[ Previous |
Next |
Contents |
Search ]
3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference
QUERY SYSTEM (20)
Purpose
Determines the level of the HLLAPI and HCON support and other system-related values.
Prerequisite Calls
This function requires no prerequisite calls to other functions.
Syntax
hllc (func, apistring, len, ret)
int *func;
char *apistring;
int *len;
int *ret;
Supplied Parameters
Supply the following parameters to invoke the QUERY SYSTEM function:
| func |
Specifies the number of the function called; must be a 20 for the QUERY SYSTEM function. |
| apistring |
Specifies the attributes of the API string; must be a previously allocated string of 35 bytes. |
| len |
Does not apply for this function; a length of 35 is implied. |
| ret |
Does not apply for this function. |
Returned Parameters
| apistring |
A data string of 35 bytes is returned. The bytes are defined as follows:
| Position 1 |
HLLAPI version number = 1 |
| Positions 2-3 |
HLLAPI level number = 04 |
| Positions 4-9 |
043094 |
| Positions 10-12 |
Reserved |
| Position 13 |
Hardware base, U = UNIX |
| Position 14 |
Control program type, X = AIX |
| Positions 15-16 |
Reserved |
| Positions 17-18 |
HCON version level as a 2-byte ASCII value (13) |
| Positions 19-35 |
Reserved |
|
| ret |
The following codes are valid:
| 0 |
Specifies that the QUERY SYSTEM function was successful; a data string was returned. |
| 9 |
Specifies that a system error occurred. |
|
Remarks
The QUERY SYSTEM function determines the level of the HLLAPI and HCON support and other system-related values. This function returns a data string that contains the appropriate system data.
Related Information
QUERY FIELD ATTRIBUTE (14) function.
[ Previous |
Next |
Contents |
Search ]