findFieldPosition

Top  Previous  Next

 

The findFieldPosition function returns the beginning position of a target field in the host-connected presentation space. This function can be used to find either protected or unprotected fields but only in a field-formatted host presentation space.

 

3270

5250

Yes

Yes

 

 

Prerequisite Calls

 

connectPresentationSpace

 

 

Call Parameters

 

Parameter name

Explanation

type

Please see the following table.

position

Identifies the field within the host presentation space at which to start the Find. It can be the PS position of any byte within the field in which you desire the Find to start.

 

 

The calling 2-character 'type' parameter can contain:

 

Code

Explanation

[RB][RB] or T [RB]

This field.

P [RB]

The previous field, either protected or unprotected.

N [RB]

The next field, either protected or unprotected.

NP

The next protected field.

NU

The next unprotected field.

PP

The previous protected field.

PU

The previous unprotected field.

 

Note:

[RB] represents a required blank.

 

 

Return Properties

 

Property name

Explanation

returnCode

A numeric code indicating the execution status of the function. Please refer to the Return Code table below for all possible values.

position

Relative position of the requested field from the origin of the host presentation space. This position is defined to be the first position after the attribute byte.

 

 

Return Code

 

The following values are defined for the 'returnCode' property:

 

Return Code

Explanation

0

The findFieldPosition function was successful.

1

Your program is not connected to a host session.

2

A parameter error was encountered.

7

The host presentation space position is not valid.

24

No such field was found.

28

Field length of 0 bytes.

 

Remarks

 

1.This function is equivalent to HLLAPI Function Number 31.
2.Except when [RB][RB] or T [RB] is used as 'type' parameter, if the field found is the same as the field from which the Find started, a return code of 24 is returned.