Find Field Length (32)

Top  Previous  Next

The Find Field Length function returns the length of a target field in the connected presentation space. This function can be used to find either protected or unprotected fields, but only in a field-formatted host presentation space.

 

This function returns the number of characters contained in the field identified using the call PS position parameter. This includes all characters from the beginning of the target field up to the character preceding the next attribute byte.

 

3270

5250

Yes

Yes

 

 

Prerequisite Calls

 

Connect Presentation Space (1)

 

 

Call Parameters

 

 

Standard Interface

Enhanced Interface

Function Number

Must be 32

 

Data String

See the following table

 

Length

NA

NA

PS Position

See note

 

 

Note:

PS 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 data string 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 Parameters

 

This function returns a length and a return code.

 

Length

 

The following lengths are valid:

 

Length

Explanation

= 0

When return code = 28, field length is 0. When return code = 24, host presentation space is not field formatted.

> 0

Required field length in the host presentation space.

 

Return Code

 

The following codes are defined:

 

Return Code

Explanation

0

The Find Field Length 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.

9

A system error was encountered.

24

No such field was found.

28

Field length of 0 bytes.

 

 

Remarks

 

Except when [RB][RB] or T [RB] is used as the calling data string, if the field found is the same as the field from which the Find started, a return code of 24 is returned.