What is the procedure to enable or disable debug mode for Control-M/Server processes?

It is recommended to consult with BMC Support first, before setting any debug

A. Interactive Method

1. Log in to Control-M Configuration Manager (CCM) within Control-M/Enterprise Manager.
2. Right-click the target Control-M/Server.
3. Select Control-M Server Debug to review current debug levels.
4. Set the required Debug Level (commonly level 4).
5. Click Apply, then OK to confirm.

B. Command-Line Method (on Control-M/Server)

1. To view current debug levels:

1. Open a command prompt as the Control-M/Server user.
2. Run one of the following commands: "ecaprflag -ACTION LIST"  or  "prf 1 1"
3. Check the last column DIAG_LVL, which indicates the debug level (0 = Disabled).

        PROCNAME PROCID PROCSTAT PSTAT_REQ SLEEP_TIME DIAG_LVL

        RT                 4804        R                R                  30                0

        CE                 170c        R                R                  60                0

        WD               1808        R                R                  360              0

        SU                 3634        R                R                  15                0

        TR                  485c       R                R                  5                  0 

2. Enable Debug on Control-M/Server Processes

1. Open a command prompt as the Control-M/Server user.
2. Run the dbglvl command using the following syntax:

                          dbglvl process_name debug_level [module_number] 

        Examples (commonly debug_level = 4 and module_number = 0):

3. Disable Debug on Control-M/Server Processes 

     Examples: 

C. Debug can also be set via the ctm_menu utility via option 9. Troubleshooting -> 1. Set Diagnostic Levels

D. Enabling Debug may have a great impact on the performance of Control-M/Server

To minimize the performance impact of debugging, enable FAST_DIAG mode by adding the following parameter to ~/ctm_server/data/config.dat and restarting Control-M/Server:

FAST_DIAG=Y

Default Behaviour:

• On UNIX, FAST_DIAG defaults to N.
• On Windows, FAST_DIAG defaults to Y.
• This parameter is not included in config.dat by default; adding it overrides the default setting.

Effect of FAST_DIAG:

• Setting FAST_DIAG to Y on UNIX prevents the application from opening and closing debug log files for every output line.
• This significantly improves Control-M/Server throughput during debugging on UNIX platforms.

Important Considerations:

• After enabling FAST_DIAG, processes must be recycled for the change to take effect.
• Before moving proclog files, shut down Control-M/Server to flush the write buffer and close log files; otherwise, recent debug data may be lost.

Additional Information:

Customers viewing this solution may find value in the following self-help Connect with Control-M video.