N2SRP (INAP) EDRs
N2SRP (INAP) Application EDRs
The INAP controlled N2SRP is a “Specialised Resource Platform” according to the INAP-specifications. It performs the SIP/RTP interaction component, under the direct supervision of an Intelligent Networking SCP.
It is built on top of the SipApp
base class, and hence generates the base
SIP EDRs.
In addition, the N2SRP logs the service logic events associated with the INAP/CAP control channel. These SRP EDRs are written to the same stream as the SIP EDRs, and will be interleaved with them in the EDR files.
The SRP EDR Event Types are:
OVER
SRP-ARI
SRP-PA
SRP-PA-E
SRP-SRR
SRP-PACUI
SRP-PACUI-R
SRP-PACUI-E
Each of these corresponds to a TCAP message exchange between the SRP and the SCP.
Common Format
The configuration parameters for configuring EDR output including filename structure
and location is defined in the configuration documentation for the EdrApp
which is
a base component provided by the n2svcd
package.
All EDRs are written by the EdrApp
application using its file and record formatting rules.
Refer to the n2svcd
base documentation for more details on configuring and managing EDR
streams, and on the syntax/encoding details for N-Squared EDRs.
SETUP-ERR EDR
The SETUP-ERR
EDR Event is written in cases where the connection could not be setup correctly.
Example:
2023-11-05 00:16:48.900<kirby~SRP~1699141920~1216662f,kirby~Logic~1699141920~12062b6b>SETUP-ERR|REASON=Abandoned
Field | Type | Description |
---|---|---|
SETUP-ERR
|
String | [Required] The reason why the channel setup failed. |
SRP-ARI EDR
The SRP-ARI
EDR Event indicates that the SRP sought assistance from an SCP to perform INAP control of the session.
Example:
2018-05-22 03:44:30.191<2771>SRP-ARI|CORRELATION_ID=860|SCCP_DGT_DIGITS=6400123456|SCCP_DGT_NOA=
→ |SCCP_DGT_NP=1|SCCP_DGT_TT=2|SCCP_DPC=4114|SCCP_DRI=0|SCCP_DSSN=106|SCP_ID=1|SIGTRAN_APP=SIGTRAN
Field | Type | Description |
---|---|---|
CALL_ID
|
Integer | [Required] The SIP Call ID for the A-Leg associated with this interaction. |
CORRELATION_ID
|
Integer | [Required] The correlation ID from SIP INVITE called-party or other fields. |
SCCP_DGT_DIGITS
|
[0-9A-F]+
|
The SCCP Destination Global Title digits for the SCP, if present. |
SCCP_DGT_NOA
|
Integer | The SCCP Destination Global Title Nature of Address for the SCP, if present. |
SCCP_DGT_NP
|
Integer | The SCCP Destination Global Title Numbering Plan for the SCP, if present. |
SCCP_DGT_TT
|
Integer | The SCCP Destination Global Title Translation Type for the SCP, if present. |
SCCP_DPC
|
Integer | The SCCP Destination Point Code for the SCP, if present. |
SCCP_DRI
|
Integer | [Required] The SCCP Destination Routing Indicator for the SCP. |
SCCP_DSSN
|
Integer | The SCCP Destination Subsystem Number for the SCP, if present. |
SCP_ID
|
[0-9A-F]+
|
[Required] The ID for the SCP selected to handle this call as configured in .
|
SIGTRAN_APP
|
String | [Required] The internal application name used to route this INAP interaction. |
SRP-PA EDR
The SRP-PA
EDR Event indicates that the SRP received a PlayAnnouncement instruction from the INAP SCP controlling this session.
Example:
2018-05-22 03:44:33.268<2771>SRP-PA|MESSAGE_ID=25046|VARIABLE_PARTS=NUMBER:2589
Field | Type | Description |
---|---|---|
LANGUAGE_ID
|
Integer | The language ID (if supplied by the SCP) for this interaction in an INAP extension. |
LANGUAGE
|
String | The name of the default or SRP-specified language. |
MESSAGE_ID
|
Integer | The single Elementary Message ID supplied in the interaction request. |
MESSAGE_IDS
|
Array | A sequence of Elementary Message IDs supplied in the interaction request. |
SEQUENCE
|
Integer |
An integer which starts at 1 and increments for each interaction within the call.
|
VARIABLE_PARTS
|
Array |
A sequence of variable parts supplied in the interaction request. Each part is recorded as [Type]:[Value], see details below. |
SRP-PA-E EDR
The SRP-PA-E
EDR Event indicates that the SRP sent a PlayAnnouncement-Error to the INAP SCP controlling this session.
Example:
2018-05-22 03:44:33.268<2771>SRP-PA-E|ERROR_CODE=13
Field | Type | Description |
---|---|---|
ERROR_CODE
|
Integer | Any of the relevant error codes defined in INAP CS-1. |
SRP-SRR EDR
The SRP-SRR
EDR Event indicates that the SRP sent a SpecializedResourceReport to the INAP SCP controlling this session.
Example:
2018-05-22 03:44:33.268<2771>SRP-SRR|
No further EDR fields are supported for this EDR event.
SRP-PACUI EDR
The SRP-PACUI
EDR Event indicates that the SRP received a PromptAndCollectUserInformation instruction from the INAP SCP controlling this session.
Example:
2018-05-22 03:44:30.344<2771>SRP-PACUI|INTERRUPTABLE=1|MAX_DIGITS=16|MESSAGE_ID=25126|MIN_DIGITS=4
Field | Type | Description |
---|---|---|
CANCEL_DIGIT
|
[0-9A-F]
|
The Cancel Input Digit requested by the SCP for the interaction (if any). |
END_DIGIT
|
[0-9A-F]
|
The End of Input Digit requested by the SCP for the interaction (if any). |
FIRST_DTO
|
Integer |
The timeout in seconds allowed for first digit entry. Can only be present if this is a prompt-and-collect interaction. |
INTER_DTO
|
Integer |
The timeout in seconds allowed for second-or-subsequent digit entry. Can only be present if this is a prompt-and-collect interaction. |
INTERRUPTABLE
|
0 /1
|
Can this interraction be interrupted by digit input. Can only be present if this is a prompt-and-collect interaction. |
LANGUAGE_ID
|
Integer | The language ID supplied by the SCP for this interaction in an INAP extension. |
LANGUAGE
|
String | Our mapped internal name for the supplied language ID. |
MAX_DIGITS
|
Integer |
The maximum number of digits which may be entered during this interaction. Can only be present if this is a prompt-and-collect interaction. |
MESSAGE_ID
|
Integer | The single Elementary Message ID supplied in the interaction request. |
MESSAGE_IDS
|
Array | A sequence of Elementary Message IDs supplied in the interaction request. |
MIN_DIGITS
|
Integer |
The minumum number of digits which must be entered during this interaction. Can only be present if this is a prompt-and-collect interaction. |
SEQUENCE
|
Integer |
An integer which starts at 1 and increments for each interaction within the call.
|
VARIABLE_PARTS
|
Array |
A sequence of variable parts supplied in the interaction request. Each part is recorded as [Type]:[Value], see details below. |
SRP-PACUI-R EDR
The SRP-PA
EDR Event indicates that the SRP received a PlayAnnouncement instruction from the INAP SCP controlling this session.
Example:
2018-05-22 03:44:33.247<2771>SRP-PACUI-R|COLLECTED_DIGITS=2589|DIGITS_RESPONSE=2589
Field | Type | Description |
---|---|---|
COLLECTED_DIGITS
|
[0-9A-D*#]
|
The original digits collected by the SRP from the A-Leg session. Hex Digits will be in upper-case. May contain * and #. |
DIGITS_RESPONSE
|
[0-9A-F]
|
The digits returned to the SRP in the PACUI-Response. Star and Hash are translated to Hex Digits. All Hex Digits will be in upper-case. |
SRP-PACUI-E EDR
The SRP-PACUI-E
EDR Event indicates that the SRP sent a PromptAndCollectUserInformation-Error to the INAP SCP controlling this session.
Example:
2018-05-22 03:44:33.268<2771>SRP-PACUI-E|ERROR_CODE=4
Field | Type | Description |
---|---|---|
ERROR_CODE
|
Integer | Any of the relevant error codes defined in INAP CS-1. |
Variable Part Types
The VARIABLE_PARTS
fields in the SRP-PA and SRP-PACUI event type EDRs are a comma-separated
list of the variable parts to be constructed and played according to the relevant language
Codec construction rules.
Example: VARIABLE_PARTS=NUMBER:2589,INTEGER:3
.
The following types of Variable Parts are supported:
Type | Value | Description |
---|---|---|
INTEGER
|
Integer | A value in the range 0-214748364. |
NUMBER
|
[0-9A-F]
|
A sequence of hexadecimal digits. Configuration may be used to map two of these digits to * and/or # .
|
TIME
|
<HHMM> | A 24-hour time in HHMM format. |
DATE
|
<YYMMDD> | A date in YYMMDD format. |
PRICE
|
<DDDDDDCC> | A price in cents, without decimal point. |