FABBME1 JCL

FABBME1 runs as a standard z/OS® batch job step. An EXEC statement and DD statements that define inputs and outputs are required.

EXEC statement

The EXEC statement must be in the form:

//  EXEC  PGM=FABBME1,REGION=768K

DD statements

The following table summarizes the DD statements.

Table 1. FABBME1 DD statements
DDNAME Use Format Required or optional
ACBLIB Input PDS Required
RMODLIB Input PDS Required
SYSIN Input LRECL=80 Required
MEDARI Input Required
SYSPRINT Output LRECL=133 Required
MESORTCD Output LRECL=80 Required
MEDARO Output Required

The following table shows space requirements for this JCL stream.

DDNAME Space requirements
MEDARO # segments X (28 + root key length + 4 X # levels) bytes
MESORTCD < 1 track
ACBLIB DD
This statement defines the library that contains the DMB that describes the database configuration to be tuned. This would normally be a testing library, not IMSVS.ACBLIB. For example:
//ACBLIB DD DSN=IMSVS.TEST.ACBLIB,DISP=SHR
RMODLIB DD
This statement defines the library that contains the randomizing routine that is to be used.
SYSIN DD
This statement defines the input control statement data set. This data set can reside on a direct-access device or be routed through the input stream.
MEDARI DD
This statement defines the input data set(s) that contain the sorted and resolved data analysis records. These are the SORTOUT data sets from step SORTR13 of the DEDB Pointer Checker procedure.
Note: Data sets from different DEDB areas can be concatenated in any order. You can process as many areas as desired in a single DEDB Tuning Aid run.
SYSPRINT DD
This statement defines the output message and statistics data set. The data set can reside on a direct-access device or printer or be routed through the output stream. It is recommended that you code the following on your DD statement:

although the following code is also valid: RECFM=FBA,LRECL=133

//SYSPRINT DD SYSOUT=A
MESORTCD DD
This statement defines the output data set that contains the sort control statements required for step SORT13. This data set must reside on a direct-access device.

Space requirements can be satisfied with one track. DCB information is hard-coded in FABBME1. Do not specify DISP=MOD for this DD statement.

MEDARO DD
This statement defines the output data set for the area definition records, the segment definition records, and the segment records. The segment records contain details about the segment such as its RBA. The data set can reside on either a direct-access device or tape. Standard labels must be used for this data set.

The DCB attributes of this file are calculated by FABBME1. The RECFM is VB. For 3380, the default block size is 23476 bytes. For 3390, the default block size is 27998 bytes. For 9345, the default block size is 22928 bytes. For other output devices, the default block size is the maximum block size of the output device. Do not code any other DCB parameters in your JCL.

Space requirements vary depending on the number of segments in the tuned area(s), and the length of the root key. Approximation: size in bytes = number of segments X (28 + root key length + 4 X no. hierarchical levels in DMB). Do not specify DISP=MOD for this DD statement.