ctmstvar

The ctmstvar utility displays the current value of a variable or function.

UNIX:
- A variable that does not contain a $ sign can be enclosed in single or double quotation marks.
- A variable that does contain a $ sign must be enclosed in single quotation marks.
- A variable that contains a $ sign cannot be resolved if it is enclosed in double quotation marks.

Windows: Variables must be enclosed with double quotation marks.

The $WCALC variable is not supported with the ctmstvar utility.

Viewing a Variable Value Using the ctmstvar Utility

This procedure describes how to run the ctmstvar utility, which enables you to display the current value of a variable or function.

Begin

From an Agent, run the following command:

ctmstvar <orderID> <variableString>

ctmstvar Parameters

The following table lists the ctmstvar utility parameters:

Variable	Description
<orderID>	Defines the Order ID of a job waiting in the Active Jobs database—as displayed in the Job Details window of the Server. The Order ID is a base 36 number. If you want to specify the Order ID here as a base 10 number, prefix the number with an asterisk, and enclose it in quotation marks. Use "0" to indicate no specific Order ID. "*1234"
<variableString>	Describes the variable or string enclosed in quotation.

Variable

Description

Defines the Order ID of a job waiting in the Active Jobs database—as displayed in the Job Details window of the Server. The Order ID is a base 36 number. If you want to specify the Order ID here as a base 10 number, prefix the number with an asterisk, and enclose it in quotation marks.

Use "0" to indicate no specific Order ID.

"*1234"

Describes the variable or string enclosed in quotation.

ctmstvar Examples

The following are examples of the ctmstvar utility commands:

ctmstvar a1 ‘%%$CALCDATE %%ODATE -2’

ctmstvar 0 "%%ODATE"