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 specified limit.

The ctmdiskspace utility can be included in the Control‑M Watchdog process. For more information, see Watchdog process parameters.

Running the ctmdiskspace Utility

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 window where Control-M/Server is installed.

2. Type the following command:

   ctmdiskspace -limit <amount>{%|K|M} -path <pathName> [-quiet]

ctmdiskspace Parameters

The following table describes the parameters of this command:

Parameter	Description
amount	Specifies the minimum amount (%, K, or M) of free space on the device as a whole number. -limit 25%
path_name	Specifies the full path name of the device. Multiple devices can be specified on the command line.
-quiet	Suppresses informational messages from being displayed during the execution of the command.

More than one -path <pathName> statement can be specified for each run of the ctmdiskspace utility.

ctmdiskspace Utility Example

• 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