Digital PDFs

DEC-S8-OBUGA-A-D

December 2000

106 pages

Original

10MB

Document:	dec-s8-obuga-a-d
Order Number:	DEC-S8-OBUGA-A-D
Revision:
Pages:	106
Original Filename:	https://svn.so-much-stuff.com/svn/trunk/pdp8/src/dec/dec-s8-obuga/dec-s8-obuga-a-d.pdf

OCR Text

0:5
,

Ed)

7%30'?

a). @.C—U <1_C
9as3

‘1’

£325"” m

%e%> @056.

(.0

00000000

MARK SENSE BATCH
USER’S GUIDE
DEC-SS-OBUGA-A-D

'rdrder aaditionaiéopies as airectédlon the Séftware
Information page at the back of this document.

digital equipment corporation magnard. mossochusetts
-

The
and

information in this document is subject to change without notice
should not be construed as a commitment by Digital Equipment

Corporation.
for any

Digital Equipment Corporation

errors

that may appear

assumes

responsibility

in this manual.

The software described in this document is furnished to the purchaser
under a license for use on a single computer system and can be copied
(with inclusion of DIGITAL's copyright notice) only for use in such
system, except as may otherwise be provided in writing by DIGITAL.

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

The

HOW

OBTAIN

(:) 1974, by Digital Equipment Corporation

SOFTWARE

this document, explains
software users.

page,
services

The postage prepaid READER'S COMMENTS
document requests the user's critical
preparing future documentation.

The

following

are

located

INFORMATION

the various

trademarks

available

the back of
DIGITAL

form on the last page of this
evaluation to assist us in
’

Digital Equipment Corporation:

'CDP

DIGITAL

INDAC

PS/8

COMPUTER LAB
COMSYST
COMTEX

DNC

EDGRIN

KAlO
LAB-8

RAD-8

EDUSYSTEM

LAB-8/e

RSTS

DDT

FLIP

LAB-K

RSX

DEC

FOCAL

OMNIBUS

DECCOMM

OS/8

DECTAPE

GLC-8IDAC

PDP

SABR

DIBOL

IDACS

PHA

TYPESET

CHIP

QUICKPOINT

RTM
.

RT-ll

UNIBUS

CONTENTS
Page

PREFACE

INTRODUCTION

CHAPTER

INTRODUCTON
HOW MSBATCH

USING

I-'

HARDWARE/SOFTWARE

CHAPTER

Hr ha anF'

ENVIRONMENT

SUPPLIED

MSBATCH

I-"

ELEMENTS OF BATCH MODE PROCESSING
PREPARING PROGRAM CARDS
PREPARING

ONU'IU'IU'IU'IWmDID-thNH

CHAPTER

DATA CARDS

INPUT/OUTPUT CONSIDERATIONS
BASIC Programs
FORTRAN IV Programs
FORTRAN II Programs
”

WNW

SUBMITTING

PROGRAM

Control Command
and $FORT Control Commands
Control Command
Control Command
Summary of Job Preparation Steps

The
The
The
The

U'IbWNI"

$JOB
$BAS
$EOD
$RUN

INTERPRETING THE
MSBATCH

RESULTS

NNNNNNN onooosmnwwH
I

MSBATCH

OF A JOB

RUN

CONTROL COMMANDS

INTRODUCTION

CHAPTER

wwwwwwwww NNNNNNNHH wwNNI-‘I-‘HH
uh

bobububub WWNHco WNH
o

Used for Reference Format
Rules for Command Syntax
DETAILED DESCRIPTIONS

Symbology

General

thH
NH

Purpose Control Commands
$JOB Control Command
$DECK Control Command
$MSG Control Command
$EOD Control Command

BASIC

Job Control Commands

$BAS Control Command
$RUN Control Command
FORTRAN

wNH

Control Commands

SFORT Control Command
SLOAD Control Command
$RUN Control Command

INPUT/OUTPUT

CONSIDERATIONS

INTRODUCTION
NAMING RESTRICTIONS

FILE

I/O

DEVICES

Programs

BASIC

FORTRAN

General

wwwwwwwww HHmmqm#bNHH
I.Il

IbobIh-Ibtbtb wNHH
I

Programs
Programs

iii

UlNO

Page

QPEEATING PathDUEES

7'0
O

INTfievHCTIGE
EREPARING TEE JEE DECK
LEADING AND RUNNING MSBATCH
EESEFTDIHG T0 flSEE REQUESTS
TEENIEATING BATCH JOB EXECUTION
EEEDE MESEAEES

1mtflhwatnfl

3? I"

Gwss ARY 01" TERMS

2131::

UIU'IU'ILIJIv—‘H

APEENEIX

flow To MARE Cx¢+~
IyJRODUCTION
CARE FIELDS

mmuml">v‘g

hfiwa

Statement/Llne Number Eield
P

an» mwm

..-.

C
C
C
C
C

I‘b‘i
‘0‘.

C.%
CC

Keyword Fie1d
Character Field
Marking the Alphabetic Characters and
Dollar Sign ($3
Marking the Symbols; < > and ;
Marking Numbers, Period and Comma
,Marklng Special Chargcters
yIEfiATIflN CARDS
COEEECTING E EORS
8

CAEE READER CEEEATTNG ERECEDURES
IETEOEHCTIOE
CONTEQLE A39 INDICATOEE
CARE HEEELIEG PEOCEDEEES
Load1ng Cards
Uhlcading Cards
OEERATING P '.; T‘“'
Mode1 6M8?
_

5%‘093‘5

..
‘

‘

foallne Operation
Dn~1ine Operatlnn
Mod31 CREE
affinlina OEQratian
Dayline fipfiration

AEEEEDIX D

INSTALLING MSBATCH

AEPEEDIX E

ADVANCED FEATURES
USING MSBATCH TE ERQCESS'OS/S JOBS
USING THE BATCH STREAM DEVICE

E >6
E

wwww aqu‘h-obD-‘H
wU'JtUWUJHHmw
HNH
I

00000 I—‘F‘I—‘I"ww
1

$169335
'

1!
A

toraEVMEoNugharwu mumhwmww
s

‘

1 ’!
‘

Mark Sense Card Fermats
MSBATCHvOs/fl Intaraction
Elementary Batch Processing Steps
8503 Central Card
$FORT Cantrol Card
$BASAC9ntr91 Card
$EOD Control Card
$RUN Control Card
Job Layout
Job Deck Listing
BASIC Example:

NNNNMl—‘H l—‘I—‘KOmQO‘Noh-N
I

Page

2~9
2-10
2-11
2*12
2~l3

BASIC Example:

5—1

End-of-File Carfi

3-1
3-2
3-3
B~4
B-S
B-6
B~7
8-8
8-9
B~10

FORTRAN IV
FORTRAN IV
FORTRAN II
FORTRAN II

Fortran

Job Carpet Listing

Exemple6
Example:
Example:

Example:

fleck-Listing
JeE-Outpnt Listing

Job

566 Back Lietinq
Jab output LiStiflg

5-2
B~l
S62
362

Card

BASIC Card

26l3
Zwle
Zwle
2~r6
2616

Properly Markee Ceres
Card Field Layout
Control Command Field

B~4

Statement/Line Number Field
BASIC Keyword Field
FORTRAN Keyword Field

B?6

Character Field"

365

EH7
3&3
‘

Selecting Alphabetic Characters an&.the
Sign Symbol
<
>
and :
Selecting the Characters:
Selecting Numbere, Ferioé-ené comma
Selecting Special Characters
Selecting Special Characters in Solemn 40
Specifying card Continuation
Correcting Errors with RUBout

Bag

Dollar
8-11
3-12
B-13
3-14
B-15
3-16
C-1
C-2

card Reader
Card Reeéer
Controls and Ineicetors
Controls and Ineicators

3‘9
369

3610
Bell
3612
SelS
car

C*3
C~4

CMBF
CMSE
CMSF
CM8E

2-1

MSBATCH User

3-1

Control Command

4-1
4-2
4-3

BASIC I/O Operations
FORTRAN IV 1/0 Operations
FORTRAN II 1/0 Operations

4‘2

5-1

MSBATCH

Operator Error Messages

sus

c-l
c-z
c~3

CMBF Fronfi Panel centrols ané Indicitere
CMBF Rear Panel Controls
CMSE Controls and
Indicators

c«4

D-l

List of Files Associated with MSBATCH

Caz
ewe

TABLES

Error‘Messages

Summary

2a12

3~3

4&3

c~6

n~1

PREFACE

Batch
Sense
Mark
the use and operation of the
In general, the manual is organized
(MSBATCH)
08/8
system program.
for
to provide information in a reference format and, except
Chapter
2, it assumes the reader is familiar with the use and operation of the
05/8 system software described in the 08/8 Handbook, DEC-S8-OSHPS-A-D.
The
inexperienced user should refer first to Chapter 2, which
for
for
describes
programs
preparing
step-by-step procedures
submission
to MSBATCH.
Experience and familiarity with MSBATCH will
lead
to
utilization
of
the
more
sophisticated MSBATCH features

This manual describes

described

in the other chapters.

program.
Chapter 1 summarizes the functional characteristics of the
2
describes the step-by-step preparation of simple BASIC and
Chapter
to
FORTRAN batch jobs including:
how
how
mark
to
cards,
prepare
programs, how to use MSBATCH control commands, how to organize the job
deck and how to interpret the results of job processing.
Examples of
marked ‘cards
illustrate
important points.
Chapter 3 describes all
MSBATCH control commands
and
gives
including syntax~ and options,
examples of use.
Chapter 4 describes input/output considerations for
BASIC and FORTRAN
5
the
describes
Chapter
operating
programs.
for
MSBATCH
and
MSBATCH,
starting
using
procedures
including:
loading
its operating modes, responding
to
user
requests,
controlling job
execution, and interpreting error messages.
a
batch
include
appendices
glossary of terms peculiar to
detailed procedures
processing in general and MSBATCH in particular;
for marking mark sense cards;
a description of the Operation
the
of
CM8E and CM8F card readers;
a description of the procedures used when
for
and, instructions
installing MSBATCH into an 08/8 system,
using
08/8 keyboard commands under MSBATCH.

The

cards
are
sense
Except where it is necessary to illustrate how mark
all programming examples simply show the contents of the card
marked,
as

interpreted by MSBATCH.

vii

CHAPTER 1

INTRODUCTION

1.1

INTRODUCTION

Mark

Sense Batch

(MSBATCH)

OS/8

that

program

translates

the

on
contained
Digital's specially formatted optical mark
service
The
sense cards into a standard 05/8 ASCII file.
principal
performed by MSBATCH is to act as a mark sense card pre-processor for

information

05/8

pregrams
'as

the

Mark

to
This permits FORTRAN and BASIC
prepare
programmers
for execution under 05/8 BATCH using optical mark sense cards

BATCH.

input medium.

Sense

Cards

can

contain three

categories

BASIC or FORTRAN

language keywords.

User

text

specified

(arguments,

information:

data,

05/8

commands).
0

Control commands

As shown in Figure 1-1,
with
BASIC
MSBATCH:

keyboard

that

direct

there

MSBATCH

operation.

used
are two types of cards that can be
are
FORTRAN
The
cards
and
cards.
cards,
essentially identical, except that the FORTRAN card contains boxes
printed with FORTRAN language keywords, while the BASIC card contains
boxes printed with BASIC language keywords.

1-1

'QdQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ

TDBWIIW
If

-‘an

ZHZID

QQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ

>flflWflflflflTflflfloQQQQQQQQQQQQQQQQQF

(:>

=2
IIIIIIMI
*EIIIzI UIUUIIUIIIIIIIIIIIMIUHIIIUUIMILg
IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIEg

(2)13"

e»

{’(3s.

*jIIIII”IEIIIIIIIIIIIIIIIIIIIIIIIIIIIIIEI

vEEIEI”I“IIIIDIIIIDIEIWIDEIIQIIIIIIIIIIEI

IjgggatIIIIIIIIIIIIIIIIIIIIDIIIIIIIIIIIEg
filtdlfimmxIIIIITIIIIIIIIIIIIIIHIIIIIIII
666

‘

’

"”5

HHHHH‘PHHI’.’ n.

HIIIH”IIEIIIIIIIBIIIIIEIIIIIIIIIIIIIII
°IDI°ILnDIBIHUIUIDIHDIHQIIIIHHHBQIIIII

2HI

67I I8 I9 IDIHIWIDI“IBI%IVI“I WIWINIfllnlfilululvlnlfllwl“Inlfllulfilulvlul 39I ”I

FORTRAN Card

-WIIIM.DDDDDDDDDDDDDDHHDDHHDDDDDDDDDDC
.”miIEDEDBBDDEBDDBEEEDEBDDEBEBEBDEE
'

3mm?“IIIWII“IIIIIII“II“IIIIIIIIIII
amnamnaaaa g
.I2 INEIEIIIIIIIIIEIIIIE

-‘IwfifiksfiwmmmWLLfiIImMIII
EIIIIIIIIIIE;
QIBIIuIIDBIIDIIIDIIDIIIIIIIIIDIIIIIIEa
IIMIMW II
IIDEVDEIDIDIIIIIJIIDIIIEI
NEIDVWII
flDflIS“mIIIIIIUIIIISEIIIIIIIIIIIIIIIIIIag
IIIIDIIIIIQIIIIIIIIIIIIIIIIIIIIE
'TTIS(S(
RESI-

ST(S( KTEHEHIHEHEBETSISLSIsIstsIsISIsISISISI5(5(5(5(5(5(
IQEQ7 nwmwwlmw
UIIIIBEIBEIIIIIIIIIIIIII
IerJ
“8IIII
laax aye
mam III
w
IIIIIIDIIII 8w IIVWVV
I EDI” m9$L
“II HDEDDUIIDQDDUUDDUILDIUWIIIIII
w

SMax

'1 '2 I3 |4 '5 [a [7's '9 |m|n|n|n|u|u |w|w|w| w|m|m|n|n|u|x|n|v|n|n|w|mlu'n'u'ulul v| ”I 3' ml

BASIC Card

Figure 1-1
Mark Sense Card Formats

1-2

designed to facilitate batch
Any language keyword or batch control command
preparation.
program
other
or
Data
can be specified simply by marking a
single box.
MSBATCH also
user-specified text is entered as single characters.
may be used to create an 08/8 file from any data on mark sense cards.
The mark

sense-cards

has

MSBATCH

three

specifically

operating modes:

Batch Mode

Interactive Batch Mode

PIP

Mode

a
being input as
prepares the deck of cards
All program language
execution
for
by 08/8 BATCH.
are
properly interpreted
keywords, data, and batch control commands
Wherever necessary, MSBATCH alters
and
placed. in the output file.
user
cause
the batch stream to
all
normally.
input data,
program
obtained
from the terminal's keyboard, to be obtained from data cards
output,
normally
Similarly,
program
following the user's program.
is switched to the 08/8 BATCH
directed
to:
the
terminal's
printer,
is
(whichever
listing device, either a line printer or the terminal
Other
available).
08/8
input/output devices can also be used to
contain programs and data, in which case the batch stream being
input
cards simply contains control commands.‘ Once all cards are read’
from
MSBATCH
and the batch stream file is complete,
automatically passes
control
to
(Refer to
08/8 BATCH to execute the batch stream file.
for
the description of 08/8 BATCH in Chapter 2 of the
08/8 Handbook
further information.)

In Batch Mode,
stream
batch

are

MSBATCH

Interactive Batch Mode, operation is identical to Batch Mode except
MSBATCH does not redirect input/output normally intended for the
This allows the individual programmer or operator
run
to
terminal.
the
program interactively,
program data input being entered from the
terminal's keyboard and program output being printed at the terminal’s
In

that

printer.

simply copies the contents of the cards being
Control is not passed to 08/8
specified 0S/8 file.
If
are
BATCH.
language keywords or MSBATCH control commands
are
This
included,
they
interpreted and included in the file.
permits batch stream files to be created for submission to 08/8 BATCH
at
a
-later time.
Interactive 08/8 and 08/8 BATCH users can also use
this feature to create an 08/8 file from
mark
cards
for
sense
any
purpose (for example, data files).
In

PIP

input

Mode,

MSBATCH

into

any

Figure 1-2 illustrates the functions performed by
its relationship to 08/8 BATCH.

MSBATCH

and

shows

MARK SENSE
CARD INPUT

OPERATOR CONTROL COMMANDS:
O
0

BATCH MODE
INTERACTIVE BATCH MODE
PIP MODE

J
'\

ficmslfifi

KEYBOARD

\
/

MSBATCH

CONSOLE
TERMINAL

PRINTER
.

PIP MODE
'

OPERATOR MESSAGES
ERROR MESSAGES

OUTPUT FILE
(ANY 05/8

DEVICE)

3
O
z
I

05/8 BATCH

3
<

OPERATOR JOB CONTROL

PROGRAM INPUT IN

INTERACTIVE MODE

CONSOLE
TERMINAL
KEYBOARD

OS/8

BATCH

OS /8
I/O
DEVICES

JOB

(LINE

DEVICE

PRINTER

OR TERMINAL)

PROGRAM LISTING
PROGRAM ERRORS
0 PROGRAM
OUTPUT
0 05/8 SYSTEM
ERRORS

Figure
MSBATCH-OS/8

1-2

BATCH

1-4

USER MESSAGES
TO OPERATOR
. PROGRAM OUTPUT
IN INTERACTIVE
BATCH MODE
.

OUTPUT

LISTING

CONSOLE
TERMINAL
PRINTER

Interaction

1.2

HARDWARE/SOFTWARE ENVIRONMENT

MSBATCH
It

can

operates
be

used

any

3).
system program of the 08/8 Monitor (version
PDP-8E/8F/8M hardware configuration that permits

03/8 BATCH operation and has either
optical mark card reader option.

1.3

HOW MSBATCH

model

CM8F

model

CMBE

Kit

tapes

SUPPLIED

The MSBATCH

software is
listed below.

supplied

the

Extension

DECtape

DEC-SB-UEXTB-A-UC

LINCtape

DEC-SB-UEXTB-A-AC

DECcassette

DEC-SB—UEXTB-A—TC

Paper Tape

DEC-SB-UEXTB-A-PB
DEC-SB-UEXTB-APPR

Installation procedures

03/8

are

(MSBAT.SV)
(GENIOX.RL)

provided in Appendix

1-5

CHAPTER 2
USING MSBATCH

This
users

for
the elementary procedures necessary
using
and is directed primarily to BASIC and FORTRAN
Other
are unfamiliar with batch processing under MSBATCH.
in
discussed
modes
are
5. Specific information
Chapter
includes:

chapter describes

MSBATCH

who

operating
presented

Batch Mode

preparing

BASIC

preparing

data

submitting

interpreting

and FORTRAN programs

cards

program for execution
the results

of program

run

glossary of terms peculiar to MSBATCH and batch operation in general
presented in Appendix A.
Appendix B contains step by step
procedures for marking mark sense cards.

2.1

ELEMENTS

BATCH

MODE

PROCESSING

FORTRAN
their
environment of MSBATCH, users submit
to a cOmputer operator for batch compilation and
programs
This is in contrast to conventional interactive
execution.
Operation
where
each
user
and
executions
performs his own compilations
the
2-1
illustrates
steps
interactively at the computer.
Figure
required to prepare programs and data for submission to MSBATCH.

and

the batch mode
BASIC

sense
card
programs and data to be input from a mark
This
means
that
once
a
reader.
program is written, it must be
transcribed onto specially formatted mark sense cards.
Any data that
the
The program
is to read is also entered on these cards.
program
cards are assembled into a deck called the program
while
data
deck,
cards
are
assembled into a
called the
data
deck.
separate deck
Special cards called control cards are placed at the beginning and end
of
the
deck
and at the end of the data deck.
These cards
program
contain control commands ’to MSBATCH
that direct batch
processing.
decks are then combined to form a job.
Both
The job is submitted to
the computer operator who, in turn, submits groups of jobs to
MSBATCH
for
processing.
During job processing a record of all operations
This
relating to each job is printed on the system's listing device.
is called the job output.
The job output is printed either on a line
The
available.
printer or the console terminal, whichever is
job
output contains such information as:

MSBATCH expects

’

After

Control

Program compilation listing

Program output

Error messages

commands used

job completion,

the

job

deck and

job output

are

returned to

the

user.

DATA

PROGRAM

CREATE A PROGRAM
AND DATA

ENTER PROGRAM AND
DATA ON CARDS
PROGRAM
CAR 05

DATA
CARDS

SEOD

INSERT

$RUN

DATA

DECK
.

CONTROL
CARDS

’

‘

SBA 5‘
OR

SFORT

SJOB

’

SUBMIT JOB
TO OPERATOR

SUBMIT JOB
TO MSBATCH

s‘auN

COMBINE DECKS AND
CONTROL CARDS TO
FORM A JOB

s 5 OD
‘

DECK

’

srom or $BAS

3108

PROGRAM/
DECK

Elementary

Figure 2-1
Processing Steps

Batch

2*2

IN’
oogAIhémgNED
LI

RESULTS

2.2

PREPARING PROGRAM CARDS

Programs
onto

to be

mark

submitted for processing by MSBATCH must be transcribed
BASIC and
two types of cards:
are
There
cards.

sense

with
boxes that can be marked
line
or
numbers,
keywords,
language
step
pencil
specify program
card
The
BASIC
and data, as well as control commands to MSBATCH.
with
BASIC
boxes
are
contains
that
language keywords, the
printed
FORTRAN card contains boxes that are
printed with FORTRAN language
Detailed
keywords.
procedures for marking cards are provided in
FORTRAN.

These

Appendix

cards

are

printed with

each
user
the input/output requirements described in 2.4,
should prepare his programs in the normal way as described in the QS/B
IV
FORTRAN
BASIC users should refer to Chapter
users
Handbook.
6,
II users should refer to
should
refer
to
and
FORTRAN
8,
Chapter

Except for

Chapter 7.

2.3

PREPARING DATA CARDS

Either
a program is-also transcribed onto cards.
cards can be used since the data is entered only in a
and
card's character field (beginning at
9
column
card
continuing
40). A data card must not be marked in card columns 1
through column
through 8. Appendix B specifically describes how to mark the character
field.
to

input by

FORTRAN

BASIC

Data

2.4

INPUT/OUTPUT

CONSIDERATIONS

or BASIC programs running in Batch Mode normally obtain
input
from a deck of cards containing the data.
Output from these programs
is sent to the system's listing device, either a line printer
the
or
console
In order to access the
is
available.
terminal, whichever
data deck and listing device, programs must perform
operations as
described in the following paragraphs.

FORTRAN

I/O

2.4.1

BASIC

programs

Programs

access the data deck and listing device
by using the
forms of the INPUT and PRINT keywords.
The INPUT keyword
is used to read a card from the
be
data
user
The
deck.
should
careful
not
to
specify a device number since this task is performed

elementary

automatically by MSBATCH.

2-3

For

example:

The

following

program reads
I.

them in array
10

DIM

N$(30,l9)

FOR

I=l TO 19

INPUT

For

example:

The

following

the

cards

used to output

5 A=l6\B=5\C=4
10 PRINT A, C+B,
15 END

FORTRAN

and

stores

N$(I)

lines of numeric

program prints the value of A,
square root of A on a single line of the

2.4.2.

deck

data

from the

keyword is
listing device.

The
the

the

sum

string

of C

and

text

and

listing device.

SQR(A)

Programs

IV programs access the data deck and
the
listing device by
the READ and WRITE keywords.
The READ keyword is used to read
from the data deck through I/O unit 4.

FORTRAN

using
cards
For

example:

The

following

statements

read

single

data

card

into

variable

the

‘

RAY.
READ

100
The WRITE

device via
For

(4,100)

RAY

(F8.0)

FORMAT

keyword is used
I/O unit 5.

output

program

the

listing

example:

The

following statements print
listing device.
WRITE

101 FORMAT

2.4.3

FORTRAN

using
cards

the

contents

the variable

RAY

the

(5,101) RAY
(' RAY=',El3.6)'

Programs

II programs access the data deck and
the
listing device by
the READ and WRITE keywOrds.
The READ keyword is used to read
from the data deck, using unit number 1.

For

example:

The

following

statements

READ

100

read

card into

the variables X and Y.

(l,lOO)X,Y
(2F8.0)

FORMAT

The WRITE keyword is used to
device via unit number 1.
For

one

output

program

the

listing

the

listing

example:

This statement
device.

prints

WRITE

101 FORMAT

2.5

SUBMITTING

When

all

the

content

of variables

and Y

(1,101)X,Y
('
=',E13. 7 ,5X,'Y=' ,El3. 7)

PROGRAM TO MSBATCH

statements

program

are

marked

cards,

the

cards

are

a
execution.
assembled
into
single deck in the order of statement
a
combined
into
are
Any data cards to be input by the program also
Before the program
single deck and arranged in the order of use.
be
for
deck and its data deck
can
submitted
processing, however,
be
MSBATCH
must
given the
job's name, the name of the language in
which it is
and
an
written
explicit instruction to execute the
This information is provided by adding special cards, called
program.
not
control cards, to the program and data decks.
Control cards are

of
the
actual
program.
They do not have keywords, statement
part
numbers or line numbers marked on them.
Control cards are cards that
specify one of the MSBATCH control commands (see Appendix B).

2.5.1

The

$JOB Control Command

batch
The first card of any job being submitted for
processing must
a
contain
This command specifies the name of
$JOB control command.
the program and programmer and identifies
and
the
combined
program
data
decks
as a new job.
Further, it assists the computer operator
in associating a
deck
the
user's
with
listing since the
output
information
this
on
card
is printed at the top of each page of the
command
listing.
Any cards in a deck that come before a $JOB control
are
A $JOB control card has a single mark in the $JOB box
ignored.
in card column 1. The name of the program, the programmer's
name
and
other
any
identifying information can be entered in the Card's
character field (card columns 9
2-2
shows. an
through 40).
Figure
example of a $JOB control card.

2-5

JAM-um IQ'ILIQIQIQIOIRI

3‘

IPIKIQIQI

ugh

15/1/13 117.71

03:3:

'nnnnianmmuma.mgammmm Dmmmmmnmmm DD DEC
unmmm n manna Bummmmmnmm DB EEC

>gmnnmn‘rnnmmfl‘nnmmnmnmnn‘xn‘mnr
aria—h
gflmllnni'malnmmrgmwmwmunmumnnnmmggunman:
.

000*

CQP.

EQWIIII'L—Egzer
fifi3H13H13‘131313r313131313x
3531
55Hawaaamaaanaamamnaamumlnnt
ESEEHE I'EEEEJME‘KLILAL
DIGITAL
“MWWBWW’E'TWWEEEQEEEIIIHBEEEE99
LLJlggleon
BASIC

‘

--------------

r ‘33333

G-

3131

3313

2F2F

2F2F2F

252r2r

EQJIPMENT

L4L4L4L4L4L4L4L4L4LL4L4L4L4L4L

”’

"‘1

505

REA!

V'f

505050505

REMARK

ll
rue

.___”50

950

050

6R6R

595911952 bRbR

bRbR

¢R.-

6R6R

-R

anon

P9P

-R

POPO'
a

POP

HEB!
..

.‘SM

Y“

Y”

'Y‘ 3| “Illa
tqzslléJLngllll lI'l9zsll9zsllgzsl!9st9st9zslI9st9st9zsil9st9 JIM
'

Z
Z
Z
Z
9 s 9 s 9 s 9 3

'1[2'3|4|5|5|7|a|9|n|n|n|n|u|uln'v'wlwlm'n|n|n|u|x|u|v|n|w|m|m|n|n|u|u|u|v|ulwlw|
V

‘———$JOB

not

use

Any user-supplied text

command

Figure

2-2

$JOB Control Card

2.5.2

The

$BAS and $FORT Control Commands

The

$BAS and SPORT Control Commands

cause

are used to tell
MSBATCH
whether
program deck to be compiled as a BASIC program or as a
FORTRAN program.
A card containing a SEAS
control
command
be.
must
inserted
immediately before a BASIC program deCk.
Similarly, a card
containing a $FORT control command must be inserted immediately before
a
FORTRAN program deck.
When the compilation is performed, a program
listing is automatically printed on the listing device.
Unlike other
control
commands, $BAS and $FORT appear only on the applicably marked
language card (FORTRAN card for $FORT or BASIC card for SBAS). A $BAS
control
card
has
a
single mark in the SBAS box in card column 1. A
$FORT control card has a single mark in the $FORT box in
card
column
If the user does not wish to obtain a
1.
printed program listing from
either compiler, he can enter the /NOL
(for
nolist)
option on the
This Option is specified by marking the characters
apprOpriate card.
/NOL in the card's character field (columns 9 through 40). Figures 2-3
and 2-4 show examples of $BAS and $FORT control cards
(notice that the
/NOL option is specified on the SBAS card).

the

2-6

Jdfidddddflddfldflfldjfldfldflfldfldfiflmfibfi
EQDLQBQQBEBBQQEDBQEg
ggggnggggq
1‘18»

rWWWm
BACQKJ
__JL_J

<\<\

ZC”

<\<\

A‘[A'A

HA=

[A1A iU‘AH-imo CORP.
B=HAB=MCICLDHCICLHBCLCIABJ:CJIB CICICICLCLQICICICICL
DE*
DE‘
0;
mD*
DE*
DE+
WIFE
(you
2EEFF2
0.5509 DE DE‘. EEElf—é]
£3.13;
F2F2F2F2F2F2F2
2IEEF2F2F2EF
2EEFZF2EF05"
WDF
LJE2F'2EEFF2Ogle.
MAZEEFZFZEFJZEF
101:
FW~~
0.»;
13 3.31313l313
~~~~~~naaamnmaalat
313l3i‘3l3l3I3I313131313131313131313131
1]
Jx‘
JK'
-,
JK
KIJK: lx'ix: JK: JK: 4L.
xnmo
JK‘IJK‘JK: .K.
J! J'
l44llL
Jl‘ DIGITAL
IAILILILILIL
Ix Ix In 'K.JK Jl: JK E!
.4!
JK‘Ifl‘JK‘ 4'41!“
.4“ KH'K.
.4“. Ix
MN7‘IM
MNL/
M
/
0m
MIIM/
050
IMIWM/M M'M/MlN/M/MN/ 0505050505059150505050505
M/M'M/MIM/M/
V/uwwnl:
oRéQR “0:0?”
.RbR oQRoa 232.0% EIRIQR
IQJ WQQQIIQJ
EPQIIQJPQJ'QJ
bl Inna .IQBQ
69. EQJQJ'QJM
lb lulu FPDPORTRAN
Inlnfl
U7U7U7U7U7U7U7UJU7 7U7U7U7U7U7U7U7U7U7U7U7U7U7__J
7_UJ7
“SWEENEWENEWHHEEHEHHEEWESHINE
JSYOPBXB
X8 X
JBX .XBXBXIX8X
'wBIUHIWIDIIIIIFUUHIIUWEHIHHIIII
JEEE? “EIDIELUUDIIIDDUUIIIIhMUIDIIIIfl
=

UDOF

IAB=
ILJ
LLJ

LWCLCLC

EQUIPMENT

3131

MN/IMl/l

4L4L

50505.0.0 5050505.N SNOSNOSIOSIOSO
.

anon

oRoR

anon

7U7U7U7U7U7U

X8X8X8X1§X8

2'3

RUB

IAISIbI7WIH'JMI10'11I12|13IM|lS'lb'W'lOI!9I20l2\I22I23I24|25I26|27|28I29I30l31'32I33|34I35|36l37|38|3¢|40|

not

Enter

use

/NOL

nothing

‘———$FORT command

Figure

2-3

$FORT Control Card

UBDDDDDDDDDDDDDDDDDDDDDDDDDDDD

“E El
IW

LET

mUDEEDDUDDDDDDDDBDDBEEDUEBEEBDC
flflflflflflflflflflflflflflflflflflflflflflflflflflflflfHF
fimbmmjlUDMZMUBUMQJHUBUUEMDUUMEML CERF.
uIIIIIEIIIIIIIIIIIEWEIIIIIIIIIIE
A

LIST

W
O ,.

Will

JPRIN

I
as )
REMARK

£IIEHHQEmmmmmwgnggggmgggggygnM
UMQMUQ

HIIEHHI!IldfldlfllflflflflflflflflllllllE
mQflflflflflfljiflflfllflflfllflflflfllllflflflfliiE
IIIIIDIIIDIPEEQQEQDIIDIIDIEIIEE

‘0:-

PL
RE ST

EWPMENY
HEIDI.DIIIIWILIIIDIEQIIIIIIDIIE DIGITAL
uEIIIIHIQIIIIIIEIHIDEBIIEEIEIEEE

raga? IURN
flflflfla
flBEE°”MHUDIBIDIDIEDUIIWDD
DIDLJFQIDIIIE
R

RUN

I‘ I2 I3 I4 I5 I6 I7 I8 I9 I”I”IVIBI" IfilblVlml

IWINI“ |22|23|24|25|2o|27|2a|29|30|31.32|33|34|35|3o|37|3a|39|40|

L'V
Do

not

use

h—é—SBAS command

Enter

Figure

/NOL

2-4

$BAS Control Card
2-?

nothing

BASIC
POP

2.5.3

The

Control Command

$EOD

card
last
end of deck) command must be the
This control command tells
decks.
a
A $EOD control card has
Single
where a program or data deck ends.
in the $EOD box in card column 1. Figure 2-5 shows an example of
mark
a $EOD control card.

inin

EOD

incaggtfionggograg an: data

MS§ATCH

IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIII

SUEDE?SUBBEDUEEEDBEDBDUEDEEDBUC

WflflflflgflflflflflflfiflmflflflflflflflflWWWWWHET
0.0.10.0‘0go‘2‘A'A.
0

0'0

0’0

0.0.0.10'0.10'0.0'0.0I

'@EEEMEEMEEEEEEEEMEMEMEEEEMMMMN= C XP.

'aEEEEEEEEEEEEEEEEEEEEEEEEEEEEEI
.........

EQJIPMENT

E@flflflflflflflflflflflflflflflflflflflflflflflflflflflflfi
LgflflflflflflflflEHEHHEEEHHEHHEHHHHHHHHE DIGITAL
I

'u”@EEEEEEE@EEEEEEEQEQEEEEHEHEEHEE BASIC
“

flflflflfififlflEflflflflflflfiflfififlflflflflflflflflflflE.

flflflflflflflflflflflflflflfl%@flflflflflflflflflflflfiflfi
EEEEEEEMEEEEEEQEEEEEMEEEMHMHEEE
3@QQHEHEEEEBQEHEEHHQQQQHQEHHEEHE
..

"F‘T‘I

uuuuu

'1 I2 '3 l4 [s '6 | 7 [a '9.|IO|II |I2|13|u|5|w|17|15|19|2o|21|22|23|24|25|2¢|27|28|29|3o|31|32|33|u|3s|3o|37|30|39|w|
‘

__J

\_,
V

L-——$EOD command

.Do

not

Figure

2-5

use

$EOD Control Card

2.5.4

The

$RUN Control Command

The

$RUN Control command causes the program compiled by
a
$BAS or
control
$FORT
command to be executed.
This command must be used if
the program is to be
A
executed.
control
$RUN
card
is
placed
immediately after the $EOD control card that terminates the program

deck.

the
program
requires a data deck, that deck must
follow
the
control
$RUN
The data deck must be
card.
terminated with a SEOD control card.
The $RUN control card contains a
single mark in the
box in card column 1.
$RUN
2-6 shows an

immediately

example of

Figure

$RUN Control Card.

2-8

!lll!{__‘

Jqullllil

,11I[II

HWHHHPWmeW—WFH’WWWTHE‘Na >MET
>

éULU”fi£flHWLMH“AQUQQUUFMHQLQU‘BML

vBIBIDUIIEQEEUHWBIEQQQQEIDQIIIBE
m

IIIEQQEWEUEIIQIQIIDQBIBQIIIEIEE

C XP.

EQJIPMENT

j}vIgmlmaliEEBUQDEHIIQQEDMMWBIIIIE DBIAGSITIACL
HIIIIQQDWETQHQQHEEDUEUUHEMHQEEE
““Lwflflflllmflm
EL]IDIIIIBUMMEEEBEDMUUDDD[MERGE]?
EEEEILJLJ'JEIBIHIIBIUUUUU
1EHBEJDIFJ
LJLLMEQEEMEMEMLMLJEJEJEJUEJI

PDP

llI2I3I4I5'6I7'8'9'10'H'12ll3lI15'16'17'18II9I20'2!'22.?3'24'25l26'27'28'29'30'3lI32l33|34l35|36|37l38|39|40l
j

'\_
V

——-$RUN command

not

Figure

use

2-6

SRUN Control Card

2.5.5
A

Summary of Job Preparation

complete job deck ready

to be

$JOB card

$BAS

$FORT card

the

Steps-

run

under MSBATCH

control consists

of:

first card
as

the

Second

card

The

A $RUN card if the job is to be executed

program deck

$EOD card to terminate the program deck

Figure
deck is

optional

deck

of data cards

$EOD card to terminate the data deck

2-7

shows the schematic layout of a complete
submitted to the system operator to be run.

2-9

job.
.

This
'

job

$EOD CONTROL CARD
T"

NAM

$RUN CONTROL CARD

DECK

$EOD CONTROL CARD
fififi
.

PROGRAM
DECK

seAs or $FOR CONTROL CARD

$108 CONTROL CARD

Figure 2-7
JOB

2.6

INTERPRETING THE

RESULTS

Layout

OF A JOB

RUN

The job output, printed on the listing device during the execution
each
user's
contains
a
job,
running account of the results of

processing.
include:

Specific information-that may
'

appear in

Program listings, when requested

Program output

Control

Error messages

from either the FORTRAN

Error messages

from MSBATCH and

commands

used

in the

the

job

output

job

08/8

BASIC

compiler

BATCH

In addition, the user will find other entries in the
job output that
do
not
These entries are inserted
appear to be related to his job.
into the job output by either MSBATCH or OS/B BATCH.
To
understand
the
significance of these entries, the user should remember that the
task of MSBATCH, when operating in Batch
Mode
or
Interactive
Batch
is
to
Mode,
prepare
jobs into a batch stream file for execution

08/8 BATCH.
commands

the

order
to
do
MSBATCH
inserts
a
number
this,
of
to
05/8 BATCH into the batch stream along with the contents
user's
job deck and any error messages

preparation.

MSBATCH

also

alters

concerning

the

input/output

job

device

specifications in BASIC programs being run in Batch Mode to allow them
properly access the user's data card deck and the listing device.

2-10

During job execution, OS/8 BATCH prints all batch stream commands,
system program responses and 08/8 system program error messages on the
these
with
concerned
The MSBATCH user need not be
listing device.
and
entries
ignore any entry in his job output that meets the
may
following criteria:
'

asterisk
or
an
(.)
period
Any line beginning with a
(these are 05/8 BATCH commands inserted by MSBATCH).

SEOD control command following two

lines

after

(*)

entry

beginning
.R PIP

...

THE
FILES
OF
"NO
FORM...",
entries described in l and 2 (above).

inserted

between

The message

Modifications to BASIC program input/output ‘statements
are directed to the data card deck and listing devices.

that

2-1.
error messages directed to the user are defined in Table
messages
may be easily identified since they are preceded by a
question mark (?). FORTRAN IV, FORTRAN II and BASIC compiler errors
6 (respectively) of the 08/8
7
and
are
8,
described in Chapters

MSBATCH

These

Handbook.
show
listings of BASIC,
through 2-13
II job decks along with the associated job
in
the
The origin of each entry
outputs produced during execution.
output listings is appropriately designated.
The

examples in Figures

FORTRAN

IV,

and

2-8

FORTRAN

use
the
of
the
Each of the examples shows One or more instances of
card
continuation feature described in Appendix B. Since continuation
is specified by a code rather than by a printing character, a vertical
these
bar
in
used,
examples, to show the location of the
(I) is
continuation code relative to the preceding characters on the card.

should
notice
that
when
a
continuation
card
is
inserts an ampersand character (&) at the beginning
of the continuation line.
line
is
offset
Further, the continuation
three character positions to the left from the other lines so that the
the
line.
ampersand is positioned in the 6th character position of
reader
should
recall
that
the FORTRAN compilers require that
(The
This means
program input lines must be in punched card image format.
that
statement
numbers
must
be in character positions 1 through 5,
while character position 6 specifies continuation if filled with a
non-blank
Positions
character.
7
72
contain
through
program
non-blank
statements.) Thus, the ampersand, since it is a
character,
causes FORTRAN_to interpret the line as a continuation line.
MSBATCH
it
uses
the
begins all other lines at character position 9 because
CTRL
TAB
function
(8 spaces) when separating statement numbers from
statements.
FORTRAN

users

specified,

MSBATCH

2-11

Table
MSBATCH

2-1

Error

User

Messages

Meaning

Message
Invalid

?BCL LINE

TOO

?INVALID

FILE

code

character

statement
LONG

Too
Batch Command Line too long.
many
to
command
control
a
in
characters
command
The user continued a
MSBATCH.
non-blank
511
more
than
for
card
The job is aborted.
characters.

SPECIFICATION

The

entered

user

control

?INV§;ID OPTION

The
a

PROGRAM NAME

card.

The

card.

(i.e.,dev:fi1enam.ex)
$BAS)

$RUN control

card

was

$RUN control card must contain

specifiCation

run.

for the program

NOTE

last three error messages
in
shown
Table
2-1 appear only when the advanced
control
card
formats
described
in
Chapter 3 are used.
The

:gggrgAsxc EXAMPLE]:%

,Control
'

*—_____Tg
.Aa
INPUT A6,

04” .2.

N=INY((A1'AW)/Aa*.53*1

‘

R0=A@*3.1416/18@
RESA2*3.1“15/188
PRINT

X)":

"XCUEGREESD"."X(RADIANS)"o"SIN(I

TO
S:SIN(R0)

FOR

1:1

continuation
card

P rogram

A08Afl¢A2

continuation
card specified
here

903R@*92
NEXT 1
STOP
END

SE00

$RUN

0.99u5<*—-Data Card
.SEOD

BASIC

Figure 2-8
Job Deck Listing
Example:
2-12

used

previous compilation ($FOR or
loading ($LOAD). When used this

or
a

specification
a

control

$RUN

A
card.
without

illegal option
job is aborted.

file

Invalid

way,
file

specification

on
incorrectly
job is aborted.

specified

user

control

file

(dev:filenam.ex)

?INVALID

language

keyword.

DeCk

being

lggoa BASIC EXAMPLEIA‘

$JOB‘Control
Card

.R FOTP

wFIL???.*/D
N0

FlEES 0F

I$BASIC

FORM:

THE

FIL???.*

$BAS Control

‘

uR P1P
*PROG.BA‘BAT8

Card

SEOD

*TTYI/T<PRDG.BA
FILE

aazutxvafl

#3:"DATA.DA"\FILEV

AflpAlpAZ
‘63/A2*05J¢

BASIC
‘—

Program

Listing

Continuation
Line

RG'RGtRB
I
CLOSE #4\STOP
_ELOSE #4\END
SEO

Inserted

.le

MSBATCH

$EOD and $RUN
Control Cards that
follow the program
deck.

4
~

fzuglp

*DATA.DA‘BAT:

5500
.R BCOMP
*PROGnBA
XtDEGREESJ

XCRAOIAN8)

SINtXJ
<7

5
10

0.0872666
0.174533
0.2618

0.0871556
0.173648

0.349066
»0.“36333
0.5236

0.342021
0.422619
0.500001
0.573578
0.642789

15
20

25
30

0.258819

0.610866
0.698133

0.785399
a,872666

45
50
55

0.707108
0.766045
0.819152
0.866025

0.959932
1.0472
1.13446
1.22173

65
70
75
85

1.309
1.39626
1.48353

1.5708

Program output

0.906307
0.939692
0.965926
0.984808
0.996196
'0.999999

E522}:

$EOD Control Card
that
data

Figure
BASIC
_

Example:

Job

2-9

Output Listing

follows
deck

the

FORTRAN

sJoa

EXAMPLE]

‘$FORTRANf
(4.100)

READ

ANGLEQ;ANGLE1,ANGINC

2;:TIE(ANGLE19ANGLE@)/ANGINC¢,L:
WRITE
DO
1

Conttnnation
here

Spec¢fted

\\\\

RADIANGANGLEQw3.1416/18Q.
RADINC=ANGINC*3.1416/139.

Control
Cards

(5:101)

RADIANaRADIAN+RADINc

100
1a;

STOP
FORMAT
FORMAT

\162

FORMAT
END

(«1xcoecnsesa¢.Te@.*xanoIANs)'r""
J

93.

5.<+——Data deck

$EOD

FORTRAN

Figure 2-10
Job
Example:

l§JOB FORTRAN IV EXAMPLEL‘

Deck

Listing

$JOB
Control

Card

,R FOTP

*FIL???.*/D
FILES OF
'
$FORTRAN:=

THE

FORM:

FIL???,*

$FORT

Err—IF

Control

Card

*FILZ01<BAT!

SE00
.R F“

*FILEGI;TTY:<FILO@1

Figure
FORTRAN

Example:

2-11
Job Output

cont?"¥at$0"
here
Spectfted

Continuation
Card

SEUD
SRUN

Program 090k

(3F8.@J

:T401”3IN(X)'}=
(' ‘pF3.@.TZ@,F5.3.T4@.F5.3)

ANGLEfluRADIANgs
ANGLEEBANGLEG+ANGINC

‘

onttnuatton

Card

I'1IN
SaSINtRADIAN)
WRITE (5.103)

L\\\\\C

Listing

FORTRAN

Program

Listing
FORTRAN

05/5

READ

mama
@fifl!

@010
@@11
@012
@013
9014
9615
flfl16

(4.166)

ANGLE@.ANGL51.ANGINC

N:INT((ANGLE1-ANGLEQJIANGINC+,

SJIb 4
RADIANzANGLfiflt3.1416/186.
RADINCIANGIth3.1416/186.
WRITE (5.181)
DO
1 1:1,N
saschnADIAN)
WRITE (5.1%?) ANGLEQ.RADIAN,S
ANGLEQaANGLEE+ANGINC

@934
@665
@006
0067

PAGE

3.02

Conto

Symbol

RADIANaRADIAN+RADINC
STOP
FORMAT (3F8.w)

1
100
101

@017

FORMAT

C'1X(DEGREES)'.TEG;”XCRADIANS)‘

.T4@.'$IN(X)');:
FORMAT (’ '.F3.@.T2@.F5.3.T4@.F5.3)

102

END

zgzg
“EDD

angy‘:*

$EOD and $RUN Control
cards

,9 LOAD
*pRoG,Lo<
'

Continuation
Lines

that

program

the

deck.

*FILBE1/C
*3

.R PIP
*DATA.DA¢BATI
5600
.R FRTS

*PROG.LD
*DATA.DA/a
iTTYi/S
i8

XtDEGREES)
6.

X(RADIANS)

SINCX)

6.00Q

0.666

10.

25.
30.

0.175
6.262
6.349
9.436
Q.524

6.174
0.259
9.342
$.423
0.560

40.
45.
5%.
55.
60.
65.
7%.

0.698
0.785
0.873
0.96%
1.647
1.134
1.222

H.643

75.
80.
65.
96.

1.369

15.
20.

4:.

9.787
H.766
0.819
0,866
6.906
0.940
0.966
0.985
6.996
1.99%

1.396
1.484

1.571

$EOD Control

FORTRAN

Card

following

data

deck

Figure 2-11 (Cont.)
Job Output Listing
Example:
2-15

Program
Output

ONE

FORTRAN

SJOB

EXAMPLE}<———————Control Cards

I$FQRTRAN|
(lulflfl)
Xd=SQRTtXJ

HEAD

(1.1231)

WRITE

Continuation

pra

Specified

TO 1
here
FORMAT (P8.@)
FORMAT ('SGRTC'.E1Q.4.’J='.E1@.4.9
8..”3

180
101
_

_Program Deck

EN‘B‘\\\\Continuation
Card

spaces

Data

‘

Control

Deck

Cards

Figure 2-12
Job Deck Listing
Example:
.

FORTRAN

bane

FORTRAN

$JOB Control

EXAMPLE}:

Card

.R FOTP
*FI

???

t/D
'

EFORVRAN

$FORT Control

Card

.R PIP
*FIL001¢BAT:
SE00

*TTYt/T¢FILO@1
READ

Clplflfl)
XBHSQRT(XJ

WRITE (1.101)
GO TO 1
FORMAT (F6.@)

106
101

FORMAT

X,X2

(“SQRT('.E1Q.4.'J=‘.E1E.4.'

300.):

\\\

END

Continuation
Line

FORT

wFILD61<FIL901

3533‘:

‘$EOD and $RUN Control

that follow
deck.

Cards

‘

UADER

fiGEkIOX

the

program

tFILaet
*s

nsxzpnoc

.SAVE

t-Lsé‘éfi‘ésfé'éggfm
'

‘

u Q wanna:
4'

sanvcm.aamee+m1a=0.amaaa+a1
SGRTIO.9@B@E+01)=0.5@@@E+@1
0

IOER

ERROR

LDC 0

Program output

‘@E+@1
1E

Note:
FORTRAN

the end of the data deck

SIEODI

can

$|EOD|4

$EOD Control

F‘

data

ignored.
Card following

deck

Figure 2-13
Job Output Listing
Example:
.

FORTRAN

This message is output by the.
II object time system whenever

2-16

reached and

CHAPTER 3
MSBATCH CONTROL COMMANDS

3.1

INTRODUCTION

3.1.1

General

the
Control commands are used by the programmer to direct
of
MSBATCH
in
preparing programs for execution. Most
element
The first
control commands consist of one or more elements.
is
a
mnemonic
which
characterizes
the action or procedure that it
The mnemonic is located in card column 1 of the mark sense
performs.
The dollar sign (S) is always the first character of a control
card.
command mnemonic.

The

MSBATCH

operation

Examples:
$BAS
$FORT
$RUN
$L0AD
$JOB
$MSG
$DECK
SEOD

Remaining elements of a control command are optional arguments and
their delimiters.
An argument is used both to modify the action of a
control command and to specify the object to which the action
of
the
control command is directed.

3.1.2

Symbology

Used

for Reference Format

The

symbols and mnemonics described below are used throughout this
chapter to assist in describing the various control command arguments.
Braces

designate

optional

control

command

arguments.

Vertical bars designate
which
arguments
among
made.
-

3-1

list of control
command
single choice must be

CHARACTERS

Upper case characters indicate control command
guments that must be used exactly as shown.

lower

Lower

UPPER CASE

case

indicate
user-supplied
dev:,
(e.g., filnam.ex,

characters
command arguments

case

control

characters

ar-

3.1.3

Rules

etc.).

for Command Syntax

Since MSBATCH

be
control commands can
sense
input only from mark
rules
governing the syntax of these control commands are
the same rules that govern the procedures for marking a control
card.
These
are
described
in
detail
in
procedures
Appendix B and are
the

cards,

summarized below:

control command is designated by marking the

column

Boxes

that is

imprinted with

in card column

that

are

the

command.

not

printed

mnemonic may not be marked.
3.

Only

one

None

of the boxes

Control command arguments, when
card
columns 9 through 40 (this

control command

can

specified

in card columns

through

specified,
also

with

3.2
The

Leading, trailing,
ignored.

File specifications (dev.filnam.ex)
other by a comma (,).

DETAILED

control

intervening

must

the

appear

marking

argument

separated

are

command

may be marked.

includes

spaces

card

card.

indicate continuation cards).
6.

box

from

are

each

DESCRIPTIONS

commands

used

MSBATCH

fall

into

three

functional

command
commands

by group.

groups:
0

General

_BASIC

Purpose Job Control Commands

Job

FORTRAN

Control

Job

Table 3-1
summarizes
The
that
paragraphs

Commands

Control
the

Commands

function of each control
follow
describe the control
of
use
group.
Examples

options in detail, by
required for clarification.

are

and their

provided

Table

3-1

Control Command_5ummarY_fl
w—r

General Purpose
Control Commands

Description

$JOB{text}
dev:
$DECK dev:filnam
filnam

Initializes MSBATCH to begin

options}

C0pies

deck of cards

08/8

to an

job.

new

file.

$MSG text

Transmits

message

the

computer.

operator.
$300

or
a
deck
Terminates either a program‘
when
data
deck
other control card
no
follows.

[BASIC Control Commandgl

$BAS{0ptions}

Prepares

SRUN

Executes

program prepared

BASIC program for execution.

the

last

$BAS control card.

IEOfiERAN Control Commando]

$FORT{options}

Prepares

$LOAD{options}

all
FORTRAN
IV
Loads
programs for loading.

$RUN{0ptions}

programs

FORTRAN
IV
for loading.

FORTRAN

-or

FORTRAN

Executes the
program(s)
previous $LOAD.

loaded

Automatically performs

$LOAD

and!

then executes the loaded programs.

3*3

(3
8

General

3.2.1
This
both

Purpose Control Commands

section describes
FORTRAN

3.2.1.1

those control
and BASIC programs.

commands

that

are

independent

$JOB Control Command

Form:

Description:

$JOB{text}
This

control

command

initializes MSBATCH

This command must be on the first card in
job.
and
$JOB deletes all temporary files
every job deck.
other internal data pertaining to the previous job.

new

Option:

optional argument (text) comprises the remainder of
card
9
(columns
through 40) and consists of any
text that the user wishes to.include in the job header.
This
header
information
used
is
primarily for job
identification
to
correlation
between
provide
teleprinter and line printer output and the user's deck

The

the

of cards.

Examples:
1.

$JOB

$JOB STUDENT NO.

MATH

201,

SECTION

432.

PROGRAM TO COMPUTE

6, J.J. QUACKENBUSCH
THIS

PI.

JOB

COMPILES

AND

III
RUNS

3.2.1.2

$DECK Control Command
dev
$DECK dev: f ilnam.e
filnam

Form:

{options}

Description:

or
This control command copies a deck of program cards
and file
to
a
data
cards
(dev:)
specified device
this
that
follow
(filnam.ex). All program statements
to the next control command, are normally
command,
up
deck
A listing of the
interpreted as a BASIC program.
If no device is
is
printed on the
listing device.
specified, the file is output to the system device
If
no file name is
(SYS:).
specified, the device must
be a non-file structured
as
the
device
such
output
or
line
(LPT:),
(PTP:),
tape
printer
paper
punch
console terminal (TTY:). In these
the
/NOList
cases,
option, described below, must be specified.

Options:

Options

can

specified in

any order

and

defined

are

asvfollows:

/F{ORTRAN}

FORTRAN

/B{ASIC}

program’(default option).

Interpret

the

cards

that

not

option

a
-

Interpret the cards that follow

/NOL{IST}

program.

create

must

BASIC

This
deck of
structured

listing.
specified if the

program

cards is output to
a
non-file
device
as
such
paper
tape punch (PTP:),
line printer (LPT:),
or
console
terminal

(TTY:).

Examples:
1.

This
a

control

BASIC

(SYS:).

command copies the cards
into
on
TEST.BA
program
No program listing is output.

that
the

follow it as
system device

$DECK TEST.BA/NOL

that

This
a
a

control command copies the cards
follow it as
FORTRAN program into a file called TIM.FO and prints
listing of the deck on the listing device.

$DECK TIM.FO/F
3.

This

control

command copies the cards that follow it as
named TEMPO.12 on DECtape unit 1. No
program
program listing is output.
a

BASIC

$DECK DTAl:TEMPO.lZ/NOL

@‘s

3.2.1.3

$MSG Control Command

Form:

$MSG

Description:

This control command allows the user to
send
messages
to the computer operator.
The $MSG command causes the
bell or other signalling device on the console terminal
to sound and the text message in the character field of
the card (columns 9 through 40) to be printed.

Options:

None

text

Example:
This control command causes the message
PLACE
"PLEASE
GLAZER'S
IN
TAPE
H.
to
be printed at the
READER."
console terminal.

$MSG PLEASE PLACE H.

GLAZER'S TAPE IN READER.

3-6

3.2.1.4

$EOD Control Command

Form:

$EOD

Description:

This

Options:

None.

deck
control command delimits a
of- either
data
cards
This card is not required if
or program cards.
a card deck is followed by a
card
containing another
control command.

3~7

3.2.2

BASIC

Job

Control

Commands

This section describes the job control commands that are
associated with programs written in the BASIC language.

3.2.2.1

particularly

$BAS Control Command

Form:

$BAS{options}

Description:

The

cards
the
control~ command
that
prepares
to the next control command, for execution
BASIC
the
and
the
on
program
prints
program

$BAS

follow,
as

listing device.
Options:

Options
as

can

specified

Input

the

any order

and

defined

are

follows:

{dev:}filnam.ex

from

than

specified,
device

/NOL{IST}

BASIC

specified file
the specified

not

from

program

the

(filnam.ex)

residing on
rather
(devz),

device
If
cards.
from
input is

device

the

system

(SYS:).
create

program

listing.

Examples:
This

control command instructs
MSBATCH
to
input the
from
a file named INTEGR.BA, which resides on
program
the system device, and to
print its
listing on the

listing device.
SBAS INTEGR.BA
This
from

control
cards

command

and

causes

suppresses

listing.

the

program

printing

be
input
the program
'

SEAS /NOL

3-8

3.2.2.2

$RUN Control Command

Form:

Description:

V$RUN
$RUN control command executes the program
prepared
the last SBAS control command.
Any data input from
The
data
cards must immediately follow this
card.
deck‘
be
must
terminated by either a SEOD card or any
other control command.

The

Options:

None

3-9

3.2.3

FORTRAN

Control Commands

commands
the
describe
control
job
following paragraphs
particularly associated with programs written in either the FORTRAN IV
or FORTRAN II language.
Unless otherwise stated, these
job control
commands can be used interchangeably with either FORTRAN IV or FORTRAN

The

programs.

3.2.3.1

SFORT Control

Command

Form:

$F0RT{options}

Description:

The

SPORT

either

Options:

control

command

compiles

the

cards

that

to‘ the next control command, as a FORTRAN
follow,
up
the
‘program, and produces a relocatable binary file on
The
deck
terminated by
is
system device.
program

SEOD card

any other control command.
on the listing device.

proqram

listing is printed

Options

can

specified in any

order and

are

The

defined

»as

follows:

{dev:}filnam.ex

with
a relocatable binary file
the specified file name (filnam.ex) on
the specified
If
no
device
(devz).
device
is
is
file
the
specified,
placed on the system device (SYS:).

Create

/S{RC}={dev:} filnam.ex
Accept the program from the
specified
file
(filnam.ex)
residing on the
rather
than
(dev:)
specified device
from

cards.
If
the file is
system device (SYS:).

specified,

/NOL{IST}

Do not

create

program

device

input from

is
the

listing.

dev:filnam,ex

/L{IST}e filnam.ex
dev:

the
listing to the
program
specified file (filnam.ex) residing.on
the specified
device
If
no
(dev:).
device
is
the
is
file
specified,

Output

output

3~10

the

system device

(SYS:).

FORTRAN IV option only

/R{ALF}

listing of the RALF
generated
by the
listing
compiler on the

Print an assembly
code
assembler
FORTRAN

device.
FORTRAN

/S{ABR}

‘

option only
Print

SABR
assembly listing of the
FORTRAN
the
code
generated
by
assembly
II compiler on the listing device.
an

Examples:
cards
This control command compiles a program from the
it
and
that
follow
the
outputs
binary file to the
The program
system device with the file name STAT.RL.
listing is printed on the listing device.

$FORT STAT.RL
This control command compiles a
from
a
file
program
called
CIRCLE residing on DECtape unit 1 and outputs a
No
binary file called CIRCLE.RL to DECtape unit 1.
program listing is output.

$FORT/SRC=DTA1:CIRCLE,DTA1:CIRCLE/NOL

3*11

(3)()'

6»

3.2.3.2

$LOAD Control Command

Form:

$LOAD{options}

Description:

The
all
control
command
$LOAD
automatically loads
relocatable
binary files created by FORTRAN since the
the
execution of
last
and
them
for
$JOB
prepares
execution
via
the
$RUN control command.
Only those
files created since the last $LOAD
or
$LOAD
implicit

(via $RUN command)

Options:

Options
as

can

loaded.

are

specified

any order

and

are

defined

follows:

‘{L=;dev:filnam.ex
O:

filnam.ex

dev:

Load an
additional
file
(filnam.ex)
from
the
(dev:).
specified device
Levels and overlays (FORTRAN IV
only)

specified

by using the optional
"L="
for
a
new
starting
overlay level and "0:" for starting a
new overlay within the current
level.
Refer
to
the
description of the
FORTRAN
IV
contained
in
Compiler
Chapter 8 of the 08/8 Handbook.
are

syntax:

Multiple

loaded by
using
file
specification
for
each
(dev:filnam.ex)
program.
each file specification from
Separate
the next by a comma (,).
programs

are

additional

Note

that

the

used with

not

(/)V

slash
delimiter
this option.

/IM{AGE}={dev:}filnam.ex
the memory image file produced by
loader, using the specified device
If
(dev:) and file name
(filnam.ex).
no
device
is
specified, the file is
Save

the

saved on the system device (SYS:).
If
the
is not specified,
/IMAGE option
the file is deleted when another $JOB,

$LOAD,

executed.

$RUN with implied loading is

dev:fi1nam.ex

/L{IST}=

filnam
dev:
the loader's memory
map
listing
the specified device (dev:) and
file name (filnam.ex). If no device is
is saved on the
file
specified,- the
name
system device (SYS:). If no file
the listing is
or device is specified,
printed on the listing device.

Save

using

/LIB{RARY}={dev:}filnam.ex
Load
system
necessary
object time
routines
from
a user-created library
on
a
file
(filnam.ex)
residing
(dev:). If no device
specific device
the
is specified, it is assumed
that
library resides on the system device

(SYS:).

/NOA{UTO>

not
automatically load programs
compiled since the last SJOB, $LOAD or
implicit $LOAD (via SRUN). This option
Do

number of programs have
but
specifically
only
named programs are to be loaded.
used when

been

FORTRAN

/SS{YMB}

compiled

option only
Send a listing of
system
the
device
specified in

to
symbols
the
/LIST

option.
FORTRAN

options only

/IN{PUT}

handler.

/OUT{PUT}

handler.

/TWO

The

Reserve

space

for

input

device

output

device

space

for

handler specified by either /IN
/OUT option is a 2-page handler.

Examples:
1.

This control command loads all programs compiled
since
the last $JOB, $LOAD or $RUN with implied loading:

$LOAD
2.

This control command loads
three
previously compiled
called MAIN.RL, SUBRA.RL, and SUBRB.RL (only)
programs
residing on DECtape unit 1:

$LOAD
3.

This

DTAl:MAIN,DTA1:SUBRA,DTA1:SUBRB/NOAUTO

control

command card:

Loads
all
last $JOB,

Loads

previously compiled programs since
$LOAD, or $RUN with implied loading.

compiled

system device.
c.

d.
'

Saves

the

device

Prints

program called TEST

from

the

(SYS:)

resulting

memory

image

the

system

RUN4.
Loader memory map

$LOAD /L/IM=RUN4,TEST

3—14

the

listing device.

3.2.3.3

$RUN Control Command

{options}

Form:

$RUN

Description:

This
the

Options:

Options

control command executes the program(s) loaded
by
control c0mmand.
last
$LOAD
Program data cards
If
this
(if any) must immediately follow this card.
card
follows a SFORT card, rather than a $LOAD card, a
the
$LOAD
$LOAD is automatically performed and any of
options described in 3.2.3.2 can then be specified on
this card.

can

specified

in any order and

are

described

follows:

{dev:}filnam.ex residing

file
loader
image
the
specified device
If
is
no
device
(dev:)
(dev:).
the file is input from the
specified,
The
file
must
system device (SYS:).
have been previously created using the
$LOAD control command's /IMAGE option.
this option can be used only
Further,
when $RUN is not preceded by either
a
When this option
$FORT or $LOAD card.
is selected, no $LOAD command
options
can be used.
Run

FORTRAN

/un{N}=
C

memory
on

option only

dev:filnam.ex
filnam.ex
dev:
hn

where:
FORTRAN

numbers
N

must

reverse

carriage
currently

unit

logical

through 9

create

name

output file
specified)

new

(file

the
device
listing
control
processing
in
effect
on
or
(to

'off).
hn

FORTRAN

device

handler

number, 1 through 4.
dev:filnam.ex = device (dev:)
and
file
name
(filnam.ex) where file
If
no
device
resides.
is
specified, the file resides on the
system device (SYS:).

3-15

the
This
option allows
and
establish
modify the
assignments
output. device

user

input

to
and

used
by
OS/8 devices
programs.
and files can be assigned to
specific
unit
numbers.
Existing
logical
internal
assignments for FORTRAN IV's
be
can
altered.
device
handlers
4
for
further
Refer
to
Chapter
devices
about
information
I/O
available under MSBATCH.
FORTRAN

NOTE

numeric file name in the range of 1
4 is used, it must be specified
with a trailing period, whether or not a
is
extension
For
used.
file. name
If

through

example:.
/6=3.

assigns logical
on

the

unit

file named

system device.

Examples:
1.

FORTRAN
IV
This control command loads
and
runs
all
card.
programs
compiled since the last $JOB or $LOAD
is via unit 4 from a file called JOE2 and
output
Input
is
via unit 5 to a new file (/N option) called RESULT.
Both files are on the system device (SYS: ).

$RUN

/4=JOE2/5N=RESULT

This control command runs
the
memory
image file of
either
a
FORTRAN
IV
a FORTRAN
or
II program called
TASK31 residing on DECtape unit 2.

$RUN
3.

This

DTA2:TASK31

either a FORTRAN II
the last SPORT
The memory image file is saved
card.
on
the
system
as
MTHOZ.
device
Carriage control command processing
for the line printer listing device
is
5)
(I/O unit
reversed.
or

control

command.loads

FORTRAN

and

runs

compiled by

program

$RUN

/IMAGE=MTH02/5C=LPT:

CHAPTER 4
INPUT/ OUTPUT CONSIDERATIONS

4.1

INTRODUCTION

and
facilities
In
techniques
general,
input/output programming
those
MSBATCH
user
are
to
the
available
provided by 08/8. This
There
Handbook.
information is described in Chapter 1 of the 08/8
user.
that
are of concern to the
several exceptions
however,
are,
The paragraphs that follow describe them.

4.2

FILE

NAMING

RESTRICTIONS

the
to
filenames
identical
careful not to
select
These
used
MSBATCH
files
and
BATCH.
08/8
temporary
by
files
are
automatically deleted _when the next $JOB command is
the
user should not attempt to read from or
executed.
Therefore,
FIL
or
write into files that have names that begin with the letters:
PROG.
Further, FORTRAN IV or BASIC users should not attempt to write
into any file called DATA.DA, since this file contains the user's data
deck card images.
The

user

names

4.3

must be

the

I/O DEVICES

and BASIC programs
a
file
from
normally obtain data
from a deck of data cards that follows the $RUN control card.
Output from a program is normally sent to the system's listing device,
either line printer or
console
available.
terminal, whichever is
This I/O scheme can be altered in several ways:

Both

FORTRAN

created

The operator can run MSBATCH in Interactive
Batch
in
Mode,
which
case
input/output as described above is automatically
switched to the console terminal's keyboard and printer
no
program modification is required.
--

access
other
devices
and
files
in
08/8
with the rules of the language being used and the
following paragraphs.

The

user

can

accordance

4.3.1
BASIC

files,

BASIC

Programs

two input
programs are permitted two simultaneously open files:
two output files or one of each.
be used
can
device
Any 08/8

4-1

except

LPT:

explicitly.

must
file
The
DATA.DA
and
CDR:.
the input/output
4-1
shows
Table

not

operations

accessed
allowed

under MSBATCH.

Table 4-1
BASIC
Statement

I/O Operations
Device

File Numbers

INPUT

Program's card deck image
residing

INPUT

the

file

system device

DATA.DA

(SYS:)

Listing device.

I/O to user specified files

and

devices

files

and

devices

except LPT:

to user

specified

except LPT:

and CDR:

1/0

INPUT
PRINT

4.3.2

FORTRAN

Programs

IV programs perform input/output Operations using logical unit
numbers
in
These logical
arguments_ to READ and WRITE statements.
units can be assigned at run time either to one of the internal device
handlers
within
FORTRAN
IV or to an OS/8 device and file.
This is
a
4-2
command
Table
shows
$RUN
3.2.3.3).
(see
accomplished by
option
the default device assignments and their use.

FORTRAN

4-2

Table
FORTRAN
Statement

Logical Unit

I/O Operations
Device/Use

Number

Papertape reader

READ

IV handler

Papertape Punch

WRITE

No.

IV handler

No.

(internal
l)

FORTRAN

(internal
2)

FORTRAN

assigned

READ/WRITE

Not

READ

Program's

data card deck

DATA.DA

residing

device

image file
the

system

(SYS:)

Listing

WRITE

whichever

device
(LPT:
is available)

TTY:

6
7

READ/WRITE

Not

assigned

4.3.3

FORTRAN

shows

the

Programs

programs perform device dependent input/output.
input/output operations and devices available.

Table
FORTRAN
Statement

I/O Operations
Device

Program data deck card images from batch
stream file

READ

Listing device

WRITE

High speed

reader

High speed punch

READ

Any OS/8 device and file

4
WRITE

NOTE

Unit number
programs

4-3

Unit No.

READ

Table

being

may
run

not

used

under MSBATCH.

4-3

with

CHAPTER 5

OPERATING PROCEDURES

5.1

INTRODUCTION

chapter describes the MSBATCH operating
procedures are described in AppendixD

This

procedures.

Installation

has three
and PIP Mode.

MSBATCH

operating

modes:

‘Batch

Mode, Interactive Batch Mode

in
In Batch Mode, users submit their jobs to the operator who,
turn,
BATCH.
processes them via MSBATCH for automatic execution under OS/8
an
User program input is obtained from either a data card deck,
08/8
or
MSBATCH processes the batch stream to produce
file,
paper tape.
an output file,
then chains to 05/8 BATCH for job
User
execution.
is
directed either to the
device, to an OS/8
output
program

file,

to paper

listing

tape.

their
to
jobs
permits users
process
this mode of operation all input/output normally
associated
with
the
data
card
deck
and
the
is
listing device
automatically switched to the console terminal.
Input, rather than
console
being obtained from the data card deck, is derived from the
terminal's
keyboard.
Output is directed to the console terminal's
printer rather than to the listing device.

Interactive

Mode

Batch

individually.

permits

Mode operation, MSBATCH
the contents of a deck of cardS‘
transferred to any other 08/8 device.
MSBATCH does not chain
to 08/8 BATCH.
Cards with control commands, language statements
and
data are interpreted accordingly.
In

PIP

5.2
The

PREPARING

THE

JOB

DECK

following steps describe
1.

Make

Collect all

sure

that

each

MSBATCH

job preparation.

job begins with

$JOB control card.

jobs to be processed during the same run
There is no limit to the number of
single deck.
jobs in this deck.

5-1

into
cards

a
or

This card
card at the end of the deck.
are no more cards to
there
that
MSBATCH
automatically signals
code
the
An end of file card is a card that has
be input.
arrow
back
for' a
(+) marked in column 1 as shown in Figure
of
If an end
5-1. The remainder of the card must be blank.
end of

Place

file

card

MSBATCH when

in response

can manually signal
operator
reached
CTRL/Z

the
not
used,
the end of the deck is
to the "LOAD MORE CARDS

cards

the
Arrange
direction.

file

that

they

by typing

0R TYPE

+2"

face

all

message.

the

same

the
Place the deck in the card reader' 3 input hopper so that
face down with the row of black marks at the bottom of
cards
If
the
reader.
each card placed inward toward the back of
as many
the
in
to
fit
too
deck
is
the
reader,
place
large
at
cards as possible into the reader's input hopper starting
C
for
to
the
of
deck.
the
(Refer
beginning
Appendix
will
MSBATCH
reader
detailed card
operating procedures.)
signal when it is ready to accept the remaining cards.

Illllllilllllllllllll1illllll

fiElEE] flDHDDDCUDDDDDDDDDDUDDDDDDDDDDDE
i'PWE ’ELUFEDDBDBELUDBDDEBEEDEEDEDDBC
r—\]<
\|'<_:_1<,l<<<<<< \I'QTI<0>\O<’\ <,\ <0"
IIO
LET

EWBWIIWMIIIIQMQQIIEIIEIQIIEIIIIEIIII COW.
Inlflflzfimxflfl‘FDEIQQQEIIIJIIIIIIIIIIIIIII

IEEEEI

mHEIIBDIIIDIGEDDEIIIIEEEEEIIEEEE

EQJPMENT

sEflMEAfl;IBJEBEECDIIIIEEIIHELIIEIHEIIEIIE DiGITAL
IHIBEB“IIMTETEQ3QEQEBQQQWQEEIIIEEIHIIIE MSTC
ébflmé”THEEVQHWQIICEEEHHHLQQIIIIQIIIIII w POP
770 7Tu
17.777Ia'mm7u7u
Tu 7T ”7 7T
‘iififlfifl
IIIIIII
7IUL
IBIELUE‘“S“
7uu7 Lg'7u7u7Tu71u77u7u7'ullsul7lu7fl'7I
'7u7u7u7u57

IWEIE”mIDIIEIIDEDIUUIEUIIIIIIIEIIIIIIEI
w|2o|2T|22|23|24|25|2¢|27|2a|29|30|31|32|33||34

9EQEH”MIUHMEEBBDIDTVBIEBFIIHIB@IIIIIE

fl‘l

6'7 '3 l9 lm'n' I2Il3'

“7'13

Figure 5—1
End of File Card

35|3¢|37|3o| 39 '40.

5.3

LOADING AND

RUNNING MSBATCH

is loaded like any other
calls MSBATCH by typing:

08/8 system program.

MSBATCH

The

operator

tR MSBAT
to the right of the dot prompting symbol
(.)
printed by
The command decoder responds by printing
08/8 Keyboard Monitor.
The operator then responds by typing
an asterisk at the left margin.
an
file
output
specification followed by any of the options listed
No input
file
be
since
below.
always
may
specified,
input is
the card reader.
obtained
from
If no options are specified, MSBATCH
MSBATCH
assumes Batch Mode operation is desired.
This
means
that
prepares a‘batch stream file from all jobs input to it, then chains to
the
It
further
assumes
that
08/8 BATCH to execute them.
listing
device is the line printer.

immediately

the

The

format of the

command decoder line

is:

{dev:}{output.ex}{/options}
where:

dev:

Output device that contains the file obtained from
the

card

input

system device
output.ex

Name

If
not
deck.
is assumed.

of the

MSBATCH

file.

output
types:

N0 OUTPUT

then recalls

Operator

specified,

the

(SYS:)

specified,

nOt

SPECIFIED

Ping

the

08/8 Command Decoder to allow the
The batch stream file
input a name.

created by
must
MSBATCH
reside
on
the
system
device
or on a device that is co-resident
(SYS:)
with 8Y8:
if 08/8 BATCH is to read it.

/Options

Enter

PIP

Mode

deck

the

transfer
the
input
specified output device.
language keywords are assumed to be
and

card
All
BASIC

until
a
control card is encountered.
$FORT
This option should be used when copying
data

cards.

Same

-as

keywords
statements

Option except
interpreted

are

until

all
as

language
FORTRAN

SBAS card is encountered.

Prepare programs for execution in Interactive
Mode.
Programs that were set up to

Batch

input from a data
device
listing
terminal

console

card deck and output to the
the
that
so
altered
are
is accessed instead.

the
and
is
When either /B or /F
selected,
be translated contains only program
to
deck
statements (i.e., no control cards, /I should
be specified.

Prepares the batch stream to
the
than
rather
terminal,

Causes

MSBATCH

string options
decoder
command

its version number at
command
other
all
command
The
are
ignored.
another
to
restarted
accept

terminal;

console

the

listing device.

the

the
console
line
printer,

use

string.
MSBATCH

Instructs

FORTRAN

compiler.

to
IV

'use

the

FORTRAN

‘II

normally assumed.

NOTE

will
not specified, BATCH
try
whether a line printer is
determine
If the line
printer is not
present.
switched to "on line" when BATCH starts,
to
some output will incorrectly be sent
If
this
should
the
teleprinter.
the
to
happen, type CTRL/C to return
Switch the line printer
05/8 Monitor.
to "on line", type
If

/T is

.R BATCH
When BATCH
the
name

prints

the

originally specified
batch

stream

asterisk (*),
device

and
to MSBATCH for

type
file
its

output:

fidev:output.ex
BATCH
Since MSBATCH passes control to 08/8
when
in
Batch
Mode
or
Interactive
Batch Mode, the operator can also include any appropriate
OS/8 BATCH options as described in the 08/8 Handbook.

The

command decoder

RETURN

the

cards

read,

the

MSBATCH
LOAD

line

ALT MODE.

can

terminated

operator placed

prints
CARDS

OR TYPE

with

the terminator is
in the card reader.

Once

5-4

either

typed,
When

Carriage
reads
cards are

MSBATCH

all

If
console terminal and waits for the operator to
respond.
load and start the card
more cards for MSBATCH to process,
in
the
cards
all
until
MSBATCH continues in this manner
reader.
If the last card in the deck is an end of
batch
are
stream
read.
the
file card, MSBATCH terminates input automatically.
Otherwise,
at the
there

are

message
OR TYPE

CARDS

of
the
is again printed, and CTRL/Z must be typed to signify the end
deck.
(CTRL/Z is typed by depressing the CTRL key while striking the
Z

key.)

prints a tally of the number of cards
For example:
invalid characters.

then

MSBATCH

contained
5
or

CARDS

cards

CARDS

5.4

enter

that

error:

ERROR

nor

(PIP

automatically passes to 08/8
Otherwise, control returns
operator

detected

ERROR
are

If neither the

Mode)

BATCH
to

another command

the

control
option is selected,
that each job can be
executed.
decoder
the
command
to
allow

string.

RESPONDING TO USER REQUESTS

has the capability of communicating with the operator via the
This control command is passed to 08/8 BATCH for
control card.
When BATCH finds a $MSG command, it
processing during job execution.
the console terminal's
temporarily halts
job processing,
operates
signalling device, prints the user's message at the console terminal,
then waits for the operator to respond.
Job processing is resumed by
typing any character on the terminal's keyboard.

The

user

$MSG

5.5

TERMINATING

BATCH

JOB

EXECUTION

terminate.MSBATCH or 08/8 BATCH processing by
typing
This is accomplished by depressing
console terminal.
the CTRL key while striking the C key.
MSBATCH
causes
to
CTRL/C
return control to the 08/8 Keyboard Monitor.

The

operator

CTRL/C

5.6

can

the

ERROR MESSAGES

MSBATCH, 08/8 BATCH and the other 08/8 system programs

perform

error

and reporting to facilitate rapid job processing.
Operating
detected by 08/8 programs other than MSBATCH are
reported via

checking
errors

08/8
the

BATCH

08/8

appropriate

in
the
Handbook

recovery

Refer to
job output.
for
descriptions of

procedures.

5-5

the applicable sections of
these
and
the
messages

Errors

reported by

errors.

User

are

reported

MSBATCH

errors

the

error

messages.

user

preparing
Table

2-1

user's
job output.
this
of
type.
messages

MSBATCH

5-1

Table

Table
MSBATCH

Operator

operating procedures

output device.

Operator

errors
a

each

error
describes
result from either faulty

with

of two types:
from mistakes in

are

result

lists

and

operator

job

deck

error

hardware
and

lists

and
and

messages

problems

describes these

5-1
Error

Messages

Meaning

Message
"BATCH.SV" NOT FOUND ON SYS:-

vMSBATCH has created an output batch

CAN'T CHAIN

stream file, but in
attempting to
to 08/8 BATCH, it discovered
chain
file
the
BATCH.SV
that
(which
was
not
contains
BATCH)
OS/8
device
the
on
resident
syStem
If
BATCH.SV is on another
(SYS:).
device, the operator can run OS/8
BATCH
from that device and use the
file
created
batch
stream
by
For example,
for
MSBATCH
input.
the
DTAl
and
if BATCH resides on
MSBATCH batch stream file was named
the
was
on
and
RUN.01
system
device, the operator could type:

.RUN DTAl:BATCH

*RUN.01(options)
CAN'T CLOSE FILE

While
close

MSBATCH

was

attempting

file
(tape or
that
the
it
discovered
disk),
output device:
the

output

switched to WRITE LOCK

(or

was

PROTECT),
generated

The

operator should:

1.
2.

the error condition,
reload the batch deck into
the
card reader,
run
MSBATCH
and
the
repeat

«f

correct

0W-

hardware

error.

Table
MSBATCH

5-1

(Cont.)

Operator Error Messages

Meaning

Message
CAN'T ENTER FILE

While
'

attempting

MSBATCH
was
the
output

file
(tape or
it
discovered
the
that
output device:
open

disk),
1.

was

switched to WRITE LOCK

(or

PROTECT),
2.
3.

had

The

operator should:

1.
2.

correct

full

generated

directory,
hardware

the

error.

error,

the
re_load the deck into
reader,
run
MSBATCH
and
repeat

card

the

Operation.
CAN'T FETCH DEVICE HANDLER

MSBATCH

attempted

load

device

handler
that
was
not resident on
This
the
(SYS:).
system. device
the
of the 08/8
that
means
copy
the
system
system that resides on

device

is defective.

The

operator should:

install

the
reload the deck

system

new

onto

copy

the

system device,
into

the

card

repeat

the

reader,
3.

run

MSBATCH

and

operation.
CARD

TYPE

SPACE

READER BACKWARDS:
TO CONTINUE.

The operator has placed one
cards in the reader in the

direction

upside

down.

reverse

The

operator should:
1.
2.

the offending card,
place it in the reader's
input
hopper
correctly at the bottom
the
of
deck
in
the
(i.e.,
position of the next card to be
read),

the
SPACE
bar
on
the
press
console
terminal's keyboard to

remove

resume

5-7

operation.

Table

5-1

(Cont.)

Messages

MSBATCH Operator Error

Meaning

Message
=;—

nnnn.

CARDS

ERROR

MSBATCH

(nnnn)

detected
that

number of

were

cards

incorrectly
is
printed

This message
end
MSBATCH
of
every
This is
due
user
to
Operation.
in marking the cards.
The
errors
indicates
user's
output
listing
which
cards
were in error so that
user
can
and
the
correct
them
resubmit
The occurrence of
them.
error cards
does. not
affect
the
in
of
other
the
execution
jobs
marked.
at
the

batch

FILE

TOO

stream.

output file exceeds the
available on the device (tape
disk). The operator should:

-The MSBATCH

BIG

space
or

use

another device

delete
PIP

some

(D and

mount

device)

(tape

tape

new

files

the

with

option switches),

reload the deck

the

card

repeat

the

into

reader,
3.

run

MSBATCH

and

operation.
LOAD

CARDS

OR TYPE

out
of
has
run
reader
more cards
in the
Place
on
reader, then type any character
the
console terminal's keyboard to
If
there
continue the operation.

The

card
cards.

are

cards, type

CTRL

This
this
to
MSBATCH.
is
not output if the last
message
card in the deck is an end of
file
card (see 5.2).

signify

NO
.

OUTPUT

FILE

SPECIFIED

The

an
operator neglected to enter
file
output
specification
to
the
Command
(dev:filnam.ex)

Decode; Ehilfi initializing MSBATCH:

Table
MSBATCH

Message
OUTPUT

ERROR

5-1

Operator

(Cont.)
Error

Messages

Meaning
While
write

disk),

MSBATCH

was

attempting
(tape

output file

‘the

discovered

that

to
or

the

output device:
switched to WRITE LOCK

was

PROTECT),
generated

hardware

(or

error.

The operator should:

1.
2.

the error,
reload the deck into
correct

the

card

repeat

the

reader,
3.

run

MSBATCH

operation.

5-9

and

APPENDIX A
GLOSSARY OF TERMS

BASIC

Card

card

A mark

sense

BASIC

language

that

statement

with

is
preprinted
keywords.

of MSBATCH that permits continuous
processing of a single job or an
under
the
of
accumulated
group
jobs
Program
supervision of a computer operator.
input normally obtained from the terminal's
deck.
keyboard is obtained from a data
terminal's
the
to
Output normally directed
printer is directed to the listing device.

facility
sequential

Batch Mode

Batch Stream

The
and

control
commands,
sequence of
keywords
data that comprise the job or jobs to be

processed.
Control Card

A mark

sense

card that

MSBATCH
control
column 1. Control

of
one
the
contained in card
used
to
direct

specifies

commands
cards are

job processing.
Control

Command

A control command is a
mnemonic
used
to
direct
the operations

instruction

performed by

control
The first character of any
MSBATCH.
is
a
command
dollar
mnemonic
sign ($). A
control command is specified by
marking the
appropriate box in card column 1.
Data Card

which
data card is a mark
sense
card
on
is
entered in columns 9 through
information

40
Data

Deck

only.

A group

of data cards

treated

entity.
FORTRAN

Card

A mark

FORTRAN

sense

card

keywords.

that

preprinted

with

facility of MSBATCH similar to Batch Mode
that
permits -program data to be input from
terminal
the console
keyboard rather than
data
and
the
batch
from
stream,
program
output to be directed to the console terminal'
printer rather than to the line printer.

Interactive Batch Mode

Job

job is a task or set of tasks that are
as a group for MSBATCH processing
considered
that
A job consists of all cards
purposes.
a
follow
$JOB control card up to either the
next SJOB control card or the physical end of
the batch stream.

Output

record
of
sequential
processing
a
The job
associated
with
specific
job.
and
output is produced on the listing device
consists
an
of
identifying header line
followed by a body of text that can include:

The

Control

commands

(and internally

generated

monitor commands),

Keyword

Compilation listings,

Program generated text, and

Error messages.

keyword
preprinted

Device

the

mnemonic
as
language
field of a mark
keyword

card.

sense

Listing

is
in

The

Batch Mode output device (either
a
line
or the console terminal,
depending on
hardWare configuration) that prints
a
job's

printer

output.
PIP

Mode

of MSBATCH that permits input from
reader
to be directed to any 08/8
Control cards, program cards
output device.
and data cards are interpreted accordingly.

facility

its

Program Card

A program
a

Program Deck

card

language

A group

single

card is a mark sense card
statement is specified.y

of
program
program.

cards

that

which

comprise

APPENDIX B
HOW TO MARK CARDS

B.l

INTRODUCTION

statements
Mark Sense Batch accepts both control commands and program
from specially formatted FORTRAN or BASIC Mark sense cards provided by
small
is
Each
card
preprinted with 40 columns of
Digital.
The column number is printed at the bottom of the
rectangular boxes.
card below each column.
Figures B-1 and B-2 illustrate FORTRAN and
BASIC

cards.

DWJLQUQDBDDDWDDDDDDC
infimnnmjDaJQBQLUaa
"Lillg
JTEUDDDJUDTDDEDEDEDDEEEBC
mm

Ejmwm gr‘EmwfifidtUMMHMMUUUUUUJMMMMUUUMUUL CORP.

HHUHUEEM‘iESinDWDlBuEEIBDIVEEEIIIIIIIIIE
EQUIPMENY
.qumtg:Gm5mnmgganummuuuuamanamamuuunuaE
{HWWEFEJQEWE’WIQlelllflllllllllllllllE DIGITAL

FOR‘I’RAN
liLEufixgflwgflOQEIEQQHQQEQQQEQEEQKEEEfifliE
inmagfasgnawgmaaanuumnpmamannlumaanaalg
anamvwmag.@mmnnmugmagnaunwmnmumnnm,
man W533xH.mwmqMllunmmunuunmmwmnnnllla
N'<
[WFWWL9P
AJQLU1DLIIDDMHQDIIE
m

.—

1—..

RUB

2'3 |4 .5 |5 '7 la '9 |10|n|12|'13. 14'lLS'lbIW'IB'19'20'21'22'23l26l25I26l27'28l29'30'31'32'33'34'35'36'37'38'39 40'

Figure

B-l

FORTRAN

Card

PDP

I’flflflwflflflwflqfl“mmmflflflflflflflflFflflflflflI
HEIDIWIgW
CWP.
(D

UHQIUVUUIMCMUMUbeDQMMUQUJQL

EIIILIQUEUIEIUEIIEEIQEQEIEEEEIEEEIIEIII

EQJIPMENT

EEII3IIBEIBIQQIIQQIQIJQEIEIQUEEDIIIIEEE
EEEEAWIMIEIL;Q§DIE§CK
IIQIIIE DIGITAL

DEHUIIU
BASIC
IUIIS”9mEIQQ&?IHQZQ%EBQQD%E“QQIQQQEKEDE
UIIIIID”
flEEEbfifilIIQBIL@EII‘EQQEHIQQMQE
”CIIIWINxflfldflflflflIIEEMLIEHIJEIQIQIQIQIIE
POP

DIIEWMIDIEIIDIIEBWIEI
IIDUDIIBIIIIDIIE
EEEEWWIUDUDQIUUUDTVITWUMUTUUDHIIIIIE
II
I2 I3 I4

6I7 Is I9 IwInInInIMIquIvIwIIwImImInInIquIuIvaIanImInInIquIuIyIuI w IwI

Figure

8-2

BASIC

Card

card
and control commands are entered onto the
by
2 is
with an ordinary soft-lead pencil (number
boxes
Each
box
ideal). DO NOT USE A BALL POINT PEN OR A FELT TIP MARKER.
a
marked
with
either vertically or
is
drawn
single heavy line,
It is not necessary to
fill
the
entire
Avoid
box.
diagonally.
making stray marks as MSBATCH reads all marks on the card, whether or
not they occur inside a box.
Stray marks cause MSBATCH to misread the
When
two
or more vertically adjacent boxes are to be marked,
card.
stroke.
they can be marked with a single vertical
Figure 3-3
illustrates examples of properly marked cards.

Program

marking

statements

these

fl‘mh

.jfl'WIH>I1L1M10nuau

I“&%EW.DDU 3LDUDJDDUUDDUDDDDDDDDDDDDDC
W

MEIUDDDDDDUUEDEUUDC
UFDHWQHVDUI
J1uvx?“ma““E?“WIEIII?H“IIIIE
QWIMIJIL‘LEIIIWEmIImLfiEEMQflfitIl' CORP.
I!“ESEIWEIEIIEIIIEIIIIIIIE
gmjfifl
‘

;ZIQQEIZ
“JDUDE: W

EQUIPMENY
ICUIEQQQQMDUUIMILIIIIIIIIIIIIE
_EEECFWIMEILDTHQIUBDHEIDIIIIQIIIQIIIIIDC DIGITAL
“

HIBEQEL
QIEDIIjm“°’
.-

FORTRAN
PDP

IMIEEQwflfi%_Efl®flflflflflfl®mflflfiflflflfllflflflflflflfl
BWWWFQQHEQmII“FDDIIIIEEIHHIINTQEIWIEII
flDMUP?m*”mdU
IIDIIIDUWUIUDUMHRIIUIIII
ImInInInImIbuILwIwIwI

2I3 I4

7Ia I9

wImImInInIquIuIvIquIwImInInIquIuIvIqule

Figure

3-3

Properly marked Cards

B-Z

I‘10ILfrlAunBVIMh

D DDWDDDDDDDDHHDWHUDDDDDDDDDDC
Wffm EDDJDDUDWDEDDDDBDEEEDDEEDEDC
(\<

<\<

<I<

<\<\<\<\

i
<\<\"<\'<\"1<\<\(\<\<‘\"<\<\<\Ir<—I]<\<\<\l<\<
000!0030000OOOOOOOOOOOWOOOOOOO

>>>>>

I'pr

::::::

>>>>>>>>>>>>>>>>>>>>>

IAIAzAI

IHJJE&&&$Rflgfifluflmhmm&mmwm&fiw9I

é_

aaccaaggb':g’mUIIIIFIIIIIIIIIIC

C XP

EQJIPMENT

EEBFWEIEBLD‘IEIIQ‘DIEIEIIIEIEEE
fifi“@DEjIWWDUWEEE"JEE‘IUEIEEBQEBIE DIGITAL

“JEDW

53544
"HHIE BASIC
Uuu!’fl”?IEQBEEQEEEQEQEEEQHIIIQW
QLfi
WflEBDb
IESEEI@QQQQQQQQUDDEIEHIIIIa
'QEE
DEE,
IEfiEEEWHmfflfliflflfllflflfliflflfl
b

r——']

ajuLsJ
.1:
MES

.wx
MMW
I
WIDEWBIBDWUDDVBIE
IMUHBEEWQBIIIIE
‘

.
IY

”__-‘

II I2I3 I4 Is Io I7Ie I9 InI nIIzInI

jIIthI

n‘v

ryu

IquIwIwI wImImInInIuIBIuIvIuInImImInIquIquIwaIwIwI

H'ICNVI

MflEuvIaIsloMMfiHAITIIlehkMM‘LIGI

EDDDDDWDEDDDIDIBIDDIDDDIIDDDDDC
.DFIEDUDDQDIDMEDEDIDDBEEDDDDDDBE

f**PPHmflflflFflflflflflflflfiflfiflflflflflflflflflflf
‘WMIJMUWMQNMHMIMMHQUQUHQUUQMUQE

C RP.

ElBEEUULEQDIIEDIEQDIIIIIIIIIIE
.EEIEF1aaQIIflEIIEIQIDIIEEEIIEIIEC
'iEEM~dPDQIUSWEDEIIWEIIIIDIDIIIE DIGITAL

EQJIPMENT

thflmQEWEMQQQQEIQ
@&&EQEEKHW@HEWHHE BASIC
”@EIBU’QTDIHQB.EIUIIDIII
fiwaHQD
PDP

IIEQIIIEIEEEEEEQEQDIIIIIIIDIIU
IWWBIEDWPBBHIEBEHGIBBEHIHIEHB

II I2 I3 I4 Is Io I7 Ia I9

ImeInIanI

IquInImI wImImInInIuIquIvInIvIwImInInIquIuIvIaI ”I wI

Figure 3-3 (Cont).
Properly Marked Cards

NOTE

marking cards, it is often helpful
the line being entered in the
space provided at the top of the card.

When
to

write

CARD

B.2

FIELDS

fields:
or
areas
Both FORTRAN and BASIC cards are divided into four
the
number
the
statement
field,
command
keyword
control
the
field,
is
field
Each
separated from an
field, and the character field.
in
shown
as
vertical
a
thick
field
Figure B-4.
line,
by
adjacent
II

~fiQ®QIIIDDDD QQQQQQQQQDQQQQQQDQQQQDQQQQE

QQQQQQIOmfimmnKmamIfiIfiQQQQnImmr
one
.Egtr‘wIDDDBWDWQBDEUJDEEDEBEDEDBDDDBEDE
EQQQIIII“IIIQIUQIJIQQQQ‘QQQIJIQQQQQIQQL
EBEHEWO“BIIUIE:ggfl’QQEQEIDIIQQEIIIIIIIC
IIIIIImIQIQLIQQIIQIIIIIQIQIQQIQIIIQQIQE EQJIPMENT
'I»

CORP.

DIGITAL
IEUEHM”‘IgmflfiflfiQgQJQESULLIj‘IIIIUIEUIIE
DEIEEEIIIWQQQQQQQQQQWWQQLQIIQIQQQIIQIE BASIC
QQQQQQQIIIII
QEEE6”“HHIIQHHSIEIDQEHEEI
dlflllfimflflflflflflbmflflflflflwblIQQQIQQIIQIIII
PDP

DIIEWMIDEEIWDDIEIUIQQQQQQQQQIQIIIIQQ
IUDWHUBuWBEUDEUEHPUMHIDBWIIIII

IIQQIQIIIfI

8|9|IO|IIIY2|13|MI|15I16|I7IIG I9|20|2I|22|23|24I25|2¢|27|2a|29|3o|31|32|33|34I35I3¢I37I30I 39I 40'

II I2

Control
Command
Field

Statement
No.

Field

Character
Field

Keyword
Field

Figure
Card Field

8-4

Layout

Notice that the cards are identical except for the keyword field which
In addition,
either
BASIC
or FORTRAN statement keywords.
contains
the SBAS control command appears in the control command field of BASIC
cards
while the $FORT and $LOAD control commands appear in this field
on

FORTRAN

B.2.l

cards.-

Control Command Field

Each of the MSBATCH control commands is printed in one of the boxes in
the
When a box in this field is marked, the
control
command field.
card is called a batch control or job
control
Batch
control
card.
cards
must
be
marked
with the appropriate command in column 1. The
character field contains command operands.
The keyword and
statement
number fields must not be marked.

Either FORTRAN or BASIC cards can be used as batch control cards since
is
the
this. field
same on both cards except for the $FORT and $BAS
Marking more than
commands.
Only one box in column 1 may be marked.
Figure 3-5 shows the
one box or marking a blank box causes an error.
control command field as it appears on FORTRAN and BASIC cards.

Never

Mark

these

boxes

FORTRAN

BASIC

Card

Figure

Card

3-5

Control Command Field

B.2.2

Statement/Line

Number Field

each
number field consists of five columns,
containing
numbered from 0 through 9. Either FORTRAN statement numbers
To
enter
a
or
BASIC
line
are
marked
in
this
numbers
field.
statement/line number on a card, mark the box in each column that
marked
is
not
corresponds to the desired digit.
Any column that is
ignored.
Only one of the boxes corresponding to the digits 0-9
of
should be marked in any column.
shows
several
,ways
Figure B-6
entering the number 15.

The

ten

statement

boxes

;*Tidfi

JDE”E[

JLJLJJP‘JFJJJ:
1C

_l. 91‘!A

0':

TE"

ré‘.

ll—

Jl§1«l!«’l'lJ-§HJ«U

“"1"”

THTJI
0

:WMLJPJ
{Baggif

g1 21 [If 2H
[JEJ
L”

JEEé:
“E

-J
BEE

gJJWHP5
_

2'3'4'5'6'

TM .‘1
6|

2| I

Figure 3-6
Statement/Line Number Field
B.2.3

Keyword Field

_Each box in this field Contains either a BASIC or a FORTRAN
keyword,
To select a keyword, mark the box that
depending on the card type.
contains the desired
keyword. Mark only one box in this
Since
the
BASIC card is used with several dialects of BASIC,
the
the

keywords on the BASIC card apply to 08/8 BASIC.
Figure
05/8 BASIC statements in the unshaded areas of the field.

|7|a .9

Figure
BASIC

B-7

Keyword Field

field.

not all
B-7 shows

IV.
OS/8 FORTRAN
keywords on the FORTRAN card can be used with
OS/8 FORTRAN II is to be used, only those statement keywords shown
be
in the unshaded areas of Figure B-8 can
Legal 08/8
employed.
BASIC
FORTRAN language keywords not shown in this field can
or
OS/8
usually be entered in the character field (see 3.2.4).

All
If

Figure 3-8
Keyword Field

FORTRAN

Character Field

B.2.4
The

character

field is

used to

control

specify:
commands

arguments

arguments to language keywords

language keywords in addition
keyword field 1.

language keywords

program data

08/8 keyboard

not

commands

MSBATCH

the

appearing in

keyword selected in

the

keyword field(l).

(see Appendix E)

This field is subdivided into two
subfields,
separated by a
horizontal line:
the zone subfield and the character subfield.
The boxes

in columns

the

heavy

all
the
39 are identical and
contain
and most of the punctuation characters.
Boxes
additional punctuation and special characters.
9

through

alphanumeric characters
in

column

(1)

Keywords

contain

entered in this

field must be

character.

B-7

preceded by

backslash

(\)

.DDDLDDWDDDDUDDEWEDDBDDDDDDDDDD
UWDJEEDDDDBDDDDDBDBEEDDEDEDDBE

Zone

Subfield

flfiflbflflflflflflf
l>><\<'ti—“flflflpflWWEnflTT
_1
“.0:
SHWUSEELWWUH“'EJM1LQMMMLMBMMLML
CORP.
050;
‘

WWWEIIIHIIIL
@LETWEEEEI
Emwfifl
immeDmflflmfllflllllQIIIIIIIIIDQIL
HIDIDDIIIDTIE DUGiTAL

i”
EQJWMENT
< :Kwflflgfiogfiflflflflflfllflfl
MEQHEéQEL
.LHSQZLUEBZLLLLEQRHEll

Character

Subfield

.PQWEQELQUIQLLEEmghfiwufflgflEfllflflEE
mxxfiwgflmLIDQEBBSEWEQHHBImflflfly

FORTRAN

POP

DWEII"EUDIE WHEIEIIDIHIIDI
ALLMM
flJHBEFWUJMHIDEQQEHJQDIIUDE
-

I9 I In In ”"4 asImeIwa IwIzoI'nI22I23I24I25I2¢I27I2¢I29I30I31I32I33I34|35|3¢|37|3o|39|ao|

Figure B-9
Character Field

3.2.4.1

Marking

the

Alphabetic

Characters

and Dollar

($)

Sign

or
the
dollar
($)
sign
any of the alphabetic characters
two boxes must be marked:
a character box and a zone box.
First mark the box containing the desired character.
Then
determine
the
position of that character in its box (i.e., top-left, middle,
or
that
bottom)
middle,
bottom-right), and mark the zone box (top,
corresponds to the selected character's position.
Figure 3-10 shows
all the characters that can be selected this way.

select

character,

319w

.B<;QLEI=G;5K£:f!$
TL_JJDL

aflg~tgzgqg{_7m;gnfia

LfluituwhfllbuflfiDQDUDL

5ULJJJrTJLrJJLJHKLJJWJLLMRJJEJJELULLJLLJEH:
TT<

']<\

W{<\T\l<'fl.<\<\fi‘<\

U<\

<\<“(TX(“TRJZKZUIW

”VICKI“
f
iéflflflfiVflLfflfflLfidiflrUfl
-=%@®1WFEJ
‘LLugfiquwamwgaamgmmhw aflk JamL CORP.
_ 1L.
ErJTwfiiflnJEQDJ
quwfi meWEmemtb
Jj1‘ uwdwgszFgJ_
DEJUJQJQFJEJU EQUIPMENT
ESTWQLEHIwLLdELU
JWMLJF‘IEJ'fiuLJW'CTJLLJLJZLJELULLJLI:[HJYJJLNJE DBIAGSITIACL
“QQWWWDEEQLLLLLmqwflflwflflflméflmEEDBL
bamLJZ
HEELJJLJJPLJLIJLJJLHJL°
flLEHMZHLESQEL
“f'EEFJLJ
flLflLJLJQJLJ[J[J[]LJLJ£JL.
_§J:é<J‘”E$E¢;flfifl§&§ifJffiFt
JLJLMLJllfHHLJEJVJEJEJ[J[J[
1%?
["0

1:.

PDP

’3§§

XEQT“[JLFZT[JLJ

ULUUUEéLWDHSjMJWWMHUWWWDHJUE

aI9I‘0InI12I13I14I15I1¢qI I18'19'20'21'22'23'24I25I26'27'28I29'30I31I32I33l34|35l36'37l38'39'40I

Figure B-lO
Selecting Alphabetic Characters and the

Dollar

Sign Symbol

B.2.4.2

the

Marking

The
the

technique
special
Figure 3-11.

Symbols:

and

;

used
used for alphabetic characters is also
and ; in the zone field,
characters
>,
<,

JAC)!‘

to
as

select
shown in

‘J

“J

L.J
L__LC
‘WMPUF”F._LVU”“J
...J
J VJ
”JVJ'J
rflfj’J
H
C
MMUMJL‘UJU
JLJLJU
J
[Jm
JLJH LJ_-JLLl
(3312)“<’\IP>
‘>\|{<>\'
<
>\;
If
\;<;L\‘<\P\
5].
r—Ifilirj
<\“{:\
0v
fi
0110\H: ‘6‘—JV
Llo>\j;;J_J
'<> IOJo
“““J7W""
II
011030 Ho 10 HE);JJ'o {jo Jo Lia
A:I'A:;A fhflMJMJA'%‘AIAwfi L
ADJ] 4mg
mP
O
EL: "w B‘IJR“@flfl@mwflfl@&bb '”JLJLLUL CORP.
‘LLCJ‘ CL_
"JJ
LFE {YM‘I L__JJ23L_JLJ' L2H
@J Fi! JWDWWMWWHLEEIEFDUHEI
F2__J
EE
1—27“L:
JWLQ
WE
TH
~10
F1”
FDEELLIUII E
JILJJ
Jr]_j3
3HI|L_I3 LJI
L? MJQfl
“LU
hL
_J
31")
1K1.)
;
C
I
"
~
JI
mom—Jr?
:LJLJ4JLUQDMJUHHHHBEIIIL DIGITAL
LJLL'LLLJL I; TILL
“-78 tlr—H—
5N0
EWQQL/ :ONM
4150: TMQEEE
E BASIC
’6" Li" 003%
GEL3J7“
{o
E: PDP
WEE
:3 «AH»wa—T‘:‘
_. ‘.—— TEEJJLEJJUPEUBEUQEE
QT- Rh? ?L_»— r-r-‘v _._
”MJQJZLUflJ
JLJJJEJEJESEJLJE[JLJEJ[J[JLJEJ E
€<_. J ~.-J
‘VMHWVWMLL,
L r—“S
—1
MW EfiJ’WRLJDJJUBJJMJUI [3
JJJ
T‘Y
”2 ‘V—Y r—Irz
3
Z]?JJLJLJJHJLJEJ
EN JMNFQM‘WJHJLJHHUUIDI
'9 lw'nH'nlDIM'Blb'WIBI s|2o|21|22|23|24|25|26|27|28|29|30|31.32|33|34|35|3¢|37I313]:«7 le
I

L‘._JL_JL'

’

“0

JT0

:J?Jm.

‘

JLJL‘L

:qA:

’

Jgflj a“

mi 0 lo

2F2F

F22F2F

3331

EQUIPMENY

3131313

1313

JQLIUEQEEKKQHI

‘

UJHUJQJHWJ

'L’

L'.

(I)

igyfiJEZHfirL:zlgdJJJQB
3. [

~.—-

Jo Jo

‘71”Jr

J-

EJEJ
\I !C

Figure B-ll
Selecting

B.2.4.3

the Characters:

Marking Numbers, Period,

and

;

and Comma

To select the numeric characters, period (.),
mark
the
box
containing the character.

and

comma

3-12

Figure

(I) I

simply

shows these

characters.
Ii

JJJ

Jé!

11J

GL5

J3!

I‘IJ

J57

IQI

J7J

JEI

I7J

iVBDDWDDDDDDDDDDDDDDGDDDDDDDDDDDE

.JDEDDDEEDDBDDDDBUBUDBDEEEBBDDEDC
Jfififlmmmfl“‘

“

puflflflflflflflflflflflflflr

-“JJL“QLUUJLUUHUDD”UJUUULQLJJMUML CORP.
aJBBQEDWJELJEIEIIEIIIIIIIIIIIIID
JJJ JIQIIIJIIUIIIEIJDJIJIJIJJE EQJIPMENT
fljfl
,

JmfliBBQIIDIIDIBJQIIIQIQQQIIIIQ DIGITAL

-EmJEQILLJEWQQE@fiJflQEQNW§EEENHNWo
REELTBJEQJLJJJJIJwflfllflfllllll FORTRAN
JnngJJJ
IJQJWQEJDJIJHIIJIIIIII
IJIJJELLIIIBUBEUJIQIIJUIIIIIIIE

JLUJJHHJHUQHHFUJHQIIIPMHHQDIIIDJ

'9 lscln |J2|u|u| uln'wpa|w|20|2s|22|23|24|25|2¢|27|2s|29|30|31I32|3s|salas|3¢|37|3a|39|40|

Figure B-lZ

Selecting Numbers, Period and Comma

Br9

3.2.4.4

Marking Special Characters

select the characters located in the
right corner of the
upper
box
the
mark
containing the desired character and all zone
be
can
boxes
zone
the
all
boxes as shown in Figure 3-13 (marking
accomplished with a single vertical stroke).
To

boxes,

LLULEWUUUWUL
LLLLLLLLLLLLLLLL

_L_

L - . ,_. -;
i. .
.

.i..

“I"

“L‘LHL‘LZLLLL’LLLLL:

1‘;
LAB laLA L8
L‘LimCLlC
AaéLLAB‘lrLA—TLALCLLCLCLLC‘
CLLLLCLCLLBLIAHALLLL_CLL‘_CLL1£LU_CLLL_LL_ CORP
LLLLLEE ‘ULCLLL

35.} EEWLEDEW
33
DunggflfiiflUafidlalflr

5L“ LLLLHLLLLL'LLLLLLLLIE EQUIPMENT
ELLEILLLLUTLLLLLLLLLLLLLL
DIGITAL
_; DPLLULIEQLLDLLLLELZLELLLLLLLL
V

LLLLijLLLLLL—LLBLLLLL

IDLLLLLLLL SELLIL’LL‘LLLLLLLL‘LLELLMLLLLLL‘LULLLWLLIL'LWE BASIC
LLULLLL LLZ°LLLZLLLLELiéLLLL9LL°L L°LLLL3LLLLL‘E’LLLLLL‘LLSLLLLLLLL‘ PD?
3meLLLSL‘ZLLLLHLLLLLLSSLL‘L LZ‘LLLL‘ELLLLLLLL‘L‘LLLLLLLLL‘LELL;
“LLLLLLLLLLLLZLL’LLLLVLLLLL
LLLLLLLLLLLLLLLO"
LZLLLLLLLLLLL” LJELLLLLLCLLL'YLLLLLL‘LLLLLLLLLLLLLLLLLL
I9

IIOIH'12l 3'14I15'16'L17'l8'19'20'2)I22|23l2LFLLLLLLLLLLLLLLL
4'25'26'27'28'29'30JI3)I32I33'34I35'36'37l38'39'40
Figure 3-13
Selecting Special Characters

mark
the
select one of the special characters in column 40, first
box
Then, if the character is in
containing the desired character.
the
If
the top half of its box, mark the top and middle zone boxes.
selected
is
character
in the lower half of its box, mark the middle
and lower zone boxes.C
Though these characters appear only in column
40, they can be marked in bny column of the operand field, as shown in
Figure B-l4. Simply use column 40 as a template.
To

Character

rubout)
described

positions
and

CON

in'B.3

the

shaded

(for
continue)
(below).

of Figure B-14 marked RUB
(for
perform special functions that are

area

11,11

Nfl

1111'!

V%1I&Jl[1

m”

H7IMO.

V‘

@”|I*1

,IDDDDD EDD EDD UUDUUUD EDD EDD"
I
fl
i
'“DU HE E
”’

’

Ill—J:

‘,‘1rI“.‘,“.‘ ‘,‘ET‘.‘ 1‘

‘.
‘.‘ 2‘
llo llo <mx‘inaflar‘alflala 2.2A8. at A8:
A8. A3.
AB: A3: A3: A3: A8: A3:
Asa A3:
A8: IABI
E1c1c1c1__g1_c_1c
.a'
1c'1c1c1c1c1c1c1c1c1chJ
3"1C'L91C‘
09"6—270; 090901109
a
é
0"D.W.EEEEEEEaEE
.aaaawaaaggmamggla
E0

p9|09

O
:
I

CORP.

emumem

EEflflfl@HEEEHEEEHEEEEEEHEEEEHEHEEE
VEEEEEEWEHHEEEHHEHEEHEIHHIEIIEEE cam
%.%%%%%%@
1mQQQQQmEmmmeEQmflgrsrx
“W“”WWW”WWWWWWMWWWQWWIQEHIIIHIH
E49: 6°11 S FORTRAN
~IQQ®Q§IQL§M¢RI§3
(1wa
ngflfljmfln 61'6R
“”’“W”WWEWEWWWUE@I@WWWEEIEHI’IQ
Naflflfimflmflflflflwimmwwiminimaliimi»ii
““““W“““““WEIEIEWEIIIIIIHIHHHEE
TMQEEEEwII,.
m9m®x..%xkfi€.mmx.11
”V””VVWWWWMEBDI“EMEIIIIEWIHIEMWE
92
95 9519319.?! 9.2.3 93.5 9.2.1 92$ 9z 92 92192;. 9.29J9zsg213 IE3]...
93
abjgggfijggfl
”“““m““mfllflflflflflflflfll““flWfl“““”"“
31313131313131313

r41141'414141414141414

QQQ.Q-'QQOQQ

3131313

414L4141414L4141

01.000

1411414141141414141

411

1313131

0
6R

Q01
R

6!!

|9|m|n|n|n|u|u|m|w|mlw'mln|n|n|u|n|u|v|u|n|w|m|n|n|u|n|u|v|u|n|w|

B-l4
Characters

Figure

Selecting Special

3.3

in Card Column

CONTINUATION CARDS

the bottom two boxes in any column specifies a continuation of
or
command
line
onto the
statement
following card.
in
card
continuation) -appear
(for
Though the characters CON
only
column
40, the two bottom boxes in any column between 9 and 40 can be
specification
Any marked columns that follow a continuation
marked.
on
that
card
are
Figure 3-15 shows an example of card
ignored.

Marking
the

current

continuation.

First Card

I17fld2$J

13$

1k_wm

KJA

Jfigw
JuJ JCULflflflflflflfi
w

l1—

WDTJQEEJ

IELENEFJ.UDW
NIUFN
ED7
\lf<\:(\“<>\_J
JHOJOHJ
on
LHMMUT;>[;> < DJJDUFJUJUthgJDLQUQQLUUPUL
00‘

£50

Pam

0,0

L<\J<\

______

<>\<\<\

<\<>\']<\<\<\[<\
0

JJCJELLCfEJLE’c Lsé'JABchLBc CORP.
LCJABC‘QJLLJLCJ‘JLJLCJJC
EJZJID WmerCJ‘JLgJJLJULJCJ LBCJ1 L__:C_JJ_CJLL§JCd
EJE
:EaaaawmaflEEEEEEEE
WWIEEDIEEIE
JBTTLTWmUJEUflHHUWUQIEE DIGITAL
EHEEBI QXHEEQEWQUEMLLEIQMJLQWWJHHQIEEIC BASIC
:40
'Fgflzo
“ELIE Rim“ “JEWEL,:QBJEIJ
PQnfiPj‘
EJ
JLPJLJL
PD?
7MB. "iiim‘JJFJELJLJLJJJE'xIEJLUWCJEJEJEJ7EL7UJLSZJZJJSJLEUJELJEJJLJJJLJLJLJ
L’LJJLJJJLJLLJZWxJLJLJLJLJL—JLZ
'“LEE?“mnDUDUJJDUUDJDJIBL UKULHMQHQQQQEIE
IJ I2 I3
osI7I I9 IJoI
J9I20I21|22I23|24I25
27|2a|29|3o|3J '32'33'34'35'36'37'38'39'40
JJI12IJ3I14IJ5II¢IJ7IJaI

E“QEEQDEQIEIQQEEEE EQJIPMENT

‘JDWEIJMIEWEEELVEEQQEJCQMDJD
*TLEE4WEMEEIUEESE
6

QJEQRJEQRJFQF

JEHUUUUEEEQ

EIEEIIQQEQIIUUWLJUWHWLU“

continuation code

Continuation Card
ILEJ

JOJFJ

JfiJJONJT'JIJ NJ UmrJITJLIONJ

JLJJARJDJ

FmEI‘EJIIIDUDUDULDDEJDDDCDDDDIDDDDDDDDDDDD
W“IEW“““““1EEEC“<IEII“EIEIE§
'”
HIE'I
I IIIII I CmP.
II”“‘HII
c1L__JJr[L_J WC‘CICJCJCJCJCJCJ
J_C_J‘CL__C1C‘_IL1__J’1_1CJIQCI
o

"”

'WDJQEIIIEEQWEIWIEEJIIIIIIIIIIE
HEEEIQUIUQIIIEUIQDEBIEIIIEIEEL

EEEEE

EEEEE
EEEEEV

DIGITAL

WQHIWEEIEIIIIIC BASIC
IE®IQEQEU“”EQQILEQEWI@IIIIII POP

;m@EIQEWEEQQSITQQ
IIEUJDBEEDFHEIQQEIIHQQIHQIQQII
rVJIELIJEILJFJJJ[JTJ“JETJLJVJZ‘ZJJICJLJLJIIILJIIIII
EQUDII'JUHEDDULJUUWLUUUWIIDII
l5I6|7|8I9I?IOIHll?IJ3IMIJSII6'17IIB'19I20|2!'22'23'24'25'26'27I28'29I30I31[32'33I34'35I36'37I38'39'40'
“

III2'3'4

EQJIPMENT

AA.

Figure B-lS
Specifying Card Continuation

B-12

B.4

CORRECTING

ERRORS

RUB
MSBATCH's
cards are corrected either by using
marks.
incorrect
feature or by completely erasing the
Marking the bottom three boxes in any column causes MSBATCH to ignore
As
(rubout)
any other character previously seleCted in that column.
in
be
used
can
with the other characters in column 40, RUBout
any
column of the card simply by using column 40 as a template (see Figure

Incorrectly marked
(for

rubout)

B-16).
are
also be corrected by completely erasing the marks that
the
column can then be correctly marked.
Although more
risky than using the RUBout feature, erasing is often more convenient,
particularly when the error is in the middle of a fully marked card.
Wherever possible however, RUBout should be used
to
correct
errors,
rather than erasing.

Errors
in

can

error;

nfifidgfia5II135liPU
2

H"HEHS17

I01“

iRW’IBHOICNTI

UEEQEQ WDUDTDEDDIDDDIDDDUDDDDDDDDDDDDDC
&
ITEEEDEEED'EEIEWEEWUEEEIEEEEEEE

£§fifi
,O

‘

’

V;\FW: ; ;:J\€§& 5‘} 9 $15!? y’allllrltgll|||8l<’ililili'!‘

EZEE.LLSWQ"UE'EJEEEQMIEQEIQEIUIDIIIDI
.

r“

5] J 5!I

__,

Aflfifiiflmgfirfifilfifllfiafilllllmllfifififi CORP.

LOGICAL so so
f“

r“

r—1M

M/ M/

0j5

mqum
QJIUUDUfl3*mfli
'

w.
._

EQUIPMENT

'EDWELIEEIQIEIQIIQIIQBEHHQIIIIE
“WEMEEEEDJDUIIIEEEEEIQEEIIEEIIE DIGITAL
7M
,MN( M/[M/ 77M/f”7'“7'M/{71MIMM/HthN/m
MN! wt
MN M/
5N0 M/
so 5ND M/l M/ M/
OJLNqSQJSQJJSWOJS “sonsogsosponso 50 L1}:
M/‘MN/J 5N0 SN MN/ '50
JsNgs
@EfiflflES“J@EEHMWMDE'DEQBIIIIII“ FPOPORTRAN
LJ sufigjlsm
(EQDUEJEESJMHFWEJQD7

2|2|3 |4 |5 |5 |7~Ta I9 '10"

mpg] u|x5 |m|n7|ne| w|2o|2t|22|23|24|25|2¢|27|2a|29|3o|31'32 |33|34|35|3¢|37|30I39|40I

Figure 3-16
Correcting Errors with

B-l3

RUBout

APPENDIX C

CARD READER OPERATING

PROCEDURES

’

C.1

INTRODUCTION

This

appendix describes the operating procedures for the CM8F and CM8E
optical mark card readers.
Figures C-1 and C-2 show front views of
the

and CM8E

CMBF

card readers.

uses
M15
53,

‘

-5

$55
«if:a»? ?
WWW».
9

3*?

M.
~

‘

_
,

‘

Wmaemfiwz;
5.2.2:: %‘%:<2‘*:W*
25-:- W:

@fi wazxkgaxfiég,%~wwxgwm~
.k‘
w

Wmfiéfiéfitfiyfik
"we

‘

4N»

‘

"1“

3.621>“179m» y;
59%

wk.
:95
a; ‘31."kw

«a
»

.‘

WW 3.

“.05 km“

5'?«;a ’35:

7!‘1
5

r2.4!»
“

@335 .3

<5
1'55 5:43.55

:
'

‘5:"“e

5135%
W

'23"

if:

«M

93'"?:f-a, ”f:«a»:

$113:«3

w? ai: ’~‘

Vi?“

ivy”
s? ?34"
2:,

3;!»

Figure
CMBF Card

C-l
Reader

Figure
CM8E Card

C.2

CONTROL AND

C-2

Reader

INDICATORS

the
CMBF
card
reader
to
indicators used
operate
in Figure C-3 and listed in Tables C-1 and C-2. The
controls and indicators used to Operate the CM8E card reader are shown
in Figure C-4
and listed in Table C-3.

The

controls

system

The

are

items

and

shown

covered

in each table

Table C-l CM8F Front Control

are

Panel

(see Figure C-3)

Table

C-2

CM8F

Rear

Control Panel

(see Figure C-3)

listed below:

This control panel, located at
the upper left-hand corner
of
the
front
of
the_ reader,
contains
the
controls
and
indicators
used
for
normal
on-line/off-line operation of
athe-card reader.
This

panel, located at the upof
the
per right-hand corner
back
of
the
reader, is used
for
initial
of
the
setup
system
purposes.

and

for

maintenance

Table C-3

Control

CMBE

This control panel, located at
the lower edge of the front of
the
“contains
the
header,
used
indicators
controls and
for card reader operation.

Panel

(see Figure C-4)

POWER

CHECK

_-__.
_

PICK

:
I

.1
I
I

STACK
CHECK

|
l

OPPER

I 5M new

FRONT CONTROL PANE L

AC POWER SWITCH

SHUTDOWN

LAMP TEST

AUTO

MAN

. o

Q..:O:O.¢:¢§e
9‘ 9’
o o

o o

‘

s‘ § s’

vw‘

MODE

REMOTE

LOCAL

MW
REAR PANEL

Figure
CM8F Controls

C-3

and

Indicators

and to

power

from

that

this the and

that

the

and

depresingreader indicator depresing power indicates edges. indicates whenever causes operationindicator. indicates operation
failed station COMAND indicator.
i
n
d
i
c
a
t
o
r
R
E
S
E
T
power
light
light trailing CHECK
RESET
r
e
a
d
e
r
r
e
a
d
e
r
.
c
a
u
s
e
s
r
e
a
d
e
r
Function aplication ap liesasociated removes
c
o
n
d
i
t
i
o
n
,
r
e
a
d
e
r
i
n
d
i
c
a
t
o
r
i
n
d
i
c
a
t
o
r
l
e
a
d
i
n
g
Indicators Controls switch causes light. When switch reader.and Because eror indicator extinguishes When received controler. Stopsextinguishes
to

of ,

card

Table

Panel
Front

When

Controls
Type

CMBF

Indicator
or

alternate-actionpushbuton/indicator
switch

Control POWER

lit, al
is

may

read
jthis ust or

switch

stop

read READ

lit, to the

out. When the the

this the
lit, card into
card the card

light
white

indicator

CHECK

READ

PICK

lit, card

the

C-l

move after from

and

torn

READ is

card

= properly

and

that and

that

can

must

empty ful .

is is

the

the may

the

and

;

and

Controls

Table Panel
light
Front Type
w
h
i
t
e
CM8F

light

Indicator indicator

indicator

white

CHECK
Control STACK
or

CHECK

HOPER

has has

the

no it

the

C-l

the the

lights thereby stops stops
c
o
n
d
i
t
i
o
n
i
n
d
i
c
a
t
o
r
.
s
t
a
c
k
e
r
m
u
t
i
l
a
t
e
d
.
indicates badly Operationindicator. indicates hoper operator operation line, RESET then curentlyrbeeand. efect only
light card output reader RESET light stacker reader im ediately READY
card
o
p
e
r
a
t
i
o
n
this input output case, cor ect
this
Function lit,previous card lit, card depresed, reader station switch power,operation.
Indicators When seated therefore Stopsextinguishes When either that either manualybefore continue. When dropsextinguishingCard son read This system curent
not
was

(Cont.)

the

pushbuton/indicator

light)
(red

momentary switch
switch
STOP

out is

clears initial- lights signal eror PICK HOPER
logic. goes switch CHECK,
A

released, reader indicator controler. STOP whenever (READ CHECK,
R
E
S
E
T
that indicator lights
f
l
i
p
f
l
o
p
s
Function card
STACK
Indicators dWhepreesned eror izes Asociated indicate aplied RESET whenever depresedindicator CHECK,CHECK).
READY

and

the

and

the

the or

(Cont.)
C-l

and

Controls

Table Panel
Front

pushbuton/indicator

Type

to is

The

light)
(gre n

momentary switch

CM8F

Indicator

f—

switch

Control RESET

C-6

al the

whenhop er

cards

READ the RESET front

operates blower whenever emptied. depresed. RESET on-line
restarts
front faulty. operation
either

control

iluminates

the

not

any

blower hOp er. causes

the

automaticaly automaticaly
is

into

aproximately

after

controler

the run the the
to
the on

using

removes from

READ
the

controler OperationRESET

enables from on-line
the

once

whether input hop er switch operation. Operator switches control
b
l
o
w
e
r
.
Function determine lamps automatic the down loaded RESET activates seconds selection inputthe of-line panel. positioninputnormal
depresSed, hoper position positionshut input are the of-line position alow STOP alow program
When indicators panel indicator Controls input MAN are AUTO the Blower cards and vBlower thre depres ed. Permits LOCAL COM AND reader and control REMOTE COM AND under depres ed.
the are

continuously

C-2

Controls
Panel

Table Rear
CM8F

Type

tog le

pushbuton 2-position

2-position

switch

LAMP

SHUTDOWN

Control TEST

switch
MODE

C-7

'to

1‘.

fixing m

‘
..

"’

’

v»

wfi'fl

‘

’

«My;

«”334“,
a3,

..="”&’®F§€"~£&
3&6;
WWW}
m:- ‘
~~§~~§M
«

X“

Ewing:
‘g

:3‘

,“2
y

‘

,4
‘3‘?kamm
w}

‘

‘
,

~"'~L§1x:‘~;‘.«,._‘
4:3" ”33:25".

fiw

”W"
M.

‘

x
‘

"gr
M ;_}zg‘;¢§u
5

\u
A

..‘>:»,¢£;u:»§,,%$
:a
A.

wfi‘:
*‘ka E?
x,

ax“

2:5u‘

«W;- "ta

fimm‘
M: 3,

‘

«39%,
“

.\;‘\Vm‘
w

‘

W
“qamfi
{o
Rm.
x

Figure
CM8E

‘,

Controls

C-4

and Indicators

de- to

except switch

the

is in is

drive eror eror Upon motor can the
from
main al the reader

reader drive cycle stops.
main switch
reading

p
r
o
c
e
s
i
n
g
switch
cprimary ircuits portion ap lied starts corected. alowing COMAND start stops motor indicator.
Function
resets provided be n spe d, indicator. stop ing curent
portionap lies reader lower power indicates
while before
switch
depresed,
up er motor.
depresed,
When pres ed, drive Depres ing removes power reader. motor indicators condition releasing ac ept controler cards. Lights When operation motor. depres ed proces , completed Extinguishes
Indicators
is

power

reader. primary

card

lit,

When

C-3 and

Table

this card the LINE

and

be n

card

the

from that

and has

has

READ

up a

and

LINE

come

When

rocker

Controls

CM8E Type

2-position

light
gre n

Indicator
or

Control POWER switch

POWER

pushbuton
switch

indicator START

‘

pushbuton
switch
STOP

‘

the

the or

reader ac ept START
.

and

the the

ocurs. either that Condition operator

card into

received controler.

and

was the read

and

controler. whenever depresed continue. operationindicator. operationindicator. after Operationindicator.
after
condition emptyful.

the to the

that

that the when
able on

the

that

can

card to the

card it
a

that

the

LINE
d
e
l
i
v
e
r
e
d
reader
r
e
a
d
e
r
from comes goes er or indicates reading
i
n
d
i
c
a
t
e
s
Function indicates depresed. switch hop erstacker corected card reader failed station COMAND card indicates stacker card
and

out is

on-line light light

move from

LINE

properly

cWhen omands This switch This STOP whenever When input output must before ‘Stopsextinguishes When reader READ Stopsextinguishes When output operation. Stepsextinguishes

lit,

(Cont.) Iandndicators

lit,

lit, read

lit,

the 'a

not

C-3

Table

Controls
CM8E

light
Type
gre n

Indicator
or

Control indicator
LINE

light

red

SUP LY

ER OR

ER OR
STACK

CARD

indicator

FE D

C-lO

indicator

_*
in

and

card check

jam

the

operationindicator. that light/dark operationindicator.
Function indicates reader LINE indicates station. reader LINE
station. card pas read card
card
a

the

I(Cont.) ndicators

lit, read

extinguishes extinguishes

light

red

lit,

the

When the Stops When failed at Stops

and

C-3

Table Controls
CMBE

Indicator EROR
or

Control MOTION indicator

ER OR
L.D.

indicator

C-ll

C.3

HANDLING PROCEDURES

CARD

The

following paragraphs
present
loading the input hopper, unloading

error

C.3.l

conditions.
Cards

following procedure is
punched cards to be read:

The

Step
1

the
for
recommended
procedures
the output stacker, and correcting

used when

the

input

hopper

with

Procedure

hand
and
with
back
one
follower
begin
Make certain that the
card decks into the hopper.
face
the
first card to be read is placed at
down,
front,
column 1 to the left.

Pull

the

hopper

is
it
cards into the input
hopper until
is
the
filled' (this
approximate amount of cards
listed as the capacity for a particular card reader model).

Continue

placing

loosely

CAUTION

input hopper so full that the air from the
riffle the cards properly.
If the cards are
it
packed too tightly,
impairs proper operation of the

Do not

pack

the

blower

cannot

vacuum

picker.

cards

may

continue

loaded

operating provided tension is
cards
portion of the deck as

while

the

maintained

reader
is
the
front

rear.
the
to
are added
Additional
cards
should
not be loaded, however, until the
hopper is approximately 1/2 to 2/3 empty.

CAUTION

maintaining tension on the card deck, use just enough
to
maintain
the
riffle
action
to prevent card
pressure
damage and jamming of the reader.

When

Normally,
stacker.

all

cards

However,

are

moved

if it

the input hopper, simply pull
the

card deck.

through the
necesSary to
back

the

reader
remove

follower

into

the

cards from
and
remove

C.3.2

Unloading

Cards

the stacker follower
from the stacker, being
The
be
stacker
may

To unload cards from the output stacker,
pull
back
with
one
hand and remove the card deck
careful to maintain the
order
of
the
deck.
unloaded while the cards are being read.
.

C.4

C.4.l

OPERATING PROCEDURES

Model CM8F

Off-line Operation
Off-line
C.4.l.l
operation of the CM8F card
is used primarily for setting up and checking reader operation
reader
prior to switching to on-line use;. for correcting error conditions;
for
When placed off-line, the reader can be
and
maintenance tests.
The following procedure is
operated locally from the control panels.
and
to
the
reader
check
off-line
used
energize
operation prior to
switching to on-line operation.
-

Procedure

Step
1

Make certain that the ac power cord is plugged
the
circuit breaker on the rear base panel of
in the ON position.

Set MODE

Set

Depress

switch to LOCAL

SHUTDOWN

position.

switch to energize reader.
but blower does not come

lights

Load

Depress

POWER

all

front

panel

lit.

RESET

into the

switch

comes

on.

input hOpper.

and
observe
that
associated
After approximately 3 seconds,

should start being picked and moved
into the output stacker.
When

that

are

card deck

indicator

Note
on.

Depress LAMP TEST switch and observe that
indicators

and
that
reader is

position.

switch to AUTO

POWER

indicator

in
the

through

the

read

green
cards

station

observe
that
the
HOPPER
input hopper is empty,
indicator lights, the green RESET indicator goes out,
and the red STOP indicator lights.
the

CHECK

The card reader may
on-line Operation.

now

Operated locally

switched

C.4.l.2

Operation

On-line

Procedure

Step
1

that

certain

Make

performing

the

card

procedure given

the

Load

certain the output stacker is empty.
hopper with the cards to be read.
Make

Set

the

green

input

the

switch to REMOTE.

MODE

Depress the

isv operational
reader
in Paragraph C.4.l.l.

associated
that
the
switch and
observe
now
on-line.
card
reader
is
The
lights.

RESET

indicator

If the card reader goes off-line because of an error
alarm,
be
can
it
placed back on-line by correcting the error and
then depressing the RESET switch.

Any time it is desired

switch.

C.4.2

off-line,

the

depress

STOP

Model CM8E

The model CM8E reader has no
Off-line Operation
C.4.2.l
capability
for
off-line
Verification of satisfactory operation is
operation.
determined simply by successful on-line operation.
-

C.4.2.2

On-line

Operation
Procedure

Step
1

Make

certain

performing

the

the
card reader is
operational
procedure given in paragraph C.4.l.2.

~that

Make certain the output stacker is
hopper with the cards to be read.

Load

empty.

the START switch.
Observe that
indicator lights.
The card reader is

the

Press

now

switch.

off-line,

input

green

LINE

on-line.

If the card reader goes off-line because of an
be
it
can
placed back on-line by correcting
then depressing the START switch.

Any time it is desired to

the

error

the

depress

alarm,

error

the

and

STOP

APPENDIX D

INSTALLING MSBATCH

This

describes how to install MSBATCH on an
OS/8
(MSBATCH will not operate under earlier versions of

version

appendix

system

08/8).

first
column
installed by copying the files listed in the
The copy operation can be
the
onto
system device.
PIP
or
performed as described in the 08/8 Handbook, using either the
FOTP
or
the
COPY keyboard command.
The other columns in
programs,
Table D-l list the system
files
and
programs
required for BASIC,
FORTRAN IV and FORTRAN II Operation.
is
Table

MSBATCH

D-l

Table

List of
f

ILMSBATCH

Files

MSBAT.SV
BATCH.SV

Files Associated with MSBATCH

BASIC

Files

BCOMP.SV

(not

required for PIP
Mode Operation)

D-l

BLOAD.SV
BRTS.SV

‘

FORTRAN

IV Files

FORTRAN

F4.SV

FORT.SV

PASSZ.SV

SABR.SV

PASSZO.SV

LOADER.SV

PASS3.SV

LIB8.RL

RALF.SV

GENIOX.RL

BASIC.AF
BASIC.FF
'

BASIC.SF

LOAD.SV
BASIC.UF
FRTS.SV
FORLIB.RL

LIBRA.SV

Files

APPENDIX E

ADVANCED FEATURES

This

E.l

and

features

describes two additional

appendix

MSBATCH

05/8

that

are

available

users.

USING MSBATCH

PROCESS

08/8

JOBS

allows users to run 08/8 jobs from mark sense cards or
simply
insert
BATCH commands into an MSBATCH job.
Any legitimate BATCH
character
the
card's
command can be used by entering the command in
field
(columns 9 through 40). Those MSBATCH keywords on the card that
For further information
have counterparts in BATCH can also be used.
the
BATCH.
to the section in
refer
08/8 Handbook that describes
Cards containing BATCH commands can be placed anywhere in the job deck
except in a program or data deck.

MSBATCH

E.2

USING THE

BATCH

STREAM DEVICE

The batch stream device is a pseudo device called
allows
BAT:
that
the
user
read
lines
from
the batch stream.
BAT:
can be_used
to
The
device
anywhere a non-file structured ASCII device is
legal.
inputs
any line in the batch stream except those lines beginning with
a $.
the
that
is,
Input begins with the current batch stream line,
line
last
line executed by BATCH.
following the
Input terminates
when a line beginning with a $ is detected.
BAT:
within
resides
BATCH
and
be used only when BATCH is resident in
therefore
can
it
Since BATCH resides in the top of the upper field of
memory.
memory
and
requires a minimum of 12K of memory to run, any user or any 08/8
program written to run within 8K of memory can safely use BAT:.

Example:
$JUB
.R

EHHHPLE

USE

BHT:

PIP

*FDUCBHT:

THIS
IT

INPUT

HILL

THE

BHTCH

TERHIHHTED

HITH

LINE

THHT

BEGINS

SIGN

{$3

CHHRHCTER.

BATCH will

STREHM.
NEHT

THE

DDLLHR

$EDD

Submitting

this

THIS
IT

INPUT

WILL

produce

THE

TERMIHHTED

LINE

THHT

BEGINS

SIGN

{$3

CHHRHETER.

NITH

EHTEH

file named FOO which contains:

STREHM.

THE

DULLHR

INDEX
Control commands

features, E-l

Advanced

Alphabetic characters,

BASIC, 3-8
FORTRAN, 3-10

B-8

ALTMODE ,

5—4

Ampersand

(&) character, 2-11
(*) symbol, 2-11, 5-3

Asterisk

$BAS control card, 2-7
$BAS control commands, 2-6,

3-8

BASIC

card, 1-2, 2-3, A-l, B-2
I/O operations, 4-2
job control commands, 3-8
keyword field, B-6
program files, 4-1
programs,
Batch

2-3

control, B-4
'mode, 1-3
processing, 2-l
stream,

A-l

device, E-l
/B option, 5-3
stream

Boxes

mark

sense

({}),

3-1

Braces,

Data

cards, A—l

preparation,
cards,

3-2

Data

2-3

2-1, A—l

deck,

DECcassette, 1-5
$DECK control command,

3-5
2-1

Decks, program and data,
DECtape, 1-5

Cards, 2-1
alignment, 5-2
continuation, 2-11
field layout, B-4
format, B-l
loading, C-12
marking, 3-2
preparation, 2-3
unloading, C-l3
Card

general purpose, 3-4
commands, 3-1, 3-3, Aii’
$BAS, 3-8
$DECK, 3-5
$EOD, 3-7
$FORT, 3-10'
$JOB, 3-4
$LOAD, 3-12
$MSG, 3-6
$RUN (BASIC), 3-9
$RUN (FORTRAN), 3-15
Copying a deck of cards, 3-5
Correcting errors, B-l3
CTRL/C, 5-5
CTRL TAB function, 2-11
CTRL/Z, 5-3, 5-5
Control

Device assignment,
Device number, 2-3

FORTRAN,

Devices, I/O, 4-1
$ (dollar sign), 3-1,
(dot) symbol, 5-3

4-2

B‘8

End of file card, 5-2
$EOD control card, 2-8

reader

input hopper, 5-2
operating procedures, C-l_
Carriage return, 5-4
Character field, B-7, B-8
Characters, upper/lower case,
card reader, C-1, C-2
controls and indicators,
CM8F, C-l
controls and indiCators,

$EOD control Command, 2-8,
correction, B-13
Error messages, 2-12, 5-5,

2-11,

3-7

Error

Execute

BASIC

program,

5-6

3-9

3-2

CM8E

C-8
C-3

through C-7
40, special characters in,

Column

B-lO
Comma

(,)

Command

usage, 3-2,
decoder line,

B-9

5-3,

Fields, B-4
File name, numeric, 3-16
File naming restrictions, 4-1
Files associated with MSBATCH,
/F option, 5-3
$FORT control card, 2-7

SPORT control command,
5-4

Commands, see control commands
Command syntax, 3-2
Continuation cards, B-ll
FORTRAN, 2—11
Continuation line, 2-11
Control cards, 2-1, 2-5, A—l
Control command field, B-4, B65

2-6,

FORTRAN

cards,

1-2,

2-3, A-l, B-l

continuation card,
control

commands,

2-ll
3-10

keyword field, B-7
FORTRAN

I/O operations,
keywords, B-7
programs,

2-4,

4—3
4-3

D-l

3-10

FORTRAN

I/O operations, 4-3
programs, 2-4, 4-2

Mark

sense

Mark

sense

Marking

card

1-2

formats,

card reader,
cards, 3-2, B-l

2-1

Messages to computer operator,

$MSG

3-l
control command,

/NOL

(no list)

3-6

Mnemonics,
General

control

purpose

commands,

3-6

3—4

Initialize MSBATCH,

3-4

Input, Batch mode, 1-3
Input hopper for card reader,

5-2,

C-12

INPUT keyword, 2—3
Input/output considerations,

2-3,

4-1

Installing MSBATCH,

C-l

Interactive Batch mode,

1-3,

5-1,

5-4, A-2
I/O devices, 4-1
/I option, 5-4

operation, C-l3
operation, C-l4
Operating modes, 1-3
Operating procedures
Offline
On-line

card reader model CM8E, C-l4
card reader model CM8F, C-l3
MSBATCH, 5-1
Operator communication, 5-5
error

messages,

1-3, 2-3, 2-10,
Output stacker, C—12

Paper tape, 1-5
Period (.), 2-11 B-9
PIP mode, 1—3, 5-1, A-2
Preparing the job deck, 5-1

1-5

printer, 5-4
Listing device, A—2
$LOAD control command,

3-12

Loading and running MSBATCH,
Loading cards, C-12
Logical unit numbers, 4-2
case

4-1

B-6

Line

Lower

5-4

Output,

3-4,

C-l

2-11

commands,

LINCtape,

5-6

Optical mark card readers,
OS/8 BATCH, 1-4, E-l

options,
Keyboard, l-3
Keyword, A-2
Keyword'field,

2-6

option,

Numeric characters, B-9
Numeric file name, 3-16

1-5

Hardware,

characters,

5-3

3-2

PRINT keyword, 2-4
Processing, 2—1, 2-2
Program cards preparation, 2-3,

Punched card

Job, A-2
$JOB control card, 2-6, 3-4 ' 5-1
$JOB control command, 2-5, 3-4

A-2

.Program deck, 2-1, A—2
Program submittal, 2-5

image format,

2-ll

Job

deck

(?),

2-ll

listing

BASIC,

2-12

FORTRAN

IV,
II,

FORTRAN

Question mark

READ

2-14
2-16

output listing,
BASIC, 2—13
FORTRAN IV, 2-14
FORTRAN II, 2-16

Job

BASIC

Job

deck, preparation of,

example,

keyword,

2-4

RUBout, B-l3
$RUN control card, 2-9
$RUN control command, 2—9
BASIC, 3-9
FORTRAN, 3-15
Running MSBATCH, 5-3

5-1

Job

layout,

2-10

output,

2-1,

Software environment,

2-10, A—2

preparation, 2-9
processing, 2-1
termination, 5-5

Spaces,

1-5

3-2

Special characters, B-lO
Stacker, C-l3
Statement/line number field,
B-4, B-5

2-11,

Submitting a program, 2-5
<>
and ;, B-9
Symbols:
Symbology, 3-1
Terminating BATCH job execution,
/T option, 5-4
/2 option, 5—4

Unloading cards,
Upper
User

C-l3

characters,
requests, 5-5
case

Vertical bars (I),
/V option, 5-4

(control Z),

Zone

subfield,

3-1

5-3,
B—7

3-2

5-5

HOW

SOFTWARE

NEWSLETTERS,

TO OBTAIN

MAILING

SOFTWARE

INFORMATION

LIST

headquarters in
Summaries (SP8)
published monthly,

located at corporate
Software Performance

Software COmmunications Group,
Maynard, publishes newsletters and
The

Newsletters are
the various Digital products.
contain announcements of new and revised software, programming
notes, software problems and solutions, and documentation corrections.
Software Performance Summaries are a collection of existing problems
and solutions for a given software system, and are published periodi—
For information on the distribution of these documents and how
cally.
to get on the software newsletter mailing list, write to:

for

and

Software Communications
P.

Maynard,

SOFTWARE

Box

Massachusetts

01754

PROBLEMS

software should be reported
or problems relating to Digital's
A specialist is located in each
Software Support Specialist.
In Europe, software problem
Digital Sales Office in the United States.
reporting centers are in the following cities.

Questions
to

Reading, England
Paris, France
The Hague, Holland
Tel Aviv, Israel

Milan,
Solna,

Italy

Munich,

West

Sweden
Geneva, Switzerland

Germany

Software Problem Report (SPR) forms are available from the
from the Software Distribution Centers cited below.

specialists

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

Digital Equipment Corporation
Software Distribution Center
146 Main Street

Maynard, Massachusetts
Outside of

the United States,
Sales Office or

Digital Field
USERS

Digital Equipment Corporation
‘

01754
orders

Software Distribution Center
1400 Terra Bella
94043
Mountain View, California
should

be directed

the

nearest

representative.

SOCIETY

Users Society, maintains a user exfor user-written programs and technical application information.
A catalog of existing programs is available.
The society
publishes a periodical, DECUSCOPE, and holds technical seminars in the
United States, Canada, Europe, and Australia.
For information on the
society and membership application forms, write to:

DECUS,

Digital Equipment Computer

change

center

DECUS

Digital Equipment Corporation

Digital Equipment,

146 Main Street

81 Route de
1211 Geneva

Maynard,

Massachusetts

01754

Switzerland

l'Aire
26

S.A.

Mark

Sense

Batch

User's Guide
DEC-S8-OBUGA-A-D

READER'S

NOTE:

Problems
form is for document comments only.
software should be reported on a Software
Problem Report (SPR) form (see the HOW TO OBTAIN

This
with

SOFTWARE

Did

find

you

COMMENTS,

errors

INFORMATION

page).

this manual?

so,

Did you find this manual understandable,
Please make suggestions for improvement.

there

for use
what material is

indicate

Name

and

well-organized?

on associated system programs
If not,
software described in this manual?
missing and where should it be placed?

the

type of user/reader that you most nearly represent.

Assembly language

DDD

usable,

page.

sufficient documentation

required

Please

specify by

programmer

Higher—level language

programmer

Occasional

(experienced)

User

with

Student

programmer

little programming experience

programmer

Non-programmer interested in computer concepts and capabilities
Date

Organization
Street

City

State

Zip Code
or

Country
If

you do

not

require

written reply,

please check here.

Fold Here

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 Communications
P.

Box

Maynard, Massachusetts

01754