[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Understanding the Diagnostic Subsystem for AIX

diag_display_menu

Purpose

Displays menus commonly used by Diagnostic Applications (DA).

Syntax

#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;

Description

The diag_display_menu subroutine displays commonly used menus.

Parameters

msgid Message ID number defined in dcda.msg. Currently, the following message IDs are defined:
CUSTOMER_TESTING_MENU 1
ADVANCED_TESTING_MENU 2
LOOPMODE_TESTING_MENU 3
NO_MICROCODE_MENU 4
NO_DIAGMICROCODE_MENU 5
NO_DDFILE_MENU 6
NO_HOT_KEY 7
DEVICE_INITIAL_STATE_FAILURE 8
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.

Return Value

The diag_display_menu subroutine returns one of the following values:

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.
[ Previous | Next | Contents | Home | Search ]