ctmvar

The ctmvar utility defines, deletes, modifies, and displays the following variables:

Variables in a specific job in a SMART folder
Variable in all jobs in a SMART folder
Named pool variables

You cannot modify variables in sub-folders.

Creating and Editing Variables Using the ctmvar Utility

This procedure describes how to run the ctmvar utility, which enables you to define, delete, modify and display variables.

Begin

From an Agent, run one of the following commands:
- ctmvar -ACTION <action parameters> [ -QUIET ]
- ctmvar -POOL <pool parameters> [ -QUIET ]
- ctmvar -input_file <fullPathFileName>
If the command ends with a backslash, add %%BLANK at the end of the command.

ctmvar -action set -var "%%\prueba" -varexpr \c:\\home\\\test\\%%BLANK

ctmvar Parameters

The following table lists the ctmvar utility parameters.

Parameter	Description
-ACTION	Indicates the action to be performed on the specified variable. The possible actions are: SET: Defines a new variable. When this option is used, parameters -var and varexpr are required for each variable that you want to set. If the variable does not exist in the data center or the specified SMART folder or job, it is created. If the variable already exists, it is updated with the specified value. If a SMART folder specified in the ctmvar utility has been run more than once, the utility updates every instance of that SMART folder in the Active Jobs database. Use the following syntax to set variables: ctmvar -action set -var "%%\<Variable_Name>" -varexpr <variable_value> -var "%%\<Variable_Name>" -varexpr <variable_value> UPDATE_FOLDER_VAR: Updates the value of a local variable at folder level in a specific instance, according to the <smart_folder_orderid> that you define in -FOLDER_ORDER_ID ctmvar -action UPDATE_FOLDER_VAR -VAR <local_variable> -varexpr <variable_new_value> -FOLDER_ORDER_ID <SMART_folder_order_ID>. The var must be without %%\ You can also resolve current function or variable values. The ctmvar utility displays all variables in the data center or the specified SMART folder.
-VAR	Defines the name and location of the variable that the specified action should be applied to. Valid Formats: -var "%%\<SMART_Folder_Name>\<Variable_Name>": Defines a local variable for every SMART folder with the specified name. -var "%%\<Folder_Name>\<Job_Name>\<Variable_Name>": Defines a local variable for a specified job in the relevant folder. -var "<Variable_Name>": Defines a variable name when you update a specific folder with ACTION UPDATE_FOLDER_VAR The <job name> must not belong to a sub-folder. You cannot assign values to the following system variables: %%ODATE and %%$ODATE %%GROUP_ORDID and %%$GROUP_ORDID %%TABLE_ID and %%$TABLE_ID %%FOLDER_ID and %%$FOLDER_ID %%JOBNO %%JOBID %%ORDERID %%SMART_ORDERID and %%$SMART_ORDERID
-VAREXPR	Describes the value to be assigned to the specified variable. Valid Values: String Integer Variable
-FOLDER_ORDER_ID	Determines order id of a specific folder. Only valid when you define UPDATE_FOLDER_VAR.
-QUIET	Suppresses the display of the results.
-input_file	Defines the pathname of a file that contains the utility parameters. In this file, each parameter and its values (if any) are on a separate line with the same syntax they would have on the command line. The -input_file parameter enables you to do the following: Prepare and save files of utility parameters that can be reused. Specify utility input longer than the number of characters allowed in the command line. -input_file ctmvar_parms.txt
-POOL	Indicates the variable action to be performed in the specified named pool. The following are possible actions: SETVAR: Defines new variables or updates existing variables in the specified named pool. When this option is used, parameters -var and value are required for each variable that you want to set. If the variable does not exist in the data center, it is created. If the variable already exists, it is updated with the specified value. The following is the syntax to set variables in a named pool: ctmvar -pool setvar -poolname <Pool_Name> -var <Variable1_Name> -value <variable1_value> -var <Variable2_Name> -value <variable2_value> DELETE: Deletes a named pool from the data center or variables from the specified named pool. The following is the syntax to delete all of the variables in a named pool: ctmvar -pool delete -poolname <Pool_Name> The following is the syntax to delete specific variables in a named pool: ctmvar -pool deletevar -poolname <Pool_Name> -var <Variable1_Name> -var <Variable2_Name> You cannot use wildcards in the name of the named pool or variable that you want to delete. LIST: Lists all named pools in the data center. The following is the syntax to list all named pools: ctmvar -pool list VIEW: Displays the list of variables in the named pool or specific variables in the named pool. The following is the syntax to view the variables in a named pool: ctmvar -pool view -poolname <Pool_Name> The following is the syntax to view specific variables in the named pool: ctmvar -pool view -poolname <Pool_Name> -var <Variable_Name> You can use wildcards in the name of the named pool or variable that you want to view.

ctmvar Examples

The following command assigns the value UP to variable %%CTMSTATUS:

ctmvar -action set -var "%%\CTMSTATUS" -varexpr "UP"
The following command assigns the value 31 to variable %%MONTHDAYS in the folder called PAYROLL:

ctmvar -action set -var "%%\PAYROLL\MONTHDAYS" -varexpr 31
The following command assigns the current value of system variable %%TIME to variable %%AAA:

ctmvar -action set -var "%%\AAA" -varexpr %%TIME
You can get the same result using the -input_file parameter as follows:

ctmvar -input_file var_expr_parms.txt

The referenced file contains the following lines:

-action set

-var "%%\AAA"

-varexpr %%TIME
The format variable %%@varname indicates that the variable should contain a value to be resolved by each job that uses it. In the following example, the command assigns the value %%@TIME to variable %%AAA:

ctmvar -action set -var "%%\AAA" -varexpr %%@TIME
The following command sets the name of the POOL to "test" and assigns the value %%ODATE to the variable A:

ctmvar -POOL SETVAR -POOLNAME "test" -VAR "A" -VALUE "%%ODATE"