|
Query Field Attribute (14)
|
Top
Previous
Next
|
|
The Query Field Attribute function returns the attribute byte of the field containing the input host presentation space position. This information is returned in the returned length parameter.
For the PC/3270, note also that:
| • | The returned length parameter is set to 0 if the screen is unformatted. |
| • | Attribute bytes are equal to or greater than hex C0. |
Prerequisite Calls
Connect Presentation Space (1)
Call Parameters
|
Standard Interface
|
Enhanced Interface
|
Function Number
|
Must be 14.
|
|
Data String
|
NA.
|
|
Length
|
NA.
|
|
PS Position
|
Identifies the target. This can be the PS position of any byte within the target field.
|
|
Return Parameters
This function returns a length and a return code.
Length
The attribute value if the screen is formatted, or 0 if the screen is unformatted.
Return Code
The following codes are defined:
Return Code
|
Explanation
|
0
|
The Query Field Attribute was successful.
|
1
|
Your program is not currently connected to a host session.
|
7
|
The host presentation space position is not valid.
|
9
|
A system error was encountered.
|
24
|
Attribute byte not found or unformatted host presentation space.
|
Remarks
The returned field attributes are defined in the following tables. The bit positions are in IBM format with bit 0 as the left most bit in the byte.
3270 Field attribute:
Bit Position
|
Meaning
|
0-1
|
Both = 1, field attribute byte
|
2
|
Unprotected/protected
0 = Unprotected data field
1 = Protected field
|
3
|
A/N
0 = Alphanumeric data
1 = Numeric data only
|
4-5
|
I/SPD
00 = Normal intensity, pen not detectable
01 = Normal intensity, pen detectable
10 = High intensity, pen detectable
11 = Nondisplay, pen not detectable
|
6
|
Reserved
|
7
|
MDT
0 = Field has not been modified
1 = Field has been modified
|
5250 field attributes:
Bit Position
|
Meaning
|
0
|
Field attribute flag
0 = Nonfield attribute flag
1 = Field attribute flag
|
1
|
Visibility
0 = Nondisplay
1 = Display
|
2
|
Unprotected/protected
0 = Unprotected data field
1 = Protected field
|
3
|
Intensity
0 = Normal intensity
1 = High intensity
|
4-6
|
Field type
000 = Alphanumeric data: All characters are available
001 = Alphabet only: Uppercase and lowercase, comma, period, hyphen, blank, or Dup key are available
010 = Numeric shift: Automatic shift for number
011 = Numeric data only: 0-9, comma, period, plus, minus, blank, or Dup key are available
101 = Numeric data only: 0-9, or Dup key are available
110 = Magnetic stripe reading device data only
111 = Signed-numeric data: 0-9, plus, minus, or Dup key are available
|
7
|
MDT
0 = Field has not been modified
1 = Field has been modified
|
|