SAVRSTDLO (Save/Restore Document Library Object)

SAVRSTDLO Command syntax diagram

 

Purpose

The Save/Restore Document Library Object (SAVRSTDLO) command saves and restores the following objects to another system. The system must have a supported communication link with the system that the objects are being restored to.

 

Notes

  1. When a folder is saved and restored, the folder object is transferred along with the documents contained in that folder and the subfolders and documents in the subfolders and all successively nested folders and documents. Specific folders can be saved and restored individually using the DLO(*FLRLVL) parameter.

  2. Distribution objects (mail) cannot be sent for individual users. Mail can be saved and restored for all users only.

  3. SAVRSTDLO does not require a dedicated system; however, individual objects in use when the save and restore command is issued cannot be saved and restored. To ensure all document library objects are saved and restored, run this command when no office activity is occurring on the system.

 

Restrictions

  1. You must have *ALLOBJ or *SAVSYS special authority to use the following parameter combinations on this command:

    • DLO(*ALL) FLR(*ANY)

    • DLO(*CHG)

    • DLO(*MAIL)

    • DLO(*SEARCH) OWNER(*ALL)

    • DLO(*SEARCH) OWNER(user-profile-name)

    where the user profile name specified is not the user profile name of the user issuing the SAVRSTDLO command.

  2. Users that do not have *ALLOBJ or *SAVSYS special authority must:

    • Have *ALL authority for each document or folder to be sent.

    • Be enrolled as Document Interchange Architecture (DIA) users.

  3. Determining document or folder ownership does not include checking group profiles if one is associated with the specified user profile.

  4. Both systems intended to participate in the save and restore operation must be connected to the same APPN network or, if the OptiConnect/400 option is to be used, both systems must be joined by the OptiConnect/400 hardware and software.

 

Required Parameters

DLO
Specifies the document library objects to save and restore.

Note: System object name is not supported.

This parameter is the same as the DLO parameter for the SAVDLO command. If you need further assistance, go to the documentation for the SAVDLO command in this book to see a detailed parameter description.

RMTLOCNAME
Specifies the remote location to connect with. Specify the remote location name using the format cccccccc or nnnnnnnn.cccccccc, where nnnnnnnn is the network identifier (ID) and cccccccc is the remote location name.

remote-location-name: Specify the remote location name associated with the system to which you want to restore objects. The local network ID (LCLNETID) network attribute is used as the value of the network identifier.

network-ID.location-name: Specify the network identifier and the remote location name associated with the system to which you want to restore objects.

 

Optional Parameters

FLR
Specifies the name of the folder containing the document library objects to be saved and restored.

Note: System object name is not supported.

This parameter is the same as the FLR parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

SRCHTYPE
This parameter is the same as the SRCHTYPE parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

CHKEXP
This parameter is the same as the CHKEXP parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

CRTDATE
This parameter is the same as the CRTDATE parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

DOCCLS
This parameter is the same as the DOCCLS parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

OWNER
This parameter is the same as the OWNER parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

REFCHGDATE
This parameter is the same as the REFCHGDATE parameter for the SAVDLO command. If you need further assistance, go to SAVDLO to see a detailed parameter description.

REFCHGTIME
This parameter is the same as the REFCHGTIME parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

DOCL
This parameter is the same as the DOCL parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

OMITFLR
This parameter is the same as the OMITFLR parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

TGTRLS
This parameter is the same as the TGTRLS parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

STG
This parameter is the same as the STG parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

CMDCHRID
This parameter is the same as the CMDCHRID parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

SAVACT
This parameter is the same as the SAVACT parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

SAVACTWAIT
This parameter is the same as the SAVACTWAIT parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

ASP
This parameter is the same as the ASP parameter for the SAVDLO command. If you need further assistance, go to SAVDLO command to see a detailed parameter description.

NEWOBJ
This parameter is the same as the NEWOBJ parameter for the RSTDLO command. If you need further assistance, go to RSTDLO to see a detailed parameter description.

ALWOBJDIF
This parameter is the same as the ALWOBJDIF parameter for the RSTDLO command. If you need further assistance, go to RSTDLO command to see a detailed parameter description.

RSTASP
This parameter is the same as the RSTASP parameter for the RSTDLO command.

Note: The default value of *SAVASP will cause the value specified for the ASP parameter to be used.

If you need further assistance, go to RSTDLO command to see a detailed parameter description.

Examples for SAVRSTDLO

Example 1: Saving and Restoring All Document Library Objects 

SAVRSTDLO   DLO(*ALL)  RMTLOCNAME(SYSTEM1)
  FLR(*ANY)  SAVACT(*YES)  NEWOBJ(*NEW)

This command saves all document library objects located in any folder and restores the objects to a remote system named SYSTEM1. The objects can be changed during the save and restore operation and new names will be given to the libraries in which the objects are restored.

Example 2: Saving and Restoring Specific Document Library Objects 

SAVRSTDLO   DLO(*SEARCH)  RMTLOCNAME(SYSTEM2)
  FLR(FLR2)  OWNER(USER8)  SRCHTYPE(*DOC)

This command searches for a folder named FLR2 and checks to see if the documents owned by user USER8. The folder and the documents in the folder are saved and restored on a remote system named SYSTEM2.

Error messages for SAVRSTDLO

*ESCAPE Messages

CPCAD82
&1 document library objects saved and restored.
CPFAD8C
An error occurred during the SAVRSTDLO operation.
CPFAD80
Unable to establish connection from &1 to &2.
CPFAD81
User profile &1 not found on remote location &2.
CPFAD82
Remote location &1 not found.
CPFAD83
Remote location &1 cannot be source location.
CPFAD84
ObjectConnect/400 internal error, function code &1, return code &2.
CPFAD86
Location name &1 unable to close &2.
CPFAD88
Unable to establish connection from &1 to &2.
CPFAD93
APPC failure. Failure code is &3.
CPF389C
ObjectConnect/400 internal error, function code &1, return code &2.