320 lines
10 KiB
HTML
320 lines
10 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Work with Messages (WRKMSG)</title>
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
|
</head>
|
|
<body bgcolor="white">
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<a name="WRKMSG.Top_Of_Page"></a>
|
|
<h2>Work with Messages (WRKMSG)</h2>
|
|
<table width="100%">
|
|
<tr>
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
|
<b>Threadsafe: </b>No
|
|
</td>
|
|
<td valign="top" align="right">
|
|
<a href="#WRKMSG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#WRKMSG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#WRKMSG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="WRKMSG"></a>
|
|
<p>The Work With Messages (WRKMSG) command is used by the display station user to work with messages received at a specified message queue.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="WRKMSG.PARAMETERS.TABLE">Parameters</a></h3>
|
|
<table border="1" cellpadding="4" cellspacing="0">
|
|
<!-- col1="10" col2="15" col3="30" col4="10" -->
|
|
<tr>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Keyword</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Description</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Choices</th>
|
|
<th bgcolor="aqua" valign="bottom" align="left">Notes</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#WRKMSG.MSGQ"><b>MSGQ</b></a></td>
|
|
<td valign="top">Message queue</td>
|
|
<td valign="top">Single values: <b><u>*WRKUSR</u></b>, *SYSOPR, *USRPRF, *WRKSTN<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Message queue</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#WRKMSG.OUTPUT"><b>OUTPUT</b></a></td>
|
|
<td valign="top">Output</td>
|
|
<td valign="top"><b><u>*</u></b>, *PRINT</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKMSG.MSGTYPE"><b>MSGTYPE</b></a></td>
|
|
<td valign="top">Message type</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *INFO, *INQ, *COPY</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKMSG.SEV"><b>SEV</b></a></td>
|
|
<td valign="top">Severity code filter</td>
|
|
<td valign="top">0-99, <b><u>0</u></b>, *MSGQ</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#WRKMSG.ASTLVL"><b>ASTLVL</b></a></td>
|
|
<td valign="top">Assistance level</td>
|
|
<td valign="top"><b><u>*PRV</u></b>, *USRPRF, *BASIC, *INTERMED</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="WRKMSG.MSGQ"></a>
|
|
<h3>Message queue (MSGQ)</h3>
|
|
<p>Specifies the message queue from which messages are shown.
|
|
</p>
|
|
<p><b>Note:</b> The special values *WRKSTN, *WRKUSR, *USRPRF, and *SYSOPR should be specified for this parameter only when you are in an interactive job.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*WRKUSR</u></b></dt>
|
|
<dd>Messages from the work station's message queue and the current user's user profile message queue are shown.
|
|
</dd>
|
|
<dt><b>*SYSOPR</b></dt>
|
|
<dd>Messages from the system operator message queue (QSYSOPR) are shown.
|
|
</dd>
|
|
<dt><b>*WRKSTN</b></dt>
|
|
<dd>Messages from the work station's message queue are shown.
|
|
</dd>
|
|
<dt><b>*USRPRF</b></dt>
|
|
<dd>Messages from the current user profile message queue are shown.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Message queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the message queue from which messages are shown.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the library list for the current thread are searched until the first match is found.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>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.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the library where the message queue is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKMSG.OUTPUT"></a>
|
|
<h3>Output (OUTPUT)</h3>
|
|
<p>Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*</u></b></dt>
|
|
<dd>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.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>The output is printed with the job's spooled output.
|
|
</dd>
|
|
</dl>
|
|
<p>When the output is printed, two lines are printed for each message. The second line contains the following information:
|
|
</p>
|
|
<ul>
|
|
<li>Qualified job name of the job that sent the message. This consists of the following three fields:
|
|
<ul>
|
|
<li>Job name
|
|
</li>
|
|
<li>User name
|
|
</li>
|
|
<li>Job number
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
<li>Name of the program that sent the message
|
|
</li>
|
|
<li>Instruction number in program that sent the message. For non-program message queues this is always zeroes.
|
|
</li>
|
|
<li>The date and time the message was sent.
|
|
</li>
|
|
<li>The name of the user profile that the thread was running under when the message was sent.
|
|
</li>
|
|
</ul>
|
|
<dl>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKMSG.MSGTYPE"></a>
|
|
<h3>Message type (MSGTYPE)</h3>
|
|
<p>Specifies the type of messages in the message queue that are shown.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All messages that are in the message queue are shown.
|
|
</dd>
|
|
<dt><b>*INFO</b></dt>
|
|
<dd>Only informational messages (those not requiring a reply) are shown.
|
|
</dd>
|
|
<dt><b>*INQ</b></dt>
|
|
<dd>Only inquiry messages (those requiring a reply) are shown.
|
|
</dd>
|
|
<dt><b>*COPY</b></dt>
|
|
<dd>A copy of each sender's message that was sent to another message queue and required a reply is shown.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKMSG.SEV"></a>
|
|
<h3>Severity code filter (SEV)</h3>
|
|
<p>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.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>0</u></b></dt>
|
|
<dd>All messages in the specified message queue are shown.
|
|
</dd>
|
|
<dt><b>*MSGQ</b></dt>
|
|
<dd>All messages having a severity code greater than or equal to the severity code specified for the message queue are shown.
|
|
</dd>
|
|
<dt><b><i>severity-code</i></b></dt>
|
|
<dd>Specify the lowest severity code value that a message can have and still be shown. Valid values range from 00 through 99.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="WRKMSG.ASTLVL"></a>
|
|
<h3>Assistance level (ASTLVL)</h3>
|
|
<p>Specifies which user interface to display.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*PRV</u></b></dt>
|
|
<dd>The previous user interface used is displayed.
|
|
</dd>
|
|
<dt><b>*USRPRF</b></dt>
|
|
<dd>The user interface stored in the current user profile is used.
|
|
</dd>
|
|
<dt><b>*BASIC</b></dt>
|
|
<dd>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.
|
|
</dd>
|
|
<dt><b>*INTERMED</b></dt>
|
|
<dd>The Display Messages display is shown.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKMSG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p>
|
|
<pre>
|
|
WRKMSG
|
|
</pre>
|
|
</p>
|
|
<p>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.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="WRKMSG.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2203</b></dt>
|
|
<dd>User profile &1 not correct.
|
|
</dd>
|
|
<dt><b>CPF2204</b></dt>
|
|
<dd>User profile &1 not found.
|
|
</dd>
|
|
<dt><b>CPF2217</b></dt>
|
|
<dd>Not authorized to user profile &1.
|
|
</dd>
|
|
<dt><b>CPF2225</b></dt>
|
|
<dd>Not able to allocate internal system object.
|
|
</dd>
|
|
<dt><b>CPF2401</b></dt>
|
|
<dd>Not authorized to library &1.
|
|
</dd>
|
|
<dt><b>CPF2403</b></dt>
|
|
<dd>Message queue &1 in &2 not found.
|
|
</dd>
|
|
<dt><b>CPF2408</b></dt>
|
|
<dd>Not authorized to message queue &1.
|
|
</dd>
|
|
<dt><b>CPF2433</b></dt>
|
|
<dd>Function not allowed for system log message queue &1.
|
|
</dd>
|
|
<dt><b>CPF2450</b></dt>
|
|
<dd>Work station message queue &1 not allocated to job.
|
|
</dd>
|
|
<dt><b>CPF2451</b></dt>
|
|
<dd>Message queue &1 is allocated to another job.
|
|
</dd>
|
|
<dt><b>CPF2477</b></dt>
|
|
<dd>Message queue &1 currently in use.
|
|
</dd>
|
|
<dt><b>CPF2513</b></dt>
|
|
<dd>Message queue &1 cannot be displayed.
|
|
</dd>
|
|
<dt><b>CPF2537</b></dt>
|
|
<dd>Too many records written to file &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF8127</b></dt>
|
|
<dd>&8 damage on message queue &4 in &9. VLIC log-&7.
|
|
</dd>
|
|
<dt><b>CPF8176</b></dt>
|
|
<dd>Message queue for device description &4 damaged.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
<dt><b>CPF9845</b></dt>
|
|
<dd>Error occurred while opening file &1.
|
|
</dd>
|
|
<dt><b>CPF9846</b></dt>
|
|
<dd>Error while processing file &1 in library &2.
|
|
</dd>
|
|
<dt><b>CPF9847</b></dt>
|
|
<dd>Error occurred while closing file &1 in library &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#WRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|