NMS TUP provides two sets of functions:
Service functions
Management functions
The TUP service functions provide the application access to the TUP layer services. Applications invoke TUP services by calling TUP request functions that send a TUP message to a remote exchange or endpoint. Request function parameters are converted to messages for processing by the TUP task.
The TUP requests from the remote endpoints are presented to the application as indications, using the same driver and mechanisms through which confirmations are delivered. The application then issues a reply to the endpoint by invoking the appropriate TUP service response function.
All TUP service functions are asynchronous. Completion of the function implies only that the function was successfully initiated (a request message was queued to the TUP task). Errors detected by the TUP task result in asynchronous status indications being sent to the application. Successfully delivered requests generally result in no notification to the application until the far end takes some corresponding action such as returning a connect confirm message in response to a connection request.
Indication and confirmation messages, as well as status messages from the local TUP layer, are passed to application processes as asynchronous events. All events for a particular user service access point are delivered through the associated Natural Access queue. For more information about queues, refer to the Natural Access Developer's Reference Manual.
Applications detect that an event is pending through an operating system specific mechanism such as poll in UNIX or WaitForMultipleObjects in Windows. The application retrieves the event data (or message) through a function that also translates the confirmation parameters from SS7 TUP raw format to API format.
For more information, refer to the Using the TUP service function reference.
The TUP management functions manage the following TUP tasks on the board:
Configuration
Circuits
Statistics and status retrieval
For more information, refer to TUP management overview and the TUP management function reference section.