z/OS MVS Programming: Assembler Services Reference ABE-HSP
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


ESTAEX —Extended specify task abnormal exit

z/OS MVS Programming: Assembler Services Reference ABE-HSP
SA23-1369-00

Note: The ESTAEX macro has the same environment, specifications, register information, programming requirements, restrictions and performance implications as the ESTAE macro, with the exceptions that follow.
Parent topic: ESTAE and ESTAEX — Extended specify task abnormal exit

Environment

The requirements for the caller of ESTAEX that are different from ESTAE are:

Environmental factor Requirement
Cross memory mode: Any PASN, any HASN, any SASN
ASC mode: Primary or access register (AR)

Programming requirements

If the program is in AR mode:
  • Issue the SYSSTATE macro with the ASCENV=AR parameter before you issue ESTAEX. SYSSTATE ASCENV=AR tells the system to generate code appropriate for AR mode.
  • User parameters, specified on the PARAM parameter, can be located in any address space.

Restrictions

The caller of ESTAEX cannot have an EUT FRR established.

Syntax

The parameters on the standard form of the ESTAEX macro are exactly the same as for the standard form of the ESTAE macro, except that the SDWALOC31 parameter is available only on the ESTAE macro. The SDWA is always placed in 31-bit storage for an ESTAEX recovery routine, so the parameter is unnecessary for ESTAEX. They are written as follows:

Syntax Description
   
   name name: Symbol. Begin name in column 1.
   
␢ One or more blanks must precede ESTAEX.
   
ESTAEX  
   
␢ One or more blanks must follow ESTAEX.
   
exit addr exit addr: A-type address, or register (2) - (12).
0  
   
   ,CT Default: CT
   ,OV  
   
   ,PARAM=list addr list addr: A-type address, or register (2) - (12).
   
   ,XCTL=NO Default: XCTL=NO
   ,XCTL=YES  
   
   ,PURGE=NONE Default: PURGE=NONE
   ,PURGE=QUIESCE  
   ,PURGE=HALT  
   
   ,ASYNCH=YES Default: ASYNCH=YES
   ,ASYNCH=NO  
   
   ,TERM=NO Default: TERM=NO
   ,TERM=YES  
   
   ,RELATED=value value: Any valid macro keyword specification.
   

Parameters

The parameters are explained under the syntax for the standard form of the ESTAE macro.

ABEND codes

X'13C'

See z/OS MVS System Codes for an explanation and programmer response for the abend code.

Return and reason codes

When control is returned to the instruction following the ESTAEX macro, the return code in GPR 15 and the reason code in GPR 0 might be different from those for the ESTAE macro. The return and reason codes for ESTAEX are listed below.

Hexadecimal Return Code Hexadecimal Reason Code Meaning and Action
00 none Meaning: Successful completion of ESTAEX request.

Action: None.
04 00 Meaning: Program error. ESTAEX OV was specified but ESTAEX CT was performed. No valid ESTAE recovery routine existed.

Action: Correct the environment and either reissue the ESTAEX macro or rerun your program, as appropriate.
04 04 Meaning: Program error. ESTAEX OV was specified but ESTAEX CT was performed. The last ESTAE recovery routine was not owned by the user's RB.

Action: Correct the environment and either reissue the ESTAEX macro or rerun your program, as appropriate.
04 08 Meaning: Program error. ESTAEX OV was specified but ESTAEX CT was performed. The last ESTAE recovery routine was not owned by the user's linkage stack entry.

Action: Correct the environment and either reissue the ESTAEX macro or rerun your program, as appropriate.
04 0C Meaning: Program error. ESTAEX OV was specified but ESTAEX CT was performed. The last recovery routine was not an ESTAE recovery routine.

Action: Correct the environment and either reissue the ESTAEX macro or rerun your program, as appropriate.
08 none Meaning: Program error. The ESTAEX request was not valid.

Action: Correct the request and either reissue the ESTAEX macro or rerun your program, as appropriate.
0C none Meaning: Program error. A recovery routine address equal to zero was specified and either there are no recovery routines for this TCB, the most recent recovery routine is not owned by the caller, or the most recent recovery routine is not an ESTAE recovery routine.

Action: Correct the environment and either reissue the ESTAEX macro or rerun your program, as appropriate.
10 none Meaning: System error. An unexpected error was encountered while the request was being processed.

Action: Rerun your program one or more times. If the problem persists, record the return and reason codes and supply them to the appropriate IBM® support personnel.
14 none Meaning: System error. ESTAEX was unable to obtain storage for a system data area.

Action: Rerun your program one or more times. If the problem persists, check with the operator to see if the installation is experiencing a storage constraint problem.
18 none Meaning: Program error. ESTAEX OV was specified without the TOKEN parameter, but the ESTAE recovery routine was created with the TOKEN parameter. (The TOKEN parameter is available only to programs in supervisor state with PSW key 0-7 or programs that are APF-authorized.)

Action: Correct the environment and either reissue the ESTAEX macro or rerun your program, as appropriate.
1C none Meaning: Program error. ESTAEX was unable to access the input parameter area.

Action: Make sure the parameter area is contained in the primary address space and reissue the ESTAEX macro or rerun your program, as appropriate.
20 none Meaning: Program error. XCTL=YES was rejected because the linkage stack was not at the same level as it was when the RB was created.

Action: Correct the environment and reissue the ESTAEX macro or rerun your program, as appropriate.
24 none Meaning: Program error. A recovery routine address equal to zero was specified, but it was rejected because no ESTAE recovery routines were active for the current linkage stack level.

Action: Correct the environment and reissue the ESTAEX macro or rerun your program, as appropriate.

Go to the previous page Go to the next page

Notices | Terms of use | Support | Contact z/OS | zFavorites



Copyright IBM Corporation 1990, 2014