NCLHELP.HLB  —  set  frame (OpenVMS)

1  –  link

    set  [node node-id] frame link link-id ...

    Modifies the attributes for an frame link entity, which is
    associated with a physical line and controls the framing protocol
    used on that line.  The modifiable attributes and their data
    types [in brackets] are:

    bisync code [ASCII-or-EBCDIC]
    bits per character [integer]
    buffer size [integer]
    crc type [crc-type]
    framing timer [milliseconds]
    initial state one [state-info]
    initial state two [state-info]
    local station address [integer]
    match station address [on-or-off]
    number of buffers [integer]
    physical line [local-entity-name]
    sync character [octet]
    sync count [integer]

    Examples:

    set frame link frame-0 bisync code EBCDIC, -
        framing timer 25, number of buffers 6

    set frame link frame-1 match station address on

1.1  –  bisync_code

    Default: EBCDIC        Value: ASCII or EBCDIC

    Character code to be used on the link. This characteristic is
    supported only when the characteristic protocol is set to one of
    the following: bisync, chips, genbyte, or swift. You can modify
    this characteristic only when the entity is disabled.

1.2  –  bits_per_character

    Default: 8             Value: 5-8

    Number of bits in each character. This characteristic is
    supported only when the characteristic protocol is set to
    genbyte. You can modify this characteristic only when the entity
    is disabled.

1.3  –  buffer_size

    Default: 512           Value: 0-65535

    Size, in octets, of each receive buffer for the link. You can
    modify this characteristic only when the entity is disabled.
    Also, you can only increase the characteristic value.

1.4  –  crc_type

    CRC type used on the link:

    AUTO_DIN
    CRC_16
    CRC_CCITT
    CRC_CCITT0
    LRC_EVEN
    LRC_ODD
    LRC_VRC_
    EVEN
    LRC_VRC_
    ODD
    NONE

    The default value depends on the protocol.

    BISYNC   CRC_16
    CHIPS    LRC_EVEN
    DDCMP    CRC_16
    GENBYTE  NONE
    HDLC     CRC_CCITT
    SDLC     CRC_CCITT
    SWIFT    CRC_16

    genbyte crc checking is done in the genbyte framing routine.

1.5  –  framing_timer

    Default: 25            Value: 10-1000

    Maximum length of time, in milliseconds, to wait for the next
    character to arrive. This characteristic is supported only when
    the characteristic protocol is set to genbyte.

1.6  –  initial_state_one

    Default: 4

    First 32 bits of state information. This characteristic is
    supported only when the characteristic protocol is set to
    genbyte. You can modify this characteristic only when the entity
    is disabled.

1.7  –  initial_state_two

    Default: 4

    Last 32 bits of state information. This characteristic is
    supported only when the characteristic protocol is set to
    genbyte. You can modify this characteristic only when the entity
    is disabled.

1.8  –  local_station_address

    Default: 255           Value: 0-255

    Address of the local station. The default value means that only
    broadcast messages are accepted. The interpretation of this
    characteristic is controlled by the value of the characteristic
    match station address.

    This attribute is supported only if the characteristic protocol
    is set to sdlc. You can modify this characteristic only when the
    entity is disabled.

1.9  –  match_station_address

    Default: Off           Value: On or Off

    Specifies whether the value of the characteristic local station
    address is to be interpreted as a valid address. This attribute
    is supported only if the characteristic protocol is set to
    sdlc. You can modify this characteristic only when the entity
    is disabled.

1.10  –  number_of_buffers

    Default: 4             Value: 0-255

    Number of receive buffers reserved for the link. You can modify
    this characteristic only when the entity is disabled. Also, you
    can only increase the characteristic value.

1.11  –  physical_line

    Default:  none               Value:  Local entity name

    A local entity name specifying the physical layer line entity on
    which the link entity is to operate.  A non-null value must be
    set before the link can be enabled.  Can only be set when the
    link is off.

1.12  –  sync_character

    Default: See description           Value: 0-FF

    Hexadecimal code of the sync character to be used on the link.
    The default value depends on the value of the characteristic
    protocol, as follows:

    bisync   32
    chips    32
    ddcmp    96
    genbyte  32
    swift    32

    This attribute is supported only if the characteristic protocol
    is set to bisync, chips, ddcmp, genbyte, or swift. You can modify
    this characteristic only when the entity is disabled.

1.13  –  sync_count

    Default: 4             Value: 0-255

    Number of sync characters that precede each message. This
    attribute is supported only if the characteristic protocol is
    set to bisync, chips, ddcmp, genbyte, or swift. You can modify
    this characteristic only when the entity is disabled.
Close Help