Configuring Gateway Screening Stop Action Sets

This procedure is used to add a gateway screening stop action set to the database or change an existing gateway screening stop action set using the chg-gws-actset command.

The gateway screening stop action sets define the actions that are performed on the MSU when the gateway screening process has stopped. These gateway screening stop action sets replace the copy and redirect parameters that have been used with the gateway screening commands when the gateway screening process stops.

The database can contain a maximum of 16 gateway screening stop action sets, with each set containing a maximum of 10 gateway screening stop actions. These are the current gateway screening stop actions.

COPY – copy the MSU for the STPLAN feature
RDCT – redirect the MSU for the DTA feature
CNCF – convert the PIP parameter with the GN parameter or the GN parameter with the PIP parameter in the ISUP IAM message for the Calling Name Conversion Facility feature.
TLNP – ISUP IAMs that pass gateway screening are processed either by the ISUP NP with EPAP feature or by the Triggerless LNP feature. This gateway screening stop action is discussed in more detail in the Configuring TLNP Gateway Screening Stop Action Sets procedure.
TINP – ISUP IAMs that pass gateway screening are intercepted by the Triggerless ISUP based Number Portability (TINP) feature and converted to include the routing number (RN) if the call is to a ported number. This gateway screening stop action can be specified only if the TINP stop action is assigned to a stop action set. If the TINP feature is enabled and turned on, the ISUP NP with EPAP feature (if the ISUP NP with EPAP feature is enabled) is overridden.
TIF, TIF2, TIF3 - TIF processing is applied to the messages that pass Gateway Screening. These gateway screening stop actions can be specified only if the tinp, tif, tif2, or tif3 stop action is already assigned to a gateway screening stop action set, or if any of these features are enabled.
- TIF Number Portability
- TIF SCS Forwarding
- TIF Simple Number Substitution
- TIF Selective Screening
SCCP - This gateway screening stop action is associated with the MTP Routed GWS Stop Action feature (part number 893035601) and can be specified only if this feature is enabled. If this stop action is configured and the MTP Routed GWS Stop Action feature is turned on, MTP routed SCCP UDT/XUDT messages that pass Gateway Screening are forwarded to the service modules for further processing.

Note:
The MTP Msgs for SCCP Apps feature (part number 893017401) takes precedence over the MTP Routed GWS Stop Action feature. If the MTP Msgs for SCCP Apps feature is enabled and turned on, all MTP routed SCCP messages are forwarded to the service modules for further processing whether or not the SCCP gateway screening stop action is specified.
NONE – no action is performed on the MSU.
DUP - This gateway screening stop action is used to duplicate the incoming MSU without affecting the processing of the original MSU. The duplicated MSU will be routed to a point code specified in the STPOPTS table under the GDPC parameter. The duplicated MSU is a priority 0 message.
STRIP - This gateway screening stop action is used to de-capsulate the MSU that was encapsulated by the REDIRECT stop action.

Caution:

When Gateway Screening is in the screen test mode, as defined by the linkset parameters gwsa=off and gwsm=on, any action in the gateway screening stop action sets created in this procedure will be performed.

The chg-gws-actset command uses these parameters.

:actid – The ID number of the gateway screening stop action set. The value of this parameter is from 4 to 16.

:actname – The name of the gateway screening stop action set consisting of 1 alphabetic character followed by up to 5 alphanumeric characters.

:force – The force=yes parameter must be specified when changing the gateway screening stop actions of an existing gateway screening stop action set.

:all=none – sets the value of each gateway screening stop action in the gateway screening stop action set to none. Refer to the procedure Removing Gateway Screening Stop Action Sets for information about using this parameter.

:act1 to :act10 – The ten gateway screening stop actions for each gateway screening stop action set. Gateway screening stop action 1 (act1) is the first stop action to be performed and gateway screening stop action 10 (act10) is the last stop action to be performed on the MSU.

The first three gateway screening stop action sets (actid=1, actid=2, and actid=3) are already defined with the existing gateway screening stop actions shown in Table 2-10.

Table 2-10 Gateway Screening Stop Action Definitions If the CNCF Feature Is Off

Gateway Screening Stop Action ID	Gateway Screening Stop Action Set Name	Stop Action 1	Stop Action 2	Action Performed by the EAGLE
1	copy	copy	—	copy the MSU for the STPLAN feature
2	rdct	rdct	—	redirect the MSU for the DTA feature
3	cr	copy	rdct	copy the MSU for the STPLAN feature and redirect the MSU for the DTA feature

The word none cannot be used for the actname parameter.

The force=yes parameter must be specified when changing an existing gateway screening stop action set.

If the copy gateway screening action is specified with the chg-gws-actset command, it must be specified with the act1 parameter.

A specific gateway screening stop action can only be specified once in a specific gateway screening stop action set. For example, the chg-gws-actset command cannot be executed if the copy gateway screening stop action is specified for gateway screening stop action parameters act1 and act2 as shown in this command example.

chg-gws-actset:actid=4:act1=copy:act2=copy

The value of the actname parameter must be unique. The value of this parameter is used by the actname parameter in the gateway screening commands and is shown in the NSR/ACT field of the outputs of the retrieve gateway screening commands to define the action that is performed on the MSU that passes gateway screening.

When a gateway screening stop action set is being entered in to the database for the first time, the name of the gateway screening stop action set (actname) must be added to the database before any gateway screening stop actions are assigned to the gateway screening stop action set.

Table 2-11 shows the combinations of parameter values that can be specified for act1, act2, and act3 parameters for gateway screening stop action sets 4 through 16.

Table 2-11 Gateway Screening Stop Action Set Parameter Combinations

ACT1	ACT2	ACT3
cncf
copy	cncf
copy	cncf	rdct
cncf	rdct
tinp
copy	tinp
tif
copy	tif
copy	cncf	tif
cncf	tif
tif2
copy	tif2
copy	cncf	tif2
cncf	tif2
tif3
copy	tif3
copy	cncf	tif3
cncf	tif3
sccp
copy	sccp
A blank entry in this table means that the ACT2 or ACT3 parameter has no value. The cncf stop action can be specified only if the CNCF feature is turned on. The tinp stop action can be specified only if the tinp stop action is assigned to a stop action set. The tif, tif2, or tif3 stop actions can be specified only if one or more of these features are enabled. TIF Number Portability TIF SCS Forwarding TIF Simple Number Substitution TIF Selective Screening The `sccp` stop action can be specified only if the MTP Routed GWS Stop Action feature is enabled.

Verify that the gateway screening feature is turned on, by entering the rtrv-feat command.

If the gateway screening feature is turned on, the GWS field should be set to on. In this example, the gateway screening feature is off.

Note:
The rtrv-feat command output contains other fields that are not used by this procedure. If you wish to see all the fields displayed by the rtrv-feat command, see the rtrv-feat command description inCommands User's Guide.

If the gateway screening feature is turned on, go to 3.
If the gateway screening feature is not turned on, shown by the GWS = off entry in the rtrv-feat command output in 1 , turn it on by entering this command.
chg-feat:gws=on

Note:
Once the gateway screening feature is turned on with the chg-feat command, it cannot be turned off.

When this command has successfully completed, this message should appear.
```
rlghncxa03w 06-10-25 15:26:30 GMT EAGLE5 36.0.0
CHG-FEAT: MASP A - COMPLTD
```
Display the gateway screening stop action sets in the database with the rtrv-gws-actset command.
Action IDs 1, 2, and 3 are predefined and cannot be changed. Action ID 1 contains only the COPY stop action. Action ID 2 contains the RDCT stop action. Action ID 3 contains the COPY and the RDCT stop action as shown in this output example.
```
rlghncxa03w 06-10-25 15:27:30 GMT EAGLE5 36.0.0
ACT  ACT    ACT  ACT  ACT  ACT  ACT  ACT  ACT  ACT  ACT  ACT
ID   NAME   1    2    3    4    5    6    7    8    9    10
--   ------ ---- ---- ---- ---- ---- ---- ---- ---- ---- ----
1    copy   copy
2    rdct   rdct
3    cr     copy rdct

GWS action set table is (3 of 16) 19% full
```
Continue the procedure by performing one of these steps.
- The TINP stop action can be specified only if a gateway screening stop action set containing the TINP stop action must be shown in the rtrv-gws-actset output. Only two gateway screening stop action sets can contain the TINP stop action.
  - If only one gateway screening stop action contains the TINP stop action, continue the procedure with 7 to specify the TINP stop action for a gateway screening stop action set.
  - If no gateway screening stop action sets contain the TINP stop action, or two gateway screening stop action sets contain the TINP stop action, the TINP stop action cannot be specified for a gateway screening stop action set. Continue the procedure by specifying another stop action.
- The SCCP stop action can be specified if the MTP Routed GWS Stop Action feature is enabled, or if the SCCP stop action is shown in the rtrv-gws-actset output.
  - If only one gateway screening stop action contains the SCCP stop action, continue the procedure with 7 to specify the SCCP stop action for a gateway screening stop action set.
  - If no gateway screening stop action sets contain the SCCP stop action, continue the procedure with 4 to verify that the MTP Routed GWS Stop Action feature is enabled.
  - Only two gateway screening stop action sets can contain the SCCP stop action. If two gateway screening stop action sets contain the SCCP stop action, the SCCP stop action cannot be specified for a gateway screening stop action set. Continue the procedure by specifying another stop action.
- The CNCF, TIF, TIF2, or TIF3 stop actions or combinations of these stop actions can be specified for a gateway screening stop action set. Refer to Table 2-11 for the combinations that can be used. If the CNCF stop action will be specified for a gateway screening stop action set, continue the procedure with 5. If only the TIF, TIF2, or TIF3 stop actions will be specified for a gateway screening stop action set, continue the procedure with 6.
Enter this command to verify whether or not the MTP Routed GWS Stop Action feature is enabled.
rtrv-ctrl-feat:partnum=893035601

This is an example of the possible output.
```
rlghncxa03w 09-07-28 21:15:37 GMT EAGLE5 41.1.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
MTPRTD GWS Stop Action    893035601  on      ----

The following features have been temporarily enabled:

Feature Name              Partnum    Status  Quantity     Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name              Partnum
Zero entries found.
```
If the MTP Routed GWS Stop Action feature is not enabled, perform the Activating the MTP Routed GWS Stop Action Feature procedure to enable the MTP Routed GWS Stop Action feature.

After the Activating the MTP Routed GWS Stop Action Feature procedure has been performed, or if the rtrv-ctrl-feat output shows that the MTP Routed GWS Stop Action feature is enabled, continue the procedure with 7.
To specify the CNCF gateway screening stop action, the Calling Name Conversion Facility (CNCF) feature must be turned on. If the CNCF gateway screening stop action is shown in 3, or if the rtrv-feat output in 1 shows that the CNCF feature is on, continue the procedure with 6. If the CNCF feature is not turned on, shown by the CNCF = off entry in the rtrv-feat command output in 1, turn it on by entering this command.
chg-feat:cncf=on

Note:
Once the calling name conversion facility feature is turned on with thechg-feat command, it cannot be turned off.

When this command has successfully completed, this message should appear.
```
rlghncxa03w 06-10-25 15:29:30 GMT EAGLE5 36.0.0
CHG-FEAT: MASP A - COMPLTD
```
Continue this procedure by performing one of these steps.
- If the TIF, TIF2, or TIF3 stop actions will not be specified for the gateway screening stop action set, continue the procedure with 7.
- If the TIF, TIF2, or TIF3 stop actions will be specified for the gateway screening stop action set, and either the TIF, TIF2, or TIF3 stop actions are shown the rtrv-ctrl-feat output in 3, continue the procedure with 7.
- If the TIF, TIF2, or TIF3 stop actions will be specified for the gateway screening stop action set, and either the TIF, TIF2, or TIF3 stop actions are not shown the rtrv-ctrl-feat output in 3, continue the procedure with 6.
Display the features that are enabled by entering the rtrv-ctrl-feat command. The following is an example of the possible output.
```
rlghncxa03w 07-05-30 21:15:37 GMT EAGLE5 37.2.0
The following features have been permanently enabled:

Feature Name              Partnum    Status  Quantity
Command Class Management  893005801  off     ----
Intermed GTT Load Sharing 893006901  off     ----
XGTT Table Expansion      893006101  off     ----
XMAP Table Expansion      893007710  on      3000
Large System # Links      893005910  on      2000
Routesets                 893006401  on      6000
GSM MAP SRI Redirect      893014001  on      ----
ISUP NP with EPAP         893013801  on      ----
HC-MIM SLK Capacity       893012707  on      64

The following features have been temporarily enabled:

Feature Name Partnum Status Quantity Trial Period Left
Zero entries found.

The following features have expired temporary keys:

Feature Name Partnum
Zero entries found.
```
If you wish to specify the TIF, TIF2, or TIF3 stop actions, one or more of these features must be enabled.
- TIF Number Portability
- TIF SCS Forwarding
- TIF Simple Number Substitution
- TIF Selective Screening
If the TIF Number Portability, TIF SCS Forwarding, or TIF Simple Number Substitution features are enabled, the TIF, TIF2, and TIF3 stop actions can be specified. Continue the procedure with 7.

The TIF Number Portability, TIF SCS Forwarding, or TIF Simple Number Substitution features must be enabled. If these features are not enabled, perform the procedures in Number Plan Processor Guide to enable at least one of these features. After the TIF Number Portability, TIF SCS Forwarding, or TIF Simple Number Substitution features have been enabled, continue the procedure with 7.
Add the gateway screening stop action to the database by using the chg-gws-actset command.
Table 2-11 shows the parameter combinations that can be used for the stop action parameters (act1 - act10).

chg-gws-actset:actid=4:actname=cncf:act1=cncf

chg-gws-actset:actid=5:actname=cpcncf:act1=copy:act2=cncf

chg-gws-actset:actid=6:actname=cncfrd:act1=cncf:act2=rdct

chg-gws-actset:actid=7:actname=cpcfrd:act1=copy:act2=cncf:act3=rdct

chg-gws-actset:actid=8:actname=cptinp:act1=copy:act2=tinp

chg-gws-actset:actid=9:actname=tinp:act1=tinp

chg-gws-actset:actid=10:actname=tif1:act1=tif

chg-gws-actset:actid=11:actname=tif2:act1=copy:act2=tif2

chg-gws-actset:actid=12:actname=tif3:act1=copy:act2=tif3

chg-gws-actset:actid=13:actname=sccpa:act1=sccp

chg-gws-actset:actid=14:actname=sccpb:act1=copy:act2=sccp

If an existing gateway screening stop action set is being changed, the force=yes parameter must be specified with the chg-gws-actset command.

The force=yes parameter can be specified with the chg-gws-actset command if a new GWS stop action set is being created, but is not necessary.

The actname parameter must be specified for a new GWS stop action set. The actname parameter is not required, but can be specified, if an existing stop action set is being changed.

If the actname parameter value is different from what is shown in the rtrv-gws-actset output for the GWS stop action set being changed, the name of the GWS stop action set will be changed to the new actname parameter value (see the first Caution).

Caution:

Changing the name of an existing GWS stop action set will prevent the actions defined in the GWS stop action set from being used to process the MSUs that pass gateway screening. If the name of the GWS stop action set is changed, enter the gateway screening retrieve commands (rtrv-scrset, rtrv-scr-opc, rtrv-scr-blkopc, rtrv-scr-sio, rtrv-scr-dpc, rtrv-scr-blkdpc, rtrv-scr-destfld, rtrv-scr-isup, rtrv-scr-cgpa, rtrv-scr-tt, rtrv-scr-cdpa, and rtrv-scr-aftpc) with the actname parameter and the old GWS stop action set name to identify the screens that need to be changed to use the new GWS stop action set name. To change these screens, perform the appropriate procedures in this user's guide.

Caution:

Caution must be used when changing the stop actions in existing gateway screening stop action sets because these gateway screening stop action sets may be used by one or more gateway screening rules. Changes in the existing gateway screening stop action sets will change how MSUs that pass gateway screening are processed.

Caution:

Caution must be used when specifying the RDCT stop action in an existing GWS stop action set. Specifying the RDCT stop action for Allowed OPC screens containing the adjacent point code of a linkset, for Allowed SIO screens containing the service indicator values 1 (SI=1) or 2 (SI=2), or for Allowed DPC screens containing the EAGLE's point code can cause signaling link failures. To verify whether or not the GWS stop action set name used in this procedure is referenced by these screens, enter the rtrv-scr-opc, rtrv-scr-sio, or rtrv-scr-dpc commands, with the actname parameter and the GWS stop action set name used in this procedure.

When each of these commands have successfully completed, this message should appear.
```
rlghncxa03w 06-10-25 15:30:30 GMT EAGLE5 36.0.0
CAUTION: GWS action set may be referenced by one or more GWS rules
CHG-GWS-ACTSET: MASP A - COMPLTD
```

Verify the changes using the rtrv-gws-actset command.

This is an example of the possible output.

rlghncxa03w 09-07-25 15:31:30 GMT EAGLE5 41.1.0
ACT  ACT    ACT  ACT  ACT  ACT  ACT  ACT  ACT  ACT  ACT  ACT
ID   NAME   1    2    3    4    5    6    7    8    9    10
--   ------ ---- ---- ---- ---- ---- ---- ---- ---- ---- ----
1    copy   copy      
2    rdct   rdct      
3    cr     copy rdct 
4    cncf   cncf      
5    cpcncf copy cncf 
6    cncfrd cncf rdct 
7    cpcfrd copy cncf rdct
8    cptinp copy tinp
9    tinp   tinp
10   tif1   tif
11   tif2   copy tif2
12   tif3   copy tif3
13   sccpa  sccp
14   sccpb  copy sccp

GWS action set table is (14 of 16) 88% full

Backup the new changes using the chg-db:action=backup:dest=fixed command.

These messages should appear, the active Maintenance and Administration Subsystem Processor (MASP) appears first.

BACKUP (FIXED) : MASP A - Backup starts on active MASP.
BACKUP (FIXED) : MASP A - Backup on active MASP to fixed disk complete.
BACKUP (FIXED) : MASP A - Backup starts on standby MASP.
BACKUP (FIXED) : MASP A - Backup on standby MASP to fixed disk complete.

Figure 2-16 Configure Gateway Screening Stop Action Sets - Sheet 1 of 4

Figure 2-17 Configure Gateway Screening Stop Action Sets - Sheet 2 of 4

Figure 2-18 Configure Gateway Screening Stop Action Sets - Sheet 3 of 4

Figure 2-19 Configure Gateway Screening Stop Action Sets - Sheet 4 of 4