Try TT Now

All Gateways

TTK

Overview

You use TTK to suspend and resume services and programs listed in the ttchron.ini file. To manipulate an application, you must supply TTK with the tag parameter in that program’s section in ttchron.ini.

When you use TTK to suspend a process, the program remains suspended until one of the following occurs:

  • You reboot the TT Gateway
  • TTChron reinitializes (either by editing ttchron.ini, restarting TTChron, or using TTK to reinitialize TTChron)
  • You resume the program using TTK

TTK also enables you to list and reinitialize TTChron and TTK functions.

  • You use the list function to query TTChron for information about programs in rotation. TTK returns the job time schedule and job status (i.e., suspended or disabled).
  • You use the reinitialize function to restart TTChron. All jobs that were suspended then resume as normal (assuming they are scheduled to do so in ttchron.ini).

You run TTK from a command window, and can access the program from any directory on the TT Gateway.

Note

Both the ttchron.exe and ttk.exe install in the following directory:

  • Version 7.7.0 and higher: <root drive>:ttttchron
  • All other versions: <root drive>:ttbin

TTK Syntax

The following command options are available for use when running TTK:

ttk [PORT] [action [definition]]

TTK Command Line Options

Option

Description

PORT

(Deprecated in Version 7.7.0)

Sets the port over which TTK communicates with TTChron. Include this parameter only if TTChron listens on a port other than 1800 (i.e., the data value of the listen_port parameter in ttchron.ini).

Note

As of Version 7.7.0, TTK does not communicate with TTChron via a port. Therefore, TTK no longer requires the PORT command.

action

Sets TTK to execute a specific action. You can only include one action each time you run TTK. You can perform any of the following actions:

  • list: Displays ttchron.ini program information and schedules
  • suspend: Suspends processes as defined by the command’s definition
  • resume: Resumes processes as defined by the command’s definition
  • reinit: Reinitializes TTChron
  • status: Writes callstack data to a report file (.mdmp) for processes defined by the command’s definition.
definition

Defines the section(s) in ttchron.ini on whose process(es) TTK performs the specified action. You can designate sections in ttchron.ini by tag or section_name:

  • tag: Sets the value of the tag parameter in the ttchron.ini section of the process on which you want to perform the specified action. You can include multiple tags, separated by a space. TTK performs the specified action on all sections in ttchron.ini that have at least one of the specified tags. To narrow your section selection, you can include and before the string of tag parameters. Including and sets TTK to execute the specified action only on those sections whose Tag keyword includes all of the specified tags.
  • section_name: Sets the section name of the ttchron.ini section on whose process you want to perform the specified action.

TTK Quick Reference

TTK Quick Reference
CommandDescription
ttk ttk -h ttk /?

Displays TTK usage information

ttk listDisplays ttchron.ini program information
ttk status TAGWrites callstack data to a file named exchange-flavor.mdmp for processes whose TTChron sections have any of the TAG values as a data value in their tag parameter
ttk status section_nameWrites callstack data to a file named exchange-flavor.mdmp for all processes whose TTChron section is named section_name
ttk status and TAG1 TAG2Writes callstack data to exchange‑flavor.mdmp for all processes whose sections have all TAG values included in the command line
ttk suspend TAGSuspends processes whose TTChron sections have any of the specified TAG values as a value in their tag parameter.
ttk suspend section_nameSuspends all processes whose TTChron sections have the specified section_name.
ttk suspend and TAG1 TAG2Suspends all processes whose sections have all TAG values included in the command line.
ttk resume TAGResumes all processes whose sections have TAG as a data value in the tag parameter.
ttk resume section_nameResumes all processes whose TTChron sections have the specified section_name.
ttk resume and TAG1 TAG2Resumes all processes whose sections have all TAG values included in the command line.
ttk reinitReinitializes TTChron
Note

As of Version 7.7.0, TTK does not communicate with TTChron via a port. However, older versions of TTK require users to supply a port assignment at the start of any TTK command when listening on a port other than 1800.