configx25.dat(4) CLIX configx25.dat(4)
NAME
configx25.dat - X.25 network interface configuration file
DESCRIPTION
The /etc/configx25.dat file is read by the configx25 program at system
boot to configure the X.25 network interface. The configx25.dat file is a
text file containing configuration information that defines how the X.25
board should be configured for operation.
A detailed description of each parameter in the configx25.dat file
follows:
boot_file pathname
Specifies by full pathname the executable image that runs on the
X.25 board. The specified file must reside on the root file
system. The file /boot/X25 is the default boot file and is used
for delivery. This parameter is required.
ppa ppa_name
Specifies the name of the physical point of attachment. The
ppa_name variable must be in the format xcn, where n is 0 or 1.
There are two ports per board, thus xc0 and xc1 refer to ports 0
and 1 on the X.25 board. A separate entry of this parameter is
required for each attachment point. This parameter is required.
dte
dce Specifies whether to use data terminating equipment (DTE)
addressing or data circuit-terminating equipment (DCE) addressing.
Either dte or dce can be specified. If this parameter is not
specified, the default addressing is DTE. The DTE addressing is
the mode of operation for a workstation or server connected to a
Public Data Network. This parameter is optional.
pdn_type type
Determines the type of Public Data Network to which the workstation
or server is connected. Valid choices are telenet, datexp,
transpac, pss, datapak, ddn, accunet, datapac, and tymnet. The
default type is telenet. This parameter is optional.
line_speed speed
Specifies the speed of the line in bits per second. Valid choices
are 50, 75, 150, 300, 600, 1200, 2400, 4800, 9600, 19200, 38400,
48000, 56000, 64000, 128000, 256000, 512000, 1024000, 1544000, and
2048000. The default line speed is 9600. This parameter is
optional.
max_frame_len length
Specifies the maximum frame length that can be transmitted over the
X.25 network. This length includes overhead for headers and frame
2/94 - Intergraph Corporation 1
configx25.dat(4) CLIX configx25.dat(4)
check sequence (total of 7 bytes). Valid choices for length are
integers from 39 to 519. The default length is 135. This
parameter is optional.
o_iframes number
Specifies the number of outstanding information frames (packets)
allowed on the X.25 connection. Valid choices are integers from 1
to 7. The default is 2. This parameter is optional.
addr address
Specifies the local address of the physical line. The address can
vary in length from 1 to 15 integers. Valid integers in the
address are from 0 to 9. There is no default value for address.
This parameter is required.
flow_neg
Specifies subscription to the flow-control negotiation facility.
The default setting is no subscription to flow-control negotiation.
This parameter is optional.
def_ips size
Specifies the default incoming packet size to use if flow-control
negotiation is subscribed to. Valid choices for size are integers
in powers of 2 from 32 to 512. The default size is 128. This
parameter is optional.
def_ops size
Specifies the default outgoing packet size if flow-control
negotiation is subscribed to. Valid choices for size are integers
in powers of 2 from 32 to 512. The default size is 128. This
parameter is optional.
def_iws size
Specifies the default incoming window size if flow-control
negotiation is subscribed to. Valid choices for size are integers
from 1 to 7. The default size is 2. This parameter is optional.
def_ows size
Specifies the default outgoing window size if flow-control
negotiation is subscribed to. Valid choices for size are integers
from 1 to 7. The default value for size is 2. This parameter is
optional.
through_neg
Specifies that the throughput negotiation facility has been
subscribed to. The default setting is no subscription to
throughput negotiation. This parameter is optional.
def_itc class
Specifies the incoming throughput class if the throughput
negotiation facility is subscribed to. Valid choices for class are
2 Intergraph Corporation - 2/94
configx25.dat(4) CLIX configx25.dat(4)
75, 150, 300, 600, 1200, 2400, 4800, 9600, 19200, and 48000. The
default class is 48000. This parameter is optional.
def_otc class
Specifies the outgoing throughput class if the throughput
negotiation facility is subscribed to. Valid choices for class are
75, 150, 300, 600, 1200, 2400, 4800, 9600, 19200, and 48000. The
default class is 48000. This parameter is optional.
cug Specifies subscription to a closed user group. The default setting
is no subscription to a closed user group. This parameter is
optional.
pref_cug
Specifies subscription to a preferential closed user group. The
default setting is no subscription to a preferential closed user
group. This parameter is optional.
cug_oa Specifies subscription to a closed user group with outgoing access.
The default setting is no subscription to a closed user group with
outgoing access. This parameter is optional.
h_pvc_lcn number
Specifies the highest logical channel number for permanent virtual
circuits. Valid choices for number are integers from 1 to 4095.
The default setting is no permanent virtual circuits. If permanent
virtual circuits are specified, h_pvc_lcn must correspond to the
number of permanent virtual circuits. If h_pvc_lcn is specified,
the parameters lic, hic, ltc, htc, loc, and hoc must also be
specified. This parameter is optional.
The parameters lic, hic, ltc, htc, loc, and hoc have a different range of
values depending on whether the X.25 board is configured to operate using
DTE addressing or DCE addressing. The following description is for a
board configured to use DTE addressing (as specified with the dte
parameter). These parameters are optional. However, if one of these
parameters is specified, they all must be specified.
lic number Specifies the lowest logical channel number for incoming
calls. Valid choices for number are integers from the value
specified with h_pvc_lcn to 4095. The default lic number is
0. This parameter is optional.
hic number Specifies the highest logical channel number for incoming
calls. Valid choices for number are integers from the value
specified with lic to 4095. The default hic number is 0.
This parameter is optional.
ltc number Specifies the lowest logical channel number for incoming and
outgoing (two-way) calls. Valid choices for number are
integers from the value specified with hic to 4095. The
2/94 - Intergraph Corporation 3
configx25.dat(4) CLIX configx25.dat(4)
default ltc number is 1. This parameter is optional.
htc number Specifies the highest logical channel number for incoming and
outgoing (two-way) calls. Valid choices for number are
integers from the value specified with ltc to 4095. The
default htc number is 200. This parameter is optional.
loc number Specifies the lowest logical channel number for outgoing
calls. Valid choices number are integers from the value
specified with htc to 4095. The default loc number is 200.
This parameter is optional.
hoc number Specifies the highest logical channel number for outgoing
calls. Valid choices are integers from the value specified
with loc to 4095. The default hoc number is 200. This
parameter is optional.
The following parameters are for an X.25 board configured to use DCE
addressing:
loc number
Specifies the lowest logical channel number for outgoing calls.
Valid choices are integers from the value specified with h_pvc_lcn
to 4095. The default loc number is 0.
hoc number
Specifies the highest logical channel number for outgoing calls.
Valid choices are integers from the value specified with loc to
4095. The default hoc number is 0.
ltc number
Specifies the lowest logical channel number for incoming and
outgoing (two-way) calls. Valid choices are integers from the
value specified with hoc to 4095. The default ltc number is 1.
htc number
Specifies the highest logical channel number for incoming and
outgoing (two-way) calls. Valid choices are integers from the
value specified with ltc to 4095. The default htc number is 200.
lic number
Specifies the lowest logical channel number for incoming calls.
Valid choices are integers from the value specified with htc to
4095. The default lic number is 200.
hic number
Specifies the highest logical channel number for incoming calls.
Valid choices are integers from the value specified with lic to
4095. The default hic number is 200.
no_of_svc number
4 Intergraph Corporation - 2/94
configx25.dat(4) CLIX configx25.dat(4)
Specifies the number of switched virtual circuits that are allowed
for a particular PPA. Valid choices for number are integers from 1
to 64. The default no_of_svc number is 20. If the default is not
used, no_of_svc must be set so the total number of virtual circuits
on an X.25 board does not exceed 64.
The following parameters are used to set up permanent virtual circuits.
If permanent virtual circuits are specified, h_pvc_lcn must also be
specified.
pvc_lcn number
Specifies the logical channel number to use for this permanent
virtual circuit. Valid choices for number are integers from 1 to
h_pvc_lcn. The default setting is no permanent virtual circuits.
If pvc_lcn is specified, called_addr must also be specified. This
parameter is optional.
called_addr address
Specifies the address of the remote DTE. Valid choices for address
are 1 to 15 decimal digits. If called_addr is specified, pvc_lcn
must also be specified. This parameter is optional.
iws size
Specifies the incoming window size for this permanent virtual
circuit. Valid choices for size are integers from 1 to 7. The
default value for size is 2. This parameter is optional.
ows size
Specifies the outgoing window size for this permanent virtual
circuit. Valid choices for size are integers from 1 to 7. The
default value for size is 2. This parameter is optional.
ips length
Specifies the incoming packet length for this permanent virtual
circuit. Valid choices for length are integers from 1 to the value
of max_frame_len. The default value for length is 128. This
parameter is optional.
ops length
Specifies the outgoing packet length for this permanent virtual
circuit. Valid choices for length are integers from 1 to the value
of max_frame_len. The default value for length is 128. This
parameter is optional.
EXAMPLES
In the following example configuration file, a semicolon (;) anywhere in
the file indicates a comment region to the right of the semicolon.
boot_file /etc/X25NET333 ;name of boot file
2/94 - Intergraph Corporation 5
configx25.dat(4) CLIX configx25.dat(4)
;Set up parameters for PPA xc0
ppa xc0 ;physical point of attachment
dte ;DTE/DCE addressing
pdn_type telenet ;public data network type
line_speed 9600 ;clock rate of modem
max_frame_len 519 ;maximum data size + 7
o_iframes 7 ;max # of outstanding I frames
addr 100100100001 ;DTE address
flow_neg ;subscribe to flow negotiation
def_ips 512 ;default incoming packet size
def_ops 512 ;default outgoing packet size
def_iws 7 ;default incoming window size
def_ows 7 ;default outgoing window size
through_neg ;subscribe to throughput negotiation
def_itc 48000 ;default incoming throughput class
def_otc 48000 ;default outgoing throughput class
cug ;subscribe to a closed user group
pref_cug ;subscribe to a preferential CUG
cug_oa ;subscribe to CUG w/ outgoing access
;Set up parameters for PPA xc1
ppa xc1 ;physical point of attachment
dce ;DTE/DCE addressing
pdn_type telenet ;public data network type
line_speed 9600 ;clock rate of modem
max_frame_len 519 ;maximum data size + 7
o_iframes 7 ;max # of outstanding I frames
addr 100100100003 ;DTE address
flow_neg ;subscribe to flow negotiation
def_ips 128 ;default incoming packet size
def_ops 128 ;default outgoing packet size
def_iws 2 ;default incoming window size
def_ows 2 ;default outgoing window size
through_neg ;subscribe to throughput negotiation
def_itc 9600 ;default incoming throughput class
def_otc 9600 ;default outgoing throughput class
cug ;subscribe to a closed user group
pref_cug ;subscribe to a preferential CUG
cug_oa ;subscribe to CUG w/ outgoing access
h_pvc_lcn 1 ;highest PVC LCN
loc 2 ;lowest LCN for outgoing calls.
hoc 15 ;highest LCN for outgoing calls.
ltc 16 ;lowest LCN for two-way calls.
htc 25 ;highest LCN for two-way calls.
lic 26 ;lowest LCN for incoming calls.
hic 40 ;highest LCN for incoming calls.
;Set up a permanent virtual circuit
6 Intergraph Corporation - 2/94
configx25.dat(4) CLIX configx25.dat(4)
pvc_lcn 1 ;LCN for this PVC
called_addr 1234567 ;address of remote DTE
iws 7 ;incoming window size
ows 7 ;outgoing window size
ips 512 ;incoming packet size
ops 512 ;outgoing packet size
FILES
/etc/configx25.dat Configuration file for the X.25 network interface.
/etc/X25NET333 Default boot file.
RELATED INFORMATION
Commands: configx25(8)
2/94 - Intergraph Corporation 7