ACBSYSIN control statements

You can specify a single control statement in the ACBSYSIN DD statement. The syntax rules are the same as those of the ACBSYSIN control statements for the Advanced ACBGEN utility program. If the ACBSYSIN DD statement is omitted, the default operand values for the LISTLIB command are used.

Subsections:

Control statement example

The following figures show examples of ACBSYSIN control statements.

Figure 1. ACBSYSIN control statement examples for the ACBLIB Analyzer utility: obtain reports on an ACB library
LISTLIB
LISTLIB LIBTYPE=ACB,SNAP=(DIRENTRY=(Y,100),DIRRCD=N)
LISTLIB LIBTYPE=ACB,USESORT=YES
LISTLIB LIBTYPE=ACB,GENDATE=YES
Figure 2. ACBSYSIN control statement examples for the ACBLIB Analyzer utility: obtain reports on a DBD or PSB library 
LISTLIB LIBTYPE=DBD,INDD=IMSDBD
LISTLIB LIBTYPE=PSB,INDD=IMSPSB

For DBD and PSB libraries, ACBLIB Analyzer prints only two reports: Input Specifications report and Library Information report.

Syntax rules

The syntax rules for the ACBSYSIN control statement are the same as for the Advanced ACBGEN utility. See Syntax rules for the syntax rules of the ACBSYSIN control statement.

LISTLIB command

You can provide a LISTLIB command to specify parameters used by ACBLIB Analyzer utility. The LISTLIB command can contain the following operands:

LIBTYPE=
Identifies the type of the library to process. The operand is DBD, PSB, or ACB. The default is ACB. You can specify only one type of library for one job step.

If you specify DBD or PSB, only two reports are generated: Input Specifications report and Library Information report.

SNAP=
The valid suboperands for the SNAP operand are DIRENTRY= and DIRRCD=. Each of these suboperands can specify YES or NO, and a number.

The SNAP operand is ignored if the library type is DBD or PSB (LIBTYPE=DBD or LIBTYPE=PSB).

DIRENTRY=
The DIRENTRY= suboperand specifies whether you want a hex dump of any of the library directory entries. If you specify YES, you can also specify a three-digit number which specifies the maximum number of entries to be displayed. The default is DIRENTRY=NO. The requested number of directory entries is displayed (in hexadecimal format) in the Library Contents report.
DIRRCD=
The DIRRCD= suboperand specifies whether you want a listing of any of the library directory records. The default is DIRRCD=NO. If you specify YES, you can also include a three-digit number specifying the maximum number of entries to be displayed. The hex dump is placed in the DBTSNAP DD statement.
USESORT=
Specifies whether the ACBLIB Analyzer utility is to use the SORT program of your location. The valid operands are YES and NO; the default is USESORT=NO.

If USESORT=YES is specified, the ACBLIB Analyzer utility links to a program named SORT. DFSORT (Data Facility Sort), which is a part of z/OS®, or a functionally equivalent sort program is necessary. If the SORT program of your location requires a SYSOUT DD statement, you must specify it in your JCL.

If the ACB library being analyzed contains a large number such as over 1000 PSBs and DMBs, specify USESORT=YES to reduce the job-step elapse time and the CPU utilization time. (This depends on the user environment.)

The USESORT operand is ignored if the type of the library is DBD or PSB (LIBTYPE=DBD or LIBTYPE=PSB).

INDD=
Specifies the ddname of the DD statement that is used as input. The default ddname is IMSACB.

Specify the ddname that defines the data set name of the library to analyze. When an INDD operand is specified, the ACBLIB Analyzer utility analyzes the data set that is defined by the ddname.

GENDATE=
Specifies to include the date and time when the ACBLIB members were generated in the Library Contents report. The value can be YES or NO. The default is GENDATE=NO.

If GENDATE=YES is specified, all of the reports except the Input Specifications report are generated in the FABQRPT data set.

If GENDATE=YES is specified and the LIBTYPE=DBD or LIBTYPE=PSB operand is specified, the GENDATE=YES operand is ignored.

Parent topic: ACBLIB Analyzer utility