Digital PDFs

AA-X910A-TH

September 1983

14 pages

Original

1.3MB

Document:	PRO/Tool Kit Documentation Directory
Order Number:	AA-X910A-TH
Revision:	0
Pages:	14
Original Filename:	http://bitsavers.org/pdf/dec/pdp11/pro3xx/POS/AA-X910A-TH_PRO_Tool_Kit_Documentation_Directory_198309.pdf

OCR Text

PRO/Tool Kit
Documentation Directory
Order Number: AA-X91 OA-TH

September 1983

This directory describes the software manual set that accompanies the
PRO/Tool Kit (Tool Kit running on the Professional). It suggests a reading
path for PRO/Tool Kit users and gives a brief synopsis of each manual.
Read this document before installing and using the PRO/Tool Kit software. If
you have the Professional Host Tool Kit (Tool Kit running on a VAX/VMS or
PDP-11/RSX host system), ignore this document and refer to the Professional Host Tool Kit Documentation Directory.

DEVELOPMENT SYSTEM: P/OS V1.5 and V1.7
SOFTWARE VERSION:

PRO/Tool Kit V1.0

First Printing, September 1983

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 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 specifications and drawings, herein, are the property of Digital Equipment
Corporation and shall not be reproduced or copied or used in whole or in part as
the basis for the manufacture or sale of items without written permission.

Copyright © 1982, 1983 by Digital Equipment Corporation
All Rights Reserved
The following are trademarks of Digital Equipment Corporation:
CTI BUS
DEC
DECmate
DECsystem-10
DECSYSTEM-20
DECUS
DECwriter
DIBOL

MASSBUS
PDP
P/OS
PRO/BASIC
PRO/Communications
Professional
PRO/FMS
PRO/RMS
PROSE
PROSE PLUS

Rainbow
RSTS
RSX
Tool Kit
UNIBUS
VAX
VMS
VT
Work Processor

CONTENTS
1.0
2.0
3.0

PROfTOOL KIT DOCUMENTATION SET ....................... 1
1.1 Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 1
ORGANIZATION OF THE PROfTOOL KIT
DOCUMENTATION SET ....................................... 2
PROfTOOL KIT DOCUMENTATION ............................ 5
3.1 PROfTool Kit Volume ..................................... 5
3.1.1
PROfTool Kit Documentation Directory ............. 5
3.1.2 PROfTool Kit Installation Guide
and Release Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 5
3.1.3 PROfTool Kit Command Language and Utilities
Manual ........................................... 5
3.1.4 RSX-11 M/M-PLUS RMS-11 Utilities Manual. . . . . . .. 5
3.1.5 EDT Quick Reference Guide. . . . . . . . . . . . . . . . . . . . . .. 5
3.2 Volume 1: Introduction........... . . . . . . . . . . . . . . . . . . . . . . . .. 5
3.2.1
Professional Host Tool Kit Documentation
Directory ......................................... 5
3.2.2 Professional Host Tool Kit Installation Guide and
Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. 6
3.2.3 Tool Kit User's Guide ............................. 6
3.2.4 Terminal Subsystem Manual. ...................... 6
3.2.5 CORE Graphics Library Manual. . . . . . . . . . . . . . . . . . .. 6
3.2.6 PRO/GIDIS Manual ............................... 6
3.2.7 Documentation Guidelines. . . . . . . . . . . . . . . . . . . . . . . .. 6
3.3 Volume 2: MACRO Program Development. . . . . . . . . . . . . . . .. 7
3.3.1
P/OS System Reference Manual ................... 7
3.3.2 IAS/RSX-11 ODT Reference Manual ............... 7
3.3.3 IAS/RSX-11 ODT Supplement ..................... 7
3.3.4 PDP-11 MACRO-11 Language Reference
Manual ........................................... 7
3.4 Volume 3: PRO/RMS-11 .................................. 7
3.4.1
PRO/RMS-11: An Introduction ..................... 7
3.4.2 PRO/RMS-11 Macro Programmer's Guide ......... 7
3.4.3 RSX-11 M/M-PLUS RMS-11 User's Guide .......... 7

iii

3.5

Volume 4: PRO/FMS-11 .................................. 8
3.5.1
FMS-11/RSX Release Notes. . . . . . . . . . . . . . . . . . . . . .. 8
3.5.2 PRO/FMS-11 Documentation Supplement .......... 8
3.5.3 FMS-11/RSX Software Reference Manual. . . . . . . . .. 8
3.6 Volume 5: Task Building .................................. 8
3.6.1
RSX-11 M/M-PLUS Task Builder Manual ........... 8

FIGURE
1

Suggested Reading Path ...................................... 4

TABLE
1

PROjTool Kit Documentation ................................... 2

PRO/TOOL KIT
DOCUMENTATION DIRECTORY
1.0

PROfTOOL KIT DOCUMENTATION seT
Note: This document applies only to the PRO/Tool Kit. If you have the
Professional Host Tool Kit (Tool Kit running on a VAX/VMS or PDP-11/RSX
host system). ignore this document and refer to the Professional Host Tool
Kit Documentation Directory.

The manuals that make up the documentation set for the PRO/Too! Kit
describe the program development tools you will use when you create PlOS
applications. Topics include form management software, record management
services, the target run-time system, and the software interfaces to P/OS.

Related Documentation

1.1

You may want to refer to certain manuals not included in the PRO/Tool Kit
documentation set while you develop P/OS applications:
D

Professional 300 Series end user documentation. Obtain and read
this documentation to
learn how to install and run applications such as the PRO/Tool
Kit on the Professional, and
understand the user's view of the system on which your applications will run.

Supported language documentation. In addition to MACRO-11, four
optional high-level languages, Tool Kit COBOL-81, Tool Kit DIBOL,
Tool Kit FORTRAN-n, and Tool Kit PASCAL, are supported by the
Professional Tool Kit. See your Tool Kit Software Product Description (SPD) for information on optional software products and
documentation.

PRO/TOOL KIT DOCUMENTATION DIRECTORY

2.0

ORGANIZATION OF THE PRO/TOOL KIT DOCUMENTATION SET

The PRO/Tool Kit documentation set (see Table 1) is a superset of the documentation provided to users of the companion Professional Host Tool Kit (Tool
Kit running on a host system).

Most of the manuals in Volumes 1 through 5 are common to both
Tool Kits.

The PRO/Tool Kit volume represents information that is otherwise
available to users of the Professional Host Tool Kit through their
host system documentation.

The EDT Quick Reference Guide is not in the PRO/Tool Kit volume because of
its smaller format.
Note: Table 1 shows the documentation set for the PROjTool Kit running
on P/OS Vi.? If you have the PROjTool Kit on P/OS Vi.S, your set may not
include new information provided for P/OS Vi.? The set for PRO/Tool Kit
on P/OS V1.S may have the first edition of the CORE Graphics Library Manual (AA-N619A-TK) and does not include the PRO/GIDIS Manual or the RSX11 M/M-PLUS RMS-11 User's Guide.

Figure 1 shows a suggested reading path, relating documentation to application development tasks.
Table 1
PROjTool Kit Documentation
Manual Title

Order Number

PROjTool Kit Volume
PROjTool Kit Documentation Directory

AA-X91 OA-TH

PROjTool Kit Installation Guide
and Release Notes

AA-X911 A-TH

PROjTool Kit Command Language
and Utilities Manual

AA-X912A-TH

RSX-11 MfM-PLUS RMS-11 Utilities Manual

AA-L6?OA-TC

EDT Quick Reference (not in binder)

AA-M4 77 A-TK

Volume 1: Introduction
*Professional Host Tool Kit Documentation Directory

AA-N61SC-TK

·Professional Host Tool Kit Installation Guide
and Release Notes

AA-N616C-TK

Tool Kit User's Guide

AA-N617C-TK

Terminal Subsystem Manual

AA-N623B-TK

• The Professional Host Tool Kit Documentation Directory and the Professional Host Tool Kit
Installation Guide and Release Notes are not used with the PRO/Tool Kit. They are used only with
the Professional Host Tool Kit.

PRO/TOOL KIT DOCUMENTATION DIRECTORY

Table 1 (Cont.)
PROjTool Kit Documentation
Manual Title

Order Number

**CORE Graphics Library Manual

AA-N619B-TK

"*PRO/GIDIS Manual

AA-Y660A-TK

Documentation Guidelines

AA-N621 A-TK

Volume 2: MACRO Program Development
P/OS System Reference Manual

AA-N620A-TK

IAS/RSX-11 OOT Reference Manual

AA-M50? A-TC

IAS/RSX-11 OOT Supplement

AA-P193B-TK

PDP-11 MACRO-11 Language Reference Manual

AA-V02? A-TC

Volume 3: PRO/RMS-11
PRO/RMS-11: An Introduction

AA-P098A-TK

PRO/RMS-11 Macro Programmer's Guide

AA-P099A-TK

·**RSX-11 M/M-PLUS RMS-11 User's Guide

AA-L669A-TC

Volume 4: PRO/FMS-11
FMS-11/RSX Release Notes

AA-H85? A-TC

PRO/FMS-11 Documentation Supplement

AA-P103B-TK

FMS-11/RSX Software Reference Manual

AA-H855A-TC

Volume 5: Task Building
RSX-11 M/M-PLUS Task Builder Manual

AA-L680B-TC

•• Previous edition of manual (AA-N619A-TK) provided with PROjTool Kit on P/OS Vi.5 .
... Manual provided with PRO/Tool Kit on P/OS Vi.?

PRO/TOOL KIT DOCUMENTATION DIRECTORY

Install Software
PRO/Tool Kit Installation Guide and Release Notes
Professional end user documentation
Supported language installation guide and release notes

1 PRO{Tool Kit Command Language and Utilities Manual

Read About PRO/Tool Kit Command Language and Utilities

Read About Target System, Tools, and Program Development Cycle
PROfTool Kit Documentation Directory
Tool Kit User's Guide
PROfTool Kit Command Language and Utilities Manual
Terminal Subsystem Manual
Professional end user documentation

Der :::::n:a:::t::idelines
Create the Application and Application User Interface
Supported language documentation
Tool Kit User's Guide
Write Graphics Routines (optional)
CORE Graphics Library Manual
PRO/GIDIS Manual
Write MACRO Subprograms (optional)
P/OS System Reference Manual
PDP-11 MACRO-11 Language Reference Manual
PRO/RMS-11: An Introduction
PRO/RMS-11 Macro Programmer's Guide
RSX-11 M/M-PLUS RMS-11 User's Guide
IAS/RSX-11 ODT Reference Manual and Supplement
Create forms with FMS-11 (optional)
FMS-11/RSX Release Notes
FMS-11/RSX Software Reference Manual
PRO/FMS-11 Documentation Supplement

Crr :a:~_::::-PLUS Task Builder Manual
Execute the Application
Tool Kit User's Guide
Figure 1
Suggested Reading Path

PRO/TOOL KIT DOCUMENTATION DIRECTORY

3.0

PRO/TOOl KIT DOCUMENTATION

The documentation for the PRO/Tool Kit includes the following manuals. Each
manual description includes:

o
o

Intended audience

Brief summary of contents

3.1

Document title

PRO/Tool Kit Volume

3.1.1

PRO/Tool Kit Documentation Dil'ectory-This manual is intended for all
PRO/Tool Kit users. It describes all documentation available with the PRO/Tool
Kit.

3.1.2 PRO/Tool Kit Installation Guide and Release Notes-The PRO/Tool
Kit Installation Guide and Release Notes is intended for whoever is responsible
for installing the PRO/Tool Kit software on the Professional. This manual is
also for the application developer using tile PRO/Tool Kit. The manual
describes the current release of PRO/Tool Kit software, its installation on the
host, and known problems in the distributed software and documentation.

3.1.3

PRO/Tool Kit Command language and Utilities Manual-The
PRO/Tool Kit Command Language and Utilities Manual is intended for the
application developer using the PROfTool Kit. The manual describes the Digital
Command Language (DCl) and program development utilities available on the
PRO/Tool Kit for all phases of application development.

3.1.4 RSX-11M/M-PlUS RMS-11 Utilities Manual-The RSX-11M/M-PLUS
RMS-11 Utilities Manual is intended for application developers who are using
high-level languages and do not require or do not have access to the full set of
RMS-11 capabilities. The RMS-11 Utiiities implemented on the PRO/Tool Kit
are a subset of those available to users of RMS-11 on an RSX-11 MfM-PlUS
host system. That subset is indicated in the PRO/Tool Kit Command language
and Utilities Manual.
3.1.5 EDT Quick Reference Guide-The EDT Quick Reference Guide is
intended for all PRO/Tool Kit users. It presents a summary of the commands
and functions of EDT (V3.0), Digital's standard interactive text editor. The EDT
Editor Manual, which is the complete tutorial, user guide, and reference manual
on EDT can be ordered separately (Order Number AA-M476A-TK, about 720
pages).

3.2

Volume 1: Introduction

3.2.1 Professional Host Tool Kit Documentation Directory-Ignore this document for the PRO/Tool Kit.

PRO/TOOL KIT DOCUMENTATION DIRECTORY

3.2.2 Professional Host Tool Kit Installation Guide and Release
Notes-Ignore this document for the PRO/Tool Kit.
3.2.3 Tool Kit User's Guide-The Tool Kit User's Guide is intended for the
application developer creating software for P/OS. The manual describes the
software interfaces to PIOS and the software environment in which applications will run. The program development tools-PRO/SORT, the Frame Development Tool, and the Application Diskette Builder, -are introduced and
described as they are used in the development cycle. The manual also directs
the reader to the appropriate documentation for further information on each
tool.
3.2.4 Terminal Subsystem Manual-The Terminal Subsystem Manual is
intended for developers who need information on the subset of the Professional that provides functions typically performed by a separate video display
terminal, such as the VT100. The manual documents text mode. Graphics
mode is discussed in the CORE Graphics Library Manual, PRO/GIDIS Manual,
and in the end user document, the PRO/BASIC Language Manual. The Terminal Subsystem Manual also describes any differences between VT102 and
VT125 emulation on the Professional and the corresponding functions on
VT102 and VT125 terminals.
3.2.5 CORE Graphics Library Manual-The CORE Graphics Library Manual
is intended for the application developer who needs to use the PIDS implementation of the ACM SIGGRAPH CORE Graphics System. The CORE Graphics
Library provides a higher level graphics programming interface than
PRO/GIDIS. Although not tutorial, the manual provides descriptions of fundamental graphics programming and sample programs.
3.2.6 PRO/GIDIS Manual-The PRO/G/DIS Manual is intended for the application developer who needs to use the device-independent graphics primitives
of PRO/GIDIS (General Image Display Instruction Set). PRO/GIDIS is intended
for applications where speed and compactness are more important than the
high-level implementation provided by the CORE Graphics Library. PRO/GIDIS
instructions are encoded as a stream of op-codes and argument data, and
passed from the application program to the PRO/GIDIS layer via the P/OS 010
mechanism. The manual is intended for developers with systems programming
and graphics software experience.
3.2.7 Documentation Guidelines-Use the Documentation Guidelines when
you document a P/OS application for the end user. The manual provides a set
of guidelines for developing integrated, easy-to-use, and effective documentation for an application. It suggests efficient ways to document, package, and
produce application documentation consistent with DIGITAL's own Professional end user documents.

PRO/TOOL KIT DOCUMENTATION DIRECTORY

3.3

Volume 2: MACRO Program Development

3.3.1 P/OS System Reference Manual-The P/OS System Reference Manual is intended for the experienced application developer. The manual
describes the P/OS Executive, the base operating system for the Professional.
Topics include executive directives, system functions, checkpointing, memory
allocation, the file system, and device drivers.
3.3.2 IAS/RSX-11 ODr Reference Manual-The IAS/RSX-11 OOT Reference
Manual is intended for all application developers creating task images under
the RSX-11 M, RSX-11 M-PLUS, or lAS operating systems. It describes how to
use the On-line Debugging Tool (ODT) to debug user task images. Use this
manual with the IAS/RSX-11 ODT Supplement.
3.3.3 IAS/RSX-11 ODr Supplement-The IAS/RSX-11 OOT Supplement is
intended for the application developer experienced with ODT. It describes the
differences between IAS/RSX-11 ODT and ODT on the Professional, and
should be used with the IAS/RSX-11 ODT documentation.
3.3.4 PDP-11 MACRO-11 Language Reference Manual-The POP-11
MACRO-11 Language Reference Manual is intended for application developers writing MACRO programs. The manual describes how to use the MACRO11 relocatable assembler to develop assembly language programs.
3.4

Volume 3: PRO/RMS-11

3.4.1 PRO/RMS-11: An Introduction-PRO/RMS-11: An Introduction is
intended for all users of RMS-11 , including MACRO-11 and high-level language
programmers. It introduces the concepts of RMS-11 record formats, file organizations, and record access modes. The manual does not provide reference
or usage information, but should be read before the other RMS-11 documents.
3.4.2 PRO/RMS-11 Macro Programmer's Guide-The PRO/RMS-11 Macro
Programmer's Guide is intended for application developers who are already
familiar with RMS-11 facilities. The manual provides reference material about
the macros and symbols that make up the interface between a MACRO-11
program and the RMS-11 operation routines.
3.4.3 RSX-11 M/M-PLUS RMS-11 User's Guide-The RSX-11 M/M-PLUS
RMS-11 User's Guide is intended for application developers who are already
familiar with RMS-11 facilities. The manual is a guide to using RMS-11 in file
and task design for application programs written in either MACRO-11 or highlevel language. Note that only MACRO-11 programmers can use the full set of
RMS-11 capabilities. Subsets of these capabilities are available to high-level
language programmers. High-level-language programmers should consult their
language documentation for details on RMS-11 support. Some of the RSX-11
RMS-11 features documented in this manual may not be available to developers creating applications for P/OS. Refer to your Installation Guide and
Release Notes for a list of any differences.

PRO/TOOL KIT DOCUMENTATION DIRECTORY

3.5

Volume 4: PRO/FMS-11

3.5.1 FMS-11/RSX Release Notes-FMS-11/RSX Re/ease Notes is intended
for the FMS-11 programmer or host system manager. This manual describes
the installation procedures for FMS-11/RSX software and the FMS-11/RSX
User Environment Test Package (UETP). Note that PRO/FMS-11 is installed
with the Tool Kit installation command file. Therefore, the Tool Kit user will not
need the installation instructions in this manual.

3.5.2 PRO/FMS-11 Documentation Sl.Ipplement-The PRO/FMS Documentation Supplement is intended for the application developer experienced with
FMS-11. It describes the differences between FMS/RSX and PRO/FMS, and
should be used with the Too! Kit FMS-11/RSX documentation.

3.5.3

FMS-11/RSX Software Reference Manual-The FMS-11/RSX
Software Reference Manual is intended for the application developer who uses
FMS-11 to create forms that gather and display data. The manual describes
how to develop forms using FMS-11 with different programming languages on
RSX-11 M and RSX-11 M-PLUS systems. Use this manual with the PRO/FMS11 Documentation Supplement.

3.6

Volume 5: Task Building

3.6.1 RSX-11 M/M-PLUS Task Builder Manual-The RSX-11 M/M-PLUS Task
Builder Manual is intended for the programmer writing software for an RSX
execution environment. This document describes the capabilities of the RSX11 M/M-PLUS task builder (TKB) upon which the Professional Appplication
Builder (PAB) is based. Use the RSX-11 M/M-PLUS Task Builder Manual to run
PAS, and see the Tool Kit User's Guide for differences between TKB and PAS.

PRO/Tool Kit
Documentation Directory
Order No. AA-X91 OA- TH

READER'S COMMENTS
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 find this manual understandable, usable, and well-organized?
Please make suggestions for improvement.

I
I
I
I
I
I
I
I
I
I
I

I
I
I
I
I
I
I
I
i
I
I

I
I
I
I
I

<Ii

(/)

£
Ol

c
0
"iii

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

:;
u

Q)
(/)

u:'"
Q)

I
I
I
I
I
I
I
I

I
I
I

I
I
I
I
I
I
I
I
1

I
I
I
I

I
I
I
I
I
I
I
I
I
I
I

Please indicate the type of reader that you most nearly represent.
Assembly language programmer
Higher-level language programmer
Occasional programmer (experienced)
User with little programming experience
Student programmer
Other (please specify) - - - - - - - - - - - - - - - - - - - - - - - - -

o
o
o
o
o
o

Name ______________________________________________ Date _____________
Organization ____________________________________________________________________
Street _________________________________________________________________________
City _____________________ State _ _ _ _ _ _ _ _ Zip Code - - - - - - or
Country

I
I
I
I

Do Not Tear - Fold Here and Tape __________________________________________ 1

,.,DDDD
~

I"I ~i;:~:; ~h' !
if

United States

BUSINESS REPLY MAIL
FIRST CLASS PERMIT NO. 33 MAYNARD MASS.
POSTAGE WILL BE PAID BY ADDRESSEE

Professional 300 Series Publications
DIGITAL EQUIPMENT CORPORATION
146 MAIN STREET
MAYNARD, MASSACHUSETTS 01754

- - - Do Not Tear - Fold H e r e - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

<.I

r:::