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