The EXCLUDE command allows you to exclude data sets from processing. In order for a data set to be excluded, all tests specified on a single EXCLUDE command must be met. If only one parameter is specified, only that single test must be met for the exclusion to be honored. If the EXCLUDE command is specified more than once for any given ACTION command, it has the effect of a logical OR between EXCLUDE commands. That is, if any EXCLUDE command is true, then the data set is bypassed, regardless if other EXCLUDE commands test true or not.
For example, if the DSNAMES= parameter or the VOLUMES= parameter, but not both, are specified, conceptually think don't process these data sets or don't process these volumes. If both the DSNAMES= and VOLUMES= parameters are specified, conceptually think don't process these data sets if they reside on these volumes.
Note: If a SELECT command immediately precedes or follows any EXCLUDE command, special rules apply. See SELECT and EXCLUDE Rules for a further explanation.
The syntax of the EXCLUDE command, is as follows:
EXCLUDE DSNAMES=,COMPONENTS,TABLE=,VOLUMES=,UNIT=,VAMPOOL=,SGNAME=,VTOCS, CATALOGS=,CRITERIA=
You can specify the data sets to be excluded by NAME or PATTERN. Up to ten names or patterns are allowed.
Because an EXCLUDE DSNAMES= statement is already very restrictive, you cannot specify the VTOCS or CATALOGS= parameters on the same EXCLUDE statement. You can, however, add the COMPONENTS, TABLE=, VOLUMES=, VAMPOOL=, SGNAME= or CRITERIA= parameters.
For improved performance for VSAM, see the section COMPONENTS in the chapter "Reports."
Under SCAN REALVOLS, the COMPONENTS parameter will modify the action of EXCLUDE DSNAMES= or EXCLUDE TABLE= parameters to cause those parameters to act on VSAM component names (the names of their format-1 DSCBs) instead of their cluster names. Specifying this parameter can eliminate the need for CA Disk to access the catalog to retrieve the cluster name for VSAM components that do not meet the EXCLUDE DSNAMES= or TABLE= list. This saves significant processing time and also prevents many broken VSAM cluster messages (those that see components outside of the range of the DSNAMES= or TABLE= parameters).
This COMPONENTS parameter is only allowed on EXCLUDE DSNAMES= or EXCLUDE TABLE= commands.
This COMPONENTS parameter is ineffective under SCAN CATALOGS= or FIND commands.
Use this parameter if you have installed DFP release 3.1 or above, have installed a VSAM allocation manager product or have taken administrative action to ensure that VSAM components have names that relate to their associated cluster names, or are not processing VSAM data sets.
Specify the name of a member in the parmlib data set that contains a list of data set names and patterns that are to be excluded from CA Disk processing.
Note: Data sets are not automatically excluded because of their appearance in this list. If any other parameters are specified on the same EXCLUDE command, all tests must be true for the data set to be excluded. For example, in the following command, the data set must both be listed in the member named IMSDSNS and be more than 300 tracks in size to be excluded:
EXCLUDE TABLE=IMSDSNS,CRITERIA=(TRKS,GT,300)
Because an EXCLUDE TABLE= statement is already very restrictive, you cannot specify the VTOCS, nor CATALOGS= parameters on the same EXCLUDE statement. You can, however, add the DSNAMES=, COMPONENTS, VOLUMES=, VAMPOOL=, SGNAME= or CRITERIA= parameters.
Note: By default, these tables are stored in PARMLIB. However, you can store them in an alternative data set if you desire. For details, see Alternate DDname for User Tables in the Systems Guide.
You can exclude all data sets on a volume or volume group by use of this parameter. Up to 30 volumes or volume patterns are allowed.
When an EXCLUDE command with the VOLUMES= parameter is specified under a SCAN REALVOLS command, special processing rules apply. If the VOLUMES= parameter is specified by itself with no other parameters (such as CRITERIA= or DSNAMES=), the volume will not have its VTOC read, even if other SELECT commands are present that name the same volume or pattern name. Conversely, if any other parameter is specified on the EXCLUDE command, this will have no effect on which volumes get scanned to satisfy the request.
You can add the DSNAMES=, COMPONENTS, TABLE=, VTOCS, CATALOGS= or CRITERIA= parameters on the same EXCLUDE statement. VOLUMES= is mutually exclusive with the other volume-oriented EXCLUDE command parameters of UNIT=, VAMPOOL= and SGNAME=. This means that VOLUMES= cannot be specified with UNIT=, VAMPOOL= or SGNAME= on the same EXCLUDE statement.
You can exclude all data sets on a unit or unit group by use of this parameter. Up to 16 units or unit patterns are allowed. This will also exclude a unit from being processed by VBACKUP.
When an EXCLUDE command with the UNIT= parameter is specified under a SCAN REALVOLS command, special processing rules apply. If the UNIT= parameter is specified by itself with no other parameters (such as CRITERIA= or DSNAMES=), the volume will not have its VTOC read, even if other SELECT commands are present that name the same unit or pattern name. Conversely, if any other parameter is specified on the EXCLUDE command, this will have no effect on which units get scanned to satisfy the request.
You can add the DSNAMES=, COMPONENTS, TABLE=, VTOCS, CATALOGS= or CRITERIA= parameters on the same EXCLUDE statement. UNIT= is mutually exclusive with the other volume-oriented EXCLUDE command parameters of VOLUMES=, VAMPOOL= and SGNAME=. This means that UNIT= cannot be specified with VOLUMES=, VAMPOOL= or SGNAME= on the same EXCLUDE statement.
This parameter is only valid when CA Allocate (Volume Allocation Manager) is active on the system. It allows exclusion at the CA Allocate pool level. CA Disk. For example, EXCLUDE
VAMPOOL=(SYSTEM,DMS*) would cause CA Disk to check if the volume being processed or the cataloged volume of a data set being processed for selection is in the CA Allocate pool named SYSTEM or in pools whose names start with DMS.
Note: If you choose to use pattern matching for this parameter, you must use the CA Allocate pattern conventions.
To accomplish this selection CA Disk searches the in-memory copy of the CA Allocate pools using the volume currently being processed by a SCAN REALVOLS or the volume to which a data set being processed by a SCAN CATALOGS command is cataloged. A table of pool names containing this volume is generated. The generated table of pool names is then compared to the pool names or patterns coded in the VAMPOOL parameter to determine if a match exists.
There is a limit of 30 on the number of pool names that can be placed in the generated table. If the volume used for the search is contained in more than 30 CA Allocate pools, the 31st and higher pool names will not be entered in the table and, therefore, will not be used in the compare for a match with the VAMPOOL parameter.
On each SELECT command statement, you can specify up to 22 CA Allocate pool names or CA Allocate pool name patterns.
There are four DSCL EXCLUDE command volume-oriented parameters. They are VOLUMES=, UNIT=, VAMPOOL=, and SGNAME=, which are each mutually exclusive. This means that VAMPOOL= cannot be specified with UNIT=, VOLUMES=, or SGNAME= on the same EXCLUDE command statement.
This parameter is only valid when IBM's Storage Management Subsystem (SMS) is active on the system. It allows exclusion at the DFSMS storage group level. Volumes and/or data sets will be excluded for processing based on whether or not their volser belongs to a particular storage group name specified in the SGNAME= parameter.
For example, EXCLUDE SGNAME=(SGLARGE,SG1/) would exclude all volumes and/or data sets that reside on the volumes, in the storage group of SGLARGE and in storage group names matching the pattern name of SG1/.
On each EXCLUDE statement, you can specify up to 22 DFSMS storage group names or DFSMS storage group name patterns.
There are four DSCL EXCLUDE command volume-oriented parameters. They are VOLUMES=, UNIT=, VAMPOOL=, and SGNAME=, which are each mutually exclusive. This means that SGNAME= cannot be specified with VOLUMES=, UNIT= or VAMPOOL= on the same EXCLUDE statement.
You can add the DSNAMES=, COMPONENTS, TABLE=, VTOCS, CATALOGS= or CRITERIA= parameters on the same EXCLUDE statement.
Normally, DSCL processes user data sets only, and bypasses VTOCs, VTOC indexes, catalogs and VVDSs. This parameter is optional, you can specify it to have CA Disk bypass VTOCs and VTOC indexes.
Because an EXCLUDE VTOCS statement is already very restrictive, you cannot specify the DSNAMES=, COMPONENTS, TABLE=, CATALOGS= nor CRITERIA= parameters on the same EXCLUDE statement. You can, however, add a VOLUMES=, VAMPOOL= or SGNAME= parameter.
Normally, DSCL processes user data sets only, and bypasses VTOCs, VTOC indexes, catalogs and VVDSs. This parameter is optional, you can specify it to have CA Disk bypass catalogs and VVDSs as specified by a required fully qualified data set name or CA Disk pattern.
Because an EXCLUDE CATALOGS= statement is already very restrictive, you cannot specify the DSNAMES=, COMPONENTS, TABLE=, VTOCS nor CRITERIA= parameters on the same EXCLUDE statement. You can, however, add a VOLUMES=, VAMPOOL= or SGNAME= parameter.
Specify the exclusion criteria that, if met, will cause processing by CA Disk for that data set to be bypassed. See CRITERIA= for additional details.
Because an EXCLUDE CRITERIA= statement is already very restrictive, you cannot specify the VTOCS nor CATALOGS= parameters on the same EXCLUDE statement. You can, however, add the DSNAMES=, COMPONENTS, TABLE=, VOLUMES=, VAMPOOL= or SGNAME= parameters.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|