Start Media Balancing for BRM (STRBALBRM)

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

Parameters

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

Action (ACTION)

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.

*REPORT
Produces a report that shows the scratch media currently available as well as the scratch media requirements for BRMS operations. This information will be provided for each system specified in the System Name (SYSNAME) parameter.
*BALANCE
Balances your media according to the previously specified media requirement. If the required number of media are not available, then media that are owned by a system with lower priority will be changed to be owned by the system with higher priority as specified by the Priority (MEDPTY) parameter. If BRMS cannot communicate with a system, media owned by that system will not be used.
*SET
Sets the media requirement as specified by the other parameters.
*REMOVE
Removes the previously specified media requirement.
Top

Media class (MEDCLS)

Specifies the media class for the media balancing.

*ALL
Select all media regardless of the media class.
name
Specify the name of the media class.
Top

Volume locations to include (LOC)

Specifies the media storage location of the media for balancing.

*ALL
Select media from any storage location.
name
Specify the name of the media storage location.
Top

System (SYSNAME)

Specifies the name of the system whose media will be used for balancing.

Single values

*NETGRP
Include media from all systems in the BRMS network.
*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.

Other values (up to 100 repetitions)

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

Media priority (MEDPTY)

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.

0-9999
Is the numerical value of the priority you wish to assign this system. 0 is the highest priority and 9999 is the lowest priority.
Top

Number of media required (MEDREQ)

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.

0-9999
Is the number of media required by this system for balancing. The maximum number of media that you can specify is 9999.
Top

Examples

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

Error messages

*ESCAPE Messages

BRM1177
Cannot establish connection with remote system.
BRM1713
Media class &2 not found.
BRM1917
Feature not installed.
BRM1921
Feature not licensed.
BRM4092
Location &2 not found.
BRM40A2
BRMS product initialization required.
CPF9800
All CPF98xx messages could be signaled. xx is from 01 to FF.
Top