RSTUSFCNR (Restore Ultimedia System Facilities Container) Command Description

RSTUSFCNR Command syntax diagram

 

Purpose

The Restore Ultimedia System Facilities Container (RSTUSFCNR) command restores to the system the multimedia objects that have been saved using the Save Ultimedia System Facilities Container (SAVUSFCNR) command. The multimedia objects that can be restored using this command are the following:

Restriction: Only those objects that have been placed in an Ultimedia Facilities container and whose data stream files are in the Ultimedia Facilities repository when they were saved are restored. If the data stream file was not in the Ultimedia Facilities repository at the time of the save, only the object's DLO is restored.

 

Required Parameters

SAVCNR
Specifies the identifier of the multimedia container object that is to be restored. This is the identifier of the container object saved with the SAVUSFCNR command.

RSTCNR
Specifies the identifier of the multimedia container object to which the saved container is to be restored.

*SAVCNR: The container objects are restored to the container with the same identifier as the container in which they were saved. If a container with this identifier does not exist on the target system, the container is created as a first level container under the QUMBREPO folder.

container-identifier: Specify the identifier of the container to which the saved container objects are to be restored from tape. If the container specified does not exist, an error message is sent to the job log and processing ends for this command.

DEV
Specifies the name of the device from which the multimedia objects are to be restored.

*SAVF: The objects are restored from the save file specified on the SAVF parameter.

tape-media-library-device-name: Specify the name of the tape media library device used for the restore operation.

tape-device-name: Specify the names of one or more tape devices used for the restore operation. If multiple tape devices are used, they must have compatible media formats and their names must be specified in the order in which they are used. Using more than one tape device permits one tape volume to be rewound and unloaded while another tape device processes the next tape volume. You can specify a maximum of four tape devices.

 

Optional Parameters

VOL
Specifies the volume identifier of the tape from which the multimedia objects are to be restored.

*MOUNTED: The objects are restored from the volumes placed in the device specified on the DEV parameter. For a media library device, the volume to be used is the next cartridge in the category mounted by the Set Tape Category (SETTAPCGY) command.

volume-identifier: Specify the identifiers of one or more volumes in the order in which they are put on the device and used. Each volume identifier contains a maximum of 6 alphanumeric characters. A blank is used as a separator character when listing multiple identifiers. You can specify a maximum of 75 volumes.

SEQNBR
Specifies the starting sequence number of the files on the tape used for the restore operation.

*SEARCH: The volume on the device is searched for a data file containing the multimedia objects to be restored; when a match is found, the data file is searched for the multimedia objects to be restored. If the specified multimedia objects are not found in that data file, the search continues for the next data file that matches the value specified on the LABEL parameter.

Note: If the last operation on the device specified the same volume and ENDOPT(*LEAVE) (that is, the specified tape is positioned at the location at which the last operation ended), the search operation starts with the first data file beyond the current tape position. The files located in front of the current tape position are not searched.

sequence-number: Specify the sequence number of the file to be used as the starting point for the restore operation.

LABEL
Specifies the label of the container object that is used to find the file that was written to tape during the save operation.

*SAVCNR: The container label is the same as the last 17 characters of the Ultimedia Facilities container identifier specified on the SAVCNR parameter.

data-file-identifier: Specify the data file identifier which is the label of the data file that contains the multimedia data to be restored.

ENDOPT
Specifies the operation that is automatically performed on the tape volume after the operation ends. If more than one volume is included, this parameter applies only to the last tape volume used; all other tape volumes are rewound and unloaded when the end of the tape is reached.

*REWIND: The tape is automatically rewound, but not unloaded, after the operation has ended.

*LEAVE: The tape does not rewind or unload after the operation ends. It remains at the current position on the tape drive.

*UNLOAD: The tape is automatically rewound and unloaded after the operation ends.

SAVF
Specifies the qualified name of file that contains the multimedia objects that are being restored.

The name of the save file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

save-file-name: Specify the name of the save file to restore.

SAVDATE
Specifies the date on which the container was saved. If more than one version of the container exists on the media, this parameter identifies which version of the container to restore. If this parameter is not specified, the version of the multimedia objects being restored is the first version found on the volume or, if the LABEL parameter is specified, the version found with the specified label.

The date must be specified in the system date format specified by the system value QDATFMT; if the separators specified by the system value QDATSEP are used, the value must be enclosed in apostrophes.

SAVTIME
Specifies the time when the container was saved. If more than one version of the container exists on the media, this parameter identifies which version of the container is restored. If this parameter is not specified, the version of the multimedia objects being restored is the first version found on the volume or, if the LABEL parameter is specified, the version found with the specified file label.

The time must be specified as a 6-digit value, in the format hours, minutes, and seconds (hhmmss). If colons are used as separators, the value must be enclosed in apostrophes.

Note: This parameter is valid only if SAVDATE is specified.

ALWOBJDIF
Specifies whether the following differences that may be encountered during a restore operation are allowed.

  • The byte stream for a multimedia object resides within the Ultimedia Facilities repository on the target system but is not on the tape.

  • The byte stream for a multimedia object is on the tape but is not stored within the Ultimedia Facilities object repository on the target system.

  • The members of a multimedia key object on the tape are different than those on the target system.

  • The members of a multimedia sequence object on the tape are different than those on the target system.

*ALL: The differences listed are allowed for the restore operation. An informational message is sent and the multimedia object is restored.

*NONE: The differences listed are not allowed on the restore operation. A diagnostic message is sent for the multimedia object, and the multimedia object is not restored.

Example for RSTUSFCNR 

RSTUSFCNR   SAVCNR(SEMINARVIDEOSPOT0004)
  RSTCNR(*SAVCNR)  DEV(TAP01)

This command restores the multimedia container object with the container identifier SEMINARVIDEOSPOT0004 to the multimedia container object with the same container identifier. The container is restored from the tape unit TAP01.

No error messages.