4.118 chg-scr-aftpc

Use this command to change the attributes of a specific screening reference in the allowed affected point code category. Attributes that can be changed are the point code and the subsystem number.

Parameters

Note:

See Point Code Formats and Conversionfor a detailed description of point code formats, rules for specification, and examples.
sr (mandatory)
Screening reference. The point code’s unique screening reference name.
Range:
ayyy

1 alphabetic character followed by up to 3 alphanumeric characters

ssn (mandatory)
Subsystem number.
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 the chg-gws-actset and rtrv-gws-actset commands).
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.

area (optional)
ITU international area. The area in the point code represented by zone-area-id.
Range: 0 - 255, *
* —the full range of values from 0–255
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
id (optional)
ITU international ID. The ID in the point code represented by zone-area-id.
Range: 0 - 7, *
* —the full range of values from 0–7
mna (optional)
16-bit ITU national main number area. The mna in the point code represented by un-sna-mna.
Range:
0--31,*

*-the full range of values from 0--31

msa (optional)
24-bit ITU-national main signaling area value. The msa of the point code represented by msa-ssa-sp.
Range: 0 - 255, *
* —the full range of values from 000–255
narea (optional)
New ITU-international area value.
Range: 0 - 255, *
* —the full range of values from 0–255
Default:
No change to the current value
nc (optional)
Network cluster value. Specifies one or more nc values for the network indicator and network cluster member values specified by the ni and ncm parameters. It specifies the nc of the point code represented by ni-nc-ncm.
Range:
0 - 255, *

* —the full range of values from 0–255

ncm (optional)
Network cluster member value. Specifies one or more ncm values for the network indicator and network cluster values identified in the ni and nc parameters. It specifies the ncm of the point code represented by ni-nc-ncm.
Range:
0 - 255, *

* —the full range of values from 0–255

ni (optional)
Network indicator value. Specifies one or more ni values for the network cluster and network cluster member values identified in the nc and ncm parameters. It specifies the ni of the point code represented by ni-nc-ncm.
Range:
0 - 255, *

* —the full range of values from 0–255

nid (optional)
New ITU-international ID value
Range:
0 - 7, *

* —the full range of values from 0–7

Default:
No change to the current value
nmna (optional)
New 16-bit ITU national main number area. The new mna in the point code represented by un-sna-mna.
Range:
0--31,*

*-the full range of values from 0--31

nmsa (optional)
New 24-bit ITU-national main signaling area value. The new msa of the point code represented by msa-ssa-sp.
Range:
0 - 255,*

* —the full range of values from 0–255

nnc (optional)
New network cluster. Specifies one or more nnc values for the screening reference specified in the sr parameter. It specifies the new nc of the point code represented by ni-nc-ncm.
Range:
0 - 255, *

* —the full range of values from 0–255

Default:
No change to the current value
nncm (optional)
New network cluster member. Specifies one or more ncm values for the screening reference specified in the sr parameter. It specifies the new ncm of the point code represented by ni-nc-ncm.
Range:
0 - 255, *

* —the full range of values from 0–255

Default:
No change to the current value
nni (optional)
New network identifier. Specifies one or more nni values for the screening reference specified in the sr parameter. It specifies the new ni of the point code represented by ni-nc-ncm.
Range:
0 - 255, *

* —the full range of values from 0–255

Default:
No change to the current value
nnpc (optional)
New ITU-national point code.

Note:

Gateway screening allows the ITU national point code to be displayed and entered in the database only as a single number.If you use multiple-part ITU national point codes, see Converting ITU National Point Code Formats in Appendix A for information on converting the point code format.
Range:
0 - 16383, *

* —the full range of values from 0–16383

Default:
No change to the current value
npc (optional)
ITU national point code.
Range:
0 - 16383, *

* —the full range of values from 0–16383

npcst (optional)
New point code subtype. This parameter indicates whether the specified new ITU international or ITU national point code has no subtype prefix or has the spare point code prefix (s-).
Range:
none
s
Default:
none
nsfi (optional)
The next screening category used in the gateway screening process. This parameter halts the gateway screening process, and the message then proceeds through normal routing.
Range:
stop
Default:
No change to the current value
nsna (optional)
New 16-bit ITU national sub number area. The new sna in the point code represented by un-sna-mna.
Range:
0--15,*

*-the full range of values from 0--15

nsp (optional)
New 24-bit ITU national signaling point. The new sp of the point code represented by msa-ssa-sp.
Range:
0 - 255, *

* —the full range of values from 0–255

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
nssa (optional)
New 24-bit ITU national sub signaling area. The new ssa of the point code represented by msa-ssa-sp.
Range:
0 - 255, *

* —the full range of values from 0–255

nssn (optional)
New subsystem number.
Range:
0 - 255, *

* —the full range of values from 0–255

Default:
No change to the current value
nun (optional)
New 16-bit ITU national unit number. The new un in the point code represented by un-sna-mna.
Range:
0--127,*

*-the full range of values from 0--127

nzone (optional)
New ITU-international zone. The new zone for the point code represented by zone-area-id.
Range:
0 - 7, *

* —the full range of values from 0–7

Default:
No change to the current value
pcst (optional)
Point code subtype. This parameter indicates whether the specified ITU international or ITU national point code has no subtype prefix or has the spare point code prefix (s-).
Range:
none
s
Default:
none
sna (optional)
16-bit ITU-national sub number area. The sna of the point code represented by un-sna-mna.
Range:
0--15,*

*-the full range of values from 0-15

sp (optional)
24-bit ITU national signaling point. The sp in the point code represented by msa-ssa-sp.
Range:
0 - 255, *

* —the full range of values from 0–255

ssa (optional)
24-bit ITU national sub signaling area. The ssa in the point code represented by the format msa-ssa-sp.
Range:
0 - 255, *

* —the full range of values from 0–255

un (optional)
16-bit ITU-national unit number. The un of the point code represented by un-sna-mna.
Range:
0--127,*

*-the full range of values from 0-127

zone (optional)
ITU international zone. The zone in the point code represented by zone-area-id.
Range:
0 - 7, *

* —the full range of values from 0–255

Example

chg-scr-aftpc:sr=iec:ni=240:nc=010:ncm=010:ssn=254:nni=240:nnc=003:nncm=030 :nssn=253

chg-scr-aftpc:sr=iec:ni=240:nc=008:ncm=203:nssn=253:nsfi=stop:actname=copy

chg-scr-aftpc:sr=aft1:zone=1:area=2:id=3:nsfi=stop:ssn=1:pcst=s:npcst=none

chg-scr-aftpc:sr=aft2:un=1:sna=2:mna=1:nsfi=stop:ssn=1:nun=2:nsna=3:nmna=2

Dependencies

Caution:

Even though gateway screening is in the screen test mode, as defined by the parameters gwsa=off and gwsm=on, 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.

A complete point code must be specified, and must be one and only one, of the five point code parameter combinations: ni-nc-ncm, zone-area-id, msa-ssa-sp, un-sna-mna, or npc.

ANSI point code value 000-000-000 and ITU-International point code value 0-000-0 are not allowed.

At least one optional parameter must be specified.

The new affected point code and subsystem number to be changed cannot already exist in the affected point code entity set.

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.

If the zone=* parameter is specified, the area=* and id=* parameters must be specified.

If the area=* parameter is specified, the id=* parameter must be specified.

If the msa=* parameter is specified, the ssa=* and sp=* parameters must be specified.

If the ssa=* parameter is specified, the sp=* parameter must be specified.

If the un=* parameter is specified, the sna=* and mna=* parameters must be specified.

If the sna=* parameter is specified, the mna=* parameter must be specified.

If the nc parameter is specified as a range, the ncm parameter must be specified as an asterisk or as the full range 0–255.

If the nc parameter is specified as a single value or a range, a single value must be specified for the ni parameter.

If the nc=* paramter is specified, the ncm parameter must be specified as an asterisk or as the full range 0–255.

If the ncm parameter is specified as a single value, or a range other than the full range of 0–255, the ni and nc parameters must be specified with a single value.

If the ni parameter is specified as an asterisk (ni=*) or as a range, the nc and ncm parameters must be specified as an asterisk or as the full range 0–255.

If the nsfi parameter is specified, the parameter value must be stop.

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

The characterccannot be specified for the ni, nc, ncm, zone, area, id, msa, ssa, sp, un, sna, mna, and npc parameters.

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

The specified screening reference (sr) must already exist in the database.

The Spare Point Code Support feature must be enabled before the pcst parameter can be specified.

The spare point code subtype prefix (s-) is not supported for ANSI point codes (parameters ni, nc, ncm) or for 24-bit ITU national point codes (parameters msa, ssa, sp) or for 16-bit ITU national point codes (parameters un, sna, mna). The pcst and npcst parameters cannot be specified for ANSI, ITU-N24 or ITU-N16 point codes.

The Gateway Screening Stop Action table must be accessible.

The affected point code and subsystem number to be changed must already exist in the affected point code entity set.

The J7 support feature must be enabled before the un, sna, mna, nun, nsna, or nmna parameters are specified.

The J7 support feature must not be enabled before the msa, ssa, sp, nmsa, nssa, or nsp parameters are specified.

The GWSOA parameter combination should be known and valid.

Notes

A range of values is specified by separating the values that define the range by two ampersands (&&); for example, ni=025&&100 specifies all network indicators for ANSI point codes from 25 - 100.

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

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 the card. Screen sets should not exceed 100% capacity. Remove screen set entries until the capacity is below 100%.

A screening reference is assigned to screen sets using the ent-scrset command. A screening reference can belong to multiple screen sets.

The spare point code subtype prefix s- is supported only for ITU international and ITU national point codes. The pcst parameter indicates whether the specified point code has no subtype prefix or has the spare point code prefix.

There is no feature dependency on ANSI point code parameters i.e., ni, nc, ncm, nni, nnc or nncm. The command can be entered successfully whether the J7 feature is enabled or not enabled.

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-aftpc:sr=iec:ni=240:nc=010:ncm=010:ssn=254:nni=240:nnc=003:nncm=030 :nssn=253 

    rlghncxa03w  04-01-07  11:43:04  EST  EAGLE 31.3.0
    CHG-SCR-AFTPC:  SCREEN SET AFFECTED - IEC  25% FULL
    CHG-SCR-AFTPC:  MASP A - COMPLTD 
;

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

chg-scr-aftpc:sr=iec:ni=240:nc=010:ncm=010:ssn=254:nni=240:nnc=003:nncm=030 :nssn=253: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-AFTPC: MASP A - Cannot access standby fixed disk.
    CHG-SCR-AFTPC: MASP A - Simplex database update.
    Notice: Force parameter is required for affected screensets greater than 200
    CHG-SCR-AFTPC: MASP A - Command Aborted

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

chg-scr-aftpc:sr=iec:ni=240:nc=010:ncm=010:ssn=254:nni=240:nnc=003:nncm=030 :nssn=253: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-AFTPC: MASP A - Cannot access standby fixed disk.
    CHG-SCR-AFTPC: 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-AFTPC: SCREEN SET AFFECTED - s1      1% FULL
    CHG-SCR-AFTPC: SCREEN SET AFFECTED - s10     1% FULL
    CHG-SCR-AFTPC: SCREEN SET AFFECTED - s100    1% FULL
    CHG-SCR-AFTPC: SCREEN SET AFFECTED - s101    1% FULL
    CHG-SCR-AFTPC: SCREEN SET AFFECTED - s102    1% FULL
    ---------------------------------------------------
    ---------------------------------------------------
    (List of affected screensets)

Related Topics