CL Command Reference - SAVOBJBRM
CL Command List > SAVOBJBRM Reference
Description:
The Save Object using BRM (SAVOBJBRM) command allows you to save individual objects or a group of objects that are in the same library.
For job queues, message queues and logical files, only the object definitions are saved, not the contents. The contents of output queues can be saved using SPLFDTA(*ALL), otherwise, only the output queue object definition is saved. The contents of save files can be saved using SAVFDTA(*YES), otherwise, only the save file object definition is saved.
The system saves the specified objects by writing a copy of each object on tape, or in a save file. The objects are not affected in the system unless the command specifies that the storage should be freed.
Virtual tape media and devices can be used with this command. The following restrictions apply to the use of virtual media and virtual devices.
. The Device (DEV) parameter is limited on only one device or *MEDCLS special value for serial operations.
. Execute authority is required to the Load or Unload Image Catalog (LODIMGCLG) command.
. *CHANGE authority is required to the image catalogs.
. Execute (*X) authority is required to each directory in the image catalog path name.
. Read, write, execute (*RWX) authority is required to each image file in the parent directory that will be loaded or mounted.
. *USE authority is required to the virtual devices using the image catalogs.
To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.
Restrictions:
1. You must have authority to the SAVOBJ or SAVCHGOBJ commands to use this command.
2. You must have *USE authority to any auxiliary storage pool device specified for the Auxiliary storage pool (ASPDEV) parameter.
3. You must have either the *SAVSYS special authority or you must have:
. Read authority for, or be the owner of, each library specified.
. Object existence authority for each object in the library.
4. When saving to a save file, only one library can be specified.
5. No object being saved can be changed by a job that is running at the time the save operation occurs unless save-while-active is used.
6. *NONE must be specified for the Spooled file data (SPLFDTA) parameter if the value for the Target release (TGTRLS) parameter resolves to a release prior to V5R4M0. Use backup spooled file lists to save of spooled files for restore to target releases prior to V5R4M0.
7. This command should not be used by control group *EXIT item processing as results will be unpredictable.
You can save data to a Tivoli Storage Manager (TSM) server using this command. To save data to a TSM server, the following conditions must be met:
. Only user data can be saved to TSM servers. BRMS does not allow *IBM type libraries to be saved TSM servers. Also, BRMS does not allows IBM supplied libraries that are considered user data such as QGPL, QUSRBRM, or QUSRSYS libraries to be saved TSM media.
. You can only specify only one device for the Device (DEV) parameter and this device must be of category *NET or *APPC.
. You can specify DEV(*MEDCLS) with the Location (LOC) parameter to identify the *NET or *APPC category device to be used.
. You can specify a media policy name for the Media policy (MEDPCY) parameter if the media policy uses specifies *ADSM (TSM server) for the Media class attribute. Alternately you can specify MEDPCY(*NONE) in which can you must also specify *ADSM for the Media class (MEDCLS), Move policy (MOVPCY) and Secure volume (VOLSEC) parameters.
. The Sequence number (SEQNBR) parameter must be *END.
. The Save to save file (SAVF), Mark volumes for duplication (MARKDUP) and Mark history for duplication (MARKHST) parameters must be *NO. If *MEDPCY is specified for these parameters, then the respective value for the Save to save file attribute, Mark volumes for duplication attribute and Mark history for duplication attribute of the media policy specified by the Media policy (MEDPCY) parameter must be *NO.
. The Required volumes (MINVOL) parameter must be *NONE. If SAVF(*MEDPCY) is specified then the value for the Required volumes attribute of the media policy specified by the Media policy (MEDPCY) parameter must be *NONE.
. If *SYNCLIB is specified for the Save active (SAVACT) parameter each library is saved individually rather than as a group. Synchronization messages are therefore sent individually for each library rather than for the libraries as a group and synchronization is only within one library, not across libraries.
Examples:
Example 1: Saving Objects of a Particular Type
SAVOBJBRM LIB(MYLIB) OBJ(AP* GLMST) DEV(TAP09)
OBJTYPE(*FILE) MEDPCY(FULL)
This command saves selected file objects whose names begin with the letters ¡¯AP¡¯ and the file object named GLMST from library MYLIB using device TAP09.
Example 2: Saving Generic Objects from a Library
SAVOBJBRM LIB(MYLIB) OBJ(DIST*) DEV(TAP09) MEDPCY(FULL)
This command saves all objects that begin with the letters ¡¯DIST¡¯ from library MYLIB using device TAP09.
Example 3: Saving Objects of a Particular Type in Parallel
SAVOBJBRM LIB(MBALIB) OBJ(AP* GLMST) DEV(MLB01)
OBJTYPE(*FILE) MEDPCY(FULL) PRLRSC(2 2)
In this example all objects are saved that begin with AP or the object called GLMST if they are object type *FILE. The objects are found in library MBALIB. They will be saved to two device resources in MLB01.
Example 4: Saving Objects of a Particular Type on an Auxiliary Storage Pool Device
SAVOBJBRM LIB(MYLIB) OBJ(AP* GLMST) DEV(TAP09) OBJTYPE(*FILE)
MEDPCY(FULL) ASPDEV(PRIMETIME)
This command saves selected file objects whose names begin with the letters ¡¯AP¡¯ and the file object named GLMST from library MYLIB which reside on auxiliary storage pool device PRIMETIME using device TAP09.