Work with Saved Objects (WRKOBJBRM)

The Work with Saved Objects using BRM (WRKOBJBRM) command prints/displays a report of saved objects. Groups of objects are selected by date ranges and the resulting display or report can be sequenced in several ways. If the display option is selected, you can restore objects from the media inventory. The report that is produced is the Saved Objects report. The report, if printed, is written to printer file QP1AOD.

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
OBJ	Object	Qualified object name	Optional, Positional 1
	Qualifier 1: Object	Name, *ALL
	Qualifier 2: Library	Name, *ALL
OBJTYPE	Type	Character value, *ALL	Optional, Positional 2
ASP	Auxiliary storage pool	Character value, ALL, SYSTEM	Optional
SLTDATE	Select dates	Element list	Optional, Positional 3
	Element 1: From date	Character value, BEGIN, CURRENT
	Element 2: To date	Character value, END, CURRENT
SAVSTS	Save status	ALL, ERROR, *NOERROR	Optional
INFTYPE	Object information	ALL, DLO, MBR, OBJ	Optional
SORT	Sequence option	SAVDAT, LIB, *OBJ	Optional
FROMSYS	From system	Character value, *LCL	Optional
OUTPUT	Output	, PRINT	Optional

Top

Object (OBJ)

Specifies the name and library of the object or group of objects that you want to display or print.

Qualifier 1: Object

*ALL: Include all objects that are the object types specified in the Type (TYPE) parameter in the Work with Saved Objects display or report.
object-name: Specify the name of a specific object for which you want to produce the Work with Saved Objects display or print.

Qualifier 2: Library

*ALL: Search all libraries for objects to include in the Work with Saved Objects display or report.
library-name: Specify the name of a specific library to search for objects to included in the display or print.

Auxiliary storage pool (ASP)

Specifies the auxiliary storage pool that contained the saved objects you want to display or report.

*ALL: You want to include saved objects in all auxiliary storage pools.
*SYSTEM: You want to include saved objects that were in the system (1) auxiliary storage pool.
auxiliary-storage-pool-number: Specify the number of an auxiliary storage pool that contained the saved objects you want to include.
auxiliary-storage-pool-name: Specify the name of an auxiliary storage pool that contained the saved objects that you want to include.

Select dates (SLTDATE)

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

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: Uses the earliest date in the file for the beginning date of the date range.
*CURRENT: Uses the current date for the beginning date of the date range.
from-date: Specify the date in job date format with or without date separators that you want to use as the beginning date of the 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: Use the last date that an object was saved as the ending date in the date range that you want to use for the search.
*CURRENT: Uses the current date as the ending date of the date range.
to-date: Specify the date in job date format with or without date separators to use as the ending date of the 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.

From system (FROMSYS)

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

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

Example 1: Working with Objects Not Successfully Saved

WRKOBJBRM SAVSTS(*ERROR) INFTYPE(*OBJ) SORT(*OBJ)

This command displays the Work with Saved Objects panel, where all objects that were not successfully saved are displayed in object name sequence.