Initialize Media using BRM (INZMEDBRM)

The Initialize Media using BRM (INZMEDBRM) command prepares media for use in the BRMS system. This command is used to initialize a volume with a standard volume label for standard label magnetic volume processing.

Note: It is recommended that you use the INZMEDBRM command in place of the i5/OS INZTAP command. To assure the protection of media, BRMS disables INZTAP CHECK(*NO) for users who do not have *SECADM, *SECOFR, *SERVICE or *SAVSYS authority. Unlike users of INZTAP, users of INZMEDBRM do not need these levels of authority in order to use the CHECK(*NO) option.

Virtual tape media and devices can be used with this command. The following restrictions apply to the use of virtual media and virtual devices.

The Device (DEV) parameter is limited on only one device or *MEDCLS special value for serial operations.
Execute authority is required to the Load or Unload Image Catalog (LODIMGCLG) command.
*CHANGE authority is required to the image catalogs.
Execute (*X) authority is required to each directory in the image catalog path name.
Read, write, execute (*RWX) authority is required to each image file in the parent directory that will be loaded or mounted.
*USE authority is required to the virtual devices using the image catalogs.

To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.

Restrictions:

This command should not be used by control group *EXIT item processing as results will be unpredictable.

Parameters

Keyword	Description	Choices	Notes
DEV	Device	Name	Required, Positional 1
NEWVOL	New volume identifier	Character value	Required, Positional 2
MEDCLS	Media class	Name	Required, Positional 3
NEWOWNID	New owner identifier	Character value, *BLANK	Optional
VOL	Volume identifier	Character value, *MOUNTED	Optional
CHECK	Check for active files	YES, FIRST, *NO	Optional
CODE	Code	EBCDIC, ASCII	Optional
ENDOPT	End of tape option	REWIND, UNLOAD	Optional
CLEAR	Clear	NO, YES	Optional

Top

New volume identifier (NEWVOL)

Specifies the volume identifier for a volume being initialized for use as a BRMS volume.

New volume identifier is a required field.

new-volume-identifier: Specify the 6 character identifier of the new volume. The identifier must contain only alphanumeric characters (A through Z and 0 through 9), and cannot have a prefix or be filled with blanks.
This is a required parameter.

Media class (MEDCLS)

The MEDCLS parameter defines the density used to format the volume. It does not define the media class the volume is assigned. Use the CHGMEDBRM command to change the media class assignment of the volume.

This is a required parameter.

New owner identifier (NEWOWNID)

Specifies the volume owner's identifier to write in the volume label of the volume being written.

*BLANK: The owner identification field is set to blanks.
new-owner-identifier: Specify no more than 14 characters to identify the owner of the volume. If fewer than 14 characters are specified, the field is left-justified and is filled with blanks on the right.

Volume identifier (VOL)

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

*MOUNTED: Any labeled or unlabeled volume that is placed in the specified volume 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 (CHECK) parameter.
volume-identifier: Specify the identifier of the labeled volume being initialized for use. This parameter value can be used only to initialize a volume for use that is already a labeled volume. If the volume 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.

Check for active files (CHECK)

Specifies whether a labeled 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 volume are checked. If any active files are found, the operation is ended and an error message is sent.
*FIRST: Only the first data file label on the volume 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 volume. If the first data file has not expired, the operation is ended and an error message is sent.
*NO: Volume 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 (VOL) parameter.

Code (CODE)

Specifies the character code in which the volume label is written. All data that is not save/restore data written after the label must be in the same code; codes cannot be intermixed on a volume that is not a save/restore volume.

*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 American National Standard Institute standard label; all additional data must also be written in ASCII.

Clear (CLEAR)

Specifies whether all labels and data are to be deleted from the volume when it is initialized for use. If the volume must be cleared of all data, it is deleted from the location of the volume label or tape marks 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 usable after the volume has been initialized for use.
*YES: After the beginning of the volume has been initialized for use, the remaining data on the volume is deleted.

Examples

Example 1: Initializing a Volume

INZMEDBRM DEV(TAP06) NEWVOL(T00004) MEDCLS(QIC1000)

This command initializes volume T00004 using device TAP06. The volume is assigned a media class of QIC1000 and initialized using the density specified by the QIC1000 media class.

Error messages

*ESCAPE Messages

BRM1317: Volume &1 cannot be initialized now.
BRM1917: Feature not installed.
BRM1921: Feature not licensed.
BRM4040: Access denied for user &1.
BRM4041: Access denied for user &1.
BRM40A2: BRMS product initialization required.
CPF9800: All CPF98xx messages could be signaled. xx is from 01 to FF.