| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Restore Deferred Objects (RSTDFROBJ) command completes the restore of deferred objects, if the objects they depend on are now available.
Deferred objects can be logical files or SQL materialized query tables (MQTs). A deferred logical file is not created until the restore is complete. A deferred MQT is created, but until the restore is complete, any functions performed on the MQT that require access to the based-on files will fail.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DFRID | Defer ID | Name | Required, Positional 1 |
| OUTPUT | Output | *NONE, *PRINT, *OUTFILE | Optional |
| OUTFILE | File to receive output | Qualified object name | Optional |
| Qualifier 1: File to receive output | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| OUTMBR | Output member options | Element list | Optional |
| Element 1: Member to receive output | Name, *FIRST | ||
| Element 2: Replace or add records | *REPLACE, *ADD | ||
| INFTYPE | Type of output information | *OBJ, *MBR | Optional |
| Top |
Specifies the name that was used for the Defer ID (DFRID) parameter on the restore operations.
This is a required parameter.
| Top |
Specifies whether a list with information about the restored objects is created. The information can be printed with the job's spooled output or directed to a database file.
Note: You must specify a database file name for the File to receive output (OUTFILE) parameter when OUTPUT(*OUTFILE) is specified.
| Top |
Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.
Qualifier 1: File to receive output
Qualifier 2: Library
Note: If a new file is created, the system uses the IBM-supplied file QASRRSTO with format name QSRRST as a model.
| Top |
Specifies the name of the database file member to which the output is directed when *OUTFILE is specified for the Output (OUTPUT) parameter.
Element 1: Member to receive output
If the member exists, you can add records to the end of the existing member or clear the existing member and add the records.
Element 2: Replace or add records
| Top |
Specifies the type of information which is printed or directed to the database file.
| Top |
(Restore libraries before LFLIB.) RSTLIB SAVLIB(LFLIB) DEV(TAP01) ENDOPT(*LEAVE) DFRID(ABC) (Restore libraries between LFLIB and PFLIB.) RSTLIB SAVLIB(PFLIB) DEV(TAP01) ENDOPT(*LEAVE) DFRID(ABC) (Restore libraries after PFLIB.) RSTDFROBJ DFRID(ABC)
This example shows libraries that were saved in alphabetical order being restored. Library LFLIB contains files that have based-on files in library PFLIB. The files in LFLIB cannot be restored until after the files in PFLIB are restored. A DFRID is specified, so the files in LFLIB are deferred. The restore of these files is completed by using the RSTDFROBJ command, which does not use the tape. If a DFRID had not been specified, the tape would need to be rewound or reloaded to restore the files in LFLIB.
| Top |
*ESCAPE Messages
| Top |