Control-M/Server system exit parameters

The # used in each of the following Control‑M/Server system exit parameters represents the corresponding Control‑M/Server utility that can be included in the Control‑M/Server Watchdog process: Disk Space Utility (1) and Database Usage Utility (2).

Parameter

Description

WD_CTMEXIT_#_CMD_LINE

Contains parameters to be passed to the exit script. Arguments must start with a ‘-’ sign. Values separated by either a space or a ‘-’ sign must be enclosed in double quotation. Mandatory.

Valid values: 1024 characters

Default: ""

In the shipped config.dat on UNIX, the default values are overridden as follows:

  • wd_ctmexit_1: -LIMIT "10 M" -PATH ctm_em
  • wd_ctmexit_2: -LIMIT "90 M"

In the shipped config.dat on Windows, the default values are overridden as follows:

  • wd_ctmexit_1: -LIMIT 10M -PATH C:\
  • wd_ctmexit_2: -LIMIT 90

Refresh Type: Recycle

WD_CTMEXIT_#_ERROR_MSG

Error message string to be passed to the error handler(s) if the utility returns a "failed" status. Optional.

Valid values: 1024 characters

Default: "" (In the shipped config.dat, for wd_ctmexit_1 and wd_ctmexit_2, the default is overridden by "Low on database space.")

Refresh Type: Recycle

WD_CTMEXIT_#_INTERVAL

Number of basic time interval units that should pass before reinvoking the exit script. The basic time interval unit is defined in parameter WD_INTERVAL.

For example, if the value of this parameter is 20, and the basic time interval unit (as defined in parameter WD_INTERVAL) is 5 minutes, the exit script will be invoked every 100 minutes (20 x 5 minutes).

Valid values: 1–2^31

Default: 5 (In the shipped config.dat, this is overridden by the value 20.)

Refresh Type: Recycle

WD_CTMEXIT_#_RUN_STATE

Specify whether (Y) or not (N) to run the utility when Control-M/Server is running. A Y must be specified for either this parameter or for parameter WD_CTMEXIT_#_SUSPEND _STATE for the utility to be run.

Valid values: Y, N

Default: N (In the shipped config.dat, this is overridden by the value Y.)

Refresh Type: Recycle

WD_CTMEXIT_#_SCRIPT_FILE

Relative path of the script or binary from the ~controlm\ctm_server\exe_<computer> directory.

Valid values: 1024 characters

Default: "" (In the shipped config.dat, for both wd_ctmexit_1 and wd_ctmexit_2, this is overridden by the value CTMDISKSPACE.)

Refresh Type: Recycle

WD_CTMEXIT_#_SUSPEND_STATE

Specify whether (Y) or not (N) to run the utility in Suspend mode (that is, during New Day procedure or download, when the database inaccessible). A Y must be specified for either this parameter or for parameter WD_CTMEXIT_#_RUN _STATE for the utility to be run.

Valid values: Y, N

Default: N

Refresh Type: Recycle

WD_CTMEXIT_#_TIMEOUT

Time (milliseconds) allowed before the exit script is terminated.

Valid values: 1–2^31 (ms)

Default: 5 ms (In the shipped config.dat, this is overridden by the value 30.)

Refresh Type: Recycle

Parent Topic

Watchdog process parameters