261 lines
10 KiB
HTML
261 lines
10 KiB
HTML
|
|
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>Send Break Message (SNDBRKMSG)</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="SNDBRKMSG.Top_Of_Page"></a>
|
|
<h2>Send Break Message (SNDBRKMSG)</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="#SNDBRKMSG.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#SNDBRKMSG.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#SNDBRKMSG.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="SNDBRKMSG"></a>
|
|
<p>The Send Break Message (SNDBRKMSG) command is used to send an immediate message to one or more work station message queues. An immediate message is a message that is not predefined and is not stored in a message file. The command causes the message to be delivered always in break mode. The DSPMSG display is shown for the message when it is received, regardless of the setting of the message queue's delivery mode, severity, and break handling program. However, the message may not be displayed in some cases, depending on the BRKMSG job attribute. This command is primarily intended for the system operator's use.
|
|
</p>
|
|
<p><b>Restrictions:</b>
|
|
</p>
|
|
<ol>
|
|
<li>This command can be used to send break messages to work station message queues only.
|
|
</li>
|
|
<li>This command cannot send inquiry messages (specified by MSGTYPE(INQ)) to multiple work stations.
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDBRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="SNDBRKMSG.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="#SNDBRKMSG.MSG"><b>MSG</b></a></td>
|
|
<td valign="top">Message text</td>
|
|
<td valign="top"><i>Character value</i></td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#SNDBRKMSG.TOMSGQ"><b>TOMSGQ</b></a></td>
|
|
<td valign="top">To work station message queue</td>
|
|
<td valign="top">Single values: *ALLWS<br>Other values (up to 50 repetitions): <i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: To work station message queue</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#SNDBRKMSG.MSGTYPE"><b>MSGTYPE</b></a></td>
|
|
<td valign="top">Message type</td>
|
|
<td valign="top"><b><u>*INFO</u></b>, *INQ</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#SNDBRKMSG.RPYMSGQ"><b>RPYMSGQ</b></a></td>
|
|
<td valign="top">Message queue to get reply</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Message queue to get reply</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QSYSOPR</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*LIBL</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#SNDBRKMSG.CCSID"><b>CCSID</b></a></td>
|
|
<td valign="top">Coded character set ID</td>
|
|
<td valign="top">1-65535, *HEX, <b><u>*JOB</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDBRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="SNDBRKMSG.MSG"></a>
|
|
<h3>Message text (MSG)</h3>
|
|
<p>Specifies the immediate message that is being sent. The text must be enclosed in apostrophes if it contains blanks or other special characters. A maximum of 512 characters can be specified.
|
|
</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 running this command unless a coded character set identifier is supplied for the CCSID parameter. 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>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDBRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDBRKMSG.TOMSGQ"></a>
|
|
<h3>To work station message queue (TOMSGQ)</h3>
|
|
<p>Specifies one or more work station message queues to which the break message is sent. Only the names of work station message queues can be specified and only *LIBL or QSYS can be specified for the library value.
|
|
</p>
|
|
<p><b>Single values</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALLWS</b></dt>
|
|
<dd>The break message is sent to all work station and Personal Computer message queues. *ALLWS cannot be specified if *INQ is specified for the <b>Message type (MSGTYPE)</b> parameter.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 1: To work station message queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>message-queue-name</i></b></dt>
|
|
<dd>Specify the name of the message queue to which the break message is to be 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><i>library-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="#SNDBRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDBRKMSG.MSGTYPE"></a>
|
|
<h3>Message type (MSGTYPE)</h3>
|
|
<p>Specifies the type of message that is sent in break mode. Only informational or inquiry message types can be specified. Inquiry messages may require a response.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*INFO</u></b></dt>
|
|
<dd>An information only message is sent in break mode.
|
|
</dd>
|
|
<dt><b>*INQ</b></dt>
|
|
<dd>An inquiry message is sent in break mode; the work station receiving the message is expected to reply to it. An inquiry message cannot be sent to multiple queues with only one command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDBRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDBRKMSG.RPYMSGQ"></a>
|
|
<h3>Message queue to get reply (RPYMSGQ)</h3>
|
|
<p>Specifies, only if an inquiry message is sent, the message queue that the work station user's reply is sent to.
|
|
</p>
|
|
<p><b>Qualifier 1: Message queue to get reply</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QSYSOPR</u></b></dt>
|
|
<dd>The replies to the break message are sent to the system operator's message queue, QSYSOPR.
|
|
</dd>
|
|
<dt><b><i>message-queue-name</i></b></dt>
|
|
<dd>Specify the name of the message queue to which a reply to the break message is sent. Only a user or work station message queue can be specified.
|
|
</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><i>library-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="#SNDBRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="SNDBRKMSG.CCSID"></a>
|
|
<h3>Coded character set ID (CCSID)</h3>
|
|
<p>Specifies the coded character set identifier (CCSID) that the specified message text is in. The text supplied by the MSG parameter is assumed to be in the CCSID supplied by this parameter. 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>
|
|
<dl>
|
|
<dt><b><u>*JOB</u></b></dt>
|
|
<dd>The message text is assumed to be in the CCSID of the job running this command.
|
|
</dd>
|
|
<dt><b>*HEX</b></dt>
|
|
<dd>The message text is not converted. CCSID 65535 is used.
|
|
</dd>
|
|
<dt><b><i>coded-character-set-identifier</i></b></dt>
|
|
<dd>Specify a valid CCSID in which you want your message text to be considered in. Valid values range from 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. This command will validate the CCSID.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDBRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SNDBRKMSG.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Sending a Message</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SNDBRKMSG MSG('Inventory application shuts down at 4:00 PM.')
|
|
</pre>
|
|
</p>
|
|
<p>This command sends the message 'The inventory application shuts down at 4:00 pm today.' to all work station message queues. If the work station is signed on, the message will be delivered in break mode regardless of the delivery attribute setting of those message queues. The message is also added to the work station message queues of those work stations that are not signed on.
|
|
</p>
|
|
<p><b>Example 2: Sending an Immediate Message</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
SNDBRKMSG MSG('Your printed output is ready.')
|
|
TOMSGQ(GEORGEMSGQ)
|
|
</pre>
|
|
</p>
|
|
<p>This example shows a typical use of the SNDBRKMSG command by the system operator to send an immediate message to a work station user.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDBRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="SNDBRKMSG.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF2428</b></dt>
|
|
<dd>Message queue parameter is not valid.
|
|
</dd>
|
|
<dt><b>CPF2469</b></dt>
|
|
<dd>Error occurred when sending message&1.
|
|
</dd>
|
|
<dt><b>CPF247E</b></dt>
|
|
<dd>CCSID &1 is not valid.
|
|
</dd>
|
|
<dt><b>CPF9838</b></dt>
|
|
<dd>User profile storage limit exceeded.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#SNDBRKMSG.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|