Chapter Contents

Previous

Next
SETRP

SETRP



Set Recovery Parameters in an ESTAE Exit

Portability: SAS/C extension


SYNOPSIS
DESCRIPTION
CAUTION
EXAMPLE
RELATED FUNCTIONS


SYNOPSIS

#include <spetask.h>

void SETRP_DUMP(void *sdwa, dumpopt);

void SETRP_COMPCOD(void *sdwa, unsigned code, sysopt);

void SETRP_REASON(void *sdwa, unsigned reason);

void SETRP_RETRY(void *sdwa, void *retry, fresdwa);


DESCRIPTION

The SAS/C SETRP macros implement the most frequently used functions of the OS/390 Assembler SETRP macro. These macros should be used only in an ESTAE exit. Each macro's first argument is a pointer to the SDWA (System Diagnostic Work Area), which is passed to the exit by the operating system.

SETRP_DUMP overrides the DUMP specification of the original ABEND. dumpopt must be specified as YES or NO to indicate whether or not a dump should be taken.

SETRP_COMPCOD overrides the completion code of the original ABEND. The code argument is the new completion code. The sysopt argument must be specified as either USER or SYSTEM .

SETRP_REASON overrides the reason code of the original ABEND. The reason argument is the new reason code.

SETRP_RETRY specifies the address of an ESTAE retry. The retry argument is the address at which execution of the retry routine is to begin. To retry the ABEND in C code, the retry argument should be a call to the bldretry function, whose first argument is a jump buffer defining the retry point. The fresdwa argument must be FRESDWA or NOFRESDWA and must indicate whether the SDWA should be freed before control is passed to the retry routine.


CAUTION

The SETRP macros should be used only with the Systems Programming Environment (SPE).


EXAMPLE

See the example for ESTAE .


RELATED FUNCTIONS

ESTAE , bldretry


Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.