Chapter Contents |
Previous |
Next |
SETRP |
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 |
RELATED FUNCTIONS |
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.