WRKMSG (Work with Messages)

WRKMSG Command syntax diagram

 

Purpose

The Work with Messages (WRKMSG) command is used to work with messages received at a specified message queue.

 

Optional Parameters

MSGQ
Specifies the qualified name of the message queue from which messages are displayed.

*WRKUSR: Messages from the work station's message queue and the user profile message queue are displayed.

*SYSOPR: Messages from the system operator message queue (QSYSOPR) are displayed.

*USRPRF: Messages from the current user profile message queue are displayed.

*WRKSTN: Messages from the work station message queue are displayed.

The name of the message queue can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

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

MSGTYPE
Specifies the type of messages in the queue displayed.

*ALL: All messages in the queue are displayed.

*INFO: Informational messages (those not requiring a reply) are displayed.

*INQ: Inquiry messages (those requiring a reply) are displayed.

*COPY: The sender's copy of an inquiry message that was sent to a queue and required a reply is displayed.

SEV
Specifies the severity code of the message. The severity code indicates the severity level of the condition that causes the message to be sent.

00: All messages in the specified queue are displayed.

*MSGQ: All messages having a severity code value 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 displayed. Valid values range from 00 through 99.

OUTPUT
Specifies whether the output from the command is shown at the requesting workstation or printed with the job's spooled output. More information on this parameter is in commonly used parameters.

*: Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output. Immediate messages and predefined messages are truncated to 105 characters when printed.

*PRINT: The output is printed with the job's spooled output. Impromptu messages and predefined messages are truncated to 105 characters.

ASTLVL
Specifies the user interface to display.

*PRV: The previous user interface used is displayed.

*USRPRF: The user interface specified in the current user profile is displayed.

*BASIC: The Work with Messages display is shown. This user interface separates messages into two categories: 1) messages needing a reply, and 2) messages not needing a reply. New messages are shown at the top of each message list.

*INTERMED: The Display Messages display is shown.

Example for WRKMSG

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 for WRKMSG

*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.