1/27

Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents

1 Understanding Communication Services

• About the Software Architecture
• Communication Services
• Container Services
• Communication Service Deployment Model

2 Understanding the Communication Service Architecture

• Understanding How Communication Services Work
• Typical Application-Initiated Traffic Flow
• Typical Network-Triggered Traffic Flow
• Common Features

3 Services Gatekeeper OAuth 2.0 Authorization and Resource Servers

• Using OAuth 2.0 with Services Gatekeeper

4 Application Subscription Management

• Overview of the Application Subscription Management Service
• Application Interfaces
• Support for OAuth Authentication
• Events and Statistics
  • Event Data Records
• Managing Application Subscription Management
  • Properties for Application Subscription Management
  • Configuration Workflow for Application Subscription Management
    • Deploying Application Subscription Management Packages
    • Creating an Application Subscription Management plug-in Instance
    • Editing Application Subscription Management Attributes
    • Loading Application Subscription Configuration Files
    • Loading Trusted Applications
    • Cleaning Up Pending Requests and Expired Subscriptions
    • Retrieving Application Subscription Configuration Files
    • Retrieving Application Subscription Lists
    • Configure Application OAuth Scope
    • Connecting to an SMSC
  • Handling Traffic from Applications without Subscriptions

5 Parlay X 2.1 Multimedia Messaging/MM7

• Overview of the Parlay X 2.1 Multimedia Messaging/MM7 Communication Service
  • Processing Application-initiated Requests
    • Send Receipts
    • Delivery Receipts
  • Processing Network-triggered Requests
    • Retrieving Offline MMS Messages
  • Polling Functionality
  • Short Code Translation
• Application Interfaces
• Events and Statistics
  • Event Data Records
  • Charging Data Records
  • Statistics
  • Alarms
• Tunneled Parameters for Parlay X 2.1 MM7 Rel 6.8.0
  • ChargedParty
  • ChargedPartyCD
  • timeStamp
  • expiryDate
  • allowAdaptation
  • DeliveryCondition
  • UAProf
  • StatusText
• Managing Parlay X 2.1 Multimedia Messaging/MM7
  • Properties for Parlay X 2.1 Multimedia Messaging/MM7
  • Configuration Workflow for Parlay X 2.1 MultiMedia Messaging/MM7
  • Provisioning Parlay X 2.1 MultiMedia Messaging/MM7 Communication Service

6 Parlay X 2.1 Multimedia Messaging/SMTP, POP3, and IMAP

• Overview of the Parlay X 2.1 Multimedia Messaging/SMTP, POP3, and IMAP Communication Service
  • Processing Application-Initiated Requests
    • Send Requests
    • Send Receipts
    • Delivery Receipts
    • Retry Requests
  • Processing Network-Triggered Requests
    • Retrieving Offline Messages
• Application Interfaces
• Events and Statistics
  • Event Data Records
  • Charging Data Records
  • Alarms
• Managing Parlay X 2.1 MultiMedia Messaging/SMTP, POP3, and IMAP
  • Properties for Parlay X 2.1 MultiMedia Messaging/SMTP, POP3, and IMAP
  • Configuration Workflow for Parlay X 2.1 MultiMedia Messaging/SMTP, POP3, and IMAP
  • Provisioning Workflow for Parlay X 2.1 MultiMedia Messaging/SMTP, POP3, and IMAP

7 Parlay X 2.1 Short Messaging/SMPP

• Overview of the Parlay X 2.1 Short Messaging/SMPP Communication Service
  • Split and Submit Messaging
  • Processing Application-Initiated Requests
    • Send Receipts
    • Delivery Receipts
  • Processing Network-Triggered Requests
  • Connection Handling and Provisioning
  • Multiple Connections and Multiple Plug-in Instances
  • Windowing
  • Segments
  • Short Code Translation
  • Load Balancing, High Availability, and Failover
  • Character Set Encoding
    • Standard and Extended GSM Alphabets
    • Other Alphabets
    • Overriding the DefaultDataCoding Attribute
• Application Interfaces
• Events and Statistics
  • Event Data
  • Charging Data Records
  • Statistics
  • Alarms
• Tunneled Parameters for Parlay X 2.1 Short Messaging / SMPP
  • submit_date
  • done_date
  • sms.protocol.id
  • source_port
  • destination_port
  • data_coding
  • esm_class
  • sms.service.type
  • sms.replace.if.present
  • com.bea.wlcp.wlng.plugin.sms.OriginatingAddressType
  • com.bea.wlcp.wlng.plugin.sms.DestinationAddressType.n
  • com.bea.wlcp.wlng.plugin.sms.RequestDeliveryReportFlag
  • com.bea.wlcp.wlng.plugin.sms.DataCoding
  • com.bea.wlcp.wlng.plugin.sms.Priority
  • originating_address
  • smpp_billing_id
  • dest_addr_subunit
  • dest_bearer_type
  • service_type
  • ussd_service_operation
  • its_session_info
  • smpp_optional_int_tlv_param_tags
  • smpp_optional_int_tlv_param_values
  • smpp_optional_octet_tlv_param_tags
  • smpp_optional_octet_tlv_param_values
  • com.bea.wlcp.wlng.plugin.sms.smpp.schedule_delivery_time
  • sms.validity.period
• Managing Parlay X 2.1 Short Messaging/SMPP and Extended Web Services Binary SMS/SMPP
  • Properties for Parlay X 2.1 Short Messaging/SMPP and Extended Web Services Binary SMS/SMPP
  • Configuration Workflow for Parlay X 2.1 Short Messaging/SMPP and Extended Web Services Binary SMS/SMPP
  • Management Operations in the SMPP Server Service

8 Parlay X 3.0 Device Capabilities/LDAPv3

• Overview of the Parlay X 3.0 Device Capabilities/LDAPv3 Communication Service
• Application Interfaces
• Events and Statistics
  • Event Data Records
  • Charging Data Records
  • Statistics
• Managing Parlay X 3.0 Device Capabilities/LDAPv3
  • Properties for Parlay X 3.0 Device Capabilities/LDAPv3 Plug-in
  • Configuration Workflow for Device Capabilities/LDAPv3 Plug-in
  • Creating an LDAP-to-XML Mapping File
• Reference: Attributes and Operations for Device Capabilities/LDAPv3
  • Attribute: AuthDN
  • Attribute: AuthPassword
  • Attribute: BaseDN
  • Attribute: ConnTimeout
  • Attribute: DeviceIdAttributeName
  • Attribute: DeviceNameAttributeName
  • Attribute: DeviceProfileURLAttributeName
  • Attribute: Host
  • Attribute: LDAPConnectionStatus
  • Attribute: MaxConnections
  • Attribute: MinConnections
  • Attribute: Port
  • Attribute: recoverTimerInterval
  • Attribute: Schema
  • Operation: apply
  • Operation: updateSchemaURL

9 Parlay X 3.0 Payment/Diameter

• Overview of the Parlay X 3.0 Payment Communication Service
  • Amount Charging
  • Volume Based Charging
  • Processing Direct Queries/Application-initiated Requests
  • Processing Notifications/Network-triggered Requests
  • Validating Reservation Requests
• Application Interfaces
• Changing the List of Diameter AVPs for Your Implementation
  • About the AVP Template Files
  • Adding New AVPs for Diameter Payment in Template Files
  • Adding Diameter AVPs to a Template File During Runtime
• Forwarding AVPs as Xparams from the Charging Server to the Application
• Events and Statistics
  • Event Data Records
  • Statistics
• Tunneled Parameters for Parlay X 3.0 Payment / Diameter
  • session-id
• Managing Parlay X 3.0 Payment /Diameter
  • Properties for Parlay X 3.0 Payment/Diameter
  • Configuration Workflow for Parlay X 3.0 Payment/Diameter
  • Provisioning Workflow for Parlay X 3.0 Payment/Diameter

10 Parlay X 3.0 Address List Management Interface

• Overview of the Parlay X 3.0 Address List Management Interface
  • Address List Management Architecture
  • Group URI Format
  • Managing Groups
  • Controlling Group Access
  • Managing and Querying Group Members
  • Managing and Querying Group Attributes
  • Managing and Querying Group Member Attributes
• Application Interfaces
• Events and Statistics
  • Event Data Records
  • Alarms
• Managing Parlay X 3.0 Address List Management Architecture
  • Properties for Parlay X 3.0 Address List Management Architecture
  • Configuration Workflow for Parlay X 3.0 Address List Management Architecture
• Reference: Attributes and Operations for Parlay X 3.0 Address List Management Architecture
  • Attribute: GroupNameMaxLength
  • Attribute: GroupSize
  • Operation: createGroup
  • Operation: queryGroups
  • Operation: deleteGroup
  • Operation: setAccess
  • Operation: queryAccess
  • Operation: addMember
  • Operation: addMembers
  • Operation: queryMembers
  • Operation: deleteMember
  • Operation: deleteMembers
  • Operation: addGroupAttribute
  • Operation: queryGroupAttribute
  • Operation: deleteGroupAttribute
  • Operation: addGroupMemberAttribute
  • Operation: queryGroupMemberAttributes
  • Operation: deleteGroupMemberAttribute
  • Operation: addMemberAttribute
  • Operation: queryMemberAttributes
  • Operation: deleteMemberAttribute

11 Parlay X 4.0 Application-Driven Quality of Service/Diameter

• Overview of the Parlay X 4.0 Application-Driven Quality of Service (QoS)/Diameter Communication Service
  • How it Works
• Adding SOAP-Based QoS Support to an Application
• Managing Parlay X 4.0 Application-Driven Quality of Service (QoS)/Diameter
  • Properties for Parlay X 4.0 Application-Driven QoS/Diameter
  • Configuration Workflow for Parlay X 4.0 Application-Driven QoS/Diameter
• Events and Statistics
  • Event Data Records
  • Charging Data Records
• Reference: Attributes and Operations for Parlay X 4.0 Application-Driven Quality of Service (QoS)/Diameter
  • Attribute: DestinationHost
  • Attribute: DestinationPort
  • Attribute: DestinationRealm
  • Attribute: OriginHost
  • Attribute: OriginPort
  • Attribute: OriginRealm
  • Attribute: Connected
  • Attribute: RecordHistory
  • Operation: connect
  • Operation: disconnect
  • Operation: loadQoSRequestTemplate
  • Operation: retrieveQoSRequestTemplate
  • Operation: listQoSRequestTemplateMatchRule
  • Operation: deleteQoSRequestTemplate

12 REST Services

• Overview of REST Services

13 OneAPI Multimedia Messaging/MM7

• About the OneAPI Multimedia Messaging Interface
  • REST Service Descriptions Available at Run-time
• Sending MMS Messages
• Query Delivery Status of MMS Message
• Subscribe to MMS Delivery Notification
• Stop Subscription to Delivery Notifications
• Retrieve Messages Sent to Web Application
  • Retrieving Full Messages
• Subscribe to Notifications of Messages Sent to Application
• Stop Subscription to Application Message Notifications

14 OneAPI Payment/Diameter

• About the Payment Interface
  • REST Service Descriptions Available at Run-time
• Charge Amount
• Query Transaction Status
• List Transactions for Application User
• Refund Amount
• Reserve Amount
• Charge Reservation
• Release Reservation
• Resource States
• Payment Exceptions

15 OneAPI Short Messaging/SMPP

• About the OneAPI Short Messaging Interface
  • REST Service Descriptions Available at Run-time
• Sending SMS Messages
• Query Delivery Status of SMS Message
• Subscribe to SMS Delivery Notification
• Stop Subscription to Delivery Notifications
• Retrieve Messages Sent to Web Application
• Subscribe to Notifications of Messages Sent to Application
• Stop Subscription to Application Message Notifications

16 OneAPI Terminal Location/MLP

• About the Terminal Location Interface
  • REST Service Descriptions Available at Run-time
• Query Mobile Terminal Location

17 Extended Web Services Binary SMS/SMPP

• Overview of the EWS Binary SMS/SMPP
  • Send Receipts
  • Delivery Receipts
  • Connection Handling and Provisioning
• Application Interfaces
• Events and Statistics
  • Event Data
  • Charging Data Records
  • Statistics
  • Alarms
• Managing EWS Binary SMS/SMPP

18 Extended Web Services Quality of Service /Diameter

• Understanding the EWS Quality of Service/Diameter Communication Service
  • Using Degraded Mode
  • An Example End to End QoS Solution
• Application Interfaces
• Events and Statistics
  • Event Data Records
  • Alarms
• Specifications for the EWS Quality of Service/Diameter Communication Service
• Managing the EWS Quality of Service/Diameter Communication Service
  • General Configuration Workflow
  • Configuring Coherence to Use Degraded Mode
  • Managing Extended Web Services Quality of Service Templates
    • Load a QoS Template
    • Retrieve an Existing QoS Template
    • List Match Rules for a QoS Template
    • Delete a QoS Template
• Reference: Attributes and Operations for EWS Quality of Service/ Diameter
  • Attribute: DestinationHost
  • Attribute: DestinationPort
  • Attribute: DestinationRealm
  • Attribute: OriginHost
  • Attribute: OriginPort
  • Attribute: OriginRealm
  • Attribute: Connected
  • Operation: connect
  • Operation: disconnect
  • Operation: loadQoSRequestTemplate
  • Operation: retrieveQoSRequestTemplate
  • Operation: listQoSRequestTemplateMatchRule
  • Operation: deleteQoSRequestTemplate

19 Extended Web Services Subscriber Profile/LDAPv3

• Overview of the EWS Subscriber Profile/LDAPv3 Communication Service
• Application Interfaces
• Events and Statistics
  • Event Data Records
  • Charging Data Records
  • Statistics
  • Alarms
• Managing EWS Subscriber Profile/LDAPv3
  • Properties for EWS Subscriber Profile/LDAPv3
  • LDAP Server Schema
  • Configuration Workflow for EWS Subscriber Profile/LDAPv3
  • Management Operations for EWS Subscriber Profile/LDAPv3
  • Provisioning for EWS Subscriber Profile/LDAPv3

20 Extended Web Services WAP Push/PAP

• Overview of the EWS WAP Push/PAP Communication Service
  • Push Access Protocol (PAP) 2.0
• Application Interfaces
• Events and Statistics
  • Charging Data Records
  • Event Data Records
  • Statistics
  • Alarms
• Managing the EWS WAP Push/PAP Communication Service
  • Properties for EWS WAP Push/PAP
  • WAP User Address Scheme
  • Configuration Workflow for EWS WAP Push/PAP

21 Native MM7

• Overview of the Native MM7 Communication Service
  • Status Reports
    • Delivery Reports
    • Read-Reply Report
  • Network-triggered Multimedia Messages
• Application Interfaces
• Events and Statistics
  • Event Data Records
  • Charging Data Records
  • Statistics
  • Alarms
• Managing Native MM7
  • Properties for Native MM7
  • Configuration Workflow for Native MM7
  • Provisioning Workflow for Native MM7

22 Native SMPP

• Overview of the Native SMPP Communication Service
  • SMPP Server Service
  • Connection Handling and Provisioning
    • About Creating and Resetting Connections
    • About Session Handling
  • Creating an Interceptor With a Custom Error Code
  • Authentication
  • Connection Pooling
    • Server Connection Pools
    • Client Connection Pools
  • Timeouts
    • SMPP Server Service Timers
    • Plug-in Instance Timers
  • Windowing
  • Connection-Based Routing
    • Enable Connection-Based Routing
    • Limitations
  • Short Code Translation
  • USSD Support
    • its_session_info
    • service_type
    • ussd_service_operation
  • Billing Identification
    • smpp_billing_id
  • Load Balancing, High Availability and Fail-Over
• Application Interfaces
• Events and Statistics
  • Event Data Records
  • Charging Data Records
  • Statistics
  • Alarms
• Managing Native SMPP
• Properties for SMPP Server Service
• Properties for Native SMPP Plug-in
• Configuration Workflow for Native SMPP Communication Service
• Provisioning Workflow for Native SMPP Communication Service
• Context Attributes for Native SMPP Server
  • Attribute: native_smpp_mo_destAddressHasAppMapping
  • Attribute: native_smpp_mo_hasActiveReceiver
• System Properties for SMPP Server Service
  • System Property: oracle.ocsg.protocol.smpp.serverservice.max_threads
  • System Property: oracle.ocsg.protocol.smpp.serverservice.min_threads
  • System Property: wlng.legacy.smpp.PDUManipulationAllowed
  • System Property: wlng.smpp.max_payload_size
• Reference: Attributes and Operations for SMPP Server Service
  • Attribute: ConnectionBasedRouting
  • Attribute: EnquireLinkMaxFailureTimes
  • Attribute: EnquireLinkTimerValue
  • Attribute: InactivityTimerValue
  • Attribute: InitiationTimerValue
  • Attribute: LooseBinding
  • Attribute: OfflineMO
  • Attribute: rejectMOMessagesWithNoAppReceiverConnection
  • Attribute: RequestTimerValue
  • Attribute: ServerAddress
  • Attribute: ServerPort
  • Attribute: skipAddressrangeCheckInBindRequest
  • Attribute: SmscSystemId
  • Operation: addApplicationSpecificSettings
  • Operation: closeClientConnection
  • Operation: closeServerConnection
  • Operation: closeServerPort
  • Operation: deleteApplicationSpecificSettings
  • Operation: listApplicationSpecificSettings
  • Operation: listClientConnections
  • Operation: listClusterServerConnectionsForMOJumping
  • Operation: listPluginInstances
  • Operation: listServerConnections
  • Operation: listServerPorts
  • Operation: resetClientConnection
  • Operation: resetServerPort
  • Operation: updateAllServerPorts
• Reference: Attributes and Operations for Native SMPP Plug-in
  • Attribute: BindType
  • Attribute: DeliverSmRespCommandStatus
  • Attribute: EnableDeleteAfterCancel
  • Attribute: EnableDeleteAfterNotify
  • Attribute: EnableDeleteAfterQuery
  • Attribute: EnquireLinkTimerValue
  • Attribute: EsmeAddressRange
  • Attribute: EsmeNpi
  • Attribute: EsmePassword
  • Attribute: EsmeSystemId
  • Attribute: EsmeSystemType
  • Attribute: EsmeTon
  • Attribute: LocalAddress
  • Attribute: LocalPort
  • Attribute: MessageIdInHexFormat
  • Attribute: NumberReceiverConnections
  • Attribute: NumberTransceiverConnections
  • Attribute: NumberTransmitterConnections
  • Attribute: RequestTimerValue
  • Attribute: RetryTimesBeforeGiveUp
  • Attribute: RetryTimesBeforeReconnect
  • Attribute: SmscAddress
  • Attribute: SmppVersion
  • Attribute: SmscPort
  • Attribute: WindowingMaxQueueSize
  • Attribute: WindowingMaxWaitTime
  • Attribute: WindowingSize

23 Native UCP

• Overview of the Native UCP Communication Service
  • Connection and Credential Handling
    • Credentials
    • Multiple Connections
    • Connection Pooling
  • Windowing and Transaction Numbers
    • Behavior When the Window is Exceeded
    • Behavior When TRNs Are Not Released
  • Authentication
  • Availability and Retry
    • Application-Initiated traffic
    • Network-Initiated traffic
    • Client-Side Retry Handling
  • Heartbeat Support
    • Server-Side Heartbeat Support
    • Client-Side Heartbeat Support
  • Storage Provider
• Application Interfaces
• Events and Statistics
  • Event Data Records
    • About UCP_trn/UCP_mappedTrn
    • About UCP_oadc
  • Charging Data Records
  • Statistics
  • Alarms
• Managing Native UCP
• Properties for Native UCP Protocol Server Service
• Properties for Native UCP Managed Plug-in
• Properties for Native UCP Plug-in Instance
• Configuration Workflow for Native UCP Communication Service
• Provisioning Workflow for Native UCP Communication Service
• Reconfiguring Native UCP Listen Ports
• Reference: Attributes and Operations for Native UCP Protocol Server Service
  • Attribute: MaxReconnectAttempts
  • Attribute: TimeBetweenReconnectAttempts
  • Attribute: UCPProtocol (read-only)
  • Operation: closeClientSideConnection
  • Operation: closeServerSideConnection
  • Operation: dumpClientSideConnectionsInfo
  • Operation: dumpOngoingClientConnectionsRetryInfo
  • Operation: dumpServerSideConnectionsInfo
  • Operation: listUCPServersString
  • Operation: restartPorts
  • Operation: stopOngoingClientConnectionRetry

A Events, Alarms, and Charging

• Events
  • Event handling in the Access Tier
  • Event handling in the Network Tier
• Alarms
  • Management integration
    • OSS
    • SNMP
• Charging Data Records