Move Media using BRM (MOVMEDBRM)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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 IBM i 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 IBM i Security Reference book for the authorities required for the output file and output file library.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| MOVPCY | Move policy | Name, *ALL | Optional |
| LOC | From location | Single values: *ALL Other values (up to 10 repetitions): Name, *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 |
Move policy (MOVPCY)
Specifies the user-defined name of a move policy that you want to use to select volumes.
- *ALL
- All media that has a move policy are selected.
- move-policy-name
- Specify the user-defined name of the move policy that you are using to select media volumes.
| Top |
From location (LOC)
Specifies the location of the media or locations of media that you want to use when selecting volumes to be moved. Up to 10 locations may be specified.
- *ALL
- Select media volumes that reside in any storage location. If specified, there can be no other locations specified.
- *HOME
- Select volumes that reside in the home location. This value can be selected multiple times, but will have no effect after the first one.
- from-location-name
- Specify the name of the media storage location. Up to 10 locations may be specified.
| Top |
Container (CNR)
Specifies the container that you want to select for media movement. You can specify a container or all containers.
- *ALL
- Select all media for media movement that is currently in a container.
- container-ID
- Specify the name of the container that you want to select for media movement.
| Top |
Media class (MEDCLS)
Specifies the media class that you want to select for media movement. You can select a specific media class or all media classes.
- *ALL
- Select all media regardless of the media class.
- media-class-name
- Specify the name of the media class that you want to use to select volumes for media movement.
| 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.
| Top |
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.
| Top |
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.
| Top |
Output (OUTPUT)
Specifies whether the output is to be printed with the job's spooled output or directed to a database file.
- The output is printed with the job's spooled output.
- *OUTFILE
- The output is directed to the database file specified on the File to receive output (OUTFILE) parameter.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |