OSI/AS Programming Manual

APS_ASSOC_ATTACH_
APS Procedure Calls
056783 Tandem Computers Incorporated 3–27
APS_ASSOC_ATTACH_ This procedure allows you to tell the OSI/AS subsystem that you are ready to
establish a session, presentation, or ACSE connection if a remote application requests
one. After the APS_ASSOC_ATTACH_ procedure has completed successfully, use the
APS_EVENT_RECEIVE_ procedure to wait for a connect indication to arrive.
To be able to accept more than one connect indication, call APS_ASSOC_ATTACH_
once for each connect indication you wish to accept.
For further information about the use of this procedure, see “Establishing a
Connection as the Responding User” in Section 2.
status := APS_ASSOC_ATTACH_ ( cepi ! O
, api-environment ! I
, local-appl ! I
,[ tag ] ! I
,[ service-id ] ! 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.
cepi output
INT .EXT:ref:1
is the connection endpoint identifier (CEPI) for this connection. If this procedure
call is successful, the interface generates a CEPI. If the procedure fails, the API
returns -1 in this parameter.
api-environment input
INT .EXT:ref:(ZAPS-DDL-ENVIRONMENT)
specifies the OSI/AS subsystem you wish to use (identified by its OSI manager
process name) and the wait mode.
local-appl input
INT .EXT:ref:(ZAPS-DDL-APPL-ADDR)
is the name and/or OSI address of your application. For more information about
this parameter, see “Considerations.”