Trailing-Edge
-
PDP-10 Archives
-
BB-W661A-BM_1983
-
tools/x29pad.doc
There is 1 other file named x29pad.doc in the archive. Click here to see a list.
X29PAD
TOPS-20 PSI X.29 PAD Emulator
May, 1983
Copyright (C) 1983 by
Digital Equipment Corporation,
Maynard, Massachusetts 01754
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED ONLY
IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE INCLUSION OF THE
ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER COPIES THEREOF MAY NOT
BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY OTHER PERSON. NO TITLE TO
AND OWNERSHIP OF THE SOFTWARE IS HEREBY TRANSFERRED.
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE AND
SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT CORPORATION.
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 2
INTRODUCTION 19 May 83
1.0 INTRODUCTION
X29PAD is a program that will allow a user on a TOPS20 system to connect a
terminal to a remote host through an X.25 Public Packet Switching Network
(PPSN). It is the logical equivalent of the DECnet-20 SETHOST program.
X29PAD emulates a PAD (Packet Assembly and Disassembly) in the PPSN and
transfers data to and from the remote host according to the CCITT X.29
standard.
BEWARE
X29PAD was written with the expressed goal that it communicate with any
remote host. Therefore, X29PAD has been written to adhere as closely as
possible to the CCITT X.3 standard and does not make any attempt to
understand "National PAD Parameters". X29PAD's actions will be governed by
X.3 PAD Parameters 1 through 18 only.
Please note that this is a preliminary release of X29PAD documentation.
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 3
INSTALLATION INFORMATION 19 May 83
2.0 INSTALLATION INFORMATION
2.1 Inventory
The program is supplied as source files in the PS:<TOOLS> saveset of the
TOPS-20 PSI Version 1.0 distribution tape. The files are:
X29PAD.CTL - Control file to assemble and link X29PAD
X29PAD.DOC - Document describing X29PAD installation and usage
X29PAD.EXE - Executable image of X29PAD
X29PAD.INIT - Sample .INIT file for X29PAD
X29PAD.MAC - X29PAD source file
X29PAD.RND - RUNOFF version of X29PAD.DOC
X29PAD-DEFAULT.INIT - Sample system .INIT file
2.2 Utilities
You need the following software utilities to build X29PAD.
MACRO
LINK
CREF
You will also need the following files from the TOPS20 PSI Distribution
tape:
X25GAM.REL
X25SYM.UNV
2.3 Assembling And Linking
To assemble and link X29PAD please read X29PAD.CTL.
2.4 Network Management Information
In order to gain access to the X.25 PPSN via the Gateway the user must know
the Network Name and Network Password as specified by the Network Manager
when the Gateway software was built.
2.5 Installation
To install X29PAD you must do the following:
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 4
INSTALLATION INFORMATION 19 May 83
1. Copy X29PAD.EXE to SYS:
2. Optionally, create PS:<SYSTEM>X29PAD-DEFAULTS.INIT and include any
X29PAD commands you wish all users running X29PAD to execute.
This file may include DEFINE commands to define remote host names
for your user community so that they do not need to remember long
network address strings. You may also include the SET NETWORK
NAME and SET NETWORK PASSWORD commands to preset the Gateway
Access name and password for your users. If you elect to do this,
your users will not be required to supply them to gain access to
the X.25 network via the Gateway.
3. Create PS:<SYSTEM>X29PAD-ACCOUNTING.ACT and set its protection to
770404. This file is discussed in the next section on accounting.
Note that the protection of this file MUST BE 770404 so that
unprivileged users running X29PAD will be able to append to it.
If this file does not exist, no accounting will be done until it
is created and protected accordingly.
2.6 Accounting
This initial implementation of X29PAD does a minimum of accounting.
Anytime a user runs X29PAD and issues the CALL command an accounting record
will be appended to PS:<SYSTEM>X29PAD-ACCOUNTING.ACT if the call request
gets out into the PPSN. The format of the call record is as follows:
1. Date in the form dd-mon-yy
2. Time in the form hh:mm:ss
3. User's Name
4. Terminal the user is logged in on
5. The DTE Number the user called
The following shows how PS:<SYSTEM>X29PAD-ACCOUNTING.ACT will look:
9-Mar-83 15:59:27 DEUFEL (on) TTY63 CALLED 311061799999 (2)
10-Mar-83 18:08:03 VOBA (on) TTY52 CALLED 208092099999
10-Mar-83 18:08:41 VOBA (on) TTY52 CALLED 26245214099999
11-Mar-83 09:44:48 DEUFEL (on) TTY63 CALLED 234273499999
11-Mar-83 18:38:40 VOBA (on) TTY52 CALLED 208092099999
13-Mar-83 12:12:20 MAYO (on) TTY14 CALLED 234273499999
13-Mar-83 13:04:09 WEISBACH (on) TTY207 CALLED 26245214099999
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 5
USING X29PAD 19 May 83
3.0 USING X29PAD
X29PAD is a program which will allow a user to "SET HOST" to a remote
system through the X.25 Gateway. The remote host need not be a DEC
computer.
X29PAD has the following commands:
Command Description
BREAK Perform the BREAK function and continue the call
CALL Initiate a call to a selected REMOTE-HOST
CLEAR Clear a call that was in progress
CLOSE Close the log file opened by the LOG command
DEFINE Define a REMOTE-HOST in terms of its DTE address
EXIT Exit to the EXEC
HELP Give help with X29PAD's commands and operation
INFORMATION Give information on various parameters in X29PAD
LOG Record the session in a designated log file
PUSH Push to a new EXEC
SET Set one of X29PAD's parameters
TAKE Take a command file
To learn how to obtain more information type:
X29PAD>HELP (with) HELP
or
X29PAD>HELP (with) X29PAD
3.1 BREAK
The BREAK command causes X29PAD to initiate a break sequence, perform those
functions specified by the ACTION-ON-BREAK PAD Parameter, and (if possible)
continue the call by entering data transfer mode.
3.2 CALL
The CALL command is used to initiate a terminal session with a remote host.
The command format is:
X29PAD>CALL remote-host-name
where the remote-host-name has been defined previously using the DEFINE
command. Typing a ? after CALL will list the names of the remote hosts
that have been defined up to that point.
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 6
USING X29PAD 19 May 83
Optionally, you may elect to supply the actual DTE address and subaddress.
The format is:
X29PAD>CALL dte-address dte-subaddress
where the dte-address is the number of the remote host to which you wish to
connect to and the dte-subaddress is an optional number corresponding to
the desired remote host's subaddress.
If you have not already supplied a network name and password (using the SET
NETWORK command) you will be asked to supply them before the call to the
remote-host will be placed.
3.3 CLEAR
The CLEAR command is used to disconnect a call initiated by a CALL command.
The form of the CLEAR command is:
X29PAD>CLEAR
There are no arguments or options for this command.
3.4 CLOSE
The CLOSE command terminates session logging and closes the log file that
was initiated by using the LOG command. The format of the command is:
X29PAD>CLOSE (log file!)
3.5 CONTINUE
The CONTINUE command allows the user to continue a call that was
interrupted by the typing of the ESCAPE-CHARACTER to return to command
mode. The format of this command is:
X29PAD>CONTINUE (current call)
The CONTINUE command will attempt to restart communications with the
REMOTE-HOST and will notify the user if this is not possible.
3.6 DEFINE
The DEFINE command is used to associate the name of a remote host with a
DTE address and (optionally) a DTE subaddress. The format of this command
is:
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 7
USING X29PAD 19 May 83
X29PAD>DEFINE remote-host-name (to be) dte-address dte-subaddress
where the remote-host-name is an alphanumeric string of up to 16 characters
in length, and dte-address and dte-subaddress are numeric strings of up to
15 digits in length.
The DEFINE command may also be used to remove a remote host from the remote
host table. This is done by typing a carriage return after the name of the
remote host you wish to delete. The format is:
X29PAD>DEFINE remote-host-name <carriage-return>
The DEFINE command may also be used to change the DTE address and
subaddress of a remote host that has already been defined by simply
defining the remote host again. The entry for this remote host will be
updated in the remote host table.
3.7 EXIT
The EXIT command causes X29PAD to return the user to TOPS20 command mode.
If a CALL to a REMOTE-HOST is still in progress it will be cleared. If
LOGGING was being done, the log file will be closed and logging terminated.
Typing the TOPS20 CONTINUE command will cause X29PAD to resume execution,
but you must re-enable logging manually.
3.8 HELP
The HELP command is the way a user can obtain more detailed information
relating to the operation of X29PAD than is available through the inline
help facility (i.e. "?"). The format of the HELP command is:
X29PAD>HELP (with) argument-1 argument-2 ... argument-n
where argument is a key word in the context of the command it is found in.
For example, typing the following:
X29PAD>HELP (with) SET PAD-PARAMETER IDLE-TIMER <carriage-return>
would give you a description of the IDLE-TIMER parameter which is changable
via the SET command.
In all cases, typing a "?" at any point will give you a list of optional
key words you may elect to supply or you may type a carriage-return at any
point to receive information about the last key word typed in context.
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 8
USING X29PAD 19 May 83
3.9 INFORMATION
The INFORMATION command allows you to obtain information about various
parameters and topics in X29PAD. The format of this command is:
X29PAD>INFORMATION (about) argument
where argument is one of the following:
DEFAULTS LAST-NETWORK-ERROR PAD-PARAMETERS
REMOTE-HOSTS STATUS VERSION
For more help with any of these arguments type:
X29PAD>HELP (with) INFORMATION argument
3.9.1 INFORMATION (about) DEFAULTS
The INFORMATION (about) DEFAULTS allows you to display the current defaults
for the LOG command and the TAKE command.
3.9.2 INFORMATION (about) LAST-NETWORK-ERROR
The INFORMATION (about) LAST-NETWORK-ERROR command gives the user a more
verbose description (and possible causes) of the last reported network
error. The format of the command is:
X29PAD>INFORMATION (about) LAST-NETWORK-ERROR
3.9.3 INFORMATION (about) PAD-PARAMETERS
The INFORMATION (about) PAD-PARAMETERS command allows the user to display
the current state of the PAD. The PAD (Packet Assembly and Disassembly)
parameters are the values that determine how the terminal will act and
exchange data with the remote-host. PAD parameters may be set either by
the remote-host or by the user via the SET PAD-PARAMETER command. PAD
parameters set by the remote-host are denoted by a star (*) preceeding the
parameter. The format of the command is:
X29PAD>INFORMATION (about) PAD-PARAMETERS
For more information on specific PAD parameters type:
X29PAD>HELP (with) SET PAD-PARAMETER argument
where the argument is one of the following:
ACTION-ON-BREAK CANCEL-CHARACTER CARRIAGE-RETURN-PADDING
DATA-FORWARDING DELETE-CHARACTER DISCARD-OUTPUT
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 9
USING X29PAD 19 May 83
DISPLAY-CHARACTER DTE-TO-NET-FLOW-CONTROL ECHO
ESCAPE-TO-COMMAND-MODE IDLE-TIMER LINE-WIDTH
LINEFEED-INSERTION LINEFEED-PADDING LOCAL-EDITING
NET-TO-DTE-FLOW-CONTROL PAD-SIGNAL-CONTROL RATE
3.9.4 INFORMATION (about) REMOTE-HOSTS
The INFORMATION (about) REMOTE-HOSTS command provides the user with a list
of REMOTE-HOSTS that have been defined via the DEFINE command. Each
REMOTE-HOST will have displayed the DTE address and (optionally) the DTE
subaddress associated with it.
The format of the command is:
X29PAD>INFORMATION (about) REMOTE-HOSTS
3.9.5 INFORMATION (about) STATUS (of X29PAD)
The INFORMATION (about) STATUS (of X29PAD) command gives the user a summary
of X29PAD's state and counter information. It also displays the current
NETWORK NAME and PASSWORD, ESCAPE-CHARACTER, and STATUS-DISPLAY-CHARACTER.
The format of this command is:
X29PAD>INFORMATION (about) STATUS (of X29PAD)
3.9.6 INFORMATION (about) VERSION
The INFORMATION (about) VERSION command displays the version number and
edit number of X29PAD.
3.10 LOG
The LOG command causes your terminal session to be recorded in a file
specified by the user. The format of this command is:
X29PAD>LOG (output to file) output-filespec
where output-filespec is the filename the user wishes to call the log file.
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 10
USING X29PAD 19 May 83
3.11 PUSH
The PUSH command is analogous to the TOPS20 Monitor PUSH command. This
command allows you to push to a new copy of the TOPS20 EXEC and pop back
into X29PAD at some later point in time. Popping back from the new EXEC
does not discard the EXEC you pushed to or any subsequent programs running
under it. You may PUSH back down to that EXEC and continue any programs
started by that EXEC.
3.11.1 SET
The SET command allows you to change or set various parameters and values
used by X29PAD. The format of this command is:
X29PAD>SET argument-1 argument-2 ... argument-n
where argument-1 is one of the following:
BREAK-CHARACTER DEFAULT ESCAPE-CHARACTER
NETWORK PAD-PARAMETER STATUS-DISPLAY-CHARACTER
and argument-2 through argument-n are dependent on argument-1. For more
information type:
X29PAD>HELP SET argument-1 argument-2 ... argument-n
Use "?" to find out what specific options are available for each argument.
3.11.2 SET BREAK-CHARACTER
The SET BREAK-CHARACTER command allows you to define a special character
which, when typed, will cause X29PAD to perform the actions defined by the
ACTION-ON-BREAK PAD Parameter. This action might be to discard pending
terminal output or possibly reset the network. The format of the command
is:
X29PAD>SET BREAK-CHARACTER (to) argument
where argument is the octal value for the ASCII character code you wish to
be the escape character or any printing character in double quotes. An
alternate form of this command is:
X29PAD>SET BREAK-CHARACTER (to) CONTROL argument
This form of the command is used to define the BREAK-CHARACTER to be a
control character. The argument is a printing character in double quotes.
For example, to set the BREAK-CHARACTER to CONTROL-P you would type:
X29PAD>SET BREAK-CHARACTER (to) CONTROL "P"
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 11
USING X29PAD 19 May 83
The BREAK-CHARACTER may be disabled by setting it to a value of zero. If
this is done, the user may still cause a break to occur by typing the
ESCAPE-CHARACTER followed by the BREAK command.
Note that the default BREAK-CHARACTER is CONTROL-X.
3.11.3 SET DEFAULT
The SET DEFAULT command allows you to set default values for certain X29PAD
command parameters. These parameters affect the actions performed by the
specified command. The format of this command is:
X29PAD>SET DEFAULT argument-1 argument-2 ... argument-n
where argument-1 is one of the following:
LOG TAKE
and argument-2 through argument-n are dependent on argument-1.
3.11.3.1 SET DEFAULT LOG - The SET DEFAULT LOG command allows you to set
certain defaults for the LOG command. The format of this command is:
X29PAD>SET DEFAULT (for) LOG (to) argument-1 argument-2
where argument-1 is one of the following:
APPEND NO SUPERSEDE SUPPRESS
3.11.3.1.1 SET DEFAULT LOG APPEND - The SET DEFAULT LOG APPEND command
causes X29PAD to append to an existing log file rather than supersede it
with a new generation. For example, if you specify that the default for
logging should be APPEND and you issue the LOG command to X29PAD specifying
a log file that already exists, X29PAD will append to the existing log
file.
You may desire a new generation of log file. If so, you may use the SET
DEFAULT LOG SUPERSEDE command to affect this action.
3.11.3.1.2 SET DEFAULT LOG NO - The SET DEFAULT LOG NO command has only
one option available. The option is SUPPRESS. This command (SET DEFAULT
LOG NO SUPPRESS) causes X29PAD to include NULLs transmitted by the remote
host in the log file. The format of this command is:
X29PAD>SET DEFAULT (for) LOG (to) NO SUPPRESS (null characters in log
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 12
USING X29PAD 19 May 83
file!)
3.11.3.1.3 SET DEFAULT LOG SUPERSEDE - The SET DEFAULT LOG SUPERSEDE
command causes X29PAD to create a new generation log file whenever session
logging is initiated.
3.11.3.1.4 SET DEFAULT LOG SUPPRESS - The SET DEFAULT LOG SUPPRESS command
causes X29PAD to discard nulls sent by the remote host and not include them
in the log file.
3.11.3.2 SET DEFAULT TAKE - The SET DEFAULT TAKE command allows the user
to specify and control the actions of the TAKE command. The format of this
command is:
X29PAD>SET DEFAULT (for) TAKE (to) argument-1 argument-2
where argument-1 is one of the following:
ALLOW DISALLOW ECHO NO
and argument-2 is dependent on argument-1.
3.11.3.2.1 SET DEFAULT TAKE ALLOW - The SET DEFAULT TAKE ALLOW command
causes X29PAD's TAKE command processor to ignore errors while processing
command files. The format of this command is:
X29PAD>SET DEFAULT (for) TAKE (to) ALLOW (errors during "TAKE" files)
3.11.3.2.2 SET DEFAULT TAKE DISALLOW - The SET DEFAULT TAKE DISALLOW
command causes X29PAD's command processor to abort the processing of a
command file if an error is encountered during processing. The format of
this command is:
X29PAD>SET DEFAULT (for) TAKE (to) DISALLOW (errors during "TAKE" file)
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 13
USING X29PAD 19 May 83
3.11.3.2.3 SET DEFAULT TAKE ECHO - The SET DEFAULT TAKE ECHO command
causes the X29PAD command processor to echo all commands taken from a
command file via the TAKE command. The format of this command is:
X29PAD>SET DEFAULT (for) TAKE (to) ECHO (commands from "TAKE" file)
3.11.3.2.4 SET DEFAULT TAKE NO - The SET DEFAULT TAKE NO command has only
one option. This option is ECHO. The SET DEFAULT TAKE NO ECHO command
causes X29PAD's command processor to suppress the display of commands taken
from a command file via the TAKE command. The format of this command is:
X29PAD>SET DEFAULT (for) TAKE (to) NO ECHO (commands from "TAKE" file)
3.11.3.2.5 SET DEFAULT TAKE NO ECHO - The SET DEFAULT TAKE NO ECHO command
causes X29PAD's command processor to suppress the display of commands taken
from a command file via the TAKE command. The format of this command is:
X29PAD>SET DEFAULT (for) TAKE (to) NO ECHO (commands from "TAKE" file)
3.11.4 SET ESCAPE-CHARACTER
The SET ESCAPE-CHARACTER command allows you to define a special character
which, when typed, will cause X29PAD to return you to command mode. The
format of the command is:
X29PAD>SET ESCAPE-CHARACTER (to) argument
where argument is the octal value for the ASCII character code you wish to
be the escape character or any printing character in double quotes. An
alternate form of this command is:
X29PAD>SET ESCAPE-CHARACTER (to) CONTROL argument
This form of the command is used to define the ESCAPE-CHARACTER to be a
control character. The argument is a printing character in double quotes.
For example, to set the ESCAPE-CHARACTER to CONTROL-P you would type:
X29PAD>SET ESCAPE-CHARACTER (to) CONTROL "P"
Note that the default ESCAPE-CHARACTER is CONTROL-\.
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 14
USING X29PAD 19 May 83
3.11.5 SET NETWORK
The SET NETWORK command allows the user to set either the NETWORK NAME or
the NETWORK PASSWORD for the PSI GATEWAY the user wishes to access. The
format of this command is:
X29PAD>SET NETWORK argument-1 argument-2
where argument-1 is either NAME or PASSWORD and argument-2 is dependent on
argument-1.
For more information type:
X29PAD>HELP (with) SET NETWORK NAME
or
X29PAD>HELP (with) SET NETWORK PASSWORD
3.11.5.1 SET NETWORK NAME - The SET NETWORK NAME command allows the user
to set the name of the network he wishes to access. The format of this
command is:
X29PAD>SET NETWORK NAME (to) argument-1
where argument-1 is the name supplied by your network manager.
Please note that this name is assigned by the network manager and may bear
no association to the actual PPSN you buy services from.
3.11.5.2 SET NETWORK PASSWORD - The SET NETWORK PASSWORD command allows
the user to specify the password required to access the X.25 PSI Gateway.
The form of the command is:
X29PAD>SET NETWORK PASSWORD (to) argument-1
where argument-1 is the Gateway access password supplied by your network
manager.
3.11.6 SET PAD-PARAMETER
The SET PAD-PARAMETER command allows you to set the parameters which
control the interaction of your terminal and the REMOTE-HOST. The format
of the command is:
X29PAD>SET PAD-PARAMETER argument-1 (to) argument-2 ... argument-n
where argument-1 is one of the following:
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 15
USING X29PAD 19 May 83
ACTION-ON-BREAK CANCEL-CHARACTER CARRIAGE-RETURN-PADDING
DATA-FORWARDING DELETE-CHARACTER DISCARD-OUTPUT
DISPLAY-CHARACTER DTE-TO-NET-FLOW-CONTROL ECHO
ESCAPE-TO-COMMAND-MODE IDLE-TIMER LINE-WIDTH
LINEFEED-INSERTION LINEFEED-PADDING LOCAL-EDITING
NET-TO-DTE-FLOW-CONTROL PAD-SIGNAL-CONTROL RATE
and argument-2 through argument-n are dependent on argument-1.
BEWARE
The user should not attempt to set individual PAD Parameters. This command
is supplied for the purposes of debugging and should be used with caution.
X29PAD initializes the PAD Parameters each time it tries to place a call to
a remote host and the remote host then will set them to a known state.
Setting PAD Parameters in the middle of a terminal session with a remote
host can produce unpredictable (and undesireable) results.
3.11.7 SET STATUS-DISPLAY-CHARACTER
The SET STATUS-DISPLAY-CHARACTER command allows you to define a special
character which, when typed, will cause X29PAD to display the current call
status. The format of the command is:
X29PAD>SET STATUS-DISPLAY-CHARACTER (to) argument
where argument is the octal value for the ASCII character code you wish to
be the status display character or any printing character in double quotes.
An alternate form of this command is:
X29PAD>SET STATUS-DISPLAY-CHARACTER (to) CONTROL argument
This form of the command is used to define the STATUS-DISPLAY-CHARACTER to
be a control character. The argument is a printing character in double
quotes. For example, to set the STATUS-DISPLAY-CHARACTER to CONTROL-P you
would type:
X29PAD>SET STATUS-DISPLAY-CHARACTER (to) CONTROL "P"
The STATUS-DISPLAY-CHARACTER may be disabled by setting it to a value of
zero.
Note that the default STATUS-DISPLAY-CHARACTER is CONTROL-A.
3.11.8 TAKE
The TAKE command allows the user to direct X29PAD to execute a series of
commands from a specified file. The format of this command is:
X29PAD>TAKE (commands from) file-spec
X29PAD - TOPS-20 PSI X.29 PAD Emulator Page 16
USING X29PAD 19 May 83
where file-spec is the name of the file containing commands for X29PAD to
execute. After the file-spec type a comma followed by a carriage return to
enter subcommand mode. There the user may modify the actions of the
command processor by entering various subcommands.
APPENDIX A
The following is a sample of an X29PAD terminal session. All user input is
in BOLD print.
@x29pad
This is X29PAD version 1(200)
Gateway Access Library version is 1(0)
X29PAD>set network name telenet
X29PAD>set network password frobaz
X29PAD>set break-character control "\"
X29PAD>set escape-character control "P"
X29PAD>call 234211111111 0
BREAK-CHARACTER (is) CONTROL-\
ESCAPE-CHARACTER (is) CONTROL-P
Calling Remote DTE 234211111111 (0) [FAILED]
?Call not completed - Remote DTE number is out of order
Network clear code 9, diagnostic code 0
Call cleared at 13:10:08-EDT on May 18, 1983
Transmitted 0 characters in 0 packets.
Received 0 characters in 0 packets.
X29PAD>call black-and-blue
BREAK-CHARACTER (is) CONTROL-\
ESCAPE-CHARACTER (is) CONTROL-P
Calling Remote DTE 208006088888 [OK]
This is the Headquarters VAX 11/750, node _BLACK::
Username: derek
Password:
$ ^P
X29PAD>information (about) pad-parameters
Current PAD Parameters are:
*ACTION-ON-BREAK (is) NOTHING
*CANCEL-CHARACTER (is) CONTROL-@
CARRIAGE-RETURN-PADDING (is) DISABLED
*DATA FORWARDING (is done on) CARRIAGE-RETURN
CONTROL-CHARACTERS
EDITING-CHARACTERS
ESCAPE-CHARACTERS
TERMINATOR-CHARACTERS
*DELETE-CHARACTER (is) A RUBOUT
*DISCARD-OUTPUT (is) DISABLED
*DISPLAY-CHARACTER CONTROL-@
*DTE-TO-NET-FLOW-CONTROL (is) ENABLED
*ECHO (is) DONE LOCALLY
ESCAPE-TO-COMMAND-MODE (is) PERMITTED
Page A-2
19 May 83
*IDLE-TIMER (is) DISABLED
LINE-WIDTH (is) 0
*LINEFEED-INSERTION (is done after) NO CARRIAGE-RETURNS
LINEFEED-PADDING (is) DISABLED
*LOCAL-EDITING (is) ENABLED
*NET-TO-DTE-FLOW-CONTROL (is) DISABLED
PAD-SIGNAL-CONTROL (is) ENABLED
RATE (is) 300 BAUD
( * Indicates PAD Parameters which were set by the remote host )
X29PAD>continue (current call)
$ show us
VAX/VMS Interactive Users - Total = 11
18-MAY-1983 18:12:52.50
NVA20: DEREK 002D0037
RTA1: DIXON 00120036
RTA2: X25MASTER 00520038
TTA3: NIISATO 00230031
TTB0: COBB 00440032
TTB5: HUNT 0061003A
TTC0: STAW 00B90043
TTC1: BRYSON 002A0030
TTC2: NEWLAND 00010018
TTC7: NIISATO 00150034
TTF0: PATEL 0066003E
$ logout
DEREK logged out at 18-MAY-1983 18:12:59.04
^P
X29PAD>exit
Call cleared at 13:12:04-EDT on May 18, 1983
Transmitted 46 characters in 6 packets.
Received 1146 characters in 36 packets.
@
APPENDIX B
X.3 PAD Parameters
The following is a list of the CCITT X.3 PAD Parameters along with their
meaning and possible values. X29PAD does not use all of these currently.
Those parameters not used by X29PAD are flagged with star (*).
PLEASE NOTE: The user should not attempt to set individual PAD Parameters.
X29PAD initializes them each time it tries to place a call to a remote host
and the remote host then will set them to a known state. Setting PAD
Parameters in the middle of a terminal session with a remote host can
produce unpredictable (and undesireable) results.
Parameter Description
Number
1. Escape to Command Mode (*). This parameter has two possible
values - ALLOWED or DISALLOWED. X29PAD ignores this parameter and
always allows the user to return to command mode by typing the
ESCAPE-CHARACTER.
2. Echo. This parameter determines whether X29PAD should do the
echoing of characters or the remote host will do the echoing.
This parameter has two possible values - LOCAL or REMOTE.
3. Data Forwarding. This parameter describes the set of characters
that, when typed by the user, will cause X29PAD to transmit
whatever data is in the input buffer. This parameter has the
following possible values:
1. No data forwarding character specified (disabled).
2. Alphanumerics (A-Z, a-z, 0-9)
3. Carriage Return
4. Escape Characters (ESC, BEL, ENQ, ACK)
5. Editing Characters (DEL, CAN, DC2)
6. Terminator Characters (ETX, EOT)
Page B-2
19 May 83
7. Forms Control Characters (HT, LF, VT, FF)
8. All Other Control Characters
Only the following combinations of the above are legal:
1. (1)
2. (3)
3. (3 and 4)
4. (3 and 6)
5. (3, 4, 5, 6, 7, and 8) - DEFAULT
4. Idle Timer. This parameter controls the frequency that X29PAD
will forward data in the input buffer to the remote host. The
timer may either be DISABLED or be set to an interval from 0.05
seconds to 12.75 seconds in 0.05 second increments. The Idle
Timer is DISABLED by default.
5. DTE to Network Flow Control (*). This parameter determines
whether X29PAD can use XON/XOFF to control data flow from the
terminal. X29PAD does not currently use this parameter.
6. PAD Service Signal Suppression (*). This parameter determines if
X29PAD will suppress service signals. X29PAD ignores this
parameter.
7. Action on Break. This parameter specifies the action X29PAD takes
when the user types the BREAK-CHARACTER on the terminal. The
possible values are:
1. No action
2. X29PAD sends an interrupt to the remote DTE
3. X29PAD sends a reset to the remote DTE
4. X29PAD sends an Indication Break message to the remote DTE
5. X29PAD enters command mode
6. X29PAD discards output to the terminal (Parameter 8 set to 1)
7. Combination of 2, 4, and 6
The default value for this parameter is RESET.
8. Discard Output. This parameter determines if X29PAD will display
data from the remote host on the user's terminal or discard it.
Page B-3
19 May 83
9. Carriage Return Padding (*). This parameter controls the number
of nulls X29PAD should send after it sends a carriage return to
the terminal. X29PAD currently ignores this parameter.
10. Line Width (*). This parameter is the width of the users
terminal. X29PAD currently ignores this parameter.
11. Rate (*). This parameter contains the speed of the users
terminal. X29PAD currently ignores this parameter.
12. Network to DTE Flow Control (*). This parameter determines
whether or not the user's terminal can control the data flow from
the local host system. X29PAD currently ignores this parameter.
13. Linefeed Insertion after Carriage Return. This parameter
determines if and when X29PAD will insert a linefeed after a
carriage return in the data stream. This parameter has the
following values:
1. Never insert a linefeed after a carriage return.
2. Insert a linefeed after carriage returns sent to the terminal.
3. Insert a linefeed after carriage returns sent to the remote
host.
4. Insert a linefeed after carriage returns X29PAD echos.
5. All combinations of 2, 3, and 4.
The default for this parameter is to never insert a linefeed.
14. Linefeed Padding (*). This parameter controls the number of nulls
to be inserted into the data stream after a linefeed. X29PAD does
not use this parameter.
15. Local Editing. This parameter controls the local editing feature
of X29PAD. This parameter has two possible values. If local
editing is ENABLED, X29PAD will allow the user to edit any text in
the input buffer before it is passed on to the remote host. If
local editing is DISABLED, X29PAD will not allow local editing to
be done. Note that parameters 16, 17, and 18 are ignored by
X29PAD if local editing is disabled.
16. Delete Character. This parameter specifies the character for
deleting characters in the editing buffer while in data transfer
state. The possible values are DISABLED (value of 0) or an ASCII
character. The default setting for this parameter is RUBOUT.
This parameter is ignored if LOCAL-EDITING is disabled.
17. Cancel Character. This parameter specifies the line delete
character for deleting lines in the editing buffer. The possible
values are DISABLED (value of 0) or an ASCII character. The
default setting for this parameter is CONTROL-U. This parameter
is ignored if LOCAL-EDITING is disabled.
Page B-4
19 May 83
18. Display Character. This parameter specifies the line display
character for editing while in the data transfer state. The
possible values are DISABLED (value of 0) or an ASCII character.
The default setting for this parameter is CONTROL-R. This
parameter is ignored if LOCAL-EDITING is disabled.