4.344 ent-scr-opc

Use this command to add an allowed OPC screening reference and associated attributes (originating point code, next screening function identifier, next screening function reference) to the allowed OPC entity set. One or more OPCs may be associated with the allowed OPC screening reference. Each OPC listed in this entity set is allowed to send SS7 messages to the customer’s network.

Parameters

nsfi (mandatory)
This parameter specifies the next screening category that is used in the gateway screening process, or it indicates that the gateway screening process should stop.
Range:
blkdpc
Blocked DPC is the next screening category.
blkopc
Blocked OPC is the next screening category.
cgpa
Allowed CGPA is the next screening category.
dpc
Allowed DPC is the next screening category.
sio
Allowed SIO is the next screening category.
stop
The gateway screening process ends and the message proceeds through normal routing.
sr (mandatory)
Screening reference. A set of one or more allowed OPCs.
Range:
ayyy

1 alphabetic character followed by up to 3 alphanumeric characters

actname (optional)
Name of the gateway screening stop action set. Stop actions must be administered using this parameter in conjunction with the gateway screening stop action table (see chg-gws-actset and rtrv-gws-actset ).
Range:
ayyyyy

1 alphabetic character followed by up to 5 alphanumeric characters

area (optional)
ITU international area. The area in the point code represented by zone-area-id.
Range:
0 - 255, *, C

*—the full range of values from 0–255

C—continue

id (optional)
ITU international ID. The ID in the point code represented by zone-area-id. A
Range:
0 - 7, *, C

*—the full range of values from 0–7

C—continue

mna (optional)
16-bit ITU national main number area. The mna in the point code represented by un-sna-mna.
Range:
0---31, *, C

*---the full range of values from 0--31

C—continue

msa (optional)
24-bit ITU-national main signaling area value. The msa of the point code represented by msa-ssa-sp.
Range:
0 - 255, *, C

*—the full range of values from 0–255

C—continue

nc (optional)
Network cluster value. This parameter specifies one or more nc values for the network indicator and network cluster member values specified in the ni and ncm parameters. It specifies the nc of the point code represented by ni-nc-ncm.
Range:
0 - 255, *, C

*—the full range of values from 0–255

C—continue

ncm (optional)
Network cluster member value. This parameter specifies one or more ncm values for the network indicator and network cluster values identified in the ni and nc parameters. It specifies the ncm of the point code represented by ni-nc-ncm.
Range:
0 - 255, *, C

*—the full range of values from 0–255

C—continue

ni (optional)
Network indicator value. This parameter specifies one or more ni values for the network cluster and network cluster member values identified in the nc and ncm parameters. It specifies the ni of the point code represented by ni-nc-ncm.
Range:
0 - 255, *, C

*—full range of values from 0-255

C—continue

npc (optional)
ITU national point code.

Note:

Gateway screening allows the ITU national point code to be displayed and entered in the database only as a single number. For multiple-part ITU national point codes, see Converting ITU National Point Code Formats for information on converting the point code format.
Range:
0 - 16383, *, C

*—full range of values from 0-255

C—continue

nsr (optional)
Next screening reference. This parameter indicates which screening reference in the specified screening category (nsfi) is to be used in the screening process.
Range:
ayyy

1 alphabetic character followed by up to 3 alphanumeric characters

Default:
No value given
pcst (optional)
Point code subtype. This parameter indicates whether the specified ITU international or ITU national point code has no subtype prefix or has the spare point code prefix (s-).
Range:
none
s
Default:
none
sna (optional)
16-bit ITU national sub number area. The sna in the point code represented by un-sna-mna.
Range:
0---15, *, C

*---the full range of values from 0--15

C—continue

sp (optional)
24-bit ITU national signaling point. The sp in the point code represented by msa-ssa-sp.
Range:
0 - 255, *, C

*—full range of values from 0-255

C—continue

ssa (optional)
24-bit ITU national sub signaling area. The ssa in the point code represented by msa-ssa-sp.
Range:
0 - 255, *, C

*—full range of values from 0-255

C—continue

un (optional)
16-bit ITU-national unit number. The un of the point code represented by un-sna-mna.
Range:
0---127, *, C

*---the full range of values from 0--127

C—continue

zone (optional)
ITU international zone. The zone in the point code represented by zone-area-id.
Range:
0 - 7, *, C

*—full range of values from 7

C—continue

Example

ent-scr-opc:sr=iec:nsfi=stop

ent-scr-opc:sr=iec:ni=240:nsfi=sio:nsr=iec

ent-scr-opc:sr=iec:ni=240:nc=010:ncm=010:nsfi=stop:actname=copy

ent-scr-opc:sr=iec:ni=240:nc=010:ncm=010:nsfi=dpc:nsr=iec

ent-scr-opc:sr=opc1:zone=1:area=2:id=3:nsfi=fail:pcst=none

ent-scr-opc:sr=opc1:zone=2:area=2:id=3:nsfi=fail:pcst=s

ent-scr-opc:sr=opc1:npc=128:nsfi=fail:pcst=s

ent-scr-opc:sr=opc2:un=1:sna=2:mna=1:nsfi=stop

Dependencies

Caution:

Even though gateway screening is in the screen test mode, as defined by the gwsa=off and gwsm=on parameters, the gateway screening action in the stop action set specified by the actname parameter of the screen set will be performed at the end of the screening process.

The Gateway Screening Rules table can contain a maximum of 360,600 rules.

A complete point code must be specified, using the ni-nc-ncm, zone-area-id, msa-ssa-sp, un-sna-mna or npc combination unless a value of c is specified.

The OPC specified by ni-nc-ncm, zone-area-id, msa-ssa-sp, un-sna-mna or the npc parameter must already exist in the screening reference or within an existing range of OPCs.

ANSI point code value 000-000-000 and ITU-International point code value 0-000-0 are not allowed.

If the actname parameter is specified, then the nsfi=stop parameter must be specified.

The value of the actname parameter must already be defined in the Gateway Screening Stop Action table with the chg-gws-actset command.

If the area=* parameter is specified, then the id=* parameter must be specified.

If the msa=* parameter is specified, then the ssa=* and the sp=* parameters must be specified.

If the un=* parameter is specified, then the sna=* and the mna=* parameters must be specified.

If the nc parameter is specified as a range, the ncm parameter must be specified as an asterisk or as the full range.

If the nc parameter is specified as a single value or a range, a single value must be specified for the ni parameter.

If the nc parameter is specified as an asterisk, the ncm parameter must be specified as an asterisk or as the full range.

If the ncm parameter is specified as a single value, or a range other than the full range of 0–255, the ni and nc parameters must be specified with a single value.

If the ni parameter is specified as an asterisk or as a range, the nc and ncm parameters must be specified as an asterisk or as the full range.

The nsfi and nsr parameters must point to an existing screen, or the nsfi=stop parameter must be specified, and the nsr parameter cannot be specified.

If the nsfi=stop parameter is not specified, then the nsr parameter must be specified.

The nsr parameter must be specified if nsfi is not equal to stop.

If the ssa=* parameter is specified, then the sp=* parameter must be specified.

If the sna=* parameter is specified, then the mna=* parameter must be specified.

If the zone=* parameter is specified, then the area=* and id=* parameters must be specified.

The Spare Point Code Support feature must be enabled before the pcst parameter can be specified.

The spare point code subtype prefix (s-) is not supported for ANSI point codes (parameters ni, nc, ncm) or for 24-bit ITU national point codes (parameters msa, ssa, sp) or for 16-bit ITU national point codes (parameters un, sna, mna). The pcst parameter cannot be specified for ANSI, ITU-N16 or ITU-N24 point codes.

If the nsfi=fail parameter is specified, then the nni, nc, nncm, narea, nzone, nid, nmsa, nssa, nsp, nun, nsna, nmna, and npc parameters cannot have a value of c.

The value of the nsfi parameter must be valid for the OPC entity type.

The Gateway Screening Stop Action table is corrupt or cannot be found.

The J7 support feature must be enabled before the un/ sna/ mna parameters are specified.

The J7 support feature must not be enabled before the msa/ ssa/ sp parameters are specified.

The GWSOA parameter combination should be known and valid.

Notes

When an OPC screening reference is created, the first entry for a point code must be c-c-c or c for the npc parameter. Subsequent entries must be specific point codes.

The character c is used in the OPC screens to allow the screening process to continue for messages with point codes that do not match any point codes in the OPC screens. When screening for a DPC and the point code being screened does notmatch any of the point codes in the DPC screens, the message is not rejected and the screening process continues.

There must be an entry in the OPC screens to allow the screening process to continue. This entry consists of a screening reference, point code, nsfi, and nsr . The point code is in the form of npc=c or subfields equal to c-c-c. When the character c is specified, the nsfi and nsr parameters must be specified.

If the character c is specified for the parameters ni-nc-ncm, zone-area-id, un-sna-mna or msa-ssa-sp, the character c is the only value that can be specified for all three parameters. For example, a point code c-c-255 is not allowed. The point code must be c-c-c . The asterisk value cannot be used with the character c (for example, a point code c-c-* is not allowed).

When the point code does not match any entries in the blocked OPC screens, the screening process is directed to the screening reference with the point code c or npc=c. The nsfi and nsr in this entry are examined to determine the next step in the screening process.

If the current ni-nc-ncm, zone-area-id, un-sna-mna or msa-ssa-sp is equal to c-c-c or npc=c, only the nsfi and nsr can be changed. Otherwise, only the OPC can be changed.

A range of values is specified by separating the values that define the range by two ampersands (&&); for example, ni=025&&100 specifies all network indicators for ANSI point codes from 25 - 100.

An asterisk cannot not be specified for a parameter value in this command unless an asterisk was specified for the parameter value in the original ent-scr-opc command.

If the screen set reaches 100% capacity (indicated by the 100% Full message), the system allows subsequent entries. An error occurs, however, when downloading the screen set to an LIM. Ensure that screen sets do not exceed 100% capacity. Remove screen set entries until the capacity is below 100%.

The spare point code subtype prefix (s-) is supported only for ITU international and ITU national point codes. The pcst parameter indicates whether the specified point code has no subtype prefix or has the spare point code prefix.

There is no feature dependency on ANSI point code parameters, i.e., ni, nc, ncm. The command can be entered successfully whether the J7 feature is enabled or not enabled.

Output

ent-scr-opc:sr=iec:nsfi=stop

    rlghncxa03w 04-01-07 11:43:04 EST  EAGLE 31.3.0
    ENT-SCR-OPC:  SCREEN SET AFFECTED - IEC  25% FULL
    ENT-SCR-OPC:  MASP A - COMPLTD 
;