ibm-information-center/dist/eclipse/plugins/i5OS.ic.rbam6_5.4.0.1/msgextqueue.htm

95 lines
5.3 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="External message queue (*EXT)" />
<meta name="abstract" content="The external message queue (*EXT) is used to communicate with the external requester (such as a display station user) of the job." />
<meta name="description" content="The external message queue (*EXT) is used to communicate with the external requester (such as a display station user) of the job." />
<meta name="DC.subject" content="queue, external message (*EXT)" />
<meta name="keywords" content="queue, external message (*EXT)" />
<meta name="DC.Relation" scheme="URI" content="jmsgq.htm" />
<meta name="DC.Relation" scheme="URI" content="jblog.htm" />
<meta name="DC.Relation" scheme="URI" content="stmsg.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="msgextqueue" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>External message queue (*EXT)</title>
</head>
<body id="msgextqueue"><a name="msgextqueue"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">External message queue (*EXT)</h1>
<div><p>The external message queue (*EXT) is used to communicate with the
external requester (such as a display station user) of the job.</p>
<p>Messages sent to *EXT are displayed in the following ways:</p>
<ul><li>Display Program Messages screen<p>If an informational, inquiry, or notify
message is sent to the external message queue for an interactive job, the
message is displayed on the Display Program Messages display. Additionally,
the procedure waits for a reply to inquiry or notify messages from the display
station user. Should the user not enter a reply and press the Enter key or
F3 (Exit), the default message reply is returned to the sender of the message.
If there is no default message reply, *N is sent. If you send an inquiry or
notify message to the external message queue for a batch job, the system sends
the default reply back to you. If there is no default message reply, *N is
the reply. The system reply list may override the displaying of inquiries
or the sending of default replies to inquiries to *EXT.</p>
</li>
<li id="msgextqueue__msln"><a name="msgextqueue__msln"><!-- --></a>Message line of the display station<div class="p">If a status message is
sent to the external message queue of an interactive job, the message is displayed
on the message line of the display station. You can use status messages like
this to inform the display station user of the progress of a long-running
operation. For example, the system sends status messages when running the
CPYF command if you copy a file with several members. <div class="note"><span class="notetitle">Note:</span> When your application
completes the long-running operation, you must send another message to clear
the message line at the display. You can use message CPI9801, which is a blank
message, for this purpose. For example:</div>
</div>
<pre>PGM
.
.
.
SNDPGMMSG MSGID(CPF9898) MSGF(QCPFMSG) MSGDTA('Status 1') +
TOPGMQ(*EXT) MSGTYPE(*STATUS)
.
.
.
SNDPGMMSG MSGID(CPF9898) MSGF(QCPFMSG) MSGDTA('Status 2') +
TOPGMQ(*EXT) MSGTYPE(*STATUS)
.
.
.
SNDPGMMSG MSGID(CPI9801) MSGF(QCPFMSG) TOPGMQ(*EXT) +
MSGTYPE(*STATUS)
.
.
.
ENDPGM</pre>
</li>
</ul>
<p> Messages (except status messages) sent to the external message queue of
a job are also placed on the job log.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="jmsgq.htm" title="Job message queues are created for each job on the system to handle all the message requirements of the job. Job message queues for a single job consist of an external message queue (*EXT) and a set of call message queues.">Job message queues</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="jblog.htm" title="Each job has an associated job log.">Job log</a></div>
<div><a href="stmsg.htm" title="You can send status messages from your CL procedure or program, using the Send Program Message (SNDPGMMSG) command, to the external message queue (*EXT) for the job or to a call message queue .">Status messages</a></div>
</div>
</div>
</body>
</html>