Displays menus commonly used by Diagnostic Applications (DA).
#include <diag/diago.h> #include <diag/diag.h> long diag_display_menu ( msgid, mnum, substitution, lcount, lerrors ) long msgid; long mnum; char *substitution[]; int lcount; int lerrors;
The diag_display_menu subroutine displays commonly used menus.
Parameter | Description |
---|---|
msgid | Message ID number defined in dcda.msg. Currently,
the following message IDs are defined:
CUSTOMER_TESTING_MENU ADVANCED_TESTING_MENU LOOPMODE_TESTING_MENU NO_MICROCODE_MENU NO_DIAGMICROCODE_MENU NO_DDFILE_MENU NO_HOT_KEY DEVICE_INITIAL_STATE_FAILURE |
mnum | Menu number that is displayed, right-justified, as a hex number at the top-right corner of the screen. |
substitution | Used to pass in strings to be substituted in the menu. This must be an array of three (3) character pointers. The device descriptive text is the first element. The device name as it comes from TMInput->dname is the second, and the location code is the third. |
lcount | Used to allow the loop-count value to be displayed. This value is used only when mnum is set to LOOPMODE_TESTING_MENU. |
lerrors | Used to allow the number of errors value to be displayed. This value is used only when mnum is set to LOOPMODE_TESTING_MENU. |
The diag_display_menu subroutine returns one of the following values:
Return Value | Description |
---|---|
DIAG_ASL_OK | Successful return. |
DIAG_ASL_ARGS1 | Both the msglist and menuinfo parameters were Null. |
DIAG_ASL_ARGS2 | DIAG_MSGONLY option was specified, but no messages were named. |
DIAG_MALLOCFAILED | Memory allocation was unsuccessful. |
DIAG_ASL_ENTER | Enter Function key was entered. |
DIAG_ASL_EXIT | Exit Function key was entered. |
DIAG_ASL_CANCEL | Cancel Function key was entered. |
DIAG_ASL_HELP | Help Function key was entered. |
DIAG_ASL_LIST | List Function key was entered. |
DIAG_ASL_COMMIT | Commit Function key was entered. |
DIAG_ASL_PRINT | Print Function key was entered. |