QUERY HOST UPDATE (24)

3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference

QUERY HOST UPDATE (24)

Purpose

Enables the programmed operator to determine if the host has updated the host Presentation Space (PS), or the operator information area (OIA), or both.

Prerequisite Calls

This function requires a prerequisite call to the START HOST NOTIFICATION (23) 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 HOST UPDATE function:

func	Specifies the number of the function called; must be 24 for the QUERY HOST UPDATE function.
apistring	Specifies the attributes of the API string; one-character short session ID of the host PS, or a blank or a null indicating the connected PS.
len	Does not apply for this function; a length of 1 is implied.
ret	Does not apply for this function.

Returned Parameters

ret

The following codes are valid:

0	Specifies that no updates were made since the last call.
1	Indicates an invalid host PS was specified.
8	Specifies that no prior START HOST NOTIFICATION (23) function was called for the host PS ID.
9	Indicates a system error occurred.
21	Specifies that the OIA was updated.
22	Specifies that the PS was updated.
23	Specifies that the OIA and the host PS were updated.

Remarks

The QUERY HOST UPDATE function lets the programmer determine if the host has updated the host PS, or the OIA, or both. The target PS must be specified in the data string. However, you do not need to be connected to the host PS to check for updates.

Related Information

START HOST NOTIFICATION (23) and QUERY FIELD ATTRIBUTE (14) function.

[ Previous | Next | Contents | Search ]