---

 

RSTLIB (Restore Library) syntax diagram

Job: B,I Pgm: B,I REXX: B,I Exec

Threadsafe: No

>>-RSTLIB--SAVLIB(--+-*NONSYS------+--)------------------------->
                    +-*ALLUSR------+
                    +-*IBM---------+
                    '-library-name-'
 
>--DEV(--+-*SAVF--------------------------+--)------------------>
         +-*MEDDFN------------------------+
         +-diskette-device-name-----------+
         +-optical-device-name------------+
         +-tape-media-library-device-name-+
         | .-----------------------.      |
         | V                  (1)  |      |
         '---tape-device-name------+------'
 
>--+-----------------------------------------+------------------>
   |                  (2)                    |
   |       .-*MOUNTED-------------------.    |
   '-VOL(--+-*SAVVOL--------------------+--)-'
           | .------------------------. |
           | V                   (3)  | |
           '---volume-identifier------+-'
 
                                                 (5)
>--+-------------------------------------------+---------------->
   |         (4)   .-*SEARCH--------------.    |
   '-SEQNBR(-------+-file-sequence-number-+--)-'
 
>--+-------------------------------------+---------------------->
   |         .-*SAVLIB--------------.    |
   '-LABEL(--+-data-file-identifier-+--)-'
 
>--+-------------------------+---------------------------------->
   |          .-*REWIND-.    |
   '-ENDOPT(--+-*LEAVE--+--)-'
              '-*UNLOAD-'
 
>--+-----------------------------------+------------------------>
   |         (6)   .-*FIRST-------.    |
   '-STRLIB(-------+-library-name-+--)-'
 
>--+---------------------------------------------+-------------->
   |                .-*NONE-----------------.    |
   |                | .-------------------. |    |
   |          (6)   | V              (7)  | |    |
   '-OMITLIB(-------+---library-name------+-+--)-'
 
>--+---------------------------------------------+-------------->
   |        .-*LIBL/--------.                    |
   '-SAVF(--+---------------+--save-file-name--)-'
            +-*CURLIB/------+
            '-library-name/-'
 
>--+-----------------------------------------------------------+-->
   |         (8)   .-*LIBL/--------.                           |
   '-MEDDFN(-------+---------------+--media-definition-name--)-'
                   +-*CURLIB/------+
                   '-library-name/-'
 
>--+-----------------------+--+------------------------+-------->
   |          .-*ALL--.    |  |          .-*MATCH-.    |
   '-OPTION(--+-*NEW--+--)-'  '-MBROPT(--+-*ALL---+--)-'
              +-*OLD--+                  +-*NEW---+
              '-*FREE-'                  '-*OLD---'
 
>--+------------------------------+----------------------------->
   '-SAVDATE(--date-when-saved--)-'
 
>--+------------------------------+----------------------------->
   '-SAVTIME(--time-when-saved--)-'
 
>--+------------------------------+----------------------------->
   |             .-*NONE-----.    |
   |             |      (9)  |    |
   '-ALWOBJDIF(--+-*ALL------+--)-'
                 '-*FILELVL--'
 
>--+-----------------------------------+------------------------>
   |             .-*SYSVAL--------.    |
   '-FRCOBJCVN(--+-*NO------------+--)-'
                 |       .-*RQD-. |
                 '-*YES--+-*ALL-+-'
 
>--+------------------------------------+----------------------->
   |          .-*SAVLIB------------.    |
   |          |              (10)  |    |
   '-RSTLIB(--+-library-name-------+--)-'
 
>--+-------------------------------------------------------------+-->
   |            (11)   .-*SAVASPDEV-------------------------.    |
   '-RSTASPDEV(--------+-auxiliary-storage-pool-device-name-+--)-'
 
>--+-----------------------------------------------------+------>
   |         (11)   .-*SAVASP-----------------------.    |
   '-RSTASP(--------+-auxiliary-storage-pool-number-+--)-'
 
>--+--------------------------+--------------------------------->
   |          .-*NONE----.    |
   '-OUTPUT(--+-*PRINT---+--)-'
              '-*OUTFILE-'
 
>--+----------------------------------------------------------+-->
   |          (12)   .-*LIBL/--------.                        |
   '-OUTFILE(--------+---------------+--database-file-name--)-'
                     +-*CURLIB/------+
                     '-library-name/-'
 
>--+-------------------------------------------------+---------->
   |         (12)   .-*FIRST------.  .-*REPLACE-.    |
   '-OUTMBR(--------+-member-name-+--+-*ADD-----+--)-'
 
>--+-----------------------------+------------------------------>
   |          (12)   .-*OBJ-.    |
   '-INFTYPE(--------+-*MBR-+--)-'
 
>--+--------------------------------------------------+--------><
   |           .-'*'-----------------------------.    |
   '-OPTFILE(--+-'optical-directory-path-name/*'-+--)-'
               '-'optical-file-path-name'--------'
 
 

Notes:

1. A maximum of 4 repetitions.

2. This value cannot be specified when using an optical media library device.

3. A maximum of 75 repetitions.

4. Applies to tape devices only.

5. All parameters preceding this point can be specified positionally.

6. Valid only if SAVLIB(*NONSYS), SAVLIB(*ALLUSR), or SAVLIB(*IBM) is specified.

7. A maximum of 300 repetitions.

8. The MEDDFN parameter is required when DEV(*MEDDFN) is specified.

9. When using ALWOBJDIF(*ALL), the MBROPT(*MATCH) parameter cannot be specified.

10. If an SQL database is restored to a library other than the one in which it was saved, the journals are not restored.

11. You can specify either the RSTASPDEV or RSTASP parameter, but not both.

12. This parameter is valid only if OUTPUT(*OUTFILE) is specified.