Use this system macro to:
- Map a user-defined parameter to a particular region of main
storage. The parameter identifies main storage regions for inclusion in
dumps through the IDOTB macro, the ZIDOT command, or in every dump
(REQUIRED=YES).
- Identify very large data areas that are not needed in every dump.
The areas identified by the IDATG macro will not be dumped, unless a dump
override is created for a particular system error that requests that a storage
area be included.
This macro is only coded within the IDATB or UDATB macros. It is
never used in open code. Each IDATG call results in the creation of a
selective memory dump table (SMDT) entry in the CPST copy member of the CCCPSE
CSECT.
See IDOTB-Dump Override Table Build for more information about the IDOTB macro. See IDATB-Build Selective Memory Dump Table for more information about the IDATB
macro. See TPF Operations for more
information about the ZIDOT command.
Format
- KEYWORD
- Required. Specify one of the following:
- keyword
- Identifies the area of main storage. The value specified can be no
longer than 8 alphanumeric characters, and the first character must be a
letter.
- DUMMY
- This form of the macro generates a dummy SMDT entry that will be available
for use when creating temporary keywords using the ZIDOT command. The
number of KEYWORD=DUMMY calls determines how many temporary keywords can be
created. If DUMMY is coded no other parameters are allowed.
- LOC=(staddr,endaddr [,...])
- Required. The starting address and ending address of the storage
area. If the area resides in the control program (CP), an address may
specified as either a VCON or an ADCON. If the area resides outside of
the control program (CP), the addresses must be specified as ADCONs -
A(0),A(0) - and code must be added to CCCTIN to store the starting and ending
addresses of the storage area in the Selective Memory Dump Table Entry.
Multiple pairs of starting/ending addresses may be specified, unless the
UNIQUE parameter is coded.
- Note:
- If WXTRNs are required they must be included in the IDATB macro. See IDATB-Build Selective Memory Dump Table for more information about the IDATB macro.
- TEXT=descriptor
- Required. A text description of the storage area. This is
displayed in the dump, and in ZIDOT command responses. The description
is limited to 36 characters, and must not contain control characters.
- FORMAT
- Optional. One of four possible values which specifies how the data
in the area of storage being defined should be formatted in the dump.
Valid parameters are:
- HEX
- Format the data in hex.
- EBCDIC
- Convert the data to printable characters.
- DOUBLE
- Format data in hex, followed by a second line in EBCDIC.
- BOTH
- Format data in both hex and EBCDIC on the same print line. Causes
printing of dump labels to be suppressed.
The default is FORMAT=HEX.
- UNIQUE
- Optional. Specifies that multiple copies of the storage area exist,
as follows:
- SS
- Generate multiple selective memory dump table entries for this keyword,
one for each subsystem.
- IS
- Generate multiple selective memory dump table entries for this keyword,
one per I-stream.
- BOTH
- Generate multiple selective memory dump table entries for this keyword,
one for each I-stream and subsystem.
There is no default.
- Note:
- This keyword cannot be coded if control program (CP) VCONs are used to
identify the storage area or if more than one pair of start/end addresses was
coded on the LOC parameter.
- REQUIRED
- Optional. Specify one of the following:
- YES
- This storage area is unconditionally included in all dumps.
- NO
- The area only appears in a given dump if an override has been created for
the dump via the IDOTB macro or ZIDOT command.
The default is REQUIRED=NO.
Entry Requirements
None.
Return Conditions
None.
Programming Considerations
The IDATG calls need not be coded in ascending address order. The
initializer program will sort the SMDT entries according to whether the data
areas are present in the user's configuration.
Examples
IDATG KEYWORD=I-CP, the control program
FORMAT=HEX, format in hex
LOC=(V(CPMEXR),V(CPLKM2)), start/end addresses
TEXT='CONTROL PROGRAM' text for display
IDATG KEYWORD=DUMMY reserve some dummy entries
IDATG KEYWORD=DUMMY
IDATG KEYWORD=DUMMY
IDATG KEYWORD=I-MFST, Module File Status Table
FORMAT=BOTH, format hex and EBCDIC
LOC=(A(0),A(0)), CCCTIN will initialize
TEXT='MODULE FILE STATUS TABLE', text for display
UNIQUE=SS TPF subsystem unique
- Note:
- All parameters defined by IBM begin with the character I.