Assembler macros
Language Environment provides the following macros to assist in the entry and exit of assembler routines, to map the CAA and DSA, to generate the appropriate fields in the program prolog area (PPA), to create assembler DLLs, and to use DLLs from assembler routines:
- CEEENTRY generates a Language Environment-conforming prolog. You must use CEEENTRY in conjunction with the following macros, except for CEELOAD. (See CEEENTRY macro— Generate a Language Environment-conforming prolog for syntax.)
- CEETERM generates a Language Environment-conforming epilog and terminates the assembler routine. (See CEETERM macro — Terminate a Language Environment-conforming routine for syntax.)
- CEECAA generates a CAA mapping. (See CEECAA macro — Generate a CAA mapping for syntax.)
- CEEDSA generates a DSA mapping. (See CEEDSA macro — Generate a DSA mapping for syntax.)
- CEEPPA generates the appropriate fields in the PPA in your assembler routine. The fields describe the entry point of a Language Environment block. (See CEEPPA macro — Generate a PPA for syntax.)
- CEELOAD loads a Language Environment-conforming assembler routine; the target of CEELOAD must be a subroutine. (See CEELOAD macro — Dynamically load a Language Environment-conforming routine for syntax.)
- CEEFETCH dynamically loads a routine and returns information about a routine. (See CEEFETCH macro — Dynamically load a routine for syntax.)
- CEEFTCH generates a FTCHINFO mapping. (See CEEFTCH macro — Generate a FTCHINFO mapping for syntax.)
- CEEGLOB is used to extract the Language Environment® product information at assembly-time. (See CEEGLOB macro — Extract Language Environment product information for syntax.)
- CEERELES dynamically deletes a routine. (See CEERELES macro — Dynamically delete a routine for syntax.)
- CEEPCALL calls a Language Environment-conforming routine. It is similar to the CALL macro, except that it supports dynamic calls to routines in a DLL. (See CEEPCALL macro — Pass control to control sections at specified entry points for syntax.)
- CEEPDDA defines a data item in WSA, or declares a reference to an imported data item. (See CEEPDDA macro — Define a data item in the writeable static area (WSA) for syntax.)
- CEEPLDA returns the address of a data item defined by CEEPDDA. It is intended to be used to get the address of imported or exported variables residing in the Writeable Static Area (WSA). (See CEEPLDA macro — Returns the address of a data item defined by CEEPDDA for syntax.)
For a description of Assembler macros to assist in writing XPLINK assembler routines, see z/OS XL C/C++ Programming Guide.
Note: All keyword parameter values, such as YES, NO, ANY, must be
specified in upper case. for example, MAIN=YES, AMODE=ANY.