Storage for the transaction

A set of work areas is required during the lifetime of any task that includes one or more programs supported by Language Environment. This set is known as the “language interface work area”.

The language interface work area contains storage for the following:
  • The largest possible Language Environment interface parameter list (currently 15 parameter elements, but with space allowed for a further three elements)
  • A general-purpose register save area for use by DFHAPLI
  • A general-purpose register save area for use by Language Environment
  • A 240-byte special work area for use by Language Environment as the equivalent of DFHEISTG for CICS
  • A 4-byte Language Environment reason code field
  • The IOINFO area (see IOINFO)
  • The PGMINFO1 area (see PGMINFO1)
  • The program termination block (see Program termination block).
Also, a thread work area is required if Language Environment is involved in the running of the task. The length of a thread work area is a constant value that is notified to CICS by Language Environment during the partition initialization processing. This additional work area is built contiguous with the language interface work area if the transaction is known to contain one or more programs that use Language Environment. When such a program is first encountered, DFHAPLI:
  1. Gets from the transaction manager the address of the transaction-related instance data.
  2. Flags the data to tell the transaction manager that the transaction runs Language Environment application programs.
  3. Adds the length of the language interface work area to the total user storage length for that transaction.
This forces the transaction manager to acquire extra storage, during task initialization, as an extension to the language interface work area. For the first occurrence only, DFHAPLI acquires the thread work area.

Further areas known as run-unit work areas (RUWAs) are required at run time if the transaction includes one or more programs that use Language Environment. The length of an RUWA varies for each program. The lengths required for work areas above and below the 16MB line by Language Environment are notified to CICS during the processing to establish ownership type for that program; thereafter they can be found in the program’s installed resource definition. CICS adds to the length for the RUWA above the 16MB line a fixed amount for its own purposes before acquiring the storage.



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