Page 1¶
Norsk Data A.S¶
PROGRAM DESCRIPTION¶
Date: 87.01.27
Page: 1 of 8
| Product | Name | Reg. no. | Category |
|---|---|---|---|
| COSMOS Network Monitor | 211104A | STPR |
| Reason | X New product | Error Correction |
|---|---|---|
| Documentation | Title | Reg. no. |
|---|---|---|
| COSMOS Network Monitor Operator Guide | 30.067.01 EN |
Purpose¶
Monitors status of connections and servers in a COSMOS network. Possible to get statistics reports on a long-term basis.
Prerequisites¶
| Computer | Type Floating format | Op. system Version |
|---|---|---|
| ND-100 | SINTRAN III J or later |
| ND-no. | Product name |
|---|---|
| 210373J | X-MESSAGE |
Minimum mass storage resources for installation¶
| User | Userspace | Number of files |
|---|---|---|
| SYSTEM | 63 pages | on 1 file |
| RT | 71 pages | on 4 files |
| Any user(UTILITY) | 163 pages | on 9 files |
Minimum permanent mass storage resources¶
| User | Userspace | Number of files |
|---|---|---|
| RT | 69 pages | on 4 files |
| any user(UTILITY) | 90 pages | on 6 files |
- Max/Min number of RT-descriptions: Max 64 Min 1
- Max/Min number of segments: Max 64 Min 1
- Space requirements on segment file(s) is 64 pages
Product consists of¶
| MODULE-no. | Name | Reg. no. Source |
|---|---|---|
| 250196C | REPRO for ND-100 | 250193A |
| File Name | Type | Containing |
|---|---|---|
| INST-COSMON-A | PROG | Installation program |
| COSMON-LOAD-A | MODE | Load file for RT-program |
| COSMON-MAIN-A | PROG | RT-program doing the testing |
| COSMON-DEF-A | CONF | Configuration file |
| COSMON-WIND-A | PROG | Operator's window to test program |
| COSMON-SERV-A | PROG | Saves logfile and starts REPRO |
| REP-COSMON-A | RPRT | Library used by REPRO |
| COSMON-STAT-A | LOOK | Lookup files used by REPRO |
NOTE: <rev> is to be replaced by the current revision of the DIRECTORY or FILE. Revision is found on the "ND SOFTWARE LIBRARY DISKETTE" pages.
ooo ND Norsk Data ooo
[Scanned by Jonny Oddene for Sintran Dace © 2011]
Page 2¶
COSMOS Network Monitor¶
| Date | Norsk Data A.S | Page 2 of 8 |
|---|---|---|
| Product | Name | Reg. no. |
| COSMOS Network Monitor | 211104A |
1 SYSTEMS PREREQUISITES¶
The following are prerequisites for the installation of COSMOS Network Monitor:
- SINTRAN III version J or newer.
- X-MESSAGE version J or newer.
2 INSTALLATION CONSIDERATIONS¶
The COSMOS Network Monitor consists of three parts:
- test part, which checks status of connections and servers.
- report part, which allows the operator to produce reports.
- monitory part, which does online monitoring of status on a terminal whenever started.
The test part should only be installed on one machine (per operator domain) in the network. This machine should be a central one and have good access to other parts of the network. The test part is installed under user RT.
The configuration file and the logging file from the test part are input files to the report part. To prevent that the operator has to copy these files to another machine when producing reports, the report part is installed on the same machine as the test part. It may be installed under any user. NOTE that you also have to install the enclosed report production tool REPRO for ND-100 on your machine.
The monitory part may be run on any system in the network which has access to the system where the test part is running. It may be installed under any user.
ooo ND Norsk Data ooo
Scanned by Jonny Oddene for Sintran Data © 2011
Page 3¶
| Date | Norsk Data A.S | Page 3 of 8 |
|---|---|---|
| Product | Name | Reg.-no. |
| COSMOS Network Monitor | 211104A |
3 INSTALLATION PROCEDURE¶
The installation procedure allows you to choose whether to install the test & report part AND/OR the monitory part.
3.1 Running the installation program¶
Installing the different parts of the COSMOS Monitor is done as follows:
- Log in as user SYSTEM.
- Make sure that the user(s) you want to copy the files to has enough free user space. The amount of space is given on the front page of this PD-sheet.
- Insert the first release floppy in the floppy drive.
- Enter the directory on the floppy
@ENTER-DIRECTORY↵
DIRECTORY NAME: 211104A<rev>-XX-01↵
DEVICE NAME: FLOPPY-DISC-<drive-no.>↵
DEVICE UNIT: <floppy-unit>↵
@
- Start the installation program with the command:
@(211104A:FLOPPY-USER)INST-COSMON↵
The two messages:
USER-BREAK TERMINATION ENABLED and
FATAL-ERROR TERMINATION ENABLED
are not error messages, but simply informing you that the error handling is ready.
- Choose which part(s) of the COSMOS Monitor you want to install; test & report AND/OR monitory part.
- When you are asked for user name, you should write the name without any abbreviations. The files concerned with the report production will be placed on this user area. The file in the monitory part will also be placed on this area if you choose to install it. The RT- program will be placed under user RT.
Page 4¶
| Date | Norsk Data A.S | Page 4 of 8 |
|---|---|---|
| Product | Name | Reg. no. |
| COSMOS Network Monitor | 211104A | STPR |
3.2 What the installation program does¶
When you run the installation procedure, the following will be done:
If you install the test & report part:¶
The following files will be copied from the diskette:
To user RT:
- COSMON-MAIN-A:PROG (RT-program doing the testing).
- COSMON-DEF-A:CONF (Configuration file).
- COSMON-LOAD-A:MODE (Load file for RT-program).
To user area given by you:
- COSMON-SERV-A:PROG (Saves logfile and starts REPRO for producing reports).
- REP-COSMON-A:RPRT (Library used by REPRO).
- COSMON-STAT-A:LOOK (Lookup file used by REPRO).
The following files will be created:
On the user area given by you:
- COSMON-INRP-A:SYMB (Infile to REPRO).
- COSMON-OUTRP-A:TEXT (Default outfile from REPRO).
If you install the monitory part:¶
The following files will be copied from the diskette:
To user area given by you:
- COSMON-WIND-A:PROG (Operator's monitor program).
4 Ending the installation procedure¶
When the installation program has terminated successfully, you should give the command:
@DELETE-FILE (SYSTEM)INST-COSMON:PROG
ooo ND Norsk Data ooo
Scanned by Jonny Oddene for Sintran Data © 2011
Page 5¶
Program Description¶
| Date | Norsk Data A.S | Page |
|---|---|---|
| 87.01.27 | PROGRAM DESCRIPTION | 5 of 8 |
| Product | Name | Reg. no. | Category |
|---|---|---|---|
| COSMOS Network Monitor | 211104A | STPR |
5 Further Procedures¶
5.1 Loading the COSMON Main RT-program¶
To load the COSMON-Main RT-program you do as follows:
- Log in as user SYSTEM or RT
- Run the mode file COSMON-LOAD-A:MODE on user RT.
@MODE (RT)COSMON-LOAD-A:MODE,,,,
This mode command should be inserted in the SINTRAN file HENT-MODE:MODE, to ensure that the COSMON-Main RT-program is loaded after a cold start.
5.2 Starting and stopping the COSMON Main RT-program¶
Before you start the COSMON Main RT-program, you must use PED (or any other text editor with 7-bit storage format) to build up your own version of the configuration file
COSMON-DEF-A:CONF
A sample version is copied from the diskette which will be useful for keeping the required format. A description of the format of this file is found in the COSMOS Network Monitor Operator Guide.
Remember the cost if testing connections over public networks.
To be able to check the status of servers on a system in a network, this system must run XMSG K or later. If not, an error message will be returned.
The logging file, COSMON-LOG:LOGS, will be created when the RT-program is started.
Start the COSMON Main RT-program using the SINTRAN command
@RT COSMONJ
You should add this command in the SINTRAN file LOAD-MODE:MODE (or LOAD-SYSTEM:BATC) so that the COSMON Main RT-program is restarted after a warm start.
ND Norsk Data ooo
Page 6¶
| Date | Norsk Data A.S | Page 6 of 8 |
|------------|---------------------------------|-------------|
| | PROGRAM DESCRIPTION | |
| Product | Name | Reg. no. | Category |
|------------|---------------------|----------|-------------|
| | COSMOS Network Monitor | 211104A | STPR |
If you want to produce reports you must also execute the command
@SET-FILE-ACCESS COSMON-LOG:LOGS R, L
The RT-program is stopped by the SINTRAN command
@ABORT COSMONJ
# 5.3 Running the COSMON Window program
The monitoring part of the COSMOS Network Monitor consists of only one program. When this is started
@COSMON-WINDJ
the operator is asked on which system the COSMON Main RT-program is running. The operator may in this way be miles away from the machine where the test part is running and still get a status display on his/her terminal. When this has been specified, the status display on the terminal will start.
You may shift pages with the <|> and <|> keys. Status will be continuously updated until the operator wants to stop it. This is done by pressing the <EXIT> or the <CR> key.
Only one COSMON Window program per running RT-program may be started at the same time. Remember the cost if you choose to set up a connection between the test part and the monitor part over a public network.
# 5.4 Producing Reports
The COSMON Main RT-program logs all changes in status for those entries in the configuration file which have been specified to be logged. Since this logging file is rather tiresome to read, you may produce reports which are easier to read. You may also produce statistics reports over the network access.
Install the enclosed standard report production tool REPRO for ND-100 (Reg.no. 250196C) by running the REPRO installation job, unless it is already installed on your machine.
Log in as the user where you have installed the report part. The reports are produced through the COSMON-SERV(ICE) program. Before you produce a report from the logging file you must merge the configuration file and the logging file. This is done in
ooo ND Norsk Data ooo
Page 7¶
Program Description¶
| Date | Norsk Data A.S | Page 7 of 8 |
|---|---|---|
| Product | Name | Reg. no. |
| COSMOS Network Monitor | 211104A |
COSMON-SERVICE with the command:¶
@COSMON-SERVJ
COSMON-SERVICE:SAVELOGJ
To produce a report from one of your merged files, you execute the command:
COSMON-SERVICE:REPORTJ
You may choose between three different types of reports:
- DETAIL - an easier-to-read version of the logfile for connections
- GLOBAL - a statistics report for connections
- SERVER - an easier-to-read version of the logfile for servers
The reports will be written to the file
COSMON-OUTRP:TEXT
unless you specify another file name.
Further instructions are given in the COSMOS Network Monitor Operator Guide.
ooo ND Norsk Data ooo
Scanned by Jonny Oddene for Sintran Data © 2011
Page 8¶
Norsk Data A.S¶
Date: 87.01.27
Page: 8 of 8
PROGRAM DESCRIPTION
| Product | Name | Reg. no. | Category |
|---|---|---|---|
| COSMOS Network Monitor | 211104A | STPR |
6 APPENDIX A¶
6.1 Finding out the status of the COSMON Main RT-program¶
A useful command is the SINTRAN command:
@LIST-RT-DESCRIPTION COSMONJ
It gives the status of the RT-program, which should be
ACTIVE or
IN TIME QUEUE
when the program is running. If the state is PASSIVE, the COSMON Main RT-program needs to be restarted or in some cases reloaded.
ooo ND Norsk Data ooo
Page 9¶
ND Software Library Diskette¶
Containing: COSMOS Network Monitor
Directory Information¶
- Directory Name: 211104A01-XX-01S
- User Name: FLOPPY-USER
File Access¶
| Nr | File name | Type | T | Public | Friend | Own | Pages | Bytes |
|---|---|---|---|---|---|---|---|---|
| 0 | COSMON-WIND-A01 | PROG | I | R | RWACD | RWACD | 44 | 274432 |
| 1 | INST-COSMON-A01 | PROG | I | R | RWACD | RWACD | 61 | 190842 |
2 files using 105 pages. 148 pages reserved out of 148 pages.
Scanned by Jonny Oddene for Sintran Data © 2011
Page 10¶
ND Software Library Diskette¶
PAGE 1
Containing: COSMOS Network Monitor
Directory Name: 211104A01-XX-02S
User Name: FLOPPY-USER
File Access¶
| Nr | File name | Type | T | Public | Friend | Own | Pages | Bytes |
|---|---|---|---|---|---|---|---|---|
| 0 | COSMON-MAIN-A01 | PROG | I | R | RWACD | RWACD | 65 | 286720 |
| 1 | COSMON-DEF-A01 | CONF | I | R | RWACD | RWACD | 2 | 1907 |
| 2 | COSMON-LOAD-A01 | MODE | I | R | RWACD | RWACD | 2 | 472 |
| 3 | COSMON-SERV-A01 | PROG | I | R | RWACD | RWACD | 13 | 26288 |
| 4 | REP-COSMON-A01 | RPRT | I | R | RWACD | RWACD | 31 | 61440 |
| 5 | COSMON-STAT-A01 | LOOK | I | R | RWACD | RWACD | 2 | 233 |
6 files using 115 pages. 148 pages reserved out of 148 pages.
[Scanned by Jonny Oddene for Sintran Data © 2011]
Page 11¶
ND Software Library Diskette¶
Page 1¶
Containing: COSMOS Network Monitor
Directory Name: 211104A01-XX-01D
User Name: FLOPPY-USER
File Access:¶
| Nr | File Name | Type | T | Public | Friend | Own | Pages | Bytes |
|---|---|---|---|---|---|---|---|---|
| 0 | COSMON-MAIN-A01 | PROG | I | R | RWACD | RWACD | 65 | 286720 |
| 1 | COSMON-DEF-A01 | CONF | I | R | RWACD | RWACD | 2 | 1907 |
| 2 | COSMON-LOAD-A01 | MODE | I | R | RWACD | RWACD | 2 | 472 |
| 3 | COSMON-SERV-A01 | PROG | I | R | RWACD | RWACD | 13 | 268288 |
| 4 | REP-COSMON-A01 | RPRT | I | R | RWACD | RWACD | 31 | 61440 |
| 5 | COSMON-STAT-A01 | LOOK | I | R | RWACD | RWACD | 2 | 233 |
| 6 | COSMON-WIND-A01 | PROG | I | R | RWACD | RWACD | 44 | 274432 |
| 7 | INST-COSMON-A01 | PROG | I | R | RWACD | RWACD | 61 | 190842 |
8 files using 220 pages. 607 pages reserved out of 610 pages.