Event code 28 — identify module entry point event
Purpose
This event is used to determine the language of the procedure identified as the entry point of the module. Also, if the entry point is a main procedure, then return an INPL, as defined on the CEEINT CWI call. This INPL is used to initialize an enclave in order to invoke the main procedure.
Syntax
Call CEEEVnnn (28, loadmodptr, entryptr, identified, main, inplptr, loadmodlen)
POINTER *loadmodptr;
POINTER *entryptr;
INT4 *identified;
INT4 *main;
POINTER *inplptr;
INT4 *loadmodlen;- loadmodptr (input)
- The address of the start of the load module.
- entryptr (input)
- The address of the entry point of the load module.
- identified (output)
- A fullword set to one of two values:
- 0
- The procedure is not of the member's language.
- 1
- The procedure is of the member's language.
- main (output)
- A fullword set to one of two values:
- 0
- The procedure is not a main procedure.
- 1
- The procedure is a main procedure.
- inplptr (input/output)
- The address of the INPL to be used to initialize the enclave. Enough storage is provided so that the member can build the INPL within the provided storage, or the member can set the inplptr parameter to point to other storage containing the INPL.
- loadmodlen (input)
- A fullword set to the length of the load module.
Usage notes
- This event is called only when running under CICS®.
- If a member event handler detects an error during this event, it should return with return code 16, and place the reason code for the error in CEECAACICSRSN field of the CAA. Language Environment passes this reason code to CICS.
- If a member event handler detects a non-terminating condition (for example, the INPL cannot be built due to missing csects in the module), it should return with return code 4, and place the reason code for the error in CEECAACICSRSN field of the CAA. Language Environment passes this reason code to CICS and returns control to CICS without further processing.
- CICS SPF: Language Environment calls languages in key 8 for this event. Storage for parameters can be in key 8.