Operator communication with DBCTL: An overview
IMS operations can be done from an IMS main terminal operator console, which is usually the primary z/OS® console. This can be the primary z/OS console, but it is advisable to have a secondary z/OS console that is dedicated to DBCTL. This dedicated console is called the DBCTL console.
You can issue operator commands to DBCTL from a CICS® terminal by using a CICS-supplied transaction, CDBM, as described in CDBM operator transaction.
Use the Resource Access Control Facility (RACF®) to control access to IMS resources. For further information about using RACF, see IMS administration in IMS product documentation.
Summary of DBCTL operator commands
The following tables show you the CICS operator commands, corresponding DBCTL operator commands, and which DBCTL commands can be issued using the CICS-supplied transaction CDBM. Also shown are the IMS operator commands and keywords valid with DBCTL. Administering DBCTL and Recovery and restart operations for DBCTL contain information about using operator commands with DBCTL. For further guidance on the syntax of DBCTL operator commands, see Operations and automation in IMS product documentation.
- The / used in these commands is the default command recognition character (CRC).
- THREAD is a synonym for REGION.
| DBCTL operator command | CICS equivalent | Valid with CDBM |
|---|---|---|
| /CHANGE | None | Yes |
| /CHECKPOINT (simple form) | ACTIVITY KEYPOINT | Yes |
| /CHECKPOINT FREEZE or /CHECKPOINT PURGE | CEMT PERFORM SHUTDOWN | No |
| /CHECKPOINT STATISTICS | CEMT PERFORM STATISTICS RECORD | Yes |
| /DBDUMP | None | Yes |
| /DBRECOVERY | None | Yes |
| /DELETE | None | Yes |
| /DEQUEUE | None | Yes |
| /DISPLAY ACTIVE or /DISPLAY CCTL | CEMT INQUIRE TASK | Yes |
| /DISPLAY DATABASE | None | Yes |
| /DISPLAY DBD, /DISPLAY POOL, and /DISPLAY PSB | None | Yes |
| /ERESTART | SIT with START=AUTO resulting in EMER restart | No |
| /LOCK | None | Yes |
| /LOG | None | Yes |
| /MODIFY | None | No |
| /NRESTART CHECKPOINT 0 | SIT START=INITIAL | No |
| /NRESTART (without CHECKPOINT 0) | SIT with START=AUTO resulting in WARM start | No |
| /PSTOP | None | Yes |
| /RMCHANGE | None | Yes |
| /RMDELETE | None | Yes |
| /RMGENJCL | None | Yes |
| /RMINIT | None | Yes |
| /RMLIST | None | Yes |
| /RMNOTIFY | None | Yes |
| /SSR | None | No |
| /START DATABASE | None | Yes |
| /STOP DATABASE | None | Yes |
| /STOP THREAD | CEMT SET TASK PURGE | Yes |
| /SWITCH OLDS | None | Yes |
| /TRACE SET PI | None | Yes |
| /UNLOCK | None | Yes |
| /VUNLOAD | None | Yes |
| z/OS MODIFY jobname,RECONNECT | CEMT PERFORM RECONNECT | N/A: z/OS command |
| z/OS MODIFY jobname,STOP|DUMP | CEMT PERFORM SHUTDOWN IMMEDIATE | N/A: z/OS command |
| DBCTL operator command | Keyword(s) | Description |
|---|---|---|
| /CHANGE | CCTL, PASSWORD, SUBSYS | |
| /CHECKPOINT | FREEZE, PURGE, ABDUMP, SNAPQ | To stop DBCTL normally and disconnect it from CICS, use the /CHECKPOINT command with the FREEZE or PURGE keywords. See Stopping DBCTL. |
| /DBDUMP | DATABASE | You can use the /DBDUMP command with the DATABASE keyword to prevent programs from updating DL/I full function databases. See Preventing programs and transactions from updating DBCTL databases. |
| /DBRECOVERY | AREA, DATABASE | |
| /DELETE | DATABASE, PASSWORD, PROGRAM | |
| /DISPLAY | ACTIVE, AREA, CCTL, DATABASE, DBD, INDOUBT, MODIFY, OASN SUBSYS, OLDS, POOL, PROGRAM, PSB, SHUTDOWN STATUS, STATUS, TRACE | To find out the status of particular DBCTL activities, use the /DISPLAY command. See Finding out current status of DBCTL activities. |
| /ERESTART | CHECKPOINT, COLDBASE, COLDCOMM, COLDSYS, FORMAT, NOBMP | |
| /LOCK | DATABASE, PROGRAM | |
| /LOG | None | Use the /LOG command to specify any alphanumeric character message to be logged on the IMS log. |
| /MODIFY | ABORT, COMMIT, PREPARE | The /MODIFY command is a part of the online change process used to control the modification of DBCTL resources online. See Changing DBCTL resources online. |
| /NRESTART | CHECKPOINT 0, FORMAT, NOPASSWORD, PASSWORD | |
| /PSTOP | REGION | |
| /RMCHANGE | DBRC modifier | |
| /RMDELETE | DBRC modifier | |
| /RMGENJCL | DBRC modifier | |
| /RMINIT | DBRC modifier | |
| /RMLIST | DBRC modifier | |
| /RMNOTIFY | DBRC modifier | |
| /SSR | Commands and keywords from appropriate subsystem (for example, DB2®) | |
| /START | AREA, AUTOARCH, DATABASE, OLDS, PROGRAM, REGION|THREAD1, WADS | To make DBCTL resources available to refer to and use, use the /START command. See Making DBCTL resources available. |
| /STOP | ADS, AREA, AUTOARCH, DATABASE, OLDS, PROGRAM, REGION|THREAD1, WADS | You can use the /STOP command to stop the scheduling of specific PSBs and the use of a given database. See Preventing scheduling of PSBs and use of DBCTL databases. |
| /SWITCH | OLDS | Specifying /SWITCH OLDS causes the IMS log to switch to the next OLDS. This switch to the next OLDS is marked as a recovery point for log archiving purposes. If you also specify the (optional) CHECKPOINT keyword, IMS issues a simple checkpoint after the active log data set has been switched to the next OLDS. This switch capability is identical to that provided with the DBRECOVERY command, as described in Preventing programs and transactions from updating DBCTL databases and Log control with DBRC. |
| /TRACE | SET, MONITOR, PI, PSB, TABLE | Trace DBCTL events, as described in Controlling tracing of DBCTL events. |
| /UNLOCK | DATABASE, PROGRAM | |
| /VUNLOAD | AREA |