OSI/AS Programming Manual

APS_SUBDEVICE_DISCARD_
APS Procedure Calls
056783 Tandem Computers Incorporated 3–87
APS_SUBDEVICE_DISCARD_
This procedure discards a static subdevice.
status := APS_SUBDEVICE_DISCARD_ ( end-system-name ! I
, subdevice-name ); ! I
status returned value
INT
indicates the outcome of the call. For the possible values of ZAPS-VAL-STATUS-
xxx, see “Status Codes” in Appendix B.
end-system-name input
INT .EXT:ref:(ZAPS-DDL-FILENAME)
is the fully-qualified name of the OSI manager process, in internal format, that was
specified in the api-environment parameter of the APS_ASSOC_ATTACH_ or
APS_ASSOC_CONNECTREQ_ procedure call that created the subdevice.
subdevice-name input
INT .EXT:ref:(ZAPS-DDL-FILENAME)
is the fully-qualified name of the static subdevice (as retrieved from
APS_STATUS_ immediately after the call to APS_ASSOC_ATTACH_ or
APS_ASSOC_CONNECTREQ_ that originally created the subdevice).
The subdevice name is not in D-series format. Even if your application is running
on a D-series system, however, you need not convert the name, because it is used
only by your application and not by the Guardian 90 operating system.
Considerations
The procedures APS_DISCARD_ and APS_SUBDEVICE_DISCARD_ have distinct
functions. When your application is finished with a particular connection, it calls
APS_DISCARD_ to discard the connection context. If the subdevice associated
with the connection is a dynamic subdevice, then it is also discarded at that time; if
it is a static subdevice, however, then it is merely closed by APS_DISCARD_ and
remains available for reuse. When your application is completely finished using a
static subdevice, it calls APS_SUBDEVICE_DISCARD_ to discard the static
subdevice.
This procedure makes waited requests to OSI/AS processes.
If the returned status is ZAPS-VAL-STATUS-NO-RETRY and you want to know
error information, call APS_STATUS_ specifying a cepi parameter of -1.