chg-scr-tt

Use this command to change the attributes of a specific screening reference in the allowed translation type category. Attributes that can be changed are the translation type, next screening function identifier and next screening reference.

Parameters

sr (mandatory)

Screening reference. The point code’s unique screening reference name.

Range:: ayyy
1 alphabetic character followed by up to 3 alphanumeric characters

type (mandatory)

Translation type. The GTT type value in the CdPA.

Range:: 0 - 255, *
*—the full range of values from 0–255

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

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: cdpa, stop

cdpa: Allowed called party address is the next screening category.
stop: The gateway screening process ends and the message proceeds through normal routing.

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

ntype (optional)

New translation type. The GTT type value in the CdPA. A single value or a range of values can be specified.

Range:: 0 - 255, *
*—the full range of values from 0–255
Default:: No change to the current value

Example

chg-scr-tt:sr=iec:type=012:ntype=014

chg-scr-tt:sr=iec:type=012:ntype=014:nsfi=stop:actname=none

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.

The new translation type cannot already exist.

If an asterisk is specified for the new allowed type, no other translation types can exist in the screening table.

If the actname parameter is specified, 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 next screening function identifier and the next screening to be added must point to one or more existing screening references.

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

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

If the screening reference exists, the single value or range specified for the allowed type to be added to the TT screen for the allowed TT screening reference must not already exist in that TT screen.

The screening reference and translation type for which the attributes are to be changed must exist.

The current translation type must already exist.

The Gateway Screening Stop Action table must be accessible.

The value specified for the type parameter must be within the allowed range.

The GWSOA parameter combination should be known and valid.

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

An asterisk can be specified for a parameter value in the chg/dlt-scr-tt commands only if that parameter value was specified as an asterisk in the ent-scr-tt command to define the parameter value.

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-tt:sr=iec:type=012:ntype=014


    rlghncxa03w 04-01-07 12:05:33 EST  EAGLE 31.3.0
    CHG-SCR-TT:  SCREEN SET AFFECTED - IEC  25% FULL
    CHG-SCR-TT:  MASP A - COMPLTD 
;

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

chg-scr-tt:sr=tt1:nsfi=cdpa:nsr=cd1:type=0: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-TT: MASP A - Cannot access standby fixed disk.
    CHG-SCR-TT: MASP A - Simplex database update.
    Notice: Force parameter is required for affected screensets greater than 200
    CHG-SCR-TT: MASP A - Command Aborted

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

chg-scr-tt:sr=tt1:nsfi=cdpa:nsr=cd1:type=0: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-TT: MASP A - Cannot access standby fixed disk.
    CHG-SCR-TT: 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-TT: SCREEN SET AFFECTED - s1      1% FULL
    CHG-SCR-TT: SCREEN SET AFFECTED - s10     1% FULL
    CHG-SCR-TT: SCREEN SET AFFECTED - s100    1% FULL
    CHG-SCR-TT: SCREEN SET AFFECTED - s101    1% FULL
    CHG-SCR-TT: SCREEN SET AFFECTED - s102    1% FULL
    ---------------------------------------------------
    ---------------------------------------------------
    (List of affected screensets)

4.128 chg-scr-tt