4.340 ent-scr-cgpa

Use this command to add a specific allowed calling party address (CGPA) screening reference in the CGPA entity set.

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:
cdpa
Allowed called party address is the next screening category.
stop
The gateway screening process ends and the message proceeds through normal routing.
tt
Allowed translation type is the next screening category.
ri (mandatory)
Routing indicator. This parameter provides routing instructions to the receiving signaling point. In gateway screening, messages may be screened based on the value of the routing indicator.
Range:
dpc
Allow a called party address with a routing indicator value of “DPC/SSN.”
gt
Screening stops and gateway screening is bypassed as a forced pass.
*
A full range of values.
sr (mandatory)
Screening reference. The screening reference name for the CgPA.
Range:
ayyy

1 alphabetic character followed by up to 3 alphanumeric characters

ssn (mandatory)
Subsystem number
Range:
1 - 255, *
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, *

*—the full range of values from 0–255

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

*—the full range of values from 0–7

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

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

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

*—the full range of values from 0–255

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, *

*—the full range of values from 0–255

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, *

*—the full range of values from 0–255

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, *

*—the full range of values from 0–255

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

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
sccpmt (optional)
SCCP message type
Range:
9
UDT
10
UDTS
17
XUDT
18
XUDTS
*
Default:
*
sna (optional)
16-bit ITU national sub number area. The sna in the point code represented by un-sna-mna.
Range:
0---15, *

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

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

*—the full range of values from 0–255

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

*—the full range of values from 0–255

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

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

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

*—the full range of values from 0–255

Example

ent-scr-cgpa:sr=iec:ni=240:nc=010:ncm=*:ssn=224:nsfi=aftpc:nsr=wrd5:ri=dpc

ent-scr-cgpa:sr=iec:ni=240:nc=010:ncm=*:ssn=224:nsfi=stop:ri=dpc:actname=copy

ent-scr-cgpa:sr=cdp1:ni=5:nc=5:ncm=5:ssn=1:ri=dpc:sccpmt=9:nsfi=sdpa:nsr=cdp1

ent-scr-cgpa:sr=cgpa:zone=1:area=2:id=3:ssn=1:sccpmt=9:ri=*:nsfi=stop:pcst=s

ent-scr-cgpa:sr=cgp1:un=1:sna=2:mna=1:ssn=1:sccpmt=9:nsfi=stop:ri=*

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, and must be one, and only one of the five point code parameter combinations: ni-nc-ncm, zone-area-id, un-sna-mna, msa-ssa-sp, or npc.

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

The new CGPA point code, ri, sccpmt, and ssn to be added can not already exist in the CGPA entity set.

The character c is not a valid value for the ni, nc, ncm, zone, area, id, msa,ssa, sp, un, sna, mna, and npc parameters.

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

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

If area=* is specified, id=* must be specified.

If msa=* is specified, ssa=* and sp=* must be specified.

If un=* is specified, sna=* and mna=* 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 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.

The screen referenced by nsfi and nsr must already exist.

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

When nsfi=stop is specified, the nsr parameter cannot be specified.

The nsfi=tt parameter can be specified only if the ri=gt parameter or the ri=* parameter is specified.

The nsfi=cdpa parameter can be specified only if the ri=dpc parameter or the ri=* parameter is specified.

If ssa=* is specified, sp=* must be specified.

If sna=* is specified, mna=* must be specified.

If zone=* is specified, area=* and id=* must be specified.

The specified value for the nsfi parameter is not valid for  cgpa screen.

The Gateway Screening Stop Action table must be accessible.

Valid values must be specified for the nsccpmt and sccpmt parameters.

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

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 .

If the screening reference is valid, but does not exist, a new CGPA screening table is created.

If the screening reference exists, a new rule is added to the CGPA screening table. Only one rule may exist for a given ni-nc-ncm/ssn/ri/sccpmt (or zone-area-id or npc ) combination. This implies that for a given combination, only one value of ri may be specified. The ri for a given combination can be dpc, gt, or *, but not dpc and gt independently.

If the screen set reaches 100% capacity (indicated by the 100% Full message), the system will allow subsequent entries. An error will occur, however, when downloading the screen set to a LIM. Screen sets should not exceed 100% capacity. Remove screen set entries until the capacity is below 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-cgpa command.

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 of 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 Support feature is enabled or not enabled.

Output

ent-scr-cgpa:sr=iec:ni=240:nc=010:ncm=*:ssn=224:nsfi=aftpc:nsr=wrd5:ri=dpc

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