friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/monswabrm.htm

276 lines
9.8 KiB
HTML
Raw Blame History

<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Monitor Save While Active (MONSWABRM)</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="MONSWABRM.Top_Of_Page"></a>
<h2>Monitor Save While Active (MONSWABRM)</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="#MONSWABRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#MONSWABRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#MONSWABRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="MONSWABRM"></a>
<p>The Monitor Save While Active (MONSWABRM) command reviews the save while active message queue and looks for the message indicating the end of library synchronization. When synchronization is detected, you can issue a command to the system.
</p>
<p>The MONSWABRM command can be used as an exit (*EXIT) special value in a control group during backup processing.
</p>
<p>To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#MONSWABRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="MONSWABRM.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="#MONSWABRM.LIB"><b>LIB</b></a></td>
<td valign="top">Saved library</td>
<td valign="top"><i>Name</i>, *MSGQ</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#MONSWABRM.CMD"><b>CMD</b></a></td>
<td valign="top">Command to run</td>
<td valign="top"><i>Command string</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#MONSWABRM.JOBD"><b>JOBD</b></a></td>
<td valign="top">Job description</td>
<td valign="top">Single values: <b><u>*USRPRF</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Job description</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" rowspan="3"><a href="#MONSWABRM.JOBQ"><b>JOBQ</b></a></td>
<td valign="top">Job queue</td>
<td valign="top">Single values: <b><u>*JOBD</u></b><br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Job 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>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#MONSWABRM.WAITMSG"><b>WAITMSG</b></a></td>
<td valign="top">Time limit in seconds</td>
<td valign="top">1-999999, <b><u>3600</u></b>, *NOMAX</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#MONSWABRM.MSGQ"><b>MSGQ</b></a></td>
<td valign="top">Message queue</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#MONSWABRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="MONSWABRM.LIB"></a>
<h3>Saved library (LIB)</h3>
<p>Specifies the name of the library or message queue that you want to review for synchronization during a save while active operation.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library that you want to review for synchronization.
</dd>
<dt><b>*MSGQ</b></dt>
<dd>When you specify *MSGQ, you must specify a message queue name in the <b>Message queue (MSGQ)</b> parameter. The message queue name that you specify is reviewed for synchronization.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MONSWABRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MONSWABRM.CMD"></a>
<h3>Command to run (CMD)</h3>
<p>Specifies the command that you want to process when library synchronization is achieved during a save while active operation. For instance, you may want to restart a subsystem once synchronization has occurred for the library you are saving.
</p>
<p>
<b>Note: </b>Effective use of MONSWABRM in a control group requires that you specify *YES for "Save while active" in the control group entry for the monitored library, and that the *EXIT entry precedes the control group entry for the monitored library.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#MONSWABRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MONSWABRM.JOBD"></a>
<h3>Job description (JOBD)</h3>
<p>Specifies the job description used with this job.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*USRPRF</u></b></dt>
<dd>The job description in the user profile under which the submitted job runs is used as the job description of the submitted job.
</dd>
</dl>
<p><b>Qualifier 1: Job description </b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job description used for the job.
</dd>
</dl>
<p><b>Qualifier 2: Library </b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the job description.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the job description. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the job description is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MONSWABRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MONSWABRM.JOBQ"></a>
<h3>Job queue (JOBQ)</h3>
<p>Specifies the job queue in which this job is placed. This job queue must be different from the job queue in which the control group will run, so that the MONSWABRM command will run at the same time with the control group.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*JOBD</u></b></dt>
<dd>The submitted job is placed on the job queue named in the specified job description.
</dd>
</dl>
<p><b>Qualifier 1: Job queue </b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the job queue on which the submitted job is placed.
</dd>
</dl>
<p><b>Qualifier 2: Library </b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>The library list is used to locate the job queue.
</dd>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the job queue. If no library is specified as the current library for the job, QGPL is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the job queue is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MONSWABRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MONSWABRM.WAITMSG"></a>
<h3>Time limit in seconds (WAITMSG)</h3>
<p>Specifies the time in seconds that the MONSWABRM command should wait for the library synchronization message in the job queue. If the specified time is exceeded, the MONSWABRM command will stop monitoring the message queue. The time can be specified from 1 to 999999 seconds, with a default time of 3600 seconds (1 hour).
</p>
<dl>
<dt><b><u>3600</u></b></dt>
<dd>The default time limit is one hour.
</dd>
<dt><b>*NOMAX</b></dt>
<dd>The program waits indefinitely for the arrival of the library synchronization message.
</dd>
<dt><b><i>time-limit-in-seconds</i></b></dt>
<dd>Specify the time limit in seconds. The time can range from 1 to 999999 seconds.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MONSWABRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="MONSWABRM.MSGQ"></a>
<h3>Message queue (MSGQ)</h3>
<p>Specifies the name of the message queue that you want to review for synchronization. This parameter is required when *MSGQ is specified in the <b>Saved library (LIB)</b> parameter.
</p>
<p><b>Restriction: </b>
</p>
<ul>
<li>The message queue name specified must match the name used on the SWA Message Queue field on the control group entries intended to be monitored, or the name specified in the <b>Save active message queue (SAVACTMSGQ)</b> parameter specified in the BRMS save command(s) intended to be monitored.
<p>MONSWABRM always uses the message queue from library QUSRBRM.
</p>
</li>
</ul>
</div>
<table width="100%">
<tr><td align="right"><a href="#MONSWABRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="MONSWABRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Processing a Command after Synchronization</b>
</p>
<p>
<pre>
MONSWABRM LIB(GLLIB) CMD(SBMJOB JOB(GLDAILY))
</pre>
</p>
<p>This command will submit the GLDAILY job when the synchronization message is sent during the save of library GLLIB.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#MONSWABRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="MONSWABRM.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>BRM1917</b></dt>
<dd>Feature not installed.
</dd>
<dt><b>BRM1921</b></dt>
<dd>Feature not licensed.
</dd>
<dt><b>BRM40A2</b></dt>
<dd>BRMS product initialization required.
</dd>
<dt><b>CPF9800</b></dt>
<dd>All CPF98xx messages could be signaled. xx is from 01 to FF.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#MONSWABRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink