CELHCASR — call service routines for XPLINK applications

Start of change Language Environment provides the following CWI service to call service routines enabled by way of CEL4RGSR for 31-bit XPLINK applications. End of change

Syntax (for 31-bit)

CELHCASR (rtn_addr, rtn_name, rtn_nlen )

POINTER    rtn_addr;
POINTER    rtn_name;
INT4       rtn_nlen;

CELHCASR

Call this CWI interface as follows:

L     R6,CEECAALEOV-CEECAA(,R12)
L     R6,112(,R6)
BASR  R7,R6
NOP   0,0

rtn_addr (input)

The entry point address of the routine that is about to be entered. This parameter is used by the service routine enabled by way of CEL4RGSR. End of change

rtn_name (input)

The address of the routine name that is about to be entered. This parameter is used by the service routine enabled by way of CEL4RGSR. End of change

rtn_nlen (input)

The length of the routine name. This parameter is used by the service routine enabled by way of CEL4RGSR. End of change

Note:

All the parameters for this CWI should be passed by value rather than by reference.
Language Environment will not check the return code of the service routine enabled by way of CEL4RGSR. It is the user's responsibility to handle all the unexpected scenarios in the service routine.
Language Environment will branch directly to the service routine address provided in sr_addr by way of CEL4RGSR if the service routine has been enabled.
Normally this CWI is used in the case where the performance impact should be minimized, such as delayed debugging, profiling or logging.