NCLHELP.HLB  —  set  x25_access

1  –  application

    set  [node node-id] x25 access application application-name ...

    Modifies the attributes of an x25 access application entity, which
    defines an application to be executed for an incoming call.  The
    modifiable attributes and their data types [in brackets] are:

    account [latin1string] (Tru64 UNIX)
    activation data [latin1string] (Tru64 UNIX)
    file [filename]
    filters [set of simplenames]
    maximum activations [integer] (Tru64 UNIX)
    template [simplename] (Tru64 UNIX)
    type [X25, X29, or X29 login]
    user [latin1string]

1.1  –  account (Tru64 UNIX)

    Default: No service/account data     Value: Latin1String

    Default service or account identifier to be used when starting
    the applications process.

1.2  –  activation data (Tru64 UNIX)

    Default: None                        Value: Latin1String

    Data required to start the application process. This
    characteristic is optional.

1.3  –  file

    Default: None                        Value: File name

    Indicates the file name or command that is associated with starting a
    process for the represented application.

    Example:

    set x25 access application X25_MAIL file "sys$system:x25$mail.com"

1.4  –  filters

    Default: None                 Value: Set of simplenames

    Set of filters that are associated with filtering calls for
    either X.25 or X.29 applications represented by this entity.

    Example:

    set x25 access application X29_LOGIN filters {X29}

1.5  –  maximum activations (Tru64 UNIX)

    Default: 1                           Value: 1-65535

    Maximum number of concurrent activations of the represented
    application that are possible.

    Example:

    set x25 access application X29_LOGIN maximum activations 5

1.6  –  template (Tru64 UNIX)

    Default: No template                 Value: simplename

    Template to be used in a call accept.

    Example:

    set x25 access application X29_LOGIN template X29Server

1.7  –  type

    Specifies the type of application.

    X25         This application operates in X.25 mode.  This
                is the default.

    X29         This application operates in character mode.

    X29 login   This is an application of X.29 type devoted
                   specifically to login sessions.

    Example:

    set x25 access application X25_MAIL type x25

1.8  –  user

    Default: No user ID                Value: Latin1String

    Default user identification to be used to start the application
    process. This attribute is not valid for type X29 login and
    should be null.  On OpenVMS, Latin1Strings must be embedded in
    quotes.

    Example:

    set x25 access application X25_MAIL user "X25MAIL"

2  –  dte_class

    set  [node node-id] x25 access dte class class-name ...

    Modifies the attributes of an x25 access dte class entity, which
    defines a named class of DTEs.  The modifiable attributes and
    their data types [in brackets] are:

    account [latin1string] (OpenVMS)
    DNIC [DTE address]
    international prefix [DTE address]
    local dtes [set of simplenames]
    local prefix [DTE address]
    node [full-name] (OpenVMS VAX)
    outgoing session template [simplename] (OpenVMS)
    security dte class [simplename]
    service nodes [set of records] (OpenVMS Alpha)
    strip DNIC [boolean]
    user [latin1string] (OpenVMS)

2.1  –  account (OpenVMS)

    Default: No service/account data         Value: Latin1String

    Default service or account data to be used when connecting to
    the X.25 server on the gateway system specified by the node
    characteristic or service node characteristic. This attribute is
    supported only for DTE classes with characteristic type remote.
    The account value must be specified in quotes.

2.2  –  DNIC

    Default: Supplied by   Value: DTE address of 3 or 4 digits length
             profile

    The first part of the Network User Address (NUA). This takes
    one of two forms: Either it is in the form of the Data Network
    Identification Code (DNIC) and is specified by 4 digits, or it
    is in the form of a Data Country Code (DCC) and is specified by
    3 digits. If no profile is specified, the default is null.

2.3  –  international_prefix

    Default: Supplied by         Value: DTE address of 1 digit only.
             profile

    First digit of an X.121 address to indicate an international or
    internetwork call. If no profile is specified, the default is a
    null DTE address.

2.4  –  local_dtes

    Default: No names                 Value: Set of simplenames

    Names of the local x25 protocol dte entities that belong to this
    DTE class. Note that these DTE entities need not exist when their
    names are entered in this set; DTEs that do not exist when the
    DTE class is used are not considered when the DTE class is used
    for an outgoing call.

    If an x25 protocol dte entity has status attribute state set to
    running when its name is added to local dtes, you must disable
    the DTE entity and reenable it (see the disable x25 protocol dte
    and enable x25 protocol dte commands) in order for the DTE to be
    considered when this DTE class is used for an outgoing call.

    You can specify this characteristic only for DTE classes with
    characteristic type local.

    Example:

    set x25 access dte class dte-1 local dtes (dte-0)

2.5  –  local_prefix

    Default: Supplied by           Value: DTE address of 1 digit only
    profile

    First digit of a DTE address to indicate a local call. If no
    profile is specified, the default is a null DTE address.

2.6  –  node (OpenVMS VAX)

    Default: No name                                Value: Full-name

    Node name of the remote gateway system on which the DTEs in this
    DTE class reside. Note that this characteristic is supported only
    if the service nodes characteristic is not supported.

    This characteristic is supported only for DTE classes
    with type characteristic set to remote.

2.7  –  outgoing session template (OpenVMS)

    Default: Default or no name          Value: simplename
    (see description)

    Name of the OSI Transport template to be used by the X.25 client to
    connect to the X.25 server on the gateway system. The default
    value default is valid only if OSI session control is being used.
    This attribute is supported only for DTE classes with characteristic
    type remote.

2.8  –  security_dte_class

    Default: Default                     Value: simplename

    Name of the x25 access security dte class entity that controls
    inbound and outbound access using this DTE class.

    Example:

    set x25 access dte class dte-1 security dte class Default

2.9  –  service nodes (OpenVMS Alpha)

    Default: No records                         Value: Set of records

    Names of the nodes that may be used as candidate X.25 gateway
    systems and their associated ratings. Each record consists of
    a full name that describes the candidate node and an integer
    that indicates its ratings. The records are listed in order
    of descending rating. Values are entered as [node=nodename,
    rating=integer]. The rating represents the maximum number of
    session control connections to the node pair.

2.10  –  strip DNIC

    Default: False                              Value: True or false

    Defines whether the first part of the NUA (the DNIC or DCC
    specified by the DNIC characteristic) should be stripped for
    outgoing calls, and whether the network strips the first portion
    of the NUA from addresses it presents to the DTE.

2.11  –  user (OpenVMS)

    Default: No user ID                   Value: Latin1String

    Default user identification to be used when connecting to the
    gateway system specified by the service nodes characteristic.
    The user id must be specified in quotes.

3  –  filter

    set  [node node-id] x25 access filter filter-name ...

    Modifies the attributes for an x25 access filter entity, which
    defines the criteria by which the destination of an incoming call
    is determined.  The modifiable attributes and their data types
    [in brackets] are:

    call data mask [hex-string]
    call data value [hex-string]
    called address extension mask [hex-string]
    called address extension value [hex-string]
    called nsap [nsap-address] (Tru64 UNIX)
    group [simplename]
    inbound dte class [simplename]
    incoming dte address [dte-address]
    originally called address [dte-address]
    priority [integer]
    receiving dte address [dte-address]
    redirect reason [reason]
    security filter [simplename]
    sending dte address [dte-address]
    subaddress range [one-range-set] (OpenVMS VAX)

3.1  –  call_data_mask

    Default: No mask       Value: Hex string

    Mask to be applied to call user data in an incoming call. The
    result is compared, octet by octet, with the call data value
    characteristic.

    Example:

    set x25 access filter "OSI Transport" -
        call data value "03010100'H, call data mask "FFFFFFFF'H

3.2  –  call_data_value

    Default: No call user data   Value: Hex string

    Call user data value to be matched by this filter. This value is
    compared, octet by octet, with the masked call user data in the
    call request. This string must have the same length as the string
    specified for the call data mask characteristic.

    Example:

    set x25 access filter "OSI Transport" -
        call data value "03010100'H, call data mask "FFFFFFFF'H

3.3  –  called_address_extension_mask

    Default: No called     Value: Hex string
    address extension
    mask

    Mask to be applied to the called address extension in an incoming
    call. The result is compared, octet by octet, with the called
    address extension value characteristic.

3.4  –  called_address_extension_value

    Default: No called     Value: Hex string
    address extension
    value

    Called address extension value to be matched by this filter.
    This value is compared, octet by octet, with the masked called
    address extension value. This string must have the same length
    as the string specified in the called address extension mask
    characteristic.

3.5  –  group

    Default: No group name      Value: simplename

    Name of the x25 protocol group entity to be matched by this
    filter. The DTE must belong to this group for the filter to
    match. Wildcards can be used in the group name.

3.6  –  inbound_dte_class

    Default: No DTE class  Value: simplename

    Name of the DTE class to be matched by this filter. The DTE must
    belong to this DTE class for the filter to match. This is the
    DECnet-Plus mechanism for specifying a local receiving DTE; see
    also the description of the receiving dte address characteristic.
    Wilcards can be used in the class name.

    Example:

    set x25 access filter FILTER_0 inbound dte class remote-class-0

3.7  –  incoming_dte_address

    Default: No DTE        Value: DTE address
    address

    Value to be matched with the "called address" field of an
    incoming call packet. Wildcards can be used in the incoming
    DTE address.

    Example:

    set x25 access filter FILTER_1 incoming dte address 987654444

3.8  –  originally_called_address

    Default: No address    Value: DTE address

    Value to be matched with the "originally called address" field of
    an incoming call that has been redirected. Wildcards can be used
    in the originally called DTE address.

3.9  –  called_nsap

    Default: No NSAP       Value: NSAP address
    address

    Value to be matched against the called address extension field
    of an incoming call packet when the field contents are encoded in
    ISO format.

3.10  –  priority

    Default: 1             Value: 0-65535

    Filter's position in an ordered set of filters used for matching
    incoming calls.

    Example:

    set x25 access filter FILTER_0 priority 1

3.11  –  receiving_dte_address

    Default: No DTE        Value: DTE address
    address

    Address that is used to match the DTE address of the local
    receiving DTE. This characteristic is included for backward
    compatibility with Phase IV; the DECnet-Plus mechanism uses the
    dte class characteristic. Wildcards can be used in the
    receiving DTE address.

    Example:

    set x25 access filter FILTER_0 receiving dte address 987655555

3.12  –  redirect_reason

    Default: Not           Value: See description
    specified

    Reason for matching a call that has been redirected.

    busy        The original destination was busy.

    not         Redirection was not checked.
    specified

    out of      The original destination was not operational.
    order

    systematic  Calls to the original destination are systematically
                redirected.

    This value must be the same as the redirect reason in the call
    request for the filter to match.

    Example:

    set x25 access filter "OSI Transport" redirect reason not specified

3.13  –  security_filter

    Default: Default       Value: simplename

    Name of the x25 access security filter entity that controls
    access to this filter. Wildcards can be used in the security
    filter name.

    Example:

    set x25 access filter X25_MAIL security filter Default

3.14  –  sending_dte_address

    Default: No DTE        Value: DTE address
    address

    Value to be compared with the "calling address" field of an
    incoming call packet. These values must be the same for the
    filter to match. Wildcards can be used in the sending DTE
    address.

    Example:

    set x25 access filter FILTER_0 sending dte address 987656789

3.15  –  subaddress range (OpenVMS VAX)

    Default: No range      Value: Set of one range

    Subaddress range value to be matched by this filter. Format the
    values to specify this subaddress range. This set must either
    be empty or contain exactly one value. This attribute has been
    retired; it has been included to allow the value of the attribute
    to be seen, but it cannot be modified.

4  –  reachable_address

    set  [node node-id] x25 access reachable address address-name ...

    Modifies the an x25 access reachable address entity, which maps a
    destination network service access point (NSAP) address in an
    outgoing call to a DTE class/DTE address pair.  The modifiable
    attributes and their data types [in brackets] are:

    address extensions [boolean]
    destination [dte-address]
    dte class [simplename]
    mapping [Manual or X.121]

4.1  –  address_extensions

    Default: True          Value: True or false

    Specifies whether the "called address extension" and "calling
    address extension" fields are to be included in the outgoing call
    packet.

    Example:

    set x25 access reachable address x121 address extensions true

4.2  –  destination

    Default: No DTE        Value: DTE address
    address

    Manually entered DTE address. This address is used only if the
    mapping characteristic has the value manual.

4.3  –  dte_class

    Default: No class      Value: Class name
    name

    Name of the DTE class to be used in making the outgoing call. If
    not specified, any DTE class may be used.

    Example:

    set x25 access reachable address FRED dte class remote-class-0

4.4  –  mapping

    Default: X.121         Value: Manual or X.121

    Mechanism by which the destination DTE address is to be derived.

    manual  The destination DTE address is supplied manually by means
            of the destination characteristic.

    X.121   The destination DTE address is derived by an algorithm from
            an NSAP address in X.121 format. X.121 address mapping may
            only be specified with address prefixes of 36, 37, 49, 52
            and 53.

    Example:

    set x25 access reachable address x121 mapping X . 121

5  –  security_dte_class

5.1  –  remote_dte

    set  [node node-id] x25 access security dte class class-name
         remote dte dte-name ...

    Modifies attributes of an x25 access security dte class remote dte
    entity, which is a collection of access control attributes that
    control inbound calls from and outbound calls to a set of remote
    DTEs.  The modifiable attributes and their data types [in brackets]
    are:

    acl [access-control-list]
    rights identifiers [set of simplenames]

5.1.1  –  acl

    Default: No acl        Value: Access control list

    Access Control List (ACL) that is used when checking outbound
    calls to the set of DTE addresses that this remote DTE
    represents. Wildcards can be used in the identifiers that form
    part of each Access Control Entry (ACE) in an Access Control
    List (ACL).

    Example:

    set x25 access security dte class Default -
      remote dte match_all -
      acl (( identifier = ( docwriter ), access = NONE))

5.1.2  –  rights_identifiers

    Default: No rights identifiers    Value: Set of simplenames

    Rights identifiers possessed by this remote DTE.  It is used
    for incoming call checking against the ACL attribute of a
    security filter entity that is used to guard a filter.

    Example:

    set x25 access security dte class Default -
      remote dte match_all -
      rights identifiers (FILT_FILTER_1_NONE,APPL_APPLICATION_0_NONE)

6  –  security_filter

    set  [node node-id] x25 access security filter filter-name -
          acl access-control-list

    acl

    Default: No acl        Value: Access control list

    Access control list that is used for checking inbound calls for
    all filters using this security filter. Wildcards can be
    used in the identifiers that form part of each Access Control
    Entry (ACE) in an Access Control List (ACL).

    Example:

    set x25 access security filter Default acl -
        ((identifier= (Default_ALL), access = ALL), -
         (identifier= (Default_REMOTE), access = REMOTE_CHARGE), -
         (identifier= (Default_NONE), access = NONE))

7  –  template

    set  [node node-id] x25 access template template-name ...

    Modifies an x25 access template entity, which is used to supply
    default values for call parameters when an outgoing call is made.
    The modifiable attributes and their data types [in brackets] are:

    call data [hex-string]
    calling address extension [nsap-address]
    charging information [boolean]
    destination dte address [dte-address]
    dte class [simplename]
    end-to-end delay [range]
    expedited data [Not Specified, Use, or Do Not Use]
    fast select [string]
    local facilities [hex-string]
    local subaddress [dte-address]
    network user identity [hex-string]
    nsap mapping [boolean]
    packet size [integer]
    quality of service [hex-string]
    reverse charging [boolean]
    rpoa sequence [sequence of hex-string]
    selected group [simplename]
    target address extension [nsap-address]
    throughput class request [range]
    transit delay selection [range]
    window size [integer]

7.1  –  call_data

    Default: No call user data                   Value: Hex string

    Call user data to be sent in the call.

    Example:

    set x25 access template "OSI Transport" call data '03010100'H

7.2  –  calling_address_extension

    Default: No NSAP address                     Value: NSAP address

    Calling Network Service Access Point (NSAP) address is to be
    passed to a higher-level entity within the called DTE. A null
    address indicates that this facility is not included in the
    outgoing call.

7.3  –  charging_information

    Default: False                              Value: True or false

    Specifies whether charging information is requested for this
    call.

    Example:

    set x25 access template "OSI Transport" -
        charging information false

7.4  –  destination_dte_address

    Default: No DTE address                     Value: DTE address

    Address of the remote DTE, including the remote subaddress (if
    any), to which the call is directed.

    Example:

    set x25 access template TEMPLATE-0 -
        destination dte address 3234234234

7.5  –  dte_class

    Default: No DTE class name                  Value: simplename

    Name of the DTE class to be used for the call.

    set x25 access template TEMPLATE-0 dte class remote-class-0

7.6  –  end-to-end_delay

    Default: [0..0]                 Value: Range (see description)

    Lower and upper bounds of the acceptable end-to-end delay for the
    call. A zero value for either bound indicates that no range is
    included in the outgoing call.

    Example:

    set x25 access template X29Server end-to-end delay [0..0]

7.7  –  expedited_data

    Default: Not specified                   Value: See description

    Specifies whether expedited data is requested for the call.

    do not use     Expedited data is not in use.

    not            Expedited data is not requested.
    specified

    use            Expedited data is in use.

    Example:

    set x25 access template Default expedited data not specified

7.8  –  fast_select

    Default: Not specified                  Value: See description

    Specifies whether fast select is requested for the call.

      fast select    Fast select is in use.

      no fast        Fast select is not in use.

      select not     Fast select is not requested.

      specified      Fast select with response is in use.
      with response

    Example:

    set x25 access template "OSI Transport" fast select not specified

7.9  –  local_facilities

    Default: No facilities                        Value: Hex string

    Non-CCITT facilities that are available from the local PSDN.
    The string is placed in the outgoing call request packet without
    modification. The contents and interpretation of this string are
    implementation-dependent.

7.10  –  local_subaddress

    Default: No DTE address                      Value: DTE address

    Local subaddress to be appended to the calling DTE address in the
    call.

7.11  –  network_user_identity

    Default: No network user identity            Value: Hex string

    Network user identity to be included in the call packet. The
    format of the network user identity is specified by the PSDN
    administration.

    Example:

    set x25 access template TEMPLATE-0 network user identity %x12fe

7.12  –  nsap_mapping

    Default: False                              Value: True or false

    Specifies whether an x25 access reachable address entity is used
    to map the supplied NSAP address to a destination DTE class/DTE
    address pair.

    Example:

    set x25 access template TEMPLATE-0 nsap mapping false

7.13  –  packet_size

    Default: Supplied by profile                Value: 0-4096

    Packet size, in octets, for transmitted and received data
    packets. The value must be a power of 2 in the range 0 to 4096.
    The value zero indicates that no packet size is included in the
    outgoing call.

    Example:

    set x25 access template TEMPLATE-0 packet size 512

7.14  –  quality_of_service

    Default: No data                            Value: Hex string

    Quality of service data. The contents and interpretation of this
    string are implementation-dependent.

7.15  –  reverse_charging

    Default: False                              Value: True or false

    Specifies whether reverse charging is requested for the call.

    Example:

    set x25 access template TEMPLATE-0 reverse charging false

7.16  –  rpoa_sequence

    Default: No DTE addresses              Value: Set of DTE addresses

    Private Operating Agency sequence of transit networks to be used
    in setting up the call. Format the values to specify a set of
    DTE addresses. Each DTE address is four digits long. An empty set
    indicates that no sequence is included in the outgoing call.

7.17  –  selected_group

    Default: No group name                        Value: simplename

    Name of the x25 protocol group entity that represents the CUG
    selected for the call. The index for group is included in the
    facility field of the call request packet.

7.18  –  target_address_extension

    Default: No NSAP address                      Value: NSAP address

    Called NSAP address to be sent to the called DTE should be
    supplied by a higher-level entity in the calling DTE. A null
    address indicates that this facility is not required.

7.19  –  throughput_class_request

    Default: [0..0]       Value: Range (see the following
                                        description)

    Minimum acceptable throughput class (the lower bound of the
    range) and the target throughput class (the upper bound of the
    range) for a call. The only legal range values are as follows:

    0              2400
    75             4800
    150            9600
    300            19200
    600            48000
    1200

    The range 0-0 indicates that no throughput class is
    included in the outgoing call.

    Example:

    set x25 access template TEMPLATE-0 -
        throughput class request [0..0]

7.20  –  transit_delay_selection

    Default: 0                                       Value: Integer

    Desired transit delay. A zero value for either bound indicates
    that no value is included in the outgoing call.

    Example:

    set x25 access template X29Server transit delay selection 0

7.21  –  window_size

    Default: Supplied by profile                     Value: 0-127

    Window size for transmitted and received data packets. A zero
    value indicates that no window size is included in the outgoing
    call.

    Example:

    set x25 access template TEMPLATE-0 window size 7
Close Help