show [node node-id] modem connect version
all [attributes]
all characteristics
1 – Characteristic
version
The version number of the DNA Modem Connect architecture to
which the implementation conforms. You cannot modify this
characteristic.
2 – data_port
show [node node-id] modem connect -
data port port-name attribute [,attribute...]
all [attributes]
all identifiers
all status
Example:
show modem connect data port * name, state
2.1 – Identifier
o name
Simple name assigned to the data port.
2.2 – Status
o client
Name supplied by the client when the port was opened. This defines
which client owns the port.
o line
Name of the modem connect line entity that the client supplied
when the port was opened.
o state
State of data port.
open The port is assigned to a client.
open disabled The port is assigned to a client, but the line
entity that port refers to is disabled.
3 – line
show [node node-id] modem connect -
line line-name attribute [,attribute]
all [attributes]
all characteristics
all counters
all identifiers
all status
all interchange circuits
Examples:
show modem connect line * name, state
show modem connect line DSY-0-0 all
show modem connect line ddcmp-0 all interchange circuits
3.1 – Characteristics
o alternate speed
Default: 0
Alternate (low) speed (in bits per second) to operate the
line. You can modify this characteristic only when the entity
is disabled. This characteristic is supported only when the
characteristic communications mode is asynchronous, the
characteristic modem control is full, the characteristic modem
options includes rateselect, the characteristic clock is internal,
and when the alternate line speed is needed.
o call accept timer
Default: 0
Minimum time (in milliseconds) between the assertion of data set
ready and accepting a call by asserting request to send. This
characteristic is not supported if the characteristic modem
control is none.
o carrier loss timer
Default: 15000
Maximum time (in milliseconds) that the carrier detect signal
can be absent before the loss of carrier event is generated.
This characteristic is not supported if the characteristic modem
control is none.
o clock
Source of the transmit and receive clocks.
external The modem provides the clock.
internal The communications device provides the clock.
reflected The DTE transmit clock is a reflection of the
DCE transmit clock. This minimizes the clock to
data skew that the DCE encounters when high line
speeds are used.
The default value depends on the setting of the characteristic
communications mode. If communications mode is asynchronous, the
default value of this characteristic is internal. Otherwise, the
default value is external.
The value of this attribute has no effect when the communications
line is in loopback mode. In this case, the type of loopback
determines the type of clock. You can modify this characteristic
only when the entity is disabled.
o communications mode
Default: Sychronous Value: Asynchronous or synchronous
Communications method to be used on the link, either asynchronous
or synchronous. The value of this characteristic is a copy of the
communications mode argument specified when the entity is created.
You cannot modify this characteristic.
o communications port
Default: None
Name of the communications port. The value of this characteristic
is a copy of the communications port argument specified when the
entity is created. You cannot modify this characteristic.
o connection type (Tru64 UNIX)
Default: Nonswitched Value: Nonswitched or switched
Indicates whether the line is switched or non-switched. The value
of this characteristic is a copy of the connection type argument
specified when the entity is created. You cannot modify this
characteristic.
o duplex
Default: Full Value: Full or half
Indicates whether the line is full- or half-duplex. The value of
this characteristic is a copy of the duplex argument specified
when the entity is created. You cannot modify this characteristic.
o encoding
Default: normal Value: normal or nrzi
Encoding technique used on the line. You can modify this
characteristic only when the entity is disabled.
o initial hold timer (Tru64 UNIX)
Default: 10
Maximum time, in seconds, that the entity waits for an incoming
call to be accepted.
o maximum call setup timer (Tru64 UNIX)
Default: 60
Maximum time, in seconds, that the entity waits for an outgoing
call to connect.
o maximum disable transmit timer
Default: 500 Value: 0-60000
Maximum time, in milliseconds, that clear to send can remain
asserted before the line is disconnected after Request to Send
is deasserted. This attribute is not supported if the
characteristic modem control is set to none.
o maximum dsr deassertion timer
Default: 5000 Value: 0-60000
Maximum time, in milliseconds, the entity will wait for data set
ready to be deasserted after it has deasserted data terminal
ready. If this timer expires, the entity assumes it can assert
data terminal ready once again. This attribute is not
supported if the characteristic modem control is set to none.
o maximum enable transmit timer
Default: 2000 Value: 1-5000
Maximum time, in milliseconds, between the assertion of the
request to send signal and receiving the assertion of the clear
to send signal. This attribute is not supported if the
characteristic modem control is set to none.
o minimum dtr deassertion timer
Default: 1000 Value: 0-60000
Minimum timer, in milliseconds, that the DTE will deassert data
terminal ready during a disconnection. This attribute is not
supported if the characteristic modem control is set to none.
o modem control
Default: Full Value: Full or none
Indicates whether the interchange circuits are to be monitored and
used. The value none means that only the data leads are monitored.
The value full must be used when the value of the characteristic
duplex is half. This characteristic is supported only if
the characteristic connection type is switched.
o modem options
Default: No options Value: Set of options
Set of values that determine the capabilities of the modem.
dialout The modem can dial the remote modem. Supported
only if the value of communications type is
switched. This value is supported by Tru64 UNIX
only.
direct The modem is directly connected to the remote
modem through a non-switched line. Supported
only if accompanied withdialout and used only
when the modem protocol type supports direct
dial. This value is supported by Tru64 UNIX
only.
rate select The modem is capable of data rate selection.
o modem protocol format (Tru64 UNIX)
Default: See following Value: See following description.
description.
Format to use for V.25bis protocol messages. This characteristic
applies only when the characteristic modem protocol type is
v25bis or dmcl.
asynchronous Use the asynchronous format.
hdlc Use the HDLC format.
synchronous Use the synchronous format.
The default value depends on the value of the characteristic
communications mode. If communications mode is asynchronous, the
default value of this characteristic is also asynchronous. If the
value of communications mode is synchronous, the default value of
this characteristic is hdlc.
o modem protocol type (Tru64 UNIX)
Default: V25bis Value: See description
Protocol that the modem uses to select modem options and to set
line control parameters.
at A set of automatic calling procedures used in the
Hayes Smart Modem 2400.
dmcl The Digital Modem Control Language, based on
V.25bis.
v25 A set of automatic calling and answering
procedures defined by CCITT. These procedures
use the 200-series circuits defined in the
CCITT recommendation V.24. The V.235 procedures
are also known as parallel automatic calling
procedures.
v25bis A set of automatic calling and answering
procedures defined by CCITT. These procedures
use the 100-series circuits defined in the CCITT
recommendation V.24. The V.25bis procedures
are also known as serial automatic calling
procedures.
o profile
Default: None
Name of the local profile to be used with the line. This profile
is used to restrict the range of various line attributes, and to
change the defaults for those attributes. The value of
this characteristic is a copy of the profile argument specified
when the entity is created.
o rate select
Default: High Value: High or Low
Specifies which of the line rates is to be used if none is
specified when a call is set up.
high The value of the speed characteristic is used.
low The value of the alternate speed characteristic
is used.
o speed
Default: 0
High speed, in bits per second, to be used on the line. This value
is always used on asynchronous links. It is used on synchronous
links only in the following circumstances:
o When the value of the clock characteristic is internal
o When a null modem cable is detected
o When using a loopback mode that uses internal clocking
o successful call indication timer
Default: 30
Maximum time, in seconds, that the entity will wait for indication
of a successful call before disconnecting the line. This
attribute is not supported if the characteristic modem
control is set to none.
o suppress test indicator
Default: False Value: True or false
Specifies whether the Test Mode signal is to be monitored. If the
value is false, a change in the circuit will be monitored and will
cause the Test Indication event to be generated.
You should set this characteristic to true in cases where the
transitions of this signal are not produced by entering test
mode, so that this signal should be ignored.
o transmit holdoff timer
Default: 0
Necessary delay, in milliseconds, between the transmitter
being disabled and then reenabled. The value 0 means
that the request to send signal can be asserted as soon as the
client requests it. This characteristic is not supported if the
characteristic modem control is set to none.
3.2 – Counters
o cable faults
Total number of times that the communications cable was detected
as missing or invalid.
o creation time
Time at which this entity was created.
o device errors
Total number of times that a potential device error has been
reported.
o framing errors
Total number of framing errors detected on the line. This counter
is not supported if the characteristic communications mode is
synchronous.
o losses of carrier
Total number of times that the carrier on the line was lost. This
counter is maintained only if the characteristic modem control is
none.
o losses of clock
Total number of times that the transmit or receive clock was lost.
o outgoing call failures (Tru64 UNIX)
Total number of times that an outgoing call failed to connect.
o rate fallbacks
Number of times that the DTE changed from the high data rate to
the low (alternate) rate. This counter is supported only if the
characteristic modem options includes rate select, and if the
characteristic modem control is full.
o test indications
Number of times the DCE was put into test mode by the remote
system. This counter is maintained only if the characteristic
modem control is set to none.
o times cable detected
Total number of times that a a valid communications cable was
detected following a an error counted by the counter cable faults.
o times dce not ready
Total number of times that a dce not ready event occurred. This
counter is maintained only if the characteristic modem control is
set to none.
o times reset (OpenVMS)
Number of times that the data link client has performed a line
reset.
o transmit enable timeouts
Number of times the DCE failed to assert clear to send in response
to request to send. This counter is maintained only if the
characteristic modem control is set to none.
3.3 – Identifier
o name
Simple name assigned to the line.
3.4 – Status
o actual speed
Actual speed of the line, in bits per second. For internal clocking
on some microcoded devices, a value of 0 indicates that the device
has selected a speed appropriate for the connected interface. For
external clocking, a value of 0 indicates that the speed is unknown.
o device availability (OpenVMS)
Indicates whether the hardware device associated with the named
communications port is installed. Support is mandatory on systems
that support line card hot swap. When device availability has the
value no device, the interface state takes the value
pending DTE Ready and the interface type attribute takes the value
unknown.
o interface state
State of the physical interface on the line.
connected A switched line is connected but not yet ready
to transmit or receive data.
connecting Call setup on a switched line is in progress.
disconnecting Call clear on a switched line is in progress.
dte not ready The entity is disabled.
dte ready The DTE is ready, but the DCE is not ready.
full enabled The line is enabled for data transmission and
reception.
pending dte ready The entity is enabled but the ready
state cannot be entered. For example, the
communications cable is not connected.
ready Both DTE and DCE are ready.
receive enabled The line is ready to receive data.
transmit enabled The line is ready for data transmission.
o interface type
Type of the physical interface connection.
loopback A loopback connector has been detected on the
interface.
no cable No cable is connected to the interface.
null modem A null modem cable is connected to the interface.
rs232c A cable conforming to the RS232C standard is
attached.
rs422 A cable conforming to the RS422 standard is
attached.
rs423-v24 This value appears where a cable is attached
but the connector cannot distinguish between the
RS423 and V.24 standards.
rs449 A cable conforming to the RS449 standard is
attached.
unknown A cable is attached but its type is not known
v28 A cable conforming to any of the CCITT V.24, V.28
standards, the IS 2110 standard, or the EIA-232-D
standard.
v35 A cable conforming to the V35 standard is
attached.
x.21 A cable conforming to the X.21 standard is
attached.
o loopback mode
Type of loopback in use on the line. The value of this status
attribute is determined by the startloop and stoploop commands.
connector Data is looped through a loopback connector
attached to the communications device.
device Data is looped in the communications device.
driver Data is looped in the driver of the
communications device.
external Data is looped through a null modem or a modem in
loopback mode.
local The communications device has switched its local
modem into loopback mode.
null The line is not in loopback mode.
remote The communications device has switched the remote
modem into loopback mode.
o modem type
String identifying the local modem. If this status attribute has
no value, the type could not be determined.
o state
Operating state of the line. The value of this attribute is
affected by the enable and disable commands.
off The line has been disabled
on The line has been enabled
o uid
Entity's unique identifier, which is generated when the entity is
created.
3.5 – Interchange Circuits
show modem connect line line-id all interchange circuits
The modem connect line entity has a special attribute group
"interchange circuits", which lets you show a subset of the
status attributes. This "interchange circuits" attribute
group allows you to examine the instantaneous status of the
interchange circuits on the line.
These circuits are known by different names in the various
interface standards. The following list shows how the status
attribute names used in NCL correspond to those used in the
interface standards.
For instance, the data terminal ready attribute is the name used
for the CCITT V.24 circuit 108/2, the EIA-232-D CD circuit, the
RS-499 TR circuit, and so on.
When entering commands, always use the NCL attribute name.
When displayed, each attribute has one of the following values:
asserted The circuit is asserted
not applicable The circuit does not exist on the interface
not asserted The circuit is not asserted
unknown The modem cable is not connected or is invalid
3.5.1 – CCITT V.24 Circuits
Modem Connect Line Interchange Circuits
NCL Attribute Name Circuit Description
----------------------------------------------------------------------
carrier detect 109 Data channel received line
signal detector
clear to send 106 Ready for sending
data set ready 107 Data set ready
data terminal ready 108/2 Data terminal ready
local loopback 141 Local loopback
remote loopback 140 Loopback/Maintenance test
request to send 105 Request to send
ring indicator 125 Calling indicator
signalling rate 112 Data signal rate selector(DCE)
indicator
signalling rate 111 Data signal rate selector (DTE)
selector
test mode 142 Test indicator
3.5.2 – DIN 66020 Blatt 1 Circuits
Modem Connect Line Interchange Circuits
NCL Attribute Name Circuit Description
----------------------------------------------------------------------
carrier detect M5 -
clear to send M2 -
data set ready M1 -
data terminal ready S1.2 -
local loopback PS3 -
remote loopback PS2 -
request to send S2 -
ring indicator M3 -
signalling rate not -
indicator supported
signalling rate S4 -
selector
test mode PM1 -
3.5.3 – EIA-232-D Circuits
Modem Connect Line Interchange Circuits
NCL Attribute Name Circuit Description
----------------------------------------------------------------------
carrier detect CF Received Line Signal Detector
clear to send CB Clear to Send
data set ready CC DCE Ready
data terminal ready CD DTE Ready
local loopback LL Local Loopback
remote loopback RL Remote Loopback
request to send CA Request to Send
ring indicator CE Ring Indicator
signalling rate CI Data Signal Rate Selector (DCE)
indicator
signalling rate CH Data Signal Rate Selector (DTE)
selector
test mode TM Test Mode
3.5.4 – RS-232-C Circuits
Modem Connect Line Interchange Circuits
NCL Attribute Name Circuit Description
----------------------------------------------------------------------
carrier detect - Received Line Signal Detector
clear to send - Clear to Send
data set ready - Data Set Ready
data terminal ready - Data Terminal Ready
local loopback - not supported
remote loopback - not supported
request to send - Request to Send
ring indicator - Ring Indicator
signalling rate - Data Signal Rate Selector (DCE)
indicator
signalling rate - Data Signal Rate Selector (DTE)
selector
test mode - not supported
3.5.5 – RS-449 Circuits
Modem Connect Line Interchange Circuits
NCL Attribute Name Circuit Description
----------------------------------------------------------------------
carrier detect RR Receiver Ready
clear to send CS Clear to Send
data set ready DM Data Mode
data terminal ready TR Terminal Ready
local loopback LL Local Loopback
remote loopback RL Remote Loopback
request to send RS Request to Send
ring indicator IC Incoming Call
signalling rate SI Signaling Rate Indicator
indicator
signalling rate SR Signaling Rate Selector
selector
test mode TM Test Mode