DIAG T[erminal] [ Troubleshooting Terminal, Printer, and Serial Device Connections ] MPE/iX 5.0 Documentation
Troubleshooting Terminal, Printer, and Serial Device Connections
DIAG T[erminal]
Determines if the connection between a DTC port and a terminal is
functioning properly. TermDSM writes a line of characters to the
terminal and orders it to send that line back. TermDSM then compares the
characters received with those sent.
Security level: 2.
Syntax
________________________________________________________________________
| |
| |
|T[ERMINAL] dtcnum, cardnum, portnum |
________________________________________________________________________
Parameters
dtcnum
The number TermDSM associates with a particular DTC. The DTC command
lists each DTC with its assigned number. This list is also printed when
you make a mistake while typing in a DTC number.
cardnum
Number of the interface card within the DTC to which the device is
connected. The cards are numbered from zero beginning at the bottom of
the DTC.
Range: 0 - 5
portnum
Number of the port on the interface card. As you face the back of the
DTC, the ports are numbered from zero beginning at the left of the board.
Range: 0 - 7 for direct connections.
0 - 5 for modem connections.
Description
When the subcommand is entered the following question is asked:
Do you want to stop looping if an error is found (yes/no)?
If you answer yes, the series of diagnostics will stop if an error is
encountered. For example, you specified you want the write/read
operation to run 10 times and an error is encountered in the third test.
If you answered yes to the above question, the remaining seven write/read
operations will not be run. If you answered no, all 10 write/read
operations will be executed regardless of the results of each test. The
following is then printed on the terminal:
Please connect and make ready (power on, remote mode,
etc.) a supported terminal, before answering the
"How many times?" question. (TDSM 114)
How many times do you want to repeat this operation?
You should prepare the terminal and then enter how many times you want to
run this diagnostic function. Enter a number between 1 and 65535. The
following is then displayed:
Type CONTROL_Y to stop the looping.
Any time that you want to stop the diagnostic, press CTRL-Y. The
diagnostics prompt will be printed and you will be allowed to enter
another subcommand.
This diagnostic function tests the connection between the DTC port up to
and including some terminal functions. (It is not a thorough terminal
test.) It does this by writing a string of characters to the terminal
and ordering the terminal to send those characters back for comparison.
The string of characters sent by TermDSM is preceded by:
ESC-H ESC-J
which homes the cursor on the screen and clears the screen. Then the
character string:
ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_'abcdefghijklmnopqrstuvwxyz
is written to the terminal, followed by:
ESC-H ESC-D
which homes the cursor and causes the terminal to return the character
string. (Sending ESC-D to the terminal is the same as pressing Enter.)
If TermDSM knows that this test has failed, an error message will be
printed listing the reason for the failure and how many milliseconds the
test ran before failing.
The diagnostics prompt will be printed and you will be allowed to enter
another subcommand.
Example
(disgnostics)
SElftest # (DTC Selftest)
PRint #,#,# (Print to specified port)
Internal #,#,# (Internal loopback on specified port)
EXTernal #,#,# (Loopback through hood on specified port)
Terminal #,#,# (Write and read to terminal on that port)
(carriage return to exit) ?T 3,2,5
Do you want to stop looping if an error is found (yes/no)? y
Please connect and make ready (power on, remote mode, etc.) a
supported terminal, before answering the "How many times?" question.
(TDSM 114)
How many times do you want to repeat this operation? 100
Type CONTROL_Y to stop the looping.
The test passed 100 times and failed 0 times.
(diagnostics)
SElftest # (DTC Selftest)
PRint #,#,# (Print to specified port)
Internal #,#,# (Internal loopback on specified port)
EXTernal #,#,# (Loopback through hood on specified port)
Terminal #,#,# (Write and read to terminal on that port)
(carriage return to exit) ?
The example above executes 100 terminal write/read tests on the sixth
port of the third card of DTC number three. (Remember that ports and
cards are numbered starting with zero.)
MPE/iX 5.0 Documentation