204 lines
6.9 KiB
HTML
204 lines
6.9 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>Create Physical Optical File (CRTPOFRDAR)</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="CRTPOFRDAR.Top_Of_Page"></a>
|
|
<h2>Create Physical Optical File (CRTPOFRDAR)</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="#CRTPOFRDAR.PARAMETERS.TABLE">Parameters</a><br>
|
|
<a href="#CRTPOFRDAR.COMMAND.EXAMPLES">Examples</a><br>
|
|
<a href="#CRTPOFRDAR.ERROR.MESSAGES">Error messages</a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
<div> <a name="CRTPOFRDAR"></a>
|
|
<p>The Create Physical Optical File (CRTPOFRDAR) command creates a physical optical file. The description for this physical optical file comes from the model file
|
|
</p>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
|
|
<div>
|
|
<h3><a name="CRTPOFRDAR.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" rowspan="3"><a href="#CRTPOFRDAR.FILE"><b>FILE</b></a></td>
|
|
<td valign="top">Physical optical file</td>
|
|
<td valign="top"><i>Qualified object name</i></td>
|
|
<td valign="top" rowspan="3">Required, Positional 1</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">Qualifier 1: Physical optical 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>*CURLIB</u></b></td>
|
|
</tr><tr>
|
|
<td valign="top"><a href="#CRTPOFRDAR.STGGRP"><b>STGGRP</b></a></td>
|
|
<td valign="top">Storage group</td>
|
|
<td valign="top"><i>Name</i></td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTPOFRDAR.COMPRESS"><b>COMPRESS</b></a></td>
|
|
<td valign="top">Compression</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTPOFRDAR.PRPAUT"><b>PRPAUT</b></a></td>
|
|
<td valign="top">Propagate authority</td>
|
|
<td valign="top"><b><u>*YES</u></b>, *NO</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><a href="#CRTPOFRDAR.MEDIA"><b>MEDIA</b></a></td>
|
|
<td valign="top">Media type</td>
|
|
<td valign="top"><b><u>*OPTICAL</u></b>, *DISK</td>
|
|
<td valign="top">Optional</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</div>
|
|
<div> <a name="CRTPOFRDAR.FILE"></a>
|
|
<h3>Physical optical file (FILE)</h3>
|
|
<p>Specifies the name of the physical optical file to create.
|
|
</p>
|
|
<p><b>Qualifier 1: Physical optical file</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><i>name</i></b></dt>
|
|
<dd>Specify the name of the physical optical file to be created.
|
|
</dd>
|
|
</dl>
|
|
<p>This is a required parameter.
|
|
</p>
|
|
<p><b>Qualifier 2: Library</b>
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*CURLIB</u></b></dt>
|
|
<dd>The current library for the job is used to locate the physical optical file. 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 physical optical file is located.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTPOFRDAR.STGGRP"></a>
|
|
<h3>Storage group (STGGRP)</h3>
|
|
<p>Specify the name of the optical storage group to use to find the optical volumes on which to place the physical file.
|
|
</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><i>name</i></b></dt>
|
|
<dd>Specify the name of the storage group to use.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTPOFRDAR.COMPRESS"></a>
|
|
<h3>Compression (COMPRESS)</h3>
|
|
<p>Specify if you want to compress your data before writing it to the optical media.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>The data is compressed before it is written.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>No compression is used. The data is written just as it is passed on the write API.
|
|
<p>
|
|
<b>Note: </b>This may be a good choice when working with a file that has a small record length. Depending on the data, compression can actually result in a record that is larger than the original uncompressed record. During testing, you can use the DSPOFDRDAR command to find the maximum record length for the file to help you determine if compression is of benefit.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTPOFRDAR.PRPAUT"></a>
|
|
<h3>Propagate authority (PRPAUT)</h3>
|
|
<p>Specifies whether the authority from the model file should be propagated to the newly created physical optical file.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*YES</u></b></dt>
|
|
<dd>The authority associated with the model file is propagated to the physical optical file.
|
|
</dd>
|
|
<dt><b>*NO</b></dt>
|
|
<dd>No authority is propagated to the physical optical file. Public authority is *EXCLUDE and the object is owned by the user profile or the group profile that issued this command.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<div> <a name="CRTPOFRDAR.MEDIA"></a>
|
|
<h3>Media type (MEDIA)</h3>
|
|
<p>Specifies on which type of media this file should be placed.
|
|
</p>
|
|
<dl>
|
|
<dt><b><u>*OPTICAL</u></b></dt>
|
|
<dd>The file should be placed on optical media.
|
|
</dd>
|
|
<dt><b>*DISK</b></dt>
|
|
<dd>The file should be placed on disk media.
|
|
<p>
|
|
<b>Note: </b>You will probably want to use this option while you are developing and testing your application. The OnDemand Record Archive APIs have the same parameters regardless of the media type specified here.
|
|
</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div>
|
|
<h3><a name="CRTPOFRDAR.COMMAND.EXAMPLES">Examples</a></h3>None
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
<hr size="2" width="100%">
|
|
<div><h3><a name="CRTPOFRDAR.ERROR.MESSAGES">Error messages</a> </h3>
|
|
<p><b><u>*ESCAPE Messages</u></b>
|
|
</p>
|
|
<dl>
|
|
<dt><b>RDR5404</b></dt>
|
|
<dd>Optical File &1 not created in Library &2.
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<table width="100%">
|
|
<tr><td align="right"><a href="#CRTPOFRDAR.Top_Of_Page">Top</a></td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|