z/OS DFSMSdfp Utilities
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


INITT Statement

z/OS DFSMSdfp Utilities
SC23-6864-00

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]
where:
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 .

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014