Digital PDFs

AA-C813A-TC

October 1977

18 pages

Original

0.7MB

Document:	1160 Microprogramming Tools Release Notes Oct77
Order Number:	AA-C813A-TC
Revision:	0
Pages:	18
Original Filename:	AA-C813A-TC_1160_Microprogramming_Tools_Release_Notes_Oct77.pdf

OCR Text

PDP-II/60 MICROPROGRAMMING TOOLS
VI,O RELEASE NOTES
AA-C8I3A-TC

PDP-II/50 MICROPROGRAMMING TOOLS
VlIO RELEASE NOTES
AA-C8I3A-TC

October 1977

DIGITAL EQUIPMENT CORPORATION . MAYNARD, MASSACHUSETTS

First Printing, October 1977
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 be used or copied only in accordance with 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 C 1977 by Digital Equipment Corporation
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
DECUS
UNIBUS
COMPUTER LABS
COMTEX
DDT
DECCOMt-1

DECsystem-10
DECtape
DIBOL
EDUSYSTEM
FLIP CHIP
FOCAL
INDAC
LAB-8
DECsystem-20

MASSBUS
OMNIBUS
OS/8
PHA
RSTS
RSTS
TYPESET-8
TYPESET-10
TYPESET-11

CONTENTS
PAGE
1. 0

INSTALLATION

2.0

KNOWN PROBLEMS IN THE PDP-11/60 MICROPROGRAMMING TOOLS

3.0

SAMPLE TOOLSGEN

4.0

SAMPLE SMKGEN AND SMK TEST

5.0

SAMPLE TOOLSTSK

Page 5
1.0

INSTALLATION

The PDP-11/60 Microprogramming tools are released as collection of
files in the [7,102J UFO of the release disk which has the internal
volume identifier WCS116.
In addition to the task images of the
tools, this UFO contains the source and command files necessary for
copying, compiling, linking, and running the tools.
The entire
installation can be accomplished by running one of two indirect
command files.
(Note: the command files may be printed out in
alphabetical order within tool by running the TOOLSCOP indirect
command file and specifying the output device as "LP:".)
To install the PDP-11/60 Microprogramming Tools.
A.

Complete generation (approximately 70 minutes on a
11/60, if listings are not requesteQ):

dedicated

Execute TOOLSGEN indirect command file to copy in entire
system, assemble, build, install and (optionally) test.
B.

Quick installation (approximately 6 minutes
11/60):

Execute TOOLSTSK indirect command file to
and other necessary files.

copy

dedicated

task

images

These indirect command files and the questions they ask are discussed
below.
The discussion assumes a reasonable familiarity with RSX-11M.
The entire installation section should be read before beginning the
installation.
Complete generation of the PDP-11/60 ~!.cr~Ero~!:.amming
TooLsIT'EN Indirectc-ommandflre-.----

Ioo~ ~sing

the

First, from a privileged UIC, invoke the indirect command file in
PDP-11/60 Microprogramming Tools release UFO, ego

the

>ALL OKO:
>MOU DKO: WCS116
>SET IUIC=[7,102J
>@DKO:[7,102JTOOLSGEN
The first question asked by this file will be:
>*ENTER CURRENT LOCATION OF WCS FILES[SJ:
The response should be the appropriate partial file specifications,
ego
DKO:[7,102J
The file then asks:

Page 6
>*ENTER PRIVILEGED UIC TO BUILD WCS TOOLS IN[S]:
A partial file specification for the UFD which will house the
PDP-11/60 Microprogramming Tools should then be supplied. This UFD
should be privileged and, to avoid name conflicts, should be empty
before
copying
the
tools
to
it.
(Note: the
PDP-11/60
Microprogramming Tools documentation assumes that the tools will be
used from this UIC unless they are permanently installed). The
response might be:
[7,103]
The command file then asks
>*ARE FORTRAN 4+ SUBROUTINES INSTALLED IN SYSLIB?[Y/NJ:
If the subroutines are installed in SYSLIB (only FORTRAN 4+ is used)
the response is "Y". If the response is uN", it is assumed that the
subroutines are in [1,1] F4POTS.
(Note: the generation procedure
assumes that floating point hardware is available. If floating point
is not available, the iridirect command files for task building
(MICBLD.CMD,
MICBLD.ODL,
MICBLDSL.CMD, MICBLDSL.ODL, MLDBLD.CMD,
MLDBLDSL.CMD, SMKBLD.CMD,
SMKBLBSL.CMD)
must
be
appropriately
modified). If the subroutines are in [1,1J F4POTS, the response would
be:
N

Next the command file asks:
>*DO YOU WANT LISTINGS?

[YIN]:

If FORTRAN AND MACRO-11 source listings are desired, reply:
Y

(Some task build maps will be created even if the reply is N.)
Next the file asks:
>*DO YOU WANT TO TEST THE INSTALLATION?

[YIN):

If the response is
Y

the generation procedure will finish with the assembly and execution
of a test microprogram. The test will execute successfully only if
run on a PDP~11/60 with an installed UCS option. (WARNING: The test
concludes by halting the machine and should not be made when other
users might be on the system). Since the test occurs at the end of
the generation procedure, it may be preferable to run it later by
invoking the indirect command files SMKGEN and SMK.
If the test

Page 7
successfully halts the machine, execution can be resumed by holding
down CNTRI. and pressing CONT at the KY 11-P Programmer t·~ C0nsole.
To run the test later set the UIC to the
generated and enter:

one

where

the

tools

were

>@SMKGEN

When asked
>*PROG[S]:

reply
SMKMIC
Also respond to
>*ARE FORTRAN 4+ SUBROUTINES INSTALLED IN SYSLIB?
as

[YIN]:

indicated for TOOLSGEN above.

Respond Y to

>L I 3T?

[Y IN ] :

if a listing of the test program is

desire~.

To
>BUILD?

[YIN):

respond
N

And to
>ASSEMBLE MICROPROGRAM?

[YIN]:

Respond
Y

When the test program
following invocation:

has been assembled it may be run by
(WARNlNG, this test halts the machine).

the

@SMK

To resume execution hold down CNTRL at the KY11-P Programmer's Console
and press CaNT. The output for the test ~hould be as indicated in the
examples.

Page 8
Quick installation of the WCS Tools ~sing 1.001~..ISK. '
First from a privileged UIC invoke the indirect command
PDP-11/60 Microprogramming Tools r,elease UFD, ego

file

the

>ALL DKO:
>MOU DKO:WCS116
>SET IUIC=[7,102]
>@DKO:[7,102]TOOLSTSK
The fir st· que s t ion as ked by t his f i 1 e will be:
>*ENTER CURRENT LOCATION OF WCS FILES [S] ,:
The response should be the appropriate partial file specification, ego
DKO: [7,102]
The file then asks:
>*ENTER PRIVILEGED UIC TO COpy WCS TOOLS [S]:
A partial file specifi~ation for the UFD which will house the
PDP-11/60 Microprogramming Tools should then be supplied. This UFD
should be privileged and, to avoid name conflicts, should be empty
before
copying
the
tools
to
it.
(Note: The
PDP-11/60
Microprogramming Tools documentation assumes that the tools will be
used from this UIC unless they are permanently installed). The
response might be:
[7,104]
The command file then asks:
>*ARE FORTRAN 4+ SUBROUTINES INSTALLED IN SYS1.I8? [YIN]:
For a discussion of this question see the same question in the above
section on TOOLSGEN.
If the subroutines are in [1,1] F4POTS, the
response would be:
N

Next the file asks:
>*INSTALL WCS COMMON (FOR MLD)?
the response should be:
Y

Finally the file asks:
>*TEST INSTALLATION?
If the response is

[YIN]:

Page 9

Y
the procedure will finish with the assembly and execution of a test
microprogram.
The test will execute successfully only if run on a
PDP-11/60 with an installed UCS option. WARNING: the test concludes
by halting the machine and should not be made when other users might
be on the system.
If the test successfully halts the machine, execution can be resumed
by holding down CNTROL and pressing CONT at the KY11-P Programmer's
Console.
Once the test (@SMK) has successfully run the installation of the WCS
tools is complete. It might, however, be advisable to disable the WCS
as part of the RSX-11M start up command file. The WCS can be disabled
by running the MSTOP program, ego
RUN [7,103] MSTOP
This will ensure that the WCS microcode is disabled during normal
running of the system, preventing possible hazards from inadvertent
invocations of the operation codes reserved for WCS. Since the normal
test procedures for microcode may leave the WCS enabled, this
automatic disabling is important. In addition, it may be convenient
to permanently install the microassembler (MIC). It would probably be
better not to install the loader (Ml.D) and debugger (MDT) which might
disrupt a shared system if run inadvertently. These programs can be
easily invoked in the WCS UFD by the indirect command @MLD and @MDT
respectively.
For more information on these indirect command files
3ee the PDP-11/60 Microprogramming Tools manual.

Page 10
2.0

KNOWN PROBLEMS IN THE PDP-11/60 MICROPROGRAMMING TOOLS

Several problems
microassembler.

are

known

exist

within

the

MIC,

11/60

They are:
Constraint Field Problems
A constraint field cannot be assigned on a range (X:Y) if the
assembler has selected an address within that range for its next
random allocation.
Syntax
An extra "I" in the micro-instruction
cause the instruction to be ignored.

field

namelfield

value

pair

Only 5 bit specifications are allowed in a constraint.
Fatal Problems
An .ENDB without label specified causes infinite
overflow.

loop

and

work-file

More than 123 characters in source line will kill the listing.
Undetected Errors
A .CASE beyond .ENDB is not necessarily recognized as an error.
Not all .CASE statements errors are flagged.
A line of over 120 non-comment characters
error message for the line.

may

cause

suppression

The microdebugger (MDT) has one known problem:
A micro break point
interpreted.

number

greater

than

The microloader (MLD) has no known problems.

will

not

properly

Page 11

3.0

SAMPLE TOOLSGEN

User responses are underlined.

>@DKO:[7,102]TOOLSGEN
>;fOOCSGEN:-CMO--\GENERATE WCS SOFTWARE TOOLS IN PRIVILEGED RSX-11M

>; MUST BE RUN FROM PRIVILEGED UIe

>T 11"1 E
13:1'7:3130-SEP-77
>* ENTER CURRENT LOCATION OF WCS fILES [S]: DKO:[7,102]
>* ENTER PRIVILEGED UIC TO BUILD WCS TOOLS INLsJ:--rr~T03]
>.* ARE FORTRAN 4+ SUBROUTINES INSTALLED IN SYSl.IB? TI /N1:N
>* DO YOU WANT LISTINGS? [Y/N]:N
>* DO YOU WANT TO TEST THE INSTALLATION? [Y/N]:Y
>3ET IUIC=[7,103]
!MAKE SURE TASKS BUILD IN 'TO' UIC

>
>; SMK.CMD
>;

SMOKE TEST FOR WCS TOOLS

>!vlLD WCS=MICPAK, SMKMIC
>RUN MSTART
>RUN SMKMAC
RUNNING SMOKE TEST
FIRST TEST RAN
SECOND TEST RAN
SMK SHOULD NOW END WITH ILLEGAL INSTRUCTION TRAP
TO CONTINUE PRESS "CNTRL/CONT" AT CONSOLE
(machine halts here)

SMK TEST COMPLETED
>RUN MSTOP

>
>

>TIME
14:26:1630-SEP-77
>@ <EOF>

P ag e 12

4.0

SAMPLE SMKGEN AND SMK TEST
- - - - - - - ---

User responses are underlined

> @SMKGEN
>; SMKGEN.CMD \ASSEMBLE,COMPILE,

AND/OR

BUILD SMK

>* PROG [S]: SMKMIC
>* ARE FORTRAN4+SUBROUTINES INSTl\LLED IN SYSLIB? [Y/N]:N
>* LIST? [Y/N]:Y
>* BUILD? [Y/N]TN
>* ASSEMBLE MICR5PROGRAM? [Y/N]:Y

>
>

>INS MIC/TASK= ... MIC
>MIC SMKMIC,SMKMIC/MX/BT=PREDEF,DISPCH,SMKMIC
>PIP SMKMIC.LST/SP

>
>

>@ <EOF>
>@SMK
>;SMK.CMD

SMOKE TEST FOR WCS TOOLS

>SET IMAIN=WCS:7600:200:DEV
SET -- PARTITION ALREADY EXISTS
>INS [1,1]WCS
>INS MLD/TASK= ... MLD
>MLD WCS=MICPAK,SMKMIC
>RUN IvlSTART
>RUN SMKMAC
RUNNING SMOKE TEST
FIRST TEST RAN
SECOND TEST RAN
SMK SHOULD NOW END WITH ILLEGAL INSTRUCTION TRAP
TO CONTINUE PRESS "CNTRL/CONT" AT CONSOLE
(machine halts here)

SMK TEST COMPLETED
>RUN MSTOP
>@ <EOF>

Page 13

5.0

SAMPLE TOOLSTSK

User responses are underlined.

>@DKO:[7,102]TOOLSTSK
>; TOOLSTSK.CMD \MOVE WCS SOFTWARE TOOLS TASKS TO PRIVELEGED RSX-11M

>; MUST BE RUN FROM PRIVILEGED UIC

>TIME
14:39:25 30-SEP-77
>* ENTER CURRENT LOCATION OF WCS FILES [S]: DKO:[7,102]
>* ENTER PRIVILEGED UIC TO COPY WCS TOOLS TO [S]: [7,104]
>* INSTALL WCS COMMON (FOR MLD)? [Y/N]:Y
>* TEST INSTALLATION? [Y/N]:Y
>PIP [7,104]/NV=DKO:[7,102]MIc.TSK
>PIP [7, 104]/NV=DKO: [7, 102]MLD. TSK
>PIP [7,104]/NV-DKO: [7,102]MSTART.TSK

>; WCSINS.CMD \INSTALL WCS "DRIVER" (MUST BE PRIVILEGED USER)

>PIP [1,1]WCS.STB=WCS.STB
>PIP [1,1]WCS.TSK=WCS.TSK
>SET INOMAIN=WCS
>SET IMAIN=WCS:7600:200:DEV
>INS [1,1]WCS
>REM MLD
>INS MLD/TASK= ... MLD
>REM MIC
>INS MIC/TASK= ... MIC
>MIC SMK,SMK=PREDEF,DISPCH,SMKMIC
>PIP SMK.LST/SP
>; SMK.CMD SMOKE TEST FOR WCS TOOLS

>MLD WCS-MICPAK,SMKMIC
>RUN MSTART
>RUN SMKMAC
RUNNING SMOKE TEST
FIRST TEST RAN
SECOND TEST RAN
SMK SHOULD NOW END WITH ILLEGAL INSTRUCTION TRAP
TO CONTINUE PRESS "CNTRL/CONT" AT CONSOLE
(machine halts here)

SMK TEST COMPLETED
>RUN MSTOP

>TIME
14:45:25 30-SEP-77

PDP-ll/60 Microprogramming
Tools Release Notes
AA-C8l3A-TC

READER'S COMMENTS

NOTE:

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

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.

-----_.._---Is there sufficient documentation on associated system programs
required for use of the software described in this manual? If not,
what material is missing and where should it be placed?

Please indicate the type of user/reader that you most nearly represent.
[] Assembly language programmer
[] Higher-level language programmer
[] Occasional programmer (experienced)
[] User with little programming experience
[]

Student programmer

[] Non-programmer interested in computer concepts and capabilities
Name
Organization ______

Date ___________________________
~--

__________________

___________________________________

Street
City _______________- - - Sta te ___----_____ Z ip Code _ _ _ _ _ _ __
or
Country

.-.----............ -------------------------------------------------- Fold J-Iere ------------------------------------------------------------

.----------------------------------------------- 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 HL5-5/E39
Maynard, Massachusetts 01754

digital equipment corporation

Printed in U.S.A.