Skip to Content

MAP Statement

MAP statement syntax

MAP



ENQ=NO|RESERVE|YES


,FROMDD=DISK1|ddn


,HILIGHT=NO|YES


,LINECNT=58|nnn


,MAPFORMAT=EAV|NEW|OLD


,MAPS=EXTENTS|FREESPC|SUMMARY


,STORGRP=[storg|(storg,…,storg)]|VOL=[vol|(vol,…,vol)]

MAP statement

The MAP statement is used to generate a map of DASD volumes. You may map either one or more online DASD volumes or the backup of one DASD volume from an FDR full-volume backup data set. Full VTOC error checking is performed in either case. The input device, whether DASD or FDR backup, is never altered in any way.

MAP statement operands

ENQ=
NO

Specifies that CPK not enqueue the VTOC.

RESERVE

Specifies that CPK issue an ENQUEUE/RESERVE against the VTOC on the volume being mapped.

YES

Specifies that CPK enqueue the VTOC for the duration of the MAP (but not RESERVE it).

Warning

Important

If ENQ=YES is coded on a shared DASD system or if ENQ=NO is coded on any system, CPK may produce incorrect results or go into a loop if data sets are allocated or scratched during the MAP. Since the RESERVE is a short duration for a MAP, we don't recommend overriding the default.

Default: RESERVE. ENQ= is ignored if mapping an FDR backup.

FROMDD=

ddn

Specifies the ddname of the DD statement pointing to the input device. In order to map an FDR backup residing on a DASD backup file (not tape), you must specify FROMDD=TAPEx, otherwise, CPK maps the volume on which the backup resides instead.

Default: DISK1.

HILIGHT=

NO

Specifies no highlighting.

YES

Specifies that CPK will highlight certain data on the maps in order to make it stand out. This is done by overprinting the line three times.

Warning

Important

When formatting for a display terminal or a laser printer, we suggest you specify NO highlighting.

Default: YES, unless overridden in the FDR option table.

LINECNT=
LC

nnn

Specifies the number of lines COMPAKTOR is to print per page, from 10 to 999.

Default: 58, unless overridden in the FDR option table.

MAPFORMAT=
EAV

Specifies that the EAV map format for the BEFORE and AFTER maps is used that supports 7-digit cylinder numbers to accommodate EAV volumes and 8-digit numbers for the extent length. With MAPFORMAT=EAV, the “M” (millions) suffix is used for fields in the combined summary reports when values exceed 999,999.

NEW

Specifies that a new format for the BEFORE and AFTER maps is used that supports 5-digit cylinder numbers to accommodate very large DASD volumes such as the 3390-9.

OLD

Specifies that the old map format, with 4-digit cylinder numbers and 5-digit relative track numbers, is to be used. If MAPFORMAT=OLD is specified for the large DASD volumes, inaccurate cylinder and track numbers may be printed.

Default: EAV for EAV volumes, NEW for DASD volumes with over 65,535 tracks (such as the 3390-9), and OLD for all other DASD volumes.

Warning

Important

An Extended Address Volume (EAV) is by definition 65,521 cylinders or larger. The maximum size of a volume is 1 terabyte with z/OS V1R13 or higher.

MAPS=

Specifies which maps are to be printed on SYSMAP.

EXTENTS

Specifies that a full track/extent map plus a summary report is desired.

FREESPC

Specifies that CPK is to print only free areas.

SUMMARY

Specifies that only a summary report is produced.

Default: EXTENTS.

STORGRP=

storg

Specifies the names of one or more (up to 20) SMS storage groups. COMPAKTOR interfaces to SMS to obtain all of the DASD volume serials that are defined to each of the specified storage group names, and processes them as if VOL= operands were specified for them.

The syntax for STORGRP= is the same as for VOL= as documented below. You may specify a single storage group, a list of groups, and/or a “group” of group names (for example, STORGRP=DB*). You cannot specify STORGRP= and VOL= in the same run.

Success

Tip

Depending on the number of volumes selected when using wild-cards, it may be better to separate the specifications into multiple jobs since the MAP function processes each volume serially.

VOL=

vol

Specifies the DASD volume serials that COMPAKTOR dynamically allocates and maps. FROMDD= and VOL= may not both be specified. If VOL= is specified, there must not be a DISK1 DD statement in the COMPAKTOR JCL.

A single volume serial may be specified as VOL=volser or multiple volume serials may be specified:

  • A list of volume serials may be given, enclosed in parentheses, up to a maximum of 255, for example, VOL=(TSO001,TSO002,TSO003)
    COMPAKTOR maps the volumes in the order specified.
  • A volume group may be specified by placing an asterisk at the end of the VOLSER prefix, for example, VOL=TSO*
    Within that group, COMPAKTOR maps the volumes in the order that their UCBs exist in the operating system.
  • The two may be combined, for example, VOL=(TSO*,PROD*,ABC001)
    Each group is mapped in the order described above before going on to the next group or volume.
  • All online DASD volumes may be selected by VOL=*
    COMPAKTOR maps the volumes in the order that their UCBs exist in the operating system.

COMPAKTOR does not check for duplicate volume serials, so volumes selected more than once are mapped more than once.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Compuware FDR 5.04