Work with Message Descriptions (WRKMSGD)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The Work with Message Descriptions (WRKMSGD) command shows detailed information about the messages contained in a message file. This command can be used to add, change, remove, and print message descriptions through the Work with Message Descriptions display. When message descriptions are changed by using this display, the current values for the message are shown in the command prompt. However, there is a 512-character limit for the second-level message text.

Top

Parameters

Keyword Description Choices Notes
MSGID Message identifier Name, *FIRST Optional, Positional 1
MSGF Message file Qualified object name Optional, Positional 2
Qualifier 1: Message file Name, QCPFMSG
Qualifier 2: Library Name, *LIBL, *CURLIB
Top

Message identifier (MSGID)

Specifies the message identifier with which to begin showing a list of message descriptions in the message file specified for the Message file (MSGF) parameter.

*FIRST
The first message description in the message file is used to begin the list display.
message-identifier
Specify the message identifiers of one or more messages whose descriptions are to be shown. The message identifiers must each be 7 characters long and in the following format: pppnnnn

The first 3 characters must be a code consisting of an alphabetic character followed by two alphanumeric (alphabetic or decimal) characters; the last 4 characters may consist of the decimal numbers ranging from 0 through 9, and the characters A through F.

Top

Message file (MSGF)

Specifies the message file from which the message descriptions are taken.

Qualifier 1: Message file

QCPFMSG
Message descriptions are taken from the system message file, QCPFMSG.
name
Specify the name of the message file from which the message descriptions are taken.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is used to locate the message file. If no current library entry exists in the library list, QGPL is used.
name
Specify the library where the message file is located.
Top

Examples

WRKMSGD   MSGF(QSYS/QCPFMSG)

This command displays the Work with Message Descriptions panel, showing all message descriptions found in message file QCPFMSG in library QSYS. From that panel, the user can add, change, delete, display, or print the message descriptions.

Top

Error messages

*ESCAPE Messages

CPF2401
Not authorized to library &1.
CPF2407
Message file &1 in &2 not found.
CPF2411
Not authorized to message file &1 in &2.
CPF2483
Message file currently in use.
CPF2499
Message identifier &1 not allowed.
CPF2510
Message file &1 in &2 logically damaged.
CPF2516
Unable to open display or printer file &1 in &2.
CPF9807
One or more libraries in library list deleted.
CPF9810
Library &1 not found.
CPF9830
Cannot assign library &1.
Top