Table of Contents

DSNCHECK

You can use DSNCHECK for any of the following:

list attributes of selected data sets on one or more volumes
list uncataloged, unqualified, or duplicate data sets
list data sets using less than a specified percentage of the capacity of each track or of total allocated space

JCL

Figure 10 shows the JCL for using DSNCHECK.

Figure 9. JCL for Using the DSNCHECK Procedure

//jobname JOB ,'your name',CLASS=class,TIME=(mm,ss),LINES=lines 
/*ROUTE PRINT node.location 
// EXEC DSNCHECK 
//REPORT.SYSIN
DD * 
...optional commands...

`OPTIONS` Command

The OPTIONS command has the following format:

OPTIONS FLAGS=(flag(s),...),BLOCKAGE=nn,USAGE=nn

These are the possible flags:

Flags	Abbreviation	Meaning
`NODSLIST`	`NODS`	skip the attribute list
`NODUPLIST`	`NODU`	skip the duplicate list
`NOQLIST`	`NOQL`	skip the unqualified list
`CLIST`	`C`	list uncataloged data sets
`DSLIST`	`DS`	list attributes of data sets
`DUPLIST`	`DU`	list duplicate data sets
`QLIST`	`QL`	list unqualified data set

BLOCKAGE=nn: (optional) lists all selected data sets using less than the specified percentage of the capacity of each track (in which nn must be 1-99).
USAGE=nn: (optional) lists data sets using less than the specified percentage of the total allocated space (in which nn must be 1-99).

`INCLUDE` and `EXCLUDE` Commands

The INCLUDE command has the following format:

INCLUDE INDEX=selection-prefix

Data sets starting with the given 1- to 44-character string will be included in the selected reports.

The EXCLUDE command has the following format:

EXCLUDE INDEX=selection-prefix

Data sets starting with the given 1- to 44-character string will be excluded from the selected reports.

The selection-prefix character strings are used in character comparisons. "INDEX=U" and "INDEX=U." will have different results (INDEX=U includes data sets beginning with UF but INDEX=U. does not). You can use as many INCLUDE and EXCLUDE commands as necessary In general, EXCLUDE commands should specify more detail thanINCLUDEcommands.

For example, the commands below yield all data sets starting with "UF." except for those starting with "UF.A",

INCLUDE INDEX=UF. EXCLUDE INDEX=UF.A

The following sequence, however, will result in all data sets being excluded:

INCLUDE INDEX=UF.A EXCLUDE INDEX=UF.

Example of Using `INCLUDE`

Figure 11 shows an example of using the INCLUDE command. This example would list all data sets belonging to userid KITTIES that start with either "U." or "UF."

Figure 10. Example Using the INCLUDE Command of DSNCHECK.

//jobname
JOB ,'your name',CLASS=class,TIME=(mm,ss),LINES=lines 
/*ROUTE PRINT node.location 
// EXEC DSNCHECK 
//REPORT.SYSIN DD * 
INCLUDE INDEX=U.KITTIES 
INCLUDE INDEX=UF.KITTIES

`TITLE` Command

TITLE is an optional page heading requested as follows:

TITLE 'heading'

Selecting Direct-Access Volumes

DSNCHECK contains DD statements for user volumes (USERnn) with DDnames of SYSLIB1, SYSLIB2, ... SYSLIBn. You can include additional volumes by supplying additional DD statements. For example, to add a volume named PRU031 use the following:

Figure 11. Adding a Volume Name With DSNCHECK

//jobname JOB ,'your name',CLASS=class,TIME=(mm,ss),LINES=lines
//     EXEC DSNCHECK
//VTOC.SYSLIBE DD UNIT=SYSDA,VOL=SER=PRU031,DISP=OLD

You can override the default volumes by supplying other volume specifications, or you can delete a volume by using a DD DUMMY parameter. For example, to remove the second user volume from consideration, you could use the following:

//     EXEC DSNCHECK
//VTOC.SYSLIB2 DD DUMMY

DSNCHECK uses the following SYSLIB definitions:

DDname	Volume
`SYSLIB1`	`USER90`
`SYSLIB2`	`USER91`
`SYSLIB3`	`USER92`
`SYSLIB4`	`USER93`

Note

The DDnames for all volumes to be processed must be unique and must begin with the six characters "SYSLIB". DSNCHECK requires a separate DD statement for each volume the utility is to inspect.

DSNCHECK

JCL

OPTIONS Command

INCLUDE and EXCLUDE Commands

Example of Using INCLUDE

TITLE Command