988 lines
45 KiB
HTML
988 lines
45 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 Description (CHGMSGD)</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="CHGMSGD.Top_Of_Page"></a>
|
|
<h2>Change Message Description (CHGMSGD)</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="#CHGMSGD.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CHGMSGD.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CHGMSGD.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CHGMSGD"></a>
|
|
<p>The Change Message Description (CHGMSGD) command changes an existing message description stored in a message file, and stores those changes in that message file for later use. The message description remains in the message file until the file is deleted, until the Remove Message Description (RMVMSGD) command is used to remove the message from the file, or until another change to the message is made with a Change Message Description (CHGMSGD) command.
|
|
</p>
|
|
<p>If the message is sent as an inquiry message or as a notify message and a reply is expected, the following validity-checking parameters can be used to specify some requirements that validate the reply received.
|
|
</p>
|
|
<ul>
|
|
<li><b>Reply type (TYPE)</b> parameter.
|
|
</li>
|
|
<li><b>Maximum reply length (LEN)</b> parameter.
|
|
</li>
|
|
<li><b>Valid reply values (VALUES)</b> parameter.
|
|
</li>
|
|
<li><b>Special reply values (SPCVAL)</b> parameter.
|
|
</li>
|
|
<li><b>Range of reply values (RANGE)</b> parameter.
|
|
</li>
|
|
<li><b>Relationship for valid replies (REL)</b> parameter.
|
|
</li>
|
|
<li><b>Default reply value (DFT)</b> parameter.
|
|
</li>
|
|
</ul>
|
|
<p>These parameters are not necessary for a message to allow a reply, but they can be used to define valid replies made to the message.
|
|
</p>
|
|
<p><b>Caution:</b> Specifying the alert option in the range CPx7B00 to CPx7BFF (messages sent from the alert process) may cause unpredictable results.
|
|
</p>
|
|
<p><b>Restrictions:</b> To change a message description in a message file, you must have change (*CHANGE) authority for the message file and read (*READ) authority for the library in which the file is located.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CHGMSGD.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="#CHGMSGD.MSGID"><b>MSGID</b></a></td>
|
|
<td valign="top">Message identifier</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGMSGD.MSGF"><b>MSGF</b></a></td>
|
|
<td valign="top">Message file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Message file</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="#CHGMSGD.MSG"><b>MSG</b></a></td>
|
|
<td valign="top">First-level message text</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGMSGD.SECLVL"><b>SECLVL</b></a></td>
|
|
<td valign="top">Second-level message text</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE, X''</td>
|
|
<td valign="top">Optional, Positional 4</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGMSGD.SEV"><b>SEV</b></a></td>
|
|
<td valign="top">Severity code</td>
|
|
<td valign="top">0-99, <b><u>*SAME</u></b></td>
|
|
<td valign="top">Optional, Positional 5</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#CHGMSGD.FMT"><b>FMT</b></a></td>
|
|
<td valign="top">Message data fields formats</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 99 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Data type</td>
|
|
<td valign="top">
|
|
*QTDCHAR, *CHAR, *HEX, *SPP, *DEC, *BIN, *UBIN, *CCHAR, *DTS, *SYP, *ITV</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Length</td>
|
|
<td valign="top">
|
|
<i>Integer</i>, <b><u>*VARY</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: *VARY bytes or dec pos</td>
|
|
<td valign="top">
|
|
<i>Integer</i>, <b><u>0</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGMSGD.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Reply type</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NONE, *CHAR, *DEC, *ALPHA, *NAME</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGMSGD.LEN"><b>LEN</b></a></td>
|
|
<td valign="top">Maximum reply length</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE, *TYPE<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Length</td>
|
|
<td valign="top">
|
|
<i>Integer</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Decimal positions</td>
|
|
<td valign="top">
|
|
<i>Integer</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGMSGD.VALUES"><b>VALUES</b></a></td>
|
|
<td valign="top">Valid reply values</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 20 repetitions): <i>Character value</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGMSGD.SPCVAL"><b>SPCVAL</b></a></td>
|
|
<td valign="top">Special reply values</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 20 repetitions): <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Original from-value</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Replacement to-value</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGMSGD.RANGE"><b>RANGE</b></a></td>
|
|
<td valign="top">Range of reply values</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Lower value</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Upper value</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGMSGD.REL"><b>REL</b></a></td>
|
|
<td valign="top">Relationship for valid replies</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Relational operator</td>
|
|
<td valign="top">
|
|
*EQ, *LE, *GE, *GT, *LT, *NE, *NL, *NG</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Value</td>
|
|
<td valign="top">
|
|
<i>Character value</i></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGMSGD.DFT"><b>DFT</b></a></td>
|
|
<td valign="top">Default reply value</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGMSGD.DFTPGM"><b>DFTPGM</b></a></td>
|
|
<td valign="top">Default program to call</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values: <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Default program to call</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="#CHGMSGD.DMPLST"><b>DMPLST</b></a></td>
|
|
<td valign="top">Data to be dumped</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 102 repetitions): 1-99, *JOB, *JOBINT, *JOBDMP</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CHGMSGD.ALROPT"><b>ALROPT</b></a></td>
|
|
<td valign="top">Alert options</td>
|
|
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values: <i>Element list</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Alert type</td>
|
|
<td valign="top">
|
|
<i>Character value</i>, *IMMED, *DEFER, *UNATTEND, *NO</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Resource name variable</td>
|
|
<td valign="top">
|
|
1-99, <b><u>*NONE</u></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGMSGD.LOGPRB"><b>LOGPRB</b></a></td>
|
|
<td valign="top">Log problem</td>
|
|
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CHGMSGD.CCSID"><b>CCSID</b></a></td>
|
|
<td valign="top">Coded character set ID</td>
|
|
<td valign="top">1-65535, *SAME, *HEX, <b><u>*JOB</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CHGMSGD.MSGID"></a>
|
|
<h3>Message identifier (MSGID)</h3>
|
|
<p>Specifies the message identifier of the message being changed. The message identifier must be 7 characters long and in the following format: <i>pppnnnn</i>
|
|
</p>
|
|
<p>The first 3 characters (ppp) must be a code consisting of an 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>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.MSGF"></a>
|
|
<h3>Message file (MSGF)</h3>
|
|
<p>Specifies the message file where the message description being changed is stored. This command ignores any message file overrides in effect for the job.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 1: Message file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the message file where the message description is stored.
|
|
</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 file. 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 file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.MSG"></a>
|
|
<h3>First-level message text (MSG)</h3>
|
|
<p>Specifies the new text for the message.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The message text is not changed.
|
|
</dd>
|
|
<dt><b><i>'message-text'</i></b></dt>
|
|
<dd>Specify the text of the message that is initially displayed, printed, or sent to a program or log. A maximum of 132 characters (enclosed in apostrophes) can be specified, but the display station screen size may cause additional limitations.
|
|
</dd>
|
|
</dl>
|
|
<p>
|
|
<b>Note: </b>If the message text is changing, the <b>entire</b> message text is replaced with the specified change.
|
|
</p>
|
|
<p>One or more substitution variables can be embedded in the message text string to indicate positional replacement fields that allow the program to substitute variable data in the message before the message is sent.
|
|
</p>
|
|
<p><b>Double-Byte Character Set Considerations</b>
|
|
</p>
|
|
<p>When entering double-byte characters on this parameter, several combinations of characters may cause errors to occur on this command. The double-byte characters should not contain the string, X'50Fn' (where n is a 1-digit number, 0-9). Examples are: X'50F0', X'50F4', X'50F9'.
|
|
</p>
|
|
<p><b>Coded Character Set Identifier (CCSID) Considerations</b>
|
|
</p>
|
|
<p>The text supplied for the MSG parameter is assumed to be in the CCSID of the job calling this command unless the CCSID parameter is coded. If the CCSID parameter is coded, the text is assumed to be in the CCSID specified. 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>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.SECLVL"></a>
|
|
<h3>Second-level message text (SECLVL)</h3>
|
|
<p>Specifies any message help changes. Message help can also be written to the job log, if *SECLVL is specified for the <b>Log in service log (LOG)</b> parameter of the job commands.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The message help is not changed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>There is to be no message help for this message description. Any message help in the message description is removed.
|
|
</dd>
|
|
<dt><b><i>'second-level-text'</i></b></dt>
|
|
<dd>Enter the text to show as message help. No more than 3000 characters (enclosed in apostrophes) can be specified, but display limitations must be considered. One or more substitution variables can be embedded in the message help, as described on the <b>First-level message text (MSG)</b> parameter. If you are changing the message help, the <i>entire</i> message help will be replaced with the specified change.
|
|
</dd>
|
|
</dl>
|
|
<p>Message help can be formatted for the work station using three format control characters. Each must be followed by a blank.
|
|
</p>
|
|
<ul>
|
|
<li><b>&N </b> Forces the message help to a new line (column 2). If the help is longer than one line, the next lines are indented to column 4 until the end of the help or until another format control character is found.
|
|
</li>
|
|
<li><b>&P </b> Forces the message help to a new line, indented to column 6. If the help is longer than one line, the next lines start in column 4 until the end of the help or until another format control character is found.
|
|
</li>
|
|
<li><b>&B </b> Forces the message help to a new line, starting in column 4. If the help is longer than one line, the next lines are indented to column 6 until the end of the help or until another format control character is found.
|
|
</li>
|
|
</ul>
|
|
<p><b>Double-Byte Character Set Considerations</b>
|
|
</p>
|
|
<p>When entering double-byte characters on this parameter, several combinations of characters may cause errors to occur on this command. The double-byte characters should not contain the string, X'50Fn' (where n is a 1-digit number, 0-9). Examples are: X'50F0', X'50F4', X'50F9'.
|
|
</p>
|
|
<p><b>Coded Character Set Identifier (CCSID) Considerations</b>
|
|
</p>
|
|
<p>The text supplied for the SECLVL parameter is assumed to be in the CCSID of the job calling this command unless the CCSID parameter is coded. If the CCSID parameter is coded, the text is assumed to be in the CCSID specified. 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>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.SEV"></a>
|
|
<h3>Severity code (SEV)</h3>
|
|
<p>Specifies the severity code of the message being changed. The severity code indicates the severity level of the condition that causes the message to be sent.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The severity code of this message is not changed.
|
|
</dd>
|
|
<dt><b><i>severity-code</i></b></dt>
|
|
<dd>Specify a value, 00 through 99, to represent the severity level of this message (99 is the highest severity level). The assigned code for the message should correspond to the IBM predefined severity codes. Any 2-digit value can be specified, even if no severity code has been defined for it (either predefined or user-defined).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.FMT"></a>
|
|
<h3>Message data fields formats (FMT)</h3>
|
|
<p>Specifies the formats of from one to 99 message data fields being changed. Each field is described in this parameter by a list of attributes. All 99 of the message data fields can be used as substitution values in the message and message help defined in this message description. They can also be specified for the <b>Data to be dumped (DMPLST)</b> parameter of this command. When specified for the <b>Message data field values (MSGDTA)</b> parameter of the Send Program Message (SNDPGMMSG) or Send User Message (SNDUSRMSG) command, the data fields must be concatenated to form one character string of no more than 512 characters and must match the format and sequence specified here.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If any of the previously defined formats are being changed, all existing formats must be included in this parameter.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The formats of the message are not changed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No format is being described for message fields, or the existing formats are removed. If *NONE is specified, no message data fields can be referred to in the <b>First-level message text (MSG)</b> parameter, <b>Second-level message text (SECLVL)</b> parameter, or <b>Data to be dumped (DMPLST)</b> parameter.
|
|
<p>
|
|
<b>Note: </b>If a format had been originally specified, but *NONE is specified, all referrals to those formats must be removed from the message and message help and from the dump list.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Data type</b>
|
|
</p>
|
|
<p>The first element specifies the type of data the substitution field contains and how the data is to be formatted in the message text. The contents of the second and third elements vary depending on the type specified. One of the following types can be specified for each field described by this parameter:
|
|
</p>
|
|
<dl>
|
|
<dt><b>*QTDCHAR</b></dt>
|
|
<dd>A character string formatted with enclosing apostrophes ('Monday, the 1st') can be specified.
|
|
</dd>
|
|
<dt><b>*CHAR</b></dt>
|
|
<dd>A character string formatted without enclosing apostrophes can be specified. It is an alphanumeric string that can be used to specify a name, for example, BOB. Trailing blanks are truncated.
|
|
</dd>
|
|
<dt><b>*HEX</b></dt>
|
|
<dd>A string of bytes formatted as a hexadecimal value (X'C0F4') can be specified.
|
|
</dd>
|
|
<dt><b>*DEC</b></dt>
|
|
<dd>A packed decimal number (X'058C') that is formatted in the message as a signed decimal value with a decimal point (5.8) can be specified. Values for length (required) and decimal positions (optional) specified *DEC indicate the number of decimal digits and the number of digits to the right of the decimal point. If the number of decimal positions is not specified, zero is assumed.
|
|
</dd>
|
|
<dt><b>*BIN</b></dt>
|
|
<dd>A binary value that is either 2, 4 or 8 bytes long (B'0000000000111010'), formatted in the message as a signed decimal value (58) can be specified.
|
|
</dd>
|
|
<dt><b>*UBIN</b></dt>
|
|
<dd>A binary value that is either 2, 4 or 8 bytes long (B'0000000000111010'), formatted in the message as an unsigned decimal value (58) can be specified.
|
|
</dd>
|
|
<dt><b>*CCHAR</b></dt>
|
|
<dd>A character string that can be converted. If data of this type is sent to a message queue that has a CCSID tag other than 65535 or 65534, the data is converted from the CCSID specified on the send function to the CCSID of the message queue. Conversions can also occur on data of this type when the data is obtained from the message queue using a receive or display function. See the Message Handler section of the Globalization topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for more details on CCSID conversions.
|
|
</dd>
|
|
</dl>
|
|
<p>The following formats are valid only in IBM-provided message descriptions and should not be used for other messages.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*DTS</b></dt>
|
|
<dd>An 8-byte field that contains a system-date time-stamp can be specified. The date in the output message is in the format specified by the system values QDATFMT and QDATSEP. The time is formatted as hh:mm:ss.
|
|
</dd>
|
|
<dt><b>*SPP</b></dt>
|
|
<dd>A 16-byte space pointer to data in a space object can be specified. *SPP is not valid as a replacement field in message text.
|
|
</dd>
|
|
<dt><b>*SYP</b></dt>
|
|
<dd>A 16-byte system pointer to a system object can be specified. When referred to in message text, the simple name of the system object is formatted as described in the name type, *CHAR.
|
|
</dd>
|
|
<dt><b>*ITV</b></dt>
|
|
<dd>An 8-byte field that contains a time interval can be specified. The time is formatted in the output message in the form of seconds.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Length</b>
|
|
</p>
|
|
<p>After the type specification, a second element can be specified to indicate the number of characters or digits that are passed in the message data. How the second element is used depends on the type specified in the first element.
|
|
</p>
|
|
<ul>
|
|
<li>If a length is not specified for *QTDCHAR, *CHAR, *HEX, or *SPP, then *VARY is assumed for the length. If *VARY is assumed, the message data field passed by the SNDPGMMSG or SNDUSRMSG command must be preceded by a 2-byte or 4-byte binary field that indicates the actual number of bytes of data being passed. However, when *SPP is specified, the first bytes pointed to by the space pointer contain the field length. Therefore, the 2-byte or 4-byte field must precede the data pointed to by the space pointer, and not precede the space pointer that is passed as part of the message data.
|
|
</li>
|
|
<li>If type *DEC is specified, the total number of decimal digits (including the fraction) must be specified as the second element; the number of digits in the fraction can be specified optionally as the third element.
|
|
</li>
|
|
<li>If type *BIN or *UBIN is specified, the message data field can be only 2, 4 or 8 bytes long; the default is 2 bytes.
|
|
</li>
|
|
<li>If type *CCHAR is specified, the message data length field can be only *VARY. A variable length field is required because as the data in this field gets converted to different coded character set identifiers (CCSIDs), its length may change.
|
|
</li>
|
|
</ul>
|
|
<p><b>Element 3: *VARY bytes or dec pos</b>
|
|
</p>
|
|
<p>The third element is used in one of two ways, depending on the type specified in the first element: (1) if *QTDCHAR, *CHAR, *CCHAR, *HEX, or *SPP is specified, and if *VARY is specified or assumed for the second element, the third element is used with *VARY to indicate the size of the length field actually passed. The third element can be either a 2 or a 4, which is the number of bytes specifying the length (in binary) of the passed value; (2) if *DEC is specified, the third element indicates the number of decimal positions in the decimal value. If not specified for a decimal substitution value, the default is 0 decimal positions.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If an object has been damaged or deleted, the substitution variable, when displayed, is not replaced by the name of the object. Instead, the object appears as &n (where n = number).
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.TYPE"></a>
|
|
<h3>Reply type (TYPE)</h3>
|
|
<p>Specifies, only if the message is sent as an inquiry or notify message, the type of valid reply to this message.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The reply type is not changed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>There is no reply validity checking. Any existing reply type is removed. *NONE must also be specified for the <b>Maximum reply length (LEN)</b> parameter.
|
|
</dd>
|
|
<dt><b>*CHAR</b></dt>
|
|
<dd>Any character string is valid. If it is a quoted character string, the apostrophes are passed as part of the character string.
|
|
</dd>
|
|
<dt><b>*DEC</b></dt>
|
|
<dd>Only a decimal number is a valid reply.
|
|
</dd>
|
|
<dt><b>*ALPHA</b></dt>
|
|
<dd>Only an alphabetic character string is valid. Blanks are not allowed.
|
|
</dd>
|
|
<dt><b>*NAME</b></dt>
|
|
<dd>Only a simple name is a valid reply. The name does not have to be a object name, but must start with an alphabetic character; the remaining characters must be alphanumeric.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.LEN"></a>
|
|
<h3>Maximum reply length (LEN)</h3>
|
|
<p>Specifies, only if the message is sent as an inquiry or notify message, the maximum reply length.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The reply length is not changed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>There is no reply validity checking. The existing length specification, if any, is removed. *NONE must also be specified for the <b>Reply type (TYPE)</b> parameter.
|
|
</dd>
|
|
<dt><b>*TYPE</b></dt>
|
|
<dd>The maximum length is determined by the type of reply specified for the <b>Reply type (TYPE)</b> parameter. The maximum length for each type of reply is:
|
|
<ul>
|
|
<li>Up to 132 characters for types *CHAR and *ALPHA can be specified. If any additional validity checking is to be performed (VALUES, RANGE, REL, SPCVAL, or DFT are specified), the maximum length allowed for *CHAR and *ALPHA is 32 characters.
|
|
</li>
|
|
<li>Up to 15 digits can be specified for *DEC, of which a maximum of 9 digits can be to the right of the decimal point.
|
|
</li>
|
|
<li>Up to 10 alphanumeric characters can be specified for *NAME.
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Length</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>length</i></b></dt>
|
|
<dd>Specify the maximum reply length. The length specified here cannot exceed the maximums shown above.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Decimal positions</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>number</i></b></dt>
|
|
<dd>If the reply type is a decimal value, the number of decimal positions can be optionally specified. If a value is not specified, zero decimal positions are assumed.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.VALUES"></a>
|
|
<h3>Valid reply values (VALUES)</h3>
|
|
<p>Specifies, only if the message is sent as an inquiry or notify message, a list of values of which one can be received as a valid reply. No more than 20 values can be specified in the list. Each value in the list must meet the requirements specified for message replies on the <b>Reply type (TYPE)</b> parameter and the <b>Maximum reply length (LEN)</b> parameter. If this parameter is specified, the <b>Range of reply values (RANGE)</b> parameter and the <b>Relationship for valid replies (REL)</b> parameter cannot be specified.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The existing values list is not changed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No list of reply values is specified. The reply can have any value that is consistent with the other validity-checking parameters. Any existing values are removed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>value</i></b></dt>
|
|
<dd>Specify 1 to 20 values. To be valid, these must match a reply value sent in response to the message defined in this message description. The maximum length of each value is 32 characters.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.SPCVAL"></a>
|
|
<h3>Special reply values (SPCVAL)</h3>
|
|
<p>Specifies, only if the message is sent as an inquiry or notify message, a list of up to 20 sets of special values of which one set (if the from-value is matched by the sent reply) is used as the reply. These values are special in that they may not meet all the validity checking specifications given in the other reply-oriented parameters. The reply sent is compared to the from-value in each set. If a match is found, and a to-value was specified in that set, the to-value is sent as the reply. If no to-value was specified, the from-value is sent as the reply. If the reply sent does not match any from-value, then the reply is validity-checked by the specifications in the other reply-oriented parameters.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The special values list is not changed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No special values are specified for the replies to this message. Any existing special values are removed from the message description.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Original from-value</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>from-value</i></b></dt>
|
|
<dd>Specify a from-value to compare to a message reply value.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Replacement to-value</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>to-value</i></b></dt>
|
|
<dd>Specify a to-value that the from-value will be mapped to before the reply is sent.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.RANGE"></a>
|
|
<h3>Range of reply values (RANGE)</h3>
|
|
<p>Specifies, only if the message is sent as an inquiry or notify message, the upper and lower value limits for valid replies to this message. These values must meet the requirements specified for replies by the TYPE and LEN parameters, and both values must be of the same type. If both values are not of the same length, the shorter value is padded on the right with blanks. For type *CHAR and *ALPHA replies, the reply is padded on the right with blanks or truncated on the right (to the length of the specified values) before the value range is validity-checked. If this parameter is specified, the <b>Valid reply values (VALUES)</b> parameter and the <b>Relationship for valid replies (REL)</b> parameter cannot be specified.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The upper and lower range limits are not changed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No range values are specified for the replies to this message. Any existing range values are removed from the message description.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Lower value</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>lower-value</i></b></dt>
|
|
<dd>Specify the lower limit value for valid replies to this message.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Upper value</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>upper-value</i></b></dt>
|
|
<dd>Specify the upper limit value for valid replies to this message.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.REL"></a>
|
|
<h3>Relationship for valid replies (REL)</h3>
|
|
<p>Specifies, only if the message is sent as an inquiry or notify message, the relationship that must exist for a reply to be valid. The value specified must meet the requirements specified for replies on the <b>Reply type (TYPE)</b> parameter and the <b>Maximum reply length (LEN)</b> parameter. For replies of the types *CHAR and *ALPHA, the reply is padded on the right with blanks or truncated on the right to match the length of the value specified, before the system performs the test on the reply value sent.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The relationship is not changed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No relationship is specified for replies to this message. Any existing relationship specifications are removed from the message description.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Relational operator</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>operator</i></b></dt>
|
|
<dd>Specify one of the following relational operators:
|
|
<ul>
|
|
<li>*LT -- Less than
|
|
</li>
|
|
<li>*LE -- Less than or equal to
|
|
</li>
|
|
<li>*GT -- Greater than
|
|
</li>
|
|
<li>*GE -- Greater than or equal to
|
|
</li>
|
|
<li>*EQ -- Equal to
|
|
</li>
|
|
<li>*NL -- Not less than
|
|
</li>
|
|
<li>*NG -- Not greater than
|
|
</li>
|
|
<li>*NE -- Not equal to
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Value</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>value</i></b></dt>
|
|
<dd>Specify value against which the message reply is checked. If the reply is valid in the relational test, it is sent to the sender of the message.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.DFT"></a>
|
|
<h3>Default reply value (DFT)</h3>
|
|
<p>Specifies, only if the message is sent as an inquiry or notify message, the default reply (enclosed in apostrophes, if it contains special characters) used when the receiver of the message has indicated that all messages to him are to use default replies, or when a message is deleted from a message queue and no reply was specified. The default reply can also be used to answer notify messages that are not monitored. The default reply must meet the requirements specified for replies by the validity-checking parameters.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The default reply is not changed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No default reply is specified. Any existing default reply is removed.
|
|
</dd>
|
|
<dt><b><i>'default-reply'</i></b></dt>
|
|
<dd>Specify the reply, enclosed in apostrophes if it contains special characters, to use as the default reply.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.DFTPGM"></a>
|
|
<h3>Default program to call (DFTPGM)</h3>
|
|
<p>Specifies the default program (if any) to take default action when this message is sent as an escape message to a program that is not monitoring for it.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The default program is not changed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>No default program is specified for this message. Any existing default program is removed from the message description.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: Default program to call</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the default program called when an escape message is sent.
|
|
</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 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>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.DMPLST"></a>
|
|
<h3>Data to be dumped (DMPLST)</h3>
|
|
<p>Specifies the data dumped when this message is sent as an escape message to a program that is <b><u>not</u></b> monitoring for it. This parameter can specify that data related to the job be dumped, that data from message data fields be dumped, or that a combination of these be dumped. When data from message data fields is dumped, this parameter specifies one or more numbers that identify, by position, the data fields being dumped.
|
|
</p>
|
|
<p>The system objects indicated by system pointers are dumped. The data in a space object, indicated by a space pointer, is dumped starting from the offset indicated by the space pointer for the length indicated in the field description. The standard job dump can also be requested.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The dump list is not changed.
|
|
</dd>
|
|
<dt><b>*NONE</b></dt>
|
|
<dd>There is no dump list for this message. Any existing dump list is removed from the message description.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Other values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*JOB</b></dt>
|
|
<dd>This value is the same as specifying * for the <b>Job name (JOB)</b> parameter and *PRINT for the <b>Output (OUTPUT)</b> parameter of the DSPJOB (Display Job) command.
|
|
</dd>
|
|
<dt><b>*JOBDMP</b></dt>
|
|
<dd>The data areas of the job are dumped as specified by the Dump Job (DMPJOB) command. *JOBDMP can be specified by itself, with *JOB, with *JOBINT, or with a list of message data field numbers.
|
|
</dd>
|
|
<dt><b>*JOBINT</b></dt>
|
|
<dd>The internal machine data structures related to the job processing are dumped to the machine error log as specified by the Dump Job Internal (DMPJOBINT) command. *JOBINT can be specified by itself, with *JOBDMP, *JOB, or with a list of message data field numbers.
|
|
</dd>
|
|
<dt><b><i>message-data-field-number</i></b></dt>
|
|
<dd>Specify the numbers of the message data fields that identify the data dumped when this escape message is sent but not monitored. As many as 99 data field numbers can be specified in the list; additionally, the list can contain the values *JOB, *JOBDMP and *JOBINT.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.ALROPT"></a>
|
|
<h3>Alert options (ALROPT)</h3>
|
|
<p>Specifies the alert option associated with messages sent to the QHST log and the system operator message queue.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The alert option is not changed.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 1: Alert type</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>No alert is sent.
|
|
</dd>
|
|
<dt><b>*IMMED</b></dt>
|
|
<dd>An alert is sent immediately, simultaneous with sending the message to QHST.
|
|
</dd>
|
|
<dt><b>*UNATTEND</b></dt>
|
|
<dd>An alert is sent immediately only when *UNATTEND is specified for the <b>Alert status (ALRSTS)</b> parameter of the Change Network Attributes (CHGNETA) command.
|
|
</dd>
|
|
<dt><b>*DEFER</b></dt>
|
|
<dd>The alert is sent after local problem analysis. *DEFER should be specified only for those messages against which problem analysis can be run. An alert is sent at the first exit from problem analysis for the problem referred to by the message. All alerts set to *DEFER are treated as *IMMED if:
|
|
<ul>
|
|
<li>*UNATTEND is specified for the <b>Alert status (ALRSTS)</b> parameter of the Change Network Attributes (CHGNETA) command.
|
|
</li>
|
|
<li>An error log ID is not available for a problem that might be resolved using problem analysis.
|
|
</li>
|
|
<li>*NO is specified for the <b>Log problem (LOGPRB)</b> parameter (problem analysis is not available for the condition reported by the message).
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Resource name variable</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No message data field format number is passed with the alert identifier.
|
|
</dd>
|
|
<dt><b><i>1-99</i></b></dt>
|
|
<dd>Specify the message data field format number that is passed with the alert identifier.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.LOGPRB"></a>
|
|
<h3>Log problem (LOGPRB)</h3>
|
|
<p>Specifies, for IBM-supplied messages, whether or not an entry can be put into the problem log. If there is an error log ID for the message and *YES is specified for this parameter, you can request problem analysis by pressing F14 from the system operator message queue display (by running DSPMSG *SYSOPR command).
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SAME</u></b></dt>
|
|
<dd>The value is not changed.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>An entry is not put in the problem log.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>An entry is put in the problem log if there is an error log ID associated with the message.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CHGMSGD.CCSID"></a>
|
|
<h3>Coded character set ID (CCSID)</h3>
|
|
<p>Specifies the coded character set identifier (CCSID) that the text supplied for the MSG and SECLVL parameters is in.
|
|
</p>
|
|
<p>If the MSG and SECLVL parameters are not coded, the value supplied for the CCSID parameter is used to change the CCSID tag associated with the message description. No text conversion occurs in this case. Use the CCSID parameter in this way to correct a message description that has an incorrect CCSID tag.
|
|
</p>
|
|
<p>If either the MSG or the SECLVL parameters are coded along with the CCSID parameter, the text supplied for the MSG and SECLVL parameters will be assumed to be in the CCSID specified. If only one of the MSG or SECLVL parameters is coded, but not both, any existing text associated with the parameter that is not coded is converted to the specified CCSID so that all the text is in the same CCSID.
|
|
</p>
|
|
<p>If the message file is anything other than 65535 or 65534, the text is converted from the CCSID specified to the CCSID of the message file. Otherwise, the CCSID specified is saved with the MSG description in the event a conversion is needed during a retrieve or display function.
|
|
</p>
|
|
<p>If the CCSID specified does not match the character encoding of the message description, unpredictable results may occur.
|
|
</p>
|
|
<p>To use the CCSID associated with the message description, the CCSID associated with the message file must be 65534. See the Change Message File (CHGMSGF) command for details on how to change the CCSID associated with the message file.
|
|
</p>
|
|
<p>The CCSID only applies to the first level message text and the second level message text of the message description.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*JOB</u></b></dt>
|
|
<dd>The CCSID tag of the message description is changed to the CCSID of the job running this command. If the MSG and SECLVL parameters are specified, the text supplied in these parameters is assumed to be in the CCSID specified. If the MSG and SECLVL parameters are not coded, the CCSID of the message description is not changed.
|
|
</dd>
|
|
<dt><b>*SAME</b></dt>
|
|
<dd>The CCSID tag of the message description is not changed. If the MSG or SECLVL parameter is specified, the text is assumed to be in the same CCSID as the text it is replacing.
|
|
</dd>
|
|
<dt><b>*HEX</b></dt>
|
|
<dd>The CCSID tag of the message description is changed to the special CCSID value of 65535 which means this message description is not to be converted when used.
|
|
</dd>
|
|
<dt><b><i>coded-character-set-identifier</i></b></dt>
|
|
<dd>Specify the CCSID you want the text to be considered in. Valid values range form 1 through 65535. See the Globalization information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter for a list of valid CCSID values. Only CCSIDS that a job can be changed to are accepted.
|
|
<p>If the MSG and SECLVL parameters are specified, the text supplied in these parameters is assumed to be in the CCSID specified. 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>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGMSGD.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Changing the First-Level Message and Severity</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGMSGD MSGID(UIN0115) MSGF(INV) MSG('Enter your name')
|
|
SEV(55)
|
|
</pre>
|
|
</p>
|
|
<p>This command changes the first-level message and the severity of message UIN0115 stored in the message file INV. The rest of the message description remains as originally specified in the ADDMSGD command.
|
|
</p>
|
|
<p><b>Example 2: Changing to a Range of Valid Replies</b>
|
|
</p>
|
|
<p>Assume the user created message UPY0047 as follows:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDMSGD MSGID(UPY0047) MSGF(PAYLIB/TIMECARD)
|
|
MSG('Enter department number:')
|
|
TYPE(*DEC) LEN(4) VALUES(0816 0727 0319 8774)
|
|
</pre>
|
|
</p>
|
|
<p>To change to a range of valid replies (RANGE parameter), instead of specific reply values (as specified with the VALUE parameter), the following command can be used:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGMSGD MSGID(UPY0047) MSGF(PAYLIB/TIMECARD) VALUES(*NONE)
|
|
RANGE(0300 8900)
|
|
</pre>
|
|
</p>
|
|
<p>The VALUES as originally defined are removed and the RANGE parameters are added to the message description. The type and length of the reply values do not change.
|
|
</p>
|
|
<p><b>Note:</b> All changes made to an existing message description must be compatible with the existing message description. For example, the following change would be diagnosed as invalid because the RANGE values are not compatible with the reply length as defined on the original ADDMSGD command.
|
|
</p>
|
|
<p><b>Example 3: Changing the Length Parameter</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
ADDMSGD MSGID(XYZ0202) MSGF(XYZMSGF)
|
|
MSG('Enter routing code:')
|
|
TYPE(*CHAR) LEN(2) VALUES(AA BB CC DD EE)
|
|
</pre>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGMSGD MSGID(XYZ0202) MSGF(XYZMSGF) VALUES(*NONE)
|
|
RANGE(AAA ZZZ)
|
|
</pre>
|
|
</p>
|
|
<p>To make the change to the range of reply values valid, the user must also change the length (LEN parameter). The correct command coding would be as follows:
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CHGMSGD MSGID(XYZ0202) MSGF(XYZMSGF) LEN(3)
|
|
VALUES(*NONE) RANGE(AAA ZZZ)
|
|
</pre>
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CHGMSGD.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>CPF2407</b></dt>
|
|
<dd>Message file &1 in &2 not found.
|
|
</dd>
|
|
<dt><b>CPF2411</b></dt>
|
|
<dd>Not authorized to message file &1 in &2.
|
|
</dd>
|
|
<dt><b>CPF2419</b></dt>
|
|
<dd>Message identifier &1 not found in message file &2 in &3.
|
|
</dd>
|
|
<dt><b>CPF2461</b></dt>
|
|
<dd>Message file &1 could not be extended.
|
|
</dd>
|
|
<dt><b>CPF2483</b></dt>
|
|
<dd>Message file currently in use.
|
|
</dd>
|
|
<dt><b>CPF2499</b></dt>
|
|
<dd>Message identifier &1 not allowed.
|
|
</dd>
|
|
<dt><b>CPF2510</b></dt>
|
|
<dd>Message file &1 in &2 logically damaged.
|
|
</dd>
|
|
<dt><b>CPF2542</b></dt>
|
|
<dd>Message description not changed for &1.
|
|
</dd>
|
|
<dt><b>CPF9830</b></dt>
|
|
<dd>Cannot assign library &1.
|
|
</dd>
|
|
<dt><b>CPF9838</b></dt>
|
|
<dd>User profile storage limit exceeded.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CHGMSGD.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|