[ Previous |
Next |
Contents |
Home |
Search ]
AIX Version 4.3 Understanding the Diagnostic Subsystem for AIX
diag_asl_read
Purpose
Reads user input.
Syntax
#include <diag/diago.h>
long diag_asl_read ( screen_code, wait, buf )
ASL_SCREEN_CODE screen_code;
int wait;
char *buf;
Description
The diag_asl_read subroutine reads
the keyboard buffer.
Parameters
| screen_code |
Identifies the set of function keys that should be active. |
| wait |
If True, causes this subroutine to wait until the user presses one of the keys allowed by the screen_type. If this parameter is False, then this subroutine does not wait for the user input but processes anything typed ahead just as it would if the parameter were True. |
| buf |
Allocated by the application. It is used to return the values entered by the user. If used, this buffer MUST be at least ASL_READ_BUF_SIZE. Normally this value should be set to NULL. When NULL, only the function key pressed is returned. |
Return Value
The diag_asl_read subroutine returns
one of the following values:
| DIAG_ASL_OK |
Successful return. |
| DIAG_ASL_FAIL |
Failure reading data. |
| DIAG_ASL_CANCEL |
Cancel key was entered. |
| DIAG_ASL_ENTER |
Enter key was entered. |
| DIAG_ASL_EXIT |
Exit key was entered. |
[ Previous |
Next |
Contents |
Home |
Search ]