Work with Media using BRM (WRKMEDBRM)

Where allowed to run: All environments (*ALL)
Threadsafe: No

Parameters
Examples
Error messages

The Work with Media using BRM (WRKMEDBRM) command works with active, expired, requiring initialization, in error, or all media volumes in the media inventory by creation and expiration date for any or all locations. The following parameters can be used to tailor this display or printed report. The report that is produced is the Media report. The report, if printed, is written to printer file QP1AMM.

To use this command, you must have the Backup Recovery and Media Services for IBM i licensed program installed.

Parameters

Keyword	Description	Choices	Notes
TYPE	Select volumes	ALL, ACT, EXP, ERR, INZ, BOTH	Optional, Positional 1
SLTCRTDATE	Select creation dates	Element list	Optional
	Element 1: Beginning creation date	Character value, BEGIN, CURRENT
	Element 2: Ending creation date	Character value, END, CURRENT
SLTEXPDATE	Select expiration dates	Element list	Optional
	Element 1: Beginning expiration date	Character value, BEGIN, CURRENT, *PERM
	Element 2: Ending expiration date	Character value, END, CURRENT
VOL	Volume identifier	Single values: *ALL Other values (up to 50 repetitions): Character value	Optional
LOC	From location	Name, ALL, HOME	Optional
CNR	Container	Name, *ALL	Optional
MEDCLS	Media class	Name, *ALL	Optional
SYSNAME	System name	Character value, ALL, LCL	Optional
FILEGRP	File group	Name, ALL, NONE, ARCGRP, BKUGRP, SYSGRP, SYSTEM	Optional
GRPTYPE	File group type	Name, ALL, ARC, BKU, NONE	Optional
TEXT	Text	Character value, ALL, NONE, 'generic'	Optional
SORT	Sequence	VOL, CRT, EXP, LOC	Optional
OUTPUT	Output	, PRINT	Optional

Select volumes (TYPE)

Use this parameter to specify the type of media volume that you want to display or print.

*ALL: Displays or prints all media volumes.
*ACT: Displays or prints only active media volumes.
*EXP: Displays or prints only expired media volumes.
*ERR: Displays or prints only media flagged in error.
*INZ: Displays or prints only media requiring initialization.
*BOTH: Displays or prints all media volumes. This value is deprecated and is replaced by *ALL.

Select creation dates (SLTCRTDATE)

Specifies a range of creation dates that you want to use when working with media. The Beginning creation date is the beginning of a date range of media selected and the Ending creation date is the end of the date range of creation dates.

Note: Using this parameter, it is possible to enter a date with no separator, or a number of days which can be up to 5 digits in length. For instance, if you are using month/day/year format, the number 12904 would be formatted as January 29, 2004. If on the other hand, you entered a number 13904, BRMS assume that this is not a date, but rather is a number. BRMS always tries to calculate a calendar date first when a number is entered and then if the date it calculates is not valid, assumes that it is a number of days. If the number that is entered is over 5 digits and the date that it calculates is not valid, you receive an error message.

Element 1: Beginning creation date

*BEGIN: Uses the earliest media volume creation date that is on the file for the beginning of the creation date range.
*CURRENT: Uses the current date as the beginning of the creation date range.
beginning-creation-date: Specify a date that is the beginning of the creation date range. The date must be less than or equal to the current date.
number-of-days: Specify the number of days before the current day that is used to determine the beginning date of the date range.

Element 2: Ending creation date

*END: The last creation date in the media inventory is used as the end of the creation date range.
*CURRENT: Uses the current date as the ending of the creation date range.
ending-creation-date: Specify a date that is the ending of the creation date range. The date must be equal to or greater than the beginning creation date and less than or equal to the current date.
number-of-days: Specify the number of days before the current day that is used to determine the ending date of the date range.

Select expiration dates (SLTEXPDATE)

Specifies a range of expiration dates that you want to use when working with media. The Beginning expiration date is the beginning of a date range of media selected and the Ending expiration date is the end of the date range of expiration dates.

Note: Using this parameter, it is possible to enter a date with no separator, or a number of days which can be up to 5 digits in length. For instance, if you are using month/day/year format, the number 12904 would be formatted as January 29, 2004. If on the other hand, you entered a number 13904, BRMS assume that this is not a date, but rather is a number. BRMS always tries to calculate a calendar date first when a number is entered and then if the date it calculates is not valid, assumes that it is a number of days. If the number that is entered is over 5 digits and the date that it calculates is not valid, you receive an error message.

Element 1: Beginning expiration date

*BEGIN: Uses the earliest media volume expiration date that is on the file for the beginning of the expiration date range.
*CURRENT: Uses the current date as the beginning of the expiration date range.
beginning-expiration-date: Specify a date that is the beginning of the expiration date range. The date must be less than or equal to the current date.
number-of-days: Specify the number of days before the current day that is used to determine the starting date of the date range.

Element 2: Ending expiration date

*END: The last expiration date in the media inventory is used as the end of the expiration date range.
*CURRENT: Uses the current date as the ending of the expiration date range.
ending-expiration-date: Specify a date that is greater than or equal to the beginning expiration date.
number-of-days: Specify the number of days after the current day that is used to determine the ending date of the date range.
*PERM: Selects all media volumes that are marked with a permanent retention.

Volume identifier (VOL)

Specifies the volume or volumes that you want to display in the Work with Media display or print.

Single values

*ALL: You want to display or print all volumes in the media inventory that meet all specified parameters.

Other values (up to 50 repetitions)

generic*-volume-name: Specify the generic volume name. For example, specifying VOL* would cause all volumes whose names that begin with VOL to be included in the display or print.
volume-name: Specify that you want to display or print the volume or volumes that meet all specified parameters.

From location (LOC)

Specifies the location of the media that you want to display or print.

*ALL: Use the media volumes that reside in any storage location.
*HOME: Use the media volumes that reside in the local storage location, *HOME.
from-location-name: Specify the name of the media storage location.

Container (CNR)

Specifies the container that you want to display or print. You can select a specific container or all containers within a location.

*ALL: Work with all containers that reside in a storage locations.
container-ID: Specify the name of the container you want to display or print.

Media class (MEDCLS)

Specifies the media class that you want to display or print. You can select a specific media class or all media classes.

*ALL: Work with all media classes.
media-class-name: Specify the name of the media class that you want to display or print.

System name (SYSNAME)

Specifies the system name whose media inventory that you want to display or print.

*ALL: You want to display or print the media inventory for all system names.

*LCL: Specifies that the system is the local system. BRMS uses the default local location name, LCLLOCNAME and not the system name SYSNAME. In most cases, the systems have the same value specified in the LCLLOCNAME and in the SYSNAME. You can use the DSPNETA command to view the system network attributes.
location-name: Specify the name of the remote location associated with the system. The local system's network identifier, as seen by using the DSPNETA command, is used as the system's network identifier.
Note: The BRMS Network feature (Option 1) is required to use this value.
network-id.location-name: Specify the network identifier and the name of the remote location associated with the system. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name.
Note: The BRMS Network feature (Option 1) is required to use this value.

File group (FILEGRP)

Specifies the file group that you want to include on the volumes that you want to display or print.

*ALL: Include all file groups that meet the other specifications for the media that you want to display or print.
*NONE: Do not include file groups.
*ARCGRP: Include volumes that contain the default archive control group in the group of files.
Note: The BRMS Advanced feature (Option 2) is required to use this value.
*BKUGRP: Include volumes that contain the default backup user data control group in the group of files.
*SYSGRP: Include volumes that contain the default system data control group in the group of files.
*SYSTEM: Include volumes that contain the default backup entire system control group in the group of files.
file-group: Specify the name of the file group whose volumes you want to display or print.

File group type (GRPTYPE)

Specifies the type of file group that you want to display or print.

*ALL: Include all types of file groups that meet the other specifications in the search.
*ARC: Include file groups that are archive type file groups in the media that you want to display or print.
Note: The BRMS Advanced feature (Option 2) is required to use this value.
*BKU: Include file groups that are backup type file groups in the media that you want to display or print.
*NONE: Do not include any file group types in the media that you want to display or print.
file-group-type: Specify the file group type that you want to include in the file groups that you want to display or print.

Text (TEXT)

Specifies the text related to the media with which you want to work. You can search for any string of characters, and only those media inventory entries that contain the string of characters in the text are included in the display or print.

*ALL: You want to display or print all media inventory entries, regardless of the text.
*NONE: You want to display or print all media inventory entries that have blanks for text.
*generic*-text: Specify that you want to display or print all media inventory entries that have the text string specified.

Sequence (SORT)

Specifies the sort sequence that you want to use for this display or report.

*VOL: Sorts the display or report in volume sequence.
*CRT: Sorts the display or report in creation date sequence.
*EXP: Sorts the display or report in expiration date sequence.
*LOC: Sorts the display or report in location sequence.

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*: The output is displayed (if requested by an interactive job) or printed (if requested by a batch job).
*PRINT: The output is printed with the job's spooled output.

Examples

Example 1: Working with Expired Media

WRKMEDBRM TYPE(*EXP)

This command displays the Work with Media panel, where expired media are shown.

Example 2: Working with Active Media Sorted by Location

WRKMEDBRM TYPE(*ACT) SYSNAME(MYSYS) SEQ(*LOC)

This command displays the Work with Media panel, where active media that is in the media inventory for a system named MYSYS are shown in location order.

Error messages

*ESCAPE Messages

BRM1917: Feature not installed.
BRM1921: Feature not licensed.
BRM40A2: BRMS product initialization required.