ctmdiskspace

The ctmdiskspace utility checks the amount of free disk space on a device and displays the result. The utility returns a failed status if the current free space is below the defined limit.

You can include the ctmdiskspace utility in the Control-M Watchdog process, as described in Watchdog Process Parameters.

Running the ctmdiskspace UtilityLink copied to clipboard

This procedure describes how to run the ctmdiskspace utility, which checks the amount of free disk space on a device and displays the result.

Begin

  1. Do one of the following:

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

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

  2. Run the following command:

    ctmdiskspace -limit <Amount>{%|K|M} -path <Pathname> [-quiet]

ctmdiskspace ParametersLink copied to clipboard

The following table describes the parameters of this command:

Parameter

Description

Amount

Defines the minimum amount of free space on the device—in %, K (KB), or M (MB) units—as a whole number.

-limit 25%

Pathname

Defines the full pathname of the device.

You can define multiple devices in one command, as shown in the following example:

-path <Pathname_1> -path <Pathname_2>

-quiet

Suppresses informational messages from being displayed during the execution of the command.

ctmdiskspace Utility ExamplesLink copied to clipboard

  • The following command returns a failed status if the amount of free disk space in the Control-M user directory is below 25%:

    ctmdiskspace -limit 25% -path /ctm_server/ctmuser

  • The following command returns a failed status if the amount of free disk in the Control-M user directory is below 20M:

    ctmdiskspace -limit 20M -path /ctm_server/ctmuser -path /ctm/tmp