Migrate using BRM (MGRBRM)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Migrate using BRM (MGRBRM) command allows you to migrate a library or first level folder to a specified auxiliary storage pool. This command is used by BRMS migration processing and by you to request migration of a specific library or folder as needed. You can specify the auxiliary storage pool to which you want to migrate the library or folder.

When the MGRBRM command is used BRMS ignores low storage threshold constraints for the auxiliary storage pool from which the item is being moved, but does honor the target auxiliary storage pool's high storage threshold.

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

Restriction:

Top

Parameters

Keyword Description Choices Notes
TOASP To asp Character value, *SYSTEM Required, Positional 1
TYPE Type *LIB, *FLR Optional, Positional 2
LIB Library Name Optional, Positional 3
FLR Folder Name Optional
Top

To ASP (TOASP)

Specifies the auxiliary storage pool to which the specified library or first level folder is to be migrated.

*SYSTEM
The library or folder is to be migrated to the system (1) auxiliary storage pool.
ASP-name
Specify the name of the auxiliary storage pool to which the library or folder is to be migrated. auxiliary storage pool names are assigned using the WRKASPBRM command.
ASP-number
Specify the number of the auxiliary storage pool to which the library or folder is to be migrated.

Note: UDFS, primary, secondary auxiliary storage pools are not supported for this parameter.

Top

Type (TYPE)

Specifies the type of item that you want to migrate. You can select a library or a first level folder.

*LIB
The type of item that you want to migrate to another auxiliary storage pool is a library.
*FLR
The type of item that you want to migrate to another auxiliary storage pool is a first level folder.
Top

Library (LIB)

Specifies the library name that you want to migrate to another auxiliary storage pool.

This is a required parameter with TYPE *LIB.

Top

Folder (FLR)

Specifies the folder name that you want to migrate to another auxiliary storage pool.

This is a required parameter with TYPE *FLR.

Top

Examples

Example 1: Migrating a Library

MGRBRM TOASP(COMPRESS) TYPE(*LIB) LIB(GLLIB)

This command migrates library GLLIB to the auxiliary storage pool (ASP) named COMPRESS.

Top

Error messages

*ESCAPE Messages

BRM1867
Error writing file &1.
BRM1917
Feature not installed.
BRM1921
Feature not licensed.
BRM1F24
Cannot migrate item &1, already in ASP &4.
BRM1F25
Cannot migrate item &1, objects in use.
BRM1F26
Cannot migrate item &1, not allowed.
BRM1F27
Operation not allowed, resources not available.
BRM1F34
Cannot migrate item &1, threshold too low.
BRM1F41
ASP &1 does not support migration
BRM1F42
ASP &1 not eligible for migration.
BRM1F44
ASP &1 does not support migration
BRM2112
ASP &2 not valid.
BRM4040
Access denied for user &1.
BRM4041
Access denied for user &1.
BRM40A2
BRMS product initialization required.
CPF9800
All CPF98xx messages could be signaled. xx is from 01 to FF.
Top