inh-alm

4.370 inh-alm

Use this command to inhibit the reporting of alarms for the given device. Inhibited alarms will not generate unsolicited output or cause alarm indicators to be turned on. All rept-stat-xxx commands continue to display the alarm with an indication that the device has its alarms inhibited.

The frame alarm LEDs are off for the inhibited alarm. This command does not affect the alarm counts on the VT320 banner. The fourth box on the right of the VT320 Control Area indicates the number of devices in the system with inhibited alarms.

Parameters

Note:

See Point Code Formats and Conversion for a detailed description of point code formats, rules for specification, and examples.

dev (mandatory)

Device. The device where the reporting of alarms is to be inhibited.

Range:

applsock: IP gateway application socket
as: IP gateway Application Server
card: Cards in the database
cdt: Customer defined troubles
clock: System clock
dlk: IP ports on the VSCCP, EROUTE, MCP, and FC-capable cards
e1port: E1 port on E5-E1T1-B cards
enet: Ethernet
ls: Linksets
lsmsconn: Communication link between the LSMS and the EMS
route: Route
rtx: Exception Route
slk: Signaling links
t1port: T1 port on E5-E1T1, or E5-E1T1-B cards
tps: TPS subsystem
trm: Terminals

asname (optional)

Gateway Application Server name. Used with the dev=as parameter to inhibit alarms for the named Application Server.

Range:: ayyyyyyyyyyyyyy
up to 15 alphanumeric characters; the first character must be a letter

cic (optional)

Starting Circuit Identification Code. Used with the ecic parameter to define the CIC range that is used as an exception routing criterion for the specified exception route.

Range:: 0 - 16383

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 /dpcn16 (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 destination point code with subfields main signaling area-sub signaling area-signaling point. The prefix subfield indicates a private point code.

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

dpcn16 (optional)

16-bit ITU national point code with subfields unit number sub number area main number area (un-sna-mna). The prefix subfield indicates a private point code.

Range:: p--, 000---127; Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).; prefix---p; un---000---127; sna---000---15; mna---000---31

dur (optional)

Duration. The period for which the alarms are inhibited.

Range:

perm: permanent inhibition of an alarm
temp: temporary inhibition of an alarm
timed: inhibition of an alarm for a specified duration

Note:

If the dur=temp parameter is specified, then an alarm inhibit lasts as long as the alarm is present. If the system boots or switches over, then the alarm inhibit is removed. If the dur=perm parameter is specified, then the alarm inhibit remains after the alarm is cleared or is no longer present, and after a boot/switchover. The dur=timed parameter behaves the same as the dur=perm parameter, but for a set time period.

Default:: perm

e1port (optional)

Port ID. The E1 port on the specified E1 card.

This parameter is mandatory if the dev=e1port parameter is specified.

Range:: 1 - 8

ecic (optional)

Ending Circuit Identification Code. Used with the cic parameter to define the CIC range that is used as exception routing criteria for the specified exception route.

Range:: 0 - 16383

edate (optional)

Expiry date. The date on which a timed alarm inhibit expires, at the time specified in the etime parameter value.

Note:

This parameter is valid and required when the dur=timed parameter is specified.

Range:: 101 - 991231
Specify the date in the format of year, followed by month, followed by day (yymmdd).

etime (optional)

Expiry time. The time at which a timed alarm inhibit expires, on the date specified in the edate parameter value.

This parameter is valid and required when the dur=timed parameter is specified.

Range:: 0 - 2359
Specify the time in the format of hour followed by minute (hhmm).

force (optional)

Allows critical alarms to be inhibited on a device.

This parameter is mandatory if the lvl=crit parameter is specified.

The critalminh STP option must be turned on before this parameter can be specified.

Range:

yes
no

Default:

id (optional)

Identification number of the customer-defined trouble. Customer-defined troubles 1 - 4 are generated critical alarms and cannot be specified as values for this parameter.

Range:: 5 - 16

ilsn (optional)

Incoming Link Set Name. The name of the originating linkset. The parameter value is used as part of the exception routing criteria for the specified exception route.

Range:: ayyyyyyyyy
1 alphabetic character followed by up to 9 alphanumeric characters

link (optional)

Signaling link on the card specified in the loc parameter.

Synonym:: port
Range:: a, b, a1 - a31, b1 - b31; a1, a2, b1, b2 — dev=lsmsconn; a, b, a1-a31, b1-b31 — dev=slk for an E5-E1T1, or E5-E1T1-B; a1, b1 — dev=dlk for an FC-capable card; a, b — dev=enet

loc (optional)

The card location as stenciled on the shelf of the system.

Range:: 1101 - 1113, 1115, 1201 - 1218, 1301 - 1318, 2101 - 2118, 2201 - 2218, 2301 - 2318, 3101 - 3118, 3201 - 3218, 3301 - 3318, 4101 - 4118, 4201 - 4218, 4301 - 4318, 5101 - 5118, 5201 - 5218, 5301 - 5318, 6101 - 6118

lsn (optional)

Linkset name. The name of the linkset for which the report information is to be displayed.

Range:: ayyyyyyyyy
1 alphabetic character followed by up to 9 alphanumeric characters

lvl (optional)

The alarm severity level (critical, major, or minor).

Range:

crit
majr
minr

Default:

majr

opc (optional)

ANSI 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:

opca

Range:

0-255

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

zone—0–7

area—000–255

id—0-7

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

opc/opca/opci/opcn/opcn24/opcn16 (optional): Origination point code.

opci (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.

opcn (optional)

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 destination point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp). The prefix subfield 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

opcn16 (optional)

16-bit ITU national point code with subfields unit number sub number area main number area (un-sna-mna). The prefix subfield indicates a private point code (prefix-un-sna-mna).

Range:: p--, 000---127; Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).; prefix---p; un---000---127; sna---000---15; mna---000---31

si (optional)

Service Indicator. This parameter is used as the exception routing criterion for the specified exception route.

Range:: 0 - 15

sname (optional)

Gateway application socket. Used with the dev=applsock parameter to inhibit alarms for the named application socket.

Range:: ayyyyyyyyyyyyyy
1 to 15 alphanumeric characters

t1port (optional)

Port ID. This parameter is mandatory if the dev=t1port parameter is specified.

Range:: 1 - 8

trm (optional)

Terminal ID. The ID number of the terminal whose characteristics are to be retrieved and displayed.

Range:: 1 - 40

Example

inh-alm:dev=route:dpc=1-1-1:dur=perm:lvl=crit:force=yes

inh-alm:dev=rtx:dpc=1-101-1:opc=4-4-4

inh-alm:dev=route:dpc=1-1-1:dur=timed:lvl=crit:edate=050515:etime=2300:force=yes

inh-alm:dev=enet:loc=1201:port=a

inh-alm:dev=enet:loc=1101:port=a:dur=temp:lvl=minr

inh-alm:loc=1102:dev=dlk:port=a1

inh-alm:dev=rtx:dpcn16=121-10-15:opcn16=121-10-16

Dependencies

This command is not allowed in upgrade mode.

The parameters that can be specified with the dev parameter vary, depending on the value specified for the dev parameter as shown:

dev=(any value) — dur or lvl
dev=asname — as
dev=dpc/dpca/dpci/dpcn/dpcn24/dpcn16 — route
dev=id — cdt
dev=loc — card, dlk, e1port, slk, t1port, enet
dev=lsn — ls
dev=e1port — e1port
dev=link (link=a, b)— dlk, slk, enet
dev=link (link=a1, b1)— dlk (For FC-capable cards)
dev=link (link=a, b, a1, a2, b1, b2, a3, b3)— slk
dev=link (link=a1, a2, b1, b2)— lsmsconn
dev=sname — applsock
dev=t1port — t1port
dev=trm — trm

No other action command can be in progress when this command is entered.

The linkset specified by the lsn parameter must be equipped in the database.

This command will not execute while the signaling link is running either a Link Fault Sectionalization test or a Loopback test. An AST of LFS or LPBK must be cleared before signaling link alarms can be inhibited.

This command cannot be used to permanently inhibit XLIST point codes.

Before critical alarms can be inhibited, the STP option critalminh must be enabled. The chg-stpopts:critalminh=yes command enables this option.

Alarms cannot already be inhibited for the specified device.

The Device Alarm Inhibit table is corrupt or cannot be found.

The STP Options table is corrupt or cannot be found.

If the lvl=crit parameter is specified, the force=yes parameter must be specified.

When the dev=card parameter is specified, the loc parameter must be specified.

When the dev=dlk parameter is specified, the loc parameter must be specified.

When the dev=slk parameter is specified, the loc parameter and the link parameter must be specified.

When the dev=e1port parameter is specified, the loc and e1port parameters must be specified.

When the dev=t1port parameter is specified, the loc and t1port parameter must be specified.

When the dev=ls parameter is specified, the lsn parameter must be specified.

When the dev=trm parameter is specified, the trm parameter must be specified.

When the dev=cdt parameter is specified, the id parameter must be specified.

When the dev=lsmsconn parameter is specified, the link parameter must be specified.

When the dev=route parameter is specified, the dpc/dpca/dpci/dpcn/dpcn24/dpcn16 parameter must be specified.

When the dev=applsock parameter is specified, the sname parameter must be specified.

If the dev=as parameter is specified, the asname parameter must be specified.

If the sname parameter is specified, the socket name must exist in the IPAPSOCK table.

If a point code parameter is specified, the point code must exist in the Routing table.

If the dev=slk or dev=dlk parameter is specified, the specified link must exist in the database.

The card location that is specified in the loc parameter must be equipped.

The specified device type must be supported by the card in the specified card location.

The Origin-Based MTP Routing feature must be on before the dev=rtx parameter can be specified.

Permanent alarm inhibit is not allowed on the cluster PC if either the cluster or a member PC of the cluster is already alarm inhibited.

When the dur=timed parameter is specified, the edate and etime parameters must be specified.

If the dur parameter has a value other than timed, the edate and etime parameters cannot be specified.

The edate parameter value must be a date equal to or later than the current system date. If the current system date is specified, then the etime parameter value must be a time later than the current system time. If a date later than the current system date is specified, then the etime parameter value can be any valid time in the format hhmm.

This command cannot be used to change the level of inhibition on a device.

If the dev=enet parameter is specified, then the loc and port parameters must be specified.

The card specified by the loc parameter must be provisioned with an IPS, MCP, EROUTE, VSCCP, IPSG, IPLIM, IPLIMI, SS7IPGW, or IPGWI application.

The value specified for the e1port/t1port parameter must be in the range 1-8.

The link parameter must be valid for the selected device type.

The J7 Support feature must be enabled before the opcn16/dpcn16 parameters can be specified.

Notes

If critical alarms are inhibited, all alarms (critical, major, and minor) are disabled. Likewise, if major alarms are inhibited, both major and minor alarms are disabled.

The dur parameter allows alarms to be inhibited on a temporary basis. If a device has its alarms temporarily disabled, the device’s alarms are automatically enabled after the alarm clears.

In this command, only ITU-international and ITU national point codes support the spare point code subtype prefix (s-) and the private and spare point code subtype prefix (ps-). All of the point code types support the private (internal) point code subtype prefix (p-).

Output

inh-alm:dev=route:dpc=1-1-1:dur=perm:lvl=crit


    rlghncxa03w 04-02-23 13:20:59 EST  EAGLE 31.3.0
    Alarms are permanently inhibited. 
;
    rlghncxa03w 04-02-23 13:20:59 EST  EAGLE 31.3.0
    Command Completed. 
;

inh-alm:dev=rtx:dpc=1-101-1:opc=4-4-4


     stdcfg2b 06-05-27 20:20:35 EST  EAGLE 35.0.0
     Alarms are permanently inhibited
     Command Completed. 
;

inh-alm:dev=route:dpc=1-1-1:dur=timed:lvl=crit:edate=050515:etime=2300:force=yes


    tekelecstp 07‑02‑27 13:20:59 EST  EAGLE 35.6.0
    Alarms are timed inhibited. 
;
    tekelecstp 07‑02‑27 13:20:59 EST  EAGLE 35.6.0
    Command Completed 
;

inh-alm:dev=enet:loc=1201:port=a


     stdcfg2b 07-02-07 20:20:35 EST  EAGLE 35.6.0
     Alarms are permanently inhibited
     Command Completed. 
;

inh-alm:dev=enet:loc=1101:port=a:dur=temp:lvl=minr


    stdcfg2b 07-02-07 20:20:35 EST  EAGLE 35.6.0
    Temporary alarm inhibit level less than alarm level on device
    Command Completed. 
;

Related Topics