NCLHELP.HLB  —  show  modem_connect
    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
Close Help