x25init_smpl(4)

Requires Optional LAN/X.25 Software

NAME

x25init_smpl − sample configuration file used to initialize an X.25 interface.

DESCRIPTION

To simplify and automate X.25 interface configuration, an ASCII file containing some or all X.25 interface configuration parameters and values can be created for use by the x25init command (see x25init(1M)). x25init then uses the file’s contents to load the configuration data structures in the X.25 interface. A sample configuration file, x25init_smpl, is distributed with the system, and can be customized to suit the needs of each installation. To configure the interface, use the command form:

x25init -cconfig_file

See x25init(1M) for more information about command usage.

The X.25 configuration file is arranged in a command-like structure such that configuration parameters and their assigned values are listed, line-by-line, in an easily understood format. Individual entries in the file can appear in any order, but only one entry is allowed on each line. Many parameters can be specified using an abbreviated form.

Syntax

Entires in the configuration file have the form:

parameter_name parameter_value

Where:

parameter_name Specifies a keyword identifying a particular configuration parameter. Some examples are X121, device, and framesize.

parameter_value Specifies the desired value for the corresponding parameter.

Blank lines, leading spaces, and trailing spaces are ignored. The # character and anything that follows it on a given line is treated as a comment. If a parameter is specified more than once in the configuration file, the value of the last entry for that parameter is used.

Parameters

X.25 configuration parameters fall into the following categories:

Required: Required parameters must be specified, and include:

X.121 address
device file
X.25 Programmatic Access name

Level 2: Used to define X.25 Level 2 (data link layer) characteristics:

framesize
level-2 window
retransmission count
T1 timer
T3 timer

Level 3: Used to define X.25 level 3 (network layer) characteristics:

circuit table definition	default inbound packet size
default outbound packet size	default inbound throughput size
default outbound throughput size	default inbound window size
default outbound window size	flow control negotiation
network type	fast select accept
negotiated inbound packet size	negotiated outbound packet size
negotiated inbound throughput class	negotiated outbound throughput class
negotiated inbound window size	negotiated outbuond window size
reverse charge accept	X.121 packet[addr]
PVC inbound packet size	PVC outbound packet size
PVC inbound throughput class	PVC outbound throughput class
PVC inbound window size	PVC outbound window size
throughput class negotiation

IP Related: Used to define the IP-related characteristics:

hold timer	idle timer
internet (IP) address	maximum transmission unit
maximum circuits

Parameter Definitions

The following configuration parameters and values are recognized:

lci start_num type how_many
(Level 3 parameter) Specifies the circuit table definition for the system; includes the starting value of the logical channel identifier, the type of virtual circuits, and the number of each type.

def_inpacket [size] size
(Level 3 parameter) Specifies the default maximum size, in octets, of a level-3 packet when flow control negotiation is off.

def_inthruput [class] class
(Level 3 parameter) Specifies the maximum allowable inbound data transmission rate in bits per second on a switched virtual circuit when throughput class is not negotiated.

def_inwindow size (Level 3 parameter) Specifies the default maximum number of unacknowledged inbound packets between the DTE and the DCE when flow control negotiation is off.

def_outpacket [size] size
(Level 3 parameter) Specifies the default maximum size, in octets, of a level-3 outbound packet when flow control negotiation is off.

def_outthruput [class] class
(Level 3 parameter) Specifies the maximum allowable outbound data transmission rate in bits per second on a switched virtual circuit when throughput class is not negotiated. The value of class can be expressed in bits per second: 75, 150, 300, 600, 1200, 2400, 4800, 9600, 19200, 48000, or the corresponding CCITT class numbers: 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12.

def_outwindow size (Level 3 parameter) Specifies the default maximum number of unacknowledged outbound packets between the DTE and the DCE when flow control negotiation is off.

device name (Required parameter) Specifies the interface card driver device file name found in the /dev directory.

fast_select_accept enabled

fast_select_accept disabled
(Level 3 parameter) Specifies whether or not the fast select facility is allowed. When fast select is enabled, up to 128 octets of user data can be sent with the call set-up and clear packets.

flow[control] on

flow[control] off (Level 3 parameter) Specifies flow control negotiation, which involves choosing the level-3 packet size and level-3 window size.

frame [size] n

n1 (Level 2 parameter) Specifies the maximum number of octets that can be transmitted in one frame. Either framesize or n1 can be specified as the parameter name.

hold [timer] timer (IP-related parameter) Specifies the hold timer in seconds.

idle [timer] timer (IP-related parameter) Specifies the idle timer in seconds.

IP [address] address [subnet_mask]
(IP-related parameter) Specifies the Internet address for the system if IP is to be used. The Internet address is expressed in dot notation.

l2window

k size (Level 2 parameter) Specifies the maximum number of unacknowledged frames between the DTE and the DCE. Either l2window or k can be specified as the parameter name.

max_circuit count (Level 3 parameter) Specifies the maximum number of virtual circuits that can be open at one time.

mtu size (IP-related parameter) Specifies the maximum number of octets that can be transmitted in one IP packet.

neg_inpacket [size] size
(Level 3 parameter) Specifies the maximum size, in bytes, of a level-3 inbound packet when flow control negotiation is on.

neg_inthruput [class] class
(Level 3 parameter) Specifies the maximum allowable inbound data transmission rate in bits per second on a switched virtual circuit when throughput class is negotiated. The value of class can be expressed in bits per second: 75, 150, 300, 600, 1200, 2400, 4800, 9600, 19200, 48000, or the corresponding CCITT class numbers: 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12.

neg_inwindow size (Level 3 parameter) Specifies the maximum number of unacknowledged inbound packets between the DTE and DCE when flow control negotiation is turned on.

neg_outpacket [size] size
(Level 3 parameter) Specifies the maximum size, in octets, of a level-3 outbound packet when flow control negotiation has been turned on.

neg_outthruput [class] class
(Level 3 parameter) Specifies the maximum allowable outbound data transmission rate in bits per second on a switched virtual circuit when throughput class is negotiated. The value of class can be expressed in bits per second: 75, 150, 300, 600, 1200, 2400, 4800, 9600, 19200, 48000, or the corresponding CCITT class numbers 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12.

neg_outwindow size (Level 3 parameter) Specifies the maximum number of unacknowledged outbound packets between the DTE and the DCE when flow control negotiation has been turned on.

networktype user_defined_network_name
(Level 3 parameter) Specifies the network interface type. The network type specified must match the line configuration of the host. Network type names and their associated characteristics are specified in an editable file used to identify the network to the subsystem.

name name (Level 3 parameter) Supplies the programmatic access name used for programmatic access to X.25 at level 3.

pvc_inpacket [size] size
(Level 3 parameter) Specifies the maximum size, in octets, of a level-3 inbound packet on a permanent virtual circuit.

pvc_inthruput [class] class
(Level 3 parameter) Specifies the maximum allowable inbound data transmission rate in bits per second on a permanent virtual circuit. The value of class is expressed in either bits per second: 75, 150, 300, 600, 1200, 2400, 4800, 9600, 19200, or the corrsponding CCITT class numbers: 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12.

pvc_inwindow size (Level 3 parameter) Specifies the maximum number of unacknowledged inbound packets between a DTE and a DCE on a permanent virtual circuit.

pvc_outpacket [size] size
(Level 3 parameter) Specifies the maximum size, in octets, of a level-3 outbound packet on a permanent virtual circuit.

pvc_outthruput [class] class
(Level 3 parameter) Specifies the maximum allowable outbound data transmission rate in bits per second on a permanent virtual circuit. The value of class can be expressed in either bits per second: 75, 150, 300, 600, 1200, 2400, 4800, 9600, 19200, or the corresponding CCITT class numbers: 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12.

pvc_outwindow size (Level 3 parameter) Specifies the maximum number of unacknowledged outbound packets between DTE and DCE on a permanent virtual circuit.

n2 count (Level 2 parameter) Specifies the number of times a frame can be retransmitted when an error occurs.

reverse_charge_accept enabled

reverse_charge_accept disabled
(Level 3 parameter) Specifies whether or not reverse charging and reverse charging accepted are supported. A DTE that subscribes to reverse charging can request, on a per-call basis, that the remote DTE pay for the call. Reverse charging acceptance authorizes the driver to pass to the application any calls requesting reverse charging. If this facility is disabled, the local DCE rejects any incoming calls that request reverse charging.

t1 time (Level 2 parameter) Specifies the amount of time to wait for acknowledgement of a frame.

t3 time (Level 2 parameter) Specifies the idle time.

thruputclass on

thruputclass off (Level 3 parameter) Specifies the throughput class negotiation between peers.

X.121address (Required parameter) Specifies the X.121 address of your system. The value of address can be up to 15 digits.

X.121_packet[addr] (Level 3 parameter) Specifies the X.121 packet address of any network of which there are special characteristics. An example of some network types are TRANSPAC, DDN and TYMNET. When using these and other networks known to require this parameter, the value should be expressed as 15 digits enclosed in single quotes. For these networks, a value should be specified for this parameter in addition to the standard X.121 address parameter.

DIAGNOSTICS

If an error is encountered while parsing the commands in a configuration file, x25init reports the error and continues parsing the remainder of the file. At the end of the file, x25init exits without initializing the X.25 interface.

EXAMPLES

Here are two entries as they might appear in a typical configuration file:

X.121 4085551212
framesize 256

DEPENDENCIES

Use of the parameters fast_select_accept and reverse_charge_accept is dependent upon subscription to these facilities from the network provider.

AUTHOR

x25init_smpl was developed by HP.

NOTES

The configuration file can be built interactively through use of the x25init interactive user interface. Refer to x25init(1M) for an explanation of how to use the x25init interface.

Museum

Related Articles