NCLHELP.HLB  —  set  osi_transport
    set  [node node-id] osi transport ...

    Modifies the attributes of the osi transport entity.  The modifiable
    attributes and their data types [in brackets] are:

    cltp nsap selector [integer] (Tru64 UNIX)
    congestion avoidance [boolean]
    CONS filters [set of simplenames]
    CONS nsap address [set of NSAPs]
    delay factor [integer]
    delay weight [integer]
    disconnect holdback [seconds]
    maximum cltp ports [integer] (Tru64 UNIX)
    maximum listeners [integer] (Tru64 UNIX)
    maximum multiplexing [integer]
    maximum network connections [integer]
    maximum receive buffers [integer] (OpenVMS)
    maximum remote nsaps [integer]
    maximum transport connections [integer]
    maximum window [integer]
    nsap selector [integer]
    RFC1006 listener ports [set of TCP/IP port numbers] (OpenVMS)
    RFC1006 listener ipaddresses [set of IP Addresses] (OpenVMS)

    Refer to attribute descriptions for specific command examples.

    Select application to view the settable attributes
    of an osi transport application, or select template to display the
    settable attributes of an osi transport template.

1  –  cltp nsap selector (Tru64 UNIX)

    Default: 0             Value: 0-255 (except 32)

    The NSAP selector to use for CLTS when running over CLNS. If the
    value is 0 or 1, a single NSAP is shared between the Connection-
    Oriented Transport Service (COTS), and the connectionless
    transport protocol according to the osi transport attribute nsap
    selector. If both nsap selectors are 0 or 1, then COTS and CLTS
    over CLNS are disabled.

    This attribute cannot be set either to 32, which is the value
    of the NSP NSAP selector, or to the current setting of the osi
    transport attribute, nsap selector, if the attribute has a value
    other than 0 or 1.

    This attribute cannot be modified when transport is enabled.

2  –  congestion_avoidance

    Default: False          Value: True or false

    Enables the use of the automatic congestion avoidance mechanism
    to reduce the transport window size in response to an indication
    from the Network layer when operating on the Connectionless
    Network Service (CLNS).

    set [node node-id] osi transport congestion avoidance boolean

    Example:

    set osi transport congestion avoidance false

3  –  cons_filters

    Default: { }           Value: Set of simple names

    The names of X.25 Access module filters used to determine which
    inbound network connection requests should be directed to the
    transport entity.

    On OpenVMS Modification of this attribute while OSI transport is
    enabled is permitted only with the add command.  The set and
    remove commands can only be used to modify this attribute when the
    OSI transport is disabled.

    For each cons filter, there must be a corresponding x25 access
    template with the same name. One or more of these filters must be
    specified in order to run COTS over CONS. The X.25 access filter
    osi transport is typically used. See X.25/CONS Configuration for
    more information.

    set osi transport cons filters {simplename[,simplename...]}

    Example:

    set osi transport cons filters {"OSI Transport"}

4  –  cons_nsap_addresses

    Default: { }           Value: Set of NSAP addresses

    The set of valid NSAP addresses for use with CONS. One or more
    NSAPs must be specified to run COTS over CONS. See the DECnet-Plus
    for Tru64 UNIX Programming manual for more information.

    set osi transport cons nsap addresses {nsap[,nsap...]}

5  –  delay_factor

    Default: 4             Value: 2-15

    Factor by which to multiply the current value of the round-trip
    delay estimate status attribute in order to set a value for the
    retransmission timer. This attribute works with protocol class 4
    only.

    set [node node-id] osi transport delay factor integer

    Example:

    set osi transport delay factor 4

6  –  delay_weight

    Default: 5             Value: 0-255

    Relative weighting to apply to the current estimate and to a new
    sample when estimating round-trip delay. This attribute works
    with protocol class 4 only.

    set [node node-id] osi transport delay weight integer

    Example:

    set osi transport delay weight 5

7  –  disconnect_holdback

    Default: 0                     Tru64 UNIX Value: 0-(2 raised to
                                                   the power of 31 -1)
    OpenVMS Default: 0             OpenVMS Value: 0-4294967295

    When operating over the Connection-Oriented Network Service
    (CONS), the length of the time to maintain a network connection
    for possible reuse after all transport connections multiplexed
    upon it have been disconnected. Specified in seconds. This
    characteristic may not be changed while the transport entity
    is enabled. See X.25/CONS Configuration for more information.

    set [node node-id] osi transport disconnect holdback integer

    Example:

    set osi transport disconnect holdback 0

8  –  maximum cltp ports (Tru64 UNIX)

    Default: 128           Value: 0-(2 raised to the power of 32 -1)

    Maximum number of CLTS ports at one time. This characteristic can
    only be increased while transport is enabled. You can modify this
    characteristic to a lower value only when the entity is disabled.

9  –  maximum listeners (Tru64 UNIX)

    Default: 32            Value: 1-65535

    Maximum number of listeners at one time. This characteristic can
    only be increased while transport is enabled. You can modify this
    characteristic to a lower value only when the entity is disabled.

10  –  maximum_multiplexing

    Tru64 UNIX Default: 1023       Tru64 UNIX Value: 1-1023

    OpenVMS Default: 4294967295    OpenVMS Value: 1-4294967295

    When operating over the Connection-Oriented Network Service
    (CONS), the maximum number of transport connections that can be
    multiplexed on any single network connection. This characteristic
    can be increased only when the transport entity is enabled.
    You can modify this characteristic to a lower value only when
    the entity is disabled. See X.25/CONS Configuration for more
    information.

    set [node node-id] osi transport maximum multiplexing integer

    Example:

    set osi transport maximum multiplexing 4294967295

11  –  maximum_network_connections

    Tru64 UNIX Default: 1023       Tru64 UNIX Value: 0-1023

    OpenVMS Default: 4294967295    OpenVMS Value: 0-4294967295

    When operating over the Connection-Oriented Network Service
    (CONS), the maximum number of network connections which can be
    in use concurrently by DNA OSI Transport. This characteristic
    can be incresed only when the transport entity is enabled.
    See X.25/CONS Configuration for more information.

    set [node node-id] osi transport -
         maximum network connections integer

    Example:

    set osi transport maximum network connections 4294967295

12  –  maximum receive buffers (OpenVMS)

    Default: 2000            Value: 1-4294967295

    Maximum number of receive buffers that can store received
    DT transport PDUs. You can modify this characteristic only
    when the entity is disabled. Also, you can only increase the
    characteristic value.

    set [node node-id] osi transport maximum receive buffers integer

    Example:

    set osi transport maximum receive buffers 2000

13  –  maximum_remote_nsaps

    Tru64 UNIX Default: 160      Tru64 UNIX Value: 1-65536

    OpenVMS Default: 201         OpenVMS Value: 0-4294967295

    Maximum number of remote NSAPs that can exist concurrently. This
    value must be greater than the current value of maximum transport
    connections. You can modify this characteristic to a lower value
    only when the entity is disabled. This characteristic can be
    increased when enabled.

    set [node node-id] osi transport maximum remote nsaps integer

    Example:

    set osi transport maximum remote nsaps 201

14  –  maximum_transport_connections

    Tru64 UNIX Default: 128      Tru64 UNIX Value: 0-1023

    OpenVMS Default: 200         OpenVMS Value: 0-4294967295

    Maximum number of active transport connections allowed at one
    time. Must be less than the current value of maximum remote
    nsaps. You can modify this characteristic to a lower value only
    when the entity is disabled.

    set [node node-id] osi transport -
         maximum transport connections integer

    Example:

    set osi transport maximum transport connections 200

15  –  maximum_window

    Tru64 UNIX Default: 20         Tru64 UNIX Value: 1-65535

    OpenVMS Default: 8             OpenVMS Value: 1-65535

    Maximum credit window that can be granted on a transport
    connection. This is used for control of the number of data
    segments (PDUs) allowed to be transmitted over a particular
    transport connection before at least one acknowledgment must
    be returned from the destination system. If the number of
    PDUs already transmitted equals the maximum window and no
    corresponding acknowledgments have been received, transport
    stops sending PDUs over the transport connection and waits for
    an acknowledgment message. You can modify this characteristic to
    a lower value only when the entity is disabled.

    set [node node-id] osi transport maximum window integer

    Example:

    set osi transport maximum window 20

16  –  nsap_selector

    Default: 33            Value: 0-255 (except 32)

    The NSAP selector to use for the Connection-Oriented Transport
    Service (COTS) when running over CLNS. If 0 or 1, COTS over CLNS
    is not enabled. This attribute cannot be set to 32, which is the
    value of the NSP NSAP selector. Or, on Tru64 UNIX, to the current
    setting of the osi transport attribute cltp nsap selector if it
    is other than 0 or 1.

    This attribute cannot be modified when transport is enabled.

    set [node node-id] osi transport nsap selector integer

    Example:

    set osi transport nsap selector 33

17  –  RFC1006 listener ports (OpenVMS)

    Default: { 102, 399 }      Value: Set of TCP/IP port numbers

    The names of the TCP listener ports used to receive inbound
    RFC1006 connection requests. This is applicable for both RFC1006
    and RFC1859.

    Modification of this attribute while OSI transport is enabled is
    permitted only with the add command.  The set and remove commands
    can only be used to modify this attribute when the OSI transport
    is disabled.

    set [node node-id] osi transport -
        rfc1006 listener ports {port[,port...]}

    Example:

    set osi transport rfc1006 listener ports {102, 399}

    See HELP NETWORK_MANAGEMENT RUNNING_OVER_TCP-IP for more information.

18  –  RFC1006 listener ipaddresses (OpenVMS)

    Default: { 0.0.0.0 }      Value: Set of IP Addresses

    The names of the listener IP addresses used to receive inbound
    RFC1006 connection requests. This is applicable for both RFC1006
    and RFC1859.

    Modification of this attribute while OSI transport is enabled is
    permitted only with the add command.  The set and remove commands
    can only be used to modify this attribute when the OSI transport
    is disabled.

    set [node node-id] osi transport -
        rfc1006 listener ipaddresses {ipaddr[,ipaddr...]}

    Example:

    set osi transport rfc1006 listener ipaddresses {a.b.c.d,w.x.y.z}

    See HELP NETWORK_MANAGEMENT RUNNING_OVER_TCP-IP for more information.

19  –  application (OpenVMS)

    set  [node node-id] osi transport application application-name ...

    Modifies attributes of the OSI transport application entity.  The
    modifiable attributes and their data types [in brackets] are:

    called tsels [hex-string]
    file name [filename]
    user name [latin1string]

    Refer to attribute descriptions for specific command examples.

19.1  –  called_tsels

    Default: No tsap    		 Value: Hex-string

    Transport Service Access Point (TSAP) for which the image
    specified by the image name characteristic accepts connections.
    This characteristic, which is similar to the addresses
    characteristic, is used by applications that do not use the DNA
    session control protocol (for example, VOTS applications).

    set [node node-id] osi transport application application-name -
        called tsels {hex-string}

    Example:

    set osi transport application osit$ivp -
        called tsels {%x564F5453495650}

19.2  –  file_name

    Default: No file name  	Value: Filename

    File name of the program to be invoked upon receipt of a connect
    request containing a TSEL matching the "Called TSELS" attribute
    of the application entity.

    set [node node-id] osi transport application application-name -
        file name filename

    Example:

    set osi transport application osit$ivp -
        file name sys$test:osit$ivpresp.com

19.3  –  user_name

    Default: No user name  	Value: Latin1string

    User name portion of the access control information that
    identifies the account under which the application is to run. If
    invalid information or no user name is specified, system defaults
    are used to select the user.  On OpenVMS, the user name must be
    embedded in quotes.

    set [node node-id] osi transport application application-name -
        user name latin1string

    Example:

    set osi transport application osit$ivp -
        user name "systest"

20  –  template

    set  [node node-id] osi transport template template-id ...

    Modifies the attributes of an osi transport template entity.  The
    modifiable attributes and their data types [in brackets] are:

    acknowledge delay time [seconds]
    checksums [boolean]
    classes [set-of-classes]
    clns inactive area address [area-address] (OpenVMS)
    cons template [simple-name]
    cr timeout [seconds]
    er timeout [seconds]
    expedited data [boolean]
    extended format [boolean]
    inbound [boolean] (OpenVMS)
    initial retransmit time [seconds]
    keepalive time [seconds]
    local nsap [nsap-address]
    loopback [boolean] (OpenVMS)
    maximum nsdu size [integer]
    network priority [integer] (OpenVMS)
    network service [service-type]
    retransmit threshold [integer]
    RFC1006 port number [integer] (OpenVMS)
    security [octet-string]
    send preferred maximum tpdu size [boolean]
    send request acknowledgment [boolean]
    send implementation id [boolean]
    use clns error reports [boolean]

    Refer to attribute descriptions for specific command examples.

20.1  –  acknowledgment_delay_time

    Default: 1             Value: 0-65

    Maximum amount of time, in seconds, that an AK TPDU is to be
    withheld. This attribute is valid for protocol class 4 only.

    set  [node node-id] osi transport template template-id -
         acknowledgment delay time integer

    Example:

    set osi transport template default acknowledgment delay time 1

20.2  –  checksums

    Default: False         Value: True or false

    Specifies whether the use of checksums should be negotiated for a
    transport connection. This attribute is valid for protocol class
    4 only.

    set  [node node-id] osi transport template template-id -
         checksums boolean

    Example:

    set osi transport template default checksums false

20.3  –  classes

    Default: {4}           Value: Bit-set

    Set of protocol classes that can be negotiated for use on a
    transport connection. If the value of the network service
    attribute is CLNS, the class must be a subset of the classes
    supported by the OSI transport attribute clns classes supported.
    If the value is CONS, the classes must be a subset of the
    classes supported by the OSI transport attribute cons classes
    supported. If the value of the network service attribute is ANY,
    the classes must be a subset of the combined classes in the clns
    classes supported and cons classes supported attributes.

    set  [node node-id] osi transport template template-id -
         classes {class[,class...]}

    Example:

    set osi transport template osit$loop_cons  classes {0,2,4}

20.4  –  clns inactive area address (OpenVMS)

    Default: Empty set     Value: Set of area-address

    Specifies the inactive area address to be used by transport
    connections that use this template. This characteristic is
    relevant only for connections that use CLNS with Null Internet.
    The set must contain no more than one area address.

    set  [node node-id] osi transport template template-id -
         clns inactive area address {area-address}

20.5  –  cons_template

    Default: OSI Transport          Value: Simple-name

    Name of the X.25 Access module template to be used when
    establishing a network connection over the CONS. Used only when
    the value of the network service attribute is cons.

    set  [node node-id] osi transport template template-id -
         cons template simplename

    Example:

    set osi transport template osit$loop_cons -
         cons template "OSI Transport"

20.6  –  cr_timeout

    Default: 30            Value for Tru64 UNIX: 1-(2 raised to the
                                                  power of 31 -1)

    Default: 30            Value for OpenVMS: 1-4294967295

    During connection establishment, the amount of time (in seconds)
    to wait for a response to a CR TPDU before assuming that
    the remote transport service provider will not respond. This
    attribute is valid for protocol classes 0 and 2 only.

    set  [node node-id] osi transport template template-id -
         cr timeout integer

    Example:

    set osi transport template osit$loop_cons -
         cr timeout 30

20.7  –  er_timeout

    Default: 30            Value for Tru64 UNIX: 1-(2 raised to the
                                                  power of 31 -1)

    Default: 30            Value for OpenVMS: 1-4294967295

    The amount of time (in seconds) to wait for a response to an ER
    TPDU before disconnecting the network connection. This attribute
    is used for protocol classes 0 and 2 only.

    set  [node node-id] osi transport template template-id -
         er timeout integer

    Example:

    set osi transport template osit$loop_cons -
         er timeout 30

20.8  –  expedited_data

    Default: True          Value: True or false

    Specifies whether use of the expedited data option should be
    negotiated for the transport connections. This attribute is not
    valid for protocol class 0.

    set  [node node-id] osi transport template template-id -
         expedited data boolean

    Example:

    set osi transport template osit$loop_clns -
         expedited data true

20.9  –  extended_format

    Default: None          Value: True or false

    Specifies whether the use of extended TPDU format should be
    negotiated for the transport connections. Normal format gives
    7-bit sequence numbers and 4-bit credit fields; extended format
    gives 31-bit sequence numbers and 16-bit credit fields. This
    attribute is supported only for class 2 and class 4 protocols.

    set  [node node-id] osi transport template template-id -
         extended format boolean

    Example:

    set osi transport template osit$loop_clns -
         extended format true

20.10  –  inbound (OpenVMS)

    Default: True          Value: True or false

    Indicates whether this template may be used as the template for
    an inbound transport connection. The algorithm of selection
    of the inbound template is different depending on the type of
    network service over which the transport connection is made.
    If an inbound template cannot be found for an inbound transport
    connection, then the template called DEFAULT will be selected as
    the default. For the CLNS network service, the inbound template
    selected is the first template found that has the Inbound
    attribute set to true, the Network Service attribute set to
    CLNS, and the CLNS Inactive Area Address attribute set to empty
    set.

    For the CLNS network service (using the inactive subset, that
    is, null internet), the incoming template selected is the first
    template found that has the Inbound attribute set to True, the
    Network Service attribute set to CLNS and the CLNS Inactive Area
    Address attribute matches the Inactive Area Address attribute
    of the Routing Circuit entity that the transport connection
    is using. For the CONS network service, the inbound template
    selected is the first template found that has the inbound
    attribute set to true, the network service attribute set to CONS
    and the CONS template attribute (that is, an X.25 Access template
    name) matches the name of the X.25 Access filter that was used to
    accept the inbound network connection.

    set  [node node-id] osi transport template template-id -
         inbound boolean

    Example:

    set osi transport template osit$rfc1006 -
         inbound true

20.11  –  initial_retransmit_time

    Tru64 UNIX Default: 5        Tru64 UNIX Value: 1-(2 raised to the
                                                  power of 31 -1)

    OpenVMS Default: 5           OpenVMS Value: 1-4294967295

    Amount of time, in seconds, to wait for an acknowledgment before
    retransmitting the first TPDU over the transport connection.

    set  [node node-id] osi transport template template-id -
         initial retransmit time integer

    Example:

    set osi transport template osit$loop_clns -
         initial retransmit time 5

20.12  –  keepalive_time

    Default: 60            Value: 1-16383

    Time (in seconds) to be used for the window timer. When the
    transport service provider has no TPDUs to send over a transport
    connection, it retransmits the last AK TPDU at the specified
    frequency to prevent expiration of the remote NSAP's inactivity
    timer. This attribute is valid for protocol class 4 only.

    set  [node node-id] osi transport template template-id -
         keepalive time integer

    Example:

    set osi transport template osit$loop_clns -
         keepalive time 60

20.13  –  local_nsap

    Default: System dependent, determined    Value: NSAP address
             at run-time

    A local NSAP address to be used by default if one is not supplied
    across the service interface.

    set  [node node-id] osi transport template template-id -
         local nsap nsap-address

20.14  –  loopback (OpenVMS)

    Default: False         Value: True or false

    Specifies whether transport connections using this template are
    looped back locally in the transport layer.

    set  [node node-id] osi transport template template-id -
         loopback boolean

    Example:

    set osi transport template osit$loop_clns -
         loopback true

20.15  –  maximum_nsdu_size

    Default: 2048          Value for Tru64 UNIX: 128-(2 raised to the
                                                    power of 32 -1)
    Default: 2048          Value for OpenVMS: 2048

    When operating over the CONS, the maximum NSDU size to use for
    transmit and receive buffers. Expressed as a number of octets.

    set  [node node-id] osi transport template template-id -
         maximum ndsu size integer

    Example:

    set osi transport template osit$loop_clns -
         maximum ndsu size 2048

20.16  –  network priority (OpenVMS)

    Default:  0            Value:  0-255

    When operating over CLNS, indicates network priority encoded in
    NPDU header for all transmitted packets. It may be used by
    intermediate systems to assign the packets to queues of
    appropriate priority.

    set  [node node-id] osi transport template template-id -
         network priority integer

    Example:

    set osi transport template osit$loop_clns -
         network priority 0

20.17  –  network_service

    Default: clns          Value: Any, clns, cons, or RFC1006
                                                     (OpenVMS)

    Type of network service. On Tru64 UNIX, the default template
    network service cannot be set to any. The network service
    chosen must be compatible with the value of the protocol class
    attribute.

    any        Either
    clns       Connectionless Network Service
    cons       Connection-Oriented Network Service
    RFC1006    ISO Transport Service on top of TCP

    set  [node node-id] osi transport template template-id -
         network service service-type

    Examples:

    set osi transport template osit$rfc1006 -     ! OSI over TCP/IP
         network service rfc1006                  ! RFC1006

    set osi transport template osit$rfc1006plus - ! DECnet over TCP/IP
         network service rfc1006                  ! RFC1859 a.k.a.
                                                  ! RFC1006+

20.18  –  retransmit_threshold

    Default: 8             Value: 0-4294967295

    Number of times a TPDU requiring acknowledgment is to be
    retransmitted before it is assumed that network connectivity
    has failed. This attribute is valid for protocol class 4 only.

    set  [node node-id] osi transport template template-id -
         retransmit threshold integer

    Example:

    set osi transport template osit$loop_clns -
         retransmit threshold 8

20.19  –  RFC1006 port number (OpenVMS)

    Default: 102          Value: TCP port number

    Specifies the TCP port number to use. Only applicable if the
    network service is RFC1006.

    set  [node node-id] osi transport template template-id -
         rfc1006 port number port-id

    Examples:

    set osi transport template osit$rfc1006 -     ! OSI over TCP/IP
         rfc1006 port number 102                  ! RFC1006

    set osi transport template osit$rfc1006plus - ! DECnet over TCP/IP
         rfc1006 port number 399                  ! RFC1859 a.k.a.
                                                  ! RFC1006+

20.20  –  security

    Default: Null value    Value: 00-FF

    An octet string to be transmitted in the security parameter of
    a CR or CC TPDU. A null value causes the security parameter to
    be omitted from the TPDU.

    set  [node node-id] osi transport template template-id -
         security octet-string

    Example:

    set osi transport template default security %xFF

20.21  –  send_implementation_id

    Default: True          Value: True or false

    Indicates whether the implementation id should be sent in the CR if
    the proposed protocol class is 2 or 4. It is always returned in the
    CC if it is present in the CR.

    set  [node node-id] osi transport template template-id -
         send implementation id boolean

    Example:

    set osi trans temp default send imp id true

20.22  –  send preferred maximum TPDU size

    Default: True 	 Value: True or false

    Indicates whether the preferred maximum TPDU size parameter should
    be sent in the CR TPDU.

    If the preferred maximum TPDU size parameter was present in the
    CR TPDU, then it indicates whether the preferred maximum TPDU
    size parameter should be sent in the CC TPDU.

                               NOTE

    The default value of this characteristic should not be changed
    unless the remote implementation does not conform to ISO 8073.

    set  [node node-id] osi transport template template-id -
         send preferred maximum tpdu size boolean

    Example:

    set osi trans temp default send pref max tpdu size true

20.23  –  send_request_acknowledgment

    Default: True 	    Value: True or false

    Indicates whether the request acknowledgment parameter should be
    sent in the CR TPDU.

    If the request acknowledgment parameter was present in the CR TPDU,
    then it indicates whether the request acknowledgment parameter
    should be sent in the CC TPDU.

                               NOTE

    The default of this characteristic should not be changed unless the
    remote implementation does not conform to ISO 8073.

    set  [node node-id] osi transport template template-id -
         send request acknowledgement boolean

    Example:

    set osi trans temp default send req ack true

20.24  –  use_clns_error_reports

    Default: False         Value: True or false

    Indicates whether the network Routing layer's error report
    facility should be used when performing connection establishment.
    If set to true, this may result in faster detection of an
    unreachable node at the time of connection establishment. This
    characteristic should not be set to true on an end system that
    is either dual-railed or connected to a network that has a high
    probability of duplication. This is valid only if network service
    equals clns.

    set  [node node-id] osi transport template template-id -
         use clns error reports boolean

    Example:

    set osi trans temp osit$loop_clns use clns err rep true
Close Help