OCSS7 4.0.0 :: OCSS7 Installation and Administration Guide

On this page...

What are SS7 SGC notifications?
How are notifications different from alarms?
Generic notification attributes
Notification types

What are SS7 SGC notifications?

Notifications in the SS7 SGC stack alert the administrator about infrequent major events. Subsystems in the SS7 SGC stack emit notifications upon detecting an error condition or an event of high importance.

Management clients may use either Java JMX MBean or SNMP trap/notifications to receive notifications emitted by the SS7 SGC stack.

Below are descriptions of:

how notifications differ from alarms
generic notification attributes
attributes for specific notification types.

You can review the history of emitted notifications using commands exposed by the Command-Line Management Console, which is distributed with the SGC SS7 stack.

How are notifications different from alarms?

Notifications are very similar to Alarms in the SGC stack:

Notifications have attributes (general and notification type-specific attributes).
The SGC stack stores a history of emitted notifications.

The difference is that notifications are emitted (sent) whenever a particular event occurs; and there is no notion of active notifications or a notification being cleared.

Generic notification attributes

Notification attributes represent information about events that result in a notification being emitted. Each notification type has the following generic attributes, plus a group of attributes specific to that notification type (described in the following sections).

Attribute Description

Attribute	Description
`id`	unique notification identifier
`name`	name of notification type
`severity`	notification severity: `CRITICAL` — application encountered an error which prevents it from continuing (it can no longer provide services) `MAJOR` — application encountered an event which significantly impacts delivered services; some services may no longer be available `MINOR` — application reports an event which does not have significant impact on delivered services `INFO` — application reports an information event which does not have any impact on delivered services `CLEARED` — alarm has been cleared.
`timestamp`	timestamp when the event occurred
`parameters`	comma-separated list of `key=value` pairs specific to the notification. The catalogue below documents the parameters each notification may have.
`description`	short description of the notification
`longDescription`	longer description of the notification. Will be omitted if the SNMP node is not configured for `extended-traps`

id

unique notification identifier

name

name of notification type

severity

notification severity:

CRITICAL — application encountered an error which prevents it from continuing (it can no longer provide services)
MAJOR — application encountered an event which significantly impacts delivered services; some services may no longer be available
MINOR — application reports an event which does not have significant impact on delivered services
INFO — application reports an information event which does not have any impact on delivered services
CLEARED — alarm has been cleared.

timestamp

timestamp when the event occurred

parameters

comma-separated list of key=value pairs specific to the notification. The catalogue below documents the parameters each notification may have.

description

short description of the notification

longDescription

longer description of the notification.
Will be omitted if the SNMP node is not configured for extended-traps

Notification types

This section describes all notification types that can be emitted by the SGC cluster:

`mtpDecodeErrors`

This notification contains information about the number of badly formatted messages at the MTP layer and the number of messages directed to an unsupported MTP user. This notification is emitted periodically, with a summary of the number of errors in that period. It is not emitted if there are no errors.

The following table shows the basic attributes emitted with this notification:

Attribute Description Values of constants

Attribute	Description	Values of constants
`id`	unique notification identifier
`name`	name of notification type	`mtpDecodeErrors`
`severity`	notification severity	`INFO`
`timestamp`	timestamp when the event occurred
`description`	short description of the notification	`Periodic report on M3UA decode errors`

id

unique notification identifier

name

name of notification type

mtpDecodeErrors

severity

notification severity

INFO

timestamp

timestamp when the event occurred

description

short description of the notification

Periodic report on M3UA decode errors

Additionally, the parameters attribute is a basic attribute consisting of a comma-separated list of key=value pairs containing the following notification-specific parameters:

Attribute Description

Attribute	Description
`nodeId`	the affected node
`connectionId`	name of affected connection
`decodeFailuresLastTime`	number of message decode failures during report interval
`unsupportedUserFailuresTime`	number of messages with unsupported user part during report interval

nodeId

the affected node

connectionId

name of affected connection

decodeFailuresLastTime

number of message decode failures during report interval

unsupportedUserFailuresTime

number of messages with unsupported user part during report interval

This notification’s extended parameters have the following fixed values:

Attribute Description Value

Attribute	Description	Value
`longDescription`	long description of the notification	This notification contains information about the number of badly formatted messages at the MTP layer and the number of messages directed to an unsupported MTP user. This notification is emitted periodically, with a summary of the number of errors in that period. It is not emitted if there are no errors.

longDescription

long description of the notification

`sccpDecodeErrors`

This notification contains information about the number of badly formatted messages at the SCCP layer and the number of messages directed to a prohibited SSN. This notification is emitted periodically, with a summary of the number of errors in that period. It is not emitted if there are no errors.

The following table shows the basic attributes emitted with this notification:

Attribute Description Values of constants

Attribute	Description	Values of constants
`id`	unique notification identifier
`name`	name of notification type	`sccpDecodeErrors`
`severity`	notification severity	`INFO`
`timestamp`	timestamp when the event occurred
`description`	short description of the notification	`Errors in SCCP processing notification`

id

unique notification identifier

name

name of notification type

sccpDecodeErrors

severity

notification severity

INFO

timestamp

timestamp when the event occurred

description

short description of the notification

Errors in SCCP processing notification

Additionally, the parameters attribute is a basic attribute consisting of a comma-separated list of key=value pairs containing the following notification-specific parameters:

Attribute Description

Attribute	Description
`nodeId`	affected node
`decodeFailuresLastTime`	number of message decode failures during report interval
`ssnFailuresLastTime`	number of messages directed to prohibited SSN during report interval

nodeId

affected node

decodeFailuresLastTime

number of message decode failures during report interval

ssnFailuresLastTime

number of messages directed to prohibited SSN during report interval

This notification’s extended parameters have the following fixed values:

Attribute Description Value

Attribute	Description	Value
`longDescription`	long description of the notification	This notification contains information about the number of badly formatted messages at the SCCP layer and the number of messages directed to a prohibited SSN. This notification is emitted periodically, with a summary of the number of errors in that period. It is not emitted if there are no errors.

longDescription

long description of the notification

`tcapDecodeErrors`

This notification contains information about the number of badly formatted TCAP messages and the number of messages that the SGC is unable to forward to a TCAP stack (CGIN RA). This notification is emitted periodically, with a summary of the number of errors in that period. It is not emitted if there are no errors.

The following table shows the basic attributes emitted with this notification:

Attribute Description Values of constants

Attribute	Description	Values of constants
`id`	unique notification identifier
`name`	name of notification type	`tcapDecodeErrors`
`severity`	notification severity	`INFO`
`timestamp`	timestamp when the event occurred
`description`	short description of the notification	`Periodic report on TCAP decode errors`

id

unique notification identifier

name

name of notification type

tcapDecodeErrors

severity

notification severity

INFO

timestamp

timestamp when the event occurred

description

short description of the notification

Periodic report on TCAP decode errors

Additionally, the parameters attribute is a basic attribute consisting of a comma-separated list of key=value pairs containing the following notification-specific parameters:

Attribute Description

Attribute	Description
`nodeId`	affected node
`decodeFailuresLastTime`	number of message decode failures during report interval
`missingPeerLastTime`	number of messages that the SGC was unable to forward to a TCAP stack

nodeId

affected node

decodeFailuresLastTime

number of message decode failures during report interval

missingPeerLastTime

number of messages that the SGC was unable to forward to a TCAP stack

This notification’s extended parameters have the following fixed values:

Attribute Description Value

Attribute	Description	Value
`longDescription`	long description of the notification	This notification contains information about the number of badly formatted TCAP messages and the number of messages that the SGC is unable to forward to a TCAP stack (CGIN RA). This notification is emitted periodically, with a summary of the number of errors in that period. It is not emitted if there are no errors.

longDescription

long description of the notification

`tcapStackRegister`

This notification is emitted whenever a TCAP stack registers with the SGC.

The following table shows the basic attributes emitted with this notification:

Attribute Description Values of constants

Attribute	Description	Values of constants
`id`	unique notification identifier
`name`	name of notification type	`tcapStackRegister`
`severity`	notification severity	`INFO`
`timestamp`	timestamp when the event occurred
`description`	short description of the notification	`TCAP stack registered`

id

unique notification identifier

name

name of notification type

tcapStackRegister

severity

notification severity

INFO

timestamp

timestamp when the event occurred

description

short description of the notification

TCAP stack registered

Additionally, the parameters attribute is a basic attribute consisting of a comma-separated list of key=value pairs containing the following notification-specific parameters:

Attribute Description

Attribute	Description
`ssn`	registered SSN
`nodeId`	affected node
`stackIp`	IP address of the stack
`prefix`	allocated transaction prefix

ssn

registered SSN

nodeId

affected node

stackIp

IP address of the stack

prefix

allocated transaction prefix

This notification’s extended parameters have the following fixed values:

Attribute Description Value

Attribute	Description	Value
`longDescription`	long description of the notification	This notification is emitted whenever a TCAP stack registers with the SGC.

longDescription

long description of the notification

This notification is emitted whenever a TCAP stack registers with the SGC.

`tcapStackUnregister`

This notification is emitted whenever a TCAP stack deregisters from the SGC.

The following table shows the basic attributes emitted with this notification:

Attribute Description Values of constants

Attribute	Description	Values of constants
`id`	unique notification identifier
`name`	name of notification type	`tcapStackUnregister`
`severity`	notification severity	`INFO`
`timestamp`	timestamp when the event occurred
`description`	short description of the notification	`TCAP stack unregistered`

id

unique notification identifier

name

name of notification type

tcapStackUnregister

severity

notification severity

INFO

timestamp

timestamp when the event occurred

description

short description of the notification

TCAP stack unregistered

Additionally, the parameters attribute is a basic attribute consisting of a comma-separated list of key=value pairs containing the following notification-specific parameters:

Attribute Description

Attribute	Description
`ssn`	registered SSN
`nodeId`	affected node
`stackIp`	IP address of the stack
`prefix`	allocated transaction prefix

ssn

registered SSN

nodeId

affected node

stackIp

IP address of the stack

prefix

allocated transaction prefix

This notification’s extended parameters have the following fixed values:

Attribute Description Value

Attribute	Description	Value
`longDescription`	long description of the notification	This notification is emitted whenever a TCAP stack deregisters from the SGC.

longDescription

long description of the notification

This notification is emitted whenever a TCAP stack deregisters from the SGC.

Previous page Next page