[ Previous |
Next |
Contents |
Search ]
3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference
QUERY FIELD ATTRIBUTE (14)
Purpose
Returns the attribute byte of the field containing the input host Presentation Space (PS) position.
Prerequisite Calls
This function requires a prerequisite call to the CONNECT PRESENTATION SPACE (1) function.
Syntax
hllc( func, apistring, len, ret)
int *func;
char *apistring;
int *len;
int *ret;
Supplied Parameters
Supply the following parameters to invoke the QUERY FIELD ATTRIBUTE function:
| func |
Specifies the number of the function called; must be a 14 for the QUERY FIELD ATTRIBUTE function. |
| apistring |
Does not apply for this function. |
| len |
Does not apply for this function. |
| ret |
The position within the PS. |
Returned Parameters
| len |
If the screen is formatted, the attribute value is the length; if the screen is unformatted, the length is 0. The returned data string length parameter is set to 0 if the screen is unformatted. Attribute bytes are equal to, or greater than, X' C0'. |
| ret |
The following codes are valid:
| 0 |
Indicates the QUERY FIELD ATTRIBUTE function was successful. |
| 1 |
Indicates your program was not connected to the host session. |
| 7 |
Indicates the host PS position was invalid. |
| 9 |
Indicates a system error occurred. |
| 24 |
Specifies that the attribute byte was not found (unformatted PS). |
The returned field attributes are defined below. The bit positions are in the format with bit 0 as the leftmost bit in the byte.
| 3270 Field Attributes |
| Bit position |
Meaning |
| 0-1 |
Both = 1, field attribute byte |
| 2 |
Unprotected/protected: 0 = Unprotected data field 1 = Protected data 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 = Non-display, pen not detectable |
| 6 |
Reserved |
| 7 |
Modified/Unmodified: 0 = Field has not been modified 1 = Field has been modified |
|
Remarks
The QUERY FIELD ATTRIBUTE function returns the attribute byte of the field containing the input host PS position.
Related Information
CONNECT PRESENTATION SPACE (1) function and QUERY HOST UPDATE (24) function.
[ Previous |
Next |
Contents |
Search ]