Using SAVxxxBRM Commands

Resolving The Problem

Most of the BRMS save commands are directly related to the native operating system commands. Many of the parameters are the same and have the same function as the native commands. This document highlights some of the parameters from the SAVLIBBRM, SAVOBJBRM, SAVBRM, and SAVDLOBRM commands.

Media policy . . . . . . . . . . MEDPCY

This parameter specifies the media policy to be used with this save command. Media policies are used to determine the following:

o	The type of retention to use (such as days, date, or version) for media used in control group processing.
o	The move policy to use with this media policy.
o	The media class to use.
o	Whether or not to use save files.
o	The type of retention to use (such as days or a date) for save files created in control group processing.

The media policy you specify must be a media policy that is in the BRMS media policy table.

Retain object detail . . . . . . OBJDTL

This parameter specifies whether the object detail is kept in the BRMS database for the objects saved.

Note: This parameter is not available for the SAVOBJBRM or SAVBRM commands.

When using the SAVBRM command to save the Integrated File System files or SAVOBJBRM to save individual objects in libraries, object level detail is automatically saved. It is not possible to turn this off. This could result in large files in QUSRBRM (QA1ADI2, QA1ALI2 and QA1AOD). Files in QUSRBRM should never be cleared. To remove unwanted object level detail, users can use the RMVMEDIBRM option.

If RMVMEDIBRM is done, it will not be possible to "drill down" to individual files using WRKMEDIBRM or WRKLNKBRM , or use RSTBRM and/or RSTOBJBRM to restore individual files or objects.

Control group . . . . . . . . . CTLGRP

This parameter specifies the name of the control group that you want to associate with the objects saved by this command. The control group name is stored with the media information and can be used with the Control group (CTLGRP) parameter on other BRMS commands to filter the media information or to recover saved objects by control group.

Note: None of the attributes of the control group are used for the save.

If you are using version control for the items you are saving, this save operation will be recorded as part of the specified version control. Version control is specified in the media policy associated with this control group and can be reviewed by using the Work with Media Policies display.

Type of save . . . . . . . . . . SAVTYPE

This parameter specifies whether all objects in a library are to be saved or only those objects that have changed. There is no SAVCHGOBJ equivalent BRMS command so if *CUML or *INCR is specified, BRMS will save the changes in the specified libraries. This option is only on the SAVLIBBRM, SAVDLO, and SAVBRM commands.

Note: If a backup includes new libraries and BRMS has no history of a full backup of these libraries, then a full backup will be performed regardless of the type of incremental specified.

Note: When SAVOBJBRM SAVTYPE(*CUML) or SAVTYYPE(*INCR) is used, BRMS will refer to when the entire library was saved in full or incrementally.

Sequence number . . . . . . . . SEQNBR

This parameter specifies, when tape is used, the sequence to use for the save operation. If you are saving to a BRMS volume that is expired, BRMS will begin writing information at the beginning of the volume, even though you have specified *END. If you are saving to a BRMS volume, BRMS will redirect the output to begin at the logical end of the output volume (after the end of the last active file), depending on the output device that you are using.

Note: If you want to write to an expired volume (not append to an active volume), you must specify a sequence number of 1.

Journaled objects . . . . . . . OBJJRN

This parameter specifies whether to save changed objects that are currently being journaled and that have been journaled since the date and time specified on the REFDATE and REFTIME parameters.

Note: The value entered applies only to save types of *INCR or *CUML. For save type *FULL, this value is always treated as *YES.