308 lines
14 KiB
HTML
308 lines
14 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>Copy Report Definition (CPYDFNRDAR)</title>
|
|
</head>
|
|
<body bgcolor="white">
|
|
<a name="CPYDFNRDAR.Top_Of_Page"></a>
|
|
<h2>Copy Report Definition (CPYDFNRDAR)</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="#CPYDFNRDAR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CPYDFNRDAR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CPYDFNRDAR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CPYDFNRDAR"></a>
|
|
<p>The Copy Report Definition (CPYDFNRDAR) command performs the copy operation specified by the OPTION parameter: OPTION = *EXPORT copies one or more OnDemand report definition records into a report definition transfer file named in the RPTDFNFILE parameter. This file is then available for transfer or export to another RDARS or OnDemand system. OPTION = *IMPORT copies all of the report definition records from the report definition transfer file (named in the RPTDFNFILE parameter) into the standard OnDemand report definition file. Usually, this report definition transfer file would have been created on another RDARS or OnDemand system. OPTION = *PRINT prints a summary list of the report definition records from the report definition file named in the RPTDFNFILE parameter.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYDFNRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CPYDFNRDAR.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="#CPYDFNRDAR.OPTION"><b>OPTION</b></a></td>
|
|
<td valign="top">Option</td>
|
|
<td valign="top">*EXPORT, *IMPORT, *PRINT</td>
|
|
<td valign="top">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top" rowspan="3"><a href="#CPYDFNRDAR.RPTDFNFILE"><b>RPTDFNFILE</b></a></td>
|
|
<td valign="top">Report definition file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Report definition file</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
</tr><tr>
|
|
<td valign="top">Qualifier 2: Library</td>
|
|
<td valign="top"><i>Name</i>, *CURLIB</td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CPYDFNRDAR.VIEWFILE"><b>VIEWFILE</b></a></td>
|
|
<td valign="top">Logical view file</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYDFNRDAR.FLRFLDFILE"><b>FLRFLDFILE</b></a></td>
|
|
<td valign="top">Folder-field file</td>
|
|
<td valign="top"><i>Name</i>, <b><u>*NONE</u></b></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYDFNRDAR.REPORT"><b>REPORT</b></a></td>
|
|
<td valign="top">Report name</td>
|
|
<td valign="top"><i>Generic name, name</i>, *ALL</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYDFNRDAR.VERSION"><b>VERSION</b></a></td>
|
|
<td valign="top">Version</td>
|
|
<td valign="top">1-99</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CPYDFNRDAR.RPTGRP"><b>RPTGRP</b></a></td>
|
|
<td valign="top">Report group</td>
|
|
<td valign="top"><i>Name</i>, *GRP</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYDFNRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CPYDFNRDAR.OPTION"></a>
|
|
<h3>Option (OPTION)</h3>
|
|
<p>Specifies the export, import, or print function to be done.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<dl>
|
|
<dt><b>*EXPORT</b></dt>
|
|
<dd>Copy report definition records from the OnDemand report definition file QARLRACT into the report definition transfer file named in parameter RPTDFNFILE.
|
|
</dd>
|
|
<dt><b>*IMPORT</b></dt>
|
|
<dd>Copy report definition records from the report definition transfer file specified in the RPTDFNFILE parameter into the OnDemand report definition file QARLRACT.
|
|
</dd>
|
|
<dt><b>*PRINT</b></dt>
|
|
<dd>Print a summary list of the report definition records in the report definition file named in parameter RPTDFNFILE.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYDFNRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYDFNRDAR.RPTDFNFILE"></a>
|
|
<h3>Report definition file (RPTDFNFILE)</h3>
|
|
<p>Specifies the file to which report definition records are copied, if *EXPORT is specified for the <b>Option (OPTION)</b> parameter. If *IMPORT or *PRINT is specified for the <b>Option (OPTION)</b> parameter, the report definition transfer file is the primary input file for that function.
|
|
</p>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the specified file does not exist, the export process will create it. If the file already exists, records will be added to the existing file.
|
|
</p>
|
|
<p><b>Qualifier 1: Report definition file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the report definition transfer file.
|
|
</dd>
|
|
</dl>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<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 file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYDFNRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYDFNRDAR.VIEWFILE"></a>
|
|
<h3>Logical view file (VIEWFILE)</h3>
|
|
<p>Specifies the name of an additional "transfer" file for the logical view records copied from the QARLRAPP file during export, and copied into the QARLRAPP file during import processing. This file name is required if logical view records exist during export. Otherwise, *NONE is permitted during export or import.
|
|
</p>
|
|
<p>The logical view transfer file must be in the library that was specified for the report definition transfer file (parameter RPTDFNFILE).
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the specified file does not exist, the export process will create it. If the file already exists, records will be added to the existing file.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYDFNRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYDFNRDAR.FLRFLDFILE"></a>
|
|
<h3>Folder-field file (FLRFLDFILE)</h3>
|
|
<p>Specifies the name of an additional "transfer" file for the folder-field records copied from the QARLRFFU file during export, and copied into the QARLRFFU file during import processing. This file name is required if folder field records exist during export. Otherwise, *NONE is permitted during export or import.
|
|
</p>
|
|
<p>The folder-field file must be in the same library that was specified for the report definition transfer file (parameter RPTDFNFILE).
|
|
</p>
|
|
<p>
|
|
<b>Note: </b>If the specified file does not exist, the export process will create it. If the file already exists, records will be added to the existing file.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYDFNRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYDFNRDAR.REPORT"></a>
|
|
<h3>Report name (REPORT)</h3>
|
|
<p>Specifies the name of one or more report definition records copied into the report definition transfer file when OPTION = *EXPORT. Generic values may be used, such as "AB*" to copy all of the report definitions named "ABxxx...x". The special value "*ALL" may be used to copy all existing report definitions to the report definition transfer file. This parameter can be left blank if either VERSION or RPTGRP is specified. Also, REPORT, VERSION, and RPTGRP values may be used in combination.
|
|
</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="#CPYDFNRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYDFNRDAR.VERSION"></a>
|
|
<h3>Version (VERSION)</h3>
|
|
<p>Specifies the version number of the report definition records copied into the report definition transfer file when OPTION = *EXPORT. The possible values are 01-99, or blank. This parameter can be left blank if either the REPORT or RPTGRP parameter is specified. Also, REPORT, VERSION, and RPTGRP values may be used in combinations.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYDFNRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CPYDFNRDAR.RPTGRP"></a>
|
|
<h3>Report group (RPTGRP)</h3>
|
|
<p>Specifies the value of the report group name to be matched in the report definition records which are copied into the report definition transfer file when OPTION = *EXPORT. For example, entering "ARGROUP" will copy all of the report definition records in group ARGROUP, but not the report group definition named ARGROUP itself. To copy a specific report group definition, enter the report group name as the REPORT value (eg, REPORT = ARGROUP). To copy all report group definitions enter "*GRP" as the RPTGRP value (eg, RPTGRP = *GRP). This parameter may be left blank if either the REPORT or VERSION parameter is specified. Also, REPORT, VERSION, and RPTGRP values may be used in combinations.
|
|
</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="#CPYDFNRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CPYDFNRDAR.COMMAND.EXAMPLES">Examples</a> </h3>
|
|
<p><b>Example 1: Simple Export Example</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CPYDFNRDAR OPTION(*EXPORT) RPTDFNFILE(MYLIB/MIGRDEFS)
|
|
REPORT(CHECKSTMTS)
|
|
</pre>
|
|
</p>
|
|
<p>This command will cause all versions of the OnDemand Spool File Archive report definition called CHECKSTMTS to be exported into a report definition transfer file called MIGRDEFS in library MYLIB that will contain the information to be exported.
|
|
</p>
|
|
<p><b>Example 2: Simple Import Example</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CPYDFNRDAR OPTION(*IMPORT) RPTDFNFILE(MYLIB/MIGRDEFS)
|
|
</pre>
|
|
</p>
|
|
<p>This example shows a corresponding import command to import the report definitions that were exported in Example 1. Typically, the report definition transfer file is moved from the source system to the target system, and then the example import command shown above is run on the target system.
|
|
</p>
|
|
<p><b>Example 3: More Complex Export Example</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CPYDFNRDAR OPTION(*EXPORT) RPTDFNFILE(MYLIB/MIGRDEFS)
|
|
VIEWFILE(MIGRLV)FLRFLDFILE(MIGRFF) REPORT(*ALL)
|
|
VERSION(03)
|
|
</pre>
|
|
</p>
|
|
<p>This command will cause Version 03 of all OnDemand Spool File Archive report definitions to be exported into a report definition transfer file called MIGRDEFS in library MYLIB. It will also cause any logical view definition records or folder field definition records to be exported into files called MIGRLV and MIGRFF respectively (also located in MYLIB library).
|
|
</p>
|
|
<p><b>Example 4: More Complex Import Example</b>
|
|
</p>
|
|
<p>
|
|
<pre>
|
|
CPYDFNRDAR OPTION(*IMPORT) RPTDFNFILE(MYLIB/MIGRDEFS)
|
|
VIEWFILE(MIGRLV)FLRFLDFILE(MIGRFF)
|
|
</pre>
|
|
</p>
|
|
<p>This example shows a corresponding import command to import the report definitions that were exported in Example 3. Typically, the report definition, logical view definition, and folder field definition transfer files are moved from the source system to the target system, and then the example import command shown above is run on the target system.
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYDFNRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CPYDFNRDAR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>RDR0331</b></dt>
|
|
<dd>Profile &3 can not be used.
|
|
</dd>
|
|
<dt><b>RDR4001</b></dt>
|
|
<dd>REPORT parameter can only be specified with OPTION(*EXPORT).
|
|
</dd>
|
|
<dt><b>RDR4002</b></dt>
|
|
<dd>VERSION parameter can only be specified with OPTION(*EXPORT).
|
|
</dd>
|
|
<dt><b>RDR4003</b></dt>
|
|
<dd>RPTGRP parameter can only be specified with OPTION(*EXPORT).
|
|
</dd>
|
|
<dt><b>RDR4004</b></dt>
|
|
<dd>Report definition transfer file (RPTDFNFILE) must be specified.
|
|
</dd>
|
|
<dt><b>RDR4005</b></dt>
|
|
<dd>REPORT, VERSION, and RPTGRP cannot all be blank when OPTION = *EXPORT.
|
|
</dd>
|
|
<dt><b>RDR4006</b></dt>
|
|
<dd>If REPORT value is "*ALL", both VERSION and RPTGRP must be blank.
|
|
</dd>
|
|
<dt><b>RDR4007</b></dt>
|
|
<dd>"*ALL" can be specified only for report name parameter.
|
|
</dd>
|
|
<dt><b>RDR4008</b></dt>
|
|
<dd>Name of the report definition transfer file cannot begin with the letter "Q".
|
|
</dd>
|
|
<dt><b>RDR4009</b></dt>
|
|
<dd>A library name for the report definition transfer file must be specified.
|
|
</dd>
|
|
<dt><b>RDR4010</b></dt>
|
|
<dd>Logical view transfer file name must be specified.
|
|
</dd>
|
|
<dt><b>RDR4011</b></dt>
|
|
<dd>Logical view transfer file name cannot begin with "Q".
|
|
</dd>
|
|
<dt><b>RDR4012</b></dt>
|
|
<dd>Group name value cannot include generic character "*".
|
|
</dd>
|
|
<dt><b>RDR4013</b></dt>
|
|
<dd>Report name value must include generic character "*" if group name also specified.
|
|
</dd>
|
|
<dt><b>RDR4014</b></dt>
|
|
<dd>Folder-field transfer file name must be specified.
|
|
</dd>
|
|
<dt><b>RDR4015</b></dt>
|
|
<dd>Folder-field transfer file name cannot begin with "Q".
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CPYDFNRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|