The RESTORE statement copies a sequential backup
of the SCC-DLimit database which was taken by the
BACKUP function to a target SCC-DLimit
database. The target database is specified by a SET
statement which occurs in the SYSIN stream prior to the
RESTORE statement. If the target database is not
explicitly specified by a SET statement, the active
DLimit database is used. The target database may be one
of the following:
- a VSAM cluster
- another BDAM file
- the active SCC-DLimit database
FROMDD parameter specifies the name of a DD
statement that points to a backup of a SCC-DLimit
database which was taken earlier using the BACKUP
function. By default, only those accounts which do not
currently exist in the target database will be restored. The ALL parameter indicates that all of the accounts in
the backup are to be restored, including those which already exist in the
target database. In either case, only the accounts which are selected by
the criteria specified on previous INCLUDE or
EXCLUDE statements are processed. If no
INCLUDE or EXCLUDE criteria are
present, then all accounts are processed.
In addition, the CONTROL parameter may be specified,
which indicates that the $CONTROL account is to be
restored, in addition to any other accounts selected. This may be useful
when the SCC-DLimit database is active but the
$CONTROL account has for some reason become corrupted.
ALTER authority to the
DSL.$CONTROL facility-class resource. RESTORE ALL/CONTROL
FROMDD(ddname)
LIST
ALL
Function: The ALL parameter is
optional. It indicates that all of the accounts in the backup are to
be restored, including those which already exist in the target
database. Only accounts selected by previous INCLUDE
or EXCLUDE statements are processed; if none are
present, all accounts are processed.
Default: None
Format:
ALL
CONTROL
Function: The CONTROL parameter is
optional. It indicates that the $CONTROL account is
to be restored, in addition to any other accounts selected. This may
be useful when the SCC-DLimit database is active
but the $CONTROL account has become corrupted.
Default: None
Format:
CONTROL
FROMDD(ddname)
Function: The FROMDD parameter
specifies the name of a DD statement that points to a backup of a
SCC-DLimit database taken earlier using the
BACKUP function. By default, only those accounts
which do not currently exist in the target database will
be restored.
Default: None
Format:
FROMDD(ddname)
LIST
Function: The LIST parameter is optional. It
indicates that the names of the accounts which are restored are to be
written to the SYSPRINT dataset. If the
LIST parameter is not included, then only the
RESTORE control statement is echoed to
SYSPRINT.
Default: None
Format:
LIST
Example - In the following example, the $CONTROL
account is restored to the active database from a backup:
//DSLRESTR JOB ...
//DLMAINT EXEC PGM=DLMAINT,REGION=4M
//STEPLIB DD DISP=SHR,DSN=DTS.R71.LOADLIB
//DBBKUP DD DISP=SHR,DSN=DSL.SEQ.DB.BKUP
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSIN DD *
RESTORE FROMDD(DBBKUP) CONTROL LIST
/* end of SYSIN */
In this example, all accounts are restored to a separate BDAM file used as a DLimit database. This database might later be used as the source for creating reports.
//DSLRESTC JOB ...
//DLMAINT EXEC PGM=DLMAINT,REGION=4M
//STEPLIB DD DISP=SHR,DSN=DTS.R71.LOADLIB
//DBBKUP DD DISP=SHR,DSN=DSL.SEQ.DB.BKUP
//RRDS DD DISP=SHR,DSN=DTS.R71.DSLDB.ALT
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSIN DD *
SET DATABASE(BDAM(RRDS))
RESTORE FROMDD(DBBKUP) ALL CONTROL LIST
/* end of SYSIN */