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/strbkubrm.htm

524 lines
21 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>Start Backup using BRM (STRBKUBRM)</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="STRBKUBRM.Top_Of_Page"></a>
<h2>Start Backup using BRM (STRBKUBRM)</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="#STRBKUBRM.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRBKUBRM.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRBKUBRM.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRBKUBRM"></a>
<p>The Start Backup using BRM (STRBKUBRM) command selects a control group to back up. You can start the backup immediately or you can schedule it using the system job scheduler. Processing can be batch or interactive.
</p>
<p>To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
</p>
<p><b>Restrictions: </b>
</p>
<ol>
<li>This command should not be used by control group *EXIT item processing as results will be unpredictable.
</li>
<li>You must have *USE authority to backup item exit programs and *EXECUTE authority to libraries containing the backup item exit programs. *********** End @F0A *********************************
</li>
</ol>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRBKUBRM.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="#STRBKUBRM.CTLGRP"><b>CTLGRP</b></a></td>
<td valign="top">Control group</td>
<td valign="top"><i>Name</i>, *BKUGRP, *SYSGRP, *SYSTEM</td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#STRBKUBRM.SCDTIME"><b>SCDTIME</b></a></td>
<td valign="top">Schedule time</td>
<td valign="top"><i>Decimal number</i>, <b><u>*IMMED</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRBKUBRM.SBMJOB"><b>SBMJOB</b></a></td>
<td valign="top">Submit to batch</td>
<td valign="top"><b><u>*YES</u></b>, *CONSOLE, *CTLSBS, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#STRBKUBRM.STRSEQ"><b>STRSEQ</b></a></td>
<td valign="top">Starting sequence</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Number</td>
<td valign="top">
1-9999, <b><u>*FIRST</u></b></td>
</tr>
<tr>
<td valign="top">Element 2: Library</td>
<td valign="top">
<i>Name</i>, <b><u>*FIRST</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#STRBKUBRM.APPEND"><b>APPEND</b></a></td>
<td valign="top">Append to media</td>
<td valign="top"><b><u>*CTLGRPATR</u></b>, *BKUPCY, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#STRBKUBRM.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="#STRBKUBRM.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="#STRBKUBRM.ACTIVITY"><b>ACTIVITY</b></a></td>
<td valign="top">Activity</td>
<td valign="top"><b><u>*CTLGRPATR</u></b>, *FULL, *INCR</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#STRBKUBRM.RETENTION"><b>RETENTION</b></a></td>
<td valign="top">Retention</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Retention type</td>
<td valign="top">
<b><u>*CTLGRPATR</u></b>, *DAYS, *PERM</td>
</tr>
<tr>
<td valign="top">Element 2: Retain media</td>
<td valign="top">
1-9999, <b><u>35</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#STRBKUBRM.OMITS"><b>OMITS</b></a></td>
<td valign="top">Omits</td>
<td valign="top"><b><u>*PROCESS</u></b>, *IGNORE</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRBKUBRM.CTLGRP"></a>
<h3>Control group (CTLGRP)</h3>
<p>Specifies the name of the control group that you want to schedule for backup.
</p>
<p>Backup control groups are groups of libraries, special values and lists that share common backup characteristics. You can create multiple backup control groups to complete your backup strategy.
</p>
<p>This is a required field.
</p>
<dl>
<dt><b>*BKUGRP</b></dt>
<dd>The default backup control group is processed. The default backup user data control group is set up in the BRMS backup policy.
</dd>
<dt><b>*SYSGRP</b></dt>
<dd>The default system backup control group is processed. The default backup system data control group is set up when BRMS is installed.
</dd>
<dt><b>*SYSTEM</b></dt>
<dd>The default backup control group is processed. The default backup entire system control group is set up in the BRMS backup policy.
</dd>
<dt><b><i>control-group-name</i></b></dt>
<dd>Specify the name of the backup control group, such as DAILY that you want to process.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRBKUBRM.SCDTIME"></a>
<h3>Schedule time (SCDTIME)</h3>
<p>Specifies the time that you want BRMS to begin processing the backup.
</p>
<dl>
<dt><b><u>*IMMED</u></b></dt>
<dd>The backups are to begin immediately.
</dd>
<dt><b><i>start-time</i></b></dt>
<dd>Specify the time in hour and minutes that you want the backup to begin. The time is expressed in 24 hour clock format 'hhmm'.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRBKUBRM.SBMJOB"></a>
<h3>Submit to batch (SBMJOB)</h3>
<p>Specifies how you want to process the selected control group.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Submits the processing of the control group to batch. The job is dependent on the job queue and job description specified on subsequent parameters.
</dd>
<dt><b>*CONSOLE</b></dt>
<dd>Transfers the processing of the control group to the system console. This special value is used with the console monitoring function in BRMS.
</dd>
<dt><b>*CTLSBS</b></dt>
<dd>Submits the control group to the Q1ACTLSBS job queue in the controlling subsystem for batch processing.
<p>
<b>Note: </b>If the control group requires all subsystems to be ended, this special value should only be used if the backup can complete without operator intervention because the interactive system console job is ended and will not be available.
</p>
<p>If the control group requires all subsystems to be ended, system reference code A900 3C70 is displayed while the system is in restricted state. Unresponsive restricted state backups can be ended and the interactive system console job restarted in two ways:
</p>
<ol>
<li>Start DST from the control panel, sign on to DST, select option 14 - End batch restricted state.
</li>
<li>Specify a value for <b>Maximum time for backup </b>on the <b>System Policy </b>which is large enough to allow the backup job to complete but small enough to end the backup job if the controlling subsystem has not been restarted in the specified time.
</li>
</ol>
</dd>
<dt><b>*NO</b></dt>
<dd>Performs the processing of the control group within the current job.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRBKUBRM.STRSEQ"></a>
<h3>Starting sequence (STRSEQ)</h3>
<p>Specifies the sequence number and library from which you want to restart backup processing.
</p>
<p>
<b>Note: </b>If you are not restarting a control group, then you will always start at the first sequence number in the control group, regardless of the values specified in the STRSEQ parameter.
</p>
<p>
<b>Note: </b>You can use this parameter when *IBM, *ALLUSR, *ALLPROD, *ALLTEST,*ASPnn or a generic library name is specified as the Save item in the specified sequence number in the control group.
</p>
<p><b>Element 1: Number </b>
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>Backup processing starts with the first item in the control group.
</dd>
<dt><b><i>sequence-number</i></b></dt>
<dd>Specify the sequence number within the control group from which you want to restart backup processing.
</dd>
</dl>
<p><b>Element 2: Library </b>
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>Backup processing starts with the first library in the specified sequence number.
</dd>
<dt><b><i>library-name</i></b></dt>
<dd>Specify the name of the library within the sequence number from which you want to restart backup processing.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRBKUBRM.APPEND"></a>
<h3>Append to media (APPEND)</h3>
<p>Specifies whether you want to append the backup data for the backup processing you are restarting to an active volume.
</p>
<p>
<b>Note: </b>The APPEND parameter applies only to removable media, and must be *NO if media of class *ADSM (TSM server) is used.
</p>
<dl>
<dt><b><u>*CTLGRPATR</u></b></dt>
<dd>Use the value from the control group for <b>Append to media </b>.
</dd>
<dt><b>*BKUPCY</b></dt>
<dd>Use the value from the backup policy for <b>Append to media </b>.
</dd>
<dt><b>*NO</b></dt>
<dd>Do not append backup data for the backup you are restarting to an active volume.
</dd>
<dt><b>*YES</b></dt>
<dd>Append the backup data for the backup you are restarting to an active volume. Backup data is written to the volume immediately following the last active file on the volume.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRBKUBRM.JOBD"></a>
<h3>Job description (JOBD)</h3>
<p>Specifies the job description to be 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="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRBKUBRM.JOBQ"></a>
<h3>Job queue (JOBQ)</h3>
<p>Specifies the job queue in which this job is placed.
</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="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRBKUBRM.ACTIVITY"></a>
<h3>Activity (ACTIVITY)</h3>
<p>The Activity parameter allows you to specify the activity that is to be used when processing the control group. You can specify that the <b>Weekly activity</b> attribute of the control group entries is to be used or specify a specific type of activity which will override the <b>Weekly activity</b> attribute of the control group entries.
</p>
<p>Activity overrides must be enabled for the control group specified in the CTLGRP parameter when specifying a value other than *CTLGRPATR for the Activity parameter. Activity overrides for the control group can be enabled or disabled from the properties Activity tab for the BRMS backup policy using the BRMS iSeries Navigator client. The backup policy will have the same name as the control group name.
</p>
<p>Diagnostic message BRM400A is sent by the STRBKUBRM validity checking program if activity overrides are disabled and the value for the ACTIVITY parameter is not *CTLGRPATR.
</p>
<dl>
<dt><b><u>*CTLGRPATR</u></b></dt>
<dd>Specifies the <b>Weekly activity</b> attribute of the control group entries is to be used when processing the control group. This is the default value.
</dd>
<dt><b>*FULL</b></dt>
<dd>Specifies the <b>Weekly activity</b> attribute of the control group entries is to be overriden and processed as a full save. The override applies to all days of the week.
</dd>
<dt><b>*INCR</b></dt>
<dd>Specifies the <b>Weekly activity</b> attribute of the control group entries is to be overriden and processed as a incremental save. The type of incremental save is determined by the current value of the <b>Incremental type</b> attribute of the control group. The override applies to all days of the week. Each entry in the control group will be processed when the command is run regardless of the current value specified for the <b>Weekly activity</b> attribute for the entry. This includes exit entries. If the control group entry does not support incremental saves, the entry will not be processed and diagnostic message BRM400F will be entered into the job log.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRBKUBRM.RETENTION"></a>
<h3>Retention (RETENTION)</h3>
<p>The Retention parameter allows you to specify the retention attributes that are to be applied to objects saved by the control group. You can specify that the retention attributes of the media policies defined in the control group are to be used or specify new retention attributes which will override the media policy retention attributes.
</p>
<p>Retention overrides must be enabled for the control group specified in the CTLGRP parameter when specifying a value other than *CTLGRPATR for element 1 of the Retention. Retention overrides for the control group can be enabled or disabled using the properties Media Retention tab for the BRMS backup policy using the BRMS iSeries Navigator client. The backup policy will have the same name as the control group name.
</p>
<p>Diagnostic message BRM400B is sent by the STRBKUBRM validity checking program if retention overrides are disabled and the value for element 1 of the Retention parameter is not *CTLGRPATR.
</p>
<p><b>Element 1: Retention type</b>
</p>
<dl>
<dt><b><u>*CTLGRPATR</u></b></dt>
<dd>Specifies the retention attributes of the media policies defined in the control group are to be applied to the saved objects. This is the default value.
</dd>
<dt><b>*DAYS</b></dt>
<dd>Specifies days retention is to be applied to all objects saved by this control group. Saved objects remain active for the specified number of days, after which the saved objects expire. The <b>number-of-days</b> must be specified in element 2 when using this retention type.
</dd>
<dt><b>*PERM</b></dt>
<dd>Specifies a permanent retention is to be applied to all objects saved by this control group. Permanent retention means the saved objects remain active indefinitely or until explicitly expired.
</dd>
</dl>
<p><b>Element 2: Retain media</b>
</p>
<dl>
<dt><b><i>number-of-days</i></b></dt>
<dd>Specifies a number of days from 1-9999 that saved objects remain active.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRBKUBRM.OMITS"></a>
<h3>Omits (OMITS)</h3>
<p>Specifies whether omit items are to be processed or ignored when the backup control group is run.
</p>
<p>
<b>Note: </b>This attribute does not apply to backup lists or the <b>*SYSTEM </b> backup control group.
</p>
<dl>
<dt><b><u>*PROCESS</u></b></dt>
<dd>Process omit items during the save. Omit items will be excluded from the save
</dd>
<dt><b>*IGNORE</b></dt>
<dd>Ignore omitted items during the save. Omit items will be included in the save.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRBKUBRM.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Backing up a Control Group</b>
</p>
<p>
<pre>
STRBKUBRM CTLGRP(BACK01)
</pre>
</p>
<p>This command submits a batch job for backup control group BACK01. The batch job is not scheduled, so it will start immediately assuming batch job processing is active.
</p>
<p><b>Example 2: Overriding the Save Activity</b>
</p>
<p>
<pre>
STRBKUBRM CTLGRP(BACK01) ACTIVITY(FULL)
</pre>
</p>
<p>This command submits a batch job for backup control group BACK01. The control group is set up to normally perform cumulative saves. When this backup is run, the cumulative saves will be overriden and a full save will be performed.
</p>
<p><b>Example 3: Overriding the Save Retention</b>
</p>
<p>
<pre>
STRBKUBRM CTLGRP(BACK01) ACTIVITY(FULL)
RETENTION(*DAYS 2555)
</pre>
</p>
<p>This command submits a batch job for backup control group BACK01. The control group is set up to normally perform cumulative saves with a retention of 30 days. When this backup is run, the cumulative saves and retention will be overriden. A full save with a retention of 2555 days will be performed.
</p>
<p><b>Example 4: Overriding Omitted Save Items</b>
</p>
<p>
<pre>
STRBKUBRM CTLGRP(BACK01) ACTIVITY(FULL)
RETENTION(*DAYS 2555) OMITS(*IGNORE)
</pre>
</p>
<p>This command submits a batch job for backup control group BACK01. The control group is set up to normally perform cumulative saves with a retention of 30 days and uses omits defined in the backup policy. When this backup is run, the cumulative saves, retention and omits will be overriden. A full backup which includes the omit items will be performed and a retention of 2555 days will be applied to the save.
</p>
<p><b>Example 5: Submit to System Save to Batch</b>
</p>
<p>
<pre>
STRBKUBRM CTLGRP(*SYSTEM) SBMJOB(*CTLSBS)
</pre>
</p>
<p>This command submits the *SYSTEM backup control group to the controlling subsystem for batch processing. Since the backup does not use the BRMS console monitor or any interactive processing, the backup requires complete media management automation.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRBKUBRM.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>BRM1034</b></dt>
<dd>Control group &amp;1 type &amp;2 canceled.
</dd>
<dt><b>BRM1391</b></dt>
<dd>Control group &amp;2 type &amp;3 canceled.
</dd>
<dt><b>BRM1393</b></dt>
<dd>Control group &amp;2 type &amp;3 canceled.
</dd>
<dt><b>BRM1917</b></dt>
<dd>Feature not installed.
</dd>
<dt><b>BRM1921</b></dt>
<dd>Feature not licensed.
</dd>
<dt><b>BRM4041</b></dt>
<dd>Access denied for user &amp;1.
</dd>
<dt><b>BRM40A2</b></dt>
<dd>BRMS product initialization required.
</dd>
<dt><b>CPF3700</b></dt>
<dd>All CPF37xx messages could be signaled. xx is from 01 to FF.
</dd>
<dt><b>CPF3800</b></dt>
<dd>All CPF38xx messages could be signaled. xx is from 01 to FF.
</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="#STRBKUBRM.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink