Requires Optional LAN/X.25 Software

NAME

x3config − PAD-related X.3 configuration file

DESCRIPTION

x3config is an ASCII file in directory /etc/x25 that contains X.3 configuration information for X.25 PAD (packet assembler/disassembler) components padem, x29printd, x29server, and x29uucpd. x3config contains many different terminal-specific characteristics or actions that the hosts want the remote PAD, PAD support, or PAD emulation to take upon receipt of specific input from the hosts or from the remote PAD device.  x3config contains different configuration groups that the user can choose to use as initial X.3 parameters.  The groups of X.3 parameters are referenced by X.3 configuration set names in the file /etc/x25/x29hosts. 

x3config contains the following information:

• X.3 Configuration Set Name

• X.3 Parameter

• Corresponding Parameter Value

• Comment Lines

The x3config file is made up of one or more X.3 configuration sets.  Each X.3 configuration set has its own configuration entry consisting of X.3 parameters and corresponding values (each parameter-value pair on a separate line) enclosed in curly braces {}, and preceeded by the X.3 configuration set name (and profile).  The X.3 configuration set name is defined by the administrator, and maps to the PAD configuration entries in file /etc/x25/x29hosts.  The administrator can also define profile identification numbers profile_ids for X.3 configurations.  prof_id is an integer number that is used by padem as the method of referencing X.3 configurations.  prof_id immediately follows x3_config_set_name and a colon (:).  A typical X.3 x3config configuration set is constructed as follows:

x3_config_set_name {
# <X.3 parameter> <value1> <value2>
         1           1        1
         2           1        1
         .           .        .
         .           .        .
         .           .        .
        22           0        0
}

Parameter interpretation is as follows:

x3_config_set_name A string that identifies the accompanying set of parameter-value pairs enclosed within curly braces.  Each X.3 configuration set name should be unique.  x3_config_set_name must be concatenated with a profile ID when defining the X.3 configuration for padem (see padem(1)).

X.3 Parameter An integer whose value ranges from 1 through 22 and defines the type of X.3 parameter the user is requesting. 

Parameter Value Assigns a value to the corresponding X.3 parameter.  Only certain values are recognized for each specific X.3 parameter.  value1 refers to line-mode processing.  value2 refers to raw-mode processing. 

Comment Lines Comment lines begin with a # character, and any characters following the # character are treated as comments (ignored). 

X.3 parameters are initially set from the x3config file.  They can also be set by applications that rely on specific terminal I/O options.  X.3 parameters are used to control I/O options between the host and the PAD device, and are analogous to host-to-terminal I/O options.  For example, baud rate and parity must be set to appropriate values before a host and terminal can communicate correctly.  X.3 parameters provide a means for defining how communication is to be handled between the host and the PAD. 

Here is a summary of the list of X.3 CCITT Parameters:

X.3 Parameter Description

1 Escape From Data Transfer

0 Not possible

1 Possible with DLE

32-126 Possible with defined character

2 Echo

0 No echo 1 Echo

3 Data Forwarding Signal

0 No data forwarding character

1 Alphanumerics

2 Carriage return

4 ESC, BEL, ENQ, ACK

8 DEL, CAN, DC2

16 ETX, EOT

32 HT, LF VT, FF

64 All other characters

127 All characters are for data forwarding

4 Idle Timer

0 No Time Out

1-255 Increments of 1/20 of a second

5 Ancillary Device Control

0 No use of XON and XOFF

1 Use of XON and XOFF for flow control

6 Pad Service Signals

0 No Service Signals

1 Service Signals other than prompt

4 Prompt Service Signal

5 (1+4)

7 Procedure on Break

0 Nothing

1 INTERRUPT

2 RESET

4 Indication of break pad message

8 Escape from data transfer

16 Discard output

21 (1+4+16)

8 Discard Output

0 Normal Data Delivery

1 Discard Output

9 Carriage Return Padding

0 No Padding

1-7 Padding Characters

10 Line Folding

0 No Line Folding

1-255 Number of characters per Line

X.3 Parameter Description

11 Terminal Speed

Value	Speed		Value	Speed
0	110		9	100
1	134.5		10	50
2	300		11	75/1200
3	1200		12	4800
4	600		14	9600
5	75		15	19200
6	150		16	48000
7	1800		17	56000
8	200		18	64000

12 PAD Flow Control by the Terminal

0 No use of XON and XOFF

1 Flow control by use of XON and XOFF

13 Line-Feed Insertion

0 No LF insertion

1 Insert LF after each CR to the terminal

2 Insert LF after each CR from the terminal

4 Insert LF after each CR sent as echo to the terminal

5 (1+4)

6 (2+4)

7 (1+2+4)

14 Linefeed Padding

0 No LF padding

1-7 Padding characters

15 Editing

0 No editing during data transfer

1 Editing during data transfer

16 Character Delete

0-127 Delete Character

17 Line Delete

0-127 Line-delete Character

18 Line Display

0-127 Line-display character

19 Editing PAD Service Signals

0 No editing PAD service signal

1 Editing PAD service signals for printing terminals

2 Editing PAD service signals for displaying terminals

8, 32-126
Editing PAD service signals using one character from decimal 8 or the range of decimal 32 through 126

20 Echo Mask

0 No echo mask at all

1 No echo of CR

2 No echo of LF

4 No echo of VT, HT, FF

8 NO echo of BEL, BS

16 No echo of ESC, ENQ

32 No echo of ACK, NAK, STX, SOH, EOT, ETB, ETX

64 No echo of editing characters as designated by Parameter 16, 17, 18

128 No echo of all other characters in columns 0 and 1 not mentioned above and DEL

All possible combination from above
in the range 1 through 127 can be used for parameter 20.

21 Parity Treatment

0 parity checking or generation

1 Parity checking

2 Parity generation

3 Parity checking and generation

22 Page Wait

0 Page-wait disabled

1-255 Number of line feed characters considered by the PAD for the page-wait function

EXAMPLES

Here is a sample X.3 configuration file:

# Sample x3config file

hp_padsrvr {
# <parameter> <value1> <value2>
      1          1        1
      2          1        1
      3         94      127
      4          0        0
      5          1        1
      6          5        5
      7         21       21
      8          0        0
      9          0        0
     10         0        0
     11        14       14
     12         1        1
     13         0        0
     14         0        0
     15         0        1
     16         8        8
     17        24       24
     18         0        0
     19         1        1
     20         0        0
     21         0        0
     22         0        0
}

hp_profile : 0 {
# <parameter> <value>
       1        1
       2        1
       3      127
       4        0
       5        1
       6        5
       7       21
       8        0
       9        0
      10        0
      11       14
      12        1
      13        0
      14        0
      15        1
      16        8
      17       24
      20        0
      21        0
      22        0
}

AUTHOR

x3config was developed by HP. 

SEE ALSO

x29server(1M), x29printd(1M), x29uucpd(1M), padem(1), x29hosts(4). 
InstallingandAdministeringX.25/9000. 

Hewlett-Packard Company  —  HP-UX Release 9.10: April 1995