top - download
⟦85562ba39⟧ Wang Wps File
Length: 21967 (0x55cf)
Types: Wang Wps File
Notes: PC/USM/001
Names: »4632A «
Derivation
└─⟦9fe574faa⟧ Bits:30006242 8" Wang WCS floppy, CR 0334A
└─ ⟦this⟧ »4632A «
WangText
…00……00……00……00……00…@…02……00……00…@
@…05…@…07…?…0e…?…86…1 …02… …02… …02…
…02…PC/USM/001
/840314 …02……02…#
SOFTWARE MAINTENANCE USERS MANUAL
…02……02… PC
SOFTWARE MAINTENANCE USERS MANUAL
PC/USM/001
KENNETH PLESNER
B[RGE HERMANSEN
SHAPE (12), GJ, OWE (4), DL, KPL,
BHE, EHO, EV (2)
…0e…PC PROJ.MGR 840314…0f…
1.0
840314 …0f… …0f…
PC/USM/001
…02… /840314…02… ii
SOFTWARE MAINTENANCE USERS MANUAL
…02… …02… PC
…0f…
840314 All Initial issue of
Document
PC/USM/001
…02… /840314…02… iii
SOFTWARE MAINTENANCE USERS MANUAL
…02… …02… PC
…0f…
TABLE OF CONTENTS
1 GENERAL ..........................................
1
1.1 PURPOSE AND SCOPE ............................
1
1.2 APPLICABLE DOCUMENTS .........................
2
1.3 TERMS AND ABBREVIATIONS ......................
3
1.3.1 Terms ....................................
3
1.3.2 Abbreviations ............................
3
2 CONFIGURATION LOG ................................
5
3 PACKAGE DIRECTORY ................................
7
3.1 DIRECTORY STRUCTURE AND CONTENTS .............
7
3.2 NAMING STANDARD AND JOB FILES ................
10
4 PREFIXES AND DATA FILES ..........................
12
4.1 PC PREFIX FILES ..............................
12
4.2 PACKAGE PREFIX FILES .........................
13
4.3 PACKAGE DATA FILES ...........................
13
5 PACKAGE COMMANDS .................................
14
5.1 COMMON PACKAGE COMMAND FORMAT ................
14
6 SYSTEM INTEGRATION DIRECTORY .....................
17
6.1 STRUCTURE AND CONTENTS .......................
17
6.2 SYSGEN AND PROMGEN ...........................
18
1 G̲E̲N̲E̲R̲A̲L̲
1.1 P̲U̲R̲P̲O̲S̲E̲ ̲A̲N̲D̲ ̲S̲C̲O̲P̲E̲
This document describes how S/W Maintenance and Configuration
Control is performed on the Protocol Converter CR80
SW.
The outline of the document is similar to the one used
at a package/subpackage level on the CAMPS Project.
The PC outline is obtained largely by substituting
in the CAMPS outline the word 'package' with 'system'
and 'subpackage' with 'package'.
Section 2 describes how a configuration log is maintained
in order to identify which package versions make up
the current system version.
Section 3 describes how files belonging to each of
the PC S/W packages are kept in a dedicated directory
structure reflecting the current versions of modules
used in the package.
Section 4 describes Common System Prefixes, Package
Level Prefixes and Data Files.
Section 5 is an overview of commands passed between
packages.
In section 6 procedures and files used for PC Boot
Module and EPROM File Generation are given.
1.2 A̲P̲P̲L̲I̲C̲A̲B̲L̲E̲ ̲D̲O̲C̲U̲M̲E̲N̲T̲S̲
1.2.1 Protocol Converter Contract SHNMO-82-9205-INF,
1982-04-29.
1.2.2 Software Maintenance User's Manual,
CPS/AUX/001, Issue 1, Christian Rovsing A/S, 1984-01-02.
1.2.3 Generation of PC Build One, PC/AUX/008,
Issue 3, Christian Rovsing A/S, 1983-12-02.
1.2.4 PC Software Configuration Management, PC/AUX/003,
Issue 3.2, Christian Rovsing A/S, 1983-05-30
(in Danish).
1.3 T̲E̲R̲M̲S̲ ̲A̲N̲D̲ ̲A̲B̲B̲R̲E̲V̲I̲A̲T̲I̲O̲N̲S̲
1.3.1 T̲e̲r̲m̲s̲
S/W Configuration Management:
a set of procedures for secure program retention and
identification.
Library Disc:
background storage of released software, (contrary
to the work disc).
1.3.2 A̲b̲b̲r̲e̲v̲i̲a̲t̲i̲o̲n̲s̲
ADP Automated Data Processing
AMOS Advanced Multiprocessor Operating System
CAMPS Computer Aided Message Processing System
CCIS Command and Control Information System
CI Command Interpreter
CLP CCIS Low Level Protocols
CM Configuration Management
CPA CCIS Protocol Adaptor
CR Christian Rovsing A/S
CR80 CR80 Minicomputer (Christian Rovsing)
CSA CPU SCM Adaptor
CSLP CAMPS/SCARS low Level Protocols
CSPA CAMPS/SCARS Protocol Adaptor
DINDAC autoDIN-wwmccs Direct Access Communications
Module
EPROM Erasable Programmable Read-only Memory
GRTS/355 General Remote Terminal Supervisor
of DN 355
I/F Interface
LIA-N Line Interface Adaptor
LTU Line Terminating Unit
MAC Maintenance Controller
PC Protocol Converter
PROM Programmable Read-only Memory
QA Quality Assurance
RAM Random Access Memory
SCARS Status and Control Alerting and Reporting
System
SCM System Control Module
SRS System Requirement Specification
SWELL Software Engineering Low Level Language
TBD To Be Defined
VDU Visual Display Unit
2 C̲O̲N̲F̲I̲G̲U̲R̲A̲T̲I̲O̲N̲ ̲L̲O̲G̲
The EPROM Chips used for the CR8013 EPROM Board and
identified by numbers 2537-xx thru 2554-xx.
Digits xx designate the current version of EPROM's.
The Configuration Log will relate the EPROM version
to the status of the S/W Packages. For each S/W package
the following information is provided in the log:
- Package Name
- Version/Release Numbers of Current Package Version
under CM
- Status of Test Documentation if the package was
developed within the project
- Status of Design Documentation
- CM foot notes if applicable
An example is given overleaf.
/831205
P̲r̲o̲t̲o̲c̲o̲l̲ ̲C̲o̲n̲v̲e̲r̲t̲e̲r̲ ̲S̲o̲f̲t̲w̲a̲r̲e̲ ̲D̲e̲l̲i̲v̲e̲r̲y̲ ̲S̲t̲a̲t̲u̲s̲
(Factory Acceptance Test, Site 3)
PROMS Version 02
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
^ Software ^ Version/Release ^
QA
Approved
Test
^
Design ^
^ Package ^ Delivered ^
Documentation ^
Documentation
^
^ ̲N̲a̲m̲e̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲A̲p̲p̲l̲i̲e̲s̲ ̲t̲o̲:̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲^̲ ̲U̲p̲d̲a̲t̲e̲d̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^
^ ^ ^ ^ ^
^ CI ^ V0108 ^
V0101 ^
Yes
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^
^ ^ ^ ^ ^
^ TRC ^ V0103 ^
V0101 ^
Yes
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^
^ ^ ^ ^ ^
^ CSPA ^ V0103 ^
V0101 ^
Yes
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^
^ ^ ^ ^ ^
^ CSLP ^ V0102(PC version)^
Not Applicable ^
Not
Applicable^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^
^ ^ ^ ^ ^
^ CPA ^ V0104 ^
V0101 ^
Yes
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^
^ ^ ^ ^ ^
^ CLP ^ V0102 (3) ^ ^
No ^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^
^ ^ ^ ^ ^
^ MAC ^ V0105 ^
V0101 ^
Yes
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^
^ ^ ^ ^
Separately ^
^ CISDRV ^ V0107 ^ ^
Documented
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^
^ ^ ^ ^ ^
^ SCADRV ^ V0107 ^ ^
-"-
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^
^ ^ ^
Tested
during ^ ^
^ MONITOR ^ V0104 ^
test
of
CI
and
TRC ^
Yes ^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^
^ ^ ^ ^ ^
^ SGI ^ V0101 ^
V0101
^
Yes
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^
3 P̲A̲C̲K̲A̲G̲E̲ ̲D̲I̲R̲E̲C̲T̲O̲R̲Y̲
This section describes the directory structure used
for each package at the work volume and the library
volume attached to the department's CR80 Development
System.
3.1 D̲I̲R̲E̲C̲T̲O̲R̲Y̲ ̲S̲T̲R̲U̲C̲T̲U̲R̲E̲ ̲A̲N̲D̲ ̲C̲O̲N̲T̲E̲N̲T̲S̲
Each package has a subdirectory named as the package
itself.
The package directory has the following subdirectories:
- Prefix Directory
- Module Directories
- Link Directory
- Test Directory
Version Directories such as V0102.D contains the files
for version 01, release 02 of a S/W prefix, module,
or package. The version is incremented when a major
design change is introduced starting at 01. The release
number is changed for minor corrections also starting
at 01.
When introducing new versions the release number is
reset to 01.
FIGURE 3.1-1
PC PACKAGE DIRECTORY STRUCTURE
The Prefix Directory will have one or more subdirectories
with names reflecting the prefix version. A Prefix
Source File with a module header is kept in the version
directory. The Prefix Files are named:
PREFIX.S source file
HEAD.S prefix CM file
Module Directories contain version subdirectories.
Each version directory contains the files:
COMPILE.J job file
(module ̲name).S source file
(module ̲name).P print file
(module ̲name).L object file
HEAD.S module CM file
The Link Directory is also divided into version directories.
Each version diretory will contain the following files:
(package ̲name).RL CM release description
LINK.J jobfile for linking
LINK.T link parameters
(package ̲name).C output from linker
(package ̲name).LP printfile from linker
The directory TEST.D contains a text file named
TEST ̲SPEC.T. This text is a detailed step by step description
of how the S/W package in question is prepared for
test. When Test Drivers are used, the code for them
is available in TEST.D as well.
3.2 N̲A̲M̲I̲N̲G̲ ̲S̲T̲A̲N̲D̲A̲R̲D̲ ̲A̲N̲D̲ ̲J̲O̲B̲ ̲F̲I̲L̲E̲S̲
The file names are composed of an identifier and a
qualifier.
The syntax is:
file name::=identifier.qualifier
identifier::=up to 14 characters
qualifier::=letter
Qualifiers are listed below:
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲
^ ^
^
^ qualifier ^ use
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ D ^ Directory
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ S ^ Source Code
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ M ^ Merged Source
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ C ^ Code (Object from linker)
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ B ^ Binary Object
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ P ^ Compiler Print File
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ T ^ Text
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ H ^ Hexadecimal
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ I ^ Import Prefix
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ L ^ Link Module (to linker)
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ J ^ Job Command File
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ LP ^ Link Print
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^ ^
^
^ RL ^ Release Decription
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲^̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
The job files for generating the object code for one
of the CR80 S/W Packages are:
- COMPILE.J for compilation of each module
- LINK.J for linking compiled modules together.
4 P̲R̲E̲F̲I̲X̲E̲S̲ ̲A̲N̲D̲ ̲D̲A̲T̲A̲ ̲F̲I̲L̲E̲S̲
4.1 P̲C̲ ̲P̲R̲E̲F̲I̲X̲ ̲F̲I̲L̲E̲S̲
PC ̲COMMON.D
V0104.D
PC ̲COMMON.S
PA ̲INTERFACE.D
V0101.D
PA ̲INTERFACE.S
TRC ̲INTERFACE.D
V0102.D
TRC ̲INTERFACE.S
LP ̲INTERFACE.D
V0103.D
LP ̲INTERFACE.S
LP ̲CI ̲RESPONSE.S
V0102.D
LP ̲CI ̲RESPONSE.S
SWELLPREFIX.D
DRIVERPARAMS.S
DISKDRVPARAMS.S
IOSPARAMS.S
KERNELPARAMS.S
X2GENPARAMS.S
TESTPARAMS.S
GENERALPARAMS.S
MONITORNAMES.S
COMONPARAMS.S
VOL ̲STRUCTURES.S
KERNELPARAMS
The contents of the directory PC.D*PREFIX.D on the
w̲o̲r̲k̲ ̲v̲o̲l̲u̲m̲e̲ is listed above. The l̲i̲b̲r̲a̲r̲y̲ ̲v̲o̲l̲u̲m̲e̲ will
contain the same structure comprising previous versions
as well.
4.2 P̲A̲C̲K̲A̲G̲E̲ ̲P̲R̲E̲F̲I̲X̲ ̲F̲I̲L̲E̲S̲
For each package directory there exists a subdirectory
named PREFIX.D.
A version directory will contain the PREFIX Source
File named PREFIX.S.
PREFIX.S only contains declarations of constants and
types in SWELL.
4.3 P̲A̲C̲K̲A̲G̲E̲ ̲D̲A̲T̲A̲ ̲F̲I̲L̲E̲S̲
Data Declarations are kept in the module source files
or in separate files for variables which are merged
into the source during compilation.
5 P̲A̲C̲K̲A̲G̲E̲ ̲C̲O̲M̲M̲A̲N̲D̲S̲
5.1 C̲O̲M̲M̲O̲N̲ ̲P̲A̲C̲K̲A̲G̲E̲ ̲C̲O̲M̲M̲A̲N̲D̲ ̲F̲O̲R̲M̲A̲T̲
Packages are implemented as CR80 Processes. Commands
are sent from process to process in a hierarchical
manner.
Higher ranking processes send commands to lower processes
as AMOS MESSAGE buffers. Answers to the commands are
AMOS ANSWER's. The AMOS MESSAGE/ANSWER buffers used
have a size of 5 words. If this is insufficient the
buffers are expanded by including an absolute pointer
to more parameters.
Example:
The CI Package sends the following commands to the
TRC package:
LOGON
LOGOFF
TEST
VERIFY
ENABLE STATUS
Each of these commands is identified by a constant
from 0 through 4:
TYPE
TRC ̲COMMAND ̲ID =
( TRC ̲LOGON ̲ID,
TRC ̲LOGOFF ̲ID,
TRC ̲TEST ̲ID,
TRC ̲VERIFY ̲ID,
TRC ̲ENABLE ̲STATUS ̲ID );
The constant TRC ̲LOGON ̲ID is 0, TRF ̲LOGOFF ̲ID is 1
and so on.
The command will have the following type declaration:
TYPE
TRC ̲VERIFY ̲CMD =
RECORD
ID : TRC ̲COMMAND ̲ID;
SYSTEM : END ̲SYSTEMS; " CAMPS, SCARS or CCIS
LENGTH : INTEGER; " length of test message
FILL : ARRAY(0..1) OF INTEGER; " not used
END;
Each field is one word (16 bits) long.
The response returned from TRC to CI looks like this:
TYPE
TRC ̲RESPONSE = "response buffer returned from TRC
to C1
RECORD
ID : TRC ̲COMMAND ̲ID; " command replied
CC : COMPLETION ̲CODE;
RESULT: ARRAY(0..2) OF INTEGER;
END;
If the command was successfully executed, the response
buffer will have a zero in the field CC otherwise this
field contains the value TRC ̲ID + an error code as
listed below.
"T̲R̲C̲ ̲C̲o̲m̲p̲l̲e̲t̲i̲o̲n̲ ̲C̲o̲d̲e̲s̲"
CONST
TRC ̲WRONG ̲COMMAND ̲ID = #01 + TRC ̲ID;
TRC ̲ALREADY ̲PENDING = #02 + TRC ̲ID;
TRC ̲STATE ̲INCONSISTENCE = #03 + TRC ̲ID;
TRC ̲RESPONSE ̲INCONSISTENCE = #04 + TRC ̲ID;
TRC ̲WONG ̲PARAMETER = #05 + TRC ̲ID;
TRC ̲WRONG ̲MODE = #06 + TRC ̲ID;
TRC ̲TRANSACTION ̲LENGTH ̲ERROR = #08 + TRC ̲ID;
TRC ̲TIMEOUT = #09 + TRC ̲ID;
TRC ̲TEST ̲FAILED = #0A + TRC ̲ID;
The constant 'TRC ̲ID' has the value #A000.
FIGURE 5.2-1
COMMAND STRUCTURE
6 S̲Y̲S̲T̲E̲M̲ ̲I̲N̲T̲E̲G̲R̲A̲T̲I̲O̲N̲ ̲D̲I̲R̲E̲C̲T̲O̲R̲Y̲
6.1 S̲T̲R̲U̲C̲T̲U̲R̲E̲ ̲A̲N̲D̲ ̲C̲O̲N̲T̲E̲N̲T̲S̲
The System Integration Directory can be found on the
library disc name PC ̲LIB as a subdirectory to the directory
PC.D shown in Figure 3.1-1.
SYSTEM.D contains three subdirectories:
- SYSGEN.D
- CONCAT.D
- PROMGEN.D
In SYSGEN.D a bootmodule is generated containing AMOS
and application software. LTU FW packages CLP and CSLP
has been compiled into the LTU drivers.
The directory CONCAT.D is used for appending a header
fill to the application boot module.
Furthermore an intermediate fill file is inserted between
the application boot module and the H/W Test Program
part MAC.
Finally, the directory PROMGEN.D is used to format
18 files for generating sixteen 8K words data EPROM's
and two 8K words parity EPROM's.
6.2 S̲Y̲S̲G̲E̲N̲ ̲A̲N̲D̲ ̲P̲R̲O̲M̲G̲E̲N̲
In order to generate a set of 2764 EPROM's use the
SYSGEN Utility Version 0304. In the boot module generated
by SYSGEN applications programs should start at addresses
which are multiple of 8K words. Smaller packages may
be held together within 8K word blocks.
This blocking is accomplished by using FILL options
in SYSGEN V0304. If module A has a start address plus
length below address #8000, and module B should start
at #8000 enter the following lines during SYSGEN dialogue:
.
.
.
file name for module A
FILL
#8000
file name for module B
.
.
.
.
SYSGEN is performed in the directory
PC.D*SYSTEM.D*SYSGEN.D by entering 'DO J'.
N̲o̲t̲e̲ ̲t̲h̲e̲ ̲s̲i̲z̲e̲ ̲o̲f̲ ̲t̲h̲e̲ ̲S̲Y̲S̲G̲E̲N̲ ̲o̲u̲t̲p̲u̲t̲ ̲f̲i̲l̲e̲ ̲n̲a̲m̲e̲d̲ ̲C̲
In order to generate a complete file to be prommed
enter the directory PC.D*SYSTEM.D*CONCAT.D.
The file PROMFILE.B is now to be generated to match
the 64K words EPROM contents. PROMFILE.B is a concatenation
of four files:
̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲
^
^
^ SIZE FILE
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
^
^
^ 2048 bytes HEADER ̲FILL.B
^
^
^
^ C bytes PC.D*SYSTEM.D*SYSGEN.D*C
^
^
^
^ X bytes FILL.B
^
^
^
^ PC.D*MAC.D*TEST.D*SYSGEN.B
^
^ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲ ̲
̲ ̲ ̲ ̲ ̲^
Since the fourth file containing MAC must start at
#E000 = 114688 bytes the required size of the intermediate
fill file FILL.B becomes:
114688 - 2048 - C = X bytes
FILL.B is produced by cutting off the first D-X bytes
of the file FILL.S using the CEDIT utility. D is the
size of the file FILL.S
Verify the concatenation process by utility BINHEX
on the file PROMFILE.B. The MAC Package should start
at #E000 with the special INIT module combined program/process
header.
To summarize tahe concatenation process:
enter DO FILL.J and
DO CONCAT.J and
BINHEX I:PROMFILE.B
Verify that MAC is located at address #E000.
To format the file for the PROM Programmer enter the
directory:
PC.D*SYSTEM.D*PROMGEN.D
The PC PROMGEN V0102 should be used.
Enter the command:
DO P ̲ALL.J
and write down the checksums for PROM files generated,
i.e. files PE15.B, PF15.B PE18.B, PF18.B, ...., PE37.B,
and PF37.B.
Add all the above checksums for the PE ... - files.
Add all the checksums for the PF ... - files.
Calculate a hexadecimal byte number which will make
the PE sum end at 00 when added to it. This is the
LSByte adjustment number.
The MSByte checksum number is calculated as shown below:
sum of PE checksums = XXYY
sum of PF checksums = VVZZ
LSByte adjustment = #100-YY
MSByte adjustment = #100-(XX+1+ZZ)
Enter the MAC main module directory and add the LSByte
adjustment to the variable EPROM ̲CHECKSUM ̲LEAST, least
significant byte. Add the MSByte adjustment to the
variable EPROM ̲CHECKSUM ̲LEAST, most significant byte.
Recompile, link, and SYSGEN the MAC package in directory
PC.D*MAC.D*TEST.D
After a new run of CONCAT and PROMGEN the new checksum
values are:
sum of PE checksums = XXYY = XX00
sum of PF checksums = VVZZ
where
XX + ZZ = #100
Checksumming the EPROM by adding words will result
in a checksum with four zeroes at its tail.
Mount two floppy discs with volume names PCUPPPER and
PCLOWER. Copy the PROM files to the floppy discs using
the command file COPY.J. Note how files are renamed
to match the PROM numbers on the CR8013 EPROM board.
Volumes PCUPPER and PCLOWER must be mounted on the
system.
The DATA I/O is set to control the data flow from the
CR80 by entering:
keyboard/select/D2/enter/start
On the nearby TEXAS silent enter the commands shown
in appendix A.
Verify the check sum and enter:
prog/start
on the DATA I/O SYSTEM 19
PROMs are labelled 2437-xx thru 2554-xx, where xx is
the PC version.
PROM version numbers (xx) must be reserved for use
in
PC. A new Configuration Log sheet must be issued reflecting
the S/W package versions of the currently released
set of PROMs.
