SYNCHX - Take a synchronous exit to a processing program

The SYNCHX macro provides the same function as the SYNCH macro. All parameters on the SYNCH macro are valid for the SYNCHX macro.

SYNCHX is intended for use by programs running in AR mode.

Note: The SYNCHX macro has the same environment specifications, register information, programming requirements, restrictions and limitations, performance implications, and return and reason codes as the SYNCH macro, except where noted below.

Environment

The SYNCHX macro can be used by callers in AR or primary ASC mode.

Programming requirements

If your program is in AR mode, (1) issue the SYSSTATE ASCENV=AR macro before you issue SYNCHX, and (2) initialize AR 1 to zero.

Register information

When control returns to the caller, the access registers (ARs) contain:
Register
Contents
0-13
Unchanged
14-15
Used as work registers by the system

Syntax

The SYNCHX macro is written as follows:

Syntax Description
   
   name name: Symbol. Begin name in column 1.
   
One or more blanks must precede SYNCHX.
   
SYNCHX  
   
One or more blanks must follow SYNCHX.
   
entry point addr entry point addr: RX-type address,
  or register (2) - (12) or (15).
   
   ,RESTORE=NO Default: RESTORE=NO
   ,RESTORE=YES  
   
   ,AMODE=24 Default: AMODE=CALLER
   ,AMODE=31  
   ,AMODE=64  
   ,AMODE=DEFINED
Note: AMODE=DEFINED can only be specified if the entry point is provided in a register. AMODE=DEFINED can only be used to SYNCHX to amode 24 and amode 31 programs.
   ,AMODE=CALLER  
   

Parameters

The parameters are described under the syntax of the standard form of the SYNCH macro. If AMODE=64 is specified, the requested program will receive control in 64-bit addressing mode.