Work with Media Information (WRKMEDIBRM)

The Work with Media Information using BRM (WRKMEDIBRM) command displays or reports media information based on specified libraries, date ranges and sequences. The Work with Media Information command shows the date and time each library was saved, the type of save, the volume serial and its associated expiration date and the number of objects that were saved and the number that were not saved. The command gives you the option to display or print the report. The report that is produced is the Media Information report. The report, if printed, is written to printer file QP1AHS.

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

Parameters

Keyword	Description	Choices	Notes
LIB	Library	Generic name, name, ALL, ALLDLO, LINK, LNKOMTLTS, LNKOMTONL, LTSOMTONL, QHST, SAVCFG, SAVSECDTA, SAVSPLF, *SAVSYS	Optional, Positional 1
VOL	Volume	Character value, *ALL	Optional
ASP	Auxiliary storage pool	Character value, ALL, SYSTEM	Optional
CTLGRP	Control group	Name, ALL, NONE, ARCGRP, BKUGRP, SYSGRP, SYSTEM	Optional
SAVTYPE	Save type	Single values: ALL Other values (up to 3 repetitions): ARC, CUML, FILE, FULL, INCR, NONE, QBRM	Optional
SLTDATE	Select dates	Element list	Optional
	Element 1: From date	Character value, BEGIN, CURRENT
	Element 2: To date	Character value, END, CURRENT
SAVSTS	Save status	ALL, ERROR, *NOERROR	Optional
SORT	Sequence option	DATE, LIB, *VOL	Optional
START	Entries to be displayed first	LAST, FIRST	Optional
FROMSYS	From system	Character value, *LCL	Optional
OUTPUT	Output	, PRINT	Optional

Top

Library (LIB)

Specifies the name of the library or special value that you want to display or report.

*ALL: All libraries are to be included in the media information report.
*ALLDLO: You want to display or print media information for all folders that you have saved using the *ALLDLO special value.
*LINK: You want to display or print media information for all saves using the special value *LINK which saves all IFS directories except files in /QSYS.LIB and /QDLS directories.
*LNKOMTLTS: You want to display or print media information for all saves using the special value *LNKOMTLTS. This value saves all IFS directories and files except all Lotus server files and files in /QSYS.LIB and /QDLS directories.
*LNKOMTONL: You want to display or print media information for all saves using the special value *LNKOMTONL. This value saves all IFS directories and files except online Lotus server backup files and files in /QSYS.LIB and /QDLS directories.
*LTSOMTONL: You want to display or print media information for all saves using the special value *LTSOMTONL. This value saves all Lotus server files except online Lotus server files.
*QHST: You want to display or print media information for all entries you have saved using the *QHST special value.
*SAVCFG: You want to display or print media information for all configurations that you have saved using the *SAVCFG special value.
*SAVSECDTA: You want to display or print media information for all security data that you have saved using the *SAVSECDTA special value.
*SAVSPLF: You want to display or print media information for all spooled files that you have saved in a list.
*SAVSYS: You want to display or print media information that was the result of using the *SAVSYS special value.
library-name: Specify the name of a specific library on which you want to report media information.
generic*-library-name: Specify that the library name is generic. For example, specifying ACCTP* would cause all libraries whose names begin with ACCTP to be included in the report or on the display.

Volume (VOL)

Specifies the name of the media volume which you want to include in the Work with Media Information display or *ALL if you want to include all volumes.

Note: If you specify *SAVF, the resulting display or report will include all BRMS saves to save files.

This is a required parameter.

*ALL: You want to include all volumes in the media information display or report.
volume-identifier: Specify the name of a media volume on which you want to display or report media information.

Auxiliary storage pool (ASP)

Specifies an auxiliary storage pool for the retrieved media information. Only those objects which reside on the specified auxiliary storage pool when the save operation occurred will be displayed or reported.

*ALL: You want to display or report all saved items from all auxiliary storage pools.
*SYSTEM: You want to display or report all saved items from the system (1) auxiliary storage pool.
auxiliary-storage-pool-number: You want to display or report all saved items from the auxiliary storage pool identified by this number.
auxiliary-storage-pool-name: You want to display or report all saved items from the auxiliary storage pool identified by this name.

Control group

Specifies the name of the control group that you want to work with when displaying saved items.

*ALL: Work with all control groups.
*NONE: Work with items that were not saved using a control group.
*ARCGRP: The name of the default archive control group because you want to work with items saved using the default archive control group.
Note: The BRMS Advanced feature (Option 2) is required to use this value.
*BKUGRP: The name of the default backup control group because you want to work with items saved using the default user data backup control group.
*SYSGRP: The default system backup control group because you want to work with items saved using the default system data backup control group.
*SYSTEM: The default system backup control group because you want to work with items saved using the default entire system backup control group.
control-group-name: Specify the name of the control group for the items that you want to work with.

Save type (SAVTYPE)

Specifies the type of save items that you want to work with. You can specify all types of items, a specific type or a mix of types.

You can enter multiple values for this parameter. If you are on an entry display and you need additional entry fields to enter these multiple values, type a plus sign (+) in the entry field opposite the phrase "+ for more" and press the Enter key.

Single values

*ALL: Work with all types of save items.

Other values (up to 3 repetitions)

*ARC: Only work with save items that were a result of an archive process.
Note: The BRMS Advanced feature (Option 2) is required for this value.
*CUML: Only work with save items that were a result of an incremental (save changed objects) save. *CUML indicates that the incremental save includes all objects that have been changed since the last full save.
*FILE: Only work with save items that were a result of native i5/OS save commands.
*FULL: Only work with save items that were a result of a full save.
*INCR: Only work with save items that were a result of an incremental (save changed objects) save. *INCR indicates that the incremental save includes all objects that have been changed since the last incremental save.
*NONE: Only work with save items that have never been saved.
*QBRM: Work with BRMS media information items that have been saved.

Select dates (SLTDATE)

Specifies a range of dates that you want to use when reporting on media information. The From date is the beginning of a date range of media information and the To date is the end of the date range.

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: From date

*BEGIN: The earliest media information date on the file is the beginning date of a date range.
*CURRENT: The current date is the beginning date of a date range.
from-date: Specify the date in job date format with or without date separators that you want to be the beginning date of a date range.
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: To date

*END: The last date found in the file is the end of the date range for the search.
*CURRENT: The current date is the ending date of the date range.
to-date: Specify the date in job date format with or without date separators that you want to be the ending date of a date range.
number-of-days: Specify the number of days before the current day that is used to determine the ending date of the date range.

Save status (SAVSTS)

Specifies whether you want to display or report all successful saves, unsuccessful saves or both.

*ALL: You want to include both successful and unsuccessful saves in the display or report.
*ERROR: You want to include only unsuccessful saves in the display or report.
Note: Errors that are included are those that would have resulted in an abnormal completion condition if you had used a native i5/OS save command for the save operation.
*NOERROR: You want to include only successful saves in the display or report.
Note: Objects that are not saved are not necessarily considered an error condition. For instance, if one object within a library is in a locked condition during a save operation, and the remainder of the objects in the library are not, a save operation of the library can complete successfully, even though the locked object will be omitted. The omitted object will be indicated in the Not saved column of the resulting Work with Media Information display or report.

Entries to be displayed first (START)

Specifies the starting position of the media information entries. The display station user can roll the display up or down to see other media information entries if the media information entry is on another display screen.

*LAST: Media information is shown starting with the last entry at the bottom of the display.
*FIRST: Media information is shown starting with the first entry at the top of the display.

From system (FROMSYS)

Specifies the location and network identification of the system whose media that you want to work with.

Note: The values specified in the FROMSYS parameter are ignored if a volume identifier is specified in the Volume (VOL) parameter. In this case the location and network identifier associated with the specified volume is used.

Note: Use the Display Network Attributes (DSPNETA) command to view the system network attributes.

Note: The BRMS Network feature (Option 1) is required to use this value if a value other than *LCL is specified.

*LCL: Specifies that the from-system is the local system. BRMS uses the Default local location name (LCLLOCNAME) network attribute and not the System name (SYSNAME) network attribute to determine the current system name. In most cases, the systems have the same value specified for LCLLOCNAME as for SYSNAME.
location-name: Specifies the Default local location name (LCLLOCNAME) network attribute of the remote system for the network operation. The current system Local network ID (LCLNETID) network attribute is used to connect with the remote system.
network-id.location-name: Specifies the Local network ID (LCLNETID) and the Default local location name (LCLLOCNAME) network attributes of the remote system for the network operation. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the LCLNETID and cccccccc is the LCLLOCNAME.

Examples

WRKMEDIBRM LIB(MY*) SAVTYPE(*FULL) SORT(*LIB)

This command displays the Work with Media Information panel, where all libraries that begin with the letters 'MY' and were saved during a full save, are shown in library sequence.

Error messages

*ESCAPE Messages

BRM1177: Cannot establish connection with remote system.
BRM1917: Feature not installed.
BRM1921: Feature not licensed.
BRM2154: ASP value of *ALL must be specified.
BRM215A: ASP value of *ALL or 1-32 must be specified.
BRM4040: Access denied for user &1.
BRM4041: Access denied for user &1.
BRM40A2: BRMS product initialization required.