344 lines
15 KiB
HTML
344 lines
15 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 Reply List Entry (CHGRPYLE)</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="CHGRPYLE.Top_Of_Page"></a>
|
||
|
|
<h2>Change Reply List Entry (CHGRPYLE)</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="#CHGRPYLE.PARAMETERS.TABLE">Parameters</a><br>
|
||
|
|
<a href="#CHGRPYLE.COMMAND.EXAMPLES">Examples</a><br>
|
||
|
|
<a href="#CHGRPYLE.ERROR.MESSAGES">Error messages</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div> <a name="CHGRPYLE"></a>
|
||
|
|
<p>The Change Reply List Entry (CHGRPYLE) command changes a system reply list entry. Any of the attributes of a reply list entry can be changed, except for the sequence number.
|
||
|
|
</p>
|
||
|
|
<p>The reply list is used as a source for automatic responses to predefined inquiry messages.
|
||
|
|
</p>
|
||
|
|
<p>The reply list is only used when an inquiry message is <i>sent</i> by a job that has the system reply list attribute INQMSGRPY(*SYSRPYL) specified. The INQMSGRPY attribute can be changed with the CHGJOB command.
|
||
|
|
</p>
|
||
|
|
<p>New entries may be added to the reply list with the Add Reply List Entry (ADDRPYLE) command; entries can be removed with the Remove Reply List Entry (RMVRPYLE) command. The entire list of entries can be shown with the Work with Reply List Entry (WRKRPYLE) command; from the display presented you can add, change, and remove individual entries.
|
||
|
|
</p>
|
||
|
|
<p><b>Restrictions:</b>
|
||
|
|
</p>
|
||
|
|
<ol>
|
||
|
|
<li>This command is shipped with public *EXCLUDE authority and the QPGMR user profile has private authority to use the command.
|
||
|
|
</li>
|
||
|
|
<li>To use this command, you must be signed on as QPGMR, or have *USE special authority.
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRPYLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
|
||
|
|
<div>
|
||
|
|
<h3><a name="CHGRPYLE.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"><a href="#CHGRPYLE.SEQNBR"><b>SEQNBR</b></a></td>
|
||
|
|
<td valign="top">Sequence number</td>
|
||
|
|
<td valign="top">1-9999</td>
|
||
|
|
<td valign="top">Required, Positional 1</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGRPYLE.MSGID"><b>MSGID</b></a></td>
|
||
|
|
<td valign="top">Message identifier</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *ANY</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top" rowspan="3"><a href="#CHGRPYLE.CMPDTA"><b>CMPDTA</b></a></td>
|
||
|
|
<td valign="top">Compare data</td>
|
||
|
|
<td valign="top"><i>Element list</i></td>
|
||
|
|
<td valign="top" rowspan="3">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 1: Comparison data</td>
|
||
|
|
<td valign="top">
|
||
|
|
<i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top">Element 2: Message data start position</td>
|
||
|
|
<td valign="top">
|
||
|
|
1-999, <b><u>*SAME</u></b>, *NONE</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGRPYLE.RPY"><b>RPY</b></a></td>
|
||
|
|
<td valign="top">Message reply</td>
|
||
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *DFT, *RQD</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGRPYLE.DUMP"><b>DUMP</b></a></td>
|
||
|
|
<td valign="top">Dump the sending job</td>
|
||
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
<tr>
|
||
|
|
<td valign="top"><a href="#CHGRPYLE.CCSID"><b>CCSID</b></a></td>
|
||
|
|
<td valign="top">Coded character set ID</td>
|
||
|
|
<td valign="top">1-65535, <b><u>*SAME</u></b>, *HEX, *JOB</td>
|
||
|
|
<td valign="top">Optional</td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRPYLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</div>
|
||
|
|
<div> <a name="CHGRPYLE.SEQNBR"></a>
|
||
|
|
<h3>Sequence number (SEQNBR)</h3>
|
||
|
|
<p>Specifies the sequence number of the reply list entry being changed. The message identifier and message data of an inquiry message are matched against reply list entry message identifiers and comparison data in ascending sequence number order. The search ends when a match occurs or the last reply list entry is passed.
|
||
|
|
</p>
|
||
|
|
<p>This is a required parameter.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><i>1-9999</i></b></dt>
|
||
|
|
<dd>Specify a sequence number from 1 to 9999. Duplicate sequence numbers are not allowed.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRPYLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGRPYLE.MSGID"></a>
|
||
|
|
<h3>Message identifier (MSGID)</h3>
|
||
|
|
<p>Specifies the inquiry message identifiers for which automatic system action is taken. The message identifier can be specific or generic in scope. Only predefined messages (messages known to the system by a message identifier) can be matched by reply list entries; immediate messages cannot be used for comparison.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The message identifier is not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*ANY</b></dt>
|
||
|
|
<dd>This reply list entry matches any message identifier. Unless this reply list entry has comparison data specified, any reply list entry with a higher sequence number than this one is ignored.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>message-identifier</i></b></dt>
|
||
|
|
<dd>Specify a message identifier to compare with the message identifier of an inquiry message. The message identifier must be 7 characters in length and in the following format: <i>pppnnnn</i>
|
||
|
|
<p>The first 3 characters (ppp) must be a code consisting of one alphabetic character followed by two alphanumeric (alphabetic or decimal) characters. The last 4 characters (nnnn) must consist of the decimal numbers 0 through 9 and the characters A through F.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRPYLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGRPYLE.CMPDTA"></a>
|
||
|
|
<h3>Compare data (CMPDTA)</h3>
|
||
|
|
<p>Specifies the comparison data that is used to determine whether this entry matches an inquiry message. If the identifier of the inquiry message matches the message identifier of this reply list entry, then the message data specified for the inquiry message is compared to this data.
|
||
|
|
</p>
|
||
|
|
<p><b>Element 1: Comparison data</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The comparison data is not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NONE</b></dt>
|
||
|
|
<dd>No comparison data is specified. If the inquiry message has the specified identifier, the action specified by this reply list entry is taken.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'comparison-data'</i></b></dt>
|
||
|
|
<dd>Specify a character string of no more than 28 characters (enclosed in apostrophes if blanks or other special characters are included). This string is compared with a string of the same length in the message data of the inquiry message, beginning with the first character (if no start value has been specified).
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
<p><b>Element 2: Message data start position</b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The message data start remains the same.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>message-data-start</i></b></dt>
|
||
|
|
<dd>Specify the starting character position in the message's replacement text (maximum value not to exceed 999) where the comparison data is to be compared with the replacement text. A start value is not valid without a specification of comparison data.
|
||
|
|
<p><b>Coded Character Set Identifier (CCSID) Considerations</b>
|
||
|
|
</p>
|
||
|
|
<p>The text supplied for the CMPDTA parameter that corresponds to the *CCHAR type field is assumed to be in the CCSID of the job running this command,unless the CCSID parameter is coded. For more information about the *CCHAR type field see the Add Message Description (ADDMSGD) command.
|
||
|
|
</p>
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRPYLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGRPYLE.RPY"></a>
|
||
|
|
<h3>Message reply (RPY)</h3>
|
||
|
|
<p>Specifies how to reply to an inquiry message that matches this reply list entry. The reply specified in this reply list entry is automatically sent by the system without requiring user intervention; the inquiry message does not cause any job to be interrupted or notified when the message arrives at the message queue.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The reply action is not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*DFT</b></dt>
|
||
|
|
<dd>The default reply to the inquiry message is sent.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*RQD</b></dt>
|
||
|
|
<dd>The inquiry message requires an explicit reply. No reply is automatically sent.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>'message-reply'</i></b></dt>
|
||
|
|
<dd>Specify a character string of no more than 32 characters (enclosed in apostrophes if blanks or other special characters are included), sent as a reply to the inquiry message.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRPYLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGRPYLE.DUMP"></a>
|
||
|
|
<h3>Dump the sending job (DUMP)</h3>
|
||
|
|
<p>Specifies whether the contents of the job that sent the inquiry message are printed (dumped) when the inquiry message matches this reply list entry.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The dump attribute of the reply list entry is not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*NO</b></dt>
|
||
|
|
<dd>The job is not dumped.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*YES</b></dt>
|
||
|
|
<dd>The job is dumped before control returns to the program sending the message.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRPYLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<div> <a name="CHGRPYLE.CCSID"></a>
|
||
|
|
<h3>Coded character set ID (CCSID)</h3>
|
||
|
|
<p>Specifies the coded character set identifier (CCSID) of the part of the CMPDTA that is of the type *CCHAR.
|
||
|
|
</p>
|
||
|
|
<p>When an inquiry message is sent to a job that is using the system reply list, the *CCHAR compare data is converted from the CCSID specified by the send function to the CCSID of the CMPDTA stored on the reply list. This is done before the data is compared.
|
||
|
|
</p>
|
||
|
|
<p>All other compare data is not converted before a comparison is made. For more information about 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>
|
||
|
|
<p>
|
||
|
|
<b>Note: </b>When specifying a CCSID other than *HEX, all the CMPDTA specified is converted from that CCSID to the job CCSID when displayed on the Work with Reply List Entries panel. This occurs even when all CMPDTA does not correspond with *CCHAR data; therefore, when using a CCSID other than *HEX, specifying the length of the *CCHAR data or any other data field is not recommended.
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b><u>*SAME</u></b></dt>
|
||
|
|
<dd>The CCSID associated with the CMPDTA is not changed. If the CMPDTA is being changed, the part of the CMPDTA that is of type *CCHAR is assumed to be in the same CCSID as the CMPDTA being replaced.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*JOB</b></dt>
|
||
|
|
<dd>If the CMPDTA is being changed, the part of the CMPDTA that is of type *CCHAR is assumed to be in the CCSID of the JOB running this command. If the CMPDTA is not changing, the CCSID associated with the CMPDTA is not changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>*HEX</b></dt>
|
||
|
|
<dd>The CCSID associated with the CMPDTA is changed to 65535. No conversion occurs before the replacement data is compared with the CMPDTA.
|
||
|
|
</dd>
|
||
|
|
<dt><b><i>coded-character-set-identifier</i></b></dt>
|
||
|
|
<dd>The CCSID associated with the CMPDTA is assumed to be the CCSID value specified.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRPYLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGRPYLE.COMMAND.EXAMPLES">Examples</a> </h3>
|
||
|
|
<p><b>Example 1: Changing the Message Identifier</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGRPYLE SEQNBR(20) MSGID(RPG1299)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes the message identifier of the reply list entry (sequence number 20) to RPG1299. Whenever an RPG1299 inquiry message is sent by a job that is using the reply list, the action previously specified for entry 20 is taken.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 2: Changing the Comparison Data</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGRPYLE SEQNBR(25) CMPDTA(MYPROGRAM)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes the comparison data of the reply list entry whose sequence number is 25 to MYPROGRAM. This entry only matches inquiry messages whose message data begins with MYPROGRAM. For example, if this entry were for the RPG1200 messages, the entry is used only when the RPG program from which the message was sent has message data named MYPROGRAM.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 3: Changing the Reply Sent</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGRPYLE SEQNBR(30) RPY(C)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes the reply sent for the reply list entry whose sequence number is 30 to C. Whenever an inquiry message which matches the message identifier and comparison data previously defined for this entry is sent by a job that is using the reply list, a 'C' reply is automatically sent.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 4: Printing the Job Contents</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGRPYLE SEQNBR(40) DUMP(*YES)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes the attribute defined for the DUMP parameter for the reply list entry whose sequence number is 40. Whenever this entry matches an inquiry message, the sending job is dumped before control returns to the sending program.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 5: Sending a Manual Reply</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGRPYLE SEQNBR(45) MSGID(CPA5300) CMPDTA(*NONE)
|
||
|
|
RPY(*RQD) DUMP(*NO)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes some of the attributes of the reply list entry whose sequence number is 45. Whenever a CPA53xx inquiry message is sent by a job that is using the reply list, a manual reply must be issued. If the message queue to which the inquiry is sent is in break mode, the message interrupts the job. The sending job is not dumped.
|
||
|
|
</p>
|
||
|
|
<p><b>Example 6: Sending an Automatic Reply</b>
|
||
|
|
</p>
|
||
|
|
<p>
|
||
|
|
<pre>
|
||
|
|
CHGRPYLE SEQNBR(9999) MSGID(CPA3917) RPY(R)
|
||
|
|
</pre>
|
||
|
|
</p>
|
||
|
|
<p>This command changes the reply list entry whose sequence number is 9999. Whenever a CPA3917 inquiry message is sent by a job that is using the reply list, an 'R' reply is automatically sent. The inquiry does not break into the message queue, and no opportunity is given to reply to the message manually.
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRPYLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
<hr size="2" width="100%">
|
||
|
|
<div><h3><a name="CHGRPYLE.ERROR.MESSAGES">Error messages</a> </h3>
|
||
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
||
|
|
</p>
|
||
|
|
<dl>
|
||
|
|
<dt><b>CPF2435</b></dt>
|
||
|
|
<dd>System reply list not found.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2436</b></dt>
|
||
|
|
<dd>System Reply List entry not added or changed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF247E</b></dt>
|
||
|
|
<dd>CCSID &1 is not valid.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2499</b></dt>
|
||
|
|
<dd>Message identifier &1 not allowed.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2556</b></dt>
|
||
|
|
<dd>Sequence number &1 not defined in system reply list.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2557</b></dt>
|
||
|
|
<dd>System reply list damaged.
|
||
|
|
</dd>
|
||
|
|
<dt><b>CPF2558</b></dt>
|
||
|
|
<dd>System reply list currently in use.
|
||
|
|
</dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<table width="100%">
|
||
|
|
<tr><td align="right"><a href="#CHGRPYLE.Top_Of_Page">Top</a></td></tr>
|
||
|
|
</table>
|
||
|
|
</body>
|
||
|
|
</html>
|