Keywords

GENMAP options

The GENMAP keyword specifies that each KSDS or BCS data set selected by the EXPLORE command will be formatted into a MAP command, executed as a MAP command, or both.

EXECUTE

specifies that every KSDS or BCS data set selected by EXPLORE will be executed as MAP commands. The output is written to the normal SYSOUT file.

OUTFILE

specifies the Data Definition name (DD name) to use to allocate the output GENMAP file. You must use this option if one of the following is true:

• The output is a Generation Data Set (GDS) and you want to specify a relative GDG. For example: GDG.NAME(+1).
• You want to control the STATUS of the output file. For example: DISP=MOD.

OUTDATASET

specifies the name of the pre-existing output GENMAP data set.

REPORTS

specifies the reports you want to generate. You can specify any of these available reports:

• ALL—generates all of the reports.
• CATLIST—generates a Catalog Listing report. This report is very similar to an IDCAMS LISTCAT report, but with several beneficial formatting modifications and field additions or changes.
• CA-MAP—generates a Control Area Map report. This report produces, for the Data Component, a CA-by-CA report, that illustrates CA splits, free CIs in each CA, potentially unusable CIs, CI utilization, key compression information. and the high-key for each CA.
• FREE-CI—generates a Free CI Distribution report. This report will actually generate a CA Split Distribution report and a Free CI Distribution report. To obtain this information, the command tallies the number of contiguous CA splits that have occurred throughout the object, as well as the number of free CIs in every CA processed. The reports are a summary of how these two free resources are distributed across the object.
• INDEX—generates an Index Structure report. This report provides a key size distribution summary, an Index Component CI size analysis (to assist in determining if potentially unusable Data Component CIs exist), and an Index Component record distribution summary.
• RECOMMENDATIONS—generates a Recommendations report. This report provides various performance tuning and object attribute change recommendations.
• RECORD-SIZE—generates a Record Size Distribution report. This report uses a sampling technique, when processing the object's Data Component, to reduce execution-time overhead, the sampling value may be changed via the SAMPLE keyword. By default, two CIs in every CA will be sampled, and the records therein used. If the sampled CIs contain segments of a spanned record, additional CIs may be processed. This report may aid in developing an appreciation of the average record size; this will help in developing an appropriate CI free space percentage, the potential for records to span CIs and other data.
• STATISTICAL—generates a Statistical Summary report. This report, while it contains a lot of information similar to the IDCAMS LISTCAT, is considerably more useful, as it combines actual object analysis information with the LISTCAT information, to produce information that tells you how the object is really behaving, and what the various attributes are costing you.

HEXKEY

prints the two digit hexadecimal key value along with each line of the character key. This is useful for those application objects that use non-printable characters within the key.

RECORD-COUNTERS

controls the number of counter fields to be established to accumulate, by record length, the number of records found. The default value is 2048. You can specify an integer between 1024 and 99999 (inclusive). These accumulators are used when the Record Sizes report is requested.

SAMPLE

indicates the number of CIs in each data component CA to sample. Specify an integer value between 0 to 99999999. The default is 2.