ctmhostgrp

The ctmhostgrp utility is used to maintain and view host groups. This utility provides the command line facility for running the options available from the Host Group Menu.

The Host Group menu is used to maintain and view host groups. Host groups are used by the Control-M/Server load-balancing function. For more information, see Host Groups.

Running the ctmhostgrp Utility

This procedure describes how to run the ctmhostgrp utility, which enables you to maintain and view host groups.

Begin

  1. Do one of the following:

    • UNIX: Log in to a Control-M/Server account

    • Windows: Open a command prompt window where Control-M/Server is installed.

  2. Type the following command:

    ctmhostgrp

    [ -LIST |

    -EDIT -HOSTGRP <hostGroup>

    -APPLTYPE <applicationType>

    [ -VIEW |

    -ADD <hostid> |

    -DELETE <hostid> ] |

ctmhostgrp Parameters

The following table lists the ctmhostgrp utility parameters:

Variable

Description

-LIST

Displays a list of all existing host groups.

-EDIT

Views, creates, or modifies a host group.

 -HOSTGRP

 Specifies which host group to be viewed, created, or modified.

 -APPLTYPE

Specifies the application that the host group is associated with.

Valid values:

  • OS: None Application Add-on

  • SAP: SAP Applications

  • OAP: Oracle Applications

  • Any other application type defined by the user.

Default: OS

  -VIEW

 Displays the host IDs in the specified host group.

  -ADD

Prompts for the name of a host ID to add to the specified group.

The selected host ID must be able to run jobs associated with the application type specified for this host group.

  -DELETE

Prompts for the name of a host ID to delete from the specified group.

-DELETE

Prompts for the name of the host group to delete from the specified group.