583 lines
26 KiB
HTML
583 lines
26 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>Change Message Queue (CHGMSGQ)</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="CHGMSGQ.Top_Of_Page"></a>
|
||
|
|
<h2>Change Message Queue (CHGMSGQ)</h2>
|
||
|
|
<table width="100%">
|
||
|
|
<tr>
|
||
|
|
<td valign="top" align="left"><b>Where allowed to run: </b>All environments (*ALL)<br>
|
||
|
|
<b>Threadsafe: </b>Yes
|
||
|
|
</td>
|
||
|
|
<td valign="top" align="right">
|
||
|
|
<a href="#CHGMSGQ.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CHGMSGQ.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CHGMSGQ.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CHGMSGQ"></a>
|
||
|
|
<p>The Change Message Queue (CHGMSGQ) command changes the attributes of the specified message queue. If the delivery mode is being changed to *BREAK or *NOTIFY and if the message queue is not already in *BREAK or *NOTIFY mode or specifically allocated to another job, it is implicitly allocated by this command. The DLVRY, PGM, and SEV parameters are not contained in the Create Message Queue (CRTMSGQ) command, but default values are assigned to them by the system when the message queue is created. This command can also be used to reset the status of old messages to that of new messages so they can be received again without the use of message reference keys.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>You must have use (*USE) and delete (*DLT) authorities for the queue.
|
||
|
|
</li>
|
||
|
|
<li>The message queues being changed cannot be allocated with either a *SHRRD, or *EXCL lock by another job. If the queue is allocated by another job when the CHGMSGQ command is attempted, an error message will be sent. One exception to this is that no lock is required when changing the CCSID of a workstation message queue.
|
||
|
|
</li>
|
||
|
|
<li>If you are changing multiple message queues with the generic support you are not allowed to change the value for the DLVRY parameter to *BREAK or to *NOTIFY.
|
||
|
|
</li>
|
||
|
|
<li>The QHST message queue has a message queue full action of *SNDMSG and this value cannot be changed. The CPF2433 message (Function not allowed for system log message queue QHST.) is issued if the message queue full action is changed for QHST.
|
||
|
|
</li>
|
||
|
|
<li>Message queue QSYSOPR is shipped with a message queue full action of *WRAP. If the value is changed to *SNDMSG and the queue needs to be recreated because it was damaged, the value is reset to the shipped value of *WRAP.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CHGMSGQ.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="#CHGMSGQ.MSGQ"><b>MSGQ</b></a></td>
|
||
|
|
<td valign="top">Message queue</td>
|
||
|
|
<td valign="top">Single values: *USRPRF, *WRKSTN<br>Other values: <i>Qualified object name</i></td>
|
||
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Qualifier 1: Message queue</td>
|
||
|
|
<td valign="top"><i>Generic name, name</i>, *ALL</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB, *USRLIBL, *ALLUSR, *ALL</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top"><a href="#CHGMSGQ.DLVRY"><b>DLVRY</b></a></td>
|
||
|
|
<td valign="top">Delivery</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *HOLD, *BREAK, *NOTIFY, *DFT</td>
|
||
|
|
<td valign="top">Optional, Positional 2</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGMSGQ.SEV"><b>SEV</b></a></td>
|
||
|
|
<td valign="top">Severity code filter</td>
|
||
|
|
<td valign="top">0-99, <b><u>*SAME</u></b></td>
|
||
|
|
<td valign="top">Optional, Positional 4</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGMSGQ.TEXT"><b>TEXT</b></a></td>
|
||
|
|
<td valign="top">Text 'description'</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="5"><a href="#CHGMSGQ.PGM"><b>PGM</b></a></td>
|
||
|
|
<td valign="top">Break handling attributes</td>
|
||
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *DSPMSG<br>Other values: <i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="5">Optional, Positional 3</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Break handling program</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Qualified object name</i></td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 1: Break handling program</td>
|
||
|
|
<td valign="top"><i>Name</i></td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top" style="padding-left:10pt">Qualifier 2: Library</td>
|
||
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b>, *CURLIB</td>
|
||
|
|
</tr><tr>
|
||
|
|
<td valign="top">Element 2: Allow other jobs to reply</td>
|
||
|
|
<td valign="top">
|
||
|
|
<b><u>*NOALWRPY</u></b>, *ALWRPY</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGMSGQ.RESET"><b>RESET</b></a></td>
|
||
|
|
<td valign="top">Reset old messages</td>
|
||
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGMSGQ.FORCE"><b>FORCE</b></a></td>
|
||
|
|
<td valign="top">Force to auxiliary storage</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGMSGQ.ALWALR"><b>ALWALR</b></a></td>
|
||
|
|
<td valign="top">Allow alerts</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGMSGQ.CCSID"><b>CCSID</b></a></td>
|
||
|
|
<td valign="top">Coded character set ID</td>
|
||
|
|
<td valign="top">1-65535, <b><u>*SAME</u></b>, *MSG, *HEX, *JOB</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGMSGQ.MSGQFULL"><b>MSGQFULL</b></a></td>
|
||
|
|
<td valign="top">Message queue full action</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *SNDMSG, *WRAP</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CHGMSGQ.MSGQ"></a>
|
||
|
|
<h3>Message queue (MSGQ)</h3>
|
||
|
|
<p>Specifies the name of the message queue whose attributes are being changed.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*WRKSTN</b></dt>
|
||
|
|
<dd>The attributes of the work station's message queue are being changed. (This parameter is not valid for a batch job.)
|
||
|
|
</dd>
|
||
|
|
<dt><b>*USRPRF</b></dt>
|
||
|
|
<dd>The attributes of the message queue associated with the currrent user profile are being changed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Qualifier 1: Message queue</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All message queues in the libraries identified in the library qualifier are changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>generic*-message-queue-name</i></b></dt>
|
||
|
|
<dd>Specify the generic name of the message queue whose attributes are being changed. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk (*) is a substitute for any valid character. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. If the complete object name is specified and the library qualifier is *USRLIBL, *ALL, or *ALLUSR, all message queues of the specified name are changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the message queue whose attributes are to be changed.
|
||
|
|
</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>*USRLIBL</b></dt>
|
||
|
|
<dd>Only the libraries in the user portion of the thread's library list are searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALL</b></dt>
|
||
|
|
<dd>All libraries in the system, including QSYS, are searched.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*ALLUSR</b></dt>
|
||
|
|
<dd>All user libraries are searched. All libraries with names that do not begin with the letter Q are searched except for the following:
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
#CGULIB #DSULIB #SEULIB
|
||
|
|
#COBLIB #RPGLIB
|
||
|
|
#DFULIB #SDALIB
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>Although the following Qxxx libraries are provided by IBM, they typically contain user data that changes frequently. Therefore, these libraries are considered user libraries and are also searched:
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
QDSNX QRCLxxxxx QUSRIJS QUSRVxRxMx
|
||
|
|
QGPL QSRVAGT QUSRINFSKR
|
||
|
|
QGPL38 QSYS2 QUSRNOTES
|
||
|
|
QMGTC QSYS2xxxxx QUSROND
|
||
|
|
QMGTC2 QS36F QUSRPOSGS
|
||
|
|
QMPGDATA QUSER38 QUSRPOSSA
|
||
|
|
QMQMDATA QUSRADSM QUSRPYMSVR
|
||
|
|
QMQMPROC QUSRBRM QUSRRDARS
|
||
|
|
QPFRDATA QUSRDIRCL QUSRSYS
|
||
|
|
QRCL QUSRDIRDB QUSRVI
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>'xxxxx' is the number of a primary auxiliary storage pool (ASP).
|
||
|
|
</li>
|
||
|
|
<li>A different library name, in the format QUSRVxRxMx, can be created by the user for each previous release supported by IBM to contain any user commands to be compiled in a CL program for the previous release. For the QUSRVxRxMx user library, VxRxMx is the version, release, and modification level of a previous release that IBM continues to support.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<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="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGMSGQ.DLVRY"></a>
|
||
|
|
<h3>Delivery (DLVRY)</h3>
|
||
|
|
<p>Specifies how the messages that are sent to this message queue are delivered. The method of delivery is in effect only as long as the message queue is allocated to the job. When the queue is no longer allocated, the delivery mode is changed to *HOLD for work station, system operator, and user message queues.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The method of message delivery is not changed. If this parameter has not been changed in a previous command, *SAME means that *HOLD is the method of delivery. However, if the specified message queue is a display station message queue, it is automatically changed to *NOTIFY by the system at sign-on.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HOLD</b></dt>
|
||
|
|
<dd>The messages are held in the message queue until they are requested by the user or program.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BREAK</b></dt>
|
||
|
|
<dd>When a message arrives at the message queue, the job to which the message queue is allocated is interrupted, and the program specified for the <b>Break handling program (PGM)</b> parameter is called, or the Display Message (DSPMSG) command is processed. When changing to *BREAK mode, if a program name is not specified or if PGM(*SAME) is specified the PGM parameter defaults to *DSPMSG for the break program and *ALWRPY for the allow other jobs to reply attribute.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NOTIFY</b></dt>
|
||
|
|
<dd>When a message arrives at the message queue, an interactive job to which the message queue is allocated is notified by the message light turning on and a buzzer sounding (if you have that feature).
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DFT</b></dt>
|
||
|
|
<dd>Messages requiring replies are answered with their default reply. No messages are added to the message queue unless the message queue is QSYSOPR.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGMSGQ.SEV"></a>
|
||
|
|
<h3>Severity code filter (SEV)</h3>
|
||
|
|
<p>Specifies the lowest severity level that a message can have and still be delivered to a user in break or notify mode. Messages arriving at the message queue whose severities are lower than that specified here do not interrupt the job or turn on the Message Waiting light; they are held in the queue until they are displayed by the Display Message (DSPMSG) command.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The severity code is not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>severity-code</i></b></dt>
|
||
|
|
<dd>Specify a value, 0 through 99, that specifies the lowest severity code that a message can have and still be delivered to a user if the message queue is in break or notify delivery mode.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGMSGQ.TEXT"></a>
|
||
|
|
<h3>Text 'description' (TEXT)</h3>
|
||
|
|
<p>Specifies the user-defined text that describes the message queue. The text specified here replaces any previous text.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The text is not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*BLANK</b></dt>
|
||
|
|
<dd>No text is specified.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'description'</i></b></dt>
|
||
|
|
<dd>Specify no more than 50 characters, enclosed in apostrophes.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGMSGQ.PGM"></a>
|
||
|
|
<h3>Break handling attributes (PGM)</h3>
|
||
|
|
<p>Two elements are used to specify the program parameter. The first element specifies the program called when a message arrives at the message queue and break delivery has been specified. The second element indicates whether or not to allow other jobs to reply to messages on the message queue when it is placed in *BREAK delivery mode with a break handling program other than *DSPMSG specified.
|
||
|
|
</p>
|
||
|
|
<p>Because the QSYSOPR message queue receives messages that require manual operator action, only *DSPMSG should be specified or assumed if the message queue being changed is QSYSOPR.
|
||
|
|
</p>
|
||
|
|
<p>The following parameters are passed to the program:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>Message queue name (10 characters). The name of the message queue to which the message was sent.
|
||
|
|
</li>
|
||
|
|
<li>Library name (10 characters). The name of the library containing the message queue.
|
||
|
|
</li>
|
||
|
|
<li>Message reference key (4 characters). The reference key of the message sent to the message queue.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p><b>Single values</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The same program, if any, is called. (If this parameter has not been changed previously in another Change Message Queue (CHGMSGQ) command, *SAME means that *DSPMSG and *ALWRPY are assumed.) When changing to *BREAK mode and if this parameter is not specified or if *SAME is specified, then the break program defaults to *DSPMSG and the allow other jobs to reply value is set to *ALWRPY.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DSPMSG</b></dt>
|
||
|
|
<dd>The Display Message (DSPMSG command) is processed when a message arrives for break delivery and the allow other jobs to reply value is set to *ALWRPY. For interactive jobs, the messages are shown on the display. For batch jobs, the message is sent to a spooled printer file.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 1: Break handling program</b>
|
||
|
|
</p>
|
||
|
|
<p>Specify the program that is called when a message arrives for break delivery.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<p><b>Qualifier 1: Break handling program</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>name</i></b></dt>
|
||
|
|
<dd>Specify the name of the program to be called.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
<dt><b></b></dt>
|
||
|
|
<dd>
|
||
|
|
<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 program. 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 program is located.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Allow other jobs to reply</b>
|
||
|
|
</p>
|
||
|
|
<p>Specifies whether other jobs can reply to inquiry messages on the message queue when it is placed in *BREAK delivery mode with a break handling program other than *DSPMSG specified. If *DSPMSG is specified for the break handling program then *ALWRPY is assumed for this attribute. If QMHDSMSS is specified for the break handling program in a library other than QSYS, then *ALWRPY will also be assumed for this attribute unless *NOALWRPY is explicitly specified.
|
||
|
|
</p>
|
||
|
|
<p><b>Note:</b> If a value is specified for this element, you must also specify a break handling program for element 1 of this parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NOALWRPY</u></b></dt>
|
||
|
|
<dd>When the message queue is in *BREAK mode with a break handling program other than *DSPMSG specified, other jobs can display the message queue, but cannot reply to inquiry messages on the message queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ALWRPY</b></dt>
|
||
|
|
<dd>When the message queue is in *BREAK mode with a break handling program other than *DSPMSG specified, other jobs can reply to inquiry messages on the message queue.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGMSGQ.RESET"></a>
|
||
|
|
<h3>Reset old messages (RESET)</h3>
|
||
|
|
<p>Specifies whether old messages (messages that have been received once and were not removed from the message queue) held in the message queue are reset to the new message status.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*NO</u></b></dt>
|
||
|
|
<dd>Old messages in the message queue are not reset to new message status. To receive an old message, reply to it, or remove it, you must enter the message reference key.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>All messages in the message queue, except inquiry messages that have been sent a reply, are reset to the new message status.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGMSGQ.FORCE"></a>
|
||
|
|
<h3>Force to auxiliary storage (FORCE)</h3>
|
||
|
|
<p>Specifies whether changes made to the message queue description or messages added to or removed from the queue are immediately forced into auxiliary storage; this ensures that changes to the queue, or messages sent or received, are not lost if a system failure occurs.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value specified in the referred to message queue is not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Changes made to the message queue, including its messages, are not immediately forced to auxiliary storage.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>All changes to the message queue description and to the messages in the queue are immediately forced to auxiliary storage. Warning: This could result in program performance problems.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGMSGQ.ALWALR"></a>
|
||
|
|
<h3>Allow alerts (ALWALR)</h3>
|
||
|
|
<p>Specifies whether the queue being changed allows alerts to be generated from alert messages that are sent to it.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value is not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>Does not allow alerts to be generated from this message queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>Allows alerts to be generated from this message queue.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGMSGQ.CCSID"></a>
|
||
|
|
<h3>Coded character set ID (CCSID)</h3>
|
||
|
|
<p>Specifies the coded character set identifier (CCSID) associated with this message queue. This applies only to immediate messages and message data that is defined as a character field that can be converted (*CCHAR).
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value is not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HEX</b></dt>
|
||
|
|
<dd>Messages sent, received, or displayed from this message queue are not converted. The message queue CCSID is 65535.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*MSG</b></dt>
|
||
|
|
<dd>Messages sent to this message queue are not converted. The CCSID specified by the sending job is saved in case a conversion is needed for a display or receive function. The message queue CCSID is 65534.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOB</b></dt>
|
||
|
|
<dd>The CCSID of the message queue is changed to the CCSID of the job running this command.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>coded-character-set-identifier</i></b></dt>
|
||
|
|
<dd>Specify the CCSID associated with this message queue. Messages sent to this message queue are converted to this CCSID. Valid values range from 1 through 65535. See the Globalization topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for a list of valid CCSID values.
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>When changing the CCSID of a message queue, the messages on the queue are not converted and the CCSID associated with each individual message is not changed. If the message queue is changed back to *MSG the original CCSID of each message is then used.
|
||
|
|
</p>
|
||
|
|
<p>Changing the CCSID of a message queue that already has messages on it can cause unpredictable results. This can occur when the encoding of the messages does not match the CCSID you specify. Only change the CCSID of a message queue when the CCSID of a message queue does not match the encoding of the messages on it.
|
||
|
|
</p>
|
||
|
|
<p>For more information on the message handler and its use of CCSIDs, see the Globalization topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGMSGQ.MSGQFULL"></a>
|
||
|
|
<h3>Message queue full action (MSGQFULL)</h3>
|
||
|
|
<p>Specifies the action to take when the message queue is full.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The value does not change.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<dl>
|
||
|
|
<dt><b>*SNDMSG</b></dt>
|
||
|
|
<dd>When the message queue is full, CPF2460 (Message queue could not be extended.) is sent to the program or user that is sending a message to the full message queue.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*WRAP</b></dt>
|
||
|
|
<dd>When the message queue is full, the oldest informational and answered messages are removed from the message queue to allow space for new messages to be added. If the removing of the informational and answered messages does not provide enough space to add the requested message, then unanswered inquiry messages are removed until there is space to add the requested message. The default reply is sent before an unanswered inquiry message is removed. When the message queue is wrapped, CPI2420 or CPI2421 is sent to the queue that was full to indicate it was wrapped. If there is no space on the queue to send these messages they are sent to the joblog of the user that was sending the message to the queue and they are sent to QHST if the full queue was QSYSOPR.
|
||
|
|
<p><b>NOTE:</b> When a queue uses *WRAP and a job sends a message to the queue that causes a wrap, messages are removed for the following conditions in order to perform the wrap:
|
||
|
|
</p>
|
||
|
|
<ul>
|
||
|
|
<li>the queue is in break or notify mode for a job
|
||
|
|
</li>
|
||
|
|
<li>a job is in a message wait state because it did a receive function on the queue with a wait time specified
|
||
|
|
</li>
|
||
|
|
<li>the queue is allocated by a job via the ALCOBJ command
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
<p>Only the system wrap function can remove messages from queues in these conditions. Other jobs still are not allowed to remove messages from the queues during these conditions. With *SNDMSG, these conditions do not allow another job to remove messages from the queue.
|
||
|
|
</p>
|
||
|
|
<p>Also when a queue specifies *WRAP and it is in break mode, the wrap function only removes messages that have been received by the break-handling program. For example, if the break-handling program did not receive all messages from the queue and it was becoming full, CPF2460 could be issued because messages could not be removed to perform the wrap.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGMSGQ.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Changing Method of Delivery to Notify Mode</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGMSGQ MSGQ(JONES) DLVRY(*NOTIFY)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes the method of delivery of the message queue named JONES to notify mode. The user is immediately notified by the attention light and audible alarm (if installed) when a message has been sent to his queue.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Changing Method of Delivery to Break Mode</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGMSGQ MSGQ(INV) DLVRY(*BREAK) PGM(INVUPDT)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes the delivery mode of the message queue named INV to *BREAK and calls a program named INVUPDT when a message arrives at INV. Other jobs will not be allowed to reply to inquiry messages on message queue INV.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGMSGQ.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<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>CPF2406</b></dt>
|
||
|
|
<dd>Authority error occurred on call to break program &1 in &2 for message queue &3 in &4.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2408</b></dt>
|
||
|
|
<dd>Not authorized to message queue &1.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2437</b></dt>
|
||
|
|
<dd>MSGQ(*WRKSTN) not allowed unless done interactively.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF244E</b></dt>
|
||
|
|
<dd>The delivery specified is not valid with a generic message queue
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2446</b></dt>
|
||
|
|
<dd>Delivery mode specified not valid for system log message queue.
|
||
|
|
</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>CPF247E</b></dt>
|
||
|
|
<dd>CCSID &1 is not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2477</b></dt>
|
||
|
|
<dd>Message queue &1 currently in use.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2485</b></dt>
|
||
|
|
<dd>Number of parameters for break program &1 in &2 message queue &3 in &4 not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2507</b></dt>
|
||
|
|
<dd>MODE(*NOTIFY) not allowed in batch mode.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2522</b></dt>
|
||
|
|
<dd>Break program &1 in &2 for message queue &3 in &4 cannot be called.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2534</b></dt>
|
||
|
|
<dd>MSGQ(*USRPRF) specified and no msg queue with user profile.
|
||
|
|
</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>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGMSGQ.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|