Parameters

ENTER=

Specifies the address of the routine to be called.

When you specify ACALL ENTER=(label,A), the code generates an ADCON to get the address of the routine. When you specify ACALL ENTER=(label,R), the code generates a LARL to get the address of the routine. The "A" or "R" subparameter is not allowed when a register is specified for ENTER=. Below are examples of this usage (lines with "+" are lines generated when the macro expands).

Using the "A" or "R" parameter

Without the "A" or "R" subparameter:

         ACALL ENTER=DMREADIO
+        LA    R15,DMREADIO
+        L     R14,ASAVE
+        BALR  R14,R14

With the "A" subparameter:

        ACALL  ENTER=(DMREADIO,A)
+       L      R15,=A(DMREADIO)
+       L      R14,ASAVE
+       BALR   R14,R14

With the "R" subparameter:

        ACALL  ENTER=(DMREADIO,R)
+       LARL   R15,DMREADIO
+       L      R14,ASAVE
+       BALR   R14,R14

EPLOC=

Specifies the name of a label that contains the address of the routine to be called. If the EPLOC parameter is specified, the EP parameter cannot be specified and vice versa. Below is an example (lines with "+" are lines generated when the macro expands).

Example

VIWRDRTN DC    A(0)          Address of the READ routine

         ACALL EPLOC=VIWRDRTN
+        L     R15,VIWRDRTN
+        L     R14,SAVE
+        BALR  R14,R14

SAVE=

YES: Specifies that entry is to be made through the ASAVE linkage routine, ensuring the integrity of registers 2 through 13.
NO: Specifies that entry is to be made through BALR R14, R15.

TRACE=

YES: The call will be traced in the JES3 trace table.
NO: The call will not be traced in the JES3 trace table.

This parameter is only valid with SAVE= YES.

EOD=

EOF=

NAVAIL=

ERROR=

IPL=

BUSY=

REJECT=

RJPCAN=

NORMAL=

Specifies return points. Only those return points known by the called routine can be specified. Each use of a parameter generates a branch instruction, in order of their appearance as parameters of this macro, following the branch and link to the called routine.