OSI/AS Programming Manual

New and Changed Information
056783 Tandem Computers Incorporated iii
This is the third edition of the Tandem OSI/AS Programming Manual. This revision
reflects technical enhancements to the Tandem OSI product and includes some
organizational and content enhancements to the manual as well.
Product
Enhancements
The product enhancements described in this revision are as follows:
A major new feature, which you enable through the use of configuration
parameters, allows your application to reuse a subdevice from one connection to
the next. This type of subdevice is called a static subdevice. If your application
name is configured to use static subdevices, then calls to the APS_DISCARD_
procedure will discard the connection context but not the subdevice. If your
application name is configured to use dynamic subdevices, then calls to the
APS_DISCARD_ procedure will discard both the connection context and the
subdevice.
A new parameter ( subdevice-name ) has been added to the
APS_ASSOC_ATTACH_ and APS_ASSOC_CONNECTREQ_ procedures to enable
you to explicitly name a subdevice or to reuse a static subdevice.
A new procedure (APS_SUBDEVICE_DISCARD_) has been added to enable you
to discard a static subdevice.
Two new parameters ( transport-state and transport-substate ) have
been added to the APS_STATUS_ procedure to provide more information when a
connection attempt fails.
In addition to SINGLE-ASN1-TYPE format, you can now encode your data in
OCTET-ALIGNED format. This enables you to bundle multiple PDVs into a
single PDV-list.
In addition to specifiying data as a single structure, you can now chain it for the
data request and typed data request primitives.
A new parameter ( block-size ) has been added to the APS_DATA_REQ_,
APS_TYPEDATA_REQ_, and APS_EVENT_RECEIVE_ procedures to enable you
to choose how much space is used when sending or receiving data.
Several new error subcodes have been added.
Manual Enhancements The enhancements to the manual are as follows:
Descriptions of the status and error codes have been moved from Section 4 to an
appendix. Furthermore, those descriptions are now in ascending numerical order
by code number and they have been expanded to show the cause, effect, and
recommended recovery action for each code.
C versions of the sample program modules have been added to Appendix E.