Extensions to dynamic storage

You can extend dynamic storage to provide extra storage for user variables by defining these variables in your source program in a DSECT called DFHEISTG.

24-bit and 31-bit addressing mode

For AMODE(24) and AMODE(31) programs, the maximum amount of dynamic storage obtainable using the DFHEISTG DSECT is 65 264 bytes. DFHEISTG is a reserved name. This storage is initialized to X'00'. At translation, the translator inserts the DFHEISTG macro immediately following your DFHEISTG DSECT instruction. In this way, the DSECT describes dynamic storage needed for the parameter list, for the command-level interface, and for any user variables. At link-edit time, use the STORAGE option of the CEEXOPT macro to ensure that the DFHEISTG storage is initialized to x'00', for example, CEEXOPT STORAGE=(,,00) . Make sure that your application propagates or initializes any constants that are defined in the user DFHEISTG area.

The example in Figure 1 shows a simple assembler language application program that uses such variables in dynamic storage.
Figure 1. Translated code for user variables
Source program
 
DFHEISTG DSECT
COPY DFH$AGA INPUT MAP DSECT
COPY DFH$AGB OUTPUT MAP DSECT
MESSAGE DS CL39
INQUIRY CSECT
EXEC CICS RECEIVE MAP('DFH$AGA')
MVC NUMBO,KEYI
MVC MESSAGE,=CL(L'MESSAGE)'THIS IS A MESSAGE'
EXEC CICS SEND MAP('DFH$AGB') ERASE
END
 
 
This source program is translated to:
 
DFHEIGBL , INSERTED BY TRANSLATOR
DFHEISTG DSECT
DFHEISTG INSERTED BY TRANSLATOR
COPY DFH$AGA INPUT MAP DSECT
COPY DFH$AGB OUTPUT MAP DSECT
MESSAGE DS CL39
INQUIRY CSECT
DFHEIENT INSERTED BY TRANSLATOR
* EXEC CICS RECEIVE MAP('DFH$AGA')
DFHECALL =X'1802C0000800000000040900000020',
(CHA7,=CL7'DFH$AGA*'),(______RF,DFH$AGAI)
MVC NUMBO,KEYI
MVC MESSAGE,=CL(L'MESSAGE)'THIS IS A MESSAGE'
* EXEC CICS SEND MAP('DFH$AGB') ERASE
DFHECALL =X'1804C000080000000004E204000020',
(CHA7,=CL7'DFH$AGB*'),(______RF,DFH$AGBO)
DFHEIRET INSERTED BY TRANSLATOR
DFHEISTG INSERTED BY TRANSLATOR
DFHEIEND INSERTED BY TRANSLATOR
END

64-bit addressing mode

For non- Language Environment® AMODE(64) assembler language programs, the DFHEISTG macro generates an AMODE(64) DSECT. DFHEISTG storage is obtained from 31-bit storage (above 16 MB but below 2 GB), not from 64-bit storage. The maximum amount of dynamic storage obtainable using the DFHEISTG DSECT is 65 264 bytes. This storage is initialized to X'00'.

At translation, the translator inserts the DFHEISTG macro immediately following your DFHEISTG DSECT instruction. In this way, the DSECT describes dynamic storage needed for the parameter list, for the command-level interface, and for any user variables.

CICS® defines the front portion of DFHEISTG storage.

The EIB pointer, DFHEIBP, and the COMMAREA pointer, DFHEICAP, are set up before the DFHEIENT macro returns control to the application program. These pointers are 64-bit pointers in 24-bit or 31-bit storage.



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