778 lines
30 KiB
HTML
778 lines
30 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>Start Monitor for OnDemand (STRMONOND)</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="STRMONOND.Top_Of_Page"></a>
|
|
<h2>Start Monitor for OnDemand (STRMONOND)</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="#STRMONOND.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRMONOND.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRMONOND.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRMONOND"></a>
|
|
<p>The Start Monitor for OnDemand (STRMONOND) command allows you to specify the name of an output queue or directory to monitor. The spooled files in the output queue, or the files in the directory, will be automatically processed by ADDRPTOND.
|
|
</p>
|
|
<p>Once files are processed they are controlled by the value of the DLTSPLF parameter. Spooled files are additional controlled by the settings of the ERROUTQ and the PRCOUTQ parameters. If DLTSPLF is *YES then successfully processed files will be deleted. If it is *NO then successful spooled files will be moved to the output queue named in the PRCOUTQ parameter, successful directory files will have '.PRC' added to the end of file name. Unsuccessful files will never be deleted. Spooled files will end up in the output queue specified in the ERROUTQ parameter, directory files will have '.ERR' added to end of the file name.
|
|
</p>
|
|
<p>You can end the monitor by:
|
|
</p>
|
|
<ul>
|
|
<li>Specifying a method for the monitor to end automatically.
|
|
</li>
|
|
<li>Running the ENDMONOND command.
|
|
</li>
|
|
<li>Ending the monitor job using the ENDJOB command. Specify OPTION(*CNTRLD) and DELAY(999999). The job will end as soon as the monitor finishes processing the current report.
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRMONOND.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="#STRMONOND.TYPE"><b>TYPE</b></a></td>
|
|
<td valign="top">Type</td>
|
|
<td valign="top"><b><u>*OUTQ</u></b>, *DIR</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRMONOND.OUTQ"><b>OUTQ</b></a></td>
|
|
<td valign="top">Output queue</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Output 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="#STRMONOND.DIR"><b>DIR</b></a></td>
|
|
<td valign="top">Directory</td>
|
|
<td valign="top"><i>Path name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#STRMONOND.APPGRPSRC"><b>APPGRPSRC</b></a></td>
|
|
<td valign="top">Value for application group</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Check first</td>
|
|
<td valign="top">
|
|
<b><u>*SPLFNAME</u></b>, *FORMTYPE, *USERDATA, *JOBNAME, *USRDFNOPT1, *USRDFNOPT2, *USRDFNOPT3, *USRDFNOPT4, *USRDFNDTA, *FIRST, *SECOND, *THIRD, *FOURTH</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Check next</td>
|
|
<td valign="top">
|
|
<b><u>*NONE</u></b>, *FORMTYPE, *USERDATA, *JOBNAME, *USRDFNOPT1, *USRDFNOPT2, *USRDFNOPT3, *USRDFNOPT4, *USRDFNDTA, *SPLFNAME, *SECOND, *THIRD, *FOURTH, *FIRST</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Check last</td>
|
|
<td valign="top">
|
|
<b><u>*NONE</u></b>, *USERDATA, *JOBNAME, *USRDFNOPT1, *USRDFNOPT2, *USRDFNOPT3, *USRDFNOPT4, *USRDFNDTA, *SPLFNAME, *FORMTYPE, *THIRD, *FOURTH, *FIRST, *SECOND</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="4"><a href="#STRMONOND.APPSRC"><b>APPSRC</b></a></td>
|
|
<td valign="top">Value for application name</td>
|
|
<td valign="top"><i>Element list</i></td>
|
|
<td valign="top" rowspan="4">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 1: Check first</td>
|
|
<td valign="top">
|
|
<b><u>*APPGRP</u></b>, *SPLFNAME, *FORMTYPE, *USERDATA, *JOBNAME, *USRDFNOPT1, *USRDFNOPT2, *USRDFNOPT3, *USRDFNOPT4, *USRDFNDTA, *FIRST, *SECOND, *THIRD, *FOURTH</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 2: Check next</td>
|
|
<td valign="top">
|
|
<b><u>*NONE</u></b>, *FORMTYPE, *USERDATA, *JOBNAME, *USRDFNOPT1, *USRDFNOPT2, *USRDFNOPT3, *USRDFNOPT4, *USRDFNDTA, *SPLFNAME, *SECOND, *THIRD, *FOURTH, *FIRST</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Element 3: Check last</td>
|
|
<td valign="top">
|
|
<b><u>*NONE</u></b>, *USERDATA, *JOBNAME, *USRDFNOPT1, *USRDFNOPT2, *USRDFNOPT3, *USRDFNOPT4, *USRDFNDTA, *SPLFNAME, *FORMTYPE, *THIRD, *FOURTH, *FIRST, *SECOND</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRMONOND.ERROUTQ"><b>ERROUTQ</b></a></td>
|
|
<td valign="top">Error output queue</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Error output queue</td>
|
|
<td valign="top"><i>Name</i>, <b><u>ONDERR</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QUSRRDARS</u></b>, *LIBL, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#STRMONOND.DLTSPLF"><b>DLTSPLF</b></a></td>
|
|
<td valign="top">Delete processed file</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *YES</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRMONOND.PRCOUTQ"><b>PRCOUTQ</b></a></td>
|
|
<td valign="top">Processed output queue</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Processed output queue</td>
|
|
<td valign="top"><i>Name</i>, <b><u>ONDPROC</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QUSRRDARS</u></b>, *LIBL</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#STRMONOND.ENDMON"><b>ENDMON</b></a></td>
|
|
<td valign="top">End monitor automatically</td>
|
|
<td valign="top"><b><u>*NO</u></b>, *NOINPUT, *NBRHRS, *ENDTIME</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMONOND.NBRHRS"><b>NBRHRS</b></a></td>
|
|
<td valign="top">Number of hours to run</td>
|
|
<td valign="top">1-999, <b><u>8</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMONOND.ENDTIME"><b>ENDTIME</b></a></td>
|
|
<td valign="top">Time to end</td>
|
|
<td valign="top"><i>Time</i>, <b><u>230000</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMONOND.NBRMON"><b>NBRMON</b></a></td>
|
|
<td valign="top">Number of monitors to start</td>
|
|
<td valign="top">1-99, <b><u>1</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMONOND.INSTANCE"><b>INSTANCE</b></a></td>
|
|
<td valign="top">Instance</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>QUSROND</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRMONOND.SBMJOB"><b>SBMJOB</b></a></td>
|
|
<td valign="top">Submit to batch</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#STRMONOND.JOBD"><b>JOBD</b></a></td>
|
|
<td valign="top">Job description</td>
|
|
<td valign="top"><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>, <b><u>QOND400</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, <b><u>QRDARS</u></b>, *LIBL, *CURLIB</td>
|
|
</tr></table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRMONOND.TYPE"></a>
|
|
<h3>Type (TYPE)</h3>
|
|
<p>Specifies the type of monitor.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*OUTQ</u></b></dt>
|
|
<dd>Monitor the output queue named in the OUTQ parameter.
|
|
</dd>
|
|
<dt><b>*DIR</b></dt>
|
|
<dd>Monitor the directory named in the DIR parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.OUTQ"></a>
|
|
<h3>Output queue (OUTQ)</h3>
|
|
<p>Specifies the name and library of the output queue for which a monitor is to be started. A value must be provided if TYPE(*OUTQ) is specified.
|
|
</p>
|
|
<p><b>Qualifier 1: Output queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>output-queue-name</i></b></dt>
|
|
<dd>Specify the name of the output queue to monitor.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*LIBL</u></b></dt>
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is where the output queue is located. 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 output queue is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.DIR"></a>
|
|
<h3>Directory (DIR)</h3>
|
|
<p>Specifies the directory to monitor. A value must be provided if TYPE(*DIR) is specified.
|
|
</p>
|
|
<p>When a directory is monitored, the monitor looks for files to process in that directory. Each file that is found in the directory will be processed. The file names should contain the application group and application name. For example, 'CHECKSTMTS.BIGSTMTS.data'. The monitor can use any one of the first 4 parts of the file name based on the values you specify for the APPGRPSRC and APPSRC parameters. When a file is processed successfully, '.PRC' is appended to the file name unless you have specified DLTSPLF(*YES) . If the load fails or if the values determined for application group and application are not valid, '.ERR' is appended to the file name. Files that end in .PRC or .ERR will not be processed.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.APPGRPSRC"></a>
|
|
<h3>Value for application group (APPGRPSRC)</h3>
|
|
<p>For spooled files specifies which spooled file attribute to use as the application group name. For directory files specifies which part of the file name to use as the application group name. Up to three sources can be specified. If a valid application group name is not found using the first source, the second source is used. If a valid application group name is not found using the second source, the third source is used.
|
|
</p>
|
|
<p>Each value other than *NONE can only be used once.
|
|
</p>
|
|
<p><b>Element 1: Check first</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*SPLFNAME</u></b></dt>
|
|
<dd>Use the spooled file name as the source for the name.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*FORMTYPE</b></dt>
|
|
<dd>Use the form type as the source for the name.
|
|
</dd>
|
|
<dt><b>*USERDATA</b></dt>
|
|
<dd>Use the user data as the source for the name.
|
|
</dd>
|
|
<dt><b>*JOBNAME</b></dt>
|
|
<dd>Use the job name as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT1</b></dt>
|
|
<dd>Use the user-defined option 1 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT2</b></dt>
|
|
<dd>Use the user-defined option 2 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT3</b></dt>
|
|
<dd>Use the user-defined option 3 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT4</b></dt>
|
|
<dd>Use the user-defined option 4 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNDTA</b></dt>
|
|
<dd>Use the user-defined data as the source for the name.
|
|
</dd>
|
|
<dt><b>*FIRST</b></dt>
|
|
<dd>Use the part of the file name up to the first period as the source for the name.
|
|
</dd>
|
|
<dt><b>*SECOND</b></dt>
|
|
<dd>Use the part of the file name between the first period and the second period as the source for the name.
|
|
</dd>
|
|
<dt><b>*THIRD</b></dt>
|
|
<dd>Use the part of the file name between the second period and the third period as the source for the name.
|
|
</dd>
|
|
<dt><b>*FOURTH</b></dt>
|
|
<dd>Use the part of the file name between the third period and the fourth period as the source for the name.
|
|
</dd>
|
|
</dl>
|
|
<p>The default source for the second or third source is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No further sources should be checked.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Check next</b> and <b>Element 3: Check last</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*FORMTYPE</b></dt>
|
|
<dd>Use the form type as the source for the name.
|
|
</dd>
|
|
<dt><b>*USERDATA</b></dt>
|
|
<dd>Use the user data as the source for the name.
|
|
</dd>
|
|
<dt><b>*JOBNAME</b></dt>
|
|
<dd>Use the job name as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT1</b></dt>
|
|
<dd>Use the user-defined option 1 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT2</b></dt>
|
|
<dd>Use the user-defined option 2 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT3</b></dt>
|
|
<dd>Use the user-defined option 3 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT4</b></dt>
|
|
<dd>Use the user-defined option 4 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNDTA</b></dt>
|
|
<dd>Use the user-defined data as the source for the name.
|
|
</dd>
|
|
<dt><b>*FIRST</b></dt>
|
|
<dd>Use the part of the file name up to the first period as the source for the name.
|
|
</dd>
|
|
<dt><b>*SECOND</b></dt>
|
|
<dd>Use the part of the file name between the first period and the second period as the source for the name.
|
|
</dd>
|
|
<dt><b>*THIRD</b></dt>
|
|
<dd>Use the part of the file name between the second period and the third period as the source for the name.
|
|
</dd>
|
|
<dt><b>*FOURTH</b></dt>
|
|
<dd>Use the part of the file name between the third period and the fourth period as the source for the name.
|
|
</dd>
|
|
</dl>
|
|
<p>The default source for the second or third source is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No further sources should be checked.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.APPSRC"></a>
|
|
<h3>Value for application name (APPSRC)</h3>
|
|
<p>For spooled files specifies which spooled file attribute to use as the application. For directory files specifies which part of the file name to use as the application name. Up to three sources can be specified. If a valid application name is not found using the first source, the second source is used. If a valid application name is not found using the second source, the third source is used.
|
|
</p>
|
|
<p>Each value other than *NONE can only be used once.
|
|
</p>
|
|
<p><b>Element 1: Check first</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*APPGRP</u></b></dt>
|
|
<dd>Use the application group name as the source for the application name. This value will also work if the application group only contains one application regardless of the name of the application.
|
|
</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt><b>*FORMTYPE</b></dt>
|
|
<dd>Use the form type as the source for the name.
|
|
</dd>
|
|
<dt><b>*USERDATA</b></dt>
|
|
<dd>Use the user data as the source for the name.
|
|
</dd>
|
|
<dt><b>*JOBNAME</b></dt>
|
|
<dd>Use the job name as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT1</b></dt>
|
|
<dd>Use the user-defined option 1 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT2</b></dt>
|
|
<dd>Use the user-defined option 2 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT3</b></dt>
|
|
<dd>Use the user-defined option 3 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT4</b></dt>
|
|
<dd>Use the user-defined option 4 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNDTA</b></dt>
|
|
<dd>Use the user-defined data as the source for the name.
|
|
</dd>
|
|
<dt><b>*FIRST</b></dt>
|
|
<dd>Use the part of the file name up to the first period as the source for the name.
|
|
</dd>
|
|
<dt><b>*SECOND</b></dt>
|
|
<dd>Use the part of the file name between the first period and the second period as the source for the name.
|
|
</dd>
|
|
<dt><b>*THIRD</b></dt>
|
|
<dd>Use the part of the file name between the second period and the third period as the source for the name.
|
|
</dd>
|
|
<dt><b>*FOURTH</b></dt>
|
|
<dd>Use the part of the file name between the third period and the fourth period as the source for the name.
|
|
</dd>
|
|
</dl>
|
|
<p>The default source for the second or third source is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No further sources should be checked.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Element 2: Check next</b> and <b>Element 3: Check last</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>*FORMTYPE</b></dt>
|
|
<dd>Use the form type as the source for the name.
|
|
</dd>
|
|
<dt><b>*USERDATA</b></dt>
|
|
<dd>Use the user data as the source for the name.
|
|
</dd>
|
|
<dt><b>*JOBNAME</b></dt>
|
|
<dd>Use the job name as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT1</b></dt>
|
|
<dd>Use the user-defined option 1 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT2</b></dt>
|
|
<dd>Use the user-defined option 2 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT3</b></dt>
|
|
<dd>Use the user-defined option 3 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNOPT4</b></dt>
|
|
<dd>Use the user-defined option 4 as the source for the name.
|
|
</dd>
|
|
<dt><b>*USRDFNDTA</b></dt>
|
|
<dd>Use the user-defined data as the source for the name.
|
|
</dd>
|
|
<dt><b>*FIRST</b></dt>
|
|
<dd>Use the part of the file name up to the first period as the source for the name.
|
|
</dd>
|
|
<dt><b>*SECOND</b></dt>
|
|
<dd>Use the part of the file name between the first period and the second period as the source for the name.
|
|
</dd>
|
|
<dt><b>*THIRD</b></dt>
|
|
<dd>Use the part of the file name between the second period and the third period as the source for the name.
|
|
</dd>
|
|
<dt><b>*FOURTH</b></dt>
|
|
<dd>Use the part of the file name between the third period and the fourth period as the source for the name.
|
|
</dd>
|
|
</dl>
|
|
<p>The default source for the second or third source is:
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NONE</u></b></dt>
|
|
<dd>No further sources should be checked.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.ERROUTQ"></a>
|
|
<h3>Error output queue (ERROUTQ)</h3>
|
|
<p>Specifies the name of the output queue to receive spooled files that ADDRPTOND fails to load.
|
|
</p>
|
|
<p><b>Qualifier 1: Error output queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>ONDERR</u></b></dt>
|
|
<dd>Spooled files that are not loaded are placed in the output queue named ONDERR.
|
|
</dd>
|
|
<dt><b><i>error-queue-name</i></b></dt>
|
|
<dd>Specify the name of the output queue to receive spooled files that fail to load.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QUSRRDARS</u></b></dt>
|
|
<dd>The output queue is located in library QUSRRDARS.
|
|
</dd>
|
|
<dt><b>*LIBL</b></dt>
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is where the output queue is located. 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 output queue is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.DLTSPLF"></a>
|
|
<h3>Delete processed file (DLTSPLF)</h3>
|
|
<p>Specifies whether or not to delete a spooled file or file that ADDRPTOND loads successfully. If ADDRPTOND is unsuccessful, the spooled file or file is not deleted.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>The spooled file or file is not automatically deleted.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>The spooled file or file is only deleted if the report was loaded successfully.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.PRCOUTQ"></a>
|
|
<h3>Processed output queue (PRCOUTQ)</h3>
|
|
<p>Specifies the name of the output queue to receive spooled files that ADDRPTOND loads successfully. This occurs only if DLTSPLF is *NO.
|
|
</p>
|
|
<p><b>Qualifier 1: Processed output queue</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>ONDPROC</u></b></dt>
|
|
<dd>Spooled files that are loaded successfully are placed in the output queue named ONDPROC.
|
|
</dd>
|
|
<dt><b><i>processed-queue-name</i></b></dt>
|
|
<dd>Specify the name of the output queue to receive spooled files that were loaded successfully.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QUSRRDARS</u></b></dt>
|
|
<dd>The output queue is located in library QUSRRDARS.
|
|
</dd>
|
|
<dt><b>*LIBL</b></dt>
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is where the output queue is located. 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 output queue is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.ENDMON"></a>
|
|
<h3>End monitor automatically (ENDMON)</h3>
|
|
<p>Specifies if the monitor will automatically end and how.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>Do not automatically end the monitor.
|
|
</dd>
|
|
<dt><b>*NOINPUT</b></dt>
|
|
<dd>The monitor will end when the monitored output queue or directory has no more files that can be processed.
|
|
<p>
|
|
<b>Note: </b>Only spooled files in the ready state can be processed.
|
|
</p>
|
|
</dd>
|
|
<dt><b>*NBRHRS</b></dt>
|
|
<dd>The monitor will end after it has run the number of hours specified on the NBRHRS parameter.
|
|
</dd>
|
|
<dt><b>*ENDTIME</b></dt>
|
|
<dd>Specifies that the monitor is to end at the time specified on the ENDTIME parameter.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.NBRHRS"></a>
|
|
<h3>Number of hours to run (NBRHRS)</h3>
|
|
<p>Specifies how many hours the monitor is to run before automatically ending.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>8</u></b></dt>
|
|
<dd>The monitor will automatically end after 8 hours.
|
|
</dd>
|
|
<dt><b><i>1-999</i></b></dt>
|
|
<dd>Allow the monitor to run from 1 to 999 hours.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.ENDTIME"></a>
|
|
<h3>Time to end (ENDTIME)</h3>
|
|
<p>Specifies the time when the monitor will automatically end.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>230000</u></b></dt>
|
|
<dd>The monitor will automatically end at 11:00 pm.
|
|
</dd>
|
|
<dt><b><i>ending-time</i></b></dt>
|
|
<dd>Specify the time that the monitor should end. The time is specified in 24-hour format and can be specified with or without a time separator:
|
|
<ul>
|
|
<li>Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Valid values for hh range from 00 to 23. Valid values for mm and ss range from 00 to 59.
|
|
</li>
|
|
<li>With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If this command is entered from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
|
|
</li>
|
|
</ul>
|
|
<p>
|
|
<b>Note: </b>If the ENDTIME is after the current time, the monitor will end at the time specified by ENDTIME today. If the ENDTIME is before the current time, the monitor will end at that time tomorrow.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.NBRMON"></a>
|
|
<h3>Number of monitors to start (NBRMON)</h3>
|
|
<p>Specifies the number of monitors to start with these characteristics. Only one monitor can be started when TYPE is *DIR.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>1</u></b></dt>
|
|
<dd>One monitor is started.
|
|
</dd>
|
|
<dt><b><i>1-99</i></b></dt>
|
|
<dd>Specify the number of monitors to start.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.INSTANCE"></a>
|
|
<h3>Instance (INSTANCE)</h3>
|
|
<p>Specifies the name of the instance to use.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QUSROND</u></b></dt>
|
|
<dd>The default OnDemand instance is used.
|
|
</dd>
|
|
<dt><b><i>instance-name</i></b></dt>
|
|
<dd>Specify the name of the instance that is to be used. By definition, the instance must be on the system that the command is run.
|
|
</dd>
|
|
<dt><b><i>library-server-name</i></b></dt>
|
|
<dd>Specify the TCP/IP host name of the library server. The name can also be specified as a TCP/IP dotted decimal address in the form of nnn.nnn.nnn.nnn.
|
|
<p>When a server name or TCP/IP address is entered, OnDemand uses the instance on that server that is using the default port. In most cases, this will also use the default instance.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.SBMJOB"></a>
|
|
<h3>Submit to batch (SBMJOB)</h3>
|
|
<p>Specify if you want to monitor the output queue or directory in the current job or in a another job.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>*YES must be specified when the NBRMON parameter is greater than 1.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>This command should be submitted to run in a different job.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>This command should be run within the current job. If you are entering this command from a terminal, this will prevent you from doing any other work from this terminal session until this command completes.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRMONOND.JOBD"></a>
|
|
<h3>Job description (JOBD)</h3>
|
|
<p>Specifies the name of the job description used for the submitted job.
|
|
</p>
|
|
<p><b>Qualifier 1: Job description</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QOND400</u></b></dt>
|
|
<dd>The QOND400 job description is used as the job description for the submitted job.
|
|
</dd>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name (name/name) of the job description used for the job.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>QRDARS</u></b></dt>
|
|
<dd>Library QRDARS is used as the job description's library.
|
|
</dd>
|
|
<dt><b>*LIBL</b></dt>
|
|
<dd>All libraries in the job's library list are searched until the first match is found.
|
|
</dd>
|
|
<dt><b>*CURLIB</b></dt>
|
|
<dd>The current library for the job is used to locate the job description name. 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 name is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRMONOND.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Simple Example</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRMONOND OUTQ(QUSRRDARS/ONDEMANDQ)
|
|
</pre>
|
|
</p>
|
|
<p>This command submits a job to batch that monitors for spooled files that are to be archived into OnDemand Common Server. When issued with no other parameters, the monitor uses the spooled file name attribute of the spooled file as both the application group name and application name. Spooled files that do not archive successfully are moved to the ONDERR output queue in the QUSRRDARS library. Spooled files that do archive successfully are also not deleted; they are moved to the ONDPROC output queue in the QUSRRDARS library. This command as shown will submit the monitor job without any specified end criteria, and will process within the default instance called QUSROND.
|
|
</p>
|
|
<p><b>Example 2: More Complex Example</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRMONOND OUTQ(QUSRRDARS/ONDEMANDQ)
|
|
APPGRPSRC(*SPLFNAME *FORMTYPE)APPSRC(*USERDATA)
|
|
DLTSPLF(*YES) ENDMON(*ENDTIME) ENDTIME(235900)
|
|
INSTANCE(ACCTING)
|
|
</pre>
|
|
</p>
|
|
<p>This command submits a job to batch that monitors for spooled files that are to be archived into OnDemand Common Server. The monitor attempts to use spooled file name and then form type attributes of the spooled file (in that order) for use as the application group name. The monitor uses the user data attribute of the spooled file as the application name. With this command example, successfully processed spooled files are deleted automatically; spooled files that do not archive successfully are moved to the ONDERR output queue in the QUSRRDARS library. In this example, the monitor will end at one minute before midnight of the current day. All processing will occur within the ACCTING instance.
|
|
</p>
|
|
<p><b>Example 3: Another More Complex Example</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRMONOND TYPE(*DIR) DIR('/mydir') APPGRPSRC(*SECOND)
|
|
APPSRC(*THIRD)DLTSPLF(*YES) INSTANCE(ACCTING)
|
|
</pre>
|
|
</p>
|
|
<p>This command submits a job to batch that monitors for stream files that are to be archived into OnDemand Common Server. The monitor uses the second part of the file name as the application group name and the third part of the file name as the application name. With this command example, successfully processed stream files are deleted automatically; stream files that do not archive successfully are retained in their current directory with the suffix of .ERR appended to the end of the file. All processing will occur within the ACCTING instance.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRMONOND.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>CPF1338</b></dt>
|
|
<dd>Errors occurred on SBMJOB command.
|
|
</dd>
|
|
<dt><b>OND0231</b></dt>
|
|
<dd>Output queue &1 in library &2 can not be monitored. No data queue is attached.
|
|
</dd>
|
|
<dt><b>OND0281</b></dt>
|
|
<dd>Output queue &1 in library &2 can not be monitored. Another monitor is already active.
|
|
</dd>
|
|
<dt><b>RDR0186</b></dt>
|
|
<dd>Output Queue &1 in library &2 not found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRMONOND.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|