| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Start Backup using BRM (STRBKUBRM) command selects a control group to back up. You can start the backup immediately or you can schedule it using the system job scheduler. Processing can be batch or interactive.
To use this command, you must have the Backup Recovery and Media Services for IBM i licensed program installed.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CTLGRP | Control group | Name, *BKUGRP, *SYSGRP, *SYSTEM | Required, Positional 1 |
| SCDTIME | Schedule time | Decimal number, *IMMED | Optional |
| SBMJOB | Submit to batch | *YES, *CONSOLE, *CTLSBS, *NO | Optional |
| STRSEQ | Starting sequence | Element list | Optional |
| Element 1: Number | 1-9999, *FIRST | ||
| Element 2: Library | Name, *FIRST | ||
| APPEND | Append to media | *CTLGRPATR, *BKUPCY, *NO, *YES | Optional |
| JOBD | Job description | Single values: *USRPRF Other values: Qualified object name |
Optional |
| Qualifier 1: Job description | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| JOBQ | Job queue | Single values: *JOBD Other values: Qualified object name |
Optional |
| Qualifier 1: Job queue | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| ACTIVITY | Activity | *CTLGRPATR, *FULL, *INCR | Optional |
| RETENTION | Retention | Element list | Optional |
| Element 1: Retention type | *CTLGRPATR, *DAYS, *PERM | ||
| Element 2: Retain media | 1-9999, 35 | ||
| DEV | Device | Values (up to 4 repetitions): Name, *CTLGRPATR, *MEDCLS | Optional |
| PRLRSC | Parallel device resources | Element list | Optional |
| Element 1: Minimum resources | 1-32, *CTLGRPATR, *NONE, *AVAIL | ||
| Element 2: Maximum resources | 1-32, *MIN, *AVAIL | ||
| MEDCLS | Media class | Character value, *CTLGRPATR, *SYSPCY | Optional |
| MOVPCY | Move policy | Name, *CTLGRPATR, *NONE | Optional |
| OMITS | Omits | *PROCESS, *IGNORE | Optional |
| Top |
Specifies the name of the control group that you want to schedule for backup.
Backup control groups are groups of libraries, special values and lists that share common backup characteristics. You can create multiple backup control groups to complete your backup strategy.
This is a required field.
| Top |
Specifies the time that you want BRMS to begin processing the backup.
| Top |
Specifies how you want to process the selected control group.
Note: This special value is not supported in restricted state.
Note: If the control group requires all subsystems to be ended, this special value should only be used if the backup can complete without operator intervention because the interactive system console job is ended and will not be available.
If the control group requires all subsystems to be ended, system reference code A900 3C70 is displayed while the system is in restricted state. Unresponsive restricted state backups can be ended and the interactive system console job restarted in two ways:
| Top |
Specifies the sequence number and library from which you want to restart backup processing.
Note: If you are not restarting a control group, then you will always start at the first sequence number in the control group, regardless of the values specified in the STRSEQ parameter.
Note: You can use the Library element of this parameter when *IBM, *ALLUSR, *ALLPROD, *ALLTEST,*ASPnn or a generic library name is specified as the Save item in the specified sequence number in the control group.
Element 1: Number
Element 2: Library
| Top |
Specifies whether you want to append the backup data for the backup processing you are restarting to an active volume.
Note: The APPEND parameter applies only to removable media, and must be *NO if media of class *ADSM (TSM server) is used.
| Top |
Specifies the job description to be used with this job.
Single values
Qualifier 1: Job description
Qualifier 2: Library
| Top |
Specifies the job queue in which this job is placed.
Single values
Qualifier 1: Job queue
Qualifier 2: Library
| Top |
The Activity parameter allows you to specify the activity that is to be used when processing the control group. You can specify that the Weekly activity attribute of the control group entries is to be used or specify a specific type of activity which will override the Weekly activity attribute of the control group entries.
Activity overrides must be enabled for the control group specified in the CTLGRP parameter when specifying a value other than *CTLGRPATR for the Activity parameter. Activity overrides for the control group can be enabled or disabled from the properties Activity tab for the BRMS backup policy using the BRMS graphical user interface. The backup policy will have the same name as the control group name.
Diagnostic message BRM400A is sent by the STRBKUBRM validity checking program if activity overrides are disabled and the value for the ACTIVITY parameter is not *CTLGRPATR.
Note: For the *SYSTEM backup control group, a full save will be forced regardless of the default weekly activity.
| Top |
The Retention parameter allows you to specify the retention attributes that are to be applied to objects saved by the control group. You can specify that the retention attributes of the media policies defined in the control group are to be used or specify new retention attributes which will override the media policy retention attributes.
Retention overrides must be enabled for the control group specified in the CTLGRP parameter when specifying a value other than *CTLGRPATR for element 1 of the Retention. Retention overrides for the control group can be enabled or disabled using the properties Media Retention tab for the BRMS backup policy using the BRMS graphical user interface. The backup policy will have the same name as the control group name.
Diagnostic message BRM400B is sent by the STRBKUBRM validity checking program if retention overrides are disabled and the value for element 1 of the Retention parameter is not *CTLGRPATR.
Element 1: Retention type
Element 2: Retain media
| Top |
Specifies the device or devices to be used by this command.
Single values
Note: If you want to use more than one device for a serial save operation, the *MEDCLS can be repeated up to four times, once for each device used, except for virtual tape devices which is limited to a single value. The Parallel Device Resource (PRLRSC) parameter must be *NONE. BRMS will attempt to use the maximum number of devices that can be allocated for a save operation. If you want to use more than one device for a parallel save operation the *MEDCLS must only be specified once and the PRLRSC minimum and maximum responses must be greater than one.
You can save data to a TSM (ADSM) server using this command. You can only specify one TSM type server in the list of devices or *MEDCLS, which must select a TSM server. The device type can either be *APPC, which supports SNA network protocol, or *NET, which supports TCPIP protocol.
Other values (up to 4 repetitions)
Specifies the name of the devices to be used for the save operation. the specified device name must already be in the BRMS device table.
Note: Multiple systems can share the use of a tape device or a media library device (MLB). When the device is a tape device (not an MLB device), BRMS can help you manage the use of the stand alone device by multiple systems if you indicate the device is shared.
Note: When doing a serial save, only one media library device or one virtual device can be specified. When doing a parallel save, multiple media library devices or virtual devices can be specified.
| Top |
Specifies the minimum and maximum number of device resources to be used in a parallel save operation.
Note: Transferring save files to tape does not support parallel operations.
Element 1: Minimum Resources
Specifies the minimum number of device resources required for a parallel save.
Note: If a Media Library Device (MLB) is being used and the required resources are not available, the command will wait for the MLB to become available for a time period specified by the user. The wait time is determined by the value specified on the *MLB device description for INLMNTWAIT. If a *TAP device is being used and the required resources are not available, the command will fail.
Note: The Maximum resourcevalue is ignored when this special value is specified.
Element 2: Maximum Resources
Specifies the maximum number of device resources.
Note: This value is ignored when Minimum resourcesis set to *CTLGRPATR.
| Top |
Specifies the media class that you want to use for selection of output volumes used in this save operation.
If this save operation that you are performing is saving data to a device of category *NET or *APPC, you must specify the special value *ADSM (TSM server) for the MEDCLS parameter, since a TSM server controls the use of media in this case, not BRMS.
| Top |
Specifies the move policy that you want to use for output volumes created as a result of this save operation.
If this save operation that you are performing is saving data to a device of category *NET or *APPC, you must specify the special value *ADSM (TSM server) for the MOVPCY parameter, since a TSM server controls the use of media in this case, not BRMS.
| Top |
Specifies whether omit items are to be processed or ignored when the backup control group is run.
Note: This attribute does not apply to backup lists or the *SYSTEM backup control group.
| Top |
Example 1: Backing up a Control Group
STRBKUBRM CTLGRP(BACK01)
This command submits a batch job for backup control group BACK01. The batch job is not scheduled, so it will start immediately assuming batch job processing is active.
Example 2: Overriding the Save Activity
STRBKUBRM CTLGRP(BACK01) ACTIVITY(FULL)
This command submits a batch job for backup control group BACK01. The control group is set up to normally perform cumulative saves. When this backup is run, the cumulative saves will be overriden and a full save will be performed.
Example 3: Overriding the Save Retention
STRBKUBRM CTLGRP(BACK01) ACTIVITY(FULL)
RETENTION(*DAYS 2555)
This command submits a batch job for backup control group BACK01. The control group is set up to normally perform cumulative saves with a retention of 30 days. When this backup is run, the cumulative saves and retention will be overriden. A full save with a retention of 2555 days will be performed.
Example 4: Overriding Omitted Save Items
STRBKUBRM CTLGRP(BACK01) ACTIVITY(FULL)
RETENTION(*DAYS 2555) OMITS(*IGNORE)
This command submits a batch job for backup control group BACK01. The control group is set up to normally perform cumulative saves with a retention of 30 days and uses omits defined in the backup policy. When this backup is run, the cumulative saves, retention and omits will be overriden. A full backup which includes the omit items will be performed and a retention of 2555 days will be applied to the save.
Example 5: Submit to System Save to Batch
STRBKUBRM CTLGRP(*SYSTEM) SBMJOB(*CTLSBS)
This command submits the *SYSTEM backup control group to the controlling subsystem for batch processing. Since the backup does not use the BRMS console monitor or any interactive processing, the backup requires complete media management automation.
| Top |
*ESCAPE Messages
| Top |