ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/chgscdbrm.htm

293 lines
11 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!doctype html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><META http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Change Job Scheduler (CHGSCDBRM)</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="CHGSCDBRM.Top_Of_Page"></a>
<h2>Change Job Scheduler (CHGSCDBRM)</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="#CHGSCDBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGSCDBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGSCDBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGSCDBRM"></a>
<p>BRMS uses the i5/OS job scheduler as the default job scheduler. You can also choose to use the IBM Job Scheduler for iSeries job scheduler as your default scheduler or select any other i5/OS job scheduler as your default.
</p>
<p>The Change Job Scheduler for BRM (CHGSCDBRM) command changes the job scheduler interface used by BRMS. You can use the i5/OS job scheduler, which is the default, IBM Job Scheduler for iSeries or another job scheduler that you choose. You can change the commands that BRMS uses to add, list and select job schedule entries. You can also specify whether you want to be prompted when BRMS uses these commands.
</p>
<p>The following substitution variables can be used in these commands to pass values from BRMS to the scheduler:
</p>
<ul>
<li>&amp;JOBNAME - QBRMBKUP or QBRMARC
</li>
<li>&amp;REQUEST - will be either STRARCBRM or STRBKUBRM
</li>
<li>&amp;APPL - BRMS
</li>
<li>&amp;GROUP - control group name
</li>
</ul>
<p>You can change these to your operating requirements or choose to use the defaults.
</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="#CHGSCDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGSCDBRM.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="#CHGSCDBRM.TYPE"><b>TYPE</b></a></td>
<td valign="top">Scheduler type</td>
<td valign="top"><b><u>*SYSTEM</u></b>, *IJS, *USRDFN</td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSCDBRM.ADDCMD"><b>ADDCMD</b></a></td>
<td valign="top">Add a job command</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *IJS, *SYSTEM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSCDBRM.ADDPMT"><b>ADDPMT</b></a></td>
<td valign="top">Command prompt for add</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSCDBRM.LISTCMD"><b>LISTCMD</b></a></td>
<td valign="top">List jobs command</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *IJS, *SYSTEM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSCDBRM.LISTPMT"><b>LISTPMT</b></a></td>
<td valign="top">Command prompt for list</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSCDBRM.SLTCMD"><b>SLTCMD</b></a></td>
<td valign="top">Select jobs command</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *IJS, *SYSTEM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGSCDBRM.SLTPMT"><b>SLTPMT</b></a></td>
<td valign="top">Command prompt for select</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGSCDBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGSCDBRM.TYPE"></a>
<h3>Scheduler type (TYPE)</h3>
<p>Specifies which scheduler you want to use for scheduling BRMS control groups and commands. Any commercial or user developed scheduler can be used with BRMS.
</p>
<dl>
<dt><b><u>*SYSTEM</u></b></dt>
<dd>Specifies that BRMS is to use the i5/OS job scheduler and its associated command set.
<p>
<b>Note: </b>When you specify *SYSTEM for the <b>Scheduler type (TYPE)</b> parameter, the ADDCMD, ADDPMT, LISTCMD, LISTPMT, SLTCMD and SLTPMT parameters are ignored.
</p>
</dd>
<dt><b>*IJS</b></dt>
<dd>Specifies that BRMS is to use IBM Job Scheduler for iSeries and its associated command set.
<p>
<b>Note: </b>When you specify *IJS for the <b>Scheduler type (TYPE)</b> parameter, the ADDCMD, ADDPMT, LISTCMD, LISTPMT, SLTCMD and SLTPMT parameters are ignored.
</p>
</dd>
<dt><b>*USRDFN</b></dt>
<dd>Specifies that you want to use another scheduling package command set or change the way in which BRMS starts the i5/OS job scheduler.
<p>
<b>Note: </b>When you specify *USRDFN in the <b>Scheduler type (TYPE)</b> parameter, all of the job scheduler commands are displayed and can be changed.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSCDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSCDBRM.ADDCMD"></a>
<h3>Add job command (ADDCMD)</h3>
<p>Specifies an alternative command to be used by BRMS to add a job schedule entry. When you are in a BRMS function that allows you to add a job to the job scheduler, the command that you specify here is started in lieu of the BRMS default command.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The command used does not change.
</dd>
<dt><b>*IJS</b></dt>
<dd>The Job Scheduler for iSeries command to add a job to the job schedule is used.
</dd>
<dt><b>*SYSTEM</b></dt>
<dd>The i5/OS command to add a job to the job schedule is used.
</dd>
<dt><b><i>user-command</i></b></dt>
<dd>Specify the command that you want BRMS to use when adding a job schedule entry.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSCDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSCDBRM.ADDPMT"></a>
<h3>Command prompt for add (ADDPMT)</h3>
<p>Specifies whether BRMS should prompt the command specified in the <b>Add a job command (ADDCMD)</b> parameter.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The command is not prompted when started by BRMS.
</dd>
<dt><b>*YES</b></dt>
<dd>The command is prompted when started by BRMS.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSCDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSCDBRM.LISTCMD"></a>
<h3>List jobs command (LISTCMD)</h3>
<p>Specifies an alternative command to be used by BRMS to list all jobs in the job schedule. When you are in a BRMS function that allows you to list all jobs in the job schedule the command that you specify here is started.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The command used does not change.
</dd>
<dt><b>*IJS</b></dt>
<dd>The Job Scheduler for iSeries command to list all jobs in the job schedule is used.
</dd>
<dt><b>*SYSTEM</b></dt>
<dd>The i5/OS command to list all jobs in the job schedule is used.
</dd>
<dt><b><i>user-command</i></b></dt>
<dd>Specify the command that you want to use when listing all jobs in the job schedule.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSCDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSCDBRM.LISTPMT"></a>
<h3>Command prompt for list (LISTPMT)</h3>
<p>Specifies whether BRMS should prompt the command specified in the <b>List jobs command (LISTCMD)</b> parameter.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The command is not prompted when started by BRMS.
</dd>
<dt><b>*YES</b></dt>
<dd>The command is prompted when started by BRMS.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSCDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSCDBRM.SLTCMD"></a>
<h3>Select jobs command (SLTCMD)</h3>
<p>Specifies an alternative command to be used by BRMS to list selected jobs in the job schedule. When you are in a BRMS function that allows you to select a list of BRMS jobs in the job schedule, the command that you specify here is started.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The command used does not change.
</dd>
<dt><b>*IJS</b></dt>
<dd>The Job Scheduler for iSeries command to select jobs in the job schedule is used.
</dd>
<dt><b>*SYSTEM</b></dt>
<dd>The i5/OS command to select jobs in the job schedule is used.
</dd>
<dt><b><i>user-command</i></b></dt>
<dd>Specify the command that you want BRMS to use when listing BRMS jobs in the job schedule.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSCDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGSCDBRM.SLTPMT"></a>
<h3>Command prompt for list (SLTPMT)</h3>
<p>Specifies whether BRMS should prompt the command specified in the <b>Select jobs command (SLTCMD)</b> parameter.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The command is not prompted when started by BRMS.
</dd>
<dt><b>*YES</b></dt>
<dd>The command is prompted when started by BRMS.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSCDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGSCDBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p>
<pre>
CHGSCDBRM TYPE(*USRDFN) ADDCMD('ADDJOBJS JOB(&amp;JOBNAME)
APP(&amp;APPL) SCDCDE(*DAILY) TIME (2300)
CMD(&amp;REQUEST)') ADDPMT(*YES)
</pre>
</p>
<p>This command changes the CL command used by BRMS to add a job schedule entry. In this example, an alternative scheduler is being used. When adding a back up job to the schedule BRMS will use the ADDJOBJS command and the substitution variables specified here.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGSCDBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGSCDBRM.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>BRM4040</b></dt>
<dd>Access denied for user &amp;1.
</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="#CHGSCDBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>