| Where allowed to run: Compiled CL program or interpreted REXX (*BPGM *IPGM *BREXX *IREXX) Threadsafe: No |
Parameters Examples Error messages |
The Retrieve Backup (RTVBCKUP) command is used in a CL program or REXX procedure allows the user to retrieve the options in one of the predefined backups into CL variables. More information on backup is in the Backup and Recovery book, SC41-5304.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| BCKUPOPT | Backup options | *DAILY, *WEEKLY, *MONTHLY | Required, Positional 1 |
| DEV | CL var for DEV (43) | Character value | Optional |
| TAPSET | CL var for TAPSET (34) | Character value | Optional |
| CLRTAP | CL var for CLRTAP (4) | Character value | Optional |
| SBMJOB | CL var for SBMJOB (4) | Character value | Optional |
| CHGONLY | CL var for CHGONLY (4) | Character value | Optional |
| PRTRPT | CL var for PRTRPT (4) | Character value | Optional |
| LIB | CL var for LIB (10) | Character value | Optional |
| FLR | CL var for FLR (10) | Character value | Optional |
| DIR | CL var for DIR (10) | Character value | Optional |
| SECDTA | CL var for SECDTA (4) | Character value | Optional |
| CFG | CL var for CFG (4) | Character value | Optional |
| CL var for MAIL (4) | Character value | Optional | |
| CAL | CL var for CAL (4) | Character value | Optional |
| EXITPGM | CL var for EXITPGM (10) | Character value | Optional |
| EXITPGMLIB | CL var for EXITPGMLIB (10) | Character value | Optional |
| Top |
Specifies the backup options to be retrieved.
This is a required parameter.
| Top |
Specifies the name of the CL variable that receives the device value. The variable has a minimum length of 43 characters. The value returned is a character string of four 10-character device names, separated by blanks.
| Top |
Specifies the name of the CL variable that receives the tape set names. The variable has a minimum length of 34 characters (seven 4-character tape set names, separated by blanks).
| Top |
Specifies the name of the CL variable that receives the indicator for clearing the tape for backup. The variable must have a minimum length of 4 characters. The value returned is either *YES or *NO.
| Top |
Specifies the name of the CL variable that receives the indicator of whether the backup is run as a batch job. The variable must have a minimum length of 4 characters. The value returned is either *YES or *NO.
| Top |
Specifies the name of the CL variable that receives the indicator for saving changed objects only. The variable must have a minimum length of 4 characters. The value returned is either *YES or *NO.
| Top |
Specifies the name of the CL variable that receives the indicator for printing a report of saved objects. The variable must have a minimum length of 4 characters. The value returned is either *YES or *NO.
| Top |
Specifies the name of the CL variable that receives the value specifying the libraries to save with this backup. The variable must have a minimum length of 10 characters. A value of *ALLUSR, *FROMLIST, or *NONE is returned.
| Top |
Specifies the name of the CL variable that receives the value specifying the folders to save with this backup. The variable must have a minimum length of 10 characters. A value of *ALL, *FROMLIST, or *NONE is returned.
| Top |
Specifies the name of the CL variable that receives the value specifying the user directories to save with this backup. The variable must have a minimum length of 10 characters. A value of *ALLUSR or *NONE is returned.
| Top |
Specifies the name of the CL variable that receives the indicator for saving security data. The variable must have a minimum length of 4 characters. The value returned is either *YES or *NO.
| Top |
Specifies the name of the CL variable that receives the indicator for saving configuration data. The variable must have a minimum length of 4 characters. The value returned is either *YES or *NO.
| Top |
Specifies the name of the CL variable that receives the indicator for saving OfficeVision mail. The variable must have a minimum length of 4 characters. The value returned is either *YES or *NO.
| Top |
Specifies the name of the CL variable that receives the indicator for saving OfficeVision calendars. The variable must have a minimum length of 4 characters. The value returned is either *YES or *NO.
| Top |
Specifies the name of the CL variable that receives the name of the user program to call before and after the backup is run. The variable must have a minimum length of 10 characters. If no exit program is specified, *NONE is returned.
| Top |
Specifies the name of the CL variable that receives the name of the library that contains the exit program. The variable must have a minimum length of 10 characters. If no exit program is specified, blanks are returned. If *LIBL is returned, the program uses the library list.
| Top |
RTVBCKUP BCKUPOPT(*DAILY) SBMJOB(&SBMJOBVAR) LIB(&LIBVAR)
This command retrieves the SBMJOB and LIB values for the daily backup into the CL variables SBMJOBVAR and LIBVAR respectively.
| Top |
*ESCAPE Messages
| Top |