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.
- 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
andrtrv-gws-actset
).
- 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.
- 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
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
;
Related Topics