Displays simple menus.
#include <diag/diago.h> long diag_msg ( mnum, fdes, setid, msgid [, val, ... ] ) long mnum; nl_catd fdes; unsigned short setid; unsigned short msgid; long diag_msg_nw ( mnum, fdes, setid, msgid [, val, ... ] ) long mnum; nl_catd fdes; unsigned short setid; unsigned short msgid;
The diag_msg subroutine displays the specified text and obtains the user's response. The screen is automatically cleared upon completion.
The diag_msg_nw subroutine displays the specified text but does not wait for the user to respond. The screen is not automatically cleared.
|mnum||Menu number that is displayed, right-justified, as a hex number at the top-right corner of the screen.|
|fdes||Open catalog file descriptor returned from the diag_catopen() system call.|
|setid||Set ID of the message in the catalog.|
|msgid||Message ID of the message in the catalog that serves as the format string.|
|val||Values that are optional and variable in number are inserted in the specified message according to the conventions assumed by the printf() subroutine in the standard I/O library. The format is specified by the message referenced by the catalog set and message ID.|
The diag_msg subroutine returns one of the following values:
|DIAG_ASL_CANCEL||Cancel key was entered.|
|DIAG_ASL_EXIT||Exit key was entered.|