The <dcstatus option list> specifies those elements of the data comm subsystem that are to be analyzed. These options are shown in the following diagram in this subsection. A full explanation of each option is given in the text that follows the syntax for <dcstatus option list>.
The internal file name for the output file is LINE. When the WFL RUN statement or the CANDE RUN statement is used to initiate DCSTATUS, output is sent to the line printer by default. When the CANDE DCSTATUS command is used, the output is sent to a remote terminal by default. The output format is modified to fit a 72-character line width. The file LINE can be file-equated in any of the above cases if an output device different from the default is wished.
The DCSYSTEMTABLES intrinsic does not lock the various tables that it accesses. Therefore, the contents of the tables might change while the intrinsic is accessing them. In addition, more than one call on the DCSYSTEMTABLES intrinsic is made to obtain the contents of all the various data comm tables. If the data comm tables maintained by the operating system change between calls, the results produced by DCSTATUS can appear internally inconsistent.
By using the FILE statement, analysis can be performed on DATACOMINFO files other than the currently active DATACOMINFO file. The following are the only allowable options for inactive DATACOMINFO files:
-
STATION <station number> NDL or STATION NDL
-
NETWORK
<dcstatus option list>
──┬─ STATION ─┬───────┬─┬─────────────────────┬────────────────────────┤
│ └─<LSN>─┘ └─ NDL ───────────────│
├─ NETWORK ─┬───────────────────────────────┤
│ └─<DC file prefix>──────────────┤
└─ FILE ─┬──────────────────────────────────┤
└─<DC file prefix>─────────────────┘
<DC file prefix>
──<identifier>─┬─────────────────────┬─────────────────────────────────┤
└─ ON ──<family name>─┘
The following text describes the meaning of each option:
|
Option |
Explanation |
|---|---|
|
Produces a station analysis. If no <lsn> is specified, all stations are analyzed. The normal sources of information for the STATION option are the operating system data comm tables. If the NDL option is specified, the source of information is the DATACOMINFO file. |
|
|
Produces a brief tabular network configuration report. Information in the report includes NSP, LSP, line/adapter, station, terminal, and MCS data. Because the network information is obtained from the network definition files specified by the <DC file prefix>, the NETWORK option can be used whether data comm is running or not. If the <DC file prefix> is not specified, the one currently being used by the system is analyzed. |
|
|
When the <DC file prefix> is specified, limited analysis can be performed on any inactive DATACOMINFO file. If the <DC file prefix> is not specified, the one currently being used by the system is used. For example, suppose DCSTATUS is supplied with the following <dcstatus option list>: ("FILE A/B; NETWORK; FILE; NETWORK; GRAPH") The first NETWORK report is generated using A/B/DATACOMINFO; the remaining report uses the DATACOMINFO files that are currently in use. |
Example
The following example shows the output from the STATION option on a line printer. The station name is displayed, along with information about the DCC station table.
STATION 611
ON-LINE DATACOM NETWORK ANALYSIS PROGRAM
======= ======= ======= ======== =======
SYSTEM/DCSTATUS (59.171.2) DATE: 12/02/2016 TIME: 12:09:44
DCPREFIX: SYSTEM/PROG/110804
DCC STATION TABLE
142282638050 ENABLED : READY : ATTACHED :
MCS = 10: LSN = 611 : PSEUDO-STATION : WIDTH = 80
6F0500000262 STATION REMOTE TYPE = 5: RETRY COUNT = 0: NIF INDEX = 610
004000000000 PSEUDOMCS = 4
800000000000 TRANSFERRED : DLS : UNASSIGNED
NORMAL TERMINATION 