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 IBM i licensed program installed.
Restriction:
- The BRMS Advanced feature (Option 2) is required to use this command.
| 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 |