181 lines
13 KiB
HTML
181 lines
13 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="task" />
|
|
<meta name="DC.Title" content="Create or change a message queue" />
|
|
<meta name="abstract" content="You can create or change your own user message queues." />
|
|
<meta name="description" content="You can create or change your own user message queues." />
|
|
<meta name="DC.subject" content="message queue, amount of storage, CRTMSGQ (Create Message Queue) command, Create Message Queue (CRTMSGQ) command, command, CL, CRTMSGQ (Create Message Queue), Create Message Queue (CRTMSGQ), creating, CHGMSGQ (Change Message Queue) command, Change Message Queue (CHGMSGQ) command, CHGMSGQ (Change Message Queue), Change Message Queue (CHGMSGQ), changing, attribute, message queue, message, delivery, DSPMSG (Display Messages) command, Display Messages (DSPMSG) command, DSPMSG (Display Messages), Display Messages (DSPMSG), displaying, break delivery, break delivery of message, notify delivery of message, hold delivery of message, default delivery of message, filtering, messages, using severity code filter (SEV) parameter, CCSID, using CCSID, Allow alerts, alerts, using allow alerts, workstation, QSYSOPR" />
|
|
<meta name="keywords" content="message queue, amount of storage, CRTMSGQ (Create Message Queue) command, Create Message Queue (CRTMSGQ) command, command, CL, CRTMSGQ (Create Message Queue), Create Message Queue (CRTMSGQ), creating, CHGMSGQ (Change Message Queue) command, Change Message Queue (CHGMSGQ) command, CHGMSGQ (Change Message Queue), Change Message Queue (CHGMSGQ), changing, attribute, message queue, message, delivery, DSPMSG (Display Messages) command, Display Messages (DSPMSG) command, DSPMSG (Display Messages), Display Messages (DSPMSG), displaying, break delivery, break delivery of message, notify delivery of message, hold delivery of message, default delivery of message, filtering, messages, using severity code filter (SEV) parameter, CCSID, using CCSID, Allow alerts, alerts, using allow alerts, workstation, QSYSOPR" />
|
|
<meta name="DC.Relation" scheme="URI" content="msgusequeues.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="msgqiasp.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="msghp.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="excdm.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/crtmsgq.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/chgmsgq.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/dspmsg.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="../cl/wrkmsg.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="ccmsg" />
|
|
<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>Create or change a message queue</title>
|
|
</head>
|
|
<body id="ccmsg"><a name="ccmsg"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">Create or change a message queue</h1>
|
|
<div><p>You can create or change your own user message queues.</p>
|
|
<div class="section"> <p>To create your own user message queues, you use the <span class="cmdname">Create
|
|
Message Queue (CRTMSGQ</span>) command. In addition, you also use the <span class="cmdname">Change
|
|
Message Queue (CHGMSGQ)</span> command to change attributes of your message
|
|
queue. To view the contents of the message queue, use the <span class="cmdname">Display
|
|
Message (DSPMSG)</span> command or the <span class="cmdname">Work Message (WRKMSG)</span> command.</p>
|
|
<p>The
|
|
attributes of a message queue are:</p>
|
|
<ul><li>Whether changes to the message queue must be written immediately to the
|
|
disk. Writing the changes immediately to the disk ensures that no messages
|
|
are lost in cases like a system failure. Note that this will cause a decrease
|
|
in system performance.</li>
|
|
<li>The method of delivery for messages arriving at a message queue. When
|
|
a message queue is created, the method of delivery is defined as hold delivery.
|
|
When a display station is signed on, the user's message queue is set to the
|
|
mode specified in the user profile. The types of delivery you can specify
|
|
on the <span class="cmdname">Change Message Queue (CHGMSGQ)</span> command are: <ul><li>Break delivery. A job is interrupted and a program is called to deliver
|
|
the message. If a user program is not specified on the <span class="cmdname">Change Message
|
|
Queue (CHGMSGQ)</span> command that requests break delivery, or if *SAME
|
|
is specified, the <span class="cmdname">Display Message (DSPMSG)</span> command automatically
|
|
displays the message. Break messages for a job can be controlled with the
|
|
BRKMSG parameter on the <span class="cmdname">Change Job (CHGJOB)</span> command.</li>
|
|
<li>Notify delivery. A display station user is notified by means of the attention
|
|
light or audible alarm (or by both) that a message is on the queue. The display
|
|
station user can view the message by using the <span class="cmdname">Display Message (DSPMSG)</span> or <span class="cmdname">Work
|
|
Message (WRKMSG)</span> command.</li>
|
|
<li>Hold delivery. The message queue holds the messages until the display
|
|
station user requests them with the <span class="cmdname">Display Message (DSPMSG)</span> or <span class="cmdname">Work
|
|
Message (WRKMSG)</span> command.</li>
|
|
<li>Default delivery. All messages are ignored, and any messages requiring
|
|
a reply are sent the default reply for the message.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<ul><li>How to handle messages for break delivery. <ul><li>Automatically run the <span class="cmdname">Display Message (DSPMSG)</span> command.
|
|
For an interactive job, the messages are displayed at the display station
|
|
if the severity code is high enough. For a batch job, the messages are listed
|
|
to a spooled printer file if the severity code is high enough.</li>
|
|
<li>Call a break-handling program to handle the messages. You must use the <span class="cmdname">Change
|
|
Message Queue (CHGMSGQ)</span> command to specify the called program and
|
|
to set the method of delivery to break mode. You can specify whether other
|
|
jobs can reply to inquiry messages on the queue while it is in break mode
|
|
with a break-handling program.</li>
|
|
</ul>
|
|
</li>
|
|
<li>The severity code for filtering messages for break and notify delivery.
|
|
Messages with severity equal to or greater than the minimum severity code
|
|
specified are displayed. When the queue is created, the minimum severity
|
|
code is set to 00. To change the minimum severity code, you must use the <span class="cmdname">Change
|
|
Message Queue (CHGMSGQ)</span> command. <p>When the <span class="cmdname">Display Message
|
|
(DSPMSG)</span> command is used to display messages on the message queue,
|
|
the severity code filter (SEV) parameter can be used to filter the messages
|
|
shown. This filter is used rather than the severity filter specified for
|
|
the message queue at creation time. To use this filter, specify DSPMSG SEV(*MSGQ).
|
|
You can use the <span class="cmdname">Display Message (DSPMSG)</span> command to determine
|
|
the current severity code used for filtering break and notify messages. The
|
|
code is displayed on the heading line of the message display.</p>
|
|
</li>
|
|
<li>Coded character set identifier (CCSID) associated with the message queue.
|
|
Messages sent to this queue are converted to this CCSID. No conversions
|
|
occur if the message queue CCSID is 65534 or 65535. If the message queue CCSID
|
|
is 65534, each message contains its own CCSID which is established by the
|
|
sender.</li>
|
|
<li>Allow alerts for standard message queues. Allow alerts specifies if the
|
|
queue being created allows alerts to be generated from alert messages that
|
|
are sent to it.</li>
|
|
<li>Action to take when the message queue becomes full. <ul><li>Send CPF2460 (Message queue cannot be extended) to the program or user
|
|
that sends a message to the full queue.</li>
|
|
<li>Wrap the queue. Wrapping will remove messages on the queue to make space
|
|
for a new message that is sent to the queue.</li>
|
|
</ul>
|
|
You cannot change this attribute for message queue QHST; QHST sends CPF2460
|
|
when it is full. IBM<sup>®</sup> ships QSYSOPR with this attribute set to wrap.</li>
|
|
</ul>
|
|
<div class="note"><span class="notetitle">Note:</span> When a workstation device description is created, the system establishes
|
|
a message queue for the device to receive all action messages for the device.
|
|
For workstation printers, tape drives, and APPC devices, the MSGQ parameter
|
|
can be used to specify a message queue when creating a device description.
|
|
If no message queue is specified for these devices, the default, QSYSOPR,
|
|
is used as the message queue. All other devices are assigned to the QSYSOPR
|
|
message queue when they are created.</div>
|
|
<p>The message queue defined in
|
|
your user profile is known as a user message queue. When you sign on the
|
|
system using your profile, the user message queue is put into the delivery
|
|
mode specified in your user profile.</p>
|
|
<p>If your user message queue is in
|
|
break or notify delivery mode while you are signed on a display station and
|
|
then you sign on another display station, the user message queue will not
|
|
change the delivery mode for the new sign on. User message queues (along with
|
|
workstation message queues and the QSYSOPR message queue) cannot have their
|
|
delivery mode changed by a job when the message queue is in break or notify
|
|
delivery mode for a different job.</p>
|
|
<p>When you sign off the display station,
|
|
or the job ends unexpectedly, the user message queue delivery mode is changed
|
|
to hold mode, if the delivery mode of the user message queue is break or notify
|
|
for this job. The user message queue delivery mode is also changed from break
|
|
or notify mode to hold mode when you transfer to a secondary job. You can
|
|
do this using the <span class="cmdname">Transfer Secondary Job (TFRSECJOB)</span> command
|
|
or by pressing the System Request key and specifying option 1 on the System
|
|
Request menu.</p>
|
|
<p>After transferring to a secondary job, you sign on using
|
|
your user profile. Your user message queue is put into the delivery mode
|
|
specified in your user profile. This allows the user message queue to transfer
|
|
to the secondary job. You are then able to transfer back and forth between
|
|
these two jobs and have your user message queue follow you.</p>
|
|
<p>However,
|
|
if after transferring to an alternative job, you sign on using a user profile
|
|
other than your own, the user message queue for the job from which you transferred
|
|
is left in hold delivery mode. The user message queue for the user profile
|
|
you signed on with is put in the delivery mode specified in that user profile.
|
|
Because of this, your user message queue could be put into break or notify
|
|
delivery mode by another user. If another user still has your user message
|
|
queue in that delivery mode when you transfer back to the first job, your
|
|
user message queue delivery mode cannot be changed back to the original delivery
|
|
mode.</p>
|
|
<p>The QSYSOPR message queue is the message queue for the system
|
|
operator, unless it has been changed. The above situation can occur for a
|
|
system operator as well.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<ul class="ullinks">
|
|
<li class="ulchildlink"><strong><a href="msgqiasp.htm">Message queues in independent ASPs</a></strong><br />
|
|
It is recommended that message queues in independent ASPs should not be put into break mode.</li>
|
|
<li class="ulchildlink"><strong><a href="msghp.htm">Message queues in break mode</a></strong><br />
|
|
A break-handling program can be called whenever a message of equal or higher severity than the severity code filter arrives on a message queue that is in break delivery mode.</li>
|
|
<li class="ulchildlink"><strong><a href="excdm.htm">Place a message queue in break mode automatically</a></strong><br />
|
|
This topic shows one way of monitoring the QSYSOPR message queue.</li>
|
|
</ul>
|
|
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="msgusequeues.htm" title="This covers the types of message queues, how to create or change a message queue, and details about job message queues.">Use message queues</a></div>
|
|
</div>
|
|
<div class="relinfo"><strong>Related information</strong><br />
|
|
<div><a href="../cl/crtmsgq.htm">Create Message Queue (CRTMSGQ) command</a></div>
|
|
<div><a href="../cl/chgmsgq.htm">Change Message Queue (CHGMSGQ) command</a></div>
|
|
<div><a href="../cl/dspmsg.htm">Display Message (DSPMSG) command</a></div>
|
|
<div><a href="../cl/wrkmsg.htm">Work Message (WRKMSG) command</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |