ent-scr-sio

Use this command to add an allowed SIO screening reference and associated attributes (network indicator, service indicator, message priority, H0 heading code, H1 heading code, next screening function identifier, next screening function reference) to the allowed SIO entity set.

Note:

To use TUP message type screening, an SIO screening reference with si=04 (TUP) must be defined in the SIO table. This SIO screening reference is specified in the ent-scr-isup command as the next screening reference (nsr) value in a screening reference for TUP message types

Parameters

nic (mandatory)

Network indicator code. NIC for the SIO screening reference specified in the sr parameter. The NIC is the last 2 bits of the subservice field of an SIO.

Range:: 0 - 3, *
*—full range of values from 0-3

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.
cdpa
cgpa: Allowed CGPA is the next screening category.
destfld: Allowed destination field (DESTFLD) is the next screening category.
dpc: Allowed DPC is the next screening category.
isup: ISUP message type (ISUP) is the next screening category.
stop: The gateway screening process ends and the message proceeds through normal routing.

pri (mandatory)

Message priority. A single priority, or the beginning of a range of priorities for the SIO screening reference specified by the sr parameter .

Range:: 0 - 3, *
*—full range of values from 0-3

si (mandatory)

Service indicator. SI for the SIO screening reference specified in the sr parameter. The SI is the first 4 bits of an SIO. The SS7 code directs the message to the MTP-user at the destination code.

Range:: 00 - 15

sr (mandatory)

The allowed SIO screening reference name. This parameter specifies a set of one or more si/nic/pri combinations.

Range:: ayyy
1 alphabetic character followed by up to 5 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

h0 (optional)

H0 heading code. New H0 heading code for the screening reference specified in the sr parameter.

Range:: 0 - 15, *
*—full range of values from 0-15
Default:: Value given if si value is 00, 01, 02

h1 (optional)

H1 Heading Code. H1 heading code for the screening reference specified in the sr parameter.

Range:: 0 - 15, *
*—full range of values from 0-15
Default:: Value given if si value is 00, 01, 02

nsr (optional)

Next screening reference. This parameter specifies 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

Example

ent-scr-sio:sr=iec:nic=1:si=1:h0=01&&03:h1=*:pri=*:nsfi=dpc:nsr=abc

ent-scr-sio:sr=iec:nic=1:si=3:pri=2:nsfi=stop

ent-scr-sio:sr=iec:nic=1:si=4:pri=3:nsfi=stop:actname=cncf

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.

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 si parameter is equal to 00, 01, or 02, the h0 and h1 parameters must be specified. Otherwise, the h0 parameter cannot be specified.

Valid combinations for the h0/h1 and nh0/nh1 parameters are:

h0 is a single value—h1 can be a single value, range, or an asterisk
h0 is a range— h1 can be an asterisk
h0 is an asterisk— h1 can be an asterisk

If the screening reference exists, the nic, si, h0/h1, and priorities to be added to the allowed SIO entity set for the SIO screening reference cannot exist in that allowed SIO entity set.

If asterisks or ranges are specified for the heading codes, nothing that matches the combination of nic, si, and the specified heading codes can already exist in the allowed SIO entity set for the screening reference.

If the screening reference does not exist, a new screening reference for the allowed SIO entity set is created.

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.

The values specified for the nsfi and si parameters must meet the mapping requirements as shown:

nsfi=destfld — si=00
nsfi=cdpa — si=03
nsfi=cgpa — si=03
nsfi=isup — si=05

Use Table 4-36 to determine the acceptable combination of the specified parameter values:

Table 4-36 Additional Valid ent-scr-sio Parameter Combinations

si value:	nic value	pri value	h0 value:	h1 value:
00	s, *	s, *, r	s	s, *, r
00	s, *	s, *, r	*, r	*
01, 02	s, *	s, *, r	s	s, *, r
01, 02	s, *	s, *, r	*, r	*
03-15	s, *	s, *, r	u	u
Legend s = single value r = range * = asterisk u = unspecified

The Gateway Screening Stop Action table must be accessible.

If the nsfi parameter has a value other than stop or fail, the nsr parameter must be specified and must exist.

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

If the si parameter is greater than 2, the h0 and h1 parameters must not be specified.

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

The GWSOA parameter combination should be known and valid.

For SEAS commands, the pri parameter specified must be in the range 0-3, *.

For SEAS commands, the h0 parameter specified must be in the range 0-15, *.

For SEAS commands, the h1 parameter specified must be in the range 0-15, *.

Notes

A range of values is specified by separating the values that define the range by two ampersands (&&); for example, pri=0&&2 specifies all message priorities for the range 0 - 2.

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

To use TUP message type screening, an SIO screening reference with si=04 (TUP) must be defined in the SIO table. To use ISUP message type screening, a rule with si=05 (ISUP) must be defined in the SIO table. To use a combined ISUP/TUP screen set for TUP and ISUP message screening, the SIO screening reference with si=4 and the SIO screening reference with si=5 must be two different screening references.

The h0 and h1 parameters cannot be specified if si is not equal to 00, 01, or 02.

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-sio command.

Output

ent-scr-sio:sr=iec:nic=1:si=1:h0=01&&03:h1=*:pri=*:nsfi=dpc:nsr=abc


    rlghncxa03w 04-02-14 16:45:50 EST  EAGLE 31.3.0
    ENT-SCR-SIO: SCREEN SET AFFECTED - SS01  25% FULL
    ENT-SCR-SIO: SCREEN SET AFFECTED - SS04  35% FULL
    ENT-SCR-SIO: MASP A - COMPLTD 
;

4.345 ent-scr-sio