Work with Media Information (WRKMEDIBRM)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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 IBM i licensed program installed.
| Top |
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 | 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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
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 IBM i 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.
| Top |
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.
| Top |
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 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.
| Top |
Sequence (SORT)
Specifies that the media information report is to be sequenced in several ways.
- *DATE
- Sequences the media information report by date.
- *LIB
- Sequences the media information report by library.
- *VOL
- Sequences the media information report by volume.
| Top |
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.
| Top |
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.
| Top |
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).
- The output is printed with the job's spooled output.
| Top |
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.
| Top |
Error messages
*ESCAPE Messages
- BRM1177
- Cannot establish connection with remote system
- Cannot establish connection with remote system &1.amp;1.
- 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.
| Top |