Initialize Tape (INZTAP)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Initialize Tape (INZTAP) command is used to initialize magnetic tapes for use on the system. This command is used to initialize a tape with a standard volume label for standard label magnetic tape processing, or to initialize a tape with no labels for unlabeled magnetic tape processing.

Top

Parameters

Keyword Description Choices Notes
DEV Device Name Required, Positional 1
NEWVOL New volume identifier Character value, *NONE, *CTGID Optional, Positional 2
NEWOWNID New owner identifier Character value, *BLANK Optional, Positional 3
VOL Volume identifier Character value, *MOUNTED Optional
CHECK Check for active files *YES, *NO, *FIRST Optional
DENSITY Tape density Character value, *DEVTYPE, *CTGTYPE, *FMT3480, *FMT3490E, *FMT3570, *FMT3570E, *FMT3590, *FMT3590E, *FMT3590H, *QIC120, *QIC525, *QIC1000, *QIC2GB, *QIC2DC, *QIC4GB, *QIC4DC, *QIC3040, *QIC5010, *MLR3, *SLR60, *SLR100, *FMT2GB, *FMT5GB, *FMT7GB, *FMT20GB, *FMT60GB, *ULTRIUM1, *ULTRIUM2, *VXA1, *VXA2, 1600, 3200, 6250 Optional
CODE Code *EBCDIC, *ASCII Optional
ENDOPT End of tape option *REWIND, *UNLOAD Optional
CLEAR Clear *NO, *YES Optional
Top

Device (DEV)

Specifies the name of the device in which the volume being initialized for use is placed. Specify the name of the tape or media library device.

This is a required parameter.

Top

New volume identifier (NEWVOL)

Specifies the volume identifier for a tape being initialized for use as a standard labeled tape. If no volume identifier is specified, the tape is initialized for use as an unlabeled tape.

*NONE
The tape is initialized for use as an unlabeled tape. Only tape marks are used to indicate the beginning and end of each data file on it, and the beginning and end of the volume itself.
*CTGID
The tape is initialized as a standard labeled tape. The new logical volume identifier is the same as the external identifier of the tape cartridge. Each tape within a library device must have a unique external identifier.
character-value
Specify no more than 6 characters to identify the new volume. The identifier must contain only alphanumeric characters (A through Z, $, #, @, and 0 through 9), and cannot have a prefix or contain blanks.
Top

New owner identifier (NEWOWNID)

Specifies the identifier of the tape owner to write in the volume label.

*BLANK
Text is not specified.
character-value
Specify no more than 14 characters that identify the owner of the tape. If fewer than 14 characters are specified, the field is left-justified and padded on the right with blanks.
Top

Volume identifier (VOL)

Specifies the existing volume identifier of the tape being initialized for use or indicates that the tape currently on the magnetic tape unit should be initialized for use.

Note: If the device specified is a media library device, or a virtual tape device, then the volume specified should be the cartridge identifier or virtual tape volume name to be mounted and used.

*MOUNTED
Any labeled or unlabeled volume that is placed in the specified tape device is initialized for use. To initialize a new or empty volume for use, *MOUNTED must be specified, and *NO must be specified on the Check for active files prompt (CHECK parameter). For a media library device, the volume to be used is the next cartridge in the category mounted by the Set Tape Category (SETTAPCGY) command. For a virtual tape device, the volume to be used is the currently mounted one, or if there is not a currently mounted volume, the next volume in loaded status in the image catalog will be used.
character-value
Specify the identifier of the labeled volume being initialized for use. This parameter value can be used only to initialize a tape for use that is already a labeled volume. If the tape on the specified device has a different volume identifier than the one specified or if it is an unlabeled volume, an error message is sent.
Top

Check for active files (CHECK)

Specifies whether a labeled tape volume should be checked for active data files before it is initialized for use. If an unlabeled volume is placed in the specified device, this parameter is ignored.

*YES
All data file labels on the tape are checked. If any active files are found, the operation is ended and an error message is sent.
*NO
Tape initialization continues with no checking for active files. To initialize a new or empty volume for use, *NO must be specified here and *MOUNTED must be specified on the Volume identifier prompt (VOL parameter).
*FIRST
Only the first data file label on the tape is checked. If there are no data files on the volume or if the first data file has expired, the volume is initialized for use without checking for any other files on the tape. If the first data file has not expired, the operation is ended and an error message is sent.
Top

Tape density (DENSITY)

Specifies the recording format of the data to be written on the tape.

*DEVTYPE
The highest capacity density or format supported by the tape device will be used.
Device
Highest capacity density or format
3480
*FMT3480
3490E
*FMT3490E
3570-Bxx
*FMT3570
3570-Cxx
*FMT3570E
3580-001
*ULTRIUM1
3580-002
*ULTRIUM2
3580-003
*ULTRIUM3
3590-Bxx
*FMT3590
3590-Exx
*FMT3590E
3590-Hxx
*FMT3590H
3592-J1A
*FMT3592A1
4685-001
*VXA2
6335
*QIC3040
6343
*QIC1000
6344
*QIC2GB
6348
*QIC1000
6349
*QIC2GB
6368
*QIC1000
6369
*QIC2GB
6379
*QIC1000
6380
*QIC2GB
6381
*QIC2DC
6382
*QIC4DC
6383
*QIC5010
6384
*SLR60
6385
*QIC5010
6386
*MLR3
6387
*SLR100
6390
*FMT7GB
63B0
*VRT256K
7207-122
*QIC4DC
7208-002
*FMT2GB
7208-012
*FMT5GB
7208-222
*FMT7GB
7208-342
*FMT20GB
7208-345
*FMT60GB
9348
6250
*CTGTYPE
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.
character-value
Specify the density or format to use.
1600
The data density on the tape volume is 1,600 bits per inch, which is used for 1/2 inch reel tapes.
3200
The data density on the tape volume is 3,200 bits per inch, which is used for 1/2 inch reel tapes.
6250
The data density on the tape volume is 6,250 bits per inch, which is used for 1/2 inch reel tapes.
*FMT3480
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.
*FMT3490E
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.
*FMT3570
The format of this tape is FMT3570. The data format is written on the tape volume with a 3570 device.
*FMT3570E
The format of this tape is FMT3570E. The data format is written on the tape volume with a 3570E device.
*FMT3590
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.
*FMT3590E
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.
*FMT3590H
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.
*FMT3592A1
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.
*QIC120
The format of this tape is QIC120, which is used for 1/4 inch cartridge tapes that can hold 120 megabytes of data.
*QIC525
The format of this tape is QIC525, which is used for 1/4 inch cartridge tapes that can hold 525 megabytes of data.
*QIC1000
The format of this tape is QIC1000, which is used for 1/4 inch cartridge tapes that can hold 1200 megabytes of data.
*QIC2GB
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.
*QIC2DC
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.
*QIC4GB
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.
*QIC4DC
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.
*QIC3040
The format of this tape is QIC3040, which is used for 1/4 inch minicartridge tapes that can hold 840 megabytes of data.
*QIC5010
The format of this tape is QIC5010, which is used for 1/4 inch cartridge tapes that can hold 13.5 gigabytes of data.
*MLR3
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.
*SLR60
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.
*SLR100
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.
*FMT2GB
The format of this tape is FMT2GB, which is used for 8 millimeter cartridge tapes that can hold 2 gigabytes of data.
*FMT5GB
The format of this tape is FMT5GB, which is used for 8 millimeter cartridge tapes that can hold 5 gigabytes of data.
*FMT7GB
The format of this tape is FMT7GB, which is used for 8 millimeter cartridge tapes that can hold 7 gigabytes of data.
*FMT20GB
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.
*FMT60GB
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.
*ULTRIUM1
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.
*ULTRIUM2
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.
*ULTRIUM3
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.
*VRT32K
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.
*VRT64K
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.
*VRT240K
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.
*VRT256K
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.
*VXA1
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.
*VXA2
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.

Note: 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.

Top

Code (CODE)

Specifies the character code in which the volume label is written. All data that is not save data written after the label must be in the same code; codes cannot be intermixed on a tape that is not a save tape. If the tape is being initialized for use as an unlabeled tape with *NONE or no volume identifier specified on the New volume identifier prompt (NEWVOL parameter), this parameter is ignored.

*EBCDIC
The volume label is written in EBCDIC and is an IBM standard label; all additional data must also be written in EBCDIC.
*ASCII
The volume label is written in ASCII and is an ANSI standard label; all additional data must also be written in ASCII.
Top

End of tape option (ENDOPT)

Specifies whether the tape is rewound only or rewound and unloaded after the operation ends.

*REWIND
The tape is automatically rewound, but not unloaded, after the operation has ended.
*UNLOAD
The tape is automatically rewound and unloaded after the operation ends.
Top

Clear (CLEAR)

Specifies whether all previous labels and data are deleted from the tape when it is initialized. If the volume must be cleared of all data, it is spaced from the location of the initializing volume label or tape markers to the end of the tape marker.

*NO
Existing data is not deleted. Even though the existing data is not deleted, the data on the volume is not accessible after the volume has been initialized for use.
*YES
After the beginning of the tape has been initialized for use, the rest of the data on the tape is deleted. The *YES value is needed only if there are security concerns with the old data. If *YES is selected, the initialize operation can take a long time.
Top

Examples

INZTAP   DEV(TAPE1)  NEWVOL(T00100)  CHECK(*NO)  CODE(*ASCII)
         ENDOPT(*UNLOAD)

This command initializes the volume on the tape device named TAPE1 using the ASCII character code. Its new volume identifier is T00100, regardless of whether it contains a valid volume identifier or files that have not ended (active field). Once the volume has been initialized, the tape is rewound and unloaded. Any previous data beyond the new volume label is not deleted, but is no longer accessible.

Top

Error messages

*ESCAPE Messages

CPF67A0
Volume ID does not match cartridge ID
CPF6702
Error processing volume on device &1.
CPF6708
Command ended due to error.
CPF6715
Error at beginning of tape on device &1.
CPF6718
Cannot allocate device &1.
CPF6720
Incorrect volume &2 found on device &1.
CPF6721
Device &1 not a tape device.
CPF6722
End of tape found on device &1.
CPF6745
Device &1 not a media library device.
CPF6750
NEWVOL(*NONE) not valid for device &1.
CPF6751
Load failure occurred on device &4.
CPF6754
Active file &4 found on volume &2.
CPF6760
Device &1 not ready.
CPF6762
Wrong type of cartridge in device &1.
CPF6763
Wrong type of cartridge in device &1.
CPF6768
Volume on device &1 is write protected.
CPF676B
Volume on device &4 is write protected.
CPF6772
Volume on device &1 cannot be processed.
CPF6774
New volume &2 is a nonstandard labeled tape. Volume not prepared.
CPF9814
Device &1 not found.
CPF9825
Not authorized to device &1.
Top