DBRCAUTHCMD control statement
Specifies whether Reorganization Manager issues the CHANGE.DB READON or the CHANGE.DB NOAUTH command automatically at the beginning of the reorganization and before data set name swapping.
This control statement is optional. The default is DBRCAUTHCMD=NO.
If you specify DBRCAUTHCMD=YES, Reorganization Manager issues one of the following DBRC commands at the beginning of the reorganization:
- If DBSHARE=YES, CHANGE.DB DBD(name) READON
- If DBSHARE=NO, CHANGE.DB DBD(name) NOAUTH
If you specify CRIC=ALWAYS, CRUNLOAD=ALWAYS, or both, even if DBSHARE=NO is specified, a CHANGE.DB DBD(name) READON command is issued for the database (non-HALDB) or for each HALDB partition (HALDB) that require no reorganization.
If the database to be reorganized is a HALDB partition or partitions, the command is issued for each partition. If it is an entire HALDB, the command is issued for each partition.
The CHANGE.DB READON command changes the READ ONLY flag of the database in RECON, and the database can be authorized only for read processing. The CHANGE.DB NOAUTH command changes the PROHIBIT AUTHORIZATION flag of the database in RECON. Therefore, authorization processing is prohibited for the database.
If one or more errors are detected during reorganization processing, the Smart Reorg utility issues the CHANGE.DB command to restore the READ ONLY flag or the PROHIBIT AUTHORIZATION flag before ending abnormally. For details, see Automated DBRC processing for restoring authorization flags.
The Smart Reorg utility must have exclusive access to the database before doing data set name swapping. If you specify DBRCAUTHCMD=YES, Reorganization Manager automatically issues a CHANGE.DB NOAUTH command immediately before data set name swapping.
If IMSCMD=NO, DBRCAUTHCMD=YES, and AUTHFAIL=ABORT are specified and Reorganization Manager fails to get the required authorization from DBRC, the job is stopped. If IMSCMD=NO, DBRCAUTHCMD=YES, and AUTHFAIL=WTOR are specified, the AUTHFAIL=WTOR option becomes effective after Reorganization Manager fails to get the required authorization from DBRC.
When you specify DBRCAUTHCMD=YES, DBRC must be active and the database must be registered to DBRC.
If you specify DBRCAUTHCMD=NO, it is recommended that you specify AUTHFAIL=WTOR. If you specify DBRCAUTHCMD=NO and you have not issued either the CHANGE.DB READON or the CHANGE.DB NOAUTH command for the database, the AUTHFAIL=WTOR option makes Reorganization Manager issue a WTOR message HPSG0336A stating what type of authorization is required for the database.
If you specify IMSCMD=YES, the DBRCAUTHCMD control statement is ignored and has no effect.