Work with Messages (WRKMSG)

Keyword	Description	Choices	Notes
MSGQ	Message queue	Single values: WRKUSR, SYSOPR, USRPRF, WRKSTN Other values: Qualified object name	Optional, Positional 1
Qualifier 1: Message queue	Name
Qualifier 2: Library	Name, LIBL, CURLIB
OUTPUT	Output	, PRINT	Optional
MSGTYPE	Message type	ALL, INFO, INQ, COPY	Optional
SEV	Severity code filter	0-99, 0, *MSGQ	Optional
ASTLVL	Assistance level	PRV, USRPRF, BASIC, INTERMED	Optional

Message queue (MSGQ)

Specifies the message queue from which messages are shown.

Note: The special values *WRKSTN, *WRKUSR, *USRPRF, and *SYSOPR should be specified for this parameter only when you are in an interactive job.

Single values

*WRKUSR: Messages from the work station's message queue and the current user's user profile message queue are shown.
*SYSOPR: Messages from the system operator message queue (QSYSOPR) are shown.
*WRKSTN: Messages from the work station's message queue are shown.
*USRPRF: Messages from the current user profile message queue are shown.

Qualifier 1: Message queue

name: Specify the name of the message queue from which messages are shown.

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 queue. If no current library entry exists in the library list, QGPL is used.
name: Specify the library where the message queue is located.

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*: The output is shown (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job). Immediate messages and predefined messages are truncated to 105 characters when printed.

*PRINT: The output is printed with the job's spooled output.

When the output is printed, two lines are printed for each message. The second line contains the following information:

Qualified job name of the job that sent the message. This consists of the following three fields:
- Job name
- User name
- Job number
Name of the program that sent the message
Instruction number in program that sent the message. For non-program message queues this is always zeroes.
The date and time the message was sent.
The name of the user profile that the thread was running under when the message was sent.

Message type (MSGTYPE)

Specifies the type of messages in the message queue that are shown.

*ALL: All messages that are in the message queue are shown.
*INFO: Only informational messages (those not requiring a reply) are shown.
*INQ: Only inquiry messages (those requiring a reply) are shown.
*COPY: A copy of each sender's message that was sent to another message queue and required a reply is shown.

Severity code filter (SEV)

Specifies the lowest severity code value that a message can have and be shown. If the message's severity code is lower than the value specified here, the message is not shown.

0: All messages in the specified message queue are shown.
*MSGQ: All messages having a severity code greater than or equal to the severity code specified for the message queue are shown.
severity-code: Specify the lowest severity code value that a message can have and still be shown. Valid values range from 00 through 99.

Assistance level (ASTLVL)

Specifies which user interface to display.

*PRV: The previous user interface used is displayed.
*USRPRF: The user interface stored in the current user profile is used.
*BASIC: The Work with Messages display is shown. This user interface separates messages into two categories: 1) messages requiring a reply and 2) messages not requiring a reply. New messages are shown at the top of each message list.
*INTERMED: The Display Messages display is shown.

Examples

WRKMSG

This command displays all messages from the requester's work station message queue and user profile message queue. Messages needing a reply are displayed first, followed by messages not needing a reply. Messages are displayed from newest to oldest.

Error messages

*ESCAPE Messages

CPF2203: User profile &1 not correct.
CPF2204: User profile &1 not found.
CPF2217: Not authorized to user profile &1.
CPF2225: Not able to allocate internal system object.
CPF2401: Not authorized to library &1.
CPF2403: Message queue &1 in &2 not found.
CPF2408: Not authorized to message queue &1.
CPF2433: Function not allowed for system log message queue &1.
CPF2450: Work station message queue &1 not allocated to job.
CPF2451: Message queue &1 is allocated to another job.
CPF2477: Message queue &1 currently in use.
CPF2513: Message queue &1 cannot be displayed.
CPF2537: Too many records written to file &2 in &3.
CPF8127: &8 damage on message queue &4 in &9. VLIC log-&7.
CPF8176: Message queue for device description &4 damaged.
CPF9830: Cannot assign library &1.
CPF9845: Error occurred while opening file &1.
CPF9846: Error while processing file &1 in library &2.
CPF9847: Error occurred while closing file &1 in library &2.