chg-lg-event

4.93 chg-lg-event

Use this command to change an LG event’s characteristics. The command class is TKLC_INTERNAL inheriting properties of DEBUG class. The Load Generator is supported on IPSG, IPLHC, IPGHC and SS7HC GPLs.

Parameters

event (mandatory)

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

cause (optional)

Cause Code for UPUs

Range:: 0 - 15

cnglvl (optional)

Congestion Level for TFCs

Range:: 0 - 3

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.

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.

dpc (optional)

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 (optional): Destination point code

dpci (optional)

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 (optional)

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 (optional)

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

egta (optional)

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

Range:: 1 - 21

h0h1 (optional)

SNM Type

Range:

tfa
tfp
tfc
tfr
rct
upu

maxcic (optional)

Maximum CIC Selector

Range:: 0 - 4294967295

maxsize (optional)

Maximum Service Message SIF Size

Range:: 0 - 4095

maxsls (optional)

Maximum SLS selector

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

mincic (optional)

Minimum CIC Selector

Range:: 0 - 4294967295

minsize (optional)

Minimum Service Message SIF Size

Range:

0 - 4095

Default:

60 -SCCP MSUs

40 -other MSUs

minsls (optional)

Minimum SLS Selector

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

opc (optional)

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 (optional): Originating Point Code

opci (optional)

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 (optional)

ITU national originating 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 indicatesa 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 (optional)

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

priority (optional)

Service Message Priority

Range:: 0 - 3

ri (optional)

GTT or SSN

Range:

gtt
ssn

sclass (optional)

Class of service

Range:: 0 - 1

sgta (optional)

Start of global title address. This parameter specifies 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

usrid (optional)

User ID for UPUs

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

Example

chg-lg-event:event=txisup1:dpc=3-3-3

chg-lg-event:event=txisup1:dpc=2-2-2:opc=1-1-1

chg-lg-event:event=rxisup1:dpc=4-4-4

Dependencies

If the h0h1/cnglvl/cause/usrid/cpc parameter is specified, then the si parameter must have a value of 0 (snm).

If the mincic/maxcic parameter is specified, then the si must have a value of 4 (tup), 5 (isup), or 13 (bicc)

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

Failed to read LG Event table.

The LG Event name specified in the command must exist in the table

The event parameter is mandatory

The value specified for the mincic parameter must be less than the value specified for the maxcic parameter.

The minsize specified must be less than maxsize.

The value specified for the minsls parameter must be less than the value specified for the maxsls parameter.

ITU SLS must be less than 15

The OPC/DPC network type must match the provisioned OPC/DPC network type.

The value specified for the SIF size must be valid for the SI type.

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

The value specified for the event name cannot be an EAGLE reserved name.

At least one optional parameter must be specified

SI-specific parameters cannot be specified together in the command.

Optional parameters except dpc cannot be specified with Rx event

The lengths of the values specified for the sgta and egta parameters must match

The sgta and egta 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.

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

If the lengths of the values specified for the sgta/egta parameters do not match the provisioned length of the sgta parameter, then the minsize parameter must be specified.

Output

Related Topics