CL Command Reference - SETRTVBRM
CL Command List > SETRTVBRM Reference
Description:
The Set Retrieve Controls for BRM (SETRTVBRM) command can be used to change the way that retrieve operations work when performed by your job.
The controls you specify with SETRTVBRM remain in effect for the duration of your job or until they are reset or otherwise changed by another SETRTVBRM command. The controls you specify with this command are not kept when the job ends. To see control values that are currently in effect, type the SETRTVBRM command on a command line and press F4.
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. You can retrieve data from a TSM server device by using this command. You can only specify one TSM device of *MEDCLS, which must select a TSM device. The TSM device selected can either be *APPC, which supports SNA, or *NET, which supports TCP/IP.
3. *ALLOBJ special authority is required to use any value other than *NONE for the ALWOBJDIF parameter.
4. This command should not be used by control group *EXIT item processing as results will be unpredictable.
5. You can select only one virtual tape device for serial retrieve operations. In addition, only one *MEDCLS can be specified when using media classes which specify a virtual tape device density.
Examples:
Example 1: Resetting Control Values for BRMS Retrieve Operations in Your Job
SETRTVBRM DEV(TAP01) RECALL(*NOTIFY *NOTIFY) RTVAUT(*READ)
This command will set control values so that retrieve operations that occur during your job will use device TAP01, will simply notify you when they occur, and require that you only need read authority to be able to retrieve an object.