[ Previous |
Next |
Contents |
Search ]
3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference
QUERY SESSION STATUS (22)
Purpose
Obtains session-specific information for any configured session of a user.
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 SESSION STATUS function:
func |
Specifies the number of the function called; must be 22 for the QUERY SESSION STATUS function. |
apistring |
Specifies either the short session ID of the target presentation space (PS) plus 18 bytes for returned data, or a blank or a null indicating the connected PS plus 18 bytes for returned data. The data string can contain:
Position 1 |
One of the following:
- A one-character PS short session ID
- A blank or null indicating a function call against the current connection PS
|
Position 2-17 |
Reserved |
|
len |
Specifies the length of the target data string; must be a minimum of 19 bytes for this function. |
ret |
Does not apply to this function. |
Returned Parameters
apistring |
A data string of 18 bytes is returned. The bytes are defined in the following positions:
Position 1 |
Short session ID. |
Positions 2-9 |
First 8 bytes of the SESSION USE field of the configuration panel |
Position 10 |
Session type, where D=DFT display, S=SNA T2.1 display, T=TCP/IP display, P=SNA T2.1 printer, Q=DFT non-SNA printer. |
Position 11 |
Session characteristics, expressed as a binary number containing the following session-characteristics byte:
0 |
Extended Attribute Byte (EAB) |
1-7 |
Reserved |
If bit 0 (EAB) = 0 the session has base attributes.
If bit 0 (EAB) =1, the session has extended attributes. |
Position 12 |
Reserved. |
Positions 13-14 |
Number of rows in the host PS; this is a binary number and is not in display format. |
Positions 15-16 |
Number of columns in the host PS; this is a binary number and is not in display format. |
Positions 17-18 |
Host code page number, expressed as a binary number. |
Position 19 |
Reserved. |
Note: The host rows and columns returned are the rows and columns that are currently being used by the host program.
|
ret |
The following codes are valid:
0 |
Indicates the QUERY SESSION STATUS function was successful. |
1 |
Indicates the session requested was invalid. |
2 |
Indicates an invalid string length was made. |
9 |
Indicates a system error occurred. |
|
Remarks
The QUERY SESSION STATUS function is used to obtain session-specific information for any configured session of a user.
Related Information
QUERY SESSIONS (10) function.
[ Previous |
Next |
Contents |
Search ]