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

347 lines
12 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 Disk Storage Management (STRDSMOND)</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="STRDSMOND.Top_Of_Page"></a>
<h2>Start Disk Storage Management (STRDSMOND)</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="#STRDSMOND.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRDSMOND.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRDSMOND.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRDSMOND"></a>
<p>The Start Disk Storage Management (STRDSMOND) command starts the Disk Storage Management (DSM) task which manages the movement of OnDemand data on disk and between disk and the Archived Storage Manager (ASM). DSM also controls the expiration of data in OnDemand. This function can be canceled with a controlled cancel option if enough time is allowed to end what it is currently processing.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRDSMOND.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="#STRDSMOND.APPGRP"><b>APPGRP</b></a></td>
<td valign="top">Application group</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#STRDSMOND.MGROPT"><b>MGROPT</b></a></td>
<td valign="top">Migration options</td>
<td valign="top"><b><u>*DATA</u></b>, *INDEXES, *ALL, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRDSMOND.EXPOPT"><b>EXPOPT</b></a></td>
<td valign="top">Expiration options</td>
<td valign="top"><b><u>*ALL</u></b>, *DATA, *INDEXES, *IMPIDX, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRDSMOND.STRASMOND"><b>STRASMOND</b></a></td>
<td valign="top">Run ASM</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRDSMOND.POLICY"><b>POLICY</b></a></td>
<td valign="top">Policy</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRDSMOND.INSTANCE"><b>INSTANCE</b></a></td>
<td valign="top">Instance</td>
<td valign="top"><i>Character value</i>, <b><u>QUSROND</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRDSMOND.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="#STRDSMOND.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><tr>
<td valign="top"><a href="#STRDSMOND.VALIDATE"><b>VALIDATE</b></a></td>
<td valign="top">Validate OnDemand disk storage</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="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRDSMOND.APPGRP"></a>
<h3>Application group (APPGRP)</h3>
<p>Specifies the name of the application group to perform management for.
</p>
<p>
<b>Note: </b>If you press the F4 key for this parameter while prompting the command, a list of the valid entries is presented to you. The entries listed are only valid for the default instance on the server the command is run on.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Management is done for all application groups.
</dd>
<dt><b><i>application-group</i></b></dt>
<dd>Only perform management for the named application group.
</dd>
</dl>
<p>If the value to be entered contains lower case letters, blanks, or special characters, it must be enclosed in apostrophes.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRDSMOND.MGROPT"></a>
<h3>Migration options (MGROPT)</h3>
<p>Specifies what migration functions are to be performed.
</p>
<dl>
<dt><b><u>*DATA</u></b></dt>
<dd>Migrate only OnDemand archived data.
</dd>
<dt><b>*INDEXES</b></dt>
<dd>Migrate only OnDemand index data.
<p>
<b>Note: </b>Migrated indexes cannot be searched without first importing them back into OnDemand. <b>Indexes that need to be searched should not be migrated.</b> Before allowing indexes to be migrated, be sure that is really what you want to do.
</p>
</dd>
<dt><b>*ALL</b></dt>
<dd>Migrate both OnDemand archived data and indexes.
<p>
<b>Note: </b>Migrated indexes cannot be searched without first importing them back into OnDemand. <b>Indexes that need to be searched should not be migrated.</b> Before allowing indexes to be migrated, be sure that is really what you want to do.
</p>
</dd>
<dt><b>*NONE</b></dt>
<dd>No migrations are done.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRDSMOND.EXPOPT"></a>
<h3>Expiration options (EXPOPT)</h3>
<p>Specifies what expiration functions are to be performed.
</p>
<dl>
<dt><b><u>*ALL</u></b></dt>
<dd>Perform all expiration options.
</dd>
<dt><b>*DATA</b></dt>
<dd>Expire only OnDemand archived data.
</dd>
<dt><b>*INDEXES</b></dt>
<dd>Expire only OnDemand index data.
</dd>
<dt><b>*IMPIDX</b></dt>
<dd>Expire only imported index data.
</dd>
<dt><b>*NONE</b></dt>
<dd>No expirations are done.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRDSMOND.STRASMOND"></a>
<h3>Run ASM (STRASMOND)</h3>
<p>Specifies whether to run the Archived Storage Management process after the Disk Storage Management process is finished.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>Run the Archived Storage Management process.
</dd>
<dt><b>*NO</b></dt>
<dd>Do not run the Archived Storage Management process.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRDSMOND.POLICY"></a>
<h3>Policy (POLICY)</h3>
<p>Specifies the name of the policy for Archived Storage Management to use when parameter STRASMOND is *YES.
</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 associated with the named policy to be managed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRDSMOND.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>
<dt><b><i>library-server-name</i></b></dt>
<dd>Specify the TCP/IP host name of the library server. The name can also be specified as a TCP/IP dotted decimal address in the form of nnn.nnn.nnn.nnn.
<p>When a server name or TCP/IP address is entered, OnDemand uses the instance on that server that is using the default port. In most cases, this will also use the default instance.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRDSMOND.SBMJOB"></a>
<h3>Submit to batch (SBMJOB)</h3>
<p>Specifies if DSM 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="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRDSMOND.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="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRDSMOND.VALIDATE"></a>
<h3>Validate OnDemand disk storage (VALIDATE)</h3>
<p>Specifies if OnDemand should validate its disk storage structures.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Do not validate the OnDemand disk structures.
</dd>
<dt><b>*YES</b></dt>
<dd>All disk storage files are inspected to ensure that they are correctly linked with the proper file permissions.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRDSMOND.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Simple Example</b>
</p>
<p>
<pre>
STRDSMOND
</pre>
</p>
<p>This command submits a job to batch that starts the OnDemand Common Server Disk Storage Management (DSM) task which manages the movement of OnDemand data on disk and between disk and the Archived Storage Manager (ASM). When issued with no parameters specified, this command processes data for ALL defined application groups in the default instance named QUSROND, migrating data and expiring both data and indexes. Additionally, with no parameters specified as in this example, it will automatically run ASM after the DSM processing finishes.
</p>
<p><b>Example 2: More Complex Example</b>
</p>
<p>
<pre>
STRDSMOND APPGRP(CHECKSTMTS) INSTANCE(ACCTING)
</pre>
</p>
<p>This command is similar to Example 1 but the Disk Storage Management process is run only for the Common Server application group called CHECKSTMTS within the ACCTING instance.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRDSMOND.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>OND0271</b></dt>
<dd>STRDSMOND ended in error.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRDSMOND.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>