Managing and Configuring Audio Call Communication Services
The following section describes configuration and maintenance attributes and operations for the communication services that expose Parlay 3.0 Audio Call Web Services interfaces. The sections also provide a workflow for the configuration:
Parlay X 3.0 Audio Call/Parlay MultiParty Call Control and Call User Interaction
This section contains a description of the configuration attributes and operations available for the Parlay X 3.0 Audio Call /Parlay MultiParty Call Control and Call User Interaction network protocol plug-in instance.
Exposes to the service communication layer a Java representation of:
Parlay X 3.0 Part 11: Audio Call
Interfaces with the network nodes using:
Open Service Access (OSA); Application Programming Interface (API); Part 4: Call Control SCF; Subpart 7: MultiParty Call Control Service
Open Service Access (OSA); Application Programming Interface (API); Part 5: User Interaction SCF
Deployment artifacts
osa_access.jar, Plugin_px30_audio_call_parlay_mpcc_cui.jar, and px30_audio_call_service.jar, packaged in wlng_nt_audio_call_px30.ear
px30_audio_call.war, packaged in wlng_at_audio_call_px30.ear
This plug-in service does not support multiple instantiation using the Plug-in Manager. There is a one to one mapping between plug-in service and plug-in instance. The plug-in instance is created when the plug-in service is started.
Configuration Workflow for Parlay X 3.0 Audio Call/Parlay MultiParty Call Control and Call User Interaction
Below is an outline for configuring the plug-in using Network Gatekeeper Management Console:
Gather information about the OSA Gateway and configure the MultiParty Call Control part of the protocol translator accordingly. The following information needs to be obtained from the OSA Gateway administrator and configured in the Parlay_Access service:
OSA/Parlay SCS type to be used in the look up (service discovery) phase when requesting the MultiParty Call Control service (OSA/Parlay SCS) from the OSA/Parlay Gateway. Typically this is P_MULTI_PARTY_CALL_CONTROL.
OSA/Parlay service properties to be used in the look up (service discovery) phase when requesting a service (OSA/Parlay SCS) from the OSA/Parlay Gateway. This depends on the OSA Gateway implementation.
Authentication type used by the OSA/Parlay Framework.
Encryption method used for the connection with the OSA Gateway.
Signing algorithm used when signing the service level agreement with the OSA/Parlay Framework.
Gather information about the OSA Gateway and configure the Call User Interaction part of the protocol translator accordingly. The following information needs to be obtained from the OSA Gateway administrator and configured in the OSA Access service:
OSA/Parlay SCS type to be used in the look up (service discovery) phase when requesting the Generic User interaction service (OSA/Parlay SCS) from the OSA/Parlay Gateway. Typically this is P_USER_INTERACTION.
OSA/Parlay service properties to be used in the look up (service discovery) phase when requesting a service (OSA/Parlay SCS) from the OSA/Parlay Gateway. This depends on the OSA Gateway implementation.
Authentication type used by the OSA/Parlay Framework.
Encryption method used for the connection with the OSA Gateway.
Signing algorithm used when signing the service level agreement with the OSA/Parlay Framework.
Specifies the start time-out when collecting user input, the value for the first character time-out timer.
The value corresponds to the parameter TpUICollectCriteria.StartTimeout in the sendInfoAndCollectReq requests towards the Generic User Interaction SCS.
Attribute: CollectInterCharTimeout
Scope: Cluster
Unit: Seconds
Specifies the inter-character time-out when collecting user input, the value for the inter-character time-out timer.
The value corresponds to the parameter TpUICollectCriteria.InterCharTimeOut in the sendInfoAndCollectReq requests towards the Generic User Interaction SCS.
Attribute: Language
Scope: Cluster
Unit: n/a
Format: String according to valid language strings as defined in ISO 639.
Specifies the language of the message to be played for the call participant.
Attribute: ChargingAllowed
Scope: Cluster
Unit: n/a
Format: Boolean
Specifies whether charging is allowed.
true if an application is allowed to specify charging information when playing a message (Parlay X operation playAudioMessage).
False if not.
Attribute: Retentiontime
Scope: Cluster
Unit: Seconds
Format: int [0-]
Specifies the length of time status information about a message (Parlay X MessageStatus) is stored after play operation has finished or an error related to the playing of a message has been received.
Attribute: RepeatIndicator
Scope: Cluster
Unit: n/a
Format: int
Specifies the number of times a message should be played to the call participant.
The value corresponds to the parameter repeatIndicator in the sendInfoReq requests towards the Generic User Interaction SCS.
Attribute: ResponseRequested
Scope: Cluster
Unit: n/a
Format: int [1,2,4]
Specifies if a response is required from the Generic User Interaction SCS, and what, if any, action the service should take.
The value corresponds to the parameter responseRequested in the sendInfoReq requests towards the Generic User Interaction SCS.
Use:
1 for P_UI_RESPONSE_REQUIRED
2 for P_UI_LAST_ANNOUNCEMENT_IN_A_ROW
4 for P_UI_FINAL_REQUEST
Attribute: RetensionTime
Scope: Cluster
Unit: Seconds
Format: int
Specifies the time-interval for which status information is retained after a message is played or an error occurs.
Attribute: ShutdownTimerInterval
Scope: Server
Unit: Seconds
Format: int
Specifies the time-interval to wait for call sessions to end before terminating when performing a graceful shutdown.
Attribute: MaxDigits
Scope: Server
Unit: n/a
Format: int [1 -]
Specifies the maximum number of digits that can be collected from the call participant.
The value corresponds to the parameter TpUICollectCriteria.MaxLength in the sendInfoAndCollectReq requests towards the Generic User Interaction SCS.
Attribute: MinDigits
Scope: Server
Unit: n/a
Format: int [1 -]
Specifies the minimum number of digits that can be collected from the call participant.
The value corresponds to the parameter TpUICollectCriteria.MinLength in the sendInfoAndCollectReq requests towards the Generic User Interaction SCS.
Attribute: EndSequence
Scope: Server
Unit: n/a
Format: String
Specifies the digit to be used for ending collection of data of various lengths from a call participant.
The value corresponds to the parameter TpUICollectCriteria. EndSequence in the sendInfoAndCollectReq requests towards the Generic User Interaction SCS.
