HP SNA Application Programming Interface for OpenVMS

HP SNA Application Programming SPD 26.86.10
Interface for OpenVMS, Version 2.7
• Respond to a session request initiated by an IBM
application
• Reestablish a session if the connection is broken
• Disconnect from a session
• Receive messages from an IBM host on the normal
or expedited flow
• Send messages to an IBM host on the normal or
expedited flow
• Provide positive or negative responses to messages
transmitted from an IBM host
Asynchronous Event Notification
API provides a mechanism for an OpenVMS user appli-
cation to receive control when an asynchronous "net-
work event" occurs, such as the disconnection of a
DECnet logical link, an SNA circuit failure, or the re-
ceipt of an Unbind Type 2 from IBM. The OpenVMS
application is called at a notification entry point defined
by the application at connection time; an indication of
the event that occurred is reported.
SNA Functions
API provides OpenVMS applications with access to the
SNA functions performed by either an SNA gateway
or SNA server. These include SNA path control func-
tions, data link control functions, and upper-level func-
tions such as checking access information. API pro-
vides assistance with some functions such as brackets
and chaining. In addition, API supports negotiable binds
and handles exception responses for the user applica-
tion. For complete details about which SNA functions
are provided by this product, refer to the product docu-
mentation.
The application must provide the remaining SNA func-
tions it requires. For example, the application must be
designed to:
• Process all FMD layer protocols
• Take into account all data flow control and session
control request/response units
• Keep track of any "states" relevant to the application
• Translate between ASCII and EBCDIC, and vice
versa
• Parse the bind request
• Respond to request units
User Interface
Users of API should be experienced OpenVMS applica-
tion programmers. They can use any of the OpenVMS
programming languages that conform to the OpenVMS
Calling Standard to create application programs that in-
teract with application programs on an IBM system. The
user documentation provides example programs written
in the following languages:
• MACRO-32
• ADA
• BASIC
• BLISS
•C
• COBOL
• FORTRAN
• PASCAL
• PL/I
Users of this product should be familiar with SNA and
have some knowledge of the type of logical unit that will
be used.
INSTALLATION
Installation services from HP are recommended for
a customer’s first purchase of this software product.
These services provide for installation of the software
product by an experienced software specialist.
HARDWARE REQUIREMENTS
Processors Supported
• Itanium, Alpha and VAX configuration as specified in
the OpenVMS Operating System for I64, Alpha and
VAX Software Product Description (SPD 82.35.xx
and 25.01.xx).
Disk Space Requirements (Block Cluster Size = 1)
Disk space required for installation:
OpenVMS I64 19,122 blocks
(9.561 MB)
OpenVMS Alpha 18,000 blocks
(9.0 MB)
OpenVMS VAX 17,900 blocks
(9.0 MB)
2