The Domain Manager Control Program or dmctl is a command line tool for interacting with a Domain Manager. “dmctl syntax” on page 153 provides additional information. The dmctl can be used to query, modify, or receive notifications from a Domain Manager.

The tool can do any of the following:

  • Execute commands typed at the command line

  • Execute commands read from a batch file

  • Interactively read commands typed in

    If no batch file or command is specified, dmctl enters an interactive mode in which it prints a prompt and accepts typed user commands. If a batch file is specified, dmctl executes the commands in the batch file. Single commands can also be specified.

    Command names can be abbreviated, usually to the shortest unique prefix. There are exceptions to allow a common command to be typed easily when an uncommon one conflicts with it, and conversely, to prevent the accidental typing of some commands. For example, getE is getEvents. The minimum abbreviation for getEventDescription is getEventD. The quit and exit commands cannot be abbreviated, and shutdown must appear as at least shut. Uppercase letters in command names are shown for clarity only. They can be typed in lowercase, with the same meaning.

    In non-interactive mode, dmctl also accepts commands that subscribe to notifications from the Domain Manager. In that case, dmctl does not return, but continuously waits for notifications and prints them to standard out (stdout).

  • In a command-line mode, the Domain Manager to interact with must be specified with the --server=<name> or -s <name> option.

  • In batch or interactive mode, the Domain Manager to interact with can be specified later with the attach command.