CL Command Reference - STRMGRBRM
CL Command List > STRMGRBRM Reference
Description:
The Start Migration using BRM (STRMGRBRM) command allows you to specify a migration control group to process. You can start the migration immediately or you can schedule it using the system job scheduler. Processing can be batch or interactive.
The default for the OPTION parameter is *REPORT, which produces the Migration Item Candidate report. This allows you to process a report and review what will be migrated prior to performing the migration operation. To perform a migration for the items in the Migration Item Candidate report created by the *REPORT option or to restart a migration that was interrupted for some reason, you can specify the special value *RESUME.
Each time you process the STRMGRBRM command using either the *REPORT or *MIGRATE special values, BRMS creates a migration candidate file for the items in the control group. This file contains information about the items in the control group at the time that you processed the STRMGRBRM command, as well as information about auxiliary storage pool sizes and utilization. The migration candidate file that you created is used for producing candidate reports and performing migration operations for the control group. If you specify *RESUME for a control group, the migration candidate file that was created for the control group when you processed the STRMGRBRM command is used. A new migration candidate file is not created when you specify *RESUME, even though items in the control group or auxiliary storage pool characteristics may have changed.
To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
Restrictions:
1. The BRMS Advanced feature (Option 2) is required to use this command.
2. If you use the special value *EXIT in a migration control group and the resulting processing modifies the characteristics of either the control group items or auxiliary storage pool characteristics, BRMS does not record the changes in the resulting migration candidate file. You should consider not using the *EXIT special value in migration control groups if the resulting processing alters item or auxiliary storage pool characteristics.
3. The migration candidate list that is created as a result of processing a control group using either the *REPORT or *MIGRATE special values is not associated with a job or user id, only the name of the control group. If Job A processes a migration control group and Job B subsequently processes the same migration control group, the migration candidate list created for Job A will be overwritten by the migration candidate list created for Job B. If you want to resume a migration control group using the *RESUME special value, the migration candidate list created for Job B is the list that would be available for the resume operation, even if Job A was the job that was interrupted.
4. This command should not be used by control group *EXIT item processing as results will be unpredictable.
Examples:
Example 1: Producing a Report of Migration Candidates
STRMGRBRM CTLGRP(MGR01) SCDTIME(2000 0400)
This command starts migration operations, for items identified in control group MGR01, between the hours of 10:00 PM and 4:00 AM.