Work with Containers using BRM (WRKCNRBRM)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Work with Containers using BRM (WRKCNRBRM) command works with all or selected containers. You can select all containers or those that are open or closed. Your selection can be further refined by location. Output can be a display or printed report. The report that is produced is the Container report. The report, if printed, is written to printer file QP1ACN.
To use this command, you must have the Backup Recovery and Media Services for IBM i licensed program installed.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CNR | Container ID | Name, *ALL | Optional, Positional 1 |
| STATUS | Status | *ALL, *CLOSED, *OPEN | Optional, Positional 2 |
| LOC | Location | Name, *ALL, *HOME | Optional, Positional 3 |
| CNRCLS | Container class | Name, *ALL | Optional, Positional 4 |
| OUTPUT | Output | Optional, Positional 5 |
| Top |
Container ID (CNR)
Specifies whether you want to work with a specific container or all containers.
- *ALL
- You want to work with all containers in the BRMS container inventory.
- container-ID
- Specify the container ID in the BRMS container inventory that you want to work with.
| Top |
Status (STATUS)
Specifies whether you want to work with all containers, open containers or closed containers. Open containers can accept additional media volumes and closed containers cannot.
- *ALL
- You want to work with all containers in the BRMS container inventory.
- *CLOSED
- You want to work with closed containers.
- *OPEN
- You want to work with open containers.
| Top |
Location (LOC)
Specifies a location that you want to work with. You can specify a single location, containers that are in the home storage location, containers that are in other storage locations or all locations.
- *ALL
- You want to work with all containers in all locations.
- *HOME
- You want to work with containers in the location *HOME.
- location-name
- Specify the location that contains the containers that you want to work with.
| Top |
Container class (CNRCLS)
Specifies the container class for the containers that you want to work with. Container classes define the types of physical containers that are used to store and transport physical media classes. Container classes are distinguished by attributes such as capacity and media class. For instance, there could be several container classes for eight millimeter cartridges. One container class could be CONT8MM10 indicating that this container class is used for eight millimeter cartridges and has a capacity of 10 cartridges. If you used another container for eight millimeter cartridges that had a 25 cartridge capacity, you could set up CONT8MM25 as a container class.
- *ALL
- You want to work with all container classes that are assigned to the containers you are working with.
- container-class-name
- Specify the user-defined name of the container class for the containers that you want to work with.
| Top |
Output (OUTPUT)
Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
- *
- The output is displayed (if requested by an interactive job) or printed (if requested by a batch job).
- The output is printed with the job's spooled output.
| Top |
Examples
WRKCNRBRM STATUS(*OPEN) LOC(*HOME)
This command displays the Work with Containers panel where all open containers that are at the home location are displayed.
| Top |
Error messages
*ESCAPE Messages
- BRM1917
- Feature not installed.
- BRM1921
- Feature not licensed.
- BRM4040
- Access denied for user &1.
- BRM40A2
- BRMS product initialization required.
| Top |