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
- 3490E
- *FMT3490E
- 3570-Bxx
- *FMT3570
- 3570-Cxx
- *FMT3570E
- 3580-001
- *ULTRIUM1
- 3580-002
- *ULTRIUM2
- 3580-003
- *ULTRIUM3
- 3580-004
- *ULTRIUM4
- 3580-005
- *ULTRIUM5
- 3580-006
- *ULTRIUM6
- 3590-Bxx
- *FMT3590
- 3590-Exx
- *FMT3590E
- 3590-Hxx
- *FMT3590H
- 3592-E05
- *FMT3592A2
- 3592-E06
- *FMT3592A3
- 3592-E07
- *FMT3592A4
- 3592-E08
- *FMT3592A5
- 3592-J1A
- *FMT3592A1
- 4685-001
- *VXA2
- 5619
- *DAT160
- 5661
- *DAT320
- 5746
- *ULTRIUM4
- 5755
- *ULTRIUM2
- 5907
- *DAT72
- 6258
- *DAT72
- 6279
- *VXA3
- 6380
- *QIC2GB
- 6381
- *QIC2DC
- 6382
- *QIC4DC
- 6383
- *QIC5010
- 6384
- *SLR60
- 6386
- *MLR3
- 6387
- *SLR100
- 63B0
- *VRT256K
- 7207-122
- *QIC4DC
- 7208-012
- *FMT5GB
- 7208-222
- *FMT7GB
- 7208-342
- *FMT20GB
- 7208-345
- *FMT60GB
- 9348
- 6250
- 1600
- The data density on the tape volume is 1,600 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.
- *DAT72
- The format of this tape is DAT72. It is used by 4mm cartridge tape devices that can store 36 gigabytes of data on a standard length cartridge.
- *DAT160
- The format of this tape is DAT160. It is used by 4mm cartridge tape devices that can store 80 gigabytes of data on a standard length cartridge.
- *DAT320
- The format of this tape is DAT320. It is used by 4mm cartridge tape devices that can store 160 gigabytes of data on a standard length cartridge.
- *DDS3
- The format of this tape is DDS3. It is used by 4mm cartridge tape devices that can store 12 gigabytes of data on a standard length cartridge.
- *DDS4
- The format of this tape is DDS4. It is used by 4mm cartridge tape devices that can store 20 gigabytes of data on a standard length cartridge.
- *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. It is used by 3592 tape devices that can store 300 gigabytes of data on a standard length cartridge.
- FMT3592A1E
- The format of this tape is FMT3592A1E. It is used by 3592 tape devices that can store 300 gigabytes of encrypted data on a standard length cartridge.
- *FMT3592A2
- The format of this tape is FMT3592A2. It is used by 3592 tape devices that can store 500 gigabytes of data on a standard length cartridge.
- FMT3592A2E
- The format of this tape is FMT3592A2E. It is used by 3592 tape devices that can store 500 gigabytes of encrypted data on a standard length cartridge.
- *FMT3592A3
- The format of this tape is FMT3592A3. It is used by 3592 tape devices that can store 1 terabyte of data on a standard length cartridge.
- FMT3592A3E
- The format of this tape is FMT3592A3E. It is used by 3592 tape devices that can store 1 terabyte of encrypted data on a standard length cartridge.
- *FMT3592A4
- The format of this tape is FMT3592A4. It is used by 3592 tape devices that can store 4 terabytes of data on a standard length cartridge.
- FMT3592A4E
- The format of this tape is FMT3592A4E. It is used by 3592 tape devices that can store 4 terabytes of encrypted data on a standard length cartridge.
- *FMT3592A5
- The format of this tape is FMT3592A5. It is used by 3592 tape devices that can store 10 terabytes of data on a standard length cartridge.
- FMT3592A5E
- The format of this tape is FMT3592A5E. It is used by 3592 tape devices that can store 10 terabytes of encrypted data on a standard length cartridge.
- *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.
- *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.
- *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.
- *ULTRIUM4
- The format of this tape is ULTRIUM4. It is used by 1/2 inch cartridge tape devices that can store 800 gigabytes of data on a standard length cartridge.
- *ULTRIUM5
- The format of this tape is ULTRIUM5. It is used by 1/2 inch cartridge tape devices that can store 1.5 terabytes of data on a standard length cartridge.
- *ULTRIUM6
- The format of this tape is ULTRIUM6. It is used by 1/2 inch cartridge tape devices that can store 2.5 terabytes 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.
- *VXA3
- The format of this tape is VXA3. It is used by VXA cartridge tape devices that can store 160 gigabytes of data on a standard length cartridge.
Note: Self-configured tape devices may define additional valid values for the density parameter. Use System i 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 |