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

523 lines
18 KiB
HTML
Raw Permalink 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>Start Coded Data Store (STRCDSRDAR)</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="STRCDSRDAR.Top_Of_Page"></a>
<h2>Start Coded Data Store (STRCDSRDAR)</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="#STRCDSRDAR.PARAMETERS.TABLE">Parameters</a><br>
<a href="#STRCDSRDAR.COMMAND.EXAMPLES">Examples</a><br>
<a href="#STRCDSRDAR.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="STRCDSRDAR"></a>
<p>The Start Coded Data Store (STRCDSRDAR) command allows you to store reports in OnDemand. During this process the report is broken into segments, indexed, compressed, and stored on disk for retrieval and later migration to optical or tape media if desired.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="STRCDSRDAR.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="#STRCDSRDAR.REPORT"><b>REPORT</b></a></td>
<td valign="top">Report name</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#STRCDSRDAR.VERSION"><b>VERSION</b></a></td>
<td valign="top">Version</td>
<td valign="top">1-99, <b><u>01</u></b>, *HIGHEST</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRCDSRDAR.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" rowspan="3"><a href="#STRCDSRDAR.FILE"><b>FILE</b></a></td>
<td valign="top">Input file</td>
<td valign="top">Single values: <b><u>*SPLF</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: Input file</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="#STRCDSRDAR.MBR"><b>MBR</b></a></td>
<td valign="top">Member</td>
<td valign="top"><i>Name</i>, <b><u>*FIRST</u></b>, *LAST</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRCDSRDAR.SPLF"><b>SPLF</b></a></td>
<td valign="top">Spooled file</td>
<td valign="top"><i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="4"><a href="#STRCDSRDAR.JOB"><b>JOB</b></a></td>
<td valign="top">Job name</td>
<td valign="top">Single values: <b><u>*</u></b><br>Other values: <i>Qualified job name</i></td>
<td valign="top" rowspan="4">Optional</td>
</tr>
<tr>
<td valign="top">Qualifier 1: Job name</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 2: User</td>
<td valign="top"><i>Name</i></td>
</tr><tr>
<td valign="top">Qualifier 3: Number</td>
<td valign="top">000000-999999</td>
</tr><tr>
<td valign="top"><a href="#STRCDSRDAR.SPLNBR"><b>SPLNBR</b></a></td>
<td valign="top">Spooled file number</td>
<td valign="top">1-999999, <b><u>*ONLY</u></b>, *LAST, *ANY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRCDSRDAR.JOBSYSNAME"><b>JOBSYSNAME</b></a></td>
<td valign="top">Job system name</td>
<td valign="top"><i>Name</i>, <b><u>*ONLY</u></b>, *CURRENT, *ANY</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#STRCDSRDAR.CRTDATE"><b>CRTDATE</b></a></td>
<td valign="top">Spool file created</td>
<td valign="top">Single values: <b><u>*ONLY</u></b>, *LAST<br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Creation date</td>
<td valign="top">
<i>Date</i></td>
</tr>
<tr>
<td valign="top">Element 2: Creation time</td>
<td valign="top">
<i>Time</i>, <b><u>*ONLY</u></b>, *LAST</td>
</tr>
<tr>
<td valign="top"><a href="#STRCDSRDAR.DLTINPUT"><b>DLTINPUT</b></a></td>
<td valign="top">Delete input file</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#STRCDSRDAR.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="#STRCDSRDAR.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>QRDARS400</u></b></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="#STRCDSRDAR.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="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="STRCDSRDAR.REPORT"></a>
<h3>Report name (REPORT)</h3>
<p>Specifies the name of the report to process.
</p>
<p>This is a required parameter.
</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>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.VERSION"></a>
<h3>Version (VERSION)</h3>
<p>Specifies which version of the report definition is used to store the report.
</p>
<dl>
<dt><b><u>01</u></b></dt>
<dd>The first version of the report definition is used.
</dd>
<dt><b>*HIGHEST</b></dt>
<dd>The highest defined version of the report definition is used.
</dd>
<dt><b><i>01-99</i></b></dt>
<dd>Specify the version number of the report to use.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies text that briefly describes the storing of this report. This text becomes the description of the stored report that is presented to the end user.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>No text is specified. The report description from the report definition is used as the text.
</dd>
<dt><b><i>'description'</i></b></dt>
<dd>Specify no more than 50 characters of text, enclosed in apostrophes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.FILE"></a>
<h3>Input file (FILE)</h3>
<p>Specifies where to find the report data to store.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SPLF</u></b></dt>
<dd>The report data is read from the spooled file specified by the SPLF, JOB, and SPLNBR parameters.
</dd>
</dl>
<p><b>Qualifier 1: Input file</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the database file that contains the report data to store. The first character in each line of this data must contain a valid ASA forms control character.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></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 where the file is located. 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 database file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.MBR"></a>
<h3>Member (MBR)</h3>
<p>Specifies the name of the database member which contains the report data to store.
</p>
<dl>
<dt><b><u>*FIRST</u></b></dt>
<dd>The first member in the database file contains the report data to store.
</dd>
<dt><b>*LAST</b></dt>
<dd>The last member in the database file contains the report data to store.
</dd>
<dt><b><i>member-name</i></b></dt>
<dd>Specify the name of the database member that contains the report data to store.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.SPLF"></a>
<h3>Spooled file (SPLF)</h3>
<p>Specifies the name of the spooled file to use as input to the store process. This is the file name that was specified by the user program when the file was created, or the name of the device file used to create this file.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.JOB"></a>
<h3>Job name (JOB)</h3>
<p>Specifies the name of the job which produced the spooled file.
</p>
<dl>
<dt><b><u>*</u></b></dt>
<dd>Use the job from which this command is entered.
</dd>
<dt><b><i>job-name</i></b></dt>
<dd>Specify the name of the job to use. If no job qualifier is given, all of the jobs currently in the system are searched for the simple job name. If duplicates of the specified name are found, a list of messages containing the qualified job names of all duplicates is displayed.
</dd>
<dt><b><i>user-name</i></b></dt>
<dd>Specify the name that identifies the user profile under which the job is run.
</dd>
<dt><b><i>number</i></b></dt>
<dd>Specify the job number assigned by the system.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.SPLNBR"></a>
<h3>Spooled file number (SPLNBR)</h3>
<p>Specifies, by number, which of the job's spooled files to store.
</p>
<dl>
<dt><b><u>*ONLY.</u></b></dt>
<dd>Only one spooled file in the job has the specified file name; therefore, the number of the spooled file is not necessary.
</dd>
<dt><b>*LAST</b></dt>
<dd>The spooled file with the highest number and the specified file name is used.
</dd>
</dl>
<dl>
<dt><b>*ANY</b></dt>
<dd>The spooled file number is not used to determine which spooled file is used. Use this value when the job system name parameter or the spooled file create date and time parameter is to take precedence over the spooled file number when selecting a spooled file.
</dd>
</dl>
<dl>
<dt><b><i>spooled-file-number</i></b></dt>
<dd>Specify the number of the spooled file having the specified file name to use.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.JOBSYSNAME"></a>
<h3>Job system name (JOBSYSNAME)</h3>
<p>Specifies the name of the system where the job that created the spooled file (JOB parameter) ran. This parameter is considered after the job name, user name, job number, spooled file name, and spooled file number parameter requirements have been met.
</p>
<dl>
<dt><b><u>*ONLY</u></b></dt>
<dd>There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and spooled file create date and time.
</dd>
<dt><b>*CURRENT</b></dt>
<dd>The spooled file created on the current system with the specified job name, user name, job number, spooled file name, spooled file number, and create date and time is used.
</dd>
<dt><b>*ANY</b></dt>
<dd>The job system name is not used to determine which spooled file is used. Use this value when the spooled file create date and time parameter is to take precedence over the job system name when selecting a spooled file.
</dd>
<dt><b><i>job-system-name</i></b></dt>
<dd>Specify the name of the system where the job that created the spooled file ran.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.CRTDATE"></a>
<h3>Spool file created (CRTDATE)</h3>
<p>Specifies the date and time the spooled file was created. This parameter is considered after the job name, user name, job number, spooled file name, spooled file number, and job system name parameter requirements have been met.
</p>
<p>The possible single values are:
</p>
<dl>
<dt><b><u>*ONLY</u></b></dt>
<dd>There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and job system name.
</dd>
<dt><b>*LAST</b></dt>
<dd>The spooled file with the latest create date and time of the specified job name, user name, job number, spooled file name, spooled file number, and job system name is used.
</dd>
</dl>
<p>The possible create date value is:
</p>
<dl>
<dt><b><i>spooled-file-create-date</i></b></dt>
<dd>Specify the date the spooled file was created.
</dd>
</dl>
<p>The possible create time values are:
</p>
<dl>
<dt><b><u>*ONLY</u></b></dt>
<dd>There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file create date.
</dd>
<dt><b>*LAST</b></dt>
<dd>The spooled file with the latest create time of the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file create date is used.
</dd>
<dt><b><i>spooled-file-create-time</i></b></dt>
<dd>Specify the time the spooled file was created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.DLTINPUT"></a>
<h3>Delete input file (DLTINPUT)</h3>
<p>Specifies whether the input report is deleted after the report data is successfully stored by OnDemand. An unsuccessful STRCDSRDAR does NOT delete the input.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The input report data is kept.
</dd>
<dt><b>*YES</b></dt>
<dd>The input report data is deleted.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.SBMJOB"></a>
<h3>Submit to batch (SBMJOB)</h3>
<p>Specify if you want to store the specified report interactively or in a batch job.
</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="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.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>QRDARS400</u></b></dt>
<dd>The QRDARS400 job description is used as the job description for the submitted job.
</dd>
<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>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="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="STRCDSRDAR.RESTART"></a>
<h3>Restart (RESTART)</h3>
<p>Specifies whether this is to restart a run that was previously interrupted. When STRCDSRDAR is unsuccessful because of an error, a message is issued in the QPRLRCDS printer file that tells you when you must specify *YES for this parameter.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>This is not a restart of a previously failed run.
</dd>
<dt><b>*YES</b></dt>
<dd>This is to restart a previously failed STRCDSRDAR run. This value can not be specified when processing a report type of UBND.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRCDSRDAR.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Simple Example</b>
</p>
<p>
<pre>
STRCDSRDAR REPORT(CHECKSTMTS) SPLF(CKSTMTPRTF)
</pre>
</p>
<p>This command submits a job to batch to capture the CKSTMTPRTF spooled file from the current job into OnDemand Spool File Archive.
</p>
<p><b>Example 2: More Complex Example</b>
</p>
<p>
<pre>
STRCDSRDAR REPORT(CHECKSTMTS) SPLF(CKSTMTPRTF)
JOB(123456/OPERATOR/NIGHTBATCH)SPLNBR(*LAST)
SBMJOB(*NO)
</pre>
</p>
<p>This command runs interactively to capture the last occurrence of the CKSTMTPRTF spooled file from a nightly batch job called NIGHTBATCH.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="STRCDSRDAR.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF3342</b></dt>
<dd>Job &amp;5/&amp;4/&amp;3 not found.
</dd>
<dt><b>CPF3343</b></dt>
<dd>Duplicate job names found.
</dd>
<dt><b>CPF3344</b></dt>
<dd>File &amp;1 number &amp;8 no longer in the system.
</dd>
<dt><b>CPF3492</b></dt>
<dd>Not authorized to spooled file.
</dd>
<dt><b>CPF3C40</b></dt>
<dd>Spooled file &amp;4 not found.
</dd>
<dt><b>RDR0101</b></dt>
<dd>Processing of STRCDSRDAR failed for &amp;1. Rerun STRCDSRDAR and specify RESTART(&amp;2).
</dd>
<dt><b>RDR0202</b></dt>
<dd>Report &amp;1 could not be stored.
</dd>
<dt><b>RDR0323</b></dt>
<dd>Spooled file can not be processed
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#STRCDSRDAR.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>