z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


SYNCHX - Take a synchronous exit to a processing program

z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO
SA23-1375-00

The SYNCHX macro allows a program running in primary or AR mode to take a synchronous exit to a processing program. This macro is the same as the SYNCH macro, except that, for callers in AR mode, it generates code and addresses that are appropriate in AR mode. All parameters on the SYNCH macro are valid for the SYNCHX macro.

You can issue the SYNCHX macro in 64-bit addressing mode. However, AMODE=DEFINED can only be used to SYNCHX to amode 24 or amode 31 programs.

Before you issue the SYNCHX macro, issue the SYSSTATE ASCENV=AR macro to tell the SYNCHX macro to generate code appropriate for AR mode.

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  
   
   ,KEYADDR=addr addr: RX-type address, or register (2) - (12).
   ,KEYADDR=NOKEYADDR Default: KEYADDR=NOKEYADDR (The key in the TCB is used.)
   
   ,STATE=PROB Default: STATE=PROB
   ,STATE=SUPV  
   
   ,KEYMASK=addr addr: RX-type address, or register (0) - (12).
   ,XMENV=addr addr: RX-type address or register (0) - (12).
   
   ,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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014