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:

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.