Inquisitor examples

These examples show some possible scenarios where you can customize the scope and type of processing when you run the Inquisitor program.

Example 1

These three statements are equivalent, and request data collection for all programs on all online DASD volumes.

SCANDIR
SCANDIR DA(*) PGM(*)
SCANDIR VOL(*) DS(*)

Example 2

To scan all SMS-managed volumes except volumes in storage group SGWORK use:

SCANDIR STOGROUP(*) XSTOGROUP(SGWORK)

Example 3

To scan all volumes except volumes in storage groups with names beginning with SGW use:

SCANDIR XSTOGROUP(SGW*) NONSMS

Example 4

To scan all volumes with serial numbers beginning with TSO and WRK, these two requests are used in a single program run:

SCANDIR VOLUME(TSO*)
SCANDIR VOLUME(WRK*)

Note that these 2 statements could be reduced to a single statement as follows:

SCANDIR VOLUME(TSO* WRK*)

Example 5

To scan all volumes except those with serial numbers beginning with TSO and WRK use:

SCANDIR XVOLUME(TSO* WRK*)

Example 6

To scan all volumes with serial numbers beginning with USR which are also in SMS storage groups with names beginning with SG for programs with names beginning with UTIL, use: .

SCANDIR VOLUME(USR*) STOGROUP(SG*) PROGRAM(UTIL*)

Example 7

To scan all data sets with high level qualifiers of SYS1, SYS2, SYS3, except z/OS® distribution libraries, use:

SCANDIR DSNAME(SYS%.*) XDSNAME(SYS1.A*)

Example 8

To restrict the data in the previous example to cataloged data sets, use:

SCANDIR DSNAME(SYS%.**) XDSNAME(SYS1.A*) CATALOG

Note: Note the extra asterisk in the data set name selection mask. Without this, only data set names with two qualifiers are selected. Data set name exclusion processing is not changed by the CATALOG operand.

Example 9

To scan the current IPL volume, and any other linklist and APF authorized libraries use:

SCANDIR VOLUME(******) LINKLIST AUTHLIBS

Example 10

To scan the single cataloged data set SYS1.PPLIB without a lengthy DASD subsystem scan use:

SCANDIR DATASET(SYS1.PPLIB) CATALOG

Example 11

To scan all cataloged SYS1 and SYS2 data sets use (a) two requests in a single program run, or (b) a single request. The two approaches exhibit similar resource consumption:

SCANDIR DA(SYS1.**) CAT
SCANDIR DA(SYS2.**) CAT
                       
SCANDIR DS(SYS%.**) CAT XDSN(SYS3.*,SYS4.*,SYSA.*)

The XDSN values are coded as shown under the assumption that SYS1, SYS2, SYS3, SYS4 and SYSA are the only 4 character high-level qualifiers beginning with SYS on the system being scanned.

Note: SCANDIR DS(SYS1.**,SYS2.**) CAT is not allowed.

Example 12

These examples are all equivalent. They scan the entire DASD subsystem for all data sets with a first qualifier of SYS1 or SYS2, excluding those with a second qualifier beginning with A.

(a)

SCANDIR DA(SYS1.*,SYS2.*) XDA(SYS1.A*,SYS2.A*)

(b)

SCANDIR DA(SYS1.*    +
SYS2.*)   +
XDA(SYS1.A*   +
SYS2.A*)

(c)

SCANDIR DA(SYS1.*)   +
DA(SYS2.*)   +
XDA(SYS1.A*)  +
XDA(SYS2.A*)

(d)

SCANDIR DA(SYS1.*)  XDA(SYS1.A*)  +
DA(SYS2.*)  XDA(SYS2.A*)

(e)

SCANDIR DA(SYS1.*)  XDSN(SYS1.A* SYS2.A*)  DS(SYS2.*)