[ 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 ]