CL Command Reference - STRMNTBRM

CL Command List > STRMNTBRM Reference

Description:

The Start Maintenance for BRM (STRMNTBRM) command performs various BRMS maintenance and clean-up functions. The STRMNTBRM command can be scheduled to process periodically either by manual submission or inclusion in an automatic job scheduler.

The STRMNTBRM command processes several other commands that can be run separately. These include:
. RMVMEDIBRM - Remove media information from BRM
. MOVMEDBRM - Move media using BRM
. STREXPBRM - Expire media from BRM
. RMVLOGEBRM - Remove BRM log entries
. WRKMEDIBRM - Work with media information
. STRRCYBRM - Recovery analysis

The STRMNTBRM produces multiple reports depending on the print options you select as well as the current conditions that it detects. For instance, the Centralized Media Audit report will not print if you are not using a clustered network environment in BRMS. Listed below are the printer files and associated reports that can be produced when the STRMNTBRM command processes:
. QP1AVER - Version Control
. QP1AEP - Media Expiration
. QP1AMM - Media Report by Expiration Date
. QP1AHS - Media Information
. QP1ALE - Save Strategy Exceptions
. QP1ARCY - Recovering Your Entire System
. QP1AASP - Display ASP Information
. QP1ARW - Recovery Activities
. QP1A2SL - Location Analysis
. QP1ASYN - Centralized Media Audit
. QP1A2RCY - Recovery Volume Summary

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

Restrictions:

1. This command should not be used by control group *EXIT item processing as results will be unpredictable.

2. All object authority is required to run this command.

3. This command should not be run as a remote command.

4. Depending on the size of your media inventory, this command can take a long time to process.

5. This command should be run as an independent job. No other BRMS functions should be active when the STRMNTBRM command is processing.

6. Reorganizing the BRMS database files can be a long running process requiring additional disk storage. Reorganization will occur on all BRMS data base files. Reorganization of files may be skipped if sufficient disk storage is not available, or if the file has no members or records.


Examples:

Example 1: Start Maintenance, Move Media, Clean the Archive Log

STRMNTBRM MOVMED(*YES) RMVLOGE(*ARC)

This command performs normal maintenance, starts media movement processing, and removes archive entries that are older than 90 days old from the BRMS log.



Example 2: Start Maintenance to Reorganize the BRMS Database Files

STRMNTBRM RGZBRMDB(*YES)

This command performs normal maintenance and runs the RGZDBF commmands on all the BRMS data base files.