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

573 lines
17 KiB
HTML
Raw 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 Backup Options (CHGBCKUP)</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="CHGBCKUP.Top_Of_Page"></a>
<h2>Change Backup Options (CHGBCKUP)</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="#CHGBCKUP.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGBCKUP.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGBCKUP.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGBCKUP"></a>
<p>The Change Backup Options (CHGBCKUP) command allows the user to change the options in one of the predefined backups. More information on backup is in the Backup and Recovery book, SC41-5304.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGBCKUP.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="#CHGBCKUP.BCKUPOPT"><b>BCKUPOPT</b></a></td>
<td valign="top">Backup options</td>
<td valign="top">*DAILY, *WEEKLY, *MONTHLY</td>
<td valign="top">Required, Key, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.DEV"><b>DEV</b></a></td>
<td valign="top">Device</td>
<td valign="top">Single values: <b><u>*SAME</u></b><br>Other values (up to 4 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.TAPSET"><b>TAPSET</b></a></td>
<td valign="top">Tape set</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *ANY<br>Other values (up to 7 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.CLRTAP"><b>CLRTAP</b></a></td>
<td valign="top">Clear the tape</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.SBMJOB"><b>SBMJOB</b></a></td>
<td valign="top">Submit to batch</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.CHGONLY"><b>CHGONLY</b></a></td>
<td valign="top">Changed objects only</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.PRTRPT"><b>PRTRPT</b></a></td>
<td valign="top">Print detailed report</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.LIB"><b>LIB</b></a></td>
<td valign="top">Library</td>
<td valign="top"><b><u>*SAME</u></b>, *ALLUSR, *FROMLIST, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.FLR"><b>FLR</b></a></td>
<td valign="top">Folder</td>
<td valign="top"><b><u>*SAME</u></b>, *ALL, *FROMLIST, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.DIR"><b>DIR</b></a></td>
<td valign="top">Directory</td>
<td valign="top"><b><u>*SAME</u></b>, *ALLUSR, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.SECDTA"><b>SECDTA</b></a></td>
<td valign="top">Save security data</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.CFG"><b>CFG</b></a></td>
<td valign="top">Save configuration data</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.MAIL"><b>MAIL</b></a></td>
<td valign="top">Save mail</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGBCKUP.CAL"><b>CAL</b></a></td>
<td valign="top">Save calendar data</td>
<td valign="top"><b><u>*SAME</u></b>, *YES, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGBCKUP.EXITPGM"><b>EXITPGM</b></a></td>
<td valign="top">User exit program</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values: <i>Qualified object name</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: User exit program</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></table>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGBCKUP.BCKUPOPT"></a>
<h3>Backup options (BCKUPOPT)</h3>
<p>Specifies the backup options to be changed.
</p>
<p>This is a required parameter.
</p>
<dl>
<dt><b>*DAILY</b></dt>
<dd>The options for the daily backup are changed.
</dd>
<dt><b>*WEEKLY</b></dt>
<dd>The options for the weekly backup are changed.
</dd>
<dt><b>*MONTHLY</b></dt>
<dd>The options for the monthly backup are changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the tape device to use for the backup.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The tape device name stored in the specified options is not changed.
</dd>
</dl>
<p><b>Other values (up to 4 repetitions)</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify a list of tape device names to use with the specified backup options. If you are using a virtual tape devices you can only specify one device name.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.TAPSET"></a>
<h3>Tape set (TAPSET)</h3>
<p>Specifies the name of the tape set to be used.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The tape set name stored in the specified options is not changed.
</dd>
<dt><b>*ANY</b></dt>
<dd>The tapes mounted on the backup devices are used for the backup. Tape volume IDs are not checked.
</dd>
</dl>
<p><b>Other values (up to 7 repetitions)</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify a list of 4-character names of tape volume sets to be rotated for the backup. The tape volume IDs for the backup are generated by concatenating sequential numbers starting with '01' to the specified prefix.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.CLRTAP"></a>
<h3>Clear the tape (CLRTAP)</h3>
<p>Specifies whether to clear the tape and start the save at sequence number 1.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The Clear Tape indicator stored in the specified options is not changed.
</dd>
<dt><b>*YES</b></dt>
<dd>The tape is cleared and the save starts at sequence number 1 (equivalent to CLEAR(*ALL) SEQNBR(1) on the SAVxxx commands).
</dd>
<dt><b>*NO</b></dt>
<dd>The tape is not cleared and the save starts after the last active file on the tape (equivalent to CLEAR(*NONE) SEQNBR(*END) on the SAVxxx commands).
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.SBMJOB"></a>
<h3>Submit to batch (SBMJOB)</h3>
<p>Specifies whether to submit the backup as a batch job when the RUNBCKUP menu is used to run a backup using these options.
</p>
<p>
<b>Note: </b>This parameter is ignored when the RUNBCKUP command is used to run a backup.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The Submit Job indicator stored in the specified options is not changed.
</dd>
<dt><b>*YES</b></dt>
<dd>The backup is submitted as a batch job when the menu is used to perform the backup.
</dd>
<dt><b>*NO</b></dt>
<dd>The backup is run interactively when the menu is used to perform the backup.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.CHGONLY"></a>
<h3>Changed objects only (CHGONLY)</h3>
<p>Specifies whether to save only changed objects in the libraries and folders to be backed up.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The Save Changed Only indicator stored in the specified options is not changed.
</dd>
<dt><b>*YES</b></dt>
<dd>Only objects changed since the last backup are saved.
</dd>
<dt><b>*NO</b></dt>
<dd>All of the objects in the requested libraries and folders are backed up.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.PRTRPT"></a>
<h3>Print detailed report (PRTRPT)</h3>
<p>Specifies whether a detailed list of saved objects is printed. A summary report is always printed.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The Print Report indicator stored in the specified options is not changed.
</dd>
<dt><b>*YES</b></dt>
<dd>A detailed list of saved objects and a summary report are printed.
</dd>
<dt><b>*NO</b></dt>
<dd>A summary report is printed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.LIB"></a>
<h3>Library (LIB)</h3>
<p>Specifies which libraries are backed up.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The libraries specified in the options are not changed.
</dd>
<dt><b>*ALLUSR</b></dt>
<dd>Performs a backup of all user libraries. All libraries with names that do not begin with the letter Q are backed up except for the following:
<p>
<pre>
#CGULIB #DSULIB #SEULIB
#COBLIB #RPGLIB
#DFULIB #SDALIB
</pre>
</p>
<p>Although the following Qxxx libraries are provided by IBM, they typically contain user data that changes frequently. Therefore, these libraries are considered "user libraries", and are also backed up:
</p>
<p>
<pre>
QDSNX QRCLxxxxx QUSRIJS QUSRVxRxMx
QGPL QSRVAGT QUSRINFSKR
QGPL38 QSYS2 QUSRNOTES
QMGTC QSYS2xxxxx QUSROND
QMGTC2 QS36F QUSRPOSGS
QMPGDATA QUSER38 QUSRPOSSA
QMQMDATA QUSRADSM QUSRPYMSVR
QMQMPROC QUSRBRM QUSRRDARS
QPFRDATA QUSRDIRCL QUSRSYS
QRCL QUSRDIRDB QUSRVI
</pre>
</p>
<p>
<b>Note: </b>A different library name, in the format QUSRVxRxMx, can be created by the user for each previous release supported by IBM to contain any user commands to be compiled in a CL program for the previous release. For the QUSRVxRxMx user library, VxRxMx is the version, release, and modification level of a previous release that IBM continues to support.
</p>
</dd>
<dt><b>*FROMLIST</b></dt>
<dd>The libraries selected for backup in the library backup list are backed up.
</dd>
<dt><b>*NONE</b></dt>
<dd>No libraries are backed up.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.FLR"></a>
<h3>Folder (FLR)</h3>
<p>Specifies which folders are backed up.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The folders specified in the options are not changed.
</dd>
<dt><b>*ALL</b></dt>
<dd>All folders are backed up.
</dd>
<dt><b>*FROMLIST</b></dt>
<dd>The folders selected for backup in the folder backup list are backed up.
</dd>
<dt><b>*NONE</b></dt>
<dd>No folders are backed up.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.DIR"></a>
<h3>Directory (DIR)</h3>
<p>Specifies which user directories are backed up.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The directories specified in the options are not changed.
</dd>
<dt><b>*ALLUSR </b></dt>
<dd>All user directories are backed up.
</dd>
<dt><b>*NONE</b></dt>
<dd>No directories are backed up.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.SECDTA"></a>
<h3>Save security data (SECDTA)</h3>
<p>Specifies whether to save the system security data.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The Security Data indicator stored in the specified options is not changed.
</dd>
<dt><b>*YES</b></dt>
<dd>Security data is saved when this backup is run.
</dd>
<dt><b>*NO</b></dt>
<dd>Security data is not saved.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.CFG"></a>
<h3>Save configuration data (CFG)</h3>
<p>Specifies whether to save the system configuration data.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The Configuration Data indicator stored in the specified options is not changed.
</dd>
<dt><b>*YES</b></dt>
<dd>Configuration data is saved when this backup is run.
</dd>
<dt><b>*NO</b></dt>
<dd>Configuration data is not saved.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.MAIL"></a>
<h3>Save mail (MAIL)</h3>
<p>Specifies whether to save OfficeVision mail. This parameter is ignored if FLR(*ALL) is specified.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The Mail indicator stored in the specified options is not changed.
</dd>
<dt><b>*YES</b></dt>
<dd>Mail is saved when this backup is run.
</dd>
<dt><b>*NO</b></dt>
<dd>Mail is not saved.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.CAL"></a>
<h3>Save calendar data (CAL)</h3>
<p>Specifies whether to save OfficeVision calendar data. OfficeVision calendars are also saved when QUSRSYS is saved.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The calendar indicator stored in the specified options is not changed.
</dd>
<dt><b>*YES</b></dt>
<dd>Calendars are saved when this backup is run.
</dd>
<dt><b>*NO</b></dt>
<dd>Calendars are not saved.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGBCKUP.EXITPGM"></a>
<h3>User exit program (EXITPGM)</h3>
<p>Specifies the user program to call before the backup begins and again after the backup is complete.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The program name stored in the specified options is not changed.
</dd>
<dt><b>*NONE</b></dt>
<dd>No exit program is called.
</dd>
</dl>
<p><b>Qualifier 1: User exit program</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the program to call before and after the backup.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the library list for the current thread are searched until the first match is found.
</dd>
</dl>
<dl>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the program. If no library is specified as the current library for the job, the QGPL library is used.
</dd>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library where the program is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGBCKUP.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Changing the Daily Backup Options</b>
</p>
<p>
<pre>
CHGBCKUP BCKUPOPT(*DAILY) MAIL(*YES) CAL(*YES)
</pre>
</p>
<p>This command changes the daily backup to save the OfficeVision mail and calendar data.
</p>
<p><b>Example 2: Changing the Monthly Backup Options</b>
</p>
<p>
<pre>
CHGBCKUP BCKUPOPT(*MONTHLY) DEV(TAP01 TAP02)
TAPSET(RED GRN BLU)
</pre>
</p>
<p>This command changes the monthly backup to use tape devices TAP01 and TAP02 and tape sets RED, GRN, and BLU.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGBCKUP.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF1EEA</b></dt>
<dd>Not authorized to library backup list.
</dd>
<dt><b>CPF1EEB</b></dt>
<dd>Not authorized to folder backup list.
</dd>
<dt><b>CPF1EE0</b></dt>
<dd>Device &amp;1 specified more than once.
</dd>
<dt><b>CPF1EE1</b></dt>
<dd>Tape set name &amp;1 specified more than once.
</dd>
<dt><b>CPF1EE2</b></dt>
<dd>Cannot specify *ANY and a tape set name.
</dd>
<dt><b>CPF1EE3</b></dt>
<dd>Not authorized to backup options.
</dd>
<dt><b>CPF1EE4</b></dt>
<dd>Not authorized to run backup.
</dd>
<dt><b>CPF1EE5</b></dt>
<dd>Device &amp;1 not a tape device.
</dd>
<dt><b>CPF1E6C</b></dt>
<dd>Backup options in use.
</dd>
<dt><b>CPF1E6E</b></dt>
<dd>Nothing selected for backup.
</dd>
<dt><b>CPF1E6F</b></dt>
<dd>Tape set name &amp;1 is not valid.
</dd>
<dt><b>CPF1E67</b></dt>
<dd>Backup options and library backup list damaged.
</dd>
<dt><b>CPF1E99</b></dt>
<dd>Unexpected error occurred.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGBCKUP.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>