gtps1m36System Macros

IDATG-Generate Selective Memory Dump Table Entry

Use this system macro to:

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.