friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
14ed2849c6
ibm-information-center/dist/eclipse/plugins/i5OS.ic.cl_5.4.0.1/crttapf.htm

1244 lines
58 KiB
HTML
Raw Blame History

<!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 Tape File (CRTTAPF)</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="CRTTAPF.Top_Of_Page"></a>
<h2>Create Tape File (CRTTAPF)</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="#CRTTAPF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CRTTAPF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CRTTAPF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CRTTAPF"></a>
<p>The Create Tape File (CRTTAPF) command creates a tape device file. The device file contains the file description, which identifies the device to be used; it does not contain data. The tape device file is used to read and write records on tape. The same device file can be used for both input and output operations.
</p>
<p>
<b>Note: </b>This command is not used to create device files for use in save or restore operations. User-created device files are not needed for save or restore operations.
</p>
<p>Tape files have no data description specifications (DDS). The information in the tape file description comes from the command that creates it. The tape file has one record format for input/output operations. The record format consists of one character field containing the input data retrieved from the device or the output data to be written to the device. The program using the device file must describe the fields in the record format so the program can arrange the data received from or sent to the device in the manner specified by the tape file description.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CRTTAPF.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="#CRTTAPF.FILE"><b>FILE</b></a></td>
<td valign="top">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: 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="#CRTTAPF.DEV"><b>DEV</b></a></td>
<td valign="top">Tape device</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 4 repetitions): <i>Name</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.VOL"><b>VOL</b></a></td>
<td valign="top">Volume identifier</td>
<td valign="top">Single values: <b><u>*NONE</u></b><br>Other values (up to 50 repetitions): <i>Character value</i></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTTAPF.REELS"><b>REELS</b></a></td>
<td valign="top">Tape reels specifications</td>
<td valign="top"><i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Label processing type</td>
<td valign="top">
<b><u>*SL</u></b>, *NL, *NS, *BLP, *LTM</td>
</tr>
<tr>
<td valign="top">Element 2: Number of reels</td>
<td valign="top">
1-255, <b><u>1</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.SEQNBR"><b>SEQNBR</b></a></td>
<td valign="top">Sequence number</td>
<td valign="top">1-16777215, <b><u>1</u></b>, *END, *NEXT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.LABEL"><b>LABEL</b></a></td>
<td valign="top">Tape label</td>
<td valign="top"><i>Character value</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.FILETYPE"><b>FILETYPE</b></a></td>
<td valign="top">File type</td>
<td valign="top"><b><u>*DATA</u></b>, *SRC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.IGCDTA"><b>IGCDTA</b></a></td>
<td valign="top">User specified DBCS data</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.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"><a href="#CRTTAPF.RCDLEN"><b>RCDLEN</b></a></td>
<td valign="top">Record length</td>
<td valign="top"><i>Integer</i>, <b><u>*CALC</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.BLKLEN"><b>BLKLEN</b></a></td>
<td valign="top">Block length</td>
<td valign="top">1-524288, <b><u>*CALC</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.BUFOFSET"><b>BUFOFSET</b></a></td>
<td valign="top">Buffer offset</td>
<td valign="top"><i>Integer</i>, <b><u>0</u></b>, *BLKDSC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.RCDBLKFMT"><b>RCDBLKFMT</b></a></td>
<td valign="top">Record block format</td>
<td valign="top"><b><u>*FB</u></b>, *F, *V, *VB, *D, *DB, *VS, *VBS, *U</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTTAPF.EXTEND"><b>EXTEND</b></a></td>
<td valign="top">Extend</td>
<td valign="top">Single values: <b><u>*NO</u></b><br>Other values: <i>Element list</i></td>
<td valign="top" rowspan="3">Optional</td>
</tr>
<tr>
<td valign="top">Element 1: Extend file</td>
<td valign="top">
*YES</td>
</tr>
<tr>
<td valign="top">Element 2: Check file</td>
<td valign="top">
<b><u>*NOCHECK</u></b>, *CHECK</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.DENSITY"><b>DENSITY</b></a></td>
<td valign="top">Tape density</td>
<td valign="top"><i>Character value</i>, <b><u>*DEVTYPE</u></b>, *CTGTYPE, *FMT3480, *FMT3490E, *FMT3570, *FMT3570E, *FMT3590, *FMT3590E, *QIC120, *QIC525, *QIC1000, *QIC2GB, *QIC2DC, *QIC4GB, *QIC4DC, *QIC3040, *QIC5010, *MLR3, *SLR60, *SLR100, *FMT2GB, *FMT5GB, *FMT7GB, *FMT20GB, *FMT60GB, *ULTRIUM1, 1600, 3200, 6250</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.COMPACT"><b>COMPACT</b></a></td>
<td valign="top">Data compaction</td>
<td valign="top"><b><u>*DEVD</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.CODE"><b>CODE</b></a></td>
<td valign="top">Code</td>
<td valign="top"><b><u>*EBCDIC</u></b>, *ASCII</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.CRTDATE"><b>CRTDATE</b></a></td>
<td valign="top">Creation date</td>
<td valign="top"><i>Date</i>, <b><u>*NONE</u></b></td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.EXPDATE"><b>EXPDATE</b></a></td>
<td valign="top">File expiration date</td>
<td valign="top"><i>Date</i>, <b><u>*NONE</u></b>, *PERM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.ENDOPT"><b>ENDOPT</b></a></td>
<td valign="top">End of tape option</td>
<td valign="top"><b><u>*REWIND</u></b>, *LEAVE, *UNLOAD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CRTTAPF.USRLBLPGM"><b>USRLBLPGM</b></a></td>
<td valign="top">User label program</td>
<td valign="top">Single values: <b><u>*NONE</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: User label program</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="#CRTTAPF.WAITFILE"><b>WAITFILE</b></a></td>
<td valign="top">Maximum file wait time</td>
<td valign="top"><i>Integer</i>, <b><u>*IMMED</u></b>, *CLS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.SHARE"><b>SHARE</b></a></td>
<td valign="top">Share open data path</td>
<td valign="top"><b><u>*NO</u></b>, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.AUT"><b>AUT</b></a></td>
<td valign="top">Authority</td>
<td valign="top"><i>Name</i>, <b><u>*LIBCRTAUT</u></b>, *ALL, *CHANGE, *EXCLUDE, *USE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CRTTAPF.REPLACE"><b>REPLACE</b></a></td>
<td valign="top">Replace file</td>
<td valign="top"><b><u>*YES</u></b>, *NO</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CRTTAPF.FILE"></a>
<h3>File (FILE)</h3>
<p>Specifies the tape device file to be created.
</p>
<p>If the file is used by a high-level language program, the file name must be consistent with the naming rules of that language. Otherwise, the file must be renamed in the program itself.
</p>
<p>This is a required parameter.
</p>
<p><b>Qualifier 1: File</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the tape device file to be created.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the job is used to locate the tape device 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 library where the tape file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.DEV"></a>
<h3>Device (DEV)</h3>
<p>Specifies the names of one or more tape devices, one virtual tape device, or one media library device used with this tape device file to perform reading and writing data operations. A media library device is a tape storage device that contains one or more tape drives, tape cartridges, and a part (carriage and picker assembly) for moving tape media between the cartridge storage slots and the tape drives.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No device names are specified. They must be specified later in the Change Tape File (CHGTAPF) or Override Tape File (OVRTAPF) command, or in the high-level language program that opens the file.
</dd>
</dl>
<p><b>Other values</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the names of no more than four tape devices, one virtual tape device, or the name of one media library device used with this tape device file. The order in which the device names are specified here is the order in which tapes on those devices are processed. When the number of volumes being processed exceeds the number of devices listed on this parameter, the devices are used in the same order as specified, wrapping around to the first device as needed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.VOL"></a>
<h3>Volume identifier (VOL)</h3>
<p>Specifies one or more volume identifiers used by the file. The volumes must be installed in the same order as the identifiers are specified here (and as they are specified for the DEV parameter. If the file is opened for read backward, then the volume identifiers in the list are processed from last to first (while the devices in the device list are used in first-to-last order). If a list of volume identifiers is provided for the file, operator messages indicate the name of the required volume.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No tape volume identifiers are specified for this file. They can be supplied before the device file is opened, either in a CHGTAPF or OVRTAPF command or in the high-level language program. If volume identifiers are not specified before the device file is opened, volume checking is not performed beyond verifying that the correct label type volume is on the device, and volume names are not provided in operator messages. The maximum number of reels processed for an *NL, *NS, *BLP, or *LTM input file when VOL(*NONE) is specified is determined by the REELS(number-of-reels) parameter value.
</dd>
</dl>
<p><b>Other values (up to 50 repetitions)</b>
</p>
<dl>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the identifiers of one or more volumes in the order in which they are placed on the device. Each volume identifier contains a maximum of 6 alphanumeric characters. Use a blank as a separator character when listing multiple identifiers. Up to 50 volume identifiers can be specified. These identifiers are used in messages sent to the operator during processing. The maximum number of reels processed for an *NL, *NS, *BLP, or *LTM input file is determined by the number of volume identifiers in the list.
<p>
<b>Note: </b>If the VOL parameter value used for the file specifies a list of identifiers rather than VOL(*NONE), the number-of-reels part of the REELS parameter is ignored regardless of where it is specified. A description of how the parameter values for the file are determined when overrides are used, the high-level language interface, and the device file when the file is opened is in the Files and file systems topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter. To ensure that the number-of-reels part of the REELS parameter is used (rather than a VOL identifier list) to control the volumes processed by the tape device file, specify VOL(*NONE) in the same command in which the REELS parameter is specified.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.REELS"></a>
<h3>Tape reels specifications (REELS)</h3>
<p>Specifies the type of labeling used on the tape reels and the maximum number of reels processed if both a list of volume identifiers is not specified (VOL parameter) and this device file is used with either *NL, *NS, *LTM, or *BLP input files. When the number of reels is specified as the second element of this parameter, the volume identifiers on the volumes are ignored if labeled tapes are being processed; instead, the order in which the reels are installed on the device must be checked by the operator.
</p>
<p>The number-of-reels value is not a limiting value for standard-label or output files. For a standard-label <i>input</i> file, the data file labels limit the number of volumes processed by indicating end-of-file. For an <i>output</i> file, the number-of-reels value is ignored; the system requests that additional volumes be kept on the device until the file is closed.
</p>
<p>The system checks the first record following the load point on the tape to see (1) whether it has exactly 80 bytes for EBCDIC or at least 80 bytes for ASCII and (2) whether the first 4 bytes contain the values VOL and 1. If so, the reel contains a standard-label tape. *SL and *BLP files require standard-label tape volumes. *NL, *NS, and *LTM tape files cannot process standard-label volumes.
</p>
<p>
<b>Note: </b>The values *SL, *NL, and *LTM can be specified if the device file is used for either reading or writing on tapes. The values *NS and *BLP are valid only if the device file is used to read tapes.
</p>
<p><b>Element 1: Label processing type</b>
</p>
<dl>
<dt><b><u>*SL</u></b></dt>
<dd>The volumes have standard labels. If a list of volume identifiers is specified (with the VOL parameter), the system checks that the correct tape volumes are on the device in the specified sequence.
<ul>
<li>If no volume identifier list is given and the file is opened for <i>output</i>, any standard-label volumes may be installed on the device.
</li>
<li>If no volume identifier list is given and the file is opened for <i>input</i>, the first volume may have any volume identifier, but if the file is continued, the system requires the correct continuation volumes to be processed (verified by checking the data file labels). For an input file, the end-of-file message is sent to the program being used when the labels on the last volume processed indicate that it is the last volume for the data file.
</li>
</ul>
</dd>
<dt><b>*NL</b></dt>
<dd>The volumes are not labeled. On a nonlabeled volume, tape marks are used to indicate the end of each data file and the end of the volume. For an <i>input</i> file, the end-of-file message is sent to the program when the number of volumes specified in the volume list have been processed, or, if no list of volume identifiers is provided, when the number of reels specified in the REELS parameter are processed.
</dd>
<dt><b>*NS</b></dt>
<dd>The volumes have nonstandard labels. Each volume must start with some kind of label information, optionally preceded by a tape marker and always followed by a tape marker. This nonstandard label information is ignored. The system spaces forward to a point beyond the tape marker that follows the nonstandard labels and positions the tape at the file's data. Each reel must have a tape marker at the end of the file's data. Information beyond this ending tape marker is ignored. Only a single data file can exist on a nonstandard tape. Standard-label volumes <i>cannot</i> be processed by using the *NS label processing.
<p>For an <i>input</i> file, the end-of-file message is sent to the program using the file when the number of volumes specified in the volume list have been processed, or, if no list of volume identifiers is provided, when the number of reels specified in the REELS parameter are processed.
</p>
</dd>
<dt><b>*BLP.</b></dt>
<dd>Standard-label processing is bypassed. Each reel <i>must</i> have standard labels. Although each reel is checked for a standard volume label and each file must have at least one standard header label (HDR1) and one standard trailer label (EOV1 or EOF1), most other label information (such as the data file record length or block length) is ignored. The sequence number of each file on the volume is determined only by the number of tape markers between it and the start of tape (in contrast to *SL processing in which the file sequence number stored in the header and trailer labels of each file are used to locate a data file).
<p>Most of the information in the data file trailer label is ignored, but if an end-of-file (EOF) trailer label is found, the end-of-file message is sent to the program using the tape file. If no end-of-file trailer label is encountered by the time the specified number of volumes or reels have been processed (volume identifier list and REELS parameter), the end-of-file message is immediately sent to the program using the tape file. Bypass label processing can be used when the user does not know the name of the file used or when some file label information is incorrect.
</p>
</dd>
<dt><b>*LTM</b></dt>
<dd>The volumes have no labels but do have a single leading tape marker before the first data file. REELS(*LTM) is processed the same as REELS(*NL) except that when SEQNBR(1) is specified for an output file to create the first data file on the tape, a leading tape marker is written at the start of the tape before the first data block.
</dd>
</dl>
<p><b>Element 2: Number of reels</b>
</p>
<dl>
<dt><b><u>1</u></b></dt>
<dd>Only one tape reel is processed for the *NL, *LTM, *NS, or *BLP tape file input operation if no list of volume identifiers is provided (VOL parameter).
</dd>
<dt><b><i>1-255</i></b></dt>
<dd>Specify the maximum number of reels to be processed for an *NL, *LTM, *NS, or *BLP input tape operation when a list of volume identifiers is not specified (VOL parameter). If the next reel is not on the device when the end of the currently-processing tape is reached, a message is sent to the operator requesting that the next tape be installed on the next tape device. The number-of-reels value is ignored for a standard-label (*SL) file or for any output file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.SEQNBR"></a>
<h3>Sequence number (SEQNBR)</h3>
<p>Specifies the sequence number of the data file on the tape being processed.
</p>
<ul>
<li>When standard-label tapes are used, the four-position file sequence number is read from the first header label of the data file.
</li>
<li>When bypass label processing is used or when standard-label tapes are not used, the system counts the tape markers from the start of the tape to locate the correct sequence number data file to be processed.
</li>
<li>When multiple-file, multiple-volume tapes are processed using REELS(*SL), the file sequence numbers continue consecutively through the volumes; thus, each new data file has a sequence number one greater than the previous file, regardless of its volume location.
</li>
</ul>
<dl>
<dt><b><u>1</u></b></dt>
<dd>For standard-label tapes (not using bypass label processing), the data file having the sequence number 1 is processed. For nonlabeled tapes and for bypass label processing of standard-label tapes, the first data file on the tape is processed.
</dd>
<dt><b>*END</b></dt>
<dd>The file is written on the end of the tape. This value is used only for files that are written to tape.
<p>An error message is shown on the display when a tape device file is used to read from a tape and the *END special value is specified in the tape device file.
</p>
</dd>
<dt><b>*NEXT</b></dt>
<dd>The next file in the sequence is processed. This value is used for files read from tape. If the tape is currently in a position that is prior to the first file, the first file on the tape is processed.
<p>An error message is shown on the display when a tape file is used to write to a tape and the *NEXT special value is specified in the tape file.
</p>
</dd>
<dt><b><i>1-16777215</i></b></dt>
<dd>Specify the sequence number of the file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.LABEL"></a>
<h3>Tape label (LABEL)</h3>
<p>Specifies the data file identifier of the data file processed by this tape device file. An identifier is defined only for standard-label tapes and is stored in the header label immediately before the data file.
</p>
<p>If a data file identifier is specified for any type of label processing other than *SL, it is ignored.
</p>
<p>An identifier is required for a standard label output file, but is optional for an input file because the sequence number uniquely identifies the data file to process.
</p>
<p>For an input file or output file with EXTEND(*YES) specified, this parameter specifies the identifier of the data file on the tape. The specified identifier must match the one in the labels of the data file that the SEQNBR parameter specifies; otherwise, an error message is sent to the program using this device file. For output files with EXTEND(*NO) specified, this parameter specifies the identifier of the data file to be created on the tape.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The data file identifier is not specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the identifier (17 alphanumeric characters maximum) of the data file used with this tape device file. If this identifier is for a tape written in the basic exchange format, and is used on a system other than an iSeries system, up to eight characters or a qualified identifier having no more than eight characters per qualifier must be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.FILETYPE"></a>
<h3>File type (FILETYPE)</h3>
<p>Specifies whether the tape device file being created describes data records or source records (statements) for a program or for another file.
</p>
<dl>
<dt><b><u>*DATA</u></b></dt>
<dd>The tape file describes data records.
</dd>
<dt><b>*SRC</b></dt>
<dd>The tape file describes source records.
<p>
<b>Note: </b>If *SRC is specified, the system adds 12 bytes to the start of every record to replace the source sequence number and date fields.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.IGCDTA"></a>
<h3>User specified DBCS data (IGCDTA)</h3>
<p>Specifies, for program-described files, whether the file processes double-byte character set (DBCS) data. Specifies, for externally described files, the DBCS attributes of the file.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The file does not process double-byte character set (DBCS) data.
</dd>
</dl>
<dl>
<dt><b>*YES</b></dt>
<dd>The file processes double-byte character set (DBCS) data.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies the text that briefly describes the object.
</p>
<dl>
<dt><b><u>*BLANK</u></b></dt>
<dd>No text is specified.
</dd>
<dt><b><i>character-value</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="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.RCDLEN"></a>
<h3>Record length (RCDLEN)</h3>
<p>Specifies, in bytes, the length of the records contained in the data file processed with this device file. The system always uses the record length and block length specified in the data file labels for any standard-label input file or output file with EXTEND(*YES) specified (if a second header label (HDR2) is found on the tape and *BLP label processing has not been specified).
</p>
<dl>
<dt><b><u>*CALC</u></b></dt>
<dd>No record length is specified for the data file being processed. If *CALC is specified, the system will attempt to calculate an appropriate record length when the file is opened. RCDLEN(*CALC) can be used for nonlabeled tapes or when there is no HDR2 label if a BLKLEN value other than *CALC is specified for the file and RCDBLKFMT does not specify spanned or blocked records. In this case, the system calculates an appropriate record length from the block length, record block format, and buffer offset (for an ASCII file) specified for the file. In any other case, the actual record length must be specified by a CHGTAPF command or OVRTAPF command, or in the high-level language program that opens the device file. The system attempts to calculate an appropriate record length when the file is opened.
</dd>
<dt><b><i>integer</i></b></dt>
<dd>Specify the length of each record in the data file. Valid values range from 1 through 32767 bytes.
</dd>
</dl>
<dl>
<dt><b></b></dt>
<dd>
<table border="1">
<caption align="bottom"><b>Figure: EBCDIC RCDLEN Ranges</b>
</caption>
<tr>
<td>
<p>
<pre>
RCDFBLKFMT FILETYPE(*DATA) FILETYPE(*SRC)
---------- --------------- --------------
*F *FB *U 18 - 32767 30 - 32767
*V *VB 1 - 32759 13 - 32767
*VS *VBS 1 - 32759 13 - 32767
</pre>
</p>
</td>
</tr>
</table>
</dd>
</dl>
<dl>
<dt><b></b></dt>
<dd>
<table border="1">
<caption align="bottom"><b>Figure: ASCII RCDLEN Ranges</b>
</caption>
<tr>
<td>
<p>
<pre>
RCDFBLKFMT FILETYPE(*DATA) FILETYPE(*SRC)
---------- --------------- --------------
*F *FB *U 18 - 32767 30 - 32767
*D *DB 1 - 9995 13 - 10007
*VS *VBS 1 - 32759 13 - 32767
</pre>
</p>
</td>
</tr>
</table>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.BLKLEN"></a>
<h3>Block length (BLKLEN)</h3>
<p>Specifies the number of bytes in the maximum length of the data blocks being transferred to or from the tape for reading or writing operations.
</p>
<dl>
<dt><b><u>*CALC</u></b></dt>
<dd>No block length is specified for the data file being processed. The system attempts to calculate an appropriate block length when the file is opened.
</dd>
<dt><b><i>1-524288</i></b></dt>
<dd>Specify the maximum length of each block in the data file to be processed. The minimum block length that can be successfully processing is determined by the tape device hardware and iSeries system machine support functions.
<p>The maximum block length is always 524288 bytes for an input file, but is limited to 9999 bytes if block descriptors must be created for an ASCII output file.
</p>
<p>The following table shows the minimum and maximum block length values allowed for an output file:
</p>
</dd>
</dl>
<dl>
<dt><b></b></dt>
<dd>
<table border="1">
<caption align="bottom"><b>Figure: Minimum and Maximum BLKLEN Values</b>
</caption>
<tr>
<td>
<p>
<pre>
CODE BUFOFSET MIN BLKLEN MAX BLKLEN
-------- -------- ---------- ----------
*EBCDIC Ignored 18 524288
*ASCII 0 18 524288
*ASCII *BLKDSC 18 9999
</pre>
</p>
</td>
</tr>
</table>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.BUFOFSET"></a>
<h3>Buffer offset (BUFOFSET)</h3>
<p>Specifies the buffer offset value for the start of the first record in each block in the tape data file. A buffer offset value can be used for any record block format ASCII file, and is ignored for an EBCDIC tape file. The system uses the buffer offset specified in the data file labels for any standard-label input file or output file with EXTEND(*YES) specified if a value is contained in the second header label (HDR2) on the tape, and *BLP label processing has not been specified.
</p>
<p>The buffer offset parameter specifies the length of any information that precedes the first record in the block. For record block formats *D, *DB, *VS, and *VBS, each record or record segment is preceded by a descriptor that contains the length of the record or segment. A buffer offset value is used to indicate that there is information <i>ahead</i> of the descriptor word for the first record in each block, or <i>ahead</i> of the data of the first fixed-length record or undefined format record in each block.
</p>
<p>This parameter is not needed for a standard-label file processed for input if the tape includes a second file header label (HDR2) that contains the buffer offset value. A buffer offset value must be provided by the Create Tape File (CRTTAPF) command, Change Tape File (CHGTAPF) command, or Override Tape File (OVRTAPF) command, or by the file labels for an input file that contains any information (such as a block descriptor) ahead of the first record in each block. If the user does not specify a buffer offset value when a tape file is created, it is not necessary to specify an offset value when the file is read.
</p>
<p>The only buffer offset values allowed for an output file are zero and *BLKDSC. An existing standard-label data file with a buffer offset value in the HDR2 label can be extended only if the buffer offset value is either 0 or 4. A buffer offset value of 0 in the HDR2 label adds data blocks with <i>no</i> buffer offset. BUFOFSET(*BLKDSC) must be specified to extend an existing tape data file that contains an offset value of 4 in the HDR2 label.
</p>
<dl>
<dt><b><u>0</u></b></dt>
<dd>No buffer offset information precedes the first record in each data block.
</dd>
<dt><b>*BLKDSC</b></dt>
<dd>4-byte block descriptors are created in any tape file created by using this device file. Any input file read by using this device file assumes 4-bytes of buffer offset information preceding the first record in each data block. This value is valid only if *D or *DB is specified for the <b>Record block format (RCDBLKFMT)</b> parameter.
</dd>
<dt><b><i>integer</i></b></dt>
<dd>Specify the length (in bytes) of the buffer offset information that precedes the first record in each data block. Valid values range from 0 through 99 bytes.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.RCDBLKFMT"></a>
<h3>Record block format (RCDBLKFMT)</h3>
<p>Specifies the type and blocking attribute of records in the tape data file being processed.
</p>
<p>Record block format *V and *VB records can be processed only for an EBCDIC file; *D and *DB records can be processed only for an ASCII file. If a standard-label tape (label type *SL or *BLP) is being processed and an inconsistent record block format is specified for the volume code, the correct record type is assumed (V or D) for the volume code and a warning message is sent to the program that opens the file. If the record type and code are inconsistent for a nonlabeled volume (label type *NL, *LTM, or *NS), an error message is sent and the file is <i>not</i> opened, because there are no labels to verify the correct volume code.
</p>
<p>If a valid record length, block length, and buffer offset value (for an ASCII file) are specified for fixed-length records but the block attribute is incorrect, the correct block attribute is assumed (changing record block format *F to *FB or record block format *FB to *F), and a warning message is sent to the program that opens the file.
</p>
<p>If a block length is specified that is longer than required to process a maximum length record, then record block format *V, *D, or *VS is changed to *VB, *DB, or *VBS and a warning message is sent to the program that opens the file.
</p>
<p>
<b>Note: </b>When BUFOFSET(*BLKDSC) is specified for the file, a value of 4 should be used for the BUFOFSET part of any BLKLEN calculations, unless existing file labels on the tape specify a different value.
</p>
<dl>
<dt><b><u>*FB</u></b></dt>
<dd>Fixed length, blocked, unspanned records in either EBCDIC or ASCII code are processed.
</dd>
<dt><b>*F</b></dt>
<dd>Fixed length, deblocked, unspanned records in either EBCDIC or ASCII code are processed.
</dd>
<dt><b>*V</b></dt>
<dd>Variable length, deblocked, unspanned records in EBCDIC type V format are processed.
</dd>
<dt><b>*VB</b></dt>
<dd>Variable length, blocked, unspanned records in EBCDIC type V format are processed.
</dd>
<dt><b>*D</b></dt>
<dd>Variable length, deblocked, unspanned records in ASCII type D format are processed.
</dd>
<dt><b>*DB</b></dt>
<dd>Variable length, blocked, unspanned records in ASCII type D format are processed.
</dd>
<dt><b>*VS</b></dt>
<dd>Variable length, deblocked, spanned records in either EBCDIC or ASCII code are processed.
</dd>
<dt><b>*VBS</b></dt>
<dd>Variable length, blocked, spanned records in either EBCDIC or ASCII code are processed. The representation of spanned records on the tape is different for EBCDIC and ASCII files, but the system selects the correct format based on the file code.
</dd>
<dt><b>*U</b></dt>
<dd>Undefined format records in either EBCDIC or ASCII code are processed.
</dd>
</dl>
<table border="1">
<caption align="bottom"><b>Figure: Required RCDLEN/BLKLEN/BUFOFSET Relation</b>
</caption>
<tr>
<td>
<p>
<pre>
CODE RCDBLKFMT BLKLEN1
========== ========= ===================
*EBCDIC *F *U = RCDLEN
*ASCII *F *U = RCDLEN + BUFOFSET
---------- --------- --------------------
*EBCDIC *FB = RCDLEN * n
*ASCII *FB = (RCDLEN * n) + BUFOFSET
(where n is the number
of records in a
maximum-length block)
---------- --------- --------------------
*EBCDIC *V = RCDLEN * 8
*ASCII *D = RCDLEN * 4 + BUFOFSET
---------- --------- --------------------
*EBCDIC *VB &gt;= RCDLEN + 8
*ASCII *DB &gt;= RCDLEN + 4 + BUFOFSET
---------- --------- --------------------
*EBCDIC *VS *VBS &gt;= 18
*ASCII *BS *VBS &gt;= 6 + BUFOFSET (18 minimum)
---------- --------- --------------------
NOTE: Block length (BLKLEN) is a function of
record length (RCDLEN) and buffer offset (BUFOFSET).
</pre>
</p>
</td>
</tr>
</table>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.EXTEND"></a>
<h3>Extend file (EXTEND)</h3>
<p>Specifies, for output operations to tape, whether new records are added to the end of a data file that is currently on the tape. If the data file is extended, it becomes the last file on the tape volume.
</p>
<p>
<b>Note: </b>This parameter is not valid for 1/4-inch cartridge tape devices.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>Records are not added to the end of the specified data file.
</dd>
</dl>
<p><b>Element 1: Extend file</b>
</p>
<dl>
<dt><b>*YES</b></dt>
<dd>New records are added to the end of the specified data file on tape when this device file is used.
</dd>
</dl>
<p><b>Element 2: Check file</b>
</p>
<dl>
<dt><b><u>*NOCHECK</u></b></dt>
<dd>The file is extended without being checked to determine whether it is active.
</dd>
<dt><b>*CHECK</b></dt>
<dd>Before the file is extended, it is checked to determine whether it is active.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.DENSITY"></a>
<h3>Tape density (DENSITY)</h3>
<p>Specifies the density of the data that is written on the tape volume when this device file is created. This parameter is used only for tape files being written to tape; it is ignored for tape files being read from the tape (in the case of files being read from tape, the density on the tape is used).
</p>
<p>The density of a standard-label volume is specified on the INZTAP command, which initializes tapes as standard-label volumes by writing volume labels on them. If the density specified for this parameter is different than the density of a standard-labeled tape, the tape must be reinitialized to the specified density.
</p>
<dl>
<dt><b><u>*DEVTYPE</u></b></dt>
<dd>The highest capacity density or format supported by the tape device will be used.
</dd>
</dl>
<dl>
<dt><b></b></dt>
<dd>
<dl>
<dt><b>Device</b></dt>
<dd><b> Highest capacity density or format
</b></dd>
<dt><b>3480</b></dt>
<dd>*FMT3480
</dd>
<dt><b>3490E</b></dt>
<dd>*FMT3490E
</dd>
<dt><b>3570-Bxx</b></dt>
<dd>*FMT3570
</dd>
<dt><b>3570-Cxx</b></dt>
<dd>*FMT3570E
</dd>
<dt><b>3580-001</b></dt>
<dd>*ULTRIUM1
</dd>
<dt><b>3580-002</b></dt>
<dd>*ULTRIUM2
</dd>
<dt><b>3580-003</b></dt>
<dd>*ULTRIUM3
</dd>
<dt><b>3590-Bxx</b></dt>
<dd>*FMT3590
</dd>
<dt><b>3590-Exx</b></dt>
<dd>*FMT3590E
</dd>
<dt><b>3590-Hxx</b></dt>
<dd>*FMT3590H
</dd>
<dt><b>3592-J1A</b></dt>
<dd>*FMT3592A1
</dd>
<dt><b>4685-001</b></dt>
<dd>*VXA2
</dd>
<dt><b>6335</b></dt>
<dd>*QIC3040
</dd>
<dt><b>6343</b></dt>
<dd>*QIC1000
</dd>
<dt><b>6344</b></dt>
<dd>*QIC2GB
</dd>
<dt><b>6348</b></dt>
<dd>*QIC1000
</dd>
<dt><b>6349</b></dt>
<dd>*QIC2GB
</dd>
<dt><b>6368</b></dt>
<dd>*QIC1000
</dd>
<dt><b>6369</b></dt>
<dd>*QIC2GB
</dd>
<dt><b>6379</b></dt>
<dd>*QIC1000
</dd>
<dt><b>6380</b></dt>
<dd>*QIC2GB
</dd>
<dt><b>6381</b></dt>
<dd>*QIC2DC
</dd>
<dt><b>6382</b></dt>
<dd>*QIC4DC
</dd>
<dt><b>6383</b></dt>
<dd>*QIC5010
</dd>
<dt><b>6384</b></dt>
<dd>*SLR60
</dd>
<dt><b>6385</b></dt>
<dd>*QIC5010
</dd>
<dt><b>6386</b></dt>
<dd>*MLR3
</dd>
<dt><b>6387</b></dt>
<dd>*SLR100
</dd>
<dt><b>6390</b></dt>
<dd>*FMT7GB
</dd>
<dt><b>63B0</b></dt>
<dd>*VRT256K
</dd>
<dt><b>7207-122</b></dt>
<dd>*QIC4DC
</dd>
<dt><b>7208-002</b></dt>
<dd>*FMT2GB
</dd>
<dt><b>7208-012</b></dt>
<dd>*FMT5GB
</dd>
<dt><b>7208-222</b></dt>
<dd>*FMT7GB
</dd>
<dt><b>7208-342</b></dt>
<dd>*FMT20GB
</dd>
<dt><b>7208-345</b></dt>
<dd>*FMT60GB
</dd>
<dt><b>9348</b></dt>
<dd>6250
</dd>
</dl>
</dd>
<dt><b>*CTGTYPE</b></dt>
<dd>The highest capacity density or format supported by the device for the mounted cartridge type will be used. If the device does not support special cartridge type information, *DEVTYPE is used.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the density or format to use.
<dl>
<dt><b>1600</b></dt>
<dd>The data density on the tape volume is 1,600 bits per inch, which is used for 1/2 inch reel tapes.
</dd>
<dt><b>3200</b></dt>
<dd>The data density on the tape volume is 3,200 bits per inch, which is used for 1/2 inch reel tapes.
</dd>
<dt><b>6250</b></dt>
<dd>The data density on the tape volume is 6,250 bits per inch, which is used for 1/2 inch reel tapes.
</dd>
<dt><b>*FMT3480</b></dt>
<dd>The format of this tape is FMT3480. The data density on this tape volume is formatted to support a 3480 device. This density is used for 1/2 inch cartridge tapes.
</dd>
<dt><b>*FMT3490E</b></dt>
<dd>The format of this tape is FMT3490E. The data density on this tape volume is formatted to support a 3490E device. This density is used for 1/2 inch cartridge tapes.
</dd>
<dt><b>*FMT3570</b></dt>
<dd>The format of this tape is FMT3570. The data format is written on the tape volume with a 3570 device.
</dd>
<dt><b>*FMT3570E</b></dt>
<dd>The format of this tape is FMT3570E. The data format is written on the tape volume with a 3570E device.
</dd>
<dt><b>*FMT3590</b></dt>
<dd>The format of this tape is FMT3590. The data format is written on the tape volume with a 3590 device. This density is used for 1/2 inch cartridge tapes.
</dd>
<dt><b>*FMT3590E</b></dt>
<dd>The format of this tape is FMT3590E. The data format is written on the tape volume with a 3590E device. This density is used for 1/2 inch cartridge tapes.
</dd>
<dt><b>*FMT3590H</b></dt>
<dd>The format of this tape is FMT3590H. The data format is written on the tape volume with a 3590H device. This density is used for 1/2 inch cartridge tapes.
</dd>
<dt><b>*FMT3592A1</b></dt>
<dd>The format of this tape is FMT3592A1. The data format is written on the tape volume with a 3592 device. This density is used for 1/2 inch cartridge tapes.
</dd>
<dt><b>*QIC120</b></dt>
<dd>The format of this tape is QIC120, which is used for 1/4 inch cartridge tapes that can hold 120 megabytes of data.
</dd>
<dt><b>*QIC525</b></dt>
<dd>The format of this tape is QIC525, which is used for 1/4 inch cartridge tapes that can hold 525 megabytes of data.
</dd>
<dt><b>*QIC1000</b></dt>
<dd>The format of this tape is QIC1000, which is used for 1/4 inch cartridge tapes that can hold 1200 megabytes of data.
</dd>
<dt><b>*QIC2GB</b></dt>
<dd>The format of this tape is QIC2GB. It is used by 1/4 inch tape devices which can store 2.5 gigabytes of data on a standard length QIC2GB cartridge.
</dd>
<dt><b>*QIC2DC</b></dt>
<dd>The format of this tape is QIC2DC. It is used to write compacted data to a 1/4 inch cartridge that supports the QIC2GB format.
</dd>
<dt><b>*QIC4GB</b></dt>
<dd>The format of this tape is QIC4GB. It is used by 1/4 inch tape devices which can store 4 gigabytes of data on a standard length QIC4GB cartridge.
</dd>
<dt><b>*QIC4DC</b></dt>
<dd>The format of this tape is QIC4DC. It is used to write compacted data to a 1/4 inch cartridge that supports the QIC4GB format.
</dd>
<dt><b>*QIC3040</b></dt>
<dd>The format of this tape is QIC3040, which is used for 1/4 inch minicartridge tapes that can hold 840 megabytes of data.
</dd>
<dt><b>*QIC5010</b></dt>
<dd>The format of this tape is QIC5010, which is used for 1/4 inch cartridge tapes that can hold 13.5 gigabytes of data.
</dd>
<dt><b>*MLR3</b></dt>
<dd>The format of this tape is MLR3. It is used by 1/4 inch tape devices which can store 25 gigabytes of data on a standard length MLR3 cartridge.
</dd>
<dt><b>*SLR60</b></dt>
<dd>The format of this tape is SLR60. It is used by 1/4 inch tape devices which can typically store 60 gigabytes of compacted data on a standard length SLR60 cartridge.
</dd>
<dt><b>*SLR100</b></dt>
<dd>The format of this tape is SLR100. It is used by 1/4 inch tape devices which can typically store 100 gigabytes of compacted data on a standard length SLR100 cartridge.
</dd>
<dt><b>*FMT2GB</b></dt>
<dd>The format of this tape is FMT2GB, which is used for 8 millimeter cartridge tapes that can hold 2 gigabytes of data.
</dd>
<dt><b>*FMT5GB</b></dt>
<dd>The format of this tape is FMT5GB, which is used for 8 millimeter cartridge tapes that can hold 5 gigabytes of data.
</dd>
<dt><b>*FMT7GB</b></dt>
<dd>The format of this tape is FMT7GB, which is used for 8 millimeter cartridge tapes that can hold 7 gigabytes of data.
</dd>
<dt><b>*FMT20GB</b></dt>
<dd>The format of this tape is FMT20GB. It is used by 8 millimeter tape devices that can store 20 gigabytes of data on a standard length cartridge.
</dd>
<dt><b>*FMT60GB</b></dt>
<dd>The format of this tape is FMT60GB. It is used by 8 millimeter tape devices that can store 60 gigabytes of data on a standard length cartridge.
</dd>
<dt><b>*ULTRIUM1</b></dt>
<dd>The format of this tape is ULTRIUM1. It is used by 1/2 inch cartridge tape devices that can store 100 gigabytes of data on a standard length cartridge.
</dd>
<dt><b>*ULTRIUM2</b></dt>
<dd>The format of this tape is ULTRIUM2. It is used by 1/2 inch cartridge tape devices that can store 200 gigabytes of data on a standard length cartridge.
</dd>
<dt><b>*ULTRIUM3</b></dt>
<dd>The format of this tape is ULTRIUM3. It is used by 1/2 inch cartridge tape devices that can store 400 gigabytes of data on a standard length cartridge.
</dd>
<dt><b>*VRT32K</b></dt>
<dd>The format of the volume is VRT32K. It is used to write data to a virtual volume using a maximum data block size of 32KB. Volumes written using this format can be duplicated to all supported tape devices.
</dd>
<dt><b>*VRT64K</b></dt>
<dd>The format of the volume is VRT64K. It is used to write data to a virtual volume using a maximum data block size of 64KB. Volumes written using this format can only be duplicated to tape devices that support a maximum block size of 64KB or greater.
</dd>
<dt><b>*VRT240K</b></dt>
<dd>The format of the volume is VRT240K. It is used to write data to a virtual volume using a maximum data block size of 240KB. Volumes written using this format can only be duplicated to tape devices that support a maximum block size of 240KB or greater.
</dd>
<dt><b>*VRT256K</b></dt>
<dd>The format of the volume is VRT256K. It is used to write data to a virtual volume using a maximum data block size of 256KB. Volumes written using this format can only be duplicated to tape devices that support a maximum block size of 256KB or greater.
</dd>
<dt><b>*VXA1</b></dt>
<dd>The format of this tape is VXA1. It is used by VXA cartridge tape devices that can store 33 gigabytes of data on a standard length cartridge.
</dd>
<dt><b>*VXA2</b></dt>
<dd>The format of this tape is VXA2. It is used by VXA cartridge tape devices that can store 80 gigabytes of data on a standard length cartridge.
</dd>
</dl>
<p>
<b>Note: </b>Self-configured tape devices may define additional valid values for the density parameter. Use iSeries Navigator (Configuration and Service) (Hardware) (Tape Devices) (Tape Libraries) (Tape Resources) (Properties) or (Configuration and Service)(Hardware) (Tape Devices) (Stand-Alone Devices) (Properties) to find additional valid density values for a specific device, or use the F4=Prompt key on the "Tape density" field of the CL command to see a list of all valid density values for the attached tape devices.
</p>
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.COMPACT"></a>
<h3>Data compaction (COMPACT)</h3>
<p>Specifies whether device data compaction is performed. If the tape devices being used do not support data compaction, this parameter will be ignored when the file is opened.
</p>
<dl>
<dt><b><u>*DEVD</u></b></dt>
<dd>Device data compaction is performed if the devices being used support data compaction.
</dd>
<dt><b>*NO</b></dt>
<dd>Device data compaction is not performed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.CODE"></a>
<h3>Code (CODE)</h3>
<p>Specifies the type of character code used when tape data is read or written by a job that uses this tape device file.
</p>
<dl>
<dt><b><u>*EBCDIC</u></b></dt>
<dd>The EBCDIC character code is used with this tape device file.
</dd>
</dl>
<dl>
<dt><b>*ASCII</b></dt>
<dd>The ASCII character code is used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.CRTDATE"></a>
<h3>Creation date (CRTDATE)</h3>
<p>Specifies the date when the data file was created on (written to) tape. The data file creation date is stored in file labels on the tape. If a creation date is specified for any type of label processing other than *SL, it is ignored.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>The creation date is not specified.
</dd>
<dt><b><i>date</i></b></dt>
<dd>Specify the creation date of the data file used by this tape device file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.EXPDATE"></a>
<h3>File expiration date (EXPDATE)</h3>
<p>Specifies, for tape output data files only, the expiration date of the data file used by this device file. The data file expiration date is stored in file labels on the tape. If an expiration date is specified for any type of label processing other than *SL, it is ignored. The data file is protected and cannot be written over until the specified expiration date.
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>No expiration date is specified for the data file. The data file is not protected.
</dd>
<dt><b>*PERM</b></dt>
<dd>The data file is protected permanently. The date written on the tape is 999999.
</dd>
<dt><b><i>date</i></b></dt>
<dd>Specify the date on which and after which the data file is no longer protected.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.ENDOPT"></a>
<h3>End of tape option (ENDOPT)</h3>
<p>Specifies the positioning operation performed automatically on the tape volume when the tape device file is closed. In the case of a multiple-volume data file, this parameter applies only to the <i>last</i> reel.
</p>
<dl>
<dt><b><u>*REWIND</u></b></dt>
<dd>The tape is automatically rewound, but not unloaded, after the operation has ended.
</dd>
</dl>
<dl>
<dt><b>*UNLOAD</b></dt>
<dd>The tape is automatically rewound and unloaded after the operation ends.
</dd>
</dl>
<dl>
<dt><b>*LEAVE</b></dt>
<dd>The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.
</dd>
</dl>
<p>
<b>Note: </b>Even if *LEAVE is specified for the ENDOPT parameter, the next tape file opened to this reel is positioned at the start or end of a data file when it is opened.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.USRLBLPGM"></a>
<h3>User label program (USRLBLPGM)</h3>
<p>Specifies the user program that processes user-defined tape labels. On an output file, the user label program passes the user labels that are written to tape. On an input file, the user labels are passed to the user label program.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*NONE</u></b></dt>
<dd>There is no user label program for this device file.
</dd>
</dl>
<p><b>Qualifier 1: User label program</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the user program that processes the user tape labels.
</dd>
</dl>
<p><b>Qualifier 2: Library</b>
</p>
<dl>
<dt><b><u>*LIBL</u></b></dt>
<dd>All libraries in the library list for the current thread are searched until the first match is found.
</dd>
</dl>
<dl>
<dt><b>*CURLIB</b></dt>
<dd>The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of the library to be searched.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.WAITFILE"></a>
<h3>Maximum file wait time (WAITFILE)</h3>
<p>Specifies the number of seconds that the program waits for the file resources to be allocated when the file is opened, or the device or session resources to be allocated when an acquire operation is performed to the file. If the file resources cannot be allocated in the specified wait time, an error message is sent to the program.
</p>
<dl>
<dt><b><u>*IMMED</u></b></dt>
<dd>The program does not wait. Immediate allocation of file resources is required.
</dd>
</dl>
<dl>
<dt><b>*CLS</b></dt>
<dd>The job default wait time is used as the wait time for the file resources to be allocated.
</dd>
<dt><b><i>1-32767</i></b></dt>
<dd>Specify the number of seconds to wait for file resources to be allocated.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.SHARE"></a>
<h3>Share open data path (SHARE)</h3>
<p>Specifies whether the open data path (ODP) is shared with other programs in the same routing step. When an ODP is shared, the programs accessing the file share facilities such as the file status and the buffer.
</p>
<dl>
<dt><b><u>*NO</u></b></dt>
<dd>The ODP is not shared with other programs in the routing step. A new ODP for the file is created and used every time a program opens the file.
</dd>
</dl>
<dl>
<dt><b>*YES</b></dt>
<dd>The same ODP is shared with each program in the job that also specifies *YES when it opens the file.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.AUT"></a>
<h3>Authority (AUT)</h3>
<p>Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
</p>
<dl>
<dt><b><u>*LIBCRTAUT</u></b></dt>
<dd>The system determines the authority for the object by using the value specified for the <b>Create authority (CRTAUT)</b> parameter on the Create Library command (CRTLIB) for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
</dd>
</dl>
<dl>
<dt><b>*CHANGE</b></dt>
<dd>The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
</dd>
</dl>
<dl>
<dt><b>*ALL</b></dt>
<dd>The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
</dd>
</dl>
<dl>
<dt><b>*USE</b></dt>
<dd>The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
</dd>
</dl>
<dl>
<dt><b>*EXCLUDE</b></dt>
<dd>The user cannot access the object.
</dd>
</dl>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CRTTAPF.REPLACE"></a>
<h3>Replace file (REPLACE)</h3>
<p>Specifies whether an existing file, other than a save or database file, is replaced.
</p>
<dl>
<dt><b><u>*YES</u></b></dt>
<dd>An file is replaced if the creation of the new tape device file with the same name and library is successful.
</dd>
<dt><b>*NO</b></dt>
<dd>The creation of a new tape device file is not allowed if there is an existing file with the same name and library.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTTAPF.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Creating a Description of a Tape Device File</b>
</p>
<p>
<pre>
CRTTAPF FILE(BACKHST) DEV(QTAPE1 QTAPE2 QTAPE3)
REELS(*BLP 10) RCDLEN(256) BLKLEN(1024)
RCDBLKFMT(*FB) EXTEND(*YES)
ENDOPT(*UNLOAD) WAITFILE(60)
</pre>
</p>
<p>This command creates a description of the tape device file named BACKHST in the current library, to be used with the tape devices QTAPE1, QTAPE2, and QTAPE3. All volumes processed on these devices with this device file must have standard-labels. Each block of data (EBCDIC character code) on the tape volumes contains four records of 256 bytes each. When records are written to the tape, they are added to the end of the data file. No creation or expiration date is specified for this tape, and both unloading and rewinding operations will occur when the device file is closed at the last tape volume processed. The program using this tape device file waits 60 seconds for file resources to be allocated when this file is opened, and this device file is used only when the current program is running.
</p>
<p><b>Example 2: Creating a Tape File Containing DBCS Data</b>
</p>
<p>
<pre>
CRTTAPF FILE(IGCLIB/IGCTAP) LABEL(GENINF) IGCDTA(*YES)
</pre>
</p>
<p>This command creates the tape file IGCTAP that is stored in library IGCLIB, which is labeled GENINF, and contains DBCS data.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CRTTAPF.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF7302</b></dt>
<dd>File &amp;1 not created in library &amp;2.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CRTTAPF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink