dec :: pdp11 :: rsts :: V06 :: DEC-11-ORDAA-A-D DocDir Jul75

RSTS/E
Documentation Directory

DEC-II-ORDAA-A-D

Order additional copies as directed on the Software
Information page at the back of this document.

digital equipment corporation • maynard. massachusetts

First Printing July, 1975

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 under a license
and may only be used or copied in accordance to the terms of such
license.

Digital Equipment Corporation assumes no responsibility for the use
or reliability of its software on equipment that is not supplied by
Digital.

Copyright (cj 1975 by Digital Equipment Corporation

The HOW TO OBTAIN SOFTWARE INFORMATION pages, located at the back of
this document, explain the various services available to Digital soft-
ware users.

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

DECsystem-10

DEC

DECtape

PDP

DIBOL

DECUS

EDUSYSTEM

UNIBUS

FLIP CHIP

COMPUTER LABS

FOCAL

COMTEX

INDAC

DDT

LAB-8

DECCOMM

MASSBUS

OMNIBUS

OS/8

PHA

RSTS

RSX

TYPESET-8

TYPESET-11

LIMITED RIGHTS LEGEND

Contract No.

Contractor or Subcontractor: Digital Equipment Corporation

All the material contained herein is considered limited rights data
under such contract.

RSTS/E DOCUMENTATION DIRECTORY

RSTS/E software consists of distribution media and documentation.
The documentation describes the components and operation of the
RSTS/E software. This directory describes the RSTS/E documentation.

1.0 ORGANIZATION OF THE DOCUMENT SET

The RSTS/E document set is logically divided into 5 categories, as
follows:

system reference

system procedures

system management and maintenance

languages

optional software

Table 1 lists the manuals by category and indicates the intended
audience of each manual.

Table 1
RSTS/E Documentation

Set

Category

Document
Title

Audience

System
Manager

System
Programmer

General
User

System
Reference

RSTS/E Document
Directory

RSTS/E Programming
Manual

X

X
X

X

RSTS/E System

Generation

Manual

X

X

System
Procedures

RSTS/E System
Manager ' s Guide

X

X

RSTS-11 System
User's Guide

X

X

X

RSTS/E RUNOFF
User's Guide

X

DOS /BATCH Text
Editor (EDIT)
Programmer ' s
Manual

X

X

PDP-11 ROLLIN
Utility
Programmer ' s
Manual

X

X

System
Management
and
Maintenance

System

Generation

Manual

X

X

RSTS/E System

Installation

Notes

X

X

RSTS/E System

Reliability

Test

X

X

RSTS/E System
Manager ' s Guide

X

X

Table 1 (Cont.)
RSTS/E Documentation Set

Category

Document
Title

Audience

System
Manager

System
Programmer

General
User

Languages

BASIC-PLUS
Language

JXi.ci.i.i.iA€i -l.

X

X

PDP-11 COBOL
Language
Reference
Manual

X

X

PDP-11 COBOL
User's Guide

X

X

PDP-11 COBOL
Language
Reference
Card

X

X

Optional
Software

PDP-11 SORT
User's Guide

RSTS/E
Commercial
User ' s Guide

RSTS/E 2780
User's Guide

RSTS-11 Sort
User's Guide

X

X
X

X

2.0 DOCUMENT DESCRIPTION

The following paragraphs summarize the information contained in each
manual in the document set. The first four documents are listed in
the recommended reading order for the system manager. The remaining
documents can be read in any order that is suitable to one's interests,

RSTS/E System Generation Manual

RSTS/E System Installation Notes

RSTS/E System Reliability Test

RSTS/E System Manager's Guide

RSTS-11 System User's Guide

BASIC-PLUS Language Manual

RSTS/E Programming Manual

RSTS/E RUNOFF User's Guide

DOS/BATCH Edit

PDP-11 ROLLIN

PDP-11 COBOL Language Reference Manual

PDP-11 COBOL User's Guide

PDP-11 COBOL Reference Card

PDP-11 SORT User's Guide

RSTS/E Commercial User's Guide

RSTS/E 2780 User's Guide

RSTS-11 Sort User's Guide

2.1 RSTS/E System Generation Manual (DEC-11-ORGNA-A-D)

This manual describes the complete procedures to generate the V06A-02
RSTS/E system image, initialize system structures, and build the system
library. Also included are procedures to build optional RSTS/2780
and PDP-11 COBOL software. Because RSTS/E supports a variety of hard-
ware and offers many optional software features, the manual also contains
reference information useful for planning and maintaining the system.
Especially important are the system initialization options. They are
used both to optimize system structures and to maintain and restructure
the system.

2.2 RSTS/E System Installation Notes (DEC-11-0RINB-C-D)

This document contains system code and library code patches and hard-
ware and software installation guidelines related to the version of
RSTS/E. The information is required for generating RSTS/E.

2.3 RSTS/E System Reliability Test (DEC-11-0RSRB-B-D)

This document describes the procedures to build system test files and
run device exerciser programs. The document is designed to be used
with the RSTS/E System Generation Manual.

The system test procedures are followed after a new RSTS/E system is
generated or can be used later to isolate hardware or system software
malfunctions.

2.4 RSTS/E System Manager's Guide (DEC-11-0RSMD-A-D)

This guide is directed to the individual who administrates and controls
the local installation. It contains information on utilization of
hardware and software resources. The material is more detailed than
that presented in the RSTS/11 System User's Guide and is directed more
at the privileged user than at the non-privileged user. Also included
are the operational procedures necessary to daily functioning of the
system. Included are guidelines for controlling system start up,
shutdown, and job execution; procedures for creating accounts and pro-
ducing account statistics; procedures for queue management and spooling,
for system error detection and correction; and for system utility opera-
tions such as disk management, run time system control, system statis-
tics, terminal characteristics, and optimizing disk directories.

2.5 RSTS-11 System User's Guide (DEC-11-0RSUA-D-D)

This guide is directed at the time sharing user. Information on

system commands and system programs is provided. Most functions

described are non-privileged and the material is general in nature.
Also included are device operating procedures.

2.6 BASIC-PLUS Language Manual (DEC-11-ORBPB-A-D)

This manual introduces the beginning user to the more elementary
parts of the BASIC-PLUS language and explains for the experienced
user the more advanced features of BASIC-PLUS as implemented in
Version V6A of RSTS/E. Procedures are explained to help a user debug
a program and to write more advanced code. The more commonly used
system functions are described along with the three forms of input/
output available: formatted ASCII, virtual core, and Record I/O.
The manual is a complement of the RSTS/E Programming Manual.

2.7 RSTS/E Programming Manual (DEC-11-0RPMA-A-D)

This manual presents device dependent features and more complex system
function descriptions for the advanced programmer who uses RSTS/E
V06A. Both file structured and non-file structured operations are
described for disk, magnetic tape, paper tape, terminals, and line
printers. The system function calls to monitor are defined and
programming conventions explained.

2.8 RSTS/E RUNOFF User's Guide (DEC-11-URUNA-B-D)

This guide presents operating and preparation information for the
RSTS/E V06A text formatting system program RUNOFF. The manual
describes RUNOFF commands and their effect in the output text and shows
how to produce a formatted output file.

2.9 DOS/BATCH Text Editor (EDIT) Programmer's Manual (DEC-11-UEDAA-A-D]

This manual describes file creation, editing and manipulating pro-
cedures for the EDIT-11 program which is compatible with the RSTS/E
EDIT system program. The commands and operating procedures are defined
in this manual and summarized in the RSTS-11 System User's Guide for
EDIT.

2.10 PDP-11 ROLLIN Utility Programmer's Manual (DEC-11-OROAA-B-D)

This manual describes the commands and operating procedures for
making image mode copies of disks or for transferring images to
and from tape using the stand alone program ROLLIN.

2.11 PDP-11 COBOL Language Reference Manual 1 (DEC-11-LC0BA-B-D)

This manual describes the COBOL Language elements as implemented on
the PDP-11. It is based on the document American National Standard
COBOL, X3.23 - 1974, both for organization and content. Descriptions
of PDP-11 extensions to the standard language are shaded.

2.12 PDP-11 COBOL User's Guide 1 (DEC- 11-LCUGA-A-D)

This guide is a companion document to the PDP-11 COBOL Language
Reference Manual. It contains additional information on the compiler,
the run time system utility programs and a complete list of COBOL
error messages.

2.13 PDP-11 COBOL Reference Card 1 (DEC-11-LCRCA-A-D)

The card is a handy pocket reference containing the COBOL statement
formats, a list of the compiler-reserved words, constants, picture
symbols, and an ASCII code chart.

2.14 PDP-11 SORT Reference Manual 1 (DEC-11-USTMA-A-D)

This manual describes the features and operation of the PDP-11 SORT
program distributed with the COBOL compiler and object time system.

2.15 RSTS/E Commercial User's Guide 1 (DEC-11-0RCUA-A-D)

This guide describes generation and operation of the RSTS/E Indexed
Access Method (IAM) and the commercial QUE and LPSPL programs. Also
described is the decimal 4-word arithmetic package.

2.16 RSTS-11 Sort User's Guide (DEC-ORSGA-A-D)

This guide describes the generation and operation of the RSTS-11 Sort
programs distributed with the RSTS/E Commercial User's package. The
Sort programs are coded in BASIC-PLUS and stored in the system library
as compiled (BAC) files. Also included in the guide are file formats,
error messages, program interfaces, key extraction technique, and the
use of the key file dump utility.

Available under separate license.

2.17 RSTS/E 2780 User's Guide (DEC-11-ORJEA-A-D)

This guide describes the operation of the RJ2780 program for users
of RSTS/E systems with the RSTS/2780 software package. Included are
a summary of the build procedures, a list of hardware and software
options, and the steps required to send data to and receive data from
a remote computer system. Features related to the 2780 environment
are described in the document 2780 Remote Computer Systems Installation
Notes.

HOW TO OBTAIN SOFTWARE INFORMATION

SOFTWARE NEWSLETTERS, MAILING LIST

The Software Communications Group, located at corporate headquarters in
Maynard, publishes software newsletters for the various DIGITAL products,
Newsletters are published monthly, and keep the user informed about cus-
tomer software problems and solutions, new software products, documenta-
tion corrections, as well as programming notes and techniques.

There are two similar levels of service:

The Software Dispatch
The Digital Software News

The Software Dispatch is part of the Software Maintenance Service. This
service applies to the following software products:

PDP-9/15
RSX-11D
DOS /BATCH
RSTS/E
DECsystem-10

A Digital Software News for the PDP-11 and a Digital Software News for
the PDP-8/12 are available to any customer who has purchased PDP-11 or
PDP-8/12 software.

A collection of existing problems and solutions for a given software
system is published periodically. A customer receives this publication
with his initial software kit with the delivery of his system. This
collection would be either a Software Dispatch Review or Software Per-
formance Summary depending on the system ordered.

A mailing list of users who receive software newsletters is also main-
tained by Software Communications. Users must sign-up for the news-
letter they desire. This can be done by either completing the form sup-
plied with the Review or Summary or by writing to:

Software Communications

P.O. Box F

Maynard, Massachusetts 01754

SOFTWARE PROBLEMS

Questions or problems relating to DIGITAL'S software should be reported
as follows:

North and South American Submitters :

Upon completion of Software Performance Report (SPR) form remove last
copy and send remainder to:

Software Communications

P.O. Box F

Maynard, Massachusetts 01754

The acknowledgement copy will be returned along with a blank SPR form
upon receipt. The acknowledgement will contain a DIGITAL assigned SPR
number. The SPR number or the preprinted number should be referenced in
any future correspondence. Additional SPR forms may be obtained from
the above address.

All International Submitters :

Upon completion of the SPR form, reserve the last copy and send the re-
mainder to the SPR Center in the nearest DIGITAL off ioe. SPR forms are
also available from our SPR Centers.

PROGRAMS AND MANUALS

Software and manuals should be ordered by title and order number. In the
United States, send orders to the nearest distribution center.

Digital Equipment Corporation
Software Distribution Center
146 Main Street
Maynard, Massachusetts 01754

Digital Equipment Corporation
Software Distribution Center
1400 Terra Bella
Mountain View, California 94043

Outside of the United States, orders should be directed to the nearest
Digital Field Sales Office or representative.

USERS SOCIETY

DECUS, Digital Equipment Computers Users Society, maintains a user ex-
change center for user-written programs and technical application infor-
mation. The Library contains approximately 1,900 programs for all
DIGITAL computer lines. Executive routines, editors, debuggers, special
functions, games, maintenance and various other classes of programs are
available.

DECUS Program Library Catalogs are routinely updated and contain lists
and abstracts of all programs according to computer line:

PDP-8, FOCAL-8, BASIC-8, PDP-12
PDP-7/9, 9, 15
PDP-11, RSTS-11
PDP-6/10, 10

Forms and information on acquiring and submitting programs to the DECUS
Library may be obtained from the DECUS office.

In addition to the catalogs, DECUS also publishes the following:

DECUSCOPE -The Society's technical newsletter, published bi-monthly,

aimed at facilitating the interchange of technical in-
formation among users of DIGITAL computers and at dis-
seminating news items concerning the Society. Circula-
tion reached 19,000 in May, 1974.

-Contains technical papers presented at DECUS Symposia
held twice a year in the United States, once a year
in Europe, Australia, and Canada.

-A report of the DECsystem-10 sessions held at the two
United States DECUS Symposia.

-A monthly mailed communique among DECsystem-10 users.

-Mailing of Local User Group (LUG) and Special Interest
Group (SIG) communique, aimed at providing closer
communication among users of a specific product or
application.

Further information on the DECUS Library, publications, and other DECUS
activities is available from the DECUS offices listed below:

PROCEEDINGS OF
THE DIGITAL
EQUIPMENT USERS
SOCIETY

MINUTES OF THE

DECsystem-10

SESSIONS

COPY-N-Mail

LUG/SIG

DECUS

Digital Equipment Corporation

146 Main Street

Maynard, Massachusetts 01754

DECUS EUROPE

Digital Equipment Corp.

(Europe)

P.O. Box 340

1211 Geneva 26

Switzerland

International

RSTS/E Documentation

Directory

DEC-11-ORDAA-A-D

READER'S COMMENTS

NOTE: This form is for document comments only. Problems
with software should be reported on a Software
Problem Report (SPR) form (see the HOW TO OBTAIN
SOFTWARE INFORMATION page) .

Did you find errors in this manual? If so, specify by page.

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

09

C

o

3 Is there sufficient documentation on associated system programs

° required for use of the software described in this manual? If not,

g what material is missing and where should it be placed?

Please indicate the type of user/reader that you most nearly represent.

f~~) Assembly language programmer

Q Higher-level language programmer

| | Occasional programmer (experienced)

| | User with little programming experience

I | Student programmer

f"~| Non-programmer interested in computer concepts and capabilities

Name - . Date ,

Organization

Street —

City State Zip Code.

or
Country

-I .. _1__— _ —-U^—l, U^tv.n

Fold Here

-- Do Not Tear - Fold Here and Staple

BUSINESS REPLY MAIL

NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES

FIRST CLASS

PERMIT NO. 33

MAYNARD, MASS.

Postage will be paid by:

mm

Software Communications

P. 0. Box F

Maynard, Massachusetts 01754

SDIBBID

DIGITAL EQUIPMENT CORPORATION
MAYNARD, MASSACHUSETTS 01754