Terminal (Program Port/Telnet) Commands
128
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
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.
