ent-lg-event

4.321 ent-lg-event

Use this command to create a new LG event. The command class is TKLC_INTERNAL inheriting properties of DEBUG class. The Load Generator is supported on IPSG, IPLHC, IPGHC and SS7HC GPLs.

Parameters

dir (mandatory)

Type of Event (Tx or Rx)

Range:

Tx: Transmit Event
Rx: Receive Event

dpc (mandatory)

ANSI destination point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). The prefix subfield indicates a private point code (prefix-ni-nc-ncm).

Synonym:

dpca

Range:

p-, 000-255, *

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p-

The asterisk value (*) is not valid for the ni subfield.

When chg-sid:pctype=ansi is specified, ni = 000 is not valid.

When chg-sid:pctype=ansi is specified, nc = 000 is not valid if ni = 001–005.

When chg-sid:pctype=ansi is specified, nc = 000 is valid if ni = 006–255.

The point code 000-000-000 is not a valid point code.

dpc/dpca/dpci/dpcn/dpcn24 (mandatory): Destination point code

dpci (mandatory)

ITU international destination point code with subfields zone-area-id. The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-zone-area-id).

Range:

s-, p-, ps-, 0-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

dpcn (mandatory)

ITU national destination point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members) separated by dashes (m1-m2-m3-m4) as defined by the chg-stpopts:npcfmti flexible point code option. A group code must be specified when the ITUDUPPC feature is turned on (nnnnn-gc, m1-m2-m3-m4-gc). The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc).

Range:

s-, p-, ps-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

dpcn24 (mandatory)

24-bit ITU national point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp). The prefix indicates a private point code (prefix-msa-ssa-sp).

Range:

p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p

msa—000–255

ssa—000–255

sp—000–255

event (mandatory)

Range:: ayyyyyyyyy Up to 10 alphanumeric characters; the first character must be a letter

h0h1 (mandatory)

SNM Type

Range:

tfa
tfp
tfc
tfr
rct
upu

opc (mandatory)

ANSI originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm).

Range:

p-, 000-255, *

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p-

The asterisk value (*) is not valid for the ni subfield.

When chg-sid:pctype=ansi is specified, ni = 000 is not valid.

When chg-sid:pctype=ansi is specified, nc = 000 is not valid if ni = 001–005.

When chg-sid:pctype=ansi is specified, nc = 000 is valid if ni = 006–255.

The point code 000-000-000 is not a valid point code.

opc/opca/opci/opcn/opcn24 (mandatory): Originating Point Code

opci (mandatory)

ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id).

Range:

s-, p-, ps-, 0-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

opcn (mandatory)

ITU national originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4numbers (members) separated by dashes (m1-m2-m3-m4) as defined by the chg-stpopts:npcfmti flexible point code option. A group code must be specified when the ITUDUPPC feature is turned on (nnnnn-gc, m1-m2-m3-m4-gc). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4,prefix-m1-m2-m3-m4-gc).

Range:

s-, p-, ps-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

opcn24 (mandatory)

24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).

Range:

p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p

msa—000–255

ssa—000–255

sp—000–255

si (mandatory)

MSU Service Indicator

Range:

0 - 15

SI value:

0 = SNM

1,2, 6-12, 14 = TEST

3 = SCCP

4 = TUP

5 = ISUP

13 = BICC

15 = H248

cause (optional)

Cause Code for UPUs

Range:: 0 - 15
Default:: 0

class (optional)

Internal or External

Range:

int: Internal

cnglvl (optional)

Congestion Level for TFCs

Range:: 0 - 3
Default:: 0

cpc (optional)

ANSI capability point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm).

Synonym:

cpca

Range:

000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

When chg-sid:pctype=ansi is specified, ni = 000 is not valid.

When chg-sid:pctype=ansi is specified, nc = 000 is not valid if ni = 001–005.

When chg-sid:pctype=ansi is specified, nc = 000 is valid if ni = 006–255.

The point code 000-000-000 is not a valid point code.

cpc/cpca/cpci/cpcn/cpcn24 (optional): Capability point code. The code used by the SS7 protocol to identify a group of functionally related STPs in the signaling network to which the STP belongs.

cpci (optional)

Range:

s-, 0-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

Default:

No change to existing point code value.

cpcn (optional)

ITU national point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members) separated by dashes (m1-m2-m3-m4) as defined by the chg-stpopts:npcfmti flexible point code option. A group code must be specified when the ITUDUPPC feature is turned on (nnnnn-gc, m1-m2-m3-m4-gc). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc).

Range:

s-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

Default:

No change to existing point code value.

cpcn24 (optional)

24-bit ITU national point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).

Range:

000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

msa—000–255

ssa—000–255

sp—000–255

Default:

No change to existing point code value.

egta (optional)

End global title address. The end of a range of global title digits.

Range:: 1 - 21

maxcic (optional)

Maximum CIC Selector

Range:: 0 - 4294967295
Default:: 4294967295

maxsize (optional)

Maximum Service Message SIF Size

Range:: 0 - 4095

maxsls (optional)

Maximum SLS selector

Range:: 0–255 -ANSI
0-15 -ITU
Default:: 255 -ANSI
15 -ITU

mincic (optional)

Minimum CIC Selector

Range:: 0 - 4294967295
Default:: 0

minsize (optional)

Minimum Service Message SIF Size

Range:: 0 - 4095
Default:: 60 -SCCP MSUs
40 -other MSUs
System Default:: 0

minsls (optional)

Minimum SLS Selector

Range:: 0–255 -ANSI
0-15 -ITU
Default:: 0

priority (optional)

Service Message Priority

Range:: 0 - 3
Default:: 0

ri (optional)

GTT or SSN

Range:

gtt
ssn

sclass (optional)

Range:: 0 - 1

sgta (optional)

Start of global title address. The beginning of a range of global title digits.

Range:: 1 - 21

ssn (optional)

Subsystem number. The application’s subsystem number. This attribute is composed of the decimal representation of the 1-byte field used in the SS7 protocol.

Range:: 2 - 255
Default:: 5
System Default:: 0

tt (optional)

Translation type.

Range:: 0 - 255
Default:: 100

type (optional)

Event Type

Range:: MSU
Default:: MSU

usrid (optional)

User ID for UPUs

Range:: 0 - 15
Default:: 5
System Default:: 0

Example

ent-lg-event:event=txisup1:dir=tx:type=msu:si=5:dpc=2-2-2:opc=1-1-1

ent-lg-event:event=txisup1:dir=tx:si=5:dpc=4-4-4:opc=3-3-3

ent-lg-event:event=rxisup1:dir=rx:dpc=3-3-3

Dependencies

If the mincic/maxcic parameter is specified, the si parameter must be 4 (tup), 5 (isup) or 13 (bicc).

If the tt/ssn/sgta/egta parameter is specified, the si=3 (sccp) parameter must be specified.

If the h0h1/cnglvl/cause/usrid/cpc parameter is specified, the si=0 (snm) parameter must be specified.

When failed to read LG Event table.

The event name specified shouldn't be an Eagle reserved name

The event and dir parameters must be specified.

The dpc parameter is mandatory with Rx event type

The opc, dpc, and si parameters are mandatory with Tx event.

The h0h1 parameter is mandatory for si=0 (snm) Tx event.

The mincic specified must be less than maxcic.

The minsize specified must be less than maxsize.

The minsls specified must be less than maxsls.

The value specified for the event parameter cannot already exist in the LG Event table.

ITU SLS must be less than 15.

The LG Event Table cannot be full.

A valid SIF size must be specified with SI value.

The same dpc parameter cannot be assigned to more than one Event of Rx type.

When other optional parameters are specified with Rx event

When sgta/egta/tt parameters are specified with RI=SSN for Tx event

The network type for the opc and dpc parameters must match.

If the ri=gt parameter is specified, then the sgta/egta parameters must be specified.

The lengths of the sgta and egta parameters must match.

The egta and sgta parameters must be specified together in the command.

The value specified for the egta parameter must be greater than or equal to the value specified for the sgta parameter.

Notes

Mandatory and optional event parameters can be organized into two groups: generic and event type specific parameters. The generic parameters are applicable to any event type whereas event type specific are applicable only to a specific event type.

Generic event parameters are shown below:

Table 4-25 ENT-LG-EVENT Generic Parameters

Parameter	Description	Mand/Opt	Applicable Event Direction	Valid Values
event	event name	M	Any
dir	transmit or receive	M	Any	Tx, Rx
class	internal or external	O	Tx	INT Default : INT
type	event type (msu)	O	Any	MSU Default: MSU

Configurable parameters specific to each type of event are shown below:

Common MSU related configuration parameters when DIR (direction) parameter is Rx, are as follows:

Table 4-26 ENT-LG-EVENT Rx MSU Event Type common Parameters

Parameter	Description	Mand/Opt	Valid Values
dpca	Destination PC (ANSI)	M
dpci	Destination PC (ITU)	M
dpcn	Destination PC (ITU National)	M
dpcn24	Destination PC (24 bit ITU national)	M

Common MSU related configuration parameters when DIR (direction) parameter is Tx, are as follows:

Table 4-27 ENT-LG-EVENT Tx MSU Event Type common Parameters

Parameter	Description	Mand/Opt	Valid Values
dpca	Destination PC (ANSI)	M
dpci	Destination PC (ITU)	M
dpcn	Destination PC (ITU National)	M
dpcn24	Destination PC (24 bit ITU national)	M
opca	Origination PC (ANSI)	M
opci	Origination PC (ITU)	M
opcn	Origination PC (ITU National)	M
opcn24	Origination PC (24 bit ITU national)	M
priority	Service message priority	O
minsls	Minimum SLS selector	O
maxsls	Maximum SLS selector	O
minsize	Minimum service message SIF size	O	0 – 4095
maxsize	Maximum service message SIF size	O	0 – 4095
si	MSU service indicator	M	0-SNM, 1,2, 6-12, 14 - TEST 3-SCCP, 4-TUP, 5-ISUP, 13-BICC 15-H248

For MSU event type, Service indicators (SI) can have different formats, and consequently unique parameters. Following tables list these parameters related to MSU event type and SI.

Table 4-28 ENT-LG-EVENT Tx MSU Event Type Specific Parameters (SI = 0)

Para meter	Description	Mand/Opt	Valid Values
h0h1	SNM type	M	TFA, TFP, TFC, TFR, RCT or UPU
cpca	concerned destination (ANSI)	O
cpci	concerned destination (ITU)	O
cpcn	concerned destination (ITU National)	O
cpcn24	concerned destination (24 bit ITU National)	O
cnglvl	congestion level for TFCs	O	0-3
cause	cause code for UPUs	O	0-15
usrid	user ID for UPUs	O	0-15

Table 4-29 ENT-LG-EVENT Tx MSU Event Type Specific Parameters (SI = 1, 2, 6-12, 14, 15)

Parameter	Description	Mand/Opt	Valid Values
None

Table 4-30 ENT-LG-EVENT Tx MSU Event Type Specific Parameters (SI = 3)

Parameter	Description	Mand/Opt	Valid Values
tt	Translation Type	O	0 – 255
ssn	Sub System Number	O	0 – 255
sgta	Start of global title address	O	1-21 digits
egta	End of global title address	O	1-21 digits
sclass	Class of service	O	0 – 1
ri	Routing Indicator (GT or SSN)	O	GT, SSN

Table 4-31 ENT-LG-EVENT Tx MSU Event Type Specific Parameters (SI = 4, 5, 13)

Parameter	Description	Mand/Opt	Valid Values
mincic	Minimum CIC selector	O	0..4294967295
maxcic	Maximum CIC selector	O	0..4294967295

Output

Related Topics