4.127 chg-scr-sio

Use this command to change a specific screening reference in the allowed service indicator octet category. Attributes that may be changed are the network indicator, service indicator, message priority, heading codes, next screening function identifier, and next screening reference.

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 as the next screening reference (nsr) value in an ISUP screening reference for screening TUP message types.

Parameters

nic (mandatory)
Network indicator code. This parameter specifies whether the message originated from an international (0) or national (2) network.
Range:
0 - 3, *

*—the full range of values from 0–3

pri (mandatory)
Message priority. The new message priority in the SIO.
Range:
0 - 3, *

*—the full range of values from 0–3

Default:
No change to the current value
si (mandatory)
Service indicator. The type of message. The values are defined in Telcordia TR-NWT-000246.
Range:
00 - 15
sr (mandatory)
Screening reference. The point code’s unique screening reference name.
Range:
ayyy

1 alphabetic charahcter followed by up to 3 alphanumeric characters

actname (optional)
Action name. The 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.

none —remove an existing gateway screening stop action set from a gateway screening rule.

force (optional)
When there are more than 200 affected screensets, this parameter will decide whether to execute the command successfully or not.
Range:
yes
no
Default:
no
h0 (optional)
This parameter is mandatory if the si value is 00, 01, 02, or 03. Otherwise, the h0 parameter is undefined.
Range:
0 - 15, *

*—the full range of values from 0–15

Default:
Current value or undefined
h1 (optional)
This parameter is mandatory if the si value is 00, 01, 02, or 03. Otherwise, the h1 parameter is undefined.
Range:
0 - 15, *

*—the full range of values from 0–15

Default:
Current value or undefined
nh0 (optional)
New H0 heading code. The new H0 heading code for the screening reference specified in the sr parameter.
Range:
0 - 15, *

*—the full range of values from 0–15

Default:
No change to the current value
nh1 (optional)
New H1 heading code. The new H1 heading code for the screening reference specified in the sr parameter.
Range:
0 - 15, *

*—the full range of values from 0–15

Default:
No change to the current value
nnic (optional)
New network indicator code. The new nic for the screening reference specified.
Range:
0 - 3

*—the full range of values from 0–3

Default:
No change to the current value
npri (optional)
New message priority. The new message priority in the SIO.
Range:
0 - 3, *

*—the full range of values from 0–3

Default:
No change to the current value
nsfi (optional)
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
cdpa
Allowed CDPA
cgpa
Allowed CGPA
destfld
Allowed destination field (DESTFLD)
isup
ISUP message type (ISUP)
stop
The gateway screening process ends and the message proceeds through normal routing.
dpc
Allowed DPC
Default:
No change to the current value
nsi (optional)
New service indicator. The type of message for the specified screening reference. The values are defined in Telcordia TR-NWT-000246.
Range:
0 - 15
Default:
No change to the current value
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

Default:
No change to the current value

Example

chg-scr-sio:sr=iec:nic=1:si=1:h0=02:h1=03:pri=*:nh0=03&&04

chg-scr-sio:sr=iec:nic=1:si=3:pri=2:npri=1

chg-scr-sio:sr=iec:nic=1:si=3:pri=3:nnic=2:nsfi=stop:actname=copy

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.

At least one attribute must be changed.

If asterisk values or ranges are specified for the new heading codes, nothing that matches the entire combination of nic/nnic, si/nsi, and the specified new heading codes and priorities can already exist in the allowed SIO category for the screening reference.

An asterisk cannot 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.

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

If the actname parameter is specified, the nsr parameter cannot be specified.

The actname parameter value must already be defined in the Gateway Screening Stop Action table with the chg-gws-actset command. These values are shown in the ACT NAME field of the rtrv-gws-actset command output.

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

If the si parameter value is greater than 2, and the nsi parameter value is greater than 3, the nh0 and nh1 parameters are used to enter the required  h0 and h1 parameter values.

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

  • h0 (nh0) is a single value—h1 (nh1) can be a single value, range, or asterisk
  • h0 (nh0) is a range— h1 (nh1) can be an asterisk
  • h0 (nh0) is an asterisk— h1 (nh1) can be an asterisk

If the value specified for the nsi parameter is greater than 2, then the nh0 and nh1 parameters cannot be specified.

Use Table 4-14 to determine additional acceptable combinations of specified parameter values

Table 4-14 Supported chg-scr-sio Parameter Combinations

si value: nic value pri value h0 value: h1 value:

0

s, *

s, *, r

s

s, *, r

0

s, *

s, *, r

*, r

*

1, 2

s, *

s, *, r

s

s, *, r

1, 2

s, *

s, *, r

*, r

*

3-15

s, *

s, *, r

u

u

Legend
  • s = single value
  • r = range
  • * = asterisk
  • u = unspecified

If the nh0 or nh1 parameters are specified, the parameter values must be valid with the h0 or h1 values currently in the database.

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

The nnic, nsi, pri, and nh0/nh1 parameters must not already exist in the allowed SIO category.

The sr, nic, si, pri, and h0/h1 parameters for which attributes are to be changed must be in the allowed SIO category.

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

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

The Gateway Screening Stop Action table must be accessible.

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.

The specified screening reference must already exist in the database.

The GWSOA parameter combination should be known and valid.

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

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

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

Notes

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 the card. Ensure that screen sets do 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.

A network indicator value of 1 or 3 can be used in private networks.

A network indicator value of 3 can be used in some national networks to broaden the identity of a national network, but is usually spare.

If there are more than 200 affected screensets and the force parameter is set to yes, then the following warning message is displayed: "WARNING: Command may take up to 30 minutes" and the command proceeds successfully.

If there are more than 200 affected screensets and the force parameter is set to no, then the following notice is displayed: "Notice: Force parameter is required for affected screensets greater than 200" and the command is aborted.

Output

chg-scr-sio:sr=iec:nic=1:si=3:pri=2:npri=1 

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

When there are more than 200 affected screensets and the force parameter is no:

chg-scr-sio:sr=iec:nic=1:si=3:pri=2:npri=1:force=no
Command entered at terminal #17.
;

    tekelecstp 15-07-15 12:19:42 MST  EAGLE5 46.3.0.0.0-66.10.0
    CHG-SCR-SIO: MASP A - Cannot access standby fixed disk.
    CHG-SCR-SIO: MASP A - Simplex database update.
    Notice: Force parameter is required for affected screensets greater than 200
    CHG-SCR-SIO: MASP A - Command Aborted

When there are more than 200 affected screensets and the force parameter is yes:

chg-scr-sio:sr=iec:nic=1:si=3:pri=2:npri=1:force=yes
Command entered at terminal #17.
;

    tekelecstp 15-07-15 14:10:31 MST  EAGLE5 46.3.0.0.0-66.10.0
    CHG-SCR-SIO: MASP A - Cannot access standby fixed disk.
    CHG-SCR-SIO: MASP A - Simplex database update.
     WARNING: Command may take upto 30 minutes.
     -----------------------------------------
;
Command Accepted - Processing
    tekelecstp 15-07-15 14:10:31 MST  EAGLE5 46.3.0.0.0-66.10.0
    Notice: The number of screensets affected is 201.
    CHG-SCR-SIO: SCREEN SET AFFECTED - s1      1% FULL
    CHG-SCR-SIO: SCREEN SET AFFECTED - s10     1% FULL
    CHG-SCR-SIO: SCREEN SET AFFECTED - s100    1% FULL
    CHG-SCR-SIO: SCREEN SET AFFECTED - s101    1% FULL
    CHG-SCR-SIO: SCREEN SET AFFECTED - s102    1% FULL
    ---------------------------------------------------
    ---------------------------------------------------
    (List of affected screensets)

Related Topics