The INCLUDE and EXCLUDE statements provide filtering criteria for
DLMAINT functions that are used to maintain the SCC-DLimit database. The statements limit DLMAINT
operations to specified subsets of data within the SCC-DLimit database. For example, placing
INCLUDE ACCOUNT(PAYROLL) in the input stream ahead of a BACKUP causes only the
PAYROLL account records to be included in the backup. The DLMAINT functions that can be
filtered include
SHOW,BACKUP,RESET,RESTORE,RESYNC,
and ERASE.
As many INCLUDE and EXCLUDE statements as necessary may be specified. Multiple
filters may be specified on a single statement or on multiple statements. For example:
-
INCLUDE ACCOUNT(PAY*, TEST*)(multiple filters on one statement) -
INCLUDE ACCOUNT(PAY*)andINCLUDE ACCOUNT(TEST*)(filter criteria on multiple statements)
INCLUDE and EXCLUDE statements may be specified in any order. If the same filter
criteria is specified on both an INCLUDE and an EXCLUDE statement, the
EXCLUDE statement takes precedence.
*) and question mark (?).
EXCLUDE
ACCOUNT
(acctnames)
DSNAME( dsnames )
VOLUME( volsers )
ACCOUNT(acctnames)
Function: This is an optional parameter. Specifies the names of the SCC-DLimit accounts
to be processed during BACKUP, RESTORE, RESYNC,
SHOW, and other DLMAINT operations. Only the specified accounts will be processed. Account
names may use wildcard characters (for example, ABC* matches all accounts beginning with "ABC").
Default: None
Format:
ACCOUNT(acct1, acct2, ... acctn)
DSNAME(dsnames)
Function: This is an optional parameter. Specifies the datasets to be excluded during DLMAINT operations. Only the specified datasets will be excluded. Dataset names may be partially qualified via wildcard characters.
Synonym:
DATASET
Default: None
Format:
DSNAME(dsname1, dsname2, ... dsnamen)
VOLUME(volsers)
Function: This is an optional parameter. Specifies the volumes to be excluded during DLMAINT operations. Only the specified volumes will be excluded. Volume names may be partially qualified via wildcard characters.
Synonym:
VOLSER
Default: None
Format:
VOLUME(vol1, vol2, ... voln)
Example: The following example shows the use of the INCLUDE and EXCLUDE
ACCOUNT statements with the RESTORE statement to load specified accounts from a
sequential backup file into the active SCC-DLimit database.
//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 *
SET DATABASE(SYSTEM)
INCLUDE ACCOUNT(TEST4*,REGION3*,SYS2*) EXCLUDE ACCOUNT(TEST4A17,SYS2.*.LOAD) RESTORE FROMDD(DBBKUP) ALL LIST
/*
Example: In the following example, the INCLUDE and EXCLUDE statements for
DSNAME and VOLUME parameters are used to select certain datasets for
RESYNC processing. This is useful, for example, when placing a new application under
SCC-DLimit control; the statements control which datasets will be used in accounting for
space. Only datasets on the specified volumes will be processed.
//DSLRESYN JOB ...
//DLMAINT EXEC PGM=DLMAINT,REGION=4M
//STEPLIB DD DISP=SHR,DSN=DTS.R71.LOADLIB
//SYSUT1 DD DSN=DSL.SYSUT1,UNIT=SYSDA,DISP=(,CATLG,DELETE),SPACE=(CYL,(25,5))
//SYSUT2 DD DSN=DSL.SYSUT2,UNIT=SYSDA,DISP=(,CATLG,DELETE),SPACE=(CYL,(25,5))
//SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(20,20)),DISP=SHR
//SORTWK02 DD UNIT=SYSDA,SPACE=(CYL,(20,20)),DISP=SHR
//SORTWK03 DD UNIT=SYSDA,SPACE=(CYL,(20,20)),DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSABEND DD SYSOUT=*
//SYSIN DD *
SET DATABASE(SYSTEM) INCLUDE DSNAME(M*,A*) INCLUDE VOLUME(WORK*,PROD*)
EXCLUDE VOLUME(WORK24,PROD18) RESYNC DETAIL
/*