| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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 operating system INZTAP or INZOPT command. To assure the protection of media, BRMS disables INZTAP CHECK(*NO) and INZOPT CHECK(*NO) for users who do not have *SECADM, *SECOFR, *SERVICE or *SAVSYS authority. Unlike users of INZTAP and INZOPT, users of INZMEDBRM do not need these levels of authority in order to use the CHECK(*NO) option.
Virtual media and devices can be used with this command. The following restrictions apply to the use of virtual media and virtual devices.
To use this command, you must have the Backup Recovery and Media Services for IBM i licensed program installed.
Restrictions:
| Top |
| 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 media option | *REWIND, *UNLOAD | Optional |
| CLEAR | Clear | *NO, *YES | Optional |
| Top |
Specifies the name of the device which is used to initialize the volume. The device name must be defined in the BRMS device table.
This is a required parameter.
| Top |
For volumes that specify a Media class (MEDCLS) parameter using a tape density, the volume identifier is the volume identifier is a maximum of six characters in length. The identifier must contain only alphanumeric characters (A through Z and 0 through 9), and cannot contain blanks.
For volumes that specify a Media class (MEDCLS) parameter using an optical format, the volume identifier is a maximum of thirty-two characters in length. The identifier must contain only alphabetic characters (A through Z), numeric characters (0 through 9), hyphen (-), underscore (_), or a period (.). The first character must be alphabetic or numeric and the identifier cannot contain blanks.
This is a required parameter.
| Top |
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.
| Top |
Specifies the volume owner's identifier to write in the volume label of the volume being written.
| Top |
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.
| Top |
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.
Note: For optical devices, specifying *FIRST is the same as specifying *YES.
| Top |
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.
Note: For optical devices this parameter is ignored.
| Top |
Specifies whether the volume is only rewound, or rewound and unloaded after it has been initialized for use.
Note: For optical devices, *UNLOAD is the only special value supported, other special values will be ignored.
| Top |
Specifies whether or not existing data on the volume will be cleared during the initialize process.
For an optical device this parameter only applies when the volume media type is *DVD-RAM.
Note: If the volume media type is *WORM the volume is never cleared regardless of the parameter setting. If the volume media type is *ERASE the volume is always cleared regardless of the parameter setting.
Note: For optical devices, this option may take several hours to complete, depending on the media capacity.
| Top |
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.
| Top |
*ESCAPE Messages
| Top |