AUTHERR
The AUTHERR keyword is valid with the REORG (Reorg function) command.
You can specify this option in a Reorg function global options module or in PLUSIN. The following table describes the keyword.
Table 1. DBRC authorization failure keyword
To do this | Specify this in PLUSIN |
|---|---|
Prompt the operator for assistance if DBRC authorization fails at initialization. | AUTHERR(WTOR) |
Abend with user abend code U0047 if DBRC authorization fails at initialization. | AUTHERR(ABEND) |
Internal default: ABEND | |
The AUTHERR keyword specifies the action the Reorg function takes if DBRC authorization fails during initialization processing. DBRC authorization fails when the database is in use, whether online or in batch. If you specify AUTHERR(ABEND) and DBRC authorization fails, the job terminates with user abend code U0047. No updates are made to the database. When you resolve the reason for the authorization failure, you can restart the job.
If you specify AUTHERR(WTOR) and DBRC authorization fails, the Reorg function sends a message to the operator requesting some action. The operator can schedule a /DBR or /DBD, or cancel the batch job, and issue one of the following replies to let the Reorg function try the authorization again:
- CANCEL causes a user abend U0047.
- RETRY attempts to get the authorization from DBRC. This could lead to another operator request, if authorization fails again. After 10 unsuccessful attempts, the WTOR value automatically changes to ABEND.
The AUTHERR keyword applies only when authorization is checked during initialization processing. The Reorg function always requires exclusive control during the data set name swapping process.
If DBRC is not active, AUTHERR is ignored.
For more information, see DBRC-authorization.
If you specify AOI(YES), the AUTHERR value is forced to AUTHERR(WTOR).
You can set the default value for the AUTHERR option by changing the FRF$GLBL global options module. Sample JCL is in member #FRFGLBL of the sample library.