ctmgetcm

The ctmgetcm utility is used to collect, store and display application server information from Control‑M/Agents.

  • When the action parameter is set to GET, application server information is collected, stored in a folder in the Control‑M/Server database, and displayed.

  • When the action parameter is set to VIEW, previously stored application server information is displayed.

Control-M information is updated only after ctmgetcm is run, or each time ctmgetcm is reconfigured.

You can also run this utility from ctm_menu, as described in ctm_menu.

Running the ctmgetcm Utility

This procedure describes how to run the ctmgetcm utility, which enables you to collect, store and display application server information from Control‑M/Agents.

Begin

Do one of the following:

  • Type the following command from the command prompt to run the utility interactively:

    ctmgetcm

    You are prompted for the required parameters as if you had selected the View Host ID Details option of the Control-M Main Menu.

  • Type the following command from the command prompt, to run the utility as a single prompt:

    ctmgetcm -HOSTID Agent -APPLTYPE OS -ACTION <get|view>

ctmgetcm Parameters

The following table lists the ctmgercm utility parameters:

Parameters

Description

-HOSTID

Defines the host name of the Agent computer.

-APPLTYPE

Defines the name of the application server, such as SAP.

A wildcard character can be used to specify more than one application:

Specify * to retrieve information for all applications. On Unix, enclose the * in quotation marks "*".

Specify O* to retrieve information for all applications beginning with O (for example, ORA or OS).

OS can be specified to return information about the Application Add-on for the current operating system.

-ACTION

Indicates the action that the ctmgetcm utility should perform.

Valid values:

  • GET: Collect and display updated application information from the specified Control‑M/Agent. The information collected is stored in the Control‑M/Server database.

  • VIEW: Display application server information that was previously collected from the specified Agent computer.

    This action will display only information that was retrieved previously using a GET action.

ctmgetcm Examples

The following are examples of the ctmgetcm utility commands:

Specify the following command to view existing information for all applications on the Control‑M/Agent sahara computer:

ctmgetcm -hostid sahara -appltype "*" -action VIEW

Output similar to the following is displayed:

Copy 
HOSTID        APPLTYPE       APPLVER    CMVER
----------------------------------------------
sahara            ORA        7          2.0.00
sahara            SAP        4.5        2.0.01
sahara            OS         SOLARIS    1.0.00

Specify the following command to view existing information for all applications with prefix O on the Control‑M/Agent sahara computer:

ctmgetcm -hostid sahara -appltype O* -action VIEW

Output similar to the following is displayed:

Copy 
HOSTID        APPLTYPE       APPLVER    CMVER
----------------------------------------------
sahara            ORA        7          2.0.00
sahara            OS         SOLARIS    1.0.00

Specify the following command to update the Control-M/Server database with new information for all applications with prefix O on the Control-M/Agent sahara computer:

ctmgetcm -hostid sahara -appltype O* -action GET

The Control-M/Server database is updated and output similar to the following is displayed:

Copy 
HOSTID        APPLTYPE       APPLVER    CMVER
----------------------------------------------
sahara            ORA        7          2.0.00
sahara            ORA        8          2.0.00
sahara            OS         SOLARIS    1.0.00