Page 1¶
Norsk Data A.S¶
PROGRAM DESCRIPTION¶
Date: 88.04.13
Page: 1 of 5
Product¶
| Name | ND-no. | Category |
|---|---|---|
| COSMOS X.25 Program Access | 211197A | SPEC |
Reason¶
X New version
Documentation¶
| Title | ND-no. |
|---|---|
| COSMOS X.25 Option Programmer Guide | 60.227.1 EN |
| COSMOS X.25 Option Operator Guide | 30.034.1 EN |
Purpose¶
Libraries to allow the access to COSMOS X.25 Option from programs written in PLANC.
Prerequisites¶
| Computer | Type | Floating format | Op. system | Version |
|---|---|---|---|---|
| ND-100 | Any | Any | SINTRAN III | >= J |
| ND-110 | Any | Any | ----- " ---- | ------- |
| ND-120 | Any | Any | ----- " ---- | ------- |
| ND-500 | Any | Any | ----- " ---- | ------- |
| ND-5000 | Any | Any | ----- " ---- | ------- |
| ND-no. | Product name | Version |
|---|---|---|
| 210373 | X-MESSAGE (Inter System) | >=J |
| Access to one of the following products: | ||
| 210570 | COSMOS X.25 Option for PIOC | >=A |
| 210573 | COSMOS X.25 Option (HDLC) | >=C |
| ND-no. | File Name | Type | Containing |
|---|---|---|---|
| 210609A | XMP-B02 | DEFS | XM-LIB PLANC def. |
| 210609A | XMP-B02 | IMPT | XM-LIB PLANC imp. |
| 210609A | XMP-100-1-B02 | BRF | XM-LIB PLANC/1bank |
| 210609A | XMP-100-2-B02 | BRF | XM-LIB PLANC/2bank |
| 210609A | XMP-500-B02 | NRF | XM-LIB PLANC/ND500 |
Minimum Mass Storage Resources for Installation¶
| User | Userspace | Number of files |
|---|---|---|
| UTILITY | 60 pages on | 10 files |
| (any user may be used) |
Minimum Permanent Mass Storage Resources¶
| User | Userspace | Number of files |
|---|---|---|
| UTILITY | 60 pages on | 10 files |
| (any user may be used) |
Space Requirement on Seg File(s)¶
Space requirement on seg file(s) is 0 pages
| ND.no. for Source | |
|---|---|
| 2502388A |
ooo ND Norsk Data ooo
Scanned by Jonny Oddene for Sintran Data © 2011
Page 2¶
Norsk Data A.S Program Description¶
COSMOS X.25 Program Access¶
| Date | Page |
|---|---|
| 88.04.13 | 2 of 5 |
| Product Name | ND-no. | Category |
|---|---|---|
| COSMOS X.25 Program Access | 211197A | SPEC |
File Information¶
| File Name | Type | Containing |
|---|---|---|
| INST-X25PA-A |
MCRO | PERFORM installation program |
| X25PA-100-1-A |
BRF | X.25 Library 1-Bank |
| X25PA-100-2-A |
BRF | X.25 Library 2-Bank |
| X25PA-500-A |
NRF | X.25 Library 500/5000 |
| X25PA-LIBR-A |
DEFS | New X.25 Lib def. file |
| X25PA-LIBR-A |
IMPT | New X.25 Lib import file |
| X25PA-INITEX-A |
PLNC | Example, Initiator program |
| X25PA-LISTEX-A |
PLNC | Example, Listener program |
| X25PA-LOADEX-A |
MCRO | Example, Loading the library |
NOTE: <rev> is to be replaced by the current revision of the DIRECTORY or FILE. The revision level is found on the preceding "ND SOFTWARE LIBRARY DISKETTE" pages.
ooo ND Norsk Data ooo
Scanned by Jonny Oddene for Sintran Data © 2011
Page 3¶
PROGRAM DESCRIPTION¶
| Date | 88.04.13 |
|---|---|
| Norsk Data A.S | Page 3 of 5 |
| Product | Name | ND-no. | Category |
|---|---|---|---|
| COSMOS X.25 Program Access | 211197A | SPEC |
1 INTRODUCTION¶
COSMOS X.25 Program Access is offered to ease the use of the message interface for the COSMOS X.25 Options, for both PIOC and HDLC. Intended users are software houses and ND departments with a good knowledge of COSMOS/XMSG programming.
The product consists of a set of library routines which format the messages going to the X.25 Packet Level module, and react to events stemming from the X.25 Packet Level. The library resides in the user address space, and acts as a part of the RT-process or Background program.
The COSMOS X.25 Program Access was delivered as an intrinsic part of the COSMOS X.25 Option (for HDLC), 210573C. For later versions of that product it will be separate. This is because it is a common part for both the COSMOS X.25 Options (ND no. 210570 and ND no. 210573), and because the XMSG programming involved here is too complicated to be categorized as a standard product.
2 SYSTEM PREREQUISITES¶
The following are prerequisites for the installation of the product COSMOS X.25 Program Access:
SOFTWARE:¶
- COSMOS X.25 Option: The libraries may be used with both COSMOS X.25 Option (HDLC-based version) - ND no. 210573C, and the COSMOS X.25 Option for PIOC - ND no. 210570A.
- Operating System: SINTRAN III version J or later.
- X-MESSAGE: Version J or later with a minimum of 15 ports.
3 SYSTEM OVERVIEW¶
The system consists of the three library files, definition and import files necessary for compilation, and examples of use. The examples may be used both as an extension of the documentation, and as a base for building one's own programs.
ooo ND Norsk Data ooo
Page 4¶
INSTALLATION PROCEDURE¶
4.1 Copying the files from the diskettes¶
In the following instructions, replace <rev> with the current revision number.
- Log in as the user which should contain the library files.
- Make sure that this user has at least 60 pages of disk space available.
- Insert the diskette with the directory name 211197A
-XX-01D (double density diskette) or 211197A -XX-01S (single density diskette). - Execute the following commands (operator input is underlined):
@ENTER-DIRECTORY,211197A<rev>-XX-01,FLOPPY-DISC-1,0-_
@PERFORM (211197A<rev>-XX-01:FLOPPY-USER)INST-X25PA-A:MCRO-_
PERFORM 2412F
Macro name (Default = INSTALL-X25) : _
The installation procedure will then start. It will perform the following tasks:
- Check the user specified.
- Delete old product files if of the same version.
- Copy the new files to the given user.
A remote copy mechanism is available, using COSMOS File Transfer. It can be started by the command sequence:
@ENTER-DIRECTORY,211197A<rev>-XX-01,FLOPPY-DISC-1,0-_
@PERFORM (211197A-XX-01:FLOPPY-USER)INST-X25PA-A:MCRO-_
PERFORM 2412F
Macro name (Default = INSTALL-X25) : REMOTE-I-X25-_
4.2 Loading¶
When you have installed the new COSMOS X.25 Program Access files, you can load your program as shown in the file X25PA-LOADEX-A:MCRO.
ooo ND Norsk Data ooo
Page 5¶
Program Description¶
| Date | Norsk Data A.S | Page |
|---|---|---|
| 88.04.13 | PROGRAM DESCRIPTION | 5 of 5 |
| Product | Name | ND-no. | Category |
|---|---|---|---|
| COSMOS X.25 Program Access | 211197A | SPEC |
4.3 Before starting the program.¶
Before starting your program, make sure that the port *X25GATE is defined on your machine.
5 MISCELLANEOUS¶
The following are inconsistencies between this implementation, and the currently available documentation.
5.1 Facility negotiation.¶
To provide for compatibility between the A-version of X.25 and later versions, facility negotiation is done after a special scheme. This applies to the Connect Accept command in the four-step connect procedure.
If no facilities are given here, (Fac. length = 0), the X.25 Packet Level will choose Standard Default Values for Window and Packet Sizes (W.S.=2 and P.S.=128 Bytes). If facilities are given, these are of course used by the X.25 Packet Level, and a corresponding Connect Accept Packet will be sent if values are correct.
The X.25 Packet Level will always negotiate the Packet Size to its Standard Default Value, which is 128 Bytes.
ooo ND Norsk Data ooo
Scanned by Jonny Oddene for Sintran Data © 2011
Page 6¶
ND Software Library Diskette¶
Page 1¶
Containing:
COSMOS X.25 Program Access
Directory Name:
211197A01-XX-01D
User Name: FLOPPY-USER¶
| No | File name | Type | T | Public | Friend | Own | Pages | Bytes |
|---|---|---|---|---|---|---|---|---|
| 0 | INST-X25PA-A01 | MCRO | I | R | R | RWACD | 4 | 3798 |
| 1 | X25PA-100-1-A01 | BRF | I | R | R | RWACD | 8 | 13477 |
| 2 | X25PA-100-2-A01 | BRF | I | R | R | RWACD | 8 | 13711 |
| 3 | X25PA-500-A01 | NRF | I | R | R | RWACD | 9 | 15495 |
| 4 | X25PA-LIBR-A01 | DEFS | I | R | R | RWACD | 8 | 12561 |
| 5 | X25PA-LIBR-A01 | IMPT | I | R | R | RWACD | 3 | 3161 |
| 6 | X25PA-INITEX-A01 | PLNC | I | R | R | RWACD | 6 | 9538 |
| 7 | X25PA-LISTEX-A01 | PLNC | I | R | R | RWACD | 6 | 9023 |
| 8 | X25PA-LOADEX-A01 | MCRO | I | R | R | RWACD | 3 | 601 |
9 files using 55 pages. 607 pages reserved out of 610 pages.