User guide

Chapter 2 - RATC
18 Version 1.7.2.0 March 27, 2015
RATC1 commands are not case-sensitive, but the password string is case-sensitive (as per the
MediaMatrix security model). RATC1 commands are, however, presented here with mixed
case to improve readability.
Control codes other than CR in the command line are ignored, except for the following two
exceptions: ASCII BS (backspace) is supported to make using telnet more reasonable; and the
telnet option control escape sequence protocol is automatically dealt with (all telnet option
requests are refused by the RATC1 service).
Name
ASCII
Name
C++
Name
Decimal Value
Hexadecimal
Value
carriage return
CR
\r
13
D
newline
NL or LF
\n
10
A
alert
BEL
\a
7
7
backspace
BS
\b
8
8
RATC1 commands and responses are designed to be compatible with two use scenarios:
computer control with a software application and human control with telnet. To aid in the text
parsing required for computer control, the non-error responses all have a unique first character,
and the error responses all have an ASCII BEL character followed by a unique character.
Change groups
If the client software will be required to monitor a large number of control alias values, the
Change Group commands can be used to maximize efficiency. By issuing a single command,
you can detect whether any individual controls in a group of controls have changed.
When a control alias is added to the change group, it is considered initially changed, and you
can retrieve its value by issuing a get command. You can define multiple change groups using
RATC2.
At the initial connect, and after each subsequent deploy or emulate, there will be no change
groups, because they are cleared between deployments. If there are no change groups assigned
when a Change Group Get command is received, a default change group will be created (but
containing no controls), so the response would show zero changes. It is not necessary for the
client software to clear the change group before disconnecting – this is done automatically by
the MediaMatrix node.
RATC1 commands
help Command
Usage
As an aid in the telnet operation of RATC1, the following command will result in a helpful
display listing the RATC1 command set
help\r