Communication, start up, and troubleshooting

The communication, startup, and troubleshooting utilities are used to set up communication between Control-M components, start up/shut down Control-M components and entities, and determine if communication between the components is occurring effectively. Various troubleshooting utilities are also included here.

By including a utility command in the command line of a job processing definition, you can run the utility at a predetermined time or under a predetermined set of conditions without being present.

Some of the parameter names changed for Control-M version 8.0.00 and above. Terminology from previous versions is still supported.

Utility	Description

Control-M/Server
ctm_agstat	Lists or updates the status of a Control-M/Agent.
ctm_diag_comm	Generates a report on the connection details of a Control-M/Agent and its remote host computer.
ctmgetcm	Collects and displays Control-M/Agent application information.
ctmhostmap	Manages the mapping of remote hosts to Control-M/Agents and the conversion of Control-M/Agents to remote host computers.
ctm_menu (Agent status)	Converts a remote host to a Control-M/Agent computer
ctmhostgrp	Enables the maintenance and viewing of host groups.
ctmping	Collects configuration information about Control-M/Agents and test communications.
ctmshout	Issues a Shout message to a specified destination.
ctmshtb	Sets the active Shout Destination folder.
ctmspdiag	Prints or erases diagnostics from stored procedures and set or show diagnostic request status of stored procedures.
ctmsuspend	Suspends Control-M/Server scheduling processes for mass uploads/downloads from Control-M/EM.
init_prflag	Resets sleep times and trace levels for Control-M/Server processes.
shut_ca	Shuts down the Control-M/Server Configuration Agent.
shut_ctm	Shuts down Control-M/Server and its processes.
show_ca	Displays the status of Control-M/Server Configuration Agent.
shutdb	Shuts down the SQL database server.
start_ca	Starts up the Control-M/Server Configuration Agent.
start_ctm	Starts up Control-M/Server.
startdb	Starts up the SQL database server.
ctm_pause	Stops Control-M/Server from submitting jobs.
ctmchangeshdir	Changes the shared directory path that is used for the PostgreSQL replication in a high availability environment.
ctm_menu (parameter customization)	Sets the communication mode to persistent between Control-M/Server and Agent.
Control-M/EM
ctl	Checks if Control-M/EM Server components are operational and sends commands.
orbadmin	Manages the Naming Service process and the CORBA configuration file.
Control-M/Agent
ag_diag_comm	Verifies communication between Control-M/Agent and Control-M/Server.
ag_ping	Verifies that Control-M/Server is active on computer connected to a Control-M/Agent.
shagent	Shows if an agent and tracker are running.