INITT Statement
The syntax of the INITT statement is:
| Label | Statement | Parameters |
|---|---|---|
| ddname | INITT | SER=serial number |
| [,DISP={REWIND|UNLOAD}] | ||
| [,OWNER='name'] | ||
| [,NUMBTAPE={n|1}] | ||
| [,LABTYPE=AL] | ||
| [,VERSION={3|4 }] | ||
| [,ACCESS=c] |
- ddname
- specifies the name that is identical to the ddname in the name field of the DD statement defining a tape unit(s). This name must begin in column 1 of the record which contains the INITT statement.
- SER=serial number
- specifies
the volume serial number of the first or only tape to be labeled. Specify
up to six characters. For IBM standard labeled (SL) tapes, the
serial number cannot contain blanks, commas, apostrophes, equal signs,
or special characters other than periods, hyphens, dollar signs, pound
signs, and at signs ('@'). ISO/ANSI labeled tapes (AL) may contain
any valid ISO/ANSI a type character as described under the
OWNER keyword. However, if any nonalphanumeric character (including
a period or a hyphen) is present, delimiting apostrophes must be included.
You cannot use a blank as the first character in a volume serial number.
If you set the NUMBTAPE keyword to a value greater than 1, then the volume serial number must be all numeric. If the volume serial number is alphanumeric, the last three digits must be numeric. If the volume serial number is all numeric, it is increased by one for each additional tape (serial number 999999 is increased to 000000). If the volume serial number is alphanumeric, only the last three digits are increased by one for each additional tape (serial number VOL999 is increased to VOL000).
- NUMBTAPE={n|1}
- specifies the number of tapes to be processed. The value n represents a number from 1 to 255. If more than one tape is specified, the volume serial number of the first tape must be all numeric. If the volume serial number is specified as alphanumeric, the last three digits must be numeric.
- DISP={REWIND|UNLOAD}
- specifies
if a tape is to be rewound or rewound and unloaded. Tapes in a
Tape Library Dataserver are unconditionally unloaded regardless of
the specification for this parameter. These values can be coded:
- REWIND
- specifies that a tape is to be rewound (but not unloaded) after the label has been written.
- UNLOAD
- specifies that a tape is to be rewound and unloaded after the label has been written. This is the default.
- OWNER='name'
- specifies the owner's name or similar identification. The information
is specified as character constants, and can be up to 10 bytes in
length for EBCDIC and BCD volume labels, or up to 14 bytes in length
for volume labels written in ASCII. The delimiting apostrophes must
be present if blanks, commas, apostrophes, equal signs, or other special
characters (except periods or hyphens) are included. The set of valid
ISO/ANSI a type characters for ASCII tapes is as follows:
upper case A-Z, numeric 0-9, and special characters !*"%&'()*+,-./:;<=>?.
The set of valid EBCDIC characters is as follows: uppercase A-Z, numeric
0-9, and special characters ¢ . < >( + ¦(X'6A') |(X'4F') ' &
! $ * ) ; ^ - \ / , % _ ? ′ : # @ ' = " ~ { } \.
If an apostrophe is included within the OWNER name field, it must be written as two consecutive apostrophes.
The OWNER keyword can be specified for Version 3 or Version 4 tapes. If Version 4 is specified, any ISO/ANSI a type character can be used. - NUMBTAPE={n|1}
- specifies the number of tapes to be labeled according to the specifications made in this control statement. The value n represents a number from 1 to 255. If more than one tape is specified, the volume serial number of the first tape must be numeric.
- LABTYPE=AL
- When
LABTYPE=AL is specified in the INITT statement, IEHINITT initializes
tapes to conform to the Version 3 standard or the Version 4 standard
as specified in the VERSION keyword. The format of the VERSION keyword
follows.
Default: The tape is written in EBCDIC in IBM standard format for tape cartridges or 9-track tape volumes and in BCDIC for 7-track tape volumes.
- VERSION={3|4}
- When
LABTYPE=AL is specified, the VERSION keyword determines if the format
will be Version 3 or Version 4.
- 3
- Initializes the tape to be Version 3
- 4
- Initializes the tape to be Version 4
The volume label (VOL 1) is written the same for Version 3 and Version 4 with one exception. Field Label Standard Version will be 3 for Version 3 and 4 for Version 4. There will be no difference in the initialization of the header labels.
Default: If this keyword is specified, that value is used. If not, the installation version level in the DEVSUPxx PARMLIB member is used. If that is not specified, Version 3 is the default.
- ACCESS=c
- specifies the Version
3 and Version 4 volume accessibility code. Version 3 valid values
for c are uppercase A through Z only. The
default value is a blank character, indicating unlimited access to
the volume. For Version 3, you cannot specify a blank character
for the access code; it must be allowed to default. Version 4 valid
values are any ISO/ANSI a type characters as follows: upper
case A-Z, numeric 0-9, and special characters !*"%&'()*+,-./:;<=>?.
The Volume Access installation exit routine must be modified to allow subsequent use of the volume if ACCESS is specified.
You must specify LABTYPE=AL and VERSION if you specify ACCESS.
The ACCESS keyword can be specified for Version 3 or Version 4. If Version 4 is specified, the keyword can be any ISO/ANSI a type character.
Related reading: For more information about volume accessibility and ISO/ANSI installation exits, see z/OS DFSMS Using Magnetic Tapes.