[ Previous | Next | Contents | Search ]
3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference

STOP HOST NOTIFICATION (25)

Purpose

Prevents the QUERY HOST UPDATE (24) function from determining if the designated host Presentation Space (PS) or Operator Information Area (OIA) has been updated.

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 STOP HOST NOTIFICATION function:

func Specifies the number of the function called; must be 25 for the STOP HOST NOTIFICATION function.
apistring Specifies the attributes of the data string; one-character short session ID of the target PS ID 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 the STOP HOST NOTIFICATION function was successful.
1 Specifies that an invalid host PS was specified.
8 Specifies that no previous START HOST NOTIFICATION (23) function was issued.
9 Specifies that a system error occurred.

Remarks

The STOP HOST NOTIFICATION function prevents the QUERY HOST UPDATE (24) function from determining if the designated host PS or OIA has been updated. This function also prevents the host events for the designated session from affecting the PAUSE (18) function.

This function must be issued by the same application that issued the START HOST NOTIFICATION (23) call. Otherwise, other applications will not be notified from this session.

Related Information

START HOST NOTIFICATION (23) function, PAUSE (18) function and QUERY HOST UPDATE (24) function.

[ Previous | Next | Contents | Search ]