LOOKUP

Displays the explanation of a specified message ID, abend code, or other information.

Read syntax diagramSkip visual syntax diagram
Syntax

>>-LOOKUP--+-----+---------------------------------------------><
           '-arg-'   

where:
arg
The message ID, abend code, or other item of information to be retrieved.

If arg is not specified, then a pop-up panel is displayed from which the required information can be selected or searched for.

The use of an asterisk as a wildcard character representing any number of characters is permitted. An implicit asterisk is assumed at both the beginning and at the end of arg, if no other asterisks are specified.

A percent sign can be used to represent only a single character.

The following are sample search arguments that illustrate the use of the wildcard characters:
XYZ
Implicitly searches for a match on *XYZ*, which means that zero or more characters might precede XYZ, and zero or more characters might follow (for example, XYZ, AXYZ, XYZB, AXYZBBB).
A*
Matches everything starting with A, followed by zero or more characters (for example, A, AB, ABA000I).
A%
Matches everything starting with A, followed by exactly one character (for example, AA, AB, AC).
ABA%%%%I
Matches everything starting with ABA, followed by 4 characters and ending with I (for example, ABA0000I).

If the search results in more than one item of information, then a list is displayed from which selections can be made.

Only information that is provided by Z Abend Investigator, or specified in member HFZHUSRM of the HFZ.SHFZSAM1 data set, can be entered.

Information, such as explanations for messages or abend codes, is searched for in the following places and in the order shown:

  1. User-defined information in member HFZHUSRM of the HFZ.SHFZSAM1 data set. For details, see Providing application-specific explanations and descriptions.
  2. HCL-supplied information in the HFZDOC data set.
  3. HCL-supplied information in the HFZVSxxx data set, where xxx is the 3-character language ID in effect for the Language option.
  4. In the case of message or abend code explanations, the Message and Abend Code Explanation user exit might choose to supply an alternate explanation. For details, see Message and Abend Code Explanation user exit.

The LOOKUP command, along with its LOOKC variant, can also be issued from outside of the Z Abend Investigator ISPF interface, as long as they are issued under ISPF and the sample Z Abend Investigator ISPF command table has been made available. For details, see Modifying your ISPF environment.

For more information about the LOOKUP command, and an example of its use, see Displaying user-selected message or abend code explanations.