4.129 chg-scrset

Use this command to change the attributes of a screen set. A screen set is a group of screening references that can be assigned to a linkset. It is defined by a name and a pointer to the first screening reference of a screen set.

Parameters

The nscrn, nsfi, or nsr parameter must be specified.

scrn (mandatory)
Screen set name. Each screening reference must have a unique name.
Range:
ayyy

1 alphabetic character followed by up to 3 alphanumeric characters

actname (optional)
Action name. This parameter specifies 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.

destfld (optional)
This parameter turns on and off the automatic allowed affected destination screening for network management messages against the routing table, self point codes, and capability point codes. When this parameter is on, the automatic screening is applied at the end of the provisioned screen set.
Range:
yes
no
Default:
Current value
nscrn (optional)
New screen set name.
Range:
ayyy 1 alphabetic character followed by up to 3 alphanumeric characters
Default:
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 is the next screening category.
blkopc
Blocked OPC is the next screening category.
dpc
Allowed DPC is the next screening category.
opc
AllowedOPC is the next screening category.
sio
Allowed SIO is the next screening category.
stop
The gateway screening process ends and the message proceeds through normal routing.
Default:
Current value
nsr (optional)
Next screening reference. The parameter indicates which screening reference in the specified screening category (nsfi) is to be used in the screening process. If nsfi=stop, the nsr parameter cannot be specified.
Range:
ayyy

1 alphabetic character followed by up to 3 alphanumeric characters

Default:
Current value

Example

chg-scrset:scrn=ss01:nsfi=opc:nsr=iec

chg-scrset:scrn=ss02:nsfi=stop:nscrn=ss03

chg-scrset:scrn=ss02:nscrn=ss03:nsfi=stop:actname=copy

chg-scrset:scrn=ss02:nsfi=stop:nscrn=ss03:destfld=no

Dependencies

The value of the nscrn parameter cannot be assigned to another screen set.

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 nsfi and nsr parameters must point to one or more existing entities in another entity set, or the nsfi=stop parameter must be specified, and the nsr parameter cannot be specified.

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

An existing screen set must be removed from all linksets before it can be changed.

If the nscrn parameter is specified, the scrn parameter value cannot be referenced by a linkset.

The Gateway Screening (GSW) Stop Action table must be accessible.

If the next screening function identifier (nsfi) and the next screening reference (nsr) does not point to an existing screen, the nsfi must be equal to stop and the nsr parameter must not be specified.

The nsfi parameter must be valid for the SCRSET entity.

At least one optional parameter must be specified.

The GWSOA parameter combination should be known and valid.

The value for the scrn and nscrn parameters must be different.

When the screen sets are provisioned at maximum capacity (1023 screen sets), no screen sets can be changed.

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

The system validates the command to verify that the specified screen set name is in use.

Output

chg-scrset:scrn=ss01:nsfi=opc:nsr=iec

    rlghncxa03w 04-01-07 09:35:10 EST  EAGLE 31.3.0
    CHG-SCRSET:  SCREEN SET AFFECTED - SS01  25% FULL
    CHG-SCRSET:  MASP A - COMPLTD 
;