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

233 lines
8.3 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 Archived Storage Mgmt (STRASMOND)</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="STRASMOND.Top_Of_Page"></a>
<h2>Start Archived Storage Mgmt (STRASMOND)</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="#STRASMOND.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRASMOND.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRASMOND.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRASMOND"></a>
<p>The Start Archived Storage Mgmt (STRASMOND) command starts the Archived Storage Management (ASM) process which manages the movement of data within the ASM defined levels. This function can be canceled with a controlled cancel option if enough time is allowed to end what it is currently processing.
</p>
<p>STRASMOND requires that the job it runs in allow DB2 to be set into server mode. This is only a concern if the command is run interactively. If any SQL statements have been processed in the interactive job before STRASMOND is run, STRASMOND will fail with SQL errors. To avoid this problem either always submit STRASMOND to batch (the default) or signoff and sign back on before running STRASMOND interactively.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRASMOND.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRASMOND.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="#STRASMOND.POLICY"><b>POLICY</b></a></td>
<td valign="top">Policy</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#STRASMOND.PROCESS"><b>PROCESS</b></a></td>
<td valign="top">Process to run</td>
<td valign="top"><b><u>*ALL</u></b>, *MIGRATION, *EXPIRATION</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRASMOND.INSTANCE"><b>INSTANCE</b></a></td>
<td valign="top">Instance</td>
<td valign="top"><i>Name</i>, <b><u>QUSROND</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRASMOND.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="#STRASMOND.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="#STRASMOND.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRASMOND.POLICY"></a>
<h3>Policy (POLICY)</h3>
<p>Specifies the name of the policy that Archived Storage Management will perform the requested functions against.
</p>
<p>
<b>Note: </b>If you press the F4 key for this parameter while prompting the command, a list of all the valid entries is presented to you.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>All policies are used. This causes all eligible data to be managed.
</dd>
<dt><b><i>policy-name</i></b></dt>
<dd>Specify the name of the policy that ASM is to process. This causes only the eligible data that is associated with the named policy to be managed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRASMOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRASMOND.PROCESS"></a>
<h3>Process to run (PROCESS)</h3>
<p>Specifies if the Archived Storage Management (ASM) process does migration processing, expiration processing, or both. You may want to separate these functions if you are concerned with how long ASM processing takes.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Both migration and expiration processing are done.
</dd>
<dt><b>*MIGRATION</b></dt>
<dd>Only migration processing is done.
</dd>
<dt><b>*EXPIRATION</b></dt>
<dd>Only expiration processing is done.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRASMOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRASMOND.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>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRASMOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRASMOND.SBMJOB"></a>
<h3>Submit to batch (SBMJOB)</h3>
<p>Specifies if ASM should run in batch or interactively.
</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="#STRASMOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRASMOND.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="#STRASMOND.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRASMOND.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Simple Example</b>
</p>
<p>
<pre>
STRASMOND
</pre>
</p>
<p>This command submits a job to batch that starts the OnDemand Common Server Archived Storage Management (ASM) process which manages the movement of data within the defined levels of archive media. When issued with no parameters specified, this command processes data for ALL defined storage management policies for the default QUSROND instance, and runs both migration and expiration processing.
</p>
<p><b>Example 2: More Complex Example</b>
</p>
<p>
<pre>
STRASMOND POLICY(APDATAPOL) PROCESS(*MIGRATION)
</pre>
</p>
<p>This command is Similar to Example 1 but processes only data associated with the APDATAPOL policy definition and runs only migration processing.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRASMOND.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRASMOND.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>OND0261</b></dt>
<dd>Archived process completed, some actions failed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRASMOND.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>