Xerox 900 Series/ 9300 MONARCH

XEROX Technical Information

,

Xerox 900 Series/ 9300 MONARCH

Technical Manual

90 06 160 April 1968

701 South Aviation Boulevard EI Segundo, California 90245 213679-4511

Xerox 900 Series/9300 MONARCH

Technicat Manual

90 06

160

April 1968

Price: $3.75

XEROX

REVISION

This publication, 90 06 16D, is a revision of the Xerox 900 Series/9300 MONARCH Techni- cal Manual, 90 06 16C. The only change made in this edition is the restoration of the description for the MONARCH Loader Routine (Cata log No. 042010-900 Series, 642025-9300) .

NOTICE

The specifications of the software system described in this publication are subject to change without notice. The availability or performance of some features may depend on a specific configuration of equipment such as additional tape units or larger memory. Customers should consult their Xerox sales representative for details.

II

CONTENTS

Catalog No.

900 Series 9300 Page

Introduction iv

MONARCH Operating System for 900 Series/9300 Computers ,042012 642028 1

MONARCH Control Routine (CONTROL) 042004 642027 3

Type Message Subroutines (TYPM, TYPOUT) 4

Standard Action Subroutine for System Routines (GSYSP) 5 MONARCH Message Analysis Tables (TABLES) 042005 642019 14 MONARCH Control Message Input Subroutine (QMSGRD) 042006 642020 17 MONARCH I/O Subroutine Loader (LDIOSR) 042007 642021 19

Card Read Subroutine (CARD) 042031 642030 22

Paper Tape/Typewriter I/O Subroutine (MTYIO) 042032 642031 23

Magnetic Tape I/O Subroutine (MAGTP) 042033 642032 24

Line Printer Subroutine (MPRNT) 042034 642033 26

MONARCH Control Supplementary Action Routines (LDI2) 042030 642034 27 Transfer to MOf'JARCH Control (TFMONRCH) 042008 642023 39

900 Series RAD MONARCH Generator (SYSGE N) 40

RAD MONARCH Loader ($QSYLDR) 04210D 44

900 Series MONARCH Resident RAD File Management

Routine (QFMR) 58

MONARCH Bootstrap Loader (BOOTSTRAP) 042009 642024 68

MONARCH Loader ($QSYLDR) 042010 642025 70

MONARCH Update Routine ($UPDATE) 042011 642026 84

Appendix A Control Message Action Subroutines 92

Appendix B Adding New Functions to the MONARCH

Monitor 96

TABLES

iv

INTRODUCTION

This manual describes the functional characteristics of the programs compris- ing the MONARCH Monitor. This description is intended to supplement the MONARCH Reference Manual (SDS Publication No. 900566) and provides in- formation needed for the mai ntenance and modifi cation of the MO NARC H Operating System.

All of these programs have been assembled using META-SYMBOL. The recom- mended means of maki ng changes to one of these programs is by furn ish i ng sym-

bo i c corrections relative to the current META-SYMBOL I isting of that program and then reassembling with the symbolic corrections and the current encoded program as input. A new encoded deck shou Id be requested each time a pro-- gram is reassembled in order to facilitate future changes.

See the description of the MONARCH Update Routine for information relating to creati ng and updati ng MO NARC H system tapes.

!t ;1

^I

-1* I

SCIENTIFIC DATA SYSTEMS

SDS PROGRAM LIBRARY PROGRAM DESCRIPTION

Catalog Nos. 042012 (900 Serie

642028 (9300)

IDENTIFICATION: MONARCH FOR 900 SERIES/9300 COMPUTERS COMPUTER

CONFIGURATION: Any SDS 900 Series/9300 Computer system with at least 8K words of core storage, console typewriter, and one or more magnetic tapes. For detai Is, see MONARCH REFERENCE MANUAL.

PURPOSE:

PROGRAMMING CONVENTIONS:

MEMORY

REQUIREMENTS:

SUBROUTINES USED:

To perform automatic execution of a sequence of independent or related pro- grams without requiring operator intervention.

MONARCH may be assembled using either SYMBOL or META-SYMBOL. It also uses no internal PROGRAMMED OPERATORS and it is reloca.table.

At I east 8K words of core storage.

MONARCH consists of the following routines:

Catalog No.

Routine Mnemonic 900 Series 9300

l. MONARCH Control Routine CONTROL 042004 642027 2. MONARCH Message Analysis TABLES 042005 642019

Tables

3. MONARCH Control Message QMSGRD 042006 642020 Input Subrouti ne

4. MO NARC H I/O Subrouti ne LDIOSR 042007 642021 Loader

5. Card Read Subroutine CARD 042031 642030 6. Paper T ape/T ypewri ter I/O MTYIO 042032 642031

Subroutine

7. Magneti c Tape I/O Subrouti ne MAGTP 042033 642032

SUBROUTINES USED:

(cont. )

2

Catalog No.

Routine Mnemonic 900 Series

10. Transfer to MONARCH TFMONRCH 042008 Control

1l.

MO NARC H Bootstrap Loader BOOTSTRAP 042009 12. MONARCH Loader QSYLDR or 042010

LOAD

13. MONARCH Update UPDATE 042011

14. FORTRAN Action Routine FORTACT 042014

15. FORTRAN Bias FORTBIAS 042015

16. ALGOL Action Routine ALGOLA 042017

*There is no 9300 MONARCH requirement for FORTACTi thus, 9300 FORTACT is used as a test program to test selective I/O handler loading only.

9300 642023

642024 642025

642026 642035*

642036

t ;1

^I

_1* ^I

SCIENTIPIC DATA SYSTEMS

SDS PROGRAM LIBRARY

PROGRAM DESCRIPTION

042004 (900 Serie!

Catalog Nos. 642027 (9300)

IDENTIFICATION: MONARCH CONTROL ROUTINE (CONTROL)

PURPOSE: Analyze the contents of MONARCH Control messages.

ACTION: The following functions are performed (in the order shown) related to the processing of MO NARC H Control messages:

CALLING SEQUENCE:

PROGRAMMING CONVENTIONS:

a. Read the message from the current control-message medium.

b. Analyze the syntax of the control message.

c. Convert any parameters in the control message to the internal representa- tion appropriate to the parameter and store the parameter values obtained in specified memory location(s}.

d. Transfer control to the Action Subroutine (processor) corresponding to the function code in the control message.

If errors are detected during this process, an appropriate error message is typed out, the message contai ni ng the error is ignored, and the routine at- tempts to read the next control message from typewriter 1 {on the W buffer for 900 Series Computers, or on Channel A for the 9300}.·

a. After loading or reloading the MONARCH system:

BRU RDMSG

b. To read the next control message when the MONARCH Monitor is still in memory (e.g., as would be the case after a control-message error is reported):

BRU RDMSGR

with a valid unit, channel, and I/O subroutine address in the Unit Assignment Table for control messages (QMSG).

Relocatable routine. No PROGRAMMED OPERATORS used. Contents of registers are not preserved.

SUBROUTINES USED:

COMMENTS:

QMSGRD, MTYIO, TYPM

The MONARCH Message Analysis Tables (TABLES - $CODES, $PARAMS, and $CHAR) are referred to by th is routine.

$CODES is the table of MONARCH symbolic functions.

$PARAMS is the table of MONARCH symbolic parameters.

$CHAR is the table of MONARCH BCD character classifications.

Listing for the Type Message Subroutine (TYPM, TYPOUT) and the Standard Action Subroutine for System Routines (GSYSP) are included in the MON- ARCH Control Routine listings.

IDENTIFICATION: TYPE MESSAGE SUBROUTINES (TYPM, TYPOUT)

PURPOSE: To type (BREAKPOINT 1 or SENSE 1 reset) or print (BREAKPOINT 1 or SENSE

1

set) control messages and MONARCH error messages, etc., on typewriter

1

or line printer

1,

respectively (on the

W

buffer for 900 Series Computers or on Channel A for 9300 Computers). The unit and channel designations are fixed in the Fi Ie Description Table (TMFDT) for typewri ter output and in the File Description Table (PRTFDT) for line printer output.

ACTION: Characters are typed, beginning with the leftmost character in the memory location specified by the Index Register (bits 10 through 23 for 900 Series Computers, or bits 9 through 23 for 9300 Computers) until:

CALLING SEQUENCE:

PROGRAMMING CONVENTIONS:

4

a. A period (SDS code 338) is typed or printed or b.

72

characters have been typed or printed.

The message text is assumed to be packed 4 characters per word. A carriage return (SDS code 52 8) is typed prior to typing the text and after the last character of text is typed. If the message is output on the line printer, the printer is upspaced one line prior to printing the message.

BRM TYPM or BRM TYPOUT

with the origin of the message text in bits 10 through 23 of the Index Register for 900 Series Computers, or in bits 9 through 23 for 9300 Computers.

Relocatable subroutine· assembled with MONARCH Control Routine. Does not use PROGRAMMED OPERATORS. The contents of the Index Regi ster are preserved but the contents of the A and B Registers are modified.

MEMORY

REQUIREMENTS: Approximately 60

S or 48

10 memory locations.

SUBROUTINES

USED: MTYIO

COMMENTS: This routine is used by the MONARCH Control Routine to type out or print control messages obtained from media other than typewriter 1 (on the W buffer for 900 Seri es Computers, or on Channe I A for 9300 Computers). It is used by the MONARCH Control Routine and MONARCH Action Subroutines (processors) to type or print error messages and to communicate other informa-

tion to the consol e operator. ...__--

IDENTIFICATION: STANDARD ACTION SUBROUTINE FOR SYSTEM ROUTINES (::;SYSP)

PURPOSE: To provide a standard subroutine for controlling the loading of standard system routines (e.g., assemblers and compilers) from a MONARCH system tape.

ACTION: The following actions are performed in the order indicated:

1. The MONARCH Loader's symbol table is "purged" so that the only entries in the symbol table are all the external labels defined within the Loader itself, which includes the following:

a.

Ali

external definitions for MONARCH Unit Assignment Table (UAT) entries and, for 900 Series Computers only, the external definitions for the Business Assignment Table (BAT).

b. An external definition for the Processor Error Switch (QPESW).

c. An external definition for the entry point to the Monitor Bootstrap Routine (QBOOT).

d. An external definition for the entry point to the MONARCH Loader (QSYLDR).

e. An external definition for the entry point to the octal dump routine (QDUMP).

2.

Selective loading of standard input/output subroutines. The contents of IORELC (bits 0 through 8) are examined to see if any standard I/O sub- routines are to be loaded to handle input/output functions for the system routine.

If

this is the case, LDIOSR is called to load the indicated I/O subroutines. Bits 9 through 23 of IORELC provide the load relocation

ACTION:

(cont. )

CALLING SEQUENCE:

PROGRAMMING CONVENTIONS:

MEMORY

REQUIREMENTS:

SUBROUTINES USED:

6

4.

system routine or to position the RAD system file at the first word of that system routine. The address of the search key is obtai ned from the loca- tion $OMTE in the MONARCH control routine.

Loading the standard system routine. Control is transferred to the MONARCH Loader with the load relocation bias (bits 9 through 23 of IORELC) in the A Register and Loader Option Flags in the B Register.

The Loader Option flags are obtained from location SRLDF in the MON- ARCH Control Routine. SRLDF is initially set to specify loading with no planned halts and no symbol table listing.

BRM GSYSP or BRU GSYSP with:

(IORELC)O_S

⁼

I/O Function Switches.

(IORELC)9_23

=

Load relocation bias for first subprogram of the system routine.

(OMTE)

(SRLDF)

=

Address of a-character program ID. This same ID is assumed to occur in characters 9 through 16 of the level

1 MONARCH ID record which precedes the system rou- tine on the system tape, or in words one and two of its RAD directory entry.

=

Loader Option Flags for MONARCH Loader.

Relocatable subroutine. No PROGRAMMED OPERATORS are used and no registers are preserved. Assembled with MONARCH Control Routine.

Approximately 50S or 40

10 memory locations.

LDIOSR SRLDSY QSRCH TYPM

QSYLDR (MONARCH Loader)

GLOSSARY OF ABBREVIATIONS AND SYMBOLS (MONARCH CONTROL ROUTINE)

(a)

a~(b) (a)~ (b) QMSG MTYIO CADDR LM RM LN

LA

LL LU LS IG IL RL RU

WDTYP ONR DNR SYM

LIT TY

MT PR

Contents of a

Store contents of b in location a Store contents of b indirectly in a UAT entry for control messages Address of typewriter I/O subroutine

Character address of next control message character Message left delimiter character

Message right de

I

i miter character Left del imiter of numeric word Left delimiter of symbolic word Left delimiter of literal word Universal left delimiter Leading plus or minus sign Character is to be ignored I II ega

I

c harac rer

Right delimiter for literal Universal right delimiter

Cell which contains word type code, current word Word type code for octa

I

number

Word type code for decimal number Word type code for symbol

Wor,d type code for literal' Typewriter

Magneti c Tape Photoreader

8

MONARCH CONTROL ROUTINE

Al~ ____________ ^~~

Type the control . . .

SlDMSG Does QMSG «*'tal" _IW ... , chan-

I, and tubtoutlM .w~?

No

QMSG - unit 1, c . . . 1 0, MTYlO

s

U I

•

S U

•

R

Inltlallz ...

Is ... '"-typewriter I?

Type a carriage return

GETCHR

G.t 1 character from IMIICIge

Input area

I. 1st char. In record an LM ( •. ,., ·A'?11-... - - . t II IMIIIIQe from typewriter 11

V.

~~::::::::;r~V~.~---'

S u a

R

Is ... from typewriter I?

No

~ Obtain and claulfy Mkt

word 01 current fWMIIICIIe

Is

,.t ...

^worda.~I?

MSGRST QMSG-unit 1, channel 0, MMO

Is 1st "*tage WOtd a legal function cod. mnemonic? ... - - - - -...

V ..

OMT£

-add,...

of ht word of func:tlon cod. entry PttMMAX - ... 1 IlIUm nuntbef of para ....

t."

PRMMIN-mlnllllUm number of paraMeten ORGPRM - arl,ln of tabl. of para .... ter _Iu.

IPf-orl,ln of MONARCH

·'roc...,·IUbr.

^outlin.

IORAWD-l/O subr ... Iectlons and load reloc:atlon bias

S IADFNC

U

• Type error meuage R

5 U

•

It

MONARCH CONTROL ROUTINE (cont.)

No

x-type ^coM for Cunw'lt word

,COMpUter?

NOTE I

_ _ _ _ _ Exit 10

-Proc:_-

Subtautlne (IRU*IPF)

9300

(PIMOIG)-Wlh".af .

•

I.,.~ecl.lon·

panIIM"

9OOS. ...

10

s

U I I

s

U I R

Get Internal chan.

01 ,.,....,

QQIIM Convert ftUIIIber to binary

MONARCH CONTROL ROUTINE (cont.)

s

U

•

I

5 U

•

R

SGETWRD

C1~---~"

5 U

•

I

~ Get IWCt ct.. (C) fl'Ofll cunwnt ...

x •

left dell",lt., cla.lflcatlon code forC

IC • character cla.mcation code for C

G.t Internal cha- of number

DEQIN Convert number to binary

S U

•

I

S U I R

GETINT Get internal chan • of word

~ Pack chars. of word

S GETINT

U Get internal I chars. of R word

5 !ill

U Pack chars. of I word I

MONARCH CONTROL ROUTINE {cont.}

Dl~---"

s

u

•

R

~ Get next char. (C) from current

~

X .1" .... 1 character cl_lflc:atlon code for C

~

^{Dl IG}

^{= ~=}

^{A3 IL}

Fill u"UMd char. posi- tiON I" wold ar. with IfMIC*

12

MONARCH CONTROL ROUTINE (cont.)

GETCHR

Extract wold add,... & char. ^poIltlon hom (CADDR)

Extract next INII. char. (C) &leaw rlght;Ultlf1ed In A Register

CADDIt- (CADOI)+ 1

rACK

Obtain chan. fl"Ol'll WOld area (Itored 1 char./WOId) &.tore thet114 char./

word In ~ry .torage (ACCUM "

ACCUM2)

IADMSG

T~.rror ... :

"ILLEGAL CONTROL MESSAGE, MESSAGE IGNOIED."

NOTE I

Del ... current

...

IAD"M

we error "...:

"CONTROL MESSAGE EllOl, UNDEFINED SYWOUC rARAMETER.

DECIIN

Convert from 1-to 8-dIQIt decimal Integer to binary, .Ingl. precl.ion

OCTiIN

Convert fl"Ol'll 1- to l-dlglt octal number to binary, ling I. pNClllon

8ADfNC

Twe·rror ... :

"CONTROL MESSAGE ERROR."

NSFPRM

T",. error ... :

"CONTlOL MESSAGE Elloa, INSUFFICIENT rAAAMETElS. "

MONARCH CONTROL ROUTINE

(cant.)

S U I R

Bootstrap for paper tape or magnetic tape?

Abeolut. or relocataba.?

-.olute Set up EOM at fli. delcrfp- t10n tabl. for paper tape

Puncho~raF ~ to paper tape .-clfled

TVPM TVPOUT Sav. IIWIICIr. origin

I, UEAICPOINT 1 (9300 SENSE 1)_? } -_ _ _ _ _ _ _ _ _ _ _ ~

S U

•

It

s

U I R

no

Type 1 carriage return

Store " . . . . origin in FII.

o.crlptlon Tabl. (TMFOT+1)

Typetextol ...

S MTYIO

U

• Type 1 carriage return

S U I R

Count number of wOtda In

"... up to period

Store word count In fli. delc:rlptlon tabl.

(PRTFOT)

I DEN TIFICATION:

PURPOSE:

ACTION:

i4

SCIENTIFIC DATA SYSTEMS

SDS PROGRAM LIBRARY PROGRAM DESCRIPTION

042005 (900 Series) Catalog Nos. 642019 (9300) MONARCH MESSAGE ANALYSIS TABLES (TABLES - $CODES,'!

$PARAMS, $CHAR)

To provide the following tables for use by the MONARCH Control Rout i nee

a. Table of MONARCH Control message function codes ($CODES).

Each entry in this table contains (1) the function code mnemonic for the control message, (2) the address of the processor (Action Subroutine) for that control message, (3) the minimum and maxi- mum number of parameters wh ich can be supp lied in the control message, (4) the address of the memory area in which parameter values are to be stored, if applicable.

For control message functions which require loading a system rou- tine from the system tape, the initial load relocation bias and parameters designati ng input/output functions are a Iso contai ned in this table.

b. Table of symbolic parameters ($PARAMS). Each entry inthe table containsa 1-t04-character symbol and a 24-bit binary value for that symbo I.

c. Character classification table ($CHAR). Each entry in this table corresponds to one of the 64 possible internal character codes.

The position of the tabie entry for a given character, with re- spect to the origin of the table, is determined by the internal character code for that character. Each table entry consists of one word conta in i ng:

1.

A left delimiter classification code for the character. This code determines the role that the character plays when it oc- curs as the leftmost character in a control message word. Oc- cupies bit positions 12 through 17.

2. An "internal" classification code for the character. This code determines the role that the character plays when it oc- curs to the right of the leftmost character in a control mes- sage word. Occupies bit positions 18 through 23.

None.

CALLING SEQUENCE:

PROGRAMMING CONVENTIONS:

MEMORY

REQUIREMENTS:

SUBROUTINES USED:

Not applicable.

Re locatabl e subrouti ne wi th no transfer address in End Record. No PRO- GRAMMED OPERATORS are used.

Variable, accordi ng to number of function code and symbol ic parameter en- tries. The current size is approximately 735 8 or 47710 locations.

None.

MONARCH OPERATING SYSTEM MONARCH MESSAGE ANALYSIS TABLES . FUNCTION CODE TABLE

The table is composed of entries of the following form:

1 st 4 characters of Function Code Mnemonic

1 Char 1 Char 1 Char 1 Char

0

(6) (6) (6) (6)

0

P(l) 2nd 4 characters of Function Code Mnemonic 1 Char

I

1 Char

I

1 Char 1 Char

(6)

(6) (6) (6)

0

P(7) P(6)

2

S SI Xl BO LO BI X3 SO X2 Relocation Bias for 1st I/O Subr

(if any)

(IOLERC)

(1) (1 ) (1) (1) (1) ( 1 ) (1) (1) (1) ( 15)

0

2 3 4 5 6 7 8 9

P(3) Max no. of Min no. of

Origin of Parameter Table Parameters Params.

3

6 (3)

15

0

56 89

P(2)

I I

4

Not Used Entry Point, First Processor F unc tion * (IPF)

o

0 0 0 0 0 000

( 15)

o 8 9

23

23

23

23

23 P(i) for i=1(1)7 refers to reference'parameter P(i) of the META-SYMBOL Procedure "FCII in the MONARCH Tables Routine.

2

3

4

5

P(7) and the UAT unit and channel designation and (optionally) a parameter in the control mes- sage calling the processor function, collectively determine which, if any, of the standard I/O subroutines will be loaded automatically by MONARCH. Each bit of P(7) corresponds to a UAT entry, as indicated. A 1 in a given bit position indicates a potential I/O function which may require that MONARCH provide a standard I/O subroutine.

*i.

e., address of Action Subroutine for this control message.

16

t ;1

^I

-\*;

SCIENTIFIC DATA .sYSTEMS

IDE NTIFICA TIO N:

PURPOSE:

ACTION:

CALLING SEQUENCE:

PROGRAMMING CONVENTIONS:

MEMORY

REQUIREMENTS:

SDS PROGRAM LIBRARY PROGRAM DESCRIPTION

042006 (900 Serie Catalog Nos. 642020 (9300) MONARCH CONTROL MESSAGE INPUT SUBROUTINE (QMSGRD) To obtain a record from the control message input medium (cards, mag- netic tape, paper tape or typewriter). The medium is specified by the MO NARCH Unit Assignment Table entry for control messages (QMSG).

If the record length exceeds 72 characters (18 words), only the fi rst 72 characters are stored in the control message input area ($MSG). If the record length is less than 73 characters, the entire record is stored in the control message input area. The control message input area is lo- cated in the MONARCH Control Routine.

a. If the medium is paper tape or typewriter, the record is read di- rectly into the control message area by executing the subroutine whose program ID is MTYIO.

b. If the medium is cards or magnetic tape, the record is read into a 40-word input area (CW) in QMSGRD. Cards are read using the subroutine whose program ID is CARD. The record is read in the binary mode. The binary card image thus obtained is converted from Hollerith code (12-bit code) to SDS internal code (6-bit code) and the first 72 characters of this converted record are moved to the control message input area (MSG). Note that the maximum magnetic tape record length that can be accommodated is 160 characters (40 \vords).

BRM QMSGRD

Relocatable subroutine with no transfer address in End Record. No regi- sters are preserved. No PROGRAMMED OPERATORS are used. Com- munication with input/output subroutines is via the MONARCH Unit Assignment Table.

Approximately 3108 or 20010 locations.

18 s

U B R

MONARCH CONTROL MESSAGE INPUT SUBROUTINE

LEGEND I

". ,. paper tope TV '"' typewriter CO ^:II cards MT :: magnetic tape

M!1!Q Read 1 record from paper tape or typewriter

5 U B R

5 U B R

s u

•

R

SQMSGIO

Is control ... '-1"", cards?

Vea Reset unit and c ... 1 c .... In COFDT (fil. tabl.)

~ Read 1 , . . . . from carch

~ Convert Hallerlth coded record to 505 int . . . ' cod.

Mo..,. canverted record to control ... Input area (MSG)

QMSG

x = "...medl"",

CARD

Read 1 card In bi . . ,y mod •

s

u

• •

s u

•

R

~ lead 1 record from paper tape, typewrite" or magnetic tape

Convert HaIl.,lth coded card I"... to teO by tabl. look-up

MAGTP

lead 1 record in binary mod.

I ;1 • ^-II;

SCIENTIFIC DATA SYSTEMS

SOS PROGRAM LIBRARY PROGRAM DESCRIPTION

042007 (900 Serie Catalog Nos. 642021 (9300) IDENTIFICATION: MONARCH I/O SUBROUTINE LOADER (LDIOSR)

PURPOSE: To load selected, standard, I/O subroutines from the MONARCH system tape in order to satisfy the I/O subroutine requirements of a MONARCH system routine. There are four standard I/O subroutines which can be loaded under control of LDIOSR. They are:

ACTION:

CALLING SEQUENCE:

'PROGRAMMING

CO

NVE NTIONS:

l~v1Etv10RY

PRINT MTAPE CDRP

PTYIO

Line Printer Output Subroutine Magnetic Tape I/O Subroutine Card Read/Punch Subroutine

Paper T ape/T ypewri ter I/O Subrouti ne

LDIOSR will determine which, if any, of these routines to load by first exam- ining the I/O function switches corresponding to MONARCH system routine

U,l."\I·H·"" T /(') .. 111... ... " .. : ... "" .. "",..11: .. "" ... "" ... .,. ,.. .. "" ... 1... ... ,.. .. ~ .. ~~,...,J 1=,.. .. "' ... ,..1.... , /r"\ ~ ... ,..,,:"' ....

YYIIV . . " ' .. , _ " " , ' - ' . V " , . I I , , , , ''''~'''"''''"''''"''' u.~ .v '-'~ "U"""~U. I VI C\,AI."II J./ _ I U I I I . " I I V I l

switch which is IIsetll, LDIOSR will examine the MONARCH Unit Assignment Table entry which corresponds to that switch. If the unit address code in that Unit Assignment Table entry is a code for an input/output device with which one of the four I/O subroutines can communicate, then LDIOSR causes that I/O subroutine to be loaded. Note that even though the same unit code

ap-

pears in more than one of the IIselected^li Unit Assignment Table entries, the corresponding I/O subroutine will be loaded only once. If the unit address code in the Unit Assignment Table entry is a RAD code, the address of the RAD File Management Routine (QFMR) is inserted at that UAT entry.

BRM LDIOSR with:

(IORELC)0_8

=

(IORELC)9_23 =

I/O function switches

initial load relocation bias (for first I/O subroutine) and any Unit .Assignment Table entries selected by the I/O function switches which are set.

Relocatable subroutine. No PROGRAMMED OPERATORS are used and no registers are preserved. Assembled with several Action Subroutines.

20

MONARCH I/O SUBROUTINE LOADER 22

LEGEND

I

UAT • Unit .... ignment Table UAC = Unit ~ Code

initialize eulnutlne para ... , . . - tract 1/0 function swltchea & Initial load relocation

bioi',..

^IOlElC

Al~---~

No

UAC .. code for mag. tape?

No

UAC .. code for card read/punch?

Insert origin of RAD file IRallap ... nt routine Into UAT entry carresponcflng to current I/O function

Set I/O functIon pointer to next I/O function swItch

Set UAT add,.. poInter to UAT entry corretponcftng to neIlt I/O functIon

laIt 1,10 functIon .wItch exGIRlned?

Extnlct unit add,.. code (UAC) from UAT entry c~tng to current I/O function

Prl nter 1,10 eut:nutlne loaded ~t?

No

Store current 1_ relocation bl _ _ printer tubroutl". art,in

No

Store current load relocation bl _ _ mag. tape subroutine origin

Na

Store current load relocation blaa _ origIn' 01 paper-tape/t)'pewrlter I/O IUblOUtlne

InMrt printer ... tl". origin Into UAT entry correepondlng to current I/O function

... orI,1n t:J ... ... - I". Into \JAT entry corretpOndlng

current I/O function

nMrt origin 01 card I/O IUbrou- lne Into UAT entry correlpOftdlng

current I/O function

nMrt origin 01 paper-tape/type- Iter I/O subroutine Into UAT try carr-.ondlnsl to current

/0 function

MONARCH I/O SUBROUTINE LOADER {cont.}

(X)--Optlon FIaga, MONARCH Lo.Ier (JOIELC)--c:urrent load reloc:atlon bien

(ar-acWre.

01 khar. MONARCH 10 fer I/O

S

•

U R

eulMautine to be 1 - "

SRLDSY

Searc:h for & load tpec:lfled

VO MIbroutln.

Set c:urrent load reloc:ation bias lum of (IORELC) & length of I/O subroutine IUlt 1 - "

LEGEND I

X • Index R .. I ....

• • • Regllter

IORELC • addr . . of load r.loc:ation bias used by SRLDSY

! ;1 • -\*;

SCIENTIFIC DATA SYSTEMS

SOS PROGRAM LIBRARY

PROGRAM DESCRIPTION 042031 (900 Series) Catalog Nos. 642030 (9300) IDENTIFICATION: CARD READ SUBROUTINE (CARD)

PURPOSE: To obtain a binary card image from a card reader (on the specified buffer for 900 Series Computers, or on the specified channel on 9300 Computers). The unit and channel assignments are taken from the MONARCH Unit Assignment Table entry for control messages (QMSG).

ACTION: One SO-column card is read from the card reader specified in binary mode.

CALLING SEQUENCE:

PROGRAMMING CONVENTIONS:

MEMORY

REQUIREMENTS:

SUBROUTINES USED:

COMMENTS:

22

BRM *QMSG PZE a

Where a is the address of the File Description Table (see description of SDS Card Read Subroutine, CDR, 900 Seri es Cata log No. 030004 or 9300 Cata-

log No. 633001).

See description of SDS Card Read Subroutine.

Approximately 270S or lS4 10 locations.

None.

This is the standard SDS Card Read Subroutine with the entry point label

changed from CDR to CARD to prevent conflict with the use of CDR in other

contexts within MONARCH.

t ;1 • -I' I

SCIENTIFIC DATA SYSTEMS

SDS PROGRAM LIBRARY PROGRAM DESCRIPTION

042032 {900 Seri4 Catalog Nos. 642031 (9300) IDENTIFICATION: PAPER-TAPE/TYPEWRITER INPUT/OUTPUT SUBROUTINE (MTYIO)

PURPOSE: To obtain control message records from a paper-tape reader or a typewriter and to type control messages and error messages in typewriter 1 (on the W buffer for 900 Series Computers, or on Channel A for 9300 Computers). The unit and channel assignments for input are obtained from the MONARCH Unit Assignment Table entry for control messages (QMSG).

ACTION:

CALLING SEQUENCES:

PROGRAMMING CONVENTIONS:

MEMORY

REQUIREMENTS:

SUBROUTINES USED:

COMMENTS:

a. Input. One record is read fromthe unit assigned into the record area specified by the File Description Table.

b. Output. One record is typed on typewriter 1 from the record area speci- fied by the File Description Table.

a. Input. BRM *QMSG PZE a

b. Output. BRM MTYIO

OP

a

Where a is the address of the Fi Ie Description Table and OP = 040

8 (see des- cription of SDS Paper Tape/fypewriter Subroutine, PTYIO, 900 Series Cata- log No. 020019, or 9300 Catalog No. 622001).

See description of SDS Paper Tape/Typewriter Subrouti nee

Approximately 530_{8 or} 344 10 locations.

None.

This is the standard SDS Paper Tape/Typewriter Subroutine with the entry point label changed from PTYIO to MTYIO to prevent conflict with the use of PTYIO in other contexts within MONARCH.

! ;1 • -1* ,

SCIENTIFIC DATA SYSTEMS

SOS PROGRAM LIBRARY

PROGRAM DESCRIPTION

042033 (900 Series) Catalog Nos. 642032 (9300) IDENTIFICATION: MAGNETIC TAPE INPUT/OUTPUT SUBROUTINE (MAGTP)

PURPOSE: To perform magnetic tape input and output functions requested by the MON- ARCH Control Routine and Action Subroutines (message processor). Unit and channel assignments are obtained from either the MONARCH Unit Assignment Table entry for control messages or from the File Description Table.

ACTION:

CALLING

SEQUENCES:

PROGRAMMING CONVENTIONS:

MEMORY

REQUIREMENTS:

SUBROUTINES USED:

a. Input. One record is read from the specified magnetic tape unit in the parity mode specified by the File Description Table.

b. Output. One record is written on the specified magnetic tape unit in the parity mode specified by the File Description Table.

c. Rewind. The specified magnetic tape unit is given a rewind command.

d. Space. The specified number of records is skipped on the specified mag- netic tape unit.

a. Input: BRM *QMSG e. g., to obtain a control

PZE a message record.

b. Output: BRM MAGTP e. g., see LABEL Action OP a Subroutine. (OP = 040S) c. Rewind: BRM MAGTP e. g., see REWIN D Action

EOM a Subrouti nee

d. Space: LDA N e.g., see SKIPREC Action BRM MAGTP Subrouti ne. (OP = 030S)

OP a

Where a is the address of the File Description Table, N is the number of records to be skipped, and N<O specifies backspace. (See description of SDS Magnetic Tape Input/Output Subroutine, MT APE, 900 Series Catalog

No. 040004 or 9300 Series Catalog No. 640001.)

See description of SDS Magnetic Tape Input/Output Subroutine.

Approximately 1000S or 512 10 locations.

None.

COMMENTS: This is the standard SDS Magnetic Tape Input/Output Subroutine with the entry point label changed from MTAPE to MAGTP to prevent conflict with the use of MTAPE in other contexts within MONARCH.

I ;1 • ^-II;

SCIENTIFIC DATA SYSTEMS

SDS PROGRAM LIBRARY

PROGRAM DESCRIPTION 042034 (900 Series) Catalog Nos. 642033 (9300) IDENTIFICATION: LINE PRINTER SUBROUTINE (MPRNT)

PURPOSE: To print control messages and error messages on line printer 1 (on the W buf- fer for 900 Series Computers, or on Channel A for 9300 Computers).

ACTION: One record is printed from the record area specified by File Description Table.

CALLING SEQUENCE:

PROGRAMMING CONVENTIONS:

MEMORY

REQUIREMENTS:

SUBROUTINES USED:

COMMENTS:

26

BRM HLT

MPRNT

a

where a is the address of the File Description Table (see description of SDS Line Printer Subroutine, PRINT, 900 Series Catalog No. 060005, or 9300 Catalog No. 662002).

See description of SDS Line Printer Subroutine.

Approximately 3208 or 208 10 locations.

None.

This is the standard SDS Line Printer Subroutine with the entry point label

changed from PRINT to MPRNT to prevent conflict with the use of PRINT in

other contexts within MONARCH.

I ;1

^I

^-II;

SCIENTIFIC DATA SYSTEMS

SOS PROGRAM LIBRARY PROGRAM DESCRIPTION

C t I N

042030 (900 Seril a a og

0

s. 642034

(930Q)

IDENTIFICATION: MONARCH CONTROL SUPPLEMENTARY ACTION ROUTINES (LDI2) PURPOSE: This program serves as an extension of the MONARCH Control Routine (900

Series Catalog No. 042004, or 9300 Catalog No. 642027) and includes a number of required system action routines.

ACTION: Control is transferred to the action routine corresponding to the function code specified in the control message. LDI2 contains the following action routines:

CALLING SEQUENCE:

PROGRAMMING

a. Processor for META-SYMBOL systems ($META) b. Processor for SYMBOL systems ($SYMBAR) c. Magnetic tape functions.

1. Backfile ($BKFILE) 2. Skipfile ($SKFILE) 3. Back record ($BKREC)

For 900 Computers only; these

4. Skip record ($SKREC) routines are assembled wi th the 5. Rewi nd ($REWI N D) 9300 MONARCH I/O Subrou-

tine Loader (LDIOSR), and ap- 6. Write end-of-file ($WEOF) pear as part of the listings for

7. Label ($LABEL) LDIOSR.

8. Posi tion ($ POSN)

9. Punch relocatable paper tape bootstrap loader ($LDI2X)

10. Write relocatable magnetic tape bootstrap loader ($BTLDX)

Not applicable.

SUBROUTINES USED:

COMMENTS:

28

GSYSP, MAGTP, RDMSG, TYPOUT, RDMSGR, TYPM, MTYIO, MSGRST, QSRCH.

For 900 Series Computers only, the program sets MSFNC and MSFNCl for communication with the META-SYMBOL control program. MSFNC (loca- tion 02738) contains bit settings corresponding to symbolic parameters speci- fied on the METASYM control card, which specifies the user's input/output requirements, and MSFNCl (location 02748) contains a 4-character (BCD) PROC name.

t F

MONARCH CONTROL SUPPLEMENTARY ACTION ROUTINES

Initialize to tty nat patallleter

CI.,Aand I.

Setpa . . . Index- 0

30

MONARCH CONTROL SUPPLEMENTARY ACTION ROUTINES

(cont.)

Inltlallz. 10, LO, and IMelltClnlc tabl. R . .

Merge SI, Xl, and 10 and/or LO bits ta 0367 and .... at Ia.ELC

Set 10 ....

Set LO flag

... - -.... -t Set IftMIMnlc tabl. Rag

MONARCH CONTROL SUPPLEMENTARY ACTION ROUTINES

(cont.)

Type "SEARCH FOR 'SYMlOl' OI'M)(XX'

FAILED~

32

MONARCH CONTROL SUPPLEMENTARY ACTION ROUTINES

{cont.}

Proc_ label r.quest

s

No U

B R

~ Type -ABNORMAL CONOmON, MT, Ott OF, 'LABEL' MSG ItEFUSEO-

had MId control ...age from typewrIter.

Read next controilMllCll.

for current aalgned control Input ....c:tlu",

MONARCH CONTROL SUPPLEMENTARY ACTION ROUTINES

{cont.}

S U

1 Set nI.delcrlptlon tabl.

a

S U

1 (IA21\"" 1\ 1\ ""1\ label^l)

a on 10/11

S U

U

I Read a D entry R

NEXTWD - LASTWD QCWD - NEXTWD

Set EOM at fil.

description tabl.

from parCIIMter (L)

MAGTP S

Writ. r.locatabl./ ^U

Yes Store QCWao at QFWacy

QFWX2' QCWX2

... _____ ... U s

Set EOM at fil.

delc:rlptlon tabl.

from (L)

Mr:l1Q Punch relocatabl.

I R

Type

IDUPLICATE LASEL I

34

MONARCH CONTROL SUPPLEME NTARY ACTION ROUTINES

(cont.)

s

u

•

R

~ Fetch 10 and store text at TID

s

~

~ Type 'ILLEGAL LEVEL R FOIl LAIEL'

s

^~

u

, "Itlon 0 at LASTWO R

u s

,

R

Set QCW,o 01 odctr-.

af....,.. .... label

~ Writ. requested 1"llnO

s ~

~ Write 'SYSENO' at R NEXTWO and cl . . 0

s .... QCWoat QFWXl and QCWX1

5

,

U R

!Y!!!!

Type 'ILLEGAL LOGICAL FILE FOR OF lABEL'

MONARCH CONTROL SUPPLEMENTARY ACTION ROUTINES (cont.)

Set logical fli ... at fll. delCrlptlon tabl.

u

, Rewind the logical fII.

l

WrIte ipeClal EOf mark (171JOOOOa) on spec I fled paper tape punch (used by FORTRAN complied program output on paper fa •

No

No

36

MONARCH CONTROL

SUPPLEME~I.bRY

ACTION ROUTINES

{cont.}

Convert EOM

_m

to UA T fOl'lNlt

S TYPM

U Type 'UNSUCassFU

... - ... , SEARCH, 'POSmON'

" " ' - - - ' R MSG NOT COMPlE ,

Save QSYSTP and Mt II indicator at QSYSTP

MONARCH CONTROL SUPPLEMENTARY ACTION ROUTINES

(cont.)

ltepIoceUATentry'. ~ No v.. Merge address of QTAP£

neI bits with •• Indlcator ... -~:.f l-.:..::.-___ ... with UAT entry'. unit and . . . of QOISK """"---..:..---' and channel

Save QSYSTP and .. t newly formed vatue at QSVSTP

38

MONARCH CONTROL SUPPLEMENTARY ACTION ROUTINES

(cont.)

-

Space""" of

~orto

EOF . . rk

no

u

s

•

R

eztrunberof

~or

To EOf mart,

t *1

^I

-1* ^I

SCIENTIPIC DATA SYSTEMS

IDENTIFICA TION:

PURPOSE:

ACTION:

CALLING SEQUENCE:

PROGRAMMING CONVENTIONS:

MEMORY

REQUIREMENTS:

SUBROUTINES USED:

COMMENTS:

SDS PROGRAM LIBRARY PROGRAM DESCRIPTION

042008 (900 Seri e~

Catalog Nos. 642023 (9300) TRANSFER TO MONARCH CONTROL (TFMONRCH)

a. To provide an external label definition ($QENDMN) of one plus the last memory location used by the complex of MONARCH Mon- itor subroutines, and such that the external definition will not be inadvertently deleted or rendered inaccurate by insertions, dele- tions, or changes of any of the subroutines comprising the MON- ARCH Monitor complex.

b. To provide a transfer instruction to the in itia I entry point ($RDMSG) of the MONARCH Control Routine.

When the MONARCH Loader loads the MONARCH Monitor complex, this routine is the last to be loaded and the transfer address in the End·

Record of TF MO NRCH causes the loader to transfer control to TFMONRCH. TFMONRCH, in turn, transfers control to the entry point of the MONARCH Control Routine ($RDMSG). This is the only subroutine in the MONARCH Monitor complex that can have an End Record with a transfer address.

Normal MONARCH Loader action when an End Record with a transfer address is encountered.

Relocatable subroutine. End Record has transfer address. No PRO- GRAMMED OPERATORS used and no registers are used.

Two (2) memory locations.

None.

This subroutine must be (physically) the last subroutine on the system tape which is in the scope of the level 1 MONARCH ID Record whose

* II • -1* ,

SCIENTIPIC DATA SYSTEMS

SDS PROGRAM LIBRARY PROGRAM DESCRIPTION

Page 1 of Catalog No.

IDENTIFICATION: 900 Series RAD MONARCH GENERATOR (SYSGEN) CONFIGURATION: Any SDS 900 Series computer with:

PROGRAMMED OPERATORS:

STORAGE:

TIMING:

USE:

8K or more core memory

magnetic tape unit on W buffer 9367 RAD

consol e typewri ter or line pri nter

None

Requires 767 locations, including constants and a 256-word input buffer N/A

SYSGEN is a MONARCH system routine, and is called by a 6SYSGEN message. SYSGE N uses resident I/O hand

I

ers and overlays MO NARCH, beginning with LDIOSR, in a manner similar to the UPDATE routine.

The generation of a RAD MONARCH system is accomplished in two steps:

1. The Tape MONARCH system is converted to a RAD MONARCH system by an UPDATE operation (unnecessary when beginning from a tape - situ- ated RAD MONARCH system).

2. The resultant NST (New System Tape) is input to a SYSGEN operation that copies the RAD MONARCH system onto the RAD.

The SYSGE N operati on is accompl ished by first bootstrapping the RAD MONARCH tape, and issuing the following control messages:

MS51GN 5 = MTO,

Xl

= DFuc, 50 =

X

6SYSGEN n

This sequence of messages results in the system being read from magnetic tape 0 on channel A, and being written on RAD unit "u" on channel

"C",

beginning with sector O. n is the number of RAD sectors to be allocated to RAD MON- ARCH and its files. A "directory" of level 1 (61) files is maintained from sector n downward.

USE:

(cont .)

METHOD:

The original level records are output on SO (LP or TV) Example:

.6ASSIGN S = MTO, Xl = DF1Y, SO = LP .6SYSGEN

4095.

The X2 and Xl fi

I

es are then begun foil owi ng the Sand D fil es.

Levell identifiers are discarded from the output (Xl) file during SYSGEN;

level 2 records are abbreviated to the first four words.

When the end of the Old System Tape (OST) is reached, the Sand D fi

I

es are closed, the OST is rewound, and control is returned to MONARCH.

SYSGEN uses the resident RAD package in performing all RAD I/O operations.

The design and operation of SYSGEN is similar to that of UPDATE, except that no editing capability is provided. That is, the complete Old System Tape is copied onto the RAD without modification.

SYSGEN consists of two separate programs:

SYSGE N

1:

a RAD bootstrap

SYSGEN 2: performs the SYSGEN

operation SYSGEN 2 performs the following steps:

1. Initializes the RAD EOM/SKS table in the File Management Routine to correspond to the unit and channel assignment specified in QSYST (UAT(X 1)).

2. Initializes the UAT entries utilized during SYSGEN.

3.

Initializes the file pointers maintained within the File Management Routine.

4.

Writes SYSGE N

1

(the RAD Bootstrap) onto RAD sectors

0

through 2, to permit subsequent bootstrap of the system from the RAD.

5.

Rewinds the Old System Tape and bypasses the tape bootstrap.

6.

Copies the OST records to the RAD, beginning with sector

3.

During the process, .61 records are discarded, but their labels are entered into a Directory file that is maintained at the end of the RAD, as allocated by

42

'vYhen the end of the

as

Tis reached, the Sand D fi

I

es are closed, the

as

^T

is rewound, and control is returned to the MO NARCH.

SYSGEN uses the resident File Management Routine in performing all RAD I/O operati ons.

900 SERIES RAD MONARCH GENERATOR (SYSGEN)

SYSGEN

initialize ItAO I/O tabI.

Initialize UAT entrI .. for . S, Xl, SO

Initialize ItAD fli •

.-oln'"

Output ItAD baohtrap to ItAD (Seeton ~2)

RewlndOST.

Iypau boatatrap.

Open 3

OST • Old System Tape S • ItAO Sys ... FII.

D • ItAD Directory FII.

SO = lilt Output

... - - -.... AWn¥late to first .. words

I *1 • -\1*

SCIENTIFIC DATA SYSTEMS

SDS PROGRAM LIBRARY PROGRAM DESCRIPTION

042100

Catalog No. (900 Series only)

IDENTIFICATION: RAD MONARCH LOADER ($QSYLDR)

PURPOSE: To load standard system routines from the MONARCH system and to load user programs from cards, magnetic tape, paper tape or RAD (see Section 3 of the MONARCH Reference Manual for a detailed description of the functional capabilities of this routine).

ACTION: Loads binary object programs from the medium specified until an End Record with a transfer address is encountered. At this point,

if

there are unsatisfied external label or PROGRAMMED OPERATOR references, the loader will search the MONARCH Library for subroutines which contain external defini- tions that satisfy one or more of the references. Library subroutines that sat- isfy these references are then loaded (see Section

3

of the MONARCH Ref- erence Manual for a detailed description of the operations performed by this routine).

CALLING SEQUENCE:

PROGRAMMING CONVENTIONS:

BRM QSYLDR

with the initial load relocation bias in the A Register and the loader option switches in the B Register and:

($QETBL)

=

address of last entry in loader's symbol table.

($QSYS!N) = unit, channel, and I/O subroutine addresses for bi.nary input medium. This information is in UAT format. t

($QSYSTP) = unit, channel, and I/O subroutine addresses for the magnetic tape containing the library subroutines. This information is in UAT format. t

The loader is assembled as a relocatable subroutine with a transfer address in the End Record. The loader is written in a subset of the SYMBOL language, and contains no external references or definitions and no internal PRO-

GRAMMED OPERATORS. However, in order to facilitate communication with the loader, it is assembled with its symbol table containing external label definition entries for those entry points and parameters which need to be accessibl e to other programs.

tExcept when the RAD unit is specified. In this case, the channel field contains the logical file number.

44

PROGRAMMING CONVE NTIONS:

(cont .)

MEMORY

REQUIREMENTS:

SUBROUTINES USED:

The loader is assembled (using either SYMBOL or META-SYMBOL) together with the following subroutines:

1. The search subroutine ($QSRCH). This subroutine is used by the loader and the MONARCH Monitor routines to locate files on magnetic tape or

RAD. Specifically, it is used by the loader to locate the MONARCH Li brary on a MO NARCH system.

2. The Monitor Bootstrap ($QBOOT). This subroutine is used by the MON- ARCH Control Routine and the various MONARCH system routines to in- itiate reloading of the MONARCH system tape (see Section 2 of the MONARCH Reference Manual).

3. The four input subroutines ($QCARD, $QTAPE, $QPAPER and $QDISK) used by the loader to read binary records. Bits 9 through 23 of QSYSIN must contain the address of one of these subroutines when control is re- linquished to the loader. Bits 9 through 23 of QSYSTP must contain the value of QTAPE when control is relinquished to the loader. These are the only input subroutines referenced by the loader.

4. The dump routine ($QDUMP). This routine may be referred to by MON- ARCH routines or by a user to dump memory in octal with zero suppression.

5. The RAD File Management Routine (see QFMR writeup on page 58).

The loader's symbol table will initially contain external definition entries for the entry points of each of the subroutines described in 1 through 5 above.

In addition, the symbol table will contain external definition entries for:

1.

All MONARCH Unit Assignment Table (UAT) and 900 Series Business Assignment Table (BAT) entries. (Refer to the MONARCH Reference Manual, Appendix A.)

2. The Processor Error Switch (QPESW).

3. The initial entry point to the loader (QSYLDR).

4. The entry point to the RAD Fi Ie Management Routine (QFMR).

Approximately 3430

8 or 1816

10 memory locations {includes the subroutines described in Calling Sequence above}.

QSRCH, QCARD, QTAPE, QPAPER, QDISK, QFMR, RDISC/WDISC.