| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Start Media Balancing for BRM (STRBALBRM) command balances media ownership to match the required number of media needed for systems within a BRMS network.
Note: You should make sure all BRMS activity is quiesced prior to balancing your media.
To use this command, you must have the Backup Recovery and Media Services for IBM i licensed program installed.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| ACTION | Action | *REPORT, *BALANCE, *SET, *REMOVE | Optional, Positional 1 |
| MEDCLS | Media class | Name, *ALL | Optional |
| LOC | Volume locations to include | Name, *ALL, *HOME | Optional |
| SYSNAME | System | Single values: *NETGRP, *LCL Other values (up to 100 repetitions): Character value |
Optional |
| MEDPTY | Media priority | 0-9999 | Optional |
| MEDREQ | Number of media required | 0-9999 | Optional |
| Top |
Specifies whether you want to balance your media, produce a media requirement report or indicate your media requirements.
Note: The values of the Media Priority (MEDPTY) and number of media required (MEDREQ) parameters will be ignored if *REPORT, *BALANCE or *REMOVE is specified for the Action (ACTION) parameter.
| Top |
Specifies the media class for the media balancing.
| Top |
Specifies the media storage location of the media for balancing.
| Top |
Specifies the name of the system whose media will be used for balancing.
Single values
Other values (up to 100 repetitions)
Note: The BRMS Network feature (Option 1) is required to use this value.
Note: The BRMS Network feature (Option 1) is required to use this value.
| Top |
Specify the priority number to assign this system (SYSNAME) while balancing media.
Note: A value is required for this parameter if *SET is specified for the Action (ACTION)parameter.
| Top |
Specify the number of media required for this system (SYSNAME).
Note: A value is required for this parameter if *SET is specified for the Action (ACTION) parameter.
| Top |
Example 1: Print the Media Balancing Report
STRBALBRM ACTION(*REPORT)
Produces a report that shows the scratch media currently available as well as the number of scratch media required for BRMS operations.
Example 2: Start Media Balancing
STRBALBRM ACTION(*BALANCE)
This command balances your media according to the previously specified media requirement.
Example 3: Set Media Requirement
STRBALBRM ACTION(*SET) MEDCLS(FMT3590) LOC(TAPMLB01)
SYSNAME(SYSTEM1) MEDPTY(1) MEDREQ(5)
This command Sets the media requirement for the media class FMT3590 at media location TAPMLB01 to media priority as 1 and number of media required to 5.
Example 4: Remove Media Requirement
STRBALBRM ACTION(*REMOVE) MEDCLS(FMT3590) LOC(TAPMLB01)
SYSNAME(SYSTEM1) MEDPTY(1) MEDREQ(5)
This command removes the media requirement for the media class FMT3590 at media location TAPMLB01 with media priority as 1.
| Top |
*ESCAPE Messages
| Top |