-C GUI_Server

Indicates that the command is directed to one or more GUI servers. GUI servers handle communications between Control-M/EM GUI workstations and other Control-M/EM components.

-M

Specifies a computer name. This name is used to identify the computer to which the GUI server belongs. -M cannot be used with -all. When -M is specified, the request is sent to the GUI server whose name is equal to the value indicated by -M.

-name

Logical name of the GUI server. If the GUI server is started without specifying -name, the logical name of the GUI server is equal to the host name of the computer where the GUI server is running.

-all

Directs a query or command to all GUI servers. -all cannot be used with -M.

-cmd

Indicates a command to be performed by the GUI server. -cmd cannot be used with -reg.

do_measure

Initiates collection of statistics about the GUI server.

This command cannot be specified with other commands in the same run of the ctl utility.

get_measure

Retrieves statistics from the GUI server and displays them.

This command cannot be specified with other commands in the same run of the ctl utility.

-cmdstr

Specifies a text string to be sent to the GUI server. If the text string contains spaces or tabs, it must be enclosed with double quotation marks (" ").

NOTE: -cmdstr cannot be used with -reg or -cmd.

Valid values include:

REFRESH_LDAP

REFRESH_HISTORY

For more information about the ‑cmdstr parameter, see System configuration.