262 lines
10 KiB
HTML
262 lines
10 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 Archive using OnDemand (STRARCRDAR)</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="STRARCRDAR.Top_Of_Page"></a>
|
|
<h2>Start Archive using OnDemand (STRARCRDAR)</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="#STRARCRDAR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#STRARCRDAR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#STRARCRDAR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="STRARCRDAR"></a>
|
|
<p>The Start Archive using OnDemand (STRARCRDAR) command archives a copy of a single object or a group of objects located in the same library. The specified objects are archived by writing a copy of each object to the archive media as specified in the object policy (either optical or tape). The objects on the system are not affected unless the command specifies that the storage should be freed. The history for the object is not updated with the fact that it was archived. Only a save of the object using one of the system save commands will update the object's history.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRARCRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="STRARCRDAR.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="#STRARCRDAR.OBJ"><b>OBJ</b></a></td>
|
|
<td valign="top">Object</td>
|
|
<td valign="top"><i>Generic name, name</i>, *ALL</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRARCRDAR.LIB"><b>LIB</b></a></td>
|
|
<td valign="top">Library</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Required, Positional 2</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRARCRDAR.OBJTYPE"><b>OBJTYPE</b></a></td>
|
|
<td valign="top">Object type</td>
|
|
<td valign="top"><b><u>*ALL</u></b>, *ALRTBL, *BNDDIR, *CHTFMT, *CLD, *CLS, *CRQD, *CMD, *CSI, *CSPMAP, *CSPTBL, *DTAARA, *DTAQ, *EDTD, *EXITRG, *FCT, *FILE, *FNTRSC, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IGCTBL, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *MENU, *MODULE, *MSGF, *MSGQ, *NODGRP, *NODL, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SRVPGM, *SSND, *SVRSTG, *S36, *TBL, *USRIDX, *USRQ, *USRSPC, *WSCST</td>
|
|
<td valign="top">Optional, Positional 3</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRARCRDAR.STG"><b>STG</b></a></td>
|
|
<td valign="top">Storage</td>
|
|
<td valign="top"><b><u>*KEEP</u></b>, *FREE</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRARCRDAR.DETAIL"><b>DETAIL</b></a></td>
|
|
<td valign="top">Detail</td>
|
|
<td valign="top"><b><u>*BASIC</u></b>, *FULL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRARCRDAR.TEXT"><b>TEXT</b></a></td>
|
|
<td valign="top">Text 'description'</td>
|
|
<td valign="top"><i>Character value</i>, <b><u>*BLANK</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#STRARCRDAR.RESTART"><b>RESTART</b></a></td>
|
|
<td valign="top">Restart</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="#STRARCRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="STRARCRDAR.OBJ"></a>
|
|
<h3>Object (OBJ)</h3>
|
|
<p>Specifies the names of an object or the generic name of a group of objects to be archived. All the objects must be in the same library, specified on the <b>Library (LIB)</b> parameter. If the <b>Object type (OBJTYPE)</b> parameter is not specified, all the object types listed in the description of that parameter are archived provided they have the specified names.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*ALL</b></dt>
|
|
<dd>All the objects in the specified library of the type specified by the Object type (OBJTYPE) parameter are archived.
|
|
</dd>
|
|
<dt><b><i>generic*-object-name</i></b></dt>
|
|
<dd>Specify a generic name for the group of objects in the specified library to be archived.
|
|
</dd>
|
|
<dt><b><i>object-name</i></b></dt>
|
|
<dd>Specify the name of a specific object to archive.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRARCRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRARCRDAR.LIB"></a>
|
|
<h3>Library (LIB)</h3>
|
|
<p>Specifies the library that contains the objects to archive. Type the name of the library.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRARCRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRARCRDAR.OBJTYPE"></a>
|
|
<h3>Object type (OBJTYPE)</h3>
|
|
<p>Specifies the types of system objects to archive. For a complete list of object types that can be archived, move the cursor to the field for the <b>Object type (OBJTYPE)</b> parameter and press the F4 key.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*ALL</u></b></dt>
|
|
<dd>All object types that are specified by name and are in the specified library are archived. If *ALL is also specified on the <b>Object (OBJ)</b> parameter, then all the objects in the library that are of the types that can be saved are archived.
|
|
</dd>
|
|
<dt><b><i>object-type</i></b></dt>
|
|
<dd>Specify the value for each of the types of objects that are archived, such as command (*CMD), file (*FILE), or program (*PGM).
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRARCRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRARCRDAR.STG"></a>
|
|
<h3>Storage (STG)</h3>
|
|
<p>Specifies whether the system storage that is occupied by the data portion of files, programs, Structured Query Language (SQL) packages, and journal receivers in the library being archived is freed as part of the archive operation. Only the data portion of the objects is deleted (freed) not the descriptions of the objects.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*KEEP</u></b></dt>
|
|
<dd>The storage occupied by the data portion of the archived objects is not freed.
|
|
</dd>
|
|
<dt><b>*FREE</b></dt>
|
|
<dd>The storage occupied by the data portion of the files, programs, SQL packages, and journal receivers being archived is freed as part of the archive operation. The storage for all the objects in a library is freed only after all the objects in that library are archived successfully.
|
|
<p>
|
|
<b>Note: </b>To prevent the abnormal end of a program, the program being archived must not be running in the system if *FREE specified.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRARCRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRARCRDAR.DETAIL"></a>
|
|
<h3>Detail (DETAIL)</h3>
|
|
<p>Specifies the amount of detail that is provided about the archive operation. This information is printed with the job's spooled output in the printer file QPRLOARC.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BASIC</u></b></dt>
|
|
<dd>A list of the parameters specified on the command, the object policy used and statistics about the archive are listed.
|
|
</dd>
|
|
<dt><b>*FULL</b></dt>
|
|
<dd>In addition to the information provided by the *BASIC parameter, a list of each object archived is provided.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRARCRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRARCRDAR.TEXT"></a>
|
|
<h3>Text 'description' (TEXT)</h3>
|
|
<p>Specifies text that briefly describes the archive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*BLANK</u></b></dt>
|
|
<dd>No text is specified.
|
|
</dd>
|
|
<dt><b><i>'description'</i></b></dt>
|
|
<dd>Specify no more than 50 characters of text, enclosed in apostrophes. This text is stored by OnDemand, along with other object information. This text also appears in the printer file QPRLOARC that is printed when you archive objects.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRARCRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="STRARCRDAR.RESTART"></a>
|
|
<h3>Restart (RESTART)</h3>
|
|
<p>Specifies whether this is a restart of a previously failed archive.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*NO</u></b></dt>
|
|
<dd>This is not a restart of a previously failed archive.
|
|
</dd>
|
|
<dt><b>*YES</b></dt>
|
|
<dd>This is a restart of a previously failed archive.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRARCRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRARCRDAR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Simple Example</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRARCRDAR OBJ(MYOBJECT) LIB(MYLIB)
|
|
</pre>
|
|
</p>
|
|
<p>This command archives objects of any type in MYLIB library by the name of MYOBJECT into OnDemand Object Archive.
|
|
</p>
|
|
<p><b>Example 2: More Complex Example</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
STRARCRDAR OBJ(MYOBJECT) LIB(MYLIB) OBJTYPE(*FILE)
|
|
</pre>
|
|
</p>
|
|
<p>This command is similar to Example 1 but archives only objects of type *FILE.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRARCRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="STRARCRDAR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>RDR1001</b></dt>
|
|
<dd>Previous archive for library &1 failed and RESTART(*NO) was specified.
|
|
</dd>
|
|
<dt><b>RDR1002</b></dt>
|
|
<dd>Archive for library &1 already in progress
|
|
</dd>
|
|
<dt><b>RDR1003</b></dt>
|
|
<dd>Archive restart failed.
|
|
</dd>
|
|
<dt><b>RDR1005</b></dt>
|
|
<dd>Archive failed. &1 objects successfully archived.
|
|
</dd>
|
|
<dt><b>RDR1006</b></dt>
|
|
<dd>Archive failed. No objects archived.
|
|
</dd>
|
|
<dt><b>RDR1007</b></dt>
|
|
<dd>Object Control Table (OCT) missing default entry.
|
|
</dd>
|
|
<dt><b>RDR1008</b></dt>
|
|
<dd>Object policy &1 not found.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#STRARCRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|