IDATB: Build selective memory dump table

Use this system macro as the repository for all information about the selective memory dump table (SMDT).

This macro contains a set of IDATG macro calls, each of which defines a unique parameter and its associated main storage area. The IDATB macro can be used anywhere in the z/TPF system to obtain information about the large data areas defined to the z/TPF system that are not normally included in a dump of system storage.

Last updated

Changed in 2024.
Changed in 2023.
Changed in 2020.
Changed in 2019.
Changed for PUT15 (information only; no code change).
Changed for PUT14.
Changed for PUT13.
Changed for PUT09.
Changed for PUT08.
Changed for PUT07.
Changed for PUT06.
Changed for PUT05.
Changed for PUT04.
Changed for PUT03.
Changed for PUT02.
Changed for PUT00.

Format

label

A symbolic name that can be assigned to the macro statement.

FUNC

Specifies one of four values that can be assigned as follows:

SMDT: Used by copy member CPST of the CCCPSE CSECT to actually construct the selective memory dump table in main storage.
EQUATES: Used by the IDOTB macro and the system initializer (CCCTIN) to generate a set of equates, one for each parameter. It is used by IDOTB so that the assembler will recognize the values specified for the INCLUDE parameter. It is used by the system initializer (CCCTIN) to access the correct SMDT entry for a specific parameter so that the starting and ending address pairs for a particular parameter can be stored in the entry.
EBCDIC: Used by the ZIDOT command processor to construct a table linking EBCDIC values to SMDT index values and uniqueness indicators. The table is mapped by the IDSEBC macro.
DEFAULTS: Used by the ZIDOT command processor to construct a default bitmap with bits already set on for values defined as REQUIRED=YES on the IDATG macro calls.
POST: Used by the diagnostic output formatter (DOF) PPCP.

Entry requirements

None.

Return conditions

None.

Programming considerations

For information about macro register conventions, see Register conventions.
Additions to or deletions from the list of IDATG macro calls in the IDATB macro will cause any ZIDOT overrides that are stored on the online system to be deleted when the z/TPF system is IPLed. When items are added or deleted, clear the existing overrides by entering ZIDOT command with the CLEAR parameter specified. Exercise care when changing DUMMY entries, because there can be hidden dependencies on them.
The following programs must be reassembled whenever IDATG macro calls are added, removed, or changed in any way in the IDATB macro.

When Updating Reassemble Link Edit

IDATB/UDATB CCCTIN
CCUEXT

ICDF

STPP
CPS0

PPCP

CIDP CCCPSE CPS0

CUDP CCCPSE
CCUEXT
CPS0
The IDATB calls required by the z/TPF system are already in place. Normally you do not need to code the IDATB macro explicitly.
User-defined parameters are defined in the UDATB copy member, which is called by the IDATB macro.

When Updating	Reassemble	Link Edit
IDATB/UDATB	CCCTIN CCUEXT ICDF STPP	CPS0 PPCP
CIDP	CCCPSE	CPS0
CUDP	CCCPSE CCUEXT	CPS0

The following parameters are predefined. All parameters defined by IBM® begin with the character I; otherwise, the parameter can begin with any alphabetic character.

Parameter	Description
I1MB	1-MB frames
I1MBUSE	1-MB frames in use
IACN	Current activation number
IAET	RCS asynchronous event table
ICAPT	Low memory (CAPT)
ICCT	Communication configuration table
ICDEPLOY	Common deployment hash table and structures in memory
ICFBLKCH	Coupling facility (CF) support blocks
ICILT	Internal line number table
ICIOLDV	Common I/O (CIO) Idevbks
ICIOLIT	CIO lost interrupt tables
ICIOLMP	CIO logical device map
ICLH	CLH block management tables
ICLHST	CPU loop work information data
ICMNUSE	Common blocks in use
ICNFTBL	BSS CINFC table
ICOMMON	4-KB common blocks
ICORND	All of memory
ICP	Control program (CP)
ICPCM	CCP common area
ICPLC	CCP low core trace blocks
ICPLKMP	CP linkage map
ICPSE	CPSE internal entry trace
ICPSEDUP	System error duplicate dump table
ICPSTCK	Control program (CP) stacks
ICRH	Header areas for the 64-bit standard core resident program area (CRPA) and 64-bit copy-on-write CRPA
ICRPASWP	CRPA sweeper control area
ICRPGM	Header areas for the 31-bit standard CRPA and 31-bit copy-on-write CRPA
ICTKC	Keypoint C (CK8KE)
ICTKM	Keypoint M (MK0CK)
ICTKX	Keypoint X (CX0CK)
ICTK1	Keypoint 1 (CK2KC)
ICTK2	Communications keypoint/ncst
ICTK6	The main storage portion of keypoint 6 (CJ6KP)
ICTK9	Keypoint 9 (CY1K9)
IDBRKPT	Online database reorganization (ODBR) control tables
IDBRRLSC	ODBR – Reorganization lock sequence control table
IDCLS	CLH dispatch control lists
IDCR	Dispatch control record
IDDMFDO	TFPAR DDM FDOCA tables
IEAT	ECB activation table
IECBS	Entry control blocks (ECBs)
IECBUSE	Entry control blocks (ECBs) in use
IEHEAPC	ECB heap control table
IEIT	External interrupt tables
IELDR	E-type loader indicators
IEPLTB	Entry point linkage table (EPLT)
IEPOL	E-type loader policing values
IEVMDAT	ECB virtual memory (EVM) region, page, and segment tables
IFACE	File address compute program (FACE) table
IFGAT	Format-2 global attribute table (FGAT)
IFILESYS	File system storage areas
IFRM	4 KB frames
IFRMUSE	4 KB frames in use
IFTPC	Active FTP client session control blocks
IF2GLOPN	All open format-2 global records for the failing ECB
IGAT	Global attribute table
IGLBLI	High-storage format-1 globals
IIOBS	I/O control blocks
IISG1	I-stream (IS)-shared global area 1
IISG2	I-stream (IS)-shared global area 2
IISG3	I-stream (IS)-shared global area 3
IISG4	I-stream (IS)-shared global area 4
IIST	I-stream (IS) status table
IIUG1	I-stream (IS)-unique global area 1
IIUG2	I-stream (IS)-unique global area 2
IIUG3	I-stream (IS)-unique global area 3
IIUG4	I-stream (IS)-unique global area 4
ILCPT	Low core patch area
ILOADERS	Loaders data
ILODI	LODIC tables
ILRT	Link routing table
IMFST	Module file status table
IMFT	1 MB frame control table
IMPIF	Multi-processor interconnect facility (MPIF) control tables
IPAT	PAT
IPATHSH	PAT hash table
IPATXTP	E-type loader extra PAT entries
IPI1DT	Processor ID table
IPLMT	Pool management table
IPOOL	Pool directories
IPREALL	Preallocated ECB private area, preallocated ECB heap, and preallocated application stack.
IRCSB	Record cache subsystem (RCS) subsystem status table base
IRCSH	RCS subsystem status table header
IRCSO	RCS subsystem status table overflow
IRHT	Record hold table (RHT)
IRIAT	Record ID attribute table (RIAT)
ISAFECP	IBM Copy Services Manager tables
ISHEAPCT	System heap storage control tables
ISMDT	Selective memory dump table (SMDT)
ISNA	System Network Architecture (SNA) tables
ISNAPDUP	SNAPC error duplicate dump table
ISNL	SNA local element bit map
ISNPT	System ordinal number pointers
ISNTB	Obsoleted in 2020.
ISTP	Server Time Protocol (STP) clock work area (mapped by data area SC0TM EXT=YES)
ISVMDAT	System virtual memory (SVM) region, page, and segment tables
ISWBS	System work blocks (SWBs)
ISWBUSE	System work blocks (SWBs) in use
ITAPE	Tape status table
ITAR	z/TPFAR tables
ITCP	TCP/IP native stack support tables
IUNIXTBL	UNIX domain socket control table
IUSREXT	User exit table
IVAA	Virtual address area table
IVFACTL	Virtual file access (VFA) control tables
IVFARSIT	VFA record sharing hash table (RSHT) initialization table
IVFAPPGE	VFA RSHT patch pages
IWGTA	WGTA tables
IWODMG	z/TPF high speed connector group control blocks
IWODMS	z/TPF high speed connector socket control blocks
IWRT	E-type loader working record table
IXID	Exchange identification (XID) I/O trace table.
IXWBCLH	CLH block management table for XWBs
IXWBS	Extended system work blocks (XWBs)
IXWBUSE	XWBs in use

Examples

The following example builds the selective memory dump table (SMDT).
```
IDATB FUNC=SMDT
```
The following example builds the EBCDIC keyword table.
```
IDATB FUNC=EBCDIC
```
The following example makes keyword equates available.
```
IDATB FUNC=EQUATES
```
The following example defines the default bit map.
```
IDATB FUNC=DEFAULT
```