Commands and Responses

Each RATC1 command is an ASCII text string terminated with an ASCII CR. Each command results in a response from RATC1. Except during login, RATC1 will send no unsolicited data to a client. Each response from RATC1 is an ASCII text string terminated with both an ASCII CR and NL character. Each response that indicates an error in the input command line is preceded by an ASCII BEL character.

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.

See also

Introduction

Allowing RATC to be used on a MediaMatrix node

Change groups

RATC1 commands

RATC1 responses