SIST ES 204 915-14 V1.1.1:2008

• Abstract:

  ETSI OSA APIs Phase 4. Based on ES 203 915 and the new requirements for OSA Phase 4, to produce ES 204 915 V1.1.1. ETSI OSA Phase 4 incorporates 3GPP OSA Release 7 and is also known as Parlay 6.0.The present document is part 14 of the Stage 3 specification for an Application Programming Interface (API) for Open Service Access (OSA).; The OSA specifications define an architecture that enables application developers to make use of network functionality through an open standardised interface, i.e. the OSA APIs.; The present document specifies the Presence and Availability Management Service Capability Feature (SCF) aspects of the interface. All aspects of the Presence and Availability Management SCF are defined here, these being:; • Sequence Diagrams.; • Class Diagrams.; • Interface specification plus detailed method descriptions.; • State Transition diagrams.; • Data Definitions.; • IDL Description of the interfaces.; The process by which this task is accomplished is through the use of object modelling techniques described by the Unified Modelling Language (UML).

• Status: Published
• Publication Date: 02-Jul-2008
• ICS: 35.100.01 - Open systems interconnection in general
• Technical Committee: SPN - Services and Protocols for Networks
• Current Stage: 6060 - National Implementation/Publication (Adopted Project)
• Start Date: 11-Jun-2008
• Due Date: 16-Aug-2008
• Completion Date: 03-Jul-2008
• Ref Project: ETSI ES 204 915-14 V1.1.1 (2008-05) - Open Service Access (OSA); Application Programming Interface (API); Part 14: Presence and Availability Management SCF (Parlay 6)

SIST ES 204 915-14 V1.1.1:2008 is the SIST version of the ETSI Open Service Access (OSA) API standard for Part 14, Presence and Availability Management SCF (Parlay 6). It specifies the Stage 3 interface for managing identities, agents, presence, availability, access control and event notifications through the OSA APIs. The document is aimed at application developers and platform implementers who need the UML-based service descriptions, data definitions and OMG IDL for PAM.

What does SIST ES 204 915-14 V1.1.1:2008 specify?

SIST ES 204 915-14 V1.1.1:2008 specifies the Presence and Availability Management Service Capability Feature (SCF) part of the OSA API family. It defines the service interfaces used to provision identities and agents, query and update presence and availability, and register for PAM events.

The document is organized as a full interface specification. Clauses 1 to 12 cover scope, references, definitions, the PAM concepts, sequence diagrams, class diagrams, service interface specifications, interface classes, service properties, data definitions and exception classes. Annexes add implementation views, alternate language bindings and related mappings.

Annex	What it covers
Annex A	Further PAM information, including UML models, architecture, access levels and illustrative use cases
Annex B	Normative OMG IDL description of the Presence and Availability Management SCF
Annex C	W3C WSDL description of the PAM SCFs
Annex D	Java API description of the PAM SCFs
Annex E	Contents of 3GPP OSA R7 Presence and Availability Management
Annex F	Description of PAM for 3GPP2 cdma2000 networks and the specific exceptions that apply
Annex G	Change summary for interfaces, methods, data definitions, service properties and exceptions

What are the key requirements of SIST ES 204 915-14 V1.1.1:2008?

SIST ES 204 915-14 V1.1.1:2008 is centered on three SCFs: PAM Provisioning, PAM Access and PAM Event. In practice, this means one part of the API creates and organizes identity data, another part exposes presence and availability, and a third part handles subscriptions and notifications.

The PAM model is built around identities, agents, presence, availability and events

Clause 4 defines the main concepts used throughout the specification: identity, agent, presence, availability and events. PAM treats these as separate but related ideas, which matters because the same person or organization may be represented differently across services, devices and namespaces.

Clause 4 also states the scope of PAM information. It covers identities, agent information, agent provisioning, presence information, availability information, notifications of changes, and security issues for access to that information. For a reader, this tells you what data PAM is meant to manage and what kind of data model the implementation needs to support.

Authentication tokens and asker data are used to control access and privacy

Clause 5 explains that PAM uses OSA Framework authentication plus an optional service-level credential for the requester. The same authorization token can be reused within a session, which reduces repeated authentication overhead when a client asks for several presence or availability operations.

The methods that need requester context accept TpPAMCredential, and getAuthToken() is used to obtain a reusable credential for that requester. In practice, this lets a gateway or service act on behalf of multiple end users while still supplying the correct requester identity for privacy decisions.

PAM Provisioning manages identities, agents, types, attributes and assignments

Clause 8.1 defines the provisioning interfaces. IpPAMIdentityManagement covers creating and deleting identities, group identities, aliases, membership and type associations; IpPAMAgentManagement does the same for agents and agent capabilities; IpPAMAgentAssignment links agents to identities; and the type-management interfaces define identity types, agent types and capabilities.

This matters because PAM provisioning is not just a directory of names. The specification also supports attributes, typed profiles and relationships between identities and agents, so implementers need to model how information is grouped, inherited and queried.

PAM Access exposes identity presence, agent presence and availability

Clause 8.2 defines the access interfaces. IpPAMIdentityPresence updates and retrieves presence for identities, IpPAMAgentPresence does the same for agents and capabilities, and IpPAMAvailability handles availability preferences and availability queries in a given context.

Clause 8.2 also includes IpAppPAMPreferenceCheck, which lets an application participate in availability computation. In practice, this means an implementation can consult external business logic or policy when deciding what availability should be returned to a requester.

PAM Event supports registration and notification of presence-related changes

Clause 8.3 defines the event service. IpPAMEventHandler registers and deregisters application interfaces and event subscriptions, while IpAppPAMEventHandler receives eventNotify() and eventNotifyErr() callbacks.

This is the part to use when a system needs push notifications rather than polling. The event model covers changes such as identity creation or deletion, group membership changes, agent creation or deletion, capability changes, presence updates, availability changes and watcher changes.

Service properties and supported data are constrained at the platform level

Clause 10 defines PAM service properties, including obtainable interfaces and supported attribute and XML-related capabilities. It also states minimum support for the PAM APIs and identifies the interfaces obtainable from PAM Access in the 3GPP case.

For a buyer or implementer, this clause is important because it tells you what a compliant platform must advertise and what data types it has to handle. It also signals that some methods and interfaces may be optional in an implementation, with P_METHOD_NOT_SUPPORTED returned when a method is not supported.

Clause 11 pre-defines key types and event data structures

Clause 11 defines the data used by the interfaces. It includes entity address types, attribute lists, presence and capability data, availability profiles, context data, credentials, access control and preference structures, interface names, event names and notification payloads.

The clause also pre-defines the Presentity identity type and lists dynamic attributes associated with it, including subscriber status, network status, communication means, contact address, location-related fields, priority and other information. This is the core data model that implementers need to map to their own directories, databases or network services.

Clause 12 defines the exception classes used by PAM operations

Clause 12 lists the exception classes returned by the PAM interfaces, including cases for existing identities or agents, unknown identities, groups, aliases or capabilities, invalid credentials, unsupported methods, unregistered interfaces and inconsistent assignments or types.

In practice, these exception names are part of the API contract. Application code and test cases need to handle them explicitly when creating identities, assigning agents, setting attributes or subscribing to events.

What terms does SIST ES 204 915-14 V1.1.1:2008 define?

SIST ES 204 915-14 V1.1.1:2008 uses a small set of core terms to describe the API model and its data types.

• Open Service Access (OSA) - the architecture that lets application developers use network functionality through an open standardized interface.
• Service Capability Feature (SCF) - the functional part of OSA covered by this standard, here focused on Presence and Availability Management.
• Presence and Availability Management (PAM) - the set of interfaces for maintaining, retrieving, publishing and subscribing to identity, presence and availability information.
• Unified Modelling Language (UML) - the object-modelling notation used to define the class diagrams, sequence diagrams and other models in the standard.
• Presentity - the pre-defined identity type used by PAM for all identities, aligned with the IETF presence model.
• TpPAMCredential - the credential object passed to methods so the platform can identify the requester and apply access control and privacy rules.
• TpPAMContext - the availability context used when asking for availability, with communication as the pre-defined context in this document.

Who uses SIST ES 204 915-14 V1.1.1:2008?

SIST ES 204 915-14 V1.1.1:2008 is used by teams building or integrating OSA/PAM services, such as application developers, service platform implementers, gateway vendors and network service providers. It is also relevant to enterprise communications teams that manage presence, availability and policy across multiple services.

The document is directly relevant to systems that expose or consume presence and availability information for instant messaging, e-mail, fax, telephony, conferencing and similar communication services. Annex A also shows use in third-party end-user management, enterprise administration, namespace federation and the controlled export of identity or status information.

What changed in SIST ES 204 915-14 V1.1.1:2008 from the previous edition?

SIST ES 204 915-14 V1.1.1:2008 was produced from ES 203 915 with the new requirements for OSA Phase 4. The foreword says that OSA Phase 4 incorporates 3GPP OSA Release 7 and is also known as Parlay 6.0.

The foreword also notes that the document was defined jointly by ETSI, The Parlay Group and 3GPP, and that a subset appears in 3GPP TS 29.198-14 V7.0.0.

Which standards are used with SIST ES 204 915-14 V1.1.1:2008?

SIST ES 204 915-14 V1.1.1:2008 refers to ETSI ES 204 915-1 for the common definitions used in clauses 2 and 3, and it points to ES 204 915-2 for common data definitions used by types not defined in clause 11. It also aligns with the IETF presence model in RFC 2778.

The foreword and annexes place this part in the wider OSA family, including the related ES 204 915 parts, and note a subset in 3GPP TS 29.198-14 V7.0.0.

What does the SIST ES 204 915-14 V1.1.1:2008 document contain?

SIST ES 204 915-14 V1.1.1:2008 contains the UML-based specification of PAM service and application interfaces, including class diagrams, sequence diagrams and method descriptions. It also contains the data model for identities, agents, capabilities, presence, availability, context, credentials, preferences, events and exceptions.

The document includes a normative OMG IDL description in Annex B, plus informative WSDL and Java API descriptions in Annexes C and D. Annex A gives architecture views, access levels and use cases, while Annex F adapts the content to 3GPP2 cdma2000 network context and Annex G summarizes the evolution of interfaces, methods and data definitions.

Final draft ETSI ES 204 915-14 V1.1.1 (2008-02)
ETSI Standard
Open Service Access (OSA);
Application Programming Interface (API);
Part 14: Presence and Availability Management SCF
(Parlay 6)
�
2 Final draft ETSI ES 204 915-14 V1.1.1 (2008-02)

Reference
DES/TISPAN-01032-14-OSA
Keywords
API, IDL, OSA, UML
ETSI
650 Route des Lucioles
F-06921 Sophia Antipolis Cedex - FRANCE

Tel.: [phone]  Fax: [phone]

Siret N° 348 623 562 00017 - NAF 742 C
Association à but non lucratif enregistrée à la
Sous-Préfecture de Grasse (06) N° 7803/88

Important notice
Individual copies of the present document can be downloaded from:
http://www.etsi.org
The present document may be made available in more than one electronic version or in print. In any case of existing or
perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF).
In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive
within ETSI Secretariat.
Users of the present document should be aware that the document may be subject to revision or change of status.
Information on the current status of this and other ETSI documents is available at
http://portal.etsi.org/tb/status/status.asp
If you find errors in the present document, please send your comment to one of the following services:
http://portal.etsi.org/chaircor/ETSI_support.asp
Copyright Notification
No part may be reproduced except as authorized by written permission.
The copyright and the foregoing restriction extend to reproduction in all media.

© European Telecommunications Standards Institute 2008.
© The Parlay Group 2008.
All rights reserved.
TM TM TM TM
DECT , PLUGTESTS , UMTS , TIPHON , the TIPHON logo and the ETSI logo are Trade Marks of ETSI registered
for the benefit of its Members.
TM
3GPP is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners.
ETSI
3 Final draft ETSI ES 204 915-14 V1.1.1 (2008-02)
Contents
Intellectual Property Rights.9
Foreword.9
1 Scope.10
2 References.10
3 Definitions and abbreviations.10
3.1 Definitions.10
3.2 Abbreviations.10
4 Presence and Availability Management SCF.11
4.1 Introduction.11
4.2 Motivation.11
4.3 Goals.11
4.4 Concepts.12
4.4.1 Identity.12
4.4.2 Agent.12
4.4.3 Presence.13
4.4.4 Availability .14
4.4.5 Events.15
4.5 Scope of PAM information .15
4.6 Security and privacy.15
5 Sequence Diagrams.16
5.1 Use of authentication tokens .17
5.2 Event registration and notification .18
6 Class Diagrams.18
6.1 PAM Provisioning SCF Class Diagrams.19
6.2 PAM Access SCF Class Diagrams.20
6.3 PAM Event SCF Class Diagrams.21
7 The Service Interface Specifications.22
7.1 Interface Specification Format .22
7.1.1 Interface Class.22
7.1.2 Method descriptions.22
7.1.3 Parameter descriptions.23
7.1.4 State Model.23
7.2 Base Interface.23
7.2.1 Interface Class IpInterface .23
7.3 Service Interfaces.23
7.3.1 Overview.23
7.4 Generic Service Interface .23
7.4.1 Interface Class IpService .23
7.4.1.1 Method setCallback().24
7.4.1.2 Method setCallbackWithSessionID().24
8 Presence and Availability Management Interface Classes.24
8.1 PAM Provisioning SCF Interface Classes.25
8.1.1 Interface Class IpPAMProvisioningManager .25
8.1.1.1 Method getAuthToken().25
8.1.1.2 Method obtainInterface().26
8.1.1.3 Method getAccessControl().26
8.1.1.4 Method setAccessControl().26
8.1.2 Interface Class IpPAMIdentityManagement .27
8.1.2.1 Method createIdentity().28
8.1.2.2 Method deleteIdentity().28
8.1.2.3 Method isIdentity().29
ETSI
4 Final draft ETSI ES 204 915-14 V1.1.1 (2008-02)
8.1.2.4 Method createGroupIdentity().29
8.1.2.5 Method deleteGroupIdentity().29
8.1.2.6 Method addToGroup().30
8.1.2.7 Method removeFromGroup().30
8.1.2.8 Method listMembers().30
8.1.2.9 Method isGroupIdentity().31
8.1.2.10 Method listGroupMembership().31
8.1.2.11 Method addAlias().32
8.1.2.12 Method removeAliases().32
8.1.2.13 Method listAliases().32
8.1.2.14 Method lookupByAlias().33
8.1.2.15 Method associateTypes().33
8.1.2.16 Method disassociateTypes().33
8.1.2.17 Method listTypesOfIdentity().34
8.1.2.18 Method hasType().34
8.1.2.19 Method getIdentityAttributes().35
8.1.2.20 Method setIdentityAttributes().35
8.1.3 Interface Class IpPAMAgentManagement .36
8.1.3.1 Method createAgent().37
8.1.3.2 Method deleteAgent().37
8.1.3.3 Method isAgent().37
8.1.3.4 Method enableCapabilities() .38
8.1.3.5 Method disableCapabilities() .38
8.1.3.6 Method listEnabledCapabilities().38
8.1.3.7 Method listAllCapabilities().39
8.1.3.8 Method isCapableOf().39
8.1.3.9 Method associateTypes().39
8.1.3.10 Method disassociateTypes().40
8.1.3.11 Method listTypesOfAgent().40
8.1.3.12 Method hasType().41
8.1.3.13 Method getAgentAttributes().41
8.1.3.14 Method setAgentAttributes().42
8.1.4 Interface Class IpPAMAgentAssignment.42
8.1.4.1 Method assignAgent().43
8.1.4.2 Method unassignAgent().43
8.1.4.3 Method listAssignedAgents().44
8.1.4.4 Method listAssociatedIdentitiesOfAgent().44
8.1.4.5 Method listAssignedAgentsByCapability() .45
8.1.4.6 Method listCapabilitiesOfIdentity() .45
8.1.4.7 Method isIdentityCapableOf().45
8.1.5 Interface Class IpPAMIdentityTypeManagement .46
8.1.5.1 Method createIdentityAttribute().46
8.1.5.2 Method deleteIdentityAttribute().47
8.1.5.3 Method getIdentityAttributeDefinition().47
8.1.5.4 Method listAllIdentityAttributes().47
8.1.5.5 Method createIdentityType().48
8.1.5.6 Method deleteIdentityType().48
8.1.5.7 Method listIdentityTypes().48
8.1.5.8 Method addIdentityTypeAttributes().49
8.1.5.9 Method removeIdentityTypeAttributes().49
8.1.5.10 Method listIdentityTypeAttributes().49
8.1.6 Interface Class IpPAMAgentTypeManagement .50
8.1.6.1 Method createAgentAttribute().50
8.1.6.2 Method deleteAgentAttribute().51
8.1.6.3 Method getAgentAttributeDefinition().51
8.1.6.4 Method listAllAgentAttributes().51
8.1.6.5 Method createAgentType().52
8.1.6.6 Method deleteAgentType().52
8.1.6.7 Method listAgentTypes().52
8.1.6.8 Method addAgentTypeAttributes().52
8.1.6.9 Method removeAgentTypeAttributes().53
8.1.6.10 Method listAgentTypeAttributes().53
ETSI
5 Final draft ETSI ES 204 915-14 V1.1.1 (2008-02)
8.1.7 Interface Class IpPAMCapabilityManagement .54
8.1.7.1 Method createCapabilityAttribute().54
8.1.7.2 Method deleteCapabilityAttribute().55
8.1.7.3 Method getCapabilityAttributeDefinition().55
8.1.7.4 Method listAllCapabilityAttributes() .55
8.1.7.5 Method createCapability().56
8.1.7.6 Method deleteCapability().56
8.1.7.7 Method listCapabilities().56
8.1.7.8 Method addCapabilityAttributes().57
8.1.7.9 Method removeCapabilityAttributes().57
8.1.7.10 Method listCapabilityAttributes().57
8.1.7.11 Method assignCapabilitiesToType() .58
8.1.7.12 Method unassignCapabilitiesFromType().58
8.1.7.13 Method listCapabilitiesOfType() .58
8.2 PAM Access SCF Interface Classes.59
8.2.1 Interface Class IpPAMPresenceAvailabilityManager .59
8.2.1.1 Method getAuthToken().59
8.2.1.2 Method obtainInterface().60
8.2.1.3 Method getAccessControl().60
8.2.1.4 Method setAccessControl().61
8.2.1.5 Method activateService().61
8.2.1.6 Method deactivateService().61
8.2.1.7 Method isActiveIdentity().62
8.2.2 Interface Class IpPAMIdentityPresence .62
8.2.2.1 Method setIdentityPresence().63
8.2.2.2 Method setIdentityPresenceExpiration().63
8.2.2.3 Method getIdentityPresence().63
8.2.3 Interface Class IpPAMAvailability.64
8.2.3.1 Method getAvailability().65
8.2.3.2 Method getPreference().66
8.2.3.3 Method setPreference().66
8.2.4 Interface Class IpPAMAgentPresence.67
8.2.4.1 Method setAgentPresence().67
8.2.4.2 Method setCapabilityPresence().68
8.2.4.3 Method setAgentPresenceExpiration().68
8.2.4.4 Method setCapabilityPresenceExpiration().69
8.2.4.5 Method getAgentPresence().69
8.2.4.6 Method getCapabilityPresence().70
8.2.5 Interface Class IpAppPAMPreferenceCheck.70
8.2.5.1 Method computeAvailability().70
8.3 PAM Event SCF Interface Classes.71
8.3.1 Interface Class IpPAMEventManager .71
8.3.1.1 Method getAuthToken().72
8.3.1.2 Method obtainInterface().72
8.3.1.3 Method getAccessControl().73
8.3.1.4 Method setAccessControl().73
8.3.1.5 Method activateService().74
8.3.1.6 Method deactivateService().74
8.3.1.7 Method isActiveIdentity().74
8.3.2 Interface Class IpPAMEventHandler.75
8.3.2.1 Method isRegistered().75
8.3.2.2 Method registerAppInterface().76
8.3.2.3 Method registerForEvent().76
8.3.2.4 Method deregisterAppInterface().76
8.3.2.5 Method deregisterFromEvent().77
8.3.3 Interface Class IpAppPAMEventHandler.77
8.3.3.1 Method eventNotify().77
8.3.3.2 Method eventNotifyErr().78
9 State Transition Diagrams.78
10 PAM Service Properties .78
ETSI
6 Final draft ETSI ES 204 915-14 V1.1.1 (2008-02)
10.1 PAM Access Service .79
10.2 PAM Event Service.79
11 PAM Data Definitions.79
11.1 Entity Address Definitions.79
11.1.1 TpPAMFQName.79
11.1.2 TpPAMFQNameList.79
11.2 Attribute Data Definitions .79
11.2.1 TpPAMAttribute.79
11.2.2 TpPAMAttributeList.79
11.2.3 TpPAMAttributeDef.80
11.2.4 TpPAMAttributeDefList.80
11.3 Presence Data Definitions .80
11.3.1 TpPAMCapability.80
11.3.2 TpPAMCapabilityList.80
11.3.3 TpPAMPresenceData.80
11.3.4 TpPAMPresenceDataList.81
11.4 Pre-defined Presence type .81
11.4.1 Presentity.81
11.5 Availability Data Definitions .81
11.5.1 TpPAMAvailabilityProfile.81
11.5.2 TpPAMAvailabilityProfileList.81
11.5.3 TpPAMPrivacyCode.81
11.6 Availability Context Data Definitions.81
11.6.1 TpPAMContext.82
11.6.2 TpPAMContextName.82
11.6.3 TpPAMContextData.82
11.6.4 TpPAMCommunicationContext.82
11.6.5 TpPAMContextList.82
11.7 Credential data definitions.83
11.7.1 TpPAMCredential.83
11.8 Availability and Access Control Preference Data Definitions .83
11.8.1 IpAppPAMPreferenceCheckRef.83
11.8.2 TpPAMAccessControlData.83
11.8.3 TpPAMACLDefault.83
11.8.4 TpPAMPreferenceOp.83
11.8.5 TpPAMPreferenceType.84
11.8.6 TpPAMPreferenceData.84
11.9 Time data definitions.84
11.9.1 TpPAMTimeInterval.84
11.10 Pre-defined Entity Types and Attributes .84
11.11 Interface name definitions.85
11.11.1 TpPAMProvisioningInterfaceName.85
11.11.2 TpPAMPresenceAvailabilityInterfaceName.85
11.11.3 TpPAMEventInterfaceName.85
11.12 Event data definitions.86
11.12.1 IpAppPAMEventHandlerRef.86
11.12.2 TpPAMClientID.86
11.12.3 TpPAMEventID.86
11.12.4 TpPAMEventName.86
11.12.5 TpPAMEventNameList.86
11.12.6 TpPAMEventInfo.86
11.12.7 TpPAMEventInfoList.87
11.12.8 TpPAMNotificationInfo.87
11.12.9 TpPAMNotificationInfoList.87
11.12.10 PAM_CE_IDENTITY_CREATED.87
11.12.10.1 TpPAMICEventData.88
11.12.10.2 TpPAMICNotificationData.88
11.12.11 PAM_CE_IDENTITY_DELETED.88
11.12.11.1 TpPAMIDEventData.88
11.12.11.2 TpPAMIDNotificationData.88
11.12.12 PAM_CE_GROUP_MEMBERSHIP_CHANGED.88
ETSI
7 Final draft ETSI ES 204 915-14 V1.1.1 (2008-02)
11.12.12.1 TpPAMGMCEventData.89
11.12.12.2 TpPAMGMCNotificationData.89
11.12.13 PAM_CE_AGENT_CREATED.89
11.12.13.1 TpPAMACEventData.89
11.12.13.2 TpPAMACNotificationData.89
11.12.14 PAM_CE_AGENT_DELETED.89
11.12.14.1 TpPAMADEventData.90
11.12.14.2 TpPAMADNotificationData.90
11.12.15 PAM_CE_AGENT_ASSIGNED.90
11.12.15.1 TpPAMAAEventData.90
11.12.15.2 TpPAMAANotificationData.91
11.12.16 PAM_CE_AGENT_UNASSIGNED.91
11.12.16.1 TpPAMAUEventData.91
11.12.16.2 TpPAMAUNotificationData.91
11.12.17 PAM_CE_CAPABILITY_CHANGED.91
11.12.17.1 TpPAMCCEventData.92
11.12.17.2 TpPAMCCNotificationData.92
11.12.18 PAM_CE_AGENT_CAPABILITY_PRESENCE_SET.92
11.12.18.1 TpPAMACPSEventData.92
11.12.18.2 TpPAMACPSNotificationData.93
11.12.19 PAM_CE_AGENT_PRESENCE_SET.93
11.12.19.1 TpPAMAPSEventData.93
11.12.19.2 TpPAMAPSNotificationData.93
11.12.20 PAM_CE_IDENTITY_PRESENCE_SET.93
11.12.20.1 TpPAMIPSEventData.94
11.12.20.2 TpPAMIPSNotificationData.94
11.12.21 PAM_CE_AVAILABILITY_CHANGED.94
11.12.21.1 TpPAMAVCEventData.94
11.12.21.2 TpPAMAVCNotificationData.95
11.12.22 PAM_CE_WATCHERS_CHANGED.95
11.12.22.1 TpPAMWCEventData.95
11.12.22.2 TpPAMWCNotificationData.96
11.12.22.3 TpPAMwatcherChangeType.96
11.13 Error Types.96
11.13.1 TpPAMErrorCause.96
11.13.2 TpPAMErrorInfo .96
12 Presence and Availability Management Exception Classes.97
Annex A (informative): Further PAM Information.98
A.1 UML Models.98
A.1.1 Identity.98
A.1.2 Agent.99
A.2 Model.
...

ETSI Standard
Open Service Access (OSA);
Application Programming Interface (API);
Part 14: Presence and Availability Management SCF
(Parlay 6)
�
2 ETSI ES 204 915-14 V1.1.1 (2008-05)

Reference
DES/TISPAN-01032-14-OSA
Keywords
API, IDL, OSA, UML
ETSI
650 Route des Lucioles
F-06921 Sophia Antipolis Cedex - FRANCE

Tel.: [phone]  Fax: [phone]

Siret N° 348 623 562 00017 - NAF 742 C
Association à but non lucratif enregistrée à la
Sous-Préfecture de Grasse (06) N° 7803/88

Important notice
Individual copies of the present document can be downloaded from:
http://www.etsi.org
The present document may be made available in more than one electronic version or in print. In any case of existing or
perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF).
In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive
within ETSI Secretariat.
Users of the present document should be aware that the document may be subject to revision or change of status.
Information on the current status of this and other ETSI documents is available at
http://portal.etsi.org/tb/status/status.asp
If you find errors in the present document, please send your comment to one of the following services:
http://portal.etsi.org/chaircor/ETSI_support.asp
Copyright Notification
No part may be reproduced except as authorized by written permission.
The copyright and the foregoing restriction extend to reproduction in all media.

© European Telecommunications Standards Institute 2008.
© The Parlay Group 2008.
All rights reserved.
TM TM TM TM
DECT , PLUGTESTS , UMTS , TIPHON , the TIPHON logo and the ETSI logo are Trade Marks of ETSI registered
for the benefit of its Members.
TM
3GPP is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners.
ETSI
3 ETSI ES 204 915-14 V1.1.1 (2008-05)
Contents
Intellectual Property Rights.9
Foreword.9
1 Scope.10
2 References.10
3 Definitions and abbreviations.10
3.1 Definitions.10
3.2 Abbreviations.10
4 Presence and Availability Management SCF.11
4.1 Introduction.11
4.2 Motivation.11
4.3 Goals.11
4.4 Concepts.12
4.4.1 Identity.12
4.4.2 Agent.12
4.4.3 Presence.13
4.4.4 Availability .14
4.4.5 Events.15
4.5 Scope of PAM information .15
4.6 Security and privacy.15
5 Sequence Diagrams.16
5.1 Use of authentication tokens .17
5.2 Event registration and notification .18
6 Class Diagrams.18
6.1 PAM Provisioning SCF Class Diagrams.19
6.2 PAM Access SCF Class Diagrams.20
6.3 PAM Event SCF Class Diagrams.21
7 The Service Interface Specifications.22
7.1 Interface Specification Format .22
7.1.1 Interface Class.22
7.1.2 Method descriptions.22
7.1.3 Parameter descriptions.23
7.1.4 State Model.23
7.2 Base Interface.23
7.2.1 Interface Class IpInterface .23
7.3 Service Interfaces.23
7.3.1 Overview.23
7.4 Generic Service Interface .23
7.4.1 Interface Class IpService .23
7.4.1.1 Method setCallback().24
7.4.1.2 Method setCallbackWithSessionID().24
8 Presence and Availability Management Interface Classes.24
8.1 PAM Provisioning SCF Interface Classes.25
8.1.1 Interface Class IpPAMProvisioningManager .25
8.1.1.1 Method getAuthToken().25
8.1.1.2 Method obtainInterface().26
8.1.1.3 Method getAccessControl().26
8.1.1.4 Method setAccessControl().26
8.1.2 Interface Class IpPAMIdentityManagement .27
8.1.2.1 Method createIdentity().28
8.1.2.2 Method deleteIdentity().28
8.1.2.3 Method isIdentity().29
ETSI
4 ETSI ES 204 915-14 V1.1.1 (2008-05)
8.1.2.4 Method createGroupIdentity().29
8.1.2.5 Method deleteGroupIdentity().29
8.1.2.6 Method addToGroup().30
8.1.2.7 Method removeFromGroup().30
8.1.2.8 Method listMembers().30
8.1.2.9 Method isGroupIdentity().31
8.1.2.10 Method listGroupMembership().31
8.1.2.11 Method addAlias().32
8.1.2.12 Method removeAliases().32
8.1.2.13 Method listAliases().32
8.1.2.14 Method lookupByAlias().33
8.1.2.15 Method associateTypes().33
8.1.2.16 Method disassociateTypes().33
8.1.2.17 Method listTypesOfIdentity().34
8.1.2.18 Method hasType().34
8.1.2.19 Method getIdentityAttributes().35
8.1.2.20 Method setIdentityAttributes().35
8.1.3 Interface Class IpPAMAgentManagement .36
8.1.3.1 Method createAgent().37
8.1.3.2 Method deleteAgent().37
8.1.3.3 Method isAgent().37
8.1.3.4 Method enableCapabilities() .38
8.1.3.5 Method disableCapabilities() .38
8.1.3.6 Method listEnabledCapabilities().38
8.1.3.7 Method listAllCapabilities().39
8.1.3.8 Method isCapableOf().39
8.1.3.9 Method associateTypes().39
8.1.3.10 Method disassociateTypes().40
8.1.3.11 Method listTypesOfAgent().40
8.1.3.12 Method hasType().41
8.1.3.13 Method getAgentAttributes().41
8.1.3.14 Method setAgentAttributes().42
8.1.4 Interface Class IpPAMAgentAssignment.42
8.1.4.1 Method assignAgent().43
8.1.4.2 Method unassignAgent().43
8.1.4.3 Method listAssignedAgents().44
8.1.4.4 Method listAssociatedIdentitiesOfAgent().44
8.1.4.5 Method listAssignedAgentsByCapability() .45
8.1.4.6 Method listCapabilitiesOfIdentity() .45
8.1.4.7 Method isIdentityCapableOf().45
8.1.5 Interface Class IpPAMIdentityTypeManagement .46
8.1.5.1 Method createIdentityAttribute().46
8.1.5.2 Method deleteIdentityAttribute().47
8.1.5.3 Method getIdentityAttributeDefinition().47
8.1.5.4 Method listAllIdentityAttributes().47
8.1.5.5 Method createIdentityType().48
8.1.5.6 Method deleteIdentityType().48
8.1.5.7 Method listIdentityTypes().48
8.1.5.8 Method addIdentityTypeAttributes().49
8.1.5.9 Method removeIdentityTypeAttributes().49
8.1.5.10 Method listIdentityTypeAttributes().49
8.1.6 Interface Class IpPAMAgentTypeManagement .50
8.1.6.1 Method createAgentAttribute().50
8.1.6.2 Method deleteAgentAttribute().51
8.1.6.3 Method getAgentAttributeDefinition().51
8.1.6.4 Method listAllAgentAttributes().51
8.1.6.5 Method createAgentType().52
8.1.6.6 Method deleteAgentType().52
8.1.6.7 Method listAgentTypes().52
8.1.6.8 Method addAgentTypeAttributes().52
8.1.6.9 Method removeAgentTypeAttributes().53
8.1.6.10 Method listAgentTypeAttributes().53
ETSI
5 ETSI ES 204 915-14 V1.1.1 (2008-05)
8.1.7 Interface Class IpPAMCapabilityManagement .54
8.1.7.1 Method createCapabilityAttribute().54
8.1.7.2 Method deleteCapabilityAttribute().55
8.1.7.3 Method getCapabilityAttributeDefinition().55
8.1.7.4 Method listAllCapabilityAttributes() .55
8.1.7.5 Method createCapability().56
8.1.7.6 Method deleteCapability().56
8.1.7.7 Method listCapabilities().56
8.1.7.8 Method addCapabilityAttributes().57
8.1.7.9 Method removeCapabilityAttributes().57
8.1.7.10 Method listCapabilityAttributes().57
8.1.7.11 Method assignCapabilitiesToType() .58
8.1.7.12 Method unassignCapabilitiesFromType().58
8.1.7.13 Method listCapabilitiesOfType() .58
8.2 PAM Access SCF Interface Classes.59
8.2.1 Interface Class IpPAMPresenceAvailabilityManager .59
8.2.1.1 Method getAuthToken().59
8.2.1.2 Method obtainInterface().60
8.2.1.3 Method getAccessControl().60
8.2.1.4 Method setAccessControl().61
8.2.1.5 Method activateService().61
8.2.1.6 Method deactivateService().61
8.2.1.7 Method isActiveIdentity().62
8.2.2 Interface Class IpPAMIdentityPresence .62
8.2.2.1 Method setIdentityPresence().63
8.2.2.2 Method setIdentityPresenceExpiration().63
8.2.2.3 Method getIdentityPresence().63
8.2.3 Interface Class IpPAMAvailability.64
8.2.3.1 Method getAvailability().65
8.2.3.2 Method getPreference().66
8.2.3.3 Method setPreference().66
8.2.4 Interface Class IpPAMAgentPresence.67
8.2.4.1 Method setAgentPresence().67
8.2.4.2 Method setCapabilityPresence().68
8.2.4.3 Method setAgentPresenceExpiration().68
8.2.4.4 Method setCapabilityPresenceExpiration().69
8.2.4.5 Method getAgentPresence().69
8.2.4.6 Method getCapabilityPresence().70
8.2.5 Interface Class IpAppPAMPreferenceCheck.70
8.2.5.1 Method computeAvailability().70
8.3 PAM Event SCF Interface Classes.71
8.3.1 Interface Class IpPAMEventManager .71
8.3.1.1 Method getAuthToken().72
8.3.1.2 Method obtainInterface().72
8.3.1.3 Method getAccessControl().73
8.3.1.4 Method setAccessControl().73
8.3.1.5 Method activateService().74
8.3.1.6 Method deactivateService().74
8.3.1.7 Method isActiveIdentity().74
8.3.2 Interface Class IpPAMEventHandler.75
8.3.2.1 Method isRegistered().75
8.3.2.2 Method registerAppInterface().76
8.3.2.3 Method registerForEvent().76
8.3.2.4 Method deregisterAppInterface().76
8.3.2.5 Method deregisterFromEvent().77
8.3.3 Interface Class IpAppPAMEventHandler.77
8.3.3.1 Method eventNotify().77
8.3.3.2 Method eventNotifyErr().78
9 State Transition Diagrams.78
10 PAM Service Properties .78
ETSI
6 ETSI ES 204 915-14 V1.1.1 (2008-05)
10.1 PAM Access Service .79
10.2 PAM Event Service.79
11 PAM Data Definitions.79
11.1 Entity Address Definitions.79
11.1.1 TpPAMFQName.79
11.1.2 TpPAMFQNameList.79
11.2 Attribute Data Definitions .79
11.2.1 TpPAMAttribute.79
11.2.2 TpPAMAttributeList.79
11.2.3 TpPAMAttributeDef.80
11.2.4 TpPAMAttributeDefList.80
11.3 Presence Data Definitions .80
11.3.1 TpPAMCapability.80
11.3.2 TpPAMCapabilityList.80
11.3.3 TpPAMPresenceData.80
11.3.4 TpPAMPresenceDataList.81
11.4 Pre-defined Presence type .81
11.4.1 Presentity.81
11.5 Availability Data Definitions .81
11.5.1 TpPAMAvailabilityProfile.81
11.5.2 TpPAMAvailabilityProfileList.81
11.5.3 TpPAMPrivacyCode.81
11.6 Availability Context Data Definitions.81
11.6.1 TpPAMContext.82
11.6.2 TpPAMContextName.82
11.6.3 TpPAMContextData.82
11.6.4 TpPAMCommunicationContext.82
11.6.5 TpPAMContextList.82
11.7 Credential data definitions.83
11.7.1 TpPAMCredential.83
11.8 Availability and Access Control Preference Data Definitions .83
11.8.1 IpAppPAMPreferenceCheckRef.83
11.8.2 TpPAMAccessControlData.83
11.8.3 TpPAMACLDefault.83
11.8.4 TpPAMPreferenceOp.83
11.8.5 TpPAMPreferenceType.84
11.8.6 TpPAMPreferenceData.84
11.9 Time data definitions.84
11.9.1 TpPAMTimeInterval.84
11.10 Pre-defined Entity Types and Attributes .84
11.11 Interface name definitions.85
11.11.1 TpPAMProvisioningInterfaceName.85
11.11.2 TpPAMPresenceAvailabilityInterfaceName.85
11.11.3 TpPAMEventInterfaceName.85
11.12 Event data definitions.86
11.12.1 IpAppPAMEventHandlerRef.86
11.12.2 TpPAMClientID.86
11.12.3 TpPAMEventID.86
11.12.4 TpPAMEventName.86
11.12.5 TpPAMEventNameList.86
11.12.6 TpPAMEventInfo.86
11.12.7 TpPAMEventInfoList.87
11.12.8 TpPAMNotificationInfo.87
11.12.9 TpPAMNotificationInfoList.87
11.12.10 PAM_CE_IDENTITY_CREATED.87
11.12.10.1 TpPAMICEventData.88
11.12.10.2 TpPAMICNotificationData.88
11.12.11 PAM_CE_IDENTITY_DELETED.88
11.12.11.1 TpPAMIDEventData.88
11.12.11.2 TpPAMIDNotificationData.88
11.12.12 PAM_CE_GROUP_MEMBERSHIP_CHANGED.88
ETSI
7 ETSI ES 204 915-14 V1.1.1 (2008-05)
11.12.12.1 TpPAMGMCEventData.89
11.12.12.2 TpPAMGMCNotificationData.89
11.12.13 PAM_CE_AGENT_CREATED.89
11.12.13.1 TpPAMACEventData.89
11.12.13.2 TpPAMACNotificationData.89
11.12.14 PAM_CE_AGENT_DELETED.89
11.12.14.1 TpPAMADEventData.90
11.12.14.2 TpPAMADNotificationData.90
11.12.15 PAM_CE_AGENT_ASSIGNED.90
11.12.15.1 TpPAMAAEventData.90
11.12.15.2 TpPAMAANotificationData.91
11.12.16 PAM_CE_AGENT_UNASSIGNED.91
11.12.16.1 TpPAMAUEventData.91
11.12.16.2 TpPAMAUNotificationData.91
11.12.17 PAM_CE_CAPABILITY_CHANGED.91
11.12.17.1 TpPAMCCEventData.92
11.12.17.2 TpPAMCCNotificationData.92
11.12.18 PAM_CE_AGENT_CAPABILITY_PRESENCE_SET.92
11.12.18.1 TpPAMACPSEventData.92
11.12.18.2 TpPAMACPSNotificationData.93
11.12.19 PAM_CE_AGENT_PRESENCE_SET.93
11.12.19.1 TpPAMAPSEventData.93
11.12.19.2 TpPAMAPSNotificationData.93
11.12.20 PAM_CE_IDENTITY_PRESENCE_SET.93
11.12.20.1 TpPAMIPSEventData.94
11.12.20.2 TpPAMIPSNotificationData.94
11.12.21 PAM_CE_AVAILABILITY_CHANGED.94
11.12.21.1 TpPAMAVCEventData.94
11.12.21.2 TpPAMAVCNotificationData.95
11.12.22 PAM_CE_WATCHERS_CHANGED.95
11.12.22.1 TpPAMWCEventData.95
11.12.22.2 TpPAMWCNotificationData.96
11.12.22.3 TpPAMwatcherChangeType.96
11.13 Error Types.96
11.13.1 TpPAMErrorCause.96
11.13.2 TpPAMErrorInfo .96
12 Presence and Availability Management Exception Classes.97
Annex A (informative): Further PAM Information.98
A.1 UML Models.98
A.1.1 Identity.98
A.1.2 Agent.99
A.2 Model.99
A.3 Architecture.
...

SLOVENSKI STANDARD
01-september-2008
2GSUWLGRVWRSGRVWRULWYH26$$SOLNDFLMVNLSURJUDPVNLYPHVQLN$3,GHO
/DVWQRVWVWRULWYHQH]PRåQRVWL6&)]DXSUDYOMDQMHQDY]RþQRVWLLQUD]SRORåOMLYRVWL
3DUOD\
Open Service Access (OSA) - Application Programming Interface (API) - Part 14:
Presence and Availability Management SCF (Parlay 6)
Ta slovenski standard je istoveten z: ES 204 915-14 Version 1.1.1
ICS:
35.100.01 Medsebojno povezovanje Open systems
odprtih sistemov na splošno interconnection in general
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.

ETSI Standard
Open Service Access (OSA);
Application Programming Interface (API);
Part 14: Presence and Availability Management SCF
(Parlay 6)
�
2 ETSI ES 204 915-14 V1.1.1 (2008-05)

Reference
DES/TISPAN-01032-14-OSA
Keywords
API, IDL, OSA, UML
ETSI
650 Route des Lucioles
F-06921 Sophia Antipolis Cedex - FRANCE

Tel.: [phone]  Fax: [phone]

Siret N° 348 623 562 00017 - NAF 742 C
Association à but non lucratif enregistrée à la
Sous-Préfecture de Grasse (06) N° 7803/88

Important notice
Individual copies of the present document can be downloaded from:
http://www.etsi.org
The present document may be made available in more than one electronic version or in print. In any case of existing or
perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF).
In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive
within ETSI Secretariat.
Users of the present document should be aware that the document may be subject to revision or change of status.
Information on the current status of this and other ETSI documents is available at
http://portal.etsi.org/tb/status/status.asp
If you find errors in the present document, please send your comment to one of the following services:
http://portal.etsi.org/chaircor/ETSI_support.asp
Copyright Notification
No part may be reproduced except as authorized by written permission.
The copyright and the foregoing restriction extend to reproduction in all media.

© European Telecommunications Standards Institute 2008.
© The Parlay Group 2008.
All rights reserved.
TM TM TM TM
DECT , PLUGTESTS , UMTS , TIPHON , the TIPHON logo and the ETSI logo are Trade Marks of ETSI registered
for the benefit of its Members.
TM
3GPP is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners.
ETSI
3 ETSI ES 204 915-14 V1.1.1 (2008-05)
Contents
Intellectual Property Rights.9
Foreword.9
1 Scope.10
2 References.10
3 Definitions and abbreviations.10
3.1 Definitions.10
3.2 Abbreviations.10
4 Presence and Availability Management SCF.11
4.1 Introduction.11
4.2 Motivation.11
4.3 Goals.11
4.4 Concepts.12
4.4.1 Identity.12
4.4.2 Agent.12
4.4.3 Presence.13
4.4.4 Availability .14
4.4.5 Events.15
4.5 Scope of PAM information .15
4.6 Security and privacy.15
5 Sequence Diagrams.16
5.1 Use of authentication tokens .17
5.2 Event registration and notification .18
6 Class Diagrams.18
6.1 PAM Provisioning SCF Class Diagrams.19
6.2 PAM Access SCF Class Diagrams.20
6.3 PAM Event SCF Class Diagrams.21
7 The Service Interface Specifications.22
7.1 Interface Specification Format .22
7.1.1 Interface Class.22
7.1.2 Method descriptions.22
7.1.3 Parameter descriptions.23
7.1.4 State Model.23
7.2 Base Interface.23
7.2.1 Interface Class IpInterface .23
7.3 Service Interfaces.23
7.3.1 Overview.23
7.4 Generic Service Interface .23
7.4.1 Interface Class IpService .23
7.4.1.1 Method setCallback().24
7.4.1.2 Method setCallbackWithSessionID().24
8 Presence and Availability Management Interface Classes.24
8.1 PAM Provisioning SCF Interface Classes.25
8.1.1 Interface Class IpPAMProvisioningManager .25
8.1.1.1 Method getAuthToken().25
8.1.1.2 Method obtainInterface().26
8.1.1.3 Method getAccessControl().26
8.1.1.4 Method setAccessControl().26
8.1.2 Interface Class IpPAMIdentityManagement .27
8.1.2.1 Method createIdentity().28
8.1.2.2 Method deleteIdentity().28
8.1.2.3 Method isIdentity().29
ETSI
4 ETSI ES 204 915-14 V1.1.1 (2008-05)
8.1.2.4 Method createGroupIdentity().29
8.1.2.5 Method deleteGroupIdentity().29
8.1.2.6 Method addToGroup().30
8.1.2.7 Method removeFromGroup().30
8.1.2.8 Method listMembers().30
8.1.2.9 Method isGroupIdentity().31
8.1.2.10 Method listGroupMembership().31
8.1.2.11 Method addAlias().32
8.1.2.12 Method removeAliases().32
8.1.2.13 Method listAliases().32
8.1.2.14 Method lookupByAlias().33
8.1.2.15 Method associateTypes().33
8.1.2.16 Method disassociateTypes().33
8.1.2.17 Method listTypesOfIdentity().34
8.1.2.18 Method hasType().34
8.1.2.19 Method getIdentityAttributes().35
8.1.2.20 Method setIdentityAttributes().35
8.1.3 Interface Class IpPAMAgentManagement .36
8.1.3.1 Method createAgent().37
8.1.3.2 Method deleteAgent().37
8.1.3.3 Method isAgent().37
8.1.3.4 Method enableCapabilities() .38
8.1.3.5 Method disableCapabilities() .38
8.1.3.6 Method listEnabledCapabilities().38
8.1.3.7 Method listAllCapabilities().39
8.1.3.8 Method isCapableOf().39
8.1.3.9 Method associateTypes().39
8.1.3.10 Method disassociateTypes().40
8.1.3.11 Method listTypesOfAgent().40
8.1.3.12 Method hasType().41
8.1.3.13 Method getAgentAttributes().41
8.1.3.14 Method setAgentAttributes().42
8.1.4 Interface Class IpPAMAgentAssignment.42
8.1.4.1 Method assignAgent().43
8.1.4.2 Method unassignAgent().43
8.1.4.3 Method listAssignedAgents().44
8.1.4.4 Method listAssociatedIdentitiesOfAgent().44
8.1.4.5 Method listAssignedAgentsByCapability() .45
8.1.4.6 Method listCapabilitiesOfIdentity() .45
8.1.4.7 Method isIdentityCapableOf().45
8.1.5 Interface Class IpPAMIdentityTypeManagement .46
8.1.5.1 Method createIdentityAttribute().46
8.1.5.2 Method deleteIdentityAttribute().47
8.1.5.3 Method getIdentityAttributeDefinition().47
8.1.5.4 Method listAllIdentityAttributes().47
8.1.5.5 Method createIdentityType().48
8.1.5.6 Method deleteIdentityType().48
8.1.5.7 Method listIdentityTypes().48
8.1.5.8 Method addIdentityTypeAttributes().49
8.1.5.9 Method removeIdentityTypeAttributes().49
8.1.5.10 Method listIdentityTypeAttributes().49
8.1.6 Interface Class IpPAMAgentTypeManagement .50
8.1.6.1 Method createAgentAttribute().50
8.1.6.2 Method deleteAgentAttribute().51
8.1.6.3 Method getAgentAttributeDefinition().51
8.1.6.4 Method listAllAgentAttributes().51
8.1.6.5 Method createAgentType().52
8.1.6.6 Method deleteAgentType().52
8.1.6.7 Method listAgentTypes().52
8.1.6.8 Method addAgentTypeAttributes().52
8.1.6.9 Method removeAgentTypeAttributes().53
8.1.6.10 Method listAgentTypeAttributes().53
ETSI
5 ETSI ES 204 915-14 V1.1.1 (2008-05)
8.1.7 Interface Class IpPAMCapabilityManagement .54
8.1.7.1 Method createCapabilityAttribute().54
8.1.7.2 Method deleteCapabilityAttribute().55
8.1.7.3 Method getCapabilityAttributeDefinition().55
8.1.7.4 Method listAllCapabilityAttributes() .55
8.1.7.5 Method createCapability().56
8.1.7.6 Method deleteCapability().56
8.1.7.7 Method listCapabilities().56
8.1.7.8 Method addCapabilityAttributes().57
8.1.7.9 Method removeCapabilityAttributes().57
8.1.7.10 Method listCapabilityAttributes().57
8.1.7.11 Method assignCapabilitiesToType() .58
8.1.7.12 Method unassignCapabilitiesFromType().58
8.1.7.13 Method listCapabilitiesOfType() .58
8.2 PAM Access SCF Interface Classes.59
8.2.1 Interface Class IpPAMPresenceAvailabilityManager .59
8.2.1.1 Method getAuthToken().59
8.2.1.2 Method obtainInterface().60
8.2.1.3 Method getAccessControl().60
8.2.1.4 Method setAccessControl().61
8.2.1.5 Method activateService().61
8.2.1.6 Method deactivateService().61
8.2.1.7 Method isActiveIdentity().62
8.2.2 Interface Class IpPAMIdentityPresence .62
8.2.2.1 Method setIdentityPresence().63
8.2.2.2 Method setIdentityPresenceExpiration().63
8.2.2.3 Method getIdentityPresence().63
8.2.3 Interface Class IpPAMAvailability.64
8.2.3.1 Method getAvailability().65
8.2.3.2 Method getPreference().66
8.2.3.3 Method setPreference().66
8.2.4 Interface Class IpPAMAgentPresence.67
8.2.4.1 Method setAgentPresence().67
8.2.4.2 Method setCapabilityPresence().68
8.2.4.3 Method setAgentPresenceExpiration().68
8.2.4.4 Method setCapabilityPresenceExpiration().69
8.2.4.5 Method getAgentPresence().69
8.2.4.6 Method getCapabilityPresence().70
8.2.5 Interface Class IpAppPAMPreferenceCheck.70
8.2.5.1 Method computeAvailability().70
8.3 PAM Event SCF Interface Classes.71
8.3.1 Interface Class IpPAMEventManager .71
8.3.1.1 Method getAuthToken().72
8.3.1.2 Method obtainInterface().72
8.3.1.3 Method getAccessControl().73
8.3.1.4 Method setAccessControl().73
8.3.1.5 Method activateService().74
8.3.1.6 Method deactivateService().74
8.3.1.7 Method isActiveIdentity().74
8.3.2 Interface Class IpPAMEventHandler.75
8.3.2.1 Method isRegistered().75
8.3.2.2 Method registerAppInterface().76
8.3.2.3 Method registerForEvent().76
8.3.2.4 Method deregisterAppInterface().76
8.3.2.5 Method deregisterFromEvent().77
8.3.3 Interface Class IpAppPAMEventHandler.77
8.3.3.1 Method eventNotify().77
8.3.3.2 Method eventNotifyErr().78
9 State Transition Diagrams.78
10 PAM Service Properties .78
ETSI
6 ETSI ES 204 915-14 V1.1.1 (2008-05)
10.1 PAM Access Service .79
10.2 PAM Event Service.79
11 PAM Data Definitions.79
11.1 Entity Address Definitions.79
11.1.1 TpPAMFQName.79
11.1.2 TpPAMFQNameList.79
11.2 Attribute Data Definitions .79
11.2.1 TpPAMAttribute.79
11.2.2 TpPAMAttributeList.79
11.2.3 TpPAMAttributeDef.80
11.2.4 TpPAMAttributeDefList.80
11.3 Presence Data Definitions .80
11.3.1 TpPAMCapability.80
11.3.2 TpPAMCapabilityList.80
11.3.3 TpPAMPresenceData.80
11.3.4 TpPAMPresenceDataList.81
11.4 Pre-defined Presence type .81
11.4.1 Presentity.81
11.5 Availability Data Definitions .81
11.5.1 TpPAMAvailabilityProfile.81
11.5.2 TpPAMAvailabilityProfileList.81
11.5.3 TpPAMPrivacyCode.81
11.6 Availability Context Data Definitions.81
11.6.1 TpPAMContext.82
11.6.2 TpPAMContextName.82
11.6.3 TpPAMContextData.82
11.6.4 TpPAMCommunicationContext.82
11.6.5 TpPAMContextList.82
11.7 Credential data definitions.83
11.7.1 TpPAMCredential.83
11.8 Availability and Access Control Preference Data Definitions .83
11.8.1 IpAppPAMPreferenceCheckRef.83
11.8.2 TpPAMAccessControlData.83
11.8.3 TpPAMACLDefault.83
11.8.4 TpPAMPreferenceOp.83
11.8.5 TpPAMPreferenceType.84
11.8.6 TpPAMPreferenceData.84
11.9 Time data definitions.84
11.9.1 TpPAMTimeInterval.84
11.10 Pre-defined Entity Types and Attributes .84
11.11 Interface name definitions.85
11.11.1 TpPAMProvisioningInterfaceName.85
11.11.2 TpPAMPresenceAvailabilityInterfaceName.85
11.11.3 TpPAMEventInterfaceName.85
11.12 Event data definitions.86
11.12.1 IpAppPAMEventHandlerRef.86
11.12.2 TpPAMClientID.86
11.12.3 TpPAMEventID.86
11.12.4 TpPAMEventName.86
11.12.5 TpPAMEventNameList.86
11.12.6 TpPAMEventInfo.86
11.12.7 TpPAMEventInfoList.87
11.12.8 TpPAMNotificationInfo.87
11.12.9 TpPAMNotificationInfoList.87
11.12.10 PAM_CE_IDENTITY_CREATED.87
11.12.10.1 TpPAMICEventData.88
11.12.10.2 TpPAMICNotificationData.88
11.12.11 PAM_CE_IDENTITY_DELETED.88
11.12.11.1 TpPAMIDEventData.88
11.12.11.2 TpPAMIDNotificationData.88
11.12.12 PAM_CE_GROUP_MEMBERSHIP_CHANGED.88
ETSI
7 ETSI ES 204 915-14 V1.1.1 (2008-05)
11.12.12.1 TpPAMGMCEventData.89
11.12.12.2 TpPAMGMCNotificationData.89
11.12.13 PAM_CE_AGENT_CREATED.89
11.12.13.1 TpPAMACEventData.89
11.12.13.2 TpPAMACNotificationData.89
11.12.14 PAM_CE_AGENT_DELETED.89
11.12.14.1 TpPAMADEventData.90
11.12.14.2 TpPAMADNotificationData.90
11.12.15 PAM_CE_AGENT_ASSIGNED.90
11.12.15.1 TpPAMAAEventData.90
11.12.15.2 TpPAMAANotificationData.91
11.12.16 PAM_CE_AGENT_UNASSIGNED.91
11.12.16.1 TpPAMAUEventData.91
11.12.16.2 TpPAMAUNotificationData.91
11.12.17 PAM_CE_CAPABILITY_CHANGED.91
11.12.17.1 TpPAMCCEventData.92
11.12.17.2 TpPAMCCNotificationData.92
11.12.18 PAM_CE_AGENT_CAPABILITY_PRESENCE_SET.92
11.12.18.1 TpPAMACPSEventData.92
11.12.18.2 TpPAMACPSNotificationData.93
11.12.19 PAM_CE_AGENT_PRESENCE_SET.93
11.12.19.1 TpPAMAPSEventData.93
11.12.19.2 TpPAMAPSNotificationData.93
11.12.20 PAM_CE_IDENTITY_PRESENCE_SET.93
11.12.20.1 TpPAMIPSEventData.94
11.12.20.2 TpPAMIPSNotificationData.94
11.12.21 PAM_CE_AVAILABILITY_CHANGED.94
11.12.21.1 TpPAMAVCEventData.94
11.12.21.2 TpPAMAVCNotificationData.95
11.12.22 PAM_CE_WATCHERS_CHANGED.95
11.12.22.1 TpPAMWCEventData.95
11.12.22.2 TpPAMWCNotificationData.96
11.12.22.3 TpPAMwatcherChangeType.96
11.13 Error Types.96
11.13.1 TpPAMErrorCause.96
11.13.2 TpPAMErrorInfo .
...