Corporation Server User Manual

OCMS Parlay X Web Services 6-1
6
OCMS Parlay X Web Services
This chapter describes OCMS support for the Parlay X 2.0 Presence Web services
interfaces for developing applications. The Web service functions as a Presence
Network Agent which can publish, subscribe, and listen to notifies on behalf of the
users of the Web service. This chapter contains the following sections:
■ "Introduction"
■ "Installing the Web Services"
■ "Installing the Aggregation Proxy"
■ "Configuring Web Services with the Aggregation Proxy"
■ "Presence Web Services Interface Descriptions"
■ "Using the Presence Web Services Interfaces"
■ "OCMS Parlay X Presence Custom Error Codes"
Introduction
OCMS provides support for Part 14 of the Parlay X Presence Web Service as defined in
the Open Service Access, Parlay X Web Services, Part 14, Presence ETSI ES 202 391-14
specification. The OCMS Parlay X Web service maps the Parlay X Web service to a
SIP/IMS network according to the Open Service Access, Mapping of Parlay X Web
Services to Parlay/OSA APIs, Part 14, Presence Mapping, Subpart 2, Mapping to
SIP/IMS Networks, ETSI TR 102 397-14-2 specification.
The presence Web service communicates directly with IMS presence network elements
using the SIP/SIMPLE protocol interface, and uses the JSR-32 UAC framework to
communicate with the SIP network.
The HTTP server that hosts the presence Web service is a Presence Network Agent or
a Parlay X to SIP gateway.
Note: Due to the synchronous nature of the Web service, to receive a
callback from the Web service the client must implement the Web
service callback interface. For presence, the required interface is the
PresenceNotification interface described in Open Service Access,
Parlay X Web Services, Part 14, Presence ETSI ES 202 391-14.
Because this implementation is not common or practical for most Web
service architectures, the PresenceNotification interface is not
currently supported.