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

88 lines
5.2 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="Specify default message handling for escape messages" />
<meta name="abstract" content="For each message you create that can be sent as an escape message, you can set up a default message handling action to be used if the message, when sent, is not handled any other way." />
<meta name="description" content="For each message you create that can be sent as an escape message, you can set up a default message handling action to be used if the message, when sent, is not handled any other way." />
<meta name="DC.Relation" scheme="URI" content="amsgf.htm" />
<meta name="DC.Relation" scheme="URI" content="exdfp.htm" />
<meta name="DC.Relation" scheme="URI" content="altid.htm" />
<meta name="DC.Relation" scheme="URI" content="../apis/mh1.htm" />
<meta name="DC.Relation" scheme="URI" content="dfthd.htm" />
<meta name="DC.Relation" scheme="URI" content="dfthd.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="esmsg" />
<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>Specify default message handling for escape messages</title>
</head>
<body id="esmsg"><a name="esmsg"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Specify default message handling for escape messages</h1>
<div><p>For each message you create that can be sent as an escape message,
you can set up a default message handling action to be used if the message,
when sent, is not handled any other way.</p>
<div class="section"> <p>Default message handling actions can consist of:</p>
<ul><li>Default program name. A program to be called that takes default action
to handle a message. The following parameters are passed to the default program:
<ul><li>Call message queue name. This parameter is a structure that consists of
many fields that identify where the system sent the message. </li>
<li>Message reference key (4 characters). The message reference key of the
escape message on the call message queue.</li>
</ul>
</li>
<li>Dump list. A list of message data field numbers (the same numbers as the
substitution variables) that indicate which objects are to be dumped. <p>In
addition, you can dump any of the following:</p>
<ul><li>The data areas for the job</li>
<li>An internal machine data structure of a job</li>
<li>A job <p>Specifying a dump list for a job is equivalent to specifying
the <span class="cmdname">Display Job (DSPJOB)</span> command with the parameters <samp class="codeph">JOB(*)
OUTPUT(*PRINT)</samp>.</p>
</li>
</ul>
</li>
</ul>
<p>If you do not specify default actions in message descriptions, you
will get a dump of the job (as if <samp class="codeph">DSPJOB JOB(*) OUTPUT(*PRINT)</samp> was
specified).</p>
<p>The default action specified in a message is taken only
after the message percolation action is completed without the escape message
being handled.</p>
</div>
</div>
<div>
<ul class="ullinks">
<li class="ulchildlink"><strong><a href="exdfp.htm">Example: Send last diagnostic message as an escape message</a></strong><br />
This example is a program that sends the last diagnostic message as an escape message.</li>
<li class="ulchildlink"><strong><a href="altid.htm">Specify the alert option</a></strong><br />
On the <span class="cmdname">Add Message Description (ADDMSGD)</span> command,
you can specify an alert option to allow an alert to be created for a message.</li>
</ul>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="amsgf.htm" title="You use the Add Message Description (ADDMSGD) command to describe your predefined messages and to add them to the message file you created.">Add messages to a file</a></div>
</div>
<div class="reltasks"><strong>Related tasks</strong><br />
<div><a href="dfthd.htm" title="The system provides default monitoring and handling of any messages you do not monitor.">CL handling for unmonitored messsages</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="../apis/mh1.htm">Message Handling APIs</a></div>
</div>
</div>
</body>
</html>