Work with Migration Info (WRKMGRIBRM)

The Work with Migration Information using BRM (WRKMGRIBRM) command displays or reports migration information based on specified items, item type, date range, migration status, migration policy, source auxiliary storage pool and/or target auxiliary storage pool. Default values are provided to produce the most inclusive display or report. A Sequence (SORT) parameter allows the user to specify the sequence of the resulting output. The Entries to be displayed first (START) parameter determines whether the resulting output is positioned at the beginning or end of the information. The report, if printed, is written to printer file QP1AHH.

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

Restriction:

The BRMS Advanced feature (Option 2) is required to use this command.

Parameters

Keyword	Description	Choices	Notes
TYPE	Item type	FLR, LIB	Optional, Positional 1
LIB	Library	Generic name, name, *ALL	Optional
FLR	Folder	Generic name, name, *ALL	Optional
FROMASP	From ASP	Character value, ALL, SYSTEM	Optional
TOASP	To ASP	Character value, ALL, SYSTEM	Optional
FROMASPCLS	From ASP class	Name, *ALL	Optional
TOASPCLS	To ASP class	Name, *ALL	Optional
SLTDATE	Select dates	Element list	Optional
	Element 1: From date	Character value, BEGIN, CURRENT
	Element 2: To date	Character value, END, CURRENT
MGRSTS	Migration status	ALL, ERROR, *NOERROR	Optional
SORT	Sequence	DATE, FROMASP, NAME, TOASP	Optional
START	Entries to be displayed first	LAST, FIRST	Optional
OUTPUT	Output	, PRINT	Optional

Top

Library (LIB)

Specifies whether all libraries, a generic group of libraries or a single library is to be included in the resulting display or report. This parameter is required when *LIB is specified in the Item type (TYPE) parameter.

*ALL: You want to include all libraries in the migration information display or report.
generic*-library-name: Specify a generic name of a library that you want to include. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an * is not specified with the name, the system assumes that the name is a complete library name.
library-name: Specify the name of the library about which you want to display or report migration information.

Folder (FLR)

Specifies whether all libraries, a generic group of libraries or a single folder is to be included in the resulting display or report. This parameter is required when *FLR is specified in the Item type (TYPE) parameter.

*ALL: You want to include all libraries in the migration information display or report.
generic*-folder-name: Specify a generic name of a folder that you want to include. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an * is not specified with the name, the system assumes that the name is a complete folder name.
folder-name: Specify the name of the folder about which you want to display or report migration information.

From ASP (FROMASP)

Specifies all auxiliary storage pools or a single auxiliary storage pool from which items have been migrated that you want to include in the display or report.

*ALL: Include all auxiliary storage pools from which items have been migrated in the display or report.
*SYSTEM: Include only items that have been migrated from the system (1) auxiliary storage pool.
from-ASP-name: Specify the name of the auxiliary storage pool that you want to include in the display or report.
from-ASP-number: Specify the number of the auxiliary storage pool that you want to include in the display or report.
Note: UDFS, primary and secondary auxiliary storage pools are not supported for this parameter.

To ASP (TOASP)

Specifies all auxiliary storage pools or a single auxiliary storage pool to which items have been migrated that you want to include in the display or report.

*ALL: Include all auxiliary storage pools to which items have been migrated in the display or report.
*SYSTEM: Include only items that have been migrated to the system (1) auxiliary storage pool.
to-ASP-name: Specify the auxiliary storage pool name that you want to include in the display or report.
to-ASP-number: Specify the auxiliary storage pool number that you want to include in the display or report.
Note: UDFS, primary and secondary auxiliary storage pools are not supported for this parameter.

Select dates (SLTDATE)

Specifies a range of dates that you want to use when reporting on migration information. The From date is the beginning of a date range of migration 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 migration 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.

Migration status (MGRSTS)

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

*ALL: You want to include both successful and unsuccessful migration information in the display or report.
*ERROR: You want to include only unsuccessful migration information in the display or report.
*NOERROR: You want to include only successful migration information in the display or report.

Sequence option (SORT)

Specifies the way in which migration information is to be sequenced.

*DATE: Sequences the migration information by date and time.
*FROMASP: Sequences the migration information by source auxiliary storage pool, target auxiliary storage pool, date and time sequence.
*NAME: Sequences the migration information by item name and type.
*TOASP: Sequences the migration information by target auxiliary storage pool, source auxiliary storage pool, date and time sequence.

Entries to be displayed first (START)

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

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

Examples

WRKMGRIBRM ITEM(ABC*) TOASP(03)

This command displays the Work with Migration Information panel, where all libraries that begin with the letters 'ABC', and were migrated from any auxiliary storage pool (ASP) to ASP number 3, are displayed in date sequence.