Disclaimer
Telematics reserves the right to change this document, its contents, and
any products described herein at any time without prior notification.
The information in this document has been reviewed for accuracy, clarity,
and completeness. Telematics is not responsible for any errors that may
occur in this document. If you find any errors, please report them to
Telematics:
TELEMATICS INTERNATIONAL, INCORPORATED
Documentation Department
Worldwide Headquarters
1201 Cypress Creek Road
Fort Lauderdale, Florida 33309 U.S.A.
Telematics reserves the right to use or distribute freely any information
supplied by readers without incurring obligations.
Any unauthorized use, duplication, or distribution of this document or any
part thereof without the prior written consent of Telematics is strictly
prohibited.
Copyright Telematics International, Inc., 1993. All rights reserved.
Revision History
ii
A0
B0
C0
D0
ASYNCXS
C320001300D0
Contents
Introduction
Operations
Connection Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Signon Include Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Printers and DisplayOnly Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
In Case of A Problem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Operation Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Command Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Data Transfer Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Signals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
PAD Service Signals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Break Signal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Data Accumulation and Forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Typeahead Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Data Forwarding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Editing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Editing Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Special Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Creating Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Symbol Replacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Symbolic Assignment Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Symbol Inquiry Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Symbol Replacement Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Device Operational States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Modem Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Modem Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Subparameter Combinations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Incoming Call Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Port Assignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
PADmap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
PADmap Routing Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
ASYNCXS
C320001300D0
iii
iv
ASYNCXS
C320001300D0
X.28 Commands
ASYNCXS
C320001300D0
Parameter? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529
Prof (Profile Set) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
Profile? (Profile Display) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
Read . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
Rpar? (Remote Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
Rprof (Remote Profile) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
Rset (Remote Set) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
Reset (Reset Circuit) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
Send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
Stat (Status) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540
Tact (Port Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540
Tactt (Terminal Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
Terminate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
Wait . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543
X28Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543
X3Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
Alarms
Severity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Alarm Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
IO Interface
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Include Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Event Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IO Service Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IO/CLOSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IO/CRDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vi
B1
B1
B2
B3
B4
B6
B8
B9
ASYNCXS
C320001300D0
ASYNCXS
C320001300D0
vii
pktrvalus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B63
Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B64
Glossary
Index
Figures
Figure 11. Product Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Figure 12. INF Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
viii
ASYNCXS
C320001300D0
1 Introduction
This manual describes the commands and parameters that configure and
control the Telematics ASYNCXS environment.
To use this manual effectively, you should be familiar with asynchronous
device operation, X.25 packet switching procedures, and the CCITT
standards for PAD implementation in an X.25 network (X.3, X.28, and
X.29). You should also be experienced with Telematics Interactive
Network Facilities (INF), NET25 software, and the Network
Configuration Model (NCM).
To use the IO interface effectively, you should be familiar with
programming in the Telematics TRAX operating system environment,
including building and submitting IO subservice packets.
This is a reference manual. For information about how commands are
used to configure and manage ASYNCXS, see the Release Notes, the
Configuration Model Manual, and the Configuration Model Operations
Guide.
ASYNCXS
C320001300D0
11
INTRODUCTION
Product Description
Telematics ASYNCXS is a Packet Assembler and Disassembler (PAD)
that allows asynchronous devices to communicate with remote devices
and hosts through an X.25 packet switching network.
ASYNCXS comprises two components: the ASYNCXS Product
Management Module (PMM) and the ASYNCXS PAD. The
ASYNCXS PMM provides a manmachine interface that allows network
operations personnel to configure and monitor the ASYNCXS PAD
using Telematics Interactive Network Facilities (INF). The ASYNCXS
PAD provides X.3, X.28, and X.29 support.
X.3 support includes a set of parameters that specify the operating
characteristics of each asynchronous port. ASYNCXS also offers
extended Telematics parameters for added functionality. X.3 parameters
can be set dynamically on a percall basis. Reconfiguration can occur
during call acceptance.
X.28 support defines the dialogue between the device and the
ASYNCXS PAD. X.28 commands set up and clear virtual calls to a
remote computer through the packet switching network, and set/modify
X.3 parameters to accommodate the devices operating requirements.
ASYNCXS implements the 1984 CCITT Recommendation X.28
commands, plus Telematics extended commands. Optionally, a command
file containing X.28 commands can be executed at call accept time at the
local and/or remote ASYNCXS nodes.
X.29 support handles the exchange of control information across a
network between two PADs, or between a PAD and a packet mode DTE.
When a virtual circuit is established, it provides a way for a user at a
remote device to read or alter PAD parameters. The X.29 module
implements this functionality using data packets with the qualifier bit set
(i.e., Q=1).
You can manage ASYNCXS locally or remotely to modify a
configuration, monitor ASYNCXS activity, and display alarm/event
messages for remote PADs. You can downline load ASYNCXS software
to remote nodes from any NCC node and send configuration parameters to
remote nodes from any point in the network. You can configure host or
terminal devices manually or automatically using command files from the
local or NCC node. See the Configuration Model Manual and the
Configuration Model Operations Guide for details.
Relationships To Other Telematics Products
NET25 Like all Telematics access products, PAD support is
implemented jointly with the NET25 software, which processes call
packets, establishes virtual circuits, and manages data packet transfers. To
support the network connection, ASYNCXS:
12
ASYNCXS
C320001300D0
INTRODUCTION
Processes X.29 commands from NET25 that the remote device has
sent, and responds accordingly
TRAX IO
ASYNCXS PMM
TRAX IO
ASYNCXS
X.3
X.28
X.29
TRAX
IO
Application
Task
Subroutine Calls
Pascal
68000
Assembler
Async L2
Library
Async L1
Library
68000
Assembler
Asynchronous
Communications Lines
ASYNCXS
C320001300D0
13
INTRODUCTION
ASYNCXS
PAD
HOST
ASYNCXS
PAD
Packet
Switching
Network
NET25
PMM
INF
Related Manuals
The Configuration Model Manual (C320001700) and the Network
Configuration Model Operations Manual (C320003800)) explain how
to configure the ASYNCXS product on your Telematics system and
customize its operation to your networks needs.
The Release Notes that accompany the software indicate the required
library revisions.
The NET25 Manual (C320000800) and the Interactive Network
Facilities (INF) Manual (C320000900) describe the commands used to
configure and manage your Telematics network.
For users of the IO interface described in Appendix B, the Programmers
Guide (C310000100) and the TRAX Programmers Manual
(C315000100) describe how to build and submit TRAX operating
system IO service packets.
14
ASYNCXS
C320001300D0
INTRODUCTION
Standards Compliance
International Telecommunication Union. Recommendation V.24 List of
Definitions for Interchange Circuits Between Data Terminal Equipment
and Data CircuitTerminating Equipment. In Red Book Data
Communication Over the Telephone Network. vol. VIII fascicle VIII.1
Geneva: International Telecommunication Union, 1985.
______. AP IX48. Geneva: International Telecommunication Union,
1989.
______. AP IX49. Geneva: International Telecommunication Union,
1989.
______. Recommendation V.40 Error Indication with Electromechanical
Equipment. In Red Book Data Communication Over the Telephone
Network. vol. VIII fascicle VIII.1 Geneva: International
Telecommunication Union, 1985.
______. Recommendation V.54 Loop Test Devices for Modems. In Red
Book Data Communication Over the Telephone Network. vol. VIII
fascicle VIII.1 Geneva: International Telecommunication Union, 1985.
______. Recommendation X.3 Packet Assembly/Disassembly Facility
(PAD) in a Public Data Network. In Blue Book Data Communication
Networks Services and Facilities. vol VIII fascicle VIII.2. Melbourne:
International Telecommunication Union, 1988.
______. Recommendation X.15 Definition of Terms Concerning Public
Data Networks. In Red Book Data Communication Networks Services
and Facilities. vol. VIII fascicle VIII.2 Geneva: International
Telecommunication Union, 1985.
______. Recommendation X.20bis Use on Public Data Networks of Data
Terminal Equipment (DTE) which is Designed for Interfacing to
Asynchronous Duplex Vseries Modems. In Red Book Data
Communication Networks Interfaces. vol. VIII fascicle VIII.3 Geneva:
International Telecommunication Union, 1985.
_____. Recommendation X.25 Interface between Data Terminal
Equipment (DTE) and Data CircuitTerminating (DCE) for Terminals
Operating in the Packet Mode Connected to Public Data Networks by
Dedicated Circuit, In Blue Book Data Communication Networks
Interfaces. vol. VIII fascicle VIII.3 Melbourne: International
Telecommunication Union, 1988.
ASYNCXS
C320001300D0
15
INTRODUCTION
Syntax Conventions
Command syntax uses the following conventions:
<>
Angle brackets enclose values you must supply. Items within the
angle brackets are italicized.
[]
Square brackets enclose optional items.
...
An ellipsis indicates the preceding item can be repeated.
|
Vertical bars between items indicate you must select only one of
the items.
UPPERCASE
16
ASYNCXS
C320001300D0
INTRODUCTION
*
A single asterisk indicates the preceding mnemonic is defined in
the asyxsuser.in include file (see next section, Include Files).
**
A double asterisk indicates the preceding mnemonic is defined in
the padiodefs.in include file (see next section, Include Files).
use and set
The word use preceding a mnemonic in the Contents column
indicates a MOVE instruction to copy a value into a field. The
word set indicates a BSET instruction to set the bit identified by
the mnemonic in that field.
ASYNCXS
C320001300D0
17
INTRODUCTION
18
ASYNCXS
C320001300D0
2 Operations
This chapter explains ASYNCXS PAD environment features, including:
Connection procedures
Signals
How data is accumulated and forwarded
Data editing
Special characters
Symbols
Device operational states
Modem processing
Incoming call routing
Connection Procedures
The first step in establishing a PAD connection is to physically and
logically connect the user terminal to the ASYNCXS PAD. The physical
connection is between the terminal and the Telematics system where
ASYNCXS resides. The logical connection, or signing on, ensures the
PAD is aware of the terminals characteristics and its readiness to begin.
Once the terminal is signed on, it is ready to make/receive calls from the
network and begin transferring data.
Terminals can be connected to the PAD in three ways: local connection,
leased line connection, and dialin line connection. The following
procedure is used for all types of terminal connections.
When modems are used, parameters configured for the terminal must be
compatible with those of the modems, and both the terminal and modem
parameters must be compatible with the PAD ports parameters. You
should check the compatibility of the terminal, modem, and operating
parameters for speed, parity, echo, bits per character, and flow control.
Also, check with your system administrator to determine whether the
autobaud option is enabled for your channel.
To establish a PAD connection:
For a local terminal or with a leased line and modem, connect the
terminal to a Telematics asynchronous channel that is configured for
ASYNCXS operation. Check with your system administrator for the
assigned channel.
ASYNCXS
C320001300D0
21
OPERATIONS
For a terminal connected via a dialin line and modem, make sure the
terminal is physically connected to the modem.
22
ASYNCXS
C320001300D0
OPERATIONS
Operation Modes
ASYNCXS devices have two operation modes: handler and PAD. The
handler mode uses TRAX IO services directly, and is described in
Appendix B. When a device is in PAD mode (the default), it can be in one
of two operational modes: command and data transfer.
Command Mode
After terminal setup and initialization procedures have completed
successfully, the terminal enters command mode. At this point, the
physical connection between the terminal and the PAD has been
established, and the user can enter X.28 commands. The terminal remains
in command mode until the PAD receives an X.28 command to make a
call to another device on the X.25 network, or until the PAD receives a
call from another device on the network.
If a nonzero command mode timeout value has been specified for the
terminal (CMDTImeout device parameter), the PAD waits for a specific
time interval for a command from the terminal after issuing the PAD
prompt signal (i.e., a command prompt) to the terminal. If the time
interval passes and no command is entered, the terminal is disconnected
from the PAD if there is no call active. If a call is active, the terminal
switches to data transfer mode. This timeout differs from the data transfer
mode timeout, which is described in the next section.
Data Transfer Mode
The terminal is placed in data transfer mode when an X.25 call is
successfully established. In data transfer mode, data can be transferred
between the terminal and the remote device. Depending on the X.3
parameters defined, the terminal remains in data transfer mode until one of
the following events occurs:
The terminal user enters the PAD recall character (depending on the
P1 value)
The terminal user enters a break signal with the break key or an
alternate break key (depending on the P7 value)
Editing characters (depending on the P15, P16, P17, and P18 values)
PAD recall character (depending on the P1 value)
Flow control characters defined in P30 and P31 (depending on the
P12, P30, and P31 values)
23
OPERATIONS
When an X.25 call is active, the terminal user can temporarily leave data
transfer mode and return to command mode by entering the PAD recall
character (controlled by P1). The terminal remains in command mode, and
X.28 commands can be entered, until the terminal user enters the X.28
Continue command, a carriage return, or a plus sign (+), any of which
returns the terminal to data transfer mode. If P1=0, the user cannot leave
data transfer mode while a call is active unless a break or alternate break is
used, depending on the value of P7.
If a nonzero data transfer mode timeout value has been configured for the
terminal (X25IDLETimer device parameter), the PAD waits the specified
time interval for data to be entered from the terminal after forwarding the
previous data. If the time interval elapses and no data has been entered,
the active call is cleared and the terminal is disconnected from the PAD.
This timeout differs from the command mode timeout, which was
described in the previous section.
24
ASYNCXS
C320001300D0
OPERATIONS
Signals
This section covers two signal types: PAD service signals that are returned
from certain events, and the break signal used at the terminal.
PAD Service Signals
Data sent from the PAD to the device falls into two categories: data
received from the remote device, and PAD service signals. A PAD service
signal is either a response to an X.28 command or an indication of PAD or
network status. The value of X.3 P6 determines whether PAD service
signals are sent to the device; it also controls the format of those signals.
Several PAD service signals are described below. Chapter 6 lists the
defined PAD service signals and their meanings.
Prompt service signal This is the character or character string that
indicates the PAD is waiting for the terminal to send it an X.28 command.
The standard prompt service signal is an asterisk (*); the default extended
prompt service signal is Service:. The extended prompt service signal is
established when the device is configured.
Acknowledge service signal This is the indication from the PAD that it
has accepted an X.28 command. It consists of the <CR> and <LF>
characters.
Break service signal This is the notification from the PAD that an
indication of break has been received from the network.
Break Signal
The break feature allows the terminal to signal the PAD without loss of
character transparency, i.e., without reserving a special character that
cannot be sent as data. A break signal also acts as a command abort key
for X.28 Aread, Read, Tact, and Tactt commands. The break signal is
meaningful only when entered while a call is active; otherwise, it is
ignored.
If the terminal supports the break signal with the break key or another
defined break key, the PAD responds to the break signal according to the
setting of X.3 P7.
If the PAD receives an indication of break message from the network and
a call is active, the PAD sends a break service signal to the terminal. This
can take one of several forms, depending on the terminals configuration:
ASYNCXS
C320001300D0
25
OPERATIONS
26
ASYNCXS
C320001300D0
OPERATIONS
ASYNCXS
C320001300D0
27
OPERATIONS
Editing Data
Before accumulated data is forwarded, it is held in a PAD buffer, and can
be edited. Editing can be done in both command and data transfer modes.
In command mode, editing is always enabled. In data transfer mode,
editing is enabled and disabled with X.3 parameter P15. When editing is
enabled in data transfer mode (i.e., P15=1), the idle timer controlled by P4
is ignored. You can only edit the current line.
Editing Characters
Editing uses three special characters: character delete, line delete, and line
display. These characters are not added to the buffer as data, but cause
specific actions to be performed to the accumulated data. X.3 P16, P17,
and P18 specify the three characters values. X.3 P19 controls the PADs
response when these characters are entered.
Character delete The default character delete character is <DEL>. X.3
P16 can be set to a nonzero value to designate an alternate character delete
character. When the PAD receives the character delete character from the
device, it deletes from its buffer the last character entered. If there are no
characters in the buffer, this editing function has no effect.
Line delete The default line delete character is <CAN>. X.3 P17 can be
set to a nonzero value to designate an alternate line delete character. When
the PAD receives this character from the device, it deletes all of the
characters in its buffer. The PAD responds to the device by sending an
editing service signal, which consists of the characters ^U followed by the
format effector (<CR><LF>). If there are no characters in the buffer, this
editing function has no effect.
Line display The default line display character is <DC2>. When the
PAD receives this character from the device, it sends a format effector
(<CR><LF>) to the device, followed by all the accumulated characters in
the buffer. X.3 P18 can be set to a nonzero value to designate an alternate
line display character.
28
ASYNCXS
C320001300D0
OPERATIONS
Special Characters
You can use X.3 parameters to identify certain control characters for
special action when they are entered from the terminal. These special
actions are:
Flow control
Display line
Line delete
Character delete
ASYNCXS
C320001300D0
highest
lowest
29
OPERATIONS
Symbols
This section explains how to create and display symbols.
Creating Symbols
Symbols are useful for creating commands with names that are familiar to
the terminal user. ASYNCXS predefines a number of symbols for
devices; some are defined when the device is enabled, and others are
defined/modified during the terminal session. The predefined symbols are:
PORT Devices port number.
PORTNUA Devices network address, e.g., 9999103105.
USERDATA Call user data from the most recent incoming call. Prior
to the first incoming call, the symbol is defined as empty, i.e., .
SYSDATE Current date, in the form ddmmmyy, e.g., 11FEB92.
SYSTIME Current time, in the form hh:mm:ss in 24 hour format,
e.g., 16:54:17.
SWREV Software revision identification.
Symbol Replacement
X.3 P81 controls symbolic replacement; replacement occurs only if P81
has the symbolic replacement option enabled. Symbolic replacement can
be temporarily disabled for part of a command line by using the toggle
function character, the backslash ( \ ).
Symbols are indicated by open apostrophes (). The symbol name can be
enclosed in a pair of open apostrophes, or preceded by a single open
apostrophe.
The first element in a command line is always replaced if it matches a
symbol name (it can be enclosed in a pair of open apostrophes, but this is
not required). All subsequent symbol names must be enclosed in a pair of
open apostrophes (or preceded by a single open apostrophe) in order to be
replaced in the command line.
Symbols can be defined with required and optional characters. When a
symbol is defined in both uppercase and lowercase, uppercase indicates
the required characters and lowercase indicates optional characters. A
symbol defined in all uppercase or lowercase must be typed completely.
Do not define a symbol with a character string that matches the case
significant characters of X.28 commands or parameter keywords. For
example, to define a symbol for remote profiles, do not use the string
RPROF or RPROFile in the definition. Examples of valid symbols are
RPRO1 and RPRtokyo.
Do not define a symbol beginning with the character C; this is the
significant character for the X.28 Call command.
210
ASYNCXS
C320001300D0
OPERATIONS
Do not define a symbol with the same format as a call facility parameter
value; symbol names that contain a single alphabetic character followed
by a number must not begin with the characters B, D, G, N, O, P, or W.
There are two symbol commands: symbolic assignment and symbolic
inquiry.
Symbolic Assignment Command
The Symbolic Assignment command defines a symbol name and assigns a
character string to it. The command line is limited to 128 characters; the
symbol assignment operator (:=) and quotation marks that enclose the
symbol value are included in the character count.
Syntax
<symbol>:=[<value>]
Parameters
<symbol>
Symbol name, containing up to 16 alphanumeric characters, the
first of which must be alphabetic. Uppercase indicates the
minimum number of significant characters.
[<value>]
Character string enclosed in quotation marks. The maximum
length is determined by the maximum line length (128 characters)
and the length of the symbol name. An empty string () deletes
the symbol definition.
Example
The following command assigns the string c 99990001234567 to the
symbol host. Once defined, the symbol (i.e., host) can be used in
response to a PAD service prompt to initiate an X.25 call request.
host:=c 99990001234567
ASYNCXS
C320001300D0
211
OPERATIONS
Error, symbol not defined The symbol cannot be defined because the
memory space reserved for symbol definition at task startup is full.
Symbol Inquiry Command
The Symbol Inquiry command displays the value of an existing symbol.
To produce a display of all defined symbols and their values, use the X.28
Help Mnemonics command.
Syntax
<symbol>?
Parameters
<symbol>
Symbol name. Wildcard characters can be used, but not as the first
character.
?
Required command character.
The following information can be returned in response to a Symbol
Inquiry command:
<symbol value> This is the normal response to the command. The PAD
issues an Acknowledge PAD service signal (see Chapter 6 for format)
followed by the <symbol>=<symbol value>.
No match found The symbol has not been defined or the name has not
been specified correctly.
Symbol Replacement Example
The following symbols have been defined:
LOgon:=c 99990001234567
atlanta:=99990007654321
data:=this is a test
PRint:=type
hello:=type hi there (quotes enclose the command parameter)
212
command:
action:
LOGON
c 99990001234567
command:
action:
c atlanta
c 99990007654321
command:
action:
response:
command:
action:
response:
prin data
type this is a test
this is a test
ASYNCXS
C320001300D0
OPERATIONS
command:
action:
response:
pri status
type status (no symbol status defined)
status
command:
action:
response:
pr \data\
type data (temporarily disabled by backslash)
data
command:
action:
response:
pr PRint = <print>
type PRint = <type>
PRint = <type>
command:
action:
response:
hello
type hi there
hi there
command:
action:
response:
pr hello = <hello>
type hello = <type hi there>
hello = <type hi there>
ASYNCXS
C320001300D0
213
OPERATIONS
Modem Processing
The modem device parameter specifies whether the device is configured
for modem support. If modem support is configured, there are several
subparameters available; the combination that is specified can affect the
state of the signals and the port when other signals are asserted or
removed. This section first describes the subparameters in general, then
lists and describes the changes that can occur for each of the eight (8)
possible subparameter combinations.
Note that if the device is configured with the DTRCall parameter, it
overrides all the modem subparameters. Also, you should not modify
modem subparameters separately with a Modify Device command.
The modem device parameter has the following syntax:
MOdem=([NO]MODem,[NO]DTR,[NO]HANgup,[NO]AUToanswer)
Modem Subparameters
The [NO]DTR subparameters indicate the idle state of DTR. These
subparameters are valid regardless of whether MODem is enabled or not.
DTR indicates that DTR will be raised when the device is created;
NODTR indicates that DTR is low.
HANgup indicates the PAD should hang up the modem when the device is
disabled. NOHANgup indicates the PAD will not modify the state of the
modem signals when the device is disabled. The [NO]HANgup
subparameters are valid only if MODem is specified.
AUToanswer indicates the device is placed in the connect state when DSR
and DCD signals are both present. ASYNCXS follows the modem
control signals in autoanswer mode, based on the Industrial Electronics
Bulletin No. 9, Application Nodes for EIA Standard RS232C. When the
device is configured for NOAUToanswer, it remains in the enabled state.
A transition from this state requires that the modem report the RING
signal. When RING is detected, ASYNCXS forces DTR and RTS high
and starts a 30 second timer to wait for DSR and DCD to go high. If the
timer expires, the modem is disconnected and the device is disabled. If
DSR and DCD are present within 30 seconds, ASYNCXS places the
device in the signon state and cancels the timer. (Subsequent completion
of the signon include file, if configured, places the device in the connect
state.)
214
ASYNCXS
C320001300D0
OPERATIONS
When the device is in the connect state, loss of DCD for more than 2
seconds, or loss of DSR causes ASYNCXS to disable the device.
When the device is disabled, and if the modem option HANgup is
enabled, ASYNCXS lowers DTR and RTS for 2 seconds. After 2
seconds, modem control returns to the idle state.
Subparameter Combinations
When modem support is enabled, there are eight (8) possible
combinations of the [no]dtr, [no]hangup, and [no]autoanswer
subparameters. This section lists these combinations (with relevant X.3
parameter settings; see Chapter 3 for full X.3 parameter descriptions) and
describes the DTR and RTS signal and port state changes (if any) when
other signals are asserted or removed.
modem=(modem,nodtr,nohangup,noautoanswer) and par=(80:0 81:92)
When the port is first created, and DSR and CD are not applied: DTR
and RTS stay low; the state is enabled
When the port is first created, and DSR and CD are applied: DTR and
RTS stay low; the state is enabled
When DSR and CD are not applied and RI is applied: DTR and RTS
go high for 30 seconds; the state is enabled
When DSR and CD are applied and RI is applied: DTR and RTS go
high; the state changes to connect
When DSR and CD are applied, and CD is removed: DTR and RTS go
low after 2 seconds; the states changes from connect to enabled
When DSR and CD are applied, and CD is removed for less than 2
seconds: DTR and RTS stay high; the state remains connect; the port
will not accept or send data (if CD is restored during the initial 2
seconds, the port continues sending and receiving data)
When DSR and CD are applied, and DSR is removed: DTR and RTS
go low immediately; the state changes from connect to enabled
When DSR and CD are applied, and an X.28 call is placed, completed,
and cleared from both sides: DTR and RTS go low immediately; the
state changes from online to enabled (if par=(81:88), DTR and RTS
stay high, and the state stays in connect)
ASYNCXS
C320001300D0
215
OPERATIONS
When the port is first created, and DSR and CD are applied: DTR and
RTS stay high; the state is connect
When DSR and CD are applied, and CD is removed: DTR and RTS go
low after 2 seconds; the states changes from connect to enabled
When DSR and CD are applied, and CD is removed for less than 2
seconds: DTR and RTS stay high; the state remains connect; the port
will not accept or send data (if CD is restored during the initial 2
seconds, the port continues sending and receiving data; if CD is not
restored, the state changes to enabled)
When DSR and CD are applied, and DSR is removed: DTR and RTS
go low immediately; the state changes from connect to enabled
When DSR and CD are applied, and an X.28 call is placed, completed,
and cleared from both sides: DTR and RTS go low immediately, then
go high; the state changes from online to connect (if par=(81:88), DTR
and RTS stay high, and the state changes from online to connect)
modem=(modem,nodtr,hangup,noautoanswer) and par=(80:0 81:88)
When the port is first created, and DSR and CD are not applied: DTR
and RTS stay low; the state is enabled
When the port is first created, and DSR and CD are applied: DTR and
RTS stay low; the state is enabled
When DSR and CD are not applied and RI is applied: DTR and RTS
go high for 30 seconds; the state is enabled
When DSR and CD are applied and RI is applied: DTR and RTS go
high; the state changes to connect
When DSR and CD are applied, and CD is removed: DTR and RTS go
low after 2 seconds; the states changes from connect to enabled
When DSR and CD are applied, and CD is removed for less than 2
seconds: DTR and RTS stay high; the state remains connect; the port
will not accept or send data (if CD is restored during the initial 2
seconds, the port continues sending and receiving data; if CD is not
restored, the state changes to enabled)
216
ASYNCXS
C320001300D0
OPERATIONS
When DSR and CD are applied, and DSR is removed: DTR and RTS
go low immediately; the state changes from connect to enabled
When DSR and CD are applied, par=(80:0 81:92), and an X.28 call is
placed, completed, and cleared from both sides: DTR and RTS go low
immediately; the state changes from online to enabled (if par=(81:88),
DTR and RTS stay high, and the state changes from online to connect)
modem=(modem,nodtr,hangup,autoanswer) and par=(80:0 81:88)
When the port is first created, and DSR and CD are applied: DTR and
RTS stay high; the state is connect
When DSR and CD are applied, and CD is removed: DTR and RTS go
low after 2 seconds; the states changes from connect to enabled
When DSR and CD are applied, and CD is removed for less than 2
seconds: DTR and RTS stay high; the state remains connect; the port
will not accept or send data (if CD is restored during the initial 2
seconds, the port continues sending and receiving data; if CD is not
restored, the state changes to enabled)
When DSR and CD are applied, and DSR is removed: DTR and RTS
go low immediately; the state changes from connect to enabled
When DSR and CD are applied, par=(80:0 81:92), and an X.28 call is
placed, completed, and cleared from both sides: DTR and RTS go low
immediately; the state changes from online to connect (if par=(81:88),
DTR and RTS stay high, and the state changes from online to connect)
modem=(modem,dtr,nohangup,noautoanswer) and par=(80:0 81:92)
When the port is first created, and DSR and CD are not applied: DTR
and RTS stay high; the state is enabled
When the port is first created, and DSR and CD are applied: DTR and
RTS stay high; the state is enabled
When DSR and CD are not applied and RI is applied: DTR and RTS
stay high; the state is enabled
When DSR and CD are applied and RI is applied: DTR and RTS stay
high; the state changes to connect
When DSR and CD are applied, and CD is removed: DTR and RTS
stay high for 2 seconds, then go low for 2 seconds, then go high; the
state changes from connect to enabled
ASYNCXS
C320001300D0
217
OPERATIONS
When DSR and CD are applied, and CD is removed for less than 2
seconds: DTR and RTS stay high; the state remains connect; the port
will not accept or send data (if CD is restored during the initial 2
seconds, the port continues sending and receiving data; if CD is not
restored, the state changes to enabled)
When DSR and CD are applied, and DSR is removed: DTR and RTS
go low immediately; after 2 seconds, DTR and RTS go high; the state
changes from connect to enabled immediately
When the port is first created, and DSR and CD are applied: DTR and
RTS stay high; the state is connect
When DSR and CD are applied, and CD is removed: DTR and RTS
stay high for 2 seconds, then go low for 2 seconds, then go high; the
state changes from connect to enabled
When DSR and CD are applied, and CD is removed for less than 2
seconds: DTR and RTS stay high; the state remains connect; the port
will not accept or send data (if CD is restored during the initial 2
seconds, the port continues sending and receiving data; if CD is not
restored, the state changes to enabled)
When DSR and CD are applied, and DSR is removed: DTR and RTS
go low immediately; after 2 seconds, DTR and RTS go high; the state
changes from connect to enabled immediately
When the port is first created, and DSR and CD are not applied: DTR
and RTS stay high; the state is enabled
When the port is first created, and DSR and CD are applied: DTR and
RTS stay high; the state is enabled
ASYNCXS
C320001300D0
OPERATIONS
When DSR and CD are not applied and RI is applied: DTR and RTS
stay high; the state is enabled
When DSR and CD are applied and RI is applied: the state changes to
connect
When DSR and CD are applied, and CD is removed: DTR and RTS
stay high for 2 seconds, then go low for 2 seconds, then go high; the
state changes from connect to enabled
When DSR and CD are applied, and CD is removed for less than 2
seconds: DTR and RTS stay high; the state remains connect; the port
will not accept or send data (if CD is restored during the initial 2
seconds, the port continues sending and receiving data; if CD is not
restored, the state changes to enabled)
When DSR and CD are applied, par=(80:0 81:92), and an X.28 call is
placed, completed, and cleared from both sides: DTR and RTS go low;
the state changes immediately from online to enabled; after 2 seconds,
DTR goes high (RTS is irrelevant); (if par=(81:88), DTR and RTS
remain high; the state changes to connect)
modem=(modem,dtr,hangup,autoanswer) and par=(80:0 81:88)
When the port is first created, and DSR and CD are applied: DTR and
RTS stay high; the state is connect
When DSR and CD are applied, and CD is removed: DTR and RTS
stay high for 2 seconds, then go low for 2 seconds, then go high; the
state changes from connect to enabled
When DSR and CD are applied, and CD is removed for less than 2
seconds: DTR and RTS stay high; the state remains connect; the port
will not accept or send data (if CD is restored during the initial 2
seconds, the port continues sending and receiving data; if CD is not
restored, the state changes to enabled)
When DSR and CD are applied, and DSR is removed: DTR and RTS
go low immediately; after 2 seconds, DTR and RTS go high; the state
changes from connect to enabled immediately
ASYNCXS
C320001300D0
219
OPERATIONS
When DSR and CD are applied, par=(80:0 81:92), and an X.28 call is
placed, completed, and cleared from both sides: DTR and RTS go low;
the state changes immediately from online to connect; after 2 seconds,
DTR and RTS go high; (if par=(81:88), DTR and RTS remain high;
the state changes to connect)
modem=(nomodem,dtr) and par=(80:0 81:92)
RTS is irrelevant; DTR stays high for all transitions of DSR, CD, and
RI; the state is always connect
modem=(nomodem,nodtr) and par=(80:0 81:92)
RTS is irrelevant; DTR stays low for all transitions of DSR, CD, and
RI; the state is always connect
220
ASYNCXS
C320001300D0
OPERATIONS
ASYNCXS
C320001300D0
221
OPERATIONS
CUD
PORT
99991032000601
999910320006%%
9999103200*
*
P%%%
*
116
#
#2
Example 1
ASYNCXS routes a call with a called NUA of 99991032000622 and call
user data abc as follows:
The called address (99991032000622) is compared to the NUA field of
the first PADmap entry (99991032000601); the comparison fails, so
ASYNCXS moves on to the second entry.
The called address (99991032000622) is compared to the NUA field of
the second PADmap entry (999910320006%%); the comparison results in
a match.
The call user data (abc) is compared to the CUD field of the second
PADmap entry (P%%%); the comparison fails, so ASYNCXS moves on
to the third PADmap entry.
222
ASYNCXS
C320001300D0
OPERATIONS
ASYNCXS
C320001300D0
223
OPERATIONS
Both called address and call user data of the third PADmap entry match
the corresponding fields of the incoming call, so the port field (#2) is
examined to determine which device should be assigned to the call. This
field instructs ASYNCXS to select the device whose port number is
given by the lower 2 digits of the incoming calls called address (00).
Thus, if the device whose port number is 0 is enabled and not busy on
another call, the call is routed to it. If the device is not enabled, the call is
rejected with a status code indicating that the destination is not obtainable,
since there are no more PADmap entries in the table to examine. If the
device is busy on another call, or if the device selected by entry 2 is busy,
the call is rejected with a busy status code.
The order of entries in the PADmap table affects the manner in which call
assignments are made. In this example, the incoming call is eventually
assigned to a port number different from that originally specified in the
CUD field of the call request packet. If the second and third entries were
reversed in the PADmap table, the port number in the CUD field (new
entry 3) would only be used if the port identified by the loworder digits
of the NUA field (new entry 2) was unavailable.
224
ASYNCXS
C320001300D0
ASYNCXS
C320001300D0
31
When the PMM modifies a device or profile, the PMM only sends the
values entered on the Modify command line. ASYNCXS then updates
only the values that were sent.
32
ASYNCXS
C320001300D0
___________________________________________________________
0:0 National Marker
0 = default value
___________________________________________________________
1:1 PAD Recall
0 = none
1 = CtrlP
___________________________________________________________
2:1 Echo
0 = disabled
1 = enabled
___________________________________________________________
3:2 Data Forwarding Character (value combinations allowed)
0 = none
1 = alpha/numeric
2 = <CR>
4 = <ESC>, <BEL>, <ENQ>, <ACK>
8 = <CAN>, <DEL>, <DC2>
16 = <EXT>, <EOT>
32 = <HT>, <LF>, <VT>, <FF>
64 = other ASCII control characters not listed above
___________________________________________________________
4:0 Idle Timer (Data Forwarding Timeout)
0 = none
1255 = time (1/20 seconds)
___________________________________________________________
5:0 Device Flow Control
0 = none
1 = data mode
2 = data/command mode
___________________________________________________________
6:5 PAD Service Signals
0 = none
1 = standard/no prompt
4 = standard/prompt only
5 = standard/all
8 = extended
9 = extended/no prompt
12 = extended/prompt only
13 = extended/all
16 = extended/English language signals
32 = extended/French language signals
48 = extended/Spanish language signals
___________________________________________________________
ASYNCXS
C320001300D0
33
Parameter:Default Name
Value(s) = Description(s)
___________________________________________________________
7:2 Break Action (Send Reset Message on Break)
0 = none
1 = interrupt
2 = reset
4 = break indication
5 = interrupt and break indication
8 = command mode escape
16 = discard data destined for device
21 = discard output, send interrupt and break indication
___________________________________________________________
8:0 Discard Output (Read Only)
0 = normal data delivery
1 = discard output
___________________________________________________________
9:0 Padding After Carriage Return
0 = none
___________________________________________________________
10:0 Line Folding
0 = none
___________________________________________________________
11:22 Device Speed (Baud Rate)
0 = 110
1 = 134.5
2 = 300
3 = 1200
4 = 600
5 = 75
6 = 150
7 = 1800
10 = 50
11 = 75/1200
12 = 2400
13 = 4800
14 = 9600
15 = 19200
19* = 2000
20* = 3600
21* = 7200
22* = autobaud
___________________________________________________________
12:1 PAD Flow Control (Device Can Flow Control the PAD)
0 = disabled
1 = enabled
___________________________________________________________
13:1 Line Feed/Carriage Return Insertion (Data Mode) (value combinations allowed)
0 = none
1 = insert <LF> after <CR> to device
2 = insert <LF> after <CR> from device
4 = insert <LF> after echoed <CR>
8* = insert <CR> after <LF> to device
___________________________________________________________
14:0 Padding after Line Insertion (Data/Command Mode)
0 = none
1255 = number of character
___________________________________________________________
15:1 Editing in Data Transfer Mode
0 = disabled
1 = enabled
___________________________________________________________
16:127 Character Delete Character
0255 = ASCII character
___________________________________________________________
34
ASYNCXS
C320001300D0
Parameter:Default Name
Value(s) = Description(s)
___________________________________________________________
17:0 Line Delete Character
0255 = ASCII character
___________________________________________________________
18:0 Line Display Character
0255 = ASCII character
___________________________________________________________
19:2 Transmit Editing Service Signals
1 = for print devices
2 = for display terminals
___________________________________________________________
20:0 Echo Mask
0 = no mask
1 = no <CR> echo
2 = no <LF> echo
4 = no <VT>, <HT>, or <FF> echo
8 = no <BEL> or <BS> echo
16 = no <ESC> or <ENQ> echo
32 = no <ACK>, <NAK>, <STX>, <SOH>, <EOT>, <ETB>, or <ETX> echo
64 = no editing character echo
128 = no echo of <NUL>, <SO>, <SI>, <DLE>, <DC1>, <DC2>, <DC3>, <DC4>,
<SYN>, <CAN>, <EM>, <SUB>, <FS>, <GS>, <RS>, <US>, <DEL>
___________________________________________________________
21:0 Parity Treatment
0 = 8 bits no parity
2 = 8 bits, odd, no check
3 = 8 bits, odd
6* = 8 bits, even, no check
7* = 8 bits, even
___________________________________________________________
22:0 Page Wait (not currently implemented)
0 = none
___________________________________________________________
23*:0 Additional Forwarding Character 1
0 = none
1255 = ASCII character
___________________________________________________________
24*:0 Additional Forwarding Character 2
0 = none
1255 = ASCII character
___________________________________________________________
25*:0 Output Pending (Due to Input)
0 = none
___________________________________________________________
26*:0 Interval Timer (For Transmitting Data)
0 = none
1255 = time (1/20 seconds)
___________________________________________________________
27*:0 Padding After Horizontal Tab <HT>
0 = none
1255 = number of characters
___________________________________________________________
ASYNCXS
C320001300D0
35
Parameter:Default Name
Value(s) = Description(s)
___________________________________________________________
28*:0 XON Character from PAD to Device
0 = DC1
1255 = ASCII character
___________________________________________________________
29*:0 XOFF Character from PAD to Device (value combinations allowed)
0 = DC3
1127 = ASCII character
128 = send <BEL> only if typeahead buffer overflows
___________________________________________________________
30*:0 XON Character from Device to PAD
0 = DC1
1255 = ASCII character
___________________________________________________________
31*:0 XOFF Character from Device to PAD
0 = DC3
1255 = ASCII character
___________________________________________________________
80*:1 Signon Options (value combinations allowed)
0 = no wait for input
1 = wait for <CR>
4 = run signon file
8 = enable CTS output flow control
16 = enable DTR input flow control
32 = enable RTS input flow control
___________________________________________________________
81*:24 Session Control (value combinations allowed)
0 = none
1 = disable <CR> terminate
2 = autocall at enable
4 = disable at call clear
+8 = auto reenable
+16 = enable symbols
64 = restore precall profile at call clear
128 = disable + terminate
___________________________________________________________
82*:0 Alternate Break Character
0 = none
___________________________________________________________
83*:0 Forwarding on Character Count
0 = none
1255 = number of characters
___________________________________________________________
84*:0 Read Options (value combinations allowed)
0 = none
8 = convert to uppercase
2 = enable X3.64
16 = passall
4 = filter X3.64
___________________________________________________________
85*:0 Discard Output
0 = none
___________________________________________________________
86*:0 Diagnostic Echo
0 = none
1 = echo
2 = echo size
3 = primary
4 = alternate
___________________________________________________________
36
ASYNCXS
C320001300D0
ASYNCXS
C320001300D0
37
You can also switch from data transfer mode to command mode by
transmitting a break if P7=8. To maintain character transparency and
permit any ASCII character to be sent as data, set P1=0 and use a break
(P7) to escape from data transfer mode.
P2 Terminal Echo
P2 tells the PAD whether input data from the device is to be transmitted
back to the device for visual display on the screen.
When local echo is enabled and block mode input is used, a delay can
occasionally occur between key depression and the character appearing on
the screen. This delay depends on the devices configured FBTimer value.
Value
Function
0 . . . . . . . . . Disable echo
1 (Def) . . . . Enable echo
P3 Data Forwarding Characters
P3 defines the characters that are used in data transfer mode to forward
accumulated data to the remote device. To select combinations of
forwarding characters, add the values and specify the sum. For example,
to select <CR>, <ETX>, and <EOT> as the data forwarding characters, set
P3=18 (the sum of 2 + 16).
Value
Function
0 . . . . . . . . . No data forwarding characters
1 . . . . . . . . . Forward on receipt of alphanumeric characters AZ,
az, and 09
2 (Def) . . . . Forward on receipt of <CR> character
4 . . . . . . . . . Forward on receipt of <ESC>, <BEL>, <ENQ>, and
<ACK> characters
8 . . . . . . . . . Forward on receipt of <CAN>, <DEL>, and <DC2>
characters
16 . . . . . . . . Forward on receipt of <ETX> and <EOT> characters
32 . . . . . . . . Forward on receipt of <HT>, <LF>, <VT>, and <FF>
characters
64 . . . . . . . . Forward on receipt of any other ASCII control
characters not included above
P4 Data Forwarding on Timeout
P4 controls the idle data forwarding timer. A nonzero value specifies the
interval of inactivity in data transfer mode after which the PAD forwards
any accumulated data to the remote device.
The timer is reset and started when a character is entered from the device.
If the P4 interval expires before another character is entered, the
characters in the packet are forwarded. Empty packets are not forwarded.
38
ASYNCXS
C320001300D0
Function
No device flow control in data transfer mode
Device flow control in data transfer mode
Device flow control in command and data transfer
modes
When P5=1, flow control manages data entry into the typeahead buffer
while a call is active. The PAD flow controls the device whenever the
PAD is temporarily unable to receive more data because the flow control
level of the typeahead buffer is reached. When the PAD is later able to
accept data, it cancels flow control. In addition, the PAD sends a flow on
signal/character to the terminal when a call is established, and a flow off
signal/character to the terminal when a call is cleared.
When P5=2, flow control manages data entry into the typeahead buffer
even when a call is not active. The PAD flow controls the device when the
PAD is temporarily unable to receive more data because the flow control
level of the typeahead buffer is reached. When the PAD is later able to
accept data, it cancels flow control.
Flow control can be done with characters (XON and XOFF) or modem
signals. P28 and P29 specify the XON and XOFF character values. P80
specifies modem flow control by CTS, DTR, or RTS.
When P29 > 127, the PAD sends <BEL> characters to the terminal when
the typeahead buffer is full and P5 is nonzero.
If ASYNCXS is using a Line Processing Module (LPM) port that is
configured with XON/XOFF flow control, you cannot disable flow control
with P5.
Telematics strongly recommends that flow control be enabled (with P5)
and that the device respond accordingly when performing file transfers.
This is especially critical when echo is also enabled (with P2).
ASYNCXS
C320001300D0
39
Function
Signals are not transmitted
All signals except the prompt are transmitted
Standard prompt is transmitted; no service signals are
transmitted
5 (Def) . . . . Standard service signals and prompt are transmitted
8 . . . . . . . . . Service signals are transmitted in extended format
9 . . . . . . . . . Extended format service signals are transmitted; no
prompt is transmitted
12 . . . . . . . . Devicespecific prompt is transmitted; no service
signals are transmitted
13 . . . . . . . . Extended format service signals and devicespecific
prompt are transmitted
16 . . . . . . . . Extended format service signals are transmitted in
English
32 . . . . . . . . Extended format service signals are transmitted in
French
48 . . . . . . . . Extended format service signals are transmitted in
Spanish
When P6=0, 1, or 9, the PAD gives no indication to the device that it is
awaiting a command. This may be required if the device is a host
computer, but can be confusing if the device is a terminal.
Similarly, when P6=0, the PAD does not transmit messages informing the
device of certain events, e.g., invalid X.28 commands or network
connection commands that did not complete. This can be undesirable for a
terminal device; however, for a host computer device, this can eliminate
the need for the host software to parse PAD responses unnecessarily.
You can define an alternate prompt service signal for each terminal. If
P6=12 or 13, this prompt signal replaces the standard X.28 * prompt.
If the extended format plus French and/or Spanish values are set, multiple
service signals may be output.
The X.28 Language command (page 526) can be used to set certain P6
service signal format values (e.g., 5 (DEFAULT parameter) 21 (ENGLISH
parameter), 37 (FRENCH parameter), 53 (SPANISH parameter), 13
(DEPENDENT parameter)).
310
ASYNCXS
C320001300D0
Function
No action
Send interrupt packet to remote device
Issue a reset to remote device
Send indication of break message to remote device
Interrupt and indication of break
Escape from data transfer mode to command mode
Discard data destined for the device; sets P8=1
Discard data destined for the device, send interrupt and
break indication
Setting P7=21 can be used to terminate a large volume of output data from
a remote device. In this case, the local PAD transmits an interrupt packet
with all bits of the interrupt user data field set to 0, followed by an
indication of break message to the remote PAD. This message indicates in
its parameter field that P8 has been set to 1, and output is to be discarded.
The remote PAD, upon receiving the interrupt packet, returns a
confirmation packet to the local PAD. Upon receiving the indication of
break, the remote PAD discards any partially completed packets destined
for the local PAD. Before resuming data transmission to the local PAD,
the remote PAD must issue a response to the indication of break with a set
or set and read PAD message, indicating that P8 should be set back to zero
for normal data delivery.
The receipt of a break signal by the remote PAD is a packet forwarding
condition except when P7=0. Similarly, the remote PAD ignores a receipt
of break when no virtual call has been established.
P7=1 instructs the local PAD to transmit an interrupt packet with all bits of
the interrupt user data field set to 1.
P7=5 instructs the local PAD to transmit an interrupt packet with all bits of
the interrupt user data field set to 0.
ASYNCXS
C320001300D0
311
P8 Discard Output
P8 controls the delivery of data from the network to the device, allowing
normal delivery or instructing the PAD to discard any data received.
The value of P8 is always set initially to zero. For information about when
the PAD changes this value, see the X.29 Recommendation, sections 3.3.1,
3.3.2, and 3.3.3.
Value
Function
0 (Def) . . . . Normal data delivery
1 . . . . . . . . . Discard data
P9 Padding after Carriage Return
P9 controls the PADs automatic insertion of padding characters after each
<CR> character transmitted in the data stream to the device. Padding may
be required for terminals that try to display a character before the
preceding carriage return operation completes (because of a mechanical
printing assembly or other mechanism).
If the sequence <CR><LF> is sent to the device as a format effector for
line folding, or if a <LF> is inserted after the <CR> as specified by P13,
the padding is inserted after the <LF>.
The padding character is specified during device configuration (PADchar
parameter). Unless otherwise specified, the default padding character is
<NUL>. Padding characters are not inserted after a <CR> is echoed to the
terminal.
Value
Function
0 (Def) . . . . No padding after <CR>
1255 . . . . . Number of padding characters to be inserted after a
<CR> sent to the terminal
P10 Line Folding
P10 defines the devices line length. A <CR><LF> is automatically
transmitted to the terminal when data containing more graphic characters
than the defined line length is sent to the terminal. For example, if
P10=80, output lines are folded into 80 character segments when sent to
the terminal.
Only graphic characters count toward line length; nonprinting characters
are not counted.
Value
Function
0 (Def) . . . . No line folding
1255 . . . . . Number of graphic characters per line
312
ASYNCXS
C320001300D0
Value
Bit Rate
12 . . . . . . . 2400
13 . . . . . . . 4800
14 . . . . . . . 9600
15 . . . . . . . 19200
16** . . . . . . 48000
17 . . . . . . . 56000
18** . . . . . . 64000
19* . . . . . . . 2000
20* . . . . . . . 3600
21* . . . . . . . 7200
22* (Def) . . . Autobaud
When P11=11, the input and output line speeds are 75 and 1200 bits per
second, respectively.
To explicitly set the devices speed and parity, configure the speed with
P11, and the parity with P21.
You can configure a device so that the PAD automatically detects the
devices speed and parity when the device attempts to connect to the PAD.
During automatic detection, autoparity and autobaud are inseparable; if
speed is automatically detected, so is parity. In other words, you cannot
specify an explicit parity for the device and autobaud.
To select autobaud/autoparity detection, set P11=22; the P21 setting is
irrelevant. Enter several periods from the terminal at one to two
second intervals. When two periods echo, enter a carriage return to
automatically set the incoming baud rate and parity. At this point, the
PAD sets P11 and P22 to the detected speed and parity.
A one minute timer is set while the software is awaiting the input for
autobaud detection. If this timer expires with no input received from
the device, the device is disabled. You can use P81 to automatically
reenable the device for another minute.
ASYNCXS
C320001300D0
313
314
ASYNCXS
C320001300D0
Value
Function
0 (Def) . . . . No padding after line feed
1255 . . . . . Number of padding characters to be inserted
P15 Editing in Data Transfer Mode
P15 controls the editing capabilities of the device while it is in data
transfer mode. Editing allows you to modify or display device input data
before it is forwarded.
You can only edit data on the current line. For example, if P10 sets a line
length of 20, and 25 characters have been entered, only characters 21
through 25 can be modified or displayed.
Setting P15=1 suspends the action of P4, i.e., data is not forwarded when
the idle timer expires.
Value
Function
0 . . . . . . . . . Disable editing in data transfer mode
1 (Def) . . . . Enable editing in data transfer mode
P16 Character Delete
P16 specifies the character delete character. Character delete can be used
in data transfer mode only if editing is enabled (P15=1). You can only edit
data on the current line.
Value
Function
0255 . . . . . Decimal value of the character delete character
(Def=127)
P17 Line Delete
P17 specifies the line delete character. Line delete can be used in data
transfer mode only if editing is enabled (P15=1). You can only edit data
on the current line.
Value
Function
0255 . . . . . Decimal value of line delete character (Def=0)
P18 Line Display
P18 specifies the line display character. Line display can be used in data
transfer mode only if editing is enabled (P15=1). You can only edit data
on the current line.
Value
Function
0255 . . . . . Decimal value of line display character (Def=0)
ASYNCXS
C320001300D0
315
Function
No echo mask (all characters echoed)
No echo of <CR>
No echo of <LF>
No echo of <VT>, <HT>, or <FF>
No echo of <BEL> or <BS>
No echo of <ESC> or <ENQ>
No echo of <ACK>, <NAK>, <STX>, <SOH>,
<EOT>, <ETB>, or <ETX>
64 . . . . . . . . No echo of editing characters specified in P16, P17,
and P18
128 . . . . . . . No echo of <NUL>, <SO>, <SI>, <DLE>, <DC1>,
<DC2>, <DC3>, <DC4>, <SYN>, <CAN>, <EM>,
<SUB>, <FS>, <GS>, <RS>, <US>, or <DEL>
P21 Parity Treatment
P21 instructs the PAD to check parity in the data stream from the device
and to generate parity in the data stream to the device.
Value
0 (Def) . . . .
2 .........
3 .........
6* . . . . . . . .
7* . . . . . . . .
316
Function
8 bits, no parity
8 bits, odd parity, no check
8 bits, odd parity
8 bits, even parity, no check
8 bits, even parity
ASYNCXS
C320001300D0
16*
18*
19*
22*
23*
.......
.......
.......
.......
.......
7 bits, no parity
7 bits, odd parity, no check
7 bits, odd parity
7 bits, even parity, no check
7 bits, even parity
ASYNCXS
C320001300D0
317
318
ASYNCXS
C320001300D0
You can specify an XOFF character and the use of the <BEL> by giving
P29 the value of 128 plus the decimal value of the XOFF character. For
example, if P29=150 (128+22), the XOFF character from the PAD to the
device is specified as <SYN>, and the PAD sends <BEL>s when the
typeahead buffer is full.
Value
0 (Def) . . . .
1127 . . . . .
128 . . . . . . .
Function
XOFF character is <DC3>
Decimal value of the XOFF character
Send <BEL> when typeahead full
ASYNCXS
C320001300D0
319
When P80=1, the PAD waits for input of a <CR> from the device before
initiating signon. Once the initial input has been used to sign on the
device, it is discarded and the device is placed in command mode.
When P80=4, the PAD executes the local signon include file for the
device. This file can contain X.28 commands to define symbols, establish
a call, or perform any other operations that can be initiated with
commands entered from the device itself. If P80=4, but no local signon
include file name is specified, the PAD takes no special action.
When P80=8, the PAD enables CTS flow control. In this case, the modem
stops sending data to the device when CTS drops, and resumes when CTS
is on. Setting P80=8 can only be done when the device is offline.
When P80=16, the PAD enables DTR flow control. In this case, the PAD
drops DTR instead of sending XOFF to the device, and raises DTR
instead of sending XON to the device. Setting P80=16 can only be done
when the device is offline.
When P80=32, the PAD enables RTS flow control. In this case, the PAD
drops RTS instead of sending XOFF to the device, and raises RTS instead
of sending XON to the device. Setting P80=32 can only be done when the
device is offline.
Both input flow control options (values 16 and 32) cannot be set at the
same time.
You can specify a combination of signon options. For example, if P80=5,
the PAD waits for input before signing on the device, and when input is
received, runs the signon include file, if present.
When P80s value is even (0, 4, 8, 16, or 32), the device is signed on as
soon as it is enabled, following modem connection and autobaud
procedures when required. When P80s value is odd (1 or 5), the device is
not recognized as being signed on to the PAD until the specified signon
actions complete.
P81* Session
Telematics P81 controls operational features of the session between the
device and the PAD.
Value
0 .........
1 .........
2 .........
4 .........
8 .........
Function
No session options
Disable <CR> command termination
Perform autocall at device enable
Disable device at call clear
Initiate reenable after disable, except INF operator
command (Default=24; 8+16)
16 . . . . . . . . Enable symbolic replacement (Default=24; 8+16)
64 . . . . . . . . Restore precall profile on call clear
320
ASYNCXS
C320001300D0
Function
ASYNCXS
C320001300D0
321
322
ASYNCXS
C320001300D0
Function
No diagnostic echo
Echo received data characters
Echo primary test pattern with length equal to the
ASCII value of the received character
3 . . . . . . . . . Echo full primary test pattern
4 . . . . . . . . . Echo full alternate test pattern
The primary test pattern is shown below; P10s value specifies the actual
number of characters displayed on a line.
THE QUICK BROWN FOX JUMPED OVER THE LAZY DOGS BACK
~0123456789 The quick brown fox jumped over the lazy
dogs back
+!@#$%^&*()[]<>?/:;\|{}.,
The alternate test pattern is shown below; P10s value specifies the actual
number of characters displayed on a line.
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz
0123456789
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz
0123456789
ASYNCXS
C320001300D0
323
324
ASYNCXS
C320001300D0
ASYNCXS
C320001300D0
41
Add Map . . . . . . . . . . .
Collect Statistics . . . . . .
Create Device . . . . . . . .
Create Directory . . . . . .
Create Profile . . . . . . . .
Define Initial . . . . . . . .
Delete Map . . . . . . . . . .
Destroy Device . . . . . . .
Destroy Directory . . . . .
Destroy Profile . . . . . . .
Disable Device . . . . . . .
Enable Device . . . . . . .
Erase Map . . . . . . . . . .
Modify Device . . . . . . .
Modify Initial . . . . . . . .
Modify Profile . . . . . . .
Reset Statistics . . . . . . .
Set Defaults Devices . .
Set Defaults Initial . . . .
Set Defaults Profiles . .
Show Defaults Devices
Show Defaults Initial . .
Show Defaults Profiles
Show Device . . . . . . . .
Show Directory . . . . . .
Show Initial . . . . . . . . .
Show Map . . . . . . . . . .
Show Profile . . . . . . . .
Show Statistics . . . . . . .
42
ASYNCXS
C320001300D0
Add Map
The Add Map command adds an entry to the PADmap table.
Syntax
ADD MAP NUA=<called_nua> [CUD=<call_user_data>] PORt=<port>
Parameters
NUA=<called_nua>
Called NUA address of an incoming call. The value assigned to the
NUA field in a PADmap entry is compared to the called address field
of the incoming call request.
Range:
CUD=<call_user_data>
Call user data of an incoming call. The values P%, P%%, P%%%, or
P%%%% can be specified to indicate that the call user data field of the
incoming call request can contain up to four digits representing the
subaddress (port number). In this case, the port field must be #. If an
empty string () is specified, only incoming calls with no user data
will satisfy the match.
Range:
PORt=<port>
String identifying the devices port number where the incoming call is
to be routed.
Range:
Examples
The following command indicates that incoming calls with any called
NUA and with no call user data will be routed to the first available port of
12, 13, 14, 15, and 16.
add map nua=* port=1216
The following command indicates that incoming calls whose called NUA
has exactly 10 digits beginning with the digits 9999404, and whose call
user data consists of three characters beginning with P will be routed to
the port whose number is specified by the last two digits of the call user
data.
add map nua=9999404%%% cud=P%% port=#
ASYNCXS
C320001300D0
43
Collect Statistics
The Collect Statistics command collects (and optionally resets) device
statistics from one or more ASYNCXS devices.
Syntax
COLlect[,Verify][,RESet] STATISTICS [ON] <device> [USING]
<stat_file>
Modifiers and Parameters
Verify
When specified, displays a verification message when the command
completes.
Reset
When specified, zeroes statistics after theyre written to the file.
ON
Aids readability.
<device>
Device name.
Range: Defined device names; wildcard characters are allowed
Default: ??
USING
Aids readability.
<stat_file>
Statistics file name. This file must have been previously activated for
statistics collection with an INF Activate Statistics command.
Range:
Example
The following command collects device statistics from the device named
device/d10 and writes them to the previously activated statistics file
named statsd10.
col statistics on device/d10 using statsd10
44
ASYNCXS
C320001300D0
Create Device
The Create Device command identifies a port as an ASYNCXS device.
Before creating the device, you must create a device directory (Create
Directory command). You may also want to establish default parameter
values with a Set Defaults Devices command. If profiles are to be used,
you must create a profile directory (Create Profile command). You can
then define the profiles to be used in this directory. You may also want to
establish default parameter values with a Set Defaults Profile command.
After the appropriate directories are created, the device can be created. A
device name and port number (corresponding to the physical channel)
must be specified. The command then allocates a channel and its
associated resources.
If the device is created in PAD mode (the default), it is also registered to
receive incoming calls, which allows it access to the packet switching
network through ASYNCXS. If the device is created in handler mode, it
can be IO/OPENed and have IO/READs and IO/WRITEs issued to it.
Only one Create Device command can be issued for a physical channel. If
X.3 parameter values and/or a local signon file have previously been
specified in a Create Profile command, and different values are specified
in the Create Device command, the Create Device command values are
used.
Syntax
CReate DEvice <dev_dir>/<dev_name> [USING] <port>
[<optional_ parameters>]
Parameters
<dev_dir>/<dev_name>
Device directory name followed by a slash and the device name.
Range:
USING
Enhances readability.
<port>
Asynchronous port number to which device is attached. This must be a
scanned port.
Range:
0479
<optional_parameters>
Described below:
ACCNumber=<accnumber>
Account number to be used with Telematics accounting.
Range:
ASYNCXS
C320001300D0
or 120 characters
45
ACCType=<acctype>
Account type to be used with Telematics accounting.
Range:
0255
BILling=<billing>
Billing number to be used with Telematics accounting.
Range:
132 digits
BLOCK=(BUFsize=<bufsize>,ELEments=<elements>,
[NO]FBTimer[=<fbtimer>]) | NOBLOCK
Level 1 input method. NOBLOCK indicates single character input.
BLOCK indicates block mode input, with <bufsize> the number of
bytes each buffer can hold, <elements> the number of buffers, and
<fbtimer> the time between the receipt of the first byte in the
buffer and when the buffer is read if it is not full.
NOFBTimer indicates the buffer will be read immediately; an
FBTimer value indicates the time delay before reading the buffer.
Telematics recommends that you do not change the block mode
parameters from their default values; they represent optimization
for file transfers and interactive users.
Range:
NOBLOCK |
BLOCK=(BUFsize=<232000>,ELEments=<2250>,
[NO]FBTimer=<02000 milliseconds>)
BREAKTime=<breaktime> | BREAKString=<breakstring> |
NOBREAK
Format of the break signal sent from the PAD to the device when
an indication of break PAD message is received from the network.
NOBREAK indicates the PAD does not send anything to the
device. BREAKTime indicates the PAD sends a binary 1 for the
specified time. BREAKString indicates the PAD sends the
specified string.
Range:
BREAKTime=<010000 milliseconds> |
BREAKString=< or 190 characters> | NOBREAK
CALLDElay=<calldelay>
Delay after which the PAD automatically places an X.25 call (if
autocall is enabled) once the device is created. To enable autocall,
X.3 P81 must equal 2 or a sum including 2, and the device must
have a valid called address.
Range:
0500 seconds
CALLEd=<called_addr>
Called NUA (default destination address for an X.28 Call
command). This is used when the called address is omitted or
when autocall is enabled (P81=2 or a sum including 2). If this
parameter is omitted, each X.28 Call command must include a
called address.
46
ASYNCXS
C320001300D0
ASYNCXS
C320001300D0
47
032767
0255 ($00$ff)
LSignon=<signon_file>
Name of file containing X.28 commands to be executed when the
device signs on to the PAD (if X.3 P80:4). Do not precede the file
name with the tm: identifier.
Range:
or 187 characters
MAxsymbols=<maxsymbols>
Maximum number of symbols that can be defined for a device
(Symbol Assignment command).
Range:
0256
MOdem=([NO]MODem,[NO]DTR,[NO]HANgup,[NO]AUToanswer)
Devices modem characteristics. Multiple values must be separated
by commas.
MODem indicates the device is configured for modem support.
ASYNCXS enables modem signal change notification (DSR,
DCD, and Ring Indication). See Chapter 2 for information about
subparameter effects. NOMODem indicates the device is not
configured for modem support.
48
ASYNCXS
C320001300D0
OPM=PAD | HANdler
Creates the device in either PAD or handler operating mode. The
handler operating mode allows a user task to issue TRAX IO
services to the PAD device.
PADchar=<padchar>
Padding data transmitted to the device. P9, P14, and P27 determine
padding.
Range:
0255 ($00$ff)
PARameters=(<n:v,...>)
X.3 parameter values.
Range:
See Chapter 3
PROFile=<profile>
Name of devices initial or default X.3 profile.
Range:
116 characters
PROMpt=<prompt>
Devices prompt string when it is in command mode. P6 controls
the prompt display.
Range:
RETRYCount=<retrycount>
Number of times a call will be retried in case of failure. A zero
value indicates no retry limit. The RETRYTime parameter
specifies the interval between retries.
Range:
0127
RETRYTime=<retrytime>
Interval the PAD waits after a call has failed before trying again.
The RETRYCount parameter specifies the maximum number of
retries.
Range:
6600 seconds
REVerse=YES | NO | ALways
Reverse charging call facility. YES indicates the reverse charging
facility is specified in the X.28 Call command. NO indicates
reverse charging is not used, even if specified in the X.28 Call
command. ALways indicates reverse charging is used on every
call, even if it is not specified in the X.28 Call command.
RSIGNOFf=<remote_signoff_file>
Name of file containing X.28 commands to be executed when an
X.25 call to the device is cleared. Do not precede the file name
with the tm: identifier. If P81:4, the remote signoff file is not
executed at call clear time.
Range:
ASYNCXS
C320001300D0
or 187 characters
49
RSIGNON=<remote_signon_file>
Name of file containing X.28 commands to be executed when the
PAD device issues a successful X.28 Call command or
successfully accepts a call. Do not precede the file name with the
tm: identifier.
Range:
or 187 characters
12032767
X25IDLETimer=<timeout>
Data transfer mode timer value used to detect inactivity on an X.25
link. The timer starts when a device enters data transfer mode or
when ASYNCXS completes a write request to NET25. The timer
stops when a read from the device completes. When the timer
expires, the active call is cleared and the device is disabled. A zero
value indicates no timer (i.e., no timeout). (This parameters alias
is datatimeout, which was used in prior releases.)
Range:
0500 minutes
X25IORead=<x25ioread>
Size of read to be issued to X.25. A zero value indicates the links
maximum packet size will be used.
Range:
065535 bytes
X25IOWrite=<x25iowrite>
Size of write to be issued to X.25. A zero value indicates the links
maximum packet size will be used.
Range:
065535 bytes
X25volume=<x25volume>
Name of X.25 volume to be associated with a device. This allows
association of different NET25 revisions with devices.
Range:
410
ASYNCXS
C320001300D0
X28type=TELEmatics | C84
Type of X.28 commands available to the device. TELEmatics
indicates the device can issue any of the X.28 commands,
including Telematics extended commands. C84 indicates the
device is limited to CCITT 1984 X.28 standard commands, plus
only a few of the Telematics extended commands.
X3Type=TELEmatics | C84
Range of X.3 parameters available to the device. TELEmatics
indicates the device can use the full set of X.3 parameters,
including Telematics extended parameters. C84 indicates the
device is limited to CCITT 1984 X.3 standard parameters.
Examples
The following command creates a device (in the device directory named
device) with the IO entity name d23, connected to asynchronous port
number 23. The calling (local) NUA is 100010023432. The called
(remote) NUA is 1000221143054. All other parameters accept the defaults
in the most recent Set Defaults Device command, or the defaults from task
startup.
create device device/d23 using 23 called=1000221143054~
calling=100010023432
The following command creates a device (in the device directory named
devices) with the IO entity name d55, connected to asynchronous port
number 55. The calling (local) NUA is 311022510043. The default data
byte to be sent with an X.29 Interrupt command is $34. The device is
connected to a modem with the hangup option set, and the initial profile is
taken from a named profile that was previously created.
cr dev devices/d55 using 55 calling=311022510043~
intd=$34 modem=(modem,hangup) profile=terminal~
dir=asyncxs:profile/
The following command creates a device with the IO entity name 13 (in
the device directory named termdevs), connected to asynchronous port
number 13. The calling (local) network user address is 777720066754; the
called (remote) address is 777710023456. A maximum of 50 symbols can
be defined for this device. X.3 parameters are described after the example.
cr dev termdevs/13 13 calling=777720066754~
called=777710023456 maxs=50 par=(11:14,81:88)
ASYNCXS
C320001300D0
411
Create Directory
The Create Directory command creates a directory for devices and/or X.3
profiles. You must create a directory before creating the actual device and
X.3 profile.
Syntax
CReate DIrectory DEvice|PRofile <directory_name>/
Parameter
<directory_name>/
Directory name followed by a slash.
Range:
116 characters
Examples
The following command creates a device directory named device.
cr di device device/
412
ASYNCXS
C320001300D0
Create Profile
The Create Profile command defines a set of X.3 parameter values that
can be associated with a device.
Before creating a profile, you must create a profile directory (Create
Directory command). Also, before creating devices you may want to
establish default parameter values with the Set Defaults Profiles
command. Then, when you create a profile, you need only specify
parameters you want to change for the particular profile. If you have not
established defaults, the defaults assigned at task startup are used; X.3
parameter default values are listed in Chapter 3.
After an X.3 profile is defined, you can use the X.28 Profile command to
change the X.3 profile associated with a device.
Syntax
CReate PRofile <prof_dir>/<prof_name>
[PARameters=(<number>:<value>,...)]
Parameters
<prof_dir>/<prof_name>
Profile directory name followed by a slash and the profile name.
Range:
PARameters=(<number>:<value>,...)
X.3 parameter values.
Range:
See Chapter 3
Example
The following command defines a profile named R1 in the profile
directory named profile. The parameters not supplied (0, 19 through 31,
and 81 through 86) and the remote signon include file name, will be set
based on the corresponding values of the default profile. Table 31
contains parameter definitions and functions. This example assumes the
user is currently located at the appropriate profile directory.
create profile profile/R1 par=(1:1,2:1,3:2,4:0,5:0)~
par=(6:5,7:0,8:0,9:0,10:0,11:14,12:0,13:0,14:0)~
par=(15:1,16:127,17:24,18:18,80:1)
ASYNCXS
C320001300D0
413
Define Initial
The Define Initial command identifies the logical volume name to receive
handler alarms and/or the NET25 interface compatibility revision. This
should be the first command issued after the ASYNCXS task is mounted.
Syntax
DEFine INitial [ALarmvol=<alarm_vol>] [X25revision=F|G|H]
Parameters
ALarmvol=<alarm_vol>
Name of logical volume to receive handler alarms.
Range: 190 characters
Default: none; no alarms handler
X25revision=F|G|H
NET25 revision.
Default: F
Example
The following command defines inf as the logical volume to receive
alarms, and ASYNCXS will be interfacing with NET25 revision H.
def in al=inf x25=h
414
ASYNCXS
C320001300D0
Delete Map
The Delete Map command removes an entry from the PADmap table. The
NUA, CUD, and Port parameters must match the corresponding
parameters of the Add Map command that created the entry. If there are
two or more identical PADmap entries, the Delete Map command deletes
the first one in the table.
To delete all entries in a PADmap table, use the Erase Map command.
Syntax
DELete MAP NUA=<called_nua> [CUD=<call_user_data>]
PORt=<port>
Parameters
NUA=<called_nua>
Called NUA; must match the called NUA field of the map entry.
Range:
115 digits
CUD=<call_user_data>
Call user data; must match the CUD field of the map entry.
Range:
112 characters
PORt=<port>
Port number; must match the port field of the map entry.
Range:
Example
The following command deletes the PADmap entry that specified NUA
9999404%%%, call user data P%%, and port #.
delete map nua=9999404%%% cud=P%% port=#
ASYNCXS
C320001300D0
415
Destroy Device|Directory|Profile
The Destroy command destroys a device, an empty directory, or a profile.
When a device is destroyed, the port is deallocated. Active devices must
be disabled (Disable Device command) before they can be destroyed.
Destroying a device also cancels the devices registration for incoming
calls. To ensure an orderly shutdown before ASYNCXS stops execution,
all devices enabled by ASYNCXS should be destroyed before destroying
the ASYNCXS task.
When a profile is destroyed, the named profile specification is destroyed.
Syntax
DEStroy PRofile|DEvice|DIrectory <prof_dev_dir/>
Parameter
<prof_dev_dir/>
Profile, device, or empty directory name.
Range:
Examples
The following command destroys the device named d14.
destroy device d14
416
ASYNCXS
C320001300D0
Disable Device
The Disable Device command disables a device and signs it off from the
PAD. If a call is active to the device, it is cleared. The device can only be
reenabled by a subsequent Enable Device command, i.e., the device will
not automatically be reenabled if P81=8.
Syntax
DISable[,Verify] DEvice <device_name>
Modifier and Parameter
Verify
When specified, displays a verification message when the command
completes.
<device_name>
Device name.
Range:
Examples
The following command disables the device term1 and sends a
verification message to the terminal.
disable,verify device term1
ASYNCXS
C320001300D0
417
Enable Device
The Enable Device command sets the status of a device so that it can be
signed on. When a device is enabled, ASYNCXS begins any signon
procedures defined for the device.
Several X.3 parameters, such as P80, determine which signon conditions
must be met before a device is ready to receive incoming calls. For
example, if P80 instructs the PAD to wait for input from the device, the
device cannot receive incoming calls until that input is supplied. In this
case, the device cannot accept incoming calls even though it is enabled.
Syntax
ENable[,Verify] DEvice <device_name>
Modifier and Parameter
Verify
When specified, displays a verification message when the command
completes.
<device_name>
Device name.
Range:
Examples
The following command enables the device named term1.
en dev term1
The following command enables all devices for signon in the current
directory, and sends verification messages to the terminal.
enable,verify de *
Erase Map
The Erase Map command deletes all entries from the PADmap table. To
delete an individual PADmap table entry, use the Delete Map command.
Syntax
ERase MAP
418
ASYNCXS
C320001300D0
Modify Device
The Modify Device command changes one or more parameters for an
asynchronous device connected to the PAD. The device must have been
created previously with a Create Device command. At least one parameter
must be specified on the Modify Device command line. The device must
be disabled (Disable Device command) before the Modify Device
command is allowed.
Note that changes to any X.3 parameters affect the initial X.3 profile, not
the current X.3 profile associated with the device.
The MAxsymbols parameter cannot be changed in a Modify Device
command. If it must be changed, destroy the device and create a new one.
Modem subparameters should not be modified separately.
Syntax
MODify DEvice <dev_dir>/<dev_name> [<opt_parameters>]
Parameters
<dev_dir>/<dev_name>
Device directory name followed by a slash and the device name.
Range:
<opt_parameters>
Described below:
ACCNumber=<accnumber>
Account number to be used with Telematics accounting.
Range:
or 120 characters
ACCType=<acctype>
Account type to be used with Telematics accounting.
Range:
0255
BILling=<billing>
Billing number to be used with Telematics accounting.
Range:
132 digits
BLOCK=(BUFsize=<bufsize>,ELEments=<elements>,
[NO]FBTimer[=<fbtimer>]) | NOBLOCK
Level 1 input method. NOBLOCK indicates single character input.
BLOCK indicates block mode input, with <bufsize> the number of
bytes each buffer can hold, <elements> the number of buffers, and
<fbtimer> the time between the receipt of the first byte in the
buffer and when the buffer is read if it is not full.
NOFBTimer indicates the buffer will be read immediately; an
FBTimer value indicates the time delay before reading the buffer.
ASYNCXS
C320001300D0
419
NOBLOCK |
BLOCK=(BUFsize=<232000>,ELEments=<2250>,
[NO]FBTimer=<02000 milliseconds>)
BREAKTime=<breaktime> | BREAKString=<breakstring> |
NOBREAK
Format of the break signal sent from the PAD to the device when
an indication of break PAD message is received from the network.
NOBREAK indicates the PAD does not send anything to the
device. BREAKTime indicates the PAD sends a binary 1 for the
specified time. BREAKString indicates the PAD sends the
specified string.
Range:
BREAKTime=<010000 milliseconds> |
BREAKString=< or 190 characters> |
NOBREAK
CALLDElay=<calldelay>
Delay after which the PAD automatically places an X.25 call (if
autocall is enabled) once the device is created. To enable autocall,
X.3 P81 must equal 2 or a sum including 2, and the device must
have a valid called address.
Range:
0500 seconds
CALLEd=<called_addr>
Called NUA (the default destination address for an X.28 Call
command). This value is used when the called address is omitted
or when autocall is enabled (P81=2 or a sum including 2). If this
parameter is omitted, each X.28 Call command must include a
called address.
Range:
or 115 digits
CALLIng=<calling_addr>
Calling NUA. This must be specified for a device to be notified by
the PAD of an incoming call. The previous calling address is
deregistered and the new address is registered when the device is
enabled.
Range:
or 115 digits
420
ASYNCXS
C320001300D0
command.
PVC indicates the X.28 Call command cannot be used. Remote
connections use PVCs, and are initiated with the X.28 Connect
command.
SVC indicates the X.28 Connect command cannot be used.
Remote connections use SVCs, and are initiated with the X.28 Call
command.
CHArge=<charge>
Charge type to be used with Telematics accounting.
Range:
0255
CMDTImeout=<cmdtimeout>
Timeout value when the device enters X.28 command mode. When
the timer expires, ASYNCXS places the device in data transfer
mode if a call is active. If no call is active, the device is disabled.
A zero value indicates no timer (i.e., no timeout).
Range:
0500 seconds
CUD=<call_user_data>
Call user data to be sent with each call request, if the
corresponding field is omitted in the X.28 Call command. If this
information is omitted in the device specification and the X.28
Call command, no call user data is sent except the protocol
identifier.
Range:
1124 characters
DIRectory=<vol:dir/>
Volume and directory containing profiles the device can use.
Range:
126 characters
[NO]DTRCall
When DTRCall is specified, the PAD raises DTR when an X.25
call is established (that is, prior to the X.28 incoming call PAD
service signal), and lowers DTR when an X.25 call is cleared (that
is, after the clear confirmation PAD service signal).
DTRCall cannot be specified when SPeed=AUTObaud. It is also
incompatible with modem (i.e., DTR and RTS) input flow control.
It overrides all the modem subparameters. Input modem signal
detection is disabled. If you specify DTR input flow control with
X.28 or X.29 commands, DTRCall overrides it.
FCLevel=<flow_control>
Number of character positions remaining in the typeahead buffer,
at which point the PAD outputs the flow control character (if P5=1
or 2, and output flow control is enabled). The flow control level
should be based on the speed of the device and the device response
to a flow control signal.
Range:
ASYNCXS
C320001300D0
032767
421
0255 ($00$ff)
LSignon=<signon_file>
Name of file containing X.28 commands to be executed when the
device signs on to the PAD (if X.3 P80:4). Do not precede the file
name with the tm: identifier.
Range:
or 187 characters
MOdem=([NO]MODem,[NO]DTR,[NO]HANgup,[NO]AUToanswer)
Devices modem characteristics. Multiple values must be separated
by commas. Do not modify subparameters separately.
MODem indicates the device is configured for modem support.
ASYNCXS enables modem signal change notification (DSR,
DCD, and Ring Indication). See Chapter 2 for information about
subparameter effects. NOMODem indicates the device is not
configured for modem support.
OPM=PAD | HANdler
Changes the device to either PAD or handler operating mode.
PADchar=<padchar>
Padding data transmitted to the device. The values of P9, P14, and
P27 determine padding.
Range:
0255 ($00$ff)
PARameters=(<n:v,...>)
X.3 parameter values.
Range:
See Chapter 3
PROFile=<profile>
Name of devices initial or default X.3 profile.
Range:
116 characters
PROMpt=<prompt>
Devices prompt string when it is in command mode. P6 controls
the display of the prompt.
Range:
422
ASYNCXS
C320001300D0
RETRYCount=<retrycount>
Number of times a call will be retried in case of failure. A zero
value indicates no retry limit. The RETRYTime parameter
specifies the interval between retries.
Range:
0127
RETRYTime=<retrytime>
Interval the PAD waits after a call has failed before trying again.
The RETRYCount parameter specifies the maximum number of
retries.
Range:
6600 seconds
REVerse=YES | NO | ALways
Reverse charging call facility. YES indicates the reverse charging
facility is specified in the X.28 Call command. NO indicates
reverse charging is not used, even if specified in the X.28 Call
command. ALways indicates reverse charging is used on every
call, even if it is not specified in the X.28 Call command.
RSIGNOFf=<remote_signoff_file>
Name of file containing X.28 commands to be executed when an
X.25 call to the device is cleared. Do not precede the file name
with the tm: identifier. If P81:4, the remote signoff file is not
executed at call clear time.
Range:
or 187 characters
RSIGNON=<remote_signon_file>
Name of file containing X.28 commands to be executed when a
PAD device issues a successful X.28 Call command or
successfully accepts a call. Do not precede the file name with the
tm: identifier.
Range:
or 187 characters
ASYNCXS
C320001300D0
12032767
423
X25IDLETimer=<timeout>
Data transfer mode timer value used to detect inactivity on an X.25
link. The timer starts when a device enters data transfer mode or
when ASYNCXS completes a write request to NET25. The timer
stops when a read from the device completes. When the timer
expires, the active call is cleared and the device is disabled. A zero
value indicates no timer (i.e., no timeout). (This parameters alias
is datatimeout, which was used in prior releases.)
Range:
0500 minutes
X25IORead=<x25ioread>
Size of read to be issued to X.25. A zero value indicates the links
maximum packet size will be used.
Range:
065535 bytes
X25IOWrite=<x25iowrite>
Size of write to be issued to X.25. A zero value indicates the links
maximum packet size will be used.
Range:
065535 bytes
X25volume=<x25volume>
Name of X.25 volume to be associated with the device. This
allows you to associate different revisions of NET25 with devices.
Range:
X28type=TELEmatics | C84
Type of X.28 commands available to the device. TELEmatics
indicates the device can issue any of the X.28 commands,
including Telematics extended commands. C84 indicates the
device is limited to CCITT 1984 X.28 standard commands, plus
only a few of the Telematics extended commands.
X3Type=TELEmatics | C84
Range of X.3 parameters available to the device. TELEmatics
indicates the device can use the full set of X.3 parameters,
including Telematics extended parameters. C84 indicates the
device is limited to CCITT 1984 X.3 standard parameters.
Example
The following command modifies the device named printer1, which is in
the device directory named printdevs. The interval for outgoing break
signals is changed to 200 milliseconds, and the data transfer mode idle
timer is changed to 180 seconds.
modify device printdevs/printer1 breakt=200 datat=180
424
ASYNCXS
C320001300D0
Modify Initial
The Modify Initial command changes the logical volume name to receive
handler alarms. Note that you can identify a NET25 revision interface
compatibility with the Define Initial command, but you cannot change it
with a Modify Initial command.
Syntax
MODify INitial [ALarmvol=<alarm_vol>]
Parameter
ALarmvol=<alarm_vol>
Name of logical volume to receive handler alarms.
Range: 190 characters
Default: none; no alarms handler
Example
The following command changes the alarm volume to inf1.
mod in al=inf1
ASYNCXS
C320001300D0
425
Modify Profile
The Modify Profile command changes one or more X.3 parameters in an
existing profile. Only the specified parameters are changed.
Syntax
MODify PRofile <prof_dir>/<prof_name>
[PARameters=(<number>:<value>,...)]
Parameters
<prof_dir>/<prof_name>
Profile directory name followed by a slash and a profile name.
Range:
PARameters=(<number>:<value>,...)
X.3 parameter values.
Range:
See Chapter 3
Example
The following command changes parameter 81 to a value of 88 for the
profile prof3, which is in the profile directory named profile. With
P81=88, all devices using this profile are automatically reenabled if they
become disabled. The symbolic replacement function is enabled and the
profile is reset when a call is cleared to the values it had when the call was
initiated.
modify profile profile/prof3 par=(81:88)
426
ASYNCXS
C320001300D0
Reset Statistics
The Reset Statistics command clears one or more devices statistics.
Syntax
RESet[,Verify] STAtistics <device_name>
Modifier and Parameter
Verify
When specified, displays a verification message when the command
completes.
<device_name>
Device name.
Range:
Example
The following command resets the statistics to zero for the device named
printer1.
reset statistics printer1
ASYNCXS
C320001300D0
427
or 120 characters
Default: Null
ACCType=<acctype>
Account type to be used with Telematics accounting.
Range:
0255
Default: 0
BILling=<billing>
Billing number to be used with Telematics accounting.
Range:
132 digits
Default: 0
BLOCK=(BUFsize=<bufsize>,ELEments=<elements>,
[NO]FBTimer[=<fbtimer>]) | NOBLOCK
Level 1 input method. NOBLOCK indicates single character input.
BLOCK indicates block mode input, with <bufsize> the number of
bytes each buffer can hold, <elements> the number of buffers, and
<fbtimer> the time between the receipt of the first byte in the
buffer and when the buffer is read if it is not full.
NOFBTimer indicates the buffer will be read immediately; an
FBTimer value indicates the time delay before reading the buffer.
Telematics recommends that you do not change the block mode
parameters from their default values; they represent optimization
for file transfers and interactive users.
Range:
NOBLOCK |
BLOCK=(BUFsize=<232000>,ELEments=<2250>,
[NO]FBTimer=<02000 milliseconds>)
Default: BLOCK=(BUFsize=80,ELEments=10,FBTimer=0)
428
ASYNCXS
C320001300D0
BREAKTime=<breaktime> | BREAKString=<breakstring> |
NOBREAK
Format of the break signal sent from the PAD to the device when
an indication of break PAD message is received from the network.
NOBREAK indicates the PAD does not send anything to the
device. BREAKTime indicates the PAD sends a binary 1 for the
specified time. BREAKString indicates the PAD sends the
specified string.
Range:
BREAKTime=<010000 milliseconds> |
BREAKString=< or 190 characters> |
NOBREAK
Default: BREAKTime=500
CALLDElay=<calldelay>
Delay after which the PAD automatically places an X.25 call (if
autocall is enabled) once the device is created. To enable autocall,
P81 must equal 2 or a sum including 2, and the device must have a
valid called address.
Range:
0500 seconds
Default: 60 seconds
CALLEd=<called_addr>
Called NUA (the default destination address for an X.28 Call
command). This value is used when the called address is omitted
or when autocall is enabled (P81=2 or a sum including 2). If this
parameter is omitted, each X.28 Call command must include a
called address.
Range:
or 115 digits
Default:
CALLIng=<calling_addr>
Calling NUA. Must be specified for a device to be notified by the
PAD of an incoming call.
Range:
or 115 digits
Default:
CALLMethod=NORmal | DIRect | PVC | SVC
Type of remote connections that can be initiated from the device.
DIRect indicates the X.28 Call command initiates calls to a remote
device, but no called NUA can be provided with the command.
The device specification must have a value assigned to the called
NUA parameter; this value is used as the destination address.
NORmal indicates remote connections can be supported by SVCs
or PVCs, and a called NUA can be provided in the X.28 Call
command.
PVC indicates the X.28 Call command cannot be used. Remote
ASYNCXS
C320001300D0
429
connections use PVCs, and are initiated with the X.28 Connect
command.
SVC indicates the X.28 Connect command cannot be used.
Remote connections use SVCs, and are initiated with the X.28 Call
command.
Default: NORmal
CHArge=<charge>
Charge type to be used with Telematics accounting.
Range:
0255
Default: 1
CMDTImeout=<cmdtimeout>
Timeout value when a device enters X.28 command mode. When
the timer expires, ASYNCXS places the device in data transfer
mode if a call is active. If no call is active, the device is disabled.
A zero value indicates no timer (i.e., no timeout).
Range:
0500 seconds
1124 characters
Default:
DIRectory=<vol:dir/>
Volume and directory containing profiles the device can use.
Range:
126 characters
Default:
[NO]DTRCall
DTRCall indicates the PAD raises DTR when an X.25 call is
established (that is, prior to the X.28 incoming call PAD service
signal), and lowers DTR when an X.25 call is cleared (that is, after
the clear confirmation PAD service signal).
DTRCall cannot be specified when SPeed=AUTObaud. It is also
incompatible with modem (i.e., DTR and RTS) input flow control.
It overrides all the modem subparameters. Input modem signal
detection is disabled. If you specify DTR input flow control with
X.28 or X.29 commands, DTRCall overrides it.
Default: NODTRCall
430
ASYNCXS
C320001300D0
FCLevel=<flow_control>
Number of character positions remaining in the typeahead buffer,
at which point the PAD outputs the flow control character (if P5=1
or 2, and output flow control is enabled). The flow control level
should be based on the speed of the device and the device response
to a flow control signal.
Range:
032767
Default: 10
INState=ONLine | ENAbled | OFFline | CONnected | DISabled
Initial device state. OFFline and DISabled create the device and
leave it in the disabled (offline) state; an Enable Device command
must be used to enable (online) the device. ONLine, ENAbled, and
CONnected create the device and enable it (without an Enable
Device command). If OFFline is specified, no checking is done to
see if the port is scanned or if another task is using it.
Default: CONnected
INTdata=<intdata>
Single data byte to be sent with the X.29 Interrupt command if no
byte is specified in the command.
Range:
0255 ($00$ff)
Default: 0
LSignon=<signon_file>
Name of file containing X.28 commands to be executed when the
device signs on to the PAD. Do not precede the file name with the
tm: identifier.
Range:
or 187 characters
Default:
MAxsymbols=<maxsymbols>
Maximum number of symbols that can be defined for a device
with the Symbol Assignment command.
Range:
0256
Default: 10
MOdem=([NO]MODem,[NO]DTR,[NO]HANgup,[NO]AUToanswer)
Devices modem characteristics. Multiple values must be separated
by commas.
MODem indicates the device is configured for modem support.
ASYNCXS enables modem signal change notification (DSR,
DCD, and Ring Indication). See Chapter 2 for information about
subparameter effects. NOMODem indicates the device is not
configured for modem support.
ASYNCXS
C320001300D0
431
0255 ($00$ff)
Default: 0
PARameters=(<n:v,...>)
X.3 parameter values. Note that values are not checked for validity
when specified in this command.
Range:
See Chapter 3
116 characters
Default:
PROMpt=<prompt>
Devices prompt string when it is in command mode. P6 controls
the display of the prompt.
Range:
Default: Service:
RETRYCount=<retrycount>
Number of times a call will be retried in case of failure. A zero
value indicates no retry limit. The RETRYTime specifies the
interval between retries.
Range:
0127
Default: 0
432
ASYNCXS
C320001300D0
RETRYTime=<retrytime>
Interval the PAD waits after a call has failed before trying again.
The RETRYCount parameter specifies the maximum number of
retries.
Range:
6600 seconds
Default: 6 seconds
REVerse=YES | NO | ALways
Reverse charging call facility. YES indicates the reverse charging
facility is specified in the X.28 Call command. NO indicates
reverse charging is not used, even if specified in the X.28 Call
command. ALways indicates reverse charging is used on every
call, even if it is not specified in the X.28 Call command.
Default: YES
RSIGNOFf=<remote_signoff_file>
Name of file containing X.28 commands to be executed when an
X.25 call to the device is cleared. Do not precede the file name
with the tm: identifier. If P81:4, the remote signoff file is not
executed at call clear time.
Range:
or 187 characters
Default:
RSIGNON=<remote_signon_file>
Name of file containing X.28 commands to be executed when a
PAD device issues a successful X.28 Call command or
successfully accepts a call. Do not precede the file name with the
tm: identifier.
Range:
or 187 characters
Default:
SERvice=NONE | DIAL | DIREct | 0255
Used with Telematics accounting. The device connection: dial up
(DIAL or 1), leased line (DIREct or 2), neither dial up nor leased
line (NONE or 0), or other (0255).
Default: DIAL
SPeed=50 | 75 | 110 | 134 | 150 | 300 | 600 | 1200 | 1800 | 2000 | 2400 |
3600 | 4800 | 7200 | 9600 | 19200 | AUTObaud
Bit rate of the device accessing the PAD. This parameter has the
same effect as X.3 P11. Conversely, setting P11 causes this
parameter to be assigned the specified value.
Default: AUTObaud
ASYNCXS
C320001300D0
433
STOPbits=1 | 2
Number of stop bits.
Default: 1
TYPeahead=<buffersize>
Number of characters the typeahead buffer can hold.
Range:
12032767
Default: 160
X25IDLETimer=<timeout>
Data transfer mode timer value used to detect inactivity on an X.25
link. The timer starts when a device enters data transfer mode or
when ASYNCXS completes a write request to NET25. The timer
stops when a read from the device completes. When the timer
expires, the active call is cleared and the device is disabled. A zero
value indicates no timer (i.e., no timeout). (This parameters alias
is datatimeout, which was used in prior releases.)
Range:
0500 minutes
Default: 20 minutes
X25IORead=<x25ioread>
Size of read to be issued to X.25. A zero value indicates the links
maximum packet size will be used.
Range:
065535 bytes
Default: 0
X25IOWrite=<x25iowrite>
Size of write to be issued to X.25. A zero value indicates the links
maximum packet size will be used.
Range:
065535 bytes
Default: 0
X25volume=<x25volume>
Name of X.25 volume to be associated with a device. This allows
you to associate different revisions of NET25 with devices.
Range:
Default: X25:
434
ASYNCXS
C320001300D0
X28type=TELEmatics | C84
Type of X.28 commands available to the device. TELEmatics
indicates the device can issue any of the X.28 commands,
including Telematics extended commands. C84 indicates the
device is limited to CCITT 1984 X.28 standard commands, plus
only a few of the Telematics extended commands.
Default: TELEmatics
X3Type=TELEmatics | C84
Range of X.3 parameters available to the device. TELEmatics
indicates the device can use the full set of X.3 parameters,
including Telematics extended parameters. C84 indicates the
device is limited to CCITT 1984 X.3 standard parameters.
Default: TELEmatics
Example
The following command sets default values for subsequent Create Device
commands in which the corresponding parameters are omitted. The
remote signon message include file is named mh:apadsign. The initial
state of the device is disabled. When a device is in command mode and a
60 second timeout value is reached, the device is placed into data transfer
mode if a call is active, and disabled if no call is active. The values
assigned to the X.3 parameters are described following the example.
set def dev rsignon=mh:apadsign instate=disabled cmdti=60~
par=(1:0,5:0,15:1,16:8,17:24,18:18,11:14,21:0,80:5,82:0)
ASYNCXS
C320001300D0
435
436
ASYNCXS
C320001300D0
ASYNCXS
C320001300D0
437
= ONLine
=
= 666690010015
= PAD
Maximum Symbols
[MA]
PAD character
[PAD]
Interrupt Data
[INT]
Call retry cnt[RETRYC]
Call method
[CALLM]
Typeahead size
[TYP]
Stop bits
[STOP]
X.25 IO/WRITE [X25IOW]
Break time
[BREAKT]
=
=
=
=
=
=
=
=
=
20
00
?($00)
3
NORmal
512
1
0
250
[CALLDE]
[CMDTI]
[X25IDLET]
[RETRYT]
[X25]
[FCL]
[REV]
[X25IOR]
=
=
=
=
=
=
=
=
10
0
20
6
x25:
10
yes
0
Block Input
[BLOCK] = NOBLOCK
Modem options [MOdem] = (NOMODem,DTR,NOHANgup,NOAUToanswer)
DTR control [DTRCall]
NODTRCall
Account Type
[ACCT]
Charge Indicator
[CHArge]
Configured Account Number [ACCN]
Configured Billing Number [BIL]
International X.3 Parameters
0:0
1:1
2:1
3:2
8:0
9:0
10:80 11:14
16:127
17:0
18:0
19:2
National X.3 Parameters
23:0 24:0 25:0 26:0
31:0
80:1 81:24 82:0 83:0
= 0
= 1
=
= 0
4:0
5:2
12:1 13:1
20:0 21:0
27:0
28:0
29:0
84:0
85:0
86:0
438
Service Type
6:5
14:0
22:0
[SERvice] = 2
7:2
15:1
30:0
= AsyncXS:
= asyncxs:profile/
=
=
=
=
ASYNCXS
C320001300D0
The default alarm volume is inf and the NET25 compatibility interface
revision H is specified.
4:0
12:1
20:0
5:2
13:1
21:0
6:5
14:0
22:0
7:2
15:1
26:0
27:0
28:0
29:0
30:0
83:0
84:0
85:0
86:0
ASYNCXS
C320001300D0
439
Show Device
The Show Device command displays either summary or detailed
information about an asynchronous device. Device operational states are
initially configured; during operations, the current state is reported in this
command. See Chapter 2 for a description of each state.
Syntax
SHow DEVice[,Full] [<dev>]
Modifier and Parameter
Full
Requests a detailed display. If specified, the <dev> parameter must
specify a single device.
<dev>
Device name.
Range:
Examples
The following command displays summary information about all devices
whose names begin with the letter d.
sh dev d*
ASYNCXS Device Summary for d/* on <node_name>
Name
Type
State
d59
Device
Connect
Name
Type
State
440
ASYNCXS
C320001300D0
= ONLine
=
= 999910210059
= PAD
Maximum Symbols
[MA]
PAD character
[PAD]
Interrupt Data
[INT]
Call retry cnt[RETRYC]
Call method
[CALLM]
Typeahead size
[TYP]
Stop bits
[STOP]
X.25 IO/WRITE [X25IOW]
Break time
[BREAKT]
=
=
=
=
=
=
=
=
=
20
00
?($00)
0
NORmal
512
1
2500
200
[CALLDE]
[CMDTI]
[X25IDLET]
[RETRYT]
[X25]
[FCL]
[REV]
[X25IOR]
=
=
=
=
=
=
=
=
10
0
0
10
x25:
488
yes
2500
Block Input
[BLOCK] = NOBLOCK
Modem options [MOdem] = (NOMODem,DTR,NOHANgup,NOAUToanswer)
DTR control [DTRCall] = NODTRCall
Account Type
[ACCT]
Charge Indicator
[CHArge]
Configured Account Number [ACCN]
Current Account Number
Configured Billing Number [BIL]
Current Billing Number
International X.3 Parameters
0:0
1:1
2:1
3:2
8:0
9:0
10:0
11:14
16:127
17:0
18:0
19:2
National X.3 Parameters
23:0 24:0 25:0 26:0
31:0
80:4 81:88 82:0 83:0
=
=
=
=
=
=
0 Service Type
0
axstest
axstest
999960010031
999960010031
4:1
5:2
12:1 13:0
20:0 21:0
27:0
28:0
29:0
84:0
85:0
86:0
ASYNCXS
C320001300D0
6:29
14:0
22:0
[SERvice] = 2
7:2
15:1
30:0
= AsyncXS:
= asyncxs:profile/
= terminal
=
=
=
441
Show Directory
The Show Directory command displays the names of all profile or device
entries in an ASYNCXS directory that match the name or wildcard
string.
Syntax
SHow DIrectory [<dir/name>]
Parameter
<dir/name>
Directory name followed by a slash and the device or profile name.
Range: Defined directory names
Default: * (all directories)
Examples
The following command displays the names of all entries in the directory
named device with device as part of the name.
show dir device/device*
Type
State
Device
Name
p
Type
State
Profile
This display shows two directories: one device directory named d and one
profile directory named p (note that the State column is not used when the
command is issued without a parameter). The following commands
display the contents of each of these directories (only device directories
have State column entries; profile directories do not).
sh dir d/
442
Type
State
Device
Connect
Name
Type
State
ASYNCXS
C320001300D0
sh dir p/
ASYNCXS Directory Summary for p/* on <node_name>
Name
Type
State
Name
Type
State
90
ASYNCXS
C320001300D0
Profile
443
Show Initial
The Show Initial command displays the current logical volume options.
Syntax
SHow INitial
Example
sh in
ASYNCXS Initial Options
ALarmvol = inf
X25revision = H
The current alarm volume is inf and revision H is the NET25 interface
compatibility revision.
Show Map
The Show Map command displays all entries in the ASYNCXS PADmap
table.
Syntax
SHow MAP
Example
The following command displays the PADmap table entries.
sh map
ASYNCXS Map Table on <node_name>
NUA
666650010015
CUD
abc
Port
1 10
This PADmap table contains one entry for NUA 666650010015. The call
user data (CUD) of an incoming call is abc. Incoming calls are routed to
port numbers 110.
444
ASYNCXS
C320001300D0
Show Profile
The Show Profile command displays summary or detailed information
about X.3 profiles.
Syntax
SHow PRofile[,Full] [<prof>]
Modifier and Parameter
Full
Requests a detailed display. If specified, the <prof> parameter must
specify a single profile.
<prof>
Profile name.
Range:
Parameters
2:1
3:2
10:0
11:14
18:0
19:2
4:0
5:0
12:1 13:1
20:0 21:0
27:0
28:0
29:0
84:0
85:0
86:0
6:5
14:0
22:0
7:2
15:1
30:0
Type
90
Profile
ASYNCXS
C320001300D0
State
Name
Type
State
445
Show Statistics
The Show Statistics command displays either summary or detailed device
statistics. Each counter shown in a detailed display rolls over to zero after
exceeding a value of 2321.
Syntax
SHow[,Full] STAtistics [<device_name>]
Modifier and Parameter
Full
Requests a detailed display. If specified, the <device_name> parameter
must specify a single device.
<device_name>
Device name.
Range:
Connect
999910210059
calling
999960010031
446
00:10
calling
1
327
1
0
0
0
0
State: Online
Remote NUA/PVCLCN 999960010031
Calls received:
0
Async characters read:
62
X.25 reads issued:
1
X.25 resets received:
0
X.25 interrupts received: 0
Async parity errors:
0
Async breaks detected:
0
ASYNCXS
C320001300D0
5 X.28 Commands
This chapter describes the X.28 commands. The X.28 command language
implemented by Telematics conforms to standards in the CCITT 1984
Recommendation for communication between a terminal and a PAD.
Telematics also provides extended functionality for handling data transfers
in special ways.
ASYNCXS
C320001300D0
51
X.28 COMMANDS
52
ASYNCXS
C320001300D0
X.28 COMMANDS
ASYNCXS
C320001300D0
53
X.28 COMMANDS
54
ASYNCXS
C320001300D0
X.28 COMMANDS
Aread
The Aread command reads a string of data from the device, compares it to
a pattern string, and optionally assigns the matched string to a symbol.
The input string from the device is compared to the specified pattern
string. If the input string does not match the pattern string, the PAD
discards the input string and reads another string from the device. If the
PAD does not receive a matching string within a specified time interval, or
if no input string is received from the device within the time interval, the
PAD disables the device. If no timer value is specified, the PAD continues
to read from the device until the pattern string is matched. Only when the
pattern is matched will another X.28 command be accepted.
This command is used primarily in the signon include file, requiring the
terminal user to enter a valid password before continuing the session. If
the user does not enter a valid password within the timeout period, the
terminal is disabled. Once a correct password has been entered, it can be
assigned to a symbol. Subsequent commands in the signon file can use the
symbol to invoke subsidiary include files whose names depend on the
password.
If a break is entered by the device that initiated the Aread command, the
command terminates.
Syntax
AREAD[,TIMer=<timeout>][,PATtern=<pattern_string>] [<symbol>]
Parameters
<timeout>
Interval the PAD waits for an input string to be read.
Range: 0255 seconds
Default: 0 (no timeout)
<pattern_string>
Pattern string to be compared to each input string. See page 52 for
information about using wildcard characters.
Range:
ASYNCXS
C320001300D0
116 characters
55
X.28 COMMANDS
Response
Acknowledge PAD service signal This is the PADs normal response, and
indicates it is awaiting input. If the input string matches the pattern
string, the PAD displays the X.28 command prompt. Otherwise, the
PAD issues another Acknowledge signal and waits for another input
string to be supplied.
Read request timeout No data was received from the terminal during the
specified time limit; the terminal has been disabled.
56
ASYNCXS
C320001300D0
X.28 COMMANDS
C (Call)
The C (Call) command establishes a virtual connection (an X.25 call)
from the local device through the PAD and the packet switching network
to a remote device. The terminal user can specify a subset of NUA call
facilities on a percall basis. If NUA call facilities are specified, they must
be followed by a dash, as shown in the syntax below.
The remote device can be a terminal or a host computer, and may or may
not be connected to the network via a remote PAD. To successfully place a
call, neither the local nor the remote device can have an active call.
If the terminal has been configured with a default called NUA, the NUA
may be omitted. In this case, the PAD tries to call the default called NUA.
If the terminal has no default called NUA, the NUA field must be
supplied.
If the terminal has been configured with default call user data, the call user
data field may be omitted. In this case, the PAD sends the default call user
data with the call request. If the terminal has no default call user data, and
the call user data field is omitted from the Call command, no data is sent
with the call request.
The M. RPOA, S, T, and U facilities are not supported.
Syntax
[C] [<nua_call_facilities>,...] [<NUA>] [*<call_user_data>]
Parameters
C
Command keyword. This is the only X.28 command in which the
command keyword can be omitted.
<nua_call_facilities>
Includes the following:
A
Activates Telematics accounting, and accounting information is
displayed when the call clears.
B<CUG_number>
Activates the Bilateral Call User Group call facility, and provides
the CUG number for the call.
Range:
099
D[(<rcv_cls>,<tm_cls>)]
D[[(]<thru_class>[)]]
Activates the Throughput Class negotiation call facility, and
requests a receive and/or transmit throughput class. If both the
receive and transmit throughput classes (<rcv_cls> and <trn_cls>)
ASYNCXS
C320001300D0
57
X.28 COMMANDS
are supplied, they can have different values. If only one value
(<thru_cls>) is supplied, it applies to both receive and transmit
throughput classes, and the parentheses are optional. If no value is
supplied with the D key letter, the default is used. If this
negotiation call facility is specified in the links definition, it
overrides the specification in this command.
Range:
Default: 75
F
Activates the Fast Select call facility. The PAD prompts the device
for Fast Select data, and up to 124 characters can be supplied to
accompany the call request packet (control sequences are treated as
single characters; leading spaces are deleted). Data exceeding 124
characters is truncated. If an incoming Fast Select call request is
received, the device is prompted for call user data, and up to 124
characters can be entered to accompany the call accept packet.
FR
Activates the Fast Select Restricted call facility. If no call user data
is supplied with the Call command, the PAD prompts the device
for it, and the device can supply up to 124 characters to
accompany the call request. The remote device responds with a
clear request; any accompanying clear user data is written to the
device prior to the clear service signal. If an incoming Fast Select
Restricted call request is received, the PAD prompts the device for
clear user data, and the device can supply up to 124 characters to
accompany the clear packet. The call is then immediately cleared.
G[(]<CUG_number>[)]
Activates the Closed User Group call facility, and provides the
CUG number for the call. The calling NUA of the local device and
the called NUA of the remote destination must both belong to the
specified CUG.
Range:
099
N[<network_user_id>]
Activates the Network User ID (NUI) call facility, and optionally
provides the NUI string. The NUI can be used for call validation
by the PAD. For security, you may not want to include the NUI in
the Call command where it is visible. There are two ways to avoid
this: disable PAD echoing by setting P2=0, or omit the string from
the Call command. In the latter case (if the N facility code supplied
but the NUI is omitted), the PAD prompts for the NUI before
initiating the call, and reads the string without echoing the input. In
either case, the string is assigned to the symbol NUI, which can be
used in subsequent include files for validation.
Range:
58
ASYNCXS
C320001300D0
X.28 COMMANDS
099
P[[(]<pkt_size>[)]]
P[(<rcv_pkt>,<trn_pkt>)]
Activates the Packet Size Negotiation call facility, and requests a
receive and/or transmit packet size. If both receive and transmit
packet sizes (<rcv_pkt> and <trn_pkt>) are supplied, they can have
different values; if only one value (<pkt_size>) is supplied, it
applies to both receive and transmit packet sizes, and the
parentheses are optional. If no value is supplied with the P key
letter, the default is used. If this negotiation call facility is specified
in the links definition, it overrides the specification in this
command.
Range:
Default: 16
R
Activates the Reverse Charging call facility. The Local Charge
Prevention call facility option must not be subscribed for the NUA
associated with the device accepting the charges.
W[(<rcv_wnd>,<trn_wnd>)]
W[[(]<wnd_size>[)]]
Activates the Window Size Negotiation call facility, and requests a
receive and/or transmit window size. If both the receive and
transmit window sizes (<rcv_wnd> and <trn_wnd>) are supplied,
they can have different values. If only one value (<wnd_size>) is
supplied, it applies to both receive and transmit window sizes, and
the parentheses are optional. If no value is supplied with the W key
letter, the default is used. If this negotiation call facility is specified
in the links definition, it overrides the specification in this
command.
Range:
1127
Default: 1
<NUA>
Network User Address of the destination device. For international
calls, the Data Network Identification Code (DNIC) must be included
in the destination address.
Range: 115 digits
Default: Configured called NUA
ASYNCXS
C320001300D0
59
X.28 COMMANDS
*<call_user_data>
Information field, preceded by an asterisk. Call user data can include
any character except an X.28 command terminator (<CR> or +).
Control characters can be sent in the call user data field with the
following limitations:
Control characters must be encoded; they cannot be entered
directly (e.g., ABC<C is ABC controlC, XYZ<D<C is XYZ
controlD controlC, ABC<< is ABC<).
If a control character is assigned a function (e.g., editing), the
function is performed. Normal control characters are discarded.
Input is not terminated if the call user data exceeds the maximum
allowable length (12 for normal calls; 124 for fast select calls).
Call user data in excess of the maximum is discarded; only the
valid portion is used to make a call.
Range: 012 characters; leading spaces are deleted
Default: Null
Response
Connected PAD service signal The call was established successfully.
The terminal is placed in data transfer mode.
Clear PAD service signal The call was not established or the terminal is
not configured to permit outgoing calls. The Clear signal includes an
error code indicating the reason for the failure.
ENGAGED A call is already active on this terminal.
Invalid facility request One of the call facilities parameters is not a legal
value. Reenter the entire command with the correct parameter.
Invalid call user data The call user data field is larger than 12 characters
and neither the Fast Select (F) nor the Fast Select Restricted (FR) call
facility was specified.
Invalid parameter The command parameters are not specified in the
correct order or one of the parameters is not a legal value. Reenter the
entire command with correct parameters.
510
ASYNCXS
C320001300D0
X.28 COMMANDS
Examples
Under different conditions the command name, optional call facilities,
NUA, and call user data can be omitted from the Call command. However,
at least one of these fields must be supplied, as shown in the following
examples:
Command
Description
ASYNCXS
C320001300D0
511
X.28 COMMANDS
512
ASYNCXS
C320001300D0
X.28 COMMANDS
Clr (Clear)
The Clr (Clear) command terminates an active call. Data en route to the
PAD from the remote device can be lost when using this command. An
orderly disconnection from the remote device should be followed (e.g.,
logging off a remote host application before clearing the call).
If the PAD detects an error, it sends a Clear message with an appropriate
error code; it does not change the mode of the terminal.
Syntax
CLR
CLear
Response
Clear PAD service signal The call was cleared. If an error occurred
while the clear was in progress, the signal includes details of the error. The
terminal is returned to command mode.
No active call This command can be executed only when a call is active.
ASYNCXS
C320001300D0
513
X.28 COMMANDS
Connect
The Connect command establishes a virtual connection from the local
device through the PAD to the packet switching network with a permanent
virtual circuit (PVC). You must supply a link name and logical channel
number to uniquely identify the PVC.
This command is analogous to a Call command, in that it sets up remote
communication; however, the Call command specifies a destination device
address and allows the network to determine the physical path through
which the call is connected. The Connect command specifies the address
of a network link to which the device is to be connected, a link for which
the physical path (PVC) is predefined when the network is configured.
The Connect command completes execution when the local device is
linked to the PVC. However, there may or may not be a device connected
to the remote end of the link; data exchanges can only proceed when a
remote device connects. Until this occurs, the network buffers any data
entered by the local device, up to the transmit window capacity.
A previous Connect command can be retried using a Call Retry command.
The link can be broken with a Clear command.
Syntax
CONNect <link_name><channel_number>
Parameters
<link_name>
Name of physical X.25 link to which the connection is requested,
followed by a hyphen.
Range:
116 characters
<channel_number>
Logical channel number specifying the PVC on the link.
Range:
14096
Response
Connected PAD service signal The PVC connection was established
successfully, and the terminal is placed in data transfer mode.
Clear PAD service signal The PVC connection was not established. The
signal includes an error code indicating the reason for the failure.
ENGAGED The terminal has already established a PVC connection or a
call is already active for this terminal.
Invalid parameter The command parameters are not specified in the
correct order, or one of the parameters is not a legal value. Reenter
the entire command with correct parameters.
514
ASYNCXS
C320001300D0
X.28 COMMANDS
Continue
The Continue command switches the terminal from command mode to
data transfer mode. This command is only valid when a call is active, and
cannot be issued from an include file.
Syntax
COntinue
Response
Acknowledge PAD service signal The terminal has been switched to data
transfer mode and is ready to accept input data.
No active call This command can be executed only when a call is active.
The terminal cannot be set to data transfer mode.
Continue not valid from signon include file The Continue command can
only be entered directly from the device, not from an include file.
ASYNCXS
C320001300D0
515
X.28 COMMANDS
Copy
The Copy command initiates a second call associated with a local device
to a copy device. When the command has been entered, data received
from the network and written to the local device is also written, through
the network, to the copy device. Data received from the copy device is
ignored. The copy and local devices must be associated with different
PADs. This command is valid only when a call is active. The M, RPOA,
S, T, and U facilities are not supported.
The copy operation continues until one of the following conditions occurs:
099
D[(<rcv_cls>,<tm_cls>)]
D[[(]<thru_class>[)]]
Activates the Throughput Class negotiation call facility, and
requests a specific receive and/or transmit throughput class. If both
the receive and transmit throughput classes (<rcv_cls> and
<trn_cls>) are supplied, they can have different values. If only one
value (<thru_cls>) is supplied, it applies to both receive and
transmit throughput classes, and the parentheses are optional. If no
value is supplied with the D key letter, the default is used. If this
negotiation call facility is specified in the links definition, it
overrides the specification in this command.
Range:
Default: 75
516
ASYNCXS
C320001300D0
X.28 COMMANDS
F
Activates the Fast Select call facility. The PAD prompts the device
for Fast Select data, and up to 124 characters can be supplied to
accompany the call request packet (control sequences are treated as
single characters; leading spaces are deleted). Data exceeding the
124 character limit is truncated. If an incoming Fast Select call
request is received, the device is prompted for call user data, and
up to 124 characters can be entered to accompany the call accept
packet.
FR
Activates the Fast Select Restricted call facility. If no call user data
is supplied with the Call command, the PAD prompts the device
for call user data, and the device can supply up to 124 characters to
accompany the call request. The remote device responds with a
clear request; any accompanying clear user data is written to the
device prior to the clear service signal. If an incoming Fast Select
Restricted call request is received, the PAD prompts the device for
clear user data, and the device can supply up to 124 characters to
accompany the clear packet. The call is then immediately cleared.
G[([<CUG_number>])]
Activates the Closed User Group call facility, and provides the
CUG number for the call. The calling NUA of the local device and
the called NUA of the remote destination must both belong to the
specified CUG.
Range:
099
N[<network_user_id>]
Activates the Network User ID (NUI) call facility, and optionally
provides the NUI string. The NUI can be used for call validation
by the PAD. For security, you may not want to include the network
ID string in the Call command where it is visible. There are two
ways to avoid this: disable PAD echoing by setting P2=0, or omit
the string from the Call command. In the latter case (if the N
facility code supplied but the NUI is omitted), the PAD prompts
for the NUI before initiating the call, and reads the string without
echoing the input. In either case, the string is assigned to the
symbol NUI, which can be used in subsequent include files for
validation.
Range:
ASYNCXS
C320001300D0
099
517
X.28 COMMANDS
P[(<rcv_pkt>,<trn_pkt>)]
P[[(]<pkt_size>[)]]
Activates the Packet Size Negotiation call facility, and requests a
specific receive and/or transmit packet size. If both the receive and
transmit packet sizes (<rcv_pkt> and <trn_pkt>) are supplied, they
can have different values; if only one value (<pkt_size>) is
supplied, it applies to both receive and transmit packet sizes, and
the parentheses are optional. If no value is supplied with the P key
letter, the default is used. If this negotiation call facility is specified
in the links definition, it overrides the specification in this
command.
Range:
Default: 16
R
Activates the Reverse Charging call facility. The Local Charge
Prevention call facility option must not be subscribed for the NUA
associated with the device accepting the charges.
W[(<rcv_wnd>,<trn_wnd>)]
W[[(]<wnd_size>[)]]
Activates the Window Size Negotiation call facility, and requests a
specific receive and/or transmit window size. If both the receive
and transmit window sizes (<rcv_wnd> and <trn_wnd>) are
supplied, they can have different values. If only one value
(<wnd_size>) is supplied, it applies to both receive and transmit
window sizes, and the parentheses are optional. If no value is
supplied with the W key letter, the default is used. If this
negotiation call facility is specified in the links definition, it
overrides the specification in this command.
Range:
1127
Default: 1
<NUA>
Network user address of the copy device. If a previous Copy command
was entered, this field can be omitted and the PAD assumes the
<NUA> of the previous Copy command.
Range: 115 characters
Default: Previous Copy command or indeterminate
*<call_user_data>
Information field, preceded by an asterisk. Call user data can include
any character except an X.28 command terminator (<CR> or +).
Control characters can be sent in the call user data field with the
following limitations:
Control characters must be encoded; they cannot be entered
directly (e.g., ABC<C is ABC controlC, XYZ<D<C is XYZ
controlD controlC, ABC<< is ABC<).
518
ASYNCXS
C320001300D0
X.28 COMMANDS
ASYNCXS
C320001300D0
519
X.28 COMMANDS
520
ASYNCXS
C320001300D0
X.28 COMMANDS
Help
The Help command displays information about the PADs facilities: X.3
and X.28 types, X.28 commands, X.3 parameters, defined symbols, or
available profiles. If no keyword is specified, the command displays a list
of keyword choices.
Syntax
Help [XTypes | X28cmds | X3parms | Mnemonics | Profiles | Help]
Parameters
XTypes
Available X28types and X3Types.
X28cmds
Available X.28 commands. Different displays are written depending
upon the devices X28type.
X3parms
Available X.3 parameters and their meanings. Different displays are
written depending upon the devices X3Type.
Mnemonics
Symbols defined for this device. The predefined symbols SWREV and
NUI are not displayed.
Profiles
X.3 profiles available to this device. For information about a specific
profile, enter: h profile<profile_name>. This display is the same as the
Profile Display command.
Help
Explains how to use help information.
ASYNCXS
C320001300D0
521
X.28 COMMANDS
Include
The Include command instructs the PAD to begin accepting X.28
commands from a named file rather than directly from the device. The file
can contain any X.28 command except Continue.
Include files can be nested up to four levels. If an include file contains
nested Include commands, the PAD accepts X.28 commands from the new
file as indicated. When it reaches the end of an include file, it resumes
accepting commands from the file at the previous level, starting with the
command following the nested Include command. When the PAD reaches
the end of the include file at the top level, it resumes accepting commands
from the terminal.
If an Include command fails from within an autosignon include file, the
call is cleared. If an Include command fails from within a signon include
file, the terminal is disabled.
Syntax
INClude <file_name>
@<file_name>
(if X28Type=TELEmatics)
(if X28Type=C84 | TELEmatics)
Parameter
<file_name>
Name of include file to be read. Must conform to Telematics file
specifier rules. Do not precede the file name with the tm: modifier; it
is automatically supplied.
Range:
187 characters
Response
The first X.28 command in the Include file determines the PADs normal
response. Possible error signals are:
Attempt to nest too many include files A maximum of four levels of
include files are permitted.
Error opening include file, may not exist: <status> The PAD
couldnt open the named file. Status is the numeric return value from
the Telematics system indicating the reason for the failure, and is
usually:
5
Include file not found The PAD couldnt locate the named file. Ensure
that the file name is specified correctly.
Unexpected end of line There were additional characters on the
command line after the <file_name> parameter.
522
ASYNCXS
C320001300D0
X.28 COMMANDS
Interrupt
The Interrupt command sends an X.25 interrupt packet, optionally
including user data, to a remote device. This command is valid only when
a call is active.
Default interrupt data can be predefined with the INTdata device
parameter. If INTdata is defined, it is sent when the <data> parameter is
omitted from the Interrupt command. If the <data> parameter is included
in the Interrupt command, it supersedes any default data. If no default data
is defined and the <data> parameter is omitted in this command, a value
of zero is sent in the interrupt data field.
Syntax
INTerrupt [<data>]
Parameter
<data>
Number sent as part of the packet.
Range: 0255
Default: Configured interrupt data
Response
Acknowledge signal This is the PADs normal response when the
interrupt packet has been sent.
A number in the range 0 to 255 was expected The value specified as
interrupt data is not within the legal range. Reenter the command
with a correct value.
No active call This command can be executed only when a call is active.
ASYNCXS
C320001300D0
523
X.28 COMMANDS
An X.25 interrupt packet is sent to the remote device with all bits of
the interrupt user data field set to 0.
The remote PAD notifies its associated device that it has received an
indication of break PAD message, and responds with PAD a message
that resets P8 for the local device. When P8 is reset to zero, normal
data transmission resumes.
Syntax
INTD
Response
Acknowledge signal This is the PADs normal response when the
interrupt packet has been sent.
No active call This command can be executed only when a call is active.
524
ASYNCXS
C320001300D0
X.28 COMMANDS
ASYNCXS
C320001300D0
525
X.28 COMMANDS
Language
The Language command sets X.3 parameter P6s value to indicate the
PAD service signal format or language.
Syntax
LANGuage ENGLISH | SPANISH | FRENCH | DEPENDENT |
DEFAULT
Parameter
ENGLISH
Sets extended dialogue mode handling and English language PAD
service signals (P6:21).
SPANISH
Sets extended dialogue mode handling and Spanish language PAD
service signals (P6:53).
FRENCH
Sets extended dialogue mode handling and French language PAD
service signals (P6:37).
DEPENDENT
Sets the extended network dependent format for PAD service signals
(P6:13).
DEFAULT
Sets the standard format (nonextended) for PAD service signals (P6:5).
Example
The following command sets X.3 P6 to English extended mode (i.e.,
P6:29).
lang english
526
ASYNCXS
C320001300D0
X.28 COMMANDS
Message
The Message command creates a PAD service signal and sends the text
string to the device. This command is normally issued from an include file
to inform the user of the command processing state. The service signal
display from the Message command depends on the P6 setting.
Syntax
MESsage <message>
Parameter
<message>
Character string. See page 52 for string format conventions.
Range:
ASYNCXS
C320001300D0
527
X.28 COMMANDS
528
ASYNCXS
C320001300D0
X.28 COMMANDS
Parameter?
The Parameter? command displays the values of some or all the X.3
parameters in the devices current profile. Parameter numbers can be
specified in any order and are displayed in the order specified. If no
parameter number is specified, the PAD displays all parameter values in
ascending order.
Syntax
PAR?
PARameter? [<number>,...]
(if X28Type=C84)
(if X28Type=TELEmatics)
Parameters
?
Required character, even when the command is abbreviated.
<number>
X.3 parameter number. Multiple numbers must be separated by
commas or spaces.
Range:
Response:
PAR 1:1, 2:1, 3:2, 4:0, 5:0, 6:5, 7:0, 8:0,9:0, 10:44,
11:14, 12:0, 13:0, 14:0, 15:1, 16:127, 17:16, 18:23,
19:2, 20:2, 21:16, 22:0, 23:0, 24:0, 25:0, 26:0, 27:5,
28:0, 29:0, 30:0, 31:0, 80:4, 81:18, 82:0, 83:127;
84:0,85:0,86:1
Response:
ASYNCXS
C320001300D0
529
X.28 COMMANDS
PAR 2:1
The following command displays the values of X.3 parameters 13, 6, 18,
and 1.
PAR? 13,6,18,1
Response:
PAR 13:0, 6:5, 18:23, 1:1
530
ASYNCXS
C320001300D0
X.28 COMMANDS
(if X28Type=C84)
(if X28Type=TELEmatics)
Parameter
<profile_name>
Name of existing profile. To invoke the profile associated with the
device when it was enabled, enter the word: initial.
Range:
116 characters
Response
Acknowledge signal This is the PADs normal response.
Profile name invalid or not defined A nonexistent profile was specified.
ASYNCXS
C320001300D0
531
X.28 COMMANDS
(if X28Type=C84)
(if X28Type=TELEmatics)
Parameters
?
Required character, even when the command is abbreviated.
<profile_name>
Name of existing X.3 profile. To display the profile assigned to the
device when it was enabled, enter the word initial.
Range: 016 characters
Default: Null (all available profile names)
Response
Profile name invalid or not defined A nonexistent profile was specified.
532
ASYNCXS
C320001300D0
X.28 COMMANDS
Read
The Read command reads a data string from a remote device, compares it
to a pattern string, and optionally assigns the input string to a symbol. If
the remote device does not send a string that matches the pattern within a
specified time interval, the PAD clears the call. An input string
corresponds to the contents of a single data packet received from the
remote device; therefore, pattern matching operations are subject to the
remote devices forwarding conditions.
The input string from the remote device is compared to the pattern string
specified with the Read command. If the input string does not match the
pattern string, the PAD discards the input string and reads the contents of
another packet from the network. If no user data is received from the
network within the time interval, the PAD clears the call. If no timer value
is specified, the PAD continues to read from the network until the pattern
string is matched. Only when the pattern is matched will another X.28
command be accepted.
The Read command is used primarily in a remote signon include file,
requiring the remote device user to enter a valid password before allowing
the call to continue. If the remote device does not enter a valid password
within the timeout period, the call is cleared. Once a correct password is
entered, the password can be assigned to a symbol. Subsequent commands
in the file can use the symbol to invoke subsidiary include files whose
names depend on the password.
If a break is entered by the device that initiated the Read command, the
command terminates.
Syntax
REAd[,TIMer=<timeout>][,PATtern=<pattern_string>] [<symbol>]
Parameters
<timeout>
Interval the Read command waits to receive the pattern matching
string.
Range: 0255 seconds
Default: 0 (no timeout)
<pattern_string>
Pattern string to be compared to the contents of a received packet. See
page 52 for information about using wildcard characters.
Range:
ASYNCXS
C320001300D0
533
X.28 COMMANDS
<symbol>
Name of symbol to which the matched string is assigned.
Range:
116 characters
Response
Acknowledge signal This is the PADs normal response.
Read request timeout No data was received from the network during the
specified time limit; the call is cleared.
Read/Send command is invalid when no call is active This command
can be executed only when a call is active.
534
ASYNCXS
C320001300D0
X.28 COMMANDS
ASYNCXS
C320001300D0
535
X.28 COMMANDS
116 characters
Response
No active call This command can be executed only when a call is active.
Remote X.29 request timeout The request was passed to the remote node
using an X.29 command, and no response was received. Possible
network problems exist.
536
ASYNCXS
C320001300D0
X.28 COMMANDS
ASYNCXS
C320001300D0
537
X.28 COMMANDS
(if X28Type=TELEmatics)
(if X28Type=C84)
Response
Acknowledge signal This is the PADs normal response.
No active call This command can be executed only when a call is active.
Send
The Send command allows a device to send data to a remote device
without switching from command mode to data transfer mode. This
command can be used in an include file, where the Continue command is
prohibited.
Syntax
SENd <string>
Parameter
<string>
String. See page 52 for string format conventions.
Range:
538
ASYNCXS
C320001300D0
X.28 COMMANDS
Set
The Set command changes the devices X.3 parameter values. If
parameters are duplicated, the last one is used. Parameters 8, 11, and 21
are readonly and cannot be set with this command.
Syntax
SET[?] <number>:<value>,...
Parameters
?
Instructs the PAD to confirm the new setting of each specified
parameter.
Default: PAD responds with an acknowledge signal
<number>
X.3 parameter number.
Range:
ASYNCXS
C320001300D0
539
X.28 COMMANDS
Stat (Status)
The Stat (Status) command instructs the PAD to display the current X.25
calls status.
If the Network User Address (NUA) was defined in X.25 with wildcard
characters, NUA information is not returned from the Status command.
Syntax
STAtus
STAT
(if X28Type=TELEmatics)
(if X28Type=C84)
Response
Status signal This is the PADs normal response.
0255
Response
No service signals are returned in response to a Port Test command.
Instead, the prompt Port Test: is displayed. The PAD echoes each
character entered from the terminal to the device.
540
ASYNCXS
C320001300D0
X.28 COMMANDS
0255
Response
No service signals are returned in response to a Terminal Test command.
Instead, the string Terminal Test: is displayed on the screen. The test data
described above is then written to the screen until the test completes.
ASYNCXS
C320001300D0
541
X.28 COMMANDS
Terminate
The Terminate command signs the device off from the PAD and disables
the channel to which the device is connected. Any active call must be
cleared before you issue this command. If P81=8, or any combination of
values including 8, the channel is automatically reenabled after being
disabled.
Syntax
TERMinate
Response
ENGAGED A call is active. The call is retained and the Terminate
command has no effect. Clear the call (Clear command) and then
reissue the Terminate command.
Type
The Type command sends a text string to the local device. This command
is usually issued from an include file to inform the user of the command
processing state.
Syntax
TYpe <string>
Parameter
<string>
String. See page 52 for string format conventions.
Range:
542
ASYNCXS
C320001300D0
X.28 COMMANDS
Wait
The Wait command instructs the PAD to wait a specified amount of time
before requesting the next command. This command is usually used in an
include file.
Syntax
WAIT [<seconds>]
Parameter
<seconds>
Interval for the PAD to wait.
Range: 190 seconds
Default: 1 second
Response
Acknowledge signal This is the PADs normal response.
A number in the range 1 to 90 was expected The time interval value is
not within the legal range. Reenter the command with a correct value.
X28Type
The X28Type command changes a devices X28type. This determines if
the device can access the full range of ASYNCXS X.28 commands or if
it is limited to the CCITT 1984 X.28 Recommendation commands.
Syntax
X28Type TELEmatics | C84
Parameters
TELEmatics
Indicates terminal can use full range of X.28 commands.
C84
Indicates device is restricted to the X.28 commands in the CCITT
1984 X.28 Recommendation (i.e., those commands not marked with
an asterisk in the Command Summary) plus the Telematics commands
COntinue, Help, X3Type, X28Type, and @.
Response
Acknowledge signal This is the PADs normal response.
Invalid X28 type The parameter specified as the X28 type is not a legal
value. Reenter the command with a correct value.
ASYNCXS
C320001300D0
543
X.28 COMMANDS
X3Type
The X3Type command changes the X3Type of a device. This determines
if the device can change or display the full set of ASYNCXS X.3
parameters or if it is limited to the CCITT 1984 X.3 Recommendation
parameters.
Syntax
X3Type TELEmatics | C84
Parameters
TELEmatics
Device can display and set all X.3 parameters.
C84
Device can display and set only X.3 parameters 122.
Response
Acknowledge signal This is the PADs normal response.
Invalid X3 type The parameter specified as the X3type is not a legal
value. Reenter the command with a correct value.
544
ASYNCXS
C320001300D0
<value>/<value>
<value>/<value>
<value>/<value>
<value>/<value>
<value>/<value>
<value>/<value>
<value>/<value>
ASYNCXS
C320001300D0
61
Network Dependent
CLR <cause> C:<ccode> D:<diagnostic> <message>
62
ASYNCXS
C320001300D0
Meaning
Originated from DTE
Number busy
Invalid facility request
Network congestion
Out of order
Access barred
Not obtainable
Remote procedure error
Local procedure error
RPOA out of order
Reverse charging acceptance
not subscribed
33 . . . . . $21 . . . . A1 . . . . . 161 . . . . Incompatible destination
41 * . . . . $29 . . . . A9 . . . . . 169 . . . . Fast select acceptance not
subscribed
49 . . . . . $39 . . . . B9 . . . . . 185 . . . . Ship absent
* Valid only if the corresponding call facilities are used
ASYNCXS
C320001300D0
Meaning
No additional information
Invalid Ps
Invalid Pr
Invalid packet type
Invalid packet type in r1
Invalid packet type in r2
Invalid packet type in r3
Invalid packet type in p1
Invalid packet type in p2
Invalid packet type in p3
Invalid packet type in p4
Invalid packet type in p5
Invalid packet type in p6
Invalid packet type in p7
Invalid packet type in d1
63
Dec.
28 . . . . . . . .
29 . . . . . . . .
32 . . . . . . . .
33 . . . . . . . .
34 . . . . . . . .
35 . . . . . . . .
36 . . . . . . . .
37 . . . . . . . .
38 . . . . . . . .
39 . . . . . . . .
40 . . . . . . . .
41 . . . . . . . .
42 . . . . . . . .
43 . . . . . . . .
44 . . . . . . . .
45 . . . . . . . .
48 . . . . . . . .
49 . . . . . . . .
50 . . . . . . . .
51 . . . . . . . .
52 . . . . . . . .
64 . . . . . . . .
65 . . . . . . . .
66 . . . . . . . .
67 . . . . . . . .
68 . . . . . . . .
69 . . . . . . . .
70 . . . . . . . .
71 . . . . . . . .
72 . . . . . . . .
73 . . . . . . . .
74 . . . . . . . .
75 . . . . . . . .
76 . . . . . . . .
77 . . . . . . . .
80 . . . . . . . .
81 . . . . . . . .
82 . . . . . . . .
83 . . . . . . . .
96 . . . . . . . .
97 . . . . . . . .
98 . . . . . . . .
64
Hex
$1C . . . . . . .
$1D . . . . . . .
$20 . . . . . . .
$21 . . . . . . .
$22 . . . . . . .
$23 . . . . . . .
$24 . . . . . . .
$25 . . . . . . .
$26 . . . . . . .
$27 . . . . . . .
$28 . . . . . . .
$29 . . . . . . .
$2A . . . . . . .
$2B . . . . . . .
$2C . . . . . . .
$2D . . . . . . .
$30 . . . . . . .
$31 . . . . . . .
$32 . . . . . . .
$33 . . . . . . .
$34 . . . . . . .
$40 . . . . . . .
$41 . . . . . . .
$42 . . . . . . .
$43 . . . . . . .
$44 . . . . . . .
$45 . . . . . . .
$46 . . . . . . .
$47 . . . . . . .
$48 . . . . . . .
$49 . . . . . . .
$4A . . . . . . .
$4B . . . . . . .
$4C . . . . . . .
$4D . . . . . . .
$50 . . . . . . .
$51 . . . . . . .
$52 . . . . . . .
$53 . . . . . . .
$60 . . . . . . .
$61 . . . . . . .
$62 . . . . . . .
Meaning
Invalid packet type in d2
Invalid packet type in d3
Packet not allowed
Unidentified packet
Call on one way LC
Invalid PVC packet
Reject on unassigned LC
Reject not subscribed to
Packet too short
Packet too long
Invalid GFI
Restart/registration packet has LC
Packet type not compatible with facility
Unauthorized interrupt confirmation
Unauthorized interrupt
Unauthorized reject
Timer expired
Incoming call timer expiration
Clear indication timer expiration
Reset indication timer expiration
Restart indication timer expiration
Call setup/clear/registration problem
Facility/registration not allowed
Expected facility not provided
Invalid called address
Invalid calling address
Invalid facility registration length
Incoming calls barred
No logical channels available
Call collision
Duplicate facility requested
Nonzero address length
Nonzero facility length
Expected facility not provided
Invalid CCITT specifies facility
Miscellaneous
Improper cause code from DTE
Nonaligned octet
Inconsistent Q bit setting
International setup/clearing problem
Unknown calling DNIC
TNIC mismatch
ASYNCXS
C320001300D0
Dec.
99 . . . . . . . .
100 . . . . . . .
101 . . . . . . .
102 . . . . . . .
103 . . . . . . .
112 . . . . . . .
113 . . . . . . .
114 . . . . . . .
115 . . . . . . .
116 . . . . . . .
117 . . . . . . .
118 . . . . . . .
119 . . . . . . .
120 . . . . . . .
121 . . . . . . .
122 . . . . . . .
128 . . . . . . .
218 . . . . . . .
219 . . . . . . .
Hex
$63 . . . . . . .
$64 . . . . . . .
$65 . . . . . . .
$66 . . . . . . .
$67 . . . . . . .
$70 . . . . . . .
$71 . . . . . . .
$72 . . . . . . .
$73 . . . . . . .
$74 . . . . . . .
$75 . . . . . . .
$76 . . . . . . .
$77 . . . . . . .
$78 . . . . . . .
$79 . . . . . . .
$7A . . . . . . .
$80 . . . . . . .
$DA . . . . . .
$DB . . . . . .
Meaning
Call identifier mismatch
Negotiation error in utility parameter value
Invalid utility length
Nonzero utility length
M bit violation
International problem
Remote network problem
International network problem
International link out of order
International link busy
Transit network facility problem
Remote network facility problem
International routing problem
Temporary routing problem
Unknown called DNIC
Maintenance action
Network specific diagnostic
TRAX trap error for user call
User task error
ASYNCXS
C320001300D0
65
Network Dependent
CLR CONF Call cleared, confirmed
66
ASYNCXS
C320001300D0
ASYNCXS
C320001300D0
67
Network Dependent
ERR Invalid X.28 command entered
Network Dependent
RESET <cause>
68
ASYNCXS
C320001300D0
<value>
<value>
(<value>/<value>)
(<value>/<value>)
(<value>/<value>)
(<value>/<value>)
(<value>/<value>)
(<value>/<value>)
ASYNCXS
C320001300D0
69
610
ASYNCXS
C320001300D0
7 Alarms
When INF receives notification of an event, a message is displayed on the
Telematics terminal. Telematics provides an include file containing the
default definitions of ASYNCXSspecific alarms. If you want to develop
your own alarm messages for ASYNCXS, see the INF Manual.
The format of an INF alarm is:
ALARM <number>:message
Severity
Informational Informational alarms require no action, and there should
be no adverse effect on ASYNCXS operation. Keep in mind that when
your resource is set to ASYNCXS, you can access all the INF
commands. If you create or type a symbol that matches the case
significance of an INF command, you will get an error message trying to
expand the symbol (which may not be the message you are expecting).
Check the syntax of the command.
Error Error alarms indicate soft or recoverable errors.
Warning Warning alarms indicate a temporary problem, and there should
be no adverse affect on ASYNCXS operation. No action is required;
however, repeated occurrences of these alarms may indicate a network or
configuration problem.
Fatal Fatal alarms rarely occur, but can affect system operation. Fatal
alarms indicate software, hardware, or configuration problems. Software
and configuration problems can occur in ASYNCXS, the network, or the
system.
ASYNCXS
C320001300D0
71
ALARMS
Alarm Messages
The following list describes alarms in ascending numerical order. All
alarms are category 18 (see the INF Manual for information about alarm
categories). In the alarm text (which is enclosed in quotation marks),
symbol S0 is the logical volume, symbol S1 is the device or profile name,
and error values indicated by N1 are defined in the level 2 include file
named l2asydef.in; see the logical read/write completion codes. The
alarms severity and explanation follow the text.
256 Device S0:S1 Async connected
Informational An asynchronous port has been logically connected to
ASYNCXS.
257 Device S0:S1 Async disconnected
Informational An asynchronous port has been logically disconnected
from ASYNCXS.
258 Device S0:S1 X.25 connected
Informational A call is complete and an X.25 logical channel has
been established.
259 Device S0:S1 X.25 disconnected
Informational An X.25 logical channel has been disconnected.
260 Reserved
261 Device S0:S1 X.29 command timer expired
Informational A timer starts when an X.29 command is issued that
requires a response. If the timer expires before a response is received,
the x29 timeout alarm is generated. Responses can be delayed for
several reasons: X.29 commands are queued in the network, one or
both PADs are in command mode, or there are normal data packets
ahead of the X.29 packets. In this case, nothing can happen until data
transfer mode is continued.
262 Device S0:S1 Command mode timer expired
Informational No activity has occurred in X.28 command mode, and
the timer has expired.
263 Device S0:S1 Data mode timer expired
Informational No activity has occurred in data transfer mode, and the
timer has expired.
264 Device S0:S1 Modem signal(s) lost
Error Modem signals were lost.
265 Device S0:S1 Memory (de)allocation error
Warning ASYNCXS requested memory from the operating system
and was denied. Memory use should be evaluated. Remedies include
increasing the amount of system memory, attaching fewer devices, or
allowing fewer concurrently executing tasks.
72
ASYNCXS
C320001300D0
ALARMS
ASYNCXS
C320001300D0
73
ALARMS
74
ASYNCXS
C320001300D0
ALARMS
ASYNCXS
C320001300D0
75
ALARMS
76
ASYNCXS
C320001300D0
ASYNCXS
C320001300D0
Hex.
00
01
02
03
04
05
06
07
08
09
0A
0B
0C
0D
0E
0F
10
11
12
13
14
15
16
17
18
19
1A
1B
1C
1D
1E
1F
20
Oct.
00
01
02
03
04
05
06
07
10
11
12
13
14
15
16
17
20
21
22
23
24
25
26
27
30
31
32
33
34
35
36
37
40
Binary
0000 0000
0000 0001
0000 0010
0000 0011
0000 0100
0000 0101
0000 0110
0000 0111
0000 1000
0000 1001
0000 1010
0000 1011
0000 1100
0000 1101
0000 1110
0000 1111
0001 0000
0001 0001
0001 0010
0001 0011
0001 0100
0001 0101
0001 0110
0001 0111
0001 1000
0001 1001
0001 1010
0001 1011
0001 1100
0001 1101
0001 1110
0001 1111
0010 0000
ASCII
NUL
SOH
STX
ETX
EOT
ENQ
ACK
BEL
BS
HT
LF
VT
FF
CR
SO
SI
DLE
DC1
DC2
DC3
DC4
NAK
SYN
ETB
CAN
EM
SUB
ESC
FS
GS
RS
US
SP
Key
CTRL@
CTRL/A
CTRL/B
CTRL/C
CTRL/D
CTRL/E
CTRL/F
CTRL/G
CTRL/H, BACKSPACE
CTRL/I, TAB
CTRL/J, LINE FEED
CTRL/K
CTRL/L
CTRL/M, RETURN
CTRL/N
CTRL/O
CTRL/P
CTRL/Q
CTRL/R
CTRL/S
CTRL/T
CTRL/U
CTRL/V
CTRL/W
CTRL/X
CTRL/Y
CTRL/Z
ESC, ESCAPE
CTRL/\
CTRL/]
CTRL/^
CTRL//
SPACEBAR
A1
Dec.
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
A2
Hex.
21
22
23
24
25
26
27
28
29
2A
2B
2C
2D
2E
2F
30
31
32
33
34
35
36
37
38
39
3A
3B
3C
3D
3E
3F
40
41
42
43
44
45
Oct.
41
42
43
44
45
46
47
50
51
52
53
54
55
56
57
60
61
62
63
64
65
66
67
70
71
72
73
74
75
76
77
100
101
102
103
104
105
Binary
0010 0001
0010 0010
0010 0011
0010 0100
0010 0101
0010 0110
0010 0111
0010 1000
0010 1001
0010 1010
0010 1011
0010 1100
0010 1101
0010 1110
0010 1111
0011 0000
0011 0001
0011 0010
0011 0011
0011 0100
0011 0101
0011 0110
0011 0111
0011 1000
0011 1001
0011 1010
0011 1011
0011 1100
0011 1101
0011 1110
0011 1111
0100 0000
0100 0001
0100 0010
0100 0011
0100 0100
0100 0101
ASCII
!
#
$
%
&
(
)
*
+
,
.
/
0
1
2
3
4
5
6
7
8
9
:
;
<
=
>
?
@
A
B
C
D
E
Key
!
#
$
%
&
(
)
*
+
,
.
/
0
1
2
3
4
5
6
7
8
9
:
;
<
=
>
?
@
A
B
C
D
E
ASYNCXS
C320001300D0
Dec.
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
ASYNCXS
C320001300D0
Hex.
46
47
48
49
4A
4B
4C
4D
4E
4F
50
51
52
53
54
55
56
57
58
59
5A
5B
5C
5D
5E
5F
60
61
62
63
64
65
66
67
68
69
6A
Oct.
106
107
110
111
112
113
114
115
116
117
120
121
122
123
124
125
126
127
130
131
132
133
134
135
136
137
140
141
142
143
144
145
146
147
150
151
152
Binary
0100 0110
0100 0111
0100 1000
0100 1001
0100 1010
0100 1011
0100 1100
0100 1101
0100 1110
0100 1111
0101 0000
0101 0001
0101 0010
0101 0011
0101 0100
0101 0101
0101 0110
0101 0111
0101 1000
0101 1001
0101 1010
0101 1011
0101 1100
0101 1101
0101 1110
0101 1111
0101 0000
0110 0001
0110 0010
0110 0011
0110 0100
0110 0101
0110 0110
0110 0111
0110 1000
0110 1001
0110 1010
ASCII
F
G
H
I
J
K
L
M
N
O
P
Q
R
S
T
U
V
W
X
Y
Z
[
\
]
^
a
b
c
d
e
f
g
h
i
j
Key
F
G
H
I
J
K
L
M
N
O
P
Q
R
S
T
U
V
W
X
Y
Z
[
\
]
^
a
b
c
d
e
f
g
h
i
j
A3
Dec.
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
A4
Hex.
6B
6C
6D
6E
6F
70
71
72
73
74
75
76
77
78
79
7A
7B
7C
7D
7E
7F
Oct.
153
154
155
156
157
160
161
162
163
164
165
166
167
170
171
172
173
174
175
176
177
Binary
0110 1011
0110 1100
0110 1101
0110 1110
0110 1111
0111 0000
0111 0001
0111 0010
0111 0011
0111 0100
0111 0101
0111 0110
0111 0111
0111 1000
0111 0101
0111 1010
0111 1011
0111 1100
0111 1101
0111 1110
0111 1111
ASCII
k
l
m
n
o
p
q
r
s
t
u
v
w
x
y
z
{
|
}
~
DEL
Key
k
l
m
n
o
p
q
r
s
t
u
v
w
x
y
z
{
|
}
~
DEL, RUBOUT
ASYNCXS
C320001300D0
IO Interface
This appendix describes the ASYNCXS PAD IO interface, which allows
a user application task to communicate directly with the PAD entity (e.g.,
transmit and receive data).
To use this appendix effectively, you must be familiar with programming
handlers and applications in the Telematics TRAX operating system
environment. This includes experience in building and submitting IO
subservice request packets, which is described in the Telematics
Programmers Guide (C310000100) and the TRAX Programmers
Manual (C315000100).
Introduction
This section lists documentation conventions and product features.
Conventions
Field length specifications
B indicates a byte, W indicates a word, and L indicates a longword. If
no decimal precedes the letter, a single byte, word, or longword is
expected. A decimal preceding the letter indicates the number of bytes,
words, or longwords.
A hyphen () indicates the mnemonic in the Field column does not
represent a field offset. Such mnemonics represent the length of a
request packet or parameter buffer, and may be used when reserving
and initializing memory for them.
A V indicates the start of a variable length field. When a buffer has a
variable length field, the maximum buffer size includes the base, plus
the maximum variable length, plus 2.
The delta graphic indicates the device parameter can be modified
while the device is online.
*
A single asterisk indicates the preceding mnemonic is defined in the
asyxsuser.in include file (see next section, Include Files).
**
A double asterisk indicates the preceding mnemonic is defined in the
padiodefs.in include file (see next section, Include Files).
use and set
The word use preceding a mnemonic in the Contents column indicates
a MOVE instruction to copy a value into a field. The word set
indicates a BSET instruction to set the bit identified by the mnemonic
in that field.
ASYNCXS
C320001300D0
B1
IO INTERFACE
Return values and error mnemonics are described at the end of the
appendix.
Include Files
The ASYNCXS PAD IO interface references three include files:
userdef.in, asyxsuser.in, and padiodefs.in.
The userdef.in include file defines the TRAX standard mnemonics and
macros.
The padiodefs.in include file defines the mnemonics that are standard
to the Telematics IO interface for PADs.
By default, most mnemonics referenced in this appendix reside in the
userdef.in include file. Mnemonics from the asyxsuser.in include file are
noted with a single asterisk (*). Mnemonics from the padiodefs.in include
file are noted with a double asterisk (**).
For high level language compatibility, the following values can be used
for CTTYPE:
Assembler values:
typ$unkn_ or typ_unkn_ . . . . . . . . . . . . . .
typ$prof_ or typ_prof_ . . . . . . . . . . . . . . . .
typ$term_ or typ_term_ . . . . . . . . . . . . . . .
typ$dir_ or typ_dir_ . . . . . . . . . . . . . . . . . .
typ$vol_ or typ_vol_ . . . . . . . . . . . . . . . . .
typ$ddir_ or typ_ddir_ . . . . . . . . . . . . . . . .
Unknown
X.3 Profile
Terminal access
Directory
Volume
Device directory (return
info only)
typ$pdir_ or typ_pdir_ . . . . . . . . . . . . . . . . Profile directory (return
info only)
typ$portsw_ or typ_portsw_ . . . . . . . . . . . Port switch bit for
create/destroy
C values:
TYP$UNKN_ or TYP_UNKN_ . . . . . . . .
TYP$PROF_ or TYP_PROF_ . . . . . . . . . .
TYP$TERM_ or TYP_TERM_ . . . . . . . . .
TYP$DIR_ or TYP_DIR_ . . . . . . . . . . . . .
TYP$VOL_ or TYP_VOL_ . . . . . . . . . . . .
TYP$DDIR_ or TYP_DDIR_ . . . . . . . . . .
Unknown
X.3 Profile
Terminal access
Directory
Volume
Device directory (return
info only)
TYP$PDIR_ or TYP_PDIR . . . . . . . . . . . . Profile directory (return
info only)
TYP$PORTSW_ or TYP_PORTSW_ . . . . Port switch bit for
create/destroy
B2
ASYNCXS
C320001300D0
IO INTERFACE
Pascal values:
typ$unkn_ or typ_unkn_ . . . . . . . . . . . . . .
typ$prof_ or typ_prof_ . . . . . . . . . . . . . . . .
typ$term_ or typ_term_ . . . . . . . . . . . . . . .
typ$dir_ or typ_dir_ . . . . . . . . . . . . . . . . . .
typ$vol_ or typ_vol_ . . . . . . . . . . . . . . . . .
typ$ddir_ or typ_ddir_ . . . . . . . . . . . . . . . .
Unknown
X.3 Profile
Terminal access
Directory
Volume
Device directory (return
info only)
typ$pdir_ or typ_pdir_ . . . . . . . . . . . . . . . . Profile directory (return
info only)
typ$portsw_ or typ_portsw_ . . . . . . . . . . . Port switch bit for
create/destroy
Modes
Each created device can be placed in one of two operating modes: PAD or
handler.
When the device is in PAD mode (the default), the PADs functionality
remains the same; any IO/READs and IO/WRITEs issued to the device
will be returned in error. The device will be in either X.28 command
mode, or in data transfer mode (see Chapter 2).
When a device is placed in handler mode, any device write or read in
progress is terminated, and if a call is active, reads and writes to X.25 are
suspended. The only valid activity with the device is through the TRAX
IO services. IO/READs and IO/WRITEs are allowed.
To change from one mode to the other, issue the appropriate
IO/EXCHANGE subservice: Pass Control to PAD Mode or Pass Control
to Handler Mode. Note that the application task must have previously
completed an IO/OPEN to the device.
Additionally, when the device is in PAD mode, it is placed in handler
mode:
When the hot key is entered. The hot key is specified with the
IO/EXCHANGE Pass Control to PAD Mode subservice, and allows a
user to quickly access the application when the PAD is in PAD mode.
When the hot key is entered, the PAD is placed into handler mode and
the application receives an event notification (if it is registered for
event notification).
ASYNCXS
C320001300D0
B3
IO INTERFACE
Event Notification
An application task can register and deregister for event notification using
IO/EXCHANGE subservices. A task can also register for event
notification in the IO/OPEN service. Events comprise device related
occurrences that may require action. When a defined event happens, and
the application is registered for event notification, the task is notified with
an IO/MODE that an event occurred, in the format shown below. Note that
ASYNCXS events are distinct from alarms used by INF.
Returned Event Format
Length
Field
evntrev **
evntfunct **
evntprod **
evntnumber **
evntrvalu **
evntboottime **
evntyear **
evntmonth **
evntday **
evnthour **
evntminutes **
evntseconds **
evntmilisec **
evnthotkey **
evntport **
evntps1 **
evntps2 **
evntsize **
W
W
W
W
L
L
W
B
B
B
B
B
W
W
W
W
W
*
Contents
Event revision
Event function
Product number
Event number (see list below)
Return value
Milliseconds since boot
Year
Month
Day
Hour
Minutes
Seconds
Milliseconds
Index of hot key that caused exception
Port number
Product specific field
Product specific field
Size of buffer
** Defined in padiodefs.in
B4
No.
0
1
2
Text Description
X.25 connected The X.25 call is up and active,
and the device is in PAD mode
X.25 disconnected The call has been
disconnected, and the device is in handler mode
X.25 incoming call The user task can obtain a
copy of the call parameter block, and then must
either accept or reject the call
ASYNCXS
C320001300D0
IO INTERFACE
evntx25o_
**
evntentc_ **
evntentonl_
**
evntentd_
**
evntentoff_
**
evnthotkey_
**
evntx25t_ **
evntx28t_ **
10
evntctlc_ **
11
evntctly_ **
12
ASYNCXS
C320001300D0
B5
IO INTERFACE
IO Service Summary
This section provides a summary of the ASYNCXS IO service requests,
plus recommendations about the proper sequence in which services should
be requested.
The ASYNCXS IO interface supports the following IO services:
IO/CREATE
Creates a full duplex channel as an IO entity and assigns it to an IO
entity name.
Creates a set of X.3 parameters that can be associated with a
device
IO/DESTROY
Destroys the definition of a channel as an IO entity
Destroys a directory
Destroys a profile
IO/EXCHANGE
Defines, modifies, or obtains initial parameters
Registers or deregisters for event notification
Passes control to PAD or handler mode
Requests an X.25 connection or accepts an incoming call
Requests an X.25 disconnection or rejects an incoming call
Requests incoming call parameters
Modifies a devices configuration parameters while the device is
online
B6
ASYNCXS
C320001300D0
IO INTERFACE
IO/INFO
Retrieves entity names or detailed properties
Retrieves a devices status
Retrieves a devices or profiles configuration information
Retrieves PADmap information
Retrieves async IO configuration information
IO/MODE
Enables, disables, or modifies a device
Resets a devices statistics
Adds or deletes a PADmap entry, or deletes the entire PADmap
table
Enables or disables task exception processing
Modifies async IO configuration information
ASYNCXS
C320001300D0
B7
IO INTERFACE
IO/CLOSE
The IO/CLOSE service releases logical file access to an IO entity. When
this request completes, exception registrations, modem state change
notification registrations, and all queued and inprogress IO/READ and
IO/WRITE requests are terminated.
The PAD requires no handler specific options for this service.
Packet
Field
pktname
B8
Length
8B
Contents
Logical access name (left justified, space
filled)
ASYNCXS
C320001300D0
IO INTERFACE
IO/CRDIR
The IO/CRDIR service creates a directory for a device or an X.3 profile.
IO/CRDIR Create Device Directory
This subservice creates a directory for devices.
Packet
Field
pktimopt
pkthsopt
pktfname
pktfnsiz
Length
B
W
L
W
Contents
Class selection index; use ioicnam.
Handler specific option; use typ$term_ *
Address of entity name string
Length of entity name
* Defined in asyxsuser.in
Length
B
W
L
W
Contents
Class selection index; use ioicnam.
Handler specific option; use typ$prof_ *
Address of profile directory name
Byte length of profile directory name
* Defined in asyxsuser.in
ASYNCXS
C320001300D0
B9
IO INTERFACE
IO/CREATE
The IO/CREATE service creates a device or X.3 profile definition.
IO/CREATE Device
This subservice identifies a channel as an IO entity and assigns it an IO
entity name. The calling task must provide a channel number
corresponding to a duplex channel in the range 0512, and an IO entity
name for the channel.
In response to this request, the PAD claims the specified full duplex
channel pair and defines the channels using the values specified in the
device configuration buffer. This is the same buffer that is used when
calling IO/MODE to set parameters.
Packet
Field
pkthsopt
pktfname
pktfnsiz
pktparam
pktpbsiz
Length
W
L
W
L
W
Contents
Handler specific option; use typ$term_ *
Address of entity name buffer
Length of entity name
Address of device configuration buffer
Byte length of device configuration buffer; use
cmsize *
B10
Length
cmverlet *
cmvernum *
B
B
cmt1val *
Contents
Current product revision letter; use verlet *
Current product version number (e.g., for the
H.x release, the version number is 8); use
vernum *
Y Delay after which the PAD automatically
places an X.25 call (if autocall is enabled) once
the device is created. To enable autocall, P81
must equal 2 or a sum including 2, and the
device must have a valid called address.
Range: 0500 seconds
ASYNCXS
C320001300D0
IO INTERFACE
cmretim *
cmretmx *
cmcdsz *
cmcd *
B
16B
cmx25sz *
cmx25vo *
9B
cmcgsz *
cmcg *
B
16B
cmrevc *
cmcudsz *
cmcud *
W
128B
cmintd *
cmport *
cmpadc *
ASYNCXS
C320001300D0
B11
IO INTERFACE
B12
cmmodem *
cmbrkmk *
cmbrkln *
cmbrksr *
W
90B
cmbrkti *
cmstopbit *
cmdtrc *
cmbufsz *
cmelem *
cmblkfl *
cmfbtim *
B
B
L
ASYNCXS
C320001300D0
IO INTERFACE
cmx3typ *
cmx28ty *
cmiact *
cmcallm *
cmsymax *
cmt2val *
ASYNCXS
C320001300D0
B13
IO INTERFACE
B14
cmt3val *
cmpbsz *
cmprmpt *
W
16B
cmtypah *
cmfclev *
cmpnmsz *
cmpname *
16B
cmprosz *
cmpronm *
16B
cmsnmsz *
cmsname *
W
87B
cmabsz *
cmasign *
87B
cmoffcl *
cmoffcm *
87B
ASYNCXS
C320001300D0
IO INTERFACE
W
W
cmx3p02 *
cmx3p03 *
cmx3p04 *
W
W
cmx3p05 *
cmx3p06 *
cmx3p07 *
cmx3p08 *
W
W
cmx3p09 *
cmx3p10 *
cmx3p11 *
cmx3p12 *
W
W
W
cmx3p13 *
cmx3p14 *
W
W
cmx3p15 *
cmx3p16 *
cmx3p17 *
W
W
cmx3p18 *
cmx3p19 *
cmx3p20 *
W
W
cmx3p21 *
cmx3p22 *
cmx3p23 #1
*
cmx3p24 #2
*
cmx3p25 *
cmx3p26 *
W
W
W
W
W
cmx3p27 *
cmx3p28 *
cmx3p29 *
W
W
cmx3p30 *
cmx3p31 *
cmx3p80 *
W
W
ASYNCXS
C320001300D0
B15
IO INTERFACE
cmx3p81 *
cmx3p82 *
cmx3p83 *
cmx3p84 *
W
W
cmx3p85 *
cmx3p86 *
cmbilling *
W
34B
cmcurbill *
cmaccnsz *
34B
W
cmaccn *
20B
cmcaccnsz *
cmcaccn *
cmacct *
W
20B
W
cmserv *
cmchg *
cmnui *
The following fields that begin with the characters cmx3c are returned
from an IO/INFO request to obtain device configuration information; they
are not valid for device configuration or modification. For complete
descriptions of X.3 parameter values, see Chapter 3.
B16
cmx3c00 *
cmx3c01 *
cmx3c02 *
cmx3c03 *
B
B
B
B
cmx3c04 *
cmx3c05 *
B
B
cmx3c06 *
cmx3c07 *
ASYNCXS
C320001300D0
IO INTERFACE
cmx3c08 *
cmx3c09 *
cmx3c10 *
cmx3c11 *
cmx3c12 *
B
B
cmx3c13 *
cmx3c14 *
cmx3c15 *
cmx3c16 *
B
B
cmx3c17 *
cmx3c18 *
B
B
cmx3c19 *
cmx3c20 *
cmx3c21 *
B
B
cmx3c22 *
cmx3c23 *
B
B
cmx3c24 *
cmx3c25 *
cmx3c26 *
cmx3c27 *
cmx3c28 *
cmx3c29 *
cmx3c30 *
ASYNCXS
C320001300D0
B17
IO INTERFACE
cmx3c31 *
cmx3c80 *
cmx3c81 *
B
B
cmx3c82 *
cmx3c83 *
cmx3c84 *
cmx3c85 *
cmx3c86 *
cmopm *
cmx25iow *
cmx25ior *
cmsize *
L
L
* Defined in asyxsuser.in
B18
ASYNCXS
C320001300D0
IO INTERFACE
IO/CREATE Profile
This subservice defines a set of X.3 parameter values that can be
associated with a device.
Packet
Field
pkthsopt
pktfname
pktfnsiz
pktparam
pktpbsiz
Length
W
L
W
L
W
Contents
Handler specific option; use typ$prof_ *
Address of profile name buffer
Length of profile name
Address of profile buffer
Byte length of profile buffer; use cpsize. *
* Defined in asyxsuser.in
Profile Buffer
See Chapter 3 for complete X.3 parameter descriptions and values.
Field
cpx3p00 *
cpx3p01 *
cpx3p02 *
cpx3p03 *
cpx3p04 *
cpx3p05 *
cpx3p06 *
cpx3p07 *
cpx3p08 *
cpx3p09 *
cpx3p10 *
cpx3p11 *
cpx3p12 *
cpx3p13 *
cpx3p14 *
cpx3p15 *
cpx3p16 *
cpx3p17 *
cpx3p18 *
cpx3p19 *
cpx3p20 *
cpx3p21 *
cpx3p22 *
ASYNCXS
C320001300D0
Length
W
W
W
W
W
W
W
W
W
W
W
W
W
W
W
W
W
W
W
W
W
W
W
Contents
X.3 P0, not defined
X.3 P1, PAD escape
X.3 P2, echo
X.3 P3, data forwarding
X.3 P4, idle timer
X.3 P5, ancillary device control
X.3 P6, PAD service signals
X.3 P7, break action
X.3 P8, discard output
X.3 P9, padding after <CR>
X.3 P10, line folding
X.3 P11, speed
X.3 P12, PAD flow control
X.3 P13, linefeed after <CR>
X.3 P14, linefeed padding
X.3 P15, editing
X.3 P16, character delete
X.3 P17, line delete
X.3 P18, line display
X.3 P19, editing service signals
X.3 P20, echo mask
X.3 P21, parity treatment
X.3 P22, page wait
B19
IO INTERFACE
cpx3p23 *
cpx3p24 *
cpx3p25 *
cpx3p26 *
cpx3p27 *
cpx3p28 *
cpx3p29 *
cpx3p30 *
cpx3p31 *
cpx3p80 *
cpx3p81 *
cpx3p82 *
cpx3p83 *
cpx3p84 *
cpx3p85 *
cpx3p86 *
cpsize *
W
W
W
W
W
W
W
W
W
W
W
W
W
W
W
W
* Defined in asyxsuser.in
B20
ASYNCXS
C320001300D0
IO INTERFACE
IO/DESTROY
The IO/DESTROY service destroys a device, directory, or profile.
IO/DESTROY Device
This subservice destroys the definition of an IO entity. The PAD releases
all the IO entitys resources (including the channel) to the pool of
available system resources.
Packet
Field
pkthsopt
pktfname
pktfnsiz
Length
W
L
W
Contents
Handler specific option; use typ$term_ *
Address of entity name buffer
Length of entity name
* Defined in asyxsuser.in
IO/DESTROY Directory
This subservice deletes a directory. All devices in the directory must be
destroyed before the directory can be destroyed.
Packet
Field
pkthsopt
pktfname
pktfnsiz
Length
W
L
W
Contents
Handler specific option; use typ$dir_ *
Address of directory name buffer
Length of directory name
* Defined in asyxsuser.in
IO/DESTROY Profile
This subservice deletes a profile specification.
Packet
Field
pkthsopt
pktfname
pktfnsiz
ASYNCXS
C320001300D0
Length
W
L
W
Contents
Handler specific option; use typ$prof_ *
Address of profile name buffer
Length of profile name
B21
IO INTERFACE
IO/DISMOUNT
The IO/DISMOUNT service removes the definition of the PADs logical
volume. The PAD requires no handler specific fields for this service.
Packet
Field
pktname
B22
Length
8B
Contents
Logical volume name (left justified, space
filled)
ASYNCXS
C320001300D0
IO INTERFACE
IO/EXCHANGE
The IO/EXCHANGE service provides the following subservices:
These services are entity name class requests; unless otherwise noted. The
subservice packet may require a second parameter buffer pktparm2.
Required information is passed in the input pktparam, and information is
returned in the output pktparm2.
ASYNCXS
C320001300D0
B23
IO INTERFACE
Length
B
B
W
L
W
L
W
L
Contents
Request type number; use ioxvinit_ **
Request class number; use ioxcnam.
Length of entity name
Address of entity name string
Length of parameter buffer; use initsize **
Address of parameter buffer
Length of return parameter buffer; use 0
Address of return parameter buffer; use 0
** Defined in padiodefs.in
Length
inalrifrev **
inalrfunct **
inalrnmsiz**
inalrname **
W
W
W
V
inx25rev **
initsize **
Contents
Product interface revision; use axsrv1_ *
Function code; use 0
Length of alarm notification entity name
Alarm notification entity name (size specified
in inalrnmsiz **); 90 character maximum
Revision of X25; use f, g, or h
Size of input parameter buffer
B24
ASYNCXS
C320001300D0
IO INTERFACE
Length
B
B
W
L
W
L
W
L
Contents
Request type number; use ioxrcnf_ **
Request class number; use ioxcnam.
Length of entity name
Address of entity name string
Length of parameter buffer; use inalrmsize **
Address of parameter buffer
Length of return parameter buffer; use 0
Address of return parameter buffer; use 0
** Defined in padiodefs.in
Length
inalrifrev **
inalrfunct **
inalrnmsiz**
inalrname **
W
W
W
V
inalrmsize**
Contents
Product interface revision; use axsrv1_ *
Function code; use 0
Length of alarm notification entity name
Alarm notification entity name (size specified
in inalrnmsiz); 90 byte maximum
Base size of input parameter buffer
ASYNCXS
C320001300D0
B25
IO INTERFACE
Length
pktextyp
pktexmopt
pktfnsiz
pktfname
pktpbsiz
pktparam
pktpbsz2
B
B
W
L
W
L
W
pktparm2
Contents
Request type number; use ioxconf_ **
Request class number; use ioxcnam.
Length of entity name
Address of entity name string
Length of input parameter buffer (exgsize **)
Address of input parameter buffer
Length of return parameter buffer; use
initsize **
Address of return parameter buffer
** Defined in padiodefs.in
Length
W
W
Contents
Product interface revision; use axsrv1_ *
Function code; use 0
Size of input parameter buffer
Length
inalrifrev **
inalrfunct **
inalrnmsiz**
inalrname **
W
W
W
V
inx25rev **
initsize **
Contents
Product interface revision
Function code
Length of alarm notification entity name
Alarm notification entity name (size specified
in inalrnmsiz **); 90 byte maximum
Revision of X25
Size of parameter buffer
B26
ASYNCXS
C320001300D0
IO INTERFACE
Length
pktextyp
pktexopt
pktiaddr
B
B
L
pktname
8B
pktpbsiz
pktparam
pktpbsz2
pktparm2
W
L
W
L
Contents
Request type number; use ioxadreg_ **
Request class number; use ioxcfil.
System internal address returned from
IO/OPEN
Logical file name from IO/OPEN request (left
justified, space filled)
Length of parameter buffer (devntsize **)
Address of parameter buffer
Length of return parameter buffer; use 0
Address of return parameter buffer; use 0
** Defined in padiodefs.in
Length
W
W
L
Contents
Product interface revision; use axsrv1_ *
Function code; use 1
User event notification key
Size of input parameter buffer
ASYNCXS
C320001300D0
B27
IO INTERFACE
Length
pktextyp
pktexopt
pktiaddr
B
B
L
pktname
8B
pktpbsiz
pktparam
pktpbsz2
pktparm2
W
L
W
L
Contents
Request type number; use ioxhan_ **
Request class number; use ioxcfil.
System internal address returned from
IO/OPEN
Logical file name from IO/OPEN request (left
justified, space filled)
Length of parameter buffer (exgsize)
Address of parameter buffer
Length of second parameter buffer; use 0
Address of second parameter buffer; use 0
** Defined in padiodefs.in
Length
W
W
Contents
Product interface revision; use axsrv1_ *
Function code; use 1
Size of parameter buffer
* Defined in asyxsuser.in
B28
ASYNCXS
C320001300D0
IO INTERFACE
Length
pktextyp
pktexopt
pktiaddr
B
B
L
pktname
8B
pktpbsiz
pktparam
pktpbsz2
pktparm2
W
L
W
L
Contents
Request type number; use ioxpad_ **
Request class number; use ioxcfil.
System internal address returned from
IO/OPEN
Logical file name from IO/OPEN request (left
justified, space filled)
Length of base parameter buffer
Address of parameter buffer
Length of second parameter buffer; use 0
Address of second parameter buffer; use 0
** Defined in padiodefs.in
Length
W
W
B
V
Contents
Product interface revision; use axsrv1_ *
Function code; use 1
Number of hot key entries; use 1
Base of hot key table
* Defined in asyxsuser.in
Length
B
V
Contents
Length of hot key specification
Hot key specification
* Defined in asyxsuser.in
ASYNCXS
C320001300D0
B29
IO INTERFACE
Length
pktextyp
pktexopt
B
B
pktiaddr
pktname
8B
pktpbsiz
pktparam
pktpbsz2
pktparm2
L
W
L
Contents
Request type number; use ioxareg_ **
Request class number; use either ioxcnam. or
ioxcfil.
System internal address returned from
IO/OPEN
Logical file name from IO/OPEN request (left
justified, space filled)
Maximum length of parameter buffer; use
revntsize ** plus length of notification entity
name plus 2
Address of parameter buffer
Length of return parameter buffer; use 0
Address of return parameter buffer; use 0
** Defined in padiodefs.in
Contents
revntifrev **
revntfunct
**
revntkey **
revnt1mask**
W
W
L
L
revnt2mask **
L
L
L
L
L
L
L
revnt3mask **
revnt4mask **
revnt5mask **
revnt6mask **
revnt7mask **
revnt8mask **
revntsize
B30
Length
ASYNCXS
C320001300D0
IO INTERFACE
revntmnmsiz
**
revntmname
**
Description
rev_x25c **
rev_x25d **
rev_x25i **
rev_x25o **
rev_entc **
rev_entonl **
rev_entd **
rev_entoff **
rev_hotkey **
rev_x25t **
rev_x28t **
rev_ctlc **
rev_ctly **
** Defined in padiodefs.in
ASYNCXS
C320001300D0
B31
IO INTERFACE
Length
pkthsopt
pktextyp
pktexopt
pktiaddr
B
B
L
pktname
8B
pktpbsiz
pktparam
pktpbsz2
L
W
pktparm2
Contents
Handler specific options; set
hop_cal ** to request an X.25 connection,
hop_acc ** to accept an incoming X.25 call,
hop_pad ** to allow handler to go directly to
PAD mode once the call is accepted
Request type number; use ioxx25c_ **
Request class number; use ioxcfil.
System internal address returned from
IO/OPEN
Logical file name from IO/OPEN request (left
justified, space filled)
Maximum length of base parameter buffer
(cparsize ** plus length of cparps2, plus 2)
Address of parameter buffer
Length of second base parameter buffer
(cparsize ** plus length of cparps2, plus 2)
Address of second parameter buffer
** Defined in padiodefs.in
B32
Length
W
W
W
Contents
Product interface revision; use axsrv1_ *
Function code; use 1
Option field; use cpa_parm **
ASYNCXS
C320001300D0
IO INTERFACE
cpartype **
cparaserv **
cparachid **
cparacnsz **
cparacn **
cparbnsz **
cparbn **
cparprod **
cparport **
cparfpd1 **
cparfpd2 **
cparcdsz **
cparcd **
cparcgsz **
cparcg **
cparfopt **
cpartxpsz **
cparrxpsz **
cpartxwsz **
cparrxwsz**
cpartxtc **
cparrxtc **
cparrqtdy **
cpartxprio**
cparrxprio**
cparlcug **
cparicug **
cparlnksz **
cparlink **
cparlc **
cparctyp **
cparrful **
cpardopt **
cparcdesz **
cparcde **
cparcgesz **
cparcge **
cparmtxtc **
ASYNCXS
C320001300D0
B
B
B
B
20B
B
16B
W
W
W
W
B
16B
B
16B
L
W
W
W
W
W
W
W
B
B
4B
4B
W
16B
W
B
B
L
B
20B
B
20B
W
Account type
Account service type
Account charge indicator
Account number field length
Account number
Billing number field length
Billing number
Product type
Access port number
File product specific field 1
File product specific field 2
Called address length
Called address
Calling address length
Calling address
Facilities field (see list)
Transmit packet size
Receive packet size
Transmit window size
Receive window size
Transmit throughput class
Receive throughput class
Transit delay selected/indicated
Transmit priority
Receive priority
Closed User Group (CUG) selection
CUG interlock code
Link name length
Link name
PVC or SVC logical channel number
Connection type required
Word alignment
DTE facilities options field
Called address extension length
Called address extension
Calling address extension length
Calling address extension
Minimum acceptable transmit transfer count
B33
IO INTERFACE
cparmrxtc **
cparcmtdy**
cparretdy **
cparmxtdy**
cparexpdn**
cparcallid **
cparusrkey**
cparrssz **
cparrs **
cparrsn **
cparcause **
cpardiag **
cparncgsz **
cparncgid **
cparpwsz **
cparpw **
cparncdsz **
cparncdid **
cparnuisz **
cparnui **
cparsize **
cparps1 **
cparps2 **
W
W
W
W
B
L
L
B
16B
B
B
B
W
20B
W
10B
W
20B
W
16B
W
V
** Defined in padiodefs.in
Facilities
The following facility bits can be used in the cparfopt field.
B34
Mnemonic
Value
cfc_ffs **
cfc_ffsr **
cfc_fpsn **
cfc_fwsn**
cfc_ftcn **
cfc_fac **
cfc_frc **
cfc_fic **
cfc_fog **
cfc_crn **
0
1
2
3
4
5
6
7
8
9
Description
Fast select
Fast select restricted
Packet size negotiation
Window size negotiation
Throughput class negotiation
Accounting required
Reverse charge required
Incoming calls accepted
Outgoing calls accepted
Call redirection notification
ASYNCXS
C320001300D0
IO INTERFACE
cfc_cchi **
cfc_clamn **
cfc_nui **
10
11
12
cfc_lcp **
cfc_rpoa **
cfc_cug **
cfc_cugo**
cfc_bug **
13
14
15
16
17
cfc_rej **
cfc_fsa **
cfc_exn **
18
19
20
cfc_c84 **
cfc_tds **
cfc_cir **
cfc_dbn **
cfc_dbtxm **
cfc_dbrxm **
cfc_rca **
cfc_crna **
cfc_tdi **
21
22
23
24
25
26
27
28
29
** Defined in padiodefs.in
ASYNCXS
C320001300D0
B35
IO INTERFACE
Length
pkthsopt
pktextyp
pktexopt
pktiaddr
B
B
L
pktname
8B
pktpbsiz
pktparam
pktpbsz2
pktparm2
L
W
L
Contents
Handler specific options; set either:
hop_dis ** to request an X.25 disconnection,
or hop_rej ** to reject an X.25 incoming call
Request type number; use ioxx25d_ **
Request class number; use ioxcfil.
System internal address returned from
IO/OPEN
Logical file name from IO/OPEN request (left
justified, space filled)
Maximum length of parameter buffer
(ccrsize** plus length of clear user data plus 2)
Address of parameter buffer
Length of second parameter buffer; use 0
Address of second parameter buffer; use 0
** Defined in padiodefs.in
Length
W
W
B
B
W
V
Contents
Product interface revision; use axsrv1_ *
Function code; use 1
X.25 cause code
X.25 diagnostic code
Base size of structure
Size of clear user data
Clear user data
B36
ASYNCXS
C320001300D0
IO INTERFACE
Length
pktextyp
pktexopt
pktiaddr
B
B
L
pktname
8B
pktpbsiz
pktparam
pktpbsz2
W
L
W
pktparm2
Contents
Request type number; use ioxx25r_ **
Request class number; use ioxcfil.
System internal address returned from
IO/OPEN
Logical file name from IO/OPEN request (left
justified, space filled)
Length of parameter buffer (exgsize **)
Address of parameter buffer
Length of second parameter buffer
(cparsize **)
Address of second base parameter buffer
** Defined in padiodefs.in
Input Buffer
Field
exgifrev **
exgfunct **
exgsize **
Length
W
W
Contents
Product interface revision; use axsrv1_ *
Function code; use 1
Size of input parameter buffer
Output Buffer
The returned parameter buffer contains the information that is used for the
IO/EXCHANGE Request an X.25 Connection/Accept Incoming X.25 Call
subservice; see the list beginning on page B32.
ASYNCXS
C320001300D0
B37
IO INTERFACE
Length
pktextyp
pktexopt
pktfname
pktfnsiz
pktname
B
B
L
W
8B
pktpbsiz
pktparam
pktpbsz2
pktparm2
W
L
W
L
Contents
Request type number; use ioxmdev_ **
Request class number; use ioxcnam.
Address of entity name string
Length of entity name
Logical file name from IO/OPEN request (left
justified, space filled)
Length of parameter buffer (cmsize *)
Address of parameter buffer
Length of second parameter buffer; use 0
Address of second parameter buffer; use 0
** Defined in padiodefs.in
B38
ASYNCXS
C320001300D0
IO INTERFACE
IO/INFO
The IO/INFO service provides the following information retrieval
subservices:
TRAX does not use pktiaddr for name class IO. To avoid the chance of
error, Telematics recommends that that field not be provided.
IO/INFO Obtain Detailed Entity Properties
This subservice returns the properties of a volume, directory, device, or
profile.
Packet
Field
pktimopt
pktimtyp
pktfname
pktfnsiz
pktparam
pktpbsiz
Length
B
B
L
W
L
W
Contents
Class selection index; use ioicnam.
Type selection index; use ioidepr.
Address of entity name string
Length of entity name
Address of return information buffer
Byte length of return information buffer; use
ioibsize
ASYNCXS
C320001300D0
Length
W
B
B
L
L
L
L
2L
Contents
Definition flags
Device type; use typterm.
Data type
Block size (fixed block entities)
Max. number of blocks/transfer (fixed block)
Minimum read buffer size in bytes (variable)
Maximum transfer count in bytes
Hander defined information
Size of structure
B39
IO INTERFACE
Field
pktimopt
pktfname
pktfnsiz
pktimtyp
pktrvalu
B
L
W
B
L
Contents
Class selection index; use ioicnam.
Address of entity name string
Length of entity name
Type selection index; use ioigdst.
Return status from TRAX
Length
pktimopt
pktfname
pktfnsiz
pktimtyp
pktparam
pktpbsiz
B
L
W
B
L
W
Contents
Class selection index; use ioicnam.
Address of entity name string
Length of entity name
Type selection index; use ioinam_ *
Address of return information buffer
Byte length of return information buffer; each
entry requires 20 bytes
* Defined in asyxsuser.in
B40
Contents
Entity name
Device type
Device state
ASYNCXS
C320001300D0
IO INTERFACE
Length
B
B
L
W
W
L
W
Contents
Class selection index; use ioicnam.
Type selection index; use ioicfg_ *
Address of entity name string
Length of entity name
Handler specific option; use typ$term_ *
Address of return information buffer
Byte length of return buffer; use cmsize *
* Defined in asyxsuser.in
Length
B
L
W
B
W
L
W
Contents
Class selection index; use ioicnam.
Address of entity name string
Length of entity name
Type selection index; use ioicfg_ *
Handler specific option; use typ$prof_ *
Address of return information buffer
Byte length of return buffer; use cpsize *
* Defined in asyxsuser.in
ASYNCXS
C320001300D0
B41
IO INTERFACE
Length
B
L
W
B
L
W
Contents
Class selection index; use ioicnam.
Address of entity name string
Length of entity name
Type selection index; use ioista_ *
Address of return information buffer
Byte length of return information buffer; use
ctsize *
* Defined in asyxsuser.in
Statistics Buffer
Field
ctname *
cttype *
ctstate *
ctcstat *
ctlsiz *
ctlnua *
ctrsiz *
ctrnua *
ctpsiz *
ctplnk *
ctplcn *
ctocnt *
cticnt *
ctctime *
cttcnt *
ctrcnt *
cttres *
ctrres *
cttint *
ctrint *
ctocall *
cticall *
ctframe *
B42
Length
4L
W
W
W
W
16B
W
16B
W
16B
W
L
L
L
L
L
L
L
L
L
L
L
L
Contents
Device name
Device type; use typ$term_ *
Device state
Call status/direction
Local NUA size
Local NUA
Remote NUA size
Remote NUA
PVC link name size
PVC link name
PVC logical channel number
Output byte count
Input byte count
Time connected (milliseconds) or 0
X.25 writes issued by PAD
X.25 reads issued by PAD
X.25 resets issued by PAD
X.25 resets received by PAD
X.25 interrupts issued by PAD
X.25 interrupts received by PAD
Calls issued
Calls received
Async framing errors
ASYNCXS
C320001300D0
IO INTERFACE
ctpari *
ctoverf *
ctbreak *
ctsize *
L
L
L
* Defined in asyxsuser.in
Length
B
B
L
W
W
L
W
Contents
Class selection index; use ioicnam.
Type selection index; use ioismp_ *
Address of entity name string
Length of entity name
Buffer number
Address of return information buffer
Byte length of return information buffer; use
mapssize *
* Defined in asyxsuser.in
Return Buffer
Field
maphfptr *
maphcnt *
Length
L
W
Contents
Address of next PADmap buffer
Number of entries in this buffer
Cell entries start here
* Defined in asyxsuser.in
Length
mapnual *
mapnua *
mapcudl *
mapcud *
maptype *
mapport1 *
B
16B
B
13B
B
W
mapport2 *
mapcsize *
mapssize *
ASYNCXS
C320001300D0
Contents
Called NUA length (without null)
Called NUA (null terminated)
Call user data length (without null)
Call user data (null terminated)
Type of port mapping (see list below)
First port (see maptype definitions list below
for meaning)
Second port
Size of map cell
Size of map structure
B43
IO INTERFACE
* Defined in asyxsuser.in
maptype Definitions
Mnemonic
maptinv_ *
maptstar_ *
maptrang_ *
maptcud_ *
maptnua_ *
Value Description
1
0
1
2
3
* Defined in asyxsuser.in
Length
B
L
W
B
L
W
Contents
Class selection index; use ioicnam.
Address of entity name string
Length of entity name
Type selection index; use ioicfg_ *
Address of return information buffer
Byte length of return information buffer; use
acnfsize *
* Defined in asyxsuser.in
Return Buffer
Field
acnfccprov *
acnfsize *
Length
32B
Contents
Control character processing table
Size of structure
* Defined in asyxsuser.in
B44
ASYNCXS
C320001300D0
IO INTERFACE
IO/MODE
The IO/MODE service provides the following subservices:
Length
B
L
W
B
Contents
Class selection index; use iomcnam.
Address of entity name string
Length of entity name
Type selection index; use iomenb_ *
* Defined in asyxsuser.in
Length
B
L
W
B
Contents
Class selection index; use iomcnam.
Address of entity name string
Length of entity name
Type selection index; use iomdisa_ *
* Defined in asyxsuser.in
ASYNCXS
C320001300D0
B45
IO INTERFACE
Length
B
L
W
B
W
L
W
Contents
Class selection index; use iomcnam.
Address of entity name string
Length of entity name
Type selection index; use iommod_ *
Handler specific option; use type$term_ *
Address of parameter buffer
Byte length of parameter buffer; use cmsize *
* Defined in asyxsuser.in
Parameter Buffer
The parameter buffer can contain the information that is used for the
IO/CREATE Create Device subservice; see list beginning on page B10.
IO/MODE Modify Profile
This subservice changes one or more profile parameters for an
asynchronous device connected to the PAD.
Packet
Field
pktimopt
pktfname
pktfnsiz
pktimtyp
pkthsopt
pktparam
pktpbsiz
Length
B
L
W
B
W
L
W
Contents
Class selection index; use iomcnam.
Address of entity name string
Length of entity name
Type selection index; use iommod_ *
Handler specific option; use type$prof_ *
Address of parameter buffer
Byte length of parameter buffer; use cpsize *
* Defined in asyxsuser.in
Parameter Buffer
The parameter buffer can contain the information that is used for the
IO/CREATE Create Profile subservice; see the list beginning on page
B19. See Chapter 3 for complete X.3 parameter descriptions and values.
B46
ASYNCXS
C320001300D0
IO INTERFACE
Length
pktname
8B
pktimtyp
pktiaddr
B
L
Contents
Logical file name from IO/OPEN request (left
justified, space filled)
Type selection index; use iomres_ *
System internal address returned from
IO/OPEN
* Defined in asyxsuser.in
ASYNCXS
C320001300D0
B47
IO INTERFACE
Length
pktimopt
pktfname
pktfnsiz
pktimtyp
pktparam
pktpbsiz
B
L
W
B
L
W
Contents
Class selection index; use iomcnam.
Address of entity name string
Length of entity name
Type selection index; use iomadm_ *
Address of parameter buffer
Byte length of parameter buffer; use mapcsize*
* Defined in asyxsuser.in
Field
mapnual *
mapnua *
mapcudl *
mapcud *
maptype *
mapport1 *
B
16B
B
13B
B
W
mapport2 *
mapcsize *
Contents
Called NUA length (without null)
Called NUA (null terminated)
Call user data length (without null)
Call user data (null terminated)
Type of port mapping (see list below)
First port (see maptype definitions list below
for meaning)
Second port
Size of map cell
* Defined in asyxsuser.in
maptype Definitions
Mnemonic
maptinv_ *
maptstar_ *
maptrang_ *
maptcud_ *
maptnua_ *
Value Description
1
0
1
2
3
* Defined in asyxsuser.in
B48
ASYNCXS
C320001300D0
IO INTERFACE
Length
pktimopt
pktfname
pktfnsiz
pktimtyp
pktiaddr
B
L
W
B
L
pktparam
pktpbsiz
L
W
Contents
Class selection index; use iomcnam.
Address of entity name string
Length of entity name
Type selection index; use iomdem_ *
System internal address returned from
IO/OPEN
Address of parameter buffer
Byte length of parameter buffer; use mapcsize*
* Defined in asyxsuser.in
Field
mapnual *
mapnua *
mapcudl *
mapcud *
maptype *
mapport1 *
B
16B
B
13B
B
W
mapport2 *
mapcsize *
Contents
Called NUA length (without null)
Called NUA (null terminated)
Call user data length (without null)
Call user data (null terminated)
Type of port mapping (see list below)
First port (see maptype definitions list below
for meaning)
Second port
Size of map cell
* Defined in asyxsuser.in
maptype Definitions
Mnemonic
maptinv_ *
maptstar_ *
maptrang_ *
maptcud_ *
maptnua_ *
Value Description
1
0
1
2
3
* Defined in asyxsuser.in
ASYNCXS
C320001300D0
B49
IO INTERFACE
Length
B
L
W
B
Contents
Class selection index; use iomcnam.
Address of entity name string
Length of entity name
Type selection index; use iomdea_ *
* Defined in asyxsuser.in
B50
ASYNCXS
C320001300D0
IO INTERFACE
Length
B
L
W
B
W
Contents
Class selection index; use iomcnam.
Address of entity name string
Length of entity name
Type selection index; use iomtskexc_ *
Handler specific option; set one of:
hop_dreg ** to disable task exception
processing
hop_reg ** to enable task exception processing
Sample Exception
When exception processing is enabled and an exception is detected, the
following information is displayed on the operator console:
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
<time>
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
asyncxs
Size:
Size:
Size:
Size:
Size:
<hex_value>
<hex_value>
<hex_value>
<hex_value>
<hex_value>
Stack at exception:
<hex_value> <hex_value> <hex_value> <hex_value>
<hex_value> <hex_value> <hex_value> <hex_value>
<hex_value> <hex_value> <hex_value> <hex_value>
Service
Pkt
Pkt+$10
Pkt+$20
Pkt+$30
After the exception is reported, ASYNCXS cleans up the stack and reads
its service queue.
ASYNCXS
C320001300D0
B51
IO INTERFACE
Length
B
L
W
B
L
W
Contents
Class selection index; use iomcnam.
Address of entity name string
Length of entity name
Type selection index; use iomacnf_ *
Address of return information buffer
Byte length of return buffer; use acnfsize *
* Defined in asyxsuser.in
Return Buffer
Field
acnfccproc *
acnfsize *
Length
32B
Contents
Control character processing table
Size of structure
* Defined in asyxsuser.in
Description
ccctla_ *
ccctlb_ *
ccctlc_ *
ccctle_ *
ccctlh_ *
ccctli_ *
ccctlj_ *
ccctlk_ *
ccctll_ *
ccctlm_ *
B52
ASYNCXS
C320001300D0
IO INTERFACE
ccctlo_ *
ccctlq_ *
ccctlr_ *
ccctls_ *
ccctlu_ *
ccctlx_ *
ccctly_ *
ccctlz_ *
ccigno_ *
ccnctl_ *
ccnuse_ *
cctext_ *
* Defined in asyxsuser.in
ASYNCXS
C320001300D0
B53
IO INTERFACE
B54
Index
Default
Index
Default
$00
$01
$02
$03
$04
$05
$06
$07
$08
$09
$0A
$0B
$0C
$0D
$0E
$0F
ccnuse_
ccctla_
ccctlb_
ccctlc_
ccnuse_
ccctle_
ccnuse_
ccnctl_
ccctlh_
ccctli_
ccctlj_
ccctlk_
ccctll_
cctext_
ccnuse_
ccctlo_
$10
$11
$12
$13
$14
$15
$16
$17
$18
$19
$1A
$1B
$1C
$1D
$1E
$1F
ccnuse_
ccctlq_
ccctlr_
ccctls_
ccnuse_
ccctlu_
ccnuse_
ccnuse_
ccctlx_
ccctly_
ccctlz_
ccnctl_
ccnuse_
ccnuse_
ccnuse_
ccnuse_
ASYNCXS
C320001300D0
IO INTERFACE
IO/MOUNT
The IO/MOUNT service mounts a logical volume and claims a
Communications Processor (CP) activity queue. The CP uses this activity
queue to notify the PAD of CPrelated event/exception conditions. A
successful IO/MOUNT request initializes the CP and handler offsets in the
activity queue, and enables interrupts. The calling task must have software
privilege to use this service.
Packet
Field
Length
pktdvtyp
pktname
W
8B
pktmtsqn
2L
ASYNCXS
C320001300D0
Contents
Entity type; use typinfbase.+1
Logical volume name (left justified, space
filled)
Name of PADs service queue
B55
IO INTERFACE
IO/OPEN
The IO/OPEN service opens a local IO entity, and optionally allows the
calling task to register for event notification. The IO entity name
represents a physical pair of input and output channels. Multiple tasks can
be open to an IO entity simultaneously. All logical files under the PAD are
created with read and write access.
Packet
Field
Length
pktssopt
pkthsopt
pktiaddr
pktname
8B
pktfnsiz
pktfname
pktpbsiz
W
L
W
pktparam
pktrvalu
L
L
Contents
Access options; to request exclusive access, set
sop.excl
Handler specific option; to register for events,
set hop_evnt **
On return, internal pointer for subsequent IO
requests
Logical access name (left justified, space
filled)
Length of entity name
Address of entity name string
Size of optional event registration buffer
(revntsize **), or zero
Address of parameter buffer, or zero
On return from this service, the state of the
connection; see list below
** Defined in padiodefs.in
Value Description
0
1
2
3
4
* Defined in asyxsuser.in
B56
ASYNCXS
C320001300D0
IO INTERFACE
IO/READ
This service transfers data from an IO entity to a buffer. The calling task
may select any of the following options for each IO/READ request:
Read with prompt. This option writes the contents of the secondary
buffer to the IO entity before the read operation. To enable this option,
the calling task defines the secondary buffer by specifying an address
and byte length for it.
ASYNCXS
C320001300D0
B57
IO INTERFACE
Length
pktfname
pktfnsiz
pkthsopt
L
W
W
pktiaddr
pktbf2ad
pktbf2ct
pktdpbad
pktdpbsz
Contents
Address of entity name string
Length of entity name
Handler specific options; set any of the
following:
hrop_pur ** purge typeahead buffer before
the read
hrop_tim ** enable timeout feature using
value specified in parameter buffer
hrop_low * convert lowercase characters to
uppercase
hrop_nec * disable echo
hrop_pas * use passall mode
hrop_tne * inhibit echo of logical read
terminator characters
System internal address returned from
IO/OPEN
If using read with prompt option, address of
secondary buffer containing the prompt; else
zero
If using read with prompt option, byte length of
secondary buffer containing the prompt; else
zero
If using logical read terminators and/or timeout
options, address of parameter buffer; else zero
If using logical read terminators and/or timeout
options, byte length of parameter buffer; else
zero (use arpbsize * with logical read
terminators option)
B58
ASYNCXS
C320001300D0
IO INTERFACE
Parameter Buffer
This buffer is used to define a logical read terminator mask and/or a
timeout value.
Field
Length
arpbtime *
arpbtrsz *
arpbmask *
arpbsize *
32B
Contents
Read timeout value in milliseconds (0 to
2321); else zero; note that timer granularity is
configurable (default = 500 ms)
Byte length of logical read terminator mask;
else zero
Read terminator mask
Size of parameter buffer
* Defined in asyxsuser.in
Description
axsrctlc_ *
axsrctlo_ *
axsrctly_ *
axsrbuff_ *
axsrtime_ *
axsrhang_ *
axsrserv_ *
* Defined in asyxsuser.in
ASYNCXS
C320001300D0
B59
IO INTERFACE
IO/RESET
The IO/RESET service cancels specific types or all of the outstanding data
server requests for a logical file.
Packet
Field
B60
Length
pktname
8B
pktssopt
pktiaddr
Contents
Logical file name from IO/OPEN request (left
justified, space filled)
Subservice options; set any of the following:
sop.rii inhibit reset of reads in progress
sop.rio inhibit reset of writes in progress
sop.rqi inhibit reset of queued reads
sop.rqo inhibit reset of queued writes
A zero value resets all reads and writes
(queued and in progress)
System internal address returned from
IO/OPEN
ASYNCXS
C320001300D0
IO INTERFACE
IO/WRITE
The IO/WRITE service transfers data from a buffer to an IO entity. The
calling task can specify prefix and postfix values for the output data by
providing the address and length of a parameter buffer (which must be at
least four bytes long). The PAD does not support a secondary buffer for
IO/WRITE.
Packet
Field
Length
pktfname
pktfnsiz
pktssopt
L
W
W
pkthsopt
pktiaddr
pktdpbad
pktdpbsz
Contents
Address of entity name string
Length of entity name
Subservice option; to indicate data chained
operation, set sop.dchn
Handler specific options; set any of the
following:
hwop_cor * reset ControlO state before
processing write request
hwop_txb * current request is not a write but
a break; the parameter buffer specifies the
duration
System internal address returned from
IO/OPEN
Address of parameter buffer (if using prefix
and postfix values, or if write is a break); else
zero
Byte length of parameter buffer (if using prefix
and postfix values, or if write is a break; use
awpbsize *); else zero
* Defined in asyxsuser.in
ASYNCXS
C320001300D0
B61
IO INTERFACE
Parameter Buffer
This parameter buffer is used to specify prefix and postfix values, or a
break duration if the IO/WRITE request is actually a break.
Field
Length
awpbprec *
awpbposc *
awpbpre *
awpbpos *
awpbtxb *
awpbsize *
Contents
Number of repetitions (0255) of prefix value;
else zero
Number of repetitions (0255) of postfix value;
else zero
Prefix; specify one of:
afixnil_ * null operation
afixcr_ * carriage return
afixlf_ * line feed
afixff_ * form feed
afixnl_ * newline
Else, zero
Postfix; use one of the mnemonics listed for
the awpbpre field; else zero
Duration of break in milliseconds; else zero
Size of parameter buffer
* Defined in asyxsuser.in
Description
axsctlc_ *
axsctlo_ *
axsctly_ *
axsrset_ *
axsserv_ *
* Defined in asyxsuser.in
B62
ASYNCXS
C320001300D0
IO INTERFACE
Return Values/Errors
pktrvalus
ASYNCXS can return the following pktrvalus:
Value
$10001
$10002
$10003
$10004
$10005
$10006
$10007
$10008
$10009
$1000A
$1000B
$1000C
$1000D
$1000E
$1000F
$10010
$10011
$10012
ASYNCXS
C320001300D0
Meaning
The PMM is incompatible with the PAD
Conflicting parameters: AUTOBAUD is invalid with
DTRCALL
Conflicting parameters: DTRCALL is invalid with
DTR flow control
An attempt was made to create or modify a device
with an invalid profile parameter
An error occurred on async online
An error occurred when allocating memory for
changing DI to block mode async input
The X25 revision was not specified in the command
or by a Define Initial command
The operating mode changed to PAD; an IO request
was terminated
The operating mode changed to HANDLER; an IO
request was terminated
No incoming call has been received
No call is active
Multiple Define Initial command calls are not valid
An attempt was made to create or modify a device
with an invalid X.3 parameter
Device cannot be enabled; a disable is in progress
A call was placed/accepted; the return buffer size is
invalid
The call user data length was greater than 16 on
nonFS/FSR call
Attempting to place a call; a call is already active
Attempting to place a call; a call is in progress
B63
IO INTERFACE
Errors
The following errors can be returned:
Mnemonic
Meaning
sccnxst.
sccexst.
sccuse.
scchie.
sccparm.
sccmem.
sccoptn.
sccdtns.
scchke.
sccname.
sccbuf.
sccfnsp.
sccbhuf.
sccsop.
sccbusy.
sccexcl.
sccfull.
sccait.
sccait.
scceof.
B64
ASYNCXS
C320001300D0
Glossary
ASCII American Standard Code for Information Interchange
An eight bit alphanumeric code for data transfer adopted by the
American National Standards Institute (ANSI X3.4 1968). The eighth
bit in each character code provides parity.
asynchronous communications
Data transmission without regular time relationship. Transmission is
controlled by start/stop bits. The sending device inserts start/stop bits
at the beginning and end of each character. The receiving device
resynchronizes on the start bit of each character.
asynchronous terminal handler
A Telematics product that controls IO operations between user tasks
and asynchronous terminal devices. Terminal oriented facilities
include user defined communications characteristics and control
character processing.
bit rate
A unit of signaling speed that is equal to the number of discrete
conditions or signal events per second.
call facilities
Optional X.25 user services that can be independently configured for a
link, file, or network user address.
call registration
The process by which ASYNCXS notifies NET25 to accept
incoming calls at a particular network address. Registration is done
when a device is created.
call user data (CUD)
Data included in a call request packet.
CCITT Consultative Committee for International Telephone and
Telegraph
The international body that produces standards on behalf of national
telecommunications authorities.
channel
The part of a communication system that connects two points and
provides a path along which signals can be sent; referred to also as
port.
command mode
The state in which all characters from the terminal to the PAD are
interpreted by the PAD as commands.
ASYNCXS
C320001300D0
GL1
GLOSSARY
configuration
The process of identifying ASYNCXS devices and profiles to
ASYNCXS and placing them into operational states.
data forwarding character
Upon receipt of a data forwarding character, all characters in the input
buffer are assembled into a data packet that is sent to a remote DTE.
The data forwarding character is the last character in the data packet.
data forwarding timeout
Each time a character is received by a PAD, the timer is started. If the
timer expires, all characters in the input buffer are assembled into a
data packet and sent to a remote DTE.
data transfer mode
The state in which all characters received from the terminal by the
PAD are packaged into packets and sent to the host DTE.
device
The asynchronous hardware to which the PAD port connects, and the
data source and destination to/from the PAD (a keyboard/display
terminal, a printer, or an asynchronous channel on a host computer).
events
Device related occurrences that may require action. An application
task can register for event notification through the IO interface; when
a defined event happens for which the task is registered, the task is
advised with an IO/MODE event notification.
fast select
A facility provided by some packet switching networks that allows up
to 128 bytes of data to be passed across the network when a call is
initiated. This allows short exchanges of information without actually
establishing a call.
flow control
A mechanism by which a network limits the number of messages in
transit, in order to prevent overloading and poor performance.
Specifying window sizes is the typical flow control method.
handler mode
A state of an ASYNCXS device where the only valid activity is
through the TRAX IO services.
hot key
A designated character that when entered, places the PAD into handler
mode and generates an event notification.
INF Interactive Network Facilities
A Telematics network management tool providing network control,
report generation, and diagnostic capabilities.
GL2
ASYNCXS
C320001300D0
GLOSSARY
initial profile
An X.3 profile used as the default profile when a terminal or printer is
initially connected to the PAD.
IO entity
A Telematics term for anything with which a task can perform input
and output operations. This includes: a file stored on disk or in
memory; a device connected to the system through a channel card
(e.g., terminal, printer); a device connected via a CPU port (e.g., host
computer, operator terminal); another task running on the system (e.g.,
network gateway, protocol handler).
logical volume
A grouping of IO entities with common characteristics.
Network Configuration Model (NCM)
A set of files and procedures for configuring a Telematics network.
NET25
The Telematics product responsible for providing user connections to a
packet switching network and supporting the functions of a switching
node on the network.
network access point
The point at which a device accesses the packet switching network.
Each network access point has a network user address assigned to it
during network configuration.
NUA Network User Address
The identifier by which a DTE is known to the network. Comparable
to a subscribers telephone number.
packet switching network
A set of linked packet switched exchanges that can be used to pass
packets between two users connected to the network through their
respective X.25 links.
PAD Packet Assembler/Disassembler
A device that assembles packets from character streams and
disassembles packets into character streams. In the Telematics
environment, a PAD refers to a Telematics node providing PAD
support for devices. Access products such as ASYNCXS work jointly
with NET25 to provide PAD support for asynchronous devices that
communicate through a packet switching network.
PAD connection
Recommendations X.25, X.28, X.3, and X.29 constitute the PAD
connections on a packet switching network. PAD connections are used
with X.25. PAD connections allow nonpacketmode DTEs to
communicate with host DTEs across a packet switching network.
ASYNCXS
C320001300D0
GL3
GLOSSARY
padding
Padding assures that characters are not printed when the mechanical
device (carriage) is being returned to the left margin. Padding can be
nonprinting characters or time fill.
PADmap
An ASYNCXS structure containing NUA, call user data, and port
information that is used for assignment of incoming calls.
PAD messages
Messages sent between the host and the PAD. They are carried in data
packets with the Q bit set to 1.
PAD mode
The default device operating mode, which can be further classified as
command mode or data transfer mode.
PAD prompt
The messages sent back by the PAD to the terminal to indicate that the
physical connection is established and the link is active.
PAD service signals
Messages sent from the PAD to the terminal. Defined by
Recommendation X.28, these messages acknowledge PAD command
signals and return to the terminal the identity and internal state of the
PAD.
PMM Product Management Module
An INF command library for interfacing to a task, e.g., a PAD.
port
The physical channel from the Telematics system to the asynchronous
device. ASYNCXS communicates directly with the asynchronous
ports under its control, but makes no distinction between terminal and
host port connections.
profile
A set of X.3 parameters that control terminals connected to
ASYNCXS.
protocol
A procedure defining the interaction of two processes across an
interface.
PVC Permanent Virtual Circuit
A virtual circuit established during network configuration that
permanently connects two network users; equivalent to a leased line.
Recommendation X.3
The CCITT document defining the X.3 PAD parameters that establish
terminal specific characteristics or actions that the remote DTE wants
the PAD to take upon receipt of particular input from the terminal
(e.g., break).
GL4
ASYNCXS
C320001300D0
GLOSSARY
Recommendation X.25
The CCITT document defining the three levels of the X.25 protocol to
connect a customers DTE to a network node (DCE). The protocol
requires software in both the DTE and the network.
Recommendation X.28
The CCITT document defining terminal signaling, i.e., commands
typed by the terminal user that are understood by the PAD, and
messages that are returned by the PAD to the terminal user.
Recommendation X.29
The CCITT document defining control procedures between the X.25
DTE and the network PAD.
SVC Switched Virtual Circuit
A virtual circuit which connects two network users for the duration of
a call. It is set up when one party calls another and removed when
either party clears the call.
terminal user
The person at an asynchronous keyboard/display terminal who signs
the terminal onto the PAD, and either readies it to accept incoming
calls, or makes outgoing calls.
Telematics system
A generic name for all Telematics Programmable Communication
Processors.
throughput
The attainable line speed for a virtual circuit during normal and peak
usage.
transmission line
The physical means of connecting processors at different locations so
that information may be transferred between them. When direct wire
connection is impractical, processors generally communicate across
leased or switched lines.
TRAX
The Telematics operating system.
virtual circuit
A logical connection between two subscribers, as defined by X.25
level 3. Virtual circuits can be multiplexed along a single link.
X.25
The protocol defining the exchange of packets along a virtual circuit.
X.25 defines the physical transfer of data along a link (level 1), the
correct exchange of data between a users computer equipment and a
packet switched exchange (level 2), and the setup and clearing of
virtual circuits (level 3).
ASYNCXS
C320001300D0
GL5
GLOSSARY
GL6
ASYNCXS
C320001300D0
Index
!!,1+0'+% 1**.5 /#.2'!# /'%+)
!(+,3)#"%# /#.2'!# /'%+)
"" - !,**+"
).*/ 6
.#" !,**+"
!&.!0#. /#0
!,**+"/
"" -
,))#!0 00'/0'!/
.#0# #2'!#
.#0# '.#!0,.5
.#0# .,$')#
#$'+# +'0')
#)#0# -
#/0.,5
'/ )# #2'!#
+ )# #2'!#
./# -
,"'$5 #2'!#
,"'$5 +'0')
,"'$5 .,$')#
#/#0 00'/0'!/
#0 #$1)0/ #2'!#/
#0 #$1)0/ +'0')
#0 #$1)0/ .,$')#/
&,3 #$1)0/ #2'!#/
&,3 #$1)0/ +'0')
&,3 #$1)0/ .,$')#/
&,3 #2'!#
&,3 '.#!0,.5
&,3 +'0')
&,3 -
&,3 .,$')#
&,3 00'/0'!/
/1**.5
10, 1"
10,!))
10,-.'05
ASYNCXS
C320001300D0
.#(
!0',+ ,+ .#!#'-0
)0#.+0# /'%+)
"0 $,.3."'+% ,+ .#!#'-0 ,$
/#.2'!# /'%+)
1$$#./
)) !,**+"
)) )) #0.5 !,**+"
)) .,10'+%
"#/!.'-0',+
#4*-)#/
&.!0#. "#)#0# !&.!0#.
&.!0#./
!,+0.,) '+0#.$!# 6
"0 $,.3."'+%
"#)#0'+% '+ #"'0'+%
#"'0'+%
/-#!')
)#.
!1/# /'%+)/
!,+$'.*0',+ /#.2'!# /'%+)
/#.2'!# /'%+)
). )#. !,**+"
,++#!0 !,**+"
,++#!0#" /#.2'!# /'%+)
,++#!0',+ -.,!#"1.#/
,+0'+1# !,**+"
,+0.,) !&.!0#./ '+0#.$!#
6
,+2#+0',+/
,-5 !,**+"
,-5!). ,-5 )#. !,**+"
.#0# #2'!# !,**+"
IN1
INDEX
D
!2! &.05!0$)-'
!$$)2).-!+ #(!0!#2%0
!$$)2).-!+ #(!0!#2%0
#(!0!#2%01
#.-$)2).-1
.- #(!0!#2%0 #.3-2
.- 0%#%)/2 .& "0%!* #(!0!#2%0
.- 0%#%)/2 .& &.05!0$)-' #(!0!#2%0
.- 0%#%)/2 .& 0%#!++ #(!0!#2%0
5(%- "3&&%0 &3++
!2! 20!-1&%0 ,.$%
%&)-% -)2)!+ #.,,!-$
%+%2% !/ #.,,!-$
%120.7 #.,,!-$
%4)#% ./%0!2).-!+ 12!2%1
%4)#% 1/%%$
)!'-.12)# %#(.
)1!"+% %4)#% #.,,!-$
)1!"+% $%4)#% .- #!++ #+%!0
)1#!0$ .32/32
)1/+!7 .32/32 $%+!7
E
#(.
$)!'-.12)#
+.#!+ %-!"+%$)1!"+%
,!1*
$)2)-'
#(!0!#2%0 $%+%2% #(!0!#2%0
#(!0!#2%01
%-!"+%$)1!"+% )- $!2! 20!-1&%0 ,.$%
+)-% $%+%2% #(!0!#2%0
IN2
F
+.5 #.-20.+
$%4)#%
5)2( ,.$%, 1)'-!+1
#(!0!#2%0
#(!0!#2%0
G
+.11!07
H
!-$+%0 ,.$% )-2%0&!#%
%+/ #.,,!-$
.2 *%7 )-2%0&!#%
I
#+0 -4)2!2).- 2. +%!0 #.,,!-$
$+% 2),%0
-#+3$% #.,,!-$
ASYNCXS
C320001300D0
INDEX
/4:+8,')+
!
" @
!" &
!#"
%
@
@
@
#"
@
!"
$ " @
%
'))+6: /4)53/4- %
)'22
@
*+,/4+ /4/:/'2 6'8'3+:+89
*+8+-/9:+8 ,58 +<+4: 45:/,/)':/54
35*/,? *+</)+ =./2+ 542/4+ @
35*/,? /4/:/'2 6'8'3+:+89
5(:'/4 /4/:/'2 6'8'3+:+89
6'99 )54:852 :5 .'4*2+8 35*+
6'99 )54:852 :5 35*+
8+-/9:+8 ,58 +<+4: 45:/,/)':/54
@
8+0+): /4)53/4- %
)'22
8+7;+9: /4)53/4- )'22 6'8'3+:+89
@
8+7;+9: %
)544+):/54
@
8+7;+9: %
*/9)544+):/54
5(:'/4 '9?4) )54,/-;8':/54
5(:'/4 *+:'/2+* +4:/:? 6856+8:/+9
5(:'/4 *+</)+ )54,/-;8':/54
5(:'/4 *+</)+ 9:':/9:/)9
@
5(:'/4 *+</)+ 9:':;9
5(:'/4 +4:/:? 4'3+9
5(:'/4 3'6 :'(2+ @
5(:'/4 685,/2+ )54,/-;8':/54
ASYNCXS
C320001300D0
'** 3'6 +4:8?
*+2+:+ '22 3'6 +4:8/+9
*+2+:+ 3'6 +4:8?
*/9'(2+ *+</)+
*/9'(2+ :'91 +>)+6:/54 685)+99/4-
+4'(2+ *+</)+
+4'(2+ :'91 +>)+6:/54 685)+99/4-
35*/,? '9?4) )54,/-;8':/54
@
35*/,? *+</)+
35*/,? 685,/2+
8+9+: 9:':/9:/)9
#"
@
!"
$ " @
L
'4-;'-+ )533'4*
/(8'8/+9
/4+
*+2+:+ ).'8'):+8 %
*/962'? ).'8'):+8 %
,++* ',:+8 )'88/'-+ 8+:;84 %
,++* 6'**/4- ',:+8 %
,52*/4- %
M
+99'-+ )533'4*
5*+3
)54,/-;8/4- 9;(56:/549
9/-4'2 ,25= )54:852 %
5*+9 5, 56+8':/54
5*/,? +</)+ )533'4*
5*/,? 4/:/'2 )533'4*
5*/,? 85,/2+ )533'4*
N
':/54'2 3'81+8 %
"
IN3
INDEX
,"-/&+* )+!".
-1(0.
P
/&+* +* -" "&,/ +# -"' .&$*(
#(+2 +*/-+(
)+!" &*/"-# "
,-+),/
-" (( %- /"-
."-1& " .&$*(.
5
S
"*! +))*!
),
"..&+*
-)"/"- +))*!
"/ +))*!
-&/3
!"/" /&+*
/-"/)"*/
+-/ ..&$*)"*/
!!&*$
#/"- --&$" -"/0-*
-+#&(".
R
"! +))*!
"! +,/&+*.
IN4
ASYNCXS
C320001300D0
INDEX
:.$0-+% 44+)/.'/5
%3'#5+/)
&+41-#:+/) 7#-6'4
13'&'(+/'&
3'1-#%'.'/5
'/#$-+/) "
'9#.1-'4
36-'4
:/5#9 %0/7'/5+0/4
T
#%5 035 '45 %0..#/&
#%55 '3.+/#- '45 %0..#/&
'3.+/#%0//'%5+0/ 130%'&63'4
4+)/0/ +/%-6&' (+-'4
'3.+/#5' %0..#/&
:1' %0..#/&
:1'#*'#& $6(('3
W
!#+5 %0..#/&
X
"
%0..#/&4
3'#&
#--
#-- #-- '53:
-3 -'#3
0//'%5
0/5+/6'
01:
01:%-3 01: -'#3
'-1
ASYNCXS
C320001300D0
'#&
'4'5 '4'5 +3%6+5
1#3 '.05' #3#.'5'3
130( '.05' 30(+-'
4'5 '.05' '5
'/&
'5
5#5 5#564
46..#3:
4:/5#9
#%5 035 '45
#%55 '3.+/#- '45
'3.+/#5'
:1'
!#+5
"
:1'
" :1'
" 1#3#.'5'34
%*#/)+/) -0%#- 7#-6'4
%*#/)+/) 3'.05' 7#-6'4
&'4%3+15+0/4 ;
&+41-#:+/) -0%#- 7#-6'4
&+41-#:+/) 130(+-' /#.'47#-6'4
IN5
INDEX
IN6
ASYNCXS
C320001300D0