Debugging Facility (DBUG) › Using the Debugging Facility › Specifying Processing Mode

Specifying Processing Mode

The Debugging Facility supports three processing modes. The Terminal Control Table (TCT) must include the terminal ID for any specified remote terminal. Local terminals and remote terminals must be in transceive status, that is to say able to send and receive data.

Note: The DBUG local and remote modes described in the following apply only to DBUG processing and have nothing to do with CICS/MRO environments.

Local Mode

Local mode processing enables you to issue the DBUG transaction to intercept CA Datacom/DB requests from a program. When DBUG intercepts a request, CA Datacom CICS Services DBUG display replaces the display of the program on your terminal.

Remote Mode

Remote mode processing enables you to issue the DBUG transaction from one terminal to intercept CA Datacom/DB requests from a program initiated at a specified remote terminal. This allows you to run an application on one terminal while concurrently viewing CA Datacom CICS Services DBUG displays for that program on your terminal. You can initiate DBUG before executing the program to intercept or at the end of any unit of work during its execution.

Monitor Mode

Monitor mode processing allows the user to monitor who, when and what program is accessing which CA Datacom/DB information. Monitor mode processing intercepts all CA Datacom/DB requests meeting specified criteria issued by any program and routes these interceptions to your terminal.

• Only one terminal can be in monitor mode at a time. It should be a dedicated terminal assigned for use of the DBUG monitor mode function.
• For a terminal that has initiated monitor mode, any subsequent transaction issued from that terminal while monitor mode is still active are not debugged.

For any terminal, a local DBUG interception or a single remote DBUG interception may be requested. A single terminal cannot be intercepted by more than one terminal at a time. When monitor mode is active, no other terminal can have a local or remote DBUG session active.

Only one terminal at a time can activate monitor mode. The authorization to request a monitor mode DBUG or a remote mode DBUG is controlled by the values specified in the MSTOPR= parameter of the DBCVTPR macro. If a list of master operators is specified, then only those operators may initiate a monitor mode or a remote mode DBUG session. If *** is the value of MSTOPR=, any terminal can start monitor mode or remote mode DBUG.

Caution Exercise discretion in your use of monitor mode. If the monitor mode terminal is to be left unattended for a period of time, turn off the monitor mode. A terminal intercepted by the monitor mode terminal receives an INTERCEPTED BY... message and remains in a wait condition until the monitor mode operator presses Enter. While it is in monitor mode, a terminal should not run any conversational tasks.

If in monitor mode or remote mode, CA Datacom CICS Services sends the following message to the intercepted terminal:

 *** YOUR TRANSACTION IS INTERCEPTED BY TERMINAL - XXXX ***