Digital PDFs

AA-H169A-TC

September 1978

45 pages

Original

1.3MB

Document:	DATATRIEVE-11 1.1 Installation Guide Sep78
Order Number:	AA-H169A-TC
Revision:	0
Pages:	45
Original Filename:	AA-H169A-TC_DATATRIEVE-11_1.1_Installation_Guide_Sep78.pdf

OCR Text

DATATRIEVE-11{V1.1)
lAS, RSX-11M, RSTS/E
Installation Guide
Order No. AA-H 169A-Te

September 1978

This manual describes the procedures to install DATATRIEVE-11 on the following operating systems: lAS, RSX-11 M, and RSTS/E.

DATATRIEVE-11(V1.1 }
lAS, RSX-11 M, RSTS/E

Installation Guide
Order No. AA-H 169A-TC

SUPERSESSION/UPDATE INFORMATION: This document completely supersedes the documents
with the following name and Order No.:
DATATRIEVE-11 lAS Installation Guide, Order No.
AA-C74SA-TC, published December 1977.
DATATRIEVE-11 RSX-11 M Installation Guide, Order No.
AA-C744A-TC, published December 1977.
DATATRIEVE-11 RSTS/E Installation Guide, Order No.
AA-C74SA-TC, published December 1977.

OPERATING SYSTEM AND VERSION:

lAS V2.0
RSX-11 M V3.1
RSTS/E VSC

SOFTWARE VERSION:

PDP-11 DATATRIEVE-11 V1.1

To order additional copies of this document, contact the Software Distribution
Center, Digital Equipment Corporation, Maynard, Massachusetts 01754

digital equipment corporation · maynard. massachusetts

First Printing, September 1978
The information in this document is subject to change without notice and
should not be construed as a commitment by Digital Equipment Corporation.
Digital Equipment Corporation assumes no responsibility for any errors that
may appear in this document.
The software described in this document is furnished un9r a license and may
only be used or copied in accordance with the terms of such license.
No responsibility is assumed for the use or reliability of software on equipment that is not supplied by DIGITAL or its affiliated companies.

The postage prepaid READER'S COMMENTS form on the last page of this
document requests the user's critical evaluation to assist us in preparing
future documentation.

The following are trademarks of Digital Equipment Corporation:
DIGITAL
DEC
PDP
DEC US
UNIBUS
COMPUTER LABS
COMTEX
DDT
DECCOMM
ASSIST-II
5 VAX
DECnet

DECsystem-l0
DECtape
DIBOL
EDUSYSTEM
FLIP CHIP
FOCAL
INDAC
LAB-8
DECSYSTEM-20
RTS-8
VlVIS
lAS

MASSBUS
OMNIBUS

08/8
PHA
R8TS
RSX
TYPESET-8
TYPESET-II
TMS-ll
ITPS-I0
SBl

Contents
Page

Preface

Documentation Conventions

Chapter 1 General Information
1.1
1.2
1.3

Installation Kit . . . . . . . . . . . .
Physically Mounting Distribution Media
Possible Errors during Installation .

· 1-1
· 1-1
· 1-2

Chapter 2 lAS V02 Installation Procedures
2.1

2.2

2.3

System Requirements . . . . .

· 2-1

2.1.1
2.1.2

·2-1
·2-2

Software Requirements.
Hardware Requirements

Procedures for Installing DATATRIEVE-ll on lAS V02

·2-2

2.2.1
2.2.2
2.2.3
2.2.4
2.2.5
2.2.6

·2-2
·2-2
·2-2
·2-3
·2-3
·2-5

Summary of Installation Procedures . . . .
Log in Under a Privileged Account . . . .
Logically Mount the Distribution Medium.
Copy the Distribution Medium . . . . . .
Executing the Command File DTRIA8.CMD
Log off the System.

DATATRIEVE-11 Files . . . . . . . . .

·2-6

Chapter 3 RSX-11 M V03 Installation Procedures
3.1

3.2

3.3

System Requirements . . . . .

·3-1

3.1.1
3.1.2

·3-1
·3-2

Software Requirements.
Hardware Requirements

Procedures for Installing DATATRIEVE-11 on RSX-11M V03 .

·3-2

3.2.1
3.2.2
3.2.3
3.2.4
3.2.5
3.2.6

·3-2
·3-2
·3-2
·3-3
·3-3
·3-5

Summary of Installation Procedures. . . . . . . . . .
Log in Under a Privileged Account . . . . . . . . . .
Allocate (and Mount, if Disk) the Distribution Medium
Copy the Distribution Medium. . . . . . . .
Executing the Command File DTR11M.CMD .
Log off the System.

DATATRIEVE-11 Files . . . . . . . . . . . . . . .

. 3-5

Chapter 4 RSTS/E V06C Installation Procedures
4.1

System Requirements . . . . .

·4-1

4.1.1
4.1.2

·4-1
·4-2

Software Requirements.
Hardware Requirements

4.2

4.3

Procedures for Installing DATATRIEVE-11 on RSTS/E V06C

.4-2

4.2.1
4.2.2
4.2.3
4.2.4
4.2.5

Summary of Installation Procedures. . . . . . . . .
Log in Under a Privileged Account . . . . . . . . .
Logically Assign the Magtape or Mount the Disk Distribution
Copy the Distribution Medium .
Executing the BUILD Program . . . . . . . . . . . . . . ,

.4-2
. 4-2
. 4-2
. 4-3
.4-3

DATATRIEVE-11 Files . . . . . . . . . . . . . . . . . . . . . .

.4-7

Chapter 5 Compressing the Data Dictionary and Extending DATATRIEVE-11
5.1
5.2
5.3
5.4

Compressing the Data Dictionary . . . . .
Extending DATATRIEVE-11 Task Space.
Extending the Data Dictionary. . . .
Automatic Spooling under RSX-11M .

Appendix A The Acceptance Test Procedure

·5-1
·5-2
·5-3
·5-3
A-I

962ALL

Preface
This manual is a guide to the installation ofDATATRIEVE-ll on the following operating systems:
lAS V2.0
RSX-I1M V3.1
RSTSIE V6C
This manual is written for the system manager who is responsible for performing the installation procedures.
The information in this manual is organized in the following manner:
Chapter 1 comments about the installation kit, describes how to physically
mount the distribution media, and indicates errors that might occur during
installation.
Chapter 2 describes how to install DATATRIEVE-ll on an lAS system.
Chapter 3 describes how to install DATATRIEVE-ll on an RSX-IIM system.
Chapter 4 describes how to install DATATRIEVE-ll on an RSTSIE system.
Chapter 5 describes possible uses of the Data Dictionary Extend Program,
extending DATATRIEVE-l1 task space, and the Dictionary Compression
Utility Program.
Appendix A contains the Acceptance Test Procedure.

Documentation Conventions
The following conventions are used throughout this manual to illustrate the
DATATRIEVE installation procedures:
The symbol (B@ represents the non-printing carriage
return key.
lower case
UPPER CASE

Lower-case text indicates variable information that you
supply; upper-case text indicates literal information that
you enter as shown.

color Information that you type during the installation procedure is indicated in red.
The circumflex (A) represents a control character. That
is, (¢TRUZ) is the same as Z.
A

Chapter 1
General Information

1.1 Installation Kit
You receive a kit containing all material necessary to install
DATATRIEVE-ll on the computer at your site. Check the contents against
your original order. If there are any discrepancies between what you ordered
and what your received, report the discrepancies to your sales representative.

1.2 Physically Mounting Distribution Media
1. For magtape distribution proceed as follows:

a. Obtain the magtape from your kit and mount it on a free tape drive
with the write enable ring removed.
b. Ensure that the FILE PROT (file protection) indicator light is lit.
c. Ensure that the tape is at its load point (the LD PT indicator light is
lit) .
d. Set the ON LINE/OFF LINE switch on the tape unit to ON LINE, and
ensure that the RDY (ready) indicator light is lit.
2. For disk cartridge distribution proceed as follows:
a. Obtain the disk cartridge from your kit and insert it into a free disk
drive unit.
b. Place either the LOAD/RUN switch for the RK05 or the RUN/STOP
switch for the RK06 and RK07 to run position. Press the LOAD button
on the RL01.
c. Ensure that the RDY (ready) indicator light is lit.
d. Ensure that the WR PROT (write protect) indicator light is lit.

1-1

1.3 Possible Errors during Installation
When you are performing your installation procedures, you may get certain
error messages. Should you get one of these messages, refer to this section.
A possible error that can occur during the DATATRIEVE-ll installation is
the failure of the QDICT program. If such an error occurs, the following
message is printed on the terminal.
RMS ERROR STATUS:xxx

where xxx is an octal RMS error code. Refer to the IAS/RSX-IIM RMS-ll
MACRO Programmer's Manual for the meaning of the error code and possible
recovery procedures. When you have corrected the error, rerun the command
file.
If the following message appears:
WRITE SHARING NOT AVAILABLEt PROCEEDING ANYWAY

write-locking has not been installed on the system. The installation continues
from this point; however, you must install write-locking and reinstall
DATATRIEVE-ll. A system generation may be required to install writelocking. With write-locking installed, you can rerun the command file.
Another possible error is the termination of the QDICT task build. If the task
build terminates with the following error message:
TKB -- *DIAG*G UNDEFINED SYMBOLS SEGMENT SAVREG

The most likely cause is that RMS-IIK has not been installed. To determine
whether or not RMS-IIK has been installed, examine the QDICT.MAP file.
If these symbols:
$CL03E
$CRE3E
$OPE3E

$CON3E
$DIS3E
$PUT3E

are undefined, RMS-IIK has not been installed on the system.

1-2

General Information

Chapter 2
lAS V02 Installation Procedures

This chapter is a guide to the installation of DATATRIEVE-11 on the lAS
V02 Operating System.
The information in this chapter is organized in the follovling manner.

Section 2.1 presents both the software and hardware requirements needed to
install DATATRIEVE-11.
Section 2.2 contains the procedures to install DATATRIEVE-11 on your
system.
Section 2.3 lists the DATATRIEVE-11 files that reside in the target DIe's.

2.1

System Requirements
The software and hardware listed in Sections 2.2.1 and 2.2.2 respectively are
required to install DATATRIEVE-11.

2.1.1 Software Requirements
lAS Version 2
RMS-11K Version 1 (for RMS Indexed Record I/O)
RMS-11K software must be present on your computer prior to installing
DATATRIEVE-11. IfRMS-11K is not present, you must first install it before
installing DATATRIEVE-11. Get the kit containing the RMS-11K software,
and install this software following the procedures presented in the RMS-11 K
lAS Installation Guide.

2-1

2.1.2 Hardware Requirements
The following system configuration
installa tion.

required for DATATRIEVE-ll

CPU

PDP-II with EIS hardware.

MEMORY

64K bytes above the minimum operating system requirements.

TERMINAL

Any supported terminal (hard copy terminals are preferred.)

TAPE

One 9-track magtape drive.

or
DISK

RK05, RK06, RK07, or RLOI drive.

DISK SPACE

2300 free blocks must be available in the target account for
DATATRIEVE-l1.

2.2 Procedures for Installing DATATRIEVE-11 on lAS V02
2.2.1 Summary of Installation Procedures
1. Log in under a privileged account([I,x]).
2. Physically mount the distribution medium as described in Chapter 1.
3. Logically mount the distribution medium.
4. Copy the distribution medium into your account (then remove the distribution medium).
5. Execute the command file DTRIAS.CMD.
6. Log off the system.

2.2.2 Log in Under a Privileged Account
Log into your computer system under a privileged account in the form ([1,x]).

2.2.3 Logically Mount the Distribution Medium
1. For magtape distribution use the command
MOUNT IFOR/NOOP del.!: OTRll ~

2. For disk cartridge distribution use the command
MOUNT/NOOP del.!: OTRll ~

where dev: is the device specification of the drive containing the distribution
medium.

2-2

lAS V02 Installation Procedures

2.2.4 Copy the Distribution Medium
1. To copy the data on the magtape into the target account type the command

2. To copy the data on the disk cartridge into the target account type the
command
COPY de!J: [ 1 t 1 J *. * *. * (5@

At this time, data on the distribution medium is copied into the target
account. when the copying operation is complete, the prompt PDS> appears
on your terminal.
To logically dismount the distribution medium, type the command
DISMOUNT de 1.1 ~ (Bfll

When the DISMOUNT COMPLETE message appears at your terminal, remove the distribution medium and store it in a safe place.
The installation dialog to this point will be similar to the following example
(magtape distribution):
PDS> MOUNT/FOR/NOOP MM1: DTR11
MOUNT-**VOLUME INFORMATION**
DEI)ICE
=MMl
CLASS
=FOREIGN
UIC
=[1 tiJ
ACCESS
=[RWEDtRWEDtRWEDtRWEDJ
CHARAC
=[FORtATCHtDCFJ
PDS>COPY MM1:[1 t1J*.*/DOS *.*
PDS> DISMOUNT MM1:
DMO -- MM1: ** DISMOUNT COMPLETE **
PDS>

2.2.5 Executing the Command File DTRIAS.CMD
Now type:
@DTRIAS (5@

DTRIAS.CMD is the command file that installs DATATRIEVE-ll into your
system. As part of the command file, the DATATRIEVE-ll Acceptance Test
is executed. During the Acceptance Test, you are required to enter data.
Observe the test as it outputs and respond as the test requests input.

lAS V02 Installation Procedures

2-3

The following example is the log printed as a result of command file execution. Note that the Acceptance Test has been deleted from the example. The
complete Acceptance Test is in Appendix A.

PDS> @ItTF: I l~S
!
!

CREATE DATATRIEVE DIRECTORIES

REMOVE
$$$DTR
REM -- TASK $$'DTR NOT IN SYSTEM
cr\Et-iTE/DIF~

I.B:[11,1:30]

CREATE/DIR
CREATE/DIR

lB:Cl11,130]

LB:[311~l101

COPY fILES TO PROPER LOCATIONS

COPY
DELETE
COpy
DELETE
COpy
DELETE

I t-lS.; MAC
AS. MAC; *
QElf.iS.LNK
OEIAS.LNK;*
QEIAS.ODL..

COpy

DTRIAS.ODL..
OTRIAS.ODL.*
DTRh~~3 + L.NK
DTRIAS +LNI\, JI(
F~MS I AS> ODI...
RMSlt-lS + DDL, *
QCIAS+LNK
(JCIAS.LNK;*
QCIAS.ODL

DEL.ETE
COPY
DELETE
COPY
DELETE
COPY
DELETE
COPY
DELETE
!
!

(~D

LH!r:311,,1.30J*.*

(~ DI

L.B:[11,130J*.~

LB:[:l1,l30J*.*

C~EIAS+ODI...;*

L.B!r::ll,130::l*.*

*., *
I...B: [ 1 1 ., L1()J *. *
LB: [J :1. ~ :I. :30::1

LB:[11.,130J*+*
I...Bt[:Ll,:l.30]*+*

l~CIAS+ODL.;*

INSTALL DATATRIEVE OBJECT LIBRARY

MAC/OBJ:QD
08:40:23

LIBR
COpy

DELETE
DELETE
!
!

lB:[311,,:l.30]QDIAS
CPU: 0+11 Status: Success
INSERT DTRlIB QD
DTRLIB.OLB
DTRLIB+OLB;*
QD.OBJ;*
Size: 26K

INSTALl... DATATRIEVE TASKS

LNK
LINK IOVERLAV:QDIAS ITASK:QDICT/OPT/MAP:QDICT/READ
08:41:52 Size: 27K CPU: 22.10 Status: Success

(~QD UiS.

2-4

lAS V02 Installation Procedures

FrON curfel
08:41:54
CREATING QUERY DICTIONARY
CREATING MESSAGE FILE
POPULATING MESSAGE FILE
BYE
08:46:22 Size: 21K CPU: 21+46
@LB:(11,130JDTRIAS+LNK
LINK /OVERLAY:LB:[11~130JDTRIAS /TASK:LB:[11,lJDTR/OPT/MAP~l,B:[111,130]DTR/MUL/READ

08:51:45 Size: 27K CPU: 48.96 Status: Success
@LB:[11,130JQEIAS+LNK
LINK /OVERLf~lY:LB:[:l.l!'130](~[IAS ....
ITASK:LB:[11,lJQDEXT/OPT/MAP:LB:[111,130JQDEXT/READ
08:52:31 Size! 27K CPU: 13.98 Status: Success
!

@LB:[11,130]QCIAS.LNK
LINK /OVERLAY:LB:[:l.l,130JQCIAS ITASK:LB:[11,l]QCPRS/OPT/MAP:LB:[111r130JQCPRS/READ
08:53:53 Size: 27K CPU: 26.60 Status! Success
SET PROTECT I ON LB: [1, 2 JQUEI~~Y. D:r C
~.JfH;:l...n;: WRE
LB: ;: i 1 !' :I. :] DIR

INSTf~LL

!
!

RUN DATATRIEVE ACCEPTANCE TEST

DTR (HITR. TST

•
•

·•

The DATATRIEVE-ll Acceptance Test Procedure
is contained in Appendix A.

•
EXIT
BYE
!

! SAVE YACHT DEMO FILE

COpy
DELETE

YACHT+DAT
YACHT+DAT;*

! END OF DATATRIEVE INSTALLA1ION

PItS>

2.2.6 Log Off the System
Log off the system after the DTRIAS.CMD file has completed execution (you
observe the PDS> prompt).

lAS V02 Installation Procedures

2-5'

2.3 DATATRIEVE-11 Files
When DATATRIEVE-ll has been installed, the following files reside in the
indicated DIC's. Note that the [SELF] designation represents your privileged
account.
VIC

2-6

FILENAME

DESCRIPTION

[l;ll

DTRLIB.OLB

Datatrieve object library

[1,2]

QUERY.DIC

Data dictionary

[1,2]

QUERY.MSG

Message file

[1,2]

YACHT.DAT

Acceptance test data file

[11,130]

DTRIAS.LNK

Datatrieve task-build command file

[11,130]

DTRIAS.ODL

Datatrieve overlay description file

[11,130]

QCIAS.LNK

COMPRESS program task-build command file

[11,130]

QCIAS.ODL

COMPRESS program overlay description file

[11,130]

QEIAS.LNK

EXTEND program task-build command file

[11,130]

QEIAS.ODL

EXTEND program overlay description file

[11,130]

RMSIAS.ODL

RMS overlay description file

[11,1]

DTRTSK

Datatrieve task image

[11,1]

QCPRS.TSK

Dictionary COMPRESS program

[11,1]

QDEXT.TSK

Dictionary EXTEND program

[111,130]

DTRMAP

Datatrieve map file

[111,130]

QCPRS.MAP

Dictionary COMPRESS program map file

[111,130]

QDEXT.MAP

Dictionary EXTEND program map file

[311,130J

QDIAS.MAC

Dictionary file-name source module

[SELF]

DTRTST

Acceptance test command file

[SELF]

MSGS.SEQ

Message file (distribution format)

[SELF]

QDIAS.LNK

Dictionary build program task-build command file

[SELF]

QDIAS.ODL

Dictionary build program overlay description file

[SELF]

QDICT.MAP

Dictionary build program map file

[SELF]

QDICT.TSK

Dictionary build program

[SELF]

YACHT. SEQ

Acceptance test data file (distribution format)

lAS V02 Installation Procedures

Chapter 3
RSX-11 M V03 Installation Procedures

This chapter is a guide to the installation of DATATRIEVE-ll on the
RSX-lll\tl V03.1 Operating System.
The information in this chapter is organized in the following manner:

Section 3.1 presents both the software and hardware requirements needed to
install DATATRIEVE-ll
Section 3.2 contains the procedures to install DATATRIEVE-ll on your system.
Section 3.3 lists the DATATRIEVE-ll files that reside in the target DIe's.

3.1 System Requirements
The software and hardware listed in Section 3.1.1 and 3.1.2 respectively are
required to install DATATRIEVE-l1.

3.1.1 Software Requirements
RSX-IIM Version 3.1 Mapped System
RMS-IIK Version 1.5 (for RMS Indexed Record I/O)
RMS-IIK Software must be present on your computer prior to installing
DATATRIEVE-l1. IfRMS-IIK is not present, you must first install it before
installing DATATRIEVE-l1. Get the kit containing the RMSII-K software,

3-1

and install this software following the procedures presented in the RMS-llK
RSX-11M Installation Guide.

3.1.2 Hardware Requirements
The following system configuration is required for DATATRIEVE-II
installation.
CPU

PDP-II with EIS hardware.

MEMORY

64K bytes above the minim um operating system requirements.

TERMINAL

Any supported terminal (hard copy terminals preferred).

TAPE

One 9-track magtape drive.

or
DISK

RK05, RK06, RK07 or RLOI drive.

DISK SPACE

2300 free blocks must be available in the target account for
DATATRIEVE-I1.

3.2 Procedures for Installing DATATRIEVE-11 on RSX-11M V03
3.2.1 Summary of Installation Procedures
1. Log in under a privileged account ([I,x]).
2. Physically mount the distribution medium as described in Chapter 1.
3. Allocate (and mount, if disk) the distribution medium.
4. Copy the distribution medium into your account (then remove the distribution medium).
5. Execute the command file DTRIIM.CMD.
6. Log off the system.

3.2.2 Log in Under a Privileged Account
Log into your computer system under a privileged account in the form [I,x).

3.2.3 Allocate (and Mount, if Disk) the Distribution Medium
1. For magtape distribution uSe the command
ALL del}: (BTI)

3-2

RSX-IIM V03 Installation Procedures

2. For disk cartridge distribution use the commands
ALL Ij el) : -(ffITy

MOU del.!:DTRll ~

where dev: is the device specification of the drive containing the distribution
medium.

3.2.4 Copy the Distribution Medium
1. To copy the data on the magtape into the target account type the command
FU{ SY:/RS}{=del.!:[l tlJ*.*/DOS ~

2. To copy the data on the disk cartridge into the target account type the
command
PIP SY:/Nl.I=deu:[l tlJ*.* ~

At this time, data on the distribution medium is copied into the target
account. \Vhen the copying operation is complete, the prompt> appears on
your terminal
To logically dismount the magtape distribution medium, type the command
DEA del.!:

For the disk distribution, type the commands
DMO dei.!:
DEA del.!:

~
~

When the prompt appears on your terminal, remove the distribution medium
and store it in a safe place.
The installation dialog to this point will be similar to the following example
(magtape distribution):
>ALL MM1:
> FU'{ SY: IRS}-{=MM1: [1 t 1 J* t*/DOS
>DEA MM1:

>
3.2.5 Executing the Command File DTR11 M.CMD
Now type
@DTRllM

DTRIIM.CMD is the command file that installs DATATRIEVE-ll into your
system. As part of the command file, the DATATRIEVE-ll Acceptance Test
is executed. During the Acceptance Test, you are required to enter data.
Observe the test as it outputs and respond as the test requests input.

RSX-IIM V03 Installation Procedures

3-3

The following example is the log printed as a result of command file execution. Note that the Acceptance Test has been deleted from the example. The
complete Acceptance Test is in Appendix A.

>@.DTRI1M

>; copy TASK BUILD COMMAND FILES

)F~EM
• + • DTR
REM -- TASK NOT IN SYSTEM
)PIP LB:[1,24J/NV=QEIIM.TKB
)PIP
QEIIM.TKB,*/DE
)PIP LB:[1,24J/NV=QEI1M.ODL
)PIP
QEIIM.ODL,*/DE
)PIP LB:[1,24J/NV=DTRIIM.TKB
)PIP
DTRI1M.TKB,*/DE
)PIP LB:[l,24J/NV=DTRIIM.ODL
)PIP
DTRI1M.ODL,*/DE
>PIP LB:[1,24J/NV=RMSI1M.ODL
)PIP
RMSIIMtODL;*/DE
)PIP LB:[1,24J/NV=QCIIM.TKB
)PIP
QCIIM.TKB,*/DE
)PIP LB:[1,24J/NV=QCIIMtODL
)PIP
QCI1M.ODL,*/DE
>!
)! INSTALL DATATRIEVE OBJECT LIBRARY
>!
)MAC QD=QD1:LM
)LBR DTRLIB/IN=QD
>PIP LB:[l,lJ/NV=DTRLIB.OLB
)PIP
DTRLIB.OLB;*/DE
)PIP
QD.OBJ;*/DE

INSTALL DATATRIEVE TASKS

>TKB @QDIIM.TI\B
)RUN QDICT
CREATING QUERY DICTIONARY
CREATING MESSAGE FILE
POPULATING MESSAGE FILE
BYE
)TKB @LB:[1,24JDTR1:LM.TKB
)TKB @LB:[1,24JQEI1M.TKB
)TKB @LB:[1,24JQCI1M.TKB
)INS LB:[1,54JDTR
>!
)! RUN DATATRIEVE ACCEPTANCE TEST
>!
)DTR @DTR.TST

•
•

·•

The DATATRIEVE-ll Acceptance Test Procedure
is contained in J;A~ppendix A.

)PIP LB:[1,2J/NV=YACHT.DAT
)PIP YACHT.DAT;*/DE
)!
>!
)!

END OF DATATRIEVE INSTALLATION

)C! <EOF>

3-4

RSX-IIM V03 Installation Procedures

3.2.6 Log Off the System
Log-off-the system after tJje-DTR1TM-~-CM-D1i-re-ri.a~;- compIefed execution (you
observe the> prompt).

3.3 DATATRIEVE-11 Files
When DATATRIEVE-ll has been installed the following files reside in the
indicated VIC's. Note that the [SELF] designation represents your privileged
account.
VIC

FILE NAME

DESCRIPTION

[1,1]

DTRLIB.OLB

Datatrieve object library

[1,24]

DTRllM.ODL

Datatrieve overlay description file

[1,24]

DTR11M.TKB

Datatrieve task-build command file

[1,24]

QCllM.ODL

COMPRESS program overlay description file

[1,24]

QCllM.TKB

COMPRESS program task-build command file

[1,24]

QEllM.ODL

EXTEND program overlay description file

[1,24]

QEllM.TKB

EXTEND program task-built command file

[1,24]

RMSllM.ODL

RMS overlay description file

[1,2]

QUERY.DIC

Data dictionary

[1,2]

QUERY.MSG

Message file

[1,2]

YACHT.DAT

Aceptance test data file

[1,34]

DTR.MAP

Datatrieve map file

[1,34]

QCPRS.MAP

Dictionary COMPRESS program map file

[1,34]

QDEXT.MAP

Dictionary EXTEND program map file

[1,54]

DTR.TSK

Datatrieve task image

[1,54]

QCPRS.TSK

Dictionary COMPRESS program

[1,54]

QDEXT.TSK

Dictionary EXTEND program

[SELF]

DTR.TST

Acceptance test command file

[SELF]

MSGS.SEQ

Message file (distribution format)

[SELF]

QDllM.MAC

Dictionary file-name source module

[SELF]

QDllM.ODL

Dictionary build program overlay description file

[SELF]

QD11M.TKB

Dictionary build program task-build command file

[SELF]

QDICT.MAP

Dictionary build program map file

[SELF]

QDICT.TSK

Dictionary build program

[SELF]

YACHT.SEQ

Acceptance test data file (distribution format)

RSX-IIM V03 Installation Procedures

3-5

Chapter 4
RSTS/E V06C Installation Procedures

This chapter is a guide to the installation ofDATATRIEVE-ll on the RSTS/E
V06C Operating System.
The information in the chapter is organized in the following manner:

Section 4.1 presents both the software and hardware requirements needed to
install DATATRIEVE-l1.
Section 4.2 contains the procedures to install DATATRIEVE-ll on your system.
Section 4.3 lists the DATATRIEVE-ll files that reside in the target accounts.

4.1

System Requirements
The software and hardware listed in Sections 4.2.1 and 4.2.2 respectively are
required to install DATATRIEVE-l1.

4.1.1 Software Requirements
RSTS/E, Version V06C
RSX.RTS - The RSX run-time system
RT.RTS - The RT-ll run-time system
SYSLIB.OLB - The RSX system object library
RMSl1.RTS - The RMS-ll run-time system
PIP.SAV - Peripheral Interchange Program in account [1,2]
TKB.TSK - The Task Builder in account [1,2]
MAC.TSK - The MACRO-II assembler in account [1,2]
RMS-IIK - Version 1.5 (for RMS Indexed Record I/O)
RMS-IIK software must be present on your computer prior to installing
DATATRIEVE-l1. If RMS-IIK is not present, you must install it before
installing DATATRIEVE-l1. Get the kit containing the RMS-IIK software,
and install this software following the procedures presented in the RMS-11K
RSTS/E Installation Guide.

4-1

4.1.2 Hardware Requirements
The following system configuration is required for DATATRIEVE-ll
install a tion.
CPU

PDP-ll with EIS hardware.

MEMORY

64K bytes above the minim urn operation system requirements.

TERMINAL

Any supported terminal (hardcopy terminals are perferred).

TAPE

One 9-track magtape drive.

or
DISK

RK05, RK06, RK07 or RLOl drive.

DISK SPACE

2300 free blocks must be available in the target account for
DATATRIEVE-l1.

4.2 Procedures for Installing DATATRIEVE-11 on RSTS/E V06C
4.2.1

Summary of Installation Procedures

1. Log in under a privileged account [l,x).
2. Physically mount the distribution medium as described in chapter 1.
3. Logically assign the magtape or mount the disk distribution medium.
4. Copy the distribution medium into your account (then remove the
distribution) .
5. Execute the BUILD program.
6. Log off the system.

4.2.2 Log in Under a Privileged Account
Log into your computer system under a privileged account in the form [l,x].

4.2.3 Logically Assign the Magtape or Mount the Disk
Distribution Medium
1. For magtape distribution use the command
ASSIGN del.!:. DDS ~

2. For disk cartridge distribution use the command
MOUNT del.l:DTRll/RONLY ~

where dev: is the device specification of the drive containing the distribution
medium.

4-2

RSTS/E V06e Installation Procedures

4.2.4 Copy the Distribution Medium
-T6-c-opy tIie--aata-on-either--the- magi~ipe or dIsk dIstrIbutIon into the target
account type the commands
RUN $PIP.SAV

tBm

At this time, data on the distribution medium is copied into the target
account. When the copying operation is complete, the prompt Ready appears
on your terminal.
To logically dismount the magtape distribution medium, type the command
DEASSIGN dev:

tBm

For the disk distribution, type the command
DISMOUNT deI.J:DTR11

(8@

\Vhen the Ready prompt appears on your ternlinal, relTIOVe the distribution
medium and store it in a safe place.
The installation dialog to this point will be similar to the following example
(magtape distribution).
Ready
ASSIGN MMO:.DOS
Ready
RUN $PI P. SAI.1

* "'z
DEASSIGN MMO:

4.2.5 Executing the BUILD Program
Now type
RUN $BUILD ffil

The computer initiates the following dialog; respond as shown.
BUILD VOGC-03 RSTS VOGC-03 SYSTEM 52547
S}'steITi Build <No>? (8@
Source Input Del.dce <SY:>? ffil
Library Output DelJice <SY>? (8@
Libran' Account <[1 t2J>? (8@
Control File is? DTRSTS.CTL (fi@
*** Copyins file SY:DTRSTS.CTL to SY:BUILD.TMP
BUILD Detachins.

RSTS/E VOOC Installation Procedures

4-3

The BUILD program then installs DATATRIEVE-ll. The dialog continues,
as shown by the following example. Note that you must enter the command
DTR @DTR.TST to run the Acceptance Test.
"'C

HELL.O

RSTS V06C-03 Basic+2/Cobol

Job 17

KB20

29-Au~-78

:J::I. /2~j()
Pa<:;~:; wo

r·d:

..Ic,h 12 "if:,

d(-~tacht?d

1..11"Ii.'lE'J'

ti-11S

account

Job number to attach to?
1 other user is lo~Sed in under this account

ASSIGN SV:SiSDSK.
F'Pdd'3
r~ss I GN

BY: SYSTEM

t1~:;~::IGI'~

~:;y: INPUT

HUN $UTILT'r
UTILTY
lJ()(SC"'c-~'~ F~~::;TS I)Of.:.C"·03 Basic+2/Cobol
:tADD RSX
?N~me or account now exists in ADD
:tfiDD RT 1:1.
:tecl... DTR:~'
?c.al"l ! t f:i rId f i 1 f:~ 0 r' account .... in eel..
:tEXIT

Install Datatrieve object library
RUN $NAC
MAC>QD::,~QDHSTS
MriC>~'C

P!.. !N $L.BR

LBF<>DTRL. IBI I N::::(~D
I...BF:'·'C

4-4

RSTSIE V06C Installation Procedures

12:42 PM

Read~-l

RUN $F'IF'.SAV
*LB:=DTRLIB.OLB
*DTRLIB.OLBlDE
*QD.OB..J/[![
*lB:RMS11.TSK<40)/RE

*'"'C
Read~

T ns t a] 1 D ;:~ t cl +. 1" .j ':.:.' ,".' t. .:~<::.k ~::.

RUN $TKB
TKB>(~(HIF~STS"

TKB

RUN QDleT
CREATING QUERY DICTIONARY
CREATING MESSAGE FILE
POP U L.f) TIN G F'I F S ~:; i~ GF i~:· :r L. [:
BYE
Read~

HUN $TKB
TKB>@DlRSTG.TKB

F~tJN

$ T!\B

T":f(>@QE~~STS +

TKB

RUN $TKH

TKB>@QCP:::>TS ,. TJ·'B

$LJTIL·IY
UTILTY 1J06C····0:3 F~STS ~)()6C--·03
tCCL DTR-=SYSTEM:~DTR.TSK
tEXIT

F~lJN

Clean

Bas:i.c+?/Cnj-·.lol

accounts

$PIP + SAl)
*SYSTEM:@(104)=DTR.1SK
*SYSTEM:@=QDEXT.TSK
*SYSTEM:@=QCPRS.TSK
*DTR.TSK/DE
*l1DEXT.TSK/DE
*QCPRS.TSK/DE
*SYSTEM:@QUERY.DIC<O)/RF
*SYSTEM:@QUERY.MSG(40~/RE

*'"'C

RSTS/E V06C Installation Procedures

4-5

Read~

HEI... L.O

RSTS V06C-03 Basic+2/Cobol
Job 17 [1,250J
Job 12 is detached under this account
Job number to attilch to? 12
Attschin~ to Jab 12
BU I LD

KB20

29-Au~-78

12:56 PM

COI1tP 1 €-~te

Read~

•
•
•
•
•

The DATATRIEVE-ll Acceptance Test Procedure
is contained in Appendix A.

Part of the BUILD program's processing is the DATATRIEVE-ll Acceptance
Test. You must enter data at the points shown in Appendix A to execute this
test properly.
At the completion of the Acceptance Test, look for the lines
END OF QUERY/REPORT WRITER TEST
EXIT
BYE
Ready

N ext, type the following under "Ready"
RUN $PIP.SAV (flIT)
*$<:aO)=YACHT.DAT (flIT)
*" Z (flIT)

Watch for the prompt Ready to appear. After "Ready" prints out, log off your
system. DATATRIEVE-ll has been installed.

4-6

RSTS/E V06e Installation Procedures

4.3 DATATRIEVE-11 Files

-Wile-n tnITA.TRIEVE-II-ilasoeen lfH,-talteQ~tne--lorr6wihg files reside in [fie
indicated accounts. Note that the [SELF] designation represents your privileged account.
ACCOUNT

FILE NAME

[1,1]

DTRLIB.OLB

Datatrieve object library

[1,2]

DTR.TSK

Datatrieve task image

[1,2]

QCPRS.TSK

Dictionary COMPRESS program

[1,2]

QDEXT.TSK

Dictionary EXTEND program

[1,2]

QUERY.DIC

Data dictionary

[1,2]

QUERY.MSG

Message file

[1,2]

YACHT.DAT

Acceptance test data file

[SELF]

DTR.MAP

Datatrieve map file

[SELF]

DTR.TST

Acceptance test command file

[SELF]

DTRSTS.ODL

Datatrieve overlay description file

[SELF]

DTRSTS.TKB

Datatrieve task-build command file

[SELF]

MSGS.SEQ

Message file (distributon format)

[SELF]

QCPRS.MAP

Dictionary COMPRESS program map file

[SELF]

QCRSTS.ODL

COMPRESS program overlay description file

[SELF]

QCRSTS.TKB

COMPRESS program task-build command file

[SELF]

QDEXT.MAP

Dictionary EXTEND program map file

[SELF]

QDICT.MAP

Dictionary build program map file

[SELF]

QDICT.TSK

Dictionary build program

[SELF]

QDRSTS.MAC

Dictionary file-name source module

[SELF]

QDRSTS.ODL

Dictionary build program overlay description file

[SELF]

QDRSTS.TKB

Dictionary build program task-build command file

[SELF]

QERSTS.ODL

EXTEND program overlay description file

[SELF]

QERSTS.TKB

EXTEND program task-build command file

[SELF]

RMSRST.ODL

RMS overlay description file

[SELF]

YACHT.SEQ

Acceptance test data file (distribution format)

DESCRIPTION

RSTSIE V06e Installation Procedures

4-7

Chapter 5
Compressing the Data Dictionary and Extending
DATATRIEVE-11

This chapter contains procedures you can use to:
1. Compress the data dictionary

2. Extend DATATRIEVE-ll task space
3. Extend (temporarily) the data dictionary

5.1 Compressing the Data Dictionary
You use the utility program, QCPRS, to periodically compress the data dictionary. As DATATRIEVE-ll is used, the data dictionary can accumulate
deleted record headers, deoptimized index structures and scattered and fragmented buckets; run QCPRS to reclaim the disk space wasted by this fragmentation.
To run QCPRS, invoke the program with the operating system command:
RUN QCPRS (8ITl

The utility program responds with the prompt:
CPR)

To compress the data dictionary, enter the command line in the form
new-file=old-file
to QCPRS, where old-file is the file name of the data dictionary, and new-file
is the name of the compressed copy of the dictionary.

5-1

The default file name for both new-file and old-file is SY:QUERY.DIC; the
VIC (or account) defaults to your directory.
On RSX-IIM and lAS systems, new-file and old-file can have the same
name; either system creates a new version of the name. Under RSTS/E,
however, the name must be different. The best strategy is to rename the
dictionary to a suitable name, such as QUERY.BAK, and use QCPRS to copy
it back to its original name, QUERY.DIC.
QCPRS then prompts for an initial allocation for the new version of the file
with the message:
ENTER ALLOCATION FOR AREA 0:

Enter a "best guess" for the new compressed version. If the value entered is too
low, the file will be extended automatically to hold the contents of the original
file.
To terminate QCPRS, type tTRl/Z) after the prompt CPR>.
The original file is not altered by QCPRS. It may be saved as a backup or
deleted.
An example of a typical QCPRS run follows:
RUN QCPRS ru
QUERY FILE COPY-COMPRESS UTILITY
CPR> QUERY.DIC = SY:[l ,2] QUERY.DIC ru
ENTER ALLOCATION FOR AREA 0: 250 ru
CPR> tTRLiz)

5.2 Extending DATATRIEVE-11 Task Space
DATATRIEVE-ll utilizes extend task space for RMS buffers, internal control blocks, and SORT work space. When this space is exhausted during
execution of a command, one of the following messages is printed:
CENTRAL STORAGE POOL EXHAUSTED
SORT WORK SPACE EXHAUSTED
COMPILER STORAGE POOL EXHAUSTED

There are two solutions to this problem. First, the amount of memory in use
can be reduced by taking one or more of the following steps:
L lIse the RELEASE command to release any unnecessary collections,
2. Use the FINISH command to finish any unnecessary domains.
3. If any DEFINE or DELETE commands have been issued, exit and reinvoke DATATRIEVE-l1.
Second, if the problem persists, the extend task size parameter in the
DATATRIEVE-ll task build command file can be modified to increase the

5-2

Compressing the Data Dictionary and Extending DATATRIEVE-ll

size of DATATRIEVE-l1. To do this, edit the file DTRIAS.TKB (lAS
SY$t~m),. or DTRIIM.TK.B (R8X-IIMSy-BtemJ~ orD_TRSTS_T_KB {RSTSjE
System). The syntax of the extend task size parameter is:
E}-(TTSK=xxxxx

where xxxxx is the number of decimal words that the task is to be extended.
Next, rebuild DATATRIEVE-ll with the command(s):
@DTR I AS. LNK

(8@

(for lAS System)

RUN $TKB (8@
TKB> @DTR11M.TKB lB@

(for RSX-llM System)

RUN $TKB lB@
TKB> @DTRSTS.TKB lB@

(for RSTS/E System)

Upon completion of the task build, DATATRIEVE-ll is ready for execution.

5.3 Extending the Data Dictionary
When DATATRIEVE-ll is installed in an RSX-ll~1 System, Rl\1S automatically extends the data dictionary file, should that file become full. However,
all RSTS/E systems (and some lAS Systems) will return error messages indicating that the data dictionary is full.
The reason for the message is that in RSTS/E Systems (and some lAS Systems) any attempt to extend a file by a user who is not the owner of the file is
rejected by RMS.
To extend the size of the data dictionary, you can use the QDEXT utility
program. Run the program by typing
RUN QDEHT

QDEXT then prompts for the name of the file (the data dictionary) and the
number of blocks it is to be extended.

5.4 Automatic Spooling Under RSX-11 M
Automatic line printer spooling under RSX-IIM is controlled by the global
symbol SPLI1M. If this symbol is set to 1 (as distributed), all PRINT and
REPORT command references to the device LP: are redirected to disk, and
queued to the spooler following request execution. If the symbol SPLIIM is
set to 0, line printer output is sent directly to the line printer.
The SPLIIM symbol is defined in the RSX-IIM DATATRIEVE Task Build
Command File DTRI1M.TKB. To send line printer output directly to the line
printer, edit the DTRI1M.TKB file (setting SPLIIM to 0), then run the Task
Builder:
RUN $TKB ffi)
TKB>@DTR11M.TKB ffi)

Compressing the Data Dictionary and Extending DATATRIEVE-ll

5-3

Appendix A
Acceptance Test Procedure

CLEAN UP FROM POSSIBLE PREVIOUS RUNS OF TEST

DELETE YACHTS-SEQUENTIAL;
·YACHTS-SEQUENTIAL· has not been defined in the dictionars
DELETE YI~CHTS;
-YACHTS· has not been defined in the dictionar~
DELETE Y(.)CHT;
·YACHT- has not been defined in the dictionary
DELETE PRICE-PER-POUND;
·PRICE-PER-PDUND- has not been defined in the dictionary
DELETE STORE-YACHT;
HSTORE-YACHT H has not been defined in the dictionar~
DELETE LOA-REPORT;
"LOA-REPORT- has not been defined in the dictionar~
I

DEFINE F;~ECOF:D

DEFINE RECORD YACHT USING
01

BOI~T ~

03 TYPE.
06 MANUFACTURER PIC X(10)
QUERY-NAME IS BUILDER.
06 MODEL PIC X(10).
03 SPECIFICATIONS

QUERY-NAME SPECS.
06 F.:IG PIC X(6) +
06 LENGTH-DVER-ALL PIC XXX
QUERY-NAME IS LOA.
06 DISPLACEMENT PIC 99999
QUERY-HEADER IS -WEIGHTEDIT-STRING IS ZZ,ZZ9
QUERY-NAME IS DISP.
06 BEAM PIC: (19 +
06 PRICE PIC 99999
EDIT-STRING IS $SS,$$$ .;
[Record YACHT is 41 b~tes IonS]

! DEFINE

nOt1{·IINS

DEFINE DOMAIN YACHTS-SEQUENTIAL USING YACHT ON YACHT. SEQ
DEFINE DOMAIN YACHTS USING YACHT ON YACHT.DAT;
!

DEFINE THE ACTUAL FILE FOR YACHTS

DEFINE FILE YACHTS KEY=BUILDER(DUP),KEY=MODEL(DUP,CHANGE),
ALLOCATION=30, SUPERCEDE

A-I

MAKE YACHTS ACCESSABLE BY OTHERS
DEFINEP YACHTS 2,PW,-SHHHH-,W
PASSWORD FOR WRITE
DEFINEP YACHTS 3,UIC,[*,*J,R
EVERYONE ELSE GETS READ
DEFINEP YACHT 2,UIC,[*,*],R
GIVE ACCESS TO RECORD DEFINITION, TOO
SHOWP YACHTS
1,UIC, [311,300], -RWMEC"
2, PW , - SHHHH -, - W
3,UIC, [*,*J~ -R B
H

DEFINE PROCEDURES
DEFINE PROCEDURE PRICE-P~R-POUND
PRICE*1.00/DISP (apRICER/-PER-/-POUND-) USING $$.99
END-PROCEDURE
DEFINE PROCEDURE STORE-YACHT
STORE YACHTS VERIFY USING
BEGIN
IF BEAM EQ 0 THEN ABORT -BAD BEAMIF DISP EQ 0 THEN ABORT YBAD DISPLACEMENTIF LOA NOT BETWEEN 20 AND 60 THEN ABORT -BAD LENGTHPRINT
DISPLAY -CONFIRM WITH Y IF OKIF *.CONFIRMATION NOT CONTAINING -Y" THEN ABORT uSTORE ABORTED·
END
END-PROCEDURE
! COPY DATA FROM SEQUENTIAL TO INDEXED FILE

READY YACHTS WRITE
READY YACHTS-SEQUENTIAL
SHOW READY
Read~ domains:
YACHTS-SEQUENTIAL: RMS SEQUENTIAL, PROTECTED READ
YACHTS: RMS INDEXED, PROTECTED WRITE
FOR YACHTS-SEQUENTIAL STORE YACHTS USING BOAT=BOAT
FINISH YACHTS-SEQUENTIAL;
TEST STORE
PLEASE SUPPLY THE FOLLOWING VALUES:
MANUFACTURER:
HINKLEY
MODEL:
BERMUDA 40
RIG:
YAWL
LENGTH-OVER-ALL:
140
DISPLACEMENT:
20000
BEAM:
12
PRICE:
82000
: STORE-YACHT
Enter MANUFACTURER: HINKLEY
Enter MODEL: BERMUDA 40
Enter RIG: YAWL
Enter LENGTH-QVER-ALL: 140
Enter tIISPLACEMENT: 20000
Enter BEAM: 12
Enter PRICE: 82000
ABORT: BAD LENGTH
Execution terminated bw -ABORT- statement
!

A-2

Acceptance Test Procedure

PLEASE SUPPLY THE FOLLOW VALUES:
ffANUFACTtJRER:
MODEL:
RIG:
LENGTH-OVER-ALL:
DISPLACEMENT:
BEAM:
PRICE!
CONFIRMATION

HINKLEY

BERMUDA 40
YAWL
40
20,000
12
$82,000
N

: STOPE-·YtiCHT
Enter MANUFACTURER:HINKLEY
Enter MODEL:BERMUDA 40
Entc-r 1~:IG: Y(.~WL
Enter LENGTH-OVER-ALL:40
Enter DISPLACEMENT:20,000
Enter BEAM:12
Enter PRICE:$82,OOO

MANUFACTUf::EI:;:

MODEL

RIG

LENGTH
OVER
ALL
WEIGHT BEAM

PRICE

HINKLEY
BERMUDA 40 YAWL
40
DISPLAY: CONFIRM WITH Y IF OK
Enter CONFIRMATION:N
ABORT: STORE ABORTED
Execution terminated by -ABORT- statement
!

CHANGE READY MODE FOR READ ACCESS

F~EADY

YACHTS

FIND YACHTS WITH PRICE NE 0
[52 records found]
SORT BY LOA,DESC DISPLACEMENT
SHOW ALL
Domains:
YACHTS-SEQUENTIAL
YACHTS
Records!
YACHT
Procedures!
PrO; I CE --PER-POUND
STORE-YACHT
Collections!
CURRENT
Ready domains:
YACHTS: RMS INDEXED, PROTECTED READ
SHOW CURRENT
Collection CURRENT
Domain! YACHTS
Number of records! 52
No selected record
Sort order! LENGTH-OVER-ALL,DISPLACEMENT
PRINT ALL

Acceptance Test Procedure

A-3

I... ENGTH

MANUFACTURER

MODEL.

RIG

OVEf::
ALL

WINDPOWER
CAPE DOF~Y
VENTLmE
VENTURE
EASTWARD
ISLANDER
IRWIN
CAPE DOf::Y
SALT
WESTERLY
GRAMPIAN
AMERICAN
TANZER
ALBIN
AMERICAN
HUNTER
ALBIN
CAPE DOF:Y
SABRE
GRAMPIAN
TANZER
ISLANDER
NORTHERN
IRWIN
HUNTER
GRAMPIAN
ISLANDER
ALBIN
CLIPPER
RYDER
BOMBAY
WI=\:IGHT
CHALLENGER
a/DAY
BAYFIELD
CLIPPER
GRAMPIAN
GRAMPIAN
CARIBBEAN

IMPULSE
TYPHOON
2l

SLOOP
SL.OOP
SLOOP
SLOOP
MIS
SL.OOP

"':':"1

CHR I S--CRAF

CHAL.LENGER
I. TRADER
ISLANDER
ALBERG
IRWIN
NORTHERN
LINDSEY
CHALLENGER
GULFSTAR
ISLANDER
COLUMBIA
OLYMPIC

A-4

22:~~

HO
BAHAMA

SLOOP
SLOOP
25
SLOOP
19
SLOOP
CENTAUR
SLOOP
26
26-·MS
MIS
SL.OOP
26
SLOOP
79
SLOOP
26
SLOOP
27
VEGA
SLOOP
28
SLOOP
28
SLOOP
28
SLOOP
SLOOP
28
28
SLOOP
SLOOP
29
30
SLOOP
30
SL.OOP
30
SLOOP
30
SLOOP
BALLAD
SLOOP
CM 30
SLOOP
SLOOP
s+ CROSS
CLIPPER
SLOOP
SEAWIND II SLOOP
32
SLOOP
SLOOP
32
30/32
SLOOP
CM 32
SLOOP
34
KETCH
2·_·34
SLOOP
35
SLOOP
CAF~IBBEAN
SLOOP
..3 w
SLOOP
37
KETCH
36
SLOOP
3l MK I I
KETCH
~57 MAI:<i, II KETCH
37
KETCH
39
MIS
KETCH
41
41
KETCH
FI;:EEPOF(f
KETCH
41
SLOOP
ADVENTURE I\ETCH
r)C"

.:..,J

1::.

Acceptance Test Procedure

WEIGHT

BEI~M

16
19
21
22
24

650
l,900
1,500
2,000

Ol
06
Ol

l,OOO

'"I A

4'1::!OO

v ...>

'")C·

400
4,000
2,600
6,700
5,,600
5,,500
4,350
4,200
4,000
6,500
5,0"70
9,000

12
07
0"7
08
OS
08
09

.:..,J

25
25
26
26
26
26
26
26
27
27
28
28
28
28
28
29
30
30
30
30
30
30
31
31
,3'">
.:..
32
32
3'")
.:..
32
33
34

~'j,

l,400

6,.900
6,800
5,994
7,250
10,000
9, ~50()
8,600
8,600

0"7
r...C\

:LO

08
09
08
09
09
10
10
10
09
10
10
09
10

l,276

08
00
11
00
:1.1
00
10
08
10
:1.0

:3,800
13,600
<7',400
14,,900
12,800
11.,,000
9,500
4,500
12,000
1l,800
:1.8,,000
18,()OO
14,800
1.8,600
13,450
20,000
20,000
14,000

~59

~35

35
~36

F'I:;~

I C[

$~5 y ~:)OO

$41129~3

$2, 82~5
$3, ~564
$15,900
$6, ~:)oo
$10,950
$S, 99~;
$6 !/590

$l!7.i,245
~i1111495

$18,895
$11 '1l~7.iO

$l"7,,900
$9,,89~:'j

$14,,999
$Uh600
$21,990
~~22, 000
$14,,47~;

$:1."7" ~::;OO
$1!:;,,908
$20,,9"75
$19,950
$21,~)00

$ll,ll!::;

$20,990
$27,,500
$9,,500
$32,500
$23, 9~j()
$:~4,

480

~~~3:1. ,,83!5

$29" ~)()O
$:32,,875
$12,950
$29,,675
$29,,675

~~3l,. 850

$::L""B50

:1.2
:1.2

$:~9" ~)O()

$39,,21.~:5

11
1 .:..'")

$3:1.,}JO
$36, 9~:;O

14, ~)oo

11
:1.1
:1.2

26,70()

1.3

$~.):I.,22B

22,.000

1.2

$4:1.,,350

41
41
42

22,000
2(),70()
24y250

13
:1.1
:1.3

$4B,.490
$80? !'500

36
37
37

$36,,9~;1

$~50" 000

$35" ~;()O
$54, ("1l0

SELECT FIRST
PRINT

MANUFACTURER

MODEL

RIG

LENGTH
OVER
ALL
WEIGHT BEAM

WINDPOWER

IMPULSE

SLOOP

650

PRICE
$3,500

SELECT
PFHNT BOAT,:PRICE-PER-POUND

MANUFACTURER

MODEL

RIG

LENGTH
OVER
ALL
WEIGHT BEAM

CAPE DORY

TYPHOON

SLOOP

1,900

PRICE

PRICE
PER
POUND

$4,295 $2.26

DEFINE REPORT PROCEDURE

DEFINE PROCEDURE LOA-REPORT
REPORT ON *.FILE
SET REPORT-NAME=·JIM'S VERY OWN LISTINeu/-OFH/HINTERESTING SAILBOATS-/
- (BY LENGTH)SET LINES-PAGE=55, COLUMNS-PAGE=72
AT TOP OF LOA PRINT LOA(-LENGTH-)
PRINT TYPE, RIG, DISP, BEAM USING Z9 , PRICE
AT BOTTOM OF LOA PRINT SKIP, COL 32, -*** AVERAGE ***U,
AVERAGE DISP, AVERAGE BEAM, AVERAGE PRICE
AT BOTTOM OF REPORT PRINT SKIP, -REPORT AVERAGES·,
AVERAGE DISP, AVERAGE BEAM, AVERAGE PRICE
AT BOTTOM OF PAGE PRINT SKIP, COL 20,
··-ANOTHER SERVICE OF QUERY ENTERPRISES-··
REPORT END
END-PROCEDURE
!

INVOKE REPORT (SUGGEST OUTPUT ON TI:)

:LOA-REPORT
FILE: TI:

Enter

Acceptance Test Procedure

A-5

OWN LISTING
OF
INTERESTING SAILBOATS
(BY LENGTH)

JIM~S

LENGTH

VEF~Y

:3l····JUL····78
1

PI~GE

MANUFACTURER

MODEL

RIG

WEIGHT

BEAM

PRICE

WINDPOWER

IMPULSE

SLOOP

650

$3, ~500

***

650

r.,''''

$3,500

SLOOP

1,900

$4,295

*** AVERAGE ***

1,900

$4, 29~;

SLOOP

1 , ~;O()

$2,823

***

1,500

(),7

$211823

SLOOP

2vO()()

$3,564

2,000

$3,564

***

19
CAPE DORY
21
VENTURE

TYPHOON

***

'1'')

Al Ir- ..... A r"r-

I"'VI:: f\ HUt:.

,~VEf'<AGE

.:... A-

VENTURE

222

*** At...'ERAGE ***

24
EASTWARD
ISLANDER

MIS

7~()0()

SLOOP

4,200

$15,900
$6,500

600

$11,200

5,400
4,000
2,600

12
7

$10,950
$8,995
$6,590

4,000

$8,845

SLOOP
SLOOP

6,700

8
8

26-MS

MIS

SLOOP
SLOOP
SLOOP

~5, 500
4,350
4,200
411000

9
10
8

$15,245
$11,495
$18,895
$11 ,l~50
$ll,900
$9,895

511058

$14,196

6,~5()O

9
8

$14,999

5,070
5,lS5

$1.6,799

9,000

9
9

$21,990
$22,0()()
$14,475
$17,5()0

HO
BAHAMA

*** A'v'ERAGE ***

25
IRWIN
CAPE DORY
SALT

'1'::",-,J

25
:L 9

SLOOP
SLOOP
SLOOP

*** AVERAGE ***

26
WESTERLY
GRAMPIAN
AMERICAN
TANZER
ALBIN
AMERICAN

CENTAUF~

19
26

*** At...'ERAGE ***

'1""
~.~

HUNTER
ALBIN

VEGA

SLOOP
SLOOP

*** AVERAGE ***

28
CAPE DORY
SABRE
GRAMPIAN

T,~NZEI;:

SLOOP
SLOOP
SLOOP
SL.OOP

-ANOTHER SERVICE OF QUr:::I:;:Y

A-6

Acceptance Test Procedure

ENTEF~PI:;:

~:;,

~j.,600

'7,,400
6 .. 900
6,SOO
I SES·

10
1.0

$18,600

JIM'S VERY OWN LISTING

INTERESTING SAILBOATS
(BY LENGTH)
LENGTH

MODEL

MANUFACTUf~ER

ISLANDER

RIG

31····JUL····78

PAGE 2
WEIGHT

SLOOP

BEAM

PRICE

$15,,908

$20, 97~'5

$20,<';>75

~~19" 950
$21 , ~jO()

*** AVERr~GE ***

NORTHERN

SLOOP

*** Flt.,'ERAGE ***

IRWIN
HUNTER
GRAMPIAN
ISLANDER
ALBIN
CLIPPER

30
30

BALLAD
CM 30

SLOOP
SLOOP
SLOOP
SLOOP
SLOOP
SLOOP

1. 0 ,()OO
9!1 ~300
8,600
~:h 600
7.,276

$17'17"75

10
10

$20,990
$27,500

:.3 5/ BOO

$9, ~'iOO

*** AVERAGE ***

RYDER
BOMBAY

S. CROSS
CLIPPEf~

SLOOP
SLOOF'

*** ,~VERAGE ***

WRIGHT
CH,~LLENGER

O'DAY
BAYFIELD
CLIPPER

SEAWIND II
32
32
30/32

eM 32

SLOOP
SLOOP
SLOOP
SLOOP
SLOOP

$~32 'I ~::j()O

$23,950

$28,225

!~~34 ,480

14,,900
12,800

$31,83~)

11,,000

()

$29 " ~:)()()

9,500
4,,500

$32" 8/'~5

$12,9~jO

*** AVERAGE ***

GRAMPIAN
34
GF~AMPIAN

KETCH

CARIBBEAN
CHRIS-CRAF
CHALLENGER

12,000

2-34

SLOOP

CARIBBEAN
35

SLOOP
SLOOP
SLOOP

:t1,,800

:LO

18~,000

$:3"7" B~)()

1.8,000
1.4,800

$3"7 , 8~.'i0

1.2

~;39,215

*** AVERAGE ***

I. TRADER
ISLANDER

*** AVERAGE ***
*** AVERAGE ***

$28, :328

37
36

KETCH
SLOOP

:1.8,,600
13,450

*** AVER,~GE ***

:1.2

$391'500

$31,,730

-ANOTHER SERVICE OF QUERY ENTERPRISES·

Acceotance Test Procedure

A-7

JIM'S VERY OWN LISTING
OF
INTERESTING SAILBOATS
(BY LENGTH)
LENGTH

MANUFACTURER

31-JUL-78
PAGE 3

MODEL

RIG

WEIGHT

BEAM

PRICE

37 MK II
37 MARK II
37

KETCH
KETCH
KETCH

20,000
~!(), 000
14,000

12
11
11

$36,951
$36,950
$50,000

*** AVERAGE ***

18,000

$41,300

MIS

14,500

$35,900

*** AVERAGE ***

14,500

$35,900

41
41
FREEPORT
41

26,700
22,000
22,000
2(),700

13
12
13
11

$51,228
$41,350
$54,970
$48,490

*** AVERAGE ***

22,850

$49,009

ADVENTURE

24,250

$80,500

24,250

$80,500

10,169

$24,843

37
ALBEI~G

IRWIN
NORTHERN
39
LINDSEY

41
CHALLENGER
GULFSTAR
ISLANDER
COLUMBIA
42
OLYMPIC

KETCH
KETCH
KETCH
SLOOP

KETCH

*** AVERAGE ***
REPORT AVERAGES
!

-ANOTHER SERVICE OF QUERY ENTERPRISESINVOKE REPORT (SUGGEST OUTPUT ON LP:)

:LOA-REPoRT
Erlter FILE: LP:
!
!

I~ATTL.E

UPDATE

FIND YACHTS WITH BEAM=O
[5 records found]
PRINT Al.L

MANUFACTURER

MODEL

RIG

l.ENGTH
OVER
WEIGHT BEAM
ALL

METALMAST
O'DAY
RYDER
TA CHIAO
WRIGHT

GALAXY
32
S. CROSS
FANTASIA
SEAWIND II

SLOOP
SLOOP
SLOOP
SLOOP
SLOOP

32
32
31
35
32

9,500
11,000
13,600
23,200
14,900

00
00
00
00
00

PRICE
$29,,500
$32,500
$~34, 480

SELECT FIRST;PRINT
LENGTH

OVER
MANUFACTURER
METALMAST

MODEL

RIG

ALL

WEIGHT BEAM

GALAXY

SLOOP

9,500

READY YACHTS MODIFY
!

A-8

Acceptance Test Procedure

()O

PRICE

! RESPOND WITH 47 (OR SOMETHING)
rfOnTFY IfEAl'f

Enter BEAM: 47
PRINT TYPE,BEAM
MANUFACTURER
METALMAST

MODEL

BEAM

GALAXY

RESPOND WITH 48 (OR SOMETHING)
!

MODIFY ALL BEAM
Enter BEAM: 48
PRINT ALL BEAM
BEAM
48
48

48
48

48
!

! RESPOND EACH TIME WITH 0 (PLEASE)

FOR CURRENT PRINT TYPE THEN MODIFY BEAM
MANUFACTURER

MODEL

METALMAST
GALAXY
Enter BEAM: 0
O'DAY
32
Enter BEAM: 0
RYDER
S. CROSS
Enter BEAM: 0
TA CHIAO
FANTASIA
Enter BEAM: 0
WRIGHT
SEAWIND II
Enter BEAM: 0
READY YACHTS READ
PRINT ALL

MANUFACTURER
METALMAST
O'DAY
RYDER
TA CHIAO
WRIGHT

MODEL

RIG

GALAXY
SLOOP
SLOOP
32
S. CROSS
SLOOP
SLOOP
FANTASIA
SEAWIND II SLOOP

LENGTH
OVER
WEIGHT BEAM
ALL
32
32
31
35
32

9,500
11,000
13,600
23,200
14,900

00
00
00
00
00

PRICE
$29'1500

$32,500
$34,480

CHECK MULTIPLE COLLECTIONS AND STATISTICAL FUNCTIONS
FIND SMALLS IN YACHTS WITH LOA<24 AND PRICE NE 0
[4 records found]

Acceptance Test Procedure

A-9

FIND BIGGIES IN YACHTS WITH LOA)40 AND PRICE NE 0
[5 records found]
!

SHOW COLLECTIONS
Co 11 €~ct i orrs:

BIGGIES (also CURRENT)
SMALL.S
\

PRINT AVERAGE\ DISP
WEIGHT

PRINT MAX [lISP
WEIGHT
2b, ·700

PRINT AVERAGE PRICE OF BIGGIES,AVERAGE PRICE OF SMALLS
PRICE

PRICE

SORT SMAL.LS BY LOA,DISP
SORT BIGGIES BY LOA,DISP
SELECT FIRST SMALLS
SELECT LAST BIGGIES
PRINT SMALLS.BOAT,SKIP,BIGGIES.BOAT
LENGTH
OVEH
ALL
WEIGHT BEAM

MANUFACTURER

MODEL

RIG

WINDPOWER
OLYMPIC

IMPULSE
ADVENTURE

SLOOP

t,ETCH

650
24,250

07
1.3

PF~ICE

$3,500
$80,500

FINAL GALA TEST!

PRINT YACHTS WITH LOA EQ MAX LOA OF YACHTS

MANUFACTURER
OLYMPIC
PEARSON

MODEL

RIG

ADlJENTURE

KETCH
KETCH

4:1.9

LENGTH
OVER
ALL
WEIGHT BEAM

PRICE

24, 2~:)O

1 :~

$80, ~)()()

21,000

:1.3

42
4':)

END OF QUERY/REPORT WRITER TEST

A-IO

Acceptance Test Procedure

READER'S COMMENTS

DATATRIEVE-II (VI.I)
lAS, RSX-IIM, RSTS/E
Installation Guide
Ordex ~o_. AA-Hla9A~ Ie

NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the
company's discretion. If you require a written reply and are eligible to receive one under Software
Performance Report (SPR) service, submit your comments on an SPR form.

Did you fmd this manual understandable, usable, and well-organized? Please make suggestions for improvement.

Did you find errors in this manual? If so, specify the error and the page number.

Please indkate the type of userlreader that you most nearly represent.

o
o
o
o
o
o
Name

Assembly language programmer
Higher-level language programmer
Occasional programmer (experienced)
User with little programming experience
Student programmer
Other (please specify) _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ __

Date--------_____________________________

Or~nization--------------------------------------------------------------------------

Street ______________________________________________________________________________
City _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ __ State _______ Zip Code _________
or
Country

·------------------------------------------------------------FoId lIere------------------------------------------------------------

.---------------------------------------------- Do Not Tear - Fold Here and Staple -----------------------------------------------

FIRST CLASS
PERMIT NO. 33

MAYNARD, MASS.

BUSINESS REPLY MAIL
NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES

Postage will be paid by:

Software Documentation
146 Main Street ML 5.5/E39