Product Documentation

c-treeRTG V2 Update Guide

Previous Topic

Next Topic

ctutil -run to execute multiple ctutil commands

This modification introduces new ctutil command -run to execute multiple ctutil commands in a single ctutil run. The -run command takes one parameter which is a command list: a text file containing a list of ctutil commands.

This command provides the ability to execute multiple ctutil commands in a single run to avoid program initialization overhead.

Usage

ctutil -run command_list_file

where:

  • command_list_file is a text file that contains one ctutil command on each line followed by all its required parameters. The ctutil commands start with a dash character, therefore each line that does not begin with a dash (excluding any leading space character) is considered a comment and is ignored.

Example

ctutil -run commands

The text file commands contains the following commands to create a file called custmast using definitions found in custmast.xdd, add records to it from custmast.txt, and link it to SQL. The final line in the file is a comment because it does not begin with a dash:

-make custmast custmast.xdd

-load custmast custmast.txt

-sqlize custmast custmast.xdd ADMIN ctreeSQL

These commands create a file, add records to it, and link it to SQL

Return

The value returned by the ctutil -run if an error occurs executing one of the listed commands is the line number of the command list file containing the failed command.

The return value is 0 if all operations listed in the command list file are completed successfully.

TOCIndex