Move Media using BRM (MOVMEDBRM)

The Move Media using BRM (MOVMEDBRM) command moves media based on BRMS move policies. Media that is moved as a result of processing this command must meet not only the move policy requirements (for example, allowable move day) but also the criteria specified in the command for location, media class, system name and so on.

The MOVMEDBRM command can be a job in the system scheduler that can run automatically or you can submit the command manually.

The output produced when you run the MOVMEDBRM command is either the Volume Movement report written to printer file QP1AVMS or the moved media records written to the output file.

Note: If you have a network of systems using BRMS, it is only necessary to process the MOVMEDBRM command on one of the members of the network, although the process can be done an a system by system basis.

Note: The system in the network that is running the movement for all of the other systems in the network should be physically attached to all media libraries that support the network operations. If this is not the case, you may have to run MOVMEDBRM again, specifying the appropriate move policy for the logically attached media library device.

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

Restriction:

When using special value *OUTFILE for the Output (OUTPUT) parameter, refer to section General Rules for Object Authorities on Commands in Appendix D of the iSeries Security Reference book for the authorities required for the output file and output file library.

Parameters

Keyword	Description	Choices	Notes
MOVPCY	Move policy	Name, *ALL	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
OUTPUT	Output	PRINT, OUTFILE	Optional
OUTFILE	File to receive output	Qualified object name	Optional
	Qualifier 1: File to receive output	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
OUTMBR	Output member options	Element list	Optional
	Element 1: Member to receive output	Name, *FIRST
	Element 2: Replace or add records	REPLACE, ADD

Top

System name (SYSNAME)

Specifies the system name whose media inventory you want to consider for media movement.

*ALL: Include all media on all systems in the media selected for media movement.
*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 use when selecting volumes that you want to move.

*ALL: Include all file groups when selecting the media that you want to move.
*NONE: Do not include media in file groups.
*ARCGRP: Include media 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 media that contain the default backup user data control group in the group of files.
*SYSGRP: Include media that contain the default system data control group in the group of files.
*SYSTEM: Include media that contain the default backup entire system control group in the group of files.
file-group: Specify the name of the file group whose media you want to select for movement.

File group type (GRPTYPE)

Specifies the type of file group that you want to select for movement.

*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 move.

Note: *ARC is not a special value, but rather indicates that this is an archive file group type.

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 move.

Note: *BKU is not a special value, but rather indicates that this is a backup file group type.

*NONE

Do not include any file group types in the media that you want to move.

file-group-type

Specify the file group type that you want to include in the file groups that you want to move. An example file group type is QBRMBKUP which indicates that it is a backup control group file group type.

File to receive output (OUTFILE)

Specifies the qualified name of the database file receiving the output when *OUTFILE is specified on the Output (OUTPUT) parameter. If the file does not exist, this command creates a database file in the specified library. New files are created using database file QO1AVMS in library QBRM with the format name QBRMMOVMED as the model.

Qualifier 1: File to receive output

database-file-name: Specifies the name of the database file receiving the output from the command. If this file does not exist, it is created in the specified library.

Qualifier 2: Library

*LIBL: All libraries in the job's library list are searched until the first match is found.
*CURLIB: The current library for the job is used to locate the file. If no library is specified as the current library for the job, QGPL is used.
library-name: The specified library is used to locate the file.

Output member options (OUTMBR)

Specifies the name of the database file member receiving the output of the command when *OUTFILE is specified for the Output (OUTPUT) parameter.

Element 1: Member to receive output

*FIRST: The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the member is created with the name of the file specified on the File to receive output (OUTFILE) parameter and the record options.
member-name: Specifies the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the member is created.
If the member exists, the user can add records to the end of the existing member or clear the existing member and add the records.

Element 2: Replace or add records

*REPLACE: The existing records in the specified database file member are replaced by the new records.
*ADD: The new records are added to the existing information in the specified database file member.

Examples

Example 1: Selecting All Volumes to Move for Location *HOME

MOVMEDBRM LOC(*HOME)

This command selects all volumes for all move policies that are located at the location *HOME for media movement. A summary of the movement activity is printed as file QP1AVMS.

Example 2: Selecting All Volumes to Move for Location *HOME

MOVMEDBRM LOC(*HOME) OUTPUT(*OUTFILE) OUTFILE(MYLIB/MOVEMENT)

This command selects all volumes for all move policies that are located at the location *HOME for media movement. A summary of the movement activity is placed in the first member in data base file MOVEMENT in library MYLIB.

Error messages

*ESCAPE Messages

BRM1917: Feature not installed.
BRM1921: Feature not licensed.
BRM4040: Access denied for user &1.
BRM4041: Access denied for user &1.
BRM40A2: BRMS product initialization required.
BRM6708: Command ended due to error.
CPF9800: All CPF98xx messages could be signaled. xx is from 01 to FF.