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

251 lines
8.8 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>Remove Report from OnDemand (RMVRPTOND)</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="RMVRPTOND.Top_Of_Page"></a>
<h2>Remove Report from OnDemand (RMVRPTOND)</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="#RMVRPTOND.PARAMETERS.TABLE">Parameters</a><br>
<a href="#RMVRPTOND.COMMAND.EXAMPLES">Examples</a><br>
<a href="#RMVRPTOND.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="RMVRPTOND"></a>
<p>The Remove Report from OnDemand (RMVRPTOND) command removes the specified report from OnDemand.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="RMVRPTOND.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="#RMVRPTOND.APPGRP"><b>APPGRP</b></a></td>
<td valign="top">Application group</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 1</td>
</tr>
<tr>
<td valign="top"><a href="#RMVRPTOND.RPTID"><b>RPTID</b></a></td>
<td valign="top">Report ID</td>
<td valign="top"><i>Character value</i></td>
<td valign="top">Required, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#RMVRPTOND.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="#RMVRPTOND.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="#RMVRPTOND.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="#RMVRPTOND.ERROPT"><b>ERROPT</b></a></td>
<td valign="top">Error option</td>
<td valign="top"><b><u>*FRCRMV</u></b>, *NOFRCRMV</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#RMVRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="RMVRPTOND.APPGRP"></a>
<h3>Application group (APPGRP)</h3>
<p>Specifies the name of the application group that contains the report to be removed.
</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 the valid entries is presented to you. The entries listed may not be valid if the parameter INSTANCE is not QUSROND.
</p>
<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="#RMVRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVRPTOND.RPTID"></a>
<h3>Report ID (RPTID)</h3>
<p>Specifies the report ID of the report to be removed.
</p>
<p>The report ID is in the form of "1220-1-0-8FAA-9939-9345", where the "1220" is the internal application group identifier, "1" is the primary storage node, "0" is the secondary storage node, "8FAA" is a counter, "9339" is the first (internal) date in the report file and "9345" is the last (internal) date in the report file. The report ID is also known as the load ID.
</p>
<p>
<b>Note: </b>The report id can be found in the system log file.
</p>
<p>This is a required parameter.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVRPTOND.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="#RMVRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVRPTOND.SBMJOB"></a>
<h3>Submit to batch (SBMJOB)</h3>
<p>Specify if you want to remove the specific 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="#RMVRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVRPTOND.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="#RMVRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="RMVRPTOND.ERROPT"></a>
<h3>Error option (ERROPT)</h3>
<p>Force the removal of the report even if the report ID is not found in the system log.
</p>
<dl>
<dt><b><u>*FRCRMV</u></b></dt>
<dd>Remove the report if the report ID is not found in the system log.
</dd>
<dt><b>*NOFRCRMV</b></dt>
<dd>Do not remove the report if the report ID is not found in the system log.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVRPTOND.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Simple Example</b>
</p>
<p>
<pre>
RMVRPTOND APPGRP(CHECKSTMTS) RPTID('1220-1-0-8FAA-9939-9345')
</pre>
</p>
<p>This command submits a job to batch to remove an archived spooled file from the OnDemand Common Server application group called CHECKSTMTS with a load id (also known as report id) as shown. The command assumes the archived data is to be removed from the QUSROND instance since no instance name was specified.
</p>
<p><b>Example 2: More Complex Example</b>
</p>
<p>
<pre>
RMVRPTOND APPGRP(CHECKSTMTS) RPTID('1220-1-0-8FAA-9939-9345')
INSTANCE(ACCTING) SBMJOB(*NO)
</pre>
</p>
<p>This command is similar to Example 1 but runs interactively and specifies a specific instance from which to remove the archived report.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="RMVRPTOND.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>OND0222</b></dt>
<dd>RMVRPTOND ended in error. The report was not removed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#RMVRPTOND.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>