4.400 rept-stat-cluster
Use this command to report summary status and statistical information for all provisioned clusters. Use this command also to report detailed routeset information for a specific cluster, provisioned cluster member, or dynamically-created x-list entry.
Note:
This command does not support 24-bit ITU national point codes.Parameters
- dpc (optional)
- ANSI destination point code of the cluster whose status is to be reported,with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). The prefix subfield indicates a private point code (prefix-ni-nc-ncm).
- Synonym:
- dpca
- Range:
- p-, 000-255, *
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
prefix—p-
The asterisk value (*) is not valid for the ni subfield.
When
chg-sid:pctype=ansi
is specified, ni = 000 is not valid.When
chg-sid:pctype=ansi
is specified, nc = 000 is not valid if ni = 001–005.When
chg-sid:pctype=ansi
is specified, nc = 000 is valid if ni = 006–255.The point code 000-000-000 is not a valid point code.
- Default:
- Display summary for all provisioned clusters
- mode (optional)
- The type of display. Specify mode=full to display additional information for the specified DPC.
Example
rept-stat-cluster
rept-stat-cluster:stat=alminh
rept-stat-cluster:stat=MT
rept-stat-cluster:dpc=20-2-*
rept-stat-cluster:dpc=20-2-*:mode=full
rept-stat-cluster:dpc=20-2-5
Dependencies
If the mode=full parameter is specified, the dpc/dpca parameter must be specified.
The stat parameter cannot be specified with the dpc/dpca parameter in the command.
The Cluster Routing and Management Diversity (CRMD) feature must be turned on before this command can be entered.
The specified DPC must exist.
If a DPC is specified, it must be an x-list entry, a cluster DPC, or a member of a provisioned cluster.
The destination address must be a full point code or a cluster point code specified as ni-nc-*. A DPC with ni-nc-** or ni-nc-*** cannot be specified.
No other rept-stat-xxx
command can be in progress when this command is entered.
Notes
If no parameters are specified, a summary report is produced, showing all provisioned clusters and their status.
If an FPC corresponding to a provisioned cluster member or an x-list entry is specified, then the status of only the specified FPC, along with routeset status, is displayed.
If a cluster destination is specified on the dpc/dpca parameter, then the status of the cluster and the routesets that have been defined for that cluster is displayed.
If the mode=full parameter and a DPC are specified, the Route/Destination table is searched, and all entries (cluster DPCs, provisioned cluster member DPCs, and x-list DPCs) belonging to the parent cluster are displayed along with their status. Also, if circular routing is in effect for the DPC, information useful in diagnosing and correcting the situation is displayed.
In the summary report, and in the detailed output when a cluster DPC is being reported, the number of provisioned members of the cluster, and the number of x-list entries that have been created for the cluster, are reported in the PROV and X-LIST columns, respectively.
When detailed information for an x-list entry is being reported, the reasons that the x-list entry was created, and the amount of time remaining on the x-list expiration timer, if applicable, in the format hh:mm is shown in the X-REASON and X-TIME columns, respectively. In x-list entries for which the expiration timer is not applicable, dashes “-----” are displayed.
MTT 4735 and 4732 deleted by MB
Output
This example shows the output when no parameters are specified. Summary information for all of the defined cluster DPCs is shown. The report shows the number of provisioned and x-list members of each cluster.
rept-stat-cluster
rlghncxa03w 04-01-07 08:51:31 EST EAGLE 34.0.0
DPCA ORIG PST SST AST PROV XLIST
020-002-* CLUST IS-NR Allowed ACCESS 2 3
020-020-* CLUST IS-NR Allowed ACCESS 3 5
020-021-* CLUST OOS-MT Prohibit INACCESS 5 2
020-022-* CLUST IS-NR Allowed ALMINH 2 3
Command Completed.
;
This example shows the output when a provisioned cluster member DPC is specified. The report shows status information for the specified DPC plus route information.
rept-stat-cluster:dpc=20-2-1
rlghncxa03w 04-01-07 08:51:31 EST EAGLE 34.0.0
DPCA ORIG PST SST AST
020-002-001 PROV IS-ANR Restrict ACCESS
ALARM STATUS = No Alarms.
RTE COST LSN APCA LS STAT NON-ADJ ROUTE STAT
1 10 lsnppp 003-003-003 Allowed Allowed Allowed
2 -- ------- ***-***-*** ------- ------- -------
3 -- ------- ***-***-*** ------- ------- -------
4 -- ------- ***-***-*** ------- ------- -------
5 -- ------- ***-***-*** ------- ------- -------
6 -- ------- ***-***-*** ------- ------- -------
Command Completed.
;
This example shows the output when a specific cluster DPC is specified. The report shows count information about the cluster’s provisioned and x-list members, plus the route information.
rept-stat-cluster:dpc=20-2-*
rlghncxa03w 04-01-07 08:51:31 EST EAGLE 34.0.0
DPCA ORIG PST SST AST PROV X-LIST
020-002-* CLUST IS-NR Allowed ACCESS 2 3
ALARM STATUS = No Alarms.
RTE COST LSN APCA LS STAT NON-ADJ ROUTE STAT
1 10 lsnppp 003-003-003 Allowed Allowed Allowed
2 -- ------- ***-***-*** ------- ------- -------
3 -- ------- ***-***-*** ------- ------- -------
4 -- ------- ***-***-*** ------- ------- -------
5 -- ------- ***-***-*** ------- ------- -------
6 -- ------- ***-***-*** ------- ------- -------
Command Completed.
;
This example shows the output when an x-list cluster member DPC is specified. The report shows x-list related information ( X-REASON, X-TIME ) plus the route information. The report identifies the specified DPC as an x-list DPC.
rept-stat-cluster:dpc=20-2-5
rlghncxa03w 04-01-07 08:51:31 EST EAGLE 34.0.0
DPCA ORIG PST SST AST X-REASON X-TIME
020-002-005 X-LIST IS-ANR Restrict ACCESS RT 08:20
ALARM STATUS = No Alarms.
RTE COST LSN APCA LS STAT NON-ADJ ROUTE STAT
1 10 lsnppp 003-003-003 Allowed Allowed Allowed
2 -- ------- ***-***-*** ------- ------- -------
3 -- ------- ***-***-*** ------- ------- -------
4 -- ------- ***-***-*** ------- ------- -------
5 -- ------- ***-***-*** ------- ------- -------
6 -- ------- ***-***-*** ------- ------- -------
Command Completed.
;
This example shows the output when a cluster DPC and mode=full is specified. The report shows summary status information for the provisioned and x-list DPCs that are members of the specified cluster.
rept-stat-cluster:dpc=20-2-*:mode=full
rlghncxa03w 04-01-07 08:51:31 EST EAGLE 34.0.0
DPCA ORIG PST SST AST PROV X-LIST
020-002-* CLUST IS-NR Allowed ACCESS 2 3
ALARM STATUS = No Alarms.
RTE COST LSN APCA LS STAT NON-ADJ ROUTE STAT
1 10 lsnppp 003-003-003 Allowed Allowed Allowed
2 -- ------- ***-***-*** ------- ------- -------
3 -- ------- ***-***-*** ------- ------- -------
4 -- ------- ***-***-*** ------- ------- -------
5 -- ------- ***-***-*** ------- ------- -------
6 -- ------- ***-***-*** ------- ------- -------
DPCA ORIG PST SST AST X-REASON X-TIME
020-002-* CLUST IS-NR Allowed ACCESS -------- -----
020-002-001 PROV OOS-MT Prohibit INACCESS -------- -----
020-002-002 PROV IS-ANR Restrict ACCESS -------- -----
020-002-126 X-LIST IS-ANR Restrict ACCESS RT 08:20
020-002-127 X-LIST OOS-MT Prohibit INACCESS CR -----
020-002-128 X-LIST IS-ANR Restrict ACCESS CG RT 05:40
CIRCULAR ROUTING
XMIT LSN= -------- RC=--
RCV LSN= --------
MEMBER = ***-***-***
Command Completed.
;
This example shows the output when the stat parameter is specified. Only those clusters having a primary state (PST) matching the specified value are reported.
rept-stat-cluster:stat=alminh
rlghncxa03w 04-01-07 08:51:31 EST EAGLE 34.0.0
DPCA ORIG PST SST AST PROV XLIST
020-022-* CLUST IS-NR Allowed ALMINH 2 3
Command Completed.
;
This example shows the output when specifying the dpc and mode=full parameters re specified. If a circular routing alarm is raised for a cluster member DPC, specifying these parameters displays information pertinent to the cluster member that is experiencing the circular routing condition.
rept-stat-cluster:dpc=20-2-127:mode=full
rlghncxa03w 04-01-07 08:51:31 EST EAGLE 34.0.0
DPCA ORIG PST SST AST
020-002-127 PROV OOS-MT Prohibit INACCESS
ALARM STATUS = *C 0319 Circular routing detected
RTE COST LSN APCA LS STAT NON-ADJ ROUTE STAT
1 10 lsnppp 003-003-003 Allowed Allowed Allowed
2 -- ------- ***-***-*** ------- ------- -------
3 -- ------- ***-***-*** ------- ------- -------
4 -- ------- ***-***-*** ------- ------- -------
5 -- ------- ***-***-*** ------- ------- -------
6 -- ------- ***-***-*** ------- ------- -------
DPCA ORIG PST SST AST X-REASON X-TIME
020-002-* CLUST IS-NR Allowed ACCESS -------- -----
020-002-001 PROV OOS-MT Prohibit ACCESS -------- -----
020-002-002 PROV IS-ANR Restrict ACCESS -------- -----
020-002-126 X-LIST IS-ANR Restrict ACCESS RT 08:20
020-002-127 X-LIST OOS-MT Prohibit INACCESS CG CR -----
020-002-128 X-LIST IS-ANR Restrict ACCESS CR CG RT 05:40
CIRCULAR ROUTING
XMIT LSN= lsnppp RC=--
RCV LSN= lsn01a
MEMBER = ***-***-***
Command Completed.
;
If a circular routing alarm is raised for a cluster DPC, then specifying the dpc and mode=full parameters displays information pertinent to the cluster member experiencing the circular routing condition. The value for the MEMBER field in this example represents the cluster member that had the circular routing condition. This is the same member for which an x-list entry could not be created.
Note:
The circular routing member information shown in this output report displays as ***-***-*** if the specified DPC is not a cluster DPC or the information is not known by maintenance at the time the report is generated. rept-stat-cluster:dpc=20-2-*:mode=full
rlghncxa03w 04-01-07 08:51:31 EST EAGLE 34.0.0
DPCA ORIG PST SST AST PROV X-LIST
020-002-* CLUST IS-NR Allowed ACCESS 2 3
ALARM STATUS = *C 0319 Circular routing detected
RTE COST LSN APCA LS STAT NON-ADJ ROUTE STAT
1 10 lsnppp 003-003-003 Allowed Allowed Allowed
2 -- ------- ***-***-*** ------- ------- -------
3 -- ------- ***-***-*** ------- ------- -------
4 -- ------- ***-***-*** ------- ------- -------
5 -- ------- ***-***-*** ------- ------- -------
6 -- ------- ***-***-*** ------- ------- -------
DPCA ORIG PST SST AST X-REASON X-TIME
020-002-* CLUST IS-NR Allowed ACCESS -------- -----
020-002-001 PROV OOS-MT Prohibit INACCESS -------- -----
020-002-002 PROV IS-ANR Restrict ACCESS -------- -----
020-002-126 X-LIST IS-ANR Restrict ACCESS RT 08:20
020-002-127 X-LIST OOS-MT Prohibit INACCESS CR -----
020-002-128 X-LIST IS-ANR Restrict ACCESS CG RT 05:40
CIRCULAR ROUTING
XMIT LSN= lsnppp RC=--
RCV LSN= lsn01a
MEMBER = 020-002-129
Command Completed.
;
This example includes private point codes:
rept-stat-cluster:dpc=20-2-*:mode=full
rlghncxa03w 05-01-06 10:09:59 EST EAGLE 34.0.0
DPCA ORIG PST SST AST PROV XLIST
020-002-* CLUST OOS-MT Idle INACCESS 0 0
ALARM STATUS = No Alarms.
RTE COST LSN APCA LS STAT NON-ADJ ROUTE STAT
1 10 ls11345678 p-001-001-003 Allowed Allowed Allowed
2 -- ---------- ---***-***-*** -------- -------- --------
3 -- ---------- ---***-***-*** -------- -------- --------
4 -- ---------- ---***-***-*** -------- -------- --------
5 -- ---------- ---***-***-*** -------- -------- --------
6 -- ---------- ---***-***-*** -------- -------- --------
DPCA ORIG PST SST AST X-REASON X-TIME
020-002-* CLUST IS-NR Allowed ACCESS -------- -----
p-020-002-001 PROV OOS-MT Prohibit INACCESS -------- -----
p-020-002-002 PROV IS-ANR Restrict ACCESS -------- -----
020-002-126 X-LIST IS-ANR Restrict ACCESS RT 08:20
020-002-127 X-LIST OOS-MT Prohibit INACCESS CR -----
020-002-128 X-LIST IS-ANR Restrict ACCESS CG RT 05:40
CIRCULAR ROUTING INFO:
XMIT LSN=---------- RC=--
RCV LSN=----------
MEMBER =-----------
Command Completed.
;
Legend
- ORIG—Origination of the destination point code being reported. Possible values that can appear in the column are:
- CLUST—Entry is a provisioned cluster (ni-nc-*) DPC
- PROV—Entry is a provisioned cluster member (ni-nc-ncm)
- X-LIST—Entry is a non-provisioned (i.e. dynamically-created) x-list cluster member
- PST—Primary state of the cluster. See Possible Values for PST/SST/AST.
- SST—Secondary state of the cluster. See Possible Values for PST/SST/AST.
- AST—Associated state of the cluster. See Possible Values for PST/SST/AST.
- X-REASON—Reasons that the X-LIST entries currently exist. The two-letter indicator values that can appear in this column are:
- RT—X-LIST entry created due to routing
- CG—X-LIST entry created due to congestion
- CR—X-LIST entry created due to circular routing
The circular routing transmit/receive linkset information shown in the mode=full detailed output report displays as “--------” if no circular routing alarm exists for the DPC or the information is not known by maintenance at the time the report is generated.
Related Topics