Setting the Threshold for Reporting Gateway Screening Activity

This procedure is used to set the threshold for reporting these gateway screening activities using the set-gtwy-acthresh command.

The threshold for MSUs received on a gateway link set.
The threshold for MSUs rejected on a gateway link set because of screening.

These thresholds are set on a linkset basis. These gateway screening activities are reported only if the threshold is set and only if the threshold is reached.

The set-gtwy-acthresh command uses these parameters.

:intrvl – The examination period, in minutes, during which the gateway screening activity thresholds are to be tested.

:lsn – The name of the linkset that the thresholds are assigned to.

:recv – The threshold for MSUs received on the gateway link set.

:rej – The threshold for MSUs rejected on the gateway link set because of screening.

Canceling the RTRV-LS Command

Because the rtrv-ls command used in this procedure can output information for a long period of time, the rtrv-ls command can be canceled and the output to the terminal stopped. There are three ways that the rtrv-ls command can be canceled.

Press the F9 function key on the keyboard at the terminal where the rtrv-ls command was entered.
Enter the canc-cmd without the trm parameter at the terminal where the rtrv-ls command was entered.
Enter the canc-cmd:trm=<xx>, where <xx> is the terminal where the rtrv-ls command was entered, from another terminal other that the terminal where the rtrv-ls command was entered. To enter the canc-cmd:trm=<xx> command, the terminal must allow Security Administration commands to be entered from it and the user must be allowed to enter Security Administration commands. The terminal’s permissions can be verified with the rtrv-secu-trm command. The user’s permissions can be verified with the rtrv-user or rtrv-secu-user commands.

For more information about the canc-cmd command, go to Commands User's Guide.

Display the gateway screening thresholds in the database using the rtrv-gtwy-acthresh command.

The following is an example of the possible output.

rlghncxa03w 06-10-25 15:25:30 GMT EAGLE5 36.0.0
LSN      REJ     RECV   INTRVL
WY644368 10      1000   10
WY234456 25      2000   20
LN123556 25      2500   30
OP239900 -       5      5

Display the current linkset configuration using the rtrv-ls command.

The following is an example of the possible output.

rlghncxa03w 09-05-25 15:26:30 GMT EAGLE5 41.0.0
                                 L3T SLT              GWS GWS GWS
LSN          APCA   (SS7)  SCRN  SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsa1         240-020-000   ss01  1   1   yes A   1    off off off no    off
lsa2         240-030-000   ss02  1   2   no  C   3    on  on  on  yes   off
lsa3         240-040-000   ss03  1   3   yes C   5    off off off yes   off
ln123556     240-050-000   ss01  1   8   yes C   5    on  on  on  yes   off
op239900     240-060-000   ss01  1   7   yes C   5    on  on  on  yes   off
wy234456     240-070-000   ss01  1   6   yes C   5    on  on  on  yes   off
wy644368     240-080-000   ss01  1   5   yes C   5    on  on  on  yes   off

                                 L3T SLT              GWS GWS GWS
LSN          APCI   (SS7)  SCRN  SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsi1         1-111-1       ss01  1   1   yes A   1    off off off ---   ---
lsi2         1-111-2       ss02  1   2   no  C   3    on  on  on  ---   ---
lsi3         1-111-3       ss03  1   3   yes C   5    off off off ---   ---

                                 L3T SLT              GWS GWS GWS
LSN          APCN   (SS7)  SCRN  SET SET BEI LST LNKS ACT MES DIS SLSCI NIS
lsn1         11111         ss01  1   1   yes A   1    off off off ---   off
lsn2         11112         ss02  1   2   no  C   3    on  on  on  ---   off
lsn3         11113         ss03  1   3   yes C   5    off off off ---   off

Link set table is ( 9 of 1024)  1% full

If the GWSA value of the linkset is no, shown in the GWSACT column of the rtrv-ls output, perform the "Changing an SS7 Linkset" procedure in Database Administration - SS7 User's Guide to change the GWSA value of the linkset. Continue the procedure with 3.

If the GWSA value of the linkset is yes, continue the procedure with 3.

Set the gateway screening thresholds for a linkset using the set-gtwy-acthresh command.
For this example, enter this command.

set-gtwy-acthresh:lsn=lsa2:intrvl=20:rej=30:recv=2500

When this command has successfully completed, a message similar to the following should appear.
```
rlghncxa03w 06-10-25 15:29:30 GMT EAGLE5 36.0.0
SET-GTWY-TRHSHLD: MASP A - COMPLTD
```
Verify the changes using the rtrv-gtwy-acthresh command with the linkset name specified in step 3.
For this example, enter this command.

rtrv-gtwy-acthresh:lsn=lsa2

The following is an example of the possible output.
```
rlghncxa03w 06-10-25 15:30:30 GMT EAGLE5 36.0.0
LSN      REJ     RECV   INTRVL
LSA2     30      2500   20
```

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

The following 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-28 Set the Threshold for Reporting Gateway Screening Activity