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

POST INTERCEPT STATUS (52)

Purpose

Informs the user that a keystroke obtained through the GET KEY (51) function was accepted or rejected.

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 POST INTERCEPT STATUS function:

func Specifies the number of the function called; must be 52 for the POST INTERCEPT STATUS function.
apistring Specifies the attributes of the API string; the calling two-character data string contains:
Position 1 One of the following:
  • The one-letter character short session ID of the PS
  • A blank or null character indicating a function call against the connected PS
Position 2 One of the following:
  • A for accept keystroke
  • R for reject keystroke
len Does not apply for this function; a length of two is implied.
ret Does not apply for this function.

Returned Parameters

ret The following codes are valid:
0 Indicates the POST INTERCEPT STATUS function was successful.
1 Indicates the PS was invalid.
2 Indicates an invalid option was specified.
8 Specifies that no prior START KEYSTROKE INTERCEPT (50) function was called for this PS short session ID.
9 Indicates a system error occurred.

Remarks

The POST INTERCEPT STATUS function informs the user that a keystroke obtained through the GET KEY (51) function was accepted or rejected. If the keystroke obtained through the GET KEY function was rejected, the POST INTERCEPT STATUS issues a beep signaling the rejection of the keystroke. Otherwise, no beep will sound.

Related Information

START HOST NOTIFICATION (23) function and GET KEY (51) function.

[ Previous | Next | Contents | Search ]