SRP Configuration
SRP Selection
When the DSG-SCP needs to play an announcement (e.g. as a result of a Result-Code action), it must have the SRP connectivity and interaction configuration in place to allow this.
If language IDs are being provided to the SRP then they must also be configured.
...
<config>
...
<language_maps>
<map name='general'>
<language name='English' id='1'/>
<language name='German' id='2'/>
</map>
</language_maps>
<srps>
<srp name="N2SRP" use_etc="1" routing_address="a88441"/>
<srp name="OtherSRP" use_etc="1" routing_address="bb88441" scf_id="ad0002" correlation_id_location="standalone"/>
<srp name="Switch" use_etc="0" star_digit="C" hash_digit="b" cancel_digit="#" end_digit="E" language_map="general" language_extension_type="400"/>
</srps>
</config>
...
Configuration Details
The available configuration items for SRP selection are as below:
Attribute | Type | Description |
---|---|---|
.language_maps
|
Array |
Array of map elements definining the supported language map(s).
|
.map
|
Array | An array of languages in the map. |
.name
|
String |
The name of the language map. (Default = default ).
|
.language
|
Object | A language mapping within the map. This elements may be repeated. |
.srps
|
Array |
Array of srp elements definining the supported SRP endpoints.
|
.srp
|
Object | Provisions a known SRP endpoint, either on-switch (CTR) or off-switch (ETC). |
Language
Each map contains one or more Language mappings from name
to id
as follows:
Attribute | Type | Description |
---|---|---|
name
|
String
|
[Required] The name of the language as the service logic will supply. |
id
|
Integer | [Required] The numeric language ID which is supplied to the SRP. |
SRP Endpoints
Each SRP Endpoint defines a rule for choosing the appropriate SRP for an announcement.
SRP Endpoints are referred to using the configured name
.
Each srp
Object in the SRP Endpoints array is configured as follows:
Attribute | Type | Description |
---|---|---|
name
|
String
|
[Required] The name of the SRP for use with selection for playing announcements. |
use_etc
|
Boolean |
[Required] The connection mode for the SRP. Set to ( 1 ) if the SRP is off-switch and connected to via EstablishTemporaryConnection .Set to ( 0 ) if the SRP is on-switch and connected to via ConnectToResource .
|
inap
|
cs1 / camel2 / camel3 / camel4
|
[Required for ETC] One of the SRP protocol variants implemented by DsgScpApp .
|
routing_address
|
Hex Digits |
[Required for use_etc = 1 ] This is the prefix of the assistingSSPIPRoutingAddress ,
which will typically include some indicate to identify this SCP node, so that the SRP can
route the associated AssistRequestInstructions correctly.
|
star_digit
|
[A-E]
|
The hex digit used by this SRP to represent the "star" character * .Modern CAMEL protocol standards state that this should always be B .(Default = B ).
|
hash_digit
|
[A-E]
|
The hex digit used by this SRP to represent the "hash" character # .Modern CAMEL protocol standards state that this should always be C .(Default = C ).
|
cancel_digit
|
[*#A-E]
|
The digit to send to the SRP as the cancelDigit in PlayAnnouncement and PromptAndCollectUserInformation operations.(Default = do not specify cancel digit). |
end_digit
|
[*#A-E]
|
The digit to send to the SRP as the endOfReplyDigit in PlayAnnouncement and PromptAndCollectUserInformation operations.(Default = do not specify end of reply digit). |
returned_ac
|
[AC Alias] / Hex Value / copy / none
|
Specify the TCAP Application Context to return to the SRP in response to the AssistRequestInstructions .Either a known TCAP AC Alias, or a hex string, or the value copy (copy the received AC) or the value none (do not send AC).(Default = the same as the inap ).
|
scf_id
|
Hex String |
A hex representation of the value to encode as the EstablishTemporaryConnection attribute scfID .(Default = do not set scfID ).
|
correlation_id_location
|
routing_address / standalone
|
Mechanism for setting the correlation ID in EstablishTemporaryConnection .routing_address means append the digits to the configured routing_address .standalone means encode the correlation ID as generic digits in the correlationID attribute of the ETC.(Default = routing_address ).
|
tcap_close
|
prearranged / end / abort
|
How should we close the SRP TCAP dialog if we believe that the interaction session is over, but
the TCAP SSP dialog is still open.prearranged = Assume pre-arranged END.end = Send TCAP END with no components.abort = Send TCAP ABORT.(Default = prearranged ).
|
language_map
|
String |
The name of a map entry within the language_maps .(Default = default ). |
language_extension_type
|
Integer |
The type value for the INAP/ASN.1 extensions SEQUENCE.Setting this value enables the use of the ASN.1 "extensions" syntax originally proposed by Unisys for interaction with their NAP platform. This mechanism is also the default mechanism supported by the Oracle NCC/OC3C platform and by the N-Squared SRP. (Default = undef i.e. language cannot be conveyed to the SRP). |
max_pa_secs
|
5 - 3600
|
This is the maximum allowed duration of interaction resulting from sending PlayAnnouncement
to this (on-switch or external) SRP. The SRP connection will be aborted if SpecializedResourceReport
is not received within this time.The additional global TCAP round-trip allowance tcap_margin_ms will be added to this value.(Default = 300 seconds). |
max_pacui_secs
|
5 - 3600
|
This is the maximum allowed duration of interaction resulting from sending PromptAndCollectUserInformation
to this (on-switch or external) SRP. The SRP connection will be aborted if PromptAndCollectUserInformationResult
is not received within this time.The additional global TCAP round-trip allowance tcap_margin_ms will be added to this value.(Default = 300 seconds). |
max_etc_ms
|
10 - 5000
|
This is the maximum time that the SCP layer will allow between sending EstablishTemporaryConnection
to the SSP and receiving AssistRequestInstructions from the SRP. The SRP connection process will
be aborted if the ARI is not received within this time window.(Default = 4000 milliseconds). |
tcap_margin_ms
|
10 - 5000
|
The grace period (in milliseconds) within which a medium/long-term expected TCAP component may
arrive late because of allowance for processing and network time. For an SRP definition, this parameter adds a margin on top of max_pa_secs or
max_pacui_secs to allow for network/processing delay.(Default = 500 milliseconds).
|
The full process for determining the outbound assistingSSPIPRoutingAddress
in the
EstablishTemporaryConnection
is as follows.
- Start with the configured
routing_address
. - If
correlation_id_location
=routing_address
then append the Correlation ID assigned by theSigtranApp
(including any leading “0”). - Use the
called_party
denormalisation rules to modify the digits and determine the NoA.
The length of the Correlation ID including leading 0
is configured in the SigtranApp
using the correlation_id_len
application parameter.