Restrictions when using the Restore command

The Restore (RST) command can be used to restore objects to any file system. This topic describes restrictions that apply when using the RST command.

Restrictions when restoring objects to multiple file systems: When you use the RST command to restore objects to more than one file system at the same time and the file systems include the QSYS.LIB file system or the QDLS file system, the following restrictions apply:

  • Different file systems support different types of objects and different methods of naming objects. Therefore, when you restore objects from more than one file system with the same command, you cannot specify object names or object types. You can restore all objects from all file systems, or you can omit some file systems. These combinations are valid:
    • Restoring all objects on the system: OBJ('/*')
      Note: Using this command is not the same as using option 21 from the Restore menu. The differences between RST OBJ('/*') and option 21 are as follows:
      • RST OBJ('/*') does not put the system in a restricted state.
      • RST OBJ('/*') does not start the controlling subsystem when it finishes.
      • RST OBJ('/*') does not provide prompting to change default options.
    • Restoring all objects in all file systems except the QSYS.LIB file system and the QDLS file system: OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT))
    • Restoring all objects in all file systems except the QSYS.LIB file system, the QDLS file system, and one or more other file systems: OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT) ('/other values' *OMIT))
  • Values for other parameters of the RST command are supported only for some file systems. You must choose values that are supported by all file systems. Specify the following parameters and values:
    OPTION
    *ALL
    ALWOBJDIF
    *NONE or *ALL
    LABEL
    *SEARCH
    OUTPUT
    *NONE
    SUBTREE
    *ALL
    SYSTEM
    *LCL
    DEV
    (Must be a tape device or an optical device)
    VOL
    *MOUNTED
  • When you specify RST OBJ('/*'), the following situations apply:
    • The system restores only objects that are saved by SAV OBJ('/*').
    • The system must be in a restricted state.
    • You must have *SAVSYS or *ALLOBJ special authority.
    • You cannot specify the save file for the DEV parameter.
    • You must specify SEQNBR(*SEARCH).
    Note: RST OBJ('/*') is not the suggested method for restoring the entire system. Selecting the appropriate recovery strategy describes how to determine the recovery procedure for your situation.

Restrictions when restoring objects to the QSYS.LIB file system: When you use the RST command to restore objects to the QSYS.LIB (library) file system, the following restrictions apply:

  • The OBJ parameter must have only one name.
  • You specify objects in the same way that you specify them on the RSTOBJ command and the RSTLIB command. Table 1 shows the valid options for the Object (OBJ) parameter when restoring objects to the QSYS.LIB file system and the equivalent Restore Object (RSTOBJ) or Restore Library (RSTLIB) command:
    Table 1. Using the RST Command for QSYS.LIB Objects
    Object parameter on RST command Equivalent RSTxxx command
    OBJ('/QSYS.LIB/library-name.LIB') RSTLIB SAVLIB(library-name)
    OBJ('/QSYS.LIB/library-name.LIB/*') 
    RSTOBJ SAVLIB(library-name) OBJ(*ALL)
       OBJTYPE(*ALL)
    OBJ('/QSYS.LIB/library-name.LIB/*.object-type') 
    RSTOBJ SAVLIB(library-name) OBJ(*ALL)
       OBJTYPE(object-type) FILEMBR(*ALL)
    OBJ('/QSYS.LIB/library-name.LIB/object-name.object-type') 
    RSTOBJ SAVLIB(library-name) OBJ(object-name)
       OBJTYPE(object-type)
    OBJ('/QSYS.LIB/library-name.LIB/file-name.FILE/*') 
    RSTOBJ SAVLIB(library-name) OBJ(file-name)
       OBJTYPE(*FILE)
    OBJ('/QSYS.LIB/library-name.LIB/file-name.FILE/*.MBR') 
    RSTOBJ SAVLIB(library-name) OBJ(file-name)
       OBJTYPE(*FILE)
    		 
    OBJ('/QSYS.LIB/library-name.LIB/file-name.FILE/
    member-name.MBR')
    		 
    RSTOBJ SAVLIB(library-name) OBJ(file-name)
       OBJTYPE(*FILE) FILEMBR((*ALL) 
       (member-name))
  • You can specify only object types that are allowed on the RSTOBJ command. For example, you cannot use the RST command to restore user profiles because OBJTYPE(*USRPRF) is not allowed on the RSTOBJ command.
  • Start of changeSome libraries in the QSYS.LIB file system cannot be saved with the SAVLIB command or restored with the RSTLIB command. You cannot use the RST command to restore these entire libraries. The QDOC, QSYS, and QTEMP libraries are examples.End of change
  • You can use the new-name element of the object parameter to rename an object in a directory, restore an object to a different directory, or restore an object to a different library. Table 2 shows some examples:
    Table 2. New name options on the RST command–Examples
    Object parameter on RST command Results
    OBJ(('/DBSDIR/FILEB' *INCLUDE '/DBSDIR/FILEX')) FILEX is created in the DBSDIR directory. The data that was saved with FILEB is restored to FILEX. If FILEB still exists on the system, it is not changed.
    OBJ(('/DBSDIR/FILE*' *INCLUDE '/LMSDIR)) Restores all objects from the DBSDIR whose names begin with FILE to the LMSDIR directory.
    OBJ(('/QSYS.LIB/LIB1.LIB' *INCLUDE '/QSYS.LIB/LIB2.LIB')) Library LIB1 (and all objects) are restored as library LIB2.
    OBJ(('/QSYS.LIB/LIB1.LIB/*' *INCLUDE '/QSYS.LIB/LIB2.LIB')) All the objects of library LIB1 are restored into library LIB2. 
    OBJ(('QSYS.LIB/LIB1.LIB/*.type' 
*INCLUDE '/QSYS.LIB/LIB2.LIB/*.type'))
    		 All objects of type 'type' from library LIB1 are restored into library LIB2.
  • For database file members, OPTION(*NEW) restores members for new files only.
  • Other parameters must have these values:
    SUBTREE
    *ALL
    SYSTEM
    *LCL
    OUTPUT
    *NONE
    ALWOBJDIF
    *ALL or *NONE
  • You can only rename the library, you cannot rename the object. The new name must be *SAME or 
    /QSYS.LIB/libname.LIB

    where the library that is specified by libname must exist.

Restrictions when restoring objects to the QDLS file system: When you use the RST command to restore objects to the QDLS (document library services) file system, the following restrictions apply:

  • The OBJ parameter must have only one name.
  • The OBJ and SUBTREE parameters must be one of the following items:
    • OBJ('/QDLS/path/folder-name') SUBTREE(*ALL)
    • OBJ('/QDLS/path/document-name') SUBTREE(*OBJ)
  • Other parameters must have these values:
    SYSTEM
    *LCL
    OUTPUT
    *NONE
    ALWOBJDIF
    *ALL or *NONE
    OPTION
    *ALL