Specifications
Terminal (Program Port/Telnet) Commands
118
NX-Series Controllers - WebConsole & Programming Guide
Telnet Diagnostics Commands
The following Telnet Diagnostics Commands provide visibility to remote Masters, in order to determine the current state
of operations, and are provided as diagnostic/troubleshooting tools.
While these commands are available for any user to execute, their output is interpretable primarily by an AMX Technical
Support Engineer.
Logging Out of a Terminal Session
CAUTION!: It is very important to execute the 'logout' command prior to disconnecting from a Master.
Simply removing the RS-232 connector from the Program Port maintains your logged-in status until you either return to
logout via a new session or reboot the target Master.
Notes on Specific Telnet/Terminal Clients
Telnet and terminal clients will have different behaviors in some situations. This section states some of the known
anomalies.
Windows Client Programs
Anomalies occur when using a Windows™ client if you are not typing standard ASCII characters (i.e. using the keypad
and the ALT key to enter decimal codes). Most programs will allow you to enter specific decimal codes by holding ALT
and using keypad numbers.
For example, hold ALT, hit the keypad 1, then hit keypad 0, then release ALT. The standard line feed code is entered
(decimal 10). Windows will perform an ANSI to OEM conversion on some codes entered this way because of the way
Windows handles languages and code pages.
The following codes are known to be altered, but others may be affected depending on the computer's setup.
Characters 15, 21, 22, and any characters above 127.
This affects both Windows Telnet and Terminal programs.
Linux Telnet Client
The Linux Telnet client has three anomalies that are known at this time:
A null (\00) character is sent after a carriage return.
If an ALT 255 is entered, two 255 characters are sent (per the Telnet RAFT).
If the code to go back to command mode is entered (ALT 29 which is ^]), the character is not sent, but Telnet
command mode is entered.
Telnet Diagnostics Commands
Command Description
PHYSICAL STATUS This command reports the current state of the Master’s Status, Output and Input LEDs, in
order to troubleshoot a remote Master. For example, if PHYSICAL STATUS indicates that the
Input LED always shows ‘1’ (or ON), it could indicate that the Master is being hammered by
incoming events.
MSG STATS This command collects messages statistics for the Interpreter over a 10 second period by
calculating the number of event messages that have been processed. This can be useful as a
debugging/diagnostics tool to determine if the NetLinx Interpreter is running and how many
messages it’s processing.