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.
Range:
full
Default:
Display summary report
stat (optional)
This parameter reports on destinations whose status is the same as the state indicated by the parameter.
Range:
all
All of the primary states
alminh
Alarms inhibited
anr
In service abnormal (IS-ANR)
dsbld
Out of service maintenance disabled (OOS-MT-DSBLD)
mt
Out of service maintenance (OOS-MT)
nr
In service normal (IS-NR)
Default:
all

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.