The XCTLX macro performs the same function as XCTL: it causes control to pass to a specified entry name in another load module, the target module. XCTLX is intended for use by programs running in access register (AR) mode. Programs running in primary mode can also use XCTLX.
If your program runs in AR mode, before you issue the XCTLX macro, issue the SYSSTATE ASCENV=AR macro to tell the XCTLX macro to generate code appropriate for AR mode.
The XCTLX macro is written as follows:
| Syntax | Description |
|---|---|
| name | name: Symbol. Begin name in column 1. |
| ␢ | One or more blanks must precede XCTLX. |
| XCTLX | |
| ␢ | One or more blanks must follow XCTLX. |
| (reg1), | reg1 and reg2: Decimal digits in the order 2 through 12. |
| (reg1,reg2), | |
| EP=entry name | entry name: Symbol. |
| EPLOC=entry name addr | entry name addr: A-type address or register (2) - (12). |
| DE=list entry addr | list entry addr: A-type address, or register (2) - (12). |
| ,DCB=dcb addr | dcb addr: A-type address, or register (2) - (12). |
| ,LSEARCH=NO | Default: LSEARCH=NO |
| ,LSEARCH=YES | |
The parameters are described under the syntax of the standard form of the XCTL macro.