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/chgtapf.htm

1158 lines
45 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>Change Tape File (CHGTAPF)</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="CHGTAPF.Top_Of_Page"></a>
<h2>Change Tape File (CHGTAPF)</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="#CHGTAPF.PARAMETERS.TABLE">Parameters</a><br>
<a href="#CHGTAPF.COMMAND.EXAMPLES">Examples</a><br>
<a href="#CHGTAPF.ERROR.MESSAGES">Error messages</a></td>
</tr>
</table>
<div> <a name="CHGTAPF"></a>
<p>The Change Tape File (CHGTAPF) command changes the attributes of the specified tape device file.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div>
<h3><a name="CHGTAPF.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="#CHGTAPF.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, Key, 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>*LIBL</u></b>, *CURLIB</td>
</tr><tr>
<td valign="top"><a href="#CHGTAPF.DEV"><b>DEV</b></a></td>
<td valign="top">Tape device</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<br>Other values (up to 4 repetitions): <i>Name</i></td>
<td valign="top">Optional, Positional 2</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.VOL"><b>VOL</b></a></td>
<td valign="top">Volume identifier</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<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="#CHGTAPF.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>*SAME</u></b>, *SL, *NL, *NS, *BLP, *LTM</td>
</tr>
<tr>
<td valign="top">Element 2: Number of reels</td>
<td valign="top">
1-255, <b><u>*SAME</u></b></td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.SEQNBR"><b>SEQNBR</b></a></td>
<td valign="top">Sequence number</td>
<td valign="top">1-16777215, <b><u>*SAME</u></b>, *END, *NEXT</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.LABEL"><b>LABEL</b></a></td>
<td valign="top">Tape label</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.TEXT"><b>TEXT</b></a></td>
<td valign="top">Text 'description'</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *BLANK</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.RCDLEN"><b>RCDLEN</b></a></td>
<td valign="top">Record length</td>
<td valign="top"><i>Integer</i>, <b><u>*SAME</u></b>, *CALC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.BLKLEN"><b>BLKLEN</b></a></td>
<td valign="top">Block length</td>
<td valign="top">1-524288, <b><u>*SAME</u></b>, *CALC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.BUFOFSET"><b>BUFOFSET</b></a></td>
<td valign="top">Buffer offset</td>
<td valign="top"><i>Integer</i>, <b><u>*SAME</u></b>, *BLKDSC</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.RCDBLKFMT"><b>RCDBLKFMT</b></a></td>
<td valign="top">Record block format</td>
<td valign="top"><b><u>*SAME</u></b>, *FB, *F, *V, *VB, *D, *DB, *VS, *VBS, *U</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGTAPF.EXTEND"><b>EXTEND</b></a></td>
<td valign="top">Extend</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NO<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="#CHGTAPF.DENSITY"><b>DENSITY</b></a></td>
<td valign="top">Tape density</td>
<td valign="top"><i>Character value</i>, <b><u>*SAME</u></b>, *DEVTYPE, *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="#CHGTAPF.COMPACT"><b>COMPACT</b></a></td>
<td valign="top">Data compaction</td>
<td valign="top"><b><u>*SAME</u></b>, *DEVD, *NO</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.CODE"><b>CODE</b></a></td>
<td valign="top">Code</td>
<td valign="top"><b><u>*SAME</u></b>, *EBCDIC, *ASCII</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.CRTDATE"><b>CRTDATE</b></a></td>
<td valign="top">Creation date</td>
<td valign="top"><i>Date</i>, <b><u>*SAME</u></b>, *NONE</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.EXPDATE"><b>EXPDATE</b></a></td>
<td valign="top">File expiration date</td>
<td valign="top"><i>Date</i>, <b><u>*SAME</u></b>, *NONE, *PERM</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.ENDOPT"><b>ENDOPT</b></a></td>
<td valign="top">End of tape option</td>
<td valign="top"><b><u>*SAME</u></b>, *REWIND, *LEAVE, *UNLOAD</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top" rowspan="3"><a href="#CHGTAPF.USRLBLPGM"><b>USRLBLPGM</b></a></td>
<td valign="top">User label program</td>
<td valign="top">Single values: <b><u>*SAME</u></b>, *NONE<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="#CHGTAPF.IGCDTA"><b>IGCDTA</b></a></td>
<td valign="top">User specified DBCS data</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.WAITFILE"><b>WAITFILE</b></a></td>
<td valign="top">Maximum file wait time</td>
<td valign="top"><i>Integer</i>, <b><u>*SAME</u></b>, *IMMED, *CLS</td>
<td valign="top">Optional</td>
</tr>
<tr>
<td valign="top"><a href="#CHGTAPF.SHARE"><b>SHARE</b></a></td>
<td valign="top">Share open data path</td>
<td valign="top"><b><u>*SAME</u></b>, *NO, *YES</td>
<td valign="top">Optional</td>
</tr>
</table>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
</div>
<div> <a name="CHGTAPF.FILE"></a>
<h3>File (FILE)</h3>
<p>Specifies the tape device file to be changed.
</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.
</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 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 name where the tape device file is located.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.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 device file to perform input/output 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>*SAME</u></b></dt>
<dd>The device name (if any) does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No device names are specified. They must be supplied later on an Override Tape File (OVRTAPF) command, on another Change Tape file (CHGTAPF) command, or when the tape device file is opened.
</dd>
</dl>
<p><b>Other values (up to 4 repetitions)</b>
</p>
<dl>
<dt><b><i>name</i></b></dt>
<dd>Specify the names of up to 4 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 the devices are processed. When more volumes are processed than the number of devices in the DEV list, the devices are used in the same order specified, wrapping around to the first device as needed. Each device name must be known on the system by a device description before this device file is created.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.VOL"></a>
<h3>Volume identifier (VOL)</h3>
<p>Specifies one or more volume identifiers used by the file. The tapes (volumes) must be placed in the devices in the same order as the identifiers are specified in the device file used with the device specified for the <b>Tape device (DEV)</b> parameter. If the file is opened for being read backward, 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.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The volume identifiers do not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No tape volume identifiers are specified for this file. They can be supplied before the device file is opened, either in the Change Tape File (CHGTAPF) command, the Override Tape File (OVRTAPF) command, or in the high-level language program.
</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 processed, placed in the devices, and used by this device file. Each identifier can have six or fewer alphanumeric characters. The maximum number of reels processed for an *NL, *LTM, *NS, or *BLP input file is determined by the number of volume identifiers in the list.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.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 that can be processed, if no list of volume identifiers is specified for the <b>Volume identifier (VOL)</b> parameter and this device file is used with either *NL, *LTM, *NS, or *BLP input files.
</p>
<p>When the number of reels is specified, the volume identifiers on the tapes are ignored if labeled tapes are being processed. The order in which the reels is arranged within the volumes must be checked by the operator.
</p>
<p>The number of reels value (the second part of this parameter) is not a limiting value for standard-labeled output files. For a standard-labeled input file, the data file labels limit the number of volumes that can be processed by indicating end-of-file. For an output file, the maximum number of reels value is ignored. The system requests that additional volumes be placed in the device until the output file is closed.
</p>
<p>
<b>Note: </b>The values *SL, *NL, and *LTM can be specified if the device file is used for either reading from or writing to tapes. The values *NS and *BLP are valid only if the device file is used to read from tapes.
</p>
<p><b>Element 1: Label processing type</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The type of volume (tape) and tape file labeling does not change.
</dd>
<dt><b>*SL</b></dt>
<dd>The volumes (tapes) have standard labels. The volume identifiers are ignored. Instead, the number-of-reels value is checked.
</dd>
<dt><b>*NL</b></dt>
<dd>The volumes (tapes) have no labels. On a nonlabeled volume, tape markers are used to indicate the beginning and end of the volume and each data file on it.
</dd>
<dt><b>*NS</b></dt>
<dd>The volumes (tapes) have nonstandard labels. The load point on the tape may be immediately followed by an optional beginning-of-tape marker and some kind of volume and file information, but these are ignored. Only a single data file can exist on a nonstandard tape.
</dd>
<dt><b>*BLP</b></dt>
<dd>Standard label processing is bypassed. Each reel must 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 marks between it and the beginning of the tape. Bypass label processing can be used when some file label information is incorrect.
</dd>
<dt><b>*LTM</b></dt>
<dd>The volumes have no labels, but they do have a single leading tape marker before the first data file.
</dd>
</dl>
<p><b>Element 2: Number of reels</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The number of reels does not change.
</dd>
<dt><b><i>1-255</i></b></dt>
<dd>Specify the maximum number of reels that are processed for a *NL, *LTM, *NS, or *BLP input tape operation when a list of volume identifiers is not specified. 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="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.SEQNBR"></a>
<h3>Sequence number (SEQNBR)</h3>
<p>Specifies the file sequence number of the data file on the tape that is being processed. When standard-labeled tapes are used, the four-position file sequence number is read from the first header label of the data file. When bypass label processing is used or when standard-labeled tapes are not used, the system uses the tape marks and the value specified (or assumed) by this parameter to locate the correct data file being processed.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The file sequence number does not change.
</dd>
<dt><b>*END</b></dt>
<dd>The file is written to the end of the tape. This value can only be specified in tape files that are used to write to tape. An error message is issued when a tape file is used to read from a tape and *END was specified in the tape file.
</dd>
<dt><b>*NEXT</b></dt>
<dd>The next file on the tape is processed. If the tape is currently positioned prior to the first file, the first file on the tape is processed. This value can only be specified in tape files being used to read from tape. An error message is issued when a tape file is used to write to a tape and *NEXT was specified in the tape file.
</dd>
<dt><b><i>1-16777215</i></b></dt>
<dd>Specify the file sequence number of the file being processed on this tape.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.LABEL"></a>
<h3>Tape label (LABEL)</h3>
<p>Specifies the data file identifier of the data file that is being processed by this tape device file. The data file identifier is defined only for standard-labeled tapes and is stored in the header label immediately before the data file that the header describes.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The data file identifier does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>The data file identifier is not specified.
</dd>
<dt><b><i>character-value</i></b></dt>
<dd>Specify the identifier of the data file being used with this tape device file. If this identifier is for a tape that is written in the basic exchange format, and it is being used on a system other than an iSeries system, a maximum of 8 characters is used or a qualified identifier having no more than 8 characters per qualifier should be used. Otherwise, a maximum of 17 alphanumeric characters can be used.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.TEXT"></a>
<h3>Text 'description' (TEXT)</h3>
<p>Specifies text that describes the tape device file.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The text (if any) does not change.
</dd>
<dt><b>*BLANK</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="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.RCDLEN"></a>
<h3>Record length (RCDLEN)</h3>
<p>Specifies the length (in bytes) of the records contained in the data file being processed with this device file.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The record length does not change.
</dd>
<dt><b>*CALC</b></dt>
<dd>No record length is specified for the data file being processed. If *CALC is specified, the system attempts to calculate an appropriate record length when the file is opened.
</dd>
<dt><b><i>integer</i></b></dt>
<dd>Specify a value ranging from 1 through 32767 bytes that specifies the length of each record in the data file being processed. The minimum and maximum record length allowed for a file depends on the record block format, block length, buffer offset (for an ASCII file), and recording code.
</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="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.BLKLEN"></a>
<h3>Block length (BLKLEN)</h3>
<p>Specifies the maximum length (in bytes) of data blocks being moved to or from the tape for output or input operations.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The data block length does not change.
</dd>
<dt><b>*CALC</b></dt>
<dd>No data block length is specified for the data file being processed. If *CALC is specified, 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="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.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 for an ASCII file, and it is ignored for an EBCDIC tape file. This parameter is not needed for a standard-labeled file processed for input if the tape includes a second file header label (HDR2) that contains the buffer offset value.
</p>
<p>A buffer offset must be provided by the Create Tape File (CRTTAPF) command, the Change Tape File (CHGTAPF) command, the Override with Tape File (OVRTAPF) command, or by the file labels for an input file that contain any information (such as a block descriptor) ahead of the first record in each block. If you do not specify a buffer offset when a tape file is created, it is not necessary to specify an offset value when the file is read. The only buffer offset values allowed for an output file are zero and *BLKDSC.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The buffer offset value does not change.
</dd>
<dt><b>*BLKDSC</b></dt>
<dd>Block descriptors 4-bytes in length are created in tape files created by using this device file. Input files that are read by using this device file assume 4-bytes of buffer offset information preceding the first record in each data block.
</dd>
<dt><b><i>0-99</i></b></dt>
<dd>Specify the length of the buffer offset information that precedes the first record in each data block.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.RCDBLKFMT"></a>
<h3>Record block format (RCDBLKFMT)</h3>
<p>Specifies the blocking attribute and type of records in the tape data file being processed. Record block format *V and *VB records can only be processed for an EBCDIC file; *D and *DB records can only be processed for an ASCII file.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The record block format does not change.
</dd>
<dt><b>*FB</b></dt>
<dd>Constant length, blocked, unspanned records in either EBCDIC or ASCII code are processed. The system may change this record block format to *F, based on other file parameters.
</dd>
<dt><b>*F</b></dt>
<dd>Constant length, deblocked, unspanned records in either EBCDIC or ASCII code are processed. The system may change this record block format to *FB, based on other file parameters.
</dd>
<dt><b>*V</b></dt>
<dd>Variable length, deblocked, unspanned records in EBCDIC type V format are processed. The system may change this record block format to *VB, *D, or *DB, based on other file parameters.
</dd>
<dt><b>*VB</b></dt>
<dd>Variable length, blocked, unspanned records in EBCDIC type V format are processed. The system may change this record block format to *DB, based on the volume code.
</dd>
<dt><b>*D</b></dt>
<dd>Variable length, deblocked, unspanned records in ASCII type D format are processed. The system may change this record block format to *DB, *V, or *VB, based on other file parameters.
</dd>
<dt><b>*DB</b></dt>
<dd>Variable length, blocked, unspanned records in ASCII type D format are processed. The system may change this record block format to *VB, based on the volume code.
</dd>
<dt><b>*VS</b></dt>
<dd>Variable length, deblocked, spanned records in either EBCDIC or ASCII code are processed. The system may change this record block format to *VBS, based on other file parameters.
</dd>
<dt><b>*VBS</b></dt>
<dd>Variable length, blocked, spanned records in either EBCDIC or ASCII code are processed. Note that 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. *U records are processed as variable length records, and each record being written or read is in a separate tape block. This format is useful for processing tape files that do not meet the formatting requirements of any other record block format.
</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="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.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. The specific data file is identified by the SEQNBR parameter and, for a standard-label file, the LABEL parameter. If the data file is extended, it becomes the last file on the tape volume; data files that follow it are overwritten as the specified file is extended.
</p>
<p>
<b>Note: </b>This parameter is not valid for 1/4-inch cartridge tape devices.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
<dt><b>*NO</b></dt>
<dd>Records are not added to the end of the specified data file on tape.
</dd>
<dt><b>*YES</b></dt>
<dd>New records are added to the end of the specified data file on tape.
</dd>
<dt><b>*NOCHECK</b></dt>
<dd>The file is extended without checking to determine whether it is active.
</dd>
<dt><b>*CHECK</b></dt>
<dd>Before the file is extended, a check is made to determine whether it is active.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.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 used. This parameter is used only for tapes written as nonlabeled volumes (*NL); it is not valid unless the <i>first</i> data file is being written on the nonlabeled volume. The density of a standard-labeled volume is specified on the Initialize Tape (INZTAP) command, which initializes tapes as standard-labeled volumes by writing volume labels on them. If a labeled or nonlabeled output file is written with a density different than the density specified by this parameter, a warning message is sent.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The data density does not change.
</dd>
</dl>
<dl>
<dt><b>*DEVTYPE</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="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*DEVD</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="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.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>*SAME</u></b></dt>
<dd>The type of character code does not change.
</dd>
<dt><b>*EBCDIC</b></dt>
<dd>The EBCDIC character code is used.
</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="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.CRTDATE"></a>
<h3>Creation date (CRTDATE)</h3>
<p>Specifies, for tape input data files and for tape output for which *YES is specified for the <b>Extend file (EXTEND)</b> parameter, the date when the data file was created (written on tape).
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The creation date does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>The creation date is not specified. It is not checked unless it is supplied in the Override with Tape File (OVRTAPF) command or in the high-level language program.
</dd>
<dt><b><i>date</i></b></dt>
<dd>Specify the creation date of the data file being used by this device file. The date must be specified in the job date format and, if separators are used, using the job date separator character.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.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. 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>*SAME</u></b></dt>
<dd>The expiration date does not change.
</dd>
<dt><b>*NONE</b></dt>
<dd>No expiration date for the data file is specified. The 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 beyond which, the data file is no longer protected.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.ENDOPT"></a>
<h3>End of tape option (ENDOPT)</h3>
<p>Specifies the operation that is automatically performed on the tape volume after the operation ends. If more than one volume is included, this parameter applies only to the last tape volume used; all other tape volumes are rewound and unloaded when the end of the tape is reached.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*REWIND</b></dt>
<dd>The tape is rewound, but not unloaded.
</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>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.USRLBLPGM"></a>
<h3>User label program (USRLBLPGM)</h3>
<p>Specifies the user program that processes user tape labels. On an output file, the user tape label program passes the user tape labels that are written to tape. On an input file, the user tape labels are passed to the user label program.
</p>
<p><b>Single values</b>
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The user label program name does not change.
</dd>
<dt><b>*NONE</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="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.IGCDTA"></a>
<h3>User specified DBCS data (IGCDTA)</h3>
<p>Specifies whether the file processes double-byte character set (DBCS) data.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The IGCDTA value does not change.
</dd>
</dl>
<dl>
<dt><b>*NO</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="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.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. If the file resources cannot be allocated within the specified wait time, an error message is sent to the program.
</p>
<dl>
<dt><b><u>*SAME</u></b></dt>
<dd>The wait time does not change.
</dd>
</dl>
<dl>
<dt><b>*IMMED</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="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<div> <a name="CHGTAPF.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>*SAME</u></b></dt>
<dd>The value does not change.
</dd>
</dl>
<dl>
<dt><b>*NO</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="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGTAPF.COMMAND.EXAMPLES">Examples</a> </h3>
<p><b>Example 1: Changing the Tape File Description</b>
</p>
<p>
<pre>
CHGTAPF FILE(TAPE01) LABEL(TUESDAY)
</pre>
</p>
<p>This command changes the description of the tape device file named TAPE01. The LABEL parameter now contains the data file identifier TUESDAY.
</p>
<p><b>Example 2: Enabling a Tape File to Process DBCS Data</b>
</p>
<p>
<pre>
CHGTAPF FILE(IGCLIB/IGCTAP) IGCDTA(*YES)
</pre>
</p>
<p>This command changes the tape file IGCTAP, which is stored in the library IGCLIB, so that the file processes double-byte character set data.
</p>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
<hr size="2" width="100%">
<div><h3><a name="CHGTAPF.ERROR.MESSAGES">Error messages</a> </h3>
<p><b><u>*ESCAPE Messages</u></b>
</p>
<dl>
<dt><b>CPF7304</b></dt>
<dd>File &amp;1 in &amp;2 not changed.
</dd>
</dl>
</div>
<table width="100%">
<tr><td align="right"><a href="#CHGTAPF.Top_Of_Page">Top</a></td></tr>
</table>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink