INZTAP (Initialize Tape)
Purpose
The Initialize Tape (INZTAP) command prepares magnetic tapes for use on the system. This command is used to write volume labels on standard-labeled magnetic tapes so the tape device support can do standard-label processing. Unlabeled tapes must also be initialized by this command or by a similar process on another system before these tapes can be used on the iSeries 400. Note that this command, unlike the Initialize Diskette (INZDKT) command, does not indicate whether the tape is used for data written in the basic exchange format or in the save and restore format. That is done when the data files are actually written on the tape.
Three operations can be done by this command, depending on the values specified for the CHECK and CLEAR parameters.
- The tape can be checked for active data files (files that have not reached their expiration dates).
- The tape can be initialized either as a standard-labeled tape (if NEWVOL specifies a volume identifier) or as an unlabeled tape. Initialization writes only on the beginning of the tape, but it makes all data on the reel inaccessible.
- If the tape is being initialized, any previous data on the tape can also be deleted.
If the tape is being initialized as a standard-labeled volume, a volume label followed by two tape markers is written at the beginning of the tape. If it is initialized as an unlabeled tape, only the two tape markers are written at the beginning of the tape.
All tapes must be initialized before use. Tapes that have been initialized do not need to be reinitialized unless the user wants to write a new volume label, change the tape type from a standard-labeled tape to an unlabeled tape or vice versa, or change the density of a standard labeled tape.
Required Parameters
- DEV
- Specifies the name of the device in which the volume being initialized is placed. Specify the name of the tape or media library device.
Optional Parameters
- NEWVOL
- Specifies the volume identifier for a tape being initialized as a standard-labeled tape. If no volume identifier is specified, the tape is initialized as an unlabeled tape; that is, it has no volume label and no header labels for data files that are written on it later.
Note: If the tape device is contained in a library device, then the volume specified should be the cartridge identifier to be mounted and used. *NONE: The tape is initialized as an unlabeled tape. Only tape markers 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.
new-volume-identifier: Specify up to 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. Each tape reel should have a unique volume identifier to ensure optimum protection and control of the tape volumes.
- NEWOWNID
- Specifies which tape owner's identifier to write in the volume label of the volume being written. The owner identification contains up to 14 characters (letters and/or numbers in any combination), is left-justified, and padded on the right with blanks if fewer than 14 characters are supplied.
*BLANK: Text is not specified.
owner-identifier: Specify up to 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.
- VOL
- Specifies one or more volume identifiers used by the file. More information on this parameter is in Commonly used parameters.
Note: If the device specified is a media library device, then the volume specified should be the cartridge identifier to be mounted and used. *MOUNTED: Any labeled or unlabeled volume on the specified tape device is initialized. VOL(*MOUNTED) and CHECK(*NO) must be used to initialize a new or completely erased tape volume. Otherwise, the system attempts to read labels from the tape volume that is on the specified device and completely unwinds from the reel. 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.
volume-identifier: Specify the identifier of the labeled volume being initialized. This parameter value can be used only to reinitialize a tape that is already a labeled volume. If the tape on the specified device has a different volume identifier than the one specified by this value, or if it is an unlabeled volume, an error message is sent.
- CHECK
- Specifies whether a labeled tape volume is checked for active data files (files with an end date later than the current system date) before it is initialized. If an unlabeled volume is on the specified device for initialization, this parameter is ignored. If the volume must be checked for active files, as much of the tape is read as necessary before initialization is done.
*YES: All data file labels on the tape are checked. If 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, VOL(*MOUNTED) and CHECK(*NO) must be specified; otherwise, the system attempts to read labels from the volume on the specified device until the tape completely unwinds from the reel.
*FIRST: Only the first data file label on the tape is checked. If there are no data files in the volume, or if the first data file has ended, the volume is initialized without checking for any other files on the reel. If the first data file has not ended (it is active), the operation is stopped and an error message is sent.
If it is known that there is only one data file on the tape, that there are no active files on the volume, or that all files have the same end date, use CHECK(*FIRST) to do the fastest initialization of the tape. Note, however, that any data files past the first one are destroyed, with no end check made.
- DENSITY
- Specifies the density or format in which to write the data on the tape after it has been initialized. The density used for all data files written to a standard-labeled tape is specified when the volume is initialized, and cannot be changed unless the tape is reinitialized. For a tape that is not labeled, the DENSITY parameter specified in the Create Tape File (CRTTAPF), the Change Tape File (CHGTAPF), or the Override Tape File (OVRTAPF) command can change the density of the volume when the first data file on the tape is created.
*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.
*DEVTYPE: The highest capacity density or format supported by the tape device will be used.
- Tape device
- Highest capacity density or format
- 2440
- 6250
- 3422
- 6250
- 3430
- 6250
- 3480
- *FMT3480
- 3490E
- *FMT3490E
- 3570-BXX
- *FMT3570
- 3570-CXX
- *FMT3570E
- 3580-001
- *ULTRIUM1
- 3590
- *FMT3590
- 3590-Exx
- *FMT3590E
- 6335
- *QIC3040
- 6341
- *QIC120
- 6342
- *QIC525
- 6343
- *QIC1000
- 6344
- *QIC2GB
- 6346
- *QIC120
- 6347
- *QIC525
- 6348
- *QIC1000
- 6349
- *QIC2GB
- 6366
- *QIC120
- 6368
- *QIC1000
- 6369
- *QIC2GB
- 6378
- *QIC525
- 6379
- *QIC1000
- 6380
- *QIC2GB
- 6381
- *QIC2DC
- 6382
- *QIC4DC
- 6383
- *QIC5010
- 6385
- *QIC5010
- 6386
- *MLR3
- 6387
- *SLR100
- 6390
- *FMT7GB
- 7207-122
- *QIC4DC
- 7208-002
- *FMT2GB
- 7208-012
- *FMT5GB
- 7208-222
- *FMT7GB
- 7208-342
- *FMT20GB
- 9346
- *QIC120
- 9347
- 3200
- 9348
- 6250
tape-density: 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.
- *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.
- *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.
- *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.
Note: Some of the density values shown can only be specified when a tape device which supports that density is attached to the system.
Note: Self-configured tape devices may define additional valid values for the density parameter. Use iSeries 400 Operations Navigator (Configuration and Service) (Hardware) (Tape Units) (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.
- CODE
- Specifies the character code used. The code can be either extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII).
*EBCDIC: The extended binary-coded decimal interchange code (EBCDIC) character set code is used.
*ASCII: The ASCII character set code is used.
- 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.
- 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: The 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.
*YES: After the beginning of the tape has been initialized, the remaining data on the tape is deleted. The *YES value is needed only if there are security concerns with old data. If *YES is specified, the initialize operation can take a long time.
Example for INZTAP
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.
Error messages for INZTAP
*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.
- 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.