Locating program data

You might want to look at the data that your application program has in its storage areas.

You must refer to the appropriate programming language information for details of the structure of the acquired storage of the program.

CICS® maintains a pointer to the chain of dynamic storage that an assembler program uses in field TCAPCDSA of the system area of the TCA.

Dumps for C/370 programs

The use of the relevant C/370 registers is as follows:

Register Use
3 In most circumstances, this is the base register
12 Holds the address of the CICS TCA for the C/370 program
13 Holds the address of the register save area

Location of COBOL dumped areas

The dumped COBOL program is in the "program information for the current transaction" section of the dump, and is addressed by the LOAD_POINT parameter on the appropriate LDLD ACQUIRE_PROGRAM exit trace entry.

The register save area INIT1+X'48' (covering registers 0 through 14) should have register 12 pointing to the program global table (PGT), register 13 pointing to the task global table (TGT), and some others to locations in the data area and compiled code of the program storage. If not, a CICS error is indicated.

For each invocation of the COBOL program, CICS copies the static TGT from program storage into CICS dynamic storage (the COBOL area) and uses the dynamic copy instead of the static one. CICS also copies working storage from program storage to the COBOL area, above the TGT. Task-related COBOL areas thus enable the single copy of a COBOL program to multithread as if it were truly reentrant.

The dumped COBOL area

The COBOL area contains the following:
  • The COBOL working storage for the task
  • A copy of the TGT

The TGT is addressed by TCAPCHS in the system part of the TCA. The TGT is used to hold intermediate values set at various stages during program execution. The first 18 words of the TGT constitute a standard save area, in which the current registers of the program are stored on any request for CICS service.



dfhs14i.html | Timestamp icon Last updated: Monday, 5 June 2017