3Z0-2t:>l5

CP-67/CMS
USER'S GUIDEIBM. Cambridge Scientific Center Report· International Business M·ac hines Corporu.tion
Can1bddgc Scicatific Cc:nterCan~bridge, 1:fassad1usetts
October, 1967
Revised .July ; I ?68L•

320-2015 .
October, 196 7
Revised July, 1968
Scientific Center Report
CP-67/CMS
USER'S GUIDEInternational Business
Machines Corporation
Cambridge Scientific Center
Cambridge, MJ.ssachusetts

Abstract
CP-67 /CMS is a general purpose time-sharing system developed
for the IBM 360 at the Cambridge Scientific Center. This guidedescribes the facilities of CP-67 /C"!;-/i.S and p~ovides detailed
information about the user commands available and their usage.
Index Terms for the IBM Subject Index
Cornputer Systen1s
IBM 036-67
Time =Sl1aring
Virtual Systexns
Conversational Compl?ting
Interactive Con1puting
Remote Computing
On-Line Debugging
07-Coinputers
21-Progr arnrning(3/12/70
0.0.0-1
CP-67/CMS USER'S GUIDETable of Contents

(__

Date

1.0.0

INTRODUCTION • • • • •2.0.0

CP/CMS CONVENTIONS..
.

• . ,.l . . .

• • • • • • • •6-01-68. . • • • • • •.- • • • • • •'\/'\ r..,2.1.0 File Conventions • • • • • • • • • • • • n':1-..:>v-01
2.2.0 Terminal Usage • • • • • • • • • • • • • 5-0l-69R

2.2.1 Terminal Characteristics • • • • • 5-0l-69A2 • 2 • 2 L egging.
n roceaures.
~• • • • • • • 5 - 01 - 69R
2.2.3. Dialing a Multi-Access System •• 5-0l-69D/A
2.2.4 General Typing Conventions • • • • 5-0l-69A
2.2.5. Attention Interrupt •• • • • 5-0l-69A.L.'

2.3.0 Environme~t Conventions ••(3. 0. 0• • • • • • • 5-01-69E.
··-. ·- ···_.,._ .

. . . . . . . . • • • • • • • 5-0l-69R
3.1.0 File Creation, Maintenance,and Manipulation • • • • • • • • • • . . 9-26-67
3.1.1 Alter . . . • . . . • • • . . . . 5-0l-69R
3.1.2 Closio . . . • • . • • • • . . .ll-01-68E
3.1.3 Combine . . . • • • • • • . • . • 9-15-67
3.1.4 Disk. . . . .
. .• • • • • • . 8-23-67
3.1.5 Dumprest.
. • • • . • 8-23-67•
3.1.6 Edit. . . . . . • • . • • . . . . 3-09-70R
3.1. 7 Erase . . • . • . . . • • . • . • 8-03-b7
3.1.8 Finis . .
. • • • • • • • . . 9-18-67
3.1. 9 Listf . . . • • . . • • • • • • . 5-0l-69R
3.1.10 Mac lib . . . . . . . . • • . • . 5-0l-69R
3.1.11 Off line . . . • . • • • .
. . 2-06-70E
3.1.12 Printf. . . . . • . . • • • . • . 7-19-68
3.1.13 Script. .
• . • • . . . • • . 5-0l-69R
3.1.14 Split . . . • . . • • • . • . • .ll-Ol-6SR
3.1.15 Tape. . . . . • . • • • • • • . • 5-0l-69R
3.1.16 Txtlib. .
..• • • • • • •3.1.17 Update. .
.
• • • • • • • • • 1-22-68
3.1.18 Taprint .
• • • • • • • • • • 4-01-68
3.1.19 Wrttap. .
.
• . • • • • • • • 4-01-68
3.1. 20 State . . • . . . • . • • . • . • 5-0l-69A
3.1. 21 Tapeio. .
. . • • • • • • • • 5-0l-69A
3.1. 22 Dumpf . . • . . • • • • • • • • . 3-09-70R
3.1. 23 Durnpd . . . . • • • • • • • • • .11-0l-68A
3.1. 24 Remote. . . . • • • • • • . . • . 3-12-70A
CMS CONr·~l'.JDS • •-.10-23-GS~

(

I

I

0.0.0-2
Date(. . . . . . . . . • 5-01-69R
3.2.1 Genr::od. .
. . . • . . 5-01-69R
3.2.2 Global. . . . . . . • • • • • . . 5-0l-69R
3.2.3 Load. . .
. . • • • • • • . . 5-0l-69R
3.2.4 Loac:nod . . . • • • . . • • • • . 5-0l-69R
3.2.5 Reuse . • . . • . • • • • • . . . 5-0l-69R. . 3. 2. 6 _. Start . . • • • • • • • • • . • . 5-0l-69R
3.2.7 Use . . • . . • • • • . • • • • . 5-0l-69R;.
:''". 3. 2. 8 $ . . • • . . • . • • • • • • . . 7-31-67
3.3.0 ..Debugging Facilities . . . • . • . . . • 8-16-67"
3.3.1 Cl rover . . . . . • • • • • • • . 8-16-67
3.3.2 Debug .
. . . • • • . • • . • 1-01-68
3.3.3 Seterr. .
• . • • . . • • . . 8-16-67
3.3.4 Set over . . • . • • • • • • • • • 8-16-67
3.4~0 ...tanguage Processors. . . .
. . . . • 7-19-68.· 3.4.1 Assemble. . •. . . . • 5-0l-69R
3.4.1.1 Asse:nbler Language
Prograr.ming . . . . . • . 1-22-68
3.4.1.2 CNS :•Iacros. . . . •. 5-0l-69R
3.4.1.3 OS Hacros . . . . . . . . 5-01-69A
5-0l-69A
3.4.1.4 CNS :Nucleus Routines.
3.4. 2 Fortran • • • • • • . . . .
• 7-24-67
3.2.0 Execution Control ••·,~·. ".~(,,.. 3. 4. 2 .1 Fortran Progra~rning·- .J../.
~

-r •

~

.J

PT
/T..&.. •.L~,•. . . . . . . . . . . . . 5-0l-69R

3.4.3 . l_PL/I Programming

3.4.4

Snobol.

.ll-13-69E• 5-0l-69A. . . .. . . . . . . . . . . 1-22-68

3. 4. 4. 1 Sno bo 1 Prog.rarnming.

. . 1-22-68• 5-bl-69A.....
3.5.0 Miscellaneous . •. . . . . . . • 3-12-70R
3.5.1 Linend.
.. .• .. .. .• • . .. 5-0l-69A
9-19-69
3.5.2 Echo. .
.11-0l-68R
3.5.3 Exec. . •
.
.
.
.
.
.
•
7-19-68.
• . . . .. 1-22-GS
3.5.4 For:r.at. • • •.
3.5.5 Ke. •.
.
.
.
3.5.6 Ko.
. . •• • . . • • • •• •• . 1-22-68
3. 4. 5

Bruin . •J/ lL/ IU
0.0.0-3

Date·J.5.7 Kt • • • • • • • • • • • • • • • • 1-22-68
3.5.8 Kx. • •• • • • • • • • • • • 5-0l-69R
3.5.9 Login •• • • • • • • • • • • 5-0l-69R
3.5.10 Logout.
• • • • • • • • • 5-0l-69R
3.5.11 Stat. •• • • • • • • • • • • 1-22-68
3.5.12 Blip. •• • • • • • • • • • • 5-0l-69D/A
3.5.13 Mapprt.
• • • • • • • • • • • 4-01-68
3.5.14 Ipl • • • • • • • • • • • • • • • 7-19-68
3.5.15 Rt . • • • • • • • • • • • • • • • ll-01-68A
3.5.16 Chardef . . . . . . . . . . . . . . . 5-0l-69A
3.5.17 Cpfunctn • • • • • • • • • • • • • 5•01-69A
3.5.18 Divertsw. •• • • • • • • • • ll-07-69A
3.5.19 Timelim • • • • • • • • • • • • • 11-07-69A
3.5.20 Getlib • • • • • • • • • • • • • • ll-12-69A
3.5.21 Quick . • • • • • • • • • • • • • ll-12-69A
3.5.22 Dosbatch • • • • • • • • • • • • • 3-09-70A(

3.6.0 Utilities • • •3.6.1
3 •.6. 2
3.6.3
3.6.4
3.6.5
3.6.6
3.6.7

CNVT26.

• • • • • • • • •.ll-07-69R. • . . • . . • . • • • . 5-01-69A. • • . • • • • • • . 5-0l-69A

CompareCVTFVModmap. •Sort.
Tpcopy.
Tprnatch

5-01-69A. . . .. • • • • • .• • • .• 5-0l-69A. . . .• • •• .• •• •• •• • .• .• • 5-0l-69A..
. . • 5-0l-69A. . . . .• .• •• •• •• • •• . .ll-07-69A
3.7.0 Text Libraries. . . . . . . . . . .ll-01-68A
3. r:1 Syslib. . . . . . . . • • . . • • ll-01-68A(

Tapset Routine •• .ll-01-68A
Trap Routine . . • • • • ll-Ol-68A
Blip Routine . . • • • • ll-Ol-68A 3.7.1.4 Logdsk Routine . • • • • ll-Ol-68A• .ll-Ol-6SA
3. 7 .1.5 Reread Routine .
• .ll-01-63A
3.7.1.6 Define Routine .
3.·7.1.7 Dsdset Routine . • • • • 11-01-63A
3.7.1.8 Getpar Routine . . • . • 11-0l-63A
3. 7.1.9 Cpnmon/Cpr21of Routines .ll-Ol-63A
3. 7 .1. 10 C~fS Routine. • . • • • • l l-13-69A

3.7.1.1
3.7.1.2
3.7.1.3

3.7.2

Plilib. • • • • •3. 8. 0 Installation Comrnands. •

4.0.0

(

........

...• • • • •CP CONSOLE FUNCTIONS • • • • • • • • •• • • • 4-02-68

4.1.0 Console Function Descriptions . •. . • • 5-01-69R

4.1.1
4.1.2

...

Begin •• • • • • • • • • • 5-01-69R
Close • • • • • • • • • • • • • • 7-19-68

3/12/70
0.0.0-4
Date. .. . . • • • • • • • • • 9-17-67
9-17-67.
.
. . . .• • •• •• •• •• •• •• •• •• •• 9-17-67. . . . • • • • • • • • 5-0l-69R. . . . • . • • • • • • • • . 5-0l-69R
5-0l-69R. .
5-0l-69R. . . ..• .• .•• •• •• •• •• •• •• •• •• •• 5-0l-69R. . • . . •• •• •• •• •• •• •• •• •• l-26-70R
l-26-70R.. . . .. • • • • • • • • • • 9-17-67• • • • • • • • • •.
• l-24-70D/A==• • . • • • • • • • • • l-26-70D/A
1-24-70D/A. . • • • • • • • • • • • • 5-01-69A
.
.
•
•
•
•
•
. . .• •• •• • . •• •• • • • • • 5-0l-69A. . 5-01-69A. .. .• .• .• .• .• •• •• •• • •• •• • 5-01-69A(. 4.1. 3 Detach •
4.1.4 Display
4.1.5 Dwnp.
4.1.6 External.·4.1.7 Ipl
4.1.8 Logout.
4.1.9 Msg
4.1.10 Query
4.1.11 Ready
4.1.12 Reset
4.1.13 Store
4.1.14 Set
4.1.15 Xfer.
4.1.16 Purge
4.1.17 Sleep
4.1.18 Spool
4.1.19 Disconn
4.1.20 Link.

.

= = = = = ==4.2.0 Console Function Applications.
5.0.0

OPERATING CONSIDERATIONS ••..• • • • • • •. . . . .. . . . •• •• 5-0l-69R• • 7-19-68.
.
......
• • 4-10-68
5-01-69A.
..

5.1.0 Recovery Procedures.
• • • • •5.2.0 Off line Procedures•• • •5.3.0 Changing Object Programs •••5.4.0 Library Usage.
•• •5.5.0 Tape Procedures.
• • •• • • •(r,... "o.v.v

SAMPLE TERMii\AL SESSION.

7.0.0

CNS BATCH I"fOXITOR.

4-05-68• •. . . . • • • • • • . 4-12-68-. . . . . . • • • • • • . .12-10-69R
7.1.0 A CNS Batch Job. . . . . . . . • • • • .ll-01-68A.ll-01-68A..• • • • .
7.2.1 //Fortran .
. . • • • . . • .ll-Ol-68A
7.2.2 //Assemble. . . . • • • . . • . .ll-01-68A.11-01-GSA
7. 2. 3 //Text. .
....• • •.ll-Ol-68A.
.
7.2.4 //Dataset . . . .
•• •7.2.5 //Go. . . . . . . . • • . • • . .ll-Ol-68A
7.2.6 //Punch . . . • . • • • • • • . .ll-01-68A
7. 2. 7 //Print . . . • • • • • • • . . .ll-01-68A
7. 2. 8 //Link. . . • . . • • • • . • . .12-10-69A
7.2.9 //Return.
. . • • • • • • . .12-10-69A
7.3.0 Running CMS Batch. . . • • • • • • • • .ll-01-68A.

7.2.0 CNS Batch Control Cards.

(. • • • • 4-03-68

5-1-6')o. o. 0·-5
Date·(
GLOSSARY............... . . ... . .

9- 4-67

APPENDIXA.

Summary of Commands, Requests, and Console
Functions . . . • . • . • • . . . • • • . • 11- l -68E

B.

Forni.at of Con1rnands, Requests, and Console
Functions . . • . •C . • CP /CMS Messages .

INDEX

(_

...............

4- 1-68
2- 5-68•.. .....

6- 1-68

/>-)
,_,

7

6-1·68

6-1-6n1.0.0-2

i. o. 0 .. 1

The Cf'/CMS time-sharing sy~ten1 i~; cornpof;cd of two indcpunrlent cornponcnts:
Control Pro~1:a1n (CP) <ti.cl the Cainbi·icl[l' 1'.1cinitor Sy;,:tcm (CMS).

tlw

CP l;uildr:•and in~dnt;1in:; fol' each u:HH' a ''virtu<il Jn<ichinc". The vil·tual in:tc:hine i::;inclistingHi:;h;1hl1! to the nscr illl<l his progr;!rn;; froiri ;1 real in<::chinc:, but i.:. reallyon" C>f rr1;111y CI' is m<.!n<l['.ing. CP alJocatcr; t!w rc:so1n·ct:H of the real rnachine toend1 virtu;:J ni;H·lr:nc in tui:n for a short ":;lice" of tinw., then rnov,~n on to the nc~xt.
virtual n1;i.cldn1,,
Sinn: tlw virlu<1l n1:.ichi11L"£ an: £inn1lalcd, Lh.·ir confi[;urations inay differ frorn eachother and froin'1 ltf• rcrll 1n.achine. J-'.;1ch u<;c ~ controls his vil'tu;1l niachinc fro 1n his
ter1ninal, which is, cffcdivcdy, lii1> con::;olc keyboard.

and resultant allocation 9f real core to a given uncr 1 s. pri.gco, appc:ar rando1nto the t<yHtc111, Special hardware is provided on the Syvtern/360, Modc~l 67
that iranf;latcs, at. execution tin1e, the uscr 1 s (01· U!H.::i• progra1n 1 :;) acld1·csscs. into Ow cm·1·1~nt real a<ldref;scs of the randomly located i1ae('8, Tl1is is called
11 clym1111ic aclclrcsn translntion 11 ; it ill trani;parc11t to the user.
Decausc of the virtual machine concept ernployc11 l;y !his :;yst.<~rn, 011ly t.hc
Control Progra1n (CP) rnay operate in the snpcrvicor elate~ on t:lic l'ec.l rnachinc.
All prograrnfl other than CP -- all progran1l; cx<;c:ut:cd on virturil n1achincs -operate in tl1c problc111 state on the real n1achinc. By a special intcrrupthancllinG iwc1cedurc, however, CP support:t• what. arnount1; to a vil'tuz,l f1\1pc1·visor
1>l<1lc Oll tl1e vb·t\1;11 rnachinc, J\11 un01· il1l:crrupu~. iHcludine thc>1H~ ('<1\1~:c:d byalt1>n1pled J>l ivilcgcd opcr;1(.ious, arc haJJclJ,,rl by CP, which rcfkct to. the usc:r
1nog1.,1n1 only tlwst? the ur;t:r progran1 would expect f1·orn <1 l'l:<t.1 in;1cl1ine:. The
user n1<ty expl'ct his progran1s to execute on his virh1<il 1nachinc in a nrn1mer
identical to their (,xecution on a real xnachine. •I.ii-<· r~,al i,1;,, !ti,1<}f:, virlu;cl in;1clii1w:; will op,;rate n10:;1: cfficic1,tl.y under au opcrat:ine
nyf-lc·1D. 'J'lw C;1rnhric!1:c lv101d(or ,c:;yf:h"n1 (C£,1~>) if,; dc::;i:j11ec1 t:o al.low fnll 1we of a
Sy1 t1:1 11/:?.(,f 1 il11·1:1·~~h a :;i1111•lc c.on1111~1!1d laneu:'f'.C c·ntcn:cl at l.11c! co,1f:o]c (in the• (dGe of
it virtual li:;.1cJi;~1c, at lite tcrrni11al).
C.1-,J!:; gives the nsni: i'. f1tJ.l !';·mr;c of capctbiliticH
cr1·.,ting <tr,;l r:;~1naginG Jile~~. con1pilinr; aucl cxccutinr, prol.1lcrn 1n·o2ranrn, <~nd dobun;ing-·· usini~ only hi:, rcrnot .., terruiiial. Sinn' each user has h:ln own vlrtu<tl
in;1chi11c with his own copy of C.lvtS 11 in it", nothing he docs c;u1 <1ffc:c:t.a11y ot·bcr t10C•J',
In <iddition, since use1·s cannot get 11 outc:icle" their virtual n1adliner;, CP is pl'olcctcd
fron1 any ur.c:r i:!rror.

Since rnany usc•r::;, through their virtual niachincs, require sysl.c1n res~nu·ccs
that l.ogctlu•1· ca11 total 1ncrny times the resourct•.r. of the real systcn1, the ~:yGlc1nO)Wl'<itor 1nn:il: occ•H~ionally take i;lcps to n-1aint:nin <"\(frqncil c r1'.spm1i;e lirnc for
all w:crs. CP i·ccogni7,es that certain kiJ,d[; of jobs C•n virtu:1l rr1<1.cliin<:s -laq~v ;u;sen1hlies or co1upilations, for cx<nnplc, -- can cr.i.u:c heavy paging
loads or olhunviue tax the Control Prograrn. CP will attcn1pt to sche;ch1lc
the diffcre;it jolJ.f; so ac. to .maxin1i:-1c the total throur,hpi.11 of thc-: syt;ten1 whilen1aii:lainini.; a fast: rCS]'Oli::c t:i1nc for those uncrs who~:c dc1n;uidB arc liehter
Lut whoDc rcRponscs 1nnst be quicke:1:. The opcrritcir ·can also lirnH the total
nuinlwr of ur:crs supported at any one tin1c. Opcra1.or-·in1p~scd p:iranwters
1uay Le obt:ainccl by issuing the QUERY console function.

Bdore a Uf·er {s authori;.-.cd to u::c CP, he rnu:;t be assigned a USJ•:IUD, which iclcnt:ifi(:sJ\11 vir1.n<d inachine J /0 operations arc handled by CP, which irnrnt translatethem into real n1achil1e 1/0 operations. This require:; t.wo tra1u:l;;.tions,accomplished as follows: CP intercepts all user I/O when Stc1rt I/O is issued.
It translates virtn<ll device addresses into real device Rd<lrci:;~;cs, translates
virtual coi·~ storage addresncs into real core storage acldrcs:::es, ensuresthat all ni>c·cssary pages arc in real core storage, bnildr; a CCW stri.ng for
the user, and issucn SIO when the channel is free. When CP i·eceivcs aninterrupt in(licating I/O cmnpktion, it sets a 11 rcady··to-run" flag in the user's
virtual rnachine status table; when control is returned to the virtual 1nachiue,
the proper J/O int.~rrupl: is siinulated. The virtual rnachine i1; not givc:ncontrol frorn the tinie it issues a SJO until CP delivers the simulated 1/0
interrupt. In the ineantiinc, another virtual n1achine(s) n1ay be operating.

IJJ.111 to the syr::lcli1, and a p;, ss ,,;ord, which is c:hecknd wheli he "lor,s in 11 , AsE:ociatcd
with each US£1i.)D if: a table describing the vfrim1l machine a:rnigncc1 t n that Ufh~i:.

Whenever he Iotf; in, CP sds up this virtual machine for hin1. Although alJ then1ay be different, ino:;t will be f;et up with the: ·ronCi:;ura~iori e.xpcctctl
Ly CMS, the n1i;:isl co111nH•nly nsctl operating systc1n. They will include at ]cat;t 256K
virt~.i\niachint'.H

bytes of core: s\oraec, two disk drives, ~ con~;o]e (the ter1ninal), a card-read-prnich unit, and' a printl:r - another di~;J~ drive and two tape drives arc optio11al(tapes inust be 'enabled G'1 rcqncst, by the sy:;te1n operator). The real syr:tcn1 willusually have. a larger nu111bcr of clink drives and/ 01 • a drurn, n1ore tape drives, andperhaps inore core storage.
Because there i:: not rooin in real co1·c: for all ui::cri:' virttnl core -1 tc ·I ·lll•ri· ni 11 ·•'' .
.
.
. . .
' c
<: llllCj\lC ca L'(118 11 •• c.r l I,y l I l(: 1;y:::tclr1,""·<>V1rlual core is divided into 40C)G-b rte blocks of
11
storagec;1l!(•d''p-1gc·~
J\11 I",,1.t ( · urrcnt- 1y a\.f.Jv(~·· } the: :;y~_;t:cin, o·
.
_
· ·
'
·" •
pager; <tre kept, by
d1ri:.:ct acct,ss Sl'C011Ch1··y stoJ"tf'C' - · · 1·· - · ] ··.;ll})"l<q·d" in] .· l f''d~· .tr .lVe dnt 1IJ<tc!1vc p.tg<:s ch;111gu .status they arc'L> '.
anc 011 o rea core. \','hilc the p<1p,ing opt:l'ation is being 1wrforrnt·d fo··om.: virtual 111;1cl1in1!, another virtual niachinc can bC' o11c·r·1 tinrr•1·11, · ~ ·.
..
'.
·
· '
t,•
.
: p,q~1ng cip(~l'at1011
<"

•

i

',

II

I;

l;

(, .. 1-U:
1. o. o. 3
J\11 virll!:1l l!::1.cLL;r. t 1;1it r•}cor<1 "f/O it: r.i;c1•.1)(·d O"l di[]·. Ly CJ".

'J'lii•r:, <':ll.'/ r·:•_ql cl(_cL

lo l>•.: "r·::~id" b~· <1 vi1-l\i:il ;r·1:c(·}_L;·1 ;;iu~;t li:1Vl' 1_1, >l rc;,d l1y ('.J'' i'l JU•.' tot]: \1'::· ... ::.;
c:lll fnr i! 0~1 Li:; vh·tc;-.J n1;·i.chil1r::; the.~ J'~i.)· ...dc;.\,l. <1 ~c~\. nn1:·;f. L-: \':, be· . . ·;, Fi eel_ r1..t:" ~· J.

.'11·l~·r CP, of c.·otir~:c, tJ1r·:_:c <lcvjccr: ;'r<\ druu];dv;d t;L1(l rc:.1n: .pj-icd tl• d:;{f(:~·(•111adclrr,f;rocr; ;11!<l/c1· d;Jfercnt clcvic<:S, For i11:.~1<1• 1 cc, CJ-,.J:S c:>.j'C·ciro ;1 10;;?, pri11t<;;rLcylinanl Ojlci:;.f(lr 1n conJ:.ll~"• '.Jul r11or:t J'CJYJCJU: l.l:rn'.itJ<''.L: ;·~·c. _?-'/~] f;; CP h~:nr~1r,:-;all cl1;inl1l!l prog1"<1J11 n1or11f1c;1tJ.on~: nccc:-:r,;1ry for lh1:; r>1in1.JJ;·11on.
1~· C<trcl C1 .:L1i1Ji!lb ILL· u~;J-:1uu, 1'0 Cl' L:1u;,•t; v ;.<) thf' Cd 'l'l1··iin;,,:(: F1:. jc, fo1·,
J .:tler,when th.~ vidu;d. 1n:·c bi1~c ha:: "rr ;1d" LI-": cart1 ~11·ck, ;1 r'<~n] rr:;Hkr CJld··c·l··fiL; i;;:-:i11,nl:tti·r1. C>1:"1 ai'rl )Ll inl('r oulr·ul, rdtnil;1J•l:' 1.;peolcd, if; n<•i; q11.cn:_.,] fc,1· plrf~dc;iJ
ou1put \1»til CP i1: t•c.'tifj."1 cir CJJ'l···of .. fj](: i11 c>rn· of th""" way[:; ih~' n;:,:r ln;:1• nff
tht.•'r:ys!1c111 (<:n• 1-cf-fik i•-, assunwd); thr: CLO:;!•: cof\:3(>lc f11ucfinn 1:pcci:'ic:: tl•('(driu.d) ;\dd""~':' or the: d·.~vic0 lo lie c.Jo~·:cu; or CP cletcd:: an hw:1licl CC\'{ achlres::"(t> fht' dt·,·icl' (vnd-nf .. filc~ ir; asnunccl).
FurlJi..1· ord]'nt fol' a cln1;cc1 ckvicl'. ii:
asr:trJJl('d le> 1.[;!rl ;1 Hc,v: file.
fio that the 1.yr.tc1n operator cal! rr•p;1ra1c pLyi::ic<1lOdll•lll, prlntl'd ;•11.tl l'\mr·h<,d cnt1p,1l, file.::; <•l'C! alw;•yg inc:cc·th"l hy a rcrunl (1:1tppliccl
liy CJl) th:t1 LOJ•Ldn1: the u:~.r.:run.
1'llw CP 1·0:1::01<• im·.--~i.m:: :dlnv.- tl1c t•:~, .. · 1.o < '' .fi·nl l;ir-: vll'f11a! 111;1 1:lii;i1: froin tlit~
tvn11i11:d 1nncl1 a~' <>n opcr; 1 fo1: co~11 rol:; "- real :u,11.hi.Jw, To ]'''rfu1 Jll an 11 'L, furin;:!:11•,--1·, !he uc:vr lyj•cr: ''Il"L" <1H<l i\ cJ..yict• ;1_,:d,.cnr;, Tlir: \•:"'l' c;11• ::lnp hir.
virhul 1n,1chi11e ni ;:11r (i;:l{'. (by dq 1 rcf:f:i1i~~ tl1" .ATTN hey) <tnll 11·q1ir :.1 dJ:·p]:,y (:fi'ny porlic·n of hir; f;{(•l'd[',C itnrl rcl~L•kr:-;. Ile tan ITHHlii)' the cunf('nfl;, H ckr:in.d,and rc:otar1 l1h· 1JJ;,.('l.i.11<·, CP ah.o rccogJJizcr·: a few f·!'•-·(inl ]'l'"i>CH:c c·c-i1·1ui;11rclr: 1
Eu ch<':: the OUEllY function rni-ntiorwd ~,_J,ovc, which n:>:e uot norn1al c.r.•1wolc f1mctio1

The Cnmhrid(:e Monitor s,-stc1~1 (CJvffJ) i~ a single-user, co11vers<ttion~d opcrr•l.i.ng!'yrtnn, c;1pablc
rmrni1;;; on a l'L-;11 n1:i.ddw· au well <H: cm il virt Li.ti 11,;1cl>i1w. It
int\--q11.;·t'; o1 i:iinpl1· c11111111;111d l.mg1wr'' typc:d i11 ;11 t.Lc C>J>c:J'ilt'fl1·'1: c·w1:; 1:il1: (in tliif:cai~,·, the l1Sl'1' 1 S rcnw1'· il:nni11:il),orV/h..~!h('r(, .. ] .. 6t;
I. o. ll..·J

rmmillg on a i·c;d or a virtual n1aclih><:, Cld[': exp~'ct:: the following 1n<1d1\JE,

c 011 Cigur a ti on:llntk.1· CP, •tll Ci,1,') 111-:r:!'l; i.:h:1rc the n:;•d·-<JJ11.)' r;y::k1;1 c.1i;:k; Ul! it rv:,idc lh:: Ch1S
•H•cl 11H: t•tlwr ruufinvs <i11cl lil'·~·::ric.·!' lh:.t
CMf; c;ill:'· ill: nc·<.·dt.'d. [;incc c:-ic-h vid11:1l r<iachii)<: i:r1<tinl·cdnr• itH 0\\'11 copy of CMS,
ura:1·fJ ·JJ1«y 1nodify H ii:.; th•:y winli \vi.tl1oul afkcUng .C'il.hc:r tLt: :;y:.teiu tl.isk vcu:ionor the copic:.; in of:hcr virtu::l niachinP.(;,

l11lClcu:-; rm,f.in(:i:, whjc!J the \H•er IPL::,(,Jv~:; c·o1n.ua11rJ~; f.dl.11:1flu·ally inlo four c;1(L:gork~::
CXl'C\lti.on

control,fiJ.,~ 111:111;1,,.il;tl;<'Ir,

cci1npilatio;1,

nnrl lkbngging ;ijrl;,.

'J')1C·. filv li:.11cllin1• cnn11tF1n<lr.: ;;llnw th<'. \1:,'<•J' tri c-rcat.l', r:co;iy, Hiovc, < c.1·1-.lJine i !trl
cra:;c cli:d·. file~:· Otl1cJ' c:o1i1r;1;1nd'> ]Jl0\'ir11: ;1r:c<:ns to llH: L11r·: l1Jtit:;, ;11i;,(c;:,mHl c;1n.1-r•_:;1cl--p111icli. Uwlcr the CJvi[-: linJ:.;t;;l 1;c!J<.,·n~·, ;r.Jl or th(::;t, ,:cJn111:tJ1ds
arc avail:1Llio to cxr:cul.il1g progra111s ar~ well i!f;tlH' user at th.-- tcrininal.

to···1"' Clv!S ];•ll[;lEtgc' prn,/r;::on: ;c1rc the .r::.11~1c onef; twcd tu.J<lcJ.· 011':1?IL1:_; f;ys[·crn/3(·0\OS); lbc:;c .inclur:·~ A:.:1;t>Jnl11r:r (F). FCll~Tl~AN IV (G), a!.id 1-'L/J (F). Th(: /,r.r:c,r.J,Jc ,.
p1:cHlllc1·1-: olijc·<"l: prog1-;r1ns that Joray he l':<r·cu!l'cl mic]r_,,- either CJ11::; or (Jf;, clq><·nr1ii•f'.
011 Iii<: 1u:1l'ru:; 11::1:d in l.111' :.;nun t· J•r<11•r;r111.
;;p· ci;il fih:··b.r11dli11p. 1 c.i.1ti1w~; forni;:('J'O Jihr;il'ic·r; ;in: incl!ldccl.
The FOl~Tr\/'1·1 ;rnd _PL/l cC1m;>ikr:; ;1)1;0 fn"ochcc
O:i--c01np;11 il,Jc: ol1jccl. Jl"O[~r;un~;. (Tlir: l'UHTl\/'1~ i:::-.cc11Uo11··l.i111(: 1;11ppor1.. progr;un:;havP heel! Jl10llif-.iccl fo;· C.Mf;,) The_; snonoL CC>Jll!-'ilo..:J' anrl i\t::..c1111.>~(~1'-illkl'}>.1.'l'lcr
were achpfccl fro1n p1·ogran1s rlc1,;igncd to execute \mdcr OS.

------------------------------------------------------------------------device

virtunl

symbolic

addrcnf':

1rn1ne------------------------------------------------------------------------1052
231 l
2' 1 l
2311

009
190
191

CONl
J)Sl\ 1

192

DSJO

]•103

OOE

2540

ooc

COllS<)lesystem tlil;k {rea(l-only)
permanent cliHk (user fikfl)
temporary disk (work space)line printel'
card reader
card punch})~;[\?,

PHNl

nmu

25•10
2400

DOD
PCHl
180
TAPl
2400
181
TAP2
At least 256i< byl<"s of core storage.

The dchuei~ing facilil y of C:MS allows the tu; er to [;top bis ~Jrogra111s at prcclclPrn1in«d )'Oints ancl cxan1inc his registers, P:·3\'/, and storar;e, <ind rnodify tlt(,i;(,·he: clcf:ircs.
This info1·n1ation rnay be~ typc-d out nt this terrnin.-11 or printed offli11c. A program interrupt gives control to DEBUG, as docs tlir~ external inter1'upt
caused by the EXTEH.NAL console function. The usr~r inay also employ the program
trilcing rontincs, which record all SVC tranHfcrs, or will 1·ecord just those intape clrivc

tnpc drive

Note. that the above: dC'viccfl represent the rni11imun1 configural.ion for CM.S<''l(ccpt foi· tlrn following thre\· dcvicca, which arc oplionnl: DSK3 at virtual
address l 92, TA Pl at virtual ctcldrcss 180, and TAP2 at 18 l.

··u :.: $!!!1#444tq'Wiii . £! j.ifai!ii!iiiii iL!.i:WUIH,IU i . J. I .. ii

lllL.

. .!

.kii,J

The cxl'cU:-i(l)J crn1trol co1n1ncinc11: allow tlw \ll:«r to )o;:d hir; prop;1·ains fr1,n1 i-dngle
olJjcct <lee],:; (tlll' fildy1w TEXT iH rei;crvc:cl for rdocatalJl<: object prngr,11n::;) or·
fro.in a library of progranrn. lk call p;ins a lint of paraniete:rr; to liin progr;unfr<•n1 lhc tenninal, and specify the point at whicli ex.C'ctilion is to lJ<f•.in. To avoid
rdoc;tfi.on (J,yp;1;;:; the rr;locating loackr) lie can create a filr: con:;i~ting c1f an
ilrnqjl" of tl1c portion of core f;to1·;1.ge containing bis progra1n, and Jo;•cl that nonrclo<·atal.il"! C'CllJY back i\l any tinic.
Since the loading ('(ljfl})l;rnds Ci!ll h<! acccfisedby cxcn1fing prop,r;tn1s, OVC'.rlay ntn1cturcs 111;1y be fict up. The user can also
c1·catc a file which is a scri.ci:; of co1nrnanus, and then execute- these co1nrnands
by typing a i;ingk line (loading and executing that file).

which an Prt'or rel11r11 is 1nadc,u;

I IJI ···--~-I:s : .; um:::: ea¥19a;:.. :; :UI u:: ... JIU! ;::::;u;:::::;;;:;.1111 m11111111111L m..llllllPI

l.L

9~30-67

2.i.0-i

9-26-67?.. 0.0-1· 2. 1. 0 FILE CONVENTIONS

2. O. 0 CP/CMS CONVENTIONS

Various ",rules" or c0Hve11t:ions nw~;t be observed v.il1en using the CP/CMS
systl'm, 'These arc di:1c11s1;f'd in the fol1owi11g 8Cctions. Inclmlcd nrc 3cliscus;_;lon of tlic fik facilHJ(~~; availnbk to t!i~~ Clvi.S w:(.:r and tile mcll1od:1
of jrlcJJtifjill[: thc~:e files, a <k~;cripLion of tl1:) 2'1'11 awl 1050 l<~nui11;1]s
a1I1l tl1cir u:;r:, mid a duc:c:rip; irm of the~ procc:dui·~::; t.o LC:! UE;cd v:hcn Joggi11g
in a1hl oi.::~ of l11u sy~:r;111. Also givc11 ~ire rule~> for typing input to tilesyr.tcrn f.L'o;·,1 a t<:n;1i1nl, mid a dc::.:c.i:ipt.ion of cacl1 of the cnvil'onment:-:
to wliid1 tLis input 1>1ny he c11kred.

One of the purposes of CMS is to provide the user with V.:1rious file-h:rndJing
facilitks. Filcp to be used under CMS may be stored on dick, cards, or m;ignelictape. llowcvcr; most CMS commands assume tlwt files nrc stored 011 disk. Thisrncaus that files ston_~·d on media CJLhcr than disk must be t;-::nsfc:c.rcd to tlisk before
many of the CMS connhundi; _cnu b8 if;sucd for l11em. The cown1~111cls whi.d1 d.::~.J withtraiwfcrri11;_;· files hctwcc11 dit:k and other media a1'c discussed in 8cl·tinns 3. 1. O.
Co11vc11tions giYc11 in this i::cction apply LC> disk files or.ly.
Disk Facilities'l\vo dif:k urv<lfl nre fivailnbk to cacli CMS user for storing infonnntion. Thesearc tlic pcnnnncnt disk area, wl.crc sto:ccd ini'm:mation is rcrniuc<l uutil the user
rcqu,·::.;ts th:1t: ulJ or p:irt of it be dek, .d, and thoJ tcmponiry disk aret:>, where
iuforni~ttion is n~u1i11cd only from the time it is created until the use1: ciJds his
tcrl11inal session.
For convenience, these two arcns arc often rcforn.:cl to as
the w;cr's "pc~rmrt'ricnt cl.isk" mid bis "tempnrary clink" res1x:ctivcly, nltlwughthe size of each area seldom co1wtitutcs an entire physical dbL The sizes of uuser's pcl'nwnent nm! tctnporary disks ci:rc as::<it;1wcl by t Le syt:tcm adrnini::;t;.·<ito;·at the time be~ eutaLli~.:hcs l'hnt p~n;on ns nn ~1t1!1·orizecl u~;er·of the CP/C,;'LS ~'/utcm.
'fhcsc nr;f:igm:d 13.izcs arc based on tl1c amount of disk sp:1ce av;dl:1blc and the: amountwhich the use:.: is lil~dy to rcc1uire. Ansignl,c.J dis!: sizes mny vn:cy umt'.ini:: usL:rs.

A third dir;k area accesucd by each user io·the system disk, which is composed of(1) th0 CMS m1cktw, of which c;1ch user receives a copy, and (2) the clisl:-rcsiclentportion of CMS, which is shan~d by nll uocrn'. The system disk is rcad-oaly; nnyattempt Lo write on it will he denied nncl will couscnn error mc:usDge to be typec1
to the uncr.
ln..fonnation sLm:cd on the~ permanent, tcmpornry, and system disk:.; is m·gani:t.cd
into files. Files on the p3r111nnm1t and/or temporary disks are referred io as "userfiles"; those on the system disk a1·c rdcrruJ to as; '\iystem files,"File Jclcnti ficrs-·-·--· --- - ··----·Each file must. have a unique identifier, which is composed of a filename,a filctyp<,, and a fih~moclc. This identifier., or a portion of it, is used L}'
the various CMS comrnands lo access user and' systC'n.1 files. If a new
file is created with an identifier· idcntkal to that of an existing user file,the orir;inal file will be erased,
·

,

I

JI
9- ~-I0--(>7
7-1 c>(,g2. L 0- S?.. 1. 0-?.

The> i1lc11:::1fr: n1:1y he any comllination o~ from l tu 8 Jh'n-bhllL 1':J_·,cu1cch<1 r 1ctcrs provided the f]n;t chci.raclcr. if; nul a z(•.ro, an aslc.l'i::;k, apt~riud, or a le.ft parenthesis.
With syt;f<,in fHr:r;, the fi.lcnnn1c is il1c nan1c
wliicl'l is issued Ly th~, usci· in Ci'.lling 11 [;pccific con11n;u1d, and ir; <ilfJo then11n1" of the progr:1n1 who1:·c code conr;titnt~'s ili<'L coinn1<1nrl. P•'-rn1:111':nt ;111rl
tcn1por;iry filr,r:; inay be an;igiwcl ;iny filcJ1anw th,- u:;cr wi1dws dnre filcna111c:s
in n,.-rn;r.dv•~S do no! h:1ve <iny sprcirtl irnplic;iticnlS in CJvlS.
Filctype n1ay be any combination of froin 1 to 8 non-blank El\CJHC c-h<1r:-ictr.rs
prc•vidcd thl: first character ii, 1wl a ze1'0, an ;-11:tcritd~, or <1 le CL l'" rcnthct:i"s.
Ccrt:1in file types imply i:pecif!c: file cbar;ictcri::;tir.f; to CJ\1S. Wif h :'ysk1nfile~;, filctypc ir; used 1.o in<lk~:te \YhctlH:r the file rcsir!cs in the! rn1clcur; or intlw t;ish-resident portion of CMS. Filetypcs which h:-tvc specific irn]'lications
fur user files arc pivc11 in Figure 2. l. 0-A. TlK nscr in:1y <:::cign any of the
fiktyp(:s in this figure to ;1uy file he wisl1cs, but he should note th<it tl1e c:ornmandr.
which use these filctyp~s will not be r.ncce~>1:fully exccntccl if the contcnlf: of thefile ;1rc in any forrn other t:lrnn that which the asi::lgne<l filetypc implies.

SPvcral of the CJ'vfS c·ornn1a11ds c:n:atc filcH fo.t· their own use on the uncr's
pern1ancr.t disk anrl ac;sign specific filcn:u-ne~filctypc comhinations to ther.ci
files. Tl1(:sc;_· filcnamt:-filelype co111hi11;1tions are listed })('.lo.v, anrl should
not lie assigned by tbe user:

assume thatfiles witl1 these!'.!I~_1nJJ~'-~_'.:l_J\:;:;crnhlcr J<in:~il·1;;cmiurcc code

Fortni11, Ftlil

FOR'l'l\AN

Fm:trr111 soHrcc cock:

PL1, Edil

PLT

PL/ l r.ourcc cC·(kSp! 1, finuwball

SNO:IOL

Spl 1

Sl'L1

Seri plSCF.JPT- Load, U·;c, Hcusc, $, Txtlili

TEXT

Txtl ih, GI ob<ll

TXTLJB

Updatefiletyp·~er ca! ing connnand

Loaclrnod, $MODULEll'<PUTINPUTl(TJ-:MP)(nISK)SNOBOLLISTF
LOAD(INPUTl)(INPUT2)FILE
f l LE(FILE)(TFILE)
TE:lvlPFJLB

EDJT
EDIT
COMBINE

Exec-,$

EXEC

EXEC
MAP
FJLF:
FJl,!•:SCRIPTIn arlclitiCln to the above, it should be noh::d that Ha user filP. is cr~<1leLl whof;efili-narnc and filc!ypc arc iclcnlicnl to tlio:;.c• of a file on the disk-i·csi<lent portionof CMS, the user's file will he nccu;secl in place of the ~;ystc1n file. Reasonsfor this arc described in Section 3, 0. O.

Tlw third portion of the identifier, filcmodc, consists of two charactcrr;. The
first character is a letter indicating the disk area on which the file rcsiclef.1: "S"for :1yst_c1n disk, "P" for perincincnt disk and "T" for te1nporary disk.
For

FOJU-.1/,T

SYSTN

A:;~;.;;:111hk, Edit,filcll<Une

DJSK, TAPESNOWB/\J,J,, SPLl
LJS'fF
LOAD, $, USE, EEUSE
SC JU PT

contain inCoxmatio;1
in thi.G

Script input

J\('loc<·\ahlc ohj:·,'.t ('<'d<.:lihi-;iry/rny com!Ji11ntiu11 cf C:j,j;;
cornrn~ntb

UFDJ\TE

llptbtl' conln•l ;rnd rcpl.::ct:·
mcnt c:tnl image~'

Maclih, Global

M.\CLJB

Asf;c111hler lang1w;;e;: rn<il:ru
ddinilion ]ibr;)1~y

Ma cli h, Edit

J\Sl'JGO

Asscmhlc>r l::ln~;11~1ge Hrncn•
definitions

SYSUT1
Asscinhlc , Pl ,JSYSUT2

Assc:mlilcr or PLJ utility
files

SYSUT3

Asscrn!Jler or cc1111pil.:rAssemble, Fortrnn, Printf, -PLI

LISTING

Asscmhlc

DJAG

Assembler diaguoslfc::;

TxtlihMAP

Library map filesource ctntcmcnts :incl
corresponding mac hi 11c
coclc

fllGUllE 2.1. 0-A Filctypc Implications

•I'

-

:11

u: '"4Ul'i•4 :::;;a:;a:ea:::a:1Jw:u:::::u:;;:a:;.;;:::za 111e#:;;;iii;: : u:::: 1.1 . ::;:::a. :u q.::;: ;JJ;;u;:;::;u:u:w;.::::;;a;K: ta:;;;::c:.:: s:JtWtJ.t:::as . . 14411uzwx: .q44; _ z¥2441.a ;asA

J4¢$llij# . .I. iiliil:UHA Lii.iillll!Hl"ll!ll!ll6-15-70
2.1.0-4(system files, the second character is always a "Y". For user
files, the second character is a number from 1 to 6. These
numbers have the following meanings, although the restrictions
they:imply may not currently be implemented in all cases:

1 or 5file may be written or read.

2 or 6

file is read-only.

3

file may be written or read but is erased
after the first read.

4

file is read-only and is erased after the_first read.

File Sizes(_

Files stored on disk will be formatted into records 800
bytes long. This formatting is handled internally by CMS,
and is not controlled by the user. The maximum CMS filesize, assuming that the user 1 s assigned disk area can accom~
modate it, is 12.848 million bytes, or 16,060 records. If
a file consists of a source language program, a size limita-- tion may be imposed by the language in which-that programis written, and this size may be smaller than the 12.848
million bytes allowed by CMS.
Although there is no inherent limitation to the number offiles a user may create, he is practically limited by thesizes of his permanent and temporary disk areas. When auser has filled either of these areas, a message to thiseffect will be typed out at his terminal. Refer to Section
5.1.0 for recovery procedures which should be used in thiscase.
A file is "accessed 0 when any portion of it is read or written
Whenever a file is accessed for the first time by a CMS commandor function, the file will be automatically opened. "Opening
in this case consists of making an entry into the user's
active file table. CMS can open an unlimited number of files,
but the language processors impose certain restrictions on
this number. For example, only 30 data set reference
numbers are currently defined in FORTRAN. CMS commands
likely to access more than eight files will close files (i.e.,remove their entr-ies -£.rem the- aetive f i-le table by executing_ __ _a FINIS command) as necessary. Also, all open files areclosed by CMS after the successful execution of any CMS
command.
0

I"'\

"'1

"~

I(:
9··:10-6'1

05/01/69 Q
2.2.0-1

2. 1. 0·.4

17

.

2.2.c

sy10tcm fdc·s, tl1;~ sn~n11cl c:ll:n-Jc["C:'.j.' if; r.h;~1ys n "Y ". For u;;c:r f.i).<.:t.i, thescco11d cll:~r:icte): i~ n l'uin!;cr frum 1 to Ci. "Jh•.::i;; nui:)b::n~ lvtvcfll1'.' foll u\\'iPi~
rnc·anin,;~., [il.tl1riui·.l1 th(: ru:tr.ic~i0nL: 1.li:'; ir.i;11y ni:1y nut cuL·n·11fy be· impk··
m~ntcd ii:i all cur:c:>:-,,file nF1 y be writ I en

m· n:ml.

theccnvetsaticnal

inFut-cutFut device
used to access thes}stcw is cefecr~d tc as a "terminal" and is operated by a•·ue•H" who tyi:eE inforreaticn that is ttani::roittPd either by telephonelire ur by ~etwanently-connccted virinq to a ccmi:uter, ~here thP
lDfcrmaticn is LFCeived and frccesEed ~y the system.
In addition to
iec~i,inq and rrocessinq information, the system may cause infcr~aticn
tc tc ~yrcJ cut at the tErrr.inal. Infcrmaticn typed from the terminal
kl''Jbc,nd by the usec is called 01 input 11 ; that tyi:ed out at thG termirrnl
t y t h Q H y s t c Cl c I l: y a u E c I f I c q [ a If. i f) ca 11 e d II 0 u t fll t ti •CP-~11c~s/

file is r,·:.-;d-0111y.

1ER:-IINA1 USAGE

file n1::y be w:riLL'::11 01:
after tl1c fi rsl i;t::•tl.

~ither cf
fcur terminals nay he used to access the CP-67/CMS
S}::t..:11.
'lht::..;e are (1) the lBM 2141 Communications 'Iermindl as shownin ~i~urE 2.2.0-A,(2) the IEM 1050 tata Communicatic~s System

tecrr.inal shewn in .Fiqµrn 2.2.0-B, (3) the tn:e 33 teletype terminal,(ll) tl:ri tvrE" 35 teletyp~ teuiral. Any of theseterminals may ~~ccrnectFd to the ccmFuter by ditect-wirinq ot ty telephcne lino. If
th: t-::riri11al if net dirEctly wired tc thf? ccnq:uter, a Data- Phone(!.ii:iiLtt tc that shown in f'iqure 2.2.C-C) will be Flaced near thetErmin~l keybcard, dnd must be
used to dial an installaticn-specified
n~nt~r in
crdEt tc estatlish a ccncecticn ~ith the computer.
Th~
Jrcc~Jutc
fer lsing a Datct- rhone is descrile<l under .f£_1Qgin inone

Fik Sizes

This fo:r··S<:ction 2.2.2.

(
Althoug!J tli(:JT if: no iri!11:11:11t ]' nit<•tiv1 to the 1H1!1d1:.>the j~~ pr:;1ciic<;]Jy ]j·,nil'_•d hj t .' .<:itcC~; Of Jtir; j)UJn~ll'ICJJf Ii 'l teflljl(ll"ill')' di~:k m:enS,
Whr..:11 ii l):1(:J' !t:1~, f;llld l'itlh . ur tk::·:c n ·~8<W, <I l11C81.::1~..:. to l1iH cffL'Ct will lie
ryp'..!d rn11. nt hi~; t<:riniu:d. tcfr1: to Section 5.1.0 for rccovc
pJ:ot:c-'!du1vs wlii.chshould b;.: nscd in llii:; ca c·.
~
A file b<1cccs~:l't1b:·n auy i1c1rtion of it is rcacl or wriltl~n. Wh 1cvcr a fileis <ll'Ce.':;F:cd
for the · 1·~:t tinw liv• a CMS c:urnmnnd or f1111c:.Uu11, tlic file wj]l
be
I
.....
nutwi:;:t~cully op::11'. I. "Op.'.'ni111·." in n1i:·: cnr;c: cow:i:;t;,; o[ mal:i111~ n11 c:nh:y into
the usc1;'i; •1ctivr; l.c t:1hlc. O,Jly eic,ht c:11r.1·icr; moy l:Y.i:;l in this tnhle <ll n11y
giVL:n u1i1w. Ci\~ COJllll1:•1HL ]il:dy !'o ;lt'.(;(';;,c; nio.rc tli:111 eight file:; will cJo:;cfiles (i. c,, rc1 ov1.·, tl1cfr c11tri,:s I.rum tl!c active file- !able.: by executing :i FlNJS
co11m1:1qcl) :1s ncc-,·.:f::ll.'y. /\J:;o, all op_·n Jiles :u:v do::l'cl by CMS afl:cr llic successful l'Xec11tic;n of il:1y Chti conmiand. The uncr cloc'.'J uot 1wccl to he co11ccn1cd
with oi;u1dng :ind closing f1ks except when ltc dc:sin:s to [lccc:::s more than cighldisk filer; with one of his own p1:ognnn::: •11......./

11

j

(.__

·

If

9-21-67

I?

9-2] -67

2.2.1-1

2. 2. 1-2

2. 2. 1 TERMINAL CHARACTERJSTICS
2741 Cha_:!.2l_c_~?E!stics
The IBM 2741 Communications Termlnnl consists of an IBM Sekctric typewriter mounted on a typewriter stand (sec Pigure 2. 2. 0-A). The stand includes
the electronic controls needed for communicatimw, n cabinet for mounting n
Data-Phone, a rack for mounting n roll of pnpcr, and n working surface. To beused with the CP/CMS system, the 2741 sltoulct he C'quipp.:.~cl with the Transrni t
Interrupt special feature a1.1d the Raccive Interrupt RPQ.

~CTJWCJITJC--J 1····-·1r··--Jc·1rno DJ[~~C~CJGG88CJ~G[~[~JL~W E:~]
:·

1

<

;

_?___ -~-:%~-- _.?__

'
6_

•

.(

......!__ __8-__

>

9__

)
~

+

:

&

BAC r,SPACf

D [E[]00GCJGJG000[JJ[JWIJ
Cl.R

111e 2741 has two moclcs of operaWm: communicate mode ancl local mode. 111c
mode of the terminal is controlled by the tcrni inal mode switch, which in locnted
on the lcfl side of the typewriter surnd. W!1Cn in locnl mode, the tC'rmin:il is disconncckd from the computer. It then functions as a typewriter only, and no information is transrnittct! or received. When in communicate mode, the tcrminnl mny
be connected to the communications line to the computer. The powt'r switch on theright side of the keyboard 1mrnt he set to ON before tbc terminal can operate ineither communicntc or local mocle. 'f1ic procedure for establishing conncl~tions
with the computer and the terminal switch settings which should he used arc
discussed in this section under 2741 Initiat_!~-~~~~£c!Ur£~·

g_]0QGJ8GG~Jl~[~DJ[J RC:J
TM

I

SPACE BAR

I

D
ATTN

ON

OFF

FIGURE 2. 2. 1-A IBM 2741 Keyboard (PTTC/EBCD Con.figuration)

Either of two 2741 keylionrd con!iguratfons may he used in accessing the CP/CM')
system. TI1csc arc the PITC/EBCD config1irations (shown in Pigurc 2. 2. 1-A) andthe standnrd Selectric configuration (shown in Figure 2. 2. 1-B). On either keyboard
the alphanumeric and special chnractcr keys, the space bar, power switch, theSHIFT, LOCK, TAB, tab CLR. SET, and MAR REL keys all operntc in the snme
way as standard Selectric typewriter keys.

On most 2741 terminals, the space bar, backspace, and hyphen/underline keys
have the typamatic feature. If one of these keys is operated normally, the corre1.1ponding function occurs only once. H the key is pressed and held, the function ls
repeated until the key is released. The following keys have special significanceon the 2741 keyboard:~nrnornwrnwmwmmoGJ

D

RETIJRN - 111e RETIJRN key is hit to signal the termination ofeach input line. When the RETURN key ls hit, control is trnnsfcrrcd to the system and the keyboard is locked until the system
is ready to accC>pt another input line.
ATTN - TI1c ATTN key is used to generate an attention intcrnipt.
· It may be hit at any time (since it is never locked out) and willcause the keyboard to be unlocked to accept an input line. Refer
to Section 2. 3. 0 for a discussion of the transfer between environments
which occurs when an attention interrupt is generated.

8bJGGbt:JtlbJGJQ.Gt~[q'0QNr;;JJQDGJGJGJG[]GJQLJDD
BACKCE3JGJGJGJCJGJGGJDD[I]~I
lsH~•nlI OFF

FIGURE 2. 2.1-B

I

SPACE BAI!

I-

IDM 2741 Keyboard (Standard Selectric Configuration):J\.

The 2741 paper controls, such as the paper release lever, line-space lever,impression control lcvc1·, etc., arc identical to the corresponding controls on
an IBM Selectric typewriter and operate accordingly.

~
I

--

'~

t"

~

""
9-21-67;J.;,~'9-21-67

2.2.1-3

2. 2.1-4,.....
Any invalid output character (one which cannot be typed by the terminal and!or which no keyboard function, such as tab or carringc ret11rn, exists) willappear in terminal output as a vcrt:ical bar (r). For a further discussl.on of
2741 ~ha.ractcristics, refer to IBM Manual A24 ... 34 l 5.
274!.!_n_!.!!_n_tL~_!'J."oce_~ures

The steps for readying the 2741 for use arc described below. After these steps
have ~ccn performed, µ-occed with the Login procedure dcsc:rlbcd in Section 2. 2. 2.
1. Set the terminal mode switch, located on the left side of thetypewriter stand, to LCL. This insures that the terminal is dis, connected from the computer.
• 2. After making sure that the terminal is plugged in, turn the
power on by pressing down on the ON portion of the terminal
power switch at the right side of the keyboard.
3. Check to sec that the margin stops, which are loc:atccl on thetyping guide just above the keyboard, are set at the tkslrecl positions(normally 0 and 130). If so, proceed to Step 4. To reset a marginstop, puf:h it in; move it to the desired position, nnd release it.
4. Check that the tabs arc set at the desired interv1.1ls by tabbing
an entire line using the TAB key. If the settings.arc satisfactory,
procevcl to Step 5. Note that these tab settings do not govern theinternal positioning of input characLcn;. Pora aiscussion of internal tab
settings, refer to Section 3. 1. 6. lf the tabs are to be reset, position
the typing clement to the right margin, press and hold the CLR, portion of the tab control key, and hit the RETURN key. This willclear all previous tnb settings. New scltings may be made byspacing the typing clement to the desired location(s) and then pressing
the SET portion of the tab control key. Afte.r tnb stops have been
set for the entire 1inc, hit the RETURN key to position the typing
element at the left margin.
5. Set tltc terminal mode switch, on the left side of the typewriter
staiid, to COM. The terminal is now ready for use as described in
Section 2. 2. 2.

_J1050 Characteristics
The 113M 1050 terminal is composed of the 1051 Control Unit and a 1052
Printer-Keyboard, as illustrated in Figure 2. 2, 0-B. The 1051 Control
Unit includes the power supplies, printer code translator, data channel,
and control ch·cuitry needed for 1050 operation. To be used with the CP/CMS
system, the 1051 should be equipped with the Time -Out Suppression special .
feature and the Transmit Interrupt and Receive Interrupt RPQs. The 1052
keyboard is similar in appearance to the standnrd IJ3M typewriter keyboard.
Figures 2. 2. 1 C, D and E illustrate the 1050 paper controls, switch panel,and keyboard. The alph~rnumer:ic and special character keys,. th.e sp:icc bar,the LOCK, SlIIFT, und TAD keys and the paper controls operate in the same
way as those on a standard IBM typewriter. The following keys are of special
significatlce ·on the 1052 keyboard.
RETURN-if the Automatic EOI3 special feature is included on theterminal being used and if the E013 switch on the switch panel is set
to AUTO, the RETURN key may be used to terminate an input line.
Otherwise, (if the Automatic EOI3 special feature is not avai1able;onthe terminal being used or if EOB on the switch panel is set to MANUAL)
the character transmitted when the RETURN key is hit will be consideredpart of the input line.
ALTN CODING -this key, when pressed and held while one: of theotherkeys is hfr, will originate a single character code such as
restore,~bypass, nuder stop, end of block (EOB), end of address (EOA),
prefix, end of transaction (E01), or cancel. Note that input lines
from 1050 termina.ls not equipped with the automatic EOl3 special
feature must be terminated by pressing the ALTN CODING key andholding it down while hitting the 5 key. This procedure will cause
a ca1Tiage return at the terminal.
RESET LINE-hittiug this key, at the left side of the keyboard, willcause an attnetion interrupt (lrovided the terminal is equipped withthe 'Fransmit Interrupt special feature.) The RESET LINE key may
be hit at anytime, since it is never locked out, and will cause the
keyboard to be unlocked to accept an input line. Refer to Section
2. 3. 0 for a discussion of the transfer between environments which
occLirs when an attention interrupt is generated.
RESEND-this key and its associated light (both located on the rightof the kcybo;-inl) arc used during block checking. The light comeson when an encl -of-block clwracter is sent hy the terminal; il isturned off when receipt ·is acknowledged by the system. If the lightremains on, indicating an error, the RESEND key may be hit toturn off the light, nncl the previous input line may then be re -entered.
While the light is on, no input wi11 be accepted from the keyboard.

J

oZ~~

9 .. 21-68
2. 2.11- 5)j
9-21-67i.

:r:.::.-:::!-=--~> :::~::-:: .·....... .
{·:;t.
.J ,j
\. if
J
•

,..

'r

c.\ \:~'.... . . -.....-MULTIPLf-COPY
lJ. ..
CONTROL LEVER. _.-,....__ ,•

r~(

I ..

·; ! ~1I.·11·-,:-~r·--.._--'·-·· -~~·"' ..J

"--

(·- L

2.2.1-6.·: -.·.-:-· ·1_1' ·,··-·-:-.:- ··· 1
PAP[R _ _ _ ]II. ~ ............ ~.. ···-'"··-- ., .

·_--·· "_l'_....PRltHINGELE~~N~•.

_,...'I!:ELEASE

I

~
LEVER
/ · . ··~. \ ·-.::~., f . ,LINE-SPACE_re~'· Ii ... J

LINE FEED-this key causes the paper to move up one or two Jines,
according to the setting of the Jine space lever, without moving the
typiug clement.

LEVER

J

DATA CIIECK-this key should be hit to turn off the associated light(lo its left) which comes on whcnver a longitudinal or vertical reclun dancy checking error occurs or when power is turned on at theterminal.

'

. ·.:

.,._•.'.I .

\,. .

·1

·_I

_...-)-- ..

--···":-.·:~.,:..\~.. _ - - , , ,'"' ·"""'~--~-· ,. ··~.~i - . .'-..,----..---~---,.,.. ,~-- . .

\Any invalid output character (one which cannot be typed by the terminal andfor which no keyboard function, such as tab or carriage return, exists) will
appenr in terminnl output as a vertical bar Cl).For further information on thecharacteristics and handling of the 1050 terminal, refer to IBM Manual A24-3020 •

,\

1>

('

I
I

(\"

..:~-~~---~J!J}~~~L~-=~:~-------·-----~:· ~~--- --~l~JJ?L~-~~:~:: . ~-lr~~:~'..~· . :~1 _ _ _ _ _FIGURE 2. 2.1-G

IB!\1 1052 Paper Controls

'
"
'
"
_
'
.
0

;: §;. g:: §·:: §::~m'..c-."''The procedure for rcaclyiug the 1050 for use are described hclow. Whenthese steps have been performecl, proccecl.with the Login procedure dcscrihedin Section 2. 2. 2.
1. After making sure that the terminal is plugged in, set th0 panel
switches, shown in Figure 2. 2.1-D. as follows::;;:;:;~"'''l'""''l'""'l'-'-l]rn!"''oN_,;;;;c.-[i'i•ill[[_100-· '""M
§ 7~ g": §.... '"tio'"'@'" €fl "@".
§ §ii»... l;.;;c,irli["°'@:: g·::o']-·~"..' -

W.:O"I.......

-·"°"'

1050 Initiation Proct•durcs---·--------------.,.,,_I!"'.

001-".!_-"''

Ul"~-2'!,. __ ,,.~~

J1111!1111 !1111,!1111!1111!1111!1111}.•111!111111111 !1111!111111111!1111!1111!1111 !111•!1111!1111!1111!11111111.!:•11,!,1111,li111.~11 ~1-~_:.:...,,

23 ~.,_,. 11 1.1

H~l:vr•u.r ..

switchSC'tling

SYSTEMMASTERA1TENDOFF
SEND RECREC
SEND

PRINTER IFIGURE 2. 2. 1-D

PlUNTER2
KEYl10ARD
READER I
READER2

IBM 1052 Switch Panel

PUNCill
PUNCH2STOP CODE
AUTO FILLPUNCIIoD
DD ~[]r71P<1(r.1~r-~:-inrnffi[J]c[~r~~nr.;;i•o·
D D ~ . . GGtJ0CiJGGC6c~100~EJ.~~ oD
D
DD ED00G~GG00GJDJCJ
D lmE. ~J::~:, D . CETI00088GGDJLJITIJ3Jr;;;;iSYSTEM~~I

FIGURE 2. 2. 1-E,_

StACI •••EOB

SYSTEMTESTSINGLE CY
RDR STOP

I

OFF
OFF
OFF
OFF
OFF
OFF
NORMALPROGRAMsec bclov:
(up)

OFF
OFF
OFF

IC an EOl3 switch appears on the terminal, it may bC' s-:t to either AUTO
or MANUAL. If it is set to AUTO, the RETURN key ·nay be used toterminate an input line. H the EOl3 switch is set to ~J.\NUAL or if it
docs not appear on the terminal, all input lines must be terminated byhitting the 5 key whlJc the ALTN CODING key is pressed and held down.

IBM 1052 Keyboard

~

~·

..)

I""'

~

'""'.
05/01/
2. 2. l - 8c,J/
9-21-67'
2.2.1-7.

/,.~/l1f£_j]_l~J£i~1£-~h~L~£i§1j~jj~~/!
P..-;Jfi<eyl.;card send/Receive)
mcdel cf
the teleq•pet)•pe 33
is EUEJOited bJ CP-67.
1he type 33 !<SF includes a typewriter
rteybo-1L·d, a
ccr.trol i:;anol,
a data phonC>,
central circuitry fer tl1e
tEletype,
ana roll
parer.
Thet~ra
33 KSH
keyboard contains all
stanJ.nd characters in
the conventional arrangement as 1wll as ar. u :n lJ E: r o f
s p e c ia l E y mb o l s •Fi q u r c
2 • i. • 1- F i 11 tu; t r at cs
t h e }; e y b ca r d
a n d c c 11 t r c l r a n c 1 •A 11 a 1 r 11 a t c t i c c ha ra c t e rs a r c c a p i ta J s •T h 0 S ll I FT
key is used cr.l} for typing the "uppershift" srecinl cliaracters. Tha
crliI. i<roy (Cc1;trcl key) is used in ccniunct:icn with other keys to
Fe rt c Lin
E pc c i a l
f u n c t. i o n s •Nc i t h c I:'t h c S H1 P T nor CT R1 ke y i s
sclf-lockiuq; ec:ch rrust. bf. dep:€sscd whio•n used.
1he KSHt~rminal

2. Check to sec that the margin stops--thc two blue indicators visible
in the 'transparent strip jast below ·the switch panel - -arc set as desired(normnlly at 0 and 130). If so, proceed to Stq) 3. To change mnrgin
sctlings, ·set the PRINTER1 and KEYDO./\RU switclv::;; to 1101'\'IE. Turnpower: on at the terminal by setting the main- line switch shown in
Figur<;: 2. 2. 0-U to POWER ON. Move the typing clement to the centerof the line by sp:1cing or t::ibbing. Turn power off ;1t the terminal. Liftthe top cover of the 1052 and tilt down llt<..! hinged portion of the front
p:mcl.; l'ress the:.· blue margin i11dicators toward the back of tbe 1052
and sitde them to the new locations. Return the hinged panel ·to its
originnl position and close the top cover.
3. Chpck the tab settings by setting P1UiffEll1 a11d KEYBOARD switches
to IJOr\1E, turning power on at the terminal, positioning the typing clement
at the ~cft margin, ;iml hilling the T./\B key repcntcdly. If the t::ib 1:icttings
are saPsfactory, proceed to .step 4. Note that terminal tab scttingl:l do
not govern internal positioniu~;· of input characters, For a discussion of internal
tab set:tings refer to Section 3. 1. 6. If t!ie tabs are to he reset, position
the typing clement to th::! right margin. Lift tbc tnb setting switch, labeled
CLR/SET, and hold it while hitting t!tc RETURN key. This will clear aJl
prcviot1s tab settings. NC.!W settings may be made by spacing the~ typing
element to the dc~:irecl localion{s) nncl then pressing down 011 the tab setting
switch, After tali stops have been set for the entire line, bi.t the RETURN
key to position th" typing clement at tlic left margin. 1\frn off power at
the terminal.
·

4. Reset the PRIN'lER i switch to SEND REC and the KEYBOARD switch
to SEt--.1D.
5. Tmm the main-line switch to POWER ON and continue with tl1e Loginproccd11rc discusBcd in Section 2. 2. 2.

In additicn
to the standard
keys the keyloard contains Sf'Veralk(yE \iith sp:cia1 · functicni:~
These. function keys are as

ncn- rrinti11y.fc1Joi::- this key qenerates a linE- tceu character. and trcves
the1i;arcr ui::
011e linG
without moving- the printinq!icchanisw.
l/hEn thGtermi11al ic used cf Cline,
the I.INE FEED key
should be·
JerrEsserl after each lino of typing ~o avoid over-printing cf thenext li1iE.
·

11~.Llll:l1~1]]]

this key is thecarriage return key and ~iqnifies t~ci
rhys1cal Erd Cf thE ill~Ut line.
t li s1H:l1

ke y r e f e a t s

t h e· a c t i on o f a 11 y k e y d cq: re .s s e cl •

this
key
generates an attention
interruFt andi11teLrupt:s program (~xccuticn.· Afterl:rr:akinq pt'oqrair executicn,
the l:HK-HlS lutton roust l:e dq:ressnd tc unlock the keyboard.

j~JA!

CN161
this keyis usedin ccniuncticn
with otherkeys to~~~~~rrr ~Eecinl
functions.
The
tah character(Ccntrcl-J) act~lik< thE ta!: key en the
2741.
Ccntrol-11 acts like the backspaceke) onthE 2741.
Control-C and Control-F produce an attenticn
interrupt like l3HEAK if the teletyre is in input mo<le.
Control-S( X- OT) il ll d Coll t r o 1 - I': act as
Ii E'J' ll Ii N•
Cc n t r c 1- fl ( E0 T ) sh o u 1 d not
tc userJas it
nay JiEccnnEct
the tcn1i11ril.
Contrcl-G (bell),conti:ol-f\(t:1F£),
Ccntrcl-'l(trii:c),andall other G:ontrol
characters areleqitimatc charactrcrs eveu thcuqli
they have no<' <j U j Va ) c 11 t C 11 th c 2 7 4 1 •llE~.LlE

Jl.li

a11d

L~L1_1QD)'~

gurcrate~=.!Jl!.t.sd.11
on

are ic;ncrcd by CP-67.
someunits)

a leqal cha1:ncter.

is notusedby

CP-67 butitI(" (
0 ';.' 'I~)"I•.·

2. 2. l - J 0

O!l/01/ti~l)-1:>
rarcl to thn righttcr~innl

i<SJ,

of the kcytoard contains six huttons
liq~t~,
abutton, and the
The buttons and lights are as

tclo~
the l(lcrtcve
dial
and two~OSMAL-~ESTCUE know
above the dial.

35 are the tollcwinq:

fcllc~s:lCC l.F(lccal/LitH!
f(•cd)
this l'.utton cpc:ratcs as tlH' I.HIE
Ff..i'D-tuttcn i.ithout ij('llC'ri\tinq a linC:-fE=ed character. lt is us<'d3lc11g with th€ LCC CR.
.

~~1~(Criqinate) t~is huttcn
ohtains a dial tcne before
jialing.
'the volume ccntrcl en the lcudspcaker:(tmdcL·thek~ytc~rd Ehelf
to the ciqht) should be turned up such that thedial tone is audinle.
After ccnncction with the computer has
teen made, the volume can te lowered.

Jf~_£B

CdrriurUl(Clear)tyrcuite.r.
,A]~( Ans wH)

J_;jJ('l<-!St)lnnocal)
oftline u.sc.

this

wh~n

l:uttondq:rRssc>d

turns

off

l~f_ ..LU-

this buttcn
returns thegene.rating
an end-of-line
only tc continue a line ofthiE button•ith the KSH mcdel.

tLOtJiCal;Hackqdce)
rr~aninq

interrupted,

B~K-bLS

genAratcs;i

attention interrupt andAfterexecution has
teen
and then the K tuttons must be derressed tc

thistuttcn qcnerates
frcqrarr
cxccuticr..

EttE~Kifit~rru1;t::;an

unlcck the: K('ytoar.d.
( KC y f o d l d )t h i E I:: 11 t t C II
terminal fer fd9E ccry cnly.

_.f.!Jl.::1J11? 1Euzzer-Rclcasc)
tld ~:: but ten turns off the buzzer
thatwarns cf a lcw r:arer suprly.
The light
in the nuz-g1s
tuttcn reir2ins on until the rai::er haE bC(!TI rP-rlenisl1cd.

l!E~1

dETURN
dces "ithcut
1.0C
CR is normally usl•dcharacter tut it has nc

en the tyrekriter for local oriBl.::11~(Freak-Release)this buttcn unlocks~ftcr rrcgran execution hae been intcrru~ted by the(Lccal;Carriaqc Return)as

inFut to ttc next linn.

this button is used for tcstinq rurrcseE only.
tur~s

-

ch.:irar:ter.

the·thiE luttcn is not usea· hy CP-67.

this buttcn''/·,: ,_.)

liie KSli(i<l~yboa1:d Scnd/l1ecdvc-)
model cf the l<•lctyr.:<: tyre V:iissuncrtcd l·y CP-67.
The type 35
t~Sll, li>~o thetyp0 31
includes il typ(•11riu•r keyl;oard, a control ranel, a data phone,·cntrcl circuitry, as well as roll paper. The type 35 has basically.h12 same feature:; <ts
the tyfc 33. The ailditior.al features of a typ<!

z. 2. 1 - 9ln2 ccntrtl,//

Un 10 C k S

1 ht~

kt! y b O a r: d

a n d Se ts

th e~ost ryre 35 terminals
have a vcluir.<' central know (SPKR
VOL) for the
lctJr[Cdkcr lccatcd
to the riqht of
the keyhoacd.
Turning the know

thn kPytoard
BREAK key.

clccln1i::c incr.ea!;cs the volume.
A cclumn indicator at the upper riqlit of the keytoard
indicates thethat hasjust teen rrintcd.
~hen
the IOC CR key is used, no
enl-ct-linc if cccorded anJ the column indicator docs not reset.

t Us liql1t iE 11ct u::ed by CF-67.

ccl~wn~!11.t~ . L=-~J~jQ]J- this k11ol: is set tc NO.!lMflL r:>XC€ft to chonqc
tile x:ilil:ct:, in which case? tho know is tkifitcn to tlH! CU'T-0.1'-SimV
light. 7hE knc~ iE t~cn Eet tc RESTORE and returned to NC&MAL
i.hcn the Cf<'ration ha:s 1.cen completed.

OUT-CF-SF~V(Cut-of~service)- this liqht qocs on whenncl"ii-aI-=-"R£~10HE know is i;oint<-:d to it for ribocn c.hanqinq.

A red light tc
tt.2 CH[if"-!I" isthe riqht of the column indicatcr
the riqht marqin.

.,arns th€ usP.r thatar~rcachingthe!cit tcl~typc utits have a lcudsreakcr and. a vclu~e control kn3w (VCL)
lcc·1te.J urdc~r thl' Keytodrd shelf. The knob is turned clcckwise toinctt3tiE ttc vclune.

Jj f L].2 __ 'Ie1£..!.1EL~.!:U~H.£!£J:i..§ ..ti-J;.2

.~

'""

~~~·iM@iil!MtJ?-·¥iRPi,rFLUJ '~'· ."~·~,,,.~ ·~~r

,,,ol

.;.
,"f

;.; .4;;;pt . ;. .

;;::;;::twz::::.#11;.u;;.,;2:::::;0:::;,,.,.,.... .....,.. .,,....... ,,,,~-·"'l"""""'··· ......."." ......

1a'"r··r~t.gp I

.Si

T

.a

""
µ

••!lllll.-!11!1

""

~

~

Uo./ UJ./ b~

05/0l/G9 ~f:;;_jl? • ?. • 2-1~. 2. 2

CP/67 CNlINE
CP/61 ONLINF.

lCGGl•G fHCCEDU6ES

lliis .r;ccticn describes tl1e procedures which must te i=etformcd atth<: termiual
U tci;in and tc
terminate use cf the
CP-67/CMS. system.
fct tne i:rocE:durer' cf co11n1~ctiuq auser to a multi-access systerr suchJS
&AX er APl, refer to Secticn 2.2.J, "Dialinq a ~ulti-AccasA!:y£:tcrr".
l.!'.'fcre thefacilJ.tiE.s of the CP-67/C!'IS sy~tern ar.c 1riloe
JvailaLle tc aset, he rrust identify himself to the Ccntrcl Proqrn~t:}(jiviuq hi:::[c<!tid aud!11.s
r:assword (twoidc-ntifier:s which are
1::;:iyncci to hint the time l:c i::: authcrized tc U!:C the system).
Thisi,JE nt il icati'cr. I cceJ urc: is referred lo as"CP Lcqin 11 •When CP leg in
L; cc;r,!Jl<:·tcd, a cc11scJe tuncticn rnily te issued tc
initialize Cl'!S, asmessagewill he tyred if theterminal is a 1052 or
2741 egui~rca ~ith an EDCD character set.
If the second rocssaqe
iB typed, the 2741 haE a standard Selectric cc correspondence
cha1actcr set. In either case, the xxxxxxxxxxxx pcrtion cf tha
mes~age ccrsists of rreaningless characters and should be iqnored.
If the letninal is a teletype type 33 or 35, the third rressaqe is
tyµca.

1he first

3.
lit thi ~ r;cint the system mu~>t lie not if ien that scmccnc wishes
to use the tcrnir.al.
Tc de this, hit the attenticn key once.
Onthl' teletno 33 or 35, hit EREAK and then I'rlK-RLS.

iucriLc.d tElo.
!/hen the
U!.iCt" has ccrr.f]ct<::d!1is USP Cf 1hc system,
hf! siqnal::;tid:::: f.1ct
ty ji;:suin'J a "loqcut" to the Control Pr:oqr:all'.
The r:eriodl.ct .. r?en Cf 1cqir ·a11J CP Icqcut i:s i:cf<.:rrC'o1 to as a "tern:inal session".

1.
1he Eystem wil~ respond tyeitt~c (1)unlockinq the keyto~rd
on a 2741 cr·1C52 ct waiting fc~
input en the teletype 33 or 35,
or tv (2) typing cne of the following messdqes:~L 1£:JiD~AX NO. OE USEHS EXCFEDFU
If the kcytoard unlocks or CP-67 waits fer input, prccced to

After the icrninaJ has teen readied fer use- as descr:ihed in::..:cticn 2.2.1, the fcllcwir.q prccedure must le pErformed ir crdcr toyoi11 accccss tc tl:\c CP-67;C11S syEtcrn.
(Ncte that input may J::e entere<lJn either urror qr loher case.
Upper: case is used
telcw tc indicat~•oc L; which
nui=:t hetyre<! n:c:thev arc shc\in; lower C<lEC indicatei:;r i •: H !:' ~ h c :s E c c r.t e n t s 10 a y v a t y • )·lf thenaxiwull· 111.:mbcr

rnll'ICOliN1.

aup dlJairi,,_/

CP/1>7 ONIINEXXXlOIXXXXXXX

f'HOGHESScieturn tc Stq: 1.

IOGll\ user idt'ollcwedty
a cari.:iagc~
idrntificalicn.

6.

taken· down.

When it is h:rought·

IdentHy ycurscH tc the .system by typing:

return,where

11uscrid" is

your

user

The syEtem will respond with enc cf the following messages:

EN1EF £ASS~O~t:
111is rnesEa~e indicates thatdcccrte<l. Erccecrl to Step 7.
fEfE/\'f::!.
'Ihe s)};terr will
ctck11cwJcdqc thata comrnunicaticn
line haEt c. i.: 11 C: .st al ) ii sh€ rJ l: )' t YI j n q OH! cf t lie f cl l c wi n q r.w s s il qr: E :IN

CP-67 is ir: the rrocess of heinq

co:nraunicritions' linetothe ccmpiter mustbe
£3tat1Js~cd. I t
th0 terminal is directly wired tothe ccmruter
thi::: is automatic .rnd you· nay rt:ccc0<1 to Ster 2.
If the terminal
is a ti:lct;rcJ) 01.1S, <kpi:ess the ORIG but.lon, m<ike~Jure th<:dial tcu<;
is audiLJe, il!id
thEn diul the
installaticn 'specififld
nundcr a11tl proc01~d 10 ~itcp 2; thc>
ORIG tut.ten is liqhtcd at. tl1is
i:oint - if th<.o light. qcci:: cut durinq tho t(.;i:minal session, the CP
Lc-]111
Frcc~Jurornt1f>tl.:erepeated.
Othr!rwise,aData-PhonP.
simildr tc thatshr~n iu Figure 2.2.C-c will beplaced near th~
tt.?t1r1nal anril .::hould Le
u~ca tocstal-lish a con:rrnn:icaticn linewith thecc1q:utcr as · fcllou:: Attcr makin<J i::ure t11at the p.luq
frCJr
the [ata-;PhO!lC!_ isCOll!ICCtcd tothewal.l~jac}\ 1
rr:<~SSt.hetuttcn
lal:1:lcd
1ALK,
liit
the
rc?coiver,ancl dialthei 11 ::: t a 11 cl t i c ri - s p e c i t i f~ 1 n u ml: c r •Hlr e 11 a
co n t i n u o u s t o n e i s he a t rj ,i:rc!'s the t\lttcn lat:E·lcd DAT/\ ar<l rerlace the reccivc:r.
Th<? DA'l'A
tuttcn shctJd r.c~ !:<~ lighted, and ~ill :renain lighl1~d as lonq asthl' termi11al
ccn:ai11.'' co1111ect..cd to the computer.
If
this light
goeF out ~t
any feint durinq the terminal se~sion,
the CF Loqin
rrcccdurc aust l;e r1•p0.1teri.
l:'J.r!:t,Ste~rressa<;E is tyt:cd, t.ho system isalready ser:vicing theof usf!rs andthe lcqin i:rccedure 'Will heterminated.
In this case ~ait fer a fe~ rrinutes and then try
ayain l.:y returning tc Step 1 •5.

ycur u:ser

identification has()
t:SEl1ID ON xxx~HE/\'.fbeen

ffOCHUiH

this rrcssac;c . is typo:d,thewcrd "lOGrl\ 11 has heeni~cc1rectl}· Return to Step 5 and tetype th~ input line.
1i

PllOOI.:UHEd.J

2 • 2 • 2 - 2 ,.,~

xxxxxxxxxxxx

en ten~d05/0l/6S "''"' _7
2. 2. 2-11 -<,,,; .5'/

05/01/69 /i;" J.

2.2.2-3

1hiE mesEac~ indicates ~hat another user ~ith the saroe userid is
Jogy~d 'en ~t t~e tcrrrinal ~hose address is xxx.
You will uot he
atlE to lcgin with the sa~e userid until the ether user has
loggEd off.
tSIR NCT IN

in a CP-61 Virtual Machine, by c. I. Johnson, HIM Cairbridqe
scientific Center Rercrt 320-2035, camtridgc, Massachusetts,
fob r ua r y 1 ~ 6 5.
£nl_J]l1i~1j~E!j~]11. 1o initialize CMS, issue the following ccnsole functic~:

tlREC~C~Y.

FHEAT PFOCF.DURE

1111 190or

It this ircEsagc
feturn tc ~ter 5

i~

a~d

typed, an invalid useri1
lcqin aqain.

has teenlH CMS

specific~.

followed lJ a carriage cctucn. This will c~~se a copy of the c~s
rucleus tc be brought intc ccre from disk.

1. 1yFe )Cur passwcrd, fcllcwed by a carriage return.
If the2741 terrriral is equipped with the Print Inhibit feature, the~~ssworJ wj]~ rct tc
tyfed at the ter~inal as the keys are hit.
Ihe Print lnhitit fcdture ar~lies cnly to the typinq of ar~ss~ord. If the terminal is a teletype33 er 35, three lines ofcharacters are cverrrirted tefore ycu ~re allowed to enter your

12.

~.L.!9.92.YL~hen the ueer has finiElcJ usinq the system and wishes to end hi5turninal scssicn, he should db so by lcgginq out frcm the Control

7he system will resrcnd wit~ cne cf the f61lowing messaqcs:
F!ACY A1 xx.xx.xx ON XX/XX/XX
where xx.xx.xx is the time.cf day and xx/xx/xx is the date. !hisuassaye inficates that the fasEwcrd haE be~n accepted and the CP
lcyin (rccEdure is completed.
The Contrel Prcgraro environment
has teen entered, acd any console functicn may be issued. To
initiali2e CMS, proceed to Step 11. To initialize any otherc~erating system Frcceed tc Ste~ 10.
9.

Ircsraro.
If the user is net already in the Ccntrcl Proqra~
environment at the time·he wishes to lcgcut, he may enter thise11vitonmcnt ty hittin·1 the ath!nticn key cnce. The keyboard willt:l? unlccked an•I the user sh.ould typelCGCllT

fcllcwcJ t) a carriaqE return. The system \ill respond ~ithlOGOfP A1 xx.xx.xx ON )X/XX/XX

tA5S\ORC INCORRFCT.
EI::FEAT PROC. FI:URF.

~ndthe ccnnectieri to the ccnruter
ftcccdure is then co~pleted and thethe tec~i~al.

lf this uessage is tyFed, aninvalid pass~ord has been specified
and the le~in Ftoccrlure will be repeated. Return to StcF 5.

,..
.,,

iii

1+•-, Si . .Li·'

will be lost. The
user may turn power

ICGOUTany th.in g

followed ty a carriaqe return. The ~anything" must be at leastcne character er any ccmbinaticr cf characters.
The connection~ith theccmputnr is not lost and the CP-67 ONLINE message istyped out fer the next user tc lcqin, as in SteF 2.

A
:SJ

iii'

.!£

iii

u:

m;: ;;

a•4"

logoutoff atCf the user desires to ~nd his terminal sessicn tut net lose thecounecticn with the ccmluter such that ancther user may loqinf~cm the terminal, the usnr should type

10. At t~is pcint in time, any cp~r~tinq system can he leaded
into the virtual roachine. To load in CMS, qo to Ster 11. To
lead in ancth~r Cfcrating Eystcrr, issue the IPL console function
to CP-67 ~pccifyinq the device from which the system is toloaded.
fer Rxaufle, IPL 293 er IPL CCC. If the device that is
IPled contains an operatinq system, such as OS/36C, cf that
cpccatinq £ystem and ycur terrinal is effectively the operator's
ccnEcle.
For inlormation on runninq OS uttler CP-67, see OS/360

1

XX/XX/XX~ill be tyfcd, and the keyboard will te unlocked.
The x.x is theversion nunber and xx/xx/xx is the vecsicn dRtc. The CMS Ccmm~nd
environment will have ccntrel at this pcint, and any C~S commandrod) be issued.

E.
At this time if there are any cards in the virtual c~rd
reader or cutput fer the ~tinter or punch, the messaqc
FILES:- xx RCU, xx PR1, xx PCH
is tyreJ •. If the CF operator ha~ set any leg ~essages for theeJy, t~cy are tyred alsc.

~;._: ':·~ :·' :·rrosage:
CNS ••• VERSJON x.x~ass~ord.

:; <,.

~he"'a .P'

jl

'

Ji

# .

'f 11-

$

J

I

""
!

;:

I.

,I

. ,;,11~,1

,~·

!""'

fl"\

o?t~~

05/01/69
2. 2. 2-5 d?Jl~7.2
i CP/61Ir h c f i r s t ' 11 e s s a g e
~7q1

egui
is typed,chatactcr
mcssaye cli the tec33

ONLINEwi 11 l; e t y p e d i f
fed with an FECC charactert e r ir i na 1 i s a
10 5 2 or aset.
If the seccnd rressaqe
the 2741 has a standard Selectric or corresponde11ce
sot.
In eithec case, the xxxxxxxxxxxx portion of thersists cf neaninqless characters and should be iqnoced.
irinal in a teletype type 33 or 35, the thicd nessage ist heTher~ are ~o 2702 er 27C3 lines available en "system", The linesrod)' no~ be available for any
one of the thrEe following reascn~:
27C2 or ~1C3 lines are not defined in the ~irtual machine; thevirtual lires are not enabled by "system••, er all of the lines
are in use.

system NO'l AVAlLAElE
FEHAT FliGCHlllif

tyi:cd.

3. ft th~s point, CF-67 must l;e notified that someone wishes tc
use the ~erwinal. To de this, hit the attention key once. On
thH telctHf! 33 or 35, hit EliE/\K and then ERK-RLS.

'!he

11

systc:n" bEinq DJAL1~d is net legged in tc CP-67.
systemi;HE AT

4. 'Ihe s!yste111 will resi.;ond ty either (1) unlocking the lieyhcai:den a 274f er 1052 er waitiuq fer ini:ut en tho teletype 33 or 35
er l1y (2) ,yriug ono of the followinq n:essa~1os:tAX. NC. CF USERS EXCEFCFD
lCGGED CFF AT xx.xx.xx ON XX/XX/XX

SHUTCOWN IN ERCGFESS
lOGG~C OFF A1 xx.Jx.YX CN XX/XX/XX.

CP-67 is in the frcccss of Leinq
brcught Uf again, return to St~p 1.
5.

Spec~t).lCCHSthe multi-accessty: trri11q:

II AL

taken down.

system to which'Ihe

When ityou wish'I he s }Stem
ro1::s::: aqcs:

6.

will

tl10n

n~sponaoneof the;nc2

or 270lines in its

virtual irachina

tc gain11 systerr"(2)
ir:Eues the CP consclc
SFecifyinq the terminal address.

function

trTACH,usei:-id offcllcwinq

1his mes ace indicates a ccnnection ·has been ~ade between theteruinal ~ud the multi-access system and the terminal is now
under co trcl cf that system. Cnly further responses will bethese ofthe multi-nccess system, as the user can net qet tc
CP-67 to iEsue ·ccnsole functicns.
ALL LJN~S BUSYFEIFAT IFOCEtURE

has no(1) 11 Ey::Jtcm"
issues a disable 'fat that terMinal.
'!his isusuillly brouyht atout tiy logqinq cut cf 11 systero 0 in thecorrect manner.

is••• connected •••~ysterus)'sten" has not issued an enatle for the 2702 or 2703 lines.

'Jhe terminal i::omains connected to "systerr" until one of the threefollowiu·q <:vP.nts cccut:

Ct:

with

N01 BEADY
HCCHll liE;i ~ ~.f..!Hl £fllll.9

s ysten1"system" is the

Ll~ESsystem NC tIAl ll~FS
H:.Fl::A'I PHOCHUHE

Cl

follcwecl t:} a carriaqe x:eturn, where
the rrulti-acccss system.

11

Ihe 11 s}st€n 11
Jesctit=ticr.•

It thektybcatd unlcckE and CP-67 waits fer input,
Frcceed to
SteF 5. I~ the messagE is tyred, the system is already servicinq
the ~ax1rrun ntmtcr of users and the dialirg Proc~dure will beterminate~.
In thiE case ~ait fer a few rrinutes and then try
d~ain by returninq tc Step 1.

05/01/69
2.2.2.-6.(3)''system" lcqs cut cf.CP-67.

When ~he terminal is
disccnnectedfcllc\ing messag€ is t)'ped out:

from

11

system 11 ,theCf/E7 LCGOUT

the terminal can now te used to loqin in CP-67 as in Section
2.2.2 er to dial intc a mclti-access system aqain.

05/01/69
2.2.3-2

05/Ql/69
2.2.3-1
2.:~:.J

t!~LI~G~~clti-~ccc~s. ,,s:.;ion, Ster~-tff,J/

Sy~tc~

ct~o·uso~has

cc~rl~teJ

his

~sc

of thec:2ff7~3.{

te repJated.

• ~~c sys~0~ will ack~o~~cdga thc:t a ccr. r..un ica ti er:
inc tJs been c~tdblish~J ~yt;ping O!IC of thes "'c t 0 i. I!(: c;: I:(; st h 3 p: 0 cc au re .s~: b i ch n us t
h C:.-i: i .:: ri; :! Jc c ca " c
a t: J: c i: t c as y s t c ir th a t F r o v i :1. c:.;~:};.i-t0r:;
r::i.lde litics, sue~.
<JG 11?.L
cL· nu:.
'.ihc:!:0c<..~;;:; c~ i;.laci1·q a ;:;:er intc a r.,\ilti-ac:c~!..;.s ~;ys~;tc:1 i.:;11--·:~\·:::::•:d to;:~;JialiHS"·
1ho !;yst<)r; tc l:c di.t:lc! i:;t.cU.t't i:.;; lCtj·JC(:
C!l tc Cl'-67, ::.~ i::
Section 2. 2. 2, '.ii.th
o: c: :n 0 2 o L 2 7 J 3 l i 11 e::;av a i ; z !:. l r: u n d<: 11 abler: t, e f c r. c:1c
cc1;nccticn c.'lr:
l:c :r;1fl1J.
·:~hen"'.:he co:in0ctio1:
is:.C\:, Cia~i::g!i .s b\;c:~ ccr.r.:ct(?d a~1d tl:e
tc:.::::ii~~l isc1:,~ ..·:.:
t!,!J cc1: rolcf
tht:
systcrr.
dialedbt.c;c.:: :u; c:; c" !; tl y ,t e 1.: ~ ·~ ti ..: . n c t k r. o i; n to CP- 6 7 us a
11
X:(?<,Jt:lar lc9<,;cc1 n" u::cr l:;ut as a -"dialc;c" user.

;: if,~

mu~t

c:;.lci 1.n9:.1c:'.:~;.19cti;

xxxxxxxxxxxx
CP/67 ONLI~E

CF/67 C LISE·:xxxxxx xxxx
Cf/G7 C Ll~~~~~:.;'.i::st
l!C!:~.'!CJt~
0 r a 2 ., L; i (J CJ u;..;!.~l~) p <: J

cc tyre.'!
if the tc,:-r::inc::l::.s awit h d n Er: c D ch D r G ct c:: ;:- s (! tIi·~i,,~ ::;,,cci:drr.c:·~~.Sil<J
i.s tyr:cj, the 27Lll };as a r;tc. d:'!.rC:
S~lcctric C[
ccr: s~cc~cncc chdLactcr Ect.
l~ c ;he=i 0: 2cesc, tta xxxxxxxxxxxx FC~ticn cf the lCs~agc ccn is~sci ~t~hinslcss checactei.:s and should tc igno=cd. If
t~e tar~inal~s atclcty~a tyfe 33
or 35, t~c thi=dl!CSS.:ISC ·~s tyrecL~ulti-accc~s

s s 0~1,
Le should leg c:.it c[ that£y.stc:.iin
t!-:0
t. i- c ia '' :iannci.:; •~en ihiit r.i.;l';;i-accczs syslcr.1 i~;suc.:;
11
at. sa le co:r.::1and for tilat t'Eruinal, the terr.ir:c.l
vii::.' <: ;:,;;e fer ar:ctber cs::?:: to 11 login" to CF-67;c;·:ser to 11 .J al" a :nulti-acce.3s systeL~.

A
~c
~n

tbis ~cint, CP-67 ct t bo notified that so~co etc use the te~rri~a •7c de this, hit t e
ic:
key cncc.
Cn thteletype 33 er 35, h ~AK nn6 ttcn B3K-RLS.
~i~:ig· Ii •

ketc
reter::dual
b.s b€C:1
reacicd fer USC' c.S
in S0cticn 2.~.1, the follc~ir.g Jrcccdurc~ust
te perforiEd tc gain access to a multi-accesssys~c~.
(~ote that
input ~ay ba entered in eitheru~~cr
er lc~cr case •. Ufrer case is i;scd balo~ toir. .::.cate ·.:ores .,;hich gust tc typed as tlicy arc sr.o·n:;lo~e: case iudicat~~ fields whc~c contents ~ay vary.):.:"Letthecescri~cd

~AA.

~

C?-67

is
~-

line

\.'ithcc~~utcr.li :.

gees

out . atanyi.:oint

d'uringtha!mm1JUJJl!ll)411111f.IJIII J14.411111;;;;;:;,,Jiiiii).!!liiii#i.!illii#iili.M . . ,Jiiiii 111111

ard

C?-67

fer

~aits

I~

ur again, rct~rn tc StcF 1.

S?ECify thesai~access~Yaulti-acceEEty?ics:.syst~~

71~.J!iii

When ityou vish£yst:3;q:!cllc'.'cc l.:y a ca::ric.gc: ::0t:.:rl:,
w!'.eret:£c;:.:fr: c...:.: -c!1c i::u.:..ti-:::.c~o.:s Sjs;;_.·.
f.

\hich

~o

systc~willthenrcs~o~d11 syste~: 11

~ith

obd

ti4°'&:t. ::;;41111.urnt;l!JSIJllJSIP.41: 4&¥:;MM¥JUJ JP j, +I

is

of

t!:~

the

~

~
;sza ... a x .J

!n~ut,

P~CGRESS

js in tha 1rcces.s cf being taken dcwn.

trc~ght

t!AL

tcr:r.ir. 1~
1

u~lccks

SHU~DO~~tocolrru1:icaticnakcytcard

lOGGEL CFE AT xx.xx.xx OX XX/XX/XX.

thee:stal;lid:th~::- cccc.:.:: tc Ster 5. If t;;o · rn.s.sz;gc i.s tjr<::c, the syste:;:-.
i~::~ Jy
servicing th~ n~xi~uc nuntc! cf users andt e ~ia irg f~cccduca \ill te t~rmi~atcd.
In this c&se
~ it fc
a fc~ ~inutcs anJ then try agajr. by rcturnicg
to Stq: 1.

~s !o1lo~~=a!tc: ~eking sure that the ;!~g::::c:.: t:-:t. ~at.z..-?:ict:t:: i~ c~:.:~c;c ;(?d, ~o t!-~c ~~-al::.jack, ::>:-c!-;s
the ~i.:tcc~ l~tclad =~:K, li!t t~e receiver, a~~ tinlth•~ i::;;ta.::r.:ic:i~pcc.::~·:d ::t:::!:,cr.
Whena CO?!tinuo s-..c:.(:
is ::-:ca::..::,
r;ro.~s ;,.i.3!:1Jttc:: l.::.'.::ele.-1
tl1'.::.iil .d:c : C< tlc rcc~iv~~. ~he Di:A ti.:ttc~ s~ould ~o~ e:i :. .::.::, ar:d .•,ill rc::iain li',J!':tcd as lo:i-J a::; t c·!.€: r:a~tC;;c:tin:: ccnnccled tc the cc:q:utcr. If tli s

toNO. O? lSE3S EXCEEC!D
o:·:_; J.T. xx.xx.xx ON xx/;o/xxlCGGFD•• !its , a co~~unic tion linE o the cc~futcr mu~t
tc Estat istc~. If th te1 inals directly ~ired lo
tho co~p ~er t~is is utc~ tic an ycu ~ay prccPcd tc
!tc~
~.
!f
the ter~inal is a tclctyp0 33 or 35,
C..::;:ri•ss t!;e OHJ:G buctcn,:.:akE sux:e th: C.ial tcre is
ct:~i.llc,,
an·a t};e:: diul
the in.stallatio!1 spi::ci:icd:: u:-. :: c :: a :i d r- r o cc c j t. c S t E f 2 , th.-::! O!U G b i.: t t c n :. slis~te~ at
t~is pcint - ii
th0 light gc~:: out during~1etcr:~~alEC~sion,StEf 1 ~U5t
be Iefcatcd.
C;,.~c:uisc, a nata-?hc~3 sirrildr lo that shc~n in Fisurc-'.2.0-C will 1::0 i::lac€c ncwr: tl:c tcrr.iinal a11d .shc:Jld beu.;;"d.sys t c ::: ;: i 11 re sr- c n J ~ y e i th c r "( 1) u 1 o c king t e
ca d en a 27~1 or 1052 or waiting f cr nput en t ety c 3:1 er 35 cz: by (2) typing o:le of t c t.o.Llcwi g
ag s:

'! h

1

1

•

•

"* : l:UMif ; .wz ;mp :m::::: •·•~ w
11

1

'~

~

/!'\

0 5./01/ 6 905/01/69

2.2.3-4

2.1.3-3
fcllcw~-9..e;:~s;;~cE~agcs:~!:is i :.o :'.i<l•JC
iadic,1tcs a cc1u;cctic11
has been i1<:d ..:.:
l c t ~' c ~ :• ;; ct c i' ;:1 i :: -~ l cJ 11 .J
t l: c mu 1 t i - a cc c. s s z y s t C:! !J a :i .:'!
U;c tp.:r.: 1:al i:; !:c-.1 u-r.,l.:ir ccnt1ol cf that sy.stc~.
Ct:'j,_y· t l: !: l h~· :.· r: c s o :: s e.:; .,,. i 11 h c t h cs o o i t h e: rn u 1 t i - a cc c ::: s.s:·s!.:q.:,
us !:Qu:::c:i: Cull r.ct get to CP-67 to issiJc
c ~:: .s ~ 1 c i u ;1 .: i. c n .s •

~

l..1c

n

11

ALL

ll~P~ATPRCCECU~E

r.g ::ca!;cr.:::vi:l~~!

t

r.all

~:.e

systc~

t.y

11

11

~7~3

11

EUSY

er 2703 li:ie-s arc,

tGe

PCOC~[UB!

.pyslc;; 11 ;iei1;g D.IALcd ·iE net logged

has

are

net

AVAilAELE~CT

EEl~~~$ystc~''

not def r1ed

virtual lines

er all cf the li11cs are in use.

systc~

L~~35

~C1

jn

to CP·-67.

BEADY?ROClIUaE
r.ct issted an enable fer

the 2702 or+incs.
syste~
B3~~A~'ll-:c27C2~~cn1nc;

s.y.ste;:sy~tG~~EF~lT~ti

LI~ES

r: c: n c 2 7 G2 c::
2 7 C3 1 in ,:; s av a i 1 at ) c c r. 11 sys t ::: 11,
cs ~ay ~ct tc availdb}e fer any cr.c cf the t ;ccl11c~Al Il5ES
PRCCECOHE~c.$ystci.: 11 I:as r.o 2702 er: 2703 linesd€scriftion.

~achinc

in it.s virtual]ll£9.1~.Qf.1il!.s~hetifr::rinc.l rc:nai:-;s ccnncctea to

~~E

ttrec

fcl~cwing eve~ts

11

systcn 11 until cne of

cccur:

1';.:;tC:1 11 i3SUCB a cisallE fort.hat ·tert.'inal.
susually brccs~t about by logging out of"'sy.:;t r~" :'..n t.!ic ccrrcct r.anr.cr.
(i)

~his

e=
11
(L)
Sj~tc::11~:OSt:C~~E?AC~, sp~cifyi~~ the·cp

ccnsol..::tc::~.i::ol

aac:::es~.

-~~c

c::
1(3)

11

.Sy.slG::--"

thetc1rmin::1.l io

disco~n11ctcd

fJ;cr.

11.syztc:;. 11 ,lle followirs cu5sagc is tyfcd out:••• connected •••c::: G_$)!:!i~1:lC-J.!O C\;t Cf. C?-67.

fur:cticn

C?/f.7 lCGCt;l
Ti':c tcrr.iinal c.7.n r:or:i~ Scctic~
2.2.2
systct.~ again •l:E usEd to lcc;in ir. CF-(// as
er to dial i~tc a ~ulti-accn~z.J7

05/01/69
2. 2 .11-l;_. 2. li

GENEFAI 7YPING

05/0l/G9.~;;:.'/ .30'

CC~VE~TIC~S

2.2.4.-2,,..'-:.-.·P-";/~ $ AELE
AHLE FCHTRAN to bE ccmpiled, leaded, andinput line to the ECIT environment 1 • 1 /HUFT/ # C /F71FFER/
Will causf the characters EUFT to te lccated and changed to
EOFFEB. 1tE line-end character can bE chanqcd with the IINEND
command fSee J.5.1).
FC~TFANThe follc~inq typing ccnventions should te otscrved when ePtrrinq
i1qut to the CP-67/CMS syf:teu: frcn: either a 2741, 1050, or ateletyEc 3~ er JS tnrminal:
lnFut na} te entered in either Uffer er

a.

lo~cr

AEIF

~jll cause
the file~~ecuted. 7he sinqle

case.

t.

When tte keybcard iE unlccked on th~ 27li1 or 1050, thei1 ready to accept input. The kcytoacd remains urlcckrd
en the teletyFe, thcrcfcre a )(greater than sign) is tyfed atthE left- tand rnarqin when the tclety~e is ready tc accept input.
If the user types tee soon on the teletype, an interrurt may
cccur whict will rrclably cause the user tc qo back to CP; if
this hafrens, type BfGI~ to return to where ycu were rrcviously.

h. An outiut line on the 2741 and 1C5C may be a maxitturn cf 130
cnaractcrs.
Any line lcnger than 130 characters will cause
cvcrrrintirq at the right nargin. On the teletypes, lines lcngcr
thar. 72 characters in lf'nqth are printed as two lines: the firstlin€ cuts cff after the 71st character and ar. uparrcw is printed
at the end of the lino to indicate continuation.

t~rminall.
Illeq,l] output characters will appeai: ir. tertninal ty1:<:out as
spaces. Pr illegal cutiut character is cne which cannot be typed
and for which nc keytoard functicn,
such as a carriage return ora tab, can be ~enerated.

c. The character-delete symbol, i ~ may be used tc delete theFtccedinq character in the input line.
n charactcr-delct~sy~tcls tcJ~tc therte~cdinq n characters in the
input line andthern.selvu=. Exception:
this feature docs not aprly with theK-lcvel ccnmands or the Rl ccmwand. The character delete nymhol
can l::e redefined by the CHA!itEF ccm:::and.

1· Cne er more blanks are used to delimit the fields cf an inr-ut
line te thE CMS cc~manJ cnvircrrrent.

lhe lire-Jclctc syrr~cl, whjch is the¢en the 2741 or 1G50
the Ehi(t K (left tracket) on the teletyre, may tc us~d torlcllte all character~ in the curre11t input line and itself. A
line-delete symtol(~) cannci bedeleted by a character-delete
synbcl(i).
Exception:
this fFature doFS net arrly with theK-levcl ccnnands er the RT ccmroanJ. The linn-delnte symbol can herndefined ty the CHAHCEF ccmmand.

J.

tnd

e.

An inrlt linP.

may l::e a maximum of 130 chari1Ct4'rs in length.
thar 130 charact€rs inclujinq dclote symbols,
l:lanks, ard the tal: ch<!racter will be truncated to 130
character~.
On the teletype 33, an input line ci!n culy contain amaxj~ua cf 72 character~.
Any line lcn<;€If.
An itrut line frcw the 27Q1 er tel~type is terminated byhitting the RE7Ui:lti key.
To terminate an input line frcro thfl
1050, ~it the 5 key while hcldinq down the ALTN CODING key unlessthe 10~0 is eguirrcd with the Autcmatic ECO srccial fcaturo.
If
thiE s~ccial fe~turc is availatle and the FOE panel switch is sat
to All'l'O, it.rut lines may l:c terminated by hittiJJq the llfT!JRN k11y.
q.

Jnrut lineE can contain a nurtcr cf loqical input lines which~eraratcd bylire-crd character (the # siqn).
Each call to[cad a line from the terminal will return a loqical inrut line.
SutsEgucnt calls tc read a line frcm the terminal will return thelc~ical inrut line which was typed followirq the previcus lcqical
infUt line. fer cxaurle, the Einqla input line ar~

...

11

1

~ ~!l tl l l l l~--

zwe:::: :::.;w; ""l!'!P'!!'ll·l'J..
iMiillii!iil. !ijl,IJiiiil.PRN· 5ii''f!'+l!MM ..
¥c!i-,@
11111.............;.....;,""
4¥ .....................4. . . .Jdl.lillllllllli...... ............................................................___________________
I

'

ocr,,

u;r

¥

~_

~·

.

.~:q

'-'/

~·

05/01/69.2.2.5-1.£¢?·~I'-'

After ~a kJi r:g a i:hcnE ccnnecticr with the ccmruter an<l the message'Cf;67 C~lino' is printed,
an attention causes the CP loqin
p.:oceaurf to begin er
the dialing of a irulti-accc.ss system toteqin.
1

lhe user•1.s machine may te interrupted (stcpfed) and the tErminal
readied :tcr irfut at any time by FteEsing the attention key
Im ark ea A:'I 'IN) c n a
2 7 4 1 , hit tin q the RE s Et button on
a 1 0 5 0 , orthe ERFt.K: key Cll the tcoletyi:e 33 er 35. '!his causes control topE.s to Cf
p~ovidPd that the Control Prcgr.rlm was
not already incontrol. er ccc.sclc functions can then te issued.
Af t E' t

fr<' V i o u s

c1

a t t l' n t i o II

( p t' ~? ;~ !.d n q

t ho

A T 'f N

k E y)

c a u s i ll q

control tc i:as.s frcrr CMS tc CP, a subsequC'nt attenticn wiJl pilSS
central :!::ack to CMS.
If cas previously had contrcJ ana "asreadingline fr:cm the ter:rrinal, i.e., the keyboard was
unlcck£~d ,. thP. Ci1S proqram i.ill be restart00 and the keyl:oard willtc unlcc~cf a~ain.
Ii
CMS rrouiously Lad central and ~as notreadin4 a linE from thf! terminal,• i.e., the kcyl:oard was lccked,
the i11t•~r;rl:rticn i;erniti: a t:i11qlc line of inrut to l;e entered :'l.nd
stacked.
~tacked lines cf: inrut 1dll lie used en succA~siv~ callf>
to tt:'ild a line trow the torrrinal until thErc· ai:-c no rrcre stackodline•!;.
:lrrut willthen betaken directly fr:o111 the~ t(>nnin;:il.
Af t (H a
1 i n e to bes t a c k c• d i ~;c 11 t c r e d , Cl1 5 t o n t i n u c s
f r o m t ho
envir:onm~nt which wa£ last. interrupted.
Any number of lines may
te inrut ard stacked in this ·way.

05/01/69
2.

: • 3. O

P.KVIHC~tE~T

CCKVENTICNS

3:;J :/;

Each infut line which is typed at the terminal ty a user istransmitted tc the CP/CMS system where it. is t:rccessed (examined
a11 d accept ect
or re ;ec ted)
by agiven routine.
'I he y:articula r
routine ty which input will be Frocessed is determined by which
FCrticn cf the system has control at the time tbe in~ut line is
rntf.red.
Each i:crticn of the system tc which input may b~euter{?d ccrstitutes a unique envir-onmcnt,
and only asubset of
all iossitle input
is acceitahlc tc any qiven environment. Thefcl}cwiuq are the environments of the CP/C~S system:
Ccntrcl Frogram cnvircnrrent
CMS tcwmand chvironment
Cetuc cnvircnmcnt
Edit :environment·

J11rut environment
Scrirt Edit environment
Scri1t ltrut envircnment
Echc environment
In additicr

tc these eightspecific environments, iniut
reay beany ether executinq rroqram ~hich exrects terminal
i1q:ut.
'Tl:c.sc ether inrut Frccosi:::inq
rrcqrams are qrouped into a
n i 1: t h , 11 r t cg r a in "c 11 v i r o n m€ n t i n.,, h i c h U1 € a cc e p t a t i 1 i t y o f a n
input line is determined l:y the executing rrcqram.

enttred tc

1'hc:n entc;r ing twc attcrnticns tc the sy!.:tem to stnck input, th~
A'I'Iti kEy .srculd uct b0 p:essc:<1 the second time until the kP-ybc,11:d
has teen uulocK<d in resrcnse tc the first attention.
If thesecond a tEnticn is erterEd bcfcre the keyboard' is unlocked, it
i.ill bE<,;r.ored.

With the exception cf the
Prcqra~environment, the input
1rccessinq rcutine.s fall into three main cateqorie.s: inr.ut isr ( c c; i v c dt y e i t ll(Hth e c c n t r o 1
Pr o q r a m( c P e n v i r c n n: f' n t) ,acontrdl c~s uervice rcuti~e (CMS Ccmrranj environment), or a
fdrticular CMS command (Detuq, Edit,
Ini:ut, Script, Edit, Script
Inrut, and Echc cnvircrrrents). Input lines which arc acceptable
tothe CE
environment are refer-r1;;?d to as "console functicns"
since fer the mcst .~a[t they si~ulate functions that can be
rerfcrmed at a 360 console. Jnput to the C!S Command environment
mdy l:e any CMS 11 ccrrman<.lu.
A certain
cw11 to be

nuruh~rof the CMS ccrnmands carse environments of theirentered. These are the DEBUG, F.Dl'I, SCRIPT, and ECliO
co~mands.
Lines acceptable to the environments of these ccrrmands
arc: rcfc:rt:ccl tc as "rcc1H.?sts" er nercly "input", depending on th~~articular environmenf whichis entered ~hen the ccmrnand isissued. The ECI1 a~J SCRIPT cowmands will cause eithPr of twoenvironments to be entered:If either command is issued fer afile which aiready exists, the arrrcFriat~ editing environment(Edit er Script Edit) will be entered, allcwinq the ccntcnts ofthe existirg file tc to examined and nodified. If an EDIT or
SCRlPT comrrand is issued for a f]le which docs net currently
exist, the approi:riate input ervircnrrent(Input or Script Input}
wili be cntcroJ, allowing the file to be cre~led. Both the Input
and Scrift Input cnvircnwents ~ill accert any input tyred at tho
t e r mi 11 a l , a n d
t h i s i rq:; u t wi 11
t e co mc> a p a r t o f t }1 e f i 1 e he i n q

,df')'~
05/0l/G9i) ·?.

,:J

2.3.0-2

created. ~he Echo environment will alsc accept any input line,
tut will Icpectt that line as output in crder to test terroinaltransrnisssjcn.
Because nc check is made to determine theiccertability cf input to these three envircnroents, lines which
are acce~tatle are terned nerely "input~.
The Debuq, Edit, andScript Edit environments, on the other hand, accept only s~ecificinrut line~ ~hich are referred tc as "requests".
toverify at any timeK€J can be hit.

whichenvircnm~nt

the useris in,

I

p
~

m
" m
::.
""()
g5
~

~.

3~~·
~

<:5
:a

~

ci

• - 1.:.. [

".:

.....

0

~~

5

ii 3 .5.; g =1

Ci

~ n., ~.,,

'2 a :l. t=~~;;a tJ1
lr::t

8

::I

ii

..

00

3
3

B ff

= ~ g :::j[!~.:~- O"' m.,,=i fr r:" •~Il ~~ R II nr~ ') .~ ··~
i}

..

~I

2-~

-

1

J ~ ~H~ ~- m" !'I§ ~ r::

II H~ ~ ~· ~ ~ ~l

3 h cji'l :JI~~~~ ~::! .g~.[I~~;o I < "' r.
a. ~ ~ ~ ~

I .,
~
..,

n

; ~~{i

,

I

:;;

::: :

~ ~

~-i----,"'--='-=--::'c-r---::-:-::-+:'~g""".::°""'.'"""'.::-:~"r::::-1~
6:! g bll:.':..0::1
0t'1":Sq -5;a~~- ii'

""Z
g

..

..

~.j g

6

:; g, g,la[" J ~ 1:1-bi"
11 :.H
5!!fil~~
int

T

S'

z

~

ii

ii

:
~·

~ c.~g!?

ii

-~~ia

z

~

Pi
~e.a.

~·~

::~::io,r----~---+-----~~'g]blii sqE.§.
~
;

~
ii

l

~~n3:::

----

1

c.m

..,aa

~~

I-

,..

.....

]>i3

~ ~gn I;;;r;3~1
S.-a~o
~1 e

1--

~

5

~

~

~
:;t

~~~~~

g <Ii

g;:;

=·

+-

~

n3==re,:::~s~~2:l

>

~·
=

s

I

"'..,
n "'. " ' - ,<Or..l"tl""I~

&.o

a

:;

~· ~

""0.

~ ~ M~ ~ ~-tg-:-3-w.r~- ~

..,
[~

~

m

I •· m

~~

~

:l

!

21 3 in g. ~ ~:.:a 1 ~s.g~"g F..il ~ z
a.,,

~;:;i

~·

g

s
;.i

m

l! _g-""c:

0. "1

~ ~

~.

g

th~

Im
l!•· m g>g':;·" "- g>

0 "t'J "1--;!~·1···--- > ~FETU~N

Various acticns by the user will cause contrcl to rass f~om one
environmcc1 to another.
These actions are sunmarized in Fiqure
2.3.0-A, acd are specified in detail thrcuqhcut this quide. Note
thdt the attention key can always ~e used tc transfer control to
the CP envicrnnent trc~ any cf the oth~r ecvircnments.
Hittinq
the atte~t1on key while in the CP environment will cause th~
keytoard
to te unlccked, ierrritticq cne line of inFut to heentered. If the line entered is a K-typc C:1S command (KT, KX, KC
er KE) or the ~r ccrrnand,
it is executed imrrediatcly and control~ill return to the cnvircnnent from which CP ~as entered.
If thelire entered is not a K-type CMS command, or the RT cc~mand, the11ne is stacked tc te used as terw.inal inrut and central will
return to the environment from which CF was entered.
As manylines as dEsired may be stacked in this way to be used in placecf successive lines of terminal input.

I

tT1::\1

~~
•·
"""1

-·--.. · - - - ·------"!-•

~

~·~§:

~
~

ii

-~~~

HH
~s~~

;.~

.~

.

~[

~· 0
:J

""'.... 0n

~~a~,
.. :l
~ g

~

.a

.

:;

I

s

~

-- - ·--·-·-.. -... -..-·---t----- - - ..

~aa

~

_

~

i

~;5·5.

tb

1f

f~[1'.l~ ~~ ·c=; ~

~m!

g_~~
~g

~

r-----i ~-~~ 1--~i~~
:~~
a:.z~

"i1{;

ti

Q

~~

.. 1

~:d

·11

ii"-< ;::-:.1·-··-·- - - ·--. - ~" ~·-· ~~·-- - - r~ - - - +66~!?..a,

3~1"';it;'E_g~B~~li

--~~
n~

a:131
~·~.?'.
g.. 11.

ii~-··--·-1--·

6- i~w2-g

g- ;a~ ~3~~!11~.8~~ ~~ ~ ~9 a. i;;ii ~~::i.15::tla~.., ~ ~

~.a ~

3a"'

"a

~

.D~

~

"..,,3~·

:!!

i;;

::t

i

1

3~"'i

%~~~ ;~1~;12~., ,; ~1~ 1s....;r-0 31
3 a~
g ~H
..~ ~ 1 3=~g&.I

"'5

"

n~~

%U~
.; a.~
3 ·<
'<

i8

·,

L9·LZ·6

J 1- ·--~;;~;;;g 1 ~H~5 1""3;r;::! .. j~"'6::r>

~ ;;-

>'.'

Hi~

.

~ 2

~

~--

5

ii

i

~ff~f:l
D3if2

iO
<

"

;~

? -q

~

~

3

c·o·c·c

7?

,,,..
= '1~11111

u: a ::fl';:, l#4!4WMa:a1;11:::::.::11Ju:.,as::;;a:u'"ui::: ,,,,;:::1:::::u::;,;f11-$liiaJaaz:111aa.; ·,-,a: : ;w: u . ,a L,~·;J "; 12

xy 14

* -

t

1

:

1

11,,.

...l/;t-J
CP1CMS!,;ll~

~!

~

~

"'1

Env~rcn~entf,

Ccmmands, and Requests.um:

1..HE.Y1'

fl05/01/69
2. 3. 0-4

lCGlN
~

tHRS
HI HO-->LH"q(file does not exist)
EC1T~------------------~------->: (f ilc exists)

I::Dl'I-:---------- >

PRINT
NEX'I

FHD
LOCATEtHETE
CHANGE

INfUT-----------> xxxx

•

xx xx

I

<---------- (null line)
I:E'JYPE'IOf
FCfl'I~JN<------ FllE

PliIN1FLCAC
S'Irdl
EiiAS

OHL

3SS

<----(pr~s~E

A'ITN key)tl:GI~--->

1c;ct1

1

I

t

J

t

I

~-

~

fl".

f:/

05 '01/69

4'54 3.0.0-2

d,4.,/ 05/01/6';.J.../1'1(1 3. 0. 0-1.=. :J. c

c~s

fee
J
syncnymor ahtceviaticn, theexrdnlad tc the criqindl c~s command
SEJOEncE ~s pertcrrrcd aqain.

CCi'H'.l\NI:S

l~e CMS tcnmands provide user
facilties fer file maintenance andD3fiEulation, e>ccuticn control, debugginq, 1an~uage precessing, andvacicus utility

Illis means that the usc0r is able tc subEtitute his own proqral'ls
tcr J1E~-rusident commandE by creating a ccre-image file of thff
flCJtim and ctssjqniny it a tilenarne ideutical to that of the ccrrrr~nd
it i3 tc
rcplac~.
This alsc rreansthat any user filein core-image
tcr1t uay b~~ called directly as a command, by issuinq the filEnanE (anrJ
any oferands CL racarrcters exrectcd by the program) as an input lieo
tc thE Cfo!S Com1cand enviro11me11t.

c~eraticns.

'Ihese corr11 rnds

may t;e issueu frem the terminal or called fromccrrma11d consists of a ccn:mand name and its
e~~ranJs, if aiy.
l\bhrcvi<lticnE have been estatlished which allo~ th~i;t·:c to s~ccity only the numhcr of characters of each co11rnand cow111ilnd
lld1~ ~hichFGrvc tc uniguely idc~tify that ccmmand. In the case ofc c :i n .lf. ,j s • wi t h t h (!
s a n1 e 1 e a d in q c h a r a ct c r .s , t t e
mo r o· c c II' rr c u 1 y
use d
11 J, 11 ,c o rr ro a n J h as L c; E r a s :::i q ii € d t he sh c r t e r a b h re v i a t i o n •f o r c x am p 1 P. ,11
is tnG
aturL'~iation for the
LIS'l'F co:nmand,iH1d1.0" forLOAD.
Any
UUffiG~r cf additional characters beycnd the ~inirrum may be specified in
11
tte
ccrrr.-anrj carrc.
ror this reason,"LO","LOA",
and 1.QAf." all11idi:;ntity thE' I°CPL ccwrrand •.ihcrcai:
1.CADl"i" is th! minimum abbreviationfc[
thelCA[)Hllcor"n1dnd.
Iftheuser desires to Chilngc theittrEviations er use syncnyns, the SYN ccmmand can be used to.create
tla ccnnacd nane~.
Uf-Ol

i:rcgra1ri:.

tyFed command is internallyname and the abcve searchingEach~ brief dcfcriptionof each CMS command is qiven in Ar~endix A.
Any invalid ccnnand,i.e., cne ~hcse ccmrnand i:rcgram dces ~ct resirte
in tl1'.? CNS 1111cln1s or transient-area ilnd fer .. hich a corc-ima<Je modulec .H n c t
l: € l cc :H n d ,\oi i 11 l: e i g no r E d an d t he 11 es s a g c " I NVAI. I D C "I S
tCl'~,\t\[; 11 will t.( tyfEd at th<~ terrrina1.·
ci:erand p:ccessinq is handlf>dty
th1! indivi:.li;alccmmand programs and these proqrams frcviile allroE>:.s,1qei:: d~alins with cc[lluan1l fcruat.
~

format ard usage cf each cf the CMS ccmrrands are dnscrihcd in
the fellowiny sc.cticns. ExamplP.s cf ccmmand usaqE and eachr~sfcr~e a11d
e1rcr mnssaqe which may be issued are alsc given. A
i:c;;pc1u;c is ar.y n;c.ssa.qe t.ypHI at the: terminal te indicate the cau.sP ofan errcr return cede in register 15, which\oiill terminate
commandexecuticn. . All responsAs and error mcssaqEs which ~ay te issu~iarpeac in alptatctical erder in Ai:vendix c,\oiith refccencee to th8d€tJilIhe coa:1ha11dnam<' and 13ach c:f
its o~('rand.s must hE
sepn:ate<l hycni:; er ncre tle1.ks. The CFerancls .. hich arc vali.1 for (?ach ccmmand are
d12cu.ssEd under the 1:.QL.l!!ll.t ~ecticn ct· each ccmn:an<l dcscrir;tion anti
alsc in Ari:e1~1lil< P.
Each ccnrrard nu1:t be ~i:ecified in a sinqle line

· 1Hc carriage
return signals the end cf a tyfical input
To sta(krrultirlo CMS ccn&andE en
one line of inrut,
use theJu.c-e11dchaJiaCter,
which is defined as thf. If •'Ihe li11r>-,211d
ch~r~cter can lE rede1ineJ vid the LINFND ccmmanJ. CMS com~ands cannot
tc ccrtinucd cntc add1tic11al linc:s.

ci irrut.
li~e.

:; c c t i c n ( ~ )Each o:s cc11111a11d !Jas a ccrresfcnding corrmand i:;rogram which
u:sidc:.l:: Eitl:Ei in the nucleus, in a transient area, or in the
J i E k- r e s i de ll t · f c r t i ono f c Ms • Th is p i- o q r a m is i d en t i f i e d b y t heccro[and wcrd
CI itsaltrcvinticn, which isissued as
the loft-mostirrut cc the ccnmand line.
ilhc11 a ccmµand is issueu, the directories of the transient area
ccnrrands and thEn th£ nuclEuE-resid~nt ccrnmands are searched for tha
corrE.q>onding 'crnrrand~i:eqr,in.
lf the proqraJJ
is located in one of
the lirectorius, it is assumed to be in core, and centre] will bA
trdnsfcrrcd tc it di1£ctly hy a BALR instructicn. If not, a LCACMOD
will be issu~d to brin4 the command program into core. In attero~tinq
to lccatc
this ~rcqra~
en disk, the user's per~ancnt and temporary
Jic2ctori<:s al)d th<• sy::>tem Jin•ctory are searched, in that crrler, fora filewith the E~ecified filenane(ccmrrand name) and afile~ype oft'GDUI.:, indicati11q

tliat thofile is incon,-iinag12 torn.

Th€ first

file found wli.ict ncct!"" these tecuircwcnts will be loa.:h•d intc core andccr.ttcl 'Aill tc: tran.s11!r:n~d to .lt.
If the MOI.:UIE file is not found, ach2ck is nad0 tcr atb1ev1ations ty chcc~inq fer user-defined Eynony~s( i-.;

E c 'i Y t..)and t I c 1: st .t n ti a l d .£ y !C t c rr

at: b L~vi at i c n ,, ; if a m,1 t ch is f o u n ri

i11

~!

1.i1 e r E

t h e y a r e ll e s c r i b e J

f ur t h e r •fr

f7
9-26-67
3.1. 0-2

I

9-26-67
3.1.0-1
command may be used. Additions to existing macro and text library
files arc made using the MACLID ADD and TXTLIB ADD commands,
respectively. A file or group of files can be deleted from disk by issuingthe ERASE command. TI1e FINIS command must be issued by any user
program which accesses more than eight disk files, and CLOSIO isused to signal the compl<!•ion of output to the card punch or printerfrom a user program.

3.1.0 FILE CREATION, MAINTENANCE, AND MANIPULATION
File Creation
Facilities are available in CMS for the handling of disk, card, and tapefiles. Most of the CMS commands, however., require lhat the files they
access be stored on disk. TI1is means tJiat card am.I tape files must betransferred ~o disk before mai:.y of the commands can be issued for them.

File Manipulatio~
CMS file manipulation consists of copying, combining, moving, spliting,ancl listing disk files, To copy a disk file, the EDIT or COMBINE
commands can be used. COMBINE also will create a new disk file fromthe conte;1ts of two or more existing disk files and may be used to transfer
a file between the permanent and temporary disk areas. TI1e SPLIT
commancl creates a new disk file composed of the specified portions ofan existing disk file or files.

Di&k files can be created from termhnl, card, or magnetic tape input,
or from other disk files. Issui11g either the EDIT or SCHIPT EDIT
commands for a disk file which docs not currently exist will allow thespecified filp to be created from terminal input. EDIT creates card·
image files; SCRIPT EDIT accepts any terminal input up to 120 char.'l.::ten;; in length. To create a disk file from card input, the OFF LINE
READ or DISK LOAD commands may he used. OFFLJNE READ accepts
caru input in any format. DISK LOAD accepts only input in the CMS card
format. The DUMPP..EST and TAPE LOAD commands create disk files
from magnetic tape input, DU1\1PREST restores the entire tape contents
to the user's permanent disk area, wl1ereas TAPE LOAD may he used totransfer one or more specific files to disk. The MACLJB GEN andTXTLIB GEN commands create macro and text library files on disk
using the contents of existing disk files. TI1c TXTLID PRINT command
will create a file containing the entry points of the specified text library.
Other conrn1ands which create disk files from disk input are discussed
under File Manipulation.

LISTF, PIUNTF, MAC LIB LIST, and TXTLID LIST cause file information to be
typ.cd at the terminal. TI1e LJSTF command will type out the identifiers and sizesof any or all files stored on the user and system disk areas. PRINTF types out
all or the specified part of a disk file.. The MAC LIB LIST and TXTLIB LIST
commands type out the directories of the specified library files,
To print the contents of a disk file on the offiine printer, the OFF LINE
PRINT or OFFLINE PRI!\c'TCC commands can be issued. OFFLINEPRINT will print the file with single spacing and CMS headings, whereas
the PRINTCC version will use tJlC first character of each record as a
printer carriage control character,

Card files are created ln CM<; by requesting that the contents of disk
files he punched out. 111e OFFLINE PUNCH command will punch out
any disk file whose records arc 80 characters or Jess in length. DISKDUMP will punch any disk file onto cards, but will fir~( convert its contents
into CMS card format,
Two of the commands, TAPE DUMP and DUMPREST, cause tape files tobe created from disk files. TAPE DUMP copies single disk file to tape.
DUMPREST will copy U1e contents of the user's entire permanent disk
area to tape.
File Mainten~~
Several commands provide facilities for maintaining disk files, UPDATE,
EDIT, and SCRIPT EDIT allow any portion of an existing file to be changed,
deleted, or added to. UPDATE processes the existing file against an
update file, a1so stored on disk. Both EDIT and SCRIPT EDIT allow thecontents of an existing disk file to be ch:mged from the terminal. Tochange the identifier of a disk file without changing lts contents, the ALTER

,,.,

j

~

•·
!

1

~

~'

"1

A?

7,h'/ 05/0l/69
3.1. 1-1.:fi•C.

#-:71'
3.1.1.

L/7

AT.UR

3.

Tne A~1Eh ccnnand changes the name,files.

I
AL1ER I

t.

c.f n

oft

•I

ctn

•

nf n

nft

nfm

*

*

*

cfru

is the criqinal filename, filetypo,and filerncda.

ufn

nfm

is the ne~ tilcraEe, filetyi:e, andfilewcdc.

ntt* JlF.VEll * *!!.!.2Ll.:!£.Eli.sl..9£.§:I
J

I

E(C0001)
OLD FIIE ~C1 FCU~D
The fil~ tc be re-designated is net in the file directory.
Chee~ the spelliny of the fileuaue and ty~e.

_:

ofn · cft

Al1EH JBS LIS1ING

Thf llSTI~G file frerr an aEEemtly of JBS is now referenc~d by the
filenarrc JIEVEL3.

- - - - - - - - - - - - - - - - - - - - - -II

Al

the filename

type, or mode number of usec

lf!..!ll.H:.

--

AlTEF BEN SYSIN F5 eRCG3 SYSlN P2

1he tile f crruerly called DEN is now referenced by
FUCG3, anf is rcad-ctly instead of read-er-write.

.f.H.Ef..§£:

05/01/69

so 3. 1. 1-2

E(O~OO~)NEW FllE AlHRACY EXISTS~ith thenew name, type,and node already exists.
Chan£~
cte cf the fields cf the new designation.
If
concatenation with an existinq file is desired, use theA file

CCIHltiF. ccmrnand •.!i§.:!9s:
E (CCCCJ)

Ibe n~roe, tyre, or mode number of any file on the perttament or
tcm~~rary fjsk may te chanqed with the hLTED command.
All fields
ct the ccunaud must be sp<'cified.
Any field not chanqed may be
rei;rE:scutcc l:yan * in the 11c~ file desiqnaticn.
If the mode
nuu,l:er is not changed, the original mode may t;e represented by an*·
1K!£E:

E(COCO~)NC CllilNGFS MAU
The nEW aesicnaticn E~ecified isde.eiyraticn.

ALTE~ dc~s vet rrove files
rr. a ) 11 o t t c c h a n <J c o •
se c

b.

AL'lEF may not h.: US(~d for files on the system (SY) disk.

tct~een disks.
The mode letter,c OM E I NE cc rn ma n d • •

P

t hn

J!HH.!H&§;AlTEH yivEE nc cesEcnse
rresE~ge ar.f cede.
!J!H.f..!S.§:the original

IlLEGAL ~CCE Cll~NGE
An attempt ~as made tc chanqe the node letter. ALTER does
net rrcvc Jiles tat~een dirks. See the COMBINE command.

~(COC06),._,,

the same aser T, orE(C0005)

cL T,

a.

OU: MODI: HlEGAl

The criqindl n:od(! specitied dces net begin with P
dccE rct end with a nurrher teem l tc E.

NtW MOUE lllEGAL!ha new mcde spacificd docs not te~ir
mode: rurrbcr iE net l:etHEn 1 and 6.

with P er T,or theE(CCC07)
INSUFFICIE~T FA~A~ETEFS
A nanE, ty~e, ard wcdc ~ere net s~eciticd fer both filPs.

except the Readymessage, er

an error9-15-67

5)...

67
9-15-67

3.1.2-1
CLOS-IQ
3. 1. 23, 1.• 2-2
CLOSIQ.

CLOSIO

Example:Purpose::a.
CLOSIO PRINTER READER
Spooling areas assigned to the user for the printer and cardreader
are closed. The reader area is erased. The printer file is queued
for actual output.

CLOSIO notifies CP/6'7 that I/O operations to an offline unit
record device are complete.
. .. _,-- -~' '-·-·
Forn1at:

Err_?r Messages::--{-~~~;;~,-:---t~~~~~-;j--~~~~:;~~--~~~~~r-:
!
:

•~

CLO

1

None •., -- - - - -- -- - - ~- -- - - - -- - -- -- --- - - - - - - -- --- --- -- ---..!
Usag~

CLOSIO is normally used as a supervisor-supplied function withinprograms written in assembly language. However, it may b<1 used
as a co1nn1and in cases where user-written progrmns including unit
record I/O routines terminate abnormally or do not include a call to
CLOSIO.
CLOSIO notifies CP/67 of an end-of-file condition for the devices
specified. Any combination of the three devices 1nay be specified
with the command, Undefined devices are ignored, When CP/67
detects the end-of-file condition, the disk spooling area assigned
to the user for the specified device is closed. Printer and cardpunch_filesare queued for actual output, Card~cacier- in1;-~t-file~~re- erased,_
--·
- .
- ..
-

All CMS unit record commands (OFF LlNE, DISK, DUMP), whether
issued from the terminal or called from within a program, havealready performed a CLOSIO when control is returned to the issuer.
~:a.

CLOSIO is not used after CMS I/O commands,b.

CP/67 assumes CLOSIO for all unit record devices when
the user logs out.

c.

CP/67 interprets any invalid CCW as a CLOSIO for the device
to which it is addressed.

Responses:

)

None.

,,,.

A

~·

"'

""

~

5J<-;'1

3. 1. 3-1
COJvlI3JNE

11/1/GO
3.J..2-3~Q
3 .1. 2CJ.OSIO

CLQSIC is

COM ill NE

The COMBINE command joins two or more disk files into a single
file, moves files between disks, and changes file designations,~enerallycalled to signal the end of an offlinc
Whrin
CP detects the end-of-file condition, the disk spooling aveas
aPo closed ~nabling tho printer or card punch files to be
quducd for actual output.
op~ration by sending an end-of-file condition to CF.

If it is desired to insure that. a number of offlinc punch orpr n~ file~ arc output together, the CLOSIO function can be
di abled by the following command:
CLOS JO(PUNCHtlPRINTJ:Rj

OFF

Aft el' a nu l!lb er of off l inc punch or print f i 1 es have b c e r1 output ,the CLOSIO function can be re-enabled by the following command:
CJ,OSIO

1(PUNCH'l_PRINTER

j

ON

In. this way offline output can he collected before it isoutput to the physical device.

ac~ually3, 1. 3f}!!EOS<::

Addi t !_on al J0J:..£E :_1.

Cf/

9-15-67~~:---------r--------------------------------------------------,~OMBINE): nfn nft nfm ofnl oftl ofml , , • ofnN oftN ofmN

f c

.J:

I

:

L---------L---------------------------------------------~----~
nfn "nft nfm

are the filename, filetype, and filcm.ode of
the file to be created.

ofn oft oim

are the filename, filctype, and filemode ofexisting file(s) to be included in the new file,~!}.SS

The file to be created and each of the included files must be specified
b.y filename, filctype, and filcmoclc. Input files must have the same
record format (fixed or variable length), Input files of fixed length
records must have the same record length, Any munber of input files
can be included i.n the new file, in the order na111cd, but the commandmust not exceed a single input line.
The output file will be created on the permanent or temporary disk,
according to the mode letter of the new file, Input files may be on
any disk.
If the new filename, filctype, and filemode are those of an existing file,the old file will be erased when the new file is created, The old file
may be among the il!put files.

·Notes:a.

Files may not be copied to the system (SY) disk,b.
As the input fi.les arc processed, a t.~rn1p~l"_ai-y_ w.ork file
1 '.jTE:MJ:>) .. rn'IJ,;g:)_!J1111-",
where 11 mm" is the s1>ecifiecl-n~~o-dc. of theot{t1)ut-filc, is created. When processing is completed, this file isgiven the designation specified for the output file. If <in error occurs
such that input files are clcstroycd, records can be retrieved fromthis work file,5{
9-lS-67SCS{,
9-lS-67
3. 1. 3-3
COMBINE

3. I. 3-2
COM13INE_!3.esponses;

E(00013)None.

ATTEMPT TO COMBINE FIXED AND VARIABLE LENGTH FILF.S.
The input files must all have the same record format,

Example~a,
COMBINE FILE Di\01 P3 TSTl FILE PS TST2 FILE PS
The file "FILE DAOI P3" is created on the permanent disk, containing
all the records of TST 1, followed by the records of TST2. TST 1 andTST2 are not changed.

b:

COMBINE JOBS EXEC TS JOBS EXEC PS
A copy of the permanent disk file JOBS is made on the tempornry disk.
c,

COMBINE J013A FORTRAN PS JOBA FORTRAN PS SUBRl FORTRAN PS

The file SUBR l is appended to a copy of JOBA, and the new file replaces
the original JOBA.
Error Messa~

E(OOOOl)
FILE ''filename filctypc filcmodc" NOT FOUND.
The file specified in the message was not found. Files re1nain'as they were before the conu11and,£(00002)DISK ERROR WIIILE READING.
An I/0 error occurred, or· there is insufficient core space forbuffers.
F,(00003)
DISK ERROR WIULE WRITING.
An I/O error occurred, or the user's allotted disk space isfilled,ERROR IN NAME, TYPE, OR MODE OF OUTPUT FILE.
£(00005)
Correct lhe designation of the output file.
CORRECT FORM IS: COMJiINE Nl Tl Ml N2 T2 M2 , • ,WIIF:RE Nl, Tl, Ml AIU-: THE NAME, TYPE, AND MODE
OF TIIE FILE TO I3E CREATED.
AND N2 T2 M2, ETC. ARE THE FILES TO BE COMBINED.
The conunancl format was incorrect, Files were not changed.

E(OOOlO)

MODE SPECIFU:D FOR OUTPUT FILF: IS ILLEGAL.
E(OOOl l)
Correct the mode specification of the output file, If the first
input file had mode number 3 or 4, it hns been erased,
E(OOOl 2)

ATTEMPT TO WRITE OUTPUT FILE ON SYSTEM DISKILLEGAL.
The system (SY) disk is read-only.

~:m, \liiliiliii!iite:q;;;;&;:UJll!Mlillliii41.11.MV,i!U,;at..,J•.JS .j!J.

-

:aa:ta;, :a. jjj . • JIU ..• QE4JPjiiL4DZ liiiiiili . Ji.WS~.

!!'Ir'"'~·*

I r

1't'mus Id ...

= '"4 "" .... -· . ,

JI!

Miirf

·j·&l'i··'"11"".·"""1'~~'!'!1

~

~

,I"'\

-8-23-67 '3.l.4-1
DISI<

j--;

3

.1. 4-2

8-23 6- 7 -'~'

~
D~SK

3.1.4

n'

-,
/

Purpose:The DiqI< cornmand punches specified permanent disk files on
cards in a special format, and can reload these card files
onto disk stor~9e.
Format:• I---~-----------------------------------------,{otsiq: jbUMP filename filetype filemodc\ l
I
Dl ;'
\LOAD
I I
L_____ l----------------------------------~---J
specifies a file is to bepunched out.

. DUMP

filename filetype filemo<lc specify the file to be punched.
LOAD

specifies that one or morecard files are to be read andsaved on the user's permanent
disk.

The DISK card format is:,----------7----------------------i
columns
content:----------{----------------------+
I1
I ·a 12-2-9 punch
I
1

l
l
t
l

1

1

1

2-~

5
6-SS
56-S7

1

CMS

I

l blnnk, or N for EOF I: file du ta
I
I blttnkI: filename, type, mode l

58-76
_•
1•__________
77-80 11______________________
sequence numher
1

The DISK LOAD operation will read any number of deck punched by ·DISK DUMP. File designations are obtained from the card stream,and may not be specified with the command. Any existing filewith the sarni3 designation a!l one of those in ·the card stream
is erased and replaced.
Files to be loaded by a DISK LOAD command must be read by CP67
as a single deck before the command is issued. An identification
card with CP67USERID in columns 1-10 and the user's identification
starting in column 13 must precede the deck.
Note.E_!.

Data is punched in Extended BCD Card Code~b.

Each file punched out is preceded by a CP67 identification
card containing the USERID. This card must be removed
before reading the deck.

trv.nsfcrrcd, ;;md end-of-file card is punched with an 'N' incoluran 5. Thi~ card contains directory information, and mustremain in the deck. '£he oric;inal disk file is retained, unlessthe mode is delete-after-reading.

.

Responses:
a.

DISK DUMP gives no response except the Ready message.

b.

filename filctype filemode LOADED.

DISK LOAD gives this response for each filo encountered in the

input deck.
completed.

'l'he Ready message is typed after transfer is~~1ple~:_a.

DISK DUMP PROCS TXTLIB PS

The specified file is punched out. Each ca.rd contains CMS incolumns 2-4, file data in columns 6-SS, and the characters
PROCS

Usage:For a ~ISK DUMP operation, filename, filetype, and filemodemust be specified, Only one file is punched out by a command.
The fi~e may have either fixed or variable length records, butmust b¢ on the p~rmancnt (mode P) disk. After all data is.

a.

TXTLIDPS

in columns 58-76. The cards are sequenced 0001, 0002, etc., incolumns 77--80. 'l'hc last cnrd contains an 'N' in column 5.
b.

DISK

LOAD

If the deck produced in the previous example has been readerased~A new fileis created with the data on the cards, and receives the designation
PROCS TXTLIB PS. The following response is typed:by CP6 7, tlw disk file PROCS TXTLIB P5 is

PHOCS TX'.I'LIB PS LOADED.
The Ready message will then be issued to indicate completion.

k£1-23-G7
3.1.4-3.

~

1.f
3.1. 5OUMPRES'l' dumps the contc'nts of the user's permanent disk ontotape, and can reload a disk from such a tape.
~:..

i---------.--.
H~~~:~::2_:

FATAL PUNCH ERROR.

Indicates an I/O orror on the 6ard punch. This message
should never occur under CP67. Notify the responsible
system programmer.
E (00003)

DUMP REST

Purpose:CORRECT FORM IS:"DISK DUMP" FILENAME FILETYPE FILEMODE
OR "DISK LOl\D".

The format of the command was incorrect. No cards were
punched or read. Issue the command again.
E(00002)3.1.5-1
DOM PREST~

f.rror Messages:
E (00001)

8-23-67

Fl\.Tll.L

A message is typed requesting one of the following replies:

DISK ERHOR.

1\n I/O error on the disk occurred. A DISK DUMP oreration
may be retried. For a DISK LO.i'\D operation, notify theoperator to enter. the card deck aga:in· bcfoi~e retryinq
the con:man<l. If the error recurs, notify the operator.
E(00004)~_{~ESTOHE}

specifies the permanent disk is to beformatted, and contents of the mounted
tape arc to be copied onto it.

USD.2£.!..

The user's tape must be mounted at virtual device address 181
hcfore the command is issued. ·rhc disk address is always virtual
191. For both DUMP and RES'l'ORE operations, the command positions
the tope at the locJd point with a m::wnm.

ILLEGl\L Cl\RD IN DISK LOAD DECK.

In the DUMP operation, data.on the pe>rmanent disk is copir!d tothe tape a track a time, including all directories and pointers.
'A RESTORE operation copies these records ba.ck to a disk inexactly the sumc locations. The disk is automatically set to
CMS format, so a new or different disk pack may be used.

A card was encountered in the input to DISK LOAD that was
not punched by DISK DUMP. A CP67 output identification
card may have been left in the deck, or the wrong deck
may have been read. The deck being rend at the time ofthe error has been flushed, and will have to be re-rc<idbefore retrying the command. No permanent file has beencreated.

E(00006)

specifics the contents of the permanent
disk arc to be copied to tape.

Fl\Tl1L READER ERROR.

Indicates an I/O error on the card reader. This message
should never occur under CP67. Notify the responsible
system progr.::immcr.
·
E (00005)_{g?MP}

NotC'.:...:_
a. RESTORE may not be valid if the locationof the user's
virtual disk 191 has been redefined since the DUMP operation.

END CARD MISSING FHOM DISK LOAD DECK.

Res122ns~s:

Physical end-of-data for a DISK LOAD was encounteredwithout ~eading the end-of-file card ('N' in column 5).
The file created on disk does not have the correct
designation. It rnay be accessed under (DISK) (TFILE) Pl.
Note that the mode is delete-after-reading, so an ALTERor COMDINE must be issued before inspecting the file.

a.

SPECIFY 'DUMP' OR 'RESTORE' :This message is typed, without a carriage return, as soon as
the command is issued. ~llicn the keyboard unlocks, enter
DUMP or RESTOIIB, or just D or R, to specify the operation.
A reply error causes the response to be repeated.
·b.

DUMP /RESTORE MOVED nnn CYLINDERS.
WERP. nnn RECOVEflABI,E Tl\PE ERROHS.

Tll~RE

This message is typed ~t the completion of the requested transfer.
If the number of cylinders specified is not equal to the size of thevirtual disk, an irrecoverable I/O error caused early termination.

•

""'

--

I

·~

'~

""""'1.

I"'bh
8-23-67

3.1.5-2

DU~!PRES'i:_\/

Examples:a.

DUMPRESTSPECIFY ~DUMP' OR 'RESTORE': D
DUMP/RES'.Ii'ORE MOVED 005 CYLINDERS.
THERE WERE 000 RECOVERABLE TAPE ERRORS.

The contents iOf the user's permanent disk have been dumped
to tape. No !errors occurred.
b.

DUMPRESTSPECIFY 'DUMP' OR 'RESTORE': restore

DUMP/n.ES'l~ORE MOVED 005 CYLINDEHS.
TIIERP. WETiF. 000 RECOVER71.l3LE 'I'APE EI-.RORS.

The contents -0f the user's permanent disk have been replacedby the contents of the dump tape. No errors occurred.
Er~~£J:.les~~None. I/O errors arc retried 10 times.
Response (b) is typed.

I
If no recovery is made,·,.

3/9/70

3.1.6-1
EDIT

3.1.6 EDIT{

Purpose:EDIT has two purposes: (1) to create card image files
on the permanent disk and (2) to make changes toexisting card-image files on the permanent or temporary
disk.
Format:Ir--~-------~r-~-~-------------~-------------,I

•

I
I
I
I
I

EDIT

filenamefile type

•I

·

I
I
I
I

E
I

------~-------------------------------------

filename

specifies the filename of thefile to be edited or created.

file typespecifies the f iletype of thefile to be edited or created.

Usage:

If a file wi.th the specified filename and filetypedoes not exist, EDIT assumes the file is being created,the Input environment is entered, and information typed
by the user thereafter becomes input to that file.
If such a file does exist, the EDIT environment isentered, enabling the user to issue EDIT requests andto modify the specified file.
Input Enviror:8ent: The Input environment is indicatedby the message ; 1l·i?UTu, a carriage return, and theunlocking of the keyboard. The user may then typesuccessive lines of input to the file as fast as hewishes. One card image is created from each input
1

line.

For files that have a filetype of ASP360, COPY, UPDATEor SYSIN, each input line is truncated after colul:ln
72. In the In?ut- enviror~":lent, if such a line contains
a non-blank character in colur:m 72, the message"STATEMENT CONTINUES:" will be typed. For files thathave the filetype LISTIXG, the truncation col~.n isc·olumn 132. For files that have a filetype of MEMO,
the truncation colu8n is column 80. For all 80 chara-cter- -files ·t:;hat-·-have- a ·file-typ-e other than AS-P-360, ·SYSIN, COPY, UPDATE or MEMO, each input line istruncated after column 72. Files with record length
other than 80 or 132, will be truncated at the fullline length.

3/9/70
3.1.6-2
EDIT{

Normally, an identifier is placed in columns 73-80 of each card
image. The identifier consists of a three character identification
and a five digit sequence n~~ber. The identification is takenfrom the first three characters of the filename; the sequencenumber begins at 00010 and is incremented by 10. The line
identifier in collli~ns 73-80 can be changed by issuing theSERIAL request in the Edit invironment.
The placing of the identifier in columns 73-80 can be eliminatedby specifying no serialization in the SERIAL request; thiscauses the truncation of innut lines at coiumn 80 and no otheridentifier assigned to each.card image. A file whose filetypeis SCRIPT, LISTING or MEHO automatically defaults to noserialization.

Internal or logical tab settings indicate a column position
that defines the beginning of a field within a card image. The
logical tab settings are automatically assumed according to the
filetype specified. These internal tab settings have no relation
to the external tab settings on the terminal. The assumed
internal tab settings are given below, where the first of thesenumbers indicate the column of the card image in which input
is.to begin.

(

Filetype Specified
in EDIT Coc2and
FORTRAi'i

SYS INASP360COPY
FLOW
UPDATEPL!

SPLl
SNOBOL

EXEC
REPS
TEXT

default settings-·

Assumed Tab Settings
1,7,10,15,20,25,30
1,10,16,31,36,41,46,51,56,72
Same as SYSINSame as SYSINSame as SYSINSame as SYSIN
2,10,15,20,25,30,35,40,
45,50,55,60
1,7,17,30,40,50,60
1,10,20,25,30,35,40,45,

50,55,60

1,5,8,17,27,31
2,7,15,24,25,30,73
Same as REPS
1,5,10,15,20,25,30,35,
40,45,50

If the specified filetype is not one of those listed, the defauit
setting of every five spaces is assumed. The assumed tab
settings can be redefined by the TABSET request from the Edit
environment. ···There is a character used in conjunction with the logical tab
settings and it is called the logical tab character. This
character causes blanks to be inse~ted into the card image fromthe column position at which this character is input up to thefirst column position of the next field defined by the logical3.1.6-3
EDIT(I

3/9/70tab settings. The next character from the innut line after
the logical tab character will be inserted as.the first characterof the next field. The standard logical tab character is theexcla::nation point (!). The logical tab character can be redefined by the TABDEF request from the Edit environment to allow
the character ! to be used as a normal innut character. The
physical tab key on the terminal can also~be used for blankinsertions, as it is interpreted in the same manner as thelogical tab character. The only difference between the tab key
and the logical tab character is that the tab key moves thetyping elenent to the next physical tab stop and does not print
when the tab key is depressed; whereas, the logical tab character
prints when the character is depressed and the typing element
does not move to the next physical tab stop.
There is a character used to backspace one column position in acard image and it is called a logical backspace character. For"n" logical backspace characters, "n" column positions are backspaced in the card inage and the "n" backspaced positions areoverlaid with the 11n 11 characters which follow the 11 n" logicalbackspace characters. If no character is given after a logicalbackspace character, ·the previously entered character will not
be overlaid. The backspacing is performed for the column
positions of a card image and not for the characters of an
input line.
The standard logical backspace character is the percent
character (%). The logical backspace character can be redefinedby the BACKSPACE request from the Edit envircc~ent to allow
the character % to be used as a normal inDut character. The
logical backspace character should not be-confused with thephysical backspace key on the terminal. The physical backspace
key moves the typing eiement back one position and generates
a valid innut character that takes uu·one coluran in the card
image for each tise the key is depressed. The character generated
by the backspace key does not print when entered on the terminal
and does not nrint on the offline Printer but it backsnaces
the typing el~ment one pos~tion pe~ character when theLcard
image is printed out at the terminal. Thus, the backspace key
allows underscoring and overprinting at the terminal. The
logical backspace character prints only when entered and does
not take up a column in the card image; it._ logically backspaces
one column in the card image.

The Edit env.ironillent is entered from the Input enviromnent by
typing a null line, i.e., a carriage return with no prior input
on the line.
Envfro~ment~- The Edit environment is-· indicated by ·the· message
EDIT 11 , a carriage return, and the unlocking of the keyboard.
The user may then type requests to the EDIT coITuuand. All changes
to the file become effective immediately; this allows recursive
modifications to be made to a file~

Edtt
11

i •.

3.1.6-4

3/9/70filfil
The logical tab character and.the logical backspace charactercan be used in the following requests i~ the Edit environment
to insert blanks and to backspace in the card image respectively:
BLAl~K, FIND, niSERT, OVERLAY, AND RETYPE.
The logical tab
character and the logical backspace character can be used as
normal input characters in the "string" operands of the CHfu.~GE,
LOCATE, and DELETE requests.
There are two modes in which to operate in the Edit environment:•verify" mode and "brief" mode. Verify mode is the normal mode.
Verify mode is the normal mode and causes an automatic typeoutof each line that has been changed or searched for as the resultof a request. The brief mode does not type out the specifiedlines, and thus the user must issu~ a FRINT request to get the
typeout if it is desired.
The input environment is entered from the Edit environment by
typing the INPUT request, and a carriage return.

Notes:a.

New files created by the EDIT command are written on thepermanent disk with mode Pl.

·(.

Existing filei being edited can be read iri fro~ either thepermanent disk or the temporary disk. If the FILE or SAVE request
is issued, the final copy of the file is written out to the samedisk with the same filemode as it previously existed.

b.

e.

The final copy of a file being edited or the first copy ofa newly created file will not be permanently written on disk
until the FILE or SAVE request is issued.
· d. Associated with each file is a pointer which refers to a linein the file considered to be the current line. The current line
is defined as the line that is being created or edited in the
file. 'Then the Edit environ2ent is-entered from the Input
environrr.ent, the pointer is positioned to the last input line
typed by the user. When the Input envirori. rnent is enteredfro3 the Edit environilient, the pointer is positioned at the lastlirLe edited by the user. When the EDIT com.-:land begins in the
Edit environcent, the pointer is positioned before the firstline in the file.
e. A null line is automatically placed in front of the firstline of a file being created or edited to permit the insertionof lines at the beginning of the file. When EDIT begins in the
E-dit environme-nt -0r wnen a 1'-0P -request, or p-G-ss-ihly the -UP request, is issued, the pointer is positioned at this null line.
A null line is also placed after the last line of the file topermit additions at the end. When an end-of-file condition
occurs, the pointer is positioned at this null line after thelast line. The two null lines never get written on disk.

..
3.1.6-5

3/9/70f.

(

If the end-or-file is reached by an EDIT request, a message
is typed out that states the request that caused the end-of-file
to be reached and the pointer is positioned after the last lineof the file. ·g. · A file must consist of at least one line to be written

permanently on disk. A file consisting of only a null line may
not be saved.
·h.

To insert a blank line in a file, type at least one spaceand hit carriage return.

i. If a new file is being created, the Input environment isentered first= If no serialization is desired or it is desired
to input 80 characters per card image, the Edit environment
must be entered and a SERIAL (NO) request issued before any
card images are created.

j. If a file already exists with no identifiers, the SERIAL (NO)request must be given each time the EDIT command is issued inorder to maintain the data that exists in columns 73-80 of the file.

I<fk. logical tab settings that are redefined by the user for afile must be redefined each time the EDIT command is issued if~~he same logical tab settirigs are desired.

1. If the logical tab character is redefined, the TABDEF request
must be issued each time· the EDIT cora.rnand is issued in order to
use the same redefined logical tab character.
rn. If the logical backspace character is redefined, the BACKSPACE
request must be issued each time the EDIT cor:u:i.and is issued inorder to use the same redefined backspace character.

n.

If extensive input and/or changes are being made to a file,
it is a good time-sharing practice to make few additiops and/orchanges at a tine, issue the FILE or SAVE request, and thencontinue making additions or changes to the file. The process
should be repeated until all additions and/or changes are made.

o. EDIT uses an inter~ediate work file during execution which
has the identifier (D:?UI'l) FILE. This work file is automaticallyallocated on the user's p~~manent disk with a filemode of Pl if
the file being edited does not exist. If the file being edited
does exist
the work files are allocated with the same modes
as the file'being edited. If the work file exists when EDIT isentered, the messar;e ~ 11 (E~PUTl) FILE Pl" EXISTS. ALTER TO SAVELAST FILE EDITED OR ERASE.' The size of the work file will bethe- size· of the .. file being edited plus change?.. El:D.d__ add~~~<?ns.
When EDIT is terminated with either the FILE or QUIT request,
the work file is erased.

3.1.6-6

3/9/70

EDIT

(

p.

If previous EDIT terminated abnormally, the current changes
or the newly created file may not be completely lost. After CMS
has been initialized, issue a LISTF to verify whether (INPUTl)
FILE Pl exists. If it does, ALTER its filename and filetype.
Then issue the EDIT command for that ALTERed file. Issuing
EDIT before ALTERing the filename &nd filetype, results in themessage in o. (above) being typed. EDIT will then terminate
with an error code.
q. If the file being edited has logical records larger than
80 characters, each record will be truncated to its line length
when read. When the FILE-or SAVE request i~ issued>- th~·full logicalrecord will be written on the disk.
·r.

All input to the file being edited will be converted fromlower case t:o upper case unless a f iletype of MENO or SCRIPT
has been specified. A MEMO file or SCRIPT file accepts thecharacters as is without translation.
s. If a filetype of REPS or TEXT is EDITed, tab settings will
be assumed and a n12-2-9" character will be inserted into column 1
if it appears blank.
t. If a null line is entered in the Input environment, the Edit
environment is-entered. If a null line is entered in the Edit
envirom::ent, the confirming message "EDIT" is typed out. To
enter the Inout environment from the Edit environment, issue
the INPUT (I) request.

Responses:

NEW FILE
The specified file does not exist, thus the Input environment
will be entered. All subsequent input lines will be accepted as
input to the file.

INPUT:The input environment is entered. The logical tab settings may
be either those defined by the user or those assumed from the
filetype. All subsequent input lines will be accepted as input
to the file.

DEFAULT TABS SETThe filetype specified is not recognized by the EDIT command;
thus the default _settings are taken for_ the logicaL tab_settings.

EDIT:
The Edit environment is entered. The logical tab settings may
be either those defined by the user or those assumed from the
filetype. Edit request may now be .issued.

3.1.6-7

3/9/70TRUNCATED(The input line was too long. If the request "SERIAL (NO)" hadbeen previously issued or the filetype was MEMO, the input line
was truncated after 80 columns; if the filetype was ASP360 or
SYSIN, it was truncated after column 71; otherwise, it was
truncated after colunm 72. Continue typing more input.

INVALID EDIT REQUEST:

xxx ••• xxx

The invalid reauest xxx ••• xxx was issued to the Edit environment.

Check to see if too many arguernents were specified with therequest or.if a non-numeric field was specified for a numericargument. Correct the request and issue it again.

EOF:
The end of the .file has been reached during the EDIT requestxxx ••• xxx. The request has been terminated and the pointer ispositioned at the null line after the last line of the file.
Another EDIT request may be issued.
STATEMENT CONTINUES:(

A non-blank character has been entered as Input into column 72
of a SYSIN, ASP360, UPDATE or-COPY file. If this was intentional,
proceed. Otherwise, leave the Input environment and correct
the line.
Error Message:
E(00002)
FILE EMPTY - EXIT TAKEN
The user attempted to save an empty file. The file will not
be written on the disk and the EDIT command will be terminated.
Requests:

Requests are issued to the EDIT command only when the user is in
the Edit environoent. These requests allow the user to manipulate
and edit files. If requests are issued during the Input envircnment, they become lines of input to the file.
Each request is separated from its operand by one or rr.ore spaces
unless otherwise snecified. These spaces can be inserted byusing the space oar, the tab key9 or.the logical tab character.
If the tab key or the logical tab character is used and the request
has u1ine 11 as the operand, the 11 line 11 will be placed in the card
image as if the tab key or logical tab character was the firstcharacter in "line".

"'

"'

~

tL.

i(
4-1-683.l.6-5

4-1-68EDIT

3. 1. 6-6

f,
If the •·ncl-of-filt' is reached b~· n EDIT l'l'CjUe st, a message istyped out that states the l't'Cj\H•st th 't caused the end-of-file to ht>r,cachccl and the pointer is positionc after the la<;t li;1c of the file.
g.
A file n1ust consist of at least one'\iiw to be written pt~nnanc:ntly
an disk. A fil1· consisting of only a nullh.

· To insert a blank line in a file,
return.

hit~arriagei.
If a new file is being crvatccl, the Input en •ironn1ent is 'ente1·ed
first. If no serialization is cksir<'cl or it is c!Ps rf'cl to input. 80
ch<lractcrs pc1· card irnage, th<' Edit envin.Hnnen· n1ust b,, <'nlt•n•d
and a.SJ.:J{l/'d. 11\:0) request issued before any car in1agi.·s are Cl'<•at.:,r_J.
j.
If a fill' alrc;Hly <·xists with no iclentifi<·rs, thequest n111st be given e.ach t1nw the EDIT co1n111ancl is\issnccl in orclet·
to lllailltiliH tJw data tJiat PXists ill cuhtn111S 7~1-80 of tJ\, file.

lf.

Logic<d y1h settings that arc redefined by the user '(or a file must

EDIT
If the system goes down during the EDIT command, thecurrent changes or the newly created file rnay not be completely
lost. After CMS has been initialized, issue a LISTF and note t.l1e
size of the two work files (if both exist). ·If both work.files do exist,
ALTER the filename a~l filetype of the larger of the work fiks. Ii
only one work file exist\. ALTER its filena1ne and filctype. Thenissue the EDIT con11nand\~for that ALTERed file, Do not is sue EDIT
before ALTERing the file a.n1c and filetype, as EDIT erases existing
work files.

p.

q.
EDIT performs input/o tput with 80 character logical records.
If the file bci.ng eclit</d ha~ le >ical records larger than 80 charactc>·s,each record will be truncatec to 80 characters when read, When the
FIJ,F: or SAVJ•; request: is isst cl, 80 chJracter logical rccord.s will be
written on the disk.
r.
A11 input to the file being c"~tccl will b<' converted !rorn lower case toupper case unless a filetypc of 1' F::l\10 has been specified. A MEMO file
accepts the characters as is with ut translation.

be rcdeii1wcl each time th•· EDI l' co1nrnand is is•uc·cl ii t\e sanw logi~altab sc·tlint•s art· ck~.in·cl.

'ts.
If n filclype of REPS is EDITc.\J, tab settings will be assumc:dand a 11 12-2 .. 9 11 character will be ii\scrted into cohnnn l if it appears
blank.

111. lf lhe logical backspact' d1a1·act,,r is r .. cll'filwd, tlw
j·equ<'st n1usl lie issued each titnl' tl1<' EDJ'J' col1wna?1cl is
to use th .. s;1m1· rc·clcfinccl logical backspace character.

t.
Jf a null line is entered in theenvironrnent, thC' J::dit cnviromncnt is <·ntered, If a null line s entered in tlll' Edit L·nvironn1ent, tlic confinning incssage "EDl'l 11 is typed out, To c'nter the
Input l·nvirom11e11t fron1 the Edit envir nrncnt, i ssne the I!JPUT (I)
request.

If tlw lol!ic;il tali charac!t·r is rcckfinc<l,niust be issu,·d 1·ach lime !ht· EDIT co111n1and~lw sarnc redcfinl'd logical tab ch<iracter.

Jf <':>.knsive input <111d/ci1· chang1'S ;11·e bcin~! n1adc to a file,
good tin1l'-sharing praC'Lic<· to n1al:c· kw additions and/01· change,pnw, isslll' tll<' l"JJ.F: or SJ\Vr:: rc·quc>.c;t, and tlwn continllt' n1aking~lilions or dian~'.l'S to tlw fit<-. The prnc.~t;s shuulcl be rcp<?<1lc•d unt\il all
IFclcl1t1011s• and I or changl'f; arc n1acll'.

11.

p. F:DIT 11scs two intc1·111ecliatc work file;; during 0xecution which)u,vc the idcntiiiers INPUT FILE ancl INPUTl FILI-:, These work
files ;ire ;,uto111;1tic;illy allocated on the user's pcrn1anc11t disk
~dth <1 filen10<k of Pl if the file being <'clited docs not exist. If~he file being cdih!d docs c:>:i:;t, the work file~; an: allocated with~he sarnc motks as the file being edited.
If fiJ,:s al1·l•ady l:xist with
ithc sanH: identifiers as the work files, they arc erased. The sizeof each work file will be the size of the file bc•ing edited plus cha11gcs.and aclditioi:s. \\'lll'n EDIT is terminated with either the FJLE or,OUIT request, the work filL:s arc er;tsc<I.

lnxlt

J~~-':E.~~<:.!!.~NO PlUMARY NAME SPECIFIED.
When the EDIT con1n1and was issued, 01\y the filctype was specified.
The Iuput cnviro. nrncnt will be entered a1 cl all subsequent input lines
will be acceptccl as i11put to file.. The us .r must specify a filt,n;i.mc with
the FJLE or SAVE request when he is re dy to save the file,

F'IJ ,E DOES NOT EXIST; WILL BE CREATED.
The specified file docs not exist, thus the Input c11vit·onn1cnt will heentered. All subsequent input lines will be accepted as input to the
file.
INPUT:The inpt1f: envi ronn1Cnt is entered. The logical tab settings inay beeither thost· defined by the user or those ass\lmcd from the filetypc·.
All sub~;eq11ent input lines will be accepted as input to the file.

4-1-68/v'!:;

4-1-68(._,'(/

3. l. 6-8
F:DIT

3.1.6-7EDIT

The tab se>ttings which arc discussc>d arc internal or logical tab
settiiigs, not the external or phyRical tau settings on the terminal.

DEFAULT 'J
The fildype spcci\ied is not recognized by the EDIT command; thus,
the default settings\nc taken for the logical tab settings.

The requests are listed below and arc described on the indicatedpages:EDIT:
The Edit enviromnent ~entered. The logical tab settingli 1nay beeither those defined by t c user or those ass\.nncd fron1 the filctypc.
Edit request n1ay now be ssucd,

Par_,_~!~_rf:E.:?!

BACI<:SPACEBACKUPBLANK
BOTTOMnRIEF
CHANGE
DELETEFILE

TRUNCATED.
\The input lhw was too long.
f the request "SERIAL (NO)" had bC>en
previously issuf!d or the filct c was MEMO, the input line wastruncated after 80 columns; if t c filctype was ASP360 or SYSIN, it
was ·tru11catcd <:tft.cr column 71; l11Crwise, it was truncated aftercolurnn 72. Continue typing mor input.

3. 1. 6-9
3.1.6-10
3.1.6-11
3.1.6-12
3.1.(,-13
3.1.6-11
3.1.6-16
3. 1. 6-18
3. 1. 6-20
3.1.6-22
3. 1. 6-23
3. 1. 6-25
3. 1. 6-27
3. 1. 6-28
3. 1. 6-30
3. 1. 6-31
3. 1. 6-32
3. 1. 6-33
- 3. 1. 6-34
3. l. 6-36
3. 1. 6-38
3. 1. 6-39
3. 1. 6-11
3. 1. 6-42
3. I. 6-43

.

FIND

INPUT
INSJ..:RT
LOCATENEXT
OVEIZLAY
Prt!NTQUIT
JU:PBATINVALID REQUEST: xxx ... xx·
The invalid request xxx ... xxx was i~·ucd to the F.clit environment.
{:heck to sc•c if too n1any argurne11ts ,. ere specified with the request
or if a non-nun11.::ric field was specific for a nurneric argurnent.
Correct tlw request and issue il again.
EOF REACIJED BY: xxx ... xxx
The cod of the fjle has been reached <luril~ihc EDIT request xxx ... xxx.
The request has been tcrn1inated and the p inter is positioned at the nullline after the last line of the file. Another •,DIT request may be issued.

RETYPESAVESERIALTAB DEFTAB SET

Error_0~~...:.~g.,£..:

TOP

E(00002)

FILE EMPTY - EXIT TAI<J:::N
The user attC'mpt<'d to save an empty file.
written on the disk and th<:' EDIT command \rill be terminated.

UP

VERIFY

Requests:_\

Rcqucst·s arc issued to the F:DIT command only wh*i the user iH in
the Edit environment. These re.·qucsts allow the us r to n1anipulate
and edit files. If requests arc issued during the Inp t environment,
they become lines of input to the file.
'-·"··;
Each request is separated fron1 its operand by one or n10re spaces'uulcss otherwise specified. These spaces can be inserted by using
the space bar, the tab key, or the logical tab character. If t:hc tab
key or the logical tab character is used and the request has "line"
as the operand, the "line" will be pl<1ced in the card image <ts if thetab key or logical tab character was the first character in "line".

•~·:i1111114111aM11as;:::::1 piJGa;G;m1.w::114111:;::;w:::act::;:e:u: u:;::::;:za::.11www141.aa:mwww:cu:wa44www:e. .a:aa:ca4111.a:::;e:::::::::;u1Jt211sa .J:: ;: If+'~.·''""Tf'W
1•;.: ; :..

:+'""*"'au;;1c:n::xu::::;:•""

3.1.6-SA

3/9/70.fillll(''

3.1.6 EDIT
Additional Notes:

1.

The truncation columns used for EDIT requests are as follows:
INPUT and REPLACE - column 72 for· SYSIN, ASP360, COPY
and UPDATE, with continuation punch
checking
Column 72 for FORTRAN, PLI, SPLl,

ASll30,SNOBOL AED, FLOW, EXEC, MAD,and REPS files

column 132 for SCRIPT, and listing
files
column 80 for other files. FIND, OVERLAY, and BLANK - co 1umn 8 0
LOCATE and CHANGE - end ZONE column
PRINT - column 72 if serialization is defaulted on or if
VERIFY column is set after serialization is turnedon; otherwise all 80 columns are printed.
VERIFY - coll.L~n 72 unless set otherwise

2.

An asterisk (-;'.-) can be used to mean "toEOF" or "GLOBAL" in--a -change request- as follows:

. ~-

(,

C

/a/b/*1~

3.

A filetype of MEMO is used to input 80 character card images
containing both upper and lower case letters.

4.

The EDIT corr::1and allows nrocessing of SCRIPT files in a form
rompat-; 1.1 n; t-h
PRHJT c._. f""lm~~,.,ri
IF t-hofi 1 """J t'"""""'"'""'a.. f-ho'-'" ... '- .~r~rbrr. . .,.
"""'&.
is SCRIPT, all input lines introduced under INPUT and strin~s.. t ro d uce d tnrougn,. use 0.1...c cu/\
, .. GT"Iin• .itii.'
t. 7 O,.V.,....,RL
r:. . . '"~Av.. , "',_:.). c..... 1'Vp,,...... _r.., an d I'~S-.-,,...,.i:.:\.1
are interpreted without converti~g lower-case characters toupper-case o The character-de; ete and line-delete syrrlbols
have the usual effect; all other characters are stored without
modification.
........

....

CJ' - ...L... ....., ..L. -.......

.~ ....

-.....J ... ""

...

4

..&..

..

. . Ji. ii

v'-1 ........ 4~ .a..~ '-.1. •..._..

J,. ....._Cd""UT"\O.._ . . . . . . . . " - 'i. ..,For SCRIPT files, the file format is set to nyu (cariablelength records) so that the SCRIPT co~.mand can be used to editor print files created by the EDIT corilmand.
5.

(

Input lines containing a backspace character are converted
into canonical form such that only one backspace follows
any character and precedes the character which will overprint
the character p~e~eding_~he backspace.

3.1.6-SB

3/9/70

EDIT

(

6.

EDIT recognizes the file type of MEMO, SCRIPT, LISTING, COPY,
SYSIN, UPDATE, AED, MAD, and AS1130, in addition to thosementioned on page 3.1.6-2.

7.

If no line is specified with the RETYPE request, the current
line is deleted and the INPUT environ.~ent is entered.
The assumed tab settings are as follows:

MEMO

default settings
default settings
default settings
same as SYS IN
same as SYSINSCRIPT

LISTINGCOPYUPDATE- AED
c .,:::... •; - =~~..-(

1, 10, 15, 20, 25, 30, 35, 40, 45
same as AED

MAD

..

•

AS113021, 27, 32, 35, 45, 50, 55, 60

8.

In addition to its obvious uses in searching and modifying
fixed-format card files, the ZONE request has utility insource program editing for adding cor.uaent fields, setting incontinuation characters, searching on the serialization
field, etc.

9.

Serialization is suppressed for all filetypes except FORTRAN,
PLI, SYSIN, UPDATE, COPY, SPLl, SNOBOL, AED, FLOW, EXEC, i,:AD,AS1130, and REPS. If serialization is turned on for otherfiletypes, and either ZONE 1 71 or SERIAL id is not issued
during subsequent Edits of the file, serialization characters
may be inadvertantly shifted into column 72 or columns 73-80
may be overwritten.

-·(.

3/9/70

3.1.6-9EDIT

BACKSPACEBACKSPACE

Format:- "' ,..._ -characteris any valid character. The default·character is "_ %. "Usage:~-""'~ _The BACKSPACE request defines the character to be used as the logical backspace..

-character in the faput environment. If the request is not issued, the default- character is assumed. The logical backspace character causes one colum:-i to bebackspaced in the card image for each logical backspace character in the input

line•_The backspace characte·r must be redefined-to allow the% character to be used()

as a normal input character.

If BACKSPACE is issued without specifying a character, the logical backspacecharacter is reset to the %character.
The backspace character is very useful for defining continuation cards in FORT.:\.AN
files. If the first logical tab setting is set to column 7, the t2b key or logical tab
character foilowed by a logical backspace character may be used to enter a chara- .
cter in column 6 instead of counting forward the appropri:ite r:umber of spaces. An
example of the use of the logical backspace chara~ter follO\vs:column1
6

i !_%5'page 1 )input line:
card ·image in file:

S'PAGE')

This places "5 'PAGE')" beginning in column 6 of the card image.
Responses:· Tne

key-b·oard·Ts-··trnlock·ea~·---···-·· ·---------- ·-·-

Examples:a. BACK$The character S will be defined as the logical backspace character. The character%may now be used as a normal input character.

""

~

':~·

~

~

...,."Y71<'h1 /[;

11/1/68
11 /1 /68

3. 1. 6 - 813

3. 1. 6 - BA
EDIT

EDIT

3, 1. 6 EDITI

Add_itional Note~1.

··...,~and precedes the character which will overprint the character
preceding t~ backspace.

•

The truncation colu~rns used for EDIT rcquc sts arc as follows:'·

INPUT and D.EPLAGf!\-column 71 for SYSIN, ASP 360, COPY,
and UPDATE\column 72 for FOH THAN, PLI, SPL 1,\ SNODOL, AED, FLOW, EXEC, MAD,·,,AS 1130, and HEPS files
collmm 132 for SCIUPT, and LISTING files
colt{hm 80 for other files

FIND, OVERLAY, and l3LANI< ·::..,colurnn 80

6.

The logical tab c aracter is defined as the {f sign. The fl sign is also
the logical carria ·e return character or line-end character andallows for multiple cornmands per line of input.
The logical line-end
character tc1kes pre edence over the tab character, therefore, theLINEND command m\"t be issued t.o allow the II to be usctl as thetab character. .

7.

E:DI'l'. recognizes the fil<\ type of J\·~2MO, SC HI PT, LISTlNG, COPY,
SYSIN, UPDATE, AED, MAD, and AS 1130, in addition to thosenientioncd on page 3. 1. 6 \. 2,

8.

If no

'

"

LOCATE. and CHANGE - end ZON.~olurnn
PRINT - column 72 if scriali:.-.;ition i~defaulted on or if VEHIFY
colnn~n is set after serinlization i£ tur!.clon; otherwise all 80
columns arc pdntcd,!_i~

is cpccifie<l wiu,\,c HE:TYPE: requc,t, the current line isdeleted and the INPUT cnvil''fnment is entered.
The assumed tab settings

VEJUFY - column 72 nnles& set otherwise

2,

C

COPY
UPDATE/a/b/ ~' >!<A filetype of MEMO is used to input 80 character
containing both upper ~md lower case letters.

4.

The EDIT cornmand allows processing of SCRIPT files incomp;1tible with the SCJUPT PHINT cornmand. If the fil.cty e
SClUl-'T, all input li11cs introduced under INPUT and stl'ings
intro(lucccl through use of CHANGE, OVBHLA Y, H.ETYI:JE, at d
INSEHT arc i11tcrprctccl without converting lower-case charac n·s
to uppcr-ca~c. The characl<~r-tlelctc antl line-delete syrnbols lthe usual effect; all other characters are stored without n1odifi
For CHH::iT files, the file forrnat is set to "V" (variable-length
rcco dn) so tkLt the SCHiPT connnancl can be used to edit or print
files. created hy the EDIT command.
Inpu~

MEMO
SC HI PT
LISTING

in a

3.

5.

arJ as follows:\"\

An asterisk (q can be usecl to rnean 11 tochange request as fol.lows~.

line!; cnutainin[~ ii b,1ckspacc charvctc:r arc converted intocanonical fonn such that only one back:;pacc follows any ch<:tTactc:rAED
MAD
AS 1130\

default ~ettings
default s~ttings
default sbtt.ings
same as SYSlN
sa111e as sys1N.1, 10, 15, ~20, 25, 30, 35, 40, 45
same as AJ.l'D

21, 27, 32, 35, 45, 50, 55, 60

9.

In addition to its obvious uses in se:~rching and modifying fixed-

10.

Serialization is suppressed for all filet pcs except FOHTHAN, PLI,
SYSIN, UPDATE, COPY, SPL 1, SNOB L, AED, FLOW, EXEC,
MAD, AS 1130, and REPS, If serializat"on is turned on for otherfiletypes, and either ZONE l 71 or SEHl L i<l is not issued <luring
subsequent Edits of the file, serializ.atio chara:cters t11ay beinaclvertantly shifted into column 72 or co umns 73-80 i11ay beoverwritten.

format ca-rd files, the ZONE: reques has utility in source program
editing for adding comment fields, s tting in continuation characters,
searching on the seriali;1,atio11 field,
tc.

z~

fc2
4-1-683. l. (,_9EDIT
BACKSPACE

4-1-683.1.6-10!:_~11TBACKSPACEBACKUP

FonT~ --{- ~~~;~~,:;~~---[-- _:,::;:;;c~--~]- --------!

BACI<UP

_[_r

BACk

I

I

l --1

I

.

I

J

~

I

I

r----------------;----------------··-~'------------------- -~------------------------·
characteris any va\~d character. Thu default
cha ractcr i~ " %• "
\\

\ .

Usa~

o

.

'\.
111e BACKSPACE rcx1uest defiri'l;;s tlie charnctcr to be used as the logical bnckspacechan1ctcr in the Input environm'R.nt. 1f the request is not issued, the default
character is assumed. The. logic'll backnpace character causes one column to bebacl:spaccd in the card irnap,c for C\Jch logical hackspnce c:lmrncter in the input
line.

The linckspacc: characlcr must be rccl<:1\_ined to allow the% cfwractcr to he used
as a normal i11p~1t c:han1ctcr.

[

D-J] •

L----------------J-----------------.}
nis an integer indicating the number oflines by which the pointer should be moved
back. The default is l line.

Usage:
Tl~c BACKUP request repositions the pointer "n" lines before
the current line. II "n" is 0 or unspecified, a value of 1 isasimnicd and the pointer is rnoved up to the previous line in the
file. If "n" is grt'atcr th;in the nun1bc1· of lines bet:wec'n tlw topof the file and ihc current line, tlw request will function as a
TOP l"CCjUC'St.

If DACKSPJ\CE is issued without spccifyinI\_a character, the lop,-icnl bncks1x1ce
chnr;ictcr i's reset to the % character.

The llackspacc charnctcr is very uf'dul for de ining- co11tinuation cards in FORTHAl'\files. lithe first lot:ical tab setting is set ton umn 7, the tab key or logical tab
character followed by a logical bac:kspncc clwra ·er may be used to enter a chan1clcr in column 6 instead of counting forward the a propriate number of spaces. An
example of th:.! use of the logical backspace charac ·r follows:columni
6
input line:
card inwgc in file:eA~rJ iRe spon sc s.:.
Verify mode:

The line at which the pointer is repositioned isprinted and the keyboard is unlocked.

nricf 1node:

The keyboard is unlocked.

Exan1p1cs:

Ia.

'Ibis places "S'PAGE')" beginning in column 6 of the card image.

U

9This request repositions the pointer 9 lines before the curr<.:nt line.

Res po~~~~;_:_'foe keyboard is unlocked.
Exan~pl5:f;:a. BACK $111c character $will be clcfined as tile logicnl backspace chnracter. The dmractcr%may now be u::;ed as a normal input character.

~- ·~1 :..

~

usn:::a;: :sq 111,;w:;"""nw::;::;:e:::411@a:w:;a;JSZ2lJQZ4Jiiil i: 421a+1:za414az¥1.l!4$i#&#ZZ£Al¥ e2;•·==••1wc..u *'" ·* .:ue., ; l"''t't -·=• '". u

~
I

..,t.

·I

.11

'

.su:

'"' ·· ,,u:.

.u:;: . ;.@ .:.;u:: .. ,.:::;... ttJii. ,,,!Ill3.1.6-11

3/9/70

EDIT
BLANK

BLANK
Format:r---------------r------------i

I

I
I

I

l

{BLBANK

l

1

j

I

line
I

1
I

L---------------L------------1
line

is any valid input line

Usage:

I·The BLANK request places blanks in the current line wherever nonblank characters occur in 11 line 11 •The tab key and the logical tab character can be used to generate
blanks in the card image.

()The "line" is separated from the request by only one blank.
other blan.~s are considered part of "line".

•.

All

Responses:
Verify Mode: The changed line is printed out.
Brief Mode: The keyboard i_s unlocked.

The keyboard is unlocked.

EOF:
The end of file was reached by the request.
For BLANK
to reach the end of file, a REPEAT request had to be issued prior to
the BLA;.JI<.:.
Example:a.

BLANK .!\.AAA.AA A
column1
6line before request:
request:line after request:

8

ABCDFJMNOP
blank aaaaaa a
M OP

Blanks are placed in columns 1-6 and 8 of the current line in the file.

·""'·

~

'11'\

"!."
(;)
4-1-683. 1. 6-11
EDIT--iiLANK

71/

4-1-683.1.6-12
EDIT--B-OTT0?\1

J1LANI<~:~BOTTOM

r------------~--rI-----------irL~Nl<)

I

I

.
1inc

,
I

\

Form":.S'I

r-------------1

1I

1 {BOTTOM)jBO)l-- - - - - - - - - - --- _L _ - _2\_ __ -.. --- J

L-------------j

\

line

I
I

is any vc't\id input line
Usage:

Usage!

\-~-\

BOTTOM positions .the pointer at the null line after the last line of the file.

The BLANK request places blanks in the current line wherever non-ExamE_le:b1ank characters occur in "line".

The tab key and the logical tab
blanks in ilie card image.

cter can be used to generate

All

Resp en~Verify Mo<le: The changed line is printed
Brid Moch·: The J;.eyboard is unlocked. ·REACHEDBY:

The keyboard is unlocked,

xxx ... xxx
For BLANK'fhc end of file was reached by the request xxx.
(o reach the encl of file, a REPEAT request had(he BLANK

Exan;1pl c:fl.

BLANI< AAAAJl.A A
colurnn. \_!. _ _ _6_8__
line before reqnesl:
requc st::liiw ;:,ft('r request:

BO

The pointer is positioned at the boU.orn of the file.

'l'he "line" is separated frmn the rcque~ by only one blank.
11other blanks arc consitlcrcd part of "li.11

EOF

a.

ABCDFJMNOP
blank aaaaaa. a
M OPBlanl:s arc plac<:rl in columns 1-6 and 8 of the current line in the file.

7/;;,
4-1-

3. l.. 6-13
EDIT--n-RJEF(!

4-1-683. 1. 6-14
EDIT
cH./\.NGE

Tl

I
CHANGE

BRIEF

Forrnat:~!::__--~---------------------------------------,

r--{~-,~:~E}, 'L\''',;""''''dng2/ [t}r----------,
I {BRIE1'l

1

I

BRj

I

[GJ]:

L---------------L-~----------------------------------J

L----------J

is ~.PY unique delimiting character that docs
not appear in stringl or string2.

Usa~c:The BRIEF request turns off the verify _mode (sec the VERIFY
rc·qucst) and tnens on the brief inodc in the Edit environment.
In the brief mode lines that are changed in the file will not be
typed out automatically. The requests that arc affected by DRIEF
are BACI<UP, BLANK, CHANGE, FIND, LOCATE, and OVERLAY.

sti·ingl-is the gi~oup of characters to be replaced.

string2

is the group of charactcrf' that rcpl::icc sfringl.

nspecifics thc'·;mmbcr of lines to be searched
for stringl. ;E(lc default is 1 line.

Gsignifies thatihe\changc is to be applied toevery occurrcncc'f>f string! in the lines.

>:..:

signifies that :ill lin\s from the current line
to the end-of-file ar~to be searched.

Exa1~<.:'._

\

a.
BH.
This requc st turns on the brief mode.

Usage:The CHANGE request replaces tlw oc:currenc
lines by string 2. If G is specifiC"d, every occ rrencc of sb·ingl
in "n" or"':'" lines is changed; if G is not speci "cd, only the firstoccurrence of slringl is clicln{~cd. If neither "n" nor "':"' is specified,
only the cur1·ent line will b0 searched fo1· string 1
Jf the occurrence of stringl is not found, the line(s~ is not altered.
The pointer rernains positioned at the l::ist line searched for theoccurrence of string!.

Stringl and stdng2 can be of different lengths. Each of the "n"or"~'" linc·s will be cxpanclc<l or compressed accordingly.
If an end of file condition immediately preceded the CHANGE, anautomatic TOP request is performed before CHANGE begins.

~
4~ 4.

iiiid ';a 4I.,.~'.!. 1l<r1!Mii#ffl~%[1 -~1111:"". !.iif•··mJfflMjiWiiM~,,;m~•MBii,¥ i@jMi; !H!M,ffilh#~ll!!'¥"' $1 i~iii"iffli""' "!!'M+ff'' ~·.¥~¥.i~~r!f1:4¥Mi rW:~·W·: ..,14; :l,,,~·R)n'1rnf,' "'''~·~·~·'!1'11~:',!111"""··~l"d'Pr' '!IF U.A/tAiA@P.
" "" ",,',. .IQ ;I~·

I ,;us".' .... #, 4f31-·---·-

2¢2Sf

¢,

. ,,

'"

?941·#

1

;,;;;

;4.;

3.1.6-14
EDIT

3/9/70CH/u~GE(

CHA:.~GE

Format:-~------~---~-------------------~-----~-~~~-~---~~----! CH~rGE !
I/stringl/string2/ [ { ; ][LL;BjJ

I---~~-----~--~-~-----------~--~--~-~--~-~-----~-~---~-

I. is any unique delimiting character that does .
not appear in stringl or string2.

stringlis the group of characters to be replaced •.string2

is the group of characters that replacenstringl.

specifies the number of lines to be searched
The default is 1 line.

for stringl.
n.or-*.

(-signifies that .. n or all .lines from the current
line to the end-of-file are to searched.

GLOBAL or G. signifies that the change is to be applied·or*to every occurrence of stringl in the lines •..

Usage:The CHANGE request replaces the occurrence of stringl in "n"lines by string 2. It G is specified, every occurrence ofstringl in nn 11 or "-;': 0 lin2s is chang2d; if G is not specified,
only the first occurrence of string! is changed. If neither"n" nor 11 ;"'" is specified, only the currei:it line will be searched
for string 1.
If the occurrence of strin~l is not found, the line(s) is notaltered. The nointer reoains positioned at the last line
searched for the occurrence of~stringl.

String! and string2 can be of different lengths. Each of theor "* 11 lines will be expanded or cor:1pressed accordingly.

11

n 11

If an end of _file condition immediately preceded the CHANG~, a?.
automatic TOP· request is performed -before CHA.~CE ·begins.-··-·· ·----·-- ··-

(

__

'.
'

3/9/703.1.6-15
EDIT

·O
• ..-

CHANGE.

Notes:a.

The "n" or 11 *" is required if G is to be specified.

b.
If n is greater than the number of lines to the end of the file,
every occurrence of string 1 from the current line to the end will
be changed. The logical backspace character and the logical tab
character cannot be used in string 1 or string2, as they v.rill be con. sidered normal input characters in either string.

In a SYSIN or ASP360 file, only 71 characters of an 80 characterline can be changed. That is, only the first 71 characters are scanned

c.

·.

.I

·for string!.. In a MEMO file or one that has requested no serialization,
all 80 characters can be changed. Iri all other filetype s, only 72
characters can be changed.
Responses:

Verify Mode:

The changed line( s) is printed out and the keyboard is
unlocked.
The keyboard is unlocked.
..

Brief Mode:

EOF!.
The end of file was reached by the request x.Y..x ••. xxx. To position
the pointer at the top of the file, a TOP request mu st be is sued.
When a FIND LOCATE, or CHJ.... NGE request is issued after theoccurrence of an end of file condition, a TOP request is. automaticallyissued before the request begiD:s.

Examples:a. C/ALPHA/DELTA/
1line before r~quest:

Column
7 10
15:1ETJ\

ALP!l;\==;\LP:t;\ -c /alpha/.!clt.1/

reqrn~st:f>El Ti\= ld.r1~li\line after request::;ETA

The first occurrence of ALPHA in the one line is changed to DELTA.
b. C*ALPHA*DELTA*

1 G
fColumn
7 rn
1s

----

c

I;

I

line before request:
request:line after request:

j, L P!I A= /\ 1.

r: i J\ - 1~ Er"c *ulpha*c.'.elt<l* 1 ;-';
0 E LT J\ = UE LTl\ - ;~ [ T;\Every occurrence of ALPHA in the one line is changed to DEL TA.

3/9/70
3. 1. 6-16
EDIT
DELETE('
DELETE
Format:r~--~-~~~~-~---,------------~-~~~~~'.. - _. ~...

:.rEL0ETE}._,. ~~·

Il~ [{ ~. }] !
I/ strmg/,l-----·_________ J ____ --- --------- - •. Jnspecifies the number of lines to bedeleted. The default is 1 line.

I

is any unique delimiting character that
does not appear in the string.
specifies the character string to belocated before deleting lines fromthe current line to the line containing. u string_."string

1(..•

Usage:

H "n" is specified, the. DELETE request removes "n" lines fromI

01

startingIthe file··~\-~ith the line at which the pointer is currently
positioned. Upon completion of this request, the pointer is positioned
after the last deleted line. If 11 n 11 is 0, only the current line is deleted.

JI /string/ is specified, DELETE first issues a "LOCATE /string/"
command. If 11 string" exists, all lines fr om the cur rent line to, but
not including, the line co:c.taining 11 string" are deleted. The pointerwill be positioned at the line containing 11 string. 11
IT 'tstring" is not located, no lines v.rill be deleted, the end-of-filemessage is typed out, and the pointer is positioned after the lastline.

If neither "n" nor "string" is specified, only the current line isdeleted.
Response:
The keyboard is unlocked.

EOF!
~he end of file was reached by the request.
To position
the pointer at the top of the file, a TOP request must be issued,

0

"'

""'

~

4-1-683. 1. 6-15
6EDlT
-CHANGB7c/~

4-1-683, l. 6.-16
ED~!_

DELETE
DELETEa.

The "n" or "':'" is required if G is to be specified,

Form~

b.
If n is greater than the mmber of lines to the encl of the file,
every occurrence of string 1 frmn the current°line to the encl will
be changed. The logical back' pace character and the logical tab
character cannot be used in st ingl or string2, as they will be considered normal input character in either string.

r-------------·--,---------------. -- -;: C°EL,;m} i [ l( ~ . 1] jI/strmg/ ·III

L - - - - - - - - - - - - - - J_ - - - - - - - - - - - - - - - - - ·'~-~c,
In a SYSlN or ASP360 file, on
71 characters of an 80 c:haractcr
line can be changed. That is, only 1c first 71 characters arc scanned·for stringl. In a MEMO file or one t at has requested no serialization,a}l 80 clrn.ra·ctc rs cnn be ch<i.nged. In c l other fil.ciypcs, only 72
characters can be changc~d.
Rcs1~1scs:

Brief Mode:

The changed line(s) is printed\rnt ancl the keyboard is
unlocked.
The keyboard is unlocked.

EOF REACJISD BY: x.xx ..• xxx'Ji'he end of file was reached by the request xxx ... :X ·x. To position
the pointer at the top of the file, a TOP 1·cqucst mt st be issued.
Wh<?n a FIND LOCATE, or CHANGE rl'cpiest is issu cl after thedccurrcnc(' of an end of"fi1c condition, a TOP request ·5 automaticallyi:ssncrl before the rcq11cst bc·ginH,
Exar~:iel<:~a.i C

Column_1___ _7_!Q__~/ALPIIJ\/IJELTA/

line before request:
request:line aftc..:r request:

1\ LP! I/\:: fl L J>:J1\
c /alpha/.JC?lt.i/

PELT/\:: /d. P! If\'I11c first occurrence of ALPHA in the one line is changed to DELTA.

b. C

n

spc'a.J.fies the number of lines to becleld\d, The default is l line,./

is any 1\piquc delirniting character that
does not\appear in the stri11g.

stringVerify Mode:''ALl'llA':DELT/\':'G

Column_! _ _7__1Q __~line before request:
rcq11est:line after request:

illf'!J,\= /\LP!i/1 - ilET/\c * n 1 p hat c:c 1 t<t * 1 f'.
OEl.T1\:: llEL Tl. - ;iET /\Every OCC\llTC..:llC'C of ALPlIA in the one li!1e is changed to nrn.TA.

"i/

'\

specifics t'\1c character string to helocated bcft>~·c deleting Jines frominc to the line containing"string. ".!2_sagc:.

If "n" is specified, the DELETE rcq\est removes "n" lines fromthe file starting with the line at whici~~tlw pointe1· is currently
positioned, Upon completion of this r\qu,,st, the pointer is positioned
afte1· the last deleted line. If 11 11" is 0, \only the current line is dt.:lctcd.
If /string/ is specified, DELETE first i·~Bucs a 11 LOCATE /:;!ring/"
con1n1an<l. If "string" exists, all lines f~on1 the current line to, but
not including, the line containing "string'\~rc cldC'tcd. The pointerwill he· positioned at· the line containing" s \ing."
If "string" is not located, no lines will Le d\leit·<l, the end-of-filen1essagc is typed out, and the pointer is pos,itioncd after the lastline.

If neither "n" nor "string" is spc,c.ificcl, only the current line isclelded.
Rcsp_'::_J~

The keyboard is unlocked.
EOF :rn:;ACIJED BY: xxx ... xxx
The encl of file was reached by the request xxx ... xxx. To position
the pointer al: thl' top of the file, a TOP request rnust be issuc,d.

-,

(0

4-1-68&4-l-683.1.6-17

3.l.6-18
EDIT-I<Ti.E

EDIT

DEI.ETEYi!

JI

Exa1i_-~:E!_<:_::;

Fonnnt:a.
D 5
Thil' rcquC'st deletes the current line plus the next four lines,: - ------- -FILE-:- - --- ---------:
-

:

- -~-

[f.ilcn me]Ib,
D /SUllllOUTINE WHIT.E:X /Thir. rcq11c5t scans for "SUDH.OUTH·JE WIUTEX" fron1 the.: current
line to cnd-oi-lilc, Once the ntring is loc:;itc>d, all lincR from thecurrent line lo lhc line containing "SUBROUTINE WRITEX'' arc
deleted, If the string is not localed, no lines arc deleted.

.. -·---··--·----:-------·

I

1ame to be used ns thc

filCn<llllC

\

~~~

\

The FILE r<.'quci;t terminates the ccliti11g of~ file. A permanent copy of the file iswril ten 011 lhl' disk a~ it cxistccl after the las\ pnss tlir" ~1gh the file. If tlw file isbeing pcrnrn11e11t:ly ::::lured for the first time, i\is writt:C'n on the permanent disk
with 111ode l'l. If tlw file already cxi.~;(I; on l11e,,dj[;k, il is written on tile snrnc' disk
in the s;1me rnoclt· as it pn:viously exi~:tcd. Th:t_latcst copy replaces any existing
copy of the file: on the dif;k ancl the file dircctor,\is updated.
If "filename" is spcciiiccl, it is used as the filen,~11e of the file. lf "filename" isnot specified, the filename ur;cd at the time of the · nvocation of the EDIT command ·is used. If "filennme" is nM specified at either ti. c, a message is typ:::d out.
After the file h:1s been written on disk, control is re'turncd to the CMS environment.

'

Jk;ponSC'f;:---- ..... --'fl1e EDIT comrnand is tcrminntccl and an entry for the 'file is entered in the appropriate file directory.

FILE El\11TY - EXIT TAl(EN111t' FILE rcq11est was issued for au empty file.
nncl ils entry will he removed from the file directory.
gc11er:1lcd and the EDIT command terminated.

\

NO PRIMARY NAME SPECIFIED - RETRY,
A filcrwrnc was not spccifi_cd for this file, so it cannot be stor,d.
FILE request and give the filename.

Re-issue the'\l::Y.1 ~11_1 r:_::;;

a. FILE
request:response from cr-..1S:

f i 1(~

n; T=u.~:s'l11is rcqu('st will write the btcst copy of the file on disk.

"'•11.::::.:.;;:; o=i1. a ;::seas . # . nu u . ;z.:

'<"1

::

z ;: .tms--: a q :... 22222

~
I

:.:

:us.a. ••4"if+ . u ....."' .... 1 -.:. . z; . 1az. "'zz s m .paa., .a. Af•

J/'J//U

3. 1. 6-18

.-

EDIT
FILE
,.- .

Format.--------~--,-----------------~I
I

I: · FlLE -- ~- - ~ [fi!enanle}.
I
I
I

.

I
t

••·~------~-.-.J---------.------

filename--.

- ·-...
---·

.•

.

· :: - -: -

-· ·

-:..

.

.

. .

I
I

.---.;.I_ .. _·specifies the name to be used as the... filename.

Usage:The FILE request terminates the editing of a file. A permanent copy of the file iswritten on the disk as it existed after the last pass through the file. If. the file isbeing permanently stored for the first time, it is ·written on the permanent disk
with mode Pl. If the file alreo.dy exists on the disk, it is written on the same disk
in the same mode as it previously existed. Th.is latest copy replaces any existing
copy of the file on the disk and the file ~rectory is updated.

(

--

.

If "filename'~ is specified,. it is used as theJil.e_naI!le of ~he file •. If "filename" isnot specified, the filename used at the time of the invocation of the EDIT-command ·is used. If "filenamen is not specified at either time, a message is typed out •.
C'After the file has been written on disk, control is returned to the C1'1S environment.
Responses:

The EDIT command is terminated and an entr/ for the file is entered in the app:-opriate file directory.

FILE E1\,iP'IT - EXIT T AJCENThe FILE request was issued for an empty file. No file will be saved on the disk
and its entry will be remoYed from the file directory. The error E (00002) will be
generated and the EDIT command tennino.ted.

Examnlcs:

a .. FJLE(-. ~, lr

.I .... ........_
~_,

~·

1-V"'

This request will write the latest copy of the file on disk.

c

•..1

3/9/703.1.6-19
EDIT
FILE

Examples: (Cont.)b. FILE. RECALC

This request will write the latest copy of the file on disk and RE CALC will be
its filename.

-·

(
)

3/9/70
3. 1. 6-20
EDIT
FIND
FIND
Format:r-----------r--------------,I

I{FIND)
. F j

I

.

l

-

L-----------l-~------:

line

.
1me

I

I

_____ Jis any valid input line. It may containblallks and the logical tab character and/ or.:·· __ _:.. -·. ,·tab key.

·Usage:The FIND request compares the non-blank characters in "line"with each line in the file.

The compare begins on the next linefrom where the pointer is currently positioned and continues down
the file until a match occurs or until the end of file is reached. If
an end of file c or.di ti on imrnediatel y preceded the FIND request, an ·automatic TOP request is performed before FIND begins. Ii "line''
is found, the pointer is positioned to the card in which "line" iscontained. If "linerr is not found, the pointer is positioned after
the last line of the file. The compare is column dependent, as the
only columns compared in each card image are the ones specified by
non-blank characters in nline 11 • For example, if 1!line 1 ' contains"AC". the search vv-ill be for an A in column 1 and a C in column 3.

.
C
'

·I
!

I
)

I
j

The "line" is separated from the request by only one blank.
other blanks are considered part of 11 line 11 •All

FIND can be used to search for a specific line identifier in columns
73-80. One tech:iique is to issue FI~D foilov.·ed by the appropriate
number of tabs to position the specified identifier to column 73.
Responses:

Verify Mode:·
Brief Mode:(_

The keyboard is unlocked.
The keyboard is unlocked

EOF~

The end of file was reached by the requc st xxx ... xx..x. To position
the pointer at the top of the file, a TOP request must:issued.
When a FIND, LOCATE, or CHANGE request is is~rncu after theoccurrence of an end of file condition, a TOP request is automaticallyissued before the request begins.

0.
'

' 1

3. 1. 6-21
EDIT
FIND

0

3/9/70

Examples:a. FIND 90

Column1

7

f 90

request:FORMAT (516)90line found:'The FIND request searches for "90" in columns i and 2. The first line foundis typed out in the verify mode.
b •. FIND ff # SUMX
Column

1

10

16

r

request:line found:f ! !sumx
LOOP
A

SUMX,X- Assuming that the logical t2h settings are set in 1, 10, 16, the request searches
for "SU:VlX" in columns 16-19. The first line found is typed out in the verify··mode. ·-- · · · ······- · · · - ··---· - · ·

()

..•

(

)

I""

"""

""""
\· 1

4-1-(,1)O_J{v

4-1-683. l. 6-20
EDIT

3.1.6-19
EDIT
l~ILE.£._~nplcs:

-

FIND

FIND

(Cont.)

b. FIL~ RECALC

Fo~•at:rc<1ucst:

r-----------r--------------,
line :
I1 {FINDJ
F
I~

re:;ponsc from CMS:'This request wlll write the latest copy of t~fHc on disk and RECALC will be

L-----------L--------------J

it's filcuµmc.

linel)' valid

input line.

It may contain

Lhe logical tab charactc1· and/or.!!!0.££:.
The F)ND rcqt1est cornparcs t e non-blank characters in "line"with each line in the file, The 01npare begins on the next line
frmn where the pointer is currc ·itly positioned and continues down
lhc file \lJJtil a nrn.tch occurs or u 1til the encl of file is reached. Jf
an end o( file conclit.lon irn:rncdiatc· y prececlcd the' FIND request, an
m1ton1atic TOP request is perform d before FIND begin:>. If "line"
is found, the pointer is positioned t the card ill which "line" iscontained. If "line" is not: found, th pointer is positioned after
the last line of the file. The cornpar is colnmn dependent, as the
only columns compared in f'i1ch·card i )<tg<~ are the onrc·s specified by
non-blank characters in "line". For e a1nplc, if "line" contains
11
A C 11 , the search will be for an A in c un·m l and a C in colnrnn 3.
The "liuc" is separated frmn the request:

one blank.

Allother blanks arc considered part of "line".
l"IND c'1n be used to search for a specific li~· iclentificr in columns
73-80. One technique is to issue FIND follo eel by tlw appropriate
number of tabs to podtion the specified identi icr Lo column 73.
Re s:e~!_i::.~.:_

Verify Mode:'I3ricf Mode:

The keyboard is' unlockdl. ' \The keyboard is unlocked·

EOF REACHED DY: xxx ... xxx·\
The end of file was reached by the request xxx ..• x\. To position
the pointer at the top of the file, a TOP request inust be issued.
When a FlND, LOCJ\TJ•;, or CI!ANGE: request is iseuf:;cl after theoccu1·r,·r11~c of a11 encl uf file conclil:ion, a TOP l'C<ft.H:st ·j,; auto1n<dically
issncd bcfo1·(, tl.11.· request begini;,

4~1-68

2/d

4-1-683. 1. 6-22
EDIT
INPUT

3.1.6-21
EDIT--FII'ID
Examples:INPUT

a. Flt\'D 90

Column1

ForE1.:i.a..!.:

7.

r----------;

l"cquC"st:I:

FORMAT (516)line fou11d:

I

j

I

:

L----------J

TI1c FIND request searches for "90" in colunms
is typed out in the verify mode.

UsaB_?..~

b. FIND if II SUMXThis rcyuc:~;t ca11se1; the Input l•nvironmeut to he c11te1·cd fron1
t.hc Edi.t cnviromn1~n1. All suhscqnenl input lincs--inclu<lingEdit rcqu~~st- - arc treated <ts iiipul lo the file and arc pl:lcecl
after the line at which the pointer is currently positioned. II
ilw JNPUT request: is givl:n al the top of tl1c file, t:he lines
appear befot·c the first line of the file.

Colunu1L{INPUT)JO

request:f Usu111xline found:

LOOP

\A~

A

Assuming that the logical tah settings are set in 1, 10, 16, thc\rcqucst searches
for "SUMX" in columns 16-19. The first liiic found is typed m\t in the verify

If no li!ws were entered while in the Input environment andreturn ls nw.i:le to the Edit cnvironrncnt, the pointer is j10E<i~ionecl·to the lai;t line of inp11t or to the line point<,d to before the Input
envjro11n-1ent wa~; entered. The li1ic after the pointer is the san1cline· lit,forc a11d aftc1· the Input cnvit·onrncnt w:i s entered.

mode.

B:~_f;l>.°..~.~~-::..:.

INPUT:The Input environment is entered.
b~.1-1..!l:.1~'.f':_a.
request:response:i
INPUT:

INPll'l' e.nte~·s the Input environment and allows the user to create
more lines of input to his file.

,...

~

·~

1-.~

t'\

"""

""

,,
d

4-1-683. 1. 6-24
EDIT
- INSERT"'t

4-01-68
3. l. 6-·23
EDIT

b

IKSERT
Assuming thnt the logicDl tah settings arc ht 1, 7, 10, and 15, this request i11scrts
the FORTRAN statement "DO 10 I=J, 25" in columns 7-18.

INSERT
Fori~2c. INSERT·1·----------------:--1·--------------i: .

l INSERT l

1!______I:J

i ______________

line

liue

request:response:::l------------· --:.!I~~g£'._

TI1is r<'•!ucst inscru~ the "line" into the file without cnterin::r the Input environment.
The line is inserted following thr~ line at which the poillter is currently positioned andthe pointer is ndvancccl to point to thi~: im;crtccl line. Tllc line is scparatecl from therequest by only one blnnk; all othr~r blrrnb: nrc considered part of "line".
TI1e conycutions of the Jnp~1t cn•:iconf11ent huld trne during the IN3ERT rcqUt!St.

A blan!~ li.nc can be insurtccl in th'..! file by using one or more spaces for "line",
If "line,' ls omittctlfrom the It\SJ\HT rcqucf!t, it is intc:rpretccl as the INPUT
rcquc:.;t :and the Input cuvironmcnt ·is entered.
~£.~~~18CS:

The keyboard is unlocked.
~xarnpl~~a. IbAl3LEb!JbhuSbJ.bbhSUM, x
Column_1- - - · - _1_0__ ,_1_2 _Ji__!~.
si .ibl e
sur1,x
s
/\BLE
SWl,X

111e input line "AULEbl>b!ibSbbbbhSUM, X" is in:;erted ill tl1e file.
is used here to indicate n single space.
b. Il!Db 10 Ic=i, 25

Column7·--·--·--·-~-

rcqu('sf:
li.I1c af:.-:_,r :request:-------·

i lido 10 i"'l,/5
DO 10 f:::l,25

I llPIJT:The Input environment is entered, as "line" was not spccificc\ with the IN:iERT
request.

is the exact input line: to be inserted into
the file.. It cnn obtaii1 blanb; and tabs
(logical tab ch:1ructcr and/or tab key) •request:. line uft~~r rcquc:::t:lnsl"!rt

The letter "b"

,f'"/
I

4-1-68
3. 1. 6-25

gt

4-1-68

8~

EDIT

1'/

3. 1. 6-26
EDIT---r:GcATE

LOCATB_,.-'

LOCATE.!'.:E~at:~f-(-1.ocA 1,£ ---. ----:-----.

I

L

\

I

Examples:a. L /FORMAT/.

Column- ~ ~ ~ - -;- - ·~1s l rngIirequest:line located:

L- - - - - - - - - - - - ~\" - - -'- - - - - - - - - - - - - - - JIisan~\uniquc dcJimiting character that7

1 /format/
55
FORM~T ( 1 0AILY AUDIT')

i~ not ~'ontai:1ccl in the string.

stringto be searcl1cd

Usage:

LOCATE sc•tns all 80 characters ii\.cach card irnagc for thecharactci· sl:riJJg r:pecificd betwcvn tl\c t.wo dclirnitcrs. The
scan begins on the next line frorn whi h the pointt'r is currently
positioned and continues until the strii g is found or until the ('mlof file is 1·eaC'hccl. If an encl of file co1 lition irnmeclialc1y preceded the LOC./\TE, an aulomaf.ic TOP cqucst is pcrfonncd before LOCATE begins . . If the "string" is locakd, the pointer ispositi\HH~d at the line that contains H.
"string" is not locatc.•cl,
the pointer is positioned after the last liI\:' of the file.

LOCATE searches for "FORMAT" in columns 1-80 of each line. In the verify
mode the first line found is typed out.
b.

L $61$

reqllest:line located:

The r<•qucst is not colun1n dcpcrnlcnt, as~, 80 characters arc
sca1111Pd, The logical tab character and th, tab key cannot heU!>ecl to generate blanks in the string.
The logical t.:1b characterand llw logical backsp<icl! character can be
put character in "string".

Coltirnn
15·_L_
1 $61$

12316XXX61987654321

LOCATE searches for "61" in columns 1-80 of each line. In the verify modethe first line found is typed out.
·

LOCATE can be used to scan for a line identifier i\1 columns 73-80.

~~P-~~1.1~E
Verify Mode':

Brief t-.fotle:

111C locntcd line is typed out and thc\kcyhoard is unlocked.
TI1c keyboard is unluckccl.

EOF RE1\CI !ED BY: xxx ... xxx
The end of file w<1s rcnchecl by the request xxx ..• xxx. To positi.on the pointl'r
nt the top of the file, n TOP request Jliust he issued. When a FIND or LCX~ATE
request is issued after the occurrence of an end of file condition, <i TOP rcquc~st
is automatically issued before the request begins.

_.

~:•:::: . :121it111:::ac11; ;p;::;41.11zu::::::.a:zc;u.:a;u x: :. . as ...: ..ttt; GJ . .11 : u:a :;: :z:._... ''*' :K:M;z u;;

JN •.:::ca:::::: as a:am::••:a:aa a : sw ca: . . :1 a: . a : : ;TT. uest .s _as aa:.•111

3/9/70
3. 1. 6-25
EDIT

LOCATELOCATE
Format:ILr--------------------------------,{LOCAT' : . I I________________

I.

I

L

t .
I
srmg
.
JI_______________
J•i~ any unique delimiting character. thatI

is not contained in the string.
stringis any group of characters to be searched

for in the card images.

Usage:
LOCATE scans a~l 80 characters in each card image for thecharacter string specified between the two delimiters. The
scan begins on the next line from which the pointer is currently
positioned and continues ur..til the string is found or 'i.!Yitil the eYidof file is reached. If an end of file condition im..."Tiediately preceded the LOCATE, an automatic TOP request is pe!"'forrned before LOCATE begins. If the 11 string" is located, the pointer ispositioned at the line that contains it. If 11 string" is not located,
the pointer is positioned after the last line of the file.
The request is not col"t:mn dependent, as all 80 characters arescanned. The logical tab character and the tab key cannot be
used to generate bla::ks in the string. The logical ta8 characterand the logical backspace character c2.n be used as a normal input character in ".string''.

LOCATE can be used to scan for a line identifier in columns 73-80.
Responses:

V crify Mode·:
Brief Mode: _(jl

The located line is typed out and the keyboard is unlocked.
The keyboard is unlocked._

EOF:
The end of file was reached by the request x..u .•• x..u. To position the po:nterat the top of the file, a TOP request must be issued.· When a FI.i\D or LCCATE
request is issued o.f:::cr the occurrence of an end of file condition, a TOP request
is automatically issued before the request begins.

3/9/70
3.1.6-27
EDIT
NEXT

0
NEXT

Format:.-~~--~---~~-~-~~--i~-~---~~--~~-~I! [{ rn '1!

{NE~T}·~~--~~~--~---~~~-~J-~---~--~---~--·

nis an integer indicating the number of lines
by which the pointer should be advanced. The
default is 1 line.

Usage:

This request advances the pointer in the file by "n" lines. If "n" is 0 or un-

·I

l(J
I1
f

specified, a value of 1 is assumed and the pointer is advanced to the next line inthe. file. If the end of file is reached before the pointer is advanced "n" lines,
the pointer is positioned after the. last line. Specifying a. value of "n' 1 thatis greater than the number of lines to the end of file is one method ofreaching the botton:i of the file.',.·,,

Responses:.

The keyboard is unlocked.
EOF: The end of file was reached by the request xxx ••. xxx. To position the pointerat t..'1e top of the file, a TOP request rnus_t be issued.
Examples:a. N 5Th.is request advances the pointer 5 lines.

j

..

I

I
If

------··- ·---··-·- · · - - - - · · ·- · ·---···.:_ -· - . --·-·-···--···

l ~).
l
I

t

. -· ---------·------------·---- -------·-- -· ------- -- ---··---·-----·-·---··--·-··-------------··------ -·' ·*·

3/9/70····f')

3. 1. 6-25
EDIT

LOCATELOCATE·1--~/

Format:r--------------------------------,
l: It. I IJ

I {LOCATE
I
L

I

s ring.

I

L- - - - - - - - - - - - - - - - ~·- - - - - - - - - - - - - - _Ji~ any unique delimiting character. thatI

is not contained in the string.
stringis any group of characters to be searched
for in the card images.

Usage:

I

. I:

f .
~c J

I

I
l

LOCATE scans a~l 80 characters in each card image for thecharacter string specified between the two delimiters. The
scan begins on the next line from which the pointer is currently
positioned and continues ur.til the string is found or u-::.til the endof file is reached. If an end of file condition im..."Tiediately preceded the LOCATE, an automatic TOP request is performed before LOCATE begins. If the 11 string 11 is located, the pointer ispositioned at the line that contains it. If 11 string 11 is not located,
the pointer is positioned after the last line of the file.
The request is not coh!mn dependent, as all 80 characters arescanned. The logical tab character and the tab key cannot be
used to generate bla;:ks in the string. The logical ta8 characterand the logical backspace character c2.n be used as a normal input character in "·string 11 •I

LOCATE can be used to scan for o line identifier in columns 73-80.

Responses:
V crify 1fode·:
Brief Mode:(j

The located line is typed out and the keyboard is unlocked.
The keyboard is unlocked.

EOF:
The end of file was reached by the request xxx .•• x..x.x. To position the pointerat the top of the file, a TOP request must be issued. When a Fli'\D or LCCATE
request is issued after the occurrence of an end of file condition, a TOP request
is automatically issued before the request begins.

i.t

3/9/703.1.6-27
EDIT
NEXT

,0

--f- .

NEXT

Format:-·-· ~~-~~~:-:-.~~-~-~---49~~~~-~-~-~-:-~~ ~-'- ~ ~~-~~-~--~-~-·-

l r~1 ! nm !
'I

I·~---~~~~~~--~-~~~~J~~~~-~--~------·

nis an integer indicating the number of lines
by which the pointer should be advanced. The
default is 1 line.

Usage:

l'ifl•·le. ·.·~
IJ

I
It
}

1
{

1
f

This request advances the pointer in the file by "n" lines. If "n" is 0 or unspecified, a value of 1 is assumed and the pointer is advanced to the next line in
the file. If the end of file is reached before the pointer is adv~rnced "n" lines,
the pointer is positioned after the. last line. Specifying a. value of 11 n 11 thatis greater than the number of lines to the end of file is one method ofreaching the botton:i of the fire.·

Responses:
The keyboard is unlocked.

EOF: The end of file \Vas reached by the request xxx ••• xxx:. To position the pointerat the top of the file, a TOP request must be issued.
Examples:a. N 5This request advances the pointer 5 lines.

-·

. .i

3. 1. 6-28_ - ~EDIT-·-3/9/70(JOVERLAY - ----·------OVERLA Y--o;------------- ----------------------Format:

-

.

.
.
.. .. .
.---~~~-~~~--~---~--i-~~--~~-~-~~--~--.
II
I

i {OVE~LAYI f
I

I

line

_

I

r
I

- - - - - - - • ·- - -t- • - - - - - - - - - - - - - - - • ._ - - ----~-~~-~~~~~~-~~~----------~-~~~----

line

is an input1foe "tliat overfays "tlie ~

- -

---

current line. ___ :_ -- - - ------ ~- - .. - ;. -- · ---- . -- ..
- _... -·----·. ,·Usage::.

This req~es1 takes the non -blank characters from "line u and places them in·~the corresponding position-of the-cm-Tent line. -Blank-characters in "line" do<~· not replace corresponding positions in the current line. - If there-is-more than-_:_-:-. one space after the request, these spo.ces will be considered as part-of "line". ·The logical tab character, -the tab key, and the logical backspace. character canbe used in specifying "line". ~
=:.-.
7

-

·

-· •

- ·

: .:. -

:. .:

-

:-:-

Responses:
VerifyfVTo~e:··-- The changed line is typed out and the keyboard is urJocked.

Brief Mode:

The keyboard is unlocked.

-·

EOF~

-- --

·=.:
...
- -...
~.
The end of file was reached by the request xxx... xx..-x. For OVERLAY
to reach the end of file, the REPEAT request had to be is sued prior to·
the OVERLAY.
•'"''t.."':" .......

..•

a. ObbbbbbbbbING

Column1line before request:
request:line after request:

9

PHOG fU\i·ii·IE Roin~

PROGfV\:t:·1 I ~lG

Columns 9-11 in the current line arc repfaced by the non-blank characters in "line".
The letter "b" is used here to indicate a single sp.:ice.

0,\3/9/70
3. 1. 6-25
EDIT

LOCATELOCATE
Format:r--------------------------------,
l: .I t . I I

fI {LOCATE

L
I
s ring.
I
L________________
J _______________ J

I

I

I

i~ any unique delimiting character thatis not contained in the string.

stringis any group of characters to be searched
for in the card images.

Usage:
LOCATE scans all 80 characters in each card image for theThescan begins on the next line from which the pointer is currently
positioned and continues until the strbg is found or t:Yltil the endof file is reached. If an end of file condition im.."Tlediately preceded the LOCATE, an automatic TOP request is per-formed before LOCATE begins. If the 11 string" is located, the pointer ispositioned at the line that contains it. If "string" is not located,
the pointer is positioned after the last line of the file.

character string specified betvleen the two delimiters.

The request is not column dependent, as all 80 characters arescanned. The logical tab character and the tab key cannot be
used to generate bla::ks in the string. The logical ta~ characterand the logical backspace character c2.n be used as a normal input character in ''.string".

LOCATE can be used to scan for a line identifier in colUmns 73-80.
Resnonses:--~-----

V crify Mode·:
Brief Mode:

The located line is typed out and the keyboard is unlocked.
The keyboard is unlocked.

EOF:

1<

I)
I

The end of file was reached by the request xxx .•• xxx. To position the pointerat the top of the file, a TOP request must be issued.· When a Fli'\'D or LC\--:::A TE
request is issued after the occurrence of an end of file condition, a TOP request
is automatically issued before the request begins.

l;'

3/9/703. l. 6-2 7
EDIT
NEXT

-NEXT

Format:.--~~-~~-~~--~---~-i~-~-~-~~--~~-~-.
II

l {NE:}

1

[{

rn !

·~~-~~~~--~-~~~~~--l-~~--~~~~-----~·

nis an integer indicating the number of lines
by which the pointer should be advanced. The
default is i line.

Usage:

This request advances the pointer in the file by "n" lines. If "n 11 is 0 or unspecified, a value of 1 is assumed and the pointer is advanced to the next line in
the file. If the end of file is reached before the pointer is advanced "n" lines,
the pointer is positioned after the.last line. Specifying a. vaiue of "n' that1

is greater than the number of lines to the end of file is one method ofreaching the botton:i of the file.'
Responses:

The keyboard is unlocked.
EOF: The end of file was reached by the request xxx ••. xxx. To position the pointerat the top of the file, a TOP request must be issued.
Examples:a. N 5nus request advances the pointer 5 lines •

..

..L

-3/9/70

3. 1. 6-28_ - ~EDIT-·
OVERLAY --(c

OVERLAY Format:.---~~~~-~~-~~~~~~--;~~~--~-~~-~-~-~--.

! {OVE~LAYJ f
I

I
I

I

I

~·

line

l
1.

I
I
- - - - - - - - ·- - -t- - - - - - - - - - - - - - - - - .... - - --~~-~-~~-~~-~-------~~----~---~~--~-

line

is an input 1foe "that overfays -theairrent line. ____ _-_ -· - - ·----- ~- - ... - ;. -- · ---- .. -- -----·- _... .. __ ...

·Usage:This req~est takes the non-blank characters from "line u and places them in··the corresponding position-of the-current line. - Blank characters in "line" do~--· not replace corresponding positions in the current line. - If there- is-more than - _:_-:_ one space after the request, these spaces will be considered as part-of ''line''. The logical tab character, -the tab key, and the logical back.space character canbe used in specifying "line". -~-- -- : .:. - :. . ~ -- - :-:- ~ ::cResponses:
VerifyfVi~e:· --- The changed line is typed out and the keyboard is unlocked.

Brief Mode:

The keyboard is unlocked.

- --..: - ·-- --- . . - . .

- - .- - . -- -- - .

.
The end of file was reached by the request xxx.•. xx.."X. For OVERLAY
to reach the end of file, the REPEAT request had to be is sued prior to·
the OVERLAY.
EOF~

. ..

,~"':'---··

a. ObbbbbbbbbING

Column1line before request:
request:line after request:c:.

9

PHOG rV\i-\i-iE Roinr;
P RO-G-RA; 1:-H ~ tG

Columns 9-11 in the current line arc repfaccd by the non-blank characters in "line".
The letter "b" is used here to indicate a single space.

c...
3/9/703. 1. 6-29
EDIT

OVERLAY
b. Ob5b33b9

Column1 3line before request:.reqvestline after request: .

I

,,
..

I

ABCOMf lOP0

5 33 95 33 3!·190P

Columns 1, 3, 4 and 6 in the current line are replaced by the non-blank characters in
.

ic···

I

6

''lim:i."ThP
lPtt~.,.. "h"ieo "Seri J...o~e ... ,. . . : ... ..t: ~.-. ... ~ ...... : - 1 ~ ""'pact=a---w- · · - ....... .........
.,"'"' u~ .LLl..;J..
'-V .LUU.J.i...a.Lc a i::>J. 0~.LC ::;,.....

Colun.m7 13line before request:
request:line after request:

Fl0.5,110)

o t·%c
CF10 • _5 , r 1 0 )Assuming that a logical tab setting is set to column 7, the logical tab character iffollowed by the logical backspace character % places the next charo.cter from the
input line into columIL 6. The C overlays the blank in column 6 of the current line.
The letter ''b" is used here to indicate a single space .

.,3/9/70

3. l. 6-30
EDIT
PRINT

(

PRINT

.' '

Format:I

r--r~~:~j-Tlf~-i----~~~~~~jj]l
L------------L----------------------~......

I

:1t.

.·.

., .
. . ...,_

..
lg
~--

.·..

n

is an integer specifying the number of lines to.be typed out. The default is 1 line •Lsignifies that t_he line identifiers should be typed

.....

~.

..
·---

out.
Usage:?

t.
~

PRINT types out "n" lines from the file, starting with the current
line. Upon completion of this r.e quest, the pointer is positioned at
the last line printed unless an end-of-file condition occurred, b whichcase the· pointer is positioned after the last line printed. If 11 n 11 is 0 ·C.

or unspecified, it is assumed to be 1 and the current line is typed out.
If the pointer is positioned at the top of the file, the null line is included in the number of lines typed.

(

If Lor LINENO is specified, the line identifier in columns 73-80 is
typed out with each .line. If L or LINE?\O is not specified, only thenon-blank characters in columns 1- 72 of each line are typed out.
The "n" is required if n V' or 11 LL.\J'ENOll is to be specified.

Responses:
The line(s) is printed out and the keyboard is unlocked •

..

EOF!
The end of file was re:iched by the request x.xx .•• xx.x. To position the
pointer at the top of the file, a TOP request must be issued.
Examples:a. P

5request:lines printed:

p 5

f

o

10

WRlfE (6,30)
FOl\t-1/\ T (' !IE f\E I AM')CALL surn
WRITE (6,10)
FORM/\ T

( I

l1ACK

AGAIN'}

TI1is request types out 5 lines. The line identifier is not included. The pointeris positioned at the fast I inc typed.
··

c

'1

3/9/70. 3.1.6-31
EDIT
QUIT

.QUIT

Format:.-............ --.
![QUIT]
!
Q

.
I
I
I

I
I

___ ..... ,. ..•I_.

Usage:QUIT terminates the EDIT command and returns to the C1.1S environment withoutcausing a file to be written on the disk or making permanent updates to an existing file.
Responses:.

,:,_;; ..

.

.,The EDIT command is terminated and the file is not written out or permanently updated •

(.)

..

~

.~

"'
4-1-683. l. 6-31

~I

4-1-683. l. 6-32
EDIT

EDIT

-QUIT

.----~l [QUIT} l '""

QUIT

~

:I
I

Q

:

I
I

----·----'

7:t

REPEAT·:)REPEAT~1r-------------:-:-_,:_[_{_:- -]1! REPEAT

:

_!_

:

L-------------L----------J'·-,.,\

Usage:n\,. .
\QUIT terminates the EDIT command and,rcturns to the CMS environment withoutcausing a file to be written on the disk or ~aking permanent updates to an existing file.
Responses:
The EDIT command is terminated and the file ~ not written out or permanently
updated.
Examples:a. Q
rC>quest:
response from CMS:

is an integer specifying the numberof times to repeat the following BLANK
c··r OVERLAY request. The default is 1.

Usage:
This request executes the following BLANK or OVERLAY request"n" times. lf "n" is 0 or unspecified, it is assumed to be I. lf"n" is greater than the number of lines between the current line
a.nd the end-of-file, REPEAT will be in effect until the end of the
file. Thus, the RE~PEAT request can provide globol BLANK and
OVERLAY requests.

q

R;

EDIT if:I te;rminatcd and the file is not written on the disk: •Responses:
The keyboard is unlocked.
Examples:a.

REPEAT 25

The following ilLANK or OVERLAY· request will be executed 25
times,~)..
·~......

______..,_..

_,_.__·~~.-..-...-..-...-----··-··-----~~-~~-~-~----~-------·----~. ~4-1-68

3. 1. 6-33
EDIT
RETYPE

91/6
4-1-683. 1. 6-34
EDIT--sA°VE

RETYPE----_)

Format:SAVE-------------------r----------------:I~RETYPE} :
line
;
l R
~-------------------t----------------'
I

I

:

I

line

~

I

r------------r-------------1
SA, v~I
CTnename J I
L------------L-------------JI

is an input line that replaces the current
line.

filename

Usage:
This request replaces the current line \vith "line". The logical tab character,the tab key, and the logical backspace character can be used in ,.line". The"line" is separated from the request by only one blank; any other blanks are
considered part of ''line".

Usage:The SAVE request writes t e latest copy of the file on the appropriate disk and returns t the Input environment with thepointer positioned at the sam current line as before the SA VE
was issued, If the file is bein stored on lhe disk for the firsttime, it is written on the pernh ncnt disk with mode Pl. If thefile already exists on the disk, l is written on the same disk inthe' same mode as it previously e isted, This latest copy replaces
any existing copy of the file on the disk. The file directory is up-

The pointer is not advanced by this request.
Responses:
The keyboard is unlocked.
Examples:

dated.

a. R#IREG =J + K**2
Columns_ ___;,.7_
14line before request:
request:line after request:

is the name to be given to the fileas the latest copy is permanently
written on disk.

H "filename" is specified, it is used

the invocation of the EDIT conunand is sed. If "filename" isnot specified at any time, a message isped out.

IRf.55 ,. I - K

r #Ire~ • J + k••2
IRF.r, • Js the filename of the file.

H 11 filename" is not specified, the file ame used at the time of+K••2
Responses:

The "line" specified with the request replaces the current line. Assuming thatthe logical tabs are set for a FORTRAN filetype, the statement "!REG= J + K~·~·2"
begins in eolumn 7.

INPUT:The latest copy of the file has been saved on disk'~nd the Input
environment has been entered. The pointer is po itioned at thesame current
line as before the SAVE was issued. \.

\FILE EMPTY-EXIT TAKEN
The SAVE request was issued for an empty file. The, file will not
be written on the ,disk and the Input environment will ~e entered.
NO PRIMARY NAME SPECIFIED - RETRY
A filename was not specified for this file, so it cannot be saved.
Re-issue the SAVE request,' specifying a, filename.

;~1111;::::;1;:J£iiJ JiGf#4.LJ

iiliJ . . ,.Liii ..ilLL. 1MllL!.fa.!.J!ii.!L, IJ.LJJ . !iii ,.JI~

LJ.i ,J

I. ..# ,;I# r4 a

4

:)

""
a za

::::: . cu amt..: 4 • ·;;::::: : :::w .. tu: ;; . ;:ww;;:::AA.z .au ;,::::mo::b"'!''~

• j.

3/9/70. 3. 1. 6-34
EDIT
SAVE

-·SAVE

Format:r~-~~~~-~~~~~r~·~-~~~-~---~,

I

I

SA VE
1
nilename] 1
L------------L_____________
J1

filename

-- -

j

li·

i

rl

is the naro~ to be given to the fiie
as the late st copy is permanently
written on disk.

Usage:

Th~-SAVE r~quest writes the latest copy of the file on the appropriate disk and returns to the faput environment with thepointer positioned at the same current line as before the SA VE
v.ras issued. If the file is being stored on the disk for the first--time, it is written on the permanent disk with mode Pl. If thefire already exists on the disk 1 it is \vritten on the same disk inthe same mode as it previously existed. This latest copy replaces- an-;:__existing copy of the file on the disk. The file directory is updated.
If "filename" is ·specified, it is used as the filename of the file.
If 11 filename" is not specified, the filename used at the time of
the invocation of the EDIT commar.d is used. If 11 filename 11 is
not specified at any time, a message is typed out.

Responses:t;.

INPUT:The late st copy of the file has been saved on disk and the Input
environment has been entered. The pointer is positioned at thesame current line as before the SA VE was issued.

FILE EMPTY-EXIT TAKEN
The SA VE request \vas issued fo-r an empty file. The fil-e will not
be written on the _disk and the Input environment will be entered.
I. ·...:,-

\.

0

i

3.1.6-35
EDIT

3/9/70. SAVE(
Examples:a.

SAVE filename

save myrequest:response:

INPUT:SAVE MY was issued to write the latest copy of the file on disk
and give it the filename of MY. The Input environment~of EDIT
is then entered.

!

••

·c

.J..

~

"""'·
4-1-683. 1. 6-35
EDIT
. SAVE~tr71. 4-1-68
3. 1. 6-36
EDIT
-SERIAL

Examples:a.

j

SERIALSAVE
request:response:request:response:~--

Format:
RIMARY FILE NAME SPECIFIED-RETRY.

----- l-!-~~~~~~; -r ·;-:,~ ·;- ·u·l··-~ _1_J_ --SER J l l (NO)j10

SA VE was b sued for a file that did notve a filename specified
with the EDIT command, as the first resp se indicates. SAVE
MY was thc11 issued to write the latest copy o the file on disk andgive it the filename of MY. The Input environm nt of EDIT is thenI----~------------~----~-----------~-id

specifies the 3 character identification to be used
In columns 73-7S.

(NO)

specifies no seri.alization or identifier is to beplaced in columns 73-80.

nspecifies the increment: for the line number.
This number also becomes the first line number.
The default value is 10.

cn~eicd.

Usa~

This request allows the user to specify the 3 identification characters and theincrement of line numbers to be used as the identifier in columns 73-80 of each "card image. If the SERIAL request is not issued, the standard identifier is used. i
The standard identifier is formed frorn the first tlu·ee characters of the·filename;~heincrement and beginning sequence number is 00010.
'

If columns 73-80 arc to be used for data or if no identifier is de sired, the SE1'1AL (NO)request should be issued. JI a :file is being created, the SERIAL (NO) request sho\tld.be issued before any input lines are typed. Upon issuing the EDIT command for a I
new file, the Input environment is entered. 13eforc any lines arc typed in, the usetshould immediately enter the Edit environment by typing a null line, issue the.
SERIAL (NO) request, and then return to the Input environment by issuing the INPOT
reci.uest to enter lines of input. Eighty character input lines can then be entered. !
Ji a fiJe already exists with no identifiers, the SERIAL (NO) request must be given:each time the EDIT command is issued to maintain the dnta tint currently exists :in columns 73-80 of the file. If a file already exists with no identifiers and the
SElUAL (NO) request is not issued, the standard identifier will be placed incolumns 73··80.
If a file already exists and the SERIAL request is issued with an id and/or increment, the new identifier will replace the contents of columns 73-80; the replacement will not occur until the ctn:rent pointer is positioned at the top of the file or 1
until a FILE or SA VE request is issued. The entire file will be rcscquenc~dwith the new identifier.

.-)

··-

/c,'rtJIii

4-1-684-1-683. 1. 6-38
EDIT
-UBDEF

3.1.6-37
EDIT-)--sEJuALfADDEFSERIAL

Format:Usage:(Cont.)

r--{;~~~~~;.1,--

Ii a file already exists with identWers or if input lines have beenentered which were serialized, the SERIAL (NO) request will haveno effect and the identifiers will not be changed. Once serialization
has begun, it cannot be nullified,-- _____ ~::::::::J]-[_r_

:
TADD
!
·--------------- -----------------I

character

Note:a. For a filetype of ME.MO, the default option for serialization
will be SERIAL (NO). That is, if serialization is desired, it. must' be explicitly stated.

is any valid 'b.raracter to be used as thelogical tab ch~\acter. The default character is the #. \\Usage:TABDEF redefines the character to be recognized\s the logical tab character. If
TAIJDEF is not issued, the character ff will be the 'assumed character.

Responses:
The keyboard is unlocked.

If. the character II is to be used as a valid input chara~cr, the logical tab charactermust he redefined using this request.
\

Examples:a. SERIAL REP 20

If TABDEF is issued without specifying any character,
reset to the character #.

The request causes REP to be placed in columns 73- 75 of each card image, tf1c
· first input line to be numbered 00020, and the line numbers to be incremented by
20.
.

~e

logical tab character is·

An example of the use of the logical tab character in a FOR RAN filetype is shown
below:~olumnb. SERIAL (NO)
If the file is hcing created, this request allows the user to create 80 charactercard images from each input line, as no identifier will be placed in columns 73-80.

input line:
card image in file:

If the file already exists without identifiers, the data in columns 73-80 will bemaintained. If a file already exists with identifiers or if input lines have beenentered which were serialized, the SERIAL (NO) request will have no effectuntil the current pointer is positioned at the top of the file after which no newserialization will take place.

Ix "' u + hX•/\+i3

\

\

\

'\

If the logical tab setting is set in column 7, the expression "X:-=A+n•\will begin
in column 7 of the card image.
\~onses:The keyboard is unlocked.
~xample:a. TADD$

This frees the ff as a valid input character and dcfine·s the character $ as thelogic~l tab character.

.--\...,..I

:11

--

•
.•

J!!Jii$

Ii

0

!SI I

SE

&

2 I

~·
-2 ZZIUM4-rn .. .,,...........,..,....

3. 1. 6-38
EDIT

3/9/70TABDEF(TABOEF
Format:.---------------,------------------~i {TABDEF~j i: . ~fchar1acterJ)~t

·:
I
I

TABD
.

:',:

I

I

I

-~~----~~-~~-~~-~·-~~-~-~~------~-~

characteris any valid character to be used as thelogical tab character. The default character is the ! •Usage: .
TABDEF redefines the character to be recognized as the logical tab character. If
TABDEF is not issued, the character .! will be the assumed character.

If the character ! is to be used as a valid input character, the logical tab charactermust be redefined using this request.

c

If TABDEF is issued without specifying any character, the logical tab character isreset to the character ! •cAn example of the use of the logical tab character in a FORTRAN filetype is shown
below:
Columnt
7fX = a + h

input line:
card image in file:

X = A + 3

If the log"ical tah setti~g is set in column 7, the expression "Xi::A+B" will begin
in column 7 of the card image.
Responses:-·

The keyboard is unlocked.

a. TABD $This frees the ! as a valid input character and defines the character $ as thelogical tab character.
.

c
.

~

~

'~

/tJc2.,,
4-1-68lo.3

3, I. 6-39
EDIT--""TABSET

4-!.-68
3. I. 6-40~

TABSET~)

TABSET~r--------------r--------------1
II {TAHSET}
1

TAns

I

,I

[

~-----·--------L----------··-·J
nl. .• nN

Usage: .

Responses:

n 1 ... n NJ tI

The keyboard is unlocked.
Examples:are column positions for logical tab
settings. If omitted, the default tab.settings will be used.

a.
TABS 1 7 13 19 25 60
This request sets ~he logical tab settings in columns 1, 7, 13, 19, 25, and.

This :request enables the user to establish his own internal or logicaltab settings for a card image. The request is followed by from l to l lnumbers that do not exceed the value of 80. The first number indicatesthe column in which the card image begins, and the following 10 numbers
specify the logical tab settings.

60.

.•.

If more than 11 numbers are specified, only the first l l are used. If
a number greater than 80 is specified and no serialization is being per-·formed, input lines will be truncated to 80 characters, when tabbing
indicates a column position above 80. If an identifier is being placed incolumns 73-80, input lines will be truncated to 71 or 72 characters whentabbing indicaks a column position above 71.
If the first number, specifying the column in which the card image begins,
is not equal to l, all input to the file will start at the specified column inthe card image and all previous columns are set to blanks. The EDIT requests BLANK, FIND, and OVERLAY consider each card image to begin
in column 1, regardless of the first specified tab value. The EDIT requests
INSEH T and RETYPE interpret the beginning column position and process
the specified line in the same inanner as input to the INPUT environment.

The TABSE:T request overrides the assurned logical tab settings, such as
for fOR TRAN and SYS IN filetype s.
The user-defined· tab settings apply only to the file during the current EDIT
command. If EDIT is issued again for the same file, the assumed logicaltab settings will be in effect until TABSET is again issued.
If TABSET is issued without specifying any values, the logical tab settings
are :re set to the default settings for the file type of the file being edited.

-"'"\
._j

4-1-68
3. 1. 6-41
EDIT

lti.5

)J/

4-1-683. l~ 6-42
EDIT

-WP
TOP

···.,

---UP

l

UP

~

Format:r-----------,

Ir--------------:- ------- -]-~

r~PJ
L----------J

Usage:~~~-:~~:.LJlJJ

This request repositions the pointer to the top of the file, i. e,, tothe null line in front of the user's first line in the file. An automatic
TOP i!! performed by the FIND, LOCATE, and CHANGE requests if
an end of file condition immediately preceded the FIND, LOCATE, or
CHANGE request.

n

is an integer indicating the number of lines
by which the pointer shoul~ be moved back.
The default is l line.

Usage:

Responses:

The UP .request is the same as the BACKUP request.
BACKU:P.

The keyboard is unlocked,

Sec

Respons_es:

Examples:Sec BACKUP.

a.
T
The pointer is positioned at the top of the file.

:~J!'11111lllll!Jli:Ul!iiii:m;q;;,:a:uau

.,,

._

~
UE.iiiWAMOOIJIJ.L.UJ.JIJl!it.". au. .L. .MMii#u.¥tAA. 2lii µ:am: ans:::s.q:: JW11£ii22111 :u::::;u Lkl 112£

2 ill

Si

I ;

1

i¥

i

.

.P

r·--=11..

n3.1.6-44
EDITc·

3/9/70ZONE

ZONE

Format::. ...:..

:

r-.r;~~~)---:~-~{-~:~J-------r----:;-}--------:

il Z

:

I

I

l

l_.truncol:I~--~------~---~--~----------~------------

nl

specifies the initial columns of the zone of eachrecord which is to be scanned. The default value

is column 1.

n2

specifies the terminal column of the zone of eachrecord which is to be scanned. If serialization is ineffect, the default value is 71 for SYSIN, ASP360, COPY
and UPDATE files and 72 for FORTRA:.'I, PLI, SNOBOL, AED,
FLOW, EXEC, MAD, AS1130, and REPS files. If serialization is suppressed, the default value is 80.

Usage:
This request will cause subsequent LOCATE and CHANGE requests
to apply oniy to the zone of the card-i~age records specified
by the integer values for starting and ending coiu.Tws.
The initial zone column, nl, must be less than or equal to thefinal zone colU.'Tln, n2, and n2 must be less than or equal to
the truncation column.
If serialization is requested bv use of SERIAL and the current
zone overlaps collli~ns 13-80, the ending zone column is reset to 72.

Note:

If serialization is in effect for SYSIN ASP360, COPY, or UPDATE
files, the default value of termcol (n2) is 71, but the ZONE
ending colur:m can be set t'o colurnn 72 to insert a continuation
character in a card image.
Responses:

END ZONE RESET TO 72 FOR SERIALIZATION
If serialization is in effect and the ZONE request specifies
a terminal colunn (n2) of 73 or greater,· the terminal column

is set to 72.

,.....

~·

~-

!t16

J:1'

11/1/683 • l. 6 - If 11

4-1-683. ll. 6-43
EDIT
-VERIFY

EDIT

I tJ?

~NE
ZONE

VERIFY

Format:Format:r-------r-----------------------.

il:~ ] :i {}!
\r---------------,-------------

i::L---------------J
rE:Ei;;vJ :_______[U~J-:-:- __
nn

1

ZONE

Z

J

nl

n2

:l

~

1

truncol::-----:::::::::-::\::::::-:::~mns of the zone of eachspecifies the number of columns to verify
in each card-image. The default is 72.

record which is\to be scanned,
is column 1.
\

Usage.:n2This request turns off the brief mode (see the BRIEF :request) andturnQ on the verify mode, causing the autornatic typeout of lineschanged or searched for by other EDIT requests. If ":nn" is specified,
11 nn" colmnns will be verified.
If "nn" is not specified, 72 columns
will be verified; this is the normal mode of operation in the Edit enviroi:iment. If a MEMO file is being edited, 80 columns will automaticallybe verified.

1

The default value

specifies the te;,1ninal column of the: zone of each rccor-dwhich.is to be sc~nned.
If serializatio~ is in effect,th c de fa u 1t v a 1 u e \is 7 l for SYS IN , ASP 3 6 O, COPY , ·"' n d
UPDATE files and 7~ for FORTRAN, PLJ, ShODOL, AED,
FLOW, EXEC, MAD, AS\130, and REPS files.
If serialization is suppressd~, the default val~e is 80.
\;

Usage:\\\

This request will cause subsequ\nt LOCATE and CHANGE requests
to apply only to the zone of the\card-imae.c records specified
by the integer valuE~s for startin)t and ending columns.

The requests which arc affected by VERIFY arc BACKUP, BLANI<,CHANGE, FIND, LOCATE, and OVERLAY.
•

Responses:

The initial zone column, nl, must b
final zone column, n2, and n2 must b
the truncation column.

The keyboard is unlocked.
Exampl~If serialization is requested bya.
VERIFYThe ~erify mode is turned on and 72 columns will be verified unlessthe r'ne being edited has a MEMO filetype, in which case 80 columns
will be verified.
b.
VERIFY 50
The fin1l 50 culu1nns will be verified in each card-image.

zone overlaps columns 73-80, theto 72.

than theequal tocurrent
reset

Note:·

If scrJalizatio~ i~ in effect for SYSIN,
files, the default value of termcol (n2)ending column can be set to column 72 tocharacter in a card image.

360, COPY, or UPDATE
1, but the ZONE
rt a continuation!_cs po~END ZONE RESET TO 72 FOR SERIALIZATION
If serialization is in effect and the ZONE request specifies
a terminal column (n2) of 73 or greater, the terminal column
is set to 72.

____--,,.....,..........._._,__.._~ ----~·----------------·---------------------

"08-03-67
3.l.7-1 /A'f~
11/1/60

/ti~

ERASE

/&/

3.l .6-115
EDI'l'--ZONf;

3 .. 1.7

ERASE

Purpo~c:Example:. The.ERASE command deletes a file or a related group of files

a. zo1rn l 72

from the permanent or temporary disks.

The jnitial ZONE column is set to 1 and the termi~al ZONE
column is set to 72 independent of whethe.r· S(jr·ialization

Format:is in effect.

----------------------------------------------,
llE~:E)I {file~ame} {file;ype} [{file~ode}]!

L-----J---------------------------------------'

Usage:

Filename and filetypc must be specified in the ERASE command, either by nameor with an asterisk. If the filcmodc is omitted, an asterisk is assumed
meaning that the permanent and temporary directories (but not the system
directory) will be searched.
Those parts of the file identifier not specified by asterisks are used tosearch the file directories. Entries for all files matching the specified
identifier are deleted from the appropriate directory(s), and disk space
occupied by these files is nn de available for new files.

Notes:ERASE will delete read-only files.

a.

Responses:
ERASE gives no response except the Ready message or an error
code. See 3.1.7-3.
Examples!.
a.
ERASE DLFAC MODULE PS

The file specified is deleted fr.om the file directory, and its
space on the permanent disk is freed.
'ERASE * LISTINGb.

All files with ttte type LISTING are deleted f~om the permanentand temporary disks.

c.

ERASE * *All user files are deleted and the directory is cleared.

~

iA
1111

::: t

1119 &ef,.,,,.,ii#@W,Lii..,ii!liHM.U. M.Ll!.#i#,,,.,.lWlili

1Ii

;:

t:

::

a :a

:

#P

,;;

144 -

~·
o

.¥

:::

444 #'f

IJ t a;:;w .J.!

iJ..;:;11111.u. !!1$iil!lj'Wll! JU41 f--'"~"""

f"t\

I~

//()

·oa-oJ-67

3.1.7-2~~~/lo

9-18-67/II

3.1. 8-1
FINIS

.•)

Messageea

E(OOOOl),Jflll\i

3. ·1. 8 FINISCORRECT FORU: ERASE FILENAME FILETYPE FILEMODE, NAME!
AND/OR TYPE MAY DE * 1 AND MODE MAY BE * OR 'hLANK.

f\Jrpose:
FINIS closes one or more files that are currently open.

~he filename or type was omitted, or the filemode
was inco~rect. ' Correct the com.~and.

f'.2~

E(00002)1r

F~~} -i ~i;:;~:ji·f;;~~~J-Ii;i;:;~~

The file specified was not found in the user's
file directory.
E(00004)-----·-- ------------------------------------

An I/O error occurred. Processing may not: havecompleted. It may be necessary.to initialize the·disk again. (See FORMAT)~ fil01-:;mej

ifil~type}<·{ filc1~odc}

is the name of the file to be closed.
An ~·means all filenames.
is the type of file to be closed.
An *means all filetypes.
is the mode of the file to be closed.
An ~,means all filemodes P, T, and S.

Usage: .

FINL'> closes one or more specified files that are open. Closing a file consistsof writing out the last record of that file on the disk, updating the appropriate fik
directory, and removing the entry for that file from the user's active file table.
If the filcmocle number is 3 or 4 (delete upon reading), the fHc will tie erased. An
asterisk may he used for the filename, filetype, and/or filcmoclc to dl'notc the
c1osing of all opt.med files with the appropriate filenames, filetypcs, anJ/c;r file·modes. If the filcmode is not given, the first file found with the specified nameand type is closed. TI1e order of search for the specified filc(s) is the permanentdisk, temporary disk, and system disk, in that order.
The specified file must already be open in order to be closed. If it is not, an crr•H"
code will he returned by the FINIS command.

Notes:_a, FINIS should be issued by the user when his program docs not close the fiks
used d11ring the execution of that program. Files accessed by CMS commands \'.illbe closed automatically.

h. Only eight files mny be' open in CMS at one time. 1hercforc, the Fll\'lS comm~rnd
should be called from user programs in which more than eight files arc acceSSl'CI.

~)/!)_,,
I

9-18-67

3. 1. 8-2~

5. ,1.

05/01/t3.1.9-1

J#

113

LISH

g

Re:iponses:

i.YHQ..:Hi:

None.

1IS1F has twc purposes: (Dto type at the terminal the name,type, ~odE, size the date-last-updated, and time-last-updated of
sp~cifed fil~sor (2)
to create a file on the per~an~nt disk
containing infcrmaticn similar tc that typed at the terminal.

Examples:a.
FINIS DATAOUT CARDS PS
The file whose identifier is DATAOUT CARDS PS will be closed.
b.
FINIS DATAOUT CARDS
The first file found with a filename filetype of DATAOUT CARDS will be closed.
The permanent disk, the temporary disk, and the system disk will be searched,in that order, for the file.·

lH.l!Ut!:c.
FINIS • * FILE1*•
All files that arc open and have a filctype of FILEi will be closed.

filenam€
II~1P

L

d.
FINIS
• *
All files that are open will be closed.

The specified filename ls invalid. It contains leading zeros.
The file ls not closed.

E(00003)

An error occurred while reading or writing the disk.
command lms terminated.

E(00004)

The first character of the mode is illegal. It is not either
P, T, S, or *. The command has terminated.

filetype•

filemcde•(option1 ••• opticnN)

is the name cf the files tc be listed.
Att • denotes all filenames attd is thedefault value.

fihtyp£is the tyro cf filE tc be liste~.
deootP-s all filetyi.;es aud is thedefault value.

1: ilemodeis the ~cde cf the files to be listed.
It may be either P, 1, s, or • • The•

E(OOOOi)*t ilrname

Enor Messages:"E(00006)

I

•

The

•

The specified file is not open and therefore cannot be closed.
11te command has terminated.

An •• denotes all filencdes,P, 1, and s.
1he default is.P and T.

.U.U.us:
E XJ:.C
(E)

•

,..

~

creates a file en the permanc-nt disk
ccntaininq a list of the specified files.

SOR'!

will "sort" or qroup-together all(S)

si1ilar filetyree

UME
If;")

will rrcduce a list cf'l tl?E(IY)

causes the 'list to contain cr.ly
filer.ane and filety~e~CIJE

trancates the tyred lino aftero~lyfilenames~·j'• . ::;::: :..: . : z1:1+04..::.;wcts . . . . ei!!iS;:2.:L:,zsaa "a..:. aLJt.:.:t . . axa.a:mcaui.21£t. .

,':j.

~

~'

. //~fl(M)

filemcdeRECfilename,-type,-«ode, and numberof records will te printed

'li)

't}

the list will contain name, type,mode, Eize and the date the file~as last written (mm/dd).
1his i:: ·the default line.

'lHIE
U)

added tc the dEfaulted line willbe the time that the file was last
upcatEd (hh;ir.n:)DA'IE

3.l.9-2. 36-l.IC

date

42-4E

time

../-*'$' 3 .1. 9- 3//5All othet columns are blank. For an exam~lE of a CMS IXEC file,see FIGURE 3.1.9-B, in which the PRINTF ccmroand has been used totyi;ecut the .contents of the :EXEC file.

1he CMS E~FC file is like any ether user file.
It can te printed
cffline, edited, added to, chanqed, etc., tut its main fUrpose istote used with the EXEC er$ commands. Fefer to Section 3.5.l
for a desctiption of the usage of a CMS EXEC file.
.!l~!.EQll.§.£.§:

If the (F)EC) cption is specifie~, the file CMS IXEC is generated
UE(r 1 s fErnacent disk, and no resronse will be ty~ed at
the termincl.

on the1IS1F either types out the of specified files er creates a filecontainine tte infctffiaticn. All operands are Cftional.
If no
CfCtand is specified, a complete list of all tbe files that exist
in the UE€I 1 S permanent and tem~crary file directories ls typed
at the t~iminal. The list consists of the name, tyfe, mode,
numtEr cf reccrds, and date the file ~as last written in eachfile specified. The number of records is the nurabcr cf 800 hyte
tecords· cc.cui;ied by the file.
The date is typed as month - date~ee

(U/Od).

FIGURE J.1.9-A.

*

filctype, and/er filemcde other thanisthe file with that identifier: is typ<~d out
alcng with its size.
afilcnam€,is net srecified, cnly the permanent andIf adisk directories will be examined by LISTF.
filcrrodc ~f • is specified, the permanent, temporary, and systemdisks wil1 lE us€d.
thef ilemcde

te~fcrary

If the~EXEC) rataroeter
is SFHCified, a card-imaqe fil~ iscreated on ~be user's permanent disk and assigned the identifier"CMS EXEC P1".
If a file with the identifier "CMS EXEC Pl"
already exjsts, it will te erased and a new file will be cr.eated •.
1his file will contain a card image for each of the specified
files and the format cf each card irraqe iE as follows:
f.Q.!Jl.!!1.£§

f .Ql!!.§1!!§

2-,3

&1

5~
s~1~
17-~L

27-28
31~34

If the (EXEC) cpticn is net given, the list cf srecified files istJ~ed at tte terminal.
As can te seen in the descrirticn of the Ofticns, only certain
guantities of each specified file can te typed by LISTF. Eachortion has a truncating effect en all opticns of lower priority.
l!s~]J£§:

Sfecified, then 011ly

If

05/01/69

05/01/69

J;§~_g,&:

lt

,~·

a.
LlSlF
The naroe, tyfe, mode, si20 and date of each file on the permanentand tempcrary disks are tyred out. See FIGURE 3.1.S-A.

b.

L151F

•

FCRTBA~(~)

name c1 eachfile that has a filetyre of FORTRAN and exists
en the pernanent oc temforary disks is typed out.

ThE

* *

c.
LlS'lF FILE.(T)
lh~ name, ty~e, mode, size, date and time of each file that has afil£name cf FlLE and exists en
system disk ~ill be typed out.

thefCLmanent, temporary,

or

d.
LISlf
(EXEC)
1he file ~ith the identifier LIST EXEC P1 is created on thepermanent disk.
1his file will contain the same list of files
that was t}ped out in Examrle a, tut each entry in the list will
have 61 anc 62 placed in frcnt cf it.

£2

filenal!lE
filetyi:efilemode
numb~r cf records

e.

LIS~F
• FOHTRAN(EXEC)
file ~ith the identifier LIS1 E~EC P1 is created. This file
will contain t~e same list of files that was typEd on the~he//,6.
05/01, ,;;~~.

05/ 1/69
3.1.9-4t~rminal in Example b, but each entry in the list will have &1 &2

flacEd in frcnt cf it.

ii/ 3.1.10-1
J.1.10see FIGURE J.1.9-B.

l.Y!.HEi!:lJ 1u_.tt~~.a.s~.§:The£(CCC01}
INVALID LIS~F PARAMETER lIST.
An incorrect form of the command was issued.
if all farameters are valid.

EICCCC2)

f/7

lACLIEMACLIE command either (1) generates a macrc litrary,(2)
er reflaces macros in an existing litrary, (l)lists the name, size, and location of macro definitions in a
macrc litrzry, or (4) cc~racts a rnacrc library.

adds, deletes,

Check tc see

FILE NOT FOUND.

l~H~J:The Siecified file does not exist on the disk.

--- - ----- --- - ---II
l HCL ll:
I
I
I
I

,,,.
,!Ii, iiiii iiiiilll!illlllUi,' i!.;!1!1111¥93#!4'"] , Jiliii· JjJiii!llL ,$iiij I ,..iiii.,\Li.iiiii!llii¥iiiiiil$illLl,,iiW.!iii,.iGE~litnarne filena[e1 ••• filenameN
ALI litnarne filenane1 ••• (ilenameN~EI libname macroname1 ••• macronarreN
DEl litname macrcna~e1 ••• macrona~eN
LI!:T libname

CCt'PACT litnamc- -- - - - - - - -- - - -- - - --GENgenerates the macrc litrary "litnarne"
frcm the macro def initicns in theEfecified file(s).

ADJ:adcs the macro definitions from thesrccitied file (s) to the existinq macro
litrar y "litname".

fiE E

deletes the existing macro and adds
the new cq:y.

ULdeletes the specified rracrc entry
trcm the dicticnary.

COMP

will ccmpact the macro litrary andrenove the macrces that have been
deleted.

fRIN'I

offline prints the macro litrary
dictfonary.

lISTty~es cut the dicticnary of the nacre
litrary specified by 11 lil:name".

litna111e~recities

the filename of a macrc litrary

~
ii

ii

;

llL41

iii

111¥ 1¥111111

!#

~·
i

!¥

4I

¥11;

W

f

I 1111 •I lllW

iff I

L '"' illillliifii. *•"1-1-1161••+-·.+ I.,..,,,,,..,,,,.,"""""""'

,...,"".

"'
to be generated, added-to, or listEd.

ff~

05/01/ 9
3.1.10-2

/!!

/

LINK
OPEN
PU!

filenane1 ••• filenameN
specify the macro definition
files tc be used in ~eneratinq, adding, er
te{lacinq in the macro litrary "litname 11 •Th£ir filetyre aust be ASP360 or CCPY.

REH
SAVE

m1croname1 •• ~nscrcnameN
srecifies the macrces to betEleted or REPlaced •

2171
2194
24C1
2410
2444

23
2C7

~

05/01/' '3.1.10-~

/If

9
34
84

SPIE
'IIM E

2528

143

2671

17

WAI'I
WHITE

2688
2707

34

19

R; T=1.02.Y.§~ge:

FIGURF 3.1.10-A.
A macro litrary is a file that has a filetype of MACLIE and that
ccr.tains mscro dcfiniticns and a dicticnary. A macro definition
is a yrc~ of /360 assembler lanquaqe itatereents identified by aunique naaE and used as an exransicn for a source statement in a1360 asscmtlcr l~nquaqe program.
The dictionary is generat~d by
the MACLJE ccm~and and is nadc ur cf macrc definition names, tho
indexes ct lccations of the macro def initicns within the library,
and the $j2e er tunber cf card irrages in each macro definition.

macliu list syslib
Ji~n_g]ND£l

C~STHE2CMSAVE

12

Cf1SliEG
Ml\ DC ALL
MAD DH
MAJ::'l YPE

54
83

CMSYSiiH

FlNIS
RtDUF
GEN
TYPE
FCB
STATE
CKE OF
fiCTYP
WRflUF
SETUF

104
119
130
208
215

227
238
287
307
316
321
335

347

~UJ;;

10
42

29
2·1
15
11
18
7
12

11
49
20
9
5
14

12
8
7

HASE
'IYFIN35~

WAI'.IR
l!l:JFCB

376
396

20

CLOSE
DCE
DCBD

407
565

158
518

1003

534

lllEHAH
GET!"!if EPCOl

1617
1fJ 1j
18119

223
9

· GETMAIN
GETl'OCL

362

c

1867
2122

14

,

~

18

Exanfle cf MACllB List command.

ptintf syslib naclib 73 86~ACRC.

&lAUEL&LAeEL

8MESSAGE
1,1YP&SYSNCXCMS~Yfl

LA
SVC
EC .
£5

iYES5YSNDX tC
tC
DC
DC

re

ME~~5YSNDX

T~A&SYSNCXDCCSSET PARA~ETER IISTISSUE CALL TO TYPLIN
15,TBA&SYSNDXBRANCH AROUUD PARAMETER LIST
Cf
(ALIGNMEN1)
Cl8'1YPLJN•
CCMMANt NAME
AL1(1)CGN50LE NO.
AL3(MES6SYSNDX)LCC. OF MESSAGEc•t•
RED INK,FIXED-lOCATICN-MESSAGE
1
AL3(L MES&SYSNDX)LENG7tt OF MESSAGEC£MESSAGEACTUAL MESSAGECH

1 1 CA 1~END

SYS00131)
SYSCO'Jt•O
SYS00750

SYSC0760
SYSC0770

SYS00780
SYSCC790
SYS00800
SYSCOP.10

S Y:OOOA 20
SYS00fl30
SYSC0840

SYS00(150
SYS00860

B; 1=C.57

FIGUFE 3.1.10-E. Printout of the CMSTYPE macrodefinitiCID Using PRIN1F.
1c te accessiblE to the MACLIE command, a macrc definition nust firstexist on disk ir. a macro defjniticn file.
A macro definition file isa file that ccrtains card imaqEs of macro definitions written in the/3€0 asqewbler language, acccrdinq to the rules for defining macros. A
macrc definiticr. file must have a filetype of ASP360.
The~aclihCorenand furcticns are: GEN, ADD, LIS'l, DEL, BEf, PRINT, and·CC~E.

1he JEN fcrm cf the MAClIB command creates a ttaccc litrary and assigns
the idrntifiEI: 11 lil.;naroe MTIC.:LI11 P1 11 to . it. 'Ibis macrc library is
generated from thE macro definitions in the specified macro definition
filc(s) having e filetne of ASP360.

25'>
119

The l\'CD tcrrr cf the MACLIB

cc~rrana

ai:i:cnils the macro definitions .fro:n

.'

/c2o

~~·

~?' 05/01/6£

1 10
macro definiticn files tc the end cf the existinq macr5· · - 4
library. As in the GEN form, the specified macro dcfiniticn files mu~t
jve a filEtyre cf ASPJ60 and the specified libna~e must have atil~t)pe cf fAClIB.
the

05/0l//di3. l.10-5~oprint the ccntents cf a ~aero definition, use the FEIUTF
ccuuand and specif) the index number as the starting lccation and(in'dex+s·izE-1) as the endinq lccaticn cf the tiacro definition.
For au exampleof FRINT!: that prints
the CMS'IYPE 111acrc
definiticn, see FIGURE 3.1.1C-e.

f.

~~ecificd

1he 1151 form cf the HACLIB command types out the name inde~, and thesi2c of each aacrc definitici in the specified library. For an
ex1~1le cf the cutput fcrm the MACLIB 1157 command see FIGUBE 3.1.10-A
which lists the CMS system macro litrary SYSLIE MACLIB.

~.£.U:Q.l].§g~p

Ncr.e.
!he tEl functicn removes from thethe 5~ecified racrc.
1heCCff functjcn

remcves

HACRO library directory the name of

JuuJg§:

any ireviously

deleted

MACROs from

MAClIE GEN LSLID HAC1 MAC2
mactc· litracy LSLID MACLID is generated from the macrodefiniticr.~ inthe ~AC1 ASP360 and MAC2 ASP360 files.
If thefile LSLIE MACL1B P1 already exists, it is erased and the nP.w
file is q€nerated.
a.

the

the

lite.icy.

The ERlNT functicn uill create.a HAP of the srecified library and{tint it en the otfline printer. "lituame MAP Fl" will alsc rerrain on
thE user•s files.

b.
MICIIE AtD lBlTE JOSUE
Th€ macrc def initicns in the file IOSUB ASP360 are
end of the existing macro library LSLIB HACLIB.

1he ~EE functicn will IEFlace the existinq code of the specified
macrc, \ith the new code frcm the ASP360 file of the same name.

added to thec.

MACllE LIS1 SJSLIB
1he names cf the macro definitions in SYSLIB HACLIB are ~rinted
cut along with each macrc definiticn'E index and size.
See
FIGUFE J.1.10-A.

}Q,U~:

1hc MACLIH command does not check t~e macro definitions forErrors; it assumes that the definitions are correct and that thecard image£ conform to the asserobler languaqe input ~cr~at (see·Sect ion 3. ll. 1).
1.

!.U.Q.Ll:i.!i.§.!2.9..9.!i.§:INVALJC MACLIB COMMAND FU~CTICNCF EA~AMElEf< LIST.
An inco~rect form cf the MACLID ccmmand was given; or, theparameter list is invalid. Re-issue the ccmrnand with theccrrect f cr~at.

E (00001)t.
Fach specified ASP360
dcfinitictf.

file mayer

ccntain one

mer~

macro

c.
If a HACLIE f 1le is teinq generated and a macrc libraryalreadJ ekists with the sa~e identifier ("litname" MACLIB P1), it
will te erased and reflaced by the library generated with the~ACLID GEN ccmmand.
d.

E(CC002) .
EBROR WHilE WFITlhG
An errcr cccutred ~hile writinq the library on disk. The
liurary will te closed and the command terminated. All of
the irrut card i~ages that were rrccessed before the error
occurred ~ill be included in the file "litna~e" MACLIB.

e. No 1c1e than 100 ~atrc definitions can reside in a MACLID
tile. lf at attemrt is aad€ tc include more than 100, an error
sessaye ~ill be typed out, and any macro definitions teycnd thefirst hundred will not he included in the r.ACLIB file.

E(00003)
EHOii WHILE HEHING
An etrcr cccurrEd ~hile reading the disk. The litrary will
be clcsed and the command terminated. If the GEN or ACD
fern cf ~ACLIE had teen issued, all of the input card i~aqesthat wEre processEd befcre the ertor occurred will be
included in the file 11 libname 11 MACLJB.

No checking for duplicate macro.names tet~een tte ASP360
files and the existing MACLID file is fetformed. The ASP3~0
files will be added to the end of the existing MACLIE file.

\,

•

I

f!A,
"~~ ~! "d'P·:r~iN!l!i!!!ifa1.UH!%,"'.~&Wf'l\'!1bifii,.,.jffiifii!!!,li!fih-%iifi+,!bl!H+.¥&-'PI~.

~.,i¥ta, %?P!!!SF.

WA' ·, }?!:¥ -!14' -W AA¥•¥

ii

1Pii 24

~·
A

L ;.a

U

4.. ... W ;

4 w:p

41

it ii i.ithi . i .,.UJI ii;; ..JiLU

SS r~~~'1~-=-

!"""

!""

·\

~

05/01/69~l.~ 3 •1• 10-6/J2E(CCC04)

J.1.11-o5 / o1I6 9

3.1.11-1

CFFLlNEINPUT FILE !iCT IN CCliRECT MACRO l;ORMAT ..

T~e A!P360 fileis net in correct macrc forruat--either thecard images aLe cut of order, the macro naoe is lcnqec than
8 cha~actEcs, there is a blank in column 10~ or a MENO cardis missinq from a macro definition. 7he litrary will beclosed and the ccwmand terMinatcd.
All of the input card
images that WP.re ftocesscd before the error occurred ~ill be
inclucEd in the file "libnaroc" MACLIB.

"lilname" DOES NOT EXIST. IGNOEED.
An ASI3EO input file does not exist--check to see that thetreciiied libname has a filetype of MACLIB.
E(CC006)
The
tte

,///

.fJJU.Qg:

7bE
CFFllNE ccomand
ccmttcls
the unit.
recordinfut/cutput dEvices. Input files
may te €nteredthrcugh the card reader. Cutfut files 1ay ho printed,~ith or withcut automatic carriage conttcl, cc funched.

!HJ!~J;:

MACLIA FILE SPECIFIEC DOES NOi EXIST.
litrary file does not exist--check tc see thatlitnarre has a filetypc cf MACLIB.

OFFllliEf[~cified~recifiedlo>

MACLIB FIL~ SPECIFIED NOT IN CORRECTFORM.
·The s1ecified libna•e is not a valid MACLIH file as createdby tbE ~ACLIB ccmrrand.

"ccmmtlnd"

filename

filetyfe<fileuode>(+)

E(CCC07)

wbEce ccaaand = :BEAC

MACl.lE DICTIONARY
MACROS.
SORRY.

E (CCCOE).

The ~lCLIE dictionary contains 100 nacre nanes. Ne more canbe ac<ied. 'Ihe Ml\CLin tile will be clcsed and thP. command
terminated.
All cf the input
card images "that ~ereprocessed tefore the errcr cccurrcd ~ill be included in thef i le1'l i b n a me "PIUNTthe specified file will te ftinted
cntc the syste~ ftioter with auto~aticsingle spacing.

fliIN'ICC

the specified file is tc te printed
with the first character cf each record
interfreted as a carriage contrcl
character.

PliINHPC

the records of the naDed file will tetranslated tc UffEI case, then feinted.

PliIN'IUR

the specified, variable-length filew,i.11 l:e pcinted.

PUNCH

the srecified file ~ill te puncled onto
the system card funch.

PU tiCllCC

and "CFFLINE BEA[ filename 1iletype"
ccntrcl card ~ill be in~exted as thefirst card prior tc runching thE specified
file.

r Ac L I B•

xxxxxxxx NCT FCUND IN tICTlO~AflY.
The lECic xxxxxxxx dces net exist in the specified macro
litraty. 'lhe MACLID ccremand is terminated. On macros in the
ASP3fC tiles that were in front of the macrc xxxxxxxx havebeen teilaced in the rracrc library.

E(C0009)

E (CCC1C)REPLACE~EN'l

FILE NOT

specifies a deck is tc be readfrom the card reader.

CVERFLCW -- TOO MANY

FOU~D.

£_,,, . ,..,.£.-_)

;.21

b5ffe

/:fA"Z . OS/01/69

05/01/69
3.1.11-3

identificaticn caid ~ith CE67USEnID f tnched in the
1ir6t 10columns, aud theusec•s identification
itartin5 in the 13th cclu~u. Cf uill save the deck
~util the user loqs on andreguests it \ith an OFFLINE
FE~t ccnwaud.
If more than cne deck baE been read ty
CE, they are processed t) successive OFFLINE READ
commands in the crder they vere entered.

3 .1.11-2

filenaae filetyfe <fileoode>identify the file to te transferred. If
filer.ode is caitted for a READ, f-1 isassuoed.
Par cutfut Oferaticns, if filecodeis o~itted, the pernanent, tecfcrnry, and~ystem disks will te searched f cr the fili.

~~!1~1:tte CFFLINE PBINI, PBINTCC, PBI~1UFC, PFINTVLR,
and EU~CHCC comcands, filenane ane filetype mustle SfECified. If tte fileoede field is blank, the~er~auent, ternrorary, and system disks are searched, inthat order. Asterisks ate net per~itted in any field.

For

specifies that filenaue, ~iletyfe, andfilEDOde will be found in OFFLINE READ
ccntrol cards in the input card stream.

•

fU~Cb

!LJB!sg:~he

O~FLINE PRINT
cc~uand prints
the specified file\ith single sracing and CMS page teadings ccntaining
the tile idettifiers and a fage nu~bor. Up to 55 lines
ate printed en a page. If the file teivg feinted has afil€tyre cf LISTING, it is frinted as if PRINTCC were
issuEd.

JJ!...8li:

lt tilEnate and filetJf€ are SFecified \ith the OFFLINE
fEAD cca[and, cnly one file will be read in.
A
FIEviously existing file kith the same identifiers iserased. If fileucde is ooitted, P1 is assuned.
Ifiilenc<le is net ~recified, the tied oust be left tlank,
an asterisk is net accepted.

1he 'CFFLlNE PRIHTCC ccngand UECS the firEt character of
each line in the file as a carriage ccntrcl cede. The
1ax~rnutt Jjae size, including
the control character, is
133 charactH·s.
A blank (hc:x•40 1 )ir. the cc:-itrcl
fositicn cau£es the line tc be follo~cd by a single.sracE. A :zcrc (hex 'F0') causes a singJe sface hcfcre
enc after: tr.e prir.ted line. A one (hex 1 F1') causes askip tc the top of the next page tefcre the line isrrintcd, and a sin~lo space after the line. Ancthervalue in the contr~l byte is assumed to be a valid
channel ccnmaud code, and is filled ii:to a · CCH. No
teadin~s cr rage numbccs aresupflicd and no autonaticskip iE 1erforcud at tho end of the page.

lf the file designaticns are to te ente1cd in the carda single asterisk nust he srecificd with the
CFFlINE FE~C command instead of filenacE and filctyfe.
ihE deck entered thrcugh the card readEc cay coutainany nuEbcr of files,. each in~edi~tely ~recedod by acatd ccntaining an OFFlltE LEAD ccntrol card specifying
the filenarre, filetype, and cftionally, file~cdc. The
ccm~anf nuststart in the first card coluan.
these
ccntrol cards are typed cut at the terrainul as they aro
enccuntered, and are JntEtfreted by the system just as
if they had been entered frorn tle tercinal.
Any
Existing tile with the ~are identifiers as thoseEfecified en one of the OFfLINE BfAt cards is erased.
Each ccttnand card ends the file fteceding it, and thelast file is ended ty the End cf tbe catd deck.

~treao,

lf an
fitst

Cf~llNE

EEINlUfC will petfcca urrer casE translaticn en
all tecctds cf the SFECifieJ file.
FcI exa~ple, if afile ct tyfe SCRIPT oc ~EKC is to le ftinted and tbe
correct ftintec characteL chain is Dot available,
fbINTUEC. will Ftint the file in urier: Cafe, Elioinating
all rrint checks and ~arbeled character~.

"OFFLINE READ • "card cf the inFut

ccnnand is iEsued, and thestream is net cf the fctm
a file identified as
11 >>hAtE<<>>TYPE<<P1 11 vill he created containing
all cards tead in until ancther OFPLINI· READ ca11tr:ol
card or an end-of-file i.s encountered. 1his te~rorary
file &ay new be alteted t: the desired filenaroe andfiletn:e.
"OFFLIH HAD filenaae filetne",

CFFLlNE FFIN1VLR will ftint variatle length raccrds
ftoduced ty an os access ~ethcj. The rrintatle data ofthe teccrd is preceded by a fcur-byte ccntrol field
which ccntains the length cf the record. 1his field istisgarded ard the reccrd rrinted under: the PRINICC
term at.

When operating on a virtue
pacbine, user card decks
aust be read in by Cf be( re an OPfLlNI READ command
can te issued.
ThE o£er t cd net be legged on at thetime the decks are read in.
Each deck 1ust be enteredse~arately,and each•~stbepreceded byan,,,.
M;::.a;":wa-aLt :S_UL.JS!lU:liiiiiJIAJll" ,billlllllll USS 212 1

1he CFFLINE PUNCH ccmmlnd accepts reccr:ds u~ to 80
characters in lenqth. Shcrtec records ate padded to 80
characters with blanks at the right.

,...

~
•.

L . a .:.uau....

a.;:41 ,;,; . 11111!4,,Jijj •. ,Jill u::.:;q;.,. ,J JU:.;;::.: II I; JP ii if

I; :;::: __.._,,_,.,,,'

016

•

1

+1 1• " ' ',,,,,"'*"'""''l'"'"''~"'I',,,.,,._,_,,,.~

,.,,.

.~

I"-

05/01/69~/ 3.1.11-4..6·4

CfFllNE EU6CliCC coumand will insert as the first card
cf thE SfeCified file tc be FUDChed, a "OFPLINE~EAD ••• " central card. The punched deck can now be readty means ct a 11 0FFLIHE REllD *" ccnr.iand.

11.£!.fil!:
a.

.

I.it

-1'1'/t/'

05/ul/69

f 1 lenaae file type <H le mode> n cont.tol cud. 1J11oY.

3 .1. 11- 5!NULL FILE)
Attempt tc read ~ file containingE.

~oreccrds was made.

I.!J!~J_g:a.
Files handled by the OfFLlllE
records, E~Ceft forfi~ed-letgtb

comrtand must have
OPFlINE PRIN1VLR,

which handles variable length teccxds.
t. Only the first card cf any input deck is checked
tcr .CE67USEBIC. CP [COCESSGS all cards fcllcvinq it
until a fhysical enj-cf-file as a single file.

OFFLINE READ SEC23 SYSIN
Any Frevicus file with thE filena~e and filetype SEC23
S~SIN
iserased.
All cards follcuing
the CF67
jdentificaticn card are flaced in a tile on thefErnanent disk identified as SEC23 SYSIN P1.

Of!LI•E EEAt * Assume theteen ~ntered ty the oferatcc:

t.

follcwing deckbas/----------------·------------/I

c. lf the filE being ftinted ~ith OFFLINE PRINl has atiletyfe cf Ll51lNG, it is printed as if PFINTCC were
specified.

I ____ -----------·---------//data cards
J·--- '---------·----------------I/CPFL l~E REAt FILE DAC2 PS
d. Under Cf, frinlcc OUlfUt is preccdEd by a single
lirie ccntaining a USERID. PUNCH output is preceded bya card containing a USEn1r.

--'---------------~------------I____________________________////source cards__ 1____ ~---------------~-----1CEFllNE READ SOH1J FORTBAhI

Sgl!Qllfil.§:I- •----·---------------------JAHEE·1/CE67 USE liU:a.
OFFLINE READ filenaue filetype filePode
After theccmroand 11 0.Hl lliE liEAD>l<"ccntrcl ce1rds
enccuntered in the ic1ut card stream are typed at theterminal.

t.

EEJLE& EMFTY OE ~C1 llEACY.
rEsfcDse and the Beady nessagc follow an OFFLINE
EEAC co"nand if no card deck has been entered for theuser's USERI[.

~b~s

c.
'lhe Readynessagc indicates the ccmnand has completed
It does not oean thatfhysical cutput
ha$ cottflcled. 1ho cutfut file ~aJ te hEld by CP until
ether cscr~ free the cutfut device.
~ithcut

crier.

11
CF1'LINE J1E~r ••• 11 CC~T!iCL Ci'iRD IS MISSING.
THE FCLLCWlNG ASSUUI[:'l his r cs i: c 11 s <:an d the a 5 s u Tl <.: d cc n tr a 1 ca rd are t y p e d
1i1honcvei: an ''Gfl:'LI!JJ: li.f./\[ * 11 cor.11i1and is is:·iued and tbe
first caid cf tho in[Ut Etcearu is not an 11 CfFLINE REAC

d.

I

I

Any pcevicus files with the identifiers SOBTJ FORTRAN
er FlLE tAO~ are ecasea. 1be card recerds are placed
in
tiles
en
the
fEtmanent
disk
under
the
identificaticns SORIJ P-OB!RAN P1 and FllE DAC2 PS. The.fcllcwing resronse is typed:
CEFLINE REA[ SCR1J !CBTEAN
CFFll~E 6EAt FILE
IA02
OFFLINE PRINT flit tAC2
A search is nade fct FILE CA02, on .all .three disks, if
necessar~.
When it is located, it is flinted out withsingle Sfacing and CMS-su~Flied page headings.
The
first fagc of the Ftintcut will contain cnly the
USERID. ~he sccccd fagc ~ill start with the follouing
heading:c~

FllE:FllE

tA02

P5

CA~BliHGE

t!CNITOR

SYSHM

/.27

05/01/69..;f-:(!

IAGE001

3 .1.11-6

05/01/69/olf"l·.?-?j3,1,11-1.1;;--1h~

heading is follc~cd tJ a tlauk line and 55 lines ofthe filE. 7te heading cf the second and subsequentiayes is the sane, except fer the rage ntnher.

Outfut froduced ~y an CFFLINE PRlNlCC ccumand.

Figure 3.1.11-i.
I!!.Q.Ll.l.!UH2.!L9.§l:d.
CFFLINE PRINTCC EX FlIE FS
5EE Fi~ure 3.1~11-A beJcw, ~hich Ehcws the contents cf
the file EX FILE PS, and the rrinted outrut i:roduced ty
this ccmmand.

I.tiJ..!L.!;.f!l!£!.l ts

Jl..Qj;,g.§

I
I
I
I

JTI'ILE ---

I
I

11

0 11 generates twc

blank lines, er a line
fcllcwed by a tlank line.

'

LltlE
I
LihE---------------> ~o carriage-control
Jcharacter causes
I CLihEsingle si:acing.
I
I CSUD- l:EACING
I
lHE

I

I
4LINE
I
I
I

E(C0008)
READ or W~ITE DI!K E6FOB
A disk I/O error has cccurred. If reading disk:
an illegal ncde aaJ ha\c been specified, atte~pt
to output an enpty file, atteni:t tc oren oore thaneight files at one tine, er net having enough coresrace fer the outrut tuffers. If vriting disk:
tle s~ecified acde en tha READ cccroand ~iqht beillegal, or no more disk SFace is a\ailable.

JPAGE THOII
I HEADING
I
!LINE

!LINE
ILIN.E

I
I
I
I
I
J
I
I

'Ibe carriage-ccr.trol
character must te incolucn 1, regardlessof the fosition of
the text.

I,,.,;;;;1.tLEliiMM.SiiiMUIZ4,S,J ..

EXAMPLEI
I LitlE

!LINE
I
I
I

,..
:;;::

E(00007)
FBI~T or tUNCU EFBOE
Systco hardware failuce has cccurred.
Retry the
Oferaticn en the specific unit reccrd device.

ILINE

I

-...

~
l2

I

RECORD'Ihc CEPLINE PUNCE ccmrnand accepts recccds cf 80
ctaracters cr less. lssting an EDIT co~~and fer
the file and re-filing it truncates records to 80
characters.

I
I
JSUB-llElLDING
I

J•
I
I
I

'!&illI HEADING
I

ILINE

lhe "1" forces a skip to
the next rage tcfore theli r.e is Fiinted.

(max=BO)

IEtG1U'Ihe recccd len~th of an output file is greaterthan 132 character~ fer ~RINT, or 133 charactersfor EfiltTCC. this is lcnger than a ~cintec line.

!LINE

EXAMPLE
111\E
LlliE

(max= 133) or EUNCHMAXIMU~I LINE

LINE
LHE

PRlNT

.E)(CJ:..EDSIJOI HEIC,.

E (00006)

I

I
I

J
11H
I
11 HGE nol0
ICH/ID1NGlf(00002)
FILE NCT FCU~D.
The file specified fer outrut dccs not exist.
Check si;elling of the filenar.e and filetyp0.

I0O(-------------> Ea.ch

nc-nc!

II

1

10 hEAC1NG)

I-------IUSEliID

7I7LE------------> A "1" here would ~avean extra tlank rage.

I
I
I
I

QJ!.!.tl!!

7he USEEID alva~s precedes
printed output. It is
tcllcved by an autocatici:ac,;e eject.

Il

E(CCC01)
INCOUREC'I COIHH1t;o LIST.
a. 'Ihe operaticn s1ecified uith the comDand wasinvalid; it must te cne of these: READ, PRINT,
PEINlcc. PRIN'ILPC, P~I~TVLR, FU~CH, oc EUNCHCC.
b.
~ofilename (ncr "*" under tbe SfEcial BEADmcde) ~as specified •c. Filetype ~as.specified as an"•"·'Ihat•s a;,.e.;;;:e :a m;eq,I

U.&$2311 ;;;;

I

'41

;

#4

::snaa a::;; , . Jj!ii2!ii1#4 ,Jt.t ,a .M·'

02/06/70
3.1.11-8
Additional Notes:

1.

With the CP c_apability of "XFER OOE" a user can receive
files in his virtual card reader which have a logicalrecord length of 132 bytes. If the file is transferred
via OFFLI~IB PRINTCC or if its FILETY'PE "is LISTil1G, thefirst character of each record is assumed to be.a carriage
control character. Otherdise, an extra character (blank)is added to the beginning of each record, i.e., C:·!S
supplies the carriage control character. When the fileis read in, the first character is ignored.
In order to prese~e the carriage control in a LISTING
file, the user must first alter the FILETYPE to otherthan LISTING, and then issue an OFFLINE PRINT, not
PRINTCC. The first cha:!'acter of each record is thentreated as a part of the file.

~;

..

..

~·

""'

.fl'

7-19-68
3.1.12-1
PRINTF
3. ·i. 12/do
7-19-68
3. 1. 12-2
PRINTF

PHINTF

Purpose:'fhc PIUNTF command types all or part of a specified file at theterminal.
~:.- -- -------- -- ---- -- ---- -- --- - ---- --- -- -- -- ----.. ,L{1:~~~:~:} ____ L.~i~::~~:: _~i~:~~~: __ [{~1}__t~2} _~:~JJ_ j~.-c,
The KT and KE commands override any specified last line number
or line length,~espcins~~:

The specified lines are typed out at the terminal, followed by the
Ready message, If the Ready n1cssage appears with no typed lines,
the specified first line number is beyond the end of the file.
1~xamplcs:

filena1nc filetypespecify the file to be typed.

nl

is the line numbpr of t.hc first line to be typed,

The entire tile "GO EXEC P5 11 is typed out. Lines are truncated to. so· characters. As shown in Figure 3, 1. 12-A, the command "printfn2

is _the line number of the last line to be typed,

go exec" produces the same output except that lines are truncated to
72 characters.

n3

is the n1axin1tun number of characters to be
typed on a line, if the records are to betruncated.

Usage:The Cilename and filetype must be specified. If the first line number
and last Hne munber are omitted, or specified with astcrislrn, theentire file will be typed out. An asterisk in the first line or encl line
fields specifier. the beginning or the end of the file, i·espectivcly.
Typep lines are truncated to the specified limit, if any, or to 113
characters if the filctype is LISTING, to 80 characters if the filetype is l\1EMO, or to 72 clwrnctcrs if the filctypc is not any of theabove. If a limit is specified, the fir::;t line nuniber and laGt line
number fields inust be filled, either explicitly or with asterisks.

a.

printf go exec •:: ':' 80b.
print£ sys lib ma clib 104 118 72
A macro definition from "SYSLIH MACLIB SY" is typed out by
specifying its first and last line numbers in the file (obtained with
the MJ\CLln LIST comrnand). The line limit of ·12 characters
truncates the serial number in colunms 73-80 of each line. Sec
Figure 3, 1. 12-B.
c.
printf fortj listing 33 •:< 72
The 33rd through the last line of the file "F.ORTJ LIST.ING P5" aretyped out, truncated to 72 characters. See Figu1:e 3, 1. 12-C.
Error Messages:

E(OOOOl)

CORRECT FORM IS: 'PRINTF' FILENAME FILETYPESTARTLINE ENDLINE LINE-LIMIT,WIJERE 'STARTLINE', 'ENDLINE', AND 'LINE-LIMIT'ARE OPTIONAL.
The filename or filetype was omitted, or one of the optional
fields was not valid.

E(OOOOZ)DISK ERROR.
An I/0 error occurred. It may be necessary to initialize
the disk again (see FORMAT).
'£'(00003)

FILE NOT FOUND.
No file with the specified filename and filct.ypc exists.

The search "for the file is made on the pcrrnanent, ternporary, andsystem disks in that order. Jn the case of files with duplicate file na1ne and filetypc_. only the first file found will be typed out.
Notes:
a.
The first line number and la1;t line number n1ust not be greaterthan 9999, and may not contain imbecklcd commas,
The first character of each line in a LISTING file is not typ0cl,
This is a printer carrLigc-conlrol character.

b.

J3J
. '\
)

l.3.o.L
prlntf~o

7-19-68exec

3. 1. 12-3
PRINTF"D .r,1s .n

R; T=O.OS

printf ~o cx~c • • 80
LOlif' 'l.il
START

r,r)
r,()

00010
00020

R; T=0.05·FIGURE 3, 1. 12-A. Two examples of PRINTF commands which
type out an enHrc file.

prlntf sysl lb mactlb 104 118 72
l·IACROMADOPl.HAS EL. &COMM=*, ~iNA11E•"*, &TYPE=*, .!,iMODE•Pl, & I TNO=O, ~BUFF=*, ~SIX
ZE=80,~FV=F,&NOIT=l·'ilADELDS~1LAP.EL. co1111
HA~EL.~JAl-ff\U\qF.L. TYPE
F1Lfl.IH:L.i·IOQE·•d.ACEL. ITNO
'd.fll1H. RUH."1LA3EL.SIZF.

or,

HliflEL.FV

DC
Ot::
DC
DC
OC
or:;
DC

OD
Cl 8 1 P.1CO:-u1 1

cm1MArrn

Cl8 1 .~,NA'·IF. 1

CL8 I !HYPE I
CL2 'MlODE.
H 1 .\ 1mo'

FI LE-NM-IE
1

A(M1UFF)
A(&SIZE)

FILE-TYPE
FI LE-f10DE
1rm Murrnrn
BUFFER AREA
BUFFER SIZF.

CL2 I !IFV I

FIXF.n/VARIABLE FLA~."il/\~El.HOIT

NUM~ER

OC H'&MOIT'
f1LASEL. NORD DC FI 0 I

OF I TE!4S,

NUllSER OF BYTES ACTUALLY RF.AD

l·IENO

R; T•0.07
FIGURE 3. 1. 12"B•
macro definition.

A PRINTF command which types out aprlntf fortj listing 33 * 72

sv:rnoLll)CATl ON

38C

5

SYMROL20

FORt1AT ST/\TEf.1ENT 11AP
LOCl\TIOM
SYMBOL

392

LOCll.TION

8398

TOTAL 11HIORY REflU I REMEMTS 0005 7E BYTES
R; l•O.B
FIGURE 3. I. 12-C. A PRINTF command which types out thebottom of a FORTRAN LISTING file.

~1

11i1, ,·!-•.•"'", •llllll'!lll'···'"·'lll!lili!iiiiiiiiii\lllilWIMI¥,.-·..,.,........ tiA ___;

.~

~
C $$

WWWAAUz;ua ;

4,,.. ':'"; '*"'T

*•

1111

#OI I

. "I

'"

1

I

•

•

"'

""

;~·

/.:i..J

05/01/69
3.1.13-1 !/}!:;.:(

3.1.13SCRIPT

05/0:L/'- 9/f!Jl

SCR1£l7OFrrints the edited and torQatted
OUtfut cf SCRIPT PRINT on the offline
printer instead of at tbe terminal.

FAGExxxc,auses p:intcut to start at page xxx.

SINGLESI

after cne page cf printed output
SCEIFT ERINT ter~inateE, usually usedin conjunction ~ith the PAGExxx option.

S'IOF

causes a facse at the tottohl of each. page ducing SCRIPT PRI~T.

CFFil?iEf.!l!fillg:

7he SCRlP'I cc1wand pEtfcras three fu11cticns:(1) it creates atile on disk of variatle length records fror. successive terminal
input lines, (2) it mcditie:: these files, and (3) it types thesetiles in a fcrroat spEcified by included ccntrol words.

l.9.!.mll.! :filEnan:efEIN'I filenace

EI:l'ISC Ill E7

SC

EDIT

Pfllti'I
J.>

PllHHE

9.E!lH.§:(ofticn1 ••• ortionN)

focwats and outputs the specified
nancscrift file ontc the tecminol,
the ofili.ne p:inter, ct intc another file.
specifies a file uithof scn1E1.

~

filetypecauses offline cutput to be centered
er. the fiinte~ paper.

F lLE'

the edited and formatted output
E~INT into a file na~ed:.filcnaue" int:tc.:id of at the terminalor cf fline ~tinter.
~rintsof SCDlfT

/.:~/

TE

translates lo»Er case letters tc
UffDI case in ftintout.

UNFORMATTEDUN

the infUt !CFIPT file is printed
along uith contrpl ucrds, the central \ords
are igncred and foccatting does not cccu~

TEANSL~IE

Sfecifies that a file Js to becreated cc ~odified.
If tbe fiLe
exists, the user is flaced in the
SCRIP'I EDil envixonment. If it does
not exist, the user is placed in the
SCHIET INEU'I e~vircnLlent, so thatthe file may bE created.

ClN'I Eli
Cl

Pl

S'I

3.l.13-2!l§!!.9.!il:

Filename tust be s~ecified ~ith the SCFIET command. the filetype
SCRlf7 is assumed. Files· created by thE SCDIPT cccrrand have thefilc~cde P1,
but existing infut Jiles tc SCRIP! EDIT may haveucde letter E oc T, and Dede numter 1 er 5. SCRIPT P&INT accepts
any filer.ode.
'Ihe SCBIE! EDIT version of this cc~maua ~laces the user in cne cf
tuc enviren~,€nts:
The Scrii;t Ini:ut eni1iro1went oc the Script
Edit onviron~ent.
In the Script Input envirco~ent, a file iscreated or expanded by adding ~uccessive terninal input lin~s.
In the Script Edit environ~ent, existin~ files ~hose filetyle is!CEIP7 can be exaninet and ncdified.
Multiple passes can te ~adethrough the iilu, adding, deleting, er roplacinq lines.
The
Script Edit etvirc~cent acCefts t)ped requests that srecify an
q:erati.ou on a line, or cl r.:cve tc ancthet i:osition iil tlie file.

11

NCW JI!'.[

stactsNP

ioi;cJiatcly bithout \iaiting for

NUMHliNU

SC~IET

EEIHT cutput

the first faqe to tc

7hc SCfilf1 P~IN1 version of the SCRIFT cca~and ex~mines each line
ct the file for ~orttat centre! Yords, which arc identified asline~ ~bich tegin ~ith a fericd, and tyfES out tho fil~ according
tc tho fcruat srecified.
-acju~ted.

prints in the left marsin the SCRIPT
filecarre ~nd line nuntec cocresponding
to each line cf ftintef cutput.

1he SCEIPl E[IT requests ac~ descritea individually ~eginnicg en
fage J.1.13-8 and SCRlE! l6Ihl fcr~at ccLtrol words ace dcscLihcd
individually beginning on Eage 3.1.13-24. Exacrles of a SCRIPT
file and SCBIP1 PRIN1 cutput are shoun in Figures 3.1.13-A and3.1.13-B, beginning en Eaget)h! ").1,13-3

3.1.13-4~.

O~!/

SCRll?'t

05/01/v:3

SCFlP'.f, /69/3t..c:: 3.1.13- 1
1

ceyuEst Js entered, the keyboard is lockEd until the action::pocified is conpleted. As scc.1.1 <H3 the keys are freed, ancth•?t
IEqucst roay te entered.

13r;"~£!1£1_1~~~J-IDJlIQ~D£JJ!:~hEncvEt

the user is in the Script Edit environneut, a pointer isnaintained srecifying his current pcsiticn in the file, or tho
ttcurr<'!r.t line".
SCHIPT.EClT rcguGsts rcrftJtt3 creraticns
on thecurrEnt line, en the fCitier, er en both.

1he Scrift Input environment iB entered uhen a SCRIPT EDIT
ccroman6 is issued SEecif}irg a file that does not exist. It nay
alsc be entered frcm ·the Script Edit environaont by issuing theI•EU1 er the BOTTCM reguests. Whenever this environuent isentered, the res~cnse "INPUT:" is tyFed and the keyboard is
tnlccked to accept an input line. As each input line is entarod,
it i~ added to the file, and the keyboard is unlocked to accept
the next line.

~hen tho Scrifl Edit cnviron~ent is entered fron the Script Input
cnvirccrrent, the current line uill h~ the last input line
entered. When the Script Edit environaent is entered frorr the CMS
Ccnnand environment, the ~cinter is FCt:iticncd at a tlank linerrec~dJng the first lineof the file. 1his lino is part of thetile only in the Scrirt Edit environment, and is not stored withthe file. It may not be ~edified er deleted, but it allcvs lines
tc bE inse&ted at the tof cf tho file.

1hc a and t symbols are dclet~on char~cters in this envircnrrent.
>n ~ syrrbcl deletes itself aad tha freceding character. Several
consecutive a syrntols delete an equal nunbcr ot preceding
charact·Ers.
The 'I- syiil:cl deletes itself and all charc:..ctcrs
rreceding it en the line.
1ho character iN~cdiately follouing
the tsyubcl is effectively at th~ left ~argin. Any othercharacter on the keybcard i~ a valid charactcc, includinq the !AD
key an~ tlie EACKSPACE key.

1he fOiotcr .always mcves for\atd thcou~h tbc file. Succcnsive
faSE<"S throuyh
the file can be rnade ty using the TCP request,
wUcb re1csiticns the i:cinter at the llani': lj ne p.tecedinq the
file. SEE tte imdividual tc~test descriptions for the action ofeach on the Fainter.

1he ~axi~urr length cf an input line is 120 characters •• If.dclcticn symtols are included in the line, up to 132 chacdctersnay le entcrEd, sc Ieng as the effective length nfter d~lctionsiE 12C characters er less(including hackspuccs).
Any linelcnger than 120 characters will Le truncated.
]_g.1.£:}rgucsts may be entered in upfcr or louer case. The firEt lettercl a requ~st is sufficient tc
uniquely id~ntify the request. Fon
e:xan1lc, a :::ingle "t'' er illlY line heqinninq "llith "T" would
sr.ecify the 'IOP request.
fi<:•1uests llhich Day include nuritcrs nustlE separated ftcrr the tuntec ly at least one blank.

llacksi;aces and underlines are includ12d ill the 120
ch<HdCter lir.it (a CF/CllS lir;itatic11., net a SCHIPT lili'itaU.cr.) .. Aline ccrsistingcf
40
underlined 'characters
occupi€s 120
characters. A lonqer line would be truncate(!_ uith no trnrid.ng~essa9e by SCtlET
since it orerates independently of tho ~p;cns
t:s::ur,caticn.

7trcc cf the SCHIPT EDIT reguests provide exits frorn the script
Edit enviccnrrent.
FlLE stocEs tLe current CCFY of the file ondisk, nnd returns to the C~S Co~raand envircnnent. CUI1 returns
to tte CMS Ccnrrand envircnacnt ~ithout Eavinq the current copy of
the tilo. INfUT exits to thE Script ln~ut environment.

1he only e~it free the Scrift Input environment is to the script
Fdit environncnt. 'Ihis ()Jdt is taken t1hcn C\ null line (a line of
1 e n g t h 0 ) i s en t e r c a•
A n u 11 l i ne is g e no r a t e d uh e n e vc i: acarriasc return is tyfed while the carriage is already at theleft margin.
The null line dces not tecone part of the file.·
Eecause the rull line is the cnlJ exocuticn control in the script
Infut envircnucnt, it is alvays nacessacy tc qc tc Script Edit tosave a file er tc rctutn tc the CHS Comuend environncnt.
_!.f!.!;1?.L1dl..L.r..D.Y):H!!l!£ n t_;,1his ervi:s::cnucnt is entered frcm the SctiFt Input environLlcnt by
tyfinq a null line, or directly from the ens Ccnnand environracnt
ty Sptcifying an existing SCRIP'I file uith the SC~IP1 Er.Il
cou~and. In either
case, the tOSFCnse "~DIT:" is typed, and the~eybcard is
unlocked tc accert a SCRIP1 EtIT request.
When a',,..
';tll _ _ _ __"''•"-·~ ;.11:pp41Pta;:M£4# 2 . aIA£4$11£US: Ji

aq

JUL

$

I( -

.. ;

I

--

;

I I

I I

''9

'ii

I i

I ISL; m:::n: "''""w., ...

,lltJll"fllllllllll!llllll~llll•••"

"'

.I"'

SCFlPTg.£.H.L.R.!Ul!J :

~·

/.3f

05/01/ _,llf.t? 3.1.13-5/37khen tbe SCEIET EEIN! ccomand is issued, the specified SCRIPT
file will he tyi:ed eithEc at the ·user's tcrttinal, on the offline
irinter, er into a file.
Ex€cutiou is ccntrcllcd by format
ccntccl words included in the specified SCFIPT file.
When thetile is locat•d and typing is ready to teqin, a resfcnse istyred, and exEcution pauses u~til a carriage return is entered at
the terminal unless the ~OWAIT, CFFLINE, er FILE crticn h~s been
speci~iEd.
~hisrausc allc~s the user to position the output
raper at the top of a Faqe.
lf s~or is specified with theco~rnarid,
the rause is tereated at the bottom of each page,
allowing the user to change parer if ten-continuous forms arelEin~ usea.
If STCP if ufed, the paper should be ~ositicned tc
the first line to te Fiinted, the heading, rather than to thefhysical tc~ of the fage. Typing will resuree when a carriage
return. is tyrl'd.
2he lRANSLAIE option is needed if output is to te directad to an
cfflinc; p:int<!I that is net Equipped uitb the unor and lo\let"casE lEttets (TH-chain).
In conjuncticn 1:1ith the UllFOlHlATTED
c~ticb,1RA~SlATE provides
a means cf printing tho ~riqinal
SUiH'I file

en a i;:rinter that dcEs not huvc the ~-11-·chain (thiscannct tE dcre by the cegcl:it 11 0FI"lihE t:EIU1' 11 CMS co1,iuand).

'.IHe rAGE:xxx q;tion in ccnjuoct'ion uith the SINGI.E option provides
a uuans for selectively fct~attiog and FI"inting ~crtions of aranu5crii:t. 'Ih~ x>:x repe~ents a 3-di.,;it pilgc nui~bc"r. aud must
include lc:ading zeros (i.e., i;age 12 only should be ref)uer.tcd hy
11 SlllGLE f1.GEC12 11 ) .
AncthH 11ean£ of :=:electively manipul~ting afcr~Qtted ~anuscrii:t
is.to usE the FILE ~pticn tc generate theenti~c er relevant~crticn cf a nanuEcrjpt into atile and thenuse •he CMS tacilities cf EDI1 and;or PBINTF to process it.

Each linE r<ad frcn the dif k file by SCFIPT PRINT is inspected
tot a first character of 11 • 11 , which identifies a format contcol
wcrd. Fcrreat central \Ords are not typed, but arc interfcctEd to
EFEcify charges in the cttrut format.
Control uords rufty tc
entctcd in u~pcr or lower c~se and shoulf le separated frcu theircrerands, if any, by cne er ncre blankE.
ccnttol words may aFpcat 3t the beginning of any line in the
file,with changes effective below the pcints at which they
cc c u r •1; c i n p u t
d a t a s ho u 1 d
I: € i n c 1 u de i\o n l i tie ~;cc 11 t ;'\i n i 11 CJ
central wcrds, since thiE 1ata could i~ some cases be lost or
intgrfrctcd as an operand cf tho ccntrcl uocd.
].Q.!.fili!:a. ~he ScriFt Edit and 5ctift Inrut environments should not be
ccntused ~ith the Edit and Input environwents accessed b) thekD11 ccwnand. Althcugh uany cf the SCRitT EDIT and EtIT requests
are siuilar, the action taken is net al~~ys the same.

SCRIP'l#,, os/ul/69
r;j;J 3.1:13-6

t. A i symtol or a.synbol Jmgediately followed by a carriage
return i~ the Scci1t lnfut envircnnont does not generate a nullline, and no exit ~o the script Edit en~ironnent will be taken.
The carriage ~ust be ~hy~icall} at the left margin for a carriage
return to qe11€t:ate a null line.

c. ~he 1AE key generates an acceptable character in the script
lnfut Envitonrrent, and i~ retran8nitted by SCRIPT PRIH7.
The
turnber of spaces actually skiffed on frint output is dependent on
the logical tab setting specified by the .TB cc~mand.
For
indentatJcns1 the .IN
er .Cl contrcl words should te usedinEt€ad of the TAB key.
d.

The SCBifT~hEy arecommand employs two vorkfiles during execution.

FILE fl and (I!IPU2.'2)FILE F1.
I f a previously
uli.stii;q file·
being pr:ccesscd, themcde 1:'1 is rei:Iaced by thencdc cf tho in~ut file.
These files ace normally craEcd on
fillFU'11)

is

ccmwan ctern i lla ticn.
Oncicf
them replaces the previously
if any, just before ccntrcl is returned tc the cos
ccnnand envircn~ent. In cases of a ~achinc or line failurecausing an unusual ternination, all o~ fart cf an edited file caylE salvaged frcn (INPU71) or(INPUT2). If a previously existing
file w~s tcing proco~sed, it stila cziEts ac though no changes
e~isting file,

had leen 1ade to it.

IttfUt lines tc SCBIP1 !CIT are scanned aud cbnonicalized uith
IBEf&ct to underlined and averfrintcd chzracters. This prccoEs is~xrlainad in
detail in csc Bepcrt 320-2023, "SCRIPT: ln Online

E.

~anuEcrirt

Ptccessing system 11 •. k/,"'05/~l/69 ; . /05/01 _,gi:Y'17 3 .1.13-7

SClllP'I

13/.l!~~J2£1g.§:

SCHP'l41.1 3. i. l 3- s

Ne SCRIPT versicn of filen~tle z:r.Y.xxxx uas
SCEIFT PRINT co~oand has teen tecgivatod.

found.

The

SEM --- SEP'l.

DISK EliBCR WHILE BEAClUG
A disk €[[0[ was incurred by SCRIPl PRINl. The SCRIPT PRINT
ccmreand has been terninated, and the disk file being printed
will remain unchangad.

'lhis reEfonse is typed ~bencvcr the SCilIPT co~oand receives
ccnttcl. (SEH is an acrony for SCBIET ENVIIlOUnEDT UODULE.) WithSCRIPT PSIN'l a ~ause fc cv~ this rcEponse until a carriage
teturn is tyfed unless the
WAIT Oftion bas been specified.

E(0001~

I!iFU'l:E(OOC1€)·;'7his resfonseer.tered.

is typed

whenever

i

t~

Hl'I:

lNV~LitiE

typed•h<ne•er thea SCRIPT
terttinated.
~rinting

is

I

\iit

SCRlFT EGIT CC~P:AND

PBINT ccm~and'~

EBROB OCCURRED Af1EB 6EADINGLINES.

com~andwhile
has beenxx~xassists in finding

SCBIPT

No action

PRINT,

the•offending error

in SCRIPTA TEHNJHAI EBRCF RAS CCCURilEC WHILE
PROCESSING ON OR AROUNt LINE xxxxxxxx••• , E1C.

~essageindicatesasystenerccr.

The

appxopriate

pErsonnel shculd te interned of thE circuDstances. Usually
this ccridition can be by~assed by diagnosing the cause of
the crrcr and changing the SCEIPT file.

\ccurte1.
lf the file exist d bcfcre theued, it bas net been cl1an9ed.
y'. any editing
Ncte d.
·REBU€§ts:
Feguests are issued to the SCEIPT ccmmard only when the user isin the ScriFt Edit environ~ent. These requests allou the user tonanifulate and edit SCbIPI files.
If requests are issued in the~cri~t Icrut environment, they becoue lires cf input to the file.

I . CRilEC't PAUi~ E'IEil llST\Ar. inval'
parameter. has been sFecificd for a ~CRIPT PRINT
ccntrcl ·ord, er a reqcired parameter has been o~tted. The
SCtilET EEINT co~mand has been tersinated.

PILE XXXJXXXX lCT PCUND.

***

E (CCCOC)No:E (OOOOLI)~i~

encountered

te terninatcd.

froc

1his
tISK Hlil !l.

~ill

For all of the errct ccssages
fcllcuing message is printed:

ThJs usuallyfile.

E(CC001)
COBliEC! JiCByiS: 11 SCiiI.E'T 11 11 EII'I"RILE\JAl1E.
Ne filetanc was !Ie fied with the SCRIPT i~IT command.
action \as ta.ken.
\l (COCOS)

vas

1

\

l.H..Q.L t'.cg~.9.fil?:

s

wcrd

The SCRIP1 PRINT

CORRECl FOUM IS: 'SCBIFT' CtHMAND NAME
WHE&E COBftA~[ 15 ED1~' OB 1 PRINT 1 •The c~noaKd ~as net SCHIET EDIT or SCRIPT P~INT.
was taken.

This res~cnse is given whenever the S~IPT PRINT coomand is issued
withcut s~ecifying the NOUAIT cpticn. Yhe carria~e return must be hit
in crrlEr foL SC~IfT fFINT rrccessing o ccntinue. \The pafer shculd be
adjusted as descriced above.

requests.

file.

E(OOC6S)
did.
thelOAD PAFEE; Hll RETURN

An l/C errcr
command was ichnt ENCOUi7EEED.

centralE(0002Q)~CFE 1H~N EIGE1 AC11VE Plt!S - REDUCE ~ESTI~G.
1hiE ~cEsaqc ~ill be given by SCRIPT PRIUT when more thanseven IMBED ccntrcl ~crds arc encountered in the SCRIPT file
being printed. All open files uill te closed and the SCRIPTisThe IEquest just s~ocified ~as Either not
qct contain a valid operand. Refer tondlvidual re~uest f~r its ~rofer fcrnat.

.E (CCC02)

ILLEGAL CCN1BOL

unreccgnizable!

\

This tesfcnse
entered.

Envir9tnent

Scri1t Input

An

Each regucst
more blanks.

. '

--

is seEaratcd frcm its Oferands, if any, by one er
ihe SCBIP1 EDI1 reguests are listed below and ace~

7c·6-15-70
3.1.13-7
SCRIPT(
3.1.13-7

SCRIPTRESPONSES:INPUT:
This response is typed whenever the Script Input environmentis entered.
EDIT:
This response is typed whenever the Script Edit environmentis entered.
INVALID SCRIPT EDIT CO}ft1AND
The request just specified was either not a valid request word
or did not contain a valid operand. Refer to the descriptionof the individual request for its proper format.

c

LOAD PAPER; HIT RETURN
This response is given whenever the SCRIPT PRINT command isissued without specifying the NOWAIT option. The carriage
return must be hit in order for SCRIPT PRINT processing tocontinue. The paper should be adjusted as described above.
ERROR MESSAGES:E(OOOOl)
CORRECT FORM IS: "SCRIPT" "EDIT" FILENAME.
No filename was specified with the SCRIPT EDIT command.
action was taken.

No

E(00002)DISK ERROR.
An I/O error occurred. If the file existed before the corrnnand
was issued, it has not been changed· by any editing requests.
See Note d.
E(00004)
INCORRECT PARAMETER LIST
An invalid parameter has been specified for a SCRIPT PRINT
control ,.;rord, or" a required parameter has been omitted. TheSCRIPT PRINT command has been terminated.
E(00008)

FILE xxxxxxxx NOT FOUND.

,,,..

fl"'\SCl\.IP'ftescrited pn the indicated Eages:

~

///4

05/01/69
ft!/" 3.1.13-9

Ml:,· 05/01/69

SCBIP1;f;q;::;,l 3 • l . 13 - l 0!f..L

g!lUl...l RI]L~<m t ro L!.9.&~§:
BequestPago Bef.

PRINT Conttol vcrds ate issued as in~ut lines to atEiDg created in the Scxipt Input Environ~ent. These uords\ill later be interpreted by the SCBIPl PBIHT cocnand to 9cvern
fcrmat ccnt1cl as the tile is being Erinted out.

1he

SCFIE~

fil~

BCT.TC I!
Cl:ANGEDHE'I EFlLiEl t\E UTlNS,HIT.KH1E

LCC:li'IB
NEX'I

PRlU'I
CliI'IREP J1,11CE
SE.El<

70P

3.1. H-B
3. 1. '13-9
3.1. '13-11
3. 1. 13-12
3.1.'.13-13
J.1. B-14
3. 1. B-15
3.1.'13-16
3.1.13-11
3.1. 13-18
3.t.13--19
3.1.D-20
3.1.13-22
3. 1. 13-23

lhe SCDlf'I PBIN'I centre] \Otds are listed belov and are descrited
CD the indicated pages:

cent 101 Wo1:d
.H

.BM
•.EB

r.eaning

AFJ?end
Bottto11 Margin
Er~~ak.·cE·Center.c~

Com11cnt
Concatenate Hcde
Conditional Page
tcutle Space aodeEo:creat (cld fcu)

.co

.CP

.ns

.FI
• FO
• HE
.IHI
.HI
•IN

Fcrnat ·t!cde
lie a ding.ss

Heading P.argin
I If bed
IndentJustification MODE
Line length
No Co~catenate Modeho Justification Mede
OffsetPage Eject
fagc tength
fage Nucbering Mode
Head Fro• Terminal
S~ace Liues
Single Sface Mode

.TB
.'IM

Top f!argin.UN

Undent ·

.JU
.. LL
• f.C

.NJ

.OF
.PA
.EL
.PN

.Dt
.,SP

Tab

~cttings

Page Ref.

SCBIP'l

BeguestEOlTOJi. 05/0l/6

1,1,,,r os·101/69
P'l/i 3 , l • 1 3 -11

SCB~PT

;J,
;.:;

If/

CllllNGE Be9uest.!'..Yrpose:

I

i.YU.Q.§.!i:

CnANGB replaces a Sfecified string of infor~ation in the current
line with ancther svecified string of intocmation.

f0l10H prints the last liDe cf the file boinq edited, positions
the ~cintet after
this line,a~d entets the
SctiFt Input
Environ~ent.

1.!tlrn:

J'CUaj:BO'ITOMCHANGEcBb!~=

1his regucst ·may he issued whenever the keytoard is unlccked in
tbe Scri~t Edit eniironBent. It is ~atticularly useful when alarge SCRIP~ file is teing entered in shcrt sessions. DOTTOH
rrints the last line cf the file to reuind the user ~here he lcfe
~ff, ~ositionn the pointer after this lite, and Ento~s tho ScciFt
lnfut envircn~ent to allcu lines to be added to the cud of thefile.
j~§E~!lE~n:

is any unique deliDitiug character
that does not aprear in strin~1 or
string2.

strin91is the grcur cf characters to be·
If ~trinql is not fFecified
string2 will be ~laced at the
beginning cf the current line.

Etdng2

INPUl:
1his is the normal response to the BOTTC~ request where uxxx •••xxx" is the last line cf the file being edited and the pointer is
rcsiticned after the last line of the file Ftior to transferring
ccnt£ol tc ScriEt In~ut.

is the qroup ci characters Yhich will
teplace or prec~de string1. lf string2
is ~ot sfecified, string1 vill bedeleted frca the c~rrent lin~. ·When the CHANGE request is issued, the current line will bescanned for a match on the characters SFECified as string1. If aratch is fcund, the characters in st~ing1 ~ill be replaced by thecharacters in string2. If nc natch is fcund, the ~urrent line
will ce~ain unchanged. The strings de not have to be the samelength; the current line will he exi:anded or comfr.essed as
iequired.

1hiE message will he given if a E07TOH tEquest is issued when thei:ointe.t is Fcs.itioned after the last line of the file (i.e., as
the next tcguest after the nessage flEOP BEACHED. 11 has been
typed.) 1~e fciater will net be moved, and control will transfer
tc the.scrift Input envircnaent.

is not specified, the ·Contepts of string2 vill be
spfEndEd to tha boqinting cf the ctrrent line (see Exa~ple C). If
Hting2 i..s not specified, string1 will te deleted froo thecurrent line (see Examfle d).

! f string1t·This is the last line.
IHPUT:'Ihe last line of the file being edited, "This is the last line."
is tyFod out and control is ttansfetLEd to the SctiFt lDfUt
Etvircnuent.
Any lines Entered intc Script Input vill beafpended inmediately after this last line.

,,.,

rc~laced.

!!.§..9.9.£:

NO CURRENT LINE.
INl?U'I:!..x.~u~:/striugl / strtng2/Ixxx ••• x~xa.

e?J a.i.13-12

,..._

~

f""t,~""
r,05/01/69//% 3 • l. 1 3 -13

SCE.JP?

/fr(

l!fil;~.§:a.
No verificaticn is EIO~ided vhen a line is changed.
examine tho changed line, issue the PRlHT rEquest.

SClilHlk/d6
I

DfLE'U Rec;;uest
To

05/01/69¢,f 3.1.1-:\-14

j~rpose:eras(s a specified number of lines frcm the file and1ositicns the EOinter at the lccation of the last deleted line.

tELE7Et. Cnl~ the fir~t occurtence of string1 in the current line vill
be changed; nc global change is frpvided by SCilIP.T EDIT.

l..91..lli!!..:
RE§,E~.§::!RUNCATED
1he requested change has extended the current line
12C cha~acters aDd the line has been truncated.

tc more thanNO CtANGE.
cccurrence of string1 was found ix the current line.
fointer is net ~cved and the line xcnainE unchanged.
~ctELETE
Dn

JI

specifies the nuah€r of lines tc
be erased. If c1ittea; 1 is assumed.

.!!J.U!..9§:p

cf sbces end ships and sealingc /en/an/~a~paf shoes and ships and sealingva~

1his change rEguest will cause the first occurrence ofthe current line tc be changed tc "an".

t.

I
I

The

Jxat'ple.§:a.

-----J"en" inStarting vith the current line, the specified nuober of lines isdeleted froc the file. If no nuabcr is specified, only thecurrent line is deleted. If the DELETE regucst is i~~ued ~henthe pointer is fOSitioned at the null line b€tore the beginninq
cf the file, this null line ~ill be ircludod iu the count oflines deleted, but a null line uill renaia at the top of the
file.
,I!g.§..E.9.D.tsL§:c 7oes?arEs?
Fof shares and shifs and sealing wax
1he fir~t ~ccur~ence of ~oes" in the current line will bo changed
tc "ares" and the line will be D~fanded accordingly.

c.

~>>tc Sfeak>p

tc sieak of shares and shifs and sealing uax
1he string "to speak" will te apFended to the beginningcurrent line.
d.

ECF EEACHED.
7he ~nd cf file was teached befcre deleting the specified number
cf lines.
The fainter will be at a fCSiticn im~ediately
follow fog the last liTie! not ·deleted.
fil1U!.E1 es:of theDELETE 5
Five lines cf thea.

file are erased,

beginning withthe current

line.

c ;sealing//p

to Sfeak cf sha1es and ships and wax
1he string "sealinq" will te deleted free th~ current line.

•

I

); •

D

1he current line is deleted.
at the pojnt cf deleticn.

The pointer vill recain pcsitioncd

05/01/69 /Y..-:
3 .1.13-Hh.0"

SCDIPTSCBIP7JllJ
05/01/69
1 ,&. 3.1.13-15/Ir

INPU'I 1iegue.st

flLE hguest
JLY.uos,g:..f.!il..E.f'EE :I~FU'I transfers the user froa the
Script 1nput envircnae~t.

1he FlIE reguest stores the current copy of the tile on disk, andexits tc the CMS Command envircn~ent.

Script Edit envircnoent tc thej'..Q.I~at:l.Q.!!11!.! :HLE

INPU'II

tilenallE

1"..YE~..9!1:

filE"na11e

specifies the na~e tc be
assigned to the created
file. If this operand isomitted, the filenane SfECified
when the SCRIF1 Command •asissued will bE used.

1NPU'I allcus the user tc add a line or lines to a file follouingth~current line Sfecified by the ~crift Edit environ~anb~ointer. 'lhe neu lines de net replace an1 alread¥ existinq lines,
but are inserted between what was the current line and the linethat fcr~crly folloMed it.

Usa.9.£:].Q..!.£:

FlLi isissued to .save a ne~ or edited copy of a file on the
FEtmanent disk.
It may te iss~ed at any time in the
Edit environaent.
7he fcsitic~ cf the pointer is notconsidered, and the whole file is always stored.

If the pointer was at the top of the file, that is, at the tlankline prccedj~g the fir~t line, lines entered after an INPUT
irecede the for0er first line of the file~~scr•s~cript~§.P.Ql.!.§.Q:

l.!A!!.I.l,!; :a.
·INPUT:
7his response signale entry to the Script Infut environ~ent.

a.
FllB
1hc file currently being edited is stcred on the user's pernanentdisk, refla~ing any previcu.sly existing cc~y of the file.

.&.K~!.tl.f':l?:a.

EliHT 1the fcllcwing fart nuabers:•INFU'I

1he PBI•T request tJfES the current line.
All lines enteredafter the lE~fonse issued by the INPUI xegnest will he inserted
in the file fellowing the line t1the fcllcwing fart Dllmters: 11 ,until a null line is ty~ed to return to the script Edit
envi1cnment.

~~ ! 11111 ::::;as:: us . i"''lfl!!ii*i!!ii1111 J!!1111!!, iiWl!l!'llf'Et °"'··" "..tu1Luau1u..
1~n ..a;s

a

I

u; Ji

I

I

~
ii

1 ·1

1 f

iii

. II .I ... $ I . liij .$$ . 4ii#\ I #4 · UA .¥I

r

'~

~

SClllP'l

SCBIPt05/01/69 ,,.,.0-_ .
3. l. 13-1 7l?.1;r._,,1(1INSHt'l Bequest

05/01/69
3.1.13-18
r7I ~){.)

KF.U lieguest,,,.,,r,0~

PU~PP..§!l:
REEF c~eatesa new file on disk consisting of all uaterial ftcP
the be9inning of the file being edited to the line above that at
which the fcinter is currently posjtioned.

.!..Y.!.fJlli..~:lNSERT allow~ a single line of input to be added tokithout transferring tc the Script Input environnent.

the file
111.!.!~..t:

1.2.H.ll:
J

KEE:!?
.K

INS.Ell'!

,,I

filenan1e

line

l-

filename.

line

is the e1act infut line tc be
inserted into the file.

]§2_9!?:

specifies the filenaue tc be
assigned to the new file.

.Yli2.!J~:

1his request allows users tc create disk files which consist ofof existi11<J SC!l!ET fil<:s.
Bbe11 the KEEP request isissued# the contents cf tbe current file frcu the first line tothe line preceding the cne ubarc ±he pcintcr is positioned will
te saved en the user•s pernanent ~isk. This file uill have thefilenaEe spetified in tha KEBE reguest, a filctype cf SCBIPT nnd
a filceoa~ cf P1. 1bis ~aved po~tion bill then be ceased fronthe current file and the line at uhich the FOinter is positicned
will bE-co~e the first lina of the file ~eing edited •· _pcrtions

this ·request inserts the ~fecified linE into the file without
Entering the Input environoent. ~he ljae is entered fcllcuing
the line at which the ~cinter is currently positioned and the~ointer is advanced to the. inserted
line. 1he line is 2eparated
fro& tle INSEH1 requeEt hj cnly one blank; all other blanks are
ccn£idered part of the inFut line.
.]o t..§:

a.
lf the INSERT request is issued \ithout an operand, it isintetfLeted as the INEUT reguest and the script Infut en~ironoent~ill cE entered.
l.!~Wg:a.

I INPUT Line tc CE added to file.
"IUfUT Line to te added to tile." wculd be inserted
lire at which the fCinter is currently positioned. The
keybdard would then te unlocked to acce~t another SCRIPT EDIT
tequcst, and the pointer kculd be positioned at the input line
just entetcd.
~he line
aftc~ t~e~.!U:.91!.§11•.§:OtD !ILE NOT FOUNt
ihe KEEf request vas EFecified uith the ~ointar positioned at thejirst line of the file. No "old file" €Xists above the fointer,and therefore nc acticn is taken.
NEW FILE ALREADY EXlS!S
1he filenaoe specif led in thQ KEEP ~e~uest has lalrcady been
assigned to a SCRIPT file.
tio file has been created by the KEEP
teguest.

INVnLID SCilIPT EDIT ccnHAND
filenaue uas specified ~ith the KEEE tegucst. A filcuaco nustbe spacified and ~ust. be separated fron the request by at least
cna blank.
~osen Il?'1

05/0l/l>93,l.l;:l-19

SCFIP'I.>'l/;t,~1/9 ,{ff!

1!2.!ll~:

05/01/69
3.1.13-20///!]'/6.2

LCCATE Bequest

KEEF CHAPT3
tile will te created en disk with ·an identifier of CHAPT3.~CEifI P1. lhis file will ccntain all lir.es frcm the heginninq of
the current file to the line ahove that where the pcinter isfcsiticned. This pcrt.icn dll be erased from the file and theline where the pointer is positioned will beccwe the first line
cf the file teitg edited.
a.

lJ:!J;..t.Q!i!g!

A

LOCATE s~arches the
s1ecitied string.

SCEJEl file fer the first

cccurrence cf thel.Q!!!l!.!:LOCATEI/string/l/

is any unigue deliniting character
that is net ccntained in the string.

·string is any grcup of characters to besEarched fer in the file.
].§.!!.9.§:

lCCAiE scans eoch line cf the file fcx an exact oatch of thecharacter string s~ecftied bet~ecn the two delioiters. The scantcyins en the line im~ediately follcuing that at which therointer Js currently rcsiticned and continues until the string isfcund or until the end cf file is ie~ched. When a ratch isfound, the keyboard ~ill be unlocked and the pointer vill bercsiticncd at the line in which the first cccurrence of a match._as found.
.
£.£.E.F.fJ)i~S~~:

HF liEACllEI:.

~his £Cssaqe is typed ~heoever

the end-cf-file is reachEd bEfore

a match of the string is fctnd •.E~1!.m.PJ£ :a.
lccate /abed/
1hc file will be 1canned, starting with the line i~mediatcly
fellowing that at which the ECitter is currently positicncd, for
an occurrence of tha characters "abed". If a match is fcund, thekeytcard will be unlocked with the fcinter positioned at theutcliinq line.

.....
~i&

m;mm

U

.

1·~~·~:· :~~kJM!Mfi@.ij!4!4P.4f#J.... . _ .L_JUJ.t.;,.¥#Ri!Hi.M¥¥iJ_.atae_. tJ;,,4;;__4. · WU-"'4~4P

ea 4.;;;a :afmw.

;;;4442*w

F+=+"--·•

""'

~

"'

·,r,,

SC EI PT

05/01/69

05/01/69

3.1.13-21

fril 11>'3

NE.X'I .lieguast""''

i.YHQ§fil!:SCJllPT

3.1.13-:0.:2/15"1'.. -,/
r J' /t;) ;,-PRINT liequest· .1.!JH£.§E:

NEXT mcves th@ current line
lines in the file.

~cinter

forYard a specified number ofF C.!Jrl'!..!:'Ihe FRINT request types thewith the current line.

specifiednu~terof lines, beginningl9.rn2.1:-----NU'InfBIN'IE};.Q.§il.9.§ :Sfecif ies the nunbet of iines to type.
If omitted, 1 is ass~med.

n

The current line pointer is advanced the specified nuuber cf
Jinei::, er tc the ne)jt line if no nunber: is specified.
If
end-cf-file is reached, the pointer re~ains pcsitioned after thelast lin€ of the file.
h.§Hl!§iL~:

HF EHClltD.

1he end-cf-lile was reached before advancing the pointer n lines.
J:.l!!!!!!J?1S.§:NEXT 15
1hE ~oioter is advanced 15 lines, counting the next line as cne.

a.

t.
n
The Fainter is advanced tc the next line.

n.!L!';!_iHJ~:

The PRlNl reguest is u~ed to examine the contents of lines in thefile ~hile in the Script Edit enviccn~ent. The current lite isalvays the first line ty~ed. The i:ointcr is advanced to the lastline typed. If only cne line is sfecifiEd, the i;:cinter does notuove. If end-cf-file is _reached, tho fCinter vill be positioned
after the laEt line of the file.
]£.f.E..Q D.§ es :NO CURRF.!IT LINE'.lhis n:ess•ige indicates that the i:ointer is i;:ositicned (1) bcfrirc
tbe first lire. cf the .file (2) after tbe last line of the file,er (3) at a line which has just teen del<EtEd.

ECF riEACHED.
'.lhis ucssagc is typed whenever the end cf file is reached bcfcre~ line5 have teen Ftinted.
'Ibo fcintet will be positioned after
the last line of the file.
l~~H]£.§:a.
PDIN1 3lhreo lines ace typed out at the ter~innl, teginningcurrent line. The fainter is advanced two lines.

with the05/0l/G9
3.1.13-24

SCBll?'I

x:;'_:f:·05/0l/o9
SCBIPT
3. l. .,. '=1-? 3t.
p'£1'.t 165
1he current line is ty~ed, and the pointer is net aoved.

, _)(//1-s-/.Q!l1Ll1H~_g~.1,

bJUf.§.£:

1he CUlT request rctu£ns the user to the CMS Cocmand environment,
kithcut saving the cucrent cofY of the tile beinq edited en disk.

1.2.!H!:

QDI'I(;.l!.§!!.9..£:.'Ihis request provides an exit free the Script Edit envirct~ent~ithcut savitg
the CCFY cf the file being edited. If the file
existed en disk previously, it still exists withcut any of thechan~cs tade by the cutrent SCRIPT EDIT co~mand; If the file wascroatcd h} the current ccncand, it is erased.
!11'~.I!l§:

a.
QUl'I
'Ihe current copy of the file is exased. Ccntrol i~ returned to
the CMS Ccn~and envircnuent. If this \as a previously existing
file, it re~ains unchanged co the user•s per~~nent disk.

-...

""
.,,~11 rL1111

I' m;l"' !!filiillili"·i!!i!ifii!!ll#!il!ll!l!liii+,UijF&.llM.;;;:111 . ;wJ@,iii 14N4

!lllMl?li/J.IP

p;:z ,+;w;;;;a &,;:;a a 11¥$~:;;; "'.

144

""'

1

""'"'

••··

....,..

''"'"f'·1~,,.--

,,,,,,..

·""'
05/01/69

SCDIP'l'.'l,1,l~-25

~12~
167

RHLACE liEquest. l.YJ;..t.Q§j:

NEFIACE ~equost Erases the current
re fl aces i t llith a spec i f ied f-He.

~be

,All\

line

of

a f ila,

and

)·1~

!..9Hi!.!:O~/Ol./69

SC!ill?T

3.1.13-26.

.P,'V/o,,.J

15'6

JUti!JD_EJ!il.§ :a.

REPLACE even though the hippo~rif uas
current line is elased and the line
hiHcgtif was 11 is inserted in its ,i:lace.

The

t.

«even

thoughtherln view of these results, itline is deleted, and the line "In view cf theseis inserted Jn its flace.
~ote that five of the six
tlanks betuecn "c" and "ln" are retained as part cf the line.
1he ether tlank serves a~ a deliniter tetween the request word
and the neuline.
~hecurrent
Ies~ltr, it"

newline

HFLJICEi;ne"lineis the line which reflaces the current
line. This line starts in the first
pcsiticn fcllo\ing the first blankafter the reguast.
If no cperand isspecified ~ith the BEPLACE request,
the current liqe will he deleted andthe Sctirt In~ut environroent will beentered •.!L§E.9£ :,~hefirst tlank follc~ing the reguest sec~es as a delimiter.
Additicnal blanks are considEred fart cf tho neu line. The ne~liu£ uust ccolcru tc the regui~eneutE of the Script Input
envtrourucnt, except that thu regu2st wcrds and tho firEt blankarc r.ct ccu11h:d in detci:n:ining length.

ll.2..t!?.:§ ~a. If np orerand iE SfECified with tte REPLACE request, thecurEcut line uill be delctad and the Script Input environment'ill tc entEred. This i ! es~ccially convenient when· it isnecessary tc replace cne line by more than ere lino.
11£.U.9.Ug.§:
l~FUl:

indicates that tho Scrirt Input envircnrrcnt haE
It will be given bhcncver tho REPLACE cequcst is
without an orerand. The keytcard uill ~c unlcckcd toany 11u~ber cf lite~ tc te inserted in lhe file in pl&ce oflhiE resrcnGel<~ner.tere~.

iEsucd~llov

the current line.

c~r
1hE current line will te erased~ill

be ent€red
its flace.

~nd

to allow any number

the Script Infut environnent
cf lines to beinserted in05/01/69

SCElPl
SEEK

3,1.13-28

05/01/69

SCDWT.J~"/ftJ:-1,1.13-27.>Jrp:·

lequest

ihesE

line~

wculd be Ekiffcd:/£?

of the Moen •
west, young can.

~Est

.BJHsg:~hE SEEK

request ndvatcEE the current line pointer to the line
\hcse leading characters are sfecified by the operand, er tc
End-cf-file if nc :atching line is found.

(Upper case11

\l 0 )(Urong ccluuns)

t.
Seek
west
1his request would se~rch fer a line vbose first eight characters
were 11west". !be la~t line of the previous exanple would
become the current llne, if it were iu tle file.

l.Q. U~.!:- -- --

I

SEH

strinq I.
I

str,ing

is-any number cf leading charactersfcoh the line tc Yhich the pcinteris to· be advanced.

sJl~~.9.£;

Staiting with the line fcllc\ing the ccrrcnt line, the leading
characters of each line are ccupared tc the specified string. The
ccnfatiEcn is colunn-defendent; the character following the firsttlank after the request wcrds will tE cc,~ared to the firstcharactEr of the line, and ~c en. DlaDks aro siqnificant, andmust be included. The first line vhose leading characters tatch
thE s~ecified charactEts beccees the cutI~nt line.
],g,! J:ill!.i?_g J.i. :a.

ECF 11EHliH.
~o ~atchjng line was f cund.
la~tlin€ of the file.

lhe~ointeris positioned after the

lli!:.P..li..§:a.

SFEK 1112.stEeginning with the line fcllcwing the current liner the first
tour ~haracl€ts cf each line are ccm1ared to the characters""est". ihe following line wculd teco111e thE current line, if it
WEte lr the file belo• the current line.
W€Stof the Hcncncgahela.

~A' 111111\iii.11

ill$$lll,!!!!~'•'i!!ii!li!l!!!Af,!!.;a;;11;;;•1!L@lllH .. i.12,..:;.:: ...... u: a ... , ..: .... ,..4 ......we ... ,......... ;:;....... ii'!li!F ..... .:....

:;.;:... ·· .. Mi'!!lj!!iii1!!!! ··'· ,........

.......

... !E!!!!" .. !!' ..........

··"··* """"""""'"""!!'~"'T·''"· *"''....... "'"'"""'·" '·"'· """ ,,•·•1""'9'·· ·t '"f ~~;;

"'~

SCliIPT·
TOP !! Eq uesti~

05/01/69
3.1.13-29/.£\? la,'//{P'l/,

05/0l/6<l

SCBlPT

3.l.l"'-30t1)· 1t~Z

J2.I1gL1d!I.£_\!Jl.!!.J.[~:

TOP places the pointer at the blank line FCeccding the first line
cf the file. •Many of the Script Print C(ntrol words iffcct paraeeters cf thepafer laycut.
The dia9taa belcv indicates certain of theimpcttant ~a fer layout par~metecs: PAGE LENGTH (PL), TOP nARGIN(TM), DOTTOl1 f.ARGIN (EM), HEACING
l1AllGH (UP.), LlllE LENGTU (LL),and Hi.:Ef.T(IN).

l.2.!Jt~.1 :'.IO p· TCE may te issued at an~ ti"e tc place the pointer in front of
the first line of the file. It allcwE recursive passes to be~ade t~rcugh a file with a single SCEIPl EtIT cosrnand.
No_t~:,---------·----------I
I

headiing()J4-----··---------

I--·-------

t
I

I
I

I

P.ftG lI

·I

The ~lank line that becomcn the current line after ~ TOP request
is aJw~ys present in tha Scri~t Edit environment. If replac~d ordeleted, another blank line is supplied. It allous additicns tc
he ~adc at the top of the file.
~~1J,E.§:a.
TCP~he ~urrEnt line FCinterfirst line of the file.

fb~sical

Lccaticn cf Jett-handI

Jis a,9,g:

i~ noved to a iosition in

front of the

I

I
I
I
I
I
J
I
·t
TEXT ·
I
I
I
I
I
I
I
I
I
I
I
1
I
II
~--------,
II
.,
1
I
I
It ______ ._..,. _______ .:_ ___ II

I IN I
1 <----1
I
I

I

•
I

·I<-------·-------> I
I

LL

J

margin

A A
1 I

__ I
II

I
I
HM VV'H! I
I

•I
I

I
t
I
I
I

I
I
I
--- I
A I
Bf'l I I
I I
I J___ v_v

PL

A HEl;t

Cootrcl/t3

1he APFENn control· word allcws ananended to the file ju_st printed.

additional SCRIPT file

[·M

1/l

l.Y.!H~.f·:DOlTC~ ~AbGIN

1he

to be

control wcrd

s~ecifiEs

the nuoher

of lines tc

1E skif~Ed at the bcttc1 cf cutfut pageE, overriding the standard
value cf three.

1£.!.!U!.!:.AP

3.1.13-32

MA6GIN Coutrcl

BC~TO~;~Xt

PUJ;..£f.f~:

05/01/69

SCBlP'I

05/01/69
3.1.13-31

SCBlPT

l.9U2!:

filena11e

.BM

I
I n
J

filenuespecifiES the DdUC of the SCBIPTnfile tc te apfendcd to tte filespecifies the nunbec cf lines to teskipped at the tcttoa of output fages.
Ii cttitted, 1 is assuDed.

which 'has just been printed.
Jl§.l!B.§:.Y!lil.!J£.l.
~hen the .AF control word is enccuntered the current file will beclosed, and the s~ecified SCRIP~ file will te printed as a
ccntinuaticn of the SCBlPl EBINT output frcn the Frevious file.

lhis ccritrol overrides the standard hctto~ vargin size cf threelinEs, ard need not be in~luded in the file if that value issatiEfactcry. It may te includEd anyuhEre in the file, and thenest recEnt value set a~Ilie~·cn any page.

ll~.!§:."i:

JiJ;J_g:
e. !he .AP ccntrcl wctd cnly allobs files to be appended to theend of the current file.
If it is desired to insert fileintc the printout of tho current file, -u;e-the .111
ccntrol wcrd.

c'cntrnts~heE01TCl~~~GINcentral weed alsc acts as a BREAK.

E X.<:!E.El.§§:.tMLf:].£.§:

a.
.J.f
AEC
'lhe ccr.tentE
fcllcwing the.AF teguest.

a.
• EM 10
7en lines will be left blank at the bottoc ofif pcsEil:le,· and on all subsequent pages.

ot SCRIFl file AEC will be typed i1nediately
last line cf tbe current tile which precedes thethe current page,~-..
~JSZlllJI! .!.Zii!i!C',tw•wa:faiiHM!£!)~~,ii!i·M%.Af~ ·.~,,+;:""·:,!: 4 !' FURi.i@!¥L·:·q;g;&.·#-'.E@?"·¥@£.@¥1:¥iU4iiM!¥M!lJili#? 3 ;µ;; '~#';::;;u?'!f"''~· " iiiiiihi

ii.M

-;.

n
-

!ifi!

-"""'1

"

r

,.,.

"V

"

~

""
SCRIPT~·

05/01/69

EliHK Ccr:tccl</.//l,1/ff;<Y

CCNCAT!NATE is in effect, DEEAK causes the freviouE lino tole typEd \itlcut filling in ~crds froo the next line.

Forga t:line following thetetween the nargins.

'.Ihe

word

will, tecentered.CE-- - - Us~_g_g:!l.§ll..9.£ :ff<EA¥ is used to prevent concatanaticn cf lines such as faragrar-h
teadin9s er the last line cf. a paragraph.
It causes therreceding line to be typed as a short line, if it is shorter thanthe current Jir.e len~tb.

~he linetc be c~nteted~ENTEB central word.
Iti~entered on the line followinq the·starts at the left ~atgin, and leadinq
er trailing tlanks will be ccnsidesed part of its length.

.!i.9.!£.§:Ji..£!!!.§ :M'any of the other ccntrcl uords hav« the effect
EREAK is necessary ~hen cue cf these is present.

of a BEEllK.

l leading tlank or tab en a line has the effect of a BBEAK.

~eading:~irst line

,he CENTER control acts as a BEEAK.

t. If the line to te centered eJcecdi the current
value, it is truncated.

a.
of the para~raph • • •ihis pait cf a file will he printed by SCRIPT PRINT as:

heading:First line of the paragraph •If thea.

line lEngthl~.$!.JU.!g:

EX,!!li.J.roi:a.

C!NUB central

l.HJIJfil:

• Ell

t.

t7?/{li..Y!.£.9£.!E:

~hen

~c

3.l.13-311

CENTEE Control/!I'

fJ1.I.£gg_;_a.

05/01/69

SCBIPt3.1.13-33

B~EAK

Reading:

ccntrcl \Ctd \ere net

included~First line of the paragtaih •it would be typed:.CE
Other Methods

this line of the file is typed, the characters!ethods" will be centeted tet~een the margins.

~hen"OtherSCfilF'l.

OS/Ol/G9
3.1.13-35

/Jtz
It/

CCMM.H'l Ccntrcl

05/01/G':I

SCEIPT

3.1.13-36.r;:-Y It.I'

CthCA'lEhA'lE Ccntrcl!.Y.!I.Qg:
i.YJ;.I.f..§§:

7he CCHHENT control ~crd causes the r~oainder cf the line to beignorEd allowing ccnaent~ tc be stored ~ithin the SCRIPT file.

CONCAIENA1E cancels a ftevicus 10 COUCATENATE central word,causinq output lines tc te formed by ccncatenating input lines
and tLuncating at the nearest uord to tie specified line lEnqth •.Ifiltrat:

1.9.Lu!:.CM

I

COlllilents.coUsas._g:].§E_q_g:

ccntrcl word allc~s coo~ents tc be stored in the SCRIPT
fer future reference.
These co11 aents canbe seenwhen
Editin~the file in SCBIPT EDIT or ~rinting the file under
UHOIHIAT mode.

1he .Cllfile

1he CONCA1ENATE contrcl specifies that cutrut lines ace to be
termed by shifting vcrds tc oc tron tte next inrut line. The
tEsulting line will be aE clcse to the specified line length as~os~ible uithout e~ceeding it er Sflittir.q a ~crd, this rcsorrhles~crual ty~i~t
output ct the M1/S!.
lhis is the normal code ofcperation fer tho SCBlET fDINT con~ocd, COUCAlEHATE is only
included le cancel a ttevicrs VO CCUCATEiATE control word.

7he cc1cents may alsc te used to state unique identifications
that can te useful whet attenfting to lccate a specific region of
the tile during editinq.

lll!E.J?le:J.!.£.t~.§:a.
.CMReme~ter to chan9e the date.
1He line ahcve will be seen when examining a unfcr~atted listing
cf the SCEIET file and reaind the user tc update the date used ina.

lhis control acts as a

ERE~K.

the text.
1.!~~.~l..£:a.
.co
Cutfut frcn this point on in the file uill be for~ed to approach
the right margin without exceeding it.

.

~

~.

11
••

ii

.. I f'l!lll!'if¥oli!!!!!.. 41iii.ffiiiii!ii!'!jljjiiiiffl!'ii,iill!iiilll!Miil!H,!i.iiffi!P,i.iiii ii,ifil!l!l!liij$ii!iil!iill!l!NllP*",.ijliif!I. M..i@l!l41,N\Miiii¥11i!l''"""'1¥1ii¥iil!llM11Pii1Pi,~:!lliiilhi!l'!'jiQlllllii

iiiii.11"''·** l!llP ifl!lii'il M!,,l!llW.
~

iil!lliiliil!!Oilifl

11.'i!f.

i.I

1"1*"4' ,,

-

,..

~

SCBII.1'r
CC~Dl11CNIL

E~GE

Ccbtiol~·

05/U.l/69
3,.1,)::l-37

SC Ji.IF'r~~~//f,j//6 j'

05/01/69::\. 1., ::1- 38
i"i:f~

tCUfLE SFACE Ccntrol//r:~

f..YH.Q.§.£:
b!U.f!_§_g:

1be CC~Dl1ICNAL FAGE ccntlcl ~crd causEs a page eject tri cccur if
less than the specified nuaheI of line~ ce~ain on the currant~age.

H.!l!i!J:

1he tOUELE SPACE ccntcol \Ctd causes a line to be skipped tctueeneach line cf typed output.
!.£H!!.t:

-:
.Cf

n

I
I
I

r.

I

. I

• r:s

I

the numbec cf linesthat rru~t rereain on the curccnt
rage fer additicnal lines tc beprinted cu it.

~pecifiesl!§J!.9 _g_;,·DOUBLE SEA<:E tray he included a11y1ihe-.:e in the file to force doutle
Efaced output.

].§]_gf:]ot~:

1he .CP ccntrcl uord ~ill cause a page eject to occur if "n"lineo de net renain on the current page. lhis request is
esreciolly meaningful (1) befcre an .SP control word to guaranteethat sufficient s~ace remains en the current page for the number
cf EfdCCS raquestad alcng uith any titles, and(2) pcccceding asection beading tc elininate the po!sibility of a heading
cccurring as the last line cf a Fage.

1his ccnttol

It nc CfEtand is f~ecified with .CV 1cquest, the request uill
l:e ig.ricced.

a.

J~~J!..El§:a.
• Cl? 10
If lcsE than 10 lines reaain on the cuttcnt page, an e1ect willte i~sucd before printout ccntinues. If 10 er ~ere lines remain,
ftintout ~ill ccctcinue en the current page.

bas the effect cf a BREAK.

l.Hl!.tl!l :a.
Ji.Q!~:~ord.rs

Elank ~ines will be inserted
feint in the file.

between cutfut

lines belcv

thisSCDlP'I

l'GRHll'I Control

05/01/69
3.l.13-39

SCDll!'I

tX:;(

05/01/69
3.1.13-4(.t1LD.£1..Lt£://7;;·;//?;• FC
Cutfut teen this feint en in the file Yill bean c~en tight ~argin en the cutput page.

17L

a.

.1YU£££:
FOB~IT central word cancEls a trevious UC FOflMAT conttol wcrd
(Ct
NC CCNC;~EN1.TE and/or bO JUSTIFY control Wctd), causing
concatenation and right j~stification of output lines to resuwe.

'lhepadded to prcduce

l.2.Ill..!:

.n
or

• .FC

.Y.§~.9..§:central Yctd is a short-hand way tc sfecify the t~o
COl!CA'll!Nl\'IE and JUSTIFl'.. 'l'his control spocifics
that lines ate to he forced by shifting ~o~dE to or fro~ the noxtline~ (ccncalenate) and then Faddad~ith extra tlanks to produce
an even riqht margin 'justify).
This is the norcal mode of
cpcration foe the SC6lf1 FLIUT coc~and, FORMAT is only included
to cancel a frevious ~c FOEHA1 ccntrol ~crd.

'lhe FCEMA'I

central 111crds:

J!QJ.§.§:

a.

1his ccntrcl acts as a ESEAK.

b.

If a line without anj bldnks exceeds the current line length,.it is titncated.

c. •

The

.FI

CCl~atibilitj

ftovided ferform of the
ccntrol word iswith cld SCEIEl file and ihould not be used in new

files.

-'~Iii J!IQll!Siiilii!idCf 11111::i1 1111!flii!\l~liiliil!!lllffl. !iijli4ii."i''"*UIWiiJWM!U41i#i!W4UMl!ii!iijiiDiiiUM

a !!#SA uewaa;::a 4201:;•~"'=+=• .ea:ae 5421

IWI a. I i iiiUSI SJC#Wiilii 2.£ $b.liii4$111WMIUIQZit4

£.$

I ;a.

111•• I llS II U:llllllllllllill'

,~·

"'

""'
SClllP.T

llEADil>G Ccntrcl

05/01/69
3. l .13-111

SCB lPT

4-Y

/'7
/3

.F.!!.!Hg':

t.

.be

IV/'7!.'

CHS

heading line to be typed at
CHS

Ifil~:

.HE

line

..

-:

line

SFecifies the heading to beprinted at the tc~ cf
subsEquent ~ages:

Usa g3:All .of the line fcllo~dng the first •t:lank after the llEADING
ccntcal ~crd is printed at tho t~p cf rnges started after thecentral ~crd is encountered. Ne heading is typed au the first
Fagc oi an output file. The beading is tyred at the left warqin.
lts lcn~tt oust be at least 10 less than the output line lenqth,
to allc~ for a paqe nu0ber at tLe eight uargin. Leading blanks
nay be uEed tc center the heading. The heading is typed in thelin~.q;ecifi<'d byth~hci'lding n:ir<)in nrid
top roargin contt:ol\Ords.
Additional .HE ccntrcl uou1s uay be incJ.udecl at any i;ointin the file to change the heading ~" subfequcnt pages.

J!.QJ.Q:a D€W heading is to te i:laced an a page fcrced with the PAGE
ccqttal weed, the HEAClNG central nust ftecede the PAGE central.

lf

EXJ!J.i:f1f3:

a.
.EE CAMBRIDGE ~G~ITCE SYSTEM
1he characters "CAMBnIDGE ~ONITCR SYSTEl" will be typed at theleft in the second-last line cf the to~ marqin en all faqes
Etartcd after thiE FOint in the file:

CAMDTIIDCE MCHITOR S151EM

l?AGB 73.1.13-42

1he leudin9 blanks dtc considered rart of the headinq,
characters "CMS" will te cEntercd in the heading line:&

1he ~EADIUG central uctd Sfecifies athe tOF cf suhseguent outFut fages.

05/01/69

EAGE 8SC

the

SCBIPT

SCllIPT
05/01/69

MARGIN Central

HlAtl~G

3.l.13-ti3/Jf/-e.?
//(;-·_r_y_Lpgg:

05/Ql/l-;-O

3 .1.13-44

llHH Ccnttcl/;y/_.,//""'/,'.-,£..\1.!.f.Q..§£:

1he HEACING MABGIN control ~crd SfECifies the nunb~r of lines tolE skiFfEd between the beading and the first line of text
eicluding fcrced spaced (lOF tABGlN), ove£riding the standard
value cf cne.

~he

IMBkC central

vcrd

is usedto insert

theccntents ofaspECifiEd tile j.ntc .the p:intcut of auotbec SCRIPT file.

1.QJ;.!!J!.!:

1£1.!!!E.1=

I

• H~

n

I
. I

.. IH

filenaae

filenamesrecifies the file to hecurrently fcrmatted into
the pcintcut. A filetypeof SCHIEi is assuned.

II

specifies the nuaber cf lines tc be!kipFed aft~r the heading line.

]Sa..9.~..i.Yfill..S.f:

1he heading line vill te. Flaced a spEcif icd nuuber of lines above
the top 1urGin. If oc BEACING MABGifi control Yord is included in
the file, the default value is one ..
1he BEADl~GiCF eAFGIN.

~ARGIN

specified must always te less than the current

1he .IM and .AP control ~crds perforn siuilar functicnE, tut .IM
allc~s tt€
ccitents cf a Eecond file to be inserted into the~rintcut cf anexisting file rather tha~ ap~ended to the e~1 ofit. l~todded files Bay sfecif y additional i~beddinq to a depth ofseven levels. l~hedding cay te used tc iusert standard sctfi ofcentral weeds at desired sfcts in a· file as well as many otherLses •.fu.:!£l:

Ex.Enls:

1his central~ord

acts as a fREAK ..

.IM C~AP4
ihE contents of the SCRIP! file·~"'~hose filename is
CHAP4 vill teinEorted in the printcut cf the current scnrPT file,. when the end
cf the C~AP4 file is reached, printcut cf the current file uill

!H.r:.EJj;:

I€suie.

a.
.EM 3
Ihree lines will be left tEtvEen the headinq line and the firstline of text.. If default tcp margin cf ~ i~ in effect, thetepding will cccut one line ftoa the tof cf paper followed bythree ioce blank lines (the beading margin) and then the text.

•ti.

.. Hl'I

1

1he standard headin3 1ar9in ct one is set.

""

"1 \ ·. 1111111; Mill 4 M it4Mt.IHL4AUJL&Ui2222 U :CL .£

-.
:

Ii :s

ll.!.f.L.tl£.:"!.§il.5J.§.§:•.

E jCCC24)
MCRE lHAN EIGH1 ACTIVE FILES - EEDUCE NESllttG.
More than seven files have teen ivboddcd in tho SCRIFT file being
fiinted. Only ~igbt files may te opEn in CttS at cnce. All open
Liles will te clcsed, and the SCRIEl FfiINT command will teterminated.

~"
SCilIP7
INJ::EN'l Central

A'f0

//7

1he INDENT ccntrol ~crd
ftintout to be indented.

allotis theleft. sideof theSCRIPT

lH.!Ul.!:

'.lN

n

I

n

Sfccities the nuotEr of spaces te beindented. If cnitted,indcntaticn will
tcverl to the original oargin •.!!Ei!..9.£:

cct:trcl \iord causes SCiiil?'I i;rirtout to be idcntcd "n"free the current left Dargin setting.
This indentation
reDa1ns in effect fer all
follouing lines, including neu
raragrarhs and pages,
until another .IN ccnt~ol
ucrd is<:ncountored. ".IN C11 tiill cancel the iodcntuti.on, . and printout
will ccntinue at the criginal left cargiv scttinq.
'lhc .IU
s~ac~s

1!521£..§:

The .IN request acts as a BREAK.

t. 'lhe .IN request will reset the effective left narqio. causing
any .Of ~ettinq to be cleared. The .OP xequest nay be UEed alone
er in ccnjuccticn ~itb .IN.
Uhcn the latter is the case, .IN~ettin~s ~ill take prEcedenco.
!HEJLl.§§:

a.
.IN 5
All lines rrinted after this request will be ideuted 5 spaces
frcm tha curre~t left nar~in setting.
This indentaticn will
ccntinue until ancther .IN ccntrcl ~crd is encountered.

/ lf" a-·'./J

sea JP'l

05/01/69
3.1.13-45.f.YJJ20S€:

a.

~·

~

t.

1hE

.IH 0

e1fEctof anycuttent

indentation

05/01/69
3.1.13-'•6

vill becanceled~rintout ~ill continue at the criginal left nargin setting.

andSCB lP'X
05/01/69
3.1.13-47

JUS'UH Central,/.X.;/SCRIP'i:~· _."f'· ".",,...-

,~(

/'/J

.f.!LU..Qg:

JUSTIFY control ~ora cancEls a pre~ious NO JUSTIFY control\otd (er part cf a NC PODMAT contrpl word), causinq rightjustificaticn of outfut lines to resuGe.

7he lI~F LENGTh central ~crd specific3 a line length
CYErtide the standard JiEe length of 60 characters.

that is to

1:.2!1'@!:l.21.J!!.fil:!

.LL

.JU

Jl

Q.§1!£.§:

ccntrol word specities that lines are to be justified byfadding ~ith extra tlatks. If concatenate raode is in effect, theconcatenaticn frocess occurs betore justification. This is thencrreal Dede cf Cfetaticn foI the SCRIPT IFIN? CODDnnd, JUSTIFY iscnl~ included to cancel a previous NO JUSTIFY control word or tho
to JOS1IF~ part of a ~c FC6NA1 ccntrcl ~crd.

~hisl!.£!~.2:nEfecifies cutfut line length net
greater tbdn 120 characters.

.!!ll~.5.1.'i:'Ihe lIH LEHG'lll ccntlcl ::ets the length for output lines until
the next
I.U-E LI;;t:GTB ccntrcl ucrd i:: c1countcret1. .If DO LI11E
LENG1H ccnt1ol is includ~d in a file, the standard line length of

6C charactors is used.

ln the JUS11FY/NC CCNC11E~i1E code, linaE shorter
length a[e jYstified tc length b~ blank fadding.

a.

1his central acts as a E6EhK.

t.

If

a liteexceed£ the1cde is net in effect,t~ecurre~tlinE lengthi~ frinted as is.

and concatenate

lina

c. This ccutrol wotd is seldom used without concatenate mode,
therefcre. FCR~AT should be used to entet justifJ and concatenate_. 1 cde.

a.
.JO
Output frcn this Feint on in the file will be padded tc produce
a~e,enright aarqin on the cutfut pa~E as lon9 as the iDFUt
length~linel!.9.t~:ccntt~lacts as a DRliAR.

l.!.Ml!l.~ :a.

. l l 50

~uccGeding

~

than

ln the COUCATENATE mode, lines longet than lioe length are
Sfilled intc the tcllc~ing line.
Line~ shorter getuords froa
frevious er follc~in~ lines tc approach line lenqth.

thislll!!.I1£: .

linoa de not eJceed tbe liDe

~_-,

/Jt'1
.HLU.9.M:~he~"5/01/69
3.1.13-48

LlllE l.EIW'J:JI Ccvtr<:llin~auill he n<: acre than SC characters tn length.

~~

tlf't\~

05/01/69

SCBlPT

SCRlP'l3;1.13-49

hC CONCA!fNATE Control&:tt

NC FOFMAl Ccnttcl

ltf/

1be
the

~O CONCAtENATEn~xt line.

/!{;;:·(. lfoL.f.Y.!.E9.§.§:

1..!:!.U:gQ:

ccntrcl stops~otds

troM shifting~oor from

the NO fORMAT control stops the CONC~1ENATE and •JUST!~Y code,causing lines tc be tyfed jtst as theJ afpear in the file.

l.9.!JHt! : 'I.2.!.!~.! :

• NC

.NF

~~=

05/01/69
3.1.13-50

I•·1

Usl'l~:!he io CO~CA7ENATE ccnttol vcrd stofs MCrds froo shifting to andfrom the nelt line. There is a onc-to-cr.e correspondence tetuecn
the words on the input lines and output lines. It is useful for
sections cf files ccntaining tabular infcrnation or other special
for~ats.

NC fCR~AT control is a shcrt-hand tiay to specify the tvc
ccntrcl weeds:
NO COtiCAIENA1E and NO JUSTIFY. This stops line
justificaticn and concatenation until ~ FORMAT, JUSTIFY, or
CCNCATFNAtE control wcrd is encounterEd.
It is useful forfactions of files containing tabular infcrnaticn OE ether special~hetcr~ats.
]ot_~:

J..9.J§§:a.

1h1s ccntrcl acts as a B6EAK.
a.

1his central acts as a BBEAK.

! ..Hl.m.£1.£:
J!U..E.1ii :.NC
Concat€nat c~ ~ill be ccm1leted fer the preceding line er lines,
tut fcllcw ng lines kill bE typed .withcut words being moved toar.d f,rc11 l ne~.

a.

•

I

a.

.NF

Justification and concatenation vill
be conpleted tot theF,receding line er lines, but followirg lines will J:e typed
Exac~ly as tley a~~eat in the file.

SCIUP7~c

JU~7IPYSCBIP'X

05/01/69
3.1.13-51

central05/01/69
3.l.J.3-52/;;;:"-:~~?

OHSE'I control.

/ft';fi

/f~:/

i.l:J
i.Y!..1:£.§§:

iJ!J;.rs££:'7he NO JVS1IFY ccnticl ~tops padding
justification of output lines.

lines

to

cause

7he OFFSET control uord Frcvides
tut the fitst line of a secticn.

rightlfil.!1!~!:

a tecbnique forindenting all

lfil..!!!~.!=

I• !iJ I

.OP

n

I

n

US_5!..!1.§:

1hc HO JCSTIFY central weed steps the blank padding of lines. If
cede is in effect, lines will be formed that approachthe curt€Dt line length but will not be forced to the exact
length. The resulting lines resenhle the output usually Froduced
ty a tyFist er a M~/S7 (Magnetic 1ape/Selectric Typeuriter).

ccnc~ter.ate

Jl§_g_g_g:

1he .OF central ~ord oay he used to indent the left side cf therrint~ut.
It's effect dccs net take Flacc until after next line
is Ftinted, and the indentation uill r~~ain in effect until a
tceak er untjl ancthoi .OF ccntrcl vocd is encountered.

Ji.Q..t~.§:a.

specifics the nuabet cf sraces to beindented after the Dext line is Ftinted.
lf emitted, indentation ~ill rewcrt tc
the original 1a19in setting.

1his control acts as a BEEAK.
1he .OF ccntrcl may be used within a section which is also
indented Mith the .IN control. Note that .IN settings take
FCECEdcnce ever .o~, hcbe~ct. and any .IN request will cause a
Ftevicus offset to te cleared.

l.!.i!Hl.£:a.
.~J
Justification will be cca~letcd fer the preceding line or lines,
tut fcllcwing lines will ~E typed witbcut additional blanks
insectEd to ~ad the line.

If it is desired to start a nev section vith the same cffs~t asthe pLEvicu& secticn; it is necessar) to repeat the ".OF n"request.
1.2.t~.§:

a.

1his ccnttol acts as a BEE>.K.

l. 'Iwo CHSET ccntrcl 'liotds •ithcut
ccnsideted an Ettor ccnditicn.

,,..
1 1
' m•

J.111 il!lil 9AU1ill\&lii&itijQlil22

an intervening text line is~~U&!i22S221UJ!llEilLU£JIL . . . ","·"''"'rn''"''""''.,,,...,,.,,,

t11iii1:1:,,1,11.1.

11,.1i1&1:11

1w

m

.11

'"

•

, ... .,..,,.....,,,••.,,,...."

··~--

!"".

""'
SCI! IP'l~11..1'1!1§~

05/01/69
3 .1. 13-.5 3(f')'Jf:?•/?.-i.OF 1C
line in~ediately follcwing the .OF ccnt~cl word hill be~rinted at the curcont left
nargin. All lines thereafter (until
the next treak or .OP request)
wi11 he indented 10 spaces fcora
the cuirent ~a1gin set~ing.

a.
,he

'~

SCEJPT

05/01/69
3.1.13-54

A.I? .

PAGE Ccnttol/,?1:

J'..!:JJ;_pbsE:

EAGE causes the cutput fern to be ad~anced to the next paqe.
l.Q.!.EJLt :b.
.CF
1he effect of any previcu~ .er reguest ~ill be canceled, and all
rrintcut after the next line uill coutinue at tho current left
2arsin setting.

n

.FA

I

n

the fagE ouuber of thenext page. if "n" is not speciiied,sequential fage numbering is assureed.
~pecifies

Us_g,g~:ucrd is enccuntetEd, the rest cf theihe Fape~ is advenced to the next page,
the heading and page nurntet are typed, and cutrut resu~es ¥iththe line fellowing the PAGE central kord. If STOP was specified•ith the SCRIPT PilINt co~mand, a carriage return tust be ent~ted
when tl1e l:cttcm of the page is reachod ..

~henever afAGE control
curr~nt fage is skifped.

Jl.Q.!.£§:

a.

1his c~ntrol acts as a BBEAK.

t. If the heading, lJne length, or ether foraat pararaetecs ace
to be differ~nt on the nck fagE, tbe afpro~riate ccntrcl ~ordsrust afpEar before the PAGE ccntrol •ord.

1.HUl.§:a.
.EA
1he rest cf the cur~ent fagE will be skiFped. The heading andrage nuater will be ty~ed in the top aargin of the next ~age, andcutrvt •ill resume.

SCBlPT

05/01/69
3.l.13-55t.
.PA 5;f:f:{?./d7
regardless of the nunter of the current page, the rest of that
Fage will te skipped, the beading ~nd ~a~e nu~ber 5 ~ill be tyrcd
in the tc~ matgin of the next page, and cutput Yill resuue.

05/01/69
3.1.13-56

SClllI?TPAGE LENGlh Ccnttol

/lfff
;J·s

i ..'l.!P.Q§,£:lhe fAGB LENGTH control tiCtd specifies the length cf out~ut pages
in lines. 7be value E~ecified ovexrides the standard page length
cf 66 l~nes.
l.Q.f.m.E!:

DJ- - - - -.:.··.-

n

.
I

• Et

Epecifies the length of output
pages in lines.

].§j!_q~:

PAGB LENGTil contiol ~crd allows varying paper sizes to be
used fer cutfut. If no EAGE LEUGTH control word is included in afile, 66 is the default 1alue. This is the correct size of~tandard typeuriter
paper fer teroinals typing eight lines fer
inch. Page length nay te cbanged anywber~ io a file, with thechange effective on the first page stact~d after the ccntcol vord
is enccuntered •~he.!.2.!~=

1his ccntrol~ord

acts as a fREAK •.lUM.l.fi:a.

.PL 51

Fa9e length is set tc 51 lines. This
terGinal typing six lines fer inch.

,,,,.
= '1111111

Ill

ii

llli\ll,ii!i\.i!IJiliJ!MliiM.iUIU .........EL$

0 .. Li. ..... !.

--.. . !....... ).. JJ J

is the correct

size for•!

,.J .Jl.

i.l 4 ""f¥£4WA *·,.,,,.111.w1•w•••lllAl4l!"IW"'w"••""'-',, ... ··"· ..,. ,ii!!111.1. .

"'

~·

"""'
SCBin·
05/01/69

PAGE ia!EEll Centro!

3.1.13-57,u,.-,,,;''.'/
rro,.,,,,..

1JJ

i.YJ;..E:.Qg:

1he PA~E
extern~l

NUMBER control wcrd allcus tbe user to control bothand internal fage nu~hering of ~he file being printed.

l.9!H!:• Pllh.
EAG! CPFNC
Ne fage nucbecs vill aFpea1 on SCBIP2 PDIUT
internal fage count tiill cemain at its current
teins further incienented.

OPP
OEFNC

--- ~

·SUHtes::es external .i;:age nunberinq,

although internal
will continue.

Fu~enunlering

CH.NO

SUFpresses tcth external and internal
page numhericg.

CN

causes external page nucbering tc be
resul'lcd.

]lH!.9.!l:.PN is used to contrcl the Eage numterirg feature of the system.
if the OFF Cferand is s~ecified, rage nunbecing will discontinued
en t~e fiintout, although the page nuaters vill ccntinue to be
incrEmented internally. The OPFNO operand uill also discontinue
fage ~umteriog on the printcut and will cause the paqe nuubors
net tc tc inccevented internally. When the ON operand iss~ecificdr page nuobering will resume frcn the last intcinal pagenu~t€r.

EXj!Hle:a.
page off
nc furthet fage nunhers \ill appear en SCRIPl PRINT output~
although the ittecnal Eage ccunt will ccntinue to be incremented
for e~ch page printed.

output andthesetting withoutc.
PAGI ONlage nucbering on SCBlET ~51NT output ·will resume usiDg thecurrent lnternal rage ccunt, and this ccunt uill be increcented
for each fage printed.

ON

CFF

05/01/69
3.1.13-58

SCfllH;.·:.-/£-';:}"'

15~;

05/01/69

scun

3.1.l~-59

SCBIPTg;!"lt ·/fl

BUI: Ccntrol

SFACf!.Y.!..EQg:

os101/u9
3.1.13-60

CcDtrclg;p/f2_.f..Y.t.E.9.§§:3he READ Ccntrcl uord allous the usertEr~inal durin9 SCRIP~ PRINT output.

to enter a line.

from the~he
SFACE ccntrol vord 9eneratEs
linEs tetore the next tyEed line.

l..2.!.!..!!.l:a spEcified

DUDber of

blank.l.QJ;U.!:

.liD

D

• SP

specifies the nuaber cf lines t~ beread at the terminal. ·1t omitted,
1 is assut1ed ..

lln!!~.s~:

nI

specifies the nuater of blank lines
to be inserted in the-output. 2if
cmitted,-1 is assumed.

!!.§1!..~:~her. the .RV control word is encountered during SCRIPT PRINT
cutput tc the terminal, it will act as a EREAK, spin the typehead several times, and unlock the keytcard for a line cf input.
'Ihe lir.e entered is igncred by the Ftcgra11 and no forciatting
cccurs en it. This facility is useful for adding headings toform letters, etc.

As wany .RD•s may be usEd as desired;separate line accepted at the terminal.

each will

result in'lhe. SPACE ccntrol ~ctd say be used any~here in the file togenerate blank linos. Jf Fage end is reached during a SPACE
operation, reiaining blank line~ are inserted after the headingen the f cllowing page.· If tOUBLE S~AC~ is in effect, tvico asuany blank lines are gen~cated as specified.
0allQ.!£:

1his ccntrol acts as a BBEAR.
J!.fte_§:'l·nr:~.qnttol
wcrd actE.-:;! ;. .
·~ ,~).U~U~§:aE

a ERBAK.

'':·. ·./
.En.r.El!l:a.
• SE 3'lhree l:la11k lines aretyi:ed line.

.

a.

• lit
.
this ccDttcl word is enccuntered during SCBIP7 PRINT output,
the tyfE ~ead will rctate and the keybcard vill be unlocked toallcv cne iine to he typed at the tecminal.

t.

~hen

inserted in

the outi;ut · before the

next

.sp

A single blank line if inserted in the cutrut.

,l).'

_.,

"'1A
~

iiiiiiH... """"; "'~"'"'··¥*'''"·''~'"'*'''.Jb,,A . ;m. ,,9.A~Wi!G,),,l,,;,;su:a;a;;aa..z;.www:;.w42w

ffii,liiH&iim, .~M'~i\~d!?Y!i.i!iU!t. -,,~;,;;:;;;:;;; 4 • , , .

4~I·~~~-·~,.f,fi,.4biiiMi#l%W!liM'!fiTHliP;;p;

ijfjF;fi.M\,,"'iii·!h"'""fiH!?!fil i,.fi,!!f!I"ii',"'

i,,.,Hii\,-Uli,,¥

,''!'

~

t'

"
SCJilP'I

SINGLE SPACE Ccntrol·'

05/01/69
3.1.13-61~~/

SCH JPT

05/01/69
TAE SE17ING

3.1.13-62

Cc~trol'/',..:'-f/

if3p;,-/,1/!ff'

l...!l.U.2§.§:.f!!..!J!.Qfil,:

1he SINGLE SPACE control word cancEls a previcus DOUBlE SPACE
conttol ~ccd, and causes cutput tc be single-spaced.
l.Q!J! at:1he 1AB SE11ING contcol vo~d specifies the tab stoFs to teassumEd tor the fcllctiing lines \hen conterting the ~AB character
intc the apptop%iate numbe~ of SfaCes.
l.9.!!2.!:

.SS

.TB

.l!.22~:n 1(i)

Cutput following the SINGLE SPACE centre! word is single-spaced.
Sine• this is the ncr1al cut~ut foreat, SINGLE SPACE is only
includEd in a'file tc cancel a ~revicus DOOBLE SPACE control
'ord.

.•

n(1)

11(2)1

nlJ)

n(4)

n(5)

I
t
I

specifies the ccluun lccation of the(i)th tab stop, the sequence must
ccnsist of strictly monotonicallyincreasing ECsiti1e values sefarated
by one or oore sEaces.

.Y.§2..9~:J!Qll:

1his ccnttol uord acts as a BBEhK.
.l!~M.a=a.

iAB characters entered intc the file duriDg SCRIPT EDIT filecreaticn are expanded ty SCBIET PBINT itto cne or Jore blanks tosimulate the affect of a lcgical tat spot. The TAB SE11IHG
ccntrcl word specifies the lccaticns cf the logical tab stops,
this overtides the defult tab stops of 5, 10, 15, 10, 15, 30, 35,
~O,

.ss

single-spacing will resume belov this pcint in the file.

45, 5C, !5, 60, 65, 7C, 75.

TAE SITTING control wocd ~ithcut any tab stop~ specified,results in reversion to the default tab settings. This control~ord
is useful for indenting the ta9inning of a Faragcafh(rc~€~tera TAB causes a faragraph ERFAK) or for tatular
inforaaticn and diagrams.

J!.9.!.£.§:a.

this ~cr.trcl word acts as ait.a tat settings aust be
settings that are net crdErEdt E bav ior.

J:.

c.

B~EAK.

1onotc~icallywill result

increasing, tab
in unFredicatablc

1he right Dargin is considered to be ccluun O.

·scUl?T/jf;~7lOP HABGlN Ccntrol

f;'lfl'_;~~-gs le:

05/01/69
3.l.13-64

SC BI PT

05/01/69
3.1.13-63

1jl

/f:J
l'..Y..!.E.2§~ :a.
.1B 1C 'O 3C 4C
1at Et~~! ac£ iDterfcetea as columns 10, 20, and 30.

1he 1CE HABGIN control Mord speci~iEs tte nuaber of lines to beskif fEd above the teJt CD ~ut~ut ~ages, overriding the standard\alue ~f tive.

t.
.tE
1ab stcfE vill tevect to default values cf S, 10, 15, etc.

.l.QJ;~:I.'IM I

I

I
n I
I

specifies the numter of line~
to·tE skipped at tbe tcp cf
cut~ut faqe5.
D
1ust be lhLee
er greater •n.YJrn.9£:!he specified nu~ber cf lines ~ill te left at the top of
succeeding output fa9es befcre the fir~t line of text. 1he fage
11unter and h<0ading, i f any, are· Flaced n'bove the top i:.:argin.. If
no 1Gf MARGIN control word is included JD tho file, the default
valuE is five.
The 70P HABGIN specified ~ust always be greaterthan the current HEADJ~G MAFGIH.
l!.Q.!~:

7his ccnttcl word acts as a EEEAK •.!JJ!..!!11.!_g :a.
.ift 3
1hree lines will be left at the tor cf Fages sta~ted after thecurt~nt ~age.
The heading and pa9e ouater will be typed in theseco~d line uDder defanlt heading aargin.

(.

,.,..
•i:x . ; .I l'h w ;;;; ,,,,Wfil4ii g ;

;:::

1111

:;

ta

:

t

-

a: a au:;;;:: &,,,,$4Ji91!1 ..,,J J SILi, tJJ JL )~JP . ;a :ilia:s s :::; . :

::

.~

~

""'
SCRJPT. u ?.DEN'l Ccnttcl

SCBlPT
05/01/69
3.1.13-65)fl)J1;:/97

R.1!.Iil~:/;f"'~">/i.c.;..v• ta 10.~e SCRIPT Examfle

/jJ;'

.ce
SCRIP7 Exami:le.;si;: 2.as

UNDEN1 ccn~tcl wctd fcrces the im5eciately following line toEtatt turther left than the ~ositicn indicated by the current
indent.
~he

Ifill! at:bo E6EAK was needed herE, since the .ss (SINGLESPACE).ccntrcl actE aE a treak. Althou~h this isin fOBMAT mode, tabular infcrmaticn can be included:
.sp
.-sp
.SP
HACE

t
.J

n

specifics the number cf Sfaces tc bE"undented" (negative indent) for the
next line only, it must bE less thanor equal to tho ancunt of indent
currently in effect.

II

.sr

~he CHIEN~
central weed sertes the sane purpose as the OFFSET
ccntrql wcrd but in a differEnt ~anner. It is usually used to~ake the firstline of a FaragraFh er section extend further tc
the left than the bcdy of the Faragra~h.

Tte cbcicE bEtween using UNDENT and CPFS£T is usually a matter ofierscnal Fteference. In general, UNDEN! is more convenient oncecne becoccs faDiliat with its usage.
~Ot.§§:

This contLcl actsaE

a EREAK.

!. It is a tery severe errcr to SFecify anthat ~xceeds the current indentation amcunt.

SUGIE SPACE.ss

VOUBLI: SPACl!

.DS

•SS

.ds
.Sf
The leading tlanks cauEed each line to te handled
separat€l).

Us~qE:

a.

'Ibis example .. will -demcnstr.a.te scce ...of t.he- eapabil ities· ..
cf the SCBIPT coGmand. 7his file vas created by issuing:.br
SCRIPT ED11 EXAMPLE.tr
Since the file did net Fie1icusly exiEt, the terminal
wa~ placed directly into the input Envircnaent.
ThisfaragtaFh was dcuble-sFaced •ith the .DS control •
• ss
.si;

I

• UN

,

Use. of the LINE LENGTE control allovs sfaCe
to le leJt ~itbin a 1age fct figures er drawings.
Naturall}, it may take scue expcritentaticn forfinditg bcw [any paragraphs will fit next to a
figure.
.11 3(.s~

1he new line length eust take affectat a faraqraph, since it acts as a BREAK. 1beswitch tack tc standard line length, usually 60,
alsc is a BREAK, and aust end a Far~grarb. This
wcrks cnly in FORMAT aode.
.11 60.nt.EJ suitching o~t of fGL~!? acde
CAPTIONand dcing ~c~e justificaticn
by eye, fancier effects can te obtained. 7his also
takES ~oue ftactice and eJpetimentation.

undentation amount
Rigure 3.1.13-A.

~~!1Jgj:a.
.UN 1CIf an indentation of 1C is in effect, thE next line uill start at
the l~ft aarqin, all f cllc~ing lines ~ill occur at normal indent
fOsit~on, 10 ~Faces from left mar~in.

05/01/69
3.1.13-66

contents of a sc~IP~ file.

SCRIP'l:

05/01/69

05/01/69

SCBlPT

3.1.13-6.7

fAFAGEAFHS:
f//;l',<-Y.tr
If not space follows a Facagraph bcndin~, and if theraragrarhs ate not indented, a BEBAn iE necessa£y in
FCLMA1 Dode, to keep the heading line tron being justified.
A tev leading blank~ are the c~sicnt vay to force
a EHEAX and separate paragraphs. A line with only a blankwill al~c force a BDEAK and a blank line, if the folloving
line alsc begins with a tlank, as follc~s:

3.1.13-68/fz"'l~SCBHt B:itanple

ckv

!ff

1his e~a•fle

vill dencnstrate

SCRIPT cc~~and.

directly

into

the

b

.ce

"E

.ce

SEACE
Sl?lGLE SPACE

.-sJ?
.ss

tOUELE SP/ICE• DS

7hE l€ading• ce
Fir;ure EX.A
.sp
10 ctfset tbe caption it wculd be nece$~ary to leave
trailing er leading tlanks, which are ccunted as partof .its Jei:gtb:
.sp
.ce

.s~

7he ahcve ca~tion has 14 trailing blanks, vhich moveit to thE left. Leading blanks vould acve it to the right.

Figure 3.1.13-1 (cont.) Contents cf a SCBIPT file.

tlank~

c~Jsedf~gure3. 1.13-A.

+

hl$111.1)11@11111Uliiili!iih4.iiii!SJI. ii

LJIH# lti !Ji 4:SL£il!Llll.U!Jt!i I• . !Ji!J a Si

Thisparagraph

was

•SF

.ss

.ds

each line to tE handled ~eparately •!he new line length 1ust
takeaffectatiraragrafh, since it acts
as a EBE1K. The switch
lack tostandard line
length, usually 60, alsc
is a BREAK, and nust end
a paragravh.
This vcrks
cnly in PC6MAT Dede.
Ey switching out of PCEMA7 gcde
and doing SC§e justificaticn
by eye, fancier effects caa te obtained.
takes soce practice and e1feriaentation.

Figure U.A,., 4141; •environaent.

Use ct the LINE LENGTH contrcl allows srace to be left within ai:a9e for tfgures ot dta.ings~ Naturally, it may take . some:ex~cri~ontation for finding hew 1any~aragrapb~·will flt ·next toa figure.

.ce""'•=i ..

input

exist, the terminal vas placed

No BREA~ was ~eeded here, since the .ss (SINGLE- SPACE) ccntrol
acts as a treak.
Althcugh this is in FOBHAT mode, tatular
infornaticn can be included:·• ~:i=

1~revicusly

doutle-spaced with the .ts control.

.ceIof the!CRIPT EtlT EXAMPLEThe CE~TEB control is handy fot s~all figuies
included in the text. A .CE in tront ct each line cf
thE fi9ure .is .nccossa.i:y, a1Jd note that .. leadfog or·trailinq
blanks count for figuring the length to be centered:

EXUIPLB

the capabilities

7bis file vas created bJ issuing:

Since the file did net• ce
1 FORHA'I

soce ofa""

CAPTION!his also

Contents of a SCBlPT file.

~

~

("""\

~

05/01/69
3.1.13-69/f0~:1;p­IP/fa,o!o;

SCBIP1 ExamEle

EARAG$APHS:
If not space follows a fatagraph headi~g, and if theparagtaphs ate• not-indented, a EREAK is necessary in

FCEHA1 mcde,
justified.

ll/Ol /68
3.l.1'1-1

tokeep thehEading

line

f~ce

teing

A few leading hlanks are the Easiest vay tc
force a EREAK and separate Faragrar.hs.
A line withcnly a blank will alsc fotcE a BREAK and a blank line,
iL the follcwing line alsc begins wit~ a blank, as
fellows:
ihe CENTER central is handy fer snall figures
included in the text. A .CE in front of each line cf
the ·figure is necessary,and note that leading or
trailing tlanks count fer figuring the length to tecentered:
FORMA1I

EXAMPLEn£Figure E•X. A

SPLIT. c;lc:..Z

3. 1. l4 SPLIT
Purp~. The SPLI'f con- '.11and copico a specified port' on o! a ~ard image file and a!pends'it to a second card image file or creates a new file, ·· · ·Fo~~:~-----,:: SPLIT----~-------l~b~i2- --ij~:

JI &nd-o!-!i~-r ,. -- -- --- --- ____ ,____ -··· ------.:.. ----- :.
,label!
:menamel filetypc I filenamcZ !ilctypcZr nl

n2

:

:
! _________ !----------------------~-----------~-----------------------·
filename 1 filct:ypc lfilcnamc2

filetype~

speieifics the fhe from which a portion will be copied.
specifies the name of the file to which file l will be
added.

label lAn '8 byte alphanumeric label with the first character
non-numeric specifying the first record to be copied.

· label2

An :B byte alphanumeric label with the first character
non-numeric specifying the item afte1· the last item tobe copied,nl

A decimal number specifying the item number of the
fil'St item to be copied.

n2.

A decimal number specifying the number of items to
be copied.

1c cffset the caption it wculd be nece!sary to leave
trailing er leading blank~, which are ccunted as partcf its length:!igue EX.A

,he a~cve caEtion has 1q trailing blanks, tihich move itto the left.
Leading tlanks would acve it to thetight.
Figural.t.13-A (cont.) Contents of a

~CBIPT

file.

Usage:The SPLIT command enables the user to copy a portion of file 1 and append it to
file2. File l and filc2 cannot be the same file. If file2 docs not exist, it will becreated. The files must have fixed-length records of BO bytes pe1· record.
·copying b<:gin.s at either th13 first .record containing the alphanumeric string,
Jabcll, in the first eight bytes c! a record (label field),, o:r at the specified
item number if the parameter consists of all numeric characters.
If the last parameter is not p1·oviided, copying continues to the end-of .. file. If thelast pararnclcr is specified as an alphanumeric label, copying, once initiated,
terminates immediately before the fil'st item having the a~phanumcric string,label2, in tfielabcl-il:ClcroTarccord. The extent of copying may alternatively
be specified by an integer count of the number of items to be copied.

,/~~?{"

li /01 /68

o<o3

3. 1. 14-2
SPLIT

.~vi

/!'?:PY

No copying is clone if l) labels arc used for both starting and stopping thecopying and these two labels arc identical, 2) the initial label or item
numucr cannot be found, or 3) the number of items is specified as zero.

Examp~~-~a) SPLIT FILE DATA Fl DATA 45 12'!'lie lZ Hems b ginning-with tbe 45th item a1· ~ extracted !rorn the file
FILE DATA and <1c1c1ecl to the encl of the file F 1 DATA if Fl DATA exists
or cTcnlcs the file Fl DATA if it docs not already exist.

B~~12£1.:~!::.~.=.
WRONG NUMBER OF PARAMETEHS
The specified number of para1nelers given is not five or six.

b) SPLIT ADLE SYSIN ABLEl SYSIN BEG 20
The 20 items ueginning with the item which has a label field containing
BEG arc extracted from the file ABLE SYSIN and arc appended to thefile ABLEl SYSIN if it exists or creates the file ABLEl SYSIN if it
doesn't exist.

INVALID LIMITOne of the limit fields is specified with the first character numeric andone of the other characters non-numeric.
EOF HEACf!ED
The en~ of file I has been reached with or without copying being initiated.

c) SPpT PJWG SYSIN PROGEND SYSIN END
Jtcmr. beginning with. the item with END in the label until the end of file
PHOG SYSIN arc use<l to create a new file called PROGEND SYSIN if
PROGEND SYSJN does not exist; if PROGEND SYSIN does exist, those
items arc appc'ndcd to it.

FILE NOT CHANGED
The comma:id has been completed wi_t!1.out any writing of files.
FILE MODIFI°ED
The comrnan<l has been successfully completed and at least one item has
been copied.
..

. Error Messages:

Any error encountered in the reading of filel will terminate the command after
printing one o! the following' responses: - TYPB NOT FOUND
DISl< EH.HOE
ILLEGAL MODENONSTANDAHD FILEBUFFE:H. TOO SMALL
OPEN FOH WRITING
OPEN FILE LIMIT
F/V FLAG WH.ONG

11 /0l /(>8
3. l. 14-3
SPLIT

The SPLIT command diagnoses all errors which occur and prints a
rcsponi;e message indicating the nature of the crro1·. All returns
from SPLIT are with general register 15 equal 0 indicating no error.

(file of variable-length items)

Any error encountered in the writing of file2 will terminate the command after
printing one of the following responses: - BAD OUTPUT TYPEEHHOR ON DISKITEM SIZE?
OPEN FOH READ
TOO MANY FILESDISK FULL
READ ONLY~'~(items vary in length)~·~

/!"'\~~

05/01/69
3.1.15-1

3. 1. 1~

filety~c" and loads it onto the rermanentdisk.
Epecifies the synbclic tape unit of
the tape to te written. loaded, er positioned.
,AP2 is the default, ~hich corresFcnds totaFe address 181.

/.::..~::;,·{!)

THE•:2c.·..5'I AI? II .

ll!Hf.§g:lhe 1AFE corom6nd copies files from disk to tape,tafEs to thE FErmanent djsk, writes tafc marks,tafe, and !cauE the tape for file identifiers.

reccpies such
FOSitions thefilenamE•

J

1 AF Efi letvre•

HWJ?\l:SCH<filernode>

.:.,:

SKIF

11

SLCA[

filename filetvFe

TAP n
TA..L2.

1
ldH'.IJ:Cf£pecifies a disk file is to te copied

DUMI?

to the mcunted tafc.
filenam~•filctype <filencde> s~ecify the file tc be
cofied. The filemode is o~ticnal andcefaults tc F1.
aeans either all filename, all fil~types
er all files cf the SFecified rncde.

ICAD II

specifies all files en the mounteJ tapetefore the next "n" tapemarks are to be
CoFiEd tc the i;ernanent disk. "n".defaclts to 1.

FIE'liHD~ositions

SCAN

ty~es

~KIF

1o~itioris

ta1e11arks.

~d:,Q.§j_gg:

1he ~AFE ICAD command copies any number of files frorr tte tare tcth( rermar.ent disk.
1~hE::
filenanes and filetypes are ol::tainr-d
trcrn theta~e, and may net
be EFecificd with the ccmmand. The
fil~wode cf all files is P1.
Any cxistiug file on the Ferrrancnt
diEk with the saree dEsiqnaticn as cne cf thn tape files is er-asodand rei::laced. lihfrnever a flaqgc:d directcr-y record is encounteredon the tafE, the file being written on disk is closed, and a n0w
fllfl is started. Reading ccntinues to t.l1E "n 11 tapernark written by'IiHE WhlTECF.

Ibe TAP! FEWINC
faint.

ccrrrrand rositicns·

thetare reel

at

th~

load

1he 'IAPE StAN commanJ reads throuqh "n" tapernarks and types out
the identiJier cf the files tn the tafe. If two tapemarks ar-e
encountered, TAFE SCAN terminates. The TAPE SKIP positicr.s the
tdfC after the
next "n" tareroark enccuntered, skipping the fileat the cu1rent position. Use of the TAPE WRITEOF and TAPE SKIP
allows accfss tc individual files er qrcur-£ cf files.
·11ie !Art SlC~D ccmrnand ~cans the ta~e fer the SFecifiEd file and_loads it crtc the ~errranent di~k ~ith mcde P1.

the tape at the load pcint.

cut the identifiers of the files
that exist on the tape in a taFe-dump format.

n,.!/6/

filenanE and ty~e or asterisk ~ust be EFecified for a TAFE tUMP
ccuirand.
If fileroodeis omitted, E1 is assumed.
Files maycontain fi)cd or variable length recor-ds. The specified file isficst cc~iEs to a disk utility file,then tc the tape mounted at
virtual de\ice address 181. No end-of-file mark is written afterthE data transfer unless a TAPE WRITECF ccmrrand is issued. The
last record of the tape file is flagged, and contains directcry
infcrmatict fer TAPE LCAD.

!£!.!! .H:

f,UM fJ.O JI[ n05/01/69
3.1.15-2

the tape after- the next "n"
11 11
n defaults to 1.

1hc TAPE ~&I!EOF command writes a ta~errark ~herever
the tape is
cu r re n tl y I c d t ion e d • T he t a p cm ark is rec c q ni z.e d l: y TA PE LC AD a s

e11d-of-tile.
H~H-L§fl£::a.
SLCA[ fil€nane filetyre scans the taFC fer "filename

iilEname filetype P1 LOADED.

rAEE LCAC

qives this response as

each file ccpied frcm

tape ishi~corrrleted. This resronse
the la:::t file.

t.

is followed ty the

05/01/69

05/01/69

3.1.15-3

Ready !essaqe after

TP.PE [UMP FILEBTAFF HITEOF

t,-Jt'l7

TE~T

3.1.15-4

PS

A·?i{.J. HPE fEHNii

JoS"

DUKflNG •••tisk files are teinq duBred tc taretyr~d cut as they are dumped.

c.

and their

1his series of commands copies two user files to tape.
(In thisand the fcllowinq exarrrles, the Ready ~gssaqe followinq eachcorumand iE omitted.)
The initial TAPE RF~lNC positions the ta~c
at the leaf feint.
FILEA is then ccried, folloued by the flaqqn~
dircctcry 1ecord. The next record is the first of FIIFB. TAPE
~RITECF rlaces
a tapemark after the directcry record cf FILED,
dlld thefinal ccmwand
rercsiticns the tape to the load point
ayain.

identifiers are

TAI n NCT FFAtY YET

1hc tafe iE attached but not physically in a ready status.
i.

(OK -

READY

b.

NOW)

TAPE

1he attached tape has teen readied and can new be used.

!:KlP

TAPE IUMP SYSllE
TAP.I:~ACLIESY

llRI'TEOF

TAPE. FEWHD.

1!9~Q1P~.

Assurrinq thP eamc tape is mounted as in t~e ~revicu~ exam~le,thiH s(ries ct ccunand! ccries SYSLIB MACLIR onto the tape afte~
the tarcrnark following FILFE.
A tapemark is written follcwinq
the directcry reccrd cf SY~LIB, and the tare is rewound to thelead rcint.

'Ihe 'lAH ccirrr'a1:d c·an be used with a 7-track tare, density 800

tlPi, ccnve1ter on, and translator off.
t.
tar~

Failure to issue a TAPF WRI'IEOF after the last file coried tc
will cause an errcr on a subsequent TAPE LOAD.

c.
c. 'IhelEXEC) form of the LlSTF command is useful
all files, er grcufs ci related files.

T~PE

fer cq:yinq

lOltC

usinc; thE san;e tare, this ceir.rrand 'ooill erase FilEA from thererlace it ... ith the tape cory.
When the directory
reccrd is (recessed, the fcllo'ooing resFonpe is tyFed:
Again

Jisk, andj.
1AFE tUMP and TAFE ICAD are valtd even if the size oflocation cf the virtual disk is redefined tetwcen the cemmands.

FlLEA

e. ~d~e records written ty TAPE tUMP are 805 bytes lonq. The
first cl:aracter is a ti nary 2 (hex 'G2 '), follownd by thecharacters CMS and a !:lank (hex '40'), followed by BOO bytes offile data FacKed •ithcut regard for logical record lcnqth.· In
the final reccrd, tt.e character N replaces the blank after CMS.
lhe datd area contain directory information (see Prcqraro Lcqic

TEXT

P1 lGADED.

~otothat the mcde is no• P1.
Because there is nc taFe~ark
fellowing tILE~,
FllEB is read and rerlaces the disk copy of
FlLE~.
1he reeponse~anual).

FILF.E

Under cr--67, all taFE units roust te attached to the CMS user
tefcrc an} tare I/O can cccur.
Refer tc Section 5.5.0 "TapeErccedures" for information on the attachment of tapes.

TEX'I

F1 lCArH.

bythe· Ileadymessagecommandnow copy SYSLID MAClIR onto the
P1.
SYSLIB MACLIB SY en thef.

is fcllc~ed
encountered.

lH.H]g.§:Ancther 1AEE LCACa.
TAPE l'EWIND
lAPf ru~p FILFA TEXT f5_.
;,ii$$$

i

)$ I

f' .

kOUld

~ermanent disk
as SYSLlE Y.ACLIB
sy~tcm dis; wculd net ~e erased.

when

thP.

tarcmark!H Q.L!.f1"11:? lt.9.€.l:l:

~

~

is

~

.~

~

05/01/6!:1
3.1.15-5c210/ff,'}:;:;7·05/01/69

c~Of
E ICOC01)

UV All£ COMMi'lt:t FCRMAT

Tbe fcrwat of the ccnuand was inccrract, or the operation
SFcciticd ~as unknown. Retry the ccmnand. No Ofaration was
perfctmed.
flLE filename filetype filei:odc NOT FOUND.
The file srccifie4 ~ith TAPE DUMP was not found.
No
orerations was P€tformed. Check the file desiqnation andretry the ccmmand.

E(CC001)

E(OOOUL)FATAL TAf:E EfiRCR ~HlLE ~TIITlNG,
An l;C crrcr cccurred which cculd net te corrected by 10
retrJEs. Nctify the c~erator to reFlacc the tafe.
This
mesFa~eis also issued for errors during ta~e ccntrol
oreraticnE {RE~IND, WRI1EGF, SKIP}.
If TAPE SKIP was issued
at a EOint he}ond which no tapemarks existed, the tare ~ent
to end-ct-reel. A sutscquent DUMP, SKIP, or WRITEOF results

ln

thi~

messa~e.

E (CCC02)'IAP n IS FlLE FROTF.C'l'ED
FATAL TArE ERBO~ ~HILE ~RI1I~G.
The ring it: net in thetare, thcu=fore
occ1,;·i::.

writing cannot

TAP n NOT A'I1ACHECFATAL TAFE E&fCF WHilE WRI'IlNf.
The taFE is rct attachad, therafcre it can ri6t-be -used.
Rtifct tc Tare Procedures in Section 5.~.o for information on

E(C0002)ta~c4.

DISK EHOF WlllU REAI:lNG.
An l/C error cccurLEd uhile the file
waE teing transferred
to ct frcm the disk utility file.
Ratry the command. If
the error recurs, notify the oper~toc. If the file wasdelEte-after-reaJins, see COMBINE, Note b.

E(COCO:t}

FA1AL DJSK EHROR.
An I/C error occurred, oc, for a DIS~ LOAD, the disk may hefilled.
To retry the command,
reposition the taFE llith a'IH'E: liHINr: and the necc::Eary
number of 'IAFE SKIP commands.
If the error recurs, notify the opEratoc.

E (OCCC3}ClSK E&FCF WHILE WRITING.
An l;C crrcr cccurred during transfer of the file to or fromthe disk utility tile, er tho uEcr'E jisk is full.
Betry
the ccmmand.
If the error recurs notify the oret~tcr. If
ttE f jlcrrcdc was delete while readinq, son COMBINE, Note h.

!(CCC03)3.1.15-6

f (C0004)~n;:,:::::FAlAL !APF £RROR WHILE READJKG,
I/C error cccurted. A tapemark ray not be at the end cf

the tarE. Repcsiticn the tare and retry the command. If thecrroc recurs, and the file has not been loaded, part of thefile roay te recoverable under the desiqnation (DISK) (TEttP).
See ~(000C6).
E(C0005)
TAPE )S NC1 IN "TAF! LOAC" FC6MAT.
A ta~E record was read which wa:: net written by TAPE DU~P.
The ~Leng tape is mounted, or readinq has ccntinued past theend cf 1APE DUMP cutput because nc taFemark was read.
E(CC006)
ENDING RECORD CF FILE MISSING.
A taremar~ or end-of-reel was encountEred before the flagged
directcry reccrd cf the current file.
Part of the file may
be tEccveratle under the desiqnaticn(DISK) (TFILE)
P3.
Note 1hat the mode is delete-after- reading, sc an ALTER or
CCMElfiF ccmroand muEt te iEsued before inspectinq this file.

10- 7.3-68

3.1. lG-1 A'/?;(:TXT L~!l ,-:2. //3. 1.16- 2
TXTLIB/.~;.Y?

.?!/..z_3.1.16 TXTLIB
libpamc

Ei.Jrpo_~:---------The TXTLl13 command either (1) generates a text library, (2) adds toan existing .ext library, (3) deletes from an existing text library, or(4) lists the entry points and control section names, the location, andthe size of the TEXT files included in the text library,filenamel. .• filcna·"lcN

I
II

r:~IB;- - - - - - - -- - - - - -"lrEN~RAT1'}

libname filcnamel.., filenamcN.f A~D J

libname filcnamcl •• , filcnameNeE~TF,)

libname cscctnamcl ••• csectnamcNel~NT)

libnamefLi~Tlibnamcr

specify the file(s) to hr used in the either gencratinr oradding to a TXTLIB file, Their filctre~n2_ust b3_'.!:_1'.:_~T.

cscctnamel.,, csectnaineN
specify the Cl'lccl(s) to be deleted from a TXTLJilfile, Entry points which are n.t>:f "?.sectnamcs arc· ignored.

Format:·- - - - - - - iis the name of the text library to be gencratc<l, adclC'd
to, printed, or listed. The filctypc of lilmamc must
be TXTLIB.
--·--·--·-----·----·-·---

Usage:
A text library is a file that has a file type of TXT LID and that contains
a dictionary ;rnd the relocatable object code from TEXT fiks, The dictionary is created by the TXTLIB command which cont-:i.i11s the entry
points and contrcil section names, their location, and the size of each
TEXT file included in the text library. The relocatable object code in
TEXT files can be created by the Assembler, Fortran, or PL/I compiler.
There arc five forms of the TXTLJI3 command: GENERATE, ADD,
DELETE, PRINT, and LIST.

{~ENERATE)

creates the text library "libname" from the specified
file(s).

The GENERATE form of the TXT LIB command generates a text libraryfrom the opccified file(s) and assigns to that library the identifier "libname TXTLIB Pl". If a file already exists with the identifier "libnamc
TXTLIJ3 Pl", the existing file will be erased; and the new file will becreated,{~DD}

adcls the contents of the specified file(s) to the existing
text library "libnamc".

The ADD form of the TXT LIB comrr1and appends the contents of the specified TEXT files to the end of the existing text library.

{~ELETE}

deletes from t.he text library "libname" the specified
control sections (csects).

{~RJNT}

creates the file "libnamc MAP Pl" c;ontaining a listof the entry points and control section names of the
TEXT file~ in the library, their location, and thesize of the TltXT file.

The DELETE form of the TXTLIB command removes the specified
control sections from the file libname TXTLIB, II a TXTLIB file has
two control sections with the same n;ime only the first one is deleted(unless the csectnamc is given twice in the argument list). The orderof the csectnames given in the commz.nd argument is immaterial.

-------- - - - - --- - - - - - -{~JSTJ"'- - - - - - - - - 1

The PRINT form of the TXTLIB command generates the file "libname
MAP Pl" on the permanent disk. If a file already exists with the same
identifier, it will be erased and the new file created. 'fhc "libnamc
MAP" file contains the same informatio~1 as that in the dictionary of thespecified text library and is in the format of a list of entry points andcontrol section names that reside in the t-;xt library, their location orindex in the file, and their size in number of card images.

provides the same information as PRINT, but the information is typed out at the terminal instead of being generated into a MAP file,~~I!If"'\.

""

~

c2.o
)/(ff 11 /01 /(i8.,3. 1. 16- 4

3. 1. 16-3
TXTLIB~~£ c><'//----·'l'hc LIST form o! the TXTLil3 cornrnand types out the contents of thedictionary at the terminal and docs not generate the. file "libnarnc
MAP Pl". For an example of the TXTLIB LIST cornmand, see FIGURE
3. 1. 16,-A. The pound sign (/I) indicates the first control section name in
the file.

Both the PlUNT and LIST forms of TXTLIB type out a statement indicating
the tot'11 purnber of entry points and control section names that cun·cntly
exist i~1 the TXTLil3 file.
For thb usage of text libraries, refer to Sections 3. ?... 2 and 5. 4. 0.
Notes:
a. Eai::h TEXT file that is to be included in the TXTLIB file must consistof one or more control sections with an END card ixnage following eachcontrol section. This fo1·mat will be autornatically genc1·ated by the
ASSEMBLE and FORTRAN commands.
b. V!Hh the TX'fLIB ADD command, the TEXT files are added to the end of
the existing TX'l'LIB file and no checking for duplicate entry points or control sciction nan1(;S will be performed.
c. The total nurnbcr of control section nan1es and ent:ry points in the
TXTLI13 file c<wnot exceed 256. When this maxirnum number is reached,an error message will he typed out. The text library created will include
all the' text files entered up to but not including the one that caused theoverflow.
Rcse~

xxx ENTRYS JN LIDE
When 'l'XTLIB is issued, the contents of the dictionary of the specified text
library will Le type cl out. See FJGUHE 3. 1. 16· A. The number of entries xxx
in the text library will be t ypt'd out when either TXTLIB LIST 01· TXTLlB
PH.IN'!' is issuecl.
Examples:·a. TXTLlB G SSP MEGOP MEG OPS
The file SSP TXTLIB Pl is gene.rated from the files MEGOP TEXT, MEG
TEXT, a'nd OPS TEXT. Ji SSP TXTLIB Pl already e:dsts, it will be erased
and th:c 11cw file created.
b. TXTLll3 ADD SSP MYHOUT
The contents of the file MYHOUT TEXT will oe added to the existing file
SSP TXTLIB. No checking for duplicate entries is performed.

A'b~l'

c, 'l'XTLII3 DEL A SUBDf/
The control section SUBDf/ in text library A will b1~ deleted,cludes entry points SUBD and SUBl (sec FIGUH.E 3. l.16-A)

This in-,1d,

TXT LlB PRINT ABC
The file "ABC MAP Pl 11 is generated on the user's permanent disk containing the oictionary information from the file "ABC TXTLIB". The
number of entries in "ADC TXTLID" is typed out,c, TXTLm us·T SSP
The dictionary of the file SSP TXTLIB as well as the total number ofentry points and control section names will be typed at the terminal.
Error Mcs~~G.5~..::..:(EOOOOl)A FILE IS MISSING
Either the filctypc of "libname" is not TXTLIB or the filctype of 11 Iilc11amcl ••. filenan:\eN'' is not TEXT, ·(E00002)
A FILE HAS WRONG RECORD LENGTH.
· One of the TEXT files.docs not have 80 character records and, therefore, it h<is an incorrect format. Re-compile or re-assemble the sou:rce
language file and then issue the TXT LIB command again,(E00003)
ERROR WHILE READING,
An error occurred while either the TXTLIB file o:r a TEXT file was bc-i ng
read, The command has terminated,(E00004)
EH.ROH. WIIILE WRIT.ING.
An error occurred whUc writing the TXTLID file.
minated,(E00005)
LJBRARY NOT FOUND.
The file "lilrnamc TXTLinn does not exist.

The command has ter-

The cornmancl has krminatcd,(E00006)xxxxxxxCAUSED OVERFLOW --- OK UP TO THERE
The rnaximum number of entry points and control section names (256) in
the TXTLIB file has been rc:ached, No additional TEXT files may be addC>d.
The control section that caused the overflow is not included in the text library creatC>.d,(E00007)
ERROR, FILENAME MAY BE• nUMMYALTER failed, This means that your original text library is lost but the
new vcr sion may exist as •·DUMMY TXT LIB.
(E00008)xxx>..xx, xxxxxx NOT FOUND • , , • OTHERWISE OK
A list of csectnamcs not found in the specified tcx.t library is pi:intcd above
this comnH:nt. The presence of such c sectname s docs not interfere withthe deletion of ones that arc found.

l-22-68
3.1.17-1

11 /01 /(>8
1 ,....,, 3. l. 16-5~/:;1 TXTLIBUPDAT~ ,//{:----(E00009)
WIPEOUT! ! !
All csccts have been deleted.

/1

UPDATE#;(,~No text library is left.

Purpose:.

(EOOOOlO) CSECTNAMES MISSING
No cscct na·nes we1·e specified with TXT'...IB DELETE.

The UPDATE command makes changes in a specified file according tocontrol cards in a second file.

BAD FOHM
Command forms must start with G, A, D, L, or P.

(EOOOOl l)

Format:,-----------r---------------------------------------------------1

l{~~-D~ ~~)_ j_'~'.~:~~-e-1" _~~'.~'~~::__ ~'.':_":~~: ~ _~'.l_e~~~: :~l-" _~ ~~~ ___ J
filename I

is the name of the file to be changed.

file type 1

is the type of the file to be changed.
SYSIN is assumed.

filename2

is the filename of the file containing the UPDATE
control cards. If 01nitted, filcnan1el is assumed.

filetype2

is the filctype of the file containing the UPDATE
control cards. If omitted, UPDATE is assumed,(P)

specified the file incorporating-the changes is toreplace the original file. If omitted, the old fileis retained unchanged, and the new file receives afilename consistiHg of a period (~) followed by the
first seven characters of the original filena1ne.

If omitted,

Control Cards:
Changes arc made in the ol'iginal file according to the UPDATE control
cards in the UPDATE file. The format: of these cards is shown below:r----~----------------·--------------------.
•
I

L_._1_ --- _f?_ _ - - _ !~.9!1.?_l_ - - - - - l~::~~~r;,t_ J~~~! __ :

s

. '

~
''hi41£

11.21 '.:,· . .

specified the new file is to be sequenced in columns
76 through 80. If this card is included in the UPDATE
file, it must be the first card.

scqnolspecified the starting sequence number.

increment

specifics Hie increment to be added to the sequencenumber for each iten1.

label

is a three-character label to be placed in columns
73 through 75 •_,:1''lflliiijlliiiMJLl!c.

. &,:. Ji

111 Jl . !Ji J,..J.i \,. "I &UIJJij UIJll!U•4!W411.

n.llll!l!l!I!'!·~

t-\

"'

I"\

c2/Y

._217

r,);7
1-22-68
3. 1. 17-2

1-22-68
3.1.17-3~------------------------·

:

•/

I

D

seqnolUPDATE gcmerates two files during execution: ''filename UPDLOG PS"
and "filename INTER PS, 11 where "filename" is that of the original filein both cases, The UPDLOCi file contains a record of the controi cards
in the UPDATE file, items added and deleted from the original file, items
added and deleted from the original file, and error messages. A new
UPDLOG file is generated 0111 each execution, replacing any existing UPDLOG
file with the. same filename.

seqno2 :I~------~-----------------·
D

specifics cards are to be deleted from the original file,'>eqnolis the (on ginal) sequence nurnber of the first card to bedeleted,seqno2is the sequence number of the last card to be deleted.
omitted, only one card is deleted.

The INTER file receives the records of the original file as changes arc made.
At the end of execution, the identifiers of the INTER file al"e changed to one of
two formats, depending on whether (P) is specified with the command. If (P)is specified, the original file is erased, and the INTER file receives its filename and fi]ctype. If (P) is not specified, the original file remains on thepermanent disk unchanged. The new file receives the same filetype and filemocle, and a filcnarnc composed of a period (.)plus the fil"st seven charactersof the origiBal filename.
· .

If·- ----- .... --- -- ----:I./

I · seqnol:

I~----------------·
spc<..:ifies cards are to be inserted in the original file, The
inserted cards must follow the • I I card immediately in the
UPJlATE file. All cards until the next control card are inserted.
seqnolThe control cards of the UPDATE file always refer to the items of the original
file by the sequence numbers existing before any changes in columns 76-80. If
no scquenc1~ numbers exist, issue a preliminary UPDATE comm;;nd with only
the./ S control card in the UPDATE file. Sequence numbers will be assigned,
The contr·ol cards inust always be :identified by a "· /" in colu1nns on<: and two,but any nurnbcr of blanks n1ay separate the other fields. .Sequence numbers n1ay
be expressed with up to five digits, but leading zeroes are not necessary. Any
sequence nu.mbcrs in cards Lei be inserted in the file arc ignored_. If the • / S
control card is omitted from the UPDATE file, asterisks will be placed incolumns 73-80 of all cards in the new file which were added or replaced, toindicate where changes were made,spedfic3 the sequence number of the item after which thecards are to be inserted.

r-----------------------1•/
R
seqnolscqno2 ::~-----------------------JR

specifics cards arc to be inserted in the original filein place of cards now there.

seqnolspecifics the first card to be replaced.

seqno2

spcdfies the last card to be replaced. The cards to beinserted in place of those deleted (not necessarily the same
number) must follow the . / R ca rel immediately in the
UPDATE file.

Changes arc inade in order in a single pass through the file. If contl"ol cards
specify ch<ingcs that a1:c not in order, an error is recorded and no changes are
nrncle,Rc~ponscs:

INTEH.MEDlATE FILE EXISTS.'
The file "filena·me INTER PS" already exists for the filename specified.
.ERASE or ALTER this file, and issue the UPDATE command again.

Usage:UPDATE modifies tlw specified file according to control cards in a second
file. The filetype SYSIN is assumed for the file to be mod·ified, if no otheris sr-ecified, The control-card file normally has tlw s.,n1e na111c as the file
to be modified, and the filetype UPDATE. It will be rderrcd to as the UPDATE
file~ with the understanding that both a different filename and filetypc m:1y be
specified with the UPDATE cormnand. Note that if different identifiers ;,respecified, the filetype of the file to be modified muf;t ;Jlso be included. "(P)"n1l1st always be the last argunwnt, if it is indurlcd.

•

I

UPDATE)UPDATEFATAL ERROR 1
A control card was detected in the UPDATE file whose second field was not
the character R, I, D, or S.

J

FATJ\LERROR 2
The file to be changed is 1~ot on the permanent disk.

J;u

j_;f

" 7

c/cJo
1-22-68
3. l.17-·4-UPDATE

1-22-68)

3.1. 17-S
UPD_ATf2
RET

READ ERRORor
WHITE EH.ROH
An error occurred reading or writing to the pcrn1ancnt disk.

RTNOOlOO
RTN00125
R TNOOlSO
RTN00175
RTN00200
RTN0022S
RTN00250
RTN00275*·

PARAMETER ERROR
No para1neters were entered with the conunand.

RETCODEfilename filctypc NOT FOUND
The file identified in the response was not found in the user's iile directory.

RET UPDLOG PS is also created, containing fhc control cards, and all items
added or deleted,

ER~ORS ENCOUNTERED.

SYSJN REMAINS UNCHANGED.
This resonse is issued for all of the abo~e error conditions. It indicatescontrol is about to return to the CMS command environment, and that nochanges have been made to the files.

Error Messages:
E(00002)

Example:a.

CSE CT
ENTRY RETCODE
BALR
12, 0
USING
12
L
15, RETCODE
BR
14
DS
F
END

FATAL ERROR 3.An error occurred while attempting to change the identificationof the INTER file.

UPDATE RET

ALTER fnl INTER ~' fnl filetype

Assume that the file RET SY SIN PS containfl th<'sc items:
CSE CT
BALR
USING
SR
END

RET

12°, 0~'. 12lS, 15Enter the. command

RETOOOJ 0
RET00020
H.ET00030
RET000-10
RET00050>:<

where fnl is the filename of the file changed, and filetype isthe desired filetype. If another error occurs, enter the UPDATE
command again.

Assume that the file RET UPDATE PS contains:

./ s
.I

I

2S

100
10

RTN

ENTRY RETCODE. / R 40 ·nL '... 15, RETCODF:
BR

14

RETCODP. DS

F

As the command is executed, the.file RET INTER P5 is created. As items
arc placed into it, "RTN" is placed in colums 73 through 75, and sequence
J)Utnbcrs beginning with 00100 and incrementing by 25 arc placed in columns
76 through 80. On completion, the file becomes • RET SYSIN PS, and contains:~v:::; ii

41

1111

""'

J

...

~

11'1"'1!

Ii"·¥ ,,Ji"' .J 4 ' ,4¥ ,J:if,4 H; '_,J''H•!

"""'"" " "' ,.;;,;., .4 .J.,J u. -·,;··M

1i ·,,

IJ,,,,.,:J,

W!if"'~!¥¥f ~§~ "' ··:i ~ 41M;att-:-igi"·:1~~"~~

,...

~

""'
4-01-68 i22;
3.1.18-1'!_{\_l>_~!N T

3.1.18 TAPRINTTA PRINT copies files from a specified tC\pc to the offline
printer. The files must be LISTING files created by the
WRTT.{\P or ASSEMBLE commands.

Fonnat::- -(~-~;~..-1~-;\ r- -c~-~~~,-!
\ \ TA PR ) I.J I----------~------~
is either T.APl or TAP2, specifying which tapeis to be copied. If omitted, TAP2," is assumed.

Usage:TAPRINT prints tape files in the special format written by the
LTAPn option of the ASSEMBLE command and by the WRTTAP
command. Printing starts wherever the tape is positioned when
the cornmand is issued, and continues until two consecutive end-offile marks arc encountered. Single end-of-file marks arc ignored,
cx.ccpt for a u1essage. On cornplction, the tape is rewound.
Responses:
EOF READ ON TAPE
A single end-of-file was read on the tape.

Printing will continue.

PLr.:ASE READY THE PRINTER
This message should not occur under CP.
END OF TAPE
Two c-onsc cutivc end-of-file marks were cnc'ounterc·d. The tapeis being rewound, and control will be passed to the CMS Command
env.ironmcnt.
PEHMANENT 1/0 ERROR ON TAPE.
An 1/0 error occurred. The command is terminated.
~arpplcs:

TAPRINT TAP l
All the files up lo the first two consecutive end-of-file marks on
the tape mounted on TA Pl {at 180) arc assumed to be LISTING files
and arc printed on the offlinc printer.

.;2,::z,_.:i,,I~PRINTl~~·~~

E (00001)

Purpose:TAPn

4-01-68
3.1.18-2

SYMBOLIC TAPE ADDRESS INCORRECT.
The symbolic tape address specified was not TA Pl
No action was perfonncd,

or TAP 2,

~

I
.,.1·

l. ),.?,:
4-01-68
3.1.19-1
WRTTAP

3.1.19 WRTTAP

o'l.::1-j

J).1
crG~

4-01-68
3. 1.19-2

Yl!lTIAP
Example:Purpose:a.

WRTTAP copies fixed-length format files from disk to tape.· If
the filctypc is LISTING, assembler and compiler carriage-contra:
codes are translated to machine codes.
~:

WRTT AP PllOG LISTING
The file PHOG LISTING PS is <:opied to tape, with carriagecontrol cocks translated to mac:hinc t:odcs, and records blocked
in groups of 10. If this is lo serve as input to the TAPRINT
ccirnnv1n<l, the following con1n1ands should be issued:
TAPE WnITEOF
TAPE WRITE OFTAPE REWIND---------r-------------------~: { WRTTAPl;filename file typel

L--~- _!_:_ ____ _______ :.. __:filenamefile typespecifies the file to be copied.

~!.Messages:

E(00002)Usa~:

WRTTAP.copies files from any di~k to TAPl.
Records areblocked in"groups of ten, and the record format must be
fixed-length less than 256 bytes.
No end of file is written
on the tape, and the tape is not rewound when the commandcompletes.
Although WRTTAP handles any file of the format describedabove, it is specially designed for LISTING files createdby the ASSEMBLE and FCRTMt{ commands.
These files containa carriage control code for the offline printer as the first
byte of each record.
WR'l'TAP translates thP. code into amachine code for the printer.
Files are written on the tapein the same format as if the ASSEMDLE command had been specified
with the (LTAPn) ~ption. This format is acceptable to the
TAPRINT commana.

Two parameters (filename and filctyp~) were notspecified.
E,(00003) VARIABLE LENGTH FILEWRTTAP docs not handle files. with variable record
kngth.
E(00004) FILE NOT FOUND
No file with the specified filename and filetypc was found.

E(00005) FATAL ERROH
An error occurred reading the file from <lisk.

~:

WRTTAP docs not write an end of file on the tape oncompletion nor does it position the tape past any
existing files.
Use the facilities of the TAPE commandfor positioning.
To mark an end of file for TAPRINT,
write two end-of-file marks.

a.

PARAMifrF:R ERRORb.

Under CP, the tape must be attached by the operator.
WRTTAP expects TAPl, addressed at 180, which should bespecified when you request the operator to attach the
tape.

c.

Tape files written with WRTTAP are not suitable for re-E{xxxxx) TAPE ERROR
A tape error occurred which could not be recovered.

The error code is unpredictable.

reading with TAPE LOAD.

"J

Responses:
None.

I! ..

as I

""'

::;a, MMU4,141i@LA144 a :au:

~'

~
I

kii

JO k

4.

. 115

. ,;;:;:;;: ;;;;,:: :::;:.;:;:: Jiiiiii ';;;:::::.iii

hii

ILi llllifi\lllii\Rli\flfW I ,1111'4

2 " ...

IQ+F ••l!!'i; :wq fF%ii·"1~"""·..,. ,.,..,,,__,,,,,"".!'~!~'

~

"'1

~

05/01/69
3.1.20-1/i'~J.2.;;--ST A,T E

3.1.2C

05/01/69
3.1.21-1

TAFEIO

3.1.21.1#:1:!
c?.;<6

H!.i;gg:

i~H.f..§£:The s~~TE ccirnmand tests whether a file exists.
f.QH~l:'Ihe TAPEIC command either writes aerases a gzf, er moves the ta~e.

tape mark on a magnetic taFo,

f.QH2t:STATI I filenarre

filetyFe- - - ---- - - - -- - ---I
filemode I
I

I

IA FEIG t!l.§..LJ.§1:

TAP1
'IAF2

llll >

Functions Are:

S.

ESE
BSH

1HQ.LS:;.9..cJ£.B:
E (CCCC1)E(OOOOll)

UP 1,

ccrresponds to device 180.
ccrresponds to device 181: TAP2 isassumed if nc tafe is specified.

When S1A1E is issueJ fer a file which exists, the command returns•ith a cede of zero.
If the file does not exist, a non-zero
errcr tode will te returned. 'Ihe mcde must be specified as P, T,CI

fu r.cticn

I

ERG
FSF

File SFecified ~ces not exist.
First character of filemode illegal.

FSil
l:{EWIN[RUN
WRI 'IECF
W'Ir.

tc tacksrace one file
to tackspace on record
to erase a gap
tc fcrward SFace one file
to forward spate one record
to rEwind the tape tc lead Foint
to rewind and unload the taFe
tc write a tafe markto write a tape mark~~:a.:1£:

The tape en the specified device is ~cvad a Einqle record or
file.as lndicated or is rewound and/or unleaded or a taFe
mark (End-cf-file) written fer a gap is erased as indicated.
~S-~~!:

1.

The mcdeset is set to X'fF', therefore, either 9-track
tapes \ith density HOO, cdd Farity, and converter
off can tc [anifulated \ith the TAPEIO ccmmand.
If othermodes cf tapes are to be used, TAPEIC should be called asa functicn frcrr an /lsserrbly Languaqe p:oqram (Sec 3.4.·1.4.-11).
.).1.../,,'·'1:1,'{, - /

2.

The

&!~INDand RUN functions indicate corrpletion befcre the·.. ~-' :l'05/01/69

05/01/69
21

Fhysical ofcration is cc~fleted. Thus a subsequent opera~ibfi t'? the .same physical device may encounter a device busy/,:?;.?(_Js1tuat lCn.
.?
c:?t><17J.

3.1.21-3//~~/

2

E(00007)
TAPn - SERIOUS !APE EBROR ATTEMFTING function
An unrecoverable tape error has occurred on the tape while
attErnpting the s~ecified function.

The IAfEIO ccrnmana is identical tc the TAPEIO function (nection
3.q.1.q.-11) except that TAPEIO READ and TAPEIO WRITE
cannct be executed f~om the comru~nd level dt a terrrinal.
If eittEr cf thcs~ is atteurted, an aprrcpriate error messaqc
and error code are qiven. (see below).HHf.!l::i£.§:TAFn

N01 EFAtY YET.

1he specified tape has been attached but it is not ready yet.
Ihe follo~inq messaqe will te received when the tape drive isin a reaa"y status.
(CK -F.EA[) Now)

ThE attact{d tafe is new ready for use.
.'.r;.u;.s;J;_.i1£ll£!.9£..§:
E (00001)

An invalid function~as ~pecified.

E (00002)

An end-cf-file or end-cf-taFe has been reached.
E (COC03)

A permanent 1/C error bas occurred while r£adinq
er writi~g the tape.
E (COC04)

An invalid symlolic tafe unit was srecified.

E(OCC05)
TAPn NOT ATTACHED.
The specified tape is not attached, therefore thefunction can not occur.
f(00005)

Sa~c asfrcvious message, but the message cnly prints
the first time this error occurs.

E(COC06}
IAPn IS PILE PRC1EC1ED.
EFecitied tape contains a file-protect rinq,
therefore the taFe can net be erased or ~ritten on.

1be

""'1
"111

;at

em::

14,

_,

~
l
I

1

4

ffl.INA'41¥F·i"'MFHll!fl

Ii!

ii

1"'"1!'"""'"''....,,.,,_,_,,....,......,.

.,,i~y-6-15-70
3.1.22-1

(

DUMPD

DUMPD

3.1. 22PURPOSE:The DUMPD command prints the contents of one or more direct accessrecords, specified by either a CCHHRR address or a BBBB number,in hexadecimal on the printer.
FORMAT:--------------------------------------------.
DUMPD

CCU

bbbb
{ cc

[bbbb] }
[hh
(rr]]

:
:
I

--------------------------------------------·CCU

cc hh rr(bbbb

is the device addressis the cylinder, track, and record
number to be printed
is the data block number

USAGE:
The contents of the specified record is printed in hexadecimal on
the printer. If cc hh rr or bbbb is not specified or if one record
has been printed, DUMPD requests another record address. To
tenninate DUMPD, issue a carriage return with no characters on theline. For more than one record:
1.
2.
3.

Omit rr for printout of given track (head);
Omit hh rr for printout of given cylinder;
Specify bbbb bbbb as the beginning and end of the data
blocks to be printed.

RESPONSES:CC HH RRBBBB
·Prompting will depend on the previous mode of input. Specify
another cylinder, track (head), and record number or data blocknumber. User may change input mode at any time input is requestede
The -change wlll he reflect.ed ori the next input prompt.
CORRECT FORM IS: DUMPD UUU CC HH R
OR: DUMPD UUU WITH THE CCHHRR ENTERED ON REQUEST.

1

6-15-70
3.1. 22-2
DUMPD(
No parameters were specified with DUMPD.
I/O ERROR ON DISK UNIT XXX,
CSW = xxx ~ • • xxx, SENSE = xxx •. . xxx

An I/O error occurred. Check to see if the record address is
outside the file boundaries.
SIO
SIO

CONDITION CODE 1
ERROR ON DISK UNIT xxx,
CSW = xxx . . . xxx, SENSE = xxx •• xxx.

An invalid device address was specified.
ERROR IN SPECIFYING RANGE OF BLOCK NUMBERS
CORRECT FORM IS FIRST LAST OF THE RANGEFirst block number was larger than the second.
must be less than the second parameter.

c

EXAMPLE:
02

05

durnpd 191
CC HH RR
002C
BBB
03 05 ODCC HH RR
02 02
CC HH RR
0020 0022
BBBB
er

01

R; 10.37.11

T = 0.81/257

First parameter·6-15-70
3.1. 23

DUMPF
3 .1. 23

DUMPF

Purpose:The DUMPF coro.mand dumps the contents of all or part of a specified
file in hexadecimal and EBCDIC.
Format:r--------.,------------------~-----------------------:~------------,! DUMPF ! filenameI

I·

filetyperl{n11{n2*J/ [n~]*/80jf{print1l_
B-

.J

J

!
I

&.---------L------------------------------------------~------------1

filename f iletypespecify the file to be dumped.

nl

is the line number of the first line
to be output.

n2

is the line number of the last line tobe output.

n3

is the maximum number of characters to
be output on a. line, 1.1... the records are to
be truncated.

(.

• . .i::print

the output will be sent to the systemprinter.

Usaqe:
The filename and filetype must be specified. If the first line
number a.nd last line number a.re omitted, or specified withasterisks, the entire file will be output. An asterisk in thefirst line or end line fields specifies the beginning or the e~dof the file, respectively.
Output lines are truncated to the specified limit, if any, or to
80 characters.
If a. limit is specified, the first line number
and last line number fields must be filled, either explicitly orwith asterisks.

Output appears a.t the terminal unless the print option is used.
The search for the file is made on the perma.nent, temporary, andsystem disks in that order. In the case of files with duplicate
filename and f iletype, only the first file found will be typed
out.

3/12/70
3.1.24-1
REMOTE
.(

3.1.24-1

REMOTE

Purpose:To print or punch CMS files on an OS controlled remote terminal(2780/1130).
Format:.

- - .- -I

REMOTE "command" ndestination" filename filetype < filemode)

I
I
.._.

__

.-.-

-

-

--

-

-

--------------------1

I -~-----

._.

....

__

._._

---- ..... ------ ...

Where cormnand = :Print:The specified file will be printed on the remote printer with
automatic single spacing.
(,Printcc:
The specified file will be printed on the remote printer withthe first character of each record interpreted as ASA carriage
control.
Punch:The specified file will be punched on the remote punch.
Where destination = :..
NY2780 in New York City-VCS Marketing OfficeDC2780 in Washington DC-SBC,

Filename filetype<filemode)
identify the file to be transferred.
If filemode is omitted, PL is assumed.
,_

Notes:a.

b.

c.

Only fixed length records can be handled
Machine carriage control characters are not valid.
Punched output will be preceeded by an OS header card.
should be disregarded.

This3/12/70
3.1.24-2
REMOTE

('

3.1.24-2 REMOTE
Responses:
filename filetype filemode NOW SET UP FOR REMOTE "command" IN"destination". This indicates normal termination of REMOTE
Exarnples:ae

REMOTE PRINT NY FILE FTOlFOOl. The file FILE FTOlFOOl Pl
will be set up for remote p~inting on the NY 2780.

b.

REMOTE PUNCH DC DATA DAOl PS.

The file DATA DAOl PS will be
set up for remote punching on the 2780 in Washington, DC.

Error Messages:(REMOTE) RD10TE FUNCTION NOT VALID Command specified was not
PRINT, PRINTCC, or PUNCH. ·(filename filetype filemode DOES NOT EXIST ON YOUR FILESINVALID REMOTE COMMAND. •, .:...~~lrong ntimber of arguments specified
0

destination" NOT A VALID LOCATION VALID 0~"1:S ARE NY AND DC

YOU MAY NOT PUNCH f ilena~e f iletype f ilemode BECAUSE RECORD
LENGTH TOO BIG. Punch files must have LRECL = 80 or less.

.

THIS FILE CANNOT BE REMOTE ncommand" ED
Record length or other error encountered •.-.-.·:;,}.

_BAD REMOTE MODULE
Error was encountered in the REMOTE module.
your marketing support representative.

Contact·1

,.,,.

,,...

.: • 4. c

EXECU1ICN CON1ROL.d( 3105/01/69
3.2.0-1/??;~!)'~

05/01/69

l CJ le,] in t 0 CC I€
tegin cxc:cuticn.

by a LCAD commandand then START will

3. 2. (1-2
he called tc /:i':'.'/;:··,._,,

l'J ;~ .,,:?""'"._&-....
Suv~ral ccn•an~s are available tc the user fer execution ccntrol,
i.e. the leading and running of programs. Files(or programs) which
are to tE loadef and rur under CMS must reside on disk and ttust be ineither rclctatallc cbicct cede fern er inccre-imagc form.
A program
jr u:1ccatable chjcct cede form is one whose address references can he;nocifiEd tc cc1qcnsate tcr the relocation which cccurs when the(ICJr~m is loaJed into corn. A program in core-image form is cnn whichr~rcasents a ccrycf the ccntcnts cf core which uould be executable.
All cf its ftJrlress ref~rences have teen resolve~ and it can no longer
tE rElocated.

CutFut frcrr the asscmtler and all ccrrrilars supported under CMS
object cede, Unless an opticn to the contrary iss1>icificd by thluser, thi:> output will t:E crEatfcd as afilP. en theuser's rcrrnanent disk,
and will be assigned a filetype of TEXT.
All
fiJss whcse t11Pty~o is TEXT are assumed tc consist of relocatablectject cede ani are ircccEscd acccrdingly. 1o load such files into
ccre, either the LCAD, USE, or REUSE commands rray te used. The LOAD
cc1rrr.and will re2d the specified file(s) frcn: disk and load them iuto
cccc, ralcc~tin~ the proqrams, and estatlisbing the prcrer linkages
tEt'AEEll rroc;ran
scc;trcnts.
SCVEral cpticns ffd'i be sr;ecified in the
LC:\C ccmwari.d i.hich allow tlw user to specify text lil::rarics tc he
EE1cch~d fornissing subroutines,
tc request that execution of thelcl ieJ frc91an (~) begin, etc. USE and/o'r IlEIJSE should l:e issued only
aft.:r a iCAD ccn1rand has h~en iEsued.
The puq;ose of the USE ccmmandiE
tc lea~ thE SfECified
lEXl file(s)intc core and to establish
lirkd4e£ t~t~ccr these Froqr<lms and previously leaded fCoqrams.
The
R~ilJ~ ccn~dnd
r~rtccres the same function
as the USE command hut has
the ~jditio:nal effect of chilnqing the default entry point cf thcso
Frc~r~ros to that cf the firEt filename specified in the BEUSE ccIDmand.
A co~e-irra~c ccry cf any infc1rnation ~urrcntly residing in core~ay
tc created hy issuing the GENMOD command.
This connand willc r e a t 1: af i 1 e cnt h e · us c r ' s p e r rr a n e n t
d i s k 1' h i ch i s
a c op y of tt11?
ccrtcnts cf ccce bet~een the specified locaticns, and will assign afiletype c( ~CClLE
to this file. All files ~hose filetyre is MOCULE
a1e assu~cd tc be in ccre-imaqe form and are processEd accccdinqly.
1c loau
such file:.. intc ccre,
the l.01\DMOD ccmmand is used.
Since
3dJrcss references do not have to te resolved, the LCADMCD rrocess isfa.:;tn lhari tl-.e LCJI.[ rrcccss for a qivt:n prcgran.
isrelccat~ble

After fileE have teen loaded into core ty either the LOAD, USE,
h!UJE or lOALMC[ cc1mands, cxecuticn may be begun by issuing the STl\RT
cc~~dnd.
£)0cutio11 may also he initiated ty spEcifyinq the XEC Cftion
with lOAt.
i S US e d . t C l Cadand
5 tarta Sp e· Ci f i e df i 1e ,filetyp0, as fcllcws: (1)if a filetype of EXEC is
tci;r.t1, the.file wiJl te a~sum<:>d to consist of one ox: more <.:Ms c"cmmands
d!ld the EXf;C ccnmaud will be calledtc execute these ccmrnands; (2) if
a fil'"tn;e ct ~CDUi.E is found, the LCACMOC command will te called toloid the tile irtc
core and then the SlART ccmrnand ~ill be called totl .;in oxecuticL: er (3) if a TEXT
filetype is found, the filP. will he'I h C~trcnJing

0$

CC JI na 11 ci

en itE·11ie functicn
cf the GlCEAL command is to specify twc
tyr-es cf
littarics:(1)
litrarieE ccntaininq TE~T files which are to be
EEirchcd by the LOAD, USE, or REUSE commands for missing subrotitines.rnd uudefint:!d names, and (2)lib:aries co11taininq macrc defiriitlcns
which are to tE GEarched ty the assc~bler fer resolvinq undefinedn<1crc=:.
If the GLOEAL command is used, it should be issued prior toth2 LCAC, USE, EEUSE, 0[ ASSEMBLE ccmmands to which it refers.

05/011.3. 2 .1·
J.~.1//./?9'ONMOI:('_;?. j'!

ol33

Before the ccre-imaqe file is written out, all undefinedarc defined tc lccaticn zetc and com~on is icitializea •.E.Y!EQ.§.£:

lhe GE•HCC command. is ued
fil€S.

to qenerate non-relocatable core-image

05/01/69
3.2.1-2//:.,;:;;

sy~bols

H!gs:
Any files existing on the permanent disk with a filetyFe of
module and the sarre filenarre as that specified in the GENMCD
corr~and ~illbe erased before the new file is created by the
GB~KCD ccnnacd.
i.

f.f!J!.2):

GFNMO[

entry1<entry2>(NOMAP)G

entty1entry~

N

I
I
I

~.

1o leaf

GE~~CDc.
lhe tcbULE tile will contain~
unless (NCfAF) is sr:ccified.

is ar. entry rcint er a contrcl secticn nameincatinq the starting core location fro~
WTiTcli the c.ore-i.riaqe ccn is tc bQ gm\eratcd ..
It will also te the filenane assiqned to the
newly qeneratEd file.
is an entry rcint er a centre! section nameindicating the ending core lccation ftcm ·which the ccre-inaqe COFY is tc be generated.

intc core any files which have been createdcommand, the .ICADMGD command should he used.

d.
A MOCUIE file withcut aspace.

load· map of·by thethe core-iuaqe

lead map ncrmally requites less diRk

J!.£§.P.9.TJ.t!.L§:

None.
(NOMA P)

specifies that ~.lead ~ar is rict to becontained in the core-image file.

1121!!.flH:a.
GNEMCL FifiS1
Asaurring ttat a file which"ccntains an entry point FIRS1 has bean
loaded intc core r:rio1 tc issuing this ccmmand, the above example
~culd
ca~Ee
a core-image file to he created en the user's
pCL~anEnt disk. 7his
file wculd consist of the contents of cocefrcm <'ntry r:cint FiflS1' to the uext availatl<: load 1ccation and aloac mar ar.d it wculd have an identifier of FIRST l'lOCllLt Ji'1.

].§.1.9.S:

lhe GE•!CD command will cause a file tc be created which is a
Cofy of th' ccntcnts cf a srecificd rctticn of core.
Normally,
the lCAD, CSE, or REUSE commands will have teen issued prior to
the GES~CC ccrorrand, tc lead intc core the file or files of whichd ncn-relccatatle
core-imaq~ copy is
to le created.
!he newly
created file will te flaced en the user'E ~ermancnt disk and will
be assiyned · a filename of the first crerdnd specified in thetE~rco ccnrrand, a filetyre cf ~ODUlE, and a fileuode cf P1.
1his fil€ ~ill te in ccrc-inaqe fcrm and will te a copy of the
ccttents cf core from the first entry rcint to the second entry
rcint srccified in the GENMCD command. If cnly one entry pcint
if srecififd, the ccre- imaqe file will ccneist of a copy of thecontents cf core from the first entry point srecified to the next
availatle lead lccaticn.
(The next available load loc~tion isindicated ty a pointer which is updated after each LOAD, LOACMOD,
ts~, or RftSF. ccmmand is issued.}

GUIMO[ ABC DEF(NOl':AP)\iould create a file on the user's perll!anent disk
with a filEna&e cf Aue; a filetyre of MCDULE, and a filemode ofP1. 1he tile will be a cory of the contents of core fro~ entry~oint ABC to entry pcint DEF anda lead map will not be includedin the MC[[LE file.
t;.

'lids exa1q:lel!!&Ltlfgll.9.§.§:E(CCCC1)NO "entry1" MOCULEThis message indicates that the entry point(s)specifiedcannct be locatnd in core. Check to se~ that these entry-:?;--(.,(A.,. . .

" ''"I ~1!·--"'"''"'•+•'••u ...;.$41 .. ;;;wu,a;:,a;,1n.,@.",,MHw w; ,.¥§.,.

~·....,...:. ..

ae.. 111 .. a o.tt :eu a: ta~I£:::am ..... !11111111111!!1!!111!!!11111111111111111••••••••••••••••••••·
!!I,

""

~

.If/It\05/01/69,,<'JI lt/2 g~~ ~ ~{~93.2.2-1..:. .. "'/:-::~:;;/GLCEAL~,?.3.:rl.YH.f~£:GlCDAl specities either (1) macro definition libraries tc bP.
eearchcd during the ASSEM~LE ccurrand er (2) te~t libraries
to te searched when loading files containing celccatatle object cod~.

hn21:

I
GlCI!Al- - - - - - - - - - - - - - - - - - - - -I
ASSE~BtER

J~AClIB( ~)I. LOAI:ER 'IXTI.Hl
I('I)<lihnarae1 ••• litnameN>II
I- ~- - - - - - - - - - - - - ... - - - - - - ... l\SSI:MJ?LEF IHCLIE
pq

lCAtEE 'O'llID('I:)

spccities the library files that are
to be searched for mac10 definiticns
Jurinq eubseg6ent assemblies.

specifies the litrary files that are tc
te searched fer missinq subroutines
durinq subsequent LCAC, USE, or REUSE
orcraticns.

litnauc1.~.litnamcN srecifies the library ,files ~hose filctype

is either MACLIB or !XTLIB.

will scarct cnly one macro library: SYSlIE ~ACLIB. This file resides
en the c~~ system disk and contains roany macro definiticns of common
use to czs users. If the ueer has creat~d a file nareed SYSLIB MACLJ~
that residEs on eith€r his 1:ecr.ancnt er ternpcrary disk, i t vill be u~ed
l.11 1lace cf the system file,, since ASSEMELE searches first the p11rl:'<i1rnnt
disk, thEn the tewrcrary diek, and finally the system disk for the
specified Jitrary fil~.
Tc terminate the searclainq cf all macro libraries, incluJinq SYSLIE~ACLIU, thE GLCEAL nssE~ELEE command can be issued with no litnames
3pECificd.
.
One the ASEFMllLEH term of the GLOBAL ccromand has been issued, thespecified nacre libraries are searched for macro definitions
during cact asscnbly until either(1)
a GLCDAL ASSEMEL!B command is re-issued, or~MS~uclEusis re-initialized, or

(2)

the

(J)

the user lcgE cut from CP.

POL a further discussion of macro libraries, refer tc Section 6.4.0.

J.bJ\lU;..!Ll'.9.!.ll• Ihe I.CACEr form of the GLCFAL command allcvs the user: tospecify teJt litrarieE tc te seacchod fer roiEsinq subroutines whenever
the ICAD, lSE, or REUSE commands are -issued.
One to fcur text lihrari~s
rocty te srecified. ThcEe text litraries ~ill be searched in the ordur in~hich they are named.
If the system text litrary SYSLIB TXTLIB is to
te sc~rched alcng with the user's text libraries, SYSLID must he sp0cificJ
clS COO of the four libraries.,
Ectch text litrary e~ccified rrust have a fil6type of TXTLIB.
For a
cf TXTLin files and how to gencrdte them, see the TXTLIB
cotrnanJ. l~~ction 3.1.16).
J~scrifticr~,UJ.§!

GLCEAL Las twc fcrus--the ASSEMDLER form and the LCADER form.
~~J£lEL£~_JQ!~·

Th~ ASSF.MBLER f crm of the GLOBAL command allows
the use~ tc sfecify the sacrc litcarics to be used during the executionof the ASS!rBLE command.
Cne to five macro libraries ~DY he specified.
these ma~rc litraries will te scaLched fcL macro definitions in the
crdct in ~bich they are uamed.
lf the zystPm rnacrc litrary SYSLIB~ACLID ia tc tc ~carcbed alcng with ~he user's •acre library, SYSLia
must be Specified as one of the five litrariEs.

Edch mactc libr~1y spccifiEd must have a filctype cf MACLIB.
For adescri~ticr of ~hCLIF files and how to genecate them, see the MACLTB
ccnwand (Secticn 3.1.1C).

Unless a i::rcvicnr; GLCUAI. ccn:mand has been if;sued, the ASSEMBLE commancl

withcut the use of r.1013!11, the LOAD, USE, and REUSE cc~rrands ~eatch only
the text ]iJ;rary SYSLrn TX'ILIB. This file resides on the CMS
Eyslcm dis~ and contains many subroutines cf use to the c~s user.
It the user has created a file with the identifier SYSLIB TXTLIB
that resides cc either his rcrrnancnt or tnnpccary di£k, it will becsud iri rlacc of the system file, as the loading process searches
first the userrs permanent disk, then hie temForary disk, and finally
the Eysterr disk for a specified library file.
If the GLCtAI LCAUEf command has te~n issuEd and· the user wisbqs toeliminate the searching of the ~revicusly specified text libraries,
the ccmmand GLCBAL LCADER TXTLIB can te issued srccifying no libnames.
rhis will terminate all litrary search fer the missing subroutines~h~~ file£ are loaded by tha LCAC, USE, or REUSE COffimands.
cnce thu LCACER form of the GlCDAL corrmand has been issued, the
1X1LIB riles will be automatically searched fer nissinq
sutrcutincE durinq each LOAD, USE, CL RECSf until either

sp~cifieda GLO[AL LOACER ccmmand is re-issued, or

(1)

fat

05/01/69
3.2.2-3

3~~~9~jc2.J7 ,;:t:?:( 2)

the c~ticn lIBE is s~ecified with LOAD uhich overrides
the GICBAL LCADEF command for the duraticn of that
LOAC and any USE er REUSE ccromands which follou
that LOAC, er(3)

the c~s nucleus is re-initialized, or(4)

the user legs cut of CP.

scdrch (ct missing suhroutines will be SCOOP TXTLID, OPS TXTLIB,
and SYSLJE TX1LID.

GlCEAL lOADETI TX,LIB
This cxarrfle c~ncels the effect of any previously issued GLOBAL LCAOER
ccmwanf anf causes nc library to be searched fer missing subroutiftenby subsc.:quEnt LOAD, USE, or llEUSE cocmands.

H!9.Ll:li.;:;§_g£!.§!

further discussion on text libraries, refer to Section E.4.0.

E(C0001)

Jt th€ GLODAL ASSE~BLEfi ccmmand is issued, one to five reacrouAy be specified and each must have a filetype of MACLIH.

F (OOOO;i)l~traric~t. If th~ GLOEAL lCArER command is issued, one to four text
Jitrarics uiy b~ specified. and each must have a filety~e of TXTLIB.
~·GlCUAl willdee~ not e1i~t,d.
11

1·1 11verity the existence of the libraries.
an Errcr messaqe will be qenerated.

c/3.V

J.

]gg~:

3.

,,.<.:;~;/E (CCOO?)

If a librart

An invalid fcrm cf the GLOBAL ccmmand was issued.
Re-issue tl1e command in its cccrect format.
TOU ~ANY 'IX1LIB(rnax=4) OR ~ACIIeS (max=S)
SFECIFIED.
Re- SSU€ the GLOEAL ccrnmand reducinq
the nurn~eI cf 1 trarics specifie1.

litname 11 L113HAl:<Y DCES NOT EXIS'I.
Exi:;tence of 11 litnarne 11 MACLIB er 11 libnal!le 11
TXTLIE has not been verified; 11 lilname 11
ha~ been emitted frcm the active list.of libraries.

11"ASSHEIEl.i 11AC1lE 11 and "LOAtf.li TXTLJE" may J:;e al:breviatfid by
and 11 1 11 , rESJ:ECtive1y.

_!!gflfll~§_f?:~ere.

llU.Hl£~:d.
GlCEAL ASSEM~lER 11ACLIB NEWLIR ~Y~AC
1hc litrarics NE~LIU KACLI~ and MYMAC 11ACLIR will be scarch~d foe macro
detiniticcs during the ASSFMDLE ccmmand. TThe order of search·for uacro a~tiniticr.s will be NE~LIB ~ACllE and then MY~AC MACLID. The
sy~tem macro library SYSlIE ~ACLIE will not te searched.

GICEAL ASSE~ELEF MACLlE
Inis exanfle cancelE tle effect cf any fteviously issued ASSFMBLFR
tcxu of the GLCBAL command and causes no library to te scarchea for
macro dc!iriticns durinq execution of the ASSEMBLE command.
J:;.

(
c.
GlCEAl LOADER 7X1LIB SCCOF OPS SYSlIB
rhc libcaties SCOOP 1X1LIB, OPS tXTLIB will be searched for missinq
sutroutinei during the LCAt, USE, and REUSE commands. 1he crd~r of,.

"'.. i-oi· 9·-·,&,,JU . L JJEi!Q..El&U.'"&kl.b dW .. & Jfa .... .!JA . . . .:e . a; .J .".J . . uuz

""
•I

,,

!:
~' ~ 4\¥41 ;:;;1q1,~.~i~!~.P@#A#S~J $ ,gs; . ;JA.,.,QQCIJU@,!IQ,C::P'.?•1

,,.,.,~~( .;>_3'1

05/0l/G9

05/01/6'.;

3.2.3-1

ht:.Zi,_

LOAJ:

3. l. 3~'3f

f.Y!.tQ§<"!:

7//.:;;><Ye)

sur1ress the Frint cf RoFlace card imag~s in the file LOAD
print Feplace card images in the file LOAD HAf.

S ll E F.

)lg
I lP. r
SYSlU:LCAD

one or more 1EX1 files containinq
and loads then into core, establishin~
the proper linkages between the files. Corrections or additions
c~n be madi at load ti1e an8 the user can specify libraries to be~eatched f cr missing sutroutines.
The user can also specify that
Exccuticn shcuid beqin urou successful ccrurletion of loadinq.

teadE

from

disk

r~lccatatJc cbject cc~e -.:.,.

the loaded files.
de rot execute the lcadEd files.

I.!}.§ j_;jf :____ _· I

1libname1 ••• litnameN>II

f

JlClCI filename1 ••• filena~eN <(oFtion1 ••• opticnNI-

filcnamL ••• filEnaneN

EJHSify the names cf 1EXT files
to be loaded into corE.

c~ticu1 ••• q:ticnN

si~cify

the options tc te ineliect during loading.

litnime1 ••• litnaweN

SFcify the names of TXTTIB files
to te seaiched for missing
sutrcutines durinq leading.

Che ~EXT files specified in the LOAD ccroroandrclccatable object code, such as that produced
FUF1~AN, CI PL/l ccmm~ndE.

must consist· ofby th€ ASSEMBLE,

Since lOAL assumes the NCCLBAn Cfticn as a default,
the fil~s
thdt ate hei ng leaded will not be placed in zeroed core. To zerocore tefcre the files are loaded, thE option CLEAU must be
si.;ecifiE:d.

ICAt auterratically begins leading th~ s~ccificd filAs into core
hexddFcimal location 12000.
This load point may he cha~qed by
specifying the CFticn SLCxxxxx, ·where xxxxx is the hexadPcimal
locaticn at ~hich loadinq is to bEgin. The SLCxxxx~ CFtion ~ay
not appFar as the first Cfticn in a string unless it is precRd<!dby enc or nore blanks.

~l~ftj!;!)§:CLEAR

HfH ..H

zcrc the load dICa before loading.
de net zero tbe lead area befccA loading.

HfJiJJ.$;

Legin loadinq the Frcqram at bexa6eciwal locaticr xxxxx.
lcgin leading thL Ficqran at hoxadecimal location 12000.

r.c 'I H!.Alcreate the file LCAC

1'H E

ty~ES tte file LCAD MAP c~line.
Jc rot type the file LCAC MAP online.

SLCxxxxx

H.!.UiSD1

HH

de not create t}c f i]c LCAD MAP.

~U[}CESS~AP.

the rrinti~q cf invalid car1 imaqes in the file LOAC MAP
Flirt invalid Cdtd im~qcs in the file LOAC MAP.

~AP.

sEarch cnly the srecified TXTIIB filos for missinq subroutines.
search the SYSLI~ TXTLIB file for missinq subreutincs; or,if the GlCEAl LCADE~ command vas previously i~sued, searchtte libraries that we1e SFecified in the GLOEAl commandlist.
~xecute

XI::~
~ggs;

H!HJ::

3. 2. 3- 2/;/~{:'

Lnl0Es the NOMAF option has teen specifiEd, a load ~ar will bP.
crtateJ ct the rernanent disk each time the LOAD ccrrmand isitisucd.
A load mar is a file that ccntains the location of
ccctrcl Eections and entry points of the filei loaded intc ccrc.
lt may alEc ccntain certain messages and card images cf any
invalid cards or Ferlacc cards that exist in the leaded files.
'lriii:; load mnr will ncrrrally he crcat0d as ;i !il'~ with tho
id~ntifier LCA[MAP F5.
Cnly one such file uay exist an the
pcrnanrnt Cisk.
Each tilrc lOAD is issued, a new LCAC MAF willre~lacc ani
pravicus LCAC MAP tilE that exists. 7c rrcvent a
LOAL MAP filefrcrn teing created,
the Cftion NCMAE rnust heq>.ccificd ~hen the LCAD command is issued.·•
Since lCAC assumes a default of NOTYPf, the LCAD ~AF file is not.
iutcmatically tyrcd cut unless crticn TYPE is Epecified when LOAD
is iESUed.
See FIGURE 3.~:3-A. The LCA~ rAF file m~y also be
flinted Olt by usinq the PFINTF or OFFLlNE ~BINT ccrrrrand.
lt invalid card images exist in thefile er files that arE beinq

05/01/:69

05/01/69

3.2.3-3

3.2.3-4

they will be listed Yith the m£-~sa9e 11 INV/l~ID ~ARD" in p)J)/
the LCAL YAP f il~.
7c surrcess the listing of J.nvall.d card . , r
irrdqes .in the LOAC ~AP, thn option SINV must be specified.
~}lf;lodd~d,h~ :n po r a r y d i .!': k wi t h t hei d En t i t i er s Ys L IB TX TL IB • l5%:/it•will he used in r-lace. of th~? system text .. .1 / , J
llblin:y bcCiiUSe lbe order oi ~earch for the SYS LIB v""' · " TX11If file is fir~t the per~anent disk, then thetemror<lry disk, atd finally the system disk.
lead w (tyr:c)W
Ii

AT 12COC
AT 12000lllct'CO.'lll A'I 12148
SAVAFEA
AT 131QC

lRCOM
FDIOCS'Ic

1-rcvcnt IOAIJ from searching the systP.m text
a11cl thefih•s srecified
hy GLOBAi.,th<?
LlUE CEtiot car. be Erecificd.
The LieE option
tnrminatcs the searching cf all text litraries
cxc<"(.t fer these s1;ccified 1dth the LCAr: ccrn:nand.
If SYSLIE TXTLIE is to tc searched alcnq with th~
specified lituanes, SYSLIB rrust be included as oneofth•~ litn;ir:ies.
l'hecrder of search ofthnsrecified litnanes i~ the order in which they arenames aud they must have: TXTLIB filetypes. If tJH!
LIBE crticn is issued anduc TXTIIB files are• specified, no TXTLIE ~iles will be searched for
roit=:rci r.q f:utrcuU ncs--nct even SYSI.lD TXTLIB.
Fol:"a discussion of text litrary usage,refer tc
Secticn ~.4.C.
libi:ury

AT 121Q8
AT 12204

lHO'C V'Ill A'I 131 9 8

ADCCH
FCVEO
FCVLC
FCVlO
FCVCC
FCVAO

AT
AT
AT
Al
AT
AT
AT

FCVZC

13198
13UUA
1JQ12
1372C

13tE4

133BA
132EllIUCFIOSH A7 14188
FICCS
AT 1418€
IHCVA1eL AT 14D7C
T !IF FCl LC H HG NAMES ARE UN t E F IN ED:

Since LOA& aEsuces tCXEC as d default cr:tion, LOAC
doP.::> not nox:wally teqin execution cf thP. lcadecl
filus.
To cause execution to begin irrmcdiately
urcn Eucccs~ful ccrrpletion cf loading, the option
XEQ
can l;especified.
10/\llwill thc~n transfer
ccntrcl tc the default entr) foint in the progr~m.

sue1

E {00004); 1'=2. 33

FIGURE 3.2.3-A.

TYEPCUt cf the lCAD~AP

Th e c1 (J f a u 1 t c n t L y p o i n t i E
e i t he L ( 1 } th e a d d r Q s s
as ! p1 cificcl in the or:0rnnc'i field of the first EllD

file durinq the LOAT

cat<l imay0 contai~inq a non-blank operand field or(~) the tcqinninq cf thefirst file loaded if all
ENO card imaqcs in the TEX1 files contained blank
CFerand ficldE.
In the CdEC cf TEXT files thatare created ty FOBTRAN, ccntrcl will te fasEed tc
the first rrait ~rc91am leaded.
If tho XEQ optio~
is not srecified, the STAPT ccmmand must be issued
tc beyin 1rcqrarn executicn.

If Ft~place(fiF.F) card images exist in tl1e files
teing leaded, they will be included in the> LOAr:
MAP. To suppress this listing of REP card imaqcs,
the option SRFP must
tf specified.
Fer anexflanaticn cf REP card i~agcs see Section 5.3.0.
Unless the GlODAl ICADRR ccmrrand has b~en issued,
LCAC searches only the system text litracy fee
s u L' r o u t i 11 E: s t ba t i'I re mi E s i n q
f r om th e f i 1 es b n i r1 c;loaded. The system text litral:"y is the file that
ccntains 1EXT files and has a filetype of TXTIID.
From one to four· text litraries can tE searcheddurinq lcadirg by the user having previously
issued the lCADEE form of the GLOBAL cc~mand. If' the Fystem text library is to be searched inaddition to the text litraries specified with the
GLOBAL LCAOER ccrriand, SYSLIB must te included as
one of the tExt librari€S in the GLOBAL LCADER
ccrnrrand.
sie the descriptionof the GLCBAL
command for the specific details.

If a

""

file hasteen createdon theFErmanent or

LOAD allcws the uEer tc include the follcwing card
iru~qesin theTEXT files
alcng ijithth~rc~ccataLlc cticct code: theSet Lccaticn Counter(Ste) cdrJ
imaqe, the Replace (flEP} card irnaqe,
and the Include Central Section (ICS) card ima11e.
Th<! SlC card i:nage .sf.<'cifies the hcxadEcimallccaticn at ~hich tiles are tc be loaded. 'Ihe REP
card iraaqe s~ecifies ccrrecticns to he made to th~
relocatatlc object code.
1he ICS card image
srecifies additicn~ to b~ uadn tc the TEXT file.
For a descri~tion of tbEse card images and tbnir
use and Flace~ett in a 1E~T file, refer to Section

5.3.0.
l:!f!£~:

~

~

~~~-~
~

I

'I

II"

fl"

d /3
J.
The
tilenatr.ES
srecified ll'USt
lihnaucs rrtst h~vc TXTLIE filetypes.

is

TEXT

filetypes:

05/0l/G93, z. 3 - 5

05/01/69
3.2.3-6/})!J}">

c=/.//
J' /1;:~
/

th·~

I

c.
tbAr MASS WEATZI1 (LIBE) SSP MYLIE SYSlIB
Ihe files !ASS TEXT and WHATZIT TEXT are leaded intc ccte and thelinkages tEsclved.
If any subroutines are missing, the follo~inq
litnames ~ill be searched in the order in which they are
specified:
SSP TX1LIU 1
MYLID lXTLIB, and SYS1I8 TXTllD.
Thorenaininq CFticns are set to the default o~ticns.

llBE option is specified and the system text library
SY5LIB nust he siecified as one of the

If thE
to tc

~.

have

""

scacchc~,

Jitrame~.

c. !o terninite the searching of all test libcacies, including
SYSL1B, s~cciiy the llBl crtict ard de net SfBCify any libnameB.

1.
lCH t'.ASSPEC (Lil:E)
1he file PASSFEC !EXT is leaded into core and the linkages
reEclved. If any sutroutines are missing, nc text litraries ~illt~ searchcf, siuce
the LIRE CFtion was
srocificd without qivinqan } 1 i l: u am es an :l an c r r c r cc de wi 11 t: e r Et urned.

.HH9!lt~.§:EXECU11C~ BEG1N5 •••111€ XEC q . tloin was si:ecitied with
frcgram ha~ tcqun execution. Any

theLOAD commanil and the leaded
further rosronses will be fcom

lH.9!-.tl.£.~.H?.9..sE§:

IICqran.
I~VAilD

lh~

t~e

PINV

E(00001)
DEflNED MCRE THAN ONCE-xxxixxxx
The name xxxxxxxx has been defined uore than once.
Check
the tiles that have teen loaded for either duplicate entry~cint nnmes of duflicate ccntrcl section names.
Loading has
been ccrr~lutnd.

CA6D - xxx ••• xxx.

c~ticn~ass~ccifi~dwith LOAC anl aninvalid card bas'Jhe IH~!.;~<l<Je
and th0 contcnb' ct
the invillid C'lt:<i(nl! ••• xx;i) <lrc li!-;t.Pct in the file I.CAD f'Ar.
Th<:0 invalirl card i.s
i y 11 c i. '~ d <ir. c ~ c ct d i n s c c n t i n ue E ~lcc11 tcund.

CCN'IH.L URI: ~leader

C:N'l~Y,•••

tr library-search cQntcol, card wasE(COC02).CVEHAY HliGR
The files teing leaded have run cut cf ccre.
Specify fewer
file~ er
reduc1? the size of the fil1rn.
Loading
has tnen

en6cuntered; e.g.,

CClf·[lEtcd.

l.IlfJ\HY.

E(GOOOJ)
1L th>.! TYn
Oftion is q;eci.fic!rl with the J,OJ\D comll]an<l,1"JAI:' file: wil1 tE typcl cut (st~C! FIGUH:E 3.2.3·-A).

the LOhD'r!J(;ri:=

PEPtHENCE
ill:( tee

S'!CtlCll n,lrnCS

1A~l~

CVEfFLOW

rra11yc;ntrie::: for (?ntry pcirH::: on coritrol"ill tho ICf<!rence
tatlE that is huilt flurinq

loading. Leading has beer ccmileted.
Reduce the number ofentry rcints and control sections in the fih!s.
t~.:H.1:1£.§:E(00004)

cc re a n d t helvcd. Ccte iE zerced before Joadinq takns Flace andfile is tyvPd out.
Upon the successful co~tlntion
ct lcadin<j IHSC:7 aud llOOK, the lcadec1 fileE l i i l l begin f;x~cution.

linkaqEc
the lCAD

re~
PA~

issue

the USE-----•·-- --- --

~

NA~ES

ARE UNCEflNFD-xxxxxxxx

ccmmandfor that.

file.

F H E N0 'I f 0 UN D-· Xl! x x ll x x x
A tile with a filename nf xxxxxxxx
filEt)pE cf TEXT.

Loadinq has

be~n

E ( CCCC(;)

dces not exist

with a1!.Yl.!.!1illJL1.Q.£.Qi.n.9\..Jruring proqcom

deck 11rrayn~solved,-·-·"'-------~,~·..----··...-~~·-,-·- -·~~M----~-----·•

FGlLCWI~G

CcmrlEtCd~

f,QXEC.

l:.
LCA[ PS67 EOCK (X!::Q 1HE CLEAR)·1 he f iJ e :: n· 6 7 'I' l:. X'f
an d I~ c; CK T J:. X T a r e 1 o a 'l Ed i n t c

Tll~

The ne~Es
xxxxxxxx are refereDced in a file and are nevnr
dc~inEd.
It
tho names nee defined in ancthct subroutine,

LC>l mAIN SC3 CAllU
1 hf; t i j(_ 5
I'~ 1 ~ 'IF. x I • s C3
T F.X T I andc JI I.cu 'I" Ex T a r € l cad€ d int ccoLe and tl€ linkages rcsclved. If any subroutines are missinq
Jnd the GLCPAL LCAfE~ command has not tc~n previcusly issued, th8
flh
S"iSUli
1X'ILitl willl€. Hat.ched.
I f the GLOl!AlLCADERcoru~aud has
been previously issued, the litnamcs specified inth.Jt cc:r·rrzrcl. will l:c i:;eilrchcd.
'Ihe> fcllcwinq defai;lt options ar.e
£et:~CCll:.A~, NGTYff,
SLC12000, PINV,
PREP, MhP, 3YSLIB, and
~.

te

and

execution, ancthc;c 11 i.:elcc11ta~lc ohjet::t
trcught into ccr£,
external references
ccnti:cl c1iven
tc itthat is dynamic

3.2.4-1J0,,-..1if;;/
leading. The desiredwith a f il€tyfe cf
d~sigrated libraries
may cause other TEXT
intc core.
'lhrce CMS/OS

05/01/69

routine must Exist en the user's files'IEX'I,(2)or e >list in one of thevith tiletype of TXTLIB.
The routine
er library routines to also be loaded

ma~roeEloadir.g:

3. 2. 4

vlf-6

f fil..Q~.§_g;.

'Ihe ICAD!CD ccnaand lcad1 intc core any single file~ontclccatable core inage fct1.
may bP.

used toinitiate dynamic·

which is in

I.2.!~J.ilCAD (SVC 8) - will cause the otiect deck ccntaining
the s~ecified entry r.cint to be brought
into core and the entry point addresstc be re~urned in reqister zero (0).

I

LINK (SVC 6) - will call in and transfer central
to the sp:cifiEd entry point.
XC'lL (SVC 7)/,G~/,.

lChDfiCD

3.2.3-7

LC AJ:.M C [filcnaGe <filecode>1

ICADl''

filenar.e

will delete the. 11 cd.llinq" .routine, thenthe specified routine will be brcught
in and qivcn central.

tiler.ode

is the name of t~E file tc he leaded into core,• whcse filetyFe nest bc.~ODULE.

is the mcde cf the~CDUlE

file to he loaded.

.Y!~.9~J.

H'I URN( XVC l)used to DELETE (SVC 9)"Called" routine and gives central
back to the "caller".
tb~

lCADH0£ is used tc lead a file uhich tas been created by the
GENnCD command.
7be file~aae cf the file to be leaded isE~ecified as the operand of the LCADMOC command, and its filetypenust be MOtULE.
•h~n the ICAttCD command is issued uithcct sFECifying a filencde,
the user's Eeinanent anc tcnpcrur} file ditectories and thesystem file director~ are searched, in that crder, for a file~itb
the specified tileta~e and a filctype of ttOtULE. If a
filcroode is given, only that disk is searched for the MCDULE
file. If such a file is fcund, it kill be assu~ed tc be inr.on-relccatable ccre-image fern, and will be loaded into core.

l!.!E fil..Q.!..§.§ .§_;
lione.
EJJ!J!!J?.l.G.
LCA[MOD FILE1
file vhcse tilerame is FIIE1 will be loaded intc core,~rovided it has afiletyfe cf MOtULE.
lf it does not, an errcr
iessage ~ill te retutned, and the leading frocess will not take

a.

1he

~lace.

·~-

I~;::::a 141142 $

9

I~

~
'"f~{4fM!Pf ii~Mlii?'H~'.~m.;c.a. .flM~¥ I;;;a,, s ,.f1iii d' .ji.,"'H ;).,u;; . ;·-Ir.MUI¥-" L\. JIJLW.:(·11i rii 'r·~'~ f.f

Iw .~);;., ;~. 'mM"••~-ij

"'

""I

~

05/01, (i3.2.4-2

h?ff
L!.!.Q..L~~£A.9~1Lt

o?l7

FllE tCES NC1 EXISt.
I:ISK ERliOR.
Eitbet cf the abc~e neseaqes indicates that a file uith thespe¢ified filcnaue and a filetyfE of ~ODULE cannot belccatedin theusec•s fer[anentor tempora~yfile
directcries or in the systen file directory.
Check to see~ ttat such afile existf and that the filena~c specified in
the ICAtHCO conmnnd iE identical tc the filename of the filetc te leaded.

E (0000 1)

DI~K

E ICCCC2)

EHRCF.

An address bas teen generated cutside the tounds of corestorage assigned to the user. Attem1t to re-issue the
ccc:.nand.
l (CCC03)

tISK ERBOli.

A disknalfuncticn has occurred.
Re-issue the LOADMOD
ccre~and.
If thecessage persists, a disk hardware Jtcblem
has, 1rctatly bi:cn enccuntered.
FILE

E ICOCC4)

DOE~

N01.E)l5l

DISK EHCF.

cf the abcve nessages indicates that the filemode ofd c e s no t .t e gin "it h P, ~: , or S • Ch an g e
the filemode tc a valid cne, if necessaryr and r~-issue the
ccr::tcand.

05/01109

points exist and re-issue the command.
a1coo02)
CISK ERROH.
·
An adfress has beenstorase assigned toccmroar.d.

' 3. 2. 4 - 3.::1/Y m~,

genctated outside the bounds cf core
the user.
Attempt to re-issue the

DISK E~Fon.
A disk nalfuncticn has cccurred.
Re-issue the GENMOD
ccmward. If the messaqe persists, a disk hardware protlem
has FIOtably been encountered.

E(00003)

DISK FRHOH.
An attew~t t9 close the file aftet writinq it cut has notteen successful. Issue a FINIS and than re-issue the GENMOC

E(CCCCll)

cc1n1rnnd.

E(COC05)DISK E&F06.
An illegal seccnd character·· has been
filerrcde. Re-issu~ the GENHCD command.
E(C0006)The

DISK EFFCb.
has att£r~ted tc clcse
it. BE-issue the GENMCD command.
s)ste~

encounteredforthe file prior to openinq

Eit~ert I. espec i f i e d t il c

E (CCCCf)

DISK ERBOE.

Eitbet ccre E~Jce assigned tc the tser is not large enoughfee, leading the sr:ecifieCl file or the syste!l' ha:: attemr-ted
tc clcse the file FiicL tc ofening it. Re-issue the LOAtMOD
ccml!land.
E (CCOO.l),[ISK l!RROB.

specified file catnct le read tram disk. Be-issue the
LCACMOt comruand.
If this uessage fersists,
the file has
ftotably been writter. cut
incctrectly, and shculd be
rE-creatEd usirg the GE~~CD command.

Tt~f(00009)

tISK ERRGB.

1he Epecificd file is cren for writing and cannot currently
te read. Re-issue the ICAD~CD com~and.
CISK ERROR.
Eitjht file~ arc alrc~dy CfEn, and the EFCCified file cannot
te CFer~d. Issue a FINIS command, and then te-issue thef(C001C)

LC.~MOD

Cc~mand.

F(CC010)DISK E~FOE.
Eight files arE already q:ene.d, a11d the command cannot heeXEctted. Issue a FINIS ccmmand and thAn re-issue the GE~MOD
command.
E(CC01J)DISK

EBl.Wfi.

1he UEcr•s disk ie full, and the ccr~-imaqo file cannot becreate:d.
E.rase c11e or more of thH unneeded files andre-issue the CEN~cn command.

c,: I
3.2.

.;lc;-u/;(?,;r~.;. ~Id:USf.

It CJ lion£ ~ere specified with the rrevious LOAD,
USE, oc REUSE
cciroand, all the Cfticns renait Ect for REUSE unless each option
is E!Pciiied when HEtSE is issued.
1hu LCAD NAP files is
1utowatically updated to reflect the files bcinq loaded by RFCSE.
&01cr to Sccticn 3.2.3 fer ade~crirticn cf the LOAD ortions andd/I

f!H.Ef.§£1th'" tCJ\V NIP file.

SlUSf. reads fccrr disk ere cc more TEXT files -- containinq
relccatatle object code·-- and loads the~ into core, o!>tahli.shinq
linkage~ \ith Froviously
loaded files, and chanqinq the default
entcy roint cf theEe tiles tc that of the first file specified inthe ~EUSE corrmand.

if!3:IfD~S£:

I~VAIID CARC xxx ••• xxx.
lhc FINV crticn was Erccificd with the rrcvious LCAC command andin invalid card has teen found.
The message and the ccntents of
the invali~ card (xxx ••• xxx) are listed in th~ file LCAr MAP. The
in~alid ca1<l is ignored and loading continues.

!21;!!!.!l..t:I
I.
JrifUSf JfilenaaE1 ••• fi1enarreN (cfticn1 ••• cFticnN) <lihnamel ••• libnameN>
I

CCN1FCL (AHC
ltadcr er litrary-scarch control
loadinq lEEurr~s.

Ifilendme1.v.filenaDeN

specify the names of TEXT files
to be leaded intc cere.

or:tion 1••• cpticnN

Epecif~ the cpticns to be ineffect durinq loading.

Ir the 1YFt epticn was srecificdth( Frcvicts LCAD. USE, or REUSE
tl1E LCAD MJP
file will le typed
the FEUSF ccrrmand.

~EUSE

EEUSE er was net reset frorn
command, the updated rcrtion ofout prior to the ccrrfletion of~ith

EEACIT GAMMA
filEE cf RfACIT and GAMMA ~ill ~e loaded intc coie,
linkagEE ) j ] ] be rosclved kith the files prP.vicusly leaded, andtbE ddtault entry rcint will be cha11qcd to the first er.try rcint
in HEAC11.
~.

lhE~.EU.sg:

Ihc epticnf that nay be srccitied withthese \ith LCAt.
Sefer to Section 3.2.J.

Ncrrnal£..!J..!!lJ~:

specify· the namEs of 1XTLIB files
tc te sGarcheJ for wissinq rcutines
durinq loading.

litn1me1 ••• litnaweNcard wan encountered.

are thesame as

R~USE

1E~1

1.lHJ_f££Ei!_grn:
DEFINEC MCRE 1HA~ CNCF - xxxxxxxx~<ish'cn d1::finccl mer<' thar. cncc.
ChecJt the files
that tavc tc0n leaded fer either durlic<ite entry point names
er u q.licate control sEctio11 na11c~.
Lcadirig has been
ccirrlctcd.

E(C0001)

The r.arr<=!§:!.9.£:REUSF •oes not ovcrldy any file that was rreviously leaded by ~LUA[, USE, or REUSE ccnrrand. It lcadE the sr~cified files intc
h.i<jhe~ cctE'
t com thu Foint of which t.l:e rrev"icus LOA o, USI~, 01~EUSE
ccnaand tcraindtcd leading.
~EU5E
rcrforms the sa~lfuncticn aE USE exc~rt th~t REUSE chanqes the default entry reint
to that cf the first tile EF~cified with REUSE.
the specifjcd tiles arc reouired to have filetypes ofsoculd ccntain relccdtatle ctject code.

OVUUY l:.hRC!i'Ihe files being loaded hav<: run cut cf ccre., sr;ecify fevl'.!r
1ilcs er reduce the si2e cf the files.
Loadinq has be~n
ccmplEtca.

E (OOoo;)

TEX'l" an(bEFERENCE 1ADLF CVEhLAY
TherE are toe many entrieG for entry· points er ccntrol
secticn namEE in the reference table that is built durin~~(CCCC3)•

1illO:MiI J ii

I"""

llJ1itilt"1!i,,llilliiol,,,• .# ··'""""''•

'

~ z;

•
4; 4\1.

, ,,I, . ,,"''"'''""'Ill ;; 11411111 i#iiMiJS iii!iiiji 4111. Uiii i.iiiii!i Ill .iii141ii II. I# I41

I~
11$1 '"'""""'" ., ,.,.,,,. " '"'"""" r .,,.,"l'I" ,,. ,.,.2 i2£ii

4".14. 4.Wi . . . iiii JiiJl4 ¥1M.P•i li&,.-, •.""'""''''"'"'"'"'""f"··05/t

I t..SJ
3.2.5-2/l/;'{:

""'1\

cJ67

/ft;~
c '

Loadinq has teen•~

NA~E IS U~UEFINRC - xxxxxxxx
rawc xxx~xxxx SFecified as an entry roint does notexist • ._cadir.q ha£ l:el'n ccmrlcted.
Chr.!ck the name and s~~
if an cntcy
point or a control section cxistn by that name
'Ih~

J.~.6

IJ/..· '>,:?{;J-.><..

S'IAll'I~~~Q~

STAR1 Loyins execution ct proqrams previously loaded and Fasses
the addreeE cf a string ct uso[ aqrumentE to that proqram ••ccnpl<~ted.

E{CCC05)

O'J/

.I. '

1Ht FCLlCWI•G NAPES AFE UNCfFJNED - xxxxxxxx
tarrcs xxxxxxxx arE [Eferencea in a file ana are neverdefinc::d.
Ifth<· n;rnc£ are dotined in another file, issuo~(CCCO~)Tt~

t:EE ¢cmmand !or th<1t file.

~ :.

05/v r.
. 3. 2 ...

loaditg.
Loadiriq has teen ccuq::lete<l. Reduce th1:l number ofcntr) points or control sections in the ffiles.

thn..-.._·!"'\l·_!£.!!!!~.!:

in the H:adc:d files.
S'l'1HT&: (CCCC6)

A filEtll..E !lO'I FUUND - .inooxxxx
with a filename of xxxxxxxx

filEt)FE~cl 'IEXT.

does not exist

II
arqumunt1 ••• arqumentN>II- - - - - - - - - -~ -I <e:: tt ry

with aI

Epecifies the name of a control section
er entry rcint tc which ccntr6i ~ill he~assed at execution time.

en tr~

a1~crnent1 ••• argcmentN

EFEcify intor[aticn tc be
Etacted program.

tc the~asEed!Jr i}::Js:
STA~1

bc~jnscxecuticc

atone oft~c

entry

points.

If

the"entry" oi:;E:raud is spccitiE:rl, e:(ucution bcqiris atthat pcint. in
the ft"Cgrau. If 11 €lltry" js 11ct srecified, E'XECUtion l:eqins at thed{dault E:ntr)' icint.
'Ihe default entry pd.nt is eithE!r {1) the'3 d d l <' s i: ;u s Fe c i t i c d
i n tt1 E; o r. e r a n d f i E l d o f t he f i rs t Ell D ca rd
imagf ccnteining a
ncn-tla~k cferand field er(2) the heqinninq
ct the tirEl file loaded it all END card i[Rqes in the 7EXT fil~scontained llan.k cpn:andfields.
The default entry
pcint. can bech<rngc11
ty
issuing
the IH:U!:E
ccrrmancl.
to continue loadinq
aaditicnal files.
Refer to ~EUSE in Section 3.2.5.

Auy undefined nameDor references that ares~ccificd

Jn the files

loaded intc ccre 1<ill tc dcf incd
tc lccation zero.
Thu~,
if
thc1e is a call or tranch to a subroutine frcrr a main ~roqram dn
the suLrcutine was never leaded, th~~ call er branch wouldt~ansfcr central to location zero at execution timo.
I i arqurucn1s
are specified with START, theyp i: o <.; i: n IT v i a c; 1.n o r a 1
r u r. c s c r c ~ i s t c r 1 • T h c

are paseEd to thec n t r y 11 o p e L- a 11 d a 11 dthat a::; a string of
11. rn} arqurH:r:t'
arc set up in a rarametor
i.ords,en nhJUment
per· doubl<' word,
andtheaddr.eu: cf
r:aril111Cttr
ti.at is[lact:d inqcneral FUtfCS<~ r.cg:i:=toi: 1.

::iJ:<JU11·e11t!:

an•accEs:snd wi.1.h

di.~q:lacvmcnt.s

of

El,

16,

211,

the

The
etc.,

,'6'J

3.2.6-1.1.1-><Y'/l,l-J~05/0~/L

c/53
trc~

address contained in register
frcgran l:eqin£.

thP"'l"ciU~d

1 when exccutic11

of

05 /0l/69
the 3.2.6-2/45-;;/

3.2.7-1

3. 2 • .,USE

v-16{/ ///{JfYH9.§f:lH~H:

ESE reads fr rn disk one or more 1EXT files -- containinq
lclccatatle cb ect cede -- and leads thcrr intc ccrc, cstahlishinq
linka~€S ~ithrcviously leaded files.

€ithcr a ccnttcl sccticn name or an entry
I t ma)not l:e • a f ilena mr it the filenan.e is notlJ(nticdl tc Either a ccntrcl section name or an frntry point"t.nt1y 11[ c i t1 t Ta ft•\:' •
1.

must

t~

fi,i O•C •lf.L!!~.~:

t. lf u~er arquments arc specified, "entry" 111ust t:e specified,
ctl11wibe, first arqureent will be takeu as the entry rcint.
I

I

I

I

1us~1f1lenarrc1 ••• tilenaneN

iHHJ::£f.f:

EXtCU1lON BEGINS •••lhc ftcgran th3t had teen previously loaded intc core bas b€qUn
EXtCUticn. 1~€ tef[Cnses nc~ ~ill be fIOU the rrcgrarn that is
E>;CCUti11q.

- ~ - - -- -- - - - - - - - - - - - - ----- -i i l<:n.Jme1 ••• fiknan:eN

speciry the names of TEXT
tiles tc be leaded intc core.

opticn1 ••• c~ticnN

q:ecify the cptic11s to he in
Effect durinq loadinq.

Jitraw~1 ••• li~tarneN

specify the names of 7XTLIB
tiles tc te searched fer
missinq routin~s during loadinq.

l!H.kl.€:5:d.
STA~T
lNITIL!he f[cgran taat has already been loaded
CX€CUtinq at the entry rcint INITlt.

intc core\ill beginb.

~1AR1 rtGO~ 13 All 1C943S
lbE ~rogran that hat already heE11 loaded irtc ccrc ~ill begin
e1ccuting et tbc entry rcitt MEGOP. The three arguments may be
1CCCESCd in theptcqram ty usinq displacenents Cf 8 1
16, and 24
trcru ttc aidt~ss ir general FUifOSe register 1.

!.H~.L~£g!UJ£J;:<(c~ticn1 ••• crtionK) <libname1 ••• litna~cN>>

I
J
I!;f.!.!~ g:

1he crticn! that may be srecified ~ith
1dth LOill:.
Refer to Se:ction 3.2.3.

tSE arc the same as those ·]§~J£:

f(COC05)
NAME IS UNDEFINEC - xxxxxxxx
lhe na~H x,xxxxxx specified a~ the point at which execution is totegin docs net exist as an entry feint narre or a control s~ction
ttdmc.
Fxecution has 11ct bequn. Check the name xxxxxxxx and ttake
sure it is a valid entry pcint er central section n~me.

cot cverlay any file that was rrEvioualy lca~ed by a
ccrrnanu. It leads the srecifi'cd file(s} into
hiqlic1 ccr«.:'tram the pcint at which the' p:cvicus LOAI:, USE, or
BEUSE corrnand tcrmin~tcd leading. T~c files specified with USE
arE required to have filctypcs of TEXT and should ccntainrclccatatlc ctject cede.
lSE doeE

LOA[,

USE, ·Cr HE!JSf

USE shculd t~ rrcce<led ty lCAD; it is ncrn~lly issued to resolve
u11dPf.inC'd ramcs t.ihe11 LCAt qives the, follcwinq r:rror nessaqe:
E (OOCCll) -"11 111ii!iilllllll;;:;:;¥if'""

lllE l:OllOW HG

t\A~.ESAFF U!JtEFIHEC:

xxxxxxxx.

~~' " !,%ii!Midl,'ffl!fif~r¥ ! "14iWri\,, ~~·~,~~,rifl\!',•$1·1

9 ,Jh,ifiiilJH!!!iiii!#ji''!lr.t!!IMWJl''t >f ...;,;;;u.jW@ii!Wil'Ji!

,,..

,...,

~

05/01/69c/r_;-j_. O.,

i2V

3.2.·. -2

7-/ 3.2.7-3c>(":),t"J r;\,_,.

control sections in the tiles.

/,/'//-?

U5! may tc iEsu~a re~eatcdly tc

resclve linkaqes and to continun
leading ncte 1EXT files.
It does
not change the default Entry
poi~t estatlished in a Fre~icus lOAD comrranJ.
crti¢nE were srecitied with the ~revicus LOAD,
USR, oc REUSE
ccrruand, all tho crtions remain set for USE unless each option istHspccitiEd whun
us~ is issued.
The LOAD MAP
f ilc
is:iutcrratically updated tc reflect the filef teinq loacle::l by· USE.
FPfC[ to Secticn 3.2.3 tor adescription cf the LCAD crticns and

lf

the

IOAb ~H tile •"-·~(CCC04)

lHE PCLlOWltiG~A~ES

AFE UNCEFlNED - xxxxxxxx

lh< ~arncs xxxxxxxx are referenced in a file and aro neveriefined. lt the na[es are defined in ancther filA, issue the USE
ccl!l1'and fct lhilt file.
Loadinq has been ccmf)eted.

E(COOOE)
FILE NCI FCUNC - xxxxxxxx
A file with a tilenawe cf xxxxxxxx dces not exist
cf 1EX1.

.~HH..!-§£.§::

INVAlJC CAaD - xxx ••• xxx.
1no fIKV crtions ~as specified with the ~cevious LOAD coro~ana an1
an invn"iic card l1ai.: teen fcund.
Thf! messaqe and th<~ contents of
the invalid
Cntd (xxx ••• xxx)
are listEd in
the fih!
LOl\D 11AP.
Ihc inv.alic caiJ i::: jgncrcd and lcacling ccntiuu<-~s.
It th(~ 'Ii'IE cption was spPcified with U!JE or was net re.set fromth~ FC€Viccs lUAD,USE,
er ~EUSE comrnancl, the u~dated portion ofthE lC/\O !HP
fi.le 'tiill l:e typEd out prior to the conq:lntion of
the USE ccn11·and.

Ul.!!11£:i •U$ E ~ ~ T E X'J 1 C AI C Ji Wli I 'I E6
1h l
fi 1 n: !'. yn x1 1 'ii: n I UI r ell TE xT'a II a Ii R IT Ef'j TE XT \I i 11 heloactc:J inlc cc1e ar.d U:c lir.kaqc::::will h~ rescl.ved bct1rnnn thesethrCF tiJEE an1
the files that havP. pr~viously
been lcad(1d into

ccrc.
!1H.L~£H.!1.9~£ !

!::(COC01)
Ih<- narr1::

fileE

naue~

IJEFlNED 1-:CRE 'Illld\ CtiCE - xxxxxxxx
has
l:f~cn clcfinl~d morf
than cnce.

'XXXXl(XXX

Check thethat have teen leaded fer either duFlicate entry point
or durlicate cohtrol section nam~s. Leading has beencorr.r lc>U·d.
E (8COO;?.)OVEULAY FBBCBE(CCCOJ)FHEHFHE 1A!HE C\IERFlOW

Specify fewer files
rl:<? fi lt>E ~Pinq loaded have run out of ccrc.
Loadinq has been ccwfleted.
er reduce: the size of the files.
tco ~any cntri~s for entry Feints or ccntrcl scctlcn
nanc::
int.hc r:c1Etlncc
t<tblc that i!: builcl du1:i11'] loadinq.
Lcddil)q ha:: LN~n ccr.qlctetl.
licducc th<-' nurrber of cntr:y pci11ts oc

lhllC

are

- - -

----....

-~.,,_.,... ~--~"·~·-"-"-~~~~~--------------------------·---------

\/·~

.

~ith

a filctype7-31-67
3.2.8-1,J.;7,J.sr;:'

7-31-67!

3.2.8-2$
2. 8 $
Wi1J1 a file whose fiklypc i::; either MODULE or TEXT, thC' arg11mcnts will beplaced in a string as mentioned above, and the address of the string may be obtained l>y adding 8 to the address cuntdnccl in gcncrnl purpuso rcg-i::;tcr 1 at
the ti me execution of the specified program begins. Aclcliti onal axguments may
be rdcrcnccd by clisplacc:rncnts of 16, 24, 32, etc. , from the address thus
obtained.

f.ur11os<::_:'l11c $ command will load and slart the specified file, provilled its fiktypc is
EXEC, MODULE, or TEXT.

format:\Jotcs:~------,---------------------------------------

;

$

;

filename[ arg

1.... arg NJ

a. Issuing the $ comnia11d for a11y filename for which an EXEC fHctype exists
is the same as issuing t11c EXEC command for that file:.

~------J---------------------------------------

filenameis the n:imc of a file whose filctypc
0must bc either EXEC, MODULE, or TEXT.

arg 1 .•. argN

arc one or more user. arg11mcnts.

h. WhC'n a file wliosc filctypc h; MODULE or TEXT is u::;c.•d, there Prnst he an entry
point in that file which is identical to the filename specified in the $command. Afterthe file lws been loaded, execution will begin at this entry point. Such an C'ntry point
will normally !Jc created by the Fortran co!11pikr using the fi1c1wme specified in the
FOIZTHJ\N command (sec Outp~ under Section 3. 4. 2 for exceptions). With Assembler
Jangw1gc file.s, the user should create as an entry point or assign as the name of acontrol section, the filen:nnc by which he wishes to reference the TEXT or f\10DULE
version of tliat file.

II:~.~&'?~

The $ commnnd i:;; used to load and st;1rt a program. The program must cxir.t
as a file on the user's p:~·rm::mcnt or tcmpor::u:y clis.k o:.: on th(~ sys~cm dit;k, aml Hs
filename must be sp:.:cificd as the fin;t opcr~mcl of the ~; cormn,:i__nc1. \Vh(m this cornmrrnd is issued, U1c user's pcnnancnt file directory will be sc~:rcl1ccl fo:: a filewith th2 specified filename ancl a filetyp~~ of either EXEC, r.;ODULE, or TEXT,
in th:::t order. If the file is not follt1d jn the user's per.mauent: file directory, his
tcm;1orary file directory ancl finally the system Dlc llirccto:.~,r will be HC<.irchcd.

~~p91y:;c0_~

WHh filcR whose filctypc: is EXEC, each comrn~u1d in the EXEC file will be typedout 11t thc use1"s terminal priC1r to its cxcci1tinn.
EXECU'I10N BEGINS •.•Tl)is message will be typed out aftC'r a file with a (i]ctypc uf i\IODULE 01· TEXT
lws been loaded into core and ju;;t bc{ore it is started. Auy output nppcaring
after this mcn~:agc is given will lw from Lhe user's program or from a pa.rt of
Ci'v1S called by that progr~1rn, arnl not fro111 the $ comnw1Kl.

If an EXEC fiktypc is found for the filcn:imc, the file will be assurnC'd to consist of
onc.' or more Cl\1S commands, nnd the EXEC command will be calktl to execute thisfile. lf no EXEC filctypc exists, hut. a filctyp:~ of MODULE is found, the LOJ\DMOD
comnHHHl \':ill be caJJcd hy $ to load the program i11to core <ind then the ST.ART
conlinaTJd will ht~ c2lkd to bt,giu P:Xecution of the program. Wlwn only a TEXT filetypc c:.xi:.ts, the LO/\D command will he called, and then the ST/,RT command.

DEFJNED MORE TIIAN ONCE - xxxxxxxx
This message, generated by LOAD, indicates that duplicate entry point~ orcontrol f>Cclion names (xxxxxxxx) have ken found in Lhe TEXT file l>e:i11g
loaclC'd, The $ commai1d \\.'ill be terminated with an error colic of 3.

Option:i.lly, the user may specify as many arguments in the $ comnw_ncl as he wishes,
provided they all 'iit on the snme input line. The arguments will be set up as n stringof double words, one argument per double word, and tlw address of this string will
be pas,..ccl to the sp~:cificd file. Each argun1cnt will he lCft adjusted, and any nrr,u·nicnt more than eight clwractcrs in length will be truncated on the right. With a filewhose filctypc is EXEC, any nrgumcnts specified in the $command will replaceth<.! corresponding t: n opernnds in the individual commands of the EXEC file (sec. tile EXEC command, Section 3. 5.3, for a full explanation of this operand-substitution
technique).

" :; ii

I I iii""

I Mi ,,;s:i,;:;,m:;q;a;

OVERLAY ERROR
There is not enough room in core to hold U1c TEXT file for which a LOAD has
been isrncd. $will be: tcrmi11atcd with an error code of 3.
•

~
k

I2

; I.

~·
,J

I ·, ' I fol Ii I Qt; ..Ti! Ji ;;:p124g •• :;;::: zµsp. !$iji#il£!441£¢iji!ij ii41P¥41iii4iGZQlii#¥ r&::SqiiijijiiiiZj ; s I ;:;::: 44' #41

fl\

,~·

"

'7-31-67

7-31-67 v-!.Sj

3.2.8-4

3.2.8-3

1;p_

REFERENCE TABLE OVERFLOW
111crc arc1 too many entry points or control section names in tJ1e TEXT file being
lo:-td('tl. $will he:· tcnnin<ltcd with an error code of 3.

TIIE FOLLOWING NAMES ARE UNDEFINED - xxxJq:pa<: ••• xxxxxxxx
111e specified names arc refcrcncecl in the TEXT file being loaded and arc neverdefined. $will be tcnninatcd witl1 an error code of 3.

DISl<: ERROH
An ~nor bcrnuccl while eit!Jer reading or closi11r; a file whose filetypc is
MODULE. This mcss::igc is generated Ly LOADMOD, and will cause an error
code of 3 to be returned by tlie ~; comnrnml.
Exm:!E1::'.!"~

a. $ MYFlLE
Pirst the user's pcnn:mcnt fik directory, and then the temporary and system fileclirectorias, will be :;ca rched for a file with a filename of MYfi'ILE and a filetypcof EXEC, MODULE, or TEXT,
If a file exists with n filename of MYFILE and a filctype of EXEC, the commands
which tLat file contains will be executed, and each command will be typccl out at
the usc. r' s' tcrm.in:il l>efore it is executed,
If filetypcs of both MODULE and TEXT or of MODULE only exist for filename
MYFILE,. the file whose filctyp:: is MODULE will be looclccl into core with aLO/d)iv10D conunand and starlc:d with a START cotnmaml at entry point MYFILE.
If only a 1'EXT filctyp;:> exists for filcnam(: MYFILE, n LOAD will be issued tobring MYFILE into core, and then a START will be issued, using an c11try pointof MYFJLE.

If none of the three filctypes is founcl forfilcname OTHER in the user's
permanent directory, the user's temporary file directory and finally thesystem file dirnctory will be :scaxched, using the procedure cliscus~;C.'d allO\'C.

Error Messa11·cs:·--··- -··~---'""--~E(OOOOl)

FILENAME NOT GIVEN. COivIMAND FORMAT IS:$ FILENAME OPTIONAL ARGSThe user has issued the$ commru1d without specifying a filename.
the $ comm:md in the con'cct format.
E(00002)

Re-issue

NO EXEC, MODUI .E, OR TEXT V ERSJON OF FILE xxxxxxxx
FOUND. $ COfvHv1AND CANNOT BE EXECUTED.

The USlT h.w spcriJicd " filcnamC.' whkli dol'S not haVL! a filetypc of EXEC,MODULE, or TEST, where xxxxxxxx is the filename which has been specified.
The LlSTF comnwnd uwy he used to verify the existence of the spccifkd fjlc
and to detenninc its fiJctypc.
E(00003)

LOAD FAILED.

An error code was returned to the $ comnrnnd by either LOAD or LOADi\lOD.
Check tJw fik for duplic<tte or undefined symbols, ovcrl:iy errors, or reference t<i!Jlu ovc1'flow.
E(OOOOi).

An jlJegnJ filcmocle has bl'cn gcncnitccl by the sysl'('l11 when searching for the
specHiccl file. Attempt lo re-issue the $ com111:1nd.
E(OOOOS)NAlvlE IS lJNDE FJNED - xxxxxxxx

The filename i-;pccificd in the $ command is not an· ent:r-y point or a conb·ol
scctiou name in the file: which lrns been loaded. Altl:r the: n.'.l:nc of the file oracid an entry poiut so tliat filename xxxxxxxx will also be a valid entry point,
anti re ·-issut~ tlw $ command.

b.. $ orn1m. SAME 1. 436 5 A
If a filc1.y1~c of EXEC is found on the user's permanent disk for filename OTHER,
cxecullon of Hie EXEC me will take place with tl1e argument. SAME replach1g &l
wherever.it nppcm:s in the EXEC file, l.43y replacing &'.2, 5 replacing &3, andA replacing & ·L
If no EXEC fiktypc' exists for fiknamc OTHER in the user's permanent directory, but
a filctypc of either 1\10DULE or TEXT is found, thl' fik will be loaded into core andstarted at entry point OTHER. 'llte four user nrgumcnts can be acccssccl by displacements of 8, 16, 21, ancl 32 , respectively, from the address contained in gcncrnl
purpose register 1 nt the time program OT! lER is started.

,

I

,}tr

fl"\

~

"""'
f

.

8-16-67 ..261
3. 3. 0-1

DEBUGGlNG FACILITIESA debugging tool is provided with CMS in the form of the DEBUG command. This command vllows the user, while ot his te:rn1inal, to cxmnine nucl change the contents of core
locations, program status words,' general purpose registers, the chnm1l'l status word,
and tk: cbnnnoJ qdclrcss word; to dump poJ·t:ions of core at liis t:enninol or on the ofClincprinter; <tnd to stop and rcr;t<1rt programs nt any specified poinf: or points. Methods forusi112 tlil!sc DnDUG facilitlc:s arc described in Section 3. 3. 2.
In addition to DEDUG, two commands nllow the usc:c to tn1ce Sl!pervinor C8lls (SVC
im;tructions) n,nd hence the intcq·ual h:i::111ches which nrc issuecl to the various CMS commaucls and functions. These two cornmr11Jf.l:-{ -- Sf~TOVER rn1c! SETEHR -will net certain''overrides",flags, which will be checked each time nn SVC i11st:n1ctioJ1 is executedand e~1cl1 time .a return is ifwucd from <111 SVC·cnllcd prognrn1. 'l\vo types of over.rides
m:iy he set: uquHal and ci:ror. N'onwil l)\1c:rrid1.:u :in: thP:·:c whi.cl! caur;c truce infornrntinn tu lie n·(·nnL:d for SVC>cdk:d progr;1,rn; which urc l'XC:cutccl without enr;ounlL-riug
any error COllcliti 011s. E1 .ror overrid;_,~; nre tho~:e wh.icl1 n:co:i:cl i1ifor111ation for SVCcnllccl prog.r:uw~ which n turn with an c:i.Tor code in general parposc :rcg-i~>tc1· 15. The
SETOVJm. con1m:-i11d cnw:cs butl1 types oC overriclc::s to be i;et. The SE'l'l~!rn. commund
will 1"Wt error override~: only.

or

Tu ckar ove:o.•iucs wh.id1 h:rvc Leen set liy the SETOVER nncl/or SETERR commnmls, the
CLI\OVER command nwy he is1-;u(:Ll. In ~1cldition to tcrmin:iting the rcconling of trJcc
in.funnation, CLROVEl-:. wiU cuusc all i11fornwtiou recorded up to tl1nt point to be printed
on the offline printer.

Ji the user wishes to te1111irn1te the recording of tr::tcc infor;11<1tion dllrillg the executionof one of his own p:cograrns or of a CMS commnncl -·i.e., nt a point when tho CLROVER
cormnan<l cmmot be issued - he may do so by hitting the A'lTN key twice (pm1si11g eachtime for the koyboal'd to vnlock) and then typing tlic letters KO followccl by a carringc
return. l'rocessing will cont"inuc ns before, but no further information will be recorded
for SVC's executed after that ruint. The KO conunn.n<l will terminate overl'ides, arnl
will also caw;c rcconlcu trace infornrntion to be pril1lcd on the ofilinc printer.
If the uscJ: h:1s 1->ct ovcr:ritlc:s hy issuing either or both the SETOVER m1cJ SETERR commands nnd h~1s foiled to ckar tl1csc overrides, they will lJe cleared nutom:1tiu1lly, andthe recorded in.formation will be· printed on the offli ne printer, when the user logs out

from tile Control Progrrun or wl1cn lw jssue:-; a RESTART rc:lllll!St ju the Debug
c11viro11mcnt.

c-26Z£LR.Q~~ER

3.3.1

3.3.0

8-16·67

3. 3. 1-1

CLROVER!!.t.!11~~
The CLROVER command clears overrides set by eit11<:!r or both the
SETOVER a11d SETERR commands. It alBo causos all trace .information recorded up to that point to !Jc printed on the offline printer.
Fon~~t!'.

1---{-~;,~;~~~1~\
:

CL

)

___ !
:

!-!~.<~g-'2_:_Thin cornmand tcnninatm; the recording of trace informut:iou lX'gun Ly
thc SETOVJ.m ancl/or SETEHR comnmncls, and causes that inform:Hion·· to be printed on the offline printc1:. Jf Cl.ROVER is uot issued, the user
may cJear <111 cun:ently-activc ovcn:ides by insuing a KO c.01)1nrnnd as described In
f:cct.lon 3. 3. O. J\lso, any overrides which h:we bl'Cn set hut not clcon·cl
at the tiine tl1c user fosucs a RESTAR'l' rcc1\l'::st: in the Debug c11yiro11ment oreJtds lilt; t.crmi11al i;c:i.:sion by Jogging out .from the C:oJJll~ol Pn;grmn will be cleared
m1ton1[1tiu1lly and their trace iufonnution will he printed offlinc.
Cl.ROVER will cancel the effect of all SETOVIm and SETERR com1J1;'lnds
issm·d since the hwt KO' or CLROVER connmrnd was issued, 01~ £ir.cc
tlic wwr's Jnst Cl\-1.S login if ncilfon- a KO i1m· a Cl.HOVER has been issued
clul'ing t:hc t.C"nninal sesoil>n. Oacc a CLH.OVER command has bei::n issned,
no fllrther trace infornrntion wiJI be reconh.:d until the user isr.;ues another
SETOVER or SETEIUl cornmancl.

A i;urnplc of the format in which traci:: infonuation will be printed of.flinc isgiven in Figure 3. 3.1-A. A fixetl omount of trace info.rmation is printed fur
nll error ovcn:idl!R; the amount for nonirnl ovcrl'idcs will vary dcpcnclini: on theoptions sp~~ciJil·tl by the user in the SETOVER command. An cxplau:itionof :ill possible field~: wllich coulcl appear in tile printout ifl given unctcr
Q.L!ll!P1 in t.1Li1J sectio!l.

~l:!-~~~~
a. If a CLROVER command is irn;ucd when no owrrides nrc currently
active, it will lw.ve no effect other than causing tl1e following line to be pri,ntcd
on the offl.inc priHt:c:r:*t.'*':·NOTI•:~-NORMA.L- AND ERROR-OVIm.R.lDES HAVE NOW

BEEN C.U~til\ED':''-'':'*b.

Auy op~rnnds given in the: CLROVER command will he ig110red.

l~~p~1~~-1'.:.

None.

**
•:)

*

7-

7: :n

Ci

·, '/!
,,.... a

I

I

;?!

s
I

?:-

~

1:11
w

..,,

m
(l

t"

0

I

I

I

I

3
(;.
...

Ir

"'
"

I

<
rn
:;;i

I
I

;.c

"

0
'11

rl

I II .. .

r11

111

-.:r:

I r-

·u ,....

rn -I ("'\I I J.•

<

vi<

'J

~
II~

m

r

....
C"l

rn

~

10

I

I

10

,,.,
....

1n......, v

rn

I

rn

"
lo

II

II

{")

I :..>

00I.,)._:, '-'

0
<">

;;o

II

II

;.. 0

;? t ....

,...

("'\

r
rn

r

po

~

'b cr;(J'JJ ;!J

t•
1r
r- I

7
D

CL.ROVER

<

-.;:
l"•

m I

7;J

..j.• .!: 0,.. ... ,,.., 0.. , I u

1.•

o

I 1r
r
rn

I

Vl

;<l m

;o

-i

r.i:;:;m
II.... t:

;;>)

II

n

n
.,, Ir.,-n I.,

II,....

II-;:'- CJ () Col 0~ 0
0 CJ 0·f>'·OO ~c..J<~ 0
0 -.·I 0 0·~· t·· ._)~a. ' ,.

n.;,;.~_,_,a-11r

r·

'1J
II

u

I ovnono'-'~ c l:> c, <_, ci ('J r...;u "'' () ..J n ...,::; o ...:..> lJ

I ·Io
I I c:.;o.;:: ..... ..);;?<.>

V'

C)

t....1 (") l...J C) (J (..),.,!.>-4"..;::} ,_,..... u,_.... J,_·11 v(..) , ......-

n

....

n-nun
·11

I

l•

· ·n 1 rr

ff·

:v

II
"Tl I O.,, I u,, ...; IJ
i1 Iii("""11 ,).,;

~

1~

r or·
,....e,...... r-0~(,/l 1·•

()

'.;:)

Ii-- 11

~

r.1

....

~1,:..

l....'I

()

m

-<
r·

m

r'\

rn

('); -I

"

;;::

0

j:J

rm

1 c; 7.
IN~n ,:>

I~

,1;)

{.")

n

:>

o vi
I..)<::

;,·

m
0

0

: ! : '.';; (,'

1..
'1

it

~~

o·

;:I

'1
I"

n

0

>j

p.

~

N

.,, ,~ ro :::oam.:-.mV1o o o o o •·- m-n.,, ml>o

I o o n o o ru ·11,, ·n V>

..

n

!Tl
-l

7-

Po

-t

-1

.....

I 0000001•-;t 0 0 Q 0 O 0 r<">nnorior..

°'
o·n<.."1000m'l1 I 0 \>J N 0 ~) Vl 11

I O 0 ~"> r.:> o ol.>J I O . t - 0 0 0 0Nv t) 0<") ( )

~

0

o:;

':JJ

0

0

Vl

<'.)

0 0- N C 0 ·.:;::; C"I _r) r:,i C> 0 U1

I •··nIo I
0m(.) •.) <,_ ~~1 n
-i)

i1

t
Cl

1.11

<

"
I

()

VI

<
(1

O<

I
0

r•

·b

1J

11;:.

"Tl ·11 II

VI()·;i •:;

Io.~,,c <.)oor~·11 I o •.:> ; • o ..~ '-l I
0

,-

r

C1

<

·11 ·n r·.~·11 "n :~J.,., ,,

0

1)

~

·~II

0

('I-~

ONm
00

:1 .,,,.. T. '.ll.,, "11<l-.
.,, ·n I·n ~ri8r··Io-r• ,,-J
Cl ;<J

m

-l

II
0
0
0
0

...n
0

co

Cl

I

1 o ·o

vi

""

---~J

;;

•.;) :>JC) r1I

.i::

:r..
'}J

rn

rn

o O

i.-4to·" .:--:

00> )> -i.~ ...":t-

II

a
):>

no "'
·n
NN.t00

;o

-f

II
0
0

fj

-1
II

0

0
0
0
0

N

N

0

..0

l•
rn

o .;) rn..... <....) ;·J
QIJ.1;1
111

-l
II

0

0

0
0

,,>
.:;.

N

~1

I ·;1
I c;;• :·~n r• ;.J1- \JI r11
0 I"' -I

tfl•·J II

1 ·H")

og

rn

~

rn

~

m
--i

;'lJ

II
0
0
0

;>J

:n
II

0

0
0
0
ci

...g ....
0

°"

0

CJ

.~ \11 o o o o ~ o fj

on o ~:> t.J :Jo <'J :--':.... .+' 0
O 0 0\.") ·;1 000•..) 0u '...) 0~.J

O >• <.') O () rel
V1 ·- ::J )> ;.) -1·1" 0 0 vi 0 II

11 0
'11 () \J1 () (') UI 000"110~!'"..lO·i-'<'.:JO

0

;;:.

0
,.,

I In

1Jl"11001110<:JOl./J
C::l "11 0 0 N () 0 <J O",/)~---.....:.:>

()

I

1.v
I n

8

00

00111

0

0

I

00

0:;.)

oo

I

I

t.:1 "11 <:l ·.:> m Cl C".) O
0 fll 0IJJ () 0 0
N V I O O n o .... ..ov

r.1

I ;.<l
I ;;J
rn
-I
II

~ \.~J r..)

-I

n

c
<

m Cl u1 C> ;.'J
Cil 0 ;"'J
rn
II

0
0
0

0
0

,0..,,...

0

/;J>

w

w

Cl

,.

fJ"
~.

-i11~;.,, .,, rn..,, ... , -·1"71 ·n II·n ·no, , "i1 0
I.)

·o
l·I
,')

··a"ilr-1-<

Nofuvr:\I ,.. ovmuurm,&>:~

1liis rncsr::igc idcnUJics lhc fhst line of p1·inlout for en.ch SVC-called
p:r(lgJ'.am wli.ich ic.la1cs D 11m:rnal rctu:i:n.

('I

-·
;o

Cf\ Lum=· xxx\xvx:X
1his information \':ill HJlJivar ill th'.'. fint line of printout for C.'.lch SVC-culled
progrnm. It .indicat('.S tlic hcx::.iclc:cirn:ll core location (xv-xxxxxx) of th::: SVC
instruction wJin;·;c c).ccul"ion cau:-;cd th.1!: pro.:;ram to be called.

l>

n

m

.,,0
('\
~(

vi

-

Cf\LLJ·:J~: ~" x>:>:xx:··::x.
'fliis i11Jorm: li<>ll will ar•pv;u: in tlw first line of )JJ:inf:out for C3C!J SVC-called
progrnrn. xxx:-:xx.xx will lie citlwi.' th~'. name of the cnllccl 1nog:rnm (if a CMS
SVC is is~:uccl) or the m1mbci: 0£ t11c SVC (if an OS SVC is issued).

: t•

1

z

0

•::l
V'I

......

Vl

SVC-OLD-l'SiV::: XXXXXXXXXXXXXXX);
11iis inforrn::ition, given in the fin;t line of printout for each SVC-cnJlcd
prog:rnm, gives th<~ con!cnts of the SVC old progr:im status word. Sec
IHM mnncwl A22-68~1, P.t:indplcr; of Opr.i:ation, for ;111 explanation of the

<
n
I
nµ.

,..
r•

SVC old pn>i:nnn statu;\\,-~;1:Lj [n1~lits u~;.;:··---V1
I
I

NH.MRET ::: xxxxx>:xx"Tl ·11

-t

0

m

0

-n

,, .,, '"!
·11 ,, ;v~":' ,: ':"} rnrn. (m -ov E mzm E,'l11is mcss::igc iclcllt:iJics t:Ii:! first line of printout for cnch SVC-called
pr:ogr::im which 1·cturns with an error cotlc in gcn2ral purpose register 15.

;;,, •,1('J O' \>.I 0

C·l 0. . ,-=-(~.,, .,, ,, ....
.,, ..,,

o 01.00,....:>o J:.•:":1

~

,,.

VI

0

·_')I/I'TI.,., 'i, r'1 ·11 rri

,z

·o

,~

I 0?.:
INr·aN<:-'.7("

.:-

C...)

0

0

2·1 '£ '£p....-ia r-

I ~~~I-<

N V1

M
?3
n

L9-91-gIIo....... ;:...io

·11

00

Q

0

~OU'1::>

n~

7'
am CJ

0

0.

l>

~

.......

::1

SF'l"f'il\G NOTUvP.L·· AND m-:.n.orz .. (JVEJ\TaDES TO l'iWVlDE
A l>YNllMLC 'l'R/1CE OF CMS (AND OS) SVC-C,\LLS •••This mcssc1ge wiJJ (')Jlpco:r in tk~ pr.intout whenever a SETOVER commandis issued.

VI

co r·

,- rr""

r

II
T.
J:>

ono

!3p

rn

11 .,: n

m

t1
"1
0

~

l"•

Nloooouon

tn
m

•O
t:J a
0
Cl,_,

0

,..::c

I on

0

Q(')

<

rn

Cl

l

u
0
I
I
I o 0 ,, c:i o o ·o
•1 ·n "OI
l l+' I ,..,, () ...i1 1~• .::J o VI
-n T\:/JI
I I viI ·.D :.II
Vl:ii:..: n 11; ::,: 'il {f (,.")()"I'.::>..) u ~.: , , 'fl :7.:
-I ··~ 'IC:m-•::c;( ., II-< ·< II
11
II
r- m II0
0 Q , , 0 Cl 0 II.,, .,, II~ '•. l ,,".J "lJ ',1().
C..':,_..,-..: l .;i' ·,1l'J
0 1;1 0 '.) 1 ·.{J ~1·11 "i'T 11........._ -. 1
1- r· ·n.... ,.. ,.,..;: • , .. _ ;i1•1
n r.o ·,1 J • ~'TI
·n ·,1 ·11--~ I Cl ,_,., :;--- ...-...:::.._.._
i>- I ;1 ry•,. _..,.
'-,,711 'Tl O""•~~· ... :,__.... ,,,,,,~ -, . I !'~'""- .. "~11 ()0en,...-1.-.

() f".

no.:>>:n-"' ..,., rn'ol '1 II
r- 00 ::<:nr-o,.... m

l')<"00U>00(';00·ri

SWJ"J'Jl'-JG I;;HIWH-OVFJUUnE TO l'ROVJDE A DYNAMIC:
TH.ACE OF CMS (./\ND OS) SVC-CALLS •••Thi~; rnct:;s;:gc wil1 appc:ir in tlw printout wliencvcr n SETERR comm:ind
is issued.

-"'
I

n

n

r

~ ~ ~~() 'J -~'<,)J,_ I o ..:i o. v "' o,;"'

(.;

o 0

er'

::>J

c

In
I a-

I
I "IJ
I V'I

~

"·

,_a

0

t::l

i;t

f:l

rT•

I
l

!.>

l ..l

An expJ;!l1:1Uor1 of l'ilch fidtl wliicl1 c(ln apJK~nr in tire Jlrintout of trace
i11form~1lion is given bdow~

0

11
.,..
'Tl I•'i1 l n..:i

011~J'.!:1!'.

)>

z

-n

Ion
J ,. ;,..

•1

5·

rI

]J

"n\/)
"1'
, , -1

m

;J:J
II

rr.

/J

....

<>~(</------

-"

;Q

w:

m

'd

:::m: i iii: :u::;tfl\11

:i:
;::..

:;·

~ ,,i11::::

3.3.1-3

NI on<:)OOorr1.-:>I o v i n o o o ..

n-<•oil,- n'8"'.16-67:<J:n--;;.-- - ,,,.

IIv.J •yi 0
C> .... , 0-f;;>; ,;
V> /J'Tl.TI

II

...

7
C.i

...... 2j ~mo

-1 ,.,

I rf'

n-·

,_

t> n

CJ

oon

In

7.. tfl

vi rn

rn

n

I

;o ;i::;c >-J-C rP.... _,<,;) ·v

I

·o ,,

0
N

rT'

I

1:> "OrI >,,I I ..
1- ·1

»

'">VJ
I I '"
I Im
\I

,'\J
-.J

-t

;u

r
r
m

Ir

I

I,..

r I
... Cl

I

. ,,

n,.
r

'b

"O ~

(11

I}

GI "r1.

;o ;i;

n

.

·u ·n

-0 7
:i::-r-i

r

-( l>

n

"'

I

I
0

....

I,..

I

r-

,, <m

••Im

.....

·<

I

(./1

0

I

;;iJ

;<)
]> "Q
Ill 1-n'cl:;::;;;

)>

II 7J

I ..

I

{fl

:;:

;;o

m -1

;<J

....

~

too

~

II

r·

!ti

• >
r- I

..., rr

;:...

'1
c:

;\l

-o
Vi<

VI <

:ii:

ITJ

~)

,.,;;o7.

;i;
:-.:~

">: :.;:

-1

m

,. C'

,.,7-

"lJ 7.

"l> ('"l
7

**
*
t.i *

'l11is information, given in the fin;t li1w of printol;t for each SVC-called
p.rogram, gives th•.: hexadecimal core focati011 ~xx.xx>:xxx) to which theprogram will return under normal conditions; i.e. 1 when no cn·or codeis generated.

~1 ~ ~l)·11·11 ;1
111

-f
II

0
0
0
0

,,.

w

.a

N

CJ(
't .

~

A
'" _gtz

i4!LU4fiii!iii i$LiiiiiMijiU11iijii¥iAl;i$i4U:UIAiiii.
,. ··· .. , . . . · ···· "'.''""!""'"~iT"MTP4!ffll!fl&i~il!lllllli!iifi~

~

""

f' r.

l:,·,t.J

8-16-67·""'J.e·
01/01/fB

3. 3.1··4

3. 3. 2-1

CLlWVE.R·· .. .. ·-"-~_!iJ}_yG..,_-~---~--DEBUG

ERR ET=- xxxxxxxx

1his infonrn1tio11, nppc:1ri11;.., at the right margin of the first line of priutout
for cnch S\'C-caJJpd progran1 1 gives tbc hcxadcdmal core loc1ti<1n (xxxxxxxx)
to w!ticb the pro;:1«1n1 will n.:i urn if an crro1· cuclc is generated during its
cxcculit>n.

£~_rp_().:_;c~_;-The purpose of the DEBUG commancl j[; to provide the llSCJ: with onlinc
facilil.ivs for dehug~ing his programs mill LO prov-ick: an (•ntry iii. CMS forhamllil1g cxt<}nwl nml program interrupts mid unn:covc.n1blc errors.

GPRS BFf'O!{f·: :: xxxxxxxx ... xxxxxxxx
Two line~• of i11icin;1:itio11 \'.rill be f)Vcn v:hc11 this ri1cssngc apF·:ir~: in the
pJ:intuut. The fin;t liilC' will con::bt of tk! c0ntcnu; of gcnernl purposen·[;i'>lcrs 0-7 a1.Ll:th2 sccc1nd line wilJ give th: contents of rvgistcrs 8-15
:1~; tlwy existed \,il~:r. contrul W<ts p:i~;scd to the SVC-c8llcd pn1grnm.

Formnt:FPftS BI~Fli!\Jo: ~,· xx:-,~.xxxx ••• xxxx:--xxx•
This Jiw~ of illfonn:•tion wiJl give thJ contents o[ t!1c! four floating point registers
a~' tlwy c;.: isL::d ~·.!. Ute timL! cuntrc>I v.r<::; lr<.rnsforrcd to the SVC-culled progTam.

~:'.0f.'~:~

GVi\S Al"fl·:R ~ xxxxn:xx . , . xxxxx.xxx
Two liHc s of info.:'ni;;tion will be giYcn when this nicssagc [lppc:ars in thepr:i11:0111. TLc firf.l: line will gi\ c' th~ contc11\:s of g\.:tJCJ.':11 purpu:;c rcgistcJ:s(J. 'i nml tl:c t't'C(•;1rl Jin(: \'.'ill i;h·c· the content·s 0£ n:i:ister~; B-15 as theycxi:;? 1:rl \'/k:n o n:~11r11 w:1:; i~:sucd by the SVC-called progL·<:rn.
1

F PRS AFT'l.:H.

.. ;~~</= D~XX K}'.XX ••• XXXXXXXK

Tlli::; lillc 0£ in":;1·1111:1tion \•1ill g'ivc tile conl\:11ls of the fom: f10,'1ti11g poillt
rq•_i stcrs as thc:y .<:xi stcd \·1hu11 n return \':~·.s i sr;11cd by th<J SV C-c;1llccl
pni,.,rnn1.
PAl~~. . l. -LIST:::; XXXX'.XXX ••••

xxxxxxxx

This me ;;~;:1;,c wil.J he follol':c·d l•y l'itk:r one or tv.·o line:> of ti!(> JKlriln1eter
Eder to Sc:clion
S. 1. 0 fo:c n dbcttt;~;ion of !Xi ,-nrncwr list:;; ~ml tlieil' u~c.

li~;t v:hich exi~;i.ct!i al the ti1t1•.· tile SVC \•;:·s c:xccutc:d.

>J<::::.:::;'-!OTH--NOJZ~·:'l.'\L- J\t~D Errn.cm-OVEl~J(D)ES[JAVE NOWUEEN CLll~An l·:U · : : ·'fhis mc:·;s~:~L' \'.'il,J app:.:ar i11 the printout Wht~llC'VCl' :1 CLROV rm comn1:111cl
i,r; issul'd.

,---···-~·-··-1\{DEBUG} l
I

DEB

1

1.---·--""--·-····

Tllc facilities of DEBUG a.re made nvallable to the user wbc:n (1) the DEDUG
comr;1a1Kl is ist.:uC'tl, (2) 811 external interrupt occurs, (3) a JlL·o:\rnrn intc.1:rupt
occun;, (4) a h1:cal:point is encountered during progn1m e):<::cvtion, or (S) ;:rn
unr('covcrable error occun;. 0!1ce DECUG ha~; been cnl.L·n~d due l<J uny of theabove ci:rcumslc!llCCt;, t\12 usc:r is Sc1id to be: in the Ddmp; cr·vircinr,1c1it. 'lh:
only valid .input in t:lii:; enviJ.·011n1enl'hJ the: t1'0tij) of DEBUG req1 1 c·;;L> disc11ssc<lin tJ1ir; t;cctiOJI, FiV1) or the requests -- co, Jl'L, KX, l~ETUTIN, <11Kl ](ESTA.RT-- cai1sv UK' uscT to lc;1vu tbc Debug environment. Which of thvse five n:CF'l't:ts
sliou1d be i:->SL!L·d clqx!ncl;; on t:k_·, circumcl:'.liCc>: unck~r which DE:\UG hJ.s l;(-cnenli~!rcd. Refer tu tlic section dealing with each rcqucf;t for a f\trtl!cr di:=:cusPio.1
of iW use.
Wilen tht! D1:hug C'nvii:ornrn:nt i:> c11tcrcd, the contents of all gcncr:il purpo:;~!
rcgislcr:;, the channel statue wort!, and 1lic clwrrncl address word will bo S:-?Ycd
so that tl1;:y may be c:rnmincd ;~ml cl1au;_yc1 1 if cbsirccl, p1:ior to lK·ing rcf;tmTd
when lcavh1g the ]);;!Jug environment. Jf. DEllUG is cntcrC'cl via aH ink:o:upt, the!
old prcig1.'(llll status wun1 for that intexrupt will al.SC> be s:1vcd. Tile requests \'.'hich
may be issued in the Dclmg cuviromncnt. allow tile user to cxarninc and chang..:: tbc
contents of these contTol wordu and registers as well vs p(n:tioa~; of tlic: user's
virtu:tl core. Each oI thoue requests is dcf;cribc:tl imlivich1;il]y in the followii:g
sect.ioM;.
Note::;:!;:;.;~]l.'.Jl].\_:~;:n.

CLHOVERThb cx~•mplc wuuld clear :tll cuircntly-~1c:tivc overrides and cc1use nny tra:::c
inronuation rccnrdcd up to that point to he prinLccl 01• the of.11i.nc pi:inter. Sec
Figure 3. 3. 1-A ffff a sa111pk of the type of information which would be printed.
l·'._!.·n>i~i.lc;s.s~L:.cc::

Kone:.

a.

The KT, KE, and KO comnrnnds arc not recognized in the Debug cnvironmc1}t.

b. Currently tile floating point registers may not be examined or chan;_:ccl in tlic
Debug c:nvironmc:nt. To accc:rn the floating point registers, the CP c011s~ile functions
DJSJ'LJ\ Y Y.rcg and STOJU<; Yreg may be used as described in .Sections 11. 1. '1 mld 4, 1. 13.

d/7

)//
01/01/68

3.3.2- 3 Ol/01/68-y
DEBUG,_,._(c3. 3.2-2

cf

DEBUG
J

(4) All op8rn11cls lonr.cr than eight clw.rncters will be left adjusted and truncatedon the right.
(5) All entric:; in the DEBUG syrnb0l table a1·c created by issuing the DEF
request. Dclow is a list of all valid DEBUG rec1uc:3ts:

Re~ponsc_~

DEBUG ENTERED ...
This mcss.'.lgc indicates that DE!3l'G lias been entered in rc!1porn-:~~ to tlw DEBUG
commqncl or clue to an unrC'covcn1ble error encountered during execution. Any
DEBUG request" may he ismwcl as soon ai:: the keyboard is unlocked.
DE!3UG ENTERED, EXTERNAL INT.

.!~~~c:__!\~!fl'~--~~~~BREAK

3. 3. 2- 4
3. 3. 2-10
3. 3. 2-11
3. 3. 2-12

CAW

This message indicates that an external interrupt has caused DEBUG to beentered, and that the external old program·St<itus word has Leen saved. Any
DEBUG request may be issued as soon as the kcyboanl is unlocked.

CSV/
DEF

DEillJG .ENTEIZED

rn.ocm.AM INT. rsw ::: xxxxxxx."xxxxxxxx
This mcssag<""! indicates tlnt a pror,-rnm ii11~1·rupt h:is caw;ccl DEeUG to beentered. The p~·ogram old PSW h0s h~cn s::ived, anrl it:H contents will be

DUMP

3.3.2-15

GO

3. 3. 2- ?.J3. 3. 2- 21
3. 3. 2- 7.6
3. 3. 2- 27
3. 3. 2- 28
3. 3. 2- 30
3.3.2-32
3. 3. 2· 33
3. 3. 2- 31
3.3.2-38
3.3.2-42

GPK
IPL

KX

typed out in hcxnclccimal rcpi:cscntation as inclic1tted hy x.xxxXX.:\xxxxxxxxx
al~o\·c. Any DEBUG request may be i:::sucd as soon ns tJ1c keyboard is
unlocked.

OH.I GIN
PSW
REr,TAH.T
RE)'URN
SET
S1DRE

DFDUG ENTERED
13RBAl~POJNT xx~_t:Cjl~CS~A'f xxxx.xx

This message will he typC'cl v:hcn DEBUG if; cntc'rcd due to a previously-set
breakpoint which has h-:cn encountered during the c.-:ccution of a progTam. The
breaJ:point will IK! idcntificcl by the 1111mher assigned to it (xx) am! by the hcxa decimal core loc-c1tion (xxxxxx) at which it has been encountered. Any DEBUG
rcqucst may he iss~ic:d ::is soon as the kcybo::inl is unlorkcd.

x

INV Al.JD DEJ]lJG HFQUESTThe us:::r has specified a rcqu~st v:hi ch is not valid in the Debug environment
or which includes the wroag rn1mbcr of op1.:r:mtls. Only the n·qucst~> dis<.:us~;cd
in this section arc valid, and they must: be i ssucd, one per li nc, in Ow correct
format.
RC'~J~~~ts:

Whenever tlw ~;:cyho:1nl is tmlockccl in the Debug environment:, any DE13UG r<"qucst
may b~ issued. The following rules apply generally when issuiug DEBUG requests:(1) The parameters, or operands, of each request must be separated by one
or m01·c bbnks.
(2) The clwractcr-dclcte symbcl,@ , may be used to delete individual diarncters
iJ1 an in1)ut line and n character-delete symbols delete.: the preceding n clwractcrs inthC' lhc.
(3) The line-delete symbol,¢ , may be used to delete itself and all preceding
characters in an input line. A line-delete symbol cannot be deleted by a characterclcletc symbol.

,,,,,.!
: 1Htl;::::m:;:,, 'iiii!i@.tii::::.;;,;;;_ "'

I

.JO

~

,,_.

!Ski

"~·

~
~

4

:

'

I

l T=t

¥

p

,. #ij,#if!!ijftP~n11m1mi·:19U~p

1114

1

2

,,._

~-

~

/JI r;

c-< f~ 1)b7

01/01/68

3.3.2-5

Ol/01/68

DEBUG

BREAK

3. 3. 2 -4
DEBUG--BllEAK

The DEBUG prognun sets a breakpoint by saving the contents of the byte
-located at the core acklrcss specified by the second operand of the BREAK
request. This byte is then replaced by the byte 'Ex', where xis the he:-;aclecimalequivalent of the breakpoint identifier specified in U1e first op.?nmd. In orderfor the breakpoint setting t~ have rnea.ning, the core address indicated hy thesccoml opcr[!nrJ must Ix~ the location of nn opcrnUon cocle. 11rns, when thelocation is c11countcrcc1 during program execution, a program interrupt will
occur (since all vnlucs EO th1·ough EF arc invalid ·opcrati.on codes) and control
will be trnJJsfen:ccl to the Dclrng cuvironmcnt. In DEBUG the inv~licl opc,ration
codl' will !Jc recognized us a breakpoint, the original operation code will be
replaced, rn1d a mci:;s:igc will be typc:d out iclent i fying lite breakpoint which h:isbeen eJtcountercd.

BREAK£.C>rl_1!_~!'.

:----------:--~-----{---------)----,: IlREAK :idsymbol:!
,lwxloc:---------·---~------------------:
jd

is ~nty ck:cimal number between 0 and 15 inclusive.

symbolis r1 11:1Plc wluch has bcC'n assig11Ccl (using the DEF

hcxloce--.278

rcq11(,st) to tk~ corn uddn:ss at which a Jwcakpojllt
is to lie i;Ct

Fir,11re 3. 3. 2··B indicates the procedure normally u:;ed fm: RC:lti11g brcal;points.
First the program iri loaded into core. The DEBUG command is then issued totransfor <.:011trol to the Debug cnvironmcJLt so that breakpoints im~y be sL't prior
to lll'gi1111in~~ execution of the program. After the der;irccl breakpoints lwve beenset, a H.ETUl\N request should he issued to return control to the CMS Commandenvironment. Issuing the STJ\RT commond will cause program execution to
bcgiu. Whenever a hrcak11oint is e11cou11tcrecl, n mcssar,e to th.:it cfkct will betyped out, control will return to the Debug cnviromnl'nt, and the keyboard will
be unlocked to accept any DEBUG request except RETUHN. lsfaii.ng the GO rl'qucst
will cawH~ p1·ogra111 cxccul.ion to c.01tUn11c fro111 cHllcr a spc:cific'd Joc:1tion or thelocatlon at wl1icl1 tllc brcnkp(Jillt had !Jcel! set.

if~ tl,e Jwxmkcimal core Jo,~ation (,:clatise to the
cur1·cnl origin) at wlL<cl1 a brcal:puinl is to he set.

!!_'.-:at.;£~This requc!St c1wbks llic w:,~r to stop tile execution oJ n program at specificinsu:uc·1ion locations, c:11kd "hn·;ilqll>i11u~." h:~:11il!g tile ERl~AI~ rcqucr;twill cause only 011e Jn:c[lkpoittl to li3 ::vt; r-:l:p~1r:1J"1• nP.EJ\I: re<.Jll('.'if~; nHIS~ \Jcir;succl for c:i.ch l~rca.kpoint (ksired. A rn;izimum of s[:-;tccn !Jrcalq•oints
may be in effect llt nny f;ivcn U me, and nny att.~mpt to :>ct more than sixteen
will !Jc rejected.
·

No~~~:-

Tlii.: iirst OfKr:.1n~I of U'.c CE gAK r<'IJll<~:Jt specif1\'u tli.: idvnt:i [il'.aU011 number.to iJc a::;f:igncd to, the brval:l'oi•1l: hd11g :;ct, and must he:~ t~c]cim;1l 1mmbcr
between 0 awl JS, jnclusivv. If :m iclc:11tifirntion mm;b:.::r js ~;pccificcl whicha.

A breakpoint i.':i cleared whc11cvcr it is cncoun.tere<l dur.in¥ program execution.

b.

To determine the core addresses _of instructions at which breakpoints arc to be

set, a listing of tltu program(s) in asscmblc1· language mnemonics should !Ju usedis the rwnw as th:tt of a cun-c11lly sct Jn·c,1kpoint, the prcvio11s Jircakpoillt
will he clc;1n:d :inti tltL' 11cw om: will Ji.:: ~:ct.

together with a load map. Assembler lm1g1rage mncmoni cs may be obtaiJwd in
Fortr:rn listings by spc~cifyhlg the UST option when the FORTRAN ·comm •.111d isissued. Sec Figure 3. 3, 2-A. To obtain a load map, the TYPE option should bespecified in the LOAD comniancl 1 as shown in Pigurc 3. 3. 2-n.

'f!Jc second operrnd o( tile 11!\l\t\l~ rcc!ucst indicates the core address at
which the bren1:1ioint i~; to l:c S<.'L lf tliis op,·raml contains any non-numericcharactvrs, the j)EBUG symbol table L SC'DlThcd for a matching symbol
entry. If a rnatt~h is frn:ml, the hrc:ikpoi11t will be set :it the core :.ukln:f;:-J
to which the• sy111liol n:mw is as~;if.,1H:d, provided that address is on an even(h:tlfwonl) J1ottll(lbry. If nfi lllatch i:; fo11rnl in the n1rnUG ~yn11iol t:t!il<:, or
if tit<..! ~;ccond o:idn·_nd co11l0i11:; oHly 1111111~·1 ic c11;1r;ict1.:n;, the ct11Tc:11t origin(as c,.,tablishccl tty the ORll:JN n.:<Jlll'St) will he utldcil Lo tile ~qK:cdil!d opcrm1cl am! the l1n:ajkpoint will be S•..!l at tlie resulting core a.ldre~;~;, provided
that· ad<lt·css i1; on a halfv:o1·tl bound;1ry.

c. Even if the mklrcss specified for a breakpoint setting is on a halfword liounclary,t.hc liytc at tl1n~ adclrc1;s may not contain an operation code. Jt it; up to the user tonrnkl' surC' that breakpoints arc set 011ly at opcrnUon code.' localions. Otherwise,
tile Jn·cal:poinl will 11ol he rccognizvtl duri11g execution am! llwy gcnL·ratc 01h0r
errors l>y OVl~rlaying d<ita or some part of a.n ill.'•tn1clion <ltiJn· tliau the opvration
code.

·1
/

cl. No breakpoints should be set below hcxmlccirnal core location 100, since thisarea is reserved for hardware control words,. and will not contain cxcc:utahle code;

OJ/01/68

Jfr

3. 3. 2··6,-;!;01/01/68

DEBUG,.2;:x,3. 3. 2-1--GRffAK

DEBUG---nllliAK/

If n BREAK request is issued which specifies a core a<lclrer.s at whichn hrcal:point is currently active, the sccci11cl breakpoint will also be setl'.

REPLACES OLD IH\.EAKJ'OINT xx AT xxxxxx
This rcspoasc i.mlicatcs t11at tlw BREt\l~ request just issued specifics
a hrc.:nJ,1wint identifier (:xx) which h~rn o lrcn.cly been n.ssigncd to a currrcntly
active hi:cnkpoint. 'foe ol<l hrcnkpoint (at core location ::xxxxx.'\:) will becleared <ind the llf'W hrc•akpoint will be i'C't.

nt tlwt s:m1e locotion. When this breakpoint is encountered during cxecut ion, the i<k~nLification number of tlw most recently set brcakpoilll will betyp•·d out. 'l11c scco;1d tilllL' this coi~·c Joca!ioa is n:;iclWcl durii;g program(.·xcc11tion, tlH! identifier of the sccnml-rnost n:ccnrly f>Ct: hrcnkpnint willJi~~ typL:d, nm! so on. Wltvncver DEBUG has bc:<..!n (·u:crccl due lo a hrcnkpoi 11! interrupt, issuing tlic CO request without nn opc:n1nd will caw;cexecution to b:::gin at tJ1c location where the hrC'nkpoint was cncountcn:d.
H more than one breakpoint has been set at this location, Lhc adclilfonalhrcnkpoint(s) will cause DEBUG to be rc-cntc,red.

DEDUG l~NTERED
BREAKPOINT xx AT xxxxxx
This message will he given whenever a brc;;kpoint is cncoantcred during
pror:n1m cxectti:;on. xx is the l:>rcakpoi.iit idci1tific1: and }:xxxxx is the coreacldrC'ss at which tile breakpoint ha:1 been encountered. After the messar;()is typed, tlic kcyhonrcl will be unlocl~cd to ncccpt miy'nnnuc rcc111cst· cxC('pt HE'l'UlU'-J.

f. Issuing a RESTART rc<JUC'st will cause :my hrcrikp0inl:> set :1t locntions
grcnlcr than hc.<taclc.:dmal 12000 LU l>C' ckm:1,;d; Ll1osc bt:lnw 12000 will remain set.

Exa1111~s;

Resp'~:'.:~

If the BREAK rcqucsl has been c;11Tcctly issu~d, the keyboard will be un-n. 1311.1\J\K 1 ISC

locked following a carringe return, and the system will be rcody to accept
another DEDUG request.

The current or.i[\i n value will be aclclcd to 18C aml the byte at the res;.1lthlg core
address will be Sfl.VC'd and r.eplncccl JJy the byte 'El'. Hdcr to Fir,m:e 3. 3. 2-13
wlt~Tc Ilic ori[',in was ~;,~L tol?.O<lll, and t.lic: in:;Lruc.lion <ll which b.1·v:1J;poiJJt l was
set is t!ic ~;(TO!lll from tli8 l:tflt il1,;(Tt1L:!ion nltown il1 Fi.!_;rn:c 3. 3. 2-A. Note thatthv Jo:.id map inclieotc:.;; tk1t prog:i·nrn l'Hllv1E was londcd at 12000. Setting theorigin to 12000, tltcrdorc, !11C!<llW t.lw< the statement locations G!1ovm jn thelisting of prog1-:un PRIME may be/used in selling brccl~pofots. When breakpoint
1 is encountered during prop·am execution, the message
DEBUG ENTERED
l3R EAKPOJI-\T 01 .AT 01218C
is typed out.

INVALJn DEJllJG REQUEST'l11is re,.;po:1sc in<.licatcs t:hnt the wrong nu111bci· oI oprJrnnds have bcl'.'n
spcL·ifil'd in the DREAK rcqu('S!. 'J\1·0 nnd cmly two op:~r;rnds mu:c:L h:.~spcciflecl.

INV ALlD ARGU:i\1KNT
This mc:-.is<1gc imlic.:Hco tlrnt dt:hcr (1) tl1e ln:c~~lqx1int iclentific~tlion
number spC"cified in the fi.r1-_;t C>JK'rand i~~ not a decim11l ntnnbcr bf'twcen
0 and 15 ilwlusiV(', or (2) the ~;ccond opc:rand crinnot be locDtcu in tltef)EIJUG sy111hul Lal11c ~111tl is IWt Cl valid hvxadcc:i111.] llllllJhcr.

rr th('b.

scconcl opcr;-,11d is intended to be a symbol, n DEF rcciuc.st must haveh-:cn previously issued for that symbol; if not, the op~rand mustspecify a valid l1cxaclccimal core location.

Ii'i'VA.L!D COHE-ADDRESSThe cnrc loc~tion imlicat<:d by the~ second op~ranc! is either uneven (noton a h;1Hword buurnbry) or th~ sum of the: second opcn1ncl nm! UJL' current
ocigin v;:iluc is g-rcntcr th-'.ln thL~ us0r's vil'l11al core size. If the current
origin vnluc is unknown, it may he reset to the desired value by i:'isuing the
ORIG;;~ request.

11

""'

~ 11t:t1::u:::11..e:sc •::mL:::m::u:;;:a::za:

BREAK 3 AAA

111c byte at the address assigned to symbol AAA will be saved am! replaced hy
the 'E3'. Jn Fi~urc 3. 3. ?..-B, a DEF rcquc:.>t is issued which assigns symbol
AAA to location 1A•1, relative to the cun:ent ori;_;in of 12000. Drcakpoint 3 will
therefore set nt core address 121A•1, ns illclicatcd by the message
DEBUG ENTERED

BREAKJ'OINT 03 AT 012111.1
which is typed out wh<.:n the breakpoint is encountered during program execution.

~~:aaw:z::::: . ::uu::::::: i!lli!UJIJ.iiliiii!)i . :m::::m: Zil ! iii!ill,:m::::::;:::

cs ma21::z;:::21 m4a: ,lltJ211Ui!L .

LJii:

:..:

::

cu :s:q •t .· ~-

•

1

-

*

" '

1·

"'

~

"'

)./j

01-01-68
3, 3. ?.-8
DI'.J)_l.!0.

c?(::;,7

01-01-68

BREA!\.
pr if

3.3.2-~

r> rt me 1 i st I lh e

F0RTRM!

IV fi

c

100

0001
0002
0003
00011
0005
0005
0007
00(18
000 I)
0010
0011
0012
0013
0014
0015
0 0 l£i
0017
0018

FORMf\T ( 2 71-1 PHIME MIJMBFRS

101
3
102
103

1=5
A= I

105
1 OG

L= I I K

11-Cl*K-l)l,2,4
COr!Tlr.JlJ[

107\·JR I H·I'" I+ 2

7. \~I~ I H

6
109

STOP

SQl<T

(13)

IF(50-1)7,li,3l·m I n: ( G, 9 )FOf!M·'\T 04!1 rrrn11nr..r.1

rnrrnrn{ G, G)

F<rn1.\/\T

c1111 mo>END

G LEVEL o, rrnD o
STA NUl·1
Lf\lffL.~0000oroooooc000010000014000016000011\00001[
000021.
000021;
00002800002C
000168

OGD71J9C9R; l"'0,37

S"iM

debu~

U1

2 , 3 ' 11 0 ( 1 5 )LR

11, 13L

B, 3G ( 0, 15)
13,8(0,ld
3, 11, 0 ( 13)15, 200000000
00000000
00000000
13 I 11 ( 0 I 13 )l 11 I 1 2 ( 0 I 13 )
2,12,28(13)

ST!-1

or
or;

DC
I.

OOOlGC

L

000170000171100011800017!·
0001 F

LM
MVI

15, 111

L

15,H0(0,13)LI<

12, 13LI(

00018200018G
00018313' 11

f1/\L

111 , G11 ( 0 I 15 )LI~L

13, 1215,lG0(0,13)

RAL
DC00000006

OOOlSC
00190

100

DEBUG

111 , 11 ( 0 , 15 )~NTERED,,.

origin 12000

break 1 18c
def aaa la4

1\11

1\20

break 3 ana

1\36returnR; To:0,02

12(13),255

Br:'.R

OllOUlO

1·

Br.n OPFRA~

fll1C5110110
111 ' 1 2 , 12 ( ] 3 )13 ('.!{

A20= 67080

15,12(0,15)

ST

A36

DATE

BC

nc
nc

OOCJO 011
0 OOOL P.

PRIME
OPERAND

AT 132F8

lllCFCVTH AT 133A8ADCON#AT 133/\8
INTGSW
AT 14409
FCVEO
AT 13E52
FCVLO
AT 13621\
FCVIO
AT 13960
FCVCO
AT 14654
FCVAO
AT 1359AFCVZOAT 134F4I HCF I 0 SH AT 14 11 2 8
F I 0 CS ii
AT J. 11 4 2 8
lllCTRCH AT 14FCO
I llCU/\TBL AT 15238( G, 5 ) I

FOl\i~/l.T

2
108
4
9

0020
FOf(T!Udl IV
I '~C;\T I ON

load prime (type)
PRIME#AT 12000
PRIME
AT 12000
IHCFCOMH AT 122CO
SAVAREA AT 13288
VFIOCSAT 13128
IBCOMf
AT 122COFDIOCSC AT 1237C
IHCSSQRT AT 132F8

rnon 1 TO 50/2X,l'!l//.X,1'12/2X,1'!3)

A=S'"lfH(.I\)
J=A
0 () 1 f~ = 3 ' J ' 2

1
5

OD l 'J

PR I 11E NlJ1-'o!1F.R Pf10f3 Lrn\lnlH (6,8)

BREAK

D/\TI'" "' 67080

PR lr·1E

8

104
I

Q~

LEVH O, MOO 0start
I '1r.W1#·--...'·,\FXECUTION BEntNS,,,DEBUG ENTERED
BREAKPOINT 01 AT 01218Cr;o

I r.cm.1#

PRIME NUMBERS FROM 1 TO 50
123

DEBUG ENTERED
BREAKPOINl 03 AT 0121A4

Figure 3, 3. 2-A. S•1mple output created by a FORTHAN coinmand in ·,which the LlST option w:i.s s1wcifiocl.
FIGURE 3. 3, 2-B.

Sample procedure for setting breakpoints.

/•'

(,/~

/'/

J·i;'I·

OI/lll/68v'

3. 3. 2-10
DEl3UG._J/!,"--CAW

3.3.2-1101/01/C.8.
DEE-UG'-·//(csw

csw

Form a~~..... ~w~----------------~2::!~~:tl.:I':

1-· - - - - - - - - - - - - - -

:'
I

csw

I

II

:
I

~----------------:CAW

JI ________________ ,I~r£:.
This request will ci.lusc th<: contents of the channel st:itus wore! which existed nt
the time DEBUG was entered to be typed out at the tcrminnl. 'flic cbonncl status
wore! (CSW) inclic<1tcs the f;tatus of a channd or an input/outpat device, or theconditions under whiCh an I/O operation has been terminated. 11ie CSW is formedin the channel and wiD. be ntorcd in hexadecimal core loc.:1tion 40 wlicm <1n I/Ointerruption occurs. If 1/0 interruptions !.:;ve been suppressed, the CSW will
generally be stored wh(!n the next START I/O, TEST I/O, or HALT I/O instruction
is executed. The CSW is :rnved when DEDUG is entered nnd h~lS the followin;:; format:

Usag~:_

Thi8 request will cause the contents of the channel acklrc8s word which
cxist~cl nt the time DEBUG was ci1tcrccl to be typ(!d out at the tcrminnl.
'l11c channel address word (CAW) specifics the storage protection key
and the core nc\Zkess of the first chanr1el comrrnmcl word associated with
the next or most recent START lfO. The channel address worct, locatedin hcxndcc:imal core location 48, is saved at the time DEBUG is entered.
·me CAW has the following fon;1.:it:Contents

Bits

Contents

0-3

l'rotcction key which is matched with a. key
in si-m:u~;'(! whenever re[L·rcncc iH ma<lc to
main storage.

Protection key, moved from the CAW andused to indicate the protection key nnd::r
which I/Owns st::utccl.

4-7

Not implemented; currently set to zcro~s.

4-7

Not implemented; currently set to zeros.

8-31

8-31

Command address, indic<lting the hexaclecimnl
core location of the first chmmcl command
word associated with the next or the most recent START I/0.

Next command aclclrcss, a pointer to thecore location eight bytes greater tllon theaddress of the last channel command word
cxecutcd.

32-47

Stat11s hits, indicating the condition3 iu thedevice or the channel th::it caused the CSW
to be stored.

48-63

Residuol count, indicating the difference inthe number of byi.cs specified in the· Jn~;t­cxecutcd ch:-inncl command word nnd thenumber of bytes which were actually transferred.

Bits
0-3

For a further discussion of the channel address word, refer to IJ3i\1 Manual
A22-6S21, Pri2!_~:U"1lC:~_?LC21'.5::£<1tion.
B~->E.?._es:

Ii the rcr1ucst hns been correctly issued, the contents of the channel nclclrcss word
will be typed in hcx::iclccirnal rcpn~scntation <1t the terminal and, following
a carria~~,; return, the keyboard will be unlocked to accept anoU1cr DEBUG
request. Sec Figure 3. 2. 2-I' for an example of response to the CAW request.

For a f11rthcr discussion of the channel status word and its use, refer to IBM
manual A22-6821, Princ!J'.lc:~ ~~-2f2~·::_~i~~1.:

Re f;P_o_i~ S£fi.!.

Ii\T\T J.\LID DEl3UG REQUEST'fl1is response to the CAW request indicates that one or more op:;rancls
have bc('!l spl'cificd. Re-issue the request in its correct format.

If tl1c rcq11cst has been correctly issued, the contents of the CS\V will be typedout at the terminal in hl'x::tclccimo.l representation. A carriage return will thenbe issued and the.: keyboard will be unlocked to accept m10tlwr DEBUG request.
For an C'xample of response to the CSW request, sclJ Figure 3. 3. 2-F.
INVALID DEBUG REQUEST
TI1is response to the CSW request indicates that one or more operands have been

specified.

11111

-

I • ' ~111"""""!!""111ii!!'!''!l"·"'"ii!ij""!!1!''~'t"""'!jiiiiiiiijiij!!"'~'*""""+,....•1111, ,,, . +1,..,..,J&llSILii.iii!Sii IJllSJ. i iii, .,,,,_""""'"""'

Re-isf:uc the rcqucst in its proper format.

~~i
Ci.. llUJC!i!E.J:aq:iiii$L21W$.liii

z;

IJISJJ I2 ii Si!Jiiii!UJJ.iiiiiiillll.'4 Y4fA11 Jii4 ij4#

. P .¥

Liil!L :::::;;:;;u:. .Lpt;µ., .74µ. :;::a .1 .. ~....... . , . 11111 . lllllll!lil!lllllllill

,,.,.

~"""'
01/0J/68

01/0.l/ 6S ·3. 3. 2-12
J7· 7··
DEBUG
0'-

)71

3, 3, 2-13

gr~-~-l!.Q--6ffJ!-

DEF

Formcit:.----~-------1-·--------------1

I

DEF

:

I
I

symbol hcxloc•

If a DEF request is issued which specifies a symbol that has been previously
defined, tile previous core address will be replaced by the more recent core
address for that symbol in the DEJ3UG symbol table. DEF rc,quC!sts which
specify mklitfonal symbol names fo:r core locations to which a symbol namehas already been assigned will cause additional entries in the DEBUG symLoltable, so that multiple symbols mny be asaignccl to the same core address.

DEF

:

I,

.~< 7.-[byt°!'"' J]It'------------.!------------------symbol

is the nnmc to be assigned to the core addressderived from the second opcrond, hcxloc.

hexH:ic

is the bcxmlccirnnl core location, relative tothe cnr:rent origin, to v:hic": the name s1x~c:ificc1
in the first operand is to ]JC <tSi>igne:cl.

hylccount

is a clccimal number lic!tvrc~cn -1 anJ 56 i ndusivc~
which Sl'8cifics the lcnr;th attrib~iu.' (in bytc8) of
tlK' symbol f;p:::,:ificd in the first operand.

Notes:a.

Only 16 symbols may be ddiuccl in the Debug envin)nment at any given time.

b. Jssuing a new ORIGIN request will not oifcct the core address to \';hich anah:cady-clcfined symbol is assigned.
c. 8ymhols nssignecl using the DEF r«1ucst are defined for use only in the Debug ·environment. These symbol definitions will not be cleared when a RESTART
request is issued.
Rc~p01~

If the DEF request bas been correctly issued, a cm:riage return will be given
au<l the keyboard will be unlocl~cd to nccept another DEBUG request.

Usage:

111(' DJ·:F rc.:qut'st allows tlir.: w;cr to assi~11 a symbol nurnc to n specific corendd1•css and to refer tu tlwt mldrr:ss in otlwr IJEIJUG requests by the assigned
name. The symbol 1wnw is specified as the first ,)pc~·,rncl of the DEF reque;=;t.
It may he fron: one to ei~;ht characte·1::·; ill lcngt11 and must contain at kn;;t: one
non~numcric cirnractcr. Also, the fin;t charackt' of the symbol name should
nol IJI.! un asterisk. Any n~une longer th~111 cighl c\wrnclcrs will tic kft-acljuslecl
a1Hl .tnmc:ikd on tile ri2ht.
111c second OjX·rand of thu ])]~fl request spccHics a hexadecimal number which
will be added U! ths cun:ent origin (<rn estnbllshed by the OIUGIN request), The
snm of thc~>e t\'/o values \'.'ill b'.:! the core addn·fis to which the syrnbol name will
hC' m;signcd.

Thl· third op::rancl of the DEF n:quc;;t: is optional mid, if given, rnu~;t specify aclcc~m:::l 11u111lJCr bctwcr:n 1 and 56 inclusive. This number is the length atlributc(in bytes) of the! symbol narm~. II the third opcr::ind is omitted, a dcfoult attributeof fou1· byt1~s \1 i11 be assigned.

IJ\TV AUD DEBUG REQUESTThis response to the DEP ~equest indicates that either less than two or morethan th:rcc opcrnmb have becu sp~cificd. rte-issue the rc:qucst in its correct·
format.
·IN.VALID ARGUMENT.
This mes1rnr;e inclic<1t:cs th:1t either (-1) the 1"rnmc SJX:cificc~ in th~ fir:::t op'.:!rnnd
contains all numeric charncters,(2) the second operand is not a vnli<l hcx::iclccirnnl
number, or (3) the third open111cl is not a decimal number between 1 and 56 in elusive.
INVALID CORE-ADDRESSThis response will 'be given when the sum of the second operand anrl the cu1Tc1Jt
origin is greater tlwn the user:•s virlunl core size. 1f the current ori~~in v;ilucis unknown,- reset it to the desired value by issuing the ORIGIN request andthen re-issue the DEF request.
16 SYMUOLS ALREADY DEFINED

Whv11 L112 DEF request is issued, an entry is made in the DEBUG syrn!wl tnhlc
incl;c~1li11g tl•c ::y111hnl 11:1mc, the core ncldress to which it i:~ assigned, rind tl1c
length attri11utt· of the 8yrnhol. Syrnhol8 will re111ai11 clefinc:cl until a new DEF
rccnic:;t if; issued for tlH'!n or 1111til the user obtains a new copy of Clv1S liy
issuing ::in IPL rcquc~;t in the Debug environment or in the Control Program

environment.

Ji th:is message is givell, the DEBUG symbol tnhlc has been filled and no new
symbol.'l nwy be defined until the current definition~; m:e cleared by ohtaini11:::,a new copy of CMS. An existing symbol may be assignee! to a new core location,
however, by issuing another DEF request f01: that syml.101.

'J "·''/'//

01/01/ (183. :t 2-H

I•

0 1-/'j

01/01/M;
3.3.2-15

DEBUG

DEBUG
DUi,1P

jjjfr< ~XaIT;Jl"<;:_::;:.DU:MPa. DEFI!\E IN1 12F5A

Format:Tlte cm·rcnt origin Y<llu.c will be added to 12F5A ancl the symbol 11:une INi willb...• assigned to the resulting hexadccinial core address. A lei1gth <1ttrihutc of 4l- ---------: ~~;'1~I~l~ y- -[-f~ymhol(lhe! default value) will be assigned to symbol IN1, and an entry foi: IN1 will hemade in the DEBUG symbol table.
b.

,_ ..... , ....

l

DUMP

I

DEFINE K 13 12

l
I
I

I

~---------J

111e currently defined origin will he added to the hexadecimal value 13, and theresulting addn~ss will be assigned the symbol name K. An entry ior K will bema<k in the DEBUG symbol lalik, and its length attribute will lw 12 bytL:s, as
sjk.•cificd.

l)

J ~1c;<Jt 1(idcnt________________________ _ONLINE

indicates that output from the DUM.P request
is to be typed at the terminal.

iclcntindicates that DUMP output iB to he printed
on the offlinc pr:.,t.cr, arid is the name bywhi.c11 that printout will be ick:11ti fie cl.

symbol I

is a name a:rnir,ncd (using the DEF rccp1c:st)
to tJ1c 1.:orc addres:> at whid1 the dump is tobegin.

hexloc 1

is the hcxadccirnol core k•c:•tion, rdati\·<~ tothe current origin, at which the clump is tobegin.

symbol2

is a name assigJv.:d (using tbc DEF rcquc~;L)to the coi:e adclrci.;s at which tiw dump is to
encl.

hexloc2is the hcxadc:cimal core location, rcbtivc to
the current origin, at which the dump is to
end.

"'

indicates tliat the dump is to end at the last
address of the user's virt11::tl core.

Usag~~

This request is used to clump the contents of all or part of the: us ...·r's
virl1ial core eHlwr on the ofGinc priHl«.:r or at th? terrnillal. If the user
spccifjcs "ONLINE" as the first opcrand of the DUMP rcqm~st, the con··tents of the specified core locatioas will be typc:d 2.t his terminal; otlwrwise the information will be p.ri11tcd offJ ine and will h::tv~' Lhc hC'<itling
DUMP --- xxxxxxxx, wl1crc X.'\xxxxxx is the identifier spccWcd as theiin;t operand of the DUMP request.

i1q111a; :::::: .. ; ..ii a'i' ".·.

""

_,

~·

" .:;

4¥AQU.ZM114J.kiiP¥P;z;:;::,;;;;;:e;a;,;u:;a.l'¥~1118'~~

Jtt

~-

~

fl'\

. . ··01/0l/6S,c:lt;

3. 3.2-16

3 ••
3 2 -17
DEBUG

DEBUG

-·--15UM1'
The second and t!Jird opr.·ra.nds specify the portion of core which is tobe dumped, ancl arc optional. If they arc· not given, the core address
spccificcl in Uic mo:;t recent DUiv1P request will he used or, if no previous DUMP request ha.s bcen issued, one word (four bytes) of con: will
be clumped starting at locatio11 0.
If the second and tl1inl oper;:rncls arc specified, the core addresses to which
they refer m~c dctcrrninl'd as follows: Jf tJ1e second operand conta.ins any
non-numeric cliaractcrs, the DECUG symbol table is searched for a nrntching symbol c1ltry. If a r.rntch is found, tl1c core acklress to which that:symbol' name is ass! g11ed \'/ill he used as the adcln~ss at which the clump is
to begin. If 110 match i:; found, or if the opcr;mcl contains only numcriccharacll:rs, tliC' c111:rc!11l o;·igi11 (~is csU•hli!;hcd by the OTI.lGIN n:quc:-;t) willbe Ddded to the :;:pccificd op;:nmd. The rcsulling core D<ldress will he used
as lh>:: bC'giunJng addrcs:; of tile dt1111p, provided it is not gn·atcr than theuser's virtu.:il corc size. Tile cori:; address :Jt v;llicl1 the dump is to end isgiven !Jy the: third opcrn•1d or tin: DlJi\H' rcqnc;;t. If Dll a~:tcrisl: is specified
for this opcnincl, all of core from tllc starting Jddrcss to the end of core
will b~~ dumpc'd. If ru1 a">tcrisk is not Gp::cificd as the tllircl 01w1·und, tJ1c
same procedure is used to det<·rmine the: ending 8dlh·cs!; of tbc dump asthat clesc:rilicd a])OVL! for l11e sl"urt:ing ::lddress. Doth ackln:sE;cs must hewithin the Dddrcss rruig·· of tlw user's virLU:i1 core, and I.he address specified in tile third opl:rand must be grL!Ulc:r tlwn that sp-:c:ificd in tl1c second.
The first two lines of output from the DUi\IP rl'qucst will givl! the contents
of general purpose n.:gi:;tcrs 0-7 :rncl 8-15 rcE;pcctivdy. Thereafter, the.
contents of thc spc:cificd portion of core wi 11 be! given, :n hytc:-; p:~r line,
The core address of tlw first hylc ·ill tl1c Jlm:' wi.ll be gh'Cll .in t11e kJt- lJl(JStcolum11 of the clump and ·Yi 11 alw;-iys he' on a fllll\\'ord ho1u1tlary. Tili::: m:~ Dns
tliat the contl!'nts of the COlll)lcLc fullword in which the sl:irling (:incl ending)ac!clress·cs occur will be incluclcr1 in the dump. All irnfonnation given in tiK~clump, including the core addresses, will be in hex:1dccimal format.
Notes:
a. To stop the typcout: of an onlinc clump, hit thv au.cnUon key once toenter the Cl' cnvironmc11t, and then issue tl1c l~XTERNAL con;;ole function.
111is will simulate an external interrupt ancl will trnnskr control to DEBUG.
The clnmp will have been c::rnc:elccl ancl the kcylio;1nl will be unlocked toaccc·pt :rny DEBUG requc·st except HETURN.

01/01/68

DUMP

Hitting two attenti.on interrupts during an online dump will not cause
the keyboard to unlock. Rather, the dump typcout will continue and thespacing of t1ie interrupted line imd the line immediately following it will
he incorrect. To stop the typcout of an on.line dump, use tlie proceduredescribed in Note a.

b.

Rcs~1!2_cs:

If ONLINE has been specified, the contents of the general purpose registers and the requested portion of core will be typed out at the terminal.
followccl by a caniage rehn:n, and tl1c keyboard will be unlock-eel to accept another DEJJUG request.
If ONLil'gE-has not been specified, a carriage return will be issued andtlie keyboard will be unlocked to accept another DEI3UG n:_!(1ucst. The
requcstcd information will be printed offUnc as soon as the printer isfree ancl rc::icly.

INV ALU) DE13UG REQUEST
Either no, two, or more than tl1rec operands have been specified in the
DUMP request. Re-issue the request, specifying either one or threeoperands.

JNV ALDJ ARGUMENT
This message will be:: given if either (1) the address specified by the third
operand is less tlwn that specified by the second operand or (2) the sccr:md
and/or third opcrancls cannot be located in the DEBUG symbol table and arc
not va:lid hexadecimal numbers. Ir either operand is intenclcd to be a symbol,
a DEP request must prev.ioudy have bccn issued for that symbol; if not, theoperand must specify a valid hexadecimal core location.
INVALID CORE-ADDRESSThe hexadecimal number specified in the second or third operand, whenacldccl to the current origin, is greater than the user's virtual core size.
If the current origin value is unknown, reset it to the des.ired value by-issuing the ORIGIN reque:;t and then re-issue the DUMP request.

Ex~~~£

a. DUMP ONLINE
Since the portion of core to be dumped has not been specified in this request,
the last settings specified iii a DUMP request would be' usccl or, if no settings
have been specified during the current terminal sc..:ssion, four bytes of core
will be typed out, starting with location 0. Sec Figure 3. 3. 2- C.

.__J./",:.l

I

J

)

O:!Lf1:)SSJ
LOL08SSJ
2SOJ02Lti
tiZDOLSti
8LOOOSSJ

8i?0000Cu OJ:::JC;i:OOO 0'68S:JOCO 03S00000

sttsocoo ~sv.soooo o~aotooo z:ovoooo

oz~ooooo:;stisoooo ot:oo:coo Zi:OVOCOO
8tiOOOOOO OJ:J01000 052S08CC

ln180000

til1JOL Str 0 D06lti O:l t;JO~ tiJ
1JZ1JOLSiJ 0 £JC5Iti 8ZOJO::lL~
Z6tiJtiJS5 z t1J0896 Z5tz~C1J95
095:)0\tOS 0 £0V'v'3!J 81JSJOV3S;n:;::i Zu:1sn ~scir.bci.:::'ptr-e.rado 3:NI'1 XO

iiU ! LUO Ct.;i1p

L-0 ~8:l-8 aS

OtiCV.OlJL:) ~3ZJSJ~J CO!OGCOO ~oooooco
00000000 83100000 23!00000 JOOOOOOO;ap

OOOGOO£60Z1 puaoo::oocoo 110000000 :!-8 (j;J{j;}s:noooco :JOOOOGOJ L-0 dt.:.:nppU<) oooz: au1 [LIO

oz oz
oooz

o~n

OSJZ

080l

VOOOtiOlO

OtiOtrOtiLJ ti3ZJS:)ti:J
00000000 83100000

OZOSfjQOO OZS80:Jf1J OZSSZ6fi::J O.:l~:}HZ
ornstiooo .0£880:P1J 0£8SZ5~1:J G.:i-;i:J£ ~zl6i1:)6GS6 Z3ti::rn1196 Z3!J:::l::l£% SSO:JC8L
OC~J0611J Z3ti::JOOZ6 no:::io::Lti HS::lOtiS
LOZG:)lJS:) 030S8£SJ 00080:J90 o::isoo:::isc:wna Cl!{:i JO sardu.r-cx~ ''.)-z '£ '£ a.rnfi!..I,,..

,,,,,.,""') (.:./....

.2r?)

I
I

I

i
;11~

i-ic
r;r

(;,;
(

('.

r•...r.
L;C

L"J ..,....

..... r~-1

(

(

~

(; (
(.'(

C(

l

~:2

,.... ......
Ci ,.J

<· ('

•· r
(.:
(

n·,...
('IO'·

rr ,._,
c' <
c. (
r c
(

('

c. (

I
"1···
-.t,·
r-.
~ ~- t ~ i ~ ~:. ~"<::~.. 'r_ ......
( ! .;-.
(" 1r:"·

lr--·------,------ao ! [f s;~1~~~y:·]------:
J··1··'I'~1

J'- _________ 1, ______________
hexloc1: _____r •._ i:'. ~ ;= ~ ~ ~Ir

C: r:· rLI

C'\...

t'r r: < l"'· -- 1. ~'ic c. $:. l( "1 ,.r ..;J.
-.

(,,.... L;...

I . ,C I rt
L~ ...-

f: "· C"-!

..t~- ~- ::: ~~: ;_\ 7 .~~1 ~u I.~ ti
~-!(

(C

ll

c-;.. 1cl.'ll:td~·-r-r

l: ~- :: ;~, ;. :·: :~~I~:.~~.~;:-·;,~·~IC'!-'...., (1 c
L..... ; ,-t ¢ L.:.. C C
f',I lj1'.J.../ ,..._: l,L( !

t-: (/'

(I~

C

('I'

r-i

Cir; ( u.-· C ,.. ,,~<": er Lf r ·, ,.._ . . ~ r:J r.J·

i

I

.

1-1

o.
~

....r.:10
.J3

r:

0
Ir

;:J

5

z

P.1

~~:J;:T~r:~

Q

c.- l

xi l . ..(', i:. 1.. <; c · L·{

~I~ ~ ~~ ~~ ~ ~-, ~..,,., r- rr· ,,.- .j- ·:t i:: r.··

~p-4

l!'ll

·~

;E
::i

(. c

'f· "1
~·,..

(

l..'

,.., ,.,t'"

cu

C-:t

r. u

fT'

("

_,....

u '
(.

('.

c:· (
r
r:· ('

f'.

L)...._iC' ('(.- (.

l.

{

c. ('
C:·L
':'· ('-' c.
r- LL.
I I(• :1:

er: Cf(.j(.'.

is the lwxaclccimal core location, relative to tllC
current origin, at which qxccution is to begin.

1-4

B

.$

fr

( l

hexloct0:..:r......

is a name which has been assigned (using the DEF
rcqueBt) to the core address at which execution is
to begi.n.

.-< n_· ,., .o. I.!.
.tr ( -: C'\. ..;j ....-t c~

-

~
IJ'

c .1
c"1
C· ,. ...

symbol

I

...

c..:

GO

-~~):~"'

I":.it-rc~u""'•.~ "'·'! (.·...._+; ...;1 .....
(I.!
t- ,..._,...
c r-1''1 t-. <o er· •4
L.. - t-, "1• ,... r._ l 1\i--1(,. o-dDE~y_g_GOi...1..: (.

' -!

. 01/0J/68
3. 3. 2-21,,.,, ,.,f.•t)-)-I5UMP

I

((If.

(

01/0J/68
3.3.2-20
DEBUG,.,,: _, ,..--4 "'1 <

r·

<' :;

rlifc· cc~--' rc· - ric~rr. . qr-· \..\ r-.,.

r~ ~ \:... 1,..
~.tt!
.-.! _.

rr

5

U)

.--1

r--f r'..
,.,..., r.. ·

l• i

Q)

1

~

J.- ..... ,. '. r

(!·

:; 2
n· ..........t .... !

~- ~ ~ ~ ~-~ ~

9
N

e>-5

L.°·

e>-5

~; ~ ~··, ~.. ~ ~ ~-: ~

1'.Il

~

:.::>

r,,...

ti:~·.~ ~- 1 ~ ~' ~ ;:: ;:.

l: ~ U' l!.
...t ...,. «'

e.)
r-t'

,,......

II<. r-- c> ti:f
'1 •.C it• <l .J .J rr., • ..f
C jC

C <.

u.... u N- L..
,.._,1 r- r'{ lJ<. <. r : r;J
4-f

....

,..._. (_-.t;~~~-1
L' (" ,j'> ,(', (" {

h,

ri'.'

,....i, ~.. , .. ~~": (ii~: ~ ~ ~ ~· ~; ~! ..,t':...:!
.j! ..j4~~..:!!'....., ,... ct c: ::. ,, -~~-~l ~. J ;;, ; :. '$_ -;;.: ~~·etc d(.~ <.· C~

Il

C'C

t

er::

N

-:r" c...: F\JC. . .J- rr·

r:I<"

C. ~ .J L· ,.,. 'j ( ,I.

l)Usage:The GO request causes the user to lenvc the Debug environment and tobcgil't execution at either a uscr-specJfiecl aclclrcss or at the address contained in bits 40-63 of the old PSW for the interrupt which caused DEBUG
to bu untercd. ThiB PSW is s<tvccl wh~n DEBUG is entered, and is lo.'.lclcd
to become the curreHt PSW when a GO rcciucst is i ssuccl. If an operand isspecified in the GO request, the i11strnction acldrcss portion o.f the PSVv
will be altcrcd to contain the address indicated by that openmd before the
PSW if; loaclecl.
TI1e core address indicated by the GO operand.is determined as follows:
If the operand contains any non-numeric clwrncters, the DEBUG symbol
tnblc is sl~archcd for a matclling symbol entry. If a nutch is fo~1ml, t.hecore atldrc~•~; to wlJich that symbol nanw is assigned will be used as the
locali<m nt wliicl1 cxc;cution is to begin, and will be moved to the saved
old PSW. IC no mnt:ch is found in the DEDUG symbol table, or if the operand contains only numeric ch::u:uctcrs, the current origin (as establisht:dhy the ORIGIN rcquc:Ht) will be acldccl to the sp0cifiecl opcrm1c1 and the resulting addre~;s will be moved lo the PSW, provided it: is not i:;reater than
the t1ser' s virllw l core size;i>rior to lo;.idinr, the PSW, the general purpose registers, channel address
word, uncl cl1;.innel stat1rn word will be restored as they existed wl1en
DEBUG waG c;11tcrcd, or, if thc;y have been moclific:d b~, the user in tlie
Debug cuvironmc11t, to tl1cir modified cu11te11ts. Tiic sr1vcd old J'S\'/ willthen he loritlccl hy DEBUG to Jwcornc tl1e current PSW, and ·execution will
begin ot the specified instruction ackli:css.

c-1.1 L:.2~·l{ll/Ol/6B

OJ/OJ/Ml
3.3.2-23
DEWG

1:1-S?

3.3.2-22
DEBUG

J.~/

--60--GO

Exampl~:}.'.

a.

GO

The old program status \'.'Ord for the interrupt which cnusccl DEBUG
to be entered will be loaded as the current PSW, and exccutio11 will
begin at the address specifi<:cl in bits '10-63 of that PS\V.

Nc·tc!':''·'I11c GO rcr1ucst should not be issued without an opernncl unless theb. GO INN
The DEBUG symbol talJk will be scarcl1ccl for symbol Il'-!N and theaddress to which that symbol is nssi[;ncd will he loaded into bilH
40-63 of the olcl P.:;W prior to loading it as the ClUTCilt
Co11trolwill then pass from tlic Debug environment oncl exC'cuti.on will begin
at the core address to which symbol INN refers.

D,:l>u;; vHYironmcnt has been entered clue to a breakpoint interrupt or to.:n1 cxtl!::nal or progsam interrupt.

rsw.

b.

\•ni,:11 an op<:!rand is sp.;cificd, the GO request may he issued at any
time in the· Pebng environment, except when DEBUG has been entered to~e:·t bn:akpoir.t:_; in a program prior to starting it.

c. If m1 op.::nm<l is ":;p~:cifictl in the GO r.:,1ucst, 1'11e address to which itn.:krs should h~ l~H: core location of an opcn1tion cock.

c. GO '123·15
Tile cur.rent origin will be added to location 12345 011d th-.; resulting
adcl:rcss will b;:; phlcccl i11 bit::; 40··63 of the old I'3\'i p:doi· to loading it

as the current P3\V. Control will th2n be tra nsfoJ:rccl from the DC!bugenvironment and execution will begin at the spc~cificcl U(ku:cr.:s.

Ih ,-;·::.~1-~c3:
li th;; c:O ~~cqucst has b2cn issuc~d si.1cccissfully, a cr.rri::i.gc return will hei:;su\'il ~me! CXL·cutinn will continue from th~~ .f:i.lcl!·css contained in tile PSW
wl.ich 1:as h<,<.:11 lo<1d:·rl.

ll'\\'.\.LlD DFllllG gEQUl·:S'f'I11is r .. .-·p··n:.v imlic:1ti·~: tlwt 111orc tli.111 n•K C1Jx:n;1ul !w;: l1ccn f:pt!cificcl inth.! (;() rcqucH.
12'~\T,\!JU

Rc:-issnc the GO re:q:1e:st in it;:..: correct format.
AJlc;t_:\JENT.A.n o;·<T~rnd k1;; l':·c:!1 sp~·cificd ii~ the GO rc:quc:.~.;t which c,rnnot Jx; located in
tJ1,: nr:.:~11c; ,,_:1uhol t~d;lc: anJ wh;eh if; Pc)t n v:i1id l:cxadc:c·imol 11umhcr. If
tk: r:;·;;·ra:id i;; i111.i.:J1tl,'<l to lw ~1 ::y1111io1, a J)f~F request rn11st have been prcvio:yl'.· i;;s:1cd for Lh<:t sym!J,,J; if n<)t, the opf~.i:and must spcdfy a v.11icl

hex<>:, cimd cur,' loi.:ation.

1;.:VAUD crn:E-f.DDRFSS
1ltL' ;i-'c1 rcss ;::t v:hicl1 exccutio.1 is to begin is citlwr 1101 on a halfword
b0~1LL ry (indicr,ti1:g th1t an op,~ration code is not located nt that acklrl!ss)

or ti;~ sum of the GO t>p~rru1d <~ncl the current origin value is greater than
the t::><"1·'s \·irtu.:il core size. If the current origin value is unknown, it
may b · re: set to the dL:sircd value of i::suing the ORIGIN request.
Ii\COlZ~\ECT DEBUG EXIT
111e GO rcqu,_·~;t has h..:cu issued without an operand when DEI3UG had notl><~t·n <.: itl' red dm.: to a bn·akpoi 1;t, extcnrnl, or program interrupt. The
1PL, K X, or RESTART n·c1ucst:; may be issuC'd in thi::; case; GO may be
isst!<.:d with an or:;:rri11cl; or the RETUl\N request may be issued if DEBUG
had k~·?n cntl~rcd vi.'.\ th2 DEBUG comm:md.

] iQ!ii!i!ijJU ii!i!il,

'' '

~

~

lft+
. ,,,,.

....... , .., ' -'~I 44 -

h ' .4#$2il! Jt ' !WI'· ;: i£ii I.., I t . ' J,•. I Hll,,...

I"\

0!/01/68

1vc,

J." I

3. 3. 2 -24

DEBUG---GPR

GPR
Format:-----~01/01/68
3.3.2-25

J?-7

DEBUG

Gffi
_)

·---,..----- ----,
;

GPR

L- -

;

G·egNJ

rcgl- -- ....1 - -- -· ---f- _- _Jregl

is a d·ccin1al number from 0-15 inclusiV<'7
indicciting the first or only general purpose
register whose contents is to be typed out.

regN.

is a clccilnal nurr1ber fr01n 0-15 inclusive,
indic.iting the last general purpose register
whosl' contents is to be typed out.

Usage:

gpr 8,

002J\1A88
The GPR request may he used io inspect ihe contl~llts of one or
n1ore general purpose registers as they existed when DEDUG was
cnkrccl. If only one ope nrnd is given, the contents of_ the specified
regbter will bCJ typed out at th<.~ tl~rrriiirnl, If two opl~r;:tnds arc given,tlw contents of ~he registers specified by the first through the second
operand, inclusive, will be typed out.

- r,pr 5 J. 5

OOOJ\5008
002AlJ\88000091338
002/\1/\8800000100

Both the first and second operands rnusl be decimal nun1bers fron1
0-1 S, a11d the seco11rl opc·raJlC! n1U",;t be greater than the first,

8000%70sooo~r:nA

G00095C2
OOOl llJl10
0000550C

Re i~pon!'t: s:
If the request has hct'n correctly issued, the contents of ilw register( s)specified wilJ be typecl at the tern1inal -- one pe1· line -- and, following;:1 carriage return, the keyboard will be unlocked to accept ;mother DEBUG

000095B8

request.
INVALID DEBUG HEQUESTThis lTH'ss:-i.ge bHlicates that either none, or 1norc th::rn two, operandi:;
have been specific·cl. H_c,--issue tlH' request in its proper format.
INVALID ,ARGUMENT
This response }vill be given if the operand(::;) specified arc not decimal
nu1nbc·rs between 0 and I 5, or if the sccon<l operandi:; less th<tn the!ir st.
E >~!2.11! l <::sa. GPR 8
The contents cif gen<'ral purpose rcgish~r 8 as it existed when DEBUG
was c:nlcrecl w)ll be typvd out :ilt the terminal, (Sec Figure' 3, 3, 2-E).

b. CiPR 5 15
Th1.: cont.~nts cJf general purpose registers 5 through l 5, inclusive,
will be typcd qul as tlwy existed when DEBUG was enter•,d. (SecFigure 3, 3, ?.-Fl.
. 1

FIGURE 3. 3. 2-E.

Examples of the GPR request.

•.J7fo).:;{..:;.-,

J/I
01/01/68

3.3.2-27

3.3.2-26
DEBUG

DEBUG

-K:-x-·

IPL"

KX

IPL

Format:,- --... --... ---- ----... -::KX!
:________ .., ________ ,Format:·----------------.
:
IPL
:
I

I

I

I

111 J ll'L rcqur·st will c:nrne control to transfer from the Debug environment to the
Cl\:S Comm:111cl cn\'iron;11cnt. Il'L may be issued <·t any time when the h~ybo:i1·d

tois imlockcd in the Debug environment, rcganUcss of the circumstances in which
DEBUG has been entered.

Rcspm!~.S:~

Issuing- the IPL.request will cause a new copy of the CMS nucleus to he Lrought
into core from the system clisk. This new copy will overlay the user's former
copy of the nucleus, cnusing all symbols which had been previously defined by
DI :F reciuests to be cleared from the DEBUG symbol table.

KILLING CMS EXECUTION • • •P-DISK: xxxx IU.:CORDS IN USE, xx.xx LEFT (of xxxx),

xx% FULL (of :xxx CYL.)
TlliH response i11dicalC'S tlwt tl1e KX rcqnc:st llas b':'.r·n ('}:ccutcd D.ncl thatco11trnl lws passed lo the CP cnviroJJJncnt. The kcyJ;oard v:ill be unlocked to accept any CP console fonction. The thrl'c XY~u: fields in theabove mc1rnngc indic:ite the number of goo hylc rcconls on the user's
permanent disk area which arc in use, free, ancl assi~ncd, rcspcctiv<:Iy.
xx specifier, the percent of assigned recorclr; in use, and xxx is thenun1bcr of cyliudcrs assigned to the user.

.:..:.:::~l?~_1:.~:~s:

CMS INITIALIZED
111is response inclicntcs that the IPL request has been successfully executed nnd
fo;1t control h::ts passed from the Dcbue environment to the CMS Command environnwut. TI1c keybonrd will be unlocl:cd, following a carriage return, to accept any
CMS comnrnncl.
·
INVALID DEBUG REQUESTINVALID DEBUG REQUEST

111is response indicates that one or more operands have been specified in the IPL
rc•1ucst. Re-issue the request in its correct format.

!U

Ui I, .

II

The KX request will close all open files ::me! I/O devicer., upd.:itc the user's file
dircct0ry, and transfer control from the Debug cnvironrnc11t to the CP environment. TJiis rcqucr;t nwy he Issued whenever the kc-yboarcl Js unlc.C'l:cd in the D~hu;~environment, rct_:"<irdlcss of tile circum:>tancc~; in which DElJUG has l1::::cn c:1tcred.
In orderobtain a new copy of CMS once the KX request baG been issued, an
IPL console function mu ct be issued in thu CP cnv ironmcnt.

!l~'.'E",,111 ii

II~;·_~'.~

I----------------1~

01/01/68

This response indicates that one or mOJ:e operands h:we been specified
in tlJe KX request. Re-issue the request in its correct format.

~~, ::;:;::: : :.: .:.;:::ss.:m:siii:t :. ::: .1111.: . . :::1414·*11 u:a:: :;;1~,.111...,,1·1r,....,_."'f""'"" , . .,..,,~.

~

~

"1
01/01/68
3. 3. 2 -28

11:,

cl-/)

Ol/Ol/6S
3. 3. 2 -29.1;'"i.. ·
DEBUG
,_ .
ORlGlN.2-J?J

DEBUG-----oifiGIN
I

__

/

, .. ,!GlN
B:~.<?..J.l:Scs;_

Forni;1t:i ---If this rcquL~st has been correctly issued, a carriage ret11l.·n will be given
and the keyboard will be unlo.ckcd to accept another DEBUG request.

}- ----~~:1~1~~ -T{- ~;~~1~1~~; ~,:INVALID DEBUG REQUESTThis response indicates that the wrong number of op\':!roncls have been
specified in the ORWIN request. One and only one opcnmd must be

hcxloc.l ____________ It _______________ :I

spccif.iccl.
symbolis a11y name which has been .?.ssigned toa core address w>ing the DEF rcc1ucst.

hcxlocis :my Jicxaclccimal core locntioH between
0 nnd the encl of the ti.•;c:r's Yirtual core.

INVALID ARGUMENTThe opcrancl ::-;pccificd in the OIUGIN request cmrnot be locatccl in the
DEBUG 8yrnbol table and is not a valid hexadecimal number. H the
opcrancl is intended to be a symbol, a DEF J~:quest must h::i.vc been prcvously isnuccl for that symbol; if not, the opC!rand must sp:.:cHy a vaJid
llcxaclccimal core loc.ntion .

.~:':''re::_Thi::-; rcc1ucst allows tltL: u~;o· to s1x:·cify an "origin", or ba.sc mldrcsB,
v:lii ch wi 11 be adcJ:,.-d to tlK· lwxadccimol locations spl!cified in ot!K:r
Di~Jl,UG n:qul·sts.
l!or l'Xamplc, tile OHIGIN request: cnabks users to
top...:·.:-iry in~•tn~cl'iO!l addrL'H!5l"S rcLltivc to pnigram load points, rathertli;·11 tti 0, whik operating i!: thv Lkhug e:nv.ironmcnt. Jf the OiUGlN
n·cF1c·sl is not is:iut:d, nll llc·xack:cirn:il locations sp:.:ciflcd in DEBUG
rcq,1r:sls are ''''~'urnwd to be rl:Jut·ivL: tCJ 0.
Wh.:n an OlUGl0i rcqut.:;,;t is iRSll<-'ci, tl!i: origin setting is determined as
fullo,•:s: If th<.! Ol{JGJ!\: op.:.r;rnd cont:<lin.s any non-numeric chan!C:tc~·s,tlic DEBUG sy;;;b~il table is :.l!archcd for a matching syml.Jol L!11try. 1f a
L.1atcl1 is four1d, tk· core odilrc:;s to which that symbol name is nssigncd
will bcc:c11111.: tl•c 1jL·w origin ::Uling. lf 110 match is found in tl1c DEJ3UG
sy111!Jol tal1!c, or:if tltc op~!rand contains only 11umcri<.: characters, theacH1 css &p~cificd in the opt:ntnd \'.'ill bl!c01m~ the origin setting.
I~.ny origill set by! an OHlGH; request wm rcnwin in effect until

another

ORICIN r\:quest or a REST1\RT rcCJlll:st is isf;ul!d, or uutil the user oht:1i11s a new copy of CMS. \Vlwnevcr a ncw ORIGJN rcquc0t is issul!d,l111· value .sp<..!cifidd in that n·qu<.!st will OV('rlay Lhc previous origin scttill?· Jf the u~.cr ol>tni11:; a 1tcw copy of CMS or issues a RESTART rcCJ.llL':>t, thl' 01·igin will be: sc·t to 0 until a new OlUGJN rl!(!l!C!St is issu~!d.

INVALID COHl<:··ADDRESS'l11c adclress spcdfi.c<l by the ORIGIN operand is gTcat•::'l' than the twcr' s

virtwll con) size·.
l~.X~·!!.1J:1E.§.:a.

O:RIGIN
12000
Tile orit;in will be set to the hcxacl<~cimal vDlue of 12000. 'l1wrcaftcr,
12000 will he mhkd to :ill hexadecimal locutions sp.:.:cificd in other
DEBUG n:l111~sts and tile resulting core iiclclress will b(; rnfcr.c!ncctl.
b.

ORIGINXYZ5The absolute address assigned to sym.bol XYZ5 (proviclL!d an entry for
XYZ5 exist:;.; in tJ1e DEBUG symbol table) will become the new origin
setting. Tliis scttin& will be added to all hcxaclccimal locations sp~ci­
fied in otJ1cr DEGUG requests t.lK'rcuftcr, and the resulting core address
wil 1 he n:fGrenccd.

J,;.;-/'~;

01/01/ 68 .
3.3.2-30)/~::

DI /0 i/G'G
DEBUG- --.rsw

DEBUG-ffi\vrsw

15

Problern state flag, set to 1 when the inachineis operating in the problem state rather than
the supervisor state.

16-31

Interrupt cock, showing the source of theinterrupt (for external interrupts) or thecause of the interrupt (for progra1n interrupts)

32-33

Instruction length code, indicating the length,
in halfwords, of the instruction being executed
when a program interrupt occurred (11nprcdicatahle

Format:,----------------,
I

I

:

rsw

I

I

:
I

I

I----------------'
Usa~·n1is request will type out the contents of the old program stntm; word
for the interrupt which cmiscd DE13UG to he entered. 1£ DEflUG wns
1 ·uti.:rcd due to an -external i Iii crrupl, !.he I'S\\' 1·cc;-. "St Will ca•JSC Lliccontents of th~ external old J'S\V to be typed ~t tlK' kr111i11nl. Ji ripro,~ram interrupt caused DE3UG to be c·ntert'd, the contents of the
program old l'SW will be typed. I! DFULIG was CJiV·rcd for ally otlwr
reason, the follC1WinJ WilJ be typ~cJ ill t·cr;pOllSC to the ffi\V l'CCJU<:!3t.

for external interrupts).
34-35

Condition code, which reflects the result of aprevious arithmetic, logical, or I/O operation.

36-39

Progran1 rnask, indic::iting whether or not various
prograrn exceptions arc allowed to c;.usc programinterrupt~;.

0 ·1 OOOOOOxxxx.0.xx
40-63

where the 1 in the: first L•yte me:a11s tlt:it cxtcriwl int~rrnpt::; arc allowed
and xxxxxxxx is the hexadccin1al cor::: m!:lrc1,::,; r;f the DEUUG progr[•lli.
Th~ fidds of the pro.;r•un stntns word ~ire as follow:-;:

Oits
0-7

clff:

3.3. 2 -31

For a further discussion of progran1 status words and their use, refer
to IBM manual A22-6821, Principlc~of Oj)~_!~t!i_'?P:

Contents--~- -~--·--···-

System mask, indicating the sources which arc
allowc.·d 1·0 intcnupt the CPU.

8-11

Prowctio;1 key, used to determine if a given
core Joc:.ition mny be written into.

12

ASCII flag, indicating whether ASCII-8 or
EBCDIC code is to be used.

13

lvfachinc check ffog, which is set to 1 whenevera machine check occurs.

14

Wait state flag, which is set to 1 when the Cl'U
is in the wait state rather than running.

Instruction address, giving the location of the nc,xt
instruction to be executed (for program interrupts)
or of the instruction last executed (for external
inte1·n1pts).

Responses:

If the request has been correctly issued, the contents of tfo~ ap;oropriatc
program status word will be typed in hexadecimal representation at theterminal, followed by a carriage return ancl an unlocked keyboard. See
Figure 3. 3. 2-F for an example of response to the PSW request.

11:'.'V ALID DEBUG REQUEST~
iij

TI1is response indicates that the user has specified one or more operands
in the PSW request. Re-issue tlw request in its correct format.

~""'· - - - - - ·- - - - - - " ' " ' " " "

,,..

fl"'.

)Jl

'01/01/68
3. ~I. 2 -32
DEilUG~-) .·/"'I·a'.11011us
3. 3. 2 -33

DEDUG

RETURN-·r~]~s-;rARTRl

Im TURNART.!:_orma1;!

1:~~!2_1_'-~!.'.

i----------------,··-----•-------··--------I:I

RESTART

I

:

:I

I

I

I

RETURN:I:·------~-·------·--·-----I

g~~LE_!!spgc::

The RE'STAlt".I' request is intenclc:d for use when un Cl.Tor has been encounteredwhich the user cannot or does not wish to correct, but when the user wishes torcta.in his cm-rent copy <if the Cl\·1S nucl(•us ::ind all currently defined i.;y111b0ls andbrl!akpoir.ts below Jwxactccimal core location 12000. Successful cxccation of J1eRESTAJZT rcqul!st will transfer the user from the DdHt::; environment to the CMS
Command environn1cnt.
\\'hen the RE~TART rl!quest is issued, an attc·mpl will be nrnde to re-initialize the
CMS nuch.·us in core, i. c., without bringing in ~~ n.:.:w copy of tile~ nucleus fromtile r;ystL!ll1 di'sk. \\'hen RESTART is issn:::d the followi11g wl1l occ11r; (l) the origin\•,ill be set to 0 (2) <111 breakpoints a hove hc:xttfk!cirn:il core locaf.inn 1 '.2000 will becleared (3) all ov.::rrides will be cleared(-!) the a.:tivc file t::'·h'lc \\·.ii! becleared ;rnd (5) the last user iile dil'vctory writtcil to dbk will be brought' in to
rvplace tilaLcurrcntly n:siding in core.
If RES'IAltT t.:<1111101 lie: succ;,ssfully e:xcC'llkd, i. '", if no re~;J'OJHlt: i,.; giVL'I> Ill the
RESTART rq1m:st and tltc: }'.cyboarll n.!111:1ins lod.ed, the u:;l!r rnay olit.:..tin a 11,~w
copy of C:vlS by hilling tl;c at.Lc:ntion key once and typing "lFL 190".
J~L~SJ.ll•~l ::<:.:~~

T =xx. xx
Tllis mesagc,. followed hy a cnrriage return and an unlod:ed keyboard, indicatestlwt the RES'fART request h<:s been successfully exccull~d, and that control has
t rvnsfcrn:d from DEBUG 10 the Cl\!S Co!llm<rnd cnvi rnnmcnt. xx. xx in the above
mcss,1ge is the CPU tinw (in seconds) which has been used since the last Cl\1S
command was is~:ucr.1.
INVld,JD DEBUG REQUEST
Oac or more Operands linvc been specified in tJw RESTART request.

the requ~~st in its correct format.

Re-issue-;,- (.,~ /·'

This request is a me.ans of exiting from the Debug environment to the
CMS command envir01m1ent. It should b::! used only when DEDUG ha.sbeen entered by issuing the DEBUG command.
When tt1e ·RE'IUHN request is i{~Stwd, the general purpose registers arc
restored with either the information they contained at the time DEBUG
was entered or, if the user has SfK~cifiecl a change to this information
while in the Debug environment, with tile chu11gi::d information. In either
case, register 15, the error code register, will be set to zero. A branchi& then made to the address contained in register 11, the nornial Cl\lS
rct1in1 register. If DEBUG has been entered by issuing the DEBUG command, register 11 w:Lll contain the address of a cenLcal C~.lS service
routine mid coutrol will transfer directly to the Cl\1S Com\rn~nd c1wiron -me.int.
~!21?.~J~.~~_s_

R; T= xx.xx
Tile Ready message, followed by a CQlTiugc return amI au unlocked keyboard, indicates th:it the RETURN request has bc8n successfully cxccutt:cland that control has transferred from tl1e Debug environment to the C!\1S
Conrnwnd environment. The xx. xx portion of the Ready rnc:;ssngc gives
the CPU time, in seconds, used while in Uie Debug environment. After
this message is typecl, the keyboard will be Wllocl:cd to accept any CMS
command.
I.NV ALID DEBUG REQUESTThis message will be given if one or more opcrunds have been specified
in the RETURN request. Re~issuc the request in its correct forrnct.
INCORRECT DEBUG EXIT
If DEBUG had been cnterccl due to a program or external interrupt or theencounter of a hrcalqioint or cut um:ecoverable error, this message will
be typed in response to the RE'IURN request. To exit from tl1c Debug
environment under the nllovc circumstances, issue either the GO request
with an operand, or the IPL or lrnSTART requests. 'Die GO request may
be issued without m1 opcnmd if DEBUG has not been entered due to an un recoverable error.

)1;:;

2 //

f./!

·--//

1)1/01/68(

3. 3. 2 -31
DEBUG.
01/0J/liS
3.3.2-35
Dl::UUG-sr:>r---sFi7SET

The number of bytes which can bu stored using the SET rcqm·,-;t varies cl':!J'c'ndi11r,
on th-:~ form of the request. WU h the Cf\ VI form, up to four byt('B of inform:ition
nrny lie storc.:d. WW1 the CSW, GPH., ancl PSW forms of SET, up t:o c.'l~;lit hytf:.S of
i11fon11ntion may be sto:.-cd, hut lhc~;e inm:t he l:C:pJ:c~;cntcd in two or2r;in<'.~; 0: fo;n·by~c~; cnch. \Vh(:Ilevcr two op:::raucl~; of informntion arc r;p.!cificd, the i1Jurm;-ct'.nn
will be stored in coi1sccutivc locatious, even if one or both oµ.::rn1ds cont:;In ks:::
than four bytes o( information, as shown in Example b.

Fornrnt::'{CAW)hex info: rsw

hcxinfohexinfo( hexinfo)[ hexillfo)

:GPR

reg

hcxi.nfo

SET : CSW

(hexh>folJ

The contents of registers which have been changed using tltc SET ru1ucst will n'.'t
he typsl uat after the request L:w been issued. In o.rcl:T to in~;p~c.t th~ ccmte;ntn
of these rc·gistcrs, the user slml']d issue Cf.W, CSW, H;w, or GPR rccrJo~tr.:, ~"snccclccl. Pig11re 3. 3. 2-/\ contains examples of issuing thc~;c rcqucstn ho1:1 h::fo:i.·12
and afte1: the SET rcqncr;t has been ism1cd.

------------L----------------------------------------CAW

indicatcr; tlwt the specified inforrnntion is to bi'
stored ill the clwnn.:!l address wc•rd v•hkh ('Xif;i-.·dat the time Dl.:I;UG was entered.

csw

indicates that the spl'.:ific'fl i11[orn1;11 ion !s tu lw
stored in the ch:innd st<1t11~~ word which existed
at the tin.c DFm JG \'.'<HJ entered.

rnw

indicate.'; th:1t fo.,. spc~:ificd infurn1:ilioP ir; to hl
stored i11 the (Jlci pro~~u1m m:atus word Jor 1hc
intC'rrupt \'tltic:h ca11sc·d Df!BUG I•• he e111vrcd.

GPR

indic~t".!B that the .c;p('cifiC'd in[onnation is to be
stored in t!Jl'; gcnc:r<il puqi(I:;(~ i'< :,_;iSl<·i· 1·.i\-,-11 ;i:,the second opcn1111l.

Respon~~_:::_:_

Ii the rcciucst h~_,s !wen issued ccH-.rcctly, a carriage return will be issucrl and the
keyboard will h:] unlocked to ncccpt another DEDUG request.
Il\1\T ALID DEBUG REQUEST'l11iS rcq1onst inciic;!tC!S th:1t t·ltc! wronp,- llllmhcr Of Of.::'l'::tllds hc>\'e b1::cn specifit·din the SET request. If t11c CA\\' i:.; Jic~ing t:et, two op2ranr!s rnuf't be given. To ~:ct
the CSW or tl1c e:>W, either two or three op2rr.11dr; arc required. 'fo sd a GPR,

either tJJr(!e or four op'-!rnnds must be givcn.

11:\T\T ALTIJ /\IIGUMENT
This mci;sagc indicntcs tluct Cit'IP_'J." (1) the firGt op:?)"<Jild is no~ CAW, csw, r;W.' or
GPR, (2) the fin;t op2:rancl iB Gl'R :md tile second or:~1·1rnc1 is not a dccirnd n•;:nb~:r
between 0 and 15 inclusive, or (3) oac or more of tb:. "hcxinfo" o;:.3ra11cls docs notcontain hexadecimal i11formntio11.

Us[~.19.:_· 111c SET rcqucE;t is used to change the contcnt·s of con:.rol a11d gc1v.T:il purpcisc:
rcr,istcrs \•:llich nrc movl'.'d from thci1· non11:il locations whl'11 lhc· DFDUG en\'ironrncnt is c11tc1·cd. The contents of these registers will he n:storccl \vhC'n control
transfers from DEJ;UG to 2notlwr cnvironme11t; if the register contents h;1vc bec11
modified in DEBUG, th·:• cbong-ed contentB will he rcs1·orc·d.

~X~!_1J?!.~?.'.

SET CAW 1100
This example would c::iusc the two-bytes "1100" to be plricccJ in t!ic first t'<'!O b:,'t<:1;of the ch:inncl nrldrc:;s word wllicli existed when Dl~euc wus eutcreu. Sec Fi[',LIT<: 3. 3, 2-F.
1l1is new clwnnd address word will be! restored wlicn rm exit is n1aC:c fro;,, tl!c DEBUG
cnviromncnt.

·a.

The rcgir:ti.'l" wliicll is tL• he modified is spvcificd ::is th.:.~ firs! opC'rand of the Sl::i'
request, ::incl the info.trnatio11 to be inserted in this rcgistl'l' is given in h1•xadccirn;ilfonrt(1l in th,! "bcxinfo" op2ra11cl(s). Each "hcxin.fo" opcr:rncl should be frorn one rn
four l>yt~·s (i.• e., two to ei~~lit hexadecimal digits) ia lcngtli. JJ an opcr:.md is kss
thnn ftH1r bytes in length and contai1:s an 1111evcn 1111111ber 1Jf hcx;1dt!cim;1l tli),:it.s(repn::scnting lwlf-bytc iufo:cmntion) the i11fonn:1tion will be. right-adjusted and I:;.
kft haH oI the uneven hytl! will lie sc~t to 0, as shown in Exampk h. If more th;111
eight ltcxmlccinrnl digits :ire specified in a singk oper:1nd, llK~ infornwt1011 \1·ill be
left-adjusted, and the additionnl digilf:l will be t:n111ca1<•d (111 the right and lost.
(Sec E:;amplc d).

~1~1~~~~~,ijU\!i!fy!jii'1:+!h,ili,,,,.,.ijP'1 ~·".

11·~~. ·., 4.,,,,

·f(,/

b.
SET CSW 001 OOFFS1
Sincu <Ill u1wve11 num!1er of byll!~; is spccific:cl in the rwconcl 0v~nrn1l, a zero will beplaced in the ldt··mo::;t h:ilf-hytt:, givin1,-. 000-1. 11ic;,;c two bytes, togcthe1· with t!.c
three bytes given in the second op~·rand will he placed as a single five-byte field
inlo th~~ CSW which existed when DEDUG was entered. Se:c Figure 3. 3. 2-F. 'li1is
new cl1anncl status word will he n::;t1Jrcd when lcavilig the DUJUG environment.

...

A~'!11' I "1111l!ll·;_.,

I, .. ;.. 4¥ 12 . . ,u. 1. :::; ..,:11~11m1111•c-::1.,J\#4\hiifWH¥;:;,;;.w41414;1w;91

,,,,.,

~-

~

3,'i

7

01/01/68

3. 3. 2 ~~g 1 101/68

p_g_nuc
siT'f
SET PSW 01000000 00012036
The contents of the entire program stat11s word for the interrupt which caused
DEDUG to he entered would be rcplnccrl hy these eight bytes of informntion. Sec
Fi[jm·c 3. 3. 2-F ., This PSW would become the current ISW when nn exit is madefrom tltc DEI3UG cnviromncnt.

c.

SET GPR 5 0000123-15
In this cxamp1c, the contents of general purpose register 5 arc to be rcplacccl by
the information S-ivcn in the third operand. Since this informntion is grcnter tbnn
eight hcxaclccirn<ill digits, it will be left-adjusted and the extra digits will be trunc2tcd on the right, giving 0000123'.l. Sec Figure 3. 3. 2-F. General puJ·posc rcgic;tcr
5 will contain this new informati(J!l when the general plirpose rcgif;tcrn arc l'C8torccl
prior to leaving U1c.DEl3UG environment.

3. 3; 2-37

DEBUG

3.·~

)
Co\'/

SET

00010FE8

set c<m 1100
C<'l\'I

llOOOFF.8

cl.

CS\/

OOOlOFFROCOOOOOS

snt csw 001 OUffHl
CS\/

000100FF81UOOOOS

PS\'/

010000000000!.151:8

set rsw OlUOOOUO OU01203G
rsw
0100000000012036

J>.pr ri
Oll!JU7F68
sf't

i~pr

5 oouo12::;1isgpr !.il)•J001234

FIGURE 3, 3. 2-F'.
Exam.ples of the SET request, using other re~p1ests
as appropriate to inspect contents both before and after SET is issued.

I~
f,,,

J
"l

3oJ

.3c- t/01/01/68

3.3.2 -Rsvo1/68

3.3.2 -39
IJEllllG

DEBUG-·--s1~01rn-51~0I\E

A maximum <if 12 bytes mny be storcd at one time w;i.11g thc STORr\ request. Th.is
if; done hy specifying 1J1n·c op'.Tanc1'; nftc1· the· Jucatiun ope rand, C'i Ch (Jf which containfour bytl'S of infrirmntion. 11 k~:s than fodr hytt·:; arc :;p.Tificd in nny C•r [Ill oi iiic:
opcroncls, the information given will be; ~1rn1ngecl inf:(J a string of consccutivc Lyi('s,and that f.lring will be stored starting ill tile location given in the first 01x·n.md.
Stored information will not lJc typcd out at the tGrminaJ. To ins1x~ct the ch:i.ngc;dcontents of core afwr a STORE request, the user nwy issue an X rcqae::;t, as shownin Pigui:c 3. 3. 2-G.

STORI·:

1

Fonn;it:: ... ---------------.---------'

STORE

:

\ sym holJ

hcxinfo_______________ L---~~~~~--------symbol

lwxloch1.:xi11[0E1cxi11(0(hexinfoU

is a name assigned (using tlie DEF. request:} to the co:::c
address at which the first byte of sp:::ciiicd infonnotion
is lo he sto.rcd.

Re~pons,(;!~.

.

If the request h:1s Ileen correctly issued, a corri:•gc rc;turn will be given and thl~
keyboard \vill l>c unlocl~cd to accept anotli•.',: DEBUG request .

ls tl1c IK!X'Hk:cimal Jr>catinn (i-clativc tn the cun:cnt
orip;i_n) where th(! first byte of iufon1wl io11 is to be
stored.

11'.T\' J\LJD llEHUG REQUI:'.ST
This re:,;pon:-;e to the STOllE n~•111c~:t indic;1tc~; that citl1cr Jess tl1an two or more
tha11 four open1nds have l•ccn r:pc:cificd. Hc-ir:rwc the request in it:-; correct fonw1t.

is any hcx~1dccimnl inforn1:1i ion, .fum: byk~: or kh~;in lc;n~~th, wllid1 ii; to lie ston:cl r;tm·Un:J, nt the nddrcr:s

INV /\LlD /\RGUMENT

s1wcific:cl by the first oper<tnd.

This n1.cssogc will le ;;ivcn if either (1) till.' fin;t op·~r;inJ c:rnnot he locat<:.:cl in the
DEBUG symhnl U1blc <incl is not n valid hexadvcinwl mm;bcr, or (2) i11forwation
spccific<l in the f:econtl, third, ancl/or fourth oper«mls is not in hcxark:cimaJ fo:..-1rn1t.
If the first operand is iutcnclcd to lie a sym!lnl, o DEF requc;st must h~iVf! hcen
pn'vio11;_;Jy h;uuc:d for !ha!" Hyrni)i)l; if not, the (•p<.1·;111'1111111;1 specify" valid lic•;:ickcinwl core loc:11 i t;ll,·!-~:is~:_This n:q11c::;t allows tlw user to st.ore information in ::iny virttwl core loc;ition. The
loc;1tiP:1 ~1t which the i11f1_innal:io11 is to lie LJ((ln:d i~.i t;pc·cifiC'd !.iy tl1c fi ml upu·1111c1 nnd
is tk:tcnninccl <rn fl)Jlowt:: If tl1L' fil"St opcr:md co,1tu.ins i~ny 11ou·-n1111h·J:ic d1an1ctcrs,
the U!·:I>UG syntliol. t:dilc i::; t'c:n:clJ(:d rur a rn•llchi11g sy1nl>ol en! ry. If a mntl'.11 isfound, the core addr('ss to which thr:t symbol mrmc is assigned will be used <1s theaddress at which infon1wtion is to b,~ stored. If no motch is found i1~ the DFBiJG
f;ynilool tnhlr:, or if the first opcn111rl cnnt:ii.ns only numc:ric charnctcrs, the current
ori1c{in will he added to the spc·cilkd operand and the rcsulti n~; core ;i 1Jdrcss will heused, provid:xl it is 1K>t gn·Mc_r th:rn tlic 11scr's virt11nl core size.

INVALID COl\E-ADJ)]lEf>S

The current origin v;iluc, when atlclccl to the hcxaclccirnal number ::iJk•1.:ificd ;;is thefirst OJX'rand, givl'S ;111 addrc::;s g:cl!atcr than thC' user's virtu~:l core size. If theor.igin value is UJJknovm, J'.csct it to tli~ desired value usiug tile 01uc;1N rvr1ucst
and tlwn rc-is.c;ue the STOHE request.

'l11c iiiformatif.•ll to bi:: stored mLwt he giv.:~n in he:xadccinwl form<it and is specified
in tl1c second througl1 the fourth operands. Each of tht•se operands s!iould hc from
Olll~ to four bytes (i.e . ., tW(I to eight licxatlecinwl digits) in length. If an operand is
kss tli;111 fonr bytes in kngth and contni1rn an 1mt·vcn numhcr of hcxaclccinwl digit:>(n·1•rcscnti11~~ h:1lf-hytc information). the information will he.: right-<1djustccl and tltc
left h;ilf of thc uur.::vcn bytc will lie set to 0 as E:hown in Example h. lf more thancigl1t. hcxack·c:imol digits are: HJK'C.ificd in a singk operand, the~ infornwtion wiJl
be lc:ft-adjustccl, and tlic adtlitionnl digits will be truncated on the righl a:~d lost.

!i~~~~1plc~0__:

STORE 1~02·1 O/\CA
This will c<iusl; the~ two hyt·cs of i nforrnat ion "OACA" t:o be stnrccl
the core:ltldn:w: obtained liy addi11g thc c11rrcnt origin to locution 1202·1. Seu Fi;~11rc 3. ~. 2-G.

a.

b.

~"1'•·"STORE XYZ

11-J12:1-!S67890 SCA1'1~
u ... J u: 1 . . m.. . . . ,.¢.... . . . .uc

1" ":. k!iif e:;;z: ..J$@. i.@JllUQ,;.;::.;.,,ii4#Air4?4M,-·;,_;:,. Jiii\ . .

B

Since the ~;econ<! opc1~~111d in tliis cx:irnpk clmtnins 1norc than eight digits, it will betruncated on the right, giving 1.'3-1 '12.1-15. The third t111d fourth opernnds, containillgan llll(.;Vcn mm1hcr of digit~;, will b;.;cornc OSC/\ H and OB n ..·srx'ctiYdy. 111is eir,hthyte string will then lie storC'<l in the core ;iddrcss indicatC'd by symbol XYZ. Sec
Figure 3. 3. 2-G.

(~cc Example: h.)

fA.

ot

.& ;4.au.,. ; . . . !. . ; .. £ .

·""i: .·~ ." .

.,,.i&@JJ.l ..;.4 q .&LU&itt ;us ..JL..

LL ..m::t:us ,... : . .,,i,Jiitij .z:t •"!'1 r"""'~~'"~~

""

,~·

"""
3cis. .

J/JO'.>

31/01/68·01/0l/6S
3. 3. 2. 40
DEBUG-S'l~Olrnc.

3.3.2-41

DEBUG
'.i

STORE

STORE )!12 FFFFFFFF FFFPPFFF F0Fff2F3

TI1is example would cause the maximum numbc1· of byt.;~s, 12, to be .stored at

location P12. I.JI F12 is a p:fcviously-clefinccl symbol, the i!Jorrnntion will be
stored starting <it the address to which that symbol rcr~.rs. J£ 110 symbol F 12 hasbeen clcfinccl,
current origin will be added to the hcxaclccirnal number F12, andthe resulting nd~rress will be used as tl1'.:! starting address into which the iniormutlon
will be stored. Sec Figura 3. 3. 2-G.

thex 12021•
r3 :Hi 11 0 r. ti
store 12024 0<1c•1

x 1 20211
0/\C/\11 OC6x xyz 15
D7D9C9fl4C5404090~COOOC9823F028

store xyz 1341234567890 5cal4 hx xyz 151341234505CA140RECOOOC9823F028

x fl2 l.3

F 1FC11 3 7 u,\ 0 0 1111 /\ U/\ UJ 2'.)10FF0

storn f12 ffffffff fff(ffff

f~flf2f3

x fl2 13
FfFFFFFFFFFFFFl-Fr-uFlF2F31"0.

FlGUJU; 3. 3. 2-·G.
Examples of thu STOl\E request, ui.iing the X
request to inspect. the contents both before and afte1· storing.

,,

.?.

•

..JC(:

,3t•//'))'/

01/01/68
3. 3. 2-13
,3(!/
DEBUG

01/01/68x3.3.2 -42
DEBUG--x:--Res J~~n::; cs_~

Ii the X request has be<!n correctly issued, the informntion wiD bC:! typed out and,following D carriage return, the keyboard will be unlocked to accept another DEBUG
request.

x· -- -~- -]{=~;----[liflfr_:r:-·: :Fo1111at::_ ... - - -- - ..... - J - .. - - -INV ALlD DEBUG REQUESTThis re;;ponse indicate:; that either no, or more two, operands have been specified
in the X rcq11cst. Re-issue the request in its correct format.
INVALm ARGlJMlrnT

symbolis n uamc assigned (uf>i11g the DFF re<iucst) to the core·mkln:ss of Lh(~ first hytt·! to llv t!Xam irwd.

hcxfocis the bcxackcimal con' lo<.:'.,~tion (..:clativc to the currcntlydcfincd origin) of the first Lytc to be examined.

11

length'l11is mc::;sogc is givc.:n when eitlt2r (1) the fin;t opcnrnd c:rnnot be located in theDl.;J}LJG r;ymbol tnhlc ai:d c.loc:-; not crn1f:tit111c 11 vaJid llcxad, dm<:l 11u111!JL:r or (2) tlic:second opt!r:ind is not :i decimal 1rnmbcr between 1 ancl 56 inclusive. JI the first- - -opcnrnc1 i~ intended to he a symbol, it nrnst have br:.::n defined in a prcvi0us DEF
request; otherwise, the op2rund must specify a vcilid !Jex:icL:c:imal number.
INVALID CORE-ADDRESS.The hcx2dccimol number specified in the first op::rancl, when nddccl to the current
origiti, is greater than tlw core si;;:c of the mnclLi 1;c bcin[; used. 1£ the cun:ent
origin v:iluc is unknowll, reset it to the desired value by issui1;g the ORIGIN rcqucn
and thc11 re-issue the X request.

is a decimal number from : to 56 inclusive, which specifics
the number of bytes to fw c':anlincd.

is the kngth attrilnitl~ of the synibol specified as the ·first
ExnmE~~E.'.

OPl'l'i.l!Jd.

X XYZ
The contents of core stm:ting at the aclclrcss to whkh syrnl)ol XYZ is assi[;T1cd wil!
he typed out at tl1c tennina.L The numl,ei: of byt,:;-; typ,:cl will be dcL•,TminGd hy thelength att:rjjmte of symbol XYZ as c~;tablii;Jicd in the DEF request for tii::it symuol.
Sec FiL;1trc 3. 3. 2-ll.

a.

!2~'.l. ~-~~:_
Tl1i'-' 1"1..'(jll('~l is used to ('.~:alllillL' the COllklltS or :Ol«'l'ific l<H'alio1•s ill till' ll:-il'l" S
virt11al con', and will cau~;,· cunknts l.o Ji,_, typ<:<I out at the tvri11in;1l in IJL.·xa ·dcdmal form. 11w first operand of the l'CfJlh.:st specifics the hcginuing addrcss
1of tile portion of core to IK'. c:-..amiucd. This addrvss is clclcrmincd <!S follows:
lf the op.~rancl contains any nn;1 ·nu1m:ric cha1·ac!l'i"s, the DFHlJG syn'fiol tahlc
1s scarclJ..~d for a matching symbol entry. Jr a mat:di is found, tlic core address
1.0 which tli;1t symbol rcfr'rs will be wwd <IS the Jo.:ation of thl! first byle to be•!Xaniinvd. H no rnalch is fot1nd, or if thl! first op.·rand cont~iins ouly numericcharnctcrs, the current 01igi11 (.:is established hy tliv ORIGIN rcq1wst) will hC':1ddt~d to tilt! specified operand, and the resulting core acldn·s~; will lw used asl.hc location of the first byte lei iiL: examined, provided that acldrcHs is not grcatL'r
lhan the user's virtual core sizl!.

h.
X O'nfER 12
1\vclvc hytcs of core will be typed out hc[;inn.ing with the core address to wl1ich
symbol OTHER has l>C•.~n assig11c<l ill a previous DEF n~c1ucst. Sec Fig11n.! 3. 3. 2-1!.
c.
x 123
Since no byte count is specified, four bytes of core will he typed out :-;tarting at thec0rc address which is the sum of the current origin value and the hcxadccirnn.1
number 123. Sec Figure 3. 3. 2-B.

d.

--n1c second opc·raml of the.· X reqm.·st is optional. Ir specified, il indicates L11c
nurnb.;r of bytes - - up to a 111;1xi1111un of 56 -- - whosl..' _content.-; are tci hl~ typL!d out.
If the s0co1i.I operand is omiucd, a cldault value uf 4 bytes will be a~;sumcd u11h:ss
the first operand is a symbnl; if it is, the kngth ;,ttrillllte which i.s assig1wd to that.>yn1bol in tlw DEl.lUG symliol table will I>~ mwd a:; thl~ m1mhi.:r or bytv.s to be_ typi.:dx 123 32

ThirLy-two bytes 0f core wili b<: typed out, starting at tlic address whkh is thesum of the current origin value and the hexadecimal number 123. Sec Figure
3. 3. 2-II .

out.

lf/lllA
1~ • ~•~'' SJ!i!IJ . I. 2
.

~
. .,

~·

a' .ikLJ:SU: j IIll I .I. x !Ji .li ;, J.iilti!J!SJ!L I Jli.,J Jii#WQ#i .@M¥ML#"'W!ll!lllmlllllll!!lll_....

~·

""'

""""

r.

,__;'.: 'l

1 .

$-16-67
3. 3. 3-1,_·::;;-{.:
SEI_!mR,){i'j01/01/(183. 3. 2-'14

SE TERR

3.3.3

f>E~~-l~X

Ptn:J~-

Tlle SETERR command is used to trace transfers to and from rul SVCcallcd prograrns in which error conditions occur .

. !:.~01<1t:

x xyz

0001110 2 0!-- --r~~;.~,~~l~ l----1~~Ii~~.
The SETERR comnrnnd will "set error" overrides wliich caune trace information
to be n:cordcd for all SVC-called progrnrns that rcturu with an error code in
general pttrposc register 15. The following infonrnition will be recorclc:d:x other 12
DGfJ 9 2 2 0 2 lAO I; I; OC 5[J5C ti 2 2 0 0x

l SETE )'--------------------

def other 120(1) A hc1sic li11c consisting of th(;! co:rc locations of the SVC instruction
and of the pn>gT[IIll which it called, the contents of the SVC old pn•gram
status word, and the core locations to which the SVC-called prognm1

11:~(J 2 1f,0 l1 l1 0

would return under both normal and error condi.t:ions.
(2) The contents of all general p~1rpot;<: registers, hotl1 hc:forc t.lic SVCcallcd prog.carn Ls given coutro1 and Gfl<.!r it issnt:s a rl!lurn.

x 123 32
021A0440C505C42200000000000000000000000000000-00000000000004EOOOO(3) Tile contents of all fJ0:1ting p,iint rcgisrcrs both bcfo.r~ tl1c SVC-caJkd
progr;irn is given control and after it issues a return.

FIGUIU.: 3, 3. 2-II.

(4) 'l\vo li1w8, or 16 words, of the parameter list which exists at thetime tile SVC js cxccutL~d.
Sec Fi[;"Lll"C 3. 3. 3-A for ,1 sample of thetype of infonnntion which will be recorded by the SETERR command,and the format in which this information would be printr:cl on the offiinc

Examples of the X request.

prin~cr.

'Ihc SETERH.. command will cause tile nbovc trace information to herecorded fo;: <!ll SVC-cCTllcd programs that return error codes, but
this i11fon11:1li.011 will m,t he printed out until tlie u:-;er i;;::;m·s n CLH.OVJ.m. or a J:O
connn:rnd, isst11.~s a HJ•:STAH.T request in t:ltc Ddrng cmvironmcnt,or Jog:; out f.rorn

the Control Program.

·,~Traces initiated by the SETERR cornrnand may be tcrmi11.1tecl byissui.ng a CL)"{ OVER or a 1\.0 command. Both CLROVEH. and KO,
as noted, will cause the trace inforrnation recorded up t.o thl: tiir1<~
they arc isfJucd to be print8d on the ·o[flinc printer.

Jtt
"'°

. .,,

('<'
\,L

"
\I.'

3. 3. 3-2

c:,

00

80

~l

II
.....

II
1-

~oroom..oooo
Q." ('°) lf\ 0 llJ 0 0 f'" ~C(' (.)

t;J~OGOM..ooo~
f : l ) Lr\ 0 UJ O C n '";"
l'.J <~ D C:- ,... 0 C CJ L">..J

g~g~gg~s~2g~g2~~

l\l

-!:'

.....

C'
C-

0
. 0

C..•
II

.....
w

C' CC

!'-:C'·\..""CUJCCr"'~IU < 0W<r.O-'C'CO C.v

C' ~· c I,.) cc. I,{' C'\;
OCC<"lCCU..C•
Li...
c;_, u c..~ I'\; c.; 0 .... 0cc u..""

cc· a

0

•-< 0

0

u.

CC 0 UJ C'-: r U.. I·'..0 0 C.. C N C... 0 ''· 0~ocowc~~~
lL

~

c

0

~

....

C"

c:

C"

coacc~cu..ofl C <''• C; 0 ...:t C li. 0

oc~co~oLLo

oc~cc~ou..o
11 C f"", C' C ~· C u .. 0µ.:iU' U l~ I'(. <...• C' (0I- C <1: C -' 1.''\ C l.. I'>
LJ C C C - ' CCC 0

t- C

d

llJ 0

C C - ' C" C.: 0

l'.xl

1

>- o c c c c c1 u o

cc~co~o~o

ccecc.u"\c~~11 ":'
t:: ~ • ...:t" 0 ...- C..:r:
< C: -

U. (.

'

C -

:-" c C-· c- c- r:- c. -.!' -'>. c c C" c c c t..: cc C c c '1"' .-1

er ~ -c

1

0

u::i

C( c c c c <..- C> ...:;· -':.:- c e c~ c C'> (.:" <.> oC):5~ ~~~~!~~!~~~?~~~~T~
I
I

i1
0

~-:

II

C- C- ::: aJ..: .,.

C

-:i:

C

'I

-'

-1
~·

C ~ ~ •- :- r::

I

I

I

,.L

> ~ ~~ ;: ~ % ;:: l ·.~
• . :

::_,
.I..

•
-

;·

"

°:.

=--

"'· "':- r- :

'-·":

.'"';

':°'..

'.:"

r_,

~

;,.::.

:..J. Ct•:r·-:- :- " ,..- c'L' : •::<:.

..,

L ..... ~c·~;c;::,,_J r_; L' L' (..1 8
U

• ..I

{..J ,..

'..

I

C-'

u

I

..,.

.;

~ ~

:.;

/"('",~.·'"'\.,~""':""

ll

C

'I

-:.

_ ..

r-4

!'_') .._,,,....

-...... t.

-

-

r~

-

.. ..,.. ., -

t.'

(""

I

0

J'

-Jovuu-;::u..:-....J·'JU<>c..-1r-("~~r....

<: O u u ::J ;:.· c I CJ
u~:::i-:c•·-~OIN:c '..,.; :"' 'll a C I C
~i:

7J

::::~

'

::~;;::~~g......... ,.... () -_,.,,......

II

-

"~

I

c '-' cII~

;J:-....: uflI(-' ,; -o -; .... u .,.- --' ,_ -

..

...

':-'.".!.

x ;/\'l ,")

...\-

.:..
~

~

:(

J.iC..

"v

;~

J.'

---

·~

'-.,

",J,

::i:..
,_

'

·~

1 o

I

,_

":.';' ".'.") ~ 0

C' ll... M'\...j'"•·O o·o o""' c1 o.i..c;ccuuo 1 N

I'\;

Ll
... If';..I"! •·-....

-" ..+ C

g~~~'bg~~..,•L?. !'.

I...

> r"""'

I.

II

II

.u
·,: ,.
::-:.w..

UJ \.I~

,J.

()·ct

VI'<.

~ vi

~I

VI<'>

VI :l!.,

0..

L.f

ii__

o_ ~

I

-,: ::::
~
..,_

~

lJ..

I

c·

::t. .,...

.,,.

~

C 0:: L' ::::

n

-~

.~

......

. .;;. j:... ..J

e::: :r:c.. <:l'..... ~

<If

1<

*

<A-

*

*

.

~-·

'.J.,;

_.,J
I.)

U

c_~

'-H

3:

,_.

u

c:

w
:>

0

_,

,..., ,._" c· ... :" C."" ,.., '.}

·.f\

:~

"J.J

IC

··c ':'> ".".") I _.

_,_,n.,.., .... -.,._..,""'<"' ,., ,....., t.J 1ri r:iI r,o or::,._... :"")~.) oC' r.:...,IIc o '":""" i::, o1 ~-' c. ~~,...... -

r:~

":"'J

I

('V

u.
UJ

>
0
I
rt
t:

er

L:J

,....., , ... ":'c c. cI ~...... _,u~r-, "."..) .....
c r ~· '"'..:i· ~ u. "".. 0 0 0 0 1 [ ) 0 I o

WOCCOWOIN

u

II

a:~

ex: <I)

rr,LI')

u0:: 0::
UJ 0.

\.!)

, ......
u.. I lJJ

a

..:::
<I:
• .J
c:(

u

u..or:r:
uu.
I UJ
0: a:

:> 0

Cl.

I

fl

u.

<l

x ::r.

=- u.

u. ~

<"!-: ,_........
\.U Vl

.

=--

((

u

u.. ...J

7-V'):-t..

w

<t

I

~CY.

Q)

...0,

C<!'":'J':)~::lZ~·,..._ -

i,

0<
f:

<..)

<r r

u c ""'" ~ ':) -:,; 0

;:1
0

-~

UI

...

I

a. SETERR
This example will cause information such as that given in Figure 3. 3. 3·A
to be r.ccorclc<l for all SVC-called programs which return an error code in
general I)Ltrposc register 15. Sec Section 3. 3. 1 for an explanation of eachline of the information as it will ap1x:ar in the offline printout.

0

..,.,
w

!ie!?2.V!9.~­QJ

uC'!..'

()

~

0

]

Lf.
?'.J
~

SET'ITNG ElUWR-OVERRJDE TO I'ROVIDE A DYNM1ICTRACE OF CMS (AND OS) SVC-CALLS . . .
This message appcnrs in the offline printout of tbe trace information
at all points where SETERR commands were issued.

8I<

h"'

w

~"\

U

r:

'::lo

..-J

*
*
***

.Q~E~1.!.:

.~
~

UJ

0

'X>

ex:
cx:w

.,_
li. _,

~

~

<t
J..

.... II;.;:J..

~

c:) cc-1 (...) L' U..J

UC'"f")~UCC-..i,.....

~,L-J ~ L' C.:) '..) ::::.· (.) <":- ('J<! 0 L' <:'.'> U C U
I 0('.'.) ~~ 0 ,-- O 1 N

1.JJ

__.

~-

~

er

"'-'l

*fl-

O::·

4..) C...J~..-.:~ --- L'~;:.,;::. 1..~

I

,J..; ..... '.:;,.l,.1.')..,. "':'"?

r- -:-1 ~) ~") ·::-"- ~ "°":" .-. ~ """1 u.. '""'•::-CL'_.,tr\O I U

~

c

~

~

If ~-.. -:;> r "-' "" ~-·C ~ 0 LL C

'JJ C

r:'I r-1 ...-.

C"'"')U-.~0".'"'llr:>.... ·=- ._1 C' c -

I

t::"

Lt\

~-L.';r:-u1-,- ..-- ,.._ ~- ,,_ .+- -: I .._

~

(.1

~

I

·-~ (~

c,., oo "":~nu':':'"

,,.~

Vl

Q)

;_;

U. U... CJ r" lL(_)~U:--:-"':"O'J

...-'

~~I

gt~g~g:~..-4"""'." ....... (...) ,-. ....;. c: -

.....

....

- ' C: C '(: Crt"\ ,.. .... f"•! ':.").....

~) .._'

~

I

z
C1

":-->

"'"-~ "-~

I U~

'")

Ill

gI ~

:"'\.J,~ -::"' ..i.. C() ·_-: ~.·, r-: ,oa .._ i
0 c: c c: ~ . --..

~~g~~~:~~..

,.....

"'

.,1

I

I C

o~

None.

I)

I-<

Q

e

·-~· ~ g ~: ~~: ::r:..
........

:;o

~

c

I";;

~

l . ......, ( l

..J.1

..:t.

._.

,- ,..... r_;,......, C"' - · r.J •/" ~- ,.... '-"' !"1 '.) ,-... '-~I -.

~ ~-::.-_,"'

L: ":.

"'.:

r· '1 :..,

u.._ "".' 00·....)'"""Cf C

D==' ,-...

-~ ":':"......) ·...J n -,

,:..

'

':"""'

c· ::. -:;.. . . . .

:·

<.
/.'.

t.1

v.

'"

~

"..:..'!-

~·

:-,
(

Responses:.

Ql

'0

0

v'") (.-)":'":'"tl~~~~~~~1~
I!,/: :_".'::" c.:

..r.
..;r

-',....... <-1 t.-. ~<i C-: 4-' L•:
r°

t'

I LL

('

c. Any 01~rands given in the SETERR commnntl will be ignored.

:....

,!:)

':t

.. I

C' -.:" C L.L. C

7.-_;_},..... :'""~y~ ~~ ~~ ~-; ~ ~! ;...

~;~~;;:~

l'II C "'.:'\ C J_ C

~ f ~ ~: :t :-; ~; ' ~( ~ ·--

/
J•

~:

0

c

~

:

~ '? ('") U.. ~) Co

b. Issuing more than one SETERR command will have no addition::tl effectother than causing the heading given under Q_u_!J?~~to appear in the ti:ace
information printout each time a SETERR is issued.

E-1

C- ,.... U- C.> u.. '".; ~ ~c- c·~u"\:_y.::~-c ooo;No2~""'--r~ ~~~~~,~~/i~~/61~u~ c ..-r ·"-' ...._ :::c ~· ~
c'-..../~ ~ :: "'I

Notes:
a. Issuing one or more SETERR commands when a SETOVER command isactive will have no effect, since error as well ns norrnnl overrides are
set by the BETOVER command.

u0

Error Mcssaf'.Tes:-·------'.J;;c~

I;~

None.

<U

~,t

r:

II.I
u::i

<iiI
t')

"''er:"
µ:i

:-J

8
r...

....

Q. c;(<..;.... 0..

2!

*
*

~
~

,,,.
:

.,

~

-A4W4W ,.WI@ ,....;;- ~,111.!,!!,faiilU..iliili!UUClll pfrK!i!l\li ,,,iiliii!!AJ@;iii!ii01ff>!!'l;::i1HiiifRL.
·-

-

-

-

_3/.;.?_,

SE1_:?RH.

0

....

IZ

cc~c-c~c~c

1- C_s -16-67
3.3.3-3i::ll.

0 C 0 Lil 0 0 LL. I'°•
-D 0 G C C'-.. C 0 L.l. 0
MCOOwco~~l'l'ICCC-U..CC'u..ll'

311

/

0
0

UJ

O' C.· O:· C• I"'· -c C•

8-16-67!'<"

u..

~%!1UMAl..
.. ·····. .IPW4i,t~ ,¥W ,~J!M!MWf.H~.,,.~Mii!iWI

J44 $ijf. •.,

j.l!IM¥ff., "M1F"-..,s.1M,i.,£&iitiff.PllRMl!MRt-.fAJii4irl.iliiUIW"'..',iif4!4WM"f19.l "'f .. #,¥!f+fi'M"!"11i' •""!"t"I"'~~.'1'.

;""'~'8-16-67

3.3.4-1

o.5/3

8-16 -67£ET<?~R

3.3.4··2~~)-~~

srfrovrm

3.3.4

NO PARM

no parameter list information is to be recorded whena program is called by an SVC instruction.

PARM1

record one line (8 words) of parnmctcr list information
when a prog.rmn is called by an SVC instruction.

Ktn:posc:

TI1C SETdVER command is used to trace tn1.11sfcr:1 to and from SVCcnllcd pi:dzrams which nre executed norrnnlly as well as those in which
error condilio1rn are enGountcrcd.
Forrnnt:r-------"--------r·--------------------------------------------,{ S1~TOVEH} : [ SAMELAST[option 1 ... optionN

J

:

J :

L_----.. _$\'.~_ - - -. -_t. - - - -- -- - - - -·- - - - - - - - .. - - - - - - - - - -- - - - - - - - - .. - - - - - ~leaves all options as sc.:t by thC! user's
last SETOVER comrnrrnQ; if SAMELAST
is not s pcci fiC!cl, the options will be resetto tli'.:!ir dcfullll scttin:;s. Any optionss pc~cHicd nft:cr SAMELAST wHl l'<..!placc
these scttin3s.

SAME LAST

option 1 ... option N

The dcfaltlt option is that two lin~s (16 words) of theparameter list will he recorded when a prograrn is
cnllcd by an SVC instructi.on.

r

NOVIAITno information :is to be rccorcled when WAIT is called by
an SVC.

I WAI1SAME

record the samo information for GPR 's, FPH. 's, and param ctcr lir::ts when WAIT is called as that rccorckd for allother SVC-called programs.

i
I

WAJT1

record 011e line (8 wonk;) of the p::irnmcter list when WAITiH called.

I WAIT2

rcconl two lines of the p~trmnctcr list when WAIT is called.

arc one or more of the options given
below

The default option is tliat no GPR, PPR, or parameter
list information will be recorcled when WAIT is called.

Op~iO!J...'.~:

ems

of

l:CCOJ.d the COntelitS
th:J gc11Cn:0l purpose n~gistcrs both before
the' SVC-c~llecl program .is given CLl!ll:rol end :1fter a return fromth:1t 1•ro~ram is isf:11cd.

GPRSllrcconl the comcnts of the general p'Jrposc registers only ns they
exist before the svc-c~11lcd program is given control.

GPHSA1

record the contc11U:: of the general P•Irposc rc.:gi.stcrs only ;w they
exist after a rctun1 is issued from the SVC-called program.

TI1e :l<:.f'.'..'!l.t. option is that no general pHrpo:1e register information will be recorded.
Fl'?,S

record tlic contents of the floating point registers both before the
SVC-c~illecl prognim is given control and after a return from that
prog; am is issued.

FPRSilre:coi·d I.he: contents of the fJ oati ug point registers only as tlwy
exist bdorc the~ SVC-c0llc.:d program is given control.

FPI\S1\n:conl the contcntH of the Iloating point registC'rs only as theycxi;:t 11f1er a rt:t.m·n is ismwd from the SVC-cnllcd program.
Tiw ~1,:f,111lJ optio11 is th~·t no floaUn.c; point rcgi~;Lc:r inforrnal.i.on
will lfc rcconlcd.

[DEFAULT~~g~

Jcancel all currr~nt settings aud reset the options to theirdefault settings.

The SEWVER command t:rnces all internal branches which take place due to SVC,or suv..;1-visor call, instructions. 11ic effect of the SETOVER command is to "setoverrides" which will cau:::;c i.11fonnation to be rcconletl at the ap1)ropriate times.
Iloth normnl ancl error overrides, as discussed in Section 3. 3. 0, will be stt by the
SE'fOVER command.
The information that is reconkd will va.ry, depending on the typ(;! of ovcrrkjc. For
both normal and error overrides, the core location of the calling SVC instruction
and the name of the ca1lcd program or routine will be rccorclcc!, as well as thecontents of the SVC olcl program stat11s word (i.e., that which was stored when
the SVC \Vas issticd) and the core lociltions of the normal and error returns fromthe cnlh.!cl program. In ac.klition to t11if; bnsic line, error overi·idcs \Vill record
the contentti of tlie gcncn1l purpose and floating puint registers, bcfo:rc br'<tncbing
to the: SVC-cnlkcl program and after returning from it, and 16 wo;rds
the p:iranwtcr list which cxi~>ti~<l wlic11 tlic SVC was issuccl. (Parnmctcr lists arc clisc11sscd
in Section 3.1. l. J ). 1"01· norm;il·ovcrrides, the aclditional.infoi-~·'natiou willorJi

3. 3. 4-·1

3. 3 ..1-3

SETOVER

SJ·:TOVJm.. -· ·-·-- ····- ... --·-

depend upon the options, if any, spzcificd by the user in tlic: SETOVER
cornm;ind. lf 110 opUons nrc f:jl..:cificd, the default options will he u~;cd: no
gt:ncraJ p::q;(•Sc: OJ: flo:1till[~ noi11t register informatiun, and 16 WonJs
lheparamc·tcr list v;ilJ be rccc1rdcd for ;•ll routines exccpl \V1\lT. For WJ\I'f
only th:: !>::sic line of information, common to both uormal aud error ovcrricks, Will !K~ rcco:rckd. \\'Ji1.:n the U1ler clues Gpv~cify OJ ions, the defou~t
sctti11_ss :ll"c ~ssuind initinlly, ancl options sp~·cificd Jiy lite l![;cr will xcplacc:
the: appropriate dt'fattlt Sc:llin~~s. lf t11::· uc;cr sr~·ciLir:s S.\MEl,.'\ST Hfl Iii.<; fin;t·
option, tlw oruc, 11 s wiJl rcn13'iJ1 ~is they were set by tko la~;t SETOVEH.
rom111:1ml is-;ucd cl11rin;-: tlir' tvnnin:il r.;c·:.;sion,nnd 1111y furllicr Oi•t.i,nns gh·cn in the
SETOVEH. c01nm011d will replace the;:;~ p:::l~viously set opliuns.

B.C:.~2.1.1:":c:~

o:

None.

Oti\.ill!!~:. SET11NG NOH.MAL - AND ERROH.-OV 1.-:JUUDES TO PROVIl)E
A DYNAMlC TRACE OF CMS (AND OS) SVC-CALLS •••This nrn~-;ogc ap11cars

l~~a~npJc'.~'.

"· SE'J'OVrm
In addition to lhc:·basic in[ornrntion rccord~~cl for both norr;1nl :111cl c:rror ovcrricks, the above cx<1mplc wo11Jd cm1~3C' tl1c ddault i11formaUon (no gcnc!J":Jl
pm:posc· o:r flo::iting point regiS'tcr i.nforrnntinn m1cl l\\"Ct linu: o[ the par:nnctcr
Ji.st) to be rC'corclccl for nil nornwl overrider,. For error ovcrrid:-s, the contents of ;1ll trcncrnl p<.1rpose ;i11d :flooti.ug point rcgi;;Lcl's wuulcl lie .recorded both
before JJnmcliing to the SVC-caJlcd prog.rnm ancl after rctu:;_·11ing from it, as
would two liner of the p~1r:1111dc1· Ji~;t: infonn::ition, (A fWmpk of t:i:c type of
i11form:1Uo11 which wo11ld k· rcconlc:d is gi\'cli in Fi;~tffe .'3. :i. 1-A).

It is poss'.ibJc to ist~uc two or 11101."c SC'l\)\TER com1>J;i'1ds lwfoYC .i.r:~~ui~'.'.'. aor a CLROVER c:on1mD1~c1. W!;u1 ;;tldition:il St·:'fO\'El~ comm<tl'lL :11:c·
is1;;ucd, the option :.:dli.n~;[> will he :1t~ju:c;fcd to n·f.lccl thn,:1~ f~pvci.fir•d in themost recent SETOYLH comm<.incl. JI \V,'\l'.LSAMF is 11ot :·;pC'ci.ficcl af: the fint
optiun in tJ::c:;l' acklition:il cunrn1:imls, the opf..i1j!Jc; will lw J c~:ct i.o their tI(~.frtult
sctrin~;s, and C•iUY tl1·:.i~~c OJ•tirrn:3 specific,~ by tl1.;-, user in tliv ll:'W SE'l'OVER comrn:rncl \\ill rcpl<ic.:L" thC' dc!;:,1:1 r'l'L:tll;',:'.

To krmi1u!e ovc1TitL~s sd hy tl:'.! SETOVJ::H. cnrn11i;, ;i.', tile u:>.:.'r may isst18
a l~O or a CLHO\'LR corn11v11d. B'.>'.h Cl.ROVER and KO will cause nll trace:
infonn~Jion rt'cm·,Ji'C: up lo the poL1i. L11cy nrc isstwd ;,i be p1:intcd on lhe
offlinc pril'<er. CLJZOVER r.:in bl1 issued only wlwn .!:c kcyi>oarcl is unJoc::cd to ;>cr;.::pL inp'1; lo tlic C,\1S Co1111ttr11;.J cnvil'·cmnll..:nt. To cknr o\·crridcs at :iny otk·r 1KdPI. in sy1;tcrn pnh:t•ssin;~. KO :;h.11 1.1 he if;sucd <i:>dcscrik'd Li Svctiun 3. 3. 0. Ir a user i~;m:cs a RJ·:STAiO' request to tltl!
D'·hu:i; C'nvironnwnt or J.,gf; nut fron; t!1::;, Co11trol Pro;,r:1111 prior tock~,ri1i;; n·;1.•i-rillc3 ~~'!:by issuing tbe SETOVEl-:. ar1d/·>1 SETEHR conunands,
the m·c1-rides will Le c]C!aJ:t:cl automatic:.1Jly ancl dl rC"cordc~d trace information \'.'ill k• pi:intcd 01: tbc offlin'' printer.

b. SETOVER
Gl'RSB
Fl'i{SANOP/1HMFor nJJ nonnal oycr.riclc:., in ncklition to the basic infornw'don, this example
would cnusc tile contents of the gcncn1l. purpose rcgir,tcrs to be rl'cordcd before
tllc SVC-cnllcd program is given control, ·and tile contents of th• flo,1Ung point
rcgi.stcrs to be rccordccl after a rct11rn is i sr_;ued by th:it prr;grnm. l'fo para meter list information would be recorded. For c:dls to tile WAJT roui:i11c, onlyt;hc~ ba::ic line of iuform;;tion would !Jc recorded. The same inforrn<>.tion would berccorck·cl for error override~; as !.lwt given in E;:ample a. Sec Figure 3. 3. '1-A
for a sample of the type of i11fonnalion which v:ould he recorded for this example
and the format in which it vrould be printed.

N(Jtes:c.. SFTOVER SJ\ll&'.LJ\ST P1\RM1\\'AIT2
As.su111c Exmnple b h3cl licc:n issued prior to tliis example. Since: SJ\MELAST
is specified as the first option, the settings for Example b would J,c <iSSUJncd
jnili:11Jy. The N01'1\1Uv1 selling, however, would be rl'phlcccl by t:ic PJ\Ri\Hoption s1x~cificd above. WAI'f2 would wJJ·rn;tlly replace tbc· default option of recording
no paramc~tcr l.ist information for calls to thr:! WAIT routine, lmt since PARMl has bc·cn
specified, only one Ji11c of th': parameter list for calls to \V AIT will be recorded.

Jr the· ~A~dEL1\ST Ol't.ion is SFCifiC'cl, it mu~;t lie till' fin;t opUon given.

b. I.f mutu.:i1iy cxcli·~··ivc· op::ions :"ll"L~ spvcifil'cl, such us NOPAl~M <incl P1\lli\1 J,tl•c la~'t such op:.I;;n \\ hicl1 :1J'1'~~<1n: in the SETOVEH. co1rnna11d will h.:.~ u~;cd. For
op~io;1s w:iicl; arc Jlf>t m11t11a1ly cxdusivc - GPi{S and Gl'RSA, for ex:implc - tile}(l~~ic::1l co:1;hi11:1ticm of the opti.ons \'till he used (in tllis casl!, the opl"ion set by
Gf't\S wo1i.ld be usc:d, since it include~> the GPH.SA option). •Tbe ::wmc infoxmation wriulcl be rccorclccl fo.r error oycrridi_:s as thiit given in
Example ::i. RC'fer to Figure 3. 3. 4-13 for a sample of the typ(! of informr.tJon
which would be recorded by this example nnd tile format in which it would heprinted.

c. 1hc m•ir;lll.'r of line::> of p:tr;1mcter list· information 1 corded for c<iJJs to tlw
W:\IT :LOiltir'c camwL exceed that rccl)rdvd fo1: o~lwr rut:. in~s, i. c., tl1e "PAlZM"
sel!in;:; v;iJJ go·1•..T11 the "WA! T" selling wlwnevcr the J;itter s1x:ci.fics the grcatt-r
nurnbc·r of Ji.nus to be recor~lcd.

•·lij ::;

..

iii

. J1$

,

.. I.!

·""•.

in the offlinC' printout of tr:ice inforrn~lion nt all

points where SETOVEIZ com11innds were isGt!Cd.

J·~O

a.

(J>(

8-16-67.J . .. -8 ··16·67 (_.1/:~J

~

~·
..

iiiittJ#iij$11!11Aiii! I:.$ 4, Liiiillik!!llliii"'l"!IHllll!fTl1i!h 4,.,,l/~U\f#4fi.#f t)llSKJl•'''lllP:)tTl!l\~; ;\r>i- .• L-''!\i)i.::, .. :;;:-u~n11;::;

S :J..~ r; 1; ~I :»: ~t;:*<.'= :-,.. .;.- tt.t' 1 :~··.~ '. ~ : I { i:t •; :-~ ~l·.;l ~ ·~ ·: .:;,'\ ;..: 1 t.

.,., ) )· \ l r-: ;,-'->;O-\;-~~-'F-)<;}~: :1 ) ~:J 'l· J JI ) l I ) ,,, )JrCCt'•" ·;;;~.,,.,; ;1:: ·\,<~ .. :~ ,) ,_' ·\ '··' ::u1J H>~~~
CC l:i l'):>·1 ~ L · )' ~.,J)llF.1,;
l '"! ) ) .l i·•:';'\~· t ;; "· • -L 1 ~ 1--r H ~--.~.!"' l •."...

. ,. ''., ~.,_.. "\ .I·'I

c 5-'t i/,. r:

C"S I/\'-:)•111•'1.,C1 )I,,q ... ~;.J.

I I 0100no7e'l ·1"l'17/·• v··-·'L ;->C:,:=I'iI• r ::: C" ~ I '.\ ' ) ! .. ~ •')('((l)';C

• )

l l"I

~ • ,'. •~r . • " l•l •1)1'•'l ) r" . J ' ' f 1--:·',1r"r- 1 1~.-, sccr.1.lnJ·1<-J,.'. '•'-~'Y"' • ''J'''lo 1.11.10~,·)

__ 1;

--*

1·1 ) ~ ; l I ·;;r:?~"".lf~t--=r:

--

--

--

f'OC'•1CH11n
rcnr.r="r.')(11F1f:.

(\] '()">')T)f)ol0(l!')'j;\')!)'-r~r~I~)

11 l"I " ' ~. ? rl .'.
r,•)'!<'"(':'I'J.)1111)'):')[2r:;Oi'.':lF3'''''''""lt'))<)1'S 1+540{"10')'1'}6--0·Vi0n•J:10
5C4f'Ff'i=F

ff-FE,'55~0:,l,;-0?3!\"t..dl"'3~n1

5f'?J)2f1'1-8--~?~"\;~·';,tF

OOCDO~).'):'I

n"lnn"'.10'1"l·'J,:>ET=O"l':')!F3u' \ "l·''J )''.,-, ' -'11 '')Jr/ (~i:t~:T="'1.'10.'\3C'J2000n9!i.·10.').0.~W.A0-l.,2 I/ '.l'JO!JflftOll• 11·):•-.:··..i

: '.

)

~vr:-CALLS •••(l'))

1-D<;\,;:-1- 1 1':)";r/y,.1"'~FT=fil'l 1 )")A'.\Q?

) IJ('! 1J'J _!

) J1l )·1))

2 f)3.J'T il)f'·':_.',L'..rf-=;"'!'~1$(:\LL-:·,:).•' l l r- ; .

OC') :_; l ;J ~ l

I pt(:)

Ct.Lll.t"=o;;:l'.;Vr~Vi,-('!
,,,.,r.)'J·l'),-,:-. ,~,.,n.1:1- ~: ( ,_~ [-t_ i:-~l- .---)

,

,, ..

1•

·••' L; , (' '; ) ~ ,..

;"';; ·' ' ) '·'"'I

r ·.t \ ~,, C'l':.J1\•J(' J.'.\(I'~0:ttoA jc t .';t~ :.i • • i"1 -1. ·.: :: •· . : I :...~ l~"' •·• '.:>

F~-:·-:v1;_·1l'.\LL-.'Z=·:;;:,:\ b;.

i\U''':.it - ! ·Ji :-,;n CL,· ; ~ .:..=

Iff) "(\I')J :) 5 ql)r.•)I):') '1'.)I)

cicooo.110

r. i. ~ ~· 1> L - l v~ !{ < ; C' r ,C \ :_ l L ~ = •J '.: C .; .'.'. K =Gt'"S ~'.:i·.:i-:l = i):))G./·ll',J.))').\'t·I'•
00 )·~fd, _,CC~L>J1>: '.;) ~ J ) ) ). ! ')00 Ji_;'.l'l))~P~S ;\~T~:R

CALL[l=~YPL!N·.-: -: ":'..L- c.v .~..i.~ 1.iL,

t.. \ l L::-: ~. =',:\ t T'.', V C-•JL ')-•~S ·,..: =f-1~':::V.~~ E T=000 '12-:ih [;;:r.tRF T:(1''!1)'.'".VC- 1 l_:J- 0 ')\,.,=f_, lfl

l\ftW"?f T=0')0029:\f

F.P.? ET=O:J()OCl 03

1.' 11:•11"~)

C\LL>';;{=·nJ12Ji'I(\V(-Sl~-PS~=rf~r)'J•1·1r1on::.;'.) "):)(°Jl~:).HJ
CC..l•J\!t).Jn..ic:;c"l•)"""I 1
J "UC:" rev:~~M~FT=0f'OOA3Cr"100''''')'.:G~?'I'/

0'Jf)·"l,>0?i3
1+C1CA"i?A'll r- ·in'~'

1'.'Yl0CO"l0~~~ET~0010ft3qE

00009A,ln
0COfJ'l()'.)r
1Jrtf)')000'J

rir: 1 fJ8.

ii. t'~ '1: I· L -C'J t ~· ~ I CF- ,C\LU'.=1=:~ ):)')~~f•C

C!'l \ (. f =~~IT~.l'-:','i'L-l;vt:i-;;..:Ict:,

1..•LL:l:=:::·1;:,:-i:_r.

~ ~; ~;~ ~;.;:r. r u ;;.,, . .}'. ~c; ~CL:;-: 2,;~~~, ~;2}1 ~~~; ;~;;~') 'J!P ~ ~'.V)Q ;;~ H=f'O-J0.'12F '+•,'-'k'.S

I- PRS= 0.·lYJ·Hl.>

LH.l~i:

AFTL-:~*:t*r~U[--\(;?":\L-~JG:;:.\~ 7·>)i))·\'•'Jt<cl\;) JJ ) ;' \(il).~h.:1):)·))

oc·1~~ 00~

c re•()')•;',)·-,)/ti'.)~'-OOJQ'.lO'.lQ

OGYJt;Cl·JCI()

AN•) ti{-\uK-CVl:R··US[:) Hf1V('\(h)'J'":''}fl(//<+'.}'l()t.'52A00000000Jloo(;

C000001)0
000000.')r;

rr:;::--.i CLFJIRtU***-e:l\J) ._,

i~~
10~
:~ 0,

!

FIGURE 3. 3. 4-A.
Offline p:::-i:l';ou: sho-..,·bg b:<'-ce ii...£c:::-m2:tion reco:::-ded 1'-iy the SETOVER
co:7lmand \vi.th the op:io:-ls G?RSB, FPRSA, a::J.d :1\0?ARM specified.

~

~
I
,__

,.

C'
I

rJ.:~<-L-

Jt ::ust~•U

1\':l.~JJ.tL-t".V ~K.·: i; • t-' ;{ .~;:,.~l.•-C.t"r<~l~~':ier'fC ;:o:.;,.:vI:::i:.

c ~L: R=];; "J ,"'. }<,) c

uc f . : ~·· L = u 0' _: ...: .1 ~)t•~

OOl~.'.\J';

CC.·:~c;::zr:

000~00)--::;Ht_;----.J :.:-: - -AH;c'-'
P t-,;..i.r. -LIS i

r·P.\~~

IJ}i:_;.!:~E

F-HS Pit !-''.i :~t_(.,J:R::. .~FT f. '<:i:• :.;·j•)•JC"•.':'·J·1l'1.'lC'·'·;.~·~J]ll·)JJ,.. '.'·1·c l'}ll'.:': ce~~,)c--S''"~--C •\LL::•:;=.,; CC·: ll' _; C= ()(J.Ll'.Hi>'tl > l J t.=J')(~~cc.~, 3 '-~~Qj:~J)2()iJG J :IC l):; 1c ~ :' ~= d ::0 C ~ '}r.J.:)l ~~ ~ _: : l ~· .. #'),;-,)) )-) 10 ;JC :,.:+~-'•C'+ '~C/;L LL.I::.=" i '-:rsl~CC1'.)'i8~.).)l)r;():))

n . ;r:~i.l~):·.:')•l,;C;".JC•),-~C'r 5;)d··, ~~~--L···ST--l'"l 1 'C"lr,')6;·1r1Ao12

I~ 1) !'~0'1C'-- 0 1\'-'~"-<.vc-r,L~J-'"'·· =c::- /

.
()·.:

'J'J1)rJ"<)') 1 •••;':JC'l.... ,J i;vi~H.ir:~':•-'.':'f'fF!:'<;f,C·'t4~''\Q;J()'<liHh)i~·~n001'" <>O~-\ \FF"'':'""·)·:·~( /OO(lf\n')/",/ oonc04cll
J'10,..."10~--\.\.HT----2

l'::1r":'0a0

ncoooooo!Jil'll '-·"'!'.)
ll'1'''>""·'54

f?C3ClE.3
0'.'0'1f)0')6''° '"""""----*

2 ·'.'\BO'>l::f-'14F1)?3·\\ \ldOCol'J.)>r:CC:)G{JC
1 1 ;:J.J~'."l"l1),Jll).:'..Vd3

nr-. '''0.>f)")J l('.;nt;'il('.)CA\'iJ"'l1..''.J'.10r6/
0'100 "2<'.lf I 4()'10fl5 2AO')JunJo'.1
C?l')P.Jl1'1.:.o»oor/'l95t::4"--dAI r--CM. LEF•>: 'IT--cc~ 1--'.'CO<;OJOO.\C - .,AL-'.''JC:R::.I t.:E-,( \ L !.:::~= .;·.: J 1/' .~A:_.
.. ,-. · :·!.-LIS: -=- - i!II r---C .'LL E F -='.·:!\ i T--GP!---•1 ;:;-.i.·~ :1 i•L-C'; d:<.; Ii::[,C ··t.L:::z=·: . J.1 '-!!2Et. ".~\ t 5 L)

C.~L L.::: =.J :. : T"W'i ~ ~·

o<>oco nnc

---,

--'*

.iJJ 5411 :J~t~~kl-C1r~R!C~.
c LL~1=J11J~~c
GP:,5 S'::l:L·<<: =CG-JC!);).;•::J:~~J.Vt:l
oc0:AJ &cJ;J012

f

HIS

~FE~

<::::::J::J(. J--fY?l--;>: ~- r• • -L I ') l~c~PAL-(V~RRICE,

i'/•r'.11:-L rS I =·;p·:zs,.

P.i:: ; ~- ·':.r:' .;

I

.,

~~

J:l"lll)l)-- ~'. \ l/(i_l00·'.: ' ' ,_;·))')--.1.'.: r------ ~ :1

rE-11t..<.".\L- "-~'' E "~·l~-rJ'ic'<~IJES:nnnccoos vc-::::.. U-.> S\<I"' r F ·.H>_....,....

~· ~E, -\..u\..iu"'.:; 1":•4-0'1000000

Q~OOOOOO

F61r;l740--

N," FT•OOOO 2?A'
000 lOCP.O

ER RET•OOOOC I 00

ocooooooN.:tv.'> r r-,,:J()f' ''' ;>!" f,

ERRET=00001\2F4:·:·()091\.00~ ~"--'"•":'-'tJ

0' ')flOO·Jo~-~'/;~~)~;~,~~~~~;:~~~gg~;·;:;~,. ,:~:;,·'"

C.tE • .~f;p..<i:):*-7
1

Ult.('!! L.i.ir.·,., •.

~hir .· ·:f'..n•t

1.,:~-~r- ··Pt <10'".•... ir::·. t!·::-:cca I~1~0·:·:n~:~ion !'"ccordC"<l ~)Y' th<.\ S:STOVER'/l.:.; :. !_,_\.::;·f, ~ 1 ..-\.TC1~l, i~~ .. : , .. / .. !'fl ~D("c.ifi'-·d. {.::A\!l:LJ':i.ST in'.:f ... ·r:; :.o t.' .-.• ~lr- . ;·,·J~: · 3 s~~~ 1~· 1 !'":CCf·~:~ ·-~. 3. ·1-AJ.
Of'!l!:hfre o~·t..i.<1

I

(

°'

0
.j>..
<I
I
I~ v- ;;

1,-.;

I

~~
~

\ _;

)

\,.I

M"

~ !"'

F!C:7~ ·~ 3. -:1. -i-:'.

..,C'"'1MAOO •00000000~; ,;~,;~2;.";,"~('·"'"'),~:=r·

4'_'·"r··;r, :!"'",_,,.,,... ,~,1::,,' .. •/;J'' ··.<;'. \() 't)"lf' ·)"('

1\f 111r~•

5C~02C43~- v (.-t:'L •l-:' ::.·. - "l ~ r-n ~_.. "T = r_·c,::, 1?9A.'
EKRH =OOOOCl 03
1 lO··~:ifJs~,l'.)O--~·-·.. H0~'100000\(:;](": _.,J .. ).'itt~·.· .. ;:~10

SVC-·OL '1-"<'<•--CCt.~

00000000
FFFE5830

5::::4'.)FFf?
40103000-(\LL~R=J0~~2~~r

ni:j
!" .t

, ';1 : ·~ • -i. I ·' I•'•i<;,~

c

--

--

NI{"'" ~T-=<Jll()f)t F3t.
ER?.ET=cooa1F 36(1'l 1 "nn-v)
nf'\0'19h00
4')'10A3?A
0.0001058--; · '. -~ ) ) :)(ViOO:J01i\li':--FI".;!-20304 l f .;ER~ET=f'lf'll')f')"11cz(;C'':":9!\0()00000000
nc...:00000

2C245F '.J

t-P'.';S M-T:.-;
Pl::· •.• -LIS r"-:<;V'..-CALLS •••:,v -'LJ-"'·-=• '-·1'1~0) Al'!R~T=0001A192

C.li..!.C.L..-=S_'.i._''./i

lf.: :~* *~-**r i{f..::iR-::; "-:U:I i.,;f:: •Gi'r..S·' r:·,·,,i!"J':.: lhllr::C: 11!" ::v.c; !!:'JC OS!

!',

~v

0--..J

8-16 ·67
3.3.'1-7,_~;17SETOVEll..,.
______ ···---·!'~X-1:_~_!~~'.'_~l:<;:~_:

E(00001)

TI1c user );as spcc:ificxl ono or more invalid options. Re-issue
tlw SETUVEH CGii1~11a11d 1rn1king; sure that 1:!11 options nrc ::;pclkcl
cvrC(,clly a11d that f.AMELAS'f, if specified, is the firDt option
giv<.:n.

~111-.$111 ,;;:;::::: .,, e;;iii!QiiiJIU#Mii!iijiiWMli!ll,iJii!il UQ!W@il#IJl!Q;;; IUIAISQU!kZitJU.JJii#i.mazs 'L,

....

~

"'''''!'" ,,,·* 'L 2 ,,· _::a" EllM411114#14ii •.•,,,.#LC•ll 111111 ..J!JIJl ,Ji!IUJBW 1!llllU!ltll!U!Ulll 4111,,·~tm·~~...,

~

"""'
7-19-68

S.2D

3. 4, 0-1
,r

3. 4. 0LANGUAGE PROCESSORS

The language processors supportc<l in CJ\1S arc the sarne ones used
under th:1 Operating Systcm/360 {OS); these include Assembler (F),
Fortra1l. IV (G), and PL/I {F).
'The language p1·0cc.ssors in CMS and OS arc compatible at the source
laneuage level af; long as the BACKSPACE statement is not \Wccl in CMS
Fortrar;i. <1.n<l the l(Htcros anrl SVC's usc,d in nn Asscrnblc1· progr<i.n1 arc
supporfod by Clv1S. The olijcct ino<lul;s (te~:t: decks) that arc output
fro1n Hjc above Opcl'atine Syslcrn corn.pilers rnay be executed undereither <j::MS or o:; a~1 lo11g as the previous i·cstrictions arc adhered to.

The SNODOL compiler anr1 asscrnblcr-h1tcrprc1.cr arc also inclmlcd
with CJ~1S. They :were aclaplcd from progran1f; designed to execute
under o~;.

~-,,,..

lfl'I\.~

05/01/6?
3.4.l-2

05/0
3. 4.

d!;

H.u:gg:ASSEKrLE ccrrm~nd creates celccatablc cb1cct programs~rcqtalrS uitten in' Syst_?m/J(O Asscmhh!r 1.anguaqE.

the!Hill~.!::- - - - - ·- -· - - - - - - - - - - - - - - - - - - - - - I
1 s s H l' l E I u Jc n a mE 1 <• • • f i 1e n c:i 11 e N>< ( er t i c n 1 • • • o p ti o 1111 >)Al- - - - - - -- - - - - -- -- - - - -i1lcranc/7,,.,,.,,.
~ritesl J JI f II

~tose

llH.!5•rites the LISTING file on

UdN I•rites the LIS1ING file on

ttc pcrrranent disk.
tlH~

1J5.!
H ll'lT.HH

r;c .<Fu!!Hg

cr~atesa 1EX1 tile· cf thetElccatablc ctject ~rcqtam.

ctecksH.f.tli1!tpi;rcsses the re-entrance check.

~£!§:

AsscKbl~r

cutrut is ccntrclled b' a set cf options. 1he list cf
C:DClcsed in a set Cf rarentheses, fellows tho
ldEt,
er cnly,filcn,1me specifie<l with tliE ccrn1i1and.
one set of
crt1cns governs all asflcmblies ierfcrmcd by one ASSEMBLE comm~nd.
The
Cf~hcn::.:, qwcificd in auy cnh!r., arc.separatEd by at lea.st cne hlan~.
P J~fJult value is su~plied fee any crticn net included.
The default
crt1cn values are:

NCtlH

DECK LIST XBEF [lAG NODENT tCISK

Any ccrnldnation cf opion values may

ci:cntes a LIS'IlNG file cf the?E~Emtled prcgrdn.

isi n c 1 u cl c tl 1
iync r<;t.I.

~ q: ~ t e :, ~: c ~; t h c L1511 :l G f i l c
0 n 1 i II c d i a CJ 11 0 s t i c .s •~ r c)

x I· E f 1

cIli G , L D I s Y. ,lie

l. P BI NT •sr,~cified,l' .H ?\ T ,n ndcut if NOLISTLT AF n

1.1 i

11

he

Dutinquna~;.somhly, th1:·c<!
woi:k
files
at:E created,\dt.h th~filctypct> SYSUT1., SYSUT2, aud SYSUT3. Tl1eir filenames ar€ the sar.ie as
t!Je SY!ilN file J:eing assr-ml:le<] •. Acccrding tc th8 options sp(~cifi8d,
fi11"E with
tilEtypcs lJSTING and 'tEX'f
may alsc tc creilt<:d,with theSi.l;il<:: iil<na1r.c.
At tl1c licqi1~1.1inq of (~ach c.t~;;:::cnbly, any p:<!-C:Xistinq
f i J ,i ::: " i t h a n } o l t nc
a Ii o v c f' i l ct yp <:> r;a n cl t h c: c:: u r r en t
f i 1 !"! 11 a 1r 0 a r. c
Jcl~te~, rvcn if th<:set cf crticns E(OCificd means they will not be
rEflaced l:y the cuu:ent. a~;~;ernU.y • . To snvc old ccpies cf LISTING and
Tl:kf f.ilu;,
u.oc Jl!.'TEH tc ch;ingr..? either their filc~narncio, or thei j 1 ·.o n .1 ·m c o f t h c S Y s I :-1 f i 1 <: b 12 f o re · a s s c mI:; 1 y •J u s 11 ff ; c i e n l s r a c e c n t h n.

irclude~ a cross-reference symtcl
t a 1~ l<! i ll t he L I s T 1 N<:. f i l c •i:1:rrros.so.s thQ crc.s.s-refn:encc

synlcl taLlc:.
t~rcs source statcrrent ccntaining<rr:crE at the torrrinal, along with
El:J·Fi:cs~<~sEEl~cted,

ti:<:: 1EX'I file.

diaqnostic rtnff e1:rcr

the prcgram for re-entrancf.

liE'H

filcl)pe ·"SYSIN" is assumed for
all input files tc tho
ccmrrard.
Th~
file rrust have fixed-lenqth,BO-character
Morethan one asscmtly may be rerfcrrred by sp~cifyinq
a<lJiti0nal filerarres, scraratod ty blanks.
Any numhec of files raay he
Eiecificd, but the commHnd must not exceed a single input line.
Eachfil~ nuncd will Le asscrrbled Ee~aratcly in the crder named.

i~ c11<~ or tnorc of the~ a~;scmhler.: Cl t.icns,~jr;tcd hclcw.

~q pi:esscs

offline prbitEt:.

reccrJ~.

~l:!i.fH:

NG;;:: CK

.322

from

Cftion 'alues

J;!~l5the LISTING file en the taresymbolic address is TAPn.

Ihc
ISSEMELE

Erocifics d SYSIN file to hE nsscrrbled.
lfditicnal filena•CE e~ccify adrliticnal
aESCmblieE.

q:ticn,/.A~,,,,.-;_.

11~/iiASSH EU

3" ~. 1

ftcr1r.<1nclll dh;k~ith

mr~ssa.qes.

tyrinq cf error£.

~n

fer

i1llY

"rilc11il111c 'IEXT r·1 11
'

l

cf

thr~

t1£[en·h}er file£

will c:a1Jsct(~r:mination.

1/0 0r1cr message.
i~>

t.lic

fil\~

of

milchinc-li'lnquaqc ccd<" cH•at:<'?cl_~· r·:-1. 11. l-·::;

t 't t h •? a ::- !' e rr b J (! r •l' h is f i 1 cJ ca n l: e 1 o i\ uc d f: o r c x c c u t i o n 11 i t h t h <~ Lo ?.!J , > .. ·.
er 1 cof.'r.«11hh;, or rur.ci:c-1
cut in ob·jcct
lli~ck :[ci:1·1 en
tlic c<t1:11punch/,:..,~it:1 the O.FfLHF PU!;CIJ con1rnanu.
If NO!JECI; \laE q:(~cificd, tlds file L;
rct cr<!a~ed.
11!-ilE.•nan:clISTINGr1 ·isthefile
cf source
stdt.C!ueuts
anc1a~2cntlvd ~achirecede froduccd by theaEserrbler.
This f ilc is not
ctcJtcj if
NCL151 is srecificJ.
An
CKt0rnal sy~hol directory and ac 1 c ;: ::: - L c f c r c 1: cc£ y rr ho l
i a bl(~<n-eincl u d c d ,u n 1 es s
1: ox n EF
was::p:cifl.l'd.
Diac;nc~tics dn.J ei.:r:cr cre~s:19,•s il.[l(!nr .Lt the bot.tot.\ of theunless NCDIAG

and,

was

specified,arctyred at

SYN EC l I c 'l i'\P}

I;.

the

c•

0 l 'I F uii1i

nd·-ot-i:cc1

tape.

'lb.-~

ct e

re~=u

e.
tl1c systcI.J

macrc
Jaacro~lit.r,'ny(SYSJ.lll

forthe tare unit

fer lhoWh,rthe crc,ratcr

r<'rlic:o that a ncv
tc.q:e .i.E nonnt<":d,l'IT'r'n: key,
ano type a carriaqr:- r<•U1rn.
wlie>n•it\1i\s

inh~rrupteu.

we.
PER~ft[NT

l/C

ff~Cf

ON TAll
DI~; K.

\iii Jj' 111 G

ON 1l\PE JS CAl\CEilED.
All er rart cf
the a~3scirl:ly listing is huinq \nittcn
en f.i~~:--. aG
11 t i 1 c no mc
I Is 'l' nit; J.'i 11 •If• an y of th crec o i: t1 :,; v c· J.:C' s u c ce .s [; f u l l ywritten enth( s1.ccifi\-dt<q.c llc?fcr.clllf' c1:ror,thc) i:ill b()
rr.i:s!:in<J frcm Uin di::K. 1.IS'l'H;G file.

1

U32r-1~iined litrarics arc searched bcfcre the Eyst~ra library, and the
1 ~ !O -: " t; l c r a cc c t s t he t i r !; te f i n i t i o 11 fora rn a c r o i t f i n cJ s , a 11 o 11 i u q
t:1-: u.:crtc cverride EyEtl~m r.iacro definitions.
I f orw of
thn user:
11 S Ys l I 13 " ,i i t r: .:1 u c s
i 11 t I: <: :o c a r: c h Ii s t
h il st h e f i I c 1: a rr c
th e
H! a 1S}5ten libraryis not searched.
See the MACLlB and GLOBAL ccmraonds
f .; c f ~ r l I: c r i r.f c r nat i c 11.

r

c ldni Il• G E R E1' u Hll •l. JS 'I 1 l\ G F 1 LE iH LL ll E Ii It 11 'IO ll 0 N

MACI.Jn

ir.a.crc ccti11iticnF.
tlil1"C!"Of
in tlii~.J lilJJ:cHY!!<IY hecttJ111,,,i i.itl, tlc l·iACLIB LIS1 ccrrnand.
!>.dditicr.11 rnaci-o lihr::ilrit•f; 10ay
L;; cu:atc•d c11 thP
fi_,rr.1a1i(1it di~;k 'With the l'll\CLIB GEN
command, ana up
t·1 tivc of thu:c additicral lil:utri('.:O r<,ay ht· includ•·r1 in th<:- C1!.:f;e1·il~lPr
i: ·: I l c h ] i s t
a t 0 nct i n e \; i t h
t he GL 0 D /1 L
h s s F Mll]. l' n l 1ll c L l JJ
c c ll'HI a n d •5))I· [) I l. . l ll f, J\ G E I T li ND Hn·

ccrditicn 1;ai: dctcc:t<'d en

HEADY TllE 'I'liri: ui;rr li?i[ filT Clil~RlAGE FETlJRN.
H1 (' trq-: e u r..). t . s r t 0c i f i <a by L 1 l• P n .d q 11n111 • d 11 o t re~ n cl y.
Go t- o C P
with the~ l\'ITll key<Hid a~;k the opc•1.·dtor to readytlic unit.
~:J,r~nlw r:cplic~ tbat
the• unit iE r<:-<uly,rPturn to C'iS \lith the AT'l'!l~C), andtype aCcirri~qe tQlucn.
The a~~<~bly ~ill bcqin er

SYSU'l3 f.ilcs creat€d l~y thc. nssc:rchler a11<1
Cf
C' d Ch a!'.:·::-; C JJ I.; 1 '/.
l f t h (' yt l' r Ii i na t i c n ,t h c y 1:1 ;1 yl· 13"ith tile fBASE cor.1'.1cind, or: l:y re-ist:;uinq the ASSE1liJLE ccrnrnarTd.
~earcl1es

VHITISG,j_

SYSUTi, SYSllT2, nl1d

1hl' i'ISFPr.l.dcr'I Ar: r.

rQtutn to
C~'.S with the
Ilic as!;<~n:l:ly will t<r:urre

IS \.' C [ k f i JCS
J t C d ( l Ct C c1 at th l' G II dn D t d c 1 (. t. u: b E c a u :::: c c ( a 11 i\ lJ n c r ma 1

dclctt~d'·-·:/./1,'./ /·/"·:~"'·

11:cc.n:lEC'I

LJ ST1:1c: fi )('.
The tar;c haE Le>cn
rr·1;cuud.
Press the f,'IT!l k(.oy toc n t <' r t !. e c P c n v i i: c n :11 c~ n l , a n d a;:; k t h e o r: c r a to r t c 1r c u n t
a n '2 "'If fNINT Ct LPdINT uas E~CCified,the "LISTING file is printed on
th: citlir.e
rriuu,r.
Jf
LTJ\Pn wa;;;:C}l(~Cificrl, tlH!
LISTING filni.~;•ritt.;!ri en th(' tai;c\1hosc symbcl.ic adclr.C>ss is TArn, i11
blccks cf tv!T•
121-character rEccrds.
If LDISK~as s~ecifjnd, or
if novalue W<ls!:~eciilcd, the-llSTING tilf! is 1-il'it.tcll on the pErn-a1wnt dir:k.

,1 ~~ !! .J

111:t1: F. SS

LISTl}G FLLE WJLL EE VSITTEN OU DISK.
O~ TAPE IS ChUCflLED.

·1h0 cr'tic11
Villu1:i LTArn 11cis sµ<'ci.ficd,
and 11.rn uu!' nota Vi1lir1
symtolic lap= ad<lro~s•'Ihc USTlNG filei!; being \:rittcn on the~ <~ Uf a 11 G 11 t d i ~ k •11

LI~IING
file,t E. r :~ i a a 1.

O!J/02./E··
3, I\, 1- l;o s Io .1 I 6 9.. ).....)af.

Pl EA Sr

FE fl DY 'I il F.

ff<l ll 'I H

!his rcE!CllE~
shculd neveri: u s r c n t i l; J E !5 y.s t e 1:1 1 r c <J r a 1H1H.: r •

cccur

under

CP.

Nctifytheq.

PH!M/\!lf.NT 1/0 EliliCf< 01; Ti!E fnINTEP., II'.;'IIh'-' FilE
Wl l 1 [ E ll !i 1 'I T E i\ C :i C I S 1; •'I h isre ~3 r c n ::: 0.
sh cu Llll e 'Ii eroccur
un dc rC P.
N ct if y
re~q:c11.si llE :;ystn1 proc;r:arrrrer.

}SJ:f:I h E.' e r r c r c o 1r p le t i c n c c ll e r c t u [J\ c d o n t c r 1r. i n a t i on o t a n 1\ s S E~~ l3 L J::i E t b;; r i q h cs t E c verity c et1 e a r; ::;i g n e>d by th c a.sr. c I!' l: 1 e i: for any

cc-~ J· d n d

HliMHEll'I 1/0 FHHOH ON CJSK, ASSElrnlY CC:l'J'HU.ES
W1 'I Ill tl T Wll I 'II Nc; 11 S 'l HG P lJ, E O !l .C Vi l~ •11ie 1u;!;QnJ;Jy is coniplcting
11ithout.
any
J,ISTI~;G file.
Ifali;;tinq
ii: ll\:C(!~:.;ai:y,ex.ccuti.on may b<? c.111cP] J(?C
with theY.X
coni111ilnd.
'.Ihc error rr.ay huvE
rc:-;ull,•tl trow in~•ufficicn\ SJ.ace onthe; r:crwanent
disk.
U.sc; the FH!,SE ccrc1::<'11d to cr:ea.tc
rnor:c frr·oh.

cc thE asEerrtlics fCrfcrrred ty that ccmmand.
..f~:H.!Jg§:

d.

Thi~

ASSF.H'IING:
rc~rcrsc iRr (' [ f c ru~' ! d t y a

d 5 st: Cl !i 1 i c ;3 •~s~acc,

iill'11a1~cty~cd fer thes i n 'I h~ c 0 Ii: r.: il n a•

the

and

try the assembly Hqain.

If lhcccrc~

r~curs,tin: C>iH.Tutct.

:::eccnd and ::ubsnqucnl ~s~>r!wl1lic:is1 t 5 e pa r •l hrn d i a g 11 cs t i cs f o r t h ~g_tf_~:~!

~

notify

,..

""'

~

05/01/69

05/Ul/69,., . /

3, If, J.-5

lh0 errcr corrpleticn code returned on CCIDFleticn of the ASSEMBLE~-_
com!o.a11d isth~ hic;hc!?t ~e'liErity cede returnocl by the asscmbl<·H,;i._).:)
for an) of the asserrblies Fecfor~ed ty that corapand.

j:}.·"';-:·. 1~·

E (CCC04)~incr errors were detected during the asserrbly, but
successful exccuticn cf the rrcgram is still prcbahle.

'Iht; Systen/360
instructic:n set i!: dc!:cri.lwd in "System/360
frincii:lc::of oi;er:ation 11 ,Form
1122-6821.
The
assecnUec
i 11 st r u r. t i c n s
andmac to
LHhJ u a CJ c.: ared c ,, c 1· i h ca
inu ll s s E! r.1lJ1 e r
L Cl llCJ ll <• <; E II , • F 0 [ m c 2 5- G: 1 4 •Aa a i 1: i c na .1
j 11 [ 0 l:PI ·a t i 0 n 0 n
as s c mb l (:: t
CX<!CUt.lC!!

andr.lCSSrH)CS

!Jay

be

found

trcc;ran:w10r's Guide", 1-'cu~ C2G-3756.
opticnsin th~"Froqrar.1mer•s Guide.,surrcrtcd ty c~s.

in

"Jl.S~;;(;nblc~r

E (COOOfl)

Errors were detected in the asse•bled program,but

execution may still be possible.

(F)

Note
that tht? executionar.e
differ-en!.: tl1an
the~;~

f(COC16)

ll!l!.!!.fl~-~=Very secicu~ errcs ~ere actccted

rrcqi:am.
ASSE~ELl

HETU~~

1IS1ING

f1

HETUB~1EXT

P1Sec Fiqure
3.L!.1-A for an er.imp.leof this cci::rJand.,showing theen-line <liiigr:crotic::: <Jl2I1er:uted h)' the nsscn;blo·.
Figure 3.4.1-B
slicwE the JlS'ltillG file creLitc<l. ·E(CCC20)f(CCC01)

f I U: ( S ) 'It 1 1i ~:.; !::11 E 1. E U Ne EF IN ED •Ne filcnumc~• ..:er.(' specified \Jith thu.!!(CCC2C)'Il.c assenhlet (J(>tuctcd a cntastrcphic Error sucb that it
cci;ld net ccutinuc p.cc~r:!:!inq. · 'This may be 011 1/0 l?rror,
ca tsed hy in:rnfJ.icicnt fn.'<] Hpacc c.n th<) pcrr.a11<'11t disk.
}[('(' !.;Cll~O EfuC:C with tho EH/\SE CCinITilJJd, and r~t'ry th(-'a ~ 5 <! n: b 1 y •1 i t ii e C L tu J.: r:.<1 C l1 ( S / n 0 t i f y l he 0 [- e t i.l t C r:.
3. ·~ • 1 • 1/\~Sr~ELJ:ll

I.llNGll,,GE

PhCGHMMlNG£H.!Jl.J11._]_<1~l!!.9:/\SSEMflLE co1,11\H1nd.

A 'I I. }:; /1 ST C N E 0 1-' 'II! r; F TL r: S 'I 0 A s S E I~ [' l E D C E :; 1: err E X I S '1'
CF LOJ:St; 1 'J' EH E 11 CCFHCT 'TYfE 1 NldH.
il ~ U.: !~ h] i C ~ \>:\~IC Et a!. t Cd.

A'I l ~;As 'f

1/C F.FliCH WllILE IiEJlrING SYSill FUE filrnaro('
ALL TUE FILE.

ASSEMBLE

TJ;u 1101.n•ul c.:nt:ty
FCillt r.amc of: aproqu1111 should he thn:::;amc as
the:: f:il(~lli.lne of tlw 'IEX'I f j 11'.
~-'he proqrvm mny thEn b<: exccute>dl: y t 11 c c c n na n d

1U.<~Ll:l5:!£i[:;_<l.9£fi:!:(C0001)

TO

File!" spEcjf:iell ttfcrc the cne iiame'l. in the nc•ssagC? have
Ileen osscmblNl.
Tbc: filE lli:[[!(:'d and sutsc;quent cue::; have
net Leen a:-::£cntled.
'Il1e filn in which the crl:or occurred
i.ill hilVC to ln~ r<'-cntcrc!d l:cf:orc asscr.iblinq j t .

TISSEtHLE liE'IUIW .JOI!/\ HST 1 (Hl::l"l' J,HI?U NOXRl':C'is M• s r- mbl <' cl, a 11 :1 t It e re:..; u 1 t i ll <J ob ~j cc tcode is clcch'<l fer 1·~~ent<:t<1Lility.
'Th0 li::.li11q filo is r:rintcd
c u t , ii 11 d i ::ll c t !>'l v c i o n d i ~; k.
Th c l i .s t i n a doc t; 11 o t
c c n t c: .i n a
ci:c~s··-i.:c.:1E1cntc
zy11•Lcl
t.:tJ]i.:.
01J-lin<~diu<Jno:;tic";·
ai:e
11 lil:.TUH!~!'11ri:re::s1,J.
TEXT
r1 11 is cr:.catcd en
lhc pc~i:muncnt disk.
when
tl1c a:;scr.liJyi!;
cc1q:J<.:'tc"c1, the:=an<~
C\:cru.ticnE 1dJlberertormcc1 for "JCl.lA ::JiSlll f5 11 , anil then for "TE'..;T1 SYSI!l PS 11 •PfHU1NENTUNA~LENODl /IC)·1 he f i ll' '' I E 'I 11 i1!J s Ys I :; f ·1 "£ (00 00 1)

in the assembled
Execution is impo!:>Sil;l('.·BETUBN

1 h c f i lE: F ET !l IH S Y s I N r 1 i s a .s s f~ rd: l c d •ti o o p t:i. o n .s a re s p e c i f j i:! c1 ,
so
the
sEt
cf
defiiult
c1;tic1is qcv8rn~
th0
assei.1bly.
'I'.hcfcllcwi11y fi.lo:-; are c1entcd:

l..

3.4.1-6

SYSIN files must have fixed-length, BO-character records.

Es.!g.rng~:~.

.:J....J.b

ll.ECORD LENGTH.

;j):)l) :--J E

0 F ·un: F l l P. s ']' ()T1 s s E !-'l'I. E

H,, s:r ~ c 0 nH Ec T

$ f ilcname

1J." tlic iilEllarre and entry r.cint.SCC;)UCJ!Cl-'

rrt:.:t toname arc ui(fcrent,

U.S<~d:lCllr file::11am<:

tli"!

followinq•

05/01/69

D ~· 1 0 l /Cr,

3. ti. l-7

s T /: lil' e n l r y ii a r: c:

., j

~j/ /

~

.

3.'Ll-rr,•1_;i::;tc1·s .:rE:
saved nnd
rc:-stcz:cu hy
the SVC-handling s0r-viceuhich is ULletl
as au
ercor returnrcuti111~, c.l<ccrt
rc<Ji::>tc'r 15,

l'!!X/·[t' <,; l St CL...

':.-'· ..
_/r'•

,}J,Y

'~;,LU!LlJ.iJ.J;j:'lli<i ru.1<111'CtPt lisl
i:.; alHay:.; aliqncd ou adcutle uoul l:ouinJary.
l f a c () 111 n c) l d
i s c il 11 u d , t h c s a r.: E Fr1 r;itr.1 (' t c r :; t h Cl t
\I 0 u 1 n h c
t yp n d
to cdll the comn;<rnd aru placed in succ<>r;sivc dcuhle wcrds.
Fori11~>tilnct•, c raz:,1n:1tti: li;.t. tcr FH1iSF rniqht t1H1(1ilJ: <i:::i:

1di01; ccr.trcl
is r.ccf,ivcd ty auser pro<}rarr., the adrhc~sof the(!;try roiUi~ i11 leqi[tcr Fi,... hich lllllY b<: USC'rlf.or: in·rr(•di;it<~,,Jdrv.::<1l.1Jity. Hct;j:=tc1.
111 c:cnt<1i11:: .1
rctui:u i\<ldr~::.;~;
into tl1r:
1..1·,::: 11uclclf, .1no mu~:t l:<! saved.
Hcq:istcr 1l cc11L1ins U1c udc1i:<::-;~-;
ct an 1ti-~o d save au:;i. Heqi~tcr 1 poiJJU' to a Jiararwtr~r ]j~;t.,i.bich cc1itains any
pdr<ipr:tc.>u:; pos~;cd
tothP- pr:oqr:;:i11 by$ oi:~-1ld<'l.
'I}•( 1ai:.1~;c-lcr li~:t iE aliq11r>d
en a double ;10i·k boundary,.i1;:l P.ic:l,cntr~ isfou11tl in tlic
hiqlt--u:d<'r. byt,~r,of ::ucc<'s::i.vr:

1'1151

l:S

01:

DC

cl !'. I E Jl fl s £ I

i:cl'outle 11crcs.
All dat.1 i!:: in l::T\ClHC.
'.Ihe ·first '~ntry is al11uy£>
the
cutr~
1.oint 11amc of
the proqi:atn bcinq executed.
'J.'h<~
1c1lodlll] E:J;tric.:; Ct[l tl;C raL·.irr<!h!Ul
ra::;f;Pd to the prorp:rtm.
For
i11!:ta11cc, ai ter the comr.1and

rc

le.

thi:> case,c rn • * •c ui 1 1w n KF i 1 E •

alJ

tiles

c1,1:.;cd dur.JPCJ exPcutjo11 of$ JGE1C 5/7/68,;ill

register
tortrat:

FLJS'I

point

cs
1:c
r:c

DC
J.:C

th~

to a

\'/CH!\l:'ILE coul<lbe~u~qucnce:

21.31

par:arn<:tPrlist

in thefojlc\1in1

cc

I.A

1, PLI ::'I

SVC

X 1 Ct1 1

t he
f i l l' '.; wc l c
cl c 1 c: t c d , c:~ s wo u 1 ci
t· f t u r n c c n t r c 1t c th ci.1;::;tri:cticn attcr th« ~vc.
Heqi.c;ter 1S would l:c .sE.t to zerotc jucJjrrlt<::that no c·u:or occurr:c,:1.
Shouldan crrcr
occur, arc:'}'.0n~·c1,cu]d betvr(·cl <t1;d c:cnti:oJ 1:0~·!'."c'dtc DC:1<1JG.
Pax:<1::1L~t<·r
lu.:tr.; tc>.· o~s routi11c!:.: 1ddcb arc r:ct cc:ruan.1s, :;uch
as 1<1:1•UF or
lYrll!l,illC
notu11ifurr.:.
Cowplr·lc u:plc:n<::ticn.s
oftJ-,<:Y~
i:·ira1t1ctcx:
li:-;tr; r:iiY
le tct:nd. in Si~ct.icn
3.4.1.111 CMS Nucleus
3ci;ti11r.E; ar.cl in the U1~' PL·cqram LoCJiC !·:o.i:ual.
I\ i. t c t:ii.~xt

CI8'JCH10 1
CL8 '~V7/6B'
CI.8 1 71 • .37 1

ex• Fi:'•la~t

cctry is alurtys a double
wor<l with all bits s0t tc en~,a s a d E: l j n i t e r •· A n y r: a r a ir o -t c r s 1 c n qt> rt ha n e i q h t
cl1dti!C:tt>rt= are truncated to the eight high-crdcr chu1:act:nrs.
" ii i c h"ith
the filctype
the p1·oc11>1r.> liy the0.s Er v ( scccurs ina callPd
To avoid~cinq tc
CEDOG ~h~nevcr an errcr
r L o q r a r.1 , t l. <' F r o <J r J rr mc 1 tH y !" p c c i f y d n c r r o ;: return addr0ss uithbytes i&~ediat~ly
i? d C )J !) VC •'f Ji C a lJ d r CS~ i fi r l il C 1; di II t h" f 0 lJ l":1itc1: the'SVC.
Co1itrcl
qoc:; totlic a11<lic:;~~:~ r cc i f i <' J c ll
u n )'
uror iu tic called 1.1(<j1arr.
!"er exarr·j.:l(':

1I f :J.J:j 2.•-1.~.Lt:
t;l.CL1<1 clll<i<IY!;!:c• to tlic <Hlc11:('S:; rccvivu'!
in rcrjist<-'J: 111.
'lt:i!"' qivc!:'
cc1;trcl tc Ci'l~i .sctvice
rcutil1•!.S o;hichclef;(! file!>,l:i_diltl? th< i;::-t>L 1 n di.}'k file~ dir12ctor:y, and calcul;tt<) and type out
tac tit:ii i.;!"cd in exc•cuti.on.
CHS alf;o insr:f·Cts reqistcr 15 fer an? r r c r cod c •1 t n c 1H:is f cu n d , 1 h (? cc rq: J ;~ tic n !H~ s s a q 12 ha .s tlin
tcrrr "h; 'l-=ll.nn/x. xx
xx/xx;xx 11 •I f tl ere i!" a vaJi;<1 in rcqistf.~r15, the r!cu;<HJC'
is "E (r:nllnn); T=n.nn/x.xx xx/xx/xx" 11hr-!t:C nnnlln
is t.hc ci.rct code i:c~tur;,c)c\ in n!qi~;t~i: 15 and n.Hn is tho CM~> CI'U
time ic Erccrds
u~c~ fer cxccuticn, x.xx
is thu CP and
CMS CPUtint•, arHi >.x;XJl/X:>< is the time .:;f day in hcurs;r.;iuutc~:/H!Con<1s.

i{·!tlllli

I.fl
SVC

rc
Lil

t\ot1·that:
the
acJJr:•:>::-r.:
ccn::tantr:l,j~'tincludealcn<Jtb
E~c~ificatic11 to~rovcnt alignmentty the a~s~nhlet. In t~isc x d r;q; l < , j i
t h 12 c <1 l 1 c dp. c q r a ii' c c rq 1 e t C' f-'n o n1 :i.11 y , co n t r ali :-;rutut11c?d at

JU.fn-9.G tc
Iii.th fc•.i

s0cs tc

CMS Ccmri«rn.ls and Rcutir!e[::~'><'J;tions, all

u1s linkaycs arc r:in1lc witJ, c11e ::;ui::.;rvisc::~ 111·111 ::;a:iii:pt . ~'"lflM\li#IJ,l.,.ii,i!;;tlifiiii$¥14A!ii.W.kiMllMLA, . . l& . . . ,.,SLJ.ii,iiii..iiiiCSUCllLA!iWiiii22

lh0. UI ir1.struction.
If
any errcr. occur.<:, control
Errcrs mGy Lo ignored by tho sequnncn:

FBf0Ll1.

SVC

cc

c.111: SVC
X 1 Cll 1 • TnE addrc~s
cf ararilmcter list i~;plac<!d inr<!')i!::tcir
1 b(~(orethe call,and thefir:.;t entry of the 11sta l WiJ y !:i S [ C C i 1 i C S
t h C Ci~ S C C lf. ma n d
0 l
f U ll C t i C ll b Ci ll q
G a 11. C 0 • /\ 11,,.

1, PIST); IC fl I
/lL 11 c r 11 r< o oT )3,;; (; ( 1)x1 c1. 1fl l 4 ( i /j )*~&S#S mm

24

~
.: ea

:.

{WAZ

.;:a.: i__ ,. !iW,141·*"................... ,H'"'WWP··""""''"'"·I M\,tw~~05/0: /69

3.4.1-9._:V,;

1-JJ.:):~t~;:.~_J!f.!;.QE':

that <lJ:<: net tf,sider,t j IJ tbc CMS nucleus may alf;o hr!
the cr.s '.;Ve,tut they
will t·e leadedat hExackcimal
1 o c ill i o H 1 :< CCC •'l li i !: i ~a 1 :; o the d cf au 1 t
l oa cl p ci n t
for n set·
rrC<JLd!!i!;t
foO i1hi•JhC!r }c;;<}poi;itmu:;t te:specified when the
11!':1't's Frcq·1n1 islcildttl.
11 ccrrlc•te lj_f,t ofthe disk re~dclcut
Comi;,;_1ncfi.1.

c.11l~d bycc;;11.1nd::ni1~'c;ivc:;

1cbsh id<!.l,1

Le ol:L.1incd 1>jthc( tl\C~· tiOL:llLE SY,

11ldcli al[;C

Ei·1.e, C'!Y.r:re;;sedin (300-l;ytc

a LISTF

CC1fii1.'."1!1<l1 vcc1 r rl ~-.

r.

ic.i 'lt'.!'i

flrcuti1;Qr 11ay

cnly Le executed by

hrn.nchinq.

The-1.tJLC.E><c~ Ci thGsc: pl.G<JLiln.!:.: arc:: Ji.~;tcd in a nucleus u:cd11le ur.c1er
t ll (- c JI l I y
r: d n l s l $ HE F • s y ~ E E F \) i 11 b 'J r (! s c 1 \' (~ a. a s a 11 E x T 11 N i ll

·lllY u~-c·1

prc•JLU:'·

from SYSr:'r'F to
the dcsir:cd\:ith thecv.~,y~;1;;.;r n-aci.:c i11st1:uctio:1, io:hich·Jc:r,cridt.:· d c ;i,ic:..;or.' JQU :;t,1tc:·.cnts •• 'Ih0. !1dr:•cof each 1;u-;Jcn:::;rcuUnr-,.. itha"D'' i:retiY.<>t1 tc i l , i~;equllt<.~d to it:;
11: 1J.1cc'r·"l'l(r<'i' SY'.iiiLF
i;i t!1~'
addrc•f;·;li.~;t. '!'Ii<.:' foJ.J.01-;inq~1.;1rrlc ~ld1:: hc11 tc qc:t tc tlic SCP.!~ i:cut·i11r.' ju thu nuc)<)u:·;.

;i.lctrc~.f;

The; t1isp]<1cu••::nt

cJ.tc1inc·dj::'

IJ ~; ]·. I: '~ <l l·

CSLl '1'
l:.X 'ii~ 11
LI.
l:i1LhL'i H
IHL

S\S[(Ei3, oc.1\ (!':Y~HEF)
1'.: I J.:'.) (JJl: ('.!)

1 ll ' 1 <;1 '.:; , 1 ~)r ti r J

CI-iS Y Sf, t· l'Inth<:cx1.-~11;icr; cf CtiSY~iHi:f,
D~;Cl\N is oquatedto thedi~-·1.1.:,ccti:,.:1:l of the Sl.!tN aclcircr.:; :in t11F !iYSHEF list:. 'fl:e acldtt•~.:f,is lci·i-,: :i:;to rcr;i~;Ui:1') fc1 !Le Bf,Jfl.
(SCl\H isa routine tolrt>ctY.
UJ 1a
t1·::r.:i11<11.
line :ir::aqc'
ill ccr:ein~o a stand1tr:c1 C~iS
rarar.cU l]j!'I,'.)C<~ th~~ CtiS 2rr~Cjri!tn .Loqic '1•1nua.lQ);/:';:'""

,Jiii\~fl"

01-22-68
3.1. 1. 1-1

)"'.
,))(

01-22-68
3.4.J.1·2,}Ju
3.1.1.1?3;

J\~;:.;crn!1L1r L;1:~~L 1 r!~;c~ l'rugn1111rningt··--- ····---···---··--···--··••-'•·---------·w"'----··-~~---------!~·0~2·~,~~: -~:1_11~i~";2The: lH>rJr;;ij c;1::ry point n:Jnie of a p~·ogj:nm should be tlic sarnc ns the filename of
the TEXT J~k. 'Ilic pro~:·n1rn m:iy then be executer! by the con1rn.'.lm:

JJJ!l 13

CSEC'l'EN'l'HY JOB 10

JOB10

J,ft

$ filv1wnic
hc u::,c;rl:LO/d) filcn(:rnc
S'l'1\H'J' cntryn:uncALJ.Dmn~

ADD:~ESSt.nUJ.'J.''X.

r.

15,FRl:CDr.

J~Hn 111~, HE'J"F!SV

I

I
I
I

I
I
I
I
I
I

BH.

'ill

L!\
E;'J
'PYP!:!
H
GT

15,7

1

lrnn2

'l':tPr~

GE'l' EH.nor{ CODE, IF' ,'',Wf.
GET HE'rurm llDDlU;f) s.
Jll\CK 'l'O CHS •1

lf.JCO.lU!CCr!' CODB LE'l"l'EH. 1

1~)I1.'.:Ri~CIJ

SlW.i': \'il:BUt, El:l':OHcu;'~/7 /6~'~

DC:

CLH'2L :\"/'
EX'FF'

pm.:<tn1ctc:;: lict v;it.h t:hc forrnu.t:

Joe 1 O 'l'EX'l'

JOD10 x.

P~i,This givc;J cont-rol

Cl\·1S rtw insp::cls l'l':_~i:>L1:r
1S fu1: m; c:in:u·1· C(,ck. If 11c·1~<: is found, the co]11pletion 1r1c:ss:1gc hus tile form
"i:; '1'.::11. nn". ][ tl!l'TC is'' valnc iri rcgi.~il:L:r ·J5, the rncsf;<ti',l' is "E(nrnmn); 'f:.::11, nn'
wht.:i.·L' 111::t!~:1 i:; tl•.! vir•JJ: c•1d~: relu.rncri in rcgic;tcr 1:1 and 11. nn if: tlic CPU tirnc in··-·· ..

c.nc.1 o)::ccut.ocJ by th:J co:h.dcUH1

on entry,regi~t2r

DC

CLB'JOll10'DC

CL8 1 X'

1 pointn to a'l'h;;; e;~i t

sec1u;.1nce allous f~r- t\·.'o types of error.s.
If the pal.'<tHK:lcr supi)l3.cd \-Jere not v<.:.15.d, thefollo~ing 'rcsponsa

to c;-..;s f:L'Jl-.·ic..:: nJ:1:·iE1:::: which close fiJe:s, update the u~c:r's di~3k file directory,

1cnLry and e:~!~t f;c•.JL1e11cc!'.; .5.n <t U!'!.c>:'l'h.i n pro0 r; '.n \-.'ould b~· ); -~pL on ci.-l :;}: t•r:

CLS 'j01J·l O'} '.rll~, ~~·~Ji.1 _F '.'it_:::

SiDi1;:>lcp;·ogr;11·1.

lti~'.h-un!.T l·l.;1r:<c1C 1 .:.

I
I

COD'.~.

H.
JJC

Fiun:r:c :1,,J.1.1.-/\.

The· );1st: ('11::.·y is :iJv.<ys a double word with ••lJ hits sN to O•w, which rwrvc:; ns ntl'.:lirnil-..:"·· Any p.1r:in1ct:cn; lougC'r th::iu cig11i- char::ict:cni arc tnrnc<:tcd to the eightI

ALJ,uu:~J::'rm11.on rnu'l'IUG. 'l\I.LDOHJ::f' • o 1I))[;l"
1_ -· ... ··-- ••. - ~ ........ -~. - - ..... ' ... - · · - ··~···---···· - - ,.,. .. ___ ,__ -*·-···· -·- ... -·· ··--M·•·-·---~·*mmcn
Rl::'.1.:W~V

I

I
I
I
I
I
I
I

SET ERRO~ CODE.

15,~U~CaDC
DC<11~d c-dc1,l.lk :111d t;.T•· u1t 111::' lirnc• u~~ccl in cxcc:11tio11.

I
I
I

SKI'.P Nl\Z-m Pl\lti\l:l·;'.tEn.
PICK UP CODI~ PAlll',L·..:;l'lU<..

()J)

llr.l11 rn sl1olc:Jd :.il\'::l) :: b.:.~ l\• t!w :1ddn-:>s received in register i:L

I

Sll..V:r;. CHS m..:'l'UWi.

])'.i

UC

I
I
I

NQHJ:.mr. EN'rTIY POIN'l'.

I\'.'li"n c<>'·Ld(Jl is n·,·.::i"·cJ hy a lli'C-'_· program, the c:dclrc:-rn of the entry puint is in
rc~~i:·,ccr ·L>, \'. itich 11·:: y l•c: w·.;::d for iPm1edintc nclrlrc~::-:<1bility. l\cgie :er 14 contuinsa r.~tl!.L"tl :!J.:_.-,::;:; i1,r.,1 Ilic.: Ci'(·:_; 11udc:11:;, ;•ml nw~:l be ~;aver!. Regblcr 13 coutaim;
ti1,, ;1d:\r,_of ~·11 ·l 1;. •;:o.! d ~;;·:n· •1rca. lh·ginl.'r 1 po!nt:; to :1 p:ir,m1ctc1· lir;t, which
CC·til<;i11:: :''I:. 1':1r::i"' :".!':; p·•::,;c·J lo !li:· pr,,;·.1':1111 liy ~; 01· S'J'J\l(J'. 'J'hc: p:1.r:nt1ct:cr]isl i'' ::J;::11•·cl c111 :i duth!~: \\'llni b\Jt111d::i·y, [!11:1 cctcl·1 cn:1·y if; found in tile higli··onlcr
byt;::!;:; t•r ,,.,c:,:cssh•v c:,.u1,1<: wonl:;. AH dda bin Ei;C:UlC. Tile .first entry is
r.lv. r1y.-: n. i:.. •.'.. ry p,1\1: 1 W!Jr:(; cir 1 Ir~ prn;;rn111 ]',r:ing exc.::utcd. The following.entries
fd'<~ tk·:: )' ·s:;:::;: to tk~ p:·u;;r:1:11. For ii:st:•ucv, aHrT the.: corninand$ JCUlll :1/i/of: 21. Tl
rcL'.i:.!c•r ·J f: ill Jioili~ l» ci p.•1«1rn1.·lc1: list in tin~ Iollo''.'illr: Ionnat.::--;cL:ond~: t:!~'vd for v_:.:; .·utic•!l . .

12, 15

ur:BUF Ol.'U'l', 1mnon""}~1m2

I'n c3:.m 1::_'.~:._i:::.::_

PJX;·rIl

UfiING JOJ.l10, 12
1 I~., HE'l'NCV
S'.l'LA
1 I fl ( 1)3, 0 ('i)
IC

Jf the· tilv1::11ric· nnd c·11:i~y p.dnt 11:1111c :n·t· di.Jfrrcnt, ti": following !;cquc11cc mtn;t.. ------------ I).NCOl~HEC'r

would be typed:

CODJ~

LE'J.'TEft.

E (00007); '£"'0. 02
If un e J~·;:oi: Oc:c.:un:<ed in \"inl>LW, the "Elff;.OR \'.'gJ:.'l'INC"
rnor:E:ar;o \·:onld be typ('!cl, ~tn<l the c:r.ror code \:ould
be tb••. t rctll.J'.'11'.":d by \'JHBLW.

lI

OJ-~:~-6S

0 J <':~-68

3. ·1. 1. 1-~.5'1!

::I. ,j I. 1- 1
.i,'_J! ~.:!:_S!~---~~--~-~:~~ __<-:c.':~'..1!~· ~-~_::__ "Y:.'.~_!'o \-~~~~~5.-:E:.

Link~ge- ..

all CNS lin\i\<:;~S <tl:'C raw de~ ui th one~•nc~~:r:visor c:1ll:
SVC
X'Cl\ 1 •'l'lw Hdd.r..:~r;~; of ''· p,:•r.r'.,;~r.•t-.0r
lif;t: is t<l<iccd 5n n·~r-1.-::'i.:cr 1 bcfor(: lhe CllJ.J., c;~c1 tl'.:.
fjrsl. entry 0£ the l.i::t nlwnys np~~clficr; the CMS command or
fu1i.·ti1H1
being cc.lJ.ed.
1.11 r.:."g;_~:V,J.::-; lil."<-"' s.:iv1:c. <:nd r:'.!s_t.-:;~:C:d. by the Si.'C-twndling SL:Lvicc rumi:1c, exccpi.: rcgbL•.'r 15,

fc·.: c;:ccptionr' I

With\;iiJ.chis\'-~:cd as-----~·

a.

l·!oU:~'·:-··· ·----#··--·.

t:1w1: nrn p(.t .1:"<.~C5.(.(':·1i: .i.n UH~ r:1:~.; lHh:J('\1:-; J'o1:q}~: 1 t U1</ \::Ul he lc:-:.c'.:·d'.i'i·.t.t:. i:.~ <: J:_;o t.111~ c>·.::Lit1lt J o«d po.I.nt for.- t•n..::;:· p;,:n•.: .'..:~:-:_:, f:o « h.i.c;l!ci~ 1o.:•dpo.:i.nt 1.1u[;t k~ np,~e;.i fic\1 \·;h1.·n t·l18 p':c·r f s pn1·:,i;:;.:,1 inlo;;<1c<r~.
A crn.1pl11t:·~ l:i ~~ L\:.he ci' i-J: n:c:>ic>.nt cor::·,::.nc'!s
r.vy b;: 0bU'.i.n1~d v.i·i:h a J,J:S'J''" ':' i:)))UJ,'i f>Y, \:lt:ich c.J:-;og:i. vc;; ct >:OH•-j!! _ic1c<'. o:Z the COL:.,1cntl [;lz:.::, e~:p'.!.·c.:;:,cd in
Cor:i'.l'<>nc1'J
a.l.~·nl1·:: c:·)Jt>o:i b~· th~: Ci:'.~ f:'/C,
t~·t h~.:;:t.c~~-·clh.::J loc~~tion 1·~.00~1.

or<:tn error rett·Tn n'g.\.Ftcr.

'l'hc: p<:n:cJ1c~tcr li~;t is ciJ.wnys alir;nc:d ori a doubl<.' woJ:d.bo:.::·,,1"'i· ~·.
If a co:r.':.:<md is c.::lle•:-1., the ~;.:nn~ p;:,~:<.1!t:..,ten3
t.hC\t ·.·:oqld be typ·~d to cnll the cm.-,·.1;,c1HJ 4\:C<.: pl<.c:ed in
snc:c~:;·.·:i'I.'~ tlonl>.lc \'!Ol~1.1·::.
l:'o:c inslL".:lCe, a p~ir.:i.) ...::ter 1.b-:tfor }:.lJ,f;L 1:iight i:PI)C![S (<f-!:

BOO-·h~'teb.

l:'C!COJ:t1s ..

h fc\: C:!-'"S j:o11·i·:i.n1.··: Hny (lnly l>(! c:~:-:::cu·i·~:d by b;:c'lK'h:i rig.
'J'hc .o;c'.d':c[;;:-;:.::.. of tli•~f-~~ p:-.("><.J;·:·r·:~ ;-,;:c J.-i i;tcd :i.11 <.:. ntH.:.1.eu-:;
modul::.' t:::-:k.1: LI~.::: c:1tr1r pciin:~ .c::;,;:··::F'.
SY[.);_<? \·:i..l.J L:~
rc~10J Vt~c~ o~; c·:1 J·::-~.rl"HN :i.n i·:ny lt;~(·T pJ.C1~;.1 ;·:.; .. t.
r;. iH::~ d5~::;·'"'
p.l ar:i!L.:1•t. fi·c-::1 ::;'.,·;':~: 1 :!" to tl;c-: c•_:::,) ):";c'. ,-_. :; •<:~ :; i~;1

PLS'i'

DS
DC
DC
DC

OD
CI.8' J::ff.Mii·:'

tily~·-td_ll\.:(1\·ri'tl' hH C~ .. ~:~iC~J·'.~·~}.<. li~:.c:·-t"..> :in~ .. L:(·1-:c~:~<~~·~, v:hic>~.
<1 i.:- ·;:.i .. :: o2 E~lU ,,;_;,:..c 1 ...--m1.:.:·•.
'/;,..-. n;.:.·: ofc;·ch nuc-lc\)'.; l."ou·: :i.111.·, Hi::h ;:, "IJ" p::cr::.;.-_,,,..; ~o ii.:, ).r.
CC}l1.t'li.:F·c1 i.O :i.i·!·~ ct: :;pl{iCC:11:·.~;1~: f)"OM ~y·:;J~~'.:
i.u {°}!(" ;~d<~} . . C~S~
liL; L.
'.lite fc1l. lcY-.·.' :i.J :q c::,:·.:;.; >le ~-h(.l'.'!G L(1,: to 'Jct to Uw~;Ci»N LC.l'c\(·inc ia the: Xi\lc~.'-.::l':':,

CI.11' ~·'1~rc:ncr;· ~-,·_:·

CL8 1 l.'OhK1''J.I.!:; I

1

ln th ii:· c<u;c, a 11 fi h~::; u.i. tli tlw fi le:typ~ \IOHl\J~JLE co•.iJ.clb;~ t:L<'.:·e;c1 <luril<; c;;cc:t~U.on. o:L the p::o9h<'rn by th0 fiCCJ\'.::n<'.(!:Lt\

1, PJ,'_;'!'LU"'

X'C11.'

L>v\ ...

U~~F!{,T0i3~~y,c~llT:f]

id'ter UH' f51('S 1.·~ ·:·~(' <1 " h!b:::d, ens \''C•uld return control cu
i.:iii.: ne;:t in·;tTw:U.on ?!UT the SVC.
Hc~ri~:;Le;: 15 '"ould l>ct>r:'t to ;-;r,-.:n to in,~:;_cai.:--, th<:l no erJ.')).'. or-ctu:i:c.·d.
S\10\1.ld a.n
cri·-.1~.. {1:~cur, a rc:rpo11:·;:.: ,.,ould )_,.:: tyr·c~d ;:_nc1 C(-,nt.i:<.il pD!;r,:eu
tt> l·J·;1;1_:c;,PDr"1,i:~tr.·r lir;ts fox c1.;s ; nut.i1;o.:.:f; \!h:i ch .:i.r1~ notc:c·.- ...,«):7_:., ;:;ur...:h <:~~·; i:nriu;·· or '.l.'Yl'LHl, ,._;.,~not ui1.ifn;:·rn.
C'o:nplctt:c::~)).;-·;·:r.·:-::or~:> of UL:~:c p:.>rurC<:>tc?:: lic~·.s m<'Y be f0tll::.t1 in thec1:,:; J'r1;;;rd111 Lo,:i·.: i\l;.nu;.1J.
-

1
1
:/.:

L

3,=~(SYSREP)

J.,
H:1r.rt15 1 llSC!:.U ( J)

1.-'J'l·:1 ~) , 1

1;JJ7.

};HJ~$

111,1~5s

Cl;SYLH:::J.•'

fiSC!.N ir; CC;\l;:~. Cl to thf!
SCl\U ~d,~.:-:<;~~ ir1 ;,;!;·:: ~;yf;n F l.i_i:. i:.•(~>C1\ ~J'J.'l1.:J c.c1.r.hc:r::~ 5.~~ .1.c·i'.dc:d in~-.o i·<gi~:li:r J5 fc.r tl": J:\Lli.s" n•i.rfinc::: tu l>r..:;:J;: up c; tcn1:i11;:J lii;c: i11:~1gC' in C(JJ'L' ir.t<i :1 !::L11<d~: nl
CJ\1:-; p:1r.1rn<'lcr lii,L Sec the Cl\JS l'ru;:,T:im Lu;_•,jc ?,J,m1;;:1.)
In t.li•.:'J.'o .-:vo.i.d gc;in~ to D!·:!:IU(-; v:lie:1H:.vcr etn error occurs :i.n a
C.:i<Ltc-d p~·og:r\\H, t.ll2 p;~c~iram:.-...~r li1<,y i::.pccify <.1n (;:n:-or retm:n,;,(~d;·c~;s \·r.i. th ccici1 S\'C.
'l'he i.H':clres~~ is pLtc·)d in the fourbyt·:~; .lL;·:;<:'.i<1'cPly <•.ft'2l. \-he: ::;vc.
Contrc1l ~)ocr.; to tlll!

t:ddrc!;s Si_».~ci f.i eel on <:•ny el.''t"or in the c<d.led program.

C:'1:C'.i'j,··n1.;c~;:pc·n:·;:ic>il

d:i..~;pl;:,c;cn~"rd~

For

o!-'

of

cr-:~;y;;,,:::ic,

til'.:!

c: ;:a.: .•;) le:

L!l
SVC
DC

Lii

1,PJ:S'l'>:'CA I
ALI! (EHf:OUT)
3, 2G ( 1)i:cJi:r~ lhi'.t th•:: i!ddrcs;; co1rntant must inclrn~e ,1 lcnqtl1 t:pccif) c:. ~" i.0 1 i ':o p:~ov,... nt alj gnrn~n:..:. by tlw a!;::;c1;,~>lcr.
In thi!;c:-:<:.·.· •.iJo, ii: the called progrilm com;::ilcta;, no:;:rn:d.ly, control
is i·(:Ll'J:JW•-1 ;:t: the! tu instruction.
If <Jay ClTOl." occ\!l'S,
contiol gov.:; to El!l~Oll'l'.
Errors mvy be ignon;d by the r;c,1n~nc2:,.
"•"- '"" , ·-· 1svcx• c1~ •I>C

AJ.11 ( ~"i· 4)

~

~
I

""'

ff"\

05/0_./69
3. ,, . l. 2-1/~1;";/'

ens I!!;cr.o.s

3. '' · 1. ;,>3 .. J,/'lhe i:<icrc daf nition:: thel: arci
Systeu ~re: ccn aincd in the file

tho Canliridse

usr:d t:)ISYSLI~

l-lo1:itor

HhCLID SY, vhicb ccaitles

isl: ,~nd isc<:JlccJ ·U:C' ~:i:::tc:.1 n;:icro 1.ihr<t:cy ..
'i'ld.E)j1:r<.n:yi cc1t.-.:'..r$ {1) C!:S L\:H'.:1:c~; t:ldci: p:oi.ck 15.i~l\ut](l.S to the C!!Sl/0
1:C'L1Lincf: nH1(/.) -~)j'ElC:il
3GO Cpci:;:;'.:irig
Sy::.:tcr; (OS)t.;;~cr.o::.;';hich hu\'C. h::rn cl1t\D~]CO
tc intcr.L~C<~
l1itb cu~;.
OnJy t}e
C!lS&acre~ aic di::.cu.s:::cu ,ill tlii:: ~cctic11.
I:•:r ;1. di.i~cuss:i.ou of tJ1c\ OS
L~ <1 c r o ;.; 1. h 5. c h a r e s u ~: F r.: i: I: c c1 , r c; f c i: · t. o s ,, c t i o u 3 u L! o 1 • 3 •'.i.' o o I:; t c::i nentho ~!}:Ot<H

a list ot the~at2s,and Jccation

Ei?c,

o~

tho uncro definitious

the co1:!:C:Dd ''UACLH L:-U:'J· SYSlllJ" r-;ay be :i:~~:uc•dat' e actu<d l'<.JCr.c dcfinili.<:n.!:, r:efoi.: to the proc\~c1ur:e

in SYS!j:CI: t:,".CUil,'lc"''j.L.:i.'1j<: oJJt

c1 cs c r i qul in St· c ti on 3 • 1 • 10.

Cl)~; nllcro~
dn~;c1:iLE:u inthit::· ~:cctic:nac'i"l p::ircr::i.lyuith
linl'.<ir:;ct "tc t!1c CMS cli!'!: <l!.1d tcr;:in:.1 hc:ru1i119 routines.
TYPE and~ Y. f 11: J~ « n d 10
1 e n. i n c; l I/ C a ll d
Ji 0 B r S 'U1 'I '!! , S l~ 'i U1.' .,.
II Dnll )' , 1; fll.3 Ul· ,CKECF, El'..~SI:'.
<rd JiU:lS
h:ad1e l/C t:otl1<J p<..!>.:1~ancnt
di{;]t.
'.i:hc'lhc

u~it

ctflintecord devices

cay tcaccess~~fro~

an asscrblct

langu,: c r,ccg~·;:l•bj c,IJ.lingth"~ OFl'Lili:'.
co;1:·:r>.1HJc n::;tin c1 c r
1, :in}: C\ gt.! -to CU S Co r: n z H 6 s in Sc ct i c t: 3 "t~ 1.,. ~ • uc:::p.l<ij.ncd

4~ y P 11; ~ " c i: o s e c: c h f; c tt:q: a r a r a r\ c t c r l i r~ t
in 1 i JI c
and i~ !l UC a (!;!'.)
SU f( J.:\' iscr C<:lL
For di.sh I/0 v
the {:i:1 HllHl t<n:li.si: i$ ECt up in i.l ccnEtilld ai.:c<: 11}' t};:2 I'CB (File Ccntl:oJ. lJ)OC.!c)r; a Cr C 1 it n d t h c 11.:. b C l 0 f t ); cl t
I· il c.; ;; Ci S U f. C 0 iJ S <l !J i.1 J:;:, r• t:: t <~ r. 0 f. th 0
I< !: c u cr
11[ D u 1' ~s J: 'i' u p Cl ll a s 'H '£ E rn c i: c ;; 1' l1 i. ch is s u e c 1! s s ~· ci ll ~. i:: r u rJ; t ion E f cc l .i '' :; il <J 0 • · I f<:: n <: :'. j_ s ~: :i :1 y f i Jn
i ::: tot c r e ;2 cJ. ,S'i.'!1'.LE
and SE'Jt:pf;lJEt be:(:'.);;1CUV~dbe:~crc tiiofiu.;t Rr:l!Uf,
toinit:i.i1l:'.:.:c the fJu.:t l'ilc Ccntr.ol Blee!;. l'igu;.:(1 3.-Ll.1~2-J, U1C1!:_; ;:_· i h c '.I y Ii' E a n dItyric~lsegucn~cofc~crcsf cr

writing and tendingdis~

fiJcs.

l!.fl£.E1a • 'l h t'l 'i P E j: n d 'l 'i P 11; t~ ll c r cs
g c,. <:; r:<1 t r: r n r a D c t. c r 1 i s t. s in 1 in G
hith c~~cutirg ccdc.
If cithc£ cccro i~ tobe used repeatedly,
it r. il 'J b C
is::;uc Ct!!::!

C~S

k! Cr C E ff i C i Ol t t C
s11c~s t:o CJll th<:Cct::ands

a:~d

.SC t
ll f 1~[Ol!U_nc~-;

Hclit.ir:e:: i;ndcr Section:: ill g l C

pal: il !:! Ct!: J.
l:i.s t 1' n ddfrectly. 'See
Linl:LigC to
3.~. L1.

t. CH~ clcsc~ user files c rrogcilrr cc~rlctiou. A usac uny havo
If it "is necessary to usec n ). y f3 : f i J c s c e 1:
a 1. a 11 y g \CD tiua.
clc~0 scuo
rrci:e tp'1n [If lcs, tlu: £ni s ~0crc· nay tc issuetl toCH~ n<:c:r.os il.i.scur,;.~;ed in tl:is_filr:s purin<J ~ cg1:;11 1 ('~'~cul: en .. 'lhc
Eccticn arA li8ted

belc~

in alr.hatctica) cruero·"""'
05/0l/G9
3.4.1.?.-2

J1 .<~>.LF;.9.n£.0!':.J.£f;.£.r:".SiJ9Q
3.L!. L,2-9

FlllIS

3.l!..'i.2-H
3.'~~ 1.2-14
3 .. 4.L2-4
3 .. ti .. 1 ~ 2 - 13
3.,4.1u2-21
3 .. t~ .. L 2-7
3q11.1 .. 2--·6

C!\llG c
CtlSIH!GEli ASE
l'CB
lCOE\'

m;D Ul!
Sf:~: UP
S'.U\'IE
THB'.l'HH
hf-BUI:

3 ~ /J o 1 .. 2 5•e

3" Ii., 1 • 2- ·j IJ
3. I!., 1 .. 2- i (3.4·.1 .. 2-1c/-:/J'-;/
J36

,,...

~"""'
OJ-22-68

3.4.1.2-3

3.3"101-22-68
3. 4. 1. 2-4

CI\1S MACROS.--------·-·
3,;:(-;..,. .. _·--~-

337

FCB

._./

PCB

IFIOUE
SOUl~CE

STMT

ST/\TrnrnTOE

Purpor.~l !'l[Ci IN
2
3
4

CS ['CT

f3ALH

12,0
USING -~, 12

Es T Af3 L IS I! AD DREs s A[3 I L I Ty

5

STATE SllJPUT,ERRl
SLTUP IHPUTINITIALIZE INPUT

915 ·RD
20

25
2G EOF
29
30

31

DOtl~

rnrn

45 ERRET
ti G
4 7 ERR2

rr-u rn trnGrnnEr.r:DG2 ER R3

TYPE

'EJlfWR REAf)ltJG 1

7G[~

rnru::r77 I 14 PUT
g5 OUTrUT

FC !1
FC'.1

DS

nm

(filen1:1mc, filetype) specif'y the nume nnd type of the file.
Mode !'5 ir; aGsumed.
i~i the la!)el of the input or output
area in tlrn program.

().)~CaI< r: 1 i.r 2 , nc L ) , ri ur r: 1
CL80
11[(. f rJ"'CL8 1 RD!'lUF 1

r=CL.8' 1·1rrnur-'

new copy the id0ntifiers FILE2 DCL PS.

STl,'l'E D.nu SETUP r:i.:lcro:;;.:11~2c:-:cutc<l for the cxlsting fileini tinli ze the Fi le Cont:col Block.

The

ncfol~e: the PCB co.n be rn:;cd fe>r inpu~: f:i.J.cn, the S'l'l\'I'E ;;1.nd SBTUP
macros must be ci:ccut(~d.
No initiali.zntion is ncedsd for output

files which .:u·c beinsr created.

to'rhcsc ure not nE)eck<l forthe output file, since it is heing created. The progrnm thenalternntcs reading and writing records, until the RDBUF at
Stater,"~nt 15 return~; th(.: end-of-file en:o1· code.
Control thengoc:; to the CKEOF rd:. sti:\tc1.<.:!.llt /.G, uhich tests '·1hcther cnc1-of-fil
or som8 othe~ error has occur1~d.
If it is end-of-file, th~error rqturn register is cleared, and control returned to
CMS viu Register l~. If an error occurs, an appropriate response
is typed out, and a vale2 is pl<t·cc·d in HcgLs.t.c:1: :15 Lo inclicat.ci
to CMS that an error condition exists.
In any case, CMS
clo!JcS both fi l<·B Hhcn tlil' pro:'.ra111 is cornpletl'd,'-CJ-~A File Control Block is needed for each dist file referenced ina pxogram. 'l'he label assigned to the FCJ3 macro serves as apnrametcr of the SETUP, RDDUF, and WRBUF m;±cron, and the FCB labelwith an "S" pref.i>:•::d is a p.:n:an;ctcr of the S'l'Ni.'E macro.

=F 1 12 1th~ia o .. ototumcnt label of seven or fewer
characters.

label

er- I L [' 1, [) cL) B'U Fr-i

Figure :3. ·!. -1. 2-,\, lm c'~an1plc of Cl~S I/O rnncros in an ns•scmhJ.r.v,
langungc program. Thia program copica the file FILEl DCL PS,

and n~signsr-i;~;i~--;~~-~-~~~i~~;;;~-;ii;~;;;~:;;;;-1~------~------L---------------------------JI

C f~!:OF ERR3
REALLY EOF?
SI(
15, 15
YES, CLEAR rnrwr~ RETURN.
!JR111• nE T LI W·l T 0 Ct 1S •lYflf:.
'FILE NOT FOUND'
Lfl
15, 1
INDICflTE ERROR RETURN.
!)
DO:I E
1
TYPF
urnor~ t·JP 1T1 tJG'

fj 1

113 BUHl
114
115
116
117

Forr~i;;:_

FILE CONTROL BLOCK

rrnsur ltlPLJT,EfH~OR::EOF READ /\ RECORD,
irn !3lff OUTPUT ,ERROH,,,ERR2\·HU TE SAMEnRD
REPEAT TO END.

Tho PCD macro generates a CMS File Control Block, which serves
as u pnramctcr list>naming and describing disk files for the
CMS I/O routines.

I

Included in the parameter list genc~ated by FCB io an «item number"field.
'l'hi£ spc-:cifies wh ch record of the f1lc is being rcfcr.cnccd.
If not chnn9cd, records w ll be rend sequcnti~lly from first to
last, and written sequent ally in order.

Rccor<la area<l~edtothe end of cx:i..:::ting f:i.lcs. Bow<::vcr, if a number is specified
in the i tern nurnbt.>r fie:Ld, the itnu· r.:pccified is read or \1ri ttcn.
'l'hc field is a half worcJ at LABEL+2G, where "Lll.rmr," is the
J!CD stat.cme11t: lnfw1.

Exariplcr-'...:_

a.
INPUT
FCB
( INFILE, DA'.l'A) , BUFF
Exp?nsion of this macro generates a parameter list referencing
lNFILE DATA PS. Before a RDBUF macro can use this FCB for~nput, the following sequence must be executed:
SThTE SINPUT,ERROR
SE'.l'Ul" INPUT

No initialization voul~ be ncc<lad for output. Data will be read
into the nrca labelled BUFF, unlesa a different area is specified
Hi th 1mnur.

01-22-68 .
3.4.1.2-5..

~~~f'E 3_)~{y;;701-22-68
9,.., (
3. 4. 1. 2-6 ,,..) '/SETUP

S'l'l.TE
P\1-:_~2__?_.:_SETUP

Tho STA'i'E macro provide::; lit1Jrngc to a cr~s routine \·1hi ch searched
the user's pc·nrnrncnt disk din:ctory for a sptcificd file.

Purpooc:
Sr~TUPini tializcs the FCB with inl:orrM'.1tion from the user' a permanent
file directory.

Fo.cmat:_I,---------.-------------------------~[label] ' STl,TE ' Sfcblnbcl ,error I

Format:1---------L-------~-----------------~
label

is an optionnl statcrn0nt label.

Sfcblnb~lis the label of th6 FCD being referenced,
with an "S" prefixed to it.

error

is thel~bclt"-------:."i---------:------: la be 1of a routine to handle an'error return.

Us~g_~:_

should be c><:ccutcd before any exicting file~ :i.s t·ofercnced
for input or output. STATE places the directory 2ddros~ of thespecified file in the FCB. From this entry, SE'i'UP will initialize
the FCB.

STT1.TE

If the file specified is net f6und in the user's file directory,
control at the point specified by t:hc zccond pnrar1\etcl"

S'l'NIE returns;

SE'tUP: fcb:------------------------·
label

is an optional Gtatcm2nt label.

fcb

is the label of the FCB to be initialized.

E._sac;:r.::_:_
SE'l'UP is executed folJ.oHing S'I'l\.'l'E to initJ.alizr~ the FCB. Tir;cor<llength and racord format (fixed or varicble length) are filled in.
SE'I'U'"' r;Jwuld not be c~•~8c:utcd if S'l'.i'.'l'E r·~turns \·li th an error codein I~gistor 15, indicating the filn was not found in the directory.
~ ~i~.!'.~? l c_.:..

a.
SETUP Al7
This initializes the F'ilc Coatrol Dlock which lms been generated by the macro:
Al 7

~~~~

FCB

(NAME,TYPE) ,BUFFER

STATE is not needed for files which are being created.
~:!:!:·::Pka.
ENTER STATE Sl\17 ,EHI~OU'J'
This will cau$C a cc<u:ch of the pcrm~rncnt file directory for the filedescribed by the Ft:B r.1~c1~0 who.ne Label is Al 7. If it is fonnd,
the address will be filled in the FCD, if not control will go to
ERROUT.

~- ,~1; ;;;:::us:

l"

·ft

~·

·1

.,.

q¥

#iQ#P••.!!114 ,i"QL. ~'"lfll!lll,....ill'llllllllillll'9

"""
01-22-68
3. 4.1. 2-7~~-l~lJF
3. 5' '1

~

~

.;

3f1

J/o

0·1-22-68
3.4.1.2- 8

RDBll_F . ;;;,;!/---,- ./71!

------------------------------------------------------~-~Code.
· Me <ming/·'. IRDDUF.

:--·~----------···---.~: ~-~---~~-;~;~;;---··-----------7--~--

P u_EF9.~~-.!.

RDDUP is used to re<.td a record from a disk file.

I

1

1

2

I

lmffer n:r.en not in core1t

d-4 sk e1::cor

3
4!'. ~EE:.a.t:----:. file type not found; i';,1 r-..N!.~ °¥t"1""1"\1'11':1o.. ,"'\,-f-- ..... .n.Y

'

5
6
7

~--~---k-----------------------------------------: (lnbcJ]: RD3Ur: fcb [!AHJ.::J,:oaJ C;.bcJ] [,ERROR:::efabeJJl------------------------------------------------~
statcm~nt

8

lab0l

ic an optional

fcb

in tlic J;1bnl of tl;e FC:3 naming the filelabel.

11

12

13

to be rc.:«d.

alabcl

item)

9
10

is tho lnbcl of an input buffer.
omitted, the n:t:ca

sp;c~ci fi.ed

If

Figure 3. '1. 1. 2-13.

in the FCB

is used.
elabclis thu entr/of an error-handling routine.
If owitte<l, errors (inclw~inq end-of-file)
are igno~ca.
-~~:1('..!~:..

a.

HEJ\DA
NEX'r______ ___ _e>:1;cut~c1.

HDUUF'

D,;
tJ~Cl<'f!:

RDBUF returri5 one i l~m each tirn~ it if; C-!xecute.d. 'I'he j tern returnedis spc~ci fied by Uw i tern 1rnl'.;b<~~- field of tlio Pih:· Control Dlock
at FC1H2fi. 'l'his nu~1.bcr is i ncrcnY.:n tcd each tirnc RDBUF j_::;:X:t. m,~y be nc:t to nny

to files.

v.~lue,allrn·ring direct ncc..:!SS·'l'hc filo reacl may hove c5. th..::r fi}:ed or variable, length records, but
the: buffer rta11\2d .l'-.I~EA"' rnust be J.<0:-90 enougl1 for the longest
record in lh·J file.
The buffer n:rnL:d \l.i.th HOBUP will overridethat spccifted in FCD, if it is differoGl.

RDBUP error
register 15.

£01•'

CI~EOP

nuP

ns

INFIL

FCD

Ass1.i1.d ng t.11:-,tHEJi.DAERHEAD,DATA) 1 DUF

theirnr 1p rM1c1:0 wan preccc1cd by

S'l'J\'l'E

a SE'l'UP ID?IL, th:i.r~ scqnence reads r.ncccssive

s INF'Ir.. andfrom thefile E~lPR onTA PS
Items ore placed in BUF, and c trol returned
at NEXT. When en -of-file is reached, control goen o EO!", where
CKEOF chcch:LJ for n 12 in

J'C<JiSb'!l'.'.'

15.

register 15, control will wi· to ERREAD.

If cll)Y otherluc is in

Fuell time Jtl)B!ll: is c.:.·,,·,·11tc·d, it links via a l:l\1S SVC i11sln11:.ti"11 tu a ru11ti11c
whi, h \'.ill rctu1!n c1mtr11l \\"hen tile n.>L:onl rc·qucstcd l1~1s ]l,·<·11 rl'.Jcl in. H noc1T11r has Ch.'.t'll~Tl'd, rq;i:;t1.•r 15 is sl't Ln ze1·0 011 rvt:1trn. Ir :111 crnit-, or e11dof-f1k, oc1.·11rs; l'L'gistu 1;:; \\'ill contain a code.: indicaLi11i; t.lw t.ypv of error. See
Figtll'L' 3. ·I. 1. 2~-ll fo,· LI li~;t of IU)lllJlo' error returns. Ir tlil' rmEOR== w:1s supplied,
cu11trol goc·s to'tli:1l point ,,n ~111 error. Ir no Ldivl was supplied, control n.:lurns
illili1L.cliatLly ft11!11.'.l!l;~ 1\l)J;l'l .. , n:g<ird\css or l'rr .. r. Noli..: tli:lt c·n~l-of-filc isalways C(in:.;ich:rcd an ern.r. An error lw11dling routine LJllot1ld s1art with tile
CKE()F 111~1l:ro,, l1J rJ<.:Lcd end· of-file.

,'01-22--oS:3. ·!."I. 2- 10
v: JZBUF ~,;/,-~ /"')
J:

01-22~68

3.4.1.2-9
CKEOF

(..-

_5f;...

--------- JjJ.·•\'IHDUF

CKEOF

Pnrpo1;c::_~1rposc.:._'rhe WHBUF milcro is used to create, update, or exp1"i11d disk files.

The CKEOF macro checks the return code from RDBUF for theend-of-file indication. Any other value is considered nn error.

Format:-----Format:-----r------------7-------------------------------=~
1 [label]
WHDUi:' 1 fcb GhnEA""ul<tbel] Gr::rrnon,=elDbelj 1
L_:. _____ ------l----------------_:-.__ .:. ____________ :~------~-------------.

: label; CKEOF 'er label 1

L-----------~-------~
label

is a statement label.

erlabelspecifies an error-handling routine.

label

is an optioncil statement lahel.

fch

is a label r.efcrencing the FCB
describing the oJtput file.

alahr~lis the label of an area from which
d3ta is to be written.

£:~~-

The label of the CKEOF macro is non11ally the ERROH~" pc-1rametet·of the RDilUF macro. CKEOF checks fo;: a value of 12 in register
15, indicating end-of-file. If any other value is present (includingzero), CKEOF branches to the specified error routine.

RDBUF J\17,ERROR=DONE

TYPE'ERrmn READING Al 7'BR

14£!?.a~{~.'...

•rlJc

CKEOF ERRR

J\Rr.:A~=

the FCB.

CONT
ERRR

routine.

,.,{l.JllF' normally is used to ci:;:)atc a ncH seqrn~ntial file, orto adrl to the end of an cx:istiw1 file.
l!o, . •,;v,~r, <1ny recordof an cxistinq fix0d-lenqth re.:: cord file nay b(~ rep) acer~ by
a<ljus ting t!ic i tern nur.~bcr· f i c l(J at FClH2G.

~~ample:DONE

is the label of an error-handlingclabclpnrarnctc:c r:wy be omi ttcd with WHBUF if spo.cifi_cd inIf specified in both places, WP.nm~ takc~s precedence.

Control is normally rctu1:rt<~d with rcriistcr Ei set to zero,
indicating error-free completion. If an er7or occurs, register
15 will cont.·1in a c0dc indi_catinq the nat-.1_,;.:0 of the err.or,
uncl control will b·.~ rcturiwd wherever speci ficcJ by the ERROR=This sequence of inEtructions gives control to CKEOF ~~cncnvcr
register 15 is non-zero on return from RDBUF. If the error
return indicates end-of-file, execution continues with CONT.
If soma other error has occurr~d, CKEOF branches to ERRR,
where a response is typed, and control returned to CMS. Notethat the value in register 15 will be typed by CNS only if
it is saved ~~d restored around the TYPE mucro. If this is done
register 15 will be displayed in the error completion response:E(nnnnn); T=n.nn

parnmctcr. If no ERROR= is included, errors arc ignored.
Sec Figure :l. -l. i. 2-C for a list of wrmtJF error returns.
~~~];c:._:_

a.

\•m.nur l\.17 ,ll.nE1\ 0 =I'I'E!·l,FHi":(m=QUIT
QUIT
'ITEM

BH
DS

H
CL80
(DlTH,,TJ31l) ,BUFFl

Al 7
FCB
This sequcnc~c writes succc:~~-.ivc items into INTR JBll PS.
On
any error, control goes to QUIT, which returns to CMS. The error,de will be print~d in the CMS error completion response.

,.
~ . .Mii!i Qi@iij.iji1

Li 41.#l;;5414..j,.Ji#L

..i

~1·

~

"l fPif~iijij,.,;44!LJ,~~Jiij4f'iiiiji¥~·""1'*i@mM!f4;:.w;,,wuw:;1MJIJi . UiJ4iUCil41LW .ua:::: SQJ.J.U 1JWWW4U .. i ij a.......

'" J

UL" """; ij#.#ii»Wi¥+'h 4 Jij'-i'' "" ""-·'r·~.

.
~SUll~,SE$. 11.JIUIJ . - !.._#$EU'" "'"""i'"r~,,'lfff~!l!I~·"""""""''!l'""'"r~"f'P'IF"'f6-15-70
3. 4.1. 2-8

RDBUF

(
Code

i
I
I

Meaning- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - · III
I
no errorI
I
file type not foundIfbuffer area not in coreI
I
disk error
II
illegal mode letter
I
I
item nwllber is 0II
no core available
I
I
file not in correct format
buffer too small (truncated i ten}J
file open for writingII
incorrect number of items
II
end-of-fileIImode number invalid
J

0
1
2
3
4

5
6
7
8
9

11

12
13

Figure 3.4.1.2-B.

(_

RDBUF error return codes.
register 15.

Returned in

Exa..mple:,
a.

READA
NEXT

RDBUF INFIL, AREA=BUF, ERROR=EOF

EOF

B
C¥EOF

BUF
INF ILDSFCBREAD A
ERRE~..D

CLSO(ELIPR, DATA), BUF

Assuming that the RDBUF macro was preceded by a STATE SINFIL anda SETUP INFIL, this sequence reads succ~ssive items
thefile ELIPR DATA PS.
Items are placed in BUF, and control returned
at NEXT. When end-of-file is reached, control goes to EOF, where
CKEOF checks for a 12 in register 15. If any other value is inregister 15, control·will go to ERREAD.

6-15-70
3.4.1.2-11
WRBUF

I --------------------------------------------------------------~I1
CodeMeaning
1
I
I--------------------------------------------------------------~

0

1
2
3
4
5

6
7
8
9

(

11
12
13
14
15
16
17
18
19
Figure 3.4.1.2-C.

(

no errors
filename missing
buff er area not in coredisk error
illegal mode letter
illegal mode number
no core available
skipping variable item
length not specified
file open for reading
fixed or variable not set
mode SY illegal
disk is full
read-only file
item wrong length
F-V cha.nged
65K length limit on item
no. items more than 1 for V-f ormat
no. items equal zero
WRBUF return codes.

Returned in register 15.

fl"\.

~

01-22-68
f'.4.1.2-11
WRJHJF ~'> 1/.,/'""'
j /Jjr"f;
01-22-68---- -·-- '· /j

3.4.

:·:-12,Jl-·
.}p

ER~~~

I

----------------,
1

r coc}c·--------~-----

:

0

l1

1

:
:
I

I
:
l

:

-------------------~

l

I1

core

2
3

:

ERi\SE!~~1_i:p_ci_:_:c:_:

11!C ERASE macro provides linkage to the ERASE command, which will cn1se thespecified file from the user's penn:~nent disk.

5

4

II

G

:

,- - - - - - - - - - - - ~· ... - ,- - ~ - - ·- - ... - - ,,. i - - - - - - - - .... - .... •1

7
8
9

:

:

I

[Jal ,cl]

I

:

11
I 17.
i

I

I

n1oc1,~ SY ilJC'~;u.l: ucu~:i:: i~:

1 11;

rei1ci···only file
i t.:,;H 11rc.mg lcnsrth

: 15

l )G
1 17
I ln

fn] 1

F-V changed.

GS!( lcnqth li.rnit on itcu
'no. itc1:,'; n1o:~e t1icu-1 i ror v-'ror.rnat
no. itc:a~; ccp:al ;-:e;_·o: 19--i ...- - - - - - - - - - - ..~ .,,. -Figure 3. 4. 1. 2~c.

:I

FJZJ\SE

:I

fc:).,. _______

,,.l:

I

•

: 10

- - - - - .... -Fornwt:-- -_,.. _ _..._ --·· -.. ~-·-- ----~~ .. -1-:rrnuF re turn co'. es.
115.

---- ---·---- --- -r~·Jtui..·rH.)clin register

I
I
I
l
I

I
l

label

:i.s an optional statement label.

fcb

is tllc Jubcl of the~ FCH wliieh identifies the file
to !.Jc cra~1ccl.

.!d~E'.t:E~'lhc El~ASE macro alh>ws tlie user to er;:isc ::rny file on hi_s permanent disk which
1i~1s <i filcmodc~ of P5.

I

Notes:[1.

To en1se a dic;J, file wllicb bns ;_: fik1r1ock: C>Lhcr th.'.ln I'.:-., tlh: user nwy set
lip D pan1mct.cJ: lisL and call the: rrn.1\SF comrn::iur.1 dircd]y, as expi£•incd
under IJ~1l~:_1g_1:_~_~_<:~~~-~.~:91_12_!.~'.'..!.!'i:'! in Sccti<.rn 3.4.1. i.

~a_!ll)?~~:t.

EHASE INPUT
The pcrnwncnt clisk file iclcnliLctl by the FCB labckd H<!TUT would be erasccl.
Fo:r ex,1n1plc, if the m<1c1:0
INPUT
FC:J
(INFILE, DAT1\),
IllJFFlwd been iss1!ccl, file INFILE DATA 1'5 would be erased.

/1,/,1.'.!/01-22 ·68

3.4.1. 2-1.3/t
Flt_i~

.}//

u· b
") /

01-22-68
3 ..1. 1. 2-11

TYPE

Ffr,J;TYPE
l~ 1 q;~~:':E.'.
'111C PfNIS macro provid<,s linbgc to the FlN1'3 cornmaml,~}~~.!..

which will close thesp~ecificd user file, ck<iring its entry from the active file table.

TYPE generates a parameter list and issuas
call to type: a line of b!rminal output.

Fl·rmrtt:- - - - - _[_1_0~1-c.~J- - - --r;I~~-"T-

CMS supervisor!:.£~~-f-:i;------:,----- -·:-----}--··-----·-····-- ------,

I-------------- ---~------------------

l~abeJ] !TYPL:~l'm"'::;s.:i.q.::·~f,r>lallc]

is an option<tl swtemcmt Libel.

fcb

is tbc Jnbe:l 11£ the FCB iwmi.ng the file to be dosed.

lIl ms g 1abe1 , n

1

1

1 .

}} l
· I

L1enr;th1

L------L----L---~----------------'~.~1~11~~:_:_'l11e f"INlS macro will close the permanent: dis!; file id::::1:tificcl by the FCi3 whoselabel is giv:·i; :;;:: an op~:cancl of the: m:icro. Sine(· CMS <il1ows only 8 fil~s to beori;,u at om.: ti;~,,,, tlli<; rnacro must be issuc:d wlK!ncvcr it is n~ccsso.1ry to ~cccss
mo.n.' L!Jan 8 files iu a single u:;cr pro;~r::1m.
Note:
The C:i\1S clo.:;c~; files m1tom::itically ni: prc>1~ram completion. It is only ncccssnry
to use th.:.' FJNJS m<icro, tl1(:r('forc, wh::n nlle prG,jl:<.lm accesses more than 8 files.

!~~".._~T£iJ~.£:a.

alabc:>lis an opti.o:~al s tutCrii2nt label.

'rness.:1gc:'

is the:rn::;glabcl

is the label of an a1-..:::a \1~w1e thn
rncnsH9c to be typc;cl is loci"l.tcd.

(r)

is a rogi~ter. co;1t:<lilling the lengthof th<-! 1i1c~~•~.<;g~ arcn.

I)i.~ a !>elf-dcfin.in(J t'C!r1a qiving theJ.cngth of the 1:\c.s::;aqc un:a.

lengthFli'~ISINPUT
Tnc p.::'rm::rncnt disk file idcntiiicd by the PCB la!Jclcd INPUT would be closed.
For cxa1nplc, if the m:1cro
INPUT FC:B (INFILE, DA TA),
DUFF

mcnsu.~cto be typ.::1.

is the label of n full or half wordconctant conto:ini11g Uit• length of therr•?.ssagc area.

~1£':.2..•

had been issued, file INrILH DATA PS would be closed.

'J'hc rna:d1.n1rn r:~e::ssngt; ·lc1v1th is 130 churo.ctcrs.
If the ac_Lual
mcss~gc i~ specified in single quota marks 0ith tho mncro,
t11c lcrHJth p<.tra111c~cr is not used.
If the L·11..i~1 of ;;,n output
an.:d is specifiGd inste<icl of the mc-ssago i b;2J.f, UH~ long th
must bC' incluckd.
Lcnc1tli •nay be specified as a S('lf-dcfining
term (a dcc:irnal nu:;1bcr or .rn equated symbol}, or a~; the la~_..clof .:t fulJ or hnlf \Jorcl con::itant, cont<:iining the l<!WJth.
Iflcnqth wi 11 not be known uati 1 ex0cution tirne, a r.,cristc:...· containing
tlw length may bu specif led in p<:irc;nthesc:;.

'11111.

1

a::::;. :.a . Ia1. ;:::u:;:;4;:41;w as. ¥CU a:ca2

~

~

~

:e

:..

z: t:

ss :

"* s ;44 up : ,:t; #J!IU: " IL .. i .I ,.e : :I : a ze; Cf
2'

1. .:: "J#MihMM ;41;w11ea;;; ;1i1¥1a;;;1M#4.11::.::::;:uu;.

~

fl"'

~

y--·
01-22-68
3.4.1.2-15

TY~

l

3fY

19

TYPIN ,.,-->11

TY PIN£E..ry.s~~.:..

Notes:

a. Issuing a TYl'J,: macro which specifics the message to be typed in single
quotes is equiv:iknt to issuing a CMSTYPE macro specifying the samemessage.

b. Tho GEN macrn is included in SYSLIB MACLIB for use by the TYPE macro,and is not meaningful for use in a user program.

Examples:.,a.

01-22-68
3.4.1.2-16

ERRl'l'YPIN reads a line of input from the terminal.

Formct:--·-~-------------r----------------------,l [labeJJ : TYPIN •area[, :Lc'!:1gtl!:} [ ,EDnc). :-------~------~---~------------------label

is an optional statement label.

area

is the label of a 130-charactcr input
b·J.ffer.

length •is ;.in optit<'n.:11 lcb::.:1 to be assi,:-;ned

TYPE 'ERROR WHILE READING'

The m~nna"ge ERROR H!IILI:: REl\DING is typedout at t:he terminal.

w a three-byte field of the parameter
list where the n'l.u~.bcr of charactersroad is placed.

TYPE MSG,LTH

b.

C'EXECUTION BEGINS ••• •*-MSG
The mesange EXECU~]ON DEGINS ••• io typed out.
MSG

DC

LTI!

EQU

is a one-character code specifying theediting of the input line to oe performedby CMS before returning control.
If omitted,
r is assumed.

.c

Edi tin~: Cod!?.S£v

interpret delete characters, tr:11rs'!.rc toupper case, pad with blanks to 130
drnractcrs.
5. nterprct delete characters, t1-.anslatc
upper case.

t'.>

s

interpret delete characters, pad withblanks to 130 characters.

Tinterpret delete characters.

x

ao not edit the line.

Una9'2.2_

TYPIN generates a parameter list and issues a CMS supervisor
call to re<:id in a line from the terminal. The input area
specified must be 130 chan.1.cters long. The number of characters
read is filled into a three-byte area in the parameter list.
This irnrribcr may be accessed by spGcifying Cl. l<::bcJ. as E:!he second
par<meh~r of Cic macro.
This numb~r is always the number ofcharactcrD rc~a, \~tether the record has been podded to 130
characters with blc.nks or not.

01-22-68
3.4.1. 2-17~

01-22-68
3.4. i. 2-18
CMSREG J

fx:;/----JS!

3SO
C.

itEG

111c. ED== parameter ahows the user to select which of the Clvrs editing functions

arc to be performed on the line. TI1e delete characters (@and¢) have theirnormal C!'v1S meaning if U, V, S, or Tis specified. Alphabetic cir.ta is translated
to upper case if U or V is specified. The buffer area follO\ving the charact-crs
read will be set to blanks (hex '40') if U or S is specified. The X option returns
the line exactly as it was typed. U is tlic default option.

~-~.~£:'l1lc CMSREG macro-instruction equates symbolic names to general purpose
registers anci floating point registers.
Form~~-----

Not,;:Ia.

The "number of bytes read" field is in the low-order three bytes of a full
word. For example, if the label specified is LAD, the number may be obtainedby a LOAD HALF instruction from LAB + 1.

ExD!!!l~~_:a.

RD
TY PIN BUFF 1, LNG TH
NEXT Lll
2, LNGTH+1
BUF"F1 DSI

CMS REG---------------------

Usage:The CMSREG mac..ro-instruction equates the followin~ symbolic names to thecorresponding general purpose and floating point registers. 1l1is allows the
symbolic names to be used in place of the register designations.
General Purpose Rcgif;tcrs

RO

CL130

R1
R2
R3

1l1is sequence reads a line: from the terminal into J3UFF1. Since no ED= option
is specified, U is assumed. Ddetc ch::iractca·s will be interpreted (and thelength G.djustcd), lower case letters will be tJ.':::.n:-;latcd to upper case, and thebuffer behind the line will be set to blanks before control is returned at NEXT.
TI1e LH instruction places the number of characters read into Register 2.
b.

GET

TY PIN B, .ED=X

n

DS

R4
RS

R6
R7
RS

R9
R10
RH
R12
R13
R14
R15

33F

1l1is m~cro rc::ids a terminal line into B. The X option means no editing will be
pcrforrn~cl on the line.

EQU
EQU
EQU
EQU
EQU
EQU
EQU
EQU
EQU
EQU
EQU

0

2
3
4
5
6
7
8
9
10

EQU

11

EQU
EQU
EQU
EQU

12
13
14
15

Floating Point Registers

FRO

FR2
FR4

FR6

EQU
EQU
EQU
EQU

0
2

4
6

.........
_,)"'- ; lti22il!iii! iii!! 111111,'. ii# ;;m; . . l,.J. ,,JJ JU .

·~~'cau.sa.u:a: .JUSL.J .li:U2$.MC ..J¥.WJJU .IQ it. oa: 1!A ¥IZ2 .. $.kl .'ii$!$$. £2$4 .

!¥4 .'

I;szuq· '!!'f''""''""' .. #ijf# .

..

*'"".

I ;;.

""''*"''"' i.+4

I ¥!141 ,. r;p"r™1f,.... :; "'

; •·•

~

~

01-22-68
3.4.1.2-19
CMSYSREF----·----3 ..52

Cfv1SYSREF£.l!.?JlOS.£_'.
111e CI\1SYSREF rnacro allows users to branch to routines in the C.tv1S m1clcus\vhich caunot he called by ,CMS SVC's.

,~·

?5J

01-22-68
3.4.1. 2-20

) 7.

~~,. 3'-7____>;In the expansion of CMSYSREF, DSETCLK is equated to the displacement of the
SETCLK routine in the SYSREF list. The address is loaded into register 15 for
the IlALR, and register 15 is cher;;:kcd for an error code after control returns to
SAMPROG. (SETCLK is a routine which saves the current value of the titncr for
subsequent use, as described in the CMS Program Logic Manual.)

Fonn3t:----------------·------ 'CMSYSREP

I

I
I

Usag£'._The CMS'fSJ\EF 1112cro instruction generates a series of EQU statements which
provide the ncklrcsscs of various Civ1S nucleus routines not rivailable via a supervisor C<ill, The addresses of these routi ncs arc listed in a nucleus module whose
entry J~oint is SYSREF. The name of. each nucleus routine, with a "D" prefixed
to it, iis equated to its clispluce111cnt fn1m SYSREF in the macro expansion.
Note~

a.

In .:ill progrums in which the CMSYSREF macro is called, SYSREF musthe declared in an EXTRN statement.

Example:111e fqllowi.ng example shows how to call the SETCLK function:SA}.1Pll0(7CSE CTEXTRN

SYS REF

L
L
IlALR
LTR
BNZ

5, = A (SYSREF)
15, DSETCLK (5)14, 1515, 15ERR ET

CMSYSREF...\........./

U':;;/ U.l/ O'::I

05/01/69
3 • ,, • l • 3 -·1

3. lf .1. 3-2?s·7
3.4.1.3

Not£ thilt. cnly the fct~s cf the ~bova nac~cs uhicb are ~sed ty
the cs language procesGo~s ate supfottGd uu~ec CUS.
Progcaoswhich use OS macros not listed a~ava or use unsupported foros oftl.~ above macros 11111 ncit run corrcoctly a:-i0et ens.

J:;,-/

cs t::acros'Ihe OS cacrcs that ate uied by the Caubtidgc Monitor Systea are
ccntained in tho file S~SIIE ttACLIB s1. vhich resides en the
Eystcro disk and iE called the syste~ ~ucro library. The CMS~acres arealso contained in the lihc&ry. Fer a discus~ian of
the cus nacres. xefer tc Section 3.4.1.~.

/f~- ;;::.:.dJ .S5-

follcuing OS cacrcs arc defined in ens but they do nota function as in cs.
They arc esso~tially a no-op; they
have no ~eaning in CHS and theJ return an et~oc code uhen the SVC
is issued.
· '!heferfcr~1c obtain a list of the na~es, ~izE, atd l'caticn cf the uacrodEfiniticns in SXSLIE ~ACLIB. the con~and "ilACLIE LIST SYSLID"1£a1 l:;eissued.
Tofrint cut. the macr.c definitions,. refer tc
Secticn J.1.10.
··

A'l 'LA c fl
CllKJ:'.I
D:CTACH!he cs nacres Mhich are

DHl:'lE
EX'IRAC'I

r:EQ
fUf~crtedunder CHS are as

follo~s:UC
n:rn'IlFY

SHllEBHEN!:
l:ll°Dl.

ESf

For a discussion of the C5 nacres thcaselvos, cafcc tc Inn eanual
C2B-6647, uopecation Sy~teo Suporviscr~nd
Dcta B~nagecent~actc-Iostructious~.
ro( a cesc~iptic~ cf the use· of the OS
cacrcs i~ CMS, refer tc the "CfS Prograu Logic MecuDl".

Cl'I!CK
ClCSE
DCB

r:c.ei::
I:HE'IE
DEV'IHE

FHlD
FliEHt.Ili
FREE POOL
G El
GE'IllAI!I

GETHCL
LINK

LCH
NCTE
CIB?i

POHl'I
fCS'I

l?U'I

FUTX
Rt-J fCD
liEH 'RE'IUFN
Sri VE

SPlE
Ut!E
rlAI'r
WliITE
WR!'IE
1110

W'I06
XCTl

.~:.:z

:a

-',

:;a

I"'",.,,& . ;wzc.1~

aw .., .!ii ......

£.11

,,..•

1ww.....muaa . J. .l ....LIL...at "''""',. 4 ¢..L.

a !$..

~az c 2044: qwtui4J.£W.M##iliJ.: J111:::a:::s.1:.i1a.::::a:u4w1u4aJJ::eua:a4uz:x 111s:sau:::

1111n

~

~

~

05i01/G93.·~.1.4

CBS~ucleus3, If, l, l}-J_

Routines,;-::.::ri3:'J-<.

U~/ L'J./ t>'3

3, If •• 1. 11-2

read

er write a tape record. The uEe ofcorrmands iE described under the section on CMS

the functions
cc~~ands.

as //:·~.~.f

Routines ~hi h are contained in the CHS nucleus nnd can be calledi.:ith the SVC XtCA 1 are called functions.
•rJiese r:out:i.nes serve as
the bdsic in crface hetucen proqL·arcs and the CMS nucleus.
The FLIST for the following functions are described belov:
callirg sequence fer all rcutim~s are of similar formtlt.
'Iherc arc two pai.:ts of each colling sequence; the ccdo totrunsfer ccn,trcl tc th<: CMS routine, and the pararaotcr list. Thoi 11 l i n e c c (l e n 1 \i <"- y s I: as t h c f o 11 o \T j_ n g f or r~ :

·rhe

Lfl
SVC

nc

1,FL1ST
X 1 C/1'
AL4 (Ef!R)

put address of param<:ter list l11tc GPR1tLensfcL ccnlrcl tc subroutine
addru;s of er:L·or return if cletd.t:ed
n c z:r.1 a J re t ur n

Sta~k

R e<'!d ca;:ds

CPFUNCTN

DES EU F
EH!ISE

FINlS

11(!qir:ter 15 is the only register tl1v.L is 1~odificd 11hcn control isreturned tc the calling rrcqrarr.
Upop a nor~al return, register
15 will ccntain zero.
Upon an error ret~rn, register 15 will
coutair. an integ(~t: en.or cede. 1'hc errcr codes are described inthe ~ritc-tµ of ev.ch routine.
If an error return is Rpecified,the byte rifter the> SVC i11struc:tio1J 11ill l:-e zero and t.Jw folJ.0 .•i11q
1

three lytc;.!.: .uill
l::c a1-0~;urocc1 tc ccntrd.n thn addi:e:ss of the "~n:oi:
re turn.
lf
tho eri:or
return address
is .!.·q;ecifi~d,thf' 1:on~a.1
return wi J.l be tc fourl>vtcs after tho SVC l11str11etior:otheruiso, it will bo to lhc location aftEr the SVC instruct~ou.
U. no crtcr handling i.r: to be p.::cvitlc.::cl, it is rcco1·1~!<:o~uae(1 th<:ot !JC
A!..4 (';.-4)
J;e USfH1,
otl1(!L11ise anerror 11ill ca uso
I:EDUG toheentc1cJ.
'lhc ~LIS'I ditfe.i::::; foi: (!i1r:h rontin0 anu is dcsci:i!K~o in sulJf,c:·qnent
sectior;,s fc.r, each rcuti11{!.
All
func:tionr; can be CC\lled dir:~'!ctJ.v
ns Cl~S ccmr:a.nds al'thouf]h mt1ny functi.ons rcr1uir.e a pcr:ar1ctcr list
S p e C i [ i e cll 11' h E X i1 d C: C i l" d la n d t h ll S :j h C U 1 d C ll 1 }' }; (!
C a.11 CU f J: 0 l'.I a ll
as~:en:bly language
proyra!Il. The follo11ing CilS cona,1aind.s di1.·0ct1y
ca.11 tl:e <:quiva.lcnt Ci1:; functions and ar.e dH:;;r:riJJcd under the£ t~ c t i 0 n s o n C ll s r: o mr. , a n d :::; :ALTE6, CLCSIC, ERASE, EINlS, GFNMOC, GlOBAl, LOAD, tOhtMOD,
HEUSE, USE, STA~T, $, IEEUG,
EXFC, LOGOUT,
IPL, DtIP,
LJUENC.
con:~tlunad AL'rn:, £Rt.SE, BLIP, and LINEND should be called fr.or:ian assc:mtl} language proqran as functions if it is desiLahle tc
specify a character ~hich cannGt Le tyred from a keyboard.

ri1efuncticns ST/l.'IE ancl TAPEJO ate
useful as com!nands a::;H h P n ca 11 \! d«.1 s <i f u n c l i o n , S T /\ '.f' E 1: e t u r: n s t b e
ci a ccpy cf tha file status table which can Le us0d inprocc;f;inc;.
'rlhoncallc!d a£ a functio11, 'Tl1rr,10 c<rn be

A'l'TNCl\HDF1'C 1'H CR [CCNW/\IT'£}1P.

1;e l[ u 11 c.: t j on E •

a c1

as

i.: c ::; !'fn thsru.serl to

llNDJN'I
HNDSVCLOG I:l !::K
PCI !\'I
PHlNT!ia line for terminal input
Pun ch car as

Wait for terminal I/O to finish
Issues CP-67 ccnsole functions from CHS
Clear t0rcinal input stack
Erase file (s)Close file(s)Set or clear I/O Interrupt Return Addresses
clear SVC handling addresses
Update file directory
Set Road 0c Brite pointerPrint l .i. 11 ,.

Set orTYPU ~

Ht~ua item(~;)
from disk
Query file status
Tape 1/0 handlingSet external interrupt address
Write tc terminal Mithout carriaqe return
Write to terminal eith carriaqe ~eturn

WAIT.

Wuit

W/o,I'lHRc a d t: c r:r11 in a 1

WHDUF

Write

flCBllf

S'I 11 'l E
'l'llfEJC

T lil1 P'l'Yl:' E

fo~interrupt

itE~rn(:::)

on disk3:?

05/0J/bS
3.11.l.4.2·1

05/01/69;;~~.<:?

3, 11 .1.11. l-·l

1.tJ.1.L;.1

A'I'U_ _:.1Ji.s;g·://'.;.~[>f3. LI. 1. 4. 2../.:i-f'f.ll.U.£1&:..

Hi:'F
Lr.UH

t1ie specified

80 bytes;11JliD~.L.52S-1 lJi!J.lf£:rsreCl8 1 l1'I'IN 1[C

CL4 1 order•rerea card froL·

ar:ca.

~::!Jll.!J.:.:_..5£..9..\.=QJJ!'.<il:
1?1 IS1!uncticn i:unchcs

fhQ CARDPI-:'He r.nN function stacks a line into the input buffer.

~.-:/r,f

C/l!Hl'Eor:
1:'1.15T

LIFO or FIFO

AL 1 (LI.IUPF)
AL3 (I:Uff)r:c

C 1 linc'

J:QU

~· -

rs
re

OD

routineCI8 1 Cl\Rr:Fli 1
A (tuffer}re80 byte arcn

JHfLf9.9£I2:

BUFF

f (OOCC1)

E(00002)
J: (00003)
E (00004)

1~..:!.::iS.:

End cf file
·unit Chc~c k
Unl;ncwr1

c;rrcr

Not 01wr:ational

Ille lir:e that is stack0d \! 5.11 be un~;t ;:ck e> 0 and useJ
11hen a cnl ltc w;,rrnr; is rr.ad12 tc read aline frc.1 th~ 1:ypc1·:r:iter co:1r.;ol<~.
Ary 11ur.:;;nr of lines may be stacked for subseqn0.nt t1:::c instead oft~r~inal

irput. ~hen the infut stack is empty, the keyboard uill
t0 unlocke6 to receive typewriter input.

~
'!

!::ZS

::::aw;cs.a 4. #ASUIJIH#:O:AIWJl$tili#b. ;:za;z;::.a JZ:JJitLJZ:; !JS . .put: ..: a Ai

~-

~
-

••

1#11

I"'

Jlljj

Li -

$ :.

44WA.4!144 ;:n .@Hf ""t;;,. IllI I

ii

I ,.11111!' ~ ""''~·~" ' I .,;;. . '" ,..~'1'r"""""!"'"'~ . '·'111~1! .--~~·

.~

~

fl"\

05/01/69

05/0l/69

3.4.1.4.4-1

3.lt,l.4.3-1
3.~.1.4.3

f ~j;~l,}'l6

CAliC:~D3 • 4 • 1• 4 • 4l~Y

COt\lihITj/(/hU.l§g;.iYUH.Q I

1hc CAHDkC function ieads a caid into tho BO byte area sppcifiad.
~~ UlJEL~!!ID!.Q!!f~ ~

ELIS1

rs

.1=(00001)
E(00003)
1:(00004)

w~itesto~sJJinJ_§£g~~]£~:OD

LC

ClfJIC11Rr:RI'

routinetC

A (bllff(!t)

80 hytc!H.QL!;.QQ.f!§:

E ( OOC02)

The CONWJl1 fqnction waits for all ~tackeJ reads and11 tinish 11 f tom tho consolo. ·typewriter.

HIST

area

cs

OD

tC

Cl0 1 C.:ONWA11 1
Cl4 1 CCN1'

tc.Y.EJil~:End of file
Unit check

Unknown e~ror
Not operaticnal

CONWAIT is called a~ a standatd CHS function.
•cON1• corresponds to the console typewriter.
.HI9.L.!l.S!.!H;'..ll.§ ":~one

The device. id

05/01/69
3.4.1.4.5-1

05/0l/G9

3. 4. 1. 4. 6 -1

J,'C:;!
f.4.1.4.5

3 • 11 • 1 • G I: F S B U F.A!J~~·._]t.,l_,CPFUlC'.IN

dtJ.£.Y.nrn..?£:

fy.u_:g_:rn:1hc DESDUF function clears the input buffer of stacked lines.
Jhe

crFtNCTN function transmits ·console~it~out leaving the virtual machine node.

functions

to

cP-67

~illling_..s~g~g~~e:

ELIS'.I

OD
CL8 1 tESEUF'

IS

HIST
~gJJj D.!L Se.9..Y~.Df~:

[C

tS
DC
DC
DC

OF

ThiE parameter .may be omitted
c1n•cr command strinq'·

DC

X 1 FFFHFFF 1!!EJ.9£:Cl8 1 CFFUNCT~ 1

Cl8 1 NO MSG'

Whan DfSBUF is called, all input lines rreviously
deleted, leaving an empty input buffer.

fence

stacked are!HfL!;Q.Q~3:

E (00001)

ic CP ccarrand string rresentf(00004)

lNVALID CP REQUE!1.E (CCC08)lA[ ARGUMENT£ ( UUX)

Any other error cedes are from theCP c,onsole function specified.

~,,~ "'"'

ULl .. i iiiiiiAiU;,,,,,i''·"lllll"'i"'fflll!!liiii!i,,,,¥!\!!l!i!!i!ijlijjjiMu!ii!i!!!!!!l!l#iiiW\ill!lfiiiMl!iLU.,

J$ ,,,.,;,,~"''C>m,\JIS

J; ,;;""' ·=·*'')14,;::;;;:;

1"'
m

i

\IM

I Aj "'"""""" ..

"""' ....""'"""'''"''11'+ !f'ijj, 1ijl . .111111 iiii.g .... jiiiiiiii".... IM!lfiii-W!'!!i,.. I .....!& .....•. ',,.,.,fl"\.

J •.,.1.11.1

05/0J./69
3.4.1.4.8-l

05/01/69
3. 4 .1.

•1.
,/,""'"'/

HAH{17,'/;1"'·~·

l

;~

i

J.f.

f.H!l:

3 • If • 1 • 4 • u,/f~i?~

t' l NJS

J'6s- ·
i:!!HQ.§C:

tho tRASE tunction qrases the srecified file(s).

1he FINIS function closes the specified file(s).
~!!l!..i.!!!L~£.9..YQ!l£~:!~11lB9-~~9YS~£j~

ELlS'Ire

Cl8 FINJS•
CLil'

[C

CL8'
c12 1

[C

IC

1

called rcutine
fil€narre or
filet vre ormode or *

*
*

ELlST

CL8'

[C

crn •

called rcuti nefilename or •

lC

CL2'

~ode

IC
tC

CL8'FINI:s•*filetyFe or
letter or •.HI .QL!;Q.Qf.§:!H1.t~:E (OCCOl)F i:st character of mode illegal!(00002)
E(C0004)

F le not foundD $.k error

FlNlS does not cause the directory to be Ufdated on the disk.
~!H.Lb~!l,£.§:

f,(00001)
F (00002)
E (OCC03)
E (000011)

E ( OOOOu)

invalid f ilQname
invalid filetypedisk errct
invalid mode
file net cpen.

I

05/01/69
3.4.1.4.9-2

05/01/69
3.IJ..1.4.9-1

3 • .J.1.4.9//~;:9/):);//

ll hDINT:4!1011an i11tcrrupt is received andi:;rcces~cd

control tc thA interrupt-handler as follcws:

366.fJIU.f.§g:

R<!<Jister C,1q', 3

1ho fNDINT function sets the

CHS l/O interrupt handlinq routines
tc transfer control to a qiven location fer an 1/0 device otherthan ttosE normally handled by CHS, or to clear such transfPr
requests.

11.j

15

{6/·.

hy •IOI?IT', it passes

L/•

I/C OLD PSW

csw

Device address
Return address to IGIN1
Address of interrupt-handler~h~nrroccssinq is complete, the interrupt-handler must return tolOlNT via rcqistor 14, with neqietcr 15 as fcllown:

B.!!1l!.9-.~£gJJ£.!lH:

Hl~

FLlST

OF

[(

CLU' fiNDIN'.T 1

r:c

CJ,4 1 SET 1 or <;,L4 1 CLH 1

called routine
function

A~AF/WAIT-FLAG,KEEP/CLEAR

X 1 FHFPFFF 1

means 'ANOTHER

INTE~HUPT

han~linq

EXPECTED•.

usinq 'HNDINT' are as

follo~E:

FLAG

1.

tc

D\cans •SIJCCFSSrUL HANDLING'

NcnzeroThf gcnQral rrccedurcs fer CMS I/O

NAME,NUMBER,ADDRESS,JOU EV

= 0

H15

[S

end cf list2.

'lhc pc9cam must initializE handling tc l;e done via 'HHDlllT St<_:T'.
~henl/C to the appropriate device is to be done, the system-mask(l·y •SSl1' ir1structicn) and appropriate •sro•

1t1ust tE set •OFF'

give fl•.U IQ.!_£.Q,.dg,2:
1.

E(OOCOl)Qa.
l~!:iJ;,SL.!gJ21:.Y:The IGDKV
field:

macro sets up thefollowinq information in!:.

= Symbolic device name (ist 4 letters)
NUHHEf = ttexad~cimal device address
AtDRESS : Symtr.lic addres~ cf interrurt-handlnr to bP.
invoked. If address = O, interrupts will be
iqncred when received.

=

IOIHV

immediately.
interrupt-handler cnly whenis called.

If 'ASAP' i.as spccifi0d, the.interrurt-ha11dler is invoked as soon
as the interrupt is 'fielded' ty CMS 'IOINT 1 • The
1 IOINT'
intf~rrq:t-hqndlcr returns toi.hich retur·ns to user's progral'.l.

floqram 'n(!<~ds' the interrupt tc l1avc hecn received, CMS•WAI1' function is called.
If intcrrurt has not yEt been
rccciV<:d, CMS gen; 1n 'WAI'I' statH until 'IOINT' fiC!lds ,a11r1 rrccesses tl1c intcn:upt in normal w<ty.
Wh£11

If the interrupt has Leen received tut net yet precessed (asundct: 'WAIT' crtic11 inEtead cf 1 hSl',P 1 ) I Cl1S 'WAIT'
now calls IOI NT to invoke desired interrupt- handler, thencleare needed flaqs and returns to caller.

NEWD,3F1,HYCODE,ASAP,KEFP

6.

.Y.!i.~.Jf.!:"""'

intcrru~ts.

If the interrupt ha~ been received and processed (e.g. on 'ASAP'),·~AIT' returns tc caller w]th neCDEEary intern~l flags cleared.

intarru~t-handler

KEnF/ClEAF-FLAG:~fEP = Retain intercurt-handlinq hetwee~ CMS commands.
CLEAR = ClP.ar interrupt-handlinq ~fter each
CMS command. 'CLEAR'=DEFAULT OPTION.L~-~.!!.f.l~:'SIC' is rerforrued satisfactorily, the system-rrask can be

qb. lf 1 ASAF' was net specified, 'IOINT' rEtains needed infor~ation
until CMS 1 WAI1~ functicn is called.

a 12-bytc

NAME

ASA£/~~IT-FlAG:
ASAP
In~oke~AIT = Invoke'~AIT'~hen

Eet tc allcw all

Incorrect parameter list~

When finished, using prcqraro shculd ncrrnally clear the
intcrctpt-handlinq scheme thru 1 UNOitT CLH' call
(Unlt~SE 'KEEF' opt.ion is used and the: interrupt-handler
remains intact in ccre).

~,·

""

.~

r"\

05/01/69
3.4.J..4.10

3 ., • 1.1.1. 1 c

//ff<

HHSVC

,36{~1

1.Y.U.~.§Y:~he

HNDSVC functicn initiali2es the SVC-Interrupt Handler totransfer central to a qiven location fer a spacific SVC number(other that x•cA• oc 202), er to clear such p:·cvioun handling.

OS

OF

cc

c LI! • :a: T • o c c 14 • c t R •DCfunction
AL1(SVC-numbet),AL3<urtdcess arquttent)'>C

X1 FHFHH'

ctoi~Nnsvc•

DC.

called routine

end of list

9!=
At

entry

to

a

svc-handlinq

non-CMSroutinethefollowinq

conoitions exist~
RegjfJ£I§
C-11 and 1~ as they wRrc at SVC tirnn
12address of svc~handler routine
13
addrfss cf SVC save area
14
1eturn ad~ress to SVCINrlh~

SVC save ar~a has the tollouinq format:-~Q!l.ig.n.!.§.!l.:t!f§Caller's reqisters

0-63
64-71

Floatinq-Foint registers 2,4,6*
80 tytc<. for use by SVC-i1andler

72-S!::
0ls saved~yCMSel~cwhacn.

- _Jg~:

1.

0-15

SVC-olrl-PSW

96- 17 ~•frll

2.

Indivjfual SVC-nu~ters mar be added .or clearedat different times hut should all te clearedteto~e terninaticn cf the ccnmand.

.fJlQL~.Q.Q.£.fil:r: (00001)
E (00002).1:(00003)~~!!in~_2£g~£]f~:

PL In

05/01/G'J
3.4.l.IL J.0-2

For CLF, thea~dces~fields are irrelevdnt.

Incorrect PllST
svc-numbet teflaces another of the same number
SVC-number clearing cne which wasn•t set

;j~}p

Jt-f

05/(11/69·:L 4. l. 4 .12-1

05/01/69
3. •i .1.1i. ll

3.11.1.4. lJ.

:. lj. 1. ij. 12

Ai:;/
.3//

PO JN 'I

.AJ-::w·

lCGDlSI<J7o·u,gg:

1.Y~J?g§,g !

The LCGDISK function closes all
file dircctccy onto the disk.

cren files and

The pcint function sets the read pointer and/or
at a EFecified iten nunber.

the write·~ointer

writes the~~JJ!Eg_~£g~gB~~:.~~11lD9-~~g~£~s~:

HJ.ST
FL I STDSts

Ct
CL8 1 LOGDISK 1;:1qg:'1!111!!l!!ll1!11'..,1,q...,,..,,.••1~1~11"1'l'':!l'1JlllD1!!111li~~-'ll!!1',·l!""'~~~·~It'

lH Q.L~.£.9£.§:Ncnc.
It the dicEctory cannot bcwri~ten out, the virtual machine is put
iu disabled wait state and control will te passed to CP.

1

II'

DC

Ihis routine ECts the read er write rointAr in the file status
tdble to a value provided hy the caller. Zero leaves the pointerunchanqed; a value cf all bits sets it to the last item number
rluE OOU.

iJJQ.L.tlf!JII.n§:

,,,..

Cl2 1

tc

called rcutine
filenane
filetyfa
roode or *write rointerread pointerH.t1:

lhe user fhould call LCGDiSK during the execution cf bis program
if LE wants tc cause new er mcdified files to be permanently\Littun onto the disk before the compl€tion of the proqram andth€ return to the CMS command envircnment.

llSl!iil Iii!

Cl8 1 FC1NT 1
CI.8'
CL8 1

re

Jl~H..5:

''Ill

r:c
tc
DC

E (00001)
E (CCC02)

File sp~cified dces net exis~
First character mode illeqal~·~~·'!!!"!!''!!!':!::''.'~~'!!' =""·~"!1'!'1""'~~~"""!!' '. '"""•'"!'.

''""",.,,.••.

I

I.I
'

ii

iifai

;

8i"T

1

4s;::1;1;::::::::::;

Jl!!ifi"i.J@K,!ii!iJ.li

ijt¥1•i\l~4llJllllllJl1•11~1.1..;;;:;11:•.1:

~

,II'\

..

~·

. 05/01/69.

05/01/69~

3, .. ~1.11.llf-l'".... : ~-t,t~~d'3 • •1 • l .... l 3 -1

3.fl.1.11.13

4-rt?.~~

P.l11N'!R

3;'r-~.. 11uuu:,hoFR1~1~

j.lf.1.11.14

NtHP.. .373.iJIU~HITha DDDUF function reads an ite• of 1nfotaation fro• a di~k file.

function outputs lines on a printer.

&it.Ul.!l.9-§!9.Y!!.D~.i:'~Jl.ill.:J_.S5g.Y.£.D&.§ :,tc

Cl8 1 t>UINT1P

DC

A (bufsi2)

A (buffet)

DCbuff er area

PLJST

tufter sizeIC

Cl8 •RDBUF'

[C

CL8'

tC

re

CC

.!~l~f:

t~

tC
1 •.

ex. 1 • 'dcuble sr:acc

Cl. 1 1'paq£

r.achine ccw
assellit JP.I)

J.

OP code carriaqc controls (as used by theare alsc acccfted.
If buffor s~ze

E (0000 1)
E (0000'2)
E (OCC03)'E(OOOOIJ)E(OOOO!.i)€(00007)

JU.&;L~~.Q~.§:f(COOOl)·E (1)0003)

E(COOOq)
E ( 00005)

may be •icdatt•
A (use,rarea)~ointerF'

CL2'f'
H'
F''

item nu rbr.r

tc input buffor
number of t.ytes in butter

fixed-variable flag (F or V)
number of items to read
number of bytes actually read

E..lJSj_.£!:.\!U:

Cjfi:Ct

Thu tcftcr size should not cxccod 133 bytes.
is 1, cnly the carriaqe control will occur.

a ( COC02)

filename

filetype

CL2 1.

Einqlc space

CL1'C'
1

2.

IC
lC
[C

The first ·byte cf the buffer is used for carriage control
and i~ not printed. The carriage.~ontrols ace:eta•

called routine

E (00008)
f(00010)E(00011)

Printer unit check
llleqal carriage control
Inccttuct parameter list
Not op~raticnal
Unknown printer error

E (00012)£(00013)File typa does not exist
User's remcry addreEs is not in liis usor area
Disk malfunction baE cccurrcd
First chatdctcr of mode illegal
Number of items equal 2erc
Filo not written with WRBUF the1:e.fore it.cannot l:ill read
Usar•s roomory area too small foe item
Ei~bt tiles already er.en.
Nunlbur of items qreatct than 1 foe variablelenqth file
Item number specified does not uist CEOF)
Cha[acteristic net ccrtect
·

]gt§:
•·
2.

All eicors except error 6 causE the function call to beatocted. On atrcc ccdo 8 that portion of the item that~ill fit in core is read.
Tho nunt€r of tytes·in the usor atea divided by thonumber of items must b~ constant (i.e., the sa~e lc9ical
record lEngth) f ct a fixed-length-rccoi~ file.

05/01/69

05/01/69

3,11.1.4.16···)3.4.1.11.15-1

3 • 11 • 1 • 4 • 1 6/{,,;;;;;/-3?/

3.'.l.1.4.15 S'I/l'H

STAT~~ntry for

The TAPEIO function reads cc writes a tape record, or
Fositions a tape.

functicn rccvides a cofy of the FS1 (file status table)
the file specified in the parameter list.

[C

re

FiH:TN~11Ui!!.9_.§.f.9.!l ..rn.c_~:

CW'S'l'AlE'
I
CL8'

re
[C
re

CL2 1

IC

A(*)

CL8 1 .

Cl2'

'
I

•

called routine
filename
filetype
mcde le.tter. or *unusedaddress of FST copy
returned

HlS'I

.

2.

rs
re
r:c

CLE 1 functicn'

IC

Cl4 1 Jeviceid 1

OD
CL8 1 TAPEI0 1

re·

XL1 1 mcdeset•re··Au (buffer)r:c·CCl,;N'I

H.!.!H:1.

d/t~

l!!!li~§e:~111in~_§£9!!£~'1:

El. lS'I/,.:;.-~-'fS~r.,?

f!HQsQ:.
ThE

T AP EI C

1-' 'size'[5

F

Symbolic tape addr~ss
7-track ~cde set
Huffer address
Buffer size
Number cf bytes read

Functions arC!:
PHETN will tc ~Et to the lccaticn cf a copy
cf the file status table entry desired if
the file is fcund.

BSR
FSF
iSH
HAI:
IiHIND

Mode ot • means that the first file found~ith name and type .specified will be used.
The crder cf search is ie~mancnt, tempcrary,and S)st:ro files.

FUii
lil!ITEliRITEOF
li'IM

J:UQl'.-~.Q&!iS:

E(00001)

E ( COCClt)

to l:ackspace one f i lt·

£,Sf

(fiG

File specified dcesn•t exist
First ch~racter ct mode illegal

tc t:ack:orace en(' rcccrd
to forward space onE file
to fcrward srace enc n•cci:dto read one record
tc rewind the tape tc loild point
to rewind· and unload the tapeto write etc H!CCld
to write a tape markto write a tape markto eraso a qap

Device lts are:1hF1 or TAF2 correspondinq to 180 or 181
rhe mode.set ~ode is cne tyte of the fprm:
tCHMM011 with the tollcwing interrrotaticn
DY-----~-~!A~~-~Qn§l!1_,.
ll.ll•I

<

oo

I

200

01

I

556

10
11

I

800

I

eoo

'

Mi#@itiiMMJ@QJ"'41Q,!J!liii!ijSI ifad,JS:Ui!t!S!SU2il.Li$SZSUJ Z:SU. !!AZ

.•...

~
Sl!i!i

4 I.$ WWW!$

. . ;':'~""TI ~.
'1

A

i

i

$l

II

PG'"¥" aw *f * 14*.APil'f '!! .\U,¥1#F,$ A.Jii!,.,..Nlli\.1111,, 111111, ,,,4Jp1:;111.11.,.." Jii.•H!l!..!,.!iil,lff.l!L,,i .

,.,,,..

·~~

I

05/01/69

05/01/69

3,11,1.4.16-2
J1Jj]_____________ - - - - - - - - - · - - - - - - - - - - - - - - - - · -

J

000
001

!

010
011

I

J
I
I
I

100

101
110
111

I

not used
not used
set dnn::>ity,
not usedeven parity,
set density,
set density,
set density_,·

3.4.1.4.16-3~z;t-;1;73/f.3/7

E(00002)

cdd parity, ccnvorter on, translator off!n end~of-fileccnverter off, trannlator off
even rarity, ccnverter off, translator on
odd parity, converter off, translator off

end-of-tape bas occurred.

E(00003)
A permancl_lt I/Cl

cdd parity, ccnvorter off, translator on

error has occurred while reading· or writing.

E (00004)..9.~U.9..§:An illegal symbolic device id was specified.

lhe tuncticn TAPlIO can be used to read, ~rite oc move magnetic
lf the WHITE function is used, the ~umber of bytes
indicatud will be written.
If the READ function is used,in[ormaticn will be rooved into the buffer and the nu~her of bytes
read will be stored into CGUNT. If a tape mark is read, thetuncticn ~jll coturn ~ith an error code cf 2.

f (00005)

ta~e.

A mode set of
to

~E

~sed.

x•oc• causes the default mode bit of X'B3'

2.

A mode set of X'E3' indicates density BOC, parity odd,
conveitEt oft, and translatcr cff.

3.

A mod~ of X1 93' indicateE· density 800, parity odd, converter on_
and translator off •..t~::?§i!..9.9.f.P

TAPn

NOT REAtY

YE.1'

the tape has been attached but it is not in a readystatus ~et!.
(OK -REAtY NCW)

The tape iE new in a ready ftatus for use.
j g f.L~ Cd£.§:E(00001)

INVALID 'TAPEIO READ' PARAMETER-LIST
An invalid parameter list was sp~cified for reading tape.

E(00001)

INVhLID 'TAPEIO wnr7E' PARAME7Efi-IIST
An invalid parameter list was specified fer writinq

TAPn NOT ATTACHEt
tape unit has not been attached to the virtual machine.
Fefer to S~ction 5.5.0 Tape Procedures.

~he

E (00006)

TAPEn IS FIL! FBCTECTEC •1he tape contains a f ile-Ftotect rinq, therefore the tape
can not te written upon •E(00C07)

TAPn - SERIOUS !APE E6ROR ATTEMfTING function
In unrecovecatle tap& error has cccurred vhile attemptinq
the specified function.

..!i.s;_!_gs:

1.

o~

ta~e.

"
...

.J

·05/01/69

05/01/69
3.4.1.4.18-1

3 • 4 • 1. 11 • 1 7 -1

J.q.1.IJ.17'IHF/',.:/;:;/'

J.q.1.4.18'./.;y,.-,,

TYPE/,,.,,.,.:,;/~

3/J/

d7f

!.!!US.§e:·f.Y&EQ§e:

Jhe TRAP fu~ction sets a user•s return fer an external interrupt.
1his return overrides the call to DEBUG cu an external interrupt.

1he !Y~E f ~nction types an output message en the console. Terminal
tlanks (if any) are net deleted, and no carriaqe return is added.

!~lJing_E~~_yg~£s:

PUST~~JJing_?..£.!L~£~9g:

DS

oi::

DC

CL8''UIAP 1

DC

A(trapsubr)rs
PLIS'I

khere "tra~subr" will be the location .transferred to on an externalinterrupt. .~f the parameter "trapsubr" is a zero, the return will bereset to gc to tEBUG en an external interrupt.

[C

AL 1 ( 1)
ALJ (MSG)

ICc•ccde 1

cc

[C
fQU

l'ISG
E.MSG

The user's interrupt routine should set a flag which shculd be
cxRmined ty the main lina frcgraR. After the flag is set,
this routine should return to the location specified in GPR14
on entry. All ether general reqisters can be used as desired.
main line ~rogram should periodically examine the trap flaq tc
determine ~hether an external interrurt has occurred.

CLB'TYFE'

re.YliH~:OF

IC

AL3 (EMSG-MSG)

tenainal number
address of output message
cede . B or R (see below)
message length (~n bytes)c• mcssaqe tc be tyfed without carriage return'*where the write codes are:E = move line to free storage tefore typinq.
K = type line fee~ the sfecified lccation.

The

H.!~~:. ,f;J!Q.L.E.il..YI.D§:

1.

Hcne.

The eutput message must be from 1 through 130 bytes in length.

].UQLf;Q.9£.§:E ( 00001)
E (00002)

Invalid terminal number
LEngti cf cutfut message not tetween 1 and 130 bytes

.,
~.
1
'

*1 IQ. .l

llQlll!i:U;

I .i!iJ,$1ilil,lllL.llEAii&iiidi&...•,• •ua,.::.:;:;;a:::;;,aaut1:sa.JJU.iiilUllL!iiiiLJU.,iiii 1. '"·····""'iJJ@I, 'Jilli~
J,1 .::::;:::: ,,JU~
LL! . . : .. J,. 4 !.J a::e :4:sq·;::fi,,,,'

4¥ '',.!JIU .UiLll,. :;::::pm;:;:q.. g;;;,,.,.. .: qJ; :.;:;+ ,.,.,~,..,~...•11 . '.Ill!!~~.~'~'

"'

~

~

05/01/69
3.11.1.4.19-1

J.ll.1.4.19

TYUitl~J:.:;.:-

05/01/69
3.4.1.ll.20-l.;t;q··WA JT

J • If• l o 4 • 2 0d~

JJt
l.YH.f.§g:.f.Yn.Q.se:

1he TYPLIN function tyFes an outFut line on the console. T~~minal
blanks (if Any) are deleted, and au automatic carriagE rolu1n is
add€d. ;

·

ts
IC
IC

OE
CLE 1 'IYPLIN 1
At1(1)re

ALJ (USG)

tC
IC

c•code 1. All (El!SG-MSG)

cs
IC

PLIS'lreterr.1inal numbet
address of cutput message
code B.or K (see belou)
message lenqth in bytes

IC

INTDEV

rellSG

c•actual ttessaqe to be tyred withca[riagc return added•

ECO

where the

~rite

rs

OF

c1euwuT•CL4'device id•

p•o~

F

wnece the device ids are:

,.

EHSG

I:!
I<

devices~£~JJJE~-2~.9.Y£~£~:~gJJlng_~gg,Yg~~i=.PLlST

1he WAIT function awaits an Jnterrupt from one ~f the

sp~cified

CON1, DSK1, PCH1, RDR1,
PBN1, TAP1, and TAP2~§.!!.~HU

codes are:move line to free storaqe tefore ty~ing.
type line fie? the SFecitied location.

].Q.l~.§:

When one of the specified devices causes an interrupt, the device
id will te stored in the word INTDEV and control will r~turn tothe calling program.
. JU.Q.L,Eet~I.JJ.§:

1.

Output lin~ must be 1 throuqh 130 bytes in length(unlesf byte count is O, which forces typlnq a single
carria~e return).

2.

No ditferen~iaticn is made between red-and-black-ink
typeouts.

E(00001)

Invalid device id specified.

l.H.QL!;lli:!(00001)

Inv~lid

terminal number.'.'

05/01·/69
3 .. Ll • 1 • ,, . 2 1- l

3.!l.1.l!.21

liUTR.t05/01/69
3.4.1.4.21-2
i%'/~~~~,;/('{J-~¥d~!!!.9.Lf;Q<lCl;l:3S33,>;>.;LJ'.H].QJ§e: ·E(00001)

E(00002)

Invalid terminal number• Bead-tyi:e• invalid (not u, V, s, T, or X)

The WAITBt function [eadi an input message up to 130 bytes inlength into a qiven buffer from a console and waits forcompleticn of thE inpQt ~essaqc.
~~Jjl~g-~~.Y..Y£~££:PL I STISre

OF
ClB'WAI'!RD'All (1)tc

re

AL3(INPBUP)ICC •code'IC

AL3 (*-*)

t<?r:minal number

address of 130-byte
input tufter:u, V, s, T, or X',

(see belcu)

INPBUF

I:S

130C

byte count of input
message is stored
here·

130 byte for more)
input tu ff er

An input line can be edited as fellows:
Use the •at sign' @ to delete the previous character,ot the •cent siqn' i to delete an entire line up to andincludi~g the cent fign.
Convention~

foru, V, s, T, er X are:•u• performs editing, upper-case translation and blank fillinq•v• performs editing and UFFer case translation•s• performs editin9 and blank fillinq (there is no upper case
·~·

•x•

trarslaticn)
performs editing only
leaves input line exactly as is.1.9J.u:1.

lf the user has •stacked' input commands: WAITRD will
accGpt t~a first •stacked• input messaqe, and move it·to the specified buffer.

2.

The iDFUt buffer is zerc-filled before read is
initiali2ed, and must be at least 130 bytes lonq.

~
11

.

...

~·

~

12 !foil:; 1111111, 11q:g;;s:;•:1::u4tQGI Qiij!i!A JIJ.J .1 u.APll #i&iiii£ib!214il!LSlllS!i!!li24iiii!Clli&ii!i£.IJl.J!il.L¢4111UiilliklUS:ii2Q!$11£15illi!UUUiiiii ....ii!LJIJIKl!I .MJ#I•Iu;: ;: . ::; M§f . !Iii·..

4 ;iiiII;;:::;,;. a iJ14

lllAfi fl"f1111 .. di . '~~05/01/69
3.4.1.4.22

3 • 4 • 1. 11 • 2 2 - l;..1'#.p~

UH UF

., 0

1

1
()c'.l'f·.f..U..119...§e ·:The WRBUF function writes cne item of infcrmation into the file\hose name is specified by the filename and filetype parameter~.
If the file does net exist when this function is first callea, an~w file•ill be opcnod and assigned the given na~e an~ type.
WdBUF will autcmatically fack fixed length iteus in an 000 tyte
tuffe~, and ~rite this 800 byte block onto the disk.
f!JJjn9_~!9~£~,~=

ELISl

[C

C 18 'IHIUU l' 1

tc

re

CL8'
CL8'
c I.2'

re

H'

tc
tc
tc

A(
f''
Cl2 •

IC

H'

· re

filenamefilctypE.

mcdo must be specif led
not *item number
user's tuff~r address
number of hytes
fixed-variable flag, F or V
number of items to write~' 1.k.Lf.fQ~.§:
E(00001)
E(00002)
E (00C03)
E (000011)

E(OOdOS)
E(00006)
E (COC07)
E (0000 8)
E(00009)

E(00010)E(00011)E(00012)E(00013)c: cooo11q.

E(COC15)
E(00016)£(00017)
E(0001E)
E(00019)

File name net specified
User memory address net in usEr area
I:isk n:alfuncticn
First charactGr mode illegals~ccnd character eode illeqal
Core space not available.AttcmFt to skiF ever unwritten varinblo length itcra
Number of bytes not specified
Fil€ alreddy active fer reading
Eight files already open
F-V flaq not F er V
l'iodo SY (systcra) is illegal
Disk already full
Alteropt to write on read-only file
Lrngth cf this item not same as previous
Characteristic (E-V Flag) not same as provicus
Vilriatl~ length item greater than 65K bytes
Number of items qreater than 1 for variable length fila
Number cf iterrs equal 2erolif.!~:The nurbec of tytes in the user area divided by the number of iteras
must be ccn~tant (i.e., the sacc loqical rEccrd length)for ~ fi xcd-leuqth-rccc.r:d filo.

~

~

~

~

'07-24-6 .,3.4.2-1
FORTRAN:J Ci /

~JO

3U

07-24-67

3. 4. 2-2~f!

S3' /)/Ob
j

Usage:

3. 4. 2 FORTRAN

Tho I·'OP-TRAN cmrunand compiles files of FORTR7\N source language

into machine-language object code.

Purpose:

Input files must have a filetype
Up tc; 32 files
may be compiled by one cornmand by llsting the filenames, andeach filli! may contnin anv number of routines, each delirni ted by
an END sli1tcrncnt..
Each file pr·oconaed will generate one object
dock nn<.l one listing, replacing any previous output files for'the same program.
of FOH'I'RAN and a record length of 80 characters.

The FORTRAN command compiles prog:r.ams written in FOR'.rRAN IV intomachine code, and prcvides program listings and diagnostics.
!~t:r{FOHJ'RANJ-----~----,--~----------------------------------------·:filename!. •• filenamcN [(option!. •• optionN) J!

, _ _ _ _ _ ,..i _ _ _ _ _ ,.,1 __ """' ________________________________ ,_______ _filename

optionQpdons:lis the name of a FORTRl\.N file to be compiled.
Up to 32 separate compil6tions may bo
performed by adding filenames, separated
by blanks.
is one or more of the eight qompiler
options.

[ NOM~ _.

ihcludas tnbles of FORTRAN variables,
NAMELIS'f, and FORMA'r statements in the
LISTING file.
•
suppresses· the tables of variables.

DECK[ NODi°::CK

gcni;ratc~; the 'J'EX·r file of object code.
suppresses the 'I'EX'I' file.

MAP

J
J

[ No~s·r_

includes a listing of object code in assembler
language r:.ncmoni en in the LISTING file.
suppresses the object code listing.

rLNO.s~oliilc:tJ
SOUHCI·:lincluJcs the som:ce program in the LIS'l'ING file.
suppresses the listing of the source program.

LIST

I UCD

lE.Ps-E.~l-[ ,,::0 J

is used if the source program is punched in
Dinary Coded Decimal.
is URed if the source program is punched in
Extc-:ndcd I3i1wry Coded Decimal Intc!rchange Code.
force~

compiler processing to completion despite

source statement errors.

'l'he options governing compiler operation and output are specified
in any order in a set of parentheses following the last filename.
Ono Hct of options governs all compilations performed by one.
command. gach of the eight options has a t:ofaul t value which is
selected wh~n none is specifiod. The default values aro:
NOGO nrnG EBCDIC DECK SOURCE NOMAP NOLIST NOPRINT
Any combiriation of options is valid, but lhe result of specifying
more than one V<\.luc for n single option is unpi:-odictRblc.
Unsupported or misapcllutl optioITTs are ignored.
If no options
a1·e specified, the part.:!nthescs are not nccc~ssciry. No filcnnmes,..,pt ions, or c011mt;rnts should be placed following the closing
iJarenthesis.

Diagnostic and error messages produced by the compiler arc placedin the LIS'l'ING file (see Out.r.ut.), and, unless the NODI!1G option
is Bpcci fied, typed out at-the.terminal.. The compiler error
1nessaqes have lHo fo.rnwts, rlcpendin<;; on when the error is detected(~cc Fiqure 3.4.2-B).
Statements in which an·error is detecteddurinq the ntaternent scan, such as a synti:x error, arc typed'
out immediately, followe.d by a line with a "$" beneath eachpoint at which an error was detected.
The "pointer" line isfollm·wd by the error· codes and explanations, numbered fromleft t.o rtqht.
If an error, such as nn undefined label, is
not detucled until statement scanning is cumplnlcd, the error
messnqe is typed, follrn~"a by a list of the labels or variables
in error.
If source stalcn~nt errors are detected, CMS terminates theconvilation with a message and an error code of 32. If the GO
option is specified, CMS does not terminate processing, although
for sonID conditions the compiler terminates itself. When processing
is completed under tlw·Go opticm, any error completion code is
the qreatest err.or severity code assigned by the compi.lE:!r (secterminates compiler processing when serious
errors arc detected.

Erro~ !2~.E.~~~) .

[~::;:J

prints the LISTING file on the offline prinfcr,
and deletes it.
suppresses printing of the LISTING file.

~ay beBin~ry[N~6~c]types source proqram errors at the terminal.
suppn~sses t:ypin9 of HoLu·ce program errors.

Source files read through the offlinc card reader for compilation
punched in aithcr Binary Coded Decimal (BCD) 'or Extended
Coded Decira~l Interchange Code (EBCDIC). If BCD is used,
the BCD option Must be specific!d.

07-24-6
3 ..f.2-3

07-24-67?)8t

3.4.2-4
FOR'rR1\N·' ,.,~~ l)(J!

.

3 l)f
'.I

.../

!.. ..:...C: !.: <2 ~~_c:;:_<:E. :_Q.i:!_!_P.Ut:

Files with the designation "filename TEXT PS" and "filonam~
LISTING PS," where "filcnmnc" is the name of the FOI~'l'HAN
input file, are produced for each file compiled.
If NODECK
is sp~cified, the TEXT file is nuppresscd.
The object program in the 'l'E>.."l' file is identical to that produced
by a compiler under the Operating System, und object decks may
be loaded and executed uncler.CMS or OS. The entry point for

the first main program in the file is the ~am~ as the filcnnme.
Subsequent main progrmns in the same file all have the entry
point tl~!N. Subroutines have the entry point specified in the
SUBROU'l'INE statemt~nt, regardless of their position in the file.

.

Under the default options (SOUnCE NOMZ\P NOLISrf) the r.IS'fING
filt! con'.:i'lins the source program statements, diagnostic
messages, and a,statemen~ of object program size in bytes (neeFigure 3.4.2-D). If NOSOURCE is specified, the source program
statements are suppressed.
IIoHevcr, statern~!nts in which errors
were detected are always included, with error messag~s in thesame forx;-iu.t as they arc tn;ed at the terminal.
If MAP is specified, a tnble of n<ldrcsses isgencrnt~dfor eachof scvcn clas;;ifications of variables used in the source program.
1'he clai::sifications nre COMMON, EOUIVl\T,ENCE, NAMEJ,IS'.r, FO!lMJ\T,scalar, and array variables, and called subprogram names.

If LIST is specified, a listing of the object program isgenerated, with relative addresses, arid instructions translated intc
.1sscmblcr language.
·rtw PHIN'r option causer, the LIS'rING file to be print•;:!d on tho
off line printer., f'nd then c10Jetcr1.
If NOPnUlT, the dcfaul t
option, is npecified, the LIS'l'ING file is saved on the permanentdiek, and may be printed with the OFFLINE PRINTCC conunand or
typed out at the terminal with the PRINTF conun.:rnd.
Noi.:cs:,,,
Previous LIS'rIHG and TEXT files with the same filename.is the current PORTRl1N input file are deleted, u.lthough in somecases they mny not be replaced because of different options

or an error termination.
h.
If multiple files or a file with multiple routines is ·haing cotl'piled, the GO option should be specified to prevent ant~rror termination of one compilation deleting all compilations>:equested.
·'l'hc FOH'l'Rl\N co!mn<.ind executes the Sy:;tem/360 Op2rating system
FORTHAN IV (G) con1piJcr.
l"oJ: infon1~tion on the FOi~'i'Rl1.N IV

l<rnqu<:qe, S<~e !_l~l;~ ~::.J'.!;~·~,ny')GO_:_ ~~o._1-:_'J:1.:_~\N. !.Y. !·~_r19_~_;:_<;E1Fon11 C28-6515,
and ~)_H}'~Y\~! !:~. !~:1l:>E~1.~y ~~1.L>p];~~~!E~~~'.·:!• Form C2u-65%. For.
information on compiler operation and n~esi:.;agcs, see FORTHJl.N IV (G)!?.!:.S'-9-~~n.~~:·::::~:>. ~1!-~~01:!.• Form C2~ .. 66 39. Infoni1ation in the-Programmer's
Gtud0. on Operating System Job control l.:mguagc and dc,ta
ma. i}·a-gcmt!nt is not applicable under CMS. The LOAD, NAME=, and
LINECNTn options are not supported.

~~g_i_:s~.s- :_Source sti'\tement error·s and compiler mci::r;agcs arc typed at theternd.nal unless NODIJ\G was specified. If: GO was specified,or if no errors were detected, there is no response except the
Rcndy mc~sugc or an error complet.f::on code. The following re:sponscs
should not oc.:cur:
RE/\DY 'J'l!E PH.IN'l'ER.
1/0 Imnon ON PIUNTEH ••• PJUN'J' I

A1OPTION Cl\NCEL!,'SD.
LTS'l'lNG ,. DISK FILE WILI. 13£ CREJ\'l'BD.

: f ei ttwr oppc'<.n·s at the tnnni.nnl, not:ify the responsible
syst.einproqrilmm~r.

~-~l~f.~l. ~::5-..:..

a.

see Figure 3.4.2-1\

Fl\C FOR'fJV\N,PS, .is to be compiled.
No option~ are specified,so the set of dcfnul t option~; governs the cornpil.nUon.
At statement
001 J, Uw corupi 1 er dctPcts tuo errors, at the points indicated bythe$ ill tlH~ ~rnc.:cc~Q(]j11rJ lirn~.
l·:n:ur OJ:) rof<:n:: to tbl! left$,
error 02) to tl1c $ at the cnrl of Uw line. E:qJlmwUons of: thecr.ror cotlcs are founrl in the FOHTiU\N Pi~oqr<i~(@cr' s Guide. CHS•
cnnccls the compilation and :;upplies tii·c·"·c-iior ·c;0ac;-r;((foo32).

l\

file,

b. nee Fi~urc 3.4.2-B
The !;c:111K~ f.iJe a~; in (a) i;, to !Jc cor:1pilcd, but the GO option issp·~ci ficd.
'l'llc sarne errors in st<.1temcnt 11 are detcct.cd, but
p1·occssir1g continues. Anotht:r error, an undefined label (t.O),
is found before.' proc•.!~;~ing ir; compJctcd. '!'he completion code.,
E(00001), is the error severity code asgigncd by the compiler.

c.

sea Fi~ure 3.4.2-C'J'hrec files arc to be c0111pilr!d: Ff,c FOH'l'RAN 1'5, SUBl FORTRl1N PS,
and SUB2 FOR'l'R\N PS. No errors are detected during any of thecompil\\tionn.

Maps of varL1blC's are included in each of the three... :r.STING files, which are autorna.t:.ically printed offline, andcrnscd from tho disk.
see Figu~c 3.4.2-D
An exa.mple of: a LISTING file generated· under the SOUHCE MAPd.

NOLif;'f options.

~.

~

"'

')
fortr.<in ·f~c
0011

3~0

IFCJ)

200

fAC00-110

:no,.

$

~

1) ERR 05 :~~~~AL LA~EL
02) ~RR 13
c:J:.:P:L1~TIOtl CA~~CE!:...LED DUE TO SOURCE ?~OGRf\'.··~ EirnOR.{S).
~(0~232);

SY~Tf\X

T=~.:7

Figure 3.4.2-A

fortrDn fac (go)
QCll
01)

IF(J) 3QO 200 100$

ERR CS

L~E~L

ILLEGALERR 22FACOOllO$02) ER~ 13
UNDEFINED LABELSYNTAX

40
E(GOOO::.); T=G.07

Figure 3.4.2..;.B• •,,.

•·~;-..,. •

"' L

..
I

0
., •!.>.> -.J

fortranfac~subl su~2

(g~ ~a~Q ~Iprint)

T=G.25

~;

::0.

~

...:!

J1

N

~I 1
,,_, V'. O'

I~

-.J

V·>

CV

Figure 3.4.2-C;);"~="1!..ffa~-

0 !·: -~- ~:/~ ~;;: I LC ::;,c! i stint,
I G LEVEL

)
0,

FAC

0

~DD

CAMBRIDGE

0 G·J ;~f•Ofl5C~Ol)ft r: ~;.;

0000
OGfJ~

00:.0

(l

IF {J) 300,200,110
110 DO 120 l=l,J
X=X*I
IF CZ.LE.X) GOTO 400

~

i20

I

•• ~- J.

on:;~

G

co~:T

j=/\~~0Ut:50

F/'.t:GOCG:'i;::,cn~u 7G
f-'fiCOO~~G
r:-t-.C~GG~n

F1\COOJ.OC;:,;coo1:c

FACOGl?O
FAC00130
F/ICOOll11')

n:u:::

FACuOlSO
i-ACOOlCO

200 SJO?

F/~CGOl 7G
f""',.. """"'"-,,.,,..
rH\,U\JJ..:i;)

J~li

300

PRl~T-3

F;\C00190 -~RITE

F.".C0021C<1e::::•i
~00

OG2i

r-oro 100

FACC0200(6,,)

FAC0022G

GOTO 100
END

0022

C023

FAC

;:o;::r::M: iv G L:VEL (), i'.OD 0:: ; LC FJ\C

_SY~·iGOLLCCATION

cs,~

CA'~i>RSCALAR MAP

SYMBOLx

LOCATION

00

SYMBOL

LOCATION

FAC00230
14/39/57

DATE = G70ZO;.;er.; I TORSYSTEM
LOCATl O~J

A

08

CALLED- SYM~OL

LOCATI O:!

PAGE 000

LOCATION
DC

sv:.:sotLO

J

SYM30L

LOCATION

SYf.'iBOL

LO..... ._ .............
LOCATION

SY:r.GOL

LO

sv:.:soL

E4

I fJ\,U1~11

FO~M~T

SYM:>U L

I DGE

SYMgOL

LOCATIO~

SU3?ROGRA~S-~y;:;:o~LO CAT 1011

1~;

r--t.f~·ocv:.ri

GOTO .105--r;--:;~.;--:;:.
c:::,";:;,cc:c-: on~ccoc ,;i:R:TE (6,2) X

00c. . .

Fi.C:HJO 0

2 FO~~~T ( 1 FACTORIAL ·;s 1 ,Gl6.9)
3 ;:or:~:.~ . ·,-;. {; ! ;:vi\L In ;\~GUi~~ErJT,}
4 ;:GRi-'.AT ( 1 OVE:ZFLO\·! ON',14,'TH ITERA7!0t~. 1 )5 FORi1/\7 ( 1 .[;;1rn rt:1\L w:-mr~s SINGLY, OR 0 TO QU:T. 1 )100 '.Iii.li.E {&·;.5)
105 r.EAD (5,1) A
J=i\
X=. lDl.O:J·~:;

p:,c= U~J

~4/39/57

1 FfHU'.l\·~ { l.7. !; jC;OG2r"'i'°'I"":

Of.T;:'. = 57030
MO~ITORSYSTEM

REAL*?. X,Z/.9074/

GG~2

\~

..........~E8

SYMOOL
2

STATEgENT ~AP

LOCATIC~EDTCTAL MGWRY REQUIREME~TS 0002EG CYTES

T:1;30.

.... -·!..OC/\TION
102_

SY~BOL

' 3

.....

.,

SYl>~COL

I;

117

5

~ "lj !"'~

Figure 3.4.2-D

.

0""
::;:)
...,

N

7-l ~

>
z

1._)

\ __ __,;).·

07-24-67
3.4.2-7., ,FO.!<TRl'•.!:!_

7-19-68
3.4.2.1-1-~) ';!/FOHTRA7'\---3J:L

I;·E!.£!. MeSSCJ.C'}eS :_K.QB_'.[.!_~A N Pl~ (_~~0~

B (00001)

TOO MANY LEF'l' Pl\RENTl!ESIS.
More thml one left parenthesis wan found Jn the comrn,1nc'i.

~~I::!~~ lj_Q:

No convilation was started.
E(OOOOl)E(OOOOl)

I,Ef'T PAREN'.L'IIESIS MISSING.
An unbalanced right parenthesis was detected.
ation was started.

r------------~---------------,NO FILE TO DE COMPILED IS DEFINED.

No filenamE:> was specified in the command.
was started.
E (00001)

All SNJlll'ntial fill'S used or ("J"('.'.ltcd by FOHTHAN programs lrnvc
file identifiers in the following form;it::

No compil-: Fil<!nanw

I

No compilation:

AT LEAST orrn OF 'l'llE FII.ES TO BE COMP II.ED DOESN IT EXISTOR DOF.SN • ·r HAVE A • FORTRJ\N • 'l'YPE NAME.

"filename FOHTRJ'.N *" was not found in the file directory.
1:(00001)

J\T LEAST ONE or 'fllE FILES TO BE COMPILED HAS LOGICAL

FI LE

Possible errors wore detected in the nource program, but
successful·exccution is possible.

xx

is the data set: rcfPr·cncc nun1bcr, fro1n
OJ lhrough H ..

yyy

is a SC<jlH·ncc numhr:r, beginning with 001,
lls<'rl lo distinguird1 nrnltiple files uncl<•r the
san1c cl;tl.a set rcf<'rcncc nun1ber.

Data set: ~·cfcrPnce nmnbcr 5 is rc,scrvcd for tcrn1i11al input rc·cordsof 80 char~tclcrs or ll'ss. Nu111hcr (, i:; rcsl't·vc<l for terrnin;i) (ml put
rccorcl:. of 120 charactt,rs or less. The ten11inZ1l is also addn·siH·cl
by slalc1nents of the fo1·n1 "RJ.;j\f) b, list" a11rl ''PIU!'\T b, Iist'' when•''b" is a FOiUv~AT sL:lll,mcnl mtmlicr. The FOllMAT for R l'HINT
stal'crnvnt nrnsl allow a leading sp;ic-p for a c.-1rriage-cnntrol c-hara(·\cr,
or the first dHJ'itcfcr of the record will be lost.
The carri.1gccontrol c]1;1ractl'1· docs not h;tvl' to be fillc·d in, ho\\·c·-..·c·l'.· Output
rc,co1·ds gcnc!r;il.ecl l1y a slah~111c11t of the· forn1 "PU;-..;C:II b, lisl" arcpl;iccd i11 ;; file on tiie purrn;uwnt di!ik under the identifiers ''FILE
FTO"/FOOJ P5".
J\ctu:tl punching out of cards n1ay be perforincd
later with the OFF LINE PUi\'CIJ command.

1-; {00008)

Errors were detected in the source proqram, execution may

fail.
E(000l2)

Serious errors were detected in the source progrGm,
execution is impossible.
E (00016)

Terminal errors were detected in the source progr~m,compilation was tcrminntcd.

wmm J.01\DING TllE IEYFOHT MODULE.

Londinq of the compiler failed, no compilation wasstar tcd. Retry· the com.r.iand.

~~.l<liJ,"w"~·'""'

Data set l'l,fcrcnc1' 11nn1bers 11 and IZ are n·sc1·vecl for t;qw 1/0.
Numhcr 11 corn·i;ponrh lo Tl\ Pl at virtual <H.ldrc·ss l HO and nmnher

COMPil.ll.TION CJ\NCELI.ED DUI~ 1'0 SOURCE PPOGM~I ERHOH(S).

CMS cancelled proccssinq.
or specify the GO option.

:

With the cxn!plion of (cr111in;il input and output, ;dl fil<"s arc•. kc·pl
on t.lw JH,rin;111.,nt disk 01· on Lipe. f:>:i~;tin,.: i1;p11I files 1nusl confori·,1
to the i·pcorcl forn1;it.s descriut!d bi:·lo''· Outpn: files will lw created
hy the, FOHTH.1\N prog1·;in1, ;ind need nut lw dl'fint•rl before cxe.cut ion.

~(00004)J-~(00012)

FTxxFyyy

file· is being c1·cal<'<l by •1 FOH.Tlt1\N pn>!-'.1·an1, the fih•1110de\\'ill h1~ P·i.
1; or input to a Fon TH,\J\: progr;1111, <1ny ilppropriatc
filcn1odc is acr:1•pt.,11.

will truncate ovcrlcnqth records tn BO bytes. No
compilation was. started.

ERROR

I
I

J( ;i

HECORD LENG'fll DHFEREUT OF 00 IW'rES.
Recreate the file with BO-byte records.
The F.DI'I' c01nmanrl

E(00016)

Filclypc·----------------------------~

UNl\IlLE 'l'O CO:-!PIT.E f-t,ORE TBJIJ.J 32 FILES IN ONE RUN. PLEASESPLI'l' YOUR RF.QUEST.
More than 32 filenames were •specified in the command.

Enter in groups of less than 32 in two or more commands.
No compilation was started.
E (00001):

1·----------------------------,

Correct the source program,~I. .
~1![" ,,.,~

6-15-70
3.4.2.1-2
FORTRAN(12 corresponds to TAP2 at virtual address 181. Before number
11 and/or 12 are used, virtual 180 and/or 181 must be attachedto the user's virtual machine configuration, or I/O errors will
occur.
With the exception of data set reference numbers 6, 8, 12, and 14
which allow 133-character records and data set reference number
9 which allows 140 character records, all files must contain 80character fixed-length records. The implied record format anddevice for each data set reference number is shown in Figure
3.4.2-E.

(

The sequence field of the filetype is always 11.001 11 unless multiple
files are referenced under the same data set number. There isno limit to the number of files which may be created or referenced
under the same number, but only one may be referenced at a time.
The first used must have the filetype FTxxFOOl, the second
FTxxF002, etc. The END FILE statement closes the file currently
in use, and the next READ or WRITE specifying the same data set
reference nwuber will refer to a file with a reference number
one larger. If the latest operation on a logical unit was aread (write), then an END FILE to that·logical unit will cause
all records to be erased on the current logical file of that
unit that are beyond the last one read (written). The REWIND
statement 11 repositions 11 the files to the first one used in that
program under that data set reference number. See Figure
3.4.2-F. The BACKSPACE statement is not supported under CMS.

6-15-70
3.4.2.1-3
FORTRAN-------------------------------,----------------,----------------------Data Set
External
RecordInternal(

Ref. No.

1
I

Filetype

1
I
1
I

. II
I
I

LengthReference-------------~-----------------~----------------~----------------------'

I

I

I

I

I

I

I

I

I
______ ! ______ ~-----~!Q1~yyy____I~ _______ §Q _______:I------~-------!---~-~!Q~~yyy ____ ~ _______ §Q _______ ~______}_______L____ :E!Q1gyyy ____L_______ §Q ______ _I______ 1_______
5

I

I
L----~~Q~Eyyy
1
I
I

---

1

I

I

I

f

:

READ {a, b)

list*

WRITE (a,b) list
END FILE a
REWIND a____L_______ §Q _______ L________________ ~------80

I

I

READ (5,b) list.
or READ b, list--------------r----------------r----------------~------------------------

1

I

•

------~-------~----~!Q~fyyy
1______ § _______

I

I

1

I

I

I

____ ~ _______ §Q _______ ~_!8!!~-J~L~l_!!~! ______ _WRITE (6,b)

list

L______ ===-------~-------1}} ______ ~_QE_E8!~!_eL_1!~~-------

I
1
1 same as 1-4 or______ 7_______ L____ fTQ1fyyy ____ L_______ §Q _______ L_E~gg_~L-1~~! _________ _II______ § _______ ~ ____I
I

f!Q§£yyy ____ L_______ 1}l ______

I
I(------~-------~----E!Q2fyyy

I
I

·

I
I
L_~~~~-~~-1=1___________ _II____ ~ _______ 11Q ______ ~-~~~-~~-1=1 ___________ _

I
I

I
I

1
I

I
I

I
I

I
i

I

-

.

l
I

_____ 1Q _______ ~ ____ E!1Qfyyy ____ ~ _______ §Q _______ ~-~§!!!.~-~~-!=1------------_____ 1±-------~------===-------r _______ §Q _______ }-~~~~-~~-1=1 ___________ _I

1133
same as 1-4--------------~----------------L----------------L-----------------------1
I
80
I
I
1
I
13
1
--'
blocked 10 1 same as 1-4

12

**
**

;

---

--------------~----------------~----------------~------------------------

14

'
I
1

I
I

---

1

133
blocked 10

II1same as 1-4--------------r----------------+----------------~------------------------

1
I

I
I

I
I

I

I

I

1
I

I
I

I
I

I

I

I

_____ !~-------~----~~1~~yyy ____ +_______ §Q _______ ~_§9ID§_g§_l=1-----------_____ 1§ _______ L____ ET!§Eyyy ____ l _______ §Q _______ l_2~§-~§_1=1------------_____ 17 _______ t1 ____ ET11Eyyy____ l1 _______ §Q. _______
l_~~~~-~~-1=1-----------•
.
1
.
.
l
I

_____ l§ _______ i---~E±l§Eyyy ____ ~ _______ §Q _______ l-~~~-~§_1=~------------ :
I

I

I

- -

I.

I
I
I

FT20Fyyy

I
I
I

I

I

.I

·

l

I
I
I

same as 1-4

III_____ l2-------}----~~12EYYY----~-------§Q _______ i-~~ill~-~§_!=~------------ :2080--------------------------------------------------------------------------

6-15-70
3.4.2.1-3.1
FORTRAN·C: ----~:~:-;:~--:--------;~~:;~:~----:----;::~;~---:-------~~;:;~~~-----------:
Ref. No.

l

Filetype:

Length:Referencel--------------4--------------------~-------------}---------------------------'
I
I

I
I

I
I

I
I

I

I

I

______ 3~------1--------~T~!fyyy____ LI _____ §Q ______ LI ____ §~ill§_~§-1=~-----------jI
I
I:______ 33 ______ J________ ~!~~Eyyy ____ L_____ §Q ______ L____ 2~m§_s§_1=1-----------~
I

I
I

l
I

I
I

!
I

I
I

I
I

I
I

I
I

I
I

I

I

I

I

I

I
I

l
I

I
I

: ______ 3} ______ J________ ~!~}E:yyy____ L_____ §Q ______ i ____ §~IDsL~§_1=1----------·--::------~~------~--------~~~1£yyy ____ ~ _____ §Q ______ } ____ §§fil§_~§_1=1-----------~!------~~------~--------~!~SFyyy ____ ~-----~Q _____ }____ §~~~-~~-!=1-----------~Il
I
I: ______ 3§ ______ ~--------~!~§~yyy ____ ~ _____ §Q ______ ~----§~~§-~~-1=1-----------~
I
I
I
I
I
f ______ ~z ______ J________ ~!~Z~yyy ____ L_____ §Q __ ~---L----~~~~-~~-1=1___________ J
I

*

l
I

I
I

.

I
I

I
I

I
I

l
I

I
I

l

I

I

i

l ------~§ _______i--------~!~§:Eyyy ____ ~ _____ §Q ______ i~---~~£1§;_§;~_1=1-----------~: ------~~------~--------t!~2:Eyyy ____ ~ _____ §Q _____ ~~----§~~~-~~-1=1-----------~
(

I
I
I
1
I
I
1
I
I

~-----~Q ______

J________ t~}Q[yyy ____ L_____ §Q ______ L____ ~~~-~§_!=1-----------~f*ais the data set reference number.

bis the FORMAT statement number.

list

is a series of variable or array names.
See the FORTRAN IV Language publication for additional
acceptable I/O statement formats

Figure 3.4.2-E.

Summary of record formats and I/O statements
for sequential FORTRAN files.

I 1
I
I
1
l

.~

!""

If/Ill\7-19-68
3.4.2.1-3

3/3..3/./• FORTRAN"J;- - ,.._ ... -- .. • 1- - -- ....... - - ... -- .. -- -.-- ... - ..... -":"---.- ....... --- - - - .. -- .... - ,. - ...... - ..... -- -- . . ·--- - ..
::12 corresponds to TAP2
virtual address 181. Before nyfober 11
and/or 12 are used,' virlua
80 and/or 181 must be attj.tfrnd to theuser's virtual. machine configu ation, or 1/0 crrors7fl occur.

Data Seti
Ref, No.:I - • - - • - • • •I:

External
Filetypc

1

FT01Fyy'~,-2- - -:- - -- -;..~-;z~;~;;;I:

RecordLength!
!

80:

Internal
Reference

JI·_-- - • • --- -• -·'.-" - -..:-I •· • ••- --• - - • -~I • • • • - • - • • • • • • - -- • - - -,-'1' • - • - - • • • • - - -l· ." :

i-----

With the except ion of data set rufcr 1cc numbeq~··< 8, 1 ?., nnd 14
which allow 133-clrnract,,r records adata s9 which allows '1'1'.0 c:har<tClcr records,
l ~s
ch~1racter fixcq-lcngth records.
The
device for each data set reference 111!

I;-.. ---;;----·:
I

I,---------1---------------1- ----------:

:

3

:

FT03Fyyy

80

I

I:---------.1---------------J-··-- -------: REWIND a::
4:
FT04Fyyy:---------.1---------------J_______ ----L---------- -----------------------~

11
always 11 0
unless nrnltiplc files
arc referenced under tht: s· le data set nun1hcr. There is 110 lirnil:to the nun1ber of files~ ch n1ay be created or re rencetl under thes;nnc number, !Jut~ one inay be rrdcrcnced at a t~e'. __ Thc firstused inusthav~ tlw filetype FTxxFOOl, the second F'fx~02, etc.
The J·:ND FIJ..J.; sta!l'nwnt closes the file currently in w-a,, ~1d thenext RFA]) or ,\'/IUT1; SJ>C'cifying the sa!ll(' cbla sc,"1. rcfrrc,nce nun1hcr

:

5

I

I
I

I
I

I

I

I

:

--

1

80

I

80

"

•

READU",b)li::;tor:

HEADb,list::---------J---------~-----J___________ LI _______ ---------~----------------~
I
I
~
5
:
:-~-------J
I

I

:

6

F'T05Fyyy:_______________ J ____________ ~ --- -----------------------------:
I

: .

--

:

J 33

I

I

:

:

·---------i---------------~------------~-- --------------~----------------,!

will refer to a file with a reference number one larger. The REWIND
statement "repositions" the file's to lhe first one used in that prograrn
under that data set rcforcncc munber. See Figure 3, 4. 2-F'. TheDACI<SPi\CE $!<1tc111cnt ii:: not supported under CMS.

:

FTO'/Fyyy:

80: - - - - - - - - -7~ - - - - - • - - - - - - - - - -:- •• - - - - "' - - - - -

:

8

:

FTOBFyyy

1

133

9

:

FT09Fyyy

I

:

:
I

!---------~---------------J _________ _
I

I

I

140

I

I

•

I

i----~~- --1-----l~;.-1-0~~;;;- -;------·· ---r-~:~~('- ~\-~:=~ -··---- -- ------ ----- ---1:---------~----------------~~----~---L-------:-~-----------------------~
1180: sarncasl"'.·1
.
•

I

I

I

f.

I

I

l:::: ~~: :: t : ::: -: : : :r_ :~~~::::ri ::~~~:'.·~:'.\:: :::::::::::::::: :::1
1

1

--

13

:

--

1

14

:

--

:

I

:

•

':":'I\~O.

:

same as 1--1 ' \133blocked I 0:

same as 1-•iI•:-- -- --- -- ~- -· --- -- - :. _-- -- -:-.?.!~~ ~'.::~ _1_~-~ -- - -- -- - -- - - - - -- - - - - -- - --- - - - -- --~1::::: 1

1

1

1

1

1

1

--------------------- -------------------------------- ------------------~I
I
I

iH lh<l'data set rcfcr<,nce nurnbc:r,

:::a

b

1c

list

series of variable or array narncs,\

FOH.l'v1AT stalcnrnnt. nnmhcr.

Sec the Q,'on.:rn~~ _!:'{ ~:~~:.1!~~!5...<:. publication for adclition<1l. acccpta Jlt, J./O stalt!n1cnl: forn1ats)·-------------------------------------------------------------------------.J

Figure· 3, '1. 2-E.

Summary of record fo1·n1ats and I/ 0 stilh!n1ents
for- st,cp1enli<tl FOl\TH H! fil1::.

'

7-19-79
3.4.2. HS

FOR1'RJ>.N---., c;-/'11 r'..:)l:J

7-19-68 :3
3. 4. 2. 1-4

/6. .

,)/ u

r----------------··--------------.--------·-----------------.
FOR'J.'Ttl\N
FII,E-FORTRANI

Notes:

1.

The file identifiers for each of the files arc:

I

I

I
I
I
I

where "xx" is the data set reference number and "yyy" is thesequence nu1nbcr,
The sequence number is 001 except when multiple files arc
referenced unrlcr the same data set rtfcrence number.
11

20 WRITE(3,100) B
30 E!W FILE 3
40 RE~D(4,100,E~D~50) D

FILE FT03F001 P~
FILE FT03F001 PS

44 WRITE(3,100) B

FILE FT03F002 PS

50 END FILE 3

FILE FT03F002 PS·

FILE FT04POOl Pl

11ao •ro 40

3.

I

;l:

FILE FTxxFyyy

2.

I

I
STl'..ri'l~l·:J:mT
l
NAME
TYPE
MODE
l
J--------------------------------·-------------------------'I
REA T,tr 8 D ( 5)1
l 0 0 FO flHJi.'i' ( 5 ( Gl 0 , 3 , 6 X) )I 5 DO 2 0 I l , 4 5
FILE FT04F001 Pl
I 10 REl>.D ( 4 , 10 0 ) B

No file irlcntifiers arc shown for reading data Ret reference
nu1nbcr 5 or writing nu1nber 6, since these nurnbcrs address
the tcnninal for input and O\.ltput, respectively. No file identifiers are shown for data set refe.rC'nce munbcrs 11, 12, 13,
and J 4, as these numbers address virtual tapes 180-183 respectively.

52 REWIND 3
75 REl\D(3,lOO)

FILE FT03F001 PS

B(terminal output)

82 PRrn·r 200, B
I

**

I

Data uet reference numbers 13 and 14 should not currently be
used, as there are no definitions in CMS for tapes 182 and 183.

STOP

I

~-------------------------------------------------------Figure 3. 4. 2··F. Files referenced by sequential FORTRAN
I/O f.ttatcmentr;.

Note:Staterr.~nt .10 rcucJs· the firr.:t 1)5 rcco:r.ds of the existing
file "FILE FTO~FOOl Pl". At statement 20, ttcse records
are pl.'.lcod in a nc•t file "F'IT,E FT03FOG1 Pl'.'. This fileis clor.cd by the END FIJ,E s tat.er;~0nt. at 30, and the nc):t
tirnc d~ta set n~fcruice nurnbcr 3 is used, at £tatem·~nt
44, a second new file is created: "FILE FT03F002". Afterthe HEHIIlD stntcmcnt, data set r.:::fcrence number 3' is again
associated with the first file created: "FILE FT03F001".
Note thnt tho PRIN'.£' statement requires a different FOR:-iAT
utatero0nt, which will allo\I for a curriage-control character.

;~ '",,,....,,,•.,. '""" •· •''"( !"'J'l'!!""!l!"!!'!!"iff!ii!i!iliii'IQiiliiiiiiiCiflii#fiiWW4$.4 AM q

...

~

Ill":
NPU

i

##A . WIµ!iii

JAllW.L llRW4 illlM ..iliiiiiiQI l!iiZ

iiiji" !!'''?

411 M I

4%

I .ii

MMih i I

ff""'

;

i!i

''·'

IF

'* 1 ·11""" !iiiiiW+•!i"''-'.I'"'"

,,,..,·"'~

7-19-68
3.4.2.1-6

3?7

7-19-6S
3.4.2.1-7

POR'I'H.11.N-·-.. -077

Direct l\ccess I/O:

1

S'rATEMENT
l . NAME TYPE.________
MODE ,
I..,: _________________________________________________
I 100 FORMAT(I6,2X,A2·0,4Gl3.6)
ll
DEFINE FILE 1{200,BO,E,R3)
I
:
.
I
I
•
I
:
5 RE!AD ( l 'J, 100) MNNO ,NAME, TOTS
l•1''ILE DAOl PlI:
II 30 WHI'l'E( l 'JI 100) MNNO,NAME ,Nl'lTOTS

have file identifiers in the follou:i.ng format:,

r-:------r--:- ------1
1 Fi 1 cna1ue 1 Fi 1c·typc 1
L---------L----------~I
FI LE

or.xx

I

L--------~------------·xx;:,>l, y'-'/•'
j--- ------ -- ----~- --·------------------.... ---- ··--------- - --- I
FORTRANt
Fir,EtAll direct access files uced or created by FORTRAN p:eog·rams

I
I!:.Q.RT R1'\N.

'·J

is the data set referar1ce number,from 01 through 08.

I

•

I

l ____ ~:~:-------------------------------------------------1
File referenced by direct access FORTRAN

H the file is being created by a FOlt'fRAN program, the filemo<lewill be P5. For ihput to a FORTRAN program, any appropdate· fUernode is acce:ptable.

Figur£i 3 • 4. 2-G,

I/O statements.

::'-lote:"Direct access" refcrc only to those files \~1ich arc usedwith the DEFINE FILE statement. Files used sequentially are
not considered direct access files, lWen though they reside

The DEFINE FILE statement describes a file of 200 80-character

records.

on disk.

Unlike the Hequcntial (lata set reference numbers, the _direct~c:ccs~;_uumb;:r, doc8_ not.. irnply .. .:~ny. i:.,conl J,cn~.1th..
'l'his info:onation
will be suprlied by the DEl:'Itm FII.E ~italer11t)nt within the
FOR'rHliN progrt~m.
11.11 files are on the permanent disk. 'I'hc
sarne data set reference nur.1bcr may not be used for botha sequ.:rntial <!tl1d a din!ct ac;cc:..;s· file in the SD.me progn1m,
nor may a sin9lc file be refen.incod by botli methocb in thesam3 prograrn.
biffcrr~nt accc!;s method~: may be u£:ecl for thesamQ file Ly ~iffcrcnt programs, provi<led the file identifiersarc changed.
The number of rccordB specificJ in tho DEFINE FILE statement
should be realistic. If a ncu file is being crcntcd, thespecified num~cr of n·cords tire blanked out on the permanent
disk before the first record is written. Specifying an

unnccc!:sarily large nutnbcr of records WD.DteH disk spnce.
J\l though the F'IND

statcmf~nt

is supported, there iB no noed·~ to use it in a ti1t1e:-.slwr.ing cnvirorn1:cnt.

I/O ovc·rlHp isachieved throµgh sharing of CPU time among the virtual
machines. Use of the FIND statement \:ill actually slow
down execution of the FORTRAN program slightly, since
two operations rnuat ba carried out instead of one.
An example of di1:ect acct:ss I/O is shown in l"igurc 3.4.2-G.

If this file had not existed prior to program

execution, 2-')0 records of 80 blanks would have bc~n written
on the permanent disk. Statements 5 and 30 rend and write
the J'th record, where J has been assigned an integer
value less than 201.

-.,.......l11/01I68 _.-:;?;;;:.3. 4. 2.1-9
FOHTHAN

7-19-68371

3.4./..1-8~E!! 3/7-------·'/({;

-....

I

Additi._~i~l-~_?5..:~~-_t~~mt.~~cd}__

Additional Notes:

2..

The FOH.THAN command docs not produce a listing file unless requested.
Alldiar,noslics are printed on the console unless suppressed l>y the option NODIAG.
To obtain a FO:-'.THAN linting.file ihc optionr SOHHCE, MAP, or LIST rm· 3l Le
specified nncl only those options requested will he included in tl1e listing file.
Ifa lislinr, file i u produced, the di;1gnoslics will be included.
lf only the option
NODIAG is r,pccHicll, a Hsting file will be produced containing only the FOHTHAN
diagnostics.
The PJUNT option directs 111c lhting to th(• printer nnd will print
only those parts of the listing requested by SOUHCE, MAP, or LIST.
If PHINT is
the only option spedficcl, only the diagnostics will be printed.

3.

Bach FOHTRAN fi:r: can contain any nurnbcr of routines to be computed.

'4.

The characters appearing in columns 73-'/6 of Tl'~XT files generated by FOHTHAN
are as follows and arc followed by a sequence nuniber in columns 77-80:

The supported data set reference numbers, device assignments,
or record formats a~ a particular instnllution moy vary fromthose described. Check with the re5ponsiblc system progrrnnmer.
1.

2. Since different FORTRAN programs using the s;:ime data set·reference number will reference the sair.c CMS file identifiers,
files should not be left on the permanent disk under FOR'l'RAN
forrr.t1t identifiers. If a FORTRAN program is to be executed
repentedly, it is advisable to create an EXEC file renaming
execution-time files before and after execution. An example
of such a file might be MYS'l'RUP EXEC PS, containing:
AI~ER

MSTR LIST Pl FILE DA02 Pl
AJ.TER CH!INGES LIST Pl FILE FT04F001 Pl$ FORTMSTR
AJ.'l'ER FILE FT04F001 Pl CHANGES DONE Pl
AJ,TER FILE DA02 Pl MSTR LIST Pla) for a suliroutinc - the first four letters of the suhrouline na.i-neb) for a rn<iin progr;-im -- the first foi1r letters of the filename if
it is physically the first deck in the file; otherwise, theletters MAJN.

The command "$ MYSTRUP" will then rename the files, execute the
FORTRAN program, and change the identifiers again on completion.

5.

The letters used for columns 73-76 of a TEXT file "\dll a.lso appear in the middleof the first line of each LISTING page:.
In acldHion, the name of the file will iippccir
at the beginning of the second line of each page in the LISTING file.

6.

The FORTRAN logical 1ilcs which arc dcfinecl arc as follows:~.i_cal Filcf2_

1-'1

5
6
7
8

He~.::_~__ _!::~!2Jl!.~
80 character i·ecords
80 character sysin records
130 character sysout records
80 character records
133 character records with carriage control

To print the logical unit 8 file generated as FILBPHINTCC command rnust be used.

FT 08F001, the OFFLJNE

7.

The r.ubroutinc DSDSET can be c11lled to enable a user to change the record format
and the logical record length for FORTRAN disk files.
Thus, a ui>cr will no lor1ger
be confined to record:; of 80 or 133 bytes in length.
Refer to section 3. 7.1. '/for ade::;cription of the DSDSF.T routine.

8. ·A facility for accessing disk files from a FORTRAN program as a direct accci:;sfile has been proviclcd, This provided an efficient way ·to update i·cco1·ds in place
and to access record:; n1nclomly.
A call to the DEFINE routine is required todefine the correspondence between a CMS file ancl a FORTRAN data set reference
number.
Refer to the description of the DEFJNE routine (3. 7.1. 6) •

. "\

_j

~... '•~~J~~m1:::11: :::1.Hm:s1''i!illlil444MWiMll!@ij$$Jli41!1LLMii!llii.49$3AUU!..J,

JU

. AK

J_ JJ1114¥411,~·
ii". . A . llQijLl!i .JliL Jiiii. L.,. UI LIJll J. St ... JU ljiflM Gi4i!MU #P . lAJM111Wi"-M·LiiMLW,~ll!l!Plfi'*'HP.Jiiii!~lllllM'I

6-15-70
3.4.2.1-11
FORTRAN(.

II.

A FORTRAN reread facility is available to perform a coreI/O format conversion. To use this facility, a call to the
REREAD routine must be made to specify the logical unit number.
The logical unit may be any unit from 1 to 99 except unit 5, 6,
or 7. The FORTRAN statement
CALL REREAD (n)sets the reread unit to logical unit n with a default record
size of 140 bytes. This may be changed by specifying the record
size as a second parameter in the call to REREAD, e.g. CALLREREAD (99,80). Refer to the subroutine 'description in section
3.7.LS. To read the record from the reread unit a second or subsequent time, a REWIND n or BACKSPACE n statement must be executed
before the READ statemente If a reread is issued without executing
a REWIND or BACKSPACE statement, an END OF FILE condition will result.
Any input/output statements for other logical units can be issued
between a write and a read ort the reread unit. The reread unitor the blocksize can be changed by another call to the REREAD
routine.

c

12.

A CMS namelist facility is available for obtaining input to a
FORTRAN program in free format without specifying variable names.
Refer to section 3.7.1.9 CPNMON/CPNMOF for a more detailed
description of this nru~elist facility.

13.

A facility has been added to change the identifier FILE FTxxFyyy·
required for FORTRAN disk file reads and writes. A call to the
DEFINE subroutine is required to change the correspondence
between a CMS file and a FORTRAN data set reference number.
Refer to section 3.7.1.6 for the DEFINE subroutine.

14.

FORTRAN has the ability to read a file from the T-disk duringexecution of a program if the file does not exist on the P-disk.

·~

""'

"'

11/01/68

i'.·/.f4

3. 4. 2.1-10 ..!l:l";t~
FOHTHANft!/

9.

FORTHAN w:dtc statements can be \med to create disk files with a name of
FILE FTOxFOOy when x is the logical unit number and y is the logical filenumber.
'l'be first iiine a write is issued to logic.:al n:::.it x, iogic,11. file 1 iswritten.
After an ENDFILE to logical unit x, subsequent wdtes to logical unit x
before a HEWIND will write ini<> file FTOxF002,
This file is a separate disk filefrom file F'l'OxFOOl.
Adcli_tional logical files can be written by ifHrning an END
FILE: to the pn'·•ious logical ~ile aud then cor':inning to write onto logical u;1it :x:.
If a file already e:l.:ists when the write statement in issued, the li.nes written areappc·ndcd to the cxisti11g fi!C.
To append information to an existing logical file
2, first·a) write oi1to Jogic<ll file 1 and issue an END FILE x, or

11.

•

cxfoting file.

A tape facility for FOJ{THAN programs is avail<:1blc where logical units 11-14 arc
the standard logical t<:pc units.
These units corresponcl to symbolic devices TAP1TAP·1 and to ,virtual dn,iecs 180-183,
A tape file can be written in one of the following five tape fo1·mats:type 1:
type 2type 3· type 4
ty~le 5fixed record size, unblocked
fixed record she:, blocked
variable 1·ccord size~ 1.rnblod<.c<lvariable record si7,c 1 blocked
undefined record size, no blocking

The default s,eltii_igs n1 e as follows:

183

SymbolicJ)cvice. 'l'APl'TAP2: TA-P3
TA P4_Logical
Unit
11
12
13
14

Block
Size

Format
Type

80

1
1

133

BOO
1330

2
2

LogkaJ Record
Length

80
133
80
133

Unless otherwise set hy a call to TAPSET, tl1c mode setting for 7 track tapes js
for 800 bpi, pdd parity, converter on and translator off.
For 9 track tapes, themode setting is ignored.
Refer to section 3. 7. J. l for a desc:dption of the TAPS:E:T

routine.
Note:

This

IU:HEAD l'outinc:,

After ci rewi1)d to a logical unit, suLsequ<!,1t writes will overwrite the existing file.
Only logical file ] , i.e., file FTOxFOOl can be overwritten,
There iB no way looverwrite in~o logical file 2, etc.
An overwrite docs not shorten the file length;
thus, inforrtltlfion L1 a file which is not overwritten will remain in the file.
Writingover an existing. file ca11 lengthen the fil.e and thus eliminates all the original infor-:..·
mation in tho file.
To write a completely new file, an existing file m1u,t firstbe erased either by is[;uing tl1e BHASE command or by calling the EHAfiE routine.

181
182

C:ALL HEREAD

may be changed by specifying the reco1·cl size as a
REHEAD, e, g., CALL REHEAD(99, 80).
Hefor
section 3. '7. 1. 5,
To read the re co rel from thetirno, a REWIND n or BACl\SPACE n statcme
must be ex ut.cd before the READ
statement.
If a reread is issued without e .cuting a HE:WIN · or DACJ<SPACE
statement., an END OF FILF: condition wi result,
Any input . utput statementsfor other logical units can be issued b veen a write Ril<l a read l the rcre<1cl
unH.
The: n.:rcad unit or t.hc blockc'7,c cai~ he chnngccl by another all to theb) read the file tmtil the encl file condition is reached

Virtual
Device180

ble to ped'orln an co*1c
Iformat conversion,
To use this facility a call to the RE
D routine must be
adc to specify the
logical unit number.
The logical unit mac nny unit fro
J. to 99 c=-: cept ttnit 5, 6, .
or 7,'fh<~ FOH TRAN statement

sets the i•c1·ead unit to logical unit n wHh a dcfauit~rA>1·d sh~e of MO b\·tcs.

then w:r'ite into logical file 2 which will appGl'td t.o the data on t.he end oft.he

10.

A FORTRAN reread facility is a'lir

TAP 3 and TAP4 arc not currently defined in CMS, therefore do not use

logical units p and 14.

12.

A CMS namelist :facility ivailablc for obtaining input to a YUHT.K.AN programin free forrnat without
ecifying variable narnes.
Hefcr to section 3, 7. 1. 9
CPNMON /CPNMOF or a more detailed description of this name list facilitr.

13.

A facility has been added to change the idcnti~ier FlLE F'l'xxFyyy required for
FOHTH.AN disk file reads and writes.
A call to the DEFINE subroutine isrequired lo chance the con·ci.:pomlcncc between a CMS file ancl n FOHTRi\1·~ data
set reference nmnbe1·,
Refer to section 3, 7. l. 6 for the DEFINE suLroutine.

11/13/69
3.4.2.1-12
FORTRAN

11/13/69
3.4.2.1-13
FORTRAN

LJ~;l..)/jtJd/.,:)-

Comma-delimited Input:

If the following line is entered as input:

j11' 43, 81,

Under standard Fortran 1/0 using numerical formats, variables
must appear within the field specified by a FORMAT statement
in order to be read in correctly. However, under CNS, theuser can effectively override the data-positioning requirement
by separating the data items with commas. Comma-delimited
input may be used with I, E, F, G, D, and Z format specifications.

1•17, J•43, and K=81

2.

Comma-delimited input is processed in the following manner:
Fortran begins a character scan on the numerical field.
Scanning continues until either a comma is encountered or
the number of characters scanned is equal to the field width
specified in the FOI~lAT statement for that variable. If acomma is encountered, the characters examined from the
beginning of the scan operation, not including the comma, areread into the associated variables. If the end of the field
is encountered, the data item is read in as usual. Scanningresumes at the character following the comma or immediately
after the last character of the preceeding field. The entire
operation is repeated until the I/O list has been satisfied.

r------------------------------,

I
I
I

'
I

READ (5, 100) A,B,C,D
100 FORMAT (4F5.l)
END-------------------------------_.
If the following line is entered as input:\121,6483,33454,98,

Comma-delimited input may not be used with A or H
format specifications.

A=12.l, B=648.3, C=3345.4, and D=37.8 after the READ
statement is executed, Note that the third value
has a field width of 5, and the next character
examined for variable, D, is a comma. Fortranassumes a null field and reads nothing for D.

Examples:

1.

A=3.4
B=62.S
C=l9.0D=37.8I
I

I
I

The user is cautioned to allow a field width specification
large enough to contain the value and the comma. A field
width of zero causes nothing to be read into the variable,i.e., its value remains unchanged. If the first character
examined is a comma, Fortran under CMS interprets thepreceeding field as having width zero.
Notes:

after the READ statement is
executed.

-----------------------------,
Ia2
J=4
K=6

READ (5, 100) I,J,K
100 FORMAT (315)

END

11q

: :;u::e91ts;;:;:mL!LJ,,.,P:UJULitijiiiii Lili J

..

~,.,

~

:; za

!!. :

:

:

:a us::

um: ::;;• ::euu:m

ag

~'T

:a :ma ::aae::.::::m::u:;, ::an: ;'1, :u :: ;:;: . :! .,~;:;;:;::;: ... """''* """'"" '''''"". tli ,,,iiiii , "

,.,,~

~

~

If'.

05/01/69!i.4.3-1

h'-1W

PL!

3. LI. 3

r03

ND

c

.f.Y.&.Ii Q.§!l:
PLI cccraand conpiles programs written in PL/I source
language iEto oachinc cede, and Frovides program
listings and diagnostics.

NC

~he

M

1!1'

f)'t/01/69
3.4.3-2

per1J1a11ent disk.
suf pressee the TEXT file.

"f't/ .~f/f'

causes coepilation to proceed after compile-time processinq
has been completed.
surrressas compilation.
indicates that compile-time processin9 is required.
causes the conpile-time prccess~r tc be bypassed.

lQIIDi'Jt:

!i.2

Pl!

'

NS 2

f filenane 1 ••• filename NJfilename 1••• filename N

CFtion 1••• option N

I(option l •.. option N) t
I.

are the names of PLI
files tc be ccmpiled.
A separate coupilation\Jill be pcrfor:1.1ed for

ST

lUi.1

u

each filenage specified.

ll

are one or more of thecompiler opticns described
below.

~.§~

C4B~.E.U~11~:NS

includes the source prograD in the LISTING file.
SUEftOSf€~ the listing cf the scurce prcgrarn.

L

includes a listing of cbjcct codQ in assambly

ll.1

language nnemonics in the LISTING file.
suppresses the cbjcct code listing.

~

lJl
FE
FS

E
A

includes input to the compile-time processor in the
LIS1ING tile.
suppresses listing cf infut to the cornpile-tiree processor.

includes an Attritute Listing in the LISTING file.
the cbject cede listing •.!!.!\

SUFprcssc~

Egincludes an External Symbol Dictionary dn the LISTING file.
~UFPrEsSLE the liEting cf the External syrrbcl Dictionary.

x
1U.tvcludcs a Cross Deference Listing in the LISTING file.
supprEsscs th~ Cress Reference Listing.

..tcreates the TEXT file of otject code on the

lHrn
N'I

use~•s

JiH

.u
NCL

produces extra code allowing eiecuticn-timo diaqnostic
mesEagcs to contain statement numbers in addition tooffsets relative to entry points.
includes cnly offsets in exccuticn-time diagnostic messages.
indicates that source program is in Extended Binary Ceded
Decimal Interchange Code.
indicates tl1at :sout:ce p:ograrn is punched in Binary Coded
Decimal.
~Fecifies thaton the offline
specifies thaton the cfflinea 60-chacacter set is availatle
pcintera 46-character set is available
printer.

specifies that warning, error, and severe error messages
are to aprear in tho LISTING file.
·specifiE~·that cnly er1or and severe error massages are
to appear in tho LISTING file.
specifies that cnly severe error messages arc to appear
in tho LISTING file.
provides a larger ex~ernal dictionary
uses noruEl size extecnal dicticnarya block level and iterative DO level arE Ftinted
after the aFFtorriate statenent.
surpresses printing of block and 00 levels.
the opticrs in effect for this cc~filaticn ace
printed in the LISTING file.
no option list is pri.ntcd.

1he following Citions relate to the

CMS

cotitrol of compiler

cut~ut.

05/01/69
3.
3- 3

•1.

Ahtre\iations for each option appears in pnrcnthesis.
fU?iCH(fU)

outputs. the TEXT file onto the off line
punch. Cption hD" must be in effect.

EfiIN!

outputs the LlSlING file onto the offlincprinter. A copy of the LlSTING fil~ in
DQ1 rlacEd onto the user's disk.

(P)

NO FR Ilil'
( !{

p,

t.GOlAG(liDG)

05/01/69
3.4.3-4

At.~·?-',,(,....

/:~?flTt'..'J

511

7/o{= ( 1, 7 ~)The deli~iting ~argins for scanning source statements ~ill be incolumns 1 and 72, oeaning that cnly cede within these ~argins
wi 11 be pcco:;sed.
Foracomplete

C2E-6594,
litcacy 11 •no LISTING file vill te produced

11

discussion of PL;I usage, refer to ID~ Manuals
PL/l Proqrammer•s Guide 11 and C28-6590, "PL/I Subroutine
An intrcducticn to Pl/I is proviueu in· Manual C2D-6D06,

11

1=1/I Primer".

jH.E.Q.!J§!.f?:comriler diaqncstics a1e not typed on theu~cr •s terminal.

None
If neither f nc1 NP is specified, the LISTING file will be p1nccd onto
the uoc~'s ~ernanent disk.
!l§J.SJ!i:

The PLI ccramand
ccmrilee files cf PL/I
source lanquaqe into
1achine-lanquage cbject code. Input files ·must have a filetype of PLI
and a record lergth cf 80 characters.

The crticns gcvErning compiler cperaticn and out~ut are specified ina r. y c t d c t i n a so t of p a r en t h e s r: fo 11 o wi n g t h e 1 a s t
f il c 1rn mr>. An y
cc~tinaticn
ct cpticr.s is valid.
When confliciting options ·arc
1r~cified,.tLelast specified oplion will be used.
Unsurrorted or
1issfelled options are iqnot"ed.
One set of cpticns governs allco~Filaticns fErfccaed
by encc~rrrrand.
Each of the options has adefatlt value· ~bich is selected when nonE is specified.
These
defaults are underlined in the secticn en .Q.Ej:J.Q.t.l.2 abov<?.
Set \~lues are ~pecified for the
be changed ty tte user:

followingo~tions,

and these may not

SIZE = 131C72
1his.opticn specifies the amount of core, in bytes, available tc
the conpilEt fer use during a ccafilaticn.
LC

= SC

This option specifies that ·listings are tol i neE i:e r fage.

be printedlll.Q.!_11£§£1.!.!.9£§:
E(OOC04)

warning mcssngcs have been included in the
LISTING file, successful executioQ is probable.

E ( 00008)

Error mcssaqes have been included in the LISTING
file. The ccr.filaticn was completed with errors,
and cxecutipn may fail.

E(OOC12)Severe error ncsEageE have been included in the
LISTING file. Successful execution is improbable.

E(00016)

Compilation terminated ahnor~al1y.
·successful exccuticn is impossible.

E ( 00026)

FILE TO BE COMPILED, undefined.
Ne file with the ~pecificd filcnau.e and filotypeof ELI can he located on disk. Chee~ to see thatsuch a file exists and then re-issue the PLI coQmand.

E ,00026)

FILE(S) TO EE COMPILE[, no specifi€d.
No filena~e(E) were s~ccified in the Pl! command.
Re-issue the command in it~ pro~er format.

.E (00026)

FILE HAS INCORRECT RECODC LENGTE.
The source cede tc be ccmriled is not inwith 50c = 0080-bytethe level cf cptiuizaticn fer the ccmriler is set at O, mcaninq
that the object-time storaqe requirement will te kept to ~ainimum.

.!( 00026)

record format and cannot be processed.

SYNTAX ERROR IN CP7ION lIST.

Verify format of option list in,~g _ _ _ _ _,""~COM~AND

line.

'

~'
I

'

""

t"'·

;~

05/0l/6J

05/01/69
3.4.3.l-l;· 'Y'· ':l-5{1~;?',107·.

PL/t

$~/}:
ftl~

PROGHA~MING

Bo-ipl the CMS system disi!."f ( 00027)

CMS NUClEUS ER?CF.

E (00028)

An error was encountered in attemptinq topunch the TEXT file fer the Froqram being
compiled.

~dJ£i1~1i£»-~~!~:
.'l.

Thu

nain

Ol''lIC1~S(NAUJ)h.
lop['oce<luru must
option stated.

bt-

c;.

Co11vc:rsion

till.:

co1npilcr

with

the

be nxamin~d carefully --Compiler diaqncstics mustnot 3tt~rnrt to executecompiled succcssf ully.

ccmf.i.le•laprogram that

bas

not

subroutines arenot~,] as"warnings" in-- this 1oes .!!.21 indicate an~c~orand should not affect the ~xecution of theprocejure -- ~t ~crely notifies th~ user of "costly"
converi.iious. Tne wai:ni.11q~ ffii'lY he zui:;i::reEJ£:cc1 by the "PF"Pd ta ITO t.Q r.

JLl':lnostic~J.
'l'hP.
ccnipil:·n· lo'ill
produce a file 11 namE: TEXT P1 11
fror,, the input
fi.lo "name PLl P1" £>xcept in the evr;rnt·.lt"tt~r;oinal"

compilAr errors.

HLL1i.LU!U
1.H;e~~the
IPL/I
Version4 Subroutine
Library.
2JcauGe the total library is compose1 cf a very la~qenumbl~r ot subroutin•?s, it has
been necessary to divije
11 PL!Lfri1
it.
int.o
thrc~ · sept.rate
fil<.rn:
TXTLIB",
11
11
11?1.JJ.1112
TX1'1IB ,ancl
PLILIIHTXTLI8 11 •Three
a~Jiti~nKl ~utroutints hdVE been
added to thn library:·c:1'.ii..

lrlF..U.s,· IHECLOK, a.n<l l!iEFlLE.
L21~in1_1_f1f1_!£99!j!

lcadi111 a
PL/I proqra m i t i~• .nggg§§!!£Y toJ.::!;;;iquate that thn PL/l libt"ary is tol:e •iserl (theJ~taull litrary is thefORTRAN li~tary call~d SYSLIB).
Ihiti m<lybe . dona immodiat~ly tetoro
Joadinq er~~t.omaticdlly
i t loqin
via the PMOPIL~ RXiC by thefh:iot0

follcwiuq CKS ~ommd11d:
GLO~AlLOADEH .Ti.Tllu PI.1Ll81

PL1LlU2 E'LII.183'1 ;.u: n i 11 q :Ift h "" l cad c r
i n d i ca t e s t h a t
n d it ~ s o f
t t, P.
form "EIF.x}z" ..He u11Jeri11ed the Pl./l libr,1riP.s W·:)re notco~rcctly

desi~nated.

~dJiiil~_tg£~ill£!fl§_!g_~_f1Ll_f£Q9L~~. 'rne CMS

CcmmandProc~ssor

automati~allyconvectsall05/0l/l .J

3.4.3.l-2
tJ·l t:.:i lllt't0 rs

on ·l command line into a series of 8char act er fields(left- i us ti ficd and pad·.1e'1 wi t.hblanks or truncated as necessary). These parameters111.1y he pas::c>d to th1~ PL/lmain i:roccdurc• with the mai:ipi:occJurc in the form illustrated.

/'/rt!

~'>.:."-'/1

3.4.3.1-3
tlon-fcrmat Simple I/O/J~>;~For ini:;ut/outp11t that is not a simple character strinq,
tho PL/I conver:sions will often woi:k adequately.

l.

~cj

05/01/•9

L.!~m2l.~rn=

proq1:

i:'~<OCELHJiiE(PARMS) OPTIONS (11AU):DECLABc PAl\MS CHAR(*) VARYING;

a, C>lSfL/IY"here~~nen
UGin~
parameter Fassinq only thP
t~ch11i:1ues desccit.cd below may be userl.

S7ART

can be any sirnr;lc v:uiable (i.e.
integer, floatinq point, character .strinq,atc.),
it will he converted to a character strinq by
Jpfault format and printed.

loadinq<proy2 ••• >Pil£m1 parm2 pacml •••LCAD ~roq1

1.

two

('rf!P. V.HUI:: Cf' i; IS' 11 N);
The value of N is ccnverted to a chdtacter string,
concil tenate.t with the mcssaqt "THE VAL'JE OF N IS",and printed.

b. OlSHl\Y

IH~CMSLCAD pro41 <pcoy2 ••• >2.

GEN MOD rroq 1c.

DIS!:J,AY
N

Ftoq1 parm1

par~2(VAHill~LE);

VA:Ufl.lll.!::( 1 r:N'rl:R= INPUT;VALUE OF N')REPLY(INPUT);

The numter enteLed is accepl0d as a character strinq
and cc11v•~rti.~J to a num1Jer by thP :~=I~PUT stateraent.
It INPUT contains ,sn illcqal repr.esc~ntation for anumher, a cc~VERSION error "ill result.

parm3

11

rhc varying

d~&P:

tat•

ch~ractcr

c011cateJM t.lOJl

lcnqth willaJ;,ray~;

or

U11~

strinqwill containPAR~S

specified parah?ters.

Its

of H (or null

if nobP. a 111ultiple(:cttar.•Jtecs i'lrc ;,;pPcif1ud),

J.

k'. ! .£ :!! ! il!! L.U.Q

Pull Pl/I Format Cdpahilitics'J'ne full PL/I torm..it caritbiliti(':; cu11,hn usnd byr.r<>.atiny Lnmdtl1'J ~tr:inqs usi11~; the r;f·p STHI1lG
c111ii PU'I ST:~ ING com11id.ndt;.
l:wqula t l'L/I input/output
utilizes the 11 1.lST" oe "EDIT" moc1<? forn1-1t control.
a. atypic~l outrut st~tement miqht te:
PU I f IL~: (SYS Pk Ln) f, DI T ( l\ , l.l, C) ( I:' ( B , 0) , F ( 8 , 0) , F (7, 2) ) :To~dcco~pl1sh tho same function to the t~rminal:
11!JT ST!dNG(UIJ'IP!lT) EDIT (1', 1:1, C) (F'(8,0), P{8,0), F(7,2));uISrLAY (OllTL>lJ'f) ;·1i1here D~rrur is de~lared to Le a sufficiently

r<!Cmiri<li input;ouq.ut
Cdll best
he perforr..'!<i by usinq
0 IS fl.A'{ or DlS PLAY/ REPLY comm;;inds.
Though the
U15PLAY/H~PLY facilities dedlQll}I ~ith character,;t[in<]:-:, all pc!;sitil(~ u:;(!S can he acco1qli.shed by thetni! l'L/lfollc1i1i114 tE:•cJ1niq1wu.
1.

long

Charilcter [/0for sirrple ch<lracter strings, th~ DISPlAY/REPLY
fdcilit1es dr~ conv~nicnt to use.

strinq.

ch~racterb. A t y p i c ,d i n f u t
GET FILt::(SYSrl)a. outrut ru~ssaqe only:
uISH AY ( m;:s::;a,1c) ;J.!~.ilil11.§:~.

F (7 ,2)) ;DISHll'i ( 11( HCLl.O 'l'HE?E

l>ISH:\'lby

l>lSl:'LAY{r~sronse);liB~!ls:(mr_•ssaq1?)('f:~'I'P.H

DlSPLt\Ylrihcre lNi'U!' i s

RFPLY

Your~

liEPLYl1A~1F. 1 )(IrlPUT):
EDIT

(Tl,

ll,

C)

(f'(8,0),where l~?UT is J~clarcd to be a sufficiently
long chdractor string •.

r.espon!:;c:<lcclai=c1l to be a

1 )s ta te me n t lit i g b t be:
P.DIT (A, H, C) (}'(8,0), F(8,0),,STlH'l(:j (INPUT)
F · ( 8 , 0) , F (7 , 2) ) ;

~F;T

1 );

vutrut meFsa,J•"! follcwr!:I

11

l~l';PLY(INPUT);.!L.~L!i~LLU~.:!

cli~ractE>r--variahJe.

c. Input only:
UlSfl.Ul!~.!!:.f_lji:

where

(I

1)

HEP LY:.>!SHAY
ll~UT

(1

1)

ixtcnsive input/output file(r·~spon5(');

REPLY

is d~clarcl to

b~

PL/I

"''''"'"'''""•' "1""i'i1,.H,,1".x.1w;,aa::a;m:sz I

U!..

IS.I LUL.

suppot't for

be briefly
here, althouqh the user should not€ that mostof thuhundred ot possi~le options and • Epccial cases
hdVC net been fully tested yet.
l~scribed

a ch1rscter-variahlc.

·""'

capahilitfo:: arc available

ErcsHntly, CMS hasvery limited
Filt l/O. Tho3u carahilitie~ willin fL/I.

(inp1Jt);--~·

,...I

~

~

f!,,L

05/01/69

1.

/11Filt) Names

A. reference

to a tilein PL/I

requires the

USC!

11

i.''ILF. S'iSPiiINT

I..

11

of a
l~!H!l!L§:

l\lthouqh

and "FILE SYSIN" respcctiV<:'ly.

.!!!Y~1.Qgf12I~1 -Siner~ Pl/I
lna ms theof files under OS/3~0 f£om either PL/I
jQcJar~ticns
or DD cards,
and CMSdo~s
not use DD
carci!J.
The gent~ral form fer a declaration is:,hg

thl! CP:rn statem0nt-~ccommer1d~d

is the length of each record in the file.

declaratio11~;

for SYSPHINT anrl SYSIN are;

SY'.;PRlN'l' PlLE STHF.AM PJHN'l' ENVIRONMENT (F{120));

Ut::C;:J,AFE

DECLAf.E SYSIN flLE STREAM Et.;VIHONMEN_1'

is~

OPP.N FILE:(filel)., fILF:(file2),

DECJ.i\l.H (ilcnctmL l"lU: <2.t.r..0.i!.!!J/Irncorn:> <£]:.TEJJ!!M.:/IN'l'~RNAL><l-' h IN T > E ti v I ii 0 IHI r: N'f ( F ( n) ) :11statement l.S not needed,
due to ~heovorhead associated with implicit ·oPENs

OPr.:N(CdUsuJ by GET, PUT, RRAU, WRITR) as well as periodic
ptcblems with thu dynamic loadiny of the routines, it
i~ recommended thatnll files be OPENed explicitly at
tho be•Jinninq ty a sinqle OPEN statement.
The form of

charact~ristic~

where

the~

~iqniticant

Fi le teclara tion s..!!11 .!il£~3.Pl~[!

''tile11dme 11 • A filename of "DATA" in PL/I corresponds toa Cl'iS rile nameJ "FILE
DATA".
Thus, the ~;tandard PL/I
files SYSfFINT and SYSIN correspond to the CMS files(F(flO))FILE(file3),••• ;~!'f~.L~.!1f£.Y~1

PL/l dttem~ts to "catch" all executicn crtors such as
iuvali·i
conv<~rsion,,pro,;r:am
int.£·rrupts,
andi11put/output. orrors, <tn;1 prints an appropriate mc~;s:l.qc
on SYSPHIN1.
The mesHaqe thatis plac~d into the fILE
SK5P~INT is also transferred to the UEer's terminal.

•Jccasionally tho

mesnaqe "Interrupt in Ere-or llandlei:- 11
occur. Triis means that PL/I has teEn unable toi:-.~c.:ov<H' ircm an
HtroiC conuition. Thorc are
three main
G<iUSE::>
ferthat phenomenon:(1)th<~compiler has~envrated
incorrect cede er malfunctionof librarycouti11\) i.e·.
system crt:or,(2)
a subscript
has·nct~eu(?d its
toun cl.s d.n<l destroyed 1:>cmc a ihi trar y ·areaJi
n1e mory usually a par- t
of t i;c proqra m, or(3)
pdl«tmutt;r::; hnv.:!· be<H1 filS!:i(~d incon:c,ctly (i.n.
scalari1rntcad of arl:'a y)cau.si11q incorr0ct aclrJre.ssQr; to
l::e
u~ud.
The
~ocond probl~m Cdn
he avoided hy enahlinq
tho SUuSCRIPTHANGE check by makinq th~ first statemnnt
oi: each su t"rou tine:
~ill

3..

1:· i le 0 i:e rations

At prcs9nt only SE~U~NTIAL files can be processed under CMS,
thouqh 'ither the STHEAM or HECORU form can be used.
The following
com~an~s ~ay Le used.

o·p rna.

lhe°i·e i:; no n~,11 ne~~a for usinq OPE'.I as the
G1:'I/l'UT or HF.llD/HRITE to a file will cause
it to <lUlomat1cally open.
Since the OPEN routine
is dynJ:nically loaded th~rn is uf·ually a noticottblPi;au.se wht>u dll OPI::N occurs.
At present the TITLE•option ~oos not appear to work under CMS.
fir~{

11 (SIJBSC1\ltlTHANGh)

iucludinq theifa PL/I environ~cnt it isnoc(~£SaL·y todisable the SPH. that PJ./l uses
to trap
all interrupts.
The SPIE can he disabled by using the

breakpcinb:• set
by tiie
DEBIJG
you wish tc sot breukpcints in

All torm.s of GET/PUT can he useJ -- of course thert i le mu: .i t h a v t! bet• 11 cl e <.: l a r c d'l .S

ST rn·~ AM •c •. .lrflJ!/.rlJIXE

th·~ SE~UEtlTlAL forms of HFT\D/WHITE can be used - thE til~~ must- b.1ve bct•n dcclil.rc:l a:c: RECORD.

Only

d.

~1~~h

Before~ file is switched from GRT to PUT, PUT to
G£1, READ to WRITE, or WRITE to BEAD, it must be
CLCSlD.

Note:

Filn~ 1re 11ot autom~tically cras€J,

into analrt~a;Jy<!r.ist.inq filf! will

re~;ult

specLll

CMS librnr:ytunct.io11

IllESPOI"

Therc:foro,(SPIE off)and.1nablerl by the functii:::n ll!F:SPON (SPIF: on).
lln!a kpoints.should be Oacedf>o that thc-!y ar0
tri11ger1~a S!i!gr the
SPlE hus been disabled.
g1Jt£_1i~l!g!ifDS

ther8foru writ~nq

in appendinq: 11

cdtch all proyram i11tHn:upts,
routine.

l?L/l willb •. HUrY:.r

reconil~.;

05/01/f
3

J

to the end of the: oriqinal fil<"!.
There is one exc~pt i'~n' -·- ~the file. S'iSPRIN~~ is automatically erased at the beginninq,1~~·.:t.;>of execution.

3.4.3.1-4

At

pr~sent

in .t l t u II c t i c ll

saveral PL/lsystem-dependent capabilitiesu n d P. I:

thec ~is - -TH~ Ea ll J D " r E

h u i 1 t - i fl

1

5

05/0

05/01/69
3.4.3.1-6

funct.icus

and certdin types of ON-conditions do not
ccrrectly.
There may
be oth~r
similartu~1ordry limitations.
The user should try to avoid
u~inq these facilities.

t/1/,/!;:'!-t:·&/o~erat~IllEC!1S•59

3.4.3.1-7. ,v;-?--,r .

~13~.Y~EQ§Q~i~1~L~l~fM!~!_J2_Y§~£!§_T£f~in~l

Ir! :~C t1 S

ptq:(orm.s

and passer.
initialization

the c'11s-dpoHdAnt initializationtc::uoroutinc, Illt:.SAP.

pdc.im<Hers

it is desirable to use thr full PL/I
:ii::T/Pll'f,
llST,
EllIT, and CATA facilitirn with theu.wr•s t0ruiri.:.1l.
PurthfJL·mcre, it is cften 1lesirable toh.1v1· JJi::oqrams
tll,it canu::;c tho torminal for t.estinq
with ~m~ll quantities of data,
hut later U5n files forl.sryc·-scalc runs.
A facility
has teen arld<!d to
C1~•-PL/l tc Sp(:;Cify that the SYSIN/SYSPRINT be directed
to tl1e u~cr's terminal rather than files.
rt is stilln~c~ssary forthe user to decl~re the SYSIN--i~~
SYSPvlNl files,
whAther he is usinq files or the
Gc~dsionallythei:riruary

l'L/I~gJ11]g_~£g~~n~£lri!C~~

is automaticdlly leadedwith the PL/I initialization

subcoutiJl(~S.

t..:nuindl.
!111...•r,~

arc twc~echanisms

available fer dCtivating thislllu<a· pl q.cra t1on.
1.
Jf the fir;:;t parameter passed
to a FL/I proqram is"('lYl'E)", it willbe trappP.d by thei.ntcrfacP. routine\11•1 .t:£~.!'2.Y~4 i rom the J•uramcter 1 ist, t.he ~1.PQW ri ter~YSl~/SYSPHlNT

mode

oHar.rnt.l:.!r.s, ifany,

p~oce 1

ute.

It

i.

will he tur110d on.
The reMainin~
will he pdssed to thH PI./I main

m~y

~e

jYSD/SYSP!<INT fromde!oirablc toselectively switch
files a11·l tcrmiMl.
The CMS-Pl,/!

!ii.nary routi11P. IllJrnNNI. (onlille)

will causi:? all future~YSI~/5tSPRINT' rcque~ts

to icter to the u~cr•s console,th1! rcuti1:e lilrOfl"L(ottliu~~> will
causP all future
SYSJN/SYSPFINT requests to refer to the files FILE
3Y5lh and FILE SYSPHINT. The rrost recent IHHONNL or
11H.CJrt'L negates tho ciftect of any previous rnoJc.
that the normal precautions concFrninq GET/PUT
In particular~
if both SYSIN and SYSPRINT areto b~ used,
it is recommended thatthey be opened
slmultancovsly hy thP statement:~1te~PFly.

OPEU fILE(S~SlN), flLE(SYSPRlNT)
f .bL L.~?°..Y~I.Q.Y..t!!l£..§'i'in·<"e sul:rcutin1?s h,1ve

teen added to the PL/I library
rot .u:·;'~ under CMS.
'l.'wo of these -- IHFCtOK and IHEFILE-- w~rc written to assist users attumrtjnq to write1• 111011itor-typH" µroqramsin PL/I.
•~11111·----'I"""-'~~'IBP~~~~.iJHl!iri\t-i!f.!!!!!fiW!fi'fH!!Miif!Mii-iiiiiiM

Pil!Hii!iiiii!@.. *iil&ij!h!fiil... !itM!RJiifl ii!iiii!!ii!U!

!RiiiiiPJ!

lfil,%@

Olrim'!'"'191•iPAI'I''"' "

"''"

"

--

"~

I

~
¥

,..,.~·"""!'II··-,i-·.. ~--~.--_1."!"'_"""""'_""'""""'"''""'"--'"""'""""""""'····-IF'"''~~---·~~· 11 ;~F'"""""" -·--.. ~~'!W·---··......................,...,....,...,. ,...,rr-"""·"r-"""'""'""",_.-'""""""~····----,-,..,.,,,,,,... _ ....,.,,.,,,,,,.....,........~"T

"'

~

~

05/01. 69
3.11.3.1-905/01/69
3,4,3,1-B.4"1:::/

jfC'Z;rJ

IHECLCK - PL)I Clock Routine

/;s

rlt

'LOOP:DISPLAYDISPLAY (''AFTEtl CLOCK.');DISPLAY ('DATE) ;DISPLAY (TIME_OF_DAY);DISPLAY (\IIRTUAL_CPU_THlE) ;DISPLAY (TOTAL_CPU_TIME);GO TO LOOP;

I.l~CLtJi\ r<;ad:.:> the CP. virtual c'hrcnolog clcck and returns the;1.\I: i , time of ~ay, ulapsed virtual and total time.

END;·~:!.1.!!!Ll_?-.f!l!.!£.!!$.S

CA LI.' rnr.:dcK
Jh~r~

CLOCK i5

( CLCCK ) ;a PL/I

structure iri

the form

illustrated

Lt! l J J.

•

.CC:CLAiH

1 CLOCK,/* date in form 01/21/6~ *//* time of day in form 21.14.34 */~D A'I E . Cl! AR (8) I
2 'I' I,M F C II AH (a ) ,2 VlB'IUAL_~lME FIXED l!IN(31,0),/* ~lapsedL-.

virtual time in timer units */'I'OT AL_ TIM 1' FIXED DIN(31,0);/* elapsed total cpu time in timer units *.

JAr.~ ·llld •1um ccntain actual 11 / 11 and 11 • 11 as illut1tratcd in theahov~. The PL/I S!JUSTR function can be used to rean:an'qc
th? i:1HF. a11d 'l;l!1E and/oL· r-emove the punct.uaticn.

·!X·3 opl·~s

ilHiJ\L_Tl11t: a11d TOtAL:_'IIhl:: are binai;y inteqers.
They represent~lrFsaJ time charged for cru usaqe runninq under problem state11( 11 vir- ... :..ial tirue)
an.J ·elapsed ti.me charl)ud for total cpu usaqe("t.)Ltl tiniP. 11 ),.
'lo c.:011vcrt from ti1ner units to hundredths of.:;<:?c<rnd:;;, divi9E by 7oH er X'3V0".
Both times ai:e incn~asinq&Jllll!lcrs, the normal 3h0 timer decreases.
th~( '1 BEFORE CLOCK.');CA IL IHECJ!.CK (CLOCK) ;f.Y.&~2.2.£

tollo~ing

is a very simple IHECLOK test proqram.

_;;;~H.B.!~:'IE3ICLC.:
Ti::STCLK:

l'HCCEDUR~

CE-TlONS

TES00010(MAIN);

PHOC.:EOllh.r: OPTIOUS (MAIN);DECLAHE IHECLOK ENT FY (1, 2 CBJ\R (8), 2 CHAR (8),2 flXEO BIN (31,0l, 2 rrxr:n urn (31,0));~ECLARE'

1 CLOCK STATIC,

2 Ul\'l'i' Ci! AH (!J) I

2 TI:'lF._O["_D,\Y Cl!AR(B),
2 'l'O'l'Al. Cl'lJ_TJNF. FIY.F.D BIN(.11,0);05/011 _;;;
3.4.3.1-11

05/01/69
3.4.3.1-10

FINIS.

If sequential

writingor

be done, th(! PL/I proqram
must incl:'emerit the
CA1lJ_.Hil'.l'H!.
When wri1 i11q,
if the i::ard already exists, it<1111 t;c• replaced by th(~ 11Pw card.
If the card did not exist(i.(~., th<? filr- i!3 hci111 cxp1.ndcd), the postion of the"enl-ot-fil.:' 11 i!: moved and the 11cw card a1dP.d to the file.

~!!£.i:!Q='.!2

l lil; •' nc: con vurts PL/ I

file access requ~sts in to the corrospondi nq!W A!} I:: , FI Nl s , RDn I) F I an d w!.HHI f'.

r~i ~~er should be familiar with the operations ofnd~~J C~5 Lile system routines and.the error codnsandr•?1lin-J is to:/;7; ·1 j c ,:; .n ill n Illi .::; sT An: ,5rATF, BRA5E,

Coe·if.2!:'17

IttEFILE - PL/I File Access Routine/:~~[:/(1?'.>r\i'll'i J.!jth~ CMS return code for the la~;t IliBr'ILE issu1Jd
1rni11.1
that P...:B.
Foe example,
return cor1c
12 from RDBIJP
1.1lic.1tnr; .w attE!mjJt to t€dd
beyond the cun<!nt i:osition oftiH?

the above
produced by them.

.?ncl-ci-t ile 11 (sec Hxarople that follows).

' 11i,~ Jl!! fJg';~H!l!:L~.ffLY!J!!f.!if c 1 l c w~; <l c P. s t h e f o 11 ow i 11 q t h in q s :Th <} c x il mp 1 c t h .1 t

CAU InHILF.

( l"Cbi·; L a s c :3 t h '·~(1)(File Central 13lcck)
illu~trdt€d tclow.

ilhJr.c l'Cll~ct~!.:.:'.CJ.Ailf

1

is a PL/I structu['e in the

2 i.:1\RC:_NUt'.luER !"llCED HIN('-1)(31,0),/*record nurnlwr - HDl311F/WHBUf only*/
2 5TA'IUS HXl-.:lJ UlN(31,0),/* CMS return code
0 means OK */l. CAH l_P.U HER CHAli ( t:iO) ;

/*
Th~

d~

byte

recordcec~

nottLc file(])/*CMS command de5i['cd *//* CMS filenamF */I* CMS filetype */(:.>)

ao byte record to be read or wcitten +/necessarilytea" T E:. T 1 D Nr /I " i fit a l r- <!a d y e X is t e d.

cr-c:.1tes a file "'£E5T1 DATl\ 11 co1i~c;istinr1 of ~5 rccoz:dn,~dch record ccntains a character string representing
tiw i:quar{} of the earn numlH~z: (i.,'!., the.third cardin the fil•· ccr.tdin.s the number 11 9 11 ) .

(2)

.Fee,

l C C ~; 11 A ND C fi Aif ( tl) ,l 1'1LEN/d1E CllAil (·j)
2 FIL!TYPE CHAN(H)t i 1e(6)i~closed via FINIS.

tho nu;nbnr of card:; in the file is unknoi,:n,the r-rogram attempts to re,1d throuqh the file untilt.he statu:; .inJic.itcs ~hi!.t the "end-ot-file 11 was reached.

.ri:;suni1llJ

The file is then read backwards (i.e. starting at lastcard~thcn next tolast, etc.).

1he file ,is closed.

sinqlnchu·1ctc-r string.
The next 80 bytes ot th"") sti::u.:::ture (after;-;f.\ CU.5) dre
used wh,1 tcv<?r tl1cy may b(!.
Thereioi::e, binary

iut.JJ<?r!i, cr1t.u:acter

strin;:is, flcatinq

point numbers,

etc.

can to used in the following ways:
(1)

(2)

addinq them tc .structure in place of CARD_BUPFER,
defining another structure positioned on top of
CA!lD_ tHlfF ER,

or

(3)

convcrtinq all

infor~ation

intc a concatenatedcliancter strinq and separating out on input by
SUl!SH<.

~1\:"iC_:rnrlrf.t\

must l:e set for Ri>BUP/iiRUUF usaqP., it is ignored

~

~
'''"

IMi#iilllllli814%4 llW,. MW ,MllM!U ,IQ iil#!,,JJ liiill.iiJ.A@,.P,. .ML.i . . . .J. L .4!!44

.4

4

t

4Z

e

4¥ J

. ¥%

-¥#J 1¥; .:;;

ftg;., Ii. j

4#4. µw 'Hi •+:;m:::ma=ym.iiiill!iiiii¥iiliil!liiii.l?!iildiiliilllliif!lfM,,,w"'ii~!! l,!ll!l!lll'.4!!!!1ll!!!lllJl!ll~11n11111p1BJI H.i....M.t; .. !,!11!11!.l!!l!!IU!!ll!a!,,~,

,.,.,.

~

05/01/6"
3.4.3.1-.i.2
li!'.iU'U;

TES00010

HWCEDURE OPTIONS (MAIN);TESTFIL:
PHOCEDUHE OPTIONS (11AIN):';f/g1~fly

Dt-:C Lld< r;
1 FC3 STATIC,
2 C 0 l'l MA N 0 C !Hdt ( B) 1

2 FILENAME CHAR(R),
2 FILErYPE CHAR (8),
2 CA!lD_llUMirnn 'lXED BIN(31,0),
2 S 'J.: A 'f US F I XE D BI N (3 1 , 0) ,2 C.:AR.C_EUHEH ChAR(flO) i

coMr-:A:rn== • EHAS E •;FILE~A~E= 1 1EST1':

FlLE'l'YPE::: 1 ll/1Tll1;

CALL Ii!BFILE (FCB);
CCi1:1/\;~D= 1 i1Ef;llF 1 ;•VC I :

1 to 25;

CA :w_DIJ FFER= I*I:
CA H D_trn,'IIJ EH:::J;

C.:ALI. l !IEFILE (FCB);DISPLl\Y(l*I);
END;

CCM~AND= 1 flt: IS':CALL Il!EFHE (FCB);
CU:'il1A~D= 1 a.J:UUP 1 ;

·

DO

l

= 1 tsY 1 WllILE (S'fA'TUS:=O):c ARD •. trn :1 n ER-= I;
C Al. LJ Ht I-' II. 1-; ( F C B ) ;v 1 s p LA y ( c A ED - B uF nrn ) ;ENll;o r ~;r r. A Y < • :..> T AT us == 1 1 1s ·1'l.'r u s ) ;l:'\AX=-I-1;
DC I= L'l AX '1'0 1 r Y - 1 ;CA iW_NUtHIJ::l<=I;
CALl. J.HEFILr: (FCU):
DISl'Lt. Y (C.:J\I:D_l31JfHH) ;ENL> iCO!'l:'iAND='FlNlS':
CALL IllEFILE (F<.E);
DISPLAY( 1 Tl!,\TS ALI..');

•

~

,.

~·

~

01-22-68
3.4.4-~

2;

01-22-68 ,,./
3 4.4-2 1.:Lf

SNOflOL.76o

SNOI30L

3, 4, 4 SNODOL·:-)~urp~...!.

'file Sl~OiJOL command
SNUuUL into SPL/1,

compiles source programs written in
and executes SPL/1 programs.

l"ormat:----r r - .... - "-• 'T - -- ·-· -· -· - - - - - - - - - ~- - - - i
t 1 SN OBQL};\SN· 1 ••• optionN·):l'J
lI fi l cnan1e: t,l(opt1on,___ --- -- -'- - - ---- --- -- -- - - - ---"-

II-lH:.CK

generates a file "filename PUNCH P1" conttiining
the SPL/1 output in a special abbreviated forrnai,-:·ii)(;()

suppresses execution of the compiled program.

-f.:t;;ilLeH=uame

identifies b1e f()llowing cards as an SPL/1 routine.

-iJtY1'A

marks the end of input to the compiler. This
car<1 must bE! }Jresent, whether any data cards follow
or not.

·-··-;-specifies a file with tiw filetype• fi lonamc

SNOLJOL to be compiled, or with tne
filetypc SPL1 to be cxccutea.

opt~onl ••• optionll

arc one• or more of tile compiler
options descrived below.

-i~:::H3l:.:~1ULY-J\GSLHLLY ON

includes tho listing of SPL/1 proqraras in the
LISTING file as they arc loaded for execution.

-'l'H1\CLcauses all strings referenced by the user's program
to be listed in the LISTING file.

~ptions:_

PH!di·

eitncr of these options specifics that information
normally placca in the LISTING fil(~ is also to
be printed offline.

1.)i·iLI!1!;;

specifics information normally placed in tnc
Llti'l'll~G file is to be typed out ut tho terminal,:iO.Llti'J:

suppresses the LIS'l'l;·iG file, but docs not affoct
ci tiler of t11e auove optio11s.
·

OFFL!t<L.:Jh.. 1

tiw file namua ~·Ii ti1 the co11unand ls
an SPL1 file to be exccutca, and not a SNODOL
file to uc compiled.

S[H~ci f ics\

In et(;dition tot11G

options al.Jove, execution is also controlled

oy control· cares wi tliin tiie source file.
These car.ds must begin
wi ti1 a i1yphcn in coJ umn 1 ano appear exilc tly as shown below.
-L1S'l' 0/11

n.!sun,e:s th8 listing of the Sl'JOHOL
in tile LIS'i'I:JG file.
This is thesource program
default value.

-Ll!,:)'.l' uf'F

suppresst!s tnc listinq of the SllOBOL source
J!rOgr~lnl in tile.: LISTING file.

-SL\lliLH~l:.

causes columns 73-80 of the source file recorJs
to be ignored by the comµiler, allowing cardsequence nun~crs.

-LJl:.C'l'inserts a carriage-control character in the LIS'L'ING
file to ship to a new page.

OPP suppre~;scs listing of SPL/1 programs in tho I~I5'l'Il~G
file as they arc loaded for execution. 'fhis is thedef<:1ult value.

!!~~~1:_~•1·.1c SNOIJOL command tmcs

t1-10 separate programs to compile andexocutc SNOBOL programs. The SNOUOL compiler is itself a SNODOL
program ~1at translates SNOUOL into SPL/1, a ruore basic
string-processing li.1n9uag12. 'l'hc SPL/1 nssemblcr-intcr!Jreter
executes 8PL/1 programs interpretively (performing the requested
oµorations fo:i; the user's program, rather than translating
nis program into machine language). 'l'he compiler and asseml>lerinterpretcr use several files, described below.
In each case,"filename" is the. filename spoci ficd with the SNOl:.IOL command.

"filename SNOBOL P1" is tne input to the SlmBOL compiler.
It mayconsist of a SNODOL program or program and s ui.Jroutinc!S, a
mixtu1'eof SNOBOL and SPL/1 programs, or entirely of SPL/1
programs which have already been compiled. SJJOBOL subroutinesmust L>eC.Jin with a SUBHOU'l'Ii'iL statement and end wi ti1 an UJ!J card..
SPL/1 programs must be preceded by a -MEl·lDEH'-'
staterncnt
to be handled by the compiler. /, -Dl\'l'A card must close input
to tiw compi lcr, whether cla ta cards follow or not. 'l'he SiiOBOL
file muy also contain the other control cards listed aLovc.
"filename ~>PL1 P1" is the output from the SNOBor, compiler, andis input to the SPI./1 u.sscmLlcr-interpretcr.
If subroutines
arc
included in the SNODOL compi lcr input, cacll will gc11cra11e
n separate
SPL 1 file, with tne s ul.Jroutine name used as afilename.
An SPL 1 file may i.Jc executed wi ti1out compilation
hy s;x:cifyin;.\' the SPL1 option.

.. )01-22-68
3. "" -1-3
SNO!)OL/_.u.

.3·01-22-68
3.·1. ·1-·1
SNOBOL"file name LISTING P 1" is a listing file crc<ttcd hy both thecompiler and tnc assembler-interpreter. According to tile
options specified and the control cards included, it may containany or all of the following information:____

CMS SHObOL users should have a copy of CMS/360 SNOBOL USER'S
Ml\:~U,\L, by Stuart E. Madnick, uvailable--:h6r.1thcf1f11camnrfdge
s·cfeJ-id.fic Center,· Cambridge, Mas:::. 'rhosc interested in theimi1lcmcntation of the· language \./ill also be interested in~.E!~Ll:.. ~ ~t:.!!~9.. ~c~..e..:d.ng ~19\:~.<J!:.• from the same source.

uiagnostic messages immediately following any errors
detectea.
2) A listing of the SPL/ 1 program as it was loaded forexecution.

~~E.1.:.::s....:_

3)
Any output generated by a SNOI30L PRINT statementin tne program.

4)

A message explaining any error completion.

5)

Output ycncratccl by tne TH.l\Ct. subroutine, if tne
it.

a. SNOBOL SORT4
Tnc file SORT4 SNOUOL P1 is compiled into SPL/1, A listing iscreated as SOH'£4 LIS'l'ING P 1, and the SPL/1 program is saved as
SOH'!'4 SPL1 P 1. As :Soon as compilation is complete, the SPL/i
assembler-interpreter recciveG control to execute the program.

~rogram rc~uested··filename PUhCu Pl" is created if a -DECK control card isencountcrctl in tne program. This file is similar to the SPL1
file, except t11at comment cards are deletect and a special
aulJrcviateu format is used.
1 t is ~iencrul ly at;out onc-tnird
tnc size of tn8 SPL1 file for the same program.

b. SNOBOL SORT4 (Sl;L1 ONLINE NOLIST)'.1.'his command executes the file SOR'f4 SPL1 P1, created in theprevious example. QNJ,JNh causcn any output normaJ.ly placed in
the LISTING file to be typed out.
NOLIST suppresses the placingof: t11c sumc output in the J.. IS'fING file.

·• fi l.e1H111:c anyna1:ic I' 1 '' is ti1e general idcnUJicr uHcd for files rcicrcnr.cd
by name from a SN0130L l?rogrurn.
"filename" ls the name of theErr<?_£ ~~~~9-~~.:.

proyram, antl '·anynaiae" is tile name used for toe file within
the program. &cc Input/Ou.tput uncicr "SrlOLOL Progranu:d.ng."

L(00008)

If tne compiler detect~ an error, a diagnostic message isµlac.:ed in· tne I:'lS'l'H1t; file, anu a JJAL1' instruction is inscrteu
in tlle Sl'L1 filt.!.
Cor:1pilation continues to tl1c -Di~Tt\ cara,
uut execution, will lJc tern.inutctt at tne: 11/\L'l instruction.

'1'.i1is is a general error coac returned by the asscm!Jler-

intcrprelcr for most errors.
found in the LIS~ING file.

An explanatory message isl:.(0001<>)l~Otc.:S:'!'here was insufficient room in core storage for an SPL1
file during loading, or more than three levels of. s ul.Jroutine nesting were attempted.

S~Ui.iOLc;ifil:l:-s in some si9nificunt ways frow other'l'rw "~1~01;or. Progrnnuning" section of
ti1is manual ocscriLc.:s briefly tuc I/u subroutines of cr-:s&!luLllJL, l.lut (1ocs not attemilt to c.icHne the langudgc.
'l'hc
user should l..>c familiar with tiw manual listed under References.·a.

·~ ...

__ ,References:__ ___..,---~··~

A·listing of the SNObOL source program, including

1)

jJ.3

CHS

8i.UJ.::UL irnplernentat101.s.

l>.
S~iObOL accepts .:my of tile 25() LilCDIC bit patterns as data,uut na1110s anu lauuls are restricted to letters and numbers,
ana several installation-ricpcndcnt special characters.
!tcspo~_:~nc

SNOllOL commanc gives no responses,

unless the ONLINE option
specifieu.
In this case, information norr.rnlly placed in the
Ll~~l~G file is also typed out ~t the terminal.

_;

is

~
;Ill

111111. a . ""' a:11:.,•~-a::usaaaa::,.a.a:11ausa:::;;:::,,.JUIL££JIJ ,,,,,.Jdit,,,~JiiJ,iii4Jik,,,Uiiifai.!!221 IUilLJihl

~·

~
$

. iii

$

·-

4 ..... ii\144ij . . . .

4w;zuan:;;.;;u ""'""" i\U .Lil

I PlfhWiii¥M" I • IhI

M '" """'"""""" ,,,.,,...

r~1"""'-

01-22-68
3.4.4.1-1')12,f
3. 4. 4. 1 · SN0130L Progrmnming

LABJ.. GB'l' ( • SAMP L • , Nur,1s)
and PU'l' both open files automiltically, if necessary, but if
the Silme file is to be written an<l read, a CLOSE must be issued

CMS SNOBOL inclvdes a subroutine feature, which mny be usccl in two ways.
Syst(·m subroutines arc provided, and are called by using the nnmc of thesubrou~inc as a SNOBOL slntement. User-written subroutines arc createdand ca]lcd by the SUBl~OUTINE, CALL, and RETURN system subroutines.
111c general format for using system subroutines is shown below:i---------------------

1:

contains til\MPL, either of the following statements would read ani tern from the fi1c 1'.ES'J'.'1 SAMPL P1:
LADL GL'l' (OA'l'/\, NUMS)
GL'l'Subroutines::

0'1-22-68 ,/ 3.4.4, 1-2 j]!J

1J.(

label

suhmmc (m:g1, .•• , argN)I

I~xc~µt for the terminal and the LISTING file, record size isalways 00 characters. The LISTING file has 120-cnaractcr records,!Jlus n carr:i.cige control character. Size of a terminal record
is alwayf; tiw nunillcr of characters written or read. A literalIof fewer than G3 characters may replace "s trin<J2 "· in· a PU'l'statement.

-------------.

l·-------·/(where)label

is an opti on:1J statement l:ilwJ.

subnnnw

is the n:unc of the subroutine.

arg1, ... ,argN are string names or literals passed to thesubroutine.

where

between the operations.
(This docs not apply to the terminal,)
u11ly e.i~ht files may be o;_Jcn· at any one time, including ti"1esystcn. files such as the LIS'i.'lt;G file.
·'l'lw terminal is acccsscci by specifyinu a filetyp<:: consistingof blani-.:_;.
'J'his n.i-ty be done' in lllrcc wayc:
by spt,c.l fy j nq n
str.in~1 cont.:dning from one lo cigiit blanks, by spccifyi11q aliteral bJ.ank, or by omitting the first opc>;rand.
'l'hc following
turec sta tcrn<..>nts nll reac..i one record
front the terminal into
tnc string. IN:
lAu GLT(T~kMI~AL,IN)
GL'l'( I I , IN)
Gh'l'(, IN)

is au oplion:Ll statt!lllCnt bhc:l specifying the subroutine
statc11H..:nt [tt whjch execution i8 to begin.

No blal)ks may scp<iratc the subroutine name anrl the left parenthesis •. 111c
system subrouti.m·s arc dcscrilx:d Lclow, group2cl accorlJing to usage •.
-~put/OutJ2!.!!:__:;PRINT (strin~} "writes th(! stri11g sp~.:cificd on tliu LISTING file. A literal of fewer
th::in 63 chnr•~ctcn; m<iy lie: sp.·cificcl in!:lcacl of n ~;tri11g name.
READ ~<>tring} r<..!ads s11cccssiv(~ itrn1s from the SNOBOL input file into the string
spccifi~·cl. 'Illi..·::w itclllS folln\':cd th.: -DATA card i11 tl1c input sLrcam.
l'Ut~CII (strin~~) writes the strin~~- spcciJiccl illto "filename PUNCII P:l",where· filename is the 11<1mc of the program. 111c st.ring spccificcl must be 80
characters or le!;:: in k11gll1. A J.itc.;ral of f(!wcr tlwn 63 characters may
also be specified.

GET (string 1, i;tring'.~)
PUT (stl"ing1, stri11~~?.)
CLOSF (r;t ri111! 1)

EJECT (st..ri11~ 1) arc usl'd to ncccss files on disk or the user's terminal. The
filcna!llc of the file refcrc11cc.;d is always the same as the name of the
program bei I\~ ext ·cutcd. "string 1" specifics the file type of the fik
rcfcreuct.:d. This opcra1id may also be expressed as a literal. For
example, if TEST! is a SNOBOL program being executed, and the string DATA~'!.'.ie first assumes ti1at the string 'l'LRMINAL contains cinJy a seriesof blanks.
'l'he 01::> delete characters have their usual effect, andall input is translatcu to upper cnse.
A line consisting of only

·a cctrriauc return causus an I/O error and program terwinution.
a whole line is dcleteci by 0, anot:iicr rcao will be issued.
'l'ile EJLC;l' state1;1ent cuuses ,u carriage-control c1rnn1cter .to bepl.:iceu in a file, forcin<J a page eject when the file is printcu,
L..it.C'l" (J,J~;'J'lM;) forces tile LUi'l'li~Ci file to skip to the top of al:JLl'JL".
l\ny file for whicn an J.:JL;C'l' is t11c fir~t st<1tc,rn0nt issuecl
wi 11 l1ave a curria0c-contro1 characte>: prefixvtl to C<H.:n item us
il is writl0n out. 'l'his cnaractcr is return<..>o as t11c first<.:11;1n1ct.e3· of slrin~1s rcau i.Ji1ck in from such a file~~,-~--~> ~ ~~1:::. g,~!1.'-'Eu_~~~~~'. :__SLL,1<UVd<;L(nl:"<J1, •• , ,ar9i<) must IJe tne first stiltcmcnt of u;:;crw1:Hrcn
sulirouLilll.~,;.
1\n L•·~> caru must c:on.:.:.luc1L~ t!ll' su·uroutinu.
'•'•IC n.::1111L! uy whica L11\~ sui)routinc will liL cLillco
J.n lriC l.:w0l ficlu of lJJ(: Sli1,,<0U'i L~L st<1temcnt.
i.1 J~;o11<.:

co11Lpilcr

mu:_;l be r,l<.i<.:eci'i'i1is nun<.! \dll

t:~il~Ufor tile fi 1 l;J1<.H1t(! of tile· ~>J>L 1 fi l(! ~wnet·.:itcti by tiie
ior toe suL>rouL:inc. 'l'nc ~.ilh.i~uU·!-.1'~1, statcn:cnt may also

•

I

lf

01-21-6~

3.4. 4. 1-3lj)701-22-68
3.4.4.1-4

j;J(:>

17·include an unconditional branch. An example of a SUBROUTINE statement ii:;:
SORT SUBROUTINE (STRING, FIELD, NUM)

TIME (name) returns the current timer wilue in hunclreths of a second in the string
specified. Unclcr CP, the timer value is elapsed virtual CPU time since LOGON.
It is useful for comparative timings of progrnm.s.

I (l'l\ OCl ~SS)

This statement causes the SNOI30L compiler to generat<:' a file SOHT SI'L1 P1,
which is loaded whcnevc:r this Rubroutinc is caJlccl by the nam c "SORT". On
receiving control, execution would begin at the statement fabellcd PHOCESS.
If the transfer had been omitted, execution begins at the first statement of th:::subroutine. STRING, FIELD, and NUM arc the strings received as arguments
by the subroutine.
RETUltN (dummy) is US('d to return control from a subroutine to tlw calling p1:ogn:imo
If RE11JRN is cxccutccl in a main program, all files arc closed, and control isreturned to the Cl\1S Command environment. "dummy" is a dummy string namewhich must he included.

!-_i.!_1}-~!H~~:s.'..

CALL (Rtt·ing, arr,1, .•• , argN) is used to call a subroutine gcncn1tccl by the SU13nOlJTINE
statement. ''slring" specifics a string containing the 1Jal1l(' of the c11llccl suhnn1tlnc,
or may be a literal specifying the callee. "arg1, ••• , argN" arc the strinf~S p::tssedto the subroutine. TI1eir n:.imcs nre independent: of tl.1osc used in the SUBROU'11NE
stnt..:mcnt, and mnlchin;j is done positionally. A CALL statement 111ay also induclc
a statement lahC'l, and an unconditional transfer specifying a return poiut. A·r:aH
to the SORT routine described abov1~ might appcnr as:
GOSRT CALL ('SORT', TEXT, CHAR1, LENGTII)/~'lEM)

TI1c strings TEXT, CHAR1, and LENGTII arc passed to the subroutine as STRING,FIELD, and NU.i\11 respcctivdy. On return, control goes to the statement lab<:.!llcd
SEhl. Only three levels of nested CALLs arc permittt-d, hut up to that depth,
CALI.s may he. recursive.

XCTL (n:1mc) overlays the currently CXC'Cuting SPL/1 progr11m with the 8pcci.ficd SPL1
file, and starts executing the new program. "name" specifics a string- containl.11g
the name of the called SI'L1. file, or may be a literal. No arguments 11wy be p:issed.
Dcl:11~r;Gi21g_ i'.'-J~~

TRACE ON (dummy)
TRACE-OFP (dummy) arc used to turn the TRACE option on and uff. The TI\ACE
opt.ion may also he enabled by the -TRACE control card. "dummy" is " dummy
string name which n:ust be present. When the TRACE option is in effect, thecontents of e:nch string are placed in the LISTING file each ti.me it is referenced.
'fl1e assembler-interpreter location counter value is includi:d with each string.
TI1e counter value refers to statement numbers in the assembler-interpreter
listing obtained when the -ASSEMBLY ON control card is used.

"'~ •( I 4!Uiiil Ii e:::::s:;1 U,Ji,,;t. &iil&ii.QIQJUl::CH& lS:. I Lhll . I/~
3 . :a:. I ... t2$2 UQJ aua j

$

1"·
22 2.

$

q,,,. . If

I J;

$J1 .a;:. h.k

ouqq; ., ,. ;see .a as

; 1¥4

!"'·

~

05/01/69
l.11.5

Bl:WU:

3, ll. 5-1

rt'{:f.1"'.

(.Jr..f..Y.!.H~e:

Ihe ERUIN commaqd initiates the .,e.i;:cwn .Universit1r l.nterpreter.

.~05/(. . 69

the CMS co1mand environment has teen ~nterEd, vbere tbe
xx.xx is the c~u time u~ed iD seccnds.
fct'cthcttesp~nses,.ILU Q.L.!:! £1Hl.9..9.Q.§:
tionc.

l£n.u:

BllUlND!!.§J.:H~:The EUUJN Environment is entered~ ~hen the character > (qrcaterthan) i ! f IintPd and the keyboard unlocks, (he interpreter isttddy to acccft a ccrnwdnd. A spUIN command should then be enteredim~ediatcl) following the > character.
To leave EFUIN and return to the CMS comrrand environment, issue
the DRUIN cc~mdnd·'
CANCEL\.H.1sU!lf£§:
ERUIU was devclOfEd at Brown University,
frcvidencc, Rhode Island. Fer information on BRUIN'lnd it.s ccirma.ntls, refer to the document ].B!l . UJ
(J}_!CVn .!!Diversity J.uteq:rctcr) foi:- the Camh:idge~onitor S):stem (CMS).
~HE.Q.D.Q.f.§:

EU~JN

As the restlt of a null line being entered, the interproteris confirming that the user is in the BRUIN Euvironment.
~ilUINFEA[)The FRUIN cnvircnrren~ has teen entered auJ it is readyto accept co~~ands.
Ii; 'I= XlC •XX

refer to the references above •3.4.5-2:fti;~p'/Jf3/12/70
3.5.0-1
3.5.0

Miscellaneous

The miscellaneous corrmands in CMS include ECHO, which
is used to test tenninal transmission; EXEC, which
executes a sequence of CMS commands from a disk file;
FORMAT, which initializes a user's file space; andKO, KT, and KX, which clears overrides, kills typing,
and terminates execution, respectively. LOGIN either
saves or deletes a user's files4 LOGOUT compacts
the user's file directory and logs the user out of C~1S.
STAT provides statistics on the user's file space,"""".1t"\. r-nJ. creal-es a
MKApnn"T',-...l-1-0d.uma.I?

- ,o f ..._,
L..ne C"'r1~1.:> nucJ.eus,ana,'T'.,..,...,.

Lt'L

reloads a copy of the CNS nucleus. DIVERTSW diverts
output from Fortran and PL/I programs directly to theoffline printer. TIMELIM sets a time limit for the
execution of a particular CMS corrrrnand. GETLIB allows
the user to access files on a library disk. QUICK
provides the capability of doing operations in afile without continually referencing the file identifier.
DOSBATCH transfers files to the VCS DOS BATCH machine.

(

-·

·1

,,,...

fl"\

7-19-68

3.5.0-l3.5.0 Miacellaneoue
The miacellaneous commands in CMS include ECHO, which
is used to test terminal tr smisaion1 EXEC, which
executes a sai:;ruenco of CMS c mands from a disk file 1
FORMAT, which initializes a us r's file space: and
KO, K'I', and KX, which clears ov rrides, kills typin9,
and terminates e}~ecution, respec vely. LOGIN either
saves or deletes a user's files.
OGOUT compacts
the u~er's file directory and logs be user out of CHS.
STAT provides eta·tistics on the use 's file apace,
MAPPRT CJ:'eates a load map of the CHS nucleus, and IPL
reloads a copy of the CNS nucleus. DIVEHTSW diverts
output from Fortran and PL/l programs directly to theoffline printer. 'l1LrnLIM sets n time limit for the
execution of a pal:'ticular Ci IS c0tru\1and. GE'l'LIB allows
the user to acces~ files on a library disk.

{"""'

4.30

05/0l/6
3.5.1-1

3. 5. 1

UNl!NtIPi?.tW(J;
iJ.IJ;J.H2.§Ul~he llNE~D command defines tho logical line-End characterus~d in ad6itic~ tc the cattiage return (new line) •.

to be

ruu.t:
I
I llHNt I <c>Icis the redetined logical line-end
cheracter. If c is net sfecified
there is no line-end character definedan~ tLe carriage tetur~ is the only
line delimiter.
·.!J§~.9..€:lbe loqical line-end character permits a number cf logicalinfut linee tc· be tyfcd en a sinqlo physical input line separated
by the line-end character.
The physical input line is terRinatedty a carriage return. Lcqical in~~t lines arc terminated hy theli1:e-encl charactm:: o:r ty the cat"r.iaqe retur11 •. Each call to reada line frcn the: tern:inal will return the lcqical input line.
Suhs<~yucnt (:.alls to road a· .line fr.om the terminal will rnturn thr!
logical infut line which was given fcllcwi11q the pr-evious loqical
in~ut lin~.
The line-end character can te used to input logicalli11Es whcn12ver a Fhysical line is ini:ut frcm the typewriter whethL•r
to CNS or to a proqram.
In addition, logical lines can be inFut an~
stacked ty use of attention to CMS (double attention if froM CMS
ancl tunning under CP).
Eefer to section 2.2.3.
1!£!~:

1.

The defined line-cud character is the I unless the LIUEUD
cornman~ has been issued to redefine the chatacter.

2.

lf the command LlNENt is issued without any pararreters,
cnly the carriage return will he used as the line delimiter.

3.

When a physical infut lino is read, it is scanned a~a·processed according to the srecificaticn~ in WAITRD.
Iflower case .to upper case conversion is s~ccificd, thei1.<~

05/vl/ ?
3,5;1-2

9-19-67
3. 5. 2-1 d?.
ECHO /.:f3complete physical input line vill be translated •. ThuB 2,,:;-S"',;r·all lc~ical inFUt lines are translated according to ther~~~
initial specification.
3. 5. 2q.

The redefined line-end character. stays in effect until
either CNS is JPLed aqaio er LINEND is reissued.

Pu_: po~:The ECIIO con1111ancftests tcnninal transu1ission by retyping
entered lines.

!,!.Hl!.E1£§:

1.

Format:LINEN[ !

The line-end character is set to the exclamation mark (!)
2.

ECHO

r·---j~-;,~~r-;[---------------,
optlon] :t____ ~:_~ ______ J_______________

LIN ENC

There is nc lcnqet a defined line-end character,therefore, only the carrirqe return will be used
as a line delimiter.

one of the three ECHO options, or if not specified,the default option U is assumed.

optionf j,Ig.,Ljjg§_§g_gg.§:

J

Optio~Ncne.

.!L

The delete characters (~, @)are interpreted, and any lowcrca;e letters arc changed to upper-case.

S

Delete characters are interpreted but no lower-case to uppercase translation is made.

X

N~ change

is made in the line.

Us.age:When the, ECHO con1mand is issued, the Echo environment will beentered an'd each line typed by the user is 1·cpcatcd by the tcrn1inal.

If no option, or an invalid option, is specified, U is assumed. An
entered line is interpreted according to the option specified, if any,
and then typccl out. The keyboard is then unlo(:ked to accept anotherline.
Control is returned to the CMS command environment by typing
RETURN as the first word of a line with no leading blanks.
Notes:
a.

If the X option is in effect, RETURN must be entered without error
to be recognb:cd (delete characters arc not interpreted).

b.

The Ready message following the RETURN request indicates that theuser has left the Echo environment and entered the CMS command

.'

'" ~·

1

$.1.i!iiSi!,,

"'

~

~
ry ;a.u ',,,,.!,PM ··f ¥@@,.ijQ

Jh!@Ji!@ll>!"i'·:~;: ·%B"!'·i~"~'~!ii!i!iif·,,R WllMMJ!t!!JIPM,'f!!!lll!~~.·!!fr!iit'r~~~~IPi~~mlP~'!"~'~"!"~~

""

I"·

134

9-19-67
3. 5. 2-2 // .I
ECHO
f3r·

~

:.)

en vi ronmcnt'.
Responses:
START TERMINAL TESTThe first lin'e may be entered when the keyboard unlocks alter thismessage is typed.
Examples:a.

echo uSTAIH C.O!lSOLF TF.ST

echo retypes any cntereo lines,
F::CHO RF.TYPES M!Y ENTF.Rrn LI MES,

rP.turn'
RETUllN
R; T=0.03b.

echo sSTART CONSOLE TESTlncg¢1mcludln~

nelP.tlonss@, Backspaces, & specl~l charncters,
tn·ctudlnc; Deletions, BnckspacP.s, l't special charactP.rs,

Return!lP.turnP.; T=0~03c.

echo xST Arn r.·or1so1. E IFST

Except In the X mode¢
Except In ·t.he X rmdP¢
rcturrQn
returrQn
returnreturnR; T=O;. 03

F.rror Messa~
None.

_:~)

'~

...

~

"

"'

..

11/01/68
3. 5. 3-1
Ji;:Xli;Cf31/

3. 5. 3 EXEC

,2~!}:f'

3. 5. 3.1 Basic Usage
Purpose:EXEC executes one 01 more CMS commands contained in a specified file,allowing a sequence of commands to be executed by issuing a single comrnarid.
F~Emat:r------·----------------------~------------------------------1
I

EXEC

:
I

·

filename[ argl. .. argNJ . :~------~-----------~--------"----------------------------~----

filennrne

argl .•• argN:. 3.5.3-2
11/01/68
EXEC. ~~.%0'&

Arguments can be concatenated "to the right-hand side of any word in.,,,,,an EXEC line. F'or example, the EXEC line LISTF ADC&l FORTRAN&2
would result in LISTF ABCXYZ FORTRAN if argl is XYZ and,arg2 isunspecified. Use of the double c1uote ( 11 ) for argl would cause the variable
to be ignored leaving LISTF ADC FORTHAN. If the single quotation
mark ( 1 ) is uscl. in place of an argument, the entire concatenated forin
will be deleted. For example, in the above EXEC line if argl is specified
with a double quote (") and arg2 is specified with a single quote (') theline would be juat LISTF ABC.

3. 5. 3.1 Basic Usage of EXEC
3. 5. ~· 2 Special Fc<1tures of EXEC
3. 5. 3. 3 EXEC Control Words
3. 5. 3. 4 Opcr;Lting under EXEC

Contents:

0

r..J6

I

specifjes the filename of a file containing one or more
CMS commands to be executed.
The filet)rpe must be
EXEC.
arc the arguments to replace the numeric variables in
the file "filename E:XEC."Usage:EXEC executes the. sequence of cornmands that arc specified by EXEC lines
contained in the file "iilenamc EXEC".
This file must be in card image form
and must coqsist of one CMS command per· card image in the: same format as thecommand is entcred nt the: terminal.
The filet~'pe fo1· the specifiecl file muslbe EXEC.
EXEC files can be created by the EDIT or LISTF commands or bya user's prograrn.

The EXF;c command is completely recursive, i.e., an EXEC file cancontain other EXEC commands in its sequence of comm<tnds. The recursiveness is limited by core size- -each level of recursion requiring
about 1200 Lytc;s of free storage for data. This limits the depth ofrecursion to app1·o:ximatcly 16.

~
1.

Errors resulting from issued commands are not fatal and do notcause the sequence of comn1ands to be terminatc:d. This Lchavior
may be modified by the EXE~ control word &ERROR {sec 3. 5. 3. 3).

2.

Each EXEC file may contain a maximum of 4095 EXEC lines.

3.

This version of the EXEC command is completely compatible with
EXEC files created for use with the previous version of EXEC comn:.andexcept that in this vc1·sion only one command is allowed per line.
This compatibility may be removed in ·a later version to save spacein the CMS nucleus.

Responses:

As each CMS. co'n-imand in the EXEC file is is.sued, it is typed at the terminal.
Each CMS command in the EXEC file can have from one to thirty numericvariable:;, A numeric variable is made up of an ampersand (&)followed by an
integer ranglng from oric to thirty, i. c., ~d&.2 •.• £.:30.
Before the commandis executed, each vari<1hle v.1.11 be temporarily replaced by an argument spccified
when the EXEC cornrnancl was issued.
For exan1ple, each ti1ne an Bt.l appears
as a variable in an EXEC line, the first argument specified with the EXEC comn1and will temporarily repl;1cc tl1e ~~l, the second argument ~;pecificd with the
EXEC comn~ancl will 1 (·place ~-? :mcl so on to argurnc:n! N of the F.XEC com1nand.

If the double_ rp10Ldion mark(") is trncd in place of an arr,urnent, the corresponding vari;-1b1t: (&.N) will Le ignored in all the cornmands which l·efcrencc thatvariable. If tlic f.pecificcl EXEC file contains n10rc variables than argmY1cmts
given with the EXEC comn1and, the higher numbel'cd variables arc assumed tobe rnissing ;pul will ht· iGnorcd when the co1nn1anc1~ are executed.

!:EE.Or Mes.sages:
E(OOOOl )FILE DOES NOT EXISTThe EXEC file does :not exist. The }<-;XEC command has terminated.
Check to see if the filename specified has a filetypc of EXEC.
E(00003)F'ILE HAS WHONG RECORD SIZE
The specified EXEC file docs not contain 80 character records.
command is terrninated.

The

E(00006)WAITRD OR RDBUF EHH.
This error would result if an EXEC file was erased after the EXEC
command had been successfully begun.

. '11/01/68/IJ"7 E'X"~C
3. 5. 3 -3'/··)
/Y_,, ..,,
_ _-"-_•_ ,p/j /l:f3%

11 /0l /68
3.5.3-1~ .,,%'1Y.;2For example, with the procedure shown in Figure 3. 5. 3-A, the file
ABCD EXEC would be erased, and the attempt to read the EXEC line
containing PRINTF would result in the error.
The EXEC command is
terminated.

exec fortclg llhs
FOHTHAN LLHS
LOAD LLHS (XEQ)EXECUTION BEGINS.
APRIL 1968 Df TA S. 320
T=0.55/1.44 01.30.45

printf abed exec
ERASE ABCD EXECPHINTF XYZ&2
T=O. 02/0.13 03, "15.14

l. 92'l

FIGURE 3. S. 3-B
exec abed
ERASE ABCD EXECWAITRD OR RDlJUF ERR
E(00006) T=O• 05/0. 08 03. 46. 10

S.600

Example of an EXEC file
to compile, load, andexecute a FOH TRAN
program.

edit fort exec
INPUT:
fortran &l (print)

Figure 3. 5. 3-A! ! !E(xxxxx)! ! !
The error code xxxxx was generated by the CMS command issued
from the EXEC file.
Check the appropriate command in the appendix
for this error message.

EDIT:
file
T=0.55/1.43 01.30.50~·mp}~

'Ill

a

a.

In F.IGUHE 3. 5. 3-B the command F:XEC FORTCLG LLHS is issued. · LLBS
is a file whose filelypc is FOH TRAN ancJ LLHS will replace tl~e &l in all
CMS commands in the EXEC file.
The file LLHS FORTHAN is compiled,
and the file LLHS TEXT is loaded and executed, Note that each CMS
command is typed out before it is executed.

b.

In FIGUHE 3. 5. ~-C the FORT EXEC is created b)' EDIT.
The only command placed in the file is "FOHTHAN&l(PIUNT)",The file LISTF EXEC
is then typed o~tt by issuing the PHINTF command,
The EXEC command isthen issued specifying the filename LISTF and the two arguments EXEC and
FOHT. The file LJSTF EXEC was created earlier with the l,ISTF command(i>r.e s~'ction 3. l. 9) and contains the sequence of FOHTHAN files to be com. pilr~d. Each file iclclltificr in LlSTF EXJ.:c is preceded by two symbolicarguments, l'{l anc1 f.:2. The &l is replaced by the first argument specified
with the EXJO::C command which is EXEC and the e.~2 is replaced by thesecond argument specified which is FOHT, The sequence of CMS commands
generated in core by EXEC from the file LlSTF EXEC are then executed, ·the first ·of which is
EXEC FOHT W FORTRAN PS 001.
This commune! executes the sequence of commands in the file FORT lO:XEC
and tcmp0rarily replaces the numeric "ariaLlc &l fron1 FOHT EXEC withthe argument W.
The arguments FOHTRAN, PS, and 001 arc ignored
because there are no variables &2, &3, and &4 for them to replace,. As.soon as the sequence of commands in FORT EXEC are completed, thenext command in the file LISTF EXEC is executed.
This sequence
continues until all commands are executed in the LISTI<~ EXEC file.

-•@;Mca:u410

printf listf exec
&I &2 W
&I &2 SUH2
&I &2 A&I &2 SUHB
T=O. 55/3. 21 01. 32. 15

FORTRAN
FOHTHANFOHTRANFOHTR!'>N

exec listf exec fort
EXEC
· f'OHT
FOHTHAN
W
EXEC
.
FOHT
FOHTHAN
SUB2
EXEC
FOHT
FOHTRANAEXEC
FOHTFORTRANsunn
T=l. SO/l. 80 01. 33. 27!UllllJU!i.L. . ,MIW. . ..li!U.. . . 2iiiL..............iii. . Y@X$. J.U. . . ,,,.&. . .,...# . .Uii! . us. . JU:!!IS2,,.QM. M¥ ·'41'+ $

001.
001
001
001

W

FOHTHANPS

001{PJUNT)
SUB2(PnINT)

FOHTRAN

PS

001

A

FOHTHANPS

001(PHI NT)SUBB(PHINT)FORTHAN:ps001

FIGUHE 3. 5. 3-C~
SAU.$$ ..I.! $.I

PS
PS
PS
P5

The file FORT EXEC iscreated, the file LISTF EXEC
is typed out, and then an
EXEC command is issued
to nest EXEC's •~·..iij#LlJUL::S::i .1..$1! . ;uamuzm::.114:;4444.::;:44,.:;;a;;;:;w•w¥Miili~!

,,....

;~~

11/01/68

3.5.3-5fe/ EXEC·,Y10/~r(/]

3. 5. 3, Z Special Features

11 /0l /68
3. 5. 3-6~EC

.iJ·t,J_.,yA number o! keywords have b·ecn defined to have special meaning andA line ·of an EXEC file sped fies either a CMS command or is an EXEC control
line.
EX:F;c control lines contirol the sequence of commands to be executed,
specify wl1at is to be typed on the console during the ex.ecution of the EXEC
command, or provide input to other command programs or to the BXEC
command itself,have their values set in a spedal way.
1.

&LINENUM - has the value of the current EXEC line number plus one.

Jl.

&INDEX l , , , &INDEX9 - arc used as iJ'diccs and initially have thevalue +l. Indices 1 through 9 may be reset o:r inc1·emented by an
EXBC line. These indices may be set to an integer value in thesame way as the value of any keyword .is set. An index m;iy be
incremented or decremented by specifying the index and theincrement in an EXEC line. For example,&INDEX5 = 30975 will set &INDEX~i to 30975.
&INDEX'/ - 50 will add -50 to the value of ~~INDEX?.
Indices arc local to the current level of l'ecursion.

3.

&INDEXO - has as its value the code number lin register 15 on :returnf:ro1n the previous CMS con1mand.

4.

&INDEX ~ has as its value the number of arguments given when the
EXEC command was issued.

5.

&:GLOBALO .. , &.GLOBAL9 - are used for cornmunication between
levels of EXEC recursion and are set and incremented in the same
way as &ilNDEX 1. .. &INDEX9.

6.

&GLOBAL - has as its value the level of recursion.

EXEC lines, containing either a CMS comr:nand or an E·XEC control, may be
identified with a lahcl.
If the first word of an EXEC line begins with a dash(-)
it is assmrnecl to be a label of an EXEC line.
Labels are used in the controlof the scqltcnce of EXEC lines to be executed (sec 3, 5, 3. 3 - &GOTO and &LOOP).
EXEC lin¢s may contain wonls whicl1 bei:;in with an ampcrsand(gd, ·A word
beginning with an ari1pcn;aJlCl may be either a) a numeric variable, b) a kcywo1·d,i.e., a symbolic V<triable, or c) a control word.
A numeric variable consistsof an ampersand followed by an integer or an asterisk(''.').
A keyword wordconsists of an <llnpcrsantl followed O}' a string of not n1orc than 7 ,·haractcrs atleast one pf which is not an integer.
Control words have the same form as keywords and arc dcfi11cd in scc!ion 3. 5, 3. 3. Numeric variables and keywords aresubstituted for before the EXEC line is interpreted.
Numeric. variables ;trc substituted for by arguments which are specified when the
EXEC coriwnancl is issued (sec 3, 5. 3, 1).
The numeric variable &O is replaced by
the filcnar11e of the current EXEC file.
The numeric variable l:n is ignored whenn is nC'gatfvC' or gr,·ater th;,n 30, or n ir; greater than the nun1ber of argmnents
supplied when the l<XE C command if; isf;uc:cl.
The variable &•.:' is interpreted
to mean aP arguments specified,
When the variable &•::is included in a CMS
co1nmand,. the command is cxcc.ntcd once for each argun1cnt specified,For
examplq, :the commtrncl line EH.ASE t.i:':' ':' would cau!:c the erasing of all files
whose filc'name is the sarnc as one of the specified arguments,
Tbc-val'i<tblc&>::may also be ur.cq in an &IF or &LOOP condition (see 3. 5. 3. 3).
The value substituted for a keyword may bei) specified in an F:XEC line, orii) ·implied i( the keywonl is a special keyword.
The value of a keyword may be: specified by an EXEC line of the form:&KEYWORD= VALUE:
which defines the kPyword ~d'\EYWOHD to have the value VALUE.
Keywords can be re: defined as oftc n as desired.

,

I

\

11 /01/68

11/01/68

3.5.3-7

3.5.3-8~?C.~C ·ff!L

EXEC

f(j

3. 5. 3. 3 EXEC Contrnl Worcls

d4t'rl~4)

The following EXEC control words can be used to provide a versatile andflexible facility for controlling the execution of commands and for defining a user oriented command environment. EXEC control words appear
in EXEC lines which can be interspersed wi•h CMS commands in an EXEC'me.
1)

ac t··1011&QUIT ON sets the return level for a subsequent M1UIT control
to 011e level higl1cr of recursion. Thus, if &QUIT ON is issued
twice ancl if the c11ri·ent level of recursion is 5, an &QUIT n would
cause a return to level 2 with an error code of n.

Action is any exec line without a statement label. Action will be
executed immediately upon an error return from a subsequent CMS
command. If action is not given, &CONTINUE (sec be1ow) isassumed. An error in execution of action, if action is a CMS
con1manc1, will :resu1t in an exit from this level of EXEC with error
code of 11.

Z)&QUIT OFF" will re~;ct the return level to level 0, the CMS
corrunand level.
5)&IF condition action
where condition consists of the three parameters:

&*

[

NE

~~:~:

6)

&GOTO E.XJT is iclcntical to. &EXIT 0 and causes a return from thecurrent level .of EXEC command.
&GOTO label will search the EXEC file starting from the present
EXJO:C line and proceeding to the end of the file, then to the beginningof the file, and finally hack to the present line location, lookiug forthe first EXEC li11c bcgi11ning ...vith the specified label.

7)

r~~bcJ:2 ::s.: :aa.

[con~~ti or]

The numbcri; nl ancl n2 must be less than 4096.

~·~·:.::a:::;.:::;:;::; •:•a:ewwwa 11¥4Z45t 1 :&LOOPThis EXEC control line causes )oopin~ C'ither 1) to and including thelnbclcd line, or ?.) through the number of line~; specified by nl, beginning with the next li11c. Looping continues either 1) until the conrHtion is satisfied, or 2) for n2 times. The condition is specified thesame as with the &JF control word and is first tested before looping.
Loops may be ne~;tcd to a clcpth of 1.

[~]

An'exit !rorn EXEC is taken with an error code of n. lf n is not
given, a norma1 exit with a code of 0 results. If n is negative and
if EXEC was ca1led from the CMS commnnd level the absolute valueof N is returned. ·u this EXEC command was called from a previous
EXEC command a negative value of n will be returned as the error
code in register 15.

.:

I

TOPJ
label
EXIT

&GOTO TOP will cause scqu.cntial execution of EXEC lines to becontinue~ at the beginning of the EXEC file.

A numcrfraJ comparison will be made only i£ both the comparands
arc numerical. For example, the EX.E.:C line: &IF 017 EQ 17 &PRINT
HI would cause the typing of "HI". Otherwise, the comparison in acondition is a logical comparison.

,11111

&GOTO

GE
LE

&PRINT.)

&BXIT

I*J

current line. If n? 0, the next EXEC line to be executed will be
n+l lines after the current line, i.e., n lines are skipped.

&$
anything

and action is any EXEC line without a label. I! the condition issatisfied,, the action is executed. The comparison specified by thesecond argument is made between the first and third argmncnts.
The t..:$ is interpreted as "any of the i;ymbolic arguments." Thus,
the EXEC line: &IF'&:$ EQ XYZ &PHINT HI wou1d cause "HI" tobe typed if at ]cant one of the arguments specified when the EXEC
command was issued was XYZ. Similarly &.>:• is interpreted as"all of the 8upplied arguments". (Sec be1ow for a description of

3)

&SKJP

If n<o, the next EXEC line to be executed will be n lines befo1·e thel[&~' J
L:!ythin~ EQ~

r

/b.W

&QUIT n is similar to &EXIT n except that &QUIT n will return tolevel 0, t'1c CMS command level, reg< rdlcss of the level of recursion of EXEC commands; whereas, &EXIT exits to the next
lower level of recursion.

rl&@NT~J·•

bERHOH

lg~.]

&QUIT

tu J: .. esa;a.:u:wma:e.:um::::JJ::eeee :::::.

4""::uaz..:;"., 11u::::i:u;:t:::a..

...,.1;;.t.;: ,.,J .. •1 .M1'4&,,..,,,,,,.111.c1:~~·1'1~1111•~u•!u1111111•1:::111111111,Hi,,

r

""

~

11/01/68
3. 5. 3-9EXEC

8)11/01/68.,;1¢://?.

3. 5. 3-10
~ .2~\-?'C'

fK1&.CONTINUE~his EXEC line is ignored.

l

It may be useful with &GOTO or &LOOP and13)

is the default action for &ERROH.

9)&TYPEOU.,...

~f{OH

ALL

·This }~XEC line is ignored and can be used to annotate tho .EXEC file .•
rTIHE

1

l~O'J.'IMEj

PACK ][ ~m5ACK14)

ALL causes all CMS command lines ancl EXEC control lines to be typed.

15)

ON causes a 11 CMS command lines to be typed but suppresses the typing&LOOP, &EXIT, or &QUIT or can be reset by typing another &HEAD
contl"ol line.
·

NOEXEC is the same as OFF and is permitted for compatability with EXEC
files created for .use with the previous version of the EXEC con1n1and.

If AnGS is specified, one line will be 1·ead from the console, the line
will be: scanned and used to redefine the numeric Variables. . Th<:~ ~i)er:ial
keyword &INDEX will be redefined to be the number of argurqcnt s read,.
The liue read will not be executed as an EXEC line.

TIME causes the time of clay to be typed preceding each CMS commandline trpc(l.
·NOT]ME suppresses the typing of the time of clay with each CMS commandline.

Only the first 72 characters on a line will be read.
16)&STACK~JJ';]
lL-17)&l)}::GSTACK

This cont1·ol word causes n carriage returns to be typed at the console.

12)l•FIFQ__]
LIFO&TIME OFF suppresses the trping of the time <1ftc:r each CMS command.

[k]

line

If the firi:;t word after the control word is FIFO the line is stackccl in a
First Jn First Out orclci·.
If the first word after the control woi·d is LIFO
the line is stacked in a Last In First Out order.
If not spccific,cJ, FIFO is
assun1ed,

OF1''&SPACEFIFO][ LIF·~1..

All numeric variables c;,ncl keywo1·ds in a line arc f;U_listitut.cd for, ;:;nd theline is "stacked'·' in the input buffer.
Subsequent calls to rear! frum thC!
console will obtain lines which were stacked in the input buffer.

NOPACK ~mpprcsses the removal of excess blanks from a line to be typed.

11)

~ J

If n is~ 0,reading will stop and the next EXEC line wHl Le obtained fromthe EXEC file.
Heading is also terminated by typing t~GOTO, i.'.SKIP.,

OFF suppresses the typing of all EXEC lines.

&TIME will caqse typing of the Hrne since the last time the time was typed.
&TIME ON will cause typing of the time mcssacc after each CMS comma1)dis typed ..

[as

ERROR causes only the CMS command lines which result in an error tobe typed.
EXEC control lines are not typed,l>tTIME

&READ

AHGS
If n is specified, the next n EXEC lines will be read from the typewriterconsole instead .of from the EXEC file.
As each line is i·cad it isexecuted
if it were r<!ad from the EXEC file.

of EXEC cont1·ol lines.

PACK ca9scs t'xcess blanks to be removed from a line to be typed resulting
in only one space between wo1:cli:; in an EXEC line ..

argl., ••. argN&ARGS

The parameters argn inc used to redefine the numeric variables &n andthe special keyword &INDEX is redefined to have the value of n.

[ OFF
NOEXEC10)~/t/I/&COMMENT linoline 1line 2line N&END STACK&PHINT line
"Lincu will be printed on the typcwrHcr console.
All keywords, E"ymbc1lic
nrgurncnl~;, etc., will be :;;uu,;tituted i11tuth::.. line.

This sequence will s.tack lines li1'1e l through lineN, literally without t runcation and will not suhstitutc for numeric varinb)r;f; or kc,ywonb.. Tlii $ !JC:qncnce may be used to specify input Ol" El)lT rcqnc~;l to tlic EDlT co111111<tnrJ.

'l-19-&o3.5.4-1

11/01/63
3.5.3-11

FORMAT~ ,;;;;17
18)

3.5.4 FORMAT

ff.5&SET action~-~~_:_'The FORMAT comnrnnd is usccl to initinlizc a clisk area in the Ctv1S format, or tocount the number of cylindt~rs on a disk.

'fhi s control word has been defi11ccl !or compatibility with old EXEC files
which usctl tht~ c:cmtrol words F.RH and TYPJ·~OUT 01· actions.
&SJ·~T maylater he removed as an F:XJ;_";C control word.

~

Notrn:

numeric variables, keywords, E:XEC control settings, ci.ncl limHc.1lions--.1 All(c. g., max. depth of loop nesting) \ll'e l.ocal to the current level of E:XEC}:~i~d-:w·-·r6~r.unless otherwise noted,

2)3)'-------------~-----------------

Any EXEC control wo1·d may be abbreviated by a. sufficieut nurnhe1· ofcharacters to distinguish the control word from other control wonls.
The following precedence order is observed: EH.ROH, EXIT; SI<IP, SPACE;STJ\Cf<, SET; TYl'}~OUT, TlMF:j ,,~:.er control wordf:, follc•wccl by otherkcywor.cli:. . Keywords cannot be abbreviated.

An error from ;1 CMS c:ommancl docs not cause an exit from the level of
EXEC.

P

spcci.fics that the user's pcrnwncnt disk area is to be
initialized, and any files on it erased.

T

specifics that the w~cr's temporary dit:k are:a is to be
initializc<I, nnd any fil.cs on it cniscd.

ALL

spccifit·r; that Hll tracks Clf the· ~pccifi<:d disk area Hrc
to ht! initialized. If omitted, the first lhr<.:c records of• Cylimlcr O, Track 0 arc skipped.
·C

specifics that the command is a check only, and cylinders
are to be counted, but not erased.

4) · When EXEC is cntcl·cd, the assumed si2tc of the controls arc&EHHOH, ~tCONTINUE, &TIME OFF, and &TYPEOUT ON TIME PACI<.

5)"//:16

H an EXEC line specifics an invalid CMS command, an error code ofE:(-0007) will be returned.
The EXEC command js not terminated.

Us arr~:Errors:----P or T must be specified. According to the option selected, the user's permanentor temporary cli[;k m·ea is initialized by writing n new home address and four
records o.n each track. Any previous cbta 011 the disk is erased.

E(OOOOl)

File doc~s not c~;:ist.

F}(OOOO?.)&.SKIP or t~GOTO error.

E(00003)

Files has '".'rong l'e.corcl size.

.F~(OOOQ.1)

Ke}'Wol·d or argmr1ent error,

E(00005)

Exceeded maximmn depth of loop nesting.

E:(OOOOb)

Waitrcl or Rdbuf error.

E{OOOOfl)

Illegal fo1·m of condition.

E(OOOlO)'

Error in &rGLOBJ\I... or &INDEX usage,

1'~(00011)

Error occurred in attempt to execute &ERHOH's action.

Unless ALL is specified, the first three records of Cylinder 0, Track 0 arc

skipped. Tiic ALL operancl should he specified in the FORMAT command
whenever an unformnttcd disk area is accessed for the first time, and will
not normally be needed thereafter.
If C is specified, data on the disk is not erased, and any files arc preserved.

~
x-DISK: nnn CYL.
The number of cylinders formatted is typed out, indicating which disk was
initialized, If C was specified, this number of cylinders was counted, but not~"'ii l UA¥!l&;41Qf ·!••·ffHW"WtMF!fNP#rii!Mii¥ijj.&fJMf'!!¥!H?f#f!€"#li¥#'f¥1.M. @ ' J,1!!#4

erased.

'~~0\!4Rf. k,Ml!N..,.§,!@"'"!i.!I!"'ij•"'.ii

"

'"'

·11·

M"IM'll'

.ij

"""""

'

.. ·-. -·-·"·.

·"'""** "".-... ;. . .

"" ! l

~

!""\

"""
01··22-68

117

I

3.S.4-2
FORMAT--·.. --..-

if!

·o:l-22-68
3.5.5-1.!5!t '/'/I'.

,.,.11.,,

'.)

Exm~

3.5.5 KEformat p

Purpose:P-DISK; 010 CYL,
The permanent. clisk is initiali2cd hy writing home addresses and four hlauk CMS
records on evc~y u·ack. Any files arc destroyed. The response indicates theuser's permon¢:nt disk Ullllcr er consists of ten cylinders.

The KE command causes terminal output lines to be tnmcatcd to 80 charactc1s.

~~_I'~!-.~-~~g~~I

E(00001),PLEASE Sl'ECIFY DISK: PERMANENT (P) OR TEMPORARY (T) •The first p::irnmcter specified was not P or T.

E(00002)

COrJDITION- CODE 1 ON SIO IN FORMATTING DlSK · (13J\D)'The condition code afttT Start I/O was iSsuecl inclicatei:: theoperation wos not accepted. Notify the opcrntor.

E(00002)

CONDITION-com: 2 ON SJO IN FOllM1\ TIING DISK (13J\D)
The condition code after Start I/O was issued i11clicates the'ctwnnd \l'dS bu:::y. This should not occur under CP. Notify

E(00003)'n1e KE command ls used t:o truncate tern;inal output from an ~;xecuting CMS
command or user program. In order for the KE command to be recognized,
it must be entered after interrupting program execution by hitting the ~mention
key once to transfer to the CP environment and a second time to transfer control
to Ctv1S. Typing KE at this point will cause tcrmi?l;;iJ output 'to be truncated to 80
characters until the command or program completes. Data beyond 80 clwr<1ctcrs
is lost. Normal terminal output will resume after the executing p1·ogrmn h~1s
been complctcd.

COt\'DITION· COJJE 3 ON SlO JN FORM1\TTIJ\!G DISK (BAD)
The crindition code aflcr Sta1·t 1/0 was issued i11dicatcs the
dc\'icc addt'c:>:.;cd is not operational. Notify the operator.

a. }~ntering KE as a normal CMS command will have no effect. KE has meaning
only after two attention interrupts have been generated during progrnm execution.
b. If the k<:!yboard docs not unlock following the second nttention interrupt,.
internal processing is probably taking place which doe;s first alluw interrupts
from the m'i1ltiplcxor channel. As soon as this processing is compktc:d, thekeyboard will be; unlocked and KE may be entered.

Notify the opcrntor.

E(0000-1),CE and DI·: NOT FOUND TOOETIIER (VERY STH.ANGE)
Ch~:n11d c11cl and device end did not occur coJ.-rcctly. Noli.fy'thl' Ojl«J:ator,

E(00005)

Same as 1·:(00002), c'xcept C was specified with th!..! commancl.

E(00006)

CE anrJ D!·: NOT TOGETIIER CHECKING NO. CYLINDERSSame :is E(OOOOl), except C was specified with the command.

E(00007)

Notes:'UNEXPEC'C'ED lJNIT-CirECI~ IN FORMATTING DJ.SK
A tmit check occurred.

c. TI1c character-delete symbol (@) and line-delete symbol (¢) arc iiot 'valid
when issuing a KE command.
'

ExaJ!l.r.le:a. KE·Assuming that the attention key had been hit twice prior to typing KE> CMS
would intercept and truncate to 80 characters any terminal output from thecommand or program in prngrcss.

UNEXl'ECTlm UNIT-CHECK NO, CYLii'-'DERS
Same as E(OOOD3), except C was specified with the command.

Err0r M~ssa~
None.

J

'

I

I

Usage:

the system op'::rat·or.

E(00002),------.
: KE :·------·

01-22-68

01·22-68

3.5.6-1

3.5.7-1

KO

~IY

~(.·'
-KT .L/7.:.,

3.5.6 KO3,5. 7· KT

Purpo~~E~.'.:'..c::_

The KT commnnd causes all terminal output gencratecl by the CMS command oruser progrnm in progress to be suppressed.

'Inc KO command may be issued during the execution of a command or user
program to stop the recording of trace information.

Format:Format:,---------,,·-------,
:

KO

:

:

·--------·

KT:---------I

I

Usage:

Usa~_:_

111e KT command if: used to stop tcnninol typcout from an exccutin~ CMS
commnncl or user program. In order to enter the KT command meaningfully,
the attention key must be hit once to interrupt execution and transfer control to
the CP environment and then a second time to trnnsfer control to CivlS. Program
execution will continue but the keyboard will be unlocked to accept user input.
Typing KT at this point will cause all further terminal output' from the executing
commnnd or user program to be intercepted and suppressed. Execution will
conlinue to normal program completion, when the Heady mess;:ige will betyped out and normal terminal output will resume.

The KO command causes recording of trace information, initiated by the SETOVER or
SETERR commnncls, to be h::ilt:ed. KO differs from the CLROVER command inthat it may be used to clenr overrides during the execution of a progr.am. In orclcr
for the KO command to be recognized, it must be entered after interrupting p.rogrnm execution by hitting the atlc,ntion key once to transfer to the CP environmc11t
and a second time to transfer cont:col to CMS. Typing KO will then en use nll
overrides to be clc<1rc<l, and no further trnce inforrn:~tion will be rcco;:ded. Program
execution will continue to its normal completion, and nll recorded trace i11fonm1tion
will be printed on the offlinc printer..

Notes:~~.£.§:__

Entering KT as a nonnnl Cl\1S command will fove no cffc:c;t. KT will havemeaning only :iftcr two nttcntioll internipts have been gcncrnted during program
execution.

fl.

a. Entering KO ns a normal Cl\1S co111mand will have no cffc~ct. KO hns meaningon]y nftc1: tw1J attention interrupts IJ3ve been genen1Lcd daring program execution.
b. If the kc)·boarcl docs not unlock following the second attcntinn interrupt,
internal processing is prob::ihly t<'king place which docs not allow interrupts fromthe multipkxo1· ch:innd. As soon as this p1·occssing Js completed, tlK! keyboard
will Lw unlocked nncl KO may he entered.

b. If 1Jic_."keyboard docs not unlock following the second attention intern1pt, internal
proccssint!' is.probably taking pince which docs not allow internipts from the multiplexor cha1111d. As soon as this processing is completed, the kcyboord will be
unlocked and KT may be entered.

c. The character-delete symbol (@)and line-delete symbol (¢)are not valid whenissuing the KO conuna nd.

c. The charnctcr-delctc symbol (@} nnd line-delete symbol (¢)arc not valid whenissuing a KT commnnd.

!Gsuing the KO command will have no effect unless a SETERR or SETOVER
comnwnd has been issued previously.

d.

Example:a. KT.!i~~!'l1.~~

Assuming that the attention key had been hit twice prior to typing KT, CMS wouldintercept anCl suppress any tcrminni output generated by the pro2'ram in proi~ress.

a. KO
Assuming that the> attention key had been hit twice prior to typing KO. CMS willstc•p recording trace information and ot the completion of the currently executing
program. all recorded trace information would be recorded on the offline printer.

Error M.essages:
None.

Erro!._M~-~~f.~~

None.

"

~

~

....

~

IF" . ll,~·0'.J/C, '69
3.5.8-1

KX

J.~.E;J',.p/(/05/(1" '"93. 5.' . 2

te-IPlcd.

the CHS cc1aand EDYi£cn1ent iE thEn entered.

t/~1
f..YHHfil!ilQ..!~§.§Jl..9..§Jll~t.e

KX ccn~and causes the eiecuticn of any CMS command oc user
EICgtam tc stcf, closEs any cfen files and I/O devices, re-IPL's
c~s, and returns the user tc the CMS cc11and envitcn~ent.

tlcne.

· UH.2.!lKX.Y.§A.9.§.£In ctdEt for tha KX ccmeand to te recognized, it must be issued
after intercufting FCcgran executicn ty titting the attenticn key
ctce tc ttansfQt ta the CE environrner.t and a seccnd time totransfer contrcl tc c~s. Issuing the ~X command will then clcse
any q:en l.iser files and sii:;nal CP that the user 1'.as nc ncre I';O
fer cfflinG devices.
After Ufdating the user•s file directory,~X re-!fl's CM~
frcm the sa~G dEvice as it was initially IPLed,and th£ user is iotutred tc the CHS comaina environment.
]£~.§.J'I:\

a. lnteting KX as a nocoa] CMS ccm~and will have no effect. KX
has D~aninq cnly aftet t~c attenticn interrupts have been
generated ducjng prc~raro execttion.

t. · If the kcytcatd dces Dot unlcck fellowing tke second
attenticn inte1ruft, internal (rocessjng is (rcbably taking Flace~hich •oes ~ct allcw intertt(ts from the multiplexor channel.
As
Econ $S this processing is ccrofleted the keyboard will be
unlcck~d and KX ;ay he enteced.
·
c. !he cbaracter-Jelete S)nhcl (a)an~ line-delete
ate not valid •hen jssuing a KX ccromand.

syttbol (¢)]!.§1:.Ql!.§..Ll

chs Version ,x.xx XX/XX/XX
1his res1cns~ is typed ~hencver KX

is inter(teted,as CMS

isJ;lf"~.

f

4-01-68

4-01-68

LOGIN

3.5.9

tS3

Purpose:E(OOOOl)LOGIN U FD FAILED
The user's file directory has not been successfully
brought into core. If the command fails a second
time, issue the NO_UFD command.

E(00002)

LOGIN NO UFD FAILED; TRY FORMAT P
The LOGINNO UFD command has not been executedcorrectly. Issue the FORMAT P command.

E(00003)

PLEASE 'LOGIN UFD' OR 'LOGIN NO UFD'
An invalid operand was specified with The LOGIN. command. Reissue the LOGIN command in its
correct format.

LOGIN causes the user's files to be either saved or deleted, as
specified.
Format:r -· ; -- - - - - - -r - -· - - -- -- - - - - --,\ LOGIN

J~Messages

LOGIN

!

.11

3. 5. 9-2
LOG!N 'fS

3.5.9-1 //1; l LOGI ~'·. - - - - - ..

I

)

:

._

- .;
•·

.

UFO
(
UFD

I

l NO_ J- -- ....:.
- ... .....
.

.

..

UFO

indicates that the user's file directory(and hence all existing disk files) areto ~e saved.

NO UFD

indicates that the user's file directoryis not to be saved, effectively clearing
his disk area and all files stored on it.

Usage:The LOGIN command, if used, should be issued immediately
after the CMS Command environment has been entered in
response to an IPL command, console function, or request.
LOGIN must have an operand, which is either UFD of NO_UFD.
If UFD is specified, the user's file directory, and hence all of
his disk files, will be maintained as they presently exist. If
NO_UFD i's specified, the user file directory will be cleared
and all disk files will, in effect, be erased. If the LOGIN
command is not issued when the user first enters the CMS
Command environment, LOGIN UFO will be assumed and all
existing disk files will be saved.
Examples:a.
LOGIN U FD
The present user file directory will be maintained as it currentiy
exists and a compacting routine will be called to eliminate any
blank entries caused by files which were erased during the last
tl-'?rminal session.
b.
LOGIN NO U.FD
The user's file cfi'rectory will be cleared, in effect erasing all of
his files currently stored on disk.

~,. 1141

"'""

.:)

~

~

411011;:1 ,. :iMll@bQ,OIPiiiiQ!ii44#11U-#:U44iii@¥1UCJ!J#lli,£#.!C:UQ4U::411Uii.llil1111;;::a:.11if:Ziill•1:•:J: ••a1:«1l!Ptli#i41 Ill ll/•tu111:11 !l'9illlii!!;au1111uuJJJ:;;w1:m;::;;;:.tii!M¥.,.n:;u::;1 ::11:u:;:: JU'''.

+••:•••••11• 1m~

.~

~

~.

%6

05/01
3
3.5.10-1
3.~.1C~~flCGCU'I~-.s.f.Y!Hg:lhe LOGCU1 ccfu11and cc1racts the user•s file directory, executes
1ny CMS ccmmand specified as an operand,
and loqs cut of CMS,
transfetrjrg ccntrcl tc thE CP environment.

c.

ouc

~4W

if theEven

LOGOU1 ccrrand is issued in CMS, it is also
ncc~ssary to
loq out from the control Prcgram. The CMS LOGOGT
command car te byFas~ed, but the CP loqout com~and must be issu~1
to lcq off the system and ~isconnect the telephone line.

!ls:i.E2.D.§f.§:
R;'T='l<>i. >ix;xx. xx
hh. mo.ss
EN'lEFEC, REQUFS'T, PLEASE.

C~.ff!H.1:

lCGCU'!
LCG.

anycom<anyccrr>·- is anyc~scommand~3.Hs:

IhiE mesEase will be typed whenever the lCGCUT corerrand is issued
in the CMS Ccmnand envircnnett. The first M~.xx is th~ total CPQ
time in secc~ds fer CMS executicn. !he seccnd xx.xx iepresentsthG• totdl CPU time in seccnds f cr CMS and CP. These times ar~
totdl timeE for the turminal session.
1hc keyhcard will then heunlocKEJ tc ~ccert dny CP ccnscle functicn.
·~1.H.iJ.!:!:.1.

loyout12.15.28
REQUEST, EIFASE.

R;T:1E.32;43.~1

CE
LOGQU'l cc11ira11dinetreqi;ired 1ohen use cf: CMS has teencorrs-lcted. lf is:;uE=d, owevHr, it will cause a compact.ir'} routine(ii!entic.:al to th~H \oh ch is called whe11 the STJIT C command is
i$sued) tc te c~lled. This rcutine reorqani2es the user•s fileJ1rectc~), clireinatin~
blank entries resulting from files which
huV€ teen c-rascd dutinq the current terminal sP.ssion.
In
1uditic11, lCGOUT
1oill execute any CMS co!fmand specifi(:'d as its
cpct'and .11is·a, fer exan1ple, to ott.ain ;i list cf the newly
cr-Janize<l file ditli"ctcq).

E~1E~E[,!ht

ttE i<cady rreEf<HJC 10ill tc tyi:;€d indicating in seconds
the CPU tlD!: used duti11q this tetmin.11 f:~f:sion for cr.s Hxecut.ionu; 1wll ~:: CMS and er- executiou.
The revised usoi: file directory
will te w1itteri cut tc disk and control will be transferred toth~ CF c~vircnrnent.
finally,thecornpacti~g rcutin~ will te called, tho indicated messaqn ~illtyµei
at the terminal, and central will transfer to the CP
cnvircnment 1oh8re the ~eytoacd will be unlocked tc accept any CP
console turcticn.
t~t.

109cui listf

The corrract1nq routine will be called, the LISTF command willty~e out the ccntents cf the reorganiznd user file directcry, t~~loqout mcsEage will te typed and Ccntrcl ~ill transfer to the CP
anvitcnment ~h~re tha keytoard will be unlocked to accert any
console futcticn.
HH.Lkl§.££s.9£J;:}.Qh.§:~one:.

~.

the fact thclt
the userfilu direct-ory is up<lated on
afte1 tho coropleticn cf each CMS corrroand,it is notneccssar~ tc LJGOO'T
trcm CMS tc insure that the user's files be

Given

Jisk

saved.

b. In otder to lcq out from the CP-67;CMS system witlout usinq
the LCGCU'T ccnnard, hit thP attentict key once tc iransfor
co11t~ol tc CP dnd ty~~ IOGCt'T tc lcgcut frcm the Central Program.

.)

3.5.10-2

01-22-68
3.5.11-1

01-22-68
3.5.11-2
STAT /6(

~

~ 1~1

.-:)

Responses:

3.5. 11 STATP-DISK:nnnn RECORDS IN USE, nnnn LEFT (of nnnn) 1
nn% FULL (of nnn CYL.)This response is given for the permanent disk, and then for
the temporary disk, unless P or T was specified, in which casePurpose:The STAT command is used ·to (1) type out statistics on how may records of theuser's permanent and/or temporary disk areas are currently in use, (2) typeout the current user-defined commands, or (3) execute a routine to compact
information in the disk management tables.
.
Format:information will he given only for the specified disk.

DEFINED COMMAND(S) = commandl ••• commandN
Up to five defined commands are listed by name.

__(____\_ ---{-f}_____ _<STAT·~s

NO DEFINED COMMANDSThis response is given if the user has no defined commands.
NO KNOWN T-DISK

0)--~---~----

This rcsponoc is given wl1cn T is spcc~fied, but no temporary
disk is configured on the user's virtual machine.

c-------------

Example:P

specifics that only statistics for the permanent disk are
to be typed out.

T

specifics that only statistics for the temporary disk are
to be typed out.

D

specifics that only the user-defined command? are to belisted.

cstat
P-DISK: 0771 RECORDS IN USE, 0229 LEFT (of 1000), 77% FULL (of 025 CYL.)
T-DISK: 0000 RECORDS IN USE, 0040 LEFT (of 0040), 00% FULL (of 001 CYL.)
DEFINED COMMAND(S) = EMSPRIME SNAPR
Since no options arc specified, P, T, and D arc assumed.

Statistics for the permanent and temporary disks are followedby the list of the user's defined commands.·

specifies that the compacting routine is to be executed.

Error Messages:

If no operand is specified, P, T, and D are assumed.

None.

Usage:The STAT Command will give a count of the records in use on the user's permanent
and/or temporary disks, the number of free records remaining, the percentnge
of assigned records in use, and the number of cylinders assigned to the user.
Disk records are always 800 bytes long.
·Any user-defined commands may also be listed using STAT. These are commands
which have been written by the user and entered into the system file directory by
the DEFINE command.
If C is specified in the STAT command, none of the above actions. are pcrform':!d.
Instead, a routine to eliminate unnecessary space in the disk management tables
will be executed. This routine ls always called automatically when CMS is initialprogram loaded and when the user issues a LOGO~ command to CMS.

--[...,., s..
lil!ll•I .. i!Jili

4s::t,;,.MU,iWMJQJ4;ss:::.a4ab:..z.:~.J ······Li,,..

I .JJ.

,,; ,,HI·~j j' '

ii.

JillL _ii !iii !Ji JJQ ifZU:QISJ@4Q,QQ.Al.,,kl,,SJUJIL,l . ,,L.AWi,AU#Ui,&TUILUiiiiiiii:UU!Lm

""'

~·

'""'
4-01-68
3.5.13-1
MAPPRT,ff.()

05/01/69
3. 5.12~g/~'f"01

3. 5.12 BLIP
Pur,eo~The BLIP comr--and causes a string of from ,..,ne to eight characters to be typed
periodically during CMS operation.
The BLIP characters are 'typed out after
every two seconds of CPU execution and give the user a!l indication of theexecution time of his program.

:--.. . ------:- ---------------

Format:

:

:

BLIP

I

:

:
I

chars

--.
:
J :

-[-:~~~~s-

1

--z~

:

~~

~-~-------:---------------~---~--------~
where:
chars

is the character to be typed out, andcount

is a digit from l to 8 indicating thenumber of BLIP characters

3.5.13 MAPPRT

Purpose:
MAPPRT creates, and optionally prints, a file containing a
map of entry points tn the CMS nucleus.
Format:l

f r~::::l-f[1~-f-[-l~~:r;-J-]___: \ MA p ) : l £ J I NO:
L---------- ----------------A

creates tl1e file CMS-NUC ALPHABET P1, containing
the riucleus entry points listed in alphabeticalorder.

N

creates the file CHS-NUC NUMERIC P1, containing
the nucleus entry points listed in numericalorder.

ccreates the file CMS-NUC ALPHANUM P1, containing
both the A and N orderings.

ONtypes out the file at the terminal.

OFF

prints the file on the offline printer.

NO

specifies no output is requested.

Usage:The default setting of the BLIP characters is a sequence of non-printing
characters - a shifting of the typing clement from low1~r case t-0 upper case.
If it is. desired to have a printed· recording of the execution of a program, theBLIP c;:hara:ters should be .changed to printing characters, e.g., a single dot.

~

Usage:
1.

If ~he count parameter is defaulted a count of l is assumed,2.

lf,thc first pa1·;:tmcter is zero or if both parameters are defaulted, theBl--IP characters arc reset to their non-printing default setting.

3~lf, noncharacter codes arc desired, the cigh bytes !or the BLIP characters
can be specified in hexadecimal in an Assembly Language Program.

Error Rctur.ns:

None.

.

.

The MAPPRT command creates a file on the user's permanent
disk containing a list of entry points and their addresses
in core. In conjunction with a listing of tl1e CMS routines,
this information allows the system programmer to exar1ii.ne. or temporarily .modify the nucleus in stornge.
The first option specifies the format of the list. The
entry points are listed in alphabetic order if A is specified. If N is specified, they are listed in the order inwhich they appear in core. If no option, or C, is specified, both types of list arc combined in a single file.
The filename of the file created is always·GMS-NUC. The
filetype is ALPUABI::'l', NUMERIC, or ALPH.l\NUM, depending on
the option Specified. Sec Figure 3. 5. 13-A fQr examples of
the three types of format.
The second option specifies whether or.not the file is tobe typed or printed. ON specifics output on the terminal,~nd OFF specifics output on the offlinc printer.
If nosecond option, or NO, is specified, no output occurs. The
file is always left on the permanent disk, whether or not
output is requested •1l: 14-01-68
3. 5. 13-2

/j(,f

MAPPRT

A!"IF:ND.~CTLKP:Not•~:.

a.

b.

4-01-68
3.5.13-3
MAPPRT

printf cms-nuc alphabet. ,,!

ACTT /\R
ACTTAlALTER
ASf·1ADDR
P,ATCH

If only one or two addresses are needed, the N option
avoids the CPU time needed for an alphabetic sort of theentry points. Any address can be obtained by using the
LOCATE request in th EDIT environment.

AT OC068
AT 03C:OF.
AT Ollf8ft.;L.

AT OlHOt\T 00000

AT

00~7.0

AT 00000!3ATSWTAT Ol\2CA
gcKSPACE AT OCOG8r,nrnur.
AT or~F84
BUFFrnAT Oi\5F8
CAR DP!!
AT OC2B8MAPPRT should only be issued after CMS has been initialized(by IPL 190), as MAPPRT uses tables set up.by the nucleus
loader.
~~pan~

None, except.undc;r the ON option, the file is typed out.

printf cns-nuc numeric~~mplcs:a.

MAPPRT

With no options specified, both the default options are taken.
The file CMS-NUC ALPH.ANUM Pl is created, containing
both an alphabetic and a nurncric listing of the nucleus entry
points.
b.

ALTER
OATCH
ER/\SE()FFL I fJF.

SYSCTL(TflPEIOUFDFLr.
flUCOll

USFL
STADflll

MAP PR T C OFF
The same action is taken as in Example a, and the file isprinted op the offline printer.

T!3U!G

LSlf.IDRLOCCNT

AT 00000
AT 00000.l1 T 0 0 0 00
AT 00000
AT 00000
AT 00000
AT 00000
AT 00100
AT 00108·AT 00110
AT 00118
1'T 00 Ir.4
-AT 001C8

Err•n Messages_;None

prfntf cms-nuc alphanumMENO
ACTLKP
AC TT ARAC Tl AlAL TF.R
ASl·IADOR
R,\TCHfil\TS~'/T(,,

AT OC068
AT 03COF.

r..T ours

AT OllFO
AT 00000

AT oor.20
AT 00000
AT Of\2CA~CKSPAr.E AT

BDF.BUGBUFFER

OC068

AT 0'3F84

AT 0A5F8/\LHR
f3f\TCll

f:RASEOFFLI tlE
SYSCTL
T.f\PE 10
UFnFLr,~Hlr.OM

USFL
STADOR
T8LNr,

f\T 00000
AT 00000
AT 00000

aoooo

AT
AT 00000
AT 00000
AT 00000
AT 00100
AT 00108
AT 00110
AT 00118

Figure 3. 5. 13-A. Samples of thC' thre<' types of nucleus map files
created by MAPPRT. Only the first few entries of each are
shown.

J

4

-

""

~
,,

me 1.u:mm=tlJU.Ji!llLK&S:Uli "'Uliliil, . iiitJii!iiiJIL!t,. 1J. ,,··Jti.liJ,,L. ,.,,,L.. IJJQ.,,. . . ,.J.L . Ji Ci!L . . .Ji!U.LU. . . . JIU .. 2113$1, . IIUJt . .,. . ,,.Jllil!JlJJJ . i . . l4411 ·ijtzli . . J1.£!!JJJ4M ... JJJii4&.4MMl4.ilftll.'9Jl•ltAt.,,41 llHWW~

.~

.~

""'

•
7-19-68
3. 5. 14-1
!PL

/t3

3.

s: 14

IPL

11/01/68
3.5.15-1
fGf RT~,<

3. 5.15 RT

Purpose:

Purpose:IPL causes a new copy of the CMS nucleus to be initial. progra1u loaded.'

The RT comma"ld restores the typeout at the console previously suppress"dby the KT command.

Format:Format:,-r----------;
'IPL.

I
I

.

I

4

l

I

I
L- -·- __ : _ --- _Itt'- - - - J~age:

Usage:'I'he RT command restores console typeout from an executing CMS con1mandor user program that was previously suppressed by the I<T com.mand. Inorder to enter the RT 1command meaningfully, the attention key must be hit
once to interrupt execution and transfer control to the CP environment andthen a second time to transfer control to CMS. P1·ogram execution willcontinue but the keybo~trd will be unlocked to accept user input. Typi:ig R 'I'
at this point will cause all further console output from the executing c:orn1n;:,11c!
or user program to be typed out. Execution will continue to normal program
compl.ctioi1.

This command performs the same action as the IPL console function.
Both will cause the CMS nucleus to be initial program loaded, although
the copies of the nucleus which arc brought in will not necessarily be
the same in both cases.
The IPL command and the "IPL 190" console function will load in the
copy of the nucleus which resides o~ disk 190. Periodically, a copyof this nucleus is saved by a CP utility. The "IPL CMS" console
function will load in this "saved 11 copy of the CMS nucleus. Thismean,s that if the nucleus on 190 has been modified since the la·st copy
was savc:d, the versions r~ferenced by the IPL command and the IPL
console function will be different.
Rcspons'e:··
CMS • •• VERSION I. 0 - 05/01/68
This response indicates that a new copy of the nucleus has been
loaded and that control has transferred to the CMS Commandenvironn1ent.

·Example:

a.

;;~-.
I

Notes:a.

Entering RT as a normal CMS command will have no effect. RT has meaning only after two attention interrupts have been generated during program
executio.n.
·b.

If the keyboard docs n(lt unlock following the second "attention interrupt,
internal proc-essing is probably taking place which docs not allow ii1tcrrupts from the multiplexor channel. As soon as this processing iscompleted, the keyboard will be unlocked and HT may be entered.

c.

'l'he character-delete i;ymbol (@)and line-delete symbol (i) arc not valid_when issuing an RT command.

Example:-ipl
CMS • • • VERSION I. 0 - 05/01 /68
A new copy of the CMS nucleus has been initial program loaded andthe keyboard will be unlocked to accept any CMS command.

a.

RT
Assuming that the attention key had been hit twice prior to typing RT,
CMS will restore any c:onsole output generated by the program in progress.

Error Messages:

Error Messages:

None.

None.

05/01/6~.! • 'j. 16

J,.rn~u..u05/01/69
3.5.16-2

3.5.16-1

765 A'47,l6

zw~

f6t

!~2Hl£§:!.!!H.Q§.9:~.

CttARDEF rcdef ines the
hdtdware f tncticns • •loqical charactersthatcorrespcnd

to

CHAFI:EF C 1

1hE character delete syrrhcl isused as a r.crmal craracter.

no~definedt.
CHHI:H L
1hE line delete symbol no lcnqer exists.
a ncrrnal c~aracter.

!H.rn~J:I

CfiAtltEf

I tuncticn

II<rerlacEment character> I

code

tur.cticn ccrle

a

as ?.

The

The

can le usen ast.

can he'1H.L].Slj§.!!.9£:I~(00001)- Illeqal function code was specified.

signifies th~ EOJT lcqicaltacks(ace character.

csignifies the character
dcle te sy 111 lol.
denotes the line delete sy"bol.

trq:lacEirent
characterEignifies the EDIT lc1ical
tab character.

is the 'cha1acter to be used fer
the specified function.
If a rcplaceaent
character is net srncifiel, there will
te no syrutol for that fu~cticn •'\.

.Y! .Bs:
rhc ~redefined chatactecs in CMS fee thP character delete symbol·and the line delete symbol are the ai and t respectively. If acharacter is net EfECitied ~ith either chardcf C or chardef L,
thc.te is nc delnte syml:ol for a character er a line.
1he rredefined loqical tat character atd tackspace character in
EDI1 ar~ the a and the 'respectively. If.R cc T is specified,
EDI~ and
CICI7 cc~n~nds will cause refer~nce tc be made to theredefined ~ynbcls each time either editor is invoked.

lhe functicn symbols that are redefined tenain in effect until
Either(1)
Cl'IS il' te-IPlEd,(2) .nether CHABCH ccmmand isitisued, cl (3) the user loqs out of CP.

•
~
:miu

ltillli4iiiliil$..

I·····"•.•" .. , , . , , .

., •. , . .

. .,,

,.,

•

~

II a . 4 Ji ,$ . ii! ... IW . .Jiih""'·''·lb!LJJll!Uwlll£i&tl.tliiJ.iU£!11LJJiiiilUU

fl"'

~

l~

05/0116~

05/Ci ./ o9,,/, 3.5.17-1;.:.11

it7 /!rK

CPPUNC'JN

3.5.17-2

1.

CPPUNC1NEXECUtES

1 i.1.U~.lHn
lne CPFUic~N ccmmand transmits console function comrands tc CP-67
withcut lElving the victual acde cf c~eration.

2.

CPf
~OHSG
DElACH
COE
Executes a DETAC~ command.

It OOE is nota valii addres&, the BAD ARGUHENt messa~e~ill net be ty~ed.

l ~!.!! ~J::

C.PtU~LH

string<NC1'1SG>CH

NC MSG

Cfticnal rttqu~€nt tc tutn cff tyfingof 1 UAt ARGUl':ENT' and 'lNVALif. CP
lHQUFS'I' meEsaqes.

str i'1o.J

a CP:67 ccnscle fuccticn.

.Y!JJ,!l:C•FU~C1N
iss~c~

is ftoviJeu

fccn

CMS

tc ·allcw CF-67 consclo functicns toand to te incorporated in EXEC files.

b~

,.
\

lH:J.L!h.~rng~f=2:

E (OOC0;1)

FUN~TION

M!SSlNGNe string vas!(CCC04)

lNVALit CE~~ecified

cc~mand.

FE~UEST•strirq' is net a
E(COC08)\ith the~toper

CF-67 conscle functicn.

~Ar ArlGUMcN1
1he arquments supplied ar£ net rrcper fer

tte srecified ccnfclc function.

\! (XXXXX).h.1Ul~§:Any othft ~tree ccJcs ate de~enucnt on the
rarticular console function desiqtated •XFER OOD tc CSC1
an XfF.R CCR!OlE f unctioo.

#J!¢?

£/tY

11/07 /69

3.5.184fog', I

3.5.193.5.18-1
DIVERTSW

3.5.19-1

4(, 8'.. ::2_.

TlNELIM

DIVERTSW
Purpose:

11/07/69

TD1ELIMThe DIVERTSW command will set a switch either
on or off for diverting certain terminal output
to the offline printer. Output for Fortran
logical unit 6 and PL/I FILE SYSPRINT can bediverted to the printer without an intermediate
file being created on the P-disk.

~J

Format:

DIVERT SW

Usage:

DIVERTSW ON sets an indicator which is later
tested during either Fortran or Pl/I execution.
Subsequently, all output destined for theterminal will be diverted directly to theoffline printer. This command can be convenient
whenever large amounts of output are expected
and P-disk space is too small to accommodate
the output.

Purpose:The TlMELlM command will set a time limit for
the execution of any command and terminate
execution if the time limit is exceeded.

Format:TlNELIM

NONE.

Notes:

a.

[n2]J
-

where nl = number of minutes
n2 m number of seconds
Usage:

DlVERTSW OFF will reset the indicator to output
to the terminal.
Responses:

D
l
_Q
FF

TlNELlM nl n2 will establish a time limit ofnl minutes and n2 seconds for the command which
immedi.ately follows TINELIM. If the executionof the subsequent command exceeds the time
limit, execution will be terminated. If thejob is completed within the time limit specified,
the time limit is no longer in effect. TIMELIM
with no parameters sets the time limit to adefault value of ten minutes.
TlMELIM OFF nullifies the effect of a previous
Til1ELIM command.

DIVERTSW does not close the printerautomatically. Therefore, the user
must close the printer file after the
program completes execution. This isdone in CP with the CLOSE function
CLOSE OOE, or with the CMS command
CLOSIO PRINTER.

Responses:

Til1E LillIT EXCEEDED ••••• EXECUTION TERNINATED.
This message is printed immediately before a
KX is issued.

Note:

If a TIMELll-J command has been specified, no"blips" will occur during the execution of thetimed job.

Examples:a.

TIHELIM 14$ FORTPROGb.

LOAD ITERATE SUBl SUB2TIMELil1 35 30
START

Errors:

,..,

•

none

"'

,...,~·"'
11/12/69 4fpg','3:i. 5. 20-l-~

3.5.2011/12/69

3.5.20-2
Qfil1ll

GETLIB

Purpose:before the library disk.
The GETLIB command permits access to files on alibrary disk.

~erid devadd ~SS.is

Format:b.

xxxxxx~~GETLIB~F

Useridspecifies the owner of the disk to beaccessed

Devaddthe owner's virtual device address inhexadecimal

xxxxxxxx

read-share password of the library disk

OFF

discontinues the use of the library disk

All files which reside on a library disk aretemporarUy assigned the mode letter, T, by

CMS.

c.

All library files are read-only.

d.

The abiltty to specify a password in the
GETLIB cc>mmand itself is provided for added
flexibiHty. It is ·specifically designed
for use j~n EXEC procedures. However, the useris cautioned to set type-out of CHS conuuands
off {&TYPEOUT OFF) to prevent the printingof passwords cm the terminal sheet.

Error messages:
Usage:GETLIB is provided so that many users may share
a common library of files. It is a space-saving
mechanism designed to eliminate the need forstoring ouplicate copies of certain seldom-modified
files on several users' P-disks.
Issuing a "GETLIB userid devadd" command will provide
access to a library disk via the following sequenceof events: Device 192, if it exists, is detached;GETLIB then LINKS to the user id 1 s devadd as 192;and finally the tables which reside on the librarydisk and describe its contents are read into core.
GETLIB OFF detaches device 192 and clears the coreresident tables associated with that device. GETLIB
with no arguments requires that device 192 is alreadyattached. It then makes the linked disk accessible
as a library disk.

Responses:

DEV 192 DETACHED
Either a "GETLIB OFF" command has been executed,
or 11 GETLIB userid devadd" has been issued subsequent
to other GETLIB commands.

Notes:a.

In accessing files. the P-disk will be searched

E(OOOOl)

An inval:l.d GETLIB argument has been detected.

E(00002)

GETLIB has been issued with no arguments, andno disk has been attached as device 192.

Examples:1.

GE1'LIB LlBMACH 191
Device 191 of LlllMACH is attached and its files
are made available for use.

2.

GET LIB OF'F
The library disk is removed.·

3.

GETLIB

User's device 192 now becomes a library disk,

4J:.r.f.·1
11 /12/69
3.5.21-1
QUICK

(

•

3.5.21 QUICKThe use of the QUICK environment allows the user to create,
edit, compile (or assemble) and execute files without
continually referencing the file by its identifier.
Fonnat:I
filename

I. QUICK

filename

specifies the filename of the fileon which operations are to be
performed.

f iletypespecifies the f iletype of the fileon which operations are to be performed •If the second argument is omitted, afiletype of FORTRAN is assumed.

."(
Usage:The QUICK exec procedure is entered. Filename is the name ofthe program to be created, edited, compiled, or executed.
SYSIN indicates the program is written in assembly language,
PL! indicates a PL/l program, and FORTRAN indicates a FORTRA~
program.

An asterisk is typed at the terminal upon successful entry into
QUICK and after the completion of subsequent QUICK requests.

gurcK Reouests:

The re~uests described on the following pages
Some of the requests,
however, are not valid for all three languages. QUICK
responds to invalid requests with the message: INVALID QUICKREQUESTare valid in t11e QUICK environoent.

EXAMPLES:
1) QUICK TESTFILEQUICK entered-operations to be performed on the file,
TESTFILE FORTRAN.
2)

.

I

Purpose:'·.

I

Q EXAMPLE SYSINQUICK entered-operations to be performed on the file,
EXAMPLE SYSIN.

11/12/69
3.5.21-2
QUICK

ERROR MESSAGES:
1) WRONG ARGlJ}fENTS-CMS ENTERED
Retry with valid arguments.

•

.,

..

11/12/69
3.5.21-3
QUICK
CMS

:c
··--CMS

Format:.I
Usage:The CMS request unlocks the keyboard so that a CMS command canbe entered; this corrroand is executed immediately and control isthen returned to the QUICK environment.
Note:

(

Any CMS command may be entered following the CMS request·.

Error Messages:

none

..

.
II

11/12/69
3.5.21-4
QUICK
COPY

COPY
Format:Languages:

Fortran, Assembler, Pl/l

Usage:The COPY request saves a copy of the current file as f ilen&~e
EXTRA•':•b': Pl.
If filename EXTRA•b'd: Pl exists, it is erased
before the fresh copy of the current file is created.
Error Messages:

none

(

..

( ..

~

11/12/69
3.5.21-5
QUICK
DATA

(
DATA

DATA

Languages:

Fortran, Assembler, PL/1

Usage:The DATA request provides the user with the capability of
specifying only once the terminal input to the current progr&~.
This is acco~plished through the automatic creation of a file
(DATA**** EXEC) which is saved on the user's P-disk.

If the user issues the DATA request with no parameters, QUICK
responds with:
ENTER INPUT DATANEW FILE
INPUT:(The data which would normally be entered from the terminal isthen entered in the format expected by the program. Multiplelines are permitted. When the desired data has been entered,
•t
.
.
•
•
•
h__ i_
an exLra carriage
recurnanu,-1 upon receivingthesys t emmessage, EDIT:, type FILE. This saves the data entered andreturns to the QUICK environment (an asterisk is printed).
Each time the $ request is issued, the data entered via the
DATA request is stacked in the terminal input buff er such thateach prograrr,.rJed read to the terminal obtains the desired input
directly froo. the input, buffer. When the user's program hasread all the stacked input lines, remaining terminal readrequests unlock the keyboard and the appropriate input data canbe keyed in normally.
~

To suspend data stacking once the data request has been insured,

the DATA request is reissued with the OFF argument. Similarly,
the ON argument resumes data stacking and can be used to activate
a DATA request issued in a prior QUICK session.
Notes:{

1.

When the DATA request is issued with no parameters, and a
DATA*~~h~ EXEC file currently exists, the current file iserased and a new DATA**** file is created.
2. The DATA option is initialized to the OFF state each time the
QUICK procedure is invoked.
Error Messages: Norie11/12/69
3.5.21-6
QUICK
EDIT

(
EDIT
Fonnat:EDIT
E

languages:

Fortran, Assembler, PL/l

Usage:The EDIT request is identical to the CMS command, EDIT filename
filetype. If the file specified to QUICK does not exist, itis created for input. Otherwise, the existing FORTRAX, SYSIN,
or PL/l file can be edited. The CMS edit requests, FILE and
QUIT, return control to·the QUICK environment (an asterisk is
printed).
Error Messages:

none

..

11/12/69.
3.5.21-7
QUICK
OK

(
OK

Languages:

Fortran, Assembler, PL/l

Usage:

The current file is compiled (fortran and PL/l) or assembled(assembly language)·. If processing is successful, filename
TEXT is created on the user's P-disk.
Error Messages:

none

(

·•

.

11/12/69
3.5.21-8
QUICK
PRINT

.

PRINT

Languages:

Assembler

Description:
The PRINT request prints the LISTING file created when thecurrent file is assembled. If the argument HERE is supplied,the LISTING file is printed at the terminal. Otherwise, thefile is dumped to the high speed printer at the computer
center.
(Error Messages:

none

..

•

.t\

.1

• !

11/12/69
3.5.21-9
QUICK

·(

QUIT

QUIT

-._,/

Languages:

Description:

Fortran, Assembler, -PL/l

Control is returned to the CMS cow~i.and environ.uent.

Error Messages:

none

(.

..

I

11/12/69
3.5.21-10
QUICK
SUB

(
SUB

SUB
Languages:

Fortran, Assembler, PL/1

Description:( ..

The SUB request allows the user to specify up to three TEXT
routines which will be loaded with the current program eachtime the $ request is issued. When the SUB request is issued,
QUICK responds with "ENTER SUBROUTINE NA:•1ES." The routinesthen specified will be ·1oaded with the main program until the
SUB request is issued with the OFF argument or until the user
leaves the QUICK environment.
Error Messages:

1.

TOO MANY ROUTINES - CMS ENTERED
Return to the QUICK environment with the QUICK CHS cormnand •

..

{

: J

,

..
. ,. ··.•

11/12/69
3.5.21-11
QUICK

~

(

$

$

~ERE~

$
Languages:

Fortran, Assembler, PL/1

Usage:The TEXT version of the current file is loaded and executed.
The SUB request can be used to specify additional TEXT
routines to be loaded each time the current program is executed.
· If a PL/l program is to be executed, QUICK insures that PLILIBl,
PLILIB2, and PLILIB3 are specified in the (LIBE) option atload time. If the argument, HERE, is supplied, SYSOUT for a
PL/l program is directed to the terminal.

(
Error Messages:

none

-·

(

6-15-70
3e5.22-l
pOSBli.TCII

3. 5. 22

DOSBATCH

PURPOSE:The DOSBATCH co~~and provide simple transfer of job files tothe DOS batch machine, and allows the user to select the mannerin which he receives output from these jobs.
FORH.:\T:

DOS BATCH

defaults

fn

ft

Bl"lTCHDOS(options)

The default filename is BATCH and the default filetypeis DOS ..

Options determine where printed or punched output should go,either to the real device in the VCS conputer center, or to the.user's virtual reader. If no options are specified, the output
will be routed to the appropriate real device.
LISrr (or L) will return printer outout from the batch
job as a file in the user's reader.
DECK (or D) will return punched output from the batch
job as a file in the user!s reader.
The options are enclosed in parentheses. Either one or both
options r~-:ay be specified. To specify both, a blank must sep2.rat:.e
the options.
DOSBATCH

If both options are
virtual reader.

short

fortranspe~ified,(list deck)

2 files will be returned in the

USAGE:The DOSBATCH command will transfer the one file specified to thebatch ma.chine to be run under DOS. Appropriate job control :nust be

included in the file.
'.·

RESPO:-~SES:a.

b.

R; hh.m..rn.ss
FILE NOT FOUNDE(OOOOl)

6-15-70

3.5.22-2

DOS BATCH

3.5.22 DOSBATCH
EXN·PLES:a.

DOSBl~TcH,

Uses the defaults.

b.

Sends the file BATCH DOS with no options.

DOSBATCH ROOT(DECK)

Uses the default filetype.

ROOT DOS to be run under DOS.

A."1y punched output will be returned as a file in the user's

reader.

c.

DOSBATCHSHORTFORTRAN(LIST DECK)The file SHORT FORTRAN will be transferred to be run, andboth printed and punched output will be returned as reader
fil.es.
NOTE:(

The default filetype cannot be envoked unless the default filetypeis also used. For example, to transfer the file BATCH COBOL,,
the com.:."Tlai"ld:
DOSBhTCH

COBOL(Options)

would be invalid since "COBOL" would be looked upon as filename
rather than t::.lpe.

·•

,,,,...,

!"'\.

~

...
I

3.6.0

UTILITIES

05/01
3.6.0-1~~1

05/01/69
3.6.1-1
l.6 .1~70 "",4hi"

CNV'I26.f~U.Q.§.Q:

This section contains those CMS commands which are utilitarianin function. They include SORT, which sorts a disk :file,
COMPARE, wh,ich compare two disk files record by record,
TPCOPY, which copies a tape, MODMAP, which types out theload map of an existing NODULE file, and TPMATCH, which
compares t~o magnetic tape files.

The CNVT26 command
EBCDIC (C2~).

converts a

ECDIC

(02~

card-imaqE file

tolH.!!!~,!;:

C.:NV'.r26

filenameI
filetype II

til~name

filetype

is the file to tE converted.

]~j~a:

the specified file is searched for en the P disk and then the T
The old file is erased and the now .file is given theoriqindl name, ty~e~ and mcde.

1isk.

CNVT26 creates the work file "ECDEBC UTilITY" with the same
filemode as the file teinq converted.
If a file with theidentifier "ECCEUC U'IILITY" already exists, it will be erased.
lUll!.E.l!,rn:a.
CNV'I2~
EASY FORTRAN
Ihe tile EASY FCRT~AN is converted from BCDIC to EBCDIC, the oldfile is erased, and the new file is qiven the orqinal name.
l ! ! 2 Lll~a.§.f!.9,g§.:£(00001)
FilE NOT POUND
The specified file does not exist on either the P disk or T disk.

E(00002)
flLENAME(S)MISSINGaither the filename and/or filetype were not~ommand.
Reissue the ccmmand correctly. ·s~ecifiedwith the05/ J../69

05/0l - •3.6.3-1

3.0.2-1

~71

P-44L

J.6.3

#<ftt

C V'IF V

COMPARE
3. 6. 2 COMPARE"17.:L
Rn .EQ.§e:

Purpose:The CVTFV cc~mand ccnverts a file with fixed lenqth records tovariable lenqth records.

The COMPARE command. can be used to compare two disk files.
Format:fQUs.:t:,----------~----------~----------;-----------;---------.

: COMPARE ; filename I "I filetype 1 : !ilename2 ; filetype2

Usage:!

l----------~----------~-------~--~----------!--------~CVTFV
If the files are identical, a message will so indicate. If corresponding
records in each file do not agree, tlk record from the first file will be
printed followed by the record from the second file. If the encl of one
file is reached before the end of the other, a mes sage will so indicate.

ti1Enaa£Tht' rn:-··t..-.um record size that can be COMPAREI-:i~s i56 charact~i-s.

(T)Responses:
EOF FILE n
The end o! file has been reached on file n, where n is either 1 or 2.

is the file to be ccnvertcd.
specjfies that all trailingblanks are to be deleted.

If (1)

is Erccified arld the file ccnsists cf 80 character(a normal card file), tytcn 73 thr-0ugh 80 of eachcard imaq~ will te delet~d regardless cf contents. Therefore
tc ccnvert card fil~s without loss of information incolumns 13 thtcugh 80, de not use the (T) cption.
[e~ords~FILES HA VE DIFFERENT CHARACTERISTICS
The files oeing compared do not have either the same record size orrecord format.

1he P disk a~d the T disk are scarcheJ fer the specified
file. The old file is erased and the new file is qiven
the original n~me, type, and mode.

PARAMETER ERROR
Insufficient parameters were. supplied •.

RECORDS ARE TOO LONG
The records are longer than 256 characters, therefore they can not be

CV1FV cr~ates J work file with a filetype cf CVTOT1 andthe filenane and acde ct the s~ecified file. If a filealread) exists with the sa~e identifier as the vork file,
i t will· be erased.

·compared.
Error Messages:
E(OOOOI)

filety~e.UsJJ!nNOT EOF FILE n
This message w!ll follow EOF FILE n if the end o! file is reached on one
file prior to that o! the other file.

E(xxxxx)

II
I filename filetype <(T)> I
I.
I

FILE NOT FOUNDFATAL ERROR

l.!.H!l.!£§:

a. CV!FVUSERGUIDSCRIPT' (T)The tile USEHGUID SCHIP! is converted from fixed length
records tc variable length records. If the file contains
80 charactEr r~ccrds, cclu~ns 73-80 are deleted.

-

•

·f'

fl',

~·

"
05/0J./1.

1,;·6;~

05/01/69
3.6.4 - 1

3.6.4

#tr

.t!CD!AE"f/7yl!.J;!!.Lt1~.§.§A..9~1i;

I.Y!l?..Q.U.1
E (00001)

fllE

NC'l' FCUNI:

1he specified file dces net exist en either the P disk

E ( 00002)

HCOEREC1 FCFMATE(OOOOl.I}

INCCFREC'I

vith

the

~fecified

A T was net
E(OOOOJ)

ftCIMAP command ~YfES the lead ltf associated
MODULE file en the ccnscle tyfEvritec.

1heer T di~:ik.

s~ecifiedbetween the~arentheses.

lli.!JJ:FCEMATlither a filename and/er filetyFe was not specified•ith th~ command. Reissue the ccmmand correctly.

J1CDl!AE

FILE IS ALEEACY VARIAELf
ihe spe~ified file ccntains variable length records,
tberefcre it can not be converted.

filename•

filema11e 1
Ifilenan~of a file whosetJletyp~

is MCDOLE

YH.9.fil

1he leader table vhich vas in use at the time the GENMOt ~asissued to create the ~CDUl! is typed on the ccDscle tyfe\titer.
~.f!filAny ~ODUL~ fil~s Cteated •ith the GENHOt (NOftAP)
ccntain a load map.

CCD~andde not

B.UR.Q.Afillil

LOAD MAf UNAVAllABl!

2he HCDUlE file vas created vit~ t~e (~OMAP) Cfticn
thEtEfOIE the lead 1a1 dee~ act e1lst.

\.

..

of GENeCD,

05/01/GS
3.6.5.-2

05/01169
3.E.5-1

SC Rt

3 .. ti. 5.y.;z $r:7?

the defined sort fields.

j/7/J- BM

the total number ot characters on which the records are to be sorted
muEt not e>cee1I 254 characters.

f!!I iH?.§e:~0~1 arranges the recorqs from file 1 into file 2 in ascendinq order
dCCording to siecified fCtt fields.

lhc sorting operation takes place with two pass9s of the input
file. Pas~ cne cre.1te~ an crnered pointer table in core storaqe.
Pa~E t~o uEes the pointer tatle to read the input file in a randcm
nanner and write th~ outfUt file. Therefor~, the si2e of core storaqe
and the Ei2e of the sort field is the liaiting factor on the number ofrecords that can be scrted at any one ti~o. An estimate of
the maximun number of records that can te sorted can be made by usinq
the follcwing formul~:

1££.U.!!

I

I SCR'II

filename1 filetype1 filename2 tiletype2- -·- - - - - - - - - - - - - - - - -.- -filcnamc1 filetyre1
filename2 filetype2

Nilis the in~ut file
to be scrtcd.

JiJ;.QJ;J
1 Q + NC

where:NRNC

is the output filethat contains thE
scrted reccrds.

is the maxi~um numbot cf inrut records
is the total numter of characters in thedefined scrt field.

.!!i.§H.Il§f§:11~.Hj:•ENTEF SCRT YIEl[
CEFINITIONS[etine the character pcsiticr.s en which the records are to
be sorted. TyFe pairs ot numbers, separated by blanks, where
each pair is the starting and ending character position ofd soLt field~within each input record.

lhe tecordE are sorte~ in E~CDIC order frooc file1 to file2.
It duplicate reccrds are fcund, they arc written onto file2
in the ord(J ia ~hich they are encountered in file1.
All
records must te cf fixed lenqth tc be so~ted.

•CU1flT FI~E ALREACY FXIS1S, TO APPENC IT, HIT BETUBN.
*TC EFASE CLD FILE, TYfE 'ERASE'.

Pile1 and filel must have unique identifiers as SORT can net
write the cutfut tack into the inrut file (file1). If the output
file already e~ists, either the old file can be erased, or thesort can te terminated, er the existinq file can be appended withthe output, or a new output file can te specified.

*TO QlIT, TYPE 'V.Ul'I', ELSE EN'TER NEW FILNAl'l/PilTYE.

Pile2 already exists.
Either erase the cld file, terminate thesort, er siecify a new cutFUt file.
XXXX RECORDS READ ON PASS1.
The tctal number of records read

Cnce the SCRT command is issued, it asks fer the sort fields
to tE detir.ed via the fcllcving meEsaqe:!.

the Eort fields are defined hy typing pairs of numbers, seFarated
ty tldnkE, where each J&it is the starting and endinq
character fosition of a sort field within each input record
and thE leftRcEt faic is the maier Ecrt field.
tuc· totdl number of pairs cf sort field definitions that can heentered is li~ited only by the ~aximu~ numcer of characters thatcan b~ ty~ed on one line and the maximum numter of characters i~,•.

the input file is XXXX.

..U.iJ.!!!fl!t§:*EUH SOT FIELD tEfINI'.IION•S

,

frc~

.

,.._

SCRT

CLASS MEMO ALFHCLAS MEMO
Eort class rnemc alphclas memo
•ENTEN SCHT FIELC DEFINITIONS
1
10
25
28
66 6ECCBtS REAt ON PASS1.
B:T=C.30/1.06
15.C6.47"',,ll!jli:U. Llii!i!i!iiiii!!iiilil,lii$1!11U!iiiiiililii!iii!:Z ILJlll J. 44MhQi 14'4 I I. .I I

ZS :a

,111.

,/,;

,,.7/'

05/01/ ~3,6.5-3

7he 66 reccrds in file CLASS MEMO are sorted on positic~s ~~1 through 10 and 25 thrcuqh 28. 1he socted output is written
intc the ne~ly credted file ALPHCLAS MEMO.
.

E(00002)*INPUT FILENAME/FILETYPE NOT DEFINED.
Eoth the filename and filetype were not specified
for file1.
*CUTPUT FILENAME/FILETYPE NOT DEFlNED.
Eoth the filecarre and filety~e were· not specified forfile 2.

! (0000 3)*lNCOMpLE1E SOR1 FIELD PAIR tEFINITION.
Cn ending character position was net specified fora sett field.

E (C0005)*INFU1 PILE DCES NC1 EXIST.
1hc file specified as file1 dces net exist.

! ( CCC06)! (CC010)

05101/69#<f

3.s:s.1·

T~:>COPY'llf'

3. 6, 6 TPCOPY
Purpose:j g QJ;_i.1£.§.§~..9~,§:E (OOC01)

.~

""'

I"'

•INPU1 FILE IS N01 FIXED LENG1H FCRMAT.

1he r~cords in file1 are not fixed lenqth, therefore,
they can net tc sorted.
CANNOT ERASE INFUT FILE
1he identifiers for file1 and file2 are the same - theysust he unique, as the input· fil~ can not be erased.

The command TPCOPY can be used to copy tape files,~..:··- - ....... - - - - .... - - -:- .. - .. - .. - ... - -.- - - - - - - - - - - .... - - .. - - - - - - - - -.:: .. - - i
1 TPCOPY
:
TAPi
TAPo
n
YES•
l
! TAPl
TAP2
1
no :
I
I

i
•

*

---

*

---

*

-

(•

--,

1

L------------J---------------------------------------)
where:
is the input• symbolic tape unit
is the output symbolic tape unit
is th<: number of files to be copied
types out a summary of each file copied,If YES is not specified, no summary is assumed.
specifics the default is to be tak_cn for each parameter.

TA Pi
TAPo
n
YES

*
~:

1.

7 track tapes arc! read and written at 800 bpi, odd parity, converter
on, translator off,2.

If TA¢i and TAPo arc'not specified, T APl and 'IAPZ are assumed,
w~ich correspond to 180 and 181 ·respectively.

3.

If n is not specified, the default is one file to be copied,4.

'fhe maximum r•~cord sizeris 4096 characters,

Respon~:SUMMARY OF COPYThe YE;S parameter was specified with TPCOPY, therefore a summaryof the copy of each Jfile is typed out,
FILE xxx
The xxx is the sequence number of the file being copied on the tape.

xxxxxxx RECORDS, LENGTH = xxxxx BYTESThe number of records on TAPi and the maximum length of eai;hare specified,
xxxx:>i:xx RF.CORDS COPIED'rhc xxxxxxx is the inumbcr of records copied from TA Pi to TA Po.
SUMMARY COMPJ.ETE
The summary typcout has terminated.

05/01/69
3.6.6-2
T,PCOPY

Jh~

3.6.7

f7f

11/07 /69

3.6.7-1

Lf '7 9 I
I

TPMATCH·TPMATCH

TAPE READ ERROR; BYPASS? (YES/NO)An error has been encountered while reading the tape. The keyboard
is unlocked for either a YES or NO response. If YES is entered,
TPCOPY skips the error record, and ... ontinucs reading. If NO isentered, error cbae 1 is rcturnc~d and TPCOPY terminates.
SUMMARY TABLE OVERFLOW; SUMMARY CANCELLED
The summary has been cancelled •.

Purpose:The TPMATCH command will compare two magnetic
tape files.

Format:TPMATCH

Usage:

One tape is mounted on device 180 and the otheron device 181. Both are rewound to the load
point, and the TPMATCH command is issued. The
contents of the tape f ilcs are compared until an
end-of-file condition is reached on either tapeor two records which do not agree are encountered.

Responses:

END OF FILE ON TAPE 1
A tape mark has been read on the tape at device
180.

Error Messa~:
E(OOOOl}E(OOOOl)
E(00003)

TAPE WRITE ERROR; TERMINATING.
ILLECAL FILE COUNT FIELD.
SAME UNIT REQUESTED FOR INPUT AND OUTPUTTAPE ERROR ON TAPE 1
An unexpected tape error has
tape at device 180.

occurred on the

END OF FILE ON TAPE 2
A tape mark has been encountered on the tape atdevice 181 •..

\.

TAPE ERROR ON TAPE 2
The tape at device 181 has a bad record.

LOGICAL RECORD LENGTHS NOT EQUAL.
Program terminates if record sizes disagree.
TAPE FILES ARE NOT IDENTICALTPHATCH has encountered two records which do notagree.
RECORD # NNNNNN WAS THE ·LAST RECORD READ.
This message indicates the record number of thefirst records which did not match.

""''"•·-·_.,,., •·"'!"''""·""''", ·A'*fl*¥1 · ··'&ffii' ;

4::.:;zw:;;;.

,.······;; "'¥2§,t,.,a..

""-¥14 ,,JL~,,,w ,.U . L& fa, .. ct..: .. 14'\iQU,,iL.i.&U.JQIJL.,". .,iiiil. JiASU ,,iiJN'ii!J,,,Mi.L.,,QMijij!llll,,,.4.Qil•llll.Ull!. .M'-1

If",

·""'

fl"'\

AV~,._

d111

l/K-O
11/01/68
3.7.0
3. 7. 0TEXT Libraries
TEXT libraries; arc used lj>y the LOAD, USE, and REUSE commands to search
for missing subroutines dudng loading.
Unless the GLOBAL LOADER TXTLIB
command is is~..ied, LOAD, USE, and REUS~ search only the TEXT libra~·y
named SYSLIB.

For more information on library usage, refer to section 5. 4. O.

'

3. 7.1SYSLIB TXTLIBThe library SYSLIB TXTLIB c:ontains the FORTRAN Library as well as anumber of CMS libi·ary subroutines.
The TXTLIB directory indicating theentries in the library is shown in Figure 3. 7.1-A.
Refer to Form.C.28-6596,
FORTRAN IV L:~rary Subprograms (Prograr- Numbers 3605-LM-501, anc1
360F-LM-619), for a description of the routines from the FORTRAN library.
'I'his section contains the descriptions of the subroutines written for use under
CMS,'l'he routines des cribcd are:'I'APSET
TRAP

3. 7. 1. 1
3. 7.1. 2

BLIP.3. 7.1. 3
3. 7. L 4

LOGDSKREREAD
DEFINEDSDSETGETPARCPNMON /CFNMOF..

~.

11/01/68 ~/3.7.1-1

3. 7. 1. 5

3.7.l.6
3. 7. 1. 7
3.7.1.8
3. 7.1. 9

..

\

.

.

1'&

rnrnv

I llDEXSIZE

lllCC(IOTO

2

4

I l:CF I XPI
FIXPllI llCHIAXD
011/\X 1
01·1 I tll
I tlCHl/\X I
MAXO
MINO

CGOTOIJ

lllCCLA'3S

9

6

CD.\GS

lllCCLJ\S

15

8

CC1:1PYt
CDDVOi1

lllCCLEXPCDEXPl!ICCLLOG
CD LOG
COLGlO
l!ICCLSCUCOS I ti
CD COS
lllCCLSQT
CDSrtrn
I llCCSABS ·

9

23

12

59

10

69

8

8

77

HICCSF..XP
CEXP
lllCCSLOG
CLOG '
CLOGlOI ~ICCSSCN

85

9

9li

12

lllCLTtlCT
253

262

10

~

13

119

g

128

i.o

;.

1()8

11

179

10

189

111

272

4

276

6

7

210

9

219

8

227

6

·'·

233

FIGURE 3. 7. 1-A.

7

DERFC
IHCLEXPDEXP
l'llCLGAM.\

13

BLIP

I llCSERF

491

13

EHFC
I l!CSEXP
EXP

5011

10

5111

15

529

10

539

10

549

10

559

8

567

8

575

12

587
604

17
91

695

91

289

8

297

9

Al.GAMA
IHCSLOG
ALOG
ALOGlO

306

10

cos

316

8

324

8

IHCSSCNll
SI flll
COS fll!ICSSQRT

332

12

34li

16

360

20

380

13

393

18

411

14

425

11

786

63

849

8

857

4·9

906

11

917

13

930

6

936

14

950
984
990
1015
1032

34

CPN110F
FrWNLOLOGDSKTRAP
IHCFAINT
Al rn. I tlCLSCN
DCOS
OS 111
TAPS ETDEFTGLVDEF I llE

GAMl1A

7..

OSDSET~I

lllCSSCN

6

25
17
47

REREAbREREADV
18li ENTRYS IN LIOE
R; Ta0.28/2.27 20.42.29

SHI

snrn

I !ICSTANfl
TANH
I llCSTllCTTAN
COT MlQTANIHCTRClllllCFCVTH

ADCOll#~;.

FIGURE 3. 7. 1-A.· (continued)

llH6S~f

FCVEO
FCVLO
FCVIO
FCVCO
FCVM
FCVZO
IHCFCOllH
SAV/\REAVFIOCSI CCOi·\I
FDIOCSIDS 11!11
•··

478

282

DGAl:f·1A

DLGAl-IA
IHCLLOG
DLOG
DLornoIUCLSCtlM

REMAr1E
ER/\SElllCSCiMIA

DEHF

203

· HtL
..
f!3

HHU!U'

rnr

OAT/\r~2

IHCLERF11ATAN2I GERRI

HlCLASCN
D/\RS Ir~
0/\RCOSlllCLAnl2
OAT/\N467

ATArl

I CEHllH

IHC I CERR

12IHCSATN2SLITESL I TETl!!C IRERH.

CP/J/.ION

455

ll!CSASCN
ARSltlAnCOS

Of.!0[')

ovrnFLlllCFHXP I
FRXPI 11lllCFRXPR

10

DTAIJ
DCOT/\N
QDT/\ll9

AMI 111

I llCFllOO I
MOO
I llCHIODR

445

IHCFIOSU
FIOCSI
lllCU:\TSL
I !ICIMMEL

9

Olf\!:11

Ml/\XlIHCFSLIT106OVCIH~-

lllCL TANH6FRXPRr1

cs 11-1

IHCFOXPDFOX PO#IUCFDXP I
FDXPlllllCFEXIT
EXIT
lllCFIFIX
IFIX
lrlT
ID ltlT

.

436

osnrn

MINl

lllCFOVER

covo~

lllCFCDX I
FCDXlllllCFCXPI
FCXPllI llCFDUr.tP
DUrtP
POUt1P
lllCFOVCll

2117

11/01/GS
3.7.1-3

SYSLIB TXTLIB

lllCLSQRT

1

Al10D

lllCCS.l\S
Cf.\PYiOU3UGI

AMINO
lllCHIAXR
MAXl

15

44

Cf\8S

ccos
I llCCSSQT
CSQP.TIHCDBUG

2110

Af.IJl.X 0

32;

11/01/66
3. 1. i- 2 ~ Y2
SYS LIB iXTLIB

OCOSll
SYS LIB TXT LIB Directory Map - October 1968

--

~

.~·

""

r//j{I

11/01/68 ~£3. 7. 1.1-1 Jt.
TAPSET
3. 7.1.1;'f'f

11/01/68 ;/(} 3. 7.1.1-2 / J.S
TAPSETTAPSET Routine

Purpose:lf the paramct·~r blksizc, mode:set, redm, or lrccl is zero or o.nitted, thepa1·ameter will be dc!aullcd to that which was previously set or defaulted for

The TAPSET subroutine changes the default settings for the FORTRAN logicaltapo units.

·

tho tapo unit.

,Cal1ing Sequc~. Usage_:

CALL TAPSET (tapno, clsrn, < blksize>, <mode set>, <recf'm ~ <lrccl>)

FOR~'RAN data set reference numbet·s 11-14 are the standard logical tape units.
'l'hesc units correspond to symbolic devices TAP1-TAP4 and to virtual devices
180-183.
The default settings are as follows:

where:
tapno

dsrn

blksizemodes etis an itcgcr from 1 to 4 indicating the virtual tape unit
TAPl, TAP2, TAP3, or TAP4 C!Jrrcsponding to device
address 180, 181, 182, or 183.
the FOHTRAN data set reference number that will be
used to reference the specified tape unit.
This number
must be from 1 to 14 with exception of 5, 6, and 7.
is the byte count for the maximum size of the physicalrecords to be read or written on the defined unit.

1)
2.)
3)
4)
5)

lrecl

Block
Si?.e

Modes etCode

FormatType

Logical Recore
Length

180
181
182
183

TAPl
'l;AF2
TAP3
TAP4

11

80
133

1
l
1
1

1

12
13
14

1
2.

80
133
80

800
1330

z

133

If the blocksize is defaulted, the following message is typed at the ·terminal or onsys out:.

odd parity, converter on, translator off
odd parity, converter off, translator on
odd parily, converter off, translator off
even parity, converter off, transhi.tor oneven parity, conve1·ter off, translator off

is a type nmn bcr from 1 to 5 indicating the 2·ecord
form;:.t.
The type nun-1bcrs arc:

Data Set
Reference Number

associated with the dsrn will still be in effect.
II a call to TAPSET associates atape unit with a dsrn which is alread)r associated with a tape, the tape previously
associated with that dsrn will not be associated with any logical unit.
If a call to
TAPSET associates a tape unit with a dsrn different from that with which it waspreviously associated, the p1·evious clsl'n will be associated with disk files·.
If acall to TAPSET associates a tape unit with a dsrn which was previously associatedwith a disk file, a read or writj~ to that dsrn will be directed to the tape unit.

The code numbers range from 1 to 15 in groups of 5.
Codes 1-5 arc for 800 bpi, 6-10 for 556 bpi, and 11-15
for 200 bpi.
Within each group of 5 the mode setting
is as.follows:

recfm

Symbolic
DeviceThe parameters hlksize, mocleset, recfm, and lrecl are associated v.i th the dsrn.
1£ a call to TAPSF:T is made with these settings clcfaultcd, the settings p:rc:viously

is a code number for setting the mode mask for 7_ track operations.
The mask is ignored on all
9 track operations.

1)
2)
3)
4)
5)

Virtual
DeviceTAPSET-BLI<SIZE IS ZERO _OH NEGATIVE; DEFAULT USED,
If the logical record length parameter is defaulted, the following message isty~ad at the terminal or on sysout:\fixed record size, unblocked
fixed record size, blocked
variable record size, unblocked
variable record size, blocked
undefined record size, no blocking-is the byte count of the logical record to be read or
written.
It is used for record forrnat types 1 through4.
For type 2 records, blksize must he an integral
multiple of lrecl; refer to the Fortran IV (G) Programmer's Guide, C28-6639, for a discussion of lrccl -andblksi zc for variable type records.

TAPSET-LRL IS ZERO OR NEGATIVE:

DEFAULT USED.

Note:"Jn the current CMS TAP3 and TAP4"are not defined, therefore data set reference
numbers 13 and 14 should not bu used.
Return Mcssag-0:'fAPSET-ONLY ONE ARGUMENT; CALL IGNORED.
The tape number, tapno, and the data set reference nun~beir, dsrn, a1·c required
parameters. If a call to TAPSET is made with only one argument, the routine
returns without altering the settings for FORTRAN logical tape units.

~. //tl-9./rt

11/01/68
3. 7.1. z
TRAPufo1</6s
3. 7.1.1-3
TAPSET
Error Exits:

3,(program terminates)

L/4'7

TRAP Routine

Purpose:ADEND lTAPSET-INVALID TAPE NUMBER; TERMINATING.
Only tape numbers 1-4 arc lc3al parameters.

The THAP subroutine sets a user's return for an external interrupt.
ovcri·idcs the c< U to l>EDUG on an external irtcrrupt.

ABEND ZTAPSET-DSRN IS GREATER THAN 14; TERMINATING.

ABEND 3

TAPSET-DSRN OF ZERO IS iLLEGAL; TERMINATING.

ABEND 4TAPSET-MODESET CODE IS GREATER THAN 15; TERMINATING.
Only the modeset codes from 1 to 15 are legal.

ABF.ND 5

TAPSET-RECFM CODE IS GREATER THAN 5; TEHMINATING.
-Only the record format type numbers from l to 5 arc legal.

ABEND 67.1. Z

This return

Calling S_cquence:a)

CALL TRAP (cxtrap)
where ext rap is the name of an external routine which will be transferred·to on an external interrupt.
CALL TRAP (0)b)

1£ the argument to TRAP is zero, the external interrupt return will be

TAPSET-DSRN5 1 6 1 AND 7 ARE ILLEGAL FOR TAPE UNITS.

reset to go to DEBUG.
Usage:The interrupt routine should set a flag which should be examined by the mainline program. After the flag is set, the interrupt routine should issue a RETURN
to return to the executing program.
The main line program should periodicallyexaminr- the trap flag to determine whether an external interrupt has occurred.
Example:The following sarnplc program illustl"atcs the USC of the TRAP procedure using

a FORTRAN pseudo sense switch as the flag for communicating between theinterrupt rou~inc and the main line program.

..

\,

EXTRAPCALL TRAP (EXTRAP) .
fortran tcsttrap
CALL SLITE (0)T=Z. Z3 15:26:58
DO 10 I<=l, 10000
CALL SLITET(2, I)$ testtrap
IF (L EQ. 1) GOTO 20
EXECUTION BEGINS •••.,. IF (L NE. 2) GOTO 30
50 TIMES
IF (MOD(l<, 50) • EQ 0) WRITE (6, lOO)K
100 tJMESCONTINUE
150 TIMES
WHITE (6, 200)
200 TIMESSTOP
250 TIMESWRITE (6, 300)
300 TI"STOPeFORMAT(lX,115', TIMES'),END OF RUNFORMAT(' END OF RUN ')lHCOOZl STOP
.0
FORMAT(' SENSE LITE ERROR')ENDSUBHOUTINE EXTRAPCALL SLITE(2)RETURNEND
EXT1'~RNAL

10
20
30
100
200
300

.~

.,

,..
-

-·~~"'''¥'""'·· lmhbliLi .@~Hi, ~"P!!!!ll!!!!!~!!~Wl~~'!fh!ii!Mi!!i#@t...,Q.%, ..hcPJl!MM ?.CC~,.~·;;:n;p:;p;ili;IQUMi&ii . . . .

GWMAiiii!Wii.@-Zj

z+ ~

· ;,

!

~·
'1
,'
. $.

ij!Q

)Mi J¢sq if-,

ijiifti.$ .,,i,i~~~~~·~,~~1111•m,~~,~·~~i r11"9':!elJ·- . i·.
. Jf.,UilillP.~11!•1111~~-iH"~&i Ai&iiii iJMl!.@iijiiiQ.U&!@ii., . .\. :.

~,Jlllll\·""'· 11/01/68 ..11/j
3. 7.1. 3J.

t!J'J~ 7t'S-3. 7. 1. 3

BLIP Routine

Purpose:!&~CALL BLIP (' cha1·actcr', count}the count parameter must be an integer ·from 1 to 8 indicating the nl'.,.'"erof BLlP characters.
b)

CALIL BLIP ('c')'Jf the count is defaulted, a count of 1 is assumed.
c)

LOGDSI<

3. 7.1. 4 · LOODSK Routine

The BLIP subroutine causes a string of from one to eight characters to be typed
on the console r-:riodically during CMS operat-ion.
The BLIP characters ?retyped out aft er every two seconds of CPU ex:ecution and give the user anindication (If t:he execution time of his program,a)

11/01/68
3.7.1.4

CALL BLIP (0)If the !irst pa1·ameter is a zero, the BLIP d1 a.racters are reset to their
non~printing dc!,ault setting (a space followed by a backspace).

Purpose:The LOGDSK su.n·outine ~loses all open files and writes the file directory ..mto
the permanent disk.
.Calling' Sequence:
CALL LOGDSKUsage:The user should call LOODSK during the execution of his program if he wa.nts
to cause new 01· modified files to be permanently written onto the permanent
disk before the completion of the prog1·am and the return to the CMS commandenvironment.
Error Exit:lf the directory cannot be written out 1 the virtual machine is put in disabled
wait state and control will be passed to CP.

Usage:The default setting of the BLIP characters is a sequence of' non-printing characters.
If it is desired to have a printed recording of the execution of a program, the BLIP
characters should be changed to.printing characters, c. g., a single dot.
·
Error Returns:
~

None.

L/17

'·

/)"'"""
r,~q11101/68

11 /0 l /68 ~'Y7..
3.7.1.6-1

1fo

3. 7.1. 5
REREAD~NE'111

3. 7. 1. 6 DEFINE Routine

3. 7. 1. 5

REREAD Routine

Purpose:Puri:£_se:

The DEFINE subroutine defines Fortran disk files that may be accessed
randomly and maker: a correspondence between a CMS file and a Fortran
logical unit number.

The REREAD subroutine provides a facility for rereading a record with di.Jercnt
format statements without performing any input/output operations.

Calling Sequence:·Calling Seqt:icnce:
CALL REREAD (dsrn,
where:

dsrn<blksize>)

CALL DEFINE (dsrn, name, type, recno, recsiz, <&n>)where:

is any data set reference number from 1-99 except unit 5, 6,
or 7 and,•dsrn

is the Fortran data set reference number to be associatedwith the defined CMS file. ·This parameter must be a 4 byte
integer or integer vari!lble.

nameis the filename of the CMS file and it must be 8 bytes in length.

.type

is the filetype of the CMS file and it must be 8 bytes in length .

A call to REREAD is made when it is desired to specify a reread unit or to change

rec nothe data set reference number or the blocksizc.
To read a record from thereread unit a second or subsequent time, a REWIND n or BACKSPACE n statement
must be executed before the READ statement; if a subsequent roread is issued
without executing a REWmD or BACKSPACE statement, an END OF FILE condition
will result.
Any input/output statements can be issued between a write and a readon the reread unit.
·

muf;t be a 4 byte integer variable. Each file defined should
use a different variableThis parameter will
indicate which record of the file is to be read or written.

recsiza 4 byte integer or integer variable that contains the record

blksizc

specifics the blocksize for the reread record. If theblocksize is omitte.d, it is defaulted to 140 bytes.

Usa~

forrccno.

length. All records must bcthcsame length. If the filealready exists, the value of this parameter will be reset by
the DEFINE routine.

Eri·or Returns:

&.n

None.

is a statement number specifying a no11-standard return.
return is taken if 'the file docs not exist.

This

All paramcte1·s except the non-standard return arc required,
Usage:
DEFINE is used to make a correspondence between a CMS file and a Fortrandata set reference number, such that the identifiers FILE FTxxFyyy arc not
required for Fortran disk file reads and writes. Records may then be read or
written using a standard FOR THAN statement. Records can be accessed either
sequentially or ranclornly using the sequential I/O statements. Before each READ
or WRITE statement the record number ·must be set to the record desired.
After the execution of the READ or WHITE statement the record number is
automatically incremented to point to the next record in the file. Thus to READ
or WHITE a file sequentially, the variable for rccno must be initially set to
1 before any READ or WRITE statement is executed. ,!.1_1 _<;gn~rPL<;>PCrations
arc ignored; however, reseting the variable for rei::no to l is equivalent to re. winding the file, and setting the variable for recno to recno+l is equivalent toskipping one rccorq.
·
Records may be read and written without closing the !ile.
is easily accomplished.
.
.
·

,.
' :~11 ... :.:::a;: !Si Jlif'. ··'' ' ,.

1~

Thus updating in-place~·'.·;p ,. L . . .Jii ... JS . . ..,...L. . . JJIMLJZUiliiiLJ..!Qi#@lliiJ#@i.iiil .... $.J#IL ..............L.,l..$".,._....,.u,

~

""""

i~

11 /0l /68 R/P/f'

11/0/68.§;,{(/
3.7.1.7-1·DSDSET

3. 7. 1. 6-2
DEFINE

t/9~
Notes:

a.

f93

3. 7. l. 7 DSDSET Routine
Purpose:The user should remember that each READ or WRITE statement increments the rec¢>rd numbc:r by at least 1. If the format statement indicatesseveral records to be read or written, the record nu1nber will be
incremented accordingly.

b.

Unformatted RE.AD or WRITE statements may re~d or write only one
record p'er .st~tcment.

c.

Each different file should use a different variable for rccno.

d.

A second call to DEFINE with the same ds.rn will undcfine the old dataset
and associate the dsrn with the new dataset.

e.

A maximum of 2Q files may be defined for i-.mdom access~

The DSDSET subroutine enables a user to change the record format andlogical record l ... ngth for FORTRAN disk !iler-.
Call_ing Sequence:
CALL DSDSET (dsrn, blksize, redm, lrecl)
where:

Error !vfessages from the CALL t~ DEFINE:

dsrn

is the FORTHAN data set reference number that will be used
to reference the specified logical unit. 'l'his number must
be from l to 14 with ex~eption of S, 6, and 7.

blksizc

is tho byte count for the maximum size of the physicalrecords to bli read 01· written on the specified unit.

rcdm

is a type number from 1 to 5 indicating the record format.
The type numbers are:ILLEGAL DSHN SPJ<;Cll'JED FOR DEFINEThis means that dsrn is specified as 0, 5, 6, 7, or greater than 99.

l)
Z)
3)
4)
5)

ILLEGAL PARAMETER FOR DEFINEThis means that name or type was not specified or the first byte of thisfilename is X'OO'.
TOO MANY DEFINE FILES
Maximum number of different files is 20.

lrecl!ixed record size, unblocked
fixed record si:ie, blocked
vadable :record size, unblocked
vadable record size, blocked
undefined record size, no blocking

is the byte count ofthe logi_cal r.ecord to be read or written.
It is used fol!" record format types 1 through 4. For type 2
records, blksize must be an integral multiple of lrecl; i·cfcr
to the Fortran IV {G) Programmer's Guide, C28-6639, for a
discussion of lrecel and blksize for variable type records,

DATASET POES NOT HAVE FIXED LENGTH RECORDS
Errors During Program Execution:
Usage:DIRECT ACCESS RECORD NO." =O
Th~s means that the record number variable for recno was set to zero.
FATAL ERROR DUBING DIRECT ACCESS READ (WRITE)

A fatal disk error occurred during the reading or writing of a defined fileand no ERR exit was specified in the user's program.
EOF PURING DIRECT ACCESS READ
The record poi.lter variable for recno was sut to a num,Per larger than thenumber of records in the file, and no END exit was specified in the user's~rogram.

A call to DSDSET is made to change the default settings for data set reference
pumbers 1-14 with the exception of 5, 6, and 7. If it is not required to change· the association of a data set reference number with a symbolic tape unit, a callto DSDSET cart be made instead of a call to TAPSET. The default settings for
FORTRAN disk files are as follows:
Data Set
Reference Numher

Block
Size

FormatType

Logical Record
Length

l

80
80

80

3
4
8

80
80
133
80
80

133

z
9
10

80
80
80
80
80

/

.

;t:0-3/4,.rt.#11 /01 /68
3. 7. l. 7-2

11/01/68
3.7.1.8
GET PARDSDSET

lfff

Notes:

ff.{"

3, 7. 1. 8 GETPAR Routine

The default settings for FORTRAN logical units 5, 6, and 7 cannot bechanged. Logical·unit 5 is the sysin device to read from the terminal
and logical unit I, is the sysout device to writf' on the terminal. The
defaults settfogs are as follow:
Data Set
Reference Number

Block

Size

FormatType

Logical Record
Length

s

80
130
80

1
·1
l

80
130
80

6
7

Purpose:The GETPAR s ibroutine obtains the paramc~ ~rs specified when thecommand or program was caJled from ·CMS.

Callit~g Sequence:
CALL GETPAH (name, numbc1· [,1RITE' ]

i &last])where:
nameis the variable {rcal':'s) tlrnt is to take the value of theparc1n1ctcr indicated by the argun1ent "number".

number is th'e paramcte1· number (integcr:::4) in the initial
parameter list of the parameter desired; it may be
any non-negative value, with 0 indicating the commandor program name on initial entry. If number exceeds
the number of parameters in the string, no parameteris passed, and control will pass to stater£,ent 'last' if&last is specified,"·'RITE'

is an option<tl literal which causes the current parameterto be right-justified in its double-word field, with leading
blanks supplied, This is useful in reading numeric parameters.

&last

is an optional statement label to'which control is passed·if "number" exceeds the number of parameters specified.

Usage:

I! (}ETPAH is called with item number equal 0, the command name or program entry will be returned. If the error return is not specified and theparameter corresponding to the item number was not specified, the routine
will return without storing any parameter. Note that blanks •arc not re. turned for an unspecified parameter.
Example:1.

CALL GETPAR (PARAM (I), I, & 100)
Parameter I will be stored in the array PARAM if it was specified;otherwise, control will pass to statement l 00.

·,-:· !liij a.$ iili$!Q!iiii4
1-;:;:m::::a:a:a:::saa::::a.uu!iii sumu:e:u""*""tQUIPM !Q£¥ ::gsau

•

~·
ii

.£ .: a l t .ts . IILJ!J! ;:a .. iitiii JU . J!Zii ;;:::;: .I' j . ;;: ,.Jl...b .iiiiitiJJi!L .JUi!J ...JIUUilil!i , , . liill,. ,;::;::;;,;,11;1;JJIWQ.IUJ.QllLl&ll Mllll"'

fl"\

"'

.~

Pf.ft?
ll /Ol /68
3.7.1.9-1

"n.;1

17.l

11/01/68

3.7.1.9-2

CPNMON /CPNMOF

7IJ7CPNMON / CPNMOF
3. 7. 1. 9 CPNMON/GPNMOF Houtincs
pl"int£ no1·mal fortran. Purpose:

The CPNMON /C'PNMOF subroutines ;;1llow a ·1ser t·ci input variables to a
FOHTRAN program in a free format mode wiL1out specifying the variable names as is required with the normal NAME LIST feature of. FORTRAN.
~~ Sequence:.CALL CPNMON..

to set the namclist feature to the free format mode.

CALL CPNMOF$normal_to set the namelist feature to the normal FORTRAN mode.

EXECUTION BEGINS •••&listlUsage:
Under the normal namclist mode, the variable name and an equal sign 1nust be
specified with the value for each variable. In addition, the name of the list
preceded by an ampcrsantl (&)must be specified before the values for thevariables are specified and the terminating marker &END must be specified
after the values for the variables arc specif.i.ed. Sec Figu1·c ~· 7. 1. 9-A.
Under the free format Hamclist mode, each variable is specified in thesan1c oxdcr as indicated in the narnclist statc1ncnt. where each variable
is delimited by a cornmn or a tab. Sec Figure 3. 7. 1. 9-13.
To use this namclist feature, the routine CPNMON must be called. This
causes the frc::c format mode to be in effect. Reac3 aiid write statements
arc then issued in the f;tandard way.
To return to the normc.l mode, a call to CPNMOF should be made,one can go from one to the other as desired.
~pl es:1.

* * 72

REAL':"1AJNTEGEH B
DIMENSIC'N C(3)NAMELIST /LISTl /A, B, C
HEAD {5, LISTl)
WHI'l'B {6, LISTI)
STOP
END
R; T::O. 05

&name
&end

a=l.,

b=2.,

c=3.

Thus,

a-=r.;-

b=Z:-:- C"3,
5,

1

4. 1

I

&end

&LISTI
A:: 1. 0000000.&END.
H; 'f=O. 32, B=

Z, G=3. 0000000, 4. 000000.

5.0000FIGURE 3. 7. 1. 9-A
print! frecfrm £ortran* * 72. REAL'f.•4A
INTEGER B
DIMENSION C(3)NAMELIST /.LISTl / A, B, C
CALL CPNMON
READ (5,LISTl)
WRITE (6, LISTl)
STOP
.
END
R; T=O. 03"'

Data s_pccificd u11dcr the standard namclist mode.

2.

1.. 2.,.

3.

Data specified under the free format namelist mode.

$ frecfrm
EXECUTION BEGINS, ••1,2,3,4,5- - & . L1ST1& END
A=l.0000000
R;T=0.28,B=

2,C=3.0000000 .•FIGURE 3. 7. 1. 9-B

4.0000000

5.000011/13/69
3. 7 •'1. 10-1
C.'MS

3. 7 .1.10

11/13/69
3.7.1.10-2
CMS,tjq '], '}.._

4qry ./CMS Routine

Purpose:REG.

15• nnnnnnnn
The contents of register 15 on return frcm the
CMS command are displayed. This value corresponds
to the E(nnnnn) received in the CMS commandenvironment.

~:

The arguments in the calling sequence must beeither 8-byte literals enclosed in quotes ( 1 ) ,or REAL*8 variables.

The CMS subroutine enables the user to execute'CMS commands from within a Fortran program.

Calling sequence:
CALL CMS (command, ar g 1, ar g 2, ar g 3 , ••• , ar g N, <, &n > )where:

commandis the CMS command name and it must be
8 bytes in length
Examples:arg l, ••• ,arg N&nUsage:

are the arguments for the CMS
command (as many as required)
Each must be 8 bytes in length.
Where n is the (optional) error
return statement ntunber

1.

2.

"CMS" is used to allow Fortran programs to execute
CMS commands. The number of arguments required in
the CHS subroutine call is determined by theparticular CHS command being executed.

CALL CMS ( 'ALTER'Pl', 'FILE'SORTDAT ', 'DATAFILE',
1
1
FT03F001', 'Pl)',

REAL*8 TXEQ,MINS,SECS
DA'l'A TXEQ/ 'TIMELIM I I ,MINS/ I 25
CALL Q1S (TXEQ,MINS,SECS)CALL EXIT'/,SECS/ '30

END

Some suggestions can be made concerning thetypes of applications which are particularly
useful. One is to alter a data file's nameand type during Fortran execution to a filerecognizable by Fortran, i.e., FILE FTxxFyyy.
Another is to set a time limit for execution(TIHELlM) within the program to be timed. A
user may wish to enter the DEBUG environment
if unexpected conditions occur; he can do this
via a call to CMS.
Error messages:

CMS COMMAND ERROR
An error return has been received in attempting
to execute a CMS command.

COMMAND•xxxxxxxx
This message identifies the CMS command which
returned an error code.

,,..
= ~1111 ;:::::a :u::::u 11;;:::9 ,,"~.

~,l.,,

!]

I

I

·~

""'

~-

05/01/69l;,1.0-l

4. O. 011~

CONTROL PROGRAM CONSOLE FUNCTIONS~jiff/

console Function tescriptions~.1.c

4-3-684. o. 0-1

CP console
functions are issued
in theControl Progran
Envircnment. Irput can be entered in either upper or lover case.
Entering infut in lower case enable the user to distinguish the input
frcm the cutFut, Eince all output will be typed in upper casE.

To communicate with the Control Progr:im (CP) and to simulate
the computer console, the use1· cap issue CP console functions. These
console functions allow the user to perforn1 such operations as initiallyloading the desired ·system. (i. c., CMS}, dumping core selectively, closing
out files on unit record devices, displaying core and machine conditions,communicating with the operator in the computer roo1n as well as with otherusers, controllin.g mcssngcs typccl on his terminal, and beginning prograin
execution at a cci·tain core· location. The uscr also has the ability to sitnulate
the System/360 c,onsole system reset key, sinrnlatc the console interval timer
switch, cause the Control Program to sirnu_latc an external interrupt, replace'specifit-d parts of core, n•ady spccifiPcl I/0 devices, and release the virtual
machine. Addition;il I/O devices can also be added to a specific virtual machine
and then bt? reh:a,scd for use by another virtual rnachinc.

1he Cantrel Erogram has a character delEtE syDbol and a line
delete syrnbcl, loth of which are the Eame as the default characters inc~~.
!he at character (a) deletes the immediately preceding characterfrom t~e input line and itself. It aay be used repetitively to delete
a string of characters. 1he cent character(t) o~ shift K (leftbr1cket) en the teletypes, deletes all preceding characters in theline and itself. A chatacte1 delete symbol (~) cannot be used todelete a line-delete symbol (¢). Note that if the character delete andlJne Jelete syn~cls are redefined in CMS, they are ]Q.! redefined in

The Control Program environment is entered on the con1pletion of thelogin procedure' (see Scction-2. 2. 2). After the message "READY AT xx:xx:xx
ON xx/xx/xx", ill typed at the user's ten11i11al where xx:xx:xx is the titnc of day
and xx/xx/xx. is the date, the keyboard is unlocked aud the Control Pro grain isthen re;1dy to accept consule function::;. By typing "IPL Clvf.S 11 or "IPL 190",
the user loads the Cambridge Monitor System and he can begin issuing CMS
commands.

A console function is acceFted and executed if a carriage return
cccuts and the ~eybcard is unlocked unless the console function caused
control to pass to ancther envitcnment, in which caso the response~ill be that cf the new environment.
If a console functicn isrojcctod, tho ~~ssaqe "INVALID CP nEQOES1" is ty~ea out. If invalift
Cferands ate Efccificd with a console function,
the messagE "DAD
ARGUMENT xx" is tyred cut where xx is the argument number.
If cnlY
cne operand is SFEcified and it is invlaid, the console function is
tct executed. lf reultiple oporands are specifir:d and part cf them areinvalid, the valid cFerands srecified befc~e the first in!alid operarid~ill be executed properly. If
a null line is entered to CP, i.e. acarriage return with nc frevicus
characters in the line, the1111
ccnficll'inq n:essage CP is l!:yped.

To re~enier the Control P:rogram frorn CMS, the user 1nust hit the ATTN
key once. This eauscs the keyboard to unlock and pern1its th.c Control Programto accept console.functi-ons. If the ATTN key is hit again while in the Control
Progra1n, the keyboard will unlock for an input line to be entered, such as a
CMS command or a li~e of data for the program being loaded and executed; control
will then be transferred to the environnwnt fron1 which the control progran1 wasentered. For instance, if the CMS corm11antl "ASSEMBLE LOOPX" had been
is sue cl and then the ATTN kC'y was hit twice and "PRINTF LOOPX LISTING"
cntC'rcd, thC' asscn'lbly would continue' nncl as soon ns it tcr1ninatcd, the LISTING
file would be typed out. If there is no desire to enter an input line once the keyboard has un1oc:kec!, hit carriage return and then control will be transferred, as
above, to the cnvironn1cnt frorn which the Control Progran1 was entered. The
console function 11EGIN is also used to leave the Control Program; it causes
control to transfer either to the cnvironrncnt fron1 which CP was entered or to a
specific core location, if one is specified. Details for using TIEGIN arc discussed
in Section 4. 1. 1.

Cf.

One or mcrE tlanks must be used to delimit operands or arguments
Sf€Cified with the ccnscle f uncticns.

~he conscl~ functicn~ that are available

for the user are listed

telcw:~.QJJ~ .tl.g_.£.Y.!1£ t i.Q.!L§

BEGH
CLOS!!
J::ET ACH
D.ISC CNN

DISl?IAY
I:Ul1fEX'IHNAL

IFL
LOGOllT
MSG
PUiiGl(;UEF Y~~.ti.Q.!LR~!g~g§".4.1.2
1.,
4.1.3
ii.1.19
4. 1."'". 1. !i".1. 6"· 1.1
4.1.6

4. 1. all.1.16ll.1.'10

05/01/69
4.1.·0-2
REAU
USE'l
SE'l

SUH

SFGCI
S'IOli !
XFU

4.1.114.1.12
Q.1.144.1.174. 1. 18
4.1.134.1.15Soil

05/01/69
4.l.1-1

dj:ii
II. 1.'

4.r,.t'.)1.:57!!

EEGIN!YH.Q.§£:BEGIN initiate~ execution at either a specified core lccati~n orat tho lcceticn srecifiod in the current PSW (which is normallythe lccdticn fcom ~hic6 the Control Program was last entered).

1~!!!!.§!:BEGIN<hexloc>E

bexlocis the hexodecinal ccrc lccation
at which execution is· to begin •.YH.9..€:
BEGlN lratsfcrs ccntrcl tc
the specified hexadecimal corelccation. If a hexadecimal core location is not sr-ecified,exccuticn ~ill resume• tccro the lccation ccntained in tho cu~ront
frcgrarn status word (PSH) - this is normally from the lccation atwhich th~ Ccntrcl Prcgram ~as last entered,· unless the PSi wasfreviouGl) changed. For exanplc, if the Console Program had heon
entered f rcm CMS by hitting the ATTN key and BEGIN is issued~ithout
srecifyinq a ccre lccatian, CMS is ehtered at thelocaticn ftoro \hich it was left.
i.H.E.Q.!l.§.§fi:

BAt ABGUMENT. xx
An invalid hc~adecirnal core location vas specified
number xx. Correct the request and issue aqain.

in argument

Any other cesponse will te that of the new environment.
l.UU1£§:

a.
B
Execution resumes at the location from which CP was last eLtered.

b.

B 15CCC

Contxol is transferred to hexadecittal core location 15000.

~

~
I'
,I

H1.1; : :::imp; 1111::4

wwt 1111ta.122 m~.&H.aumz

i

~

""'.

~'

7-19·68
4. Jl. 2-1'CLOSE

SC~)63

4-3-684. 1. 2-2 CLOSE . .!J°&

"'\
·~./

Notes:

4. 1. 2 CLOSEa.

Purpose:
CLOSE rel~ascs the spooling areas from' the specified multiplexor.
devicqs, and thP actual I/O operation is performed for any output.

"CLOSE OOE" must be given after the DUMP console function has been
issued.

b. Logging out from CP will automatically issue a CLOSE for the virtualcard reader, printer, and punch and release all spooling areas.

Format:Responses:
1'-------------------:------------------~--:lCLOSE}C

1

devadd

l

I

I

I

I

L--·------~--------J-------~-------------·BAD ARGUMENT.
An invalid device was specified.
Ex~.r~!cs:

a. c E
TI10 spooling area for the virtual printer is printed and released.

dcvaddis the device addre·ss of the virtual canl reade1·,
card punch, and printer, which a1;c norn:ially OOC,
OOD, and OOJ•:, respectively, for CMS.

Usage:
In rclc~sing the spooling areas for the virtual can! punch or printer, CLOSE
punchc,s or prints U1c coHtcnts of tlw spooling area on the real device wlwn thatdevice ;he comes availabk. TI1e printed output is preceded by one page containing
the usqr's iclcntification, U1c date and tl1c time of day in tlie following format:
v~o"1•)
07/;iS/tc.1 07:.s."':s::l(.
Cf'6"/U,~.11211)..) .. ·.-- 11 l 1-1-- .,l I. I I . u...

'

111e punched ou.tput is prccmlecl by one card containing the user's identification,
the da~e, aml the time of day, in the following format:
colunms 1 - 10columns 13 - 20columns 25 - 32columns 37 - 44columns 49 - 80

Cll>7USERID
user's ill, left justified
date (mm/dd/yy)time (hh. mm. ss)
asterisks ('~)

This punched ID card is in the correct format to be used as the input identification
card required by OFFLINE READ (see Section 3. 1. 11).

(

In re~ea sing th1, spooling area for the virtual card teader, CLOSE
assumes that the user has read all the. cards he wants from the current
card <leek and frees the spooling area. If another comn1and to read acard :is then executed, CP will return either the first card of the next
deck ~t has read for th~t user (if any), or reader-not-i~eady.

,~)9-17-67

9-17-674.1. 3-1

50/
DETACH
----

4.1.4-1DISPLAY---

ai.5

4. 1. 3 DETACII
4. 1. 4 DISPLAY
Purpose:Purp<:J~c:.:_

DETACI I removes tJ1c altachcd device whose address is specified from thevirtual machine configuration.

DISPLAY types out in h(•xadC'cimal the contC'nts of the virtual machine's corestorage, general purpose registers, floating point registers, and/or program
status word.

Format:r - - - - - - - - - - - - - -,- - - - - - - - - - - - - - - - - - - -1
I

:

I

.

"

I

; DETACH~ :1. 1

Format:I

dcvaddr.
-----------------------------------------------------------:

I

L--- ~ -- P..~- - - ~- ·- - ---------- --- --• -- !
dcvaddrI~

hcxloc] [ hexlocl-hcxloc2] [ Lhexloc]
fmsPLA; 1 [(Lhexlocl-hcxloc2][Greg] [Grcgl-rcg2],.

specifics t11c addres11 of a device that had previously
been attached to tllC virlual machine.

I

D

\

I
.

:

( Yreg] ( Yrcgl-reg2] [ PSW]t.!

·-------------~-~-------------------------------------------·

Usage:
hexlocis interpreted the same as Lhcxloc.

only be issued by the CP operator. Once a device has been attached to a virtual
machine (sec Section 4. 2. 0 for a discussion of attaching I/O devices), theresponsibility is left to the user to remove or detach the specified device fromhis configuration. As long as the. device is attached to him, it is unavailable
for use by any other user.

hexlocl -hexloc2

is interpreted the same as Lhexloc1-hcxloc2.

Lhcxloc

displays in hexadecimal the contents of the specified
hexadecimal location hcxloc.

DETACH removes the specified 9evice address from the configuration. As soon
as the device is detached, the message "DEV dcvadd DETACHED" is typed out
at the tc:ntlin;:il and the device is free for use by other users. Also, a message
is automatically typed out to the CP operator specifying the device that is free.
If the device address detached is that of a tape drive, the tape will be rewound
and unloaded.

Lhcxlocl-hexloc2

d{spl:iys in hexadecimal the contents of the specified
hexadecimal loc.:itions hexloc1 thrnugh hcxloc2.

Greg

displays in hexadecimal the contents of the general
purpose register reg, where reg is an integer ranging from 0 to 15.

Grcgl-rcg2

display:; in hexadecimal LhL' contents of gcncrul purpose registers reg1 through rcg2, where rcg1 mustbe less tlrnn rcg2 and each reg must he an integer
ranging from 0 to 15.

Yreg

displays the contents of the floating point register
reg, where reg is an integer ranging from 0 to 7.
If reg is odd, it will be adjusted to th(! preceding
even integer. The contents are displayed in hexadecimal in two f9rms: tpe internal format and in
the E format.

DETACH is used in conj~mction with the console function ATTACH, which can

Rcspon~c:s:

DAD ARGUMENT.
An invalid aI!,'1.lmcnt was specified.
DEV c\cvadd DETACHED.
TI1e SfX.!Cificd device address is no longer usable.
again for further use.

The device must be attachedNONEXISTENT UNIT

The specified unit docs not exist in the virtual machine configuration.
been detached or it was never attached.

It has either

Examples:a. DETACH 181
console function:
response:

dr.tach 181
DEV 181 DETACHED

Unit 181 is detached from the virtual machine configuration.

~·•:; : ' :a:: I:::::au 1:::;::u::::::1JJU41# '

A
IJ

'*

> -1"

~

';NSk:UMUI I JIL . . j l.14$1.U! 14 I. AiiiliillLIUii 'ii l .,Ji! a it ii# .$14 'J&£.lii4U J$2u.j i#Ji#. :;se' ,# !#412# HAM m4 !fW• """"'" ''"'"'. I,;;;:µ;"'''''"•· """'''""£"""'\ '"'""ii.,,",l.iL...,"u'·'"''¥1WILa+r t ·¥11.&iiLL.&... ' &¥1•

,,..

"""

""'

. 9-17-67
4.1. 4 .. 3..t4-,

9··17-67

4. 1. 4-2

514

DISPLAYDISPLAY ...l)lJ/,

Yregl·rcg2

PS\ydisplays the contents of the floating point registers

IJb.

rllsplay 12000-12010

regi through rcg2, where reg1 must be less than
reg2 and each reg must be nn integer ranging from0 to 7. If rcg1 and/or rcg-2 is an odtl intc:gc1· 1 eachWill be.· adjusted to the prccL·ding even integer. The
contents arc displayed in hexadecimal in two forms:
the internal format and the E format.

l 12000 • OSC050EO
00385030
C7EESS30
CSOCiS833
The contents of hexadecimal location 12000 through 12010 is displayedin hexadecimal in multiples of full words.

displnys as two hc.xadecimal words the contents ofthe program status word (ISW).

The contents of general purpose register 1 is displayed in hexadecimal.

c.

dI sp l ny

r.

~c. <l y2yWhen Dl~PLAY is issued, the arg11nwnts can be combined in any order desired,scparatci.l by one or more blanks, up to one input line in length. If nc.ither G,
Y, nor L prvcedes the S(K'Cifivd number, Lis assumed. J[ an invalid argumentis spvcificd, a mes:;agc is typL~d out and the console function terminates. If
any valid arg1(nwnt~; WL!rc spccifil'd before the invalid ouc-, they will be executedprop.:rly.

f.

~

yl-fi

y

Note's:b.

No imbcddcd blanks n re permitted within an argument.

'(g.

The specified information is typed out.

000083110

00000082

00000400

2 c 0004560000000000.1462729qf4G232350 F-78

= 1230000000000000
2 = 00045~0000000000
4 = onooon~~111noooo

E-5G

0

.76468~1173435770q

fi.1462729q646232350 E-7R
.880575434523135G7 E-82
.51817n1133Q51~540 E-77

= 009999~~99990000

1 nsw
p51.-1oonooc0n aoool374

The contents of the program status word (PSW) is displayed in hexadecimal.

DAO ARGUMJ·:NT.
An Invalid argunwnt was specified. If valid arguments were specified before
thl! first i11valid Otll', they were' cXC'CUtt'd properly.

h. "c1 p.;l-l.1 140-50 y4 PS\'/

n
L
v
PSW

!~~£11~1~~

rllsnlAy 112403
12~00

00008990

The contents of floating point registers 0, 2, 4, 6 arc displayed inhexadecimal in'!_wo foi:ms: the internal format and E format, after
the specified register 1 is adjusted to the preceding even integer 0.

~~~~

~

1 = 00011C9R

The contents of floating point register 2 is displayed in hexadecimal in two
forms: the !internal format and the E format.

yy
The contL'nts of core, the rcgistcJ:s, and the PSW arc not altered byissui1)g DISPLAY.

"1; 1

The contents of genqral purpose registers 1 through 5 is displayed inhexadecimal. ·Defore th\:! specified contents of core storage is displayed, alignment is madeto the nearest full word boundary. The Olll1'•lt is typed in multiples of a fullword (8 hcxadc:cimal characters) and all informaliou is displayed in hexadecimal.

a.

cnons21

1 ~ 00011C93

d. d ~1-5
ysagc.!_~.oOi'= 9208Fl7E

1 = noo11c98
nnoo~qg~= 00011~~0n~onnonn
4 = nooonroronono~oo= oononooo Rnoot374~~

OOOOR~~O

nno11~~0

OOOOOOR7

FFFFFFFF

TI1e contents o{ gencrul purpos~ rl'gisters 1 through 4, hexadecimal locations
40 tlu-ough 50, floating point register 4, and the program status word arc
displayed in hexadecimal with one console function.

The core storage location 12-103 is adjusted to the nearest full word boundary
12400 and one full word is displayed in hexadecimal-~)

7~FFn~~~.oonoooooc90000000 F co

4.1.5-1
DU!---1P

9-i7-67.

4 1 - 9-17-67•• ::>-2.

)b'l

SOJ'

DUMP

~s-z 7_...._\4.1. 5 DUMPJ

Usags_
Purpose:Defore the specified contents of core st.oragc is dumped, aligmnent is made to
the nearest full word boundary. 111e outvut is printed in multiples of a full word
(8 hexadecimal ch:1ractcrs) and al_l infonnation is clumped in hexadecimal.

DUMP prints·in hexadecimal on tl1e virtual printer tl1e contents of core storage,
general purpose registers, floating point registers, and/or the program status
word.

DUMP prints the specified information on the virtual printer. In order for CP
to close the virtual printer (to release the spooling area} and print the dumped
informatioJ1 on the real printer, the console function "CLOSE OOE" mqst be
issued. CLOSE need only be issued once for the printer aftcl· all the variationsof DUMP have been given.

Format:_______________ i __________ _

II

I

I

I
I

I
I

{D~~}

t_______________

I[hexloc] [hexlocl-hexloc2) [Lhexloc])[Lhcxlocl-hcxloc2] (Greg) (Grcgl-rcg2] 1[ Yreg) [ Yregl-reg2] [ PSW]>

When DUMP is issued, the arguments can be combined in any order desired,
sep:iratcd by one or more blanks, up to one input line in length. If a.n invalid
argument is specified, a message is typed out ru1d the console function terminates. If any valid argunwnts were spccifict.l before the invalid one, they will
be executed properly.

t __________________ ;hexlocis interpreted the same as Lhexloc.

hexlocl -hcxloc2

is interpreted the same as Lhexloc1-hexloc2.

Lhexloc

dumps in hexadecimal the contents of the hexadecinrnl location hexloc.

Notes:

Lhexlocl -hc.xloc2

Greg

Grcgl-reg2 'Yreg

Yregl-rcg2

PSW

~
iii•

a. 'I11e contents of core storage, the registers, and the PSW arc not alteredby issuing any form of DUMP.

dumps in hexadecimal the contents of.the hexadecimal locntions hcxloci tlu-ough hexloc2.

b.

No imbeddcd bla!lks arc permitted within an argument.

Re~J2~~-scs:

dumps in hexadecimal the contents of the gencr<llpurpose register reg, where reg is an integer ranging from 2 to 15 •.

After the completion of valid DUMP console functions, the keyboard is unlocked.
DAD ARGUMENT,

clumps in hexadecinrnl the contents of tlic general
purpose registers rcg1 through rcg2, where rcgf
must be less than reg2 and each reg must be an
integer ranging from 0 to 15.

An invnlid argu111e1;t was specified. If valid arguments were specified before
the invalid one, they were executed properly.
Example_;a.

dumps the contents of the floating point register
reg, where reg is an integer ranging from 0 to 7.
If reg is odd, it will be adjusted to the preceding
even integer. The contents arc dumped in hexadecimal in two forms: the internal format and the
E format.

dump gl-15'dump yO-li
du111p o-80
dump psw
c e

dumps the contents of the floating point registers
regi through rcg2, where regi must be less than
rcg2 and each reg must be an inkger ranging from0 to 7. If reg1 and/or reg2 is an odd integer, eachwill be adjusted to the preceding even integer. The
contents arc dumped in hexadecimal In two forms:
the internal format and the E format.

General purpose registers 1-15, floating point registers 0, 2, 4, and 6, corestorage locations 0-80, and the program status word arc dumped on the virtual
printer. To close the virtual printer aml print on the real device, "C E" wasissued. The dump output is shown in FIGURE 4. 1. 5-A.

,

- ..
....J

dumps as two hexadecimal words the contents of the
program .status word (PSW).

~,~.

u::: :::;;::e. aq @';IMllii ... LSI Li,LQCli . . EiS:JAWWW#J#SQUl!WiU#. ,.$! l!C#Uil# .QSQkEQli$1UAILA 44JUJJ, 11;4 AWJ i@#AIJ444ii#J.4j 'i!f . &Mti .•....U&@Ji.W!.i@l@IU&::: .. CBL . k. . .•.£@H· . wamw:ff±J,!'?.f.,tj!+ . .Jijrt'ni\'4 r l'iiMM +!11'' ffl!!"~~
11.•, ...

~

~

!""

05/01/69.•
4. 1.5-3
DUMP

u. <t J.J ::.
u. a') .0 t.(\0'°.....uc
0

0 ....

00

0 Ci
OC•
Uv

U.U..0-<t.(\..j°u. u... I.I. <J

.L.

'='~
Qr-

.fsuat:

EXTERNAL

Li- LL L!. "'\u... u.. ..L. .....

CJ•.::;,

Eu.. r-

LL i.1.. U... t:;i() :'...J.J..

~

u. ..L. •:>o~u.. .Lu. Q

O:J
0 r-

.J..LLUO
u. ..... ·:O •'.)·.J.. ..L 'J .)

·a0

-t- n

'...:I.I"\'J .:.>
CJQ
":l 0

~

u.. u.. ".) ·):.... .J.. .J.. ::>-@U.LLU..O

8
6c:i

..L.

{/)

u.... -\... - t

a o '·"' Q o :.::; u.. .J.. r- :..J'."l".":>0".">Pj

UJ .I.. l.U u.J~:x:;..L LI. J. 0'.C"'r:J ...,...,"."\U.. :.J.. ..J.....

OJ)·::>o·::iau..LL.u....uEo .... (:>o ...,ou.lt.J..r-·::> ':) LI Cl ·::> <;.} ..L. U.. .J.. 0::> :::> ·:J <.:.> '.:; ';:) u.. .J.. IJ.. 'J
O '--' c:) 0 0 •.::> .J.. IJ_ u.. 0':> 0 u :J •.) ·::> •.J.. .l... .I..<";">.

~
+.•

~

'.0'.:>00UUUu..-<O
0 ·::i '.) <) .J , , \... ...... t':> ~) ::J 'J ':) •:> u. .·, 0:::. :.:::> {.• ·J .:> '.:> ...:> .J... ._) .....
o ':J • • • • r.J u... n ·:.)

0
0

::>-<

O<tLl'.l'J

O>.CJ

0·.LJ'...)r-

,..4
~

~

'1"
,.._
f""I

'!'.)

r:'>. ·:> ".:. ~ ., ..::> i_) -:> .•") '.:".'- :"'·::;, '.:) ?
~,...,:i ,..,"-> 0·.:.> (,,)..0 J> (~ u .J v

00?

'.'l•:'I ':->".)-r.0 <! 'J \,.,) u. 0

O-uO:...>->u·"'--->uv.1..0._, 0 ·-: ..) ·::> -J ]' •.J :_.1 •.'.) I. 0_. ".) ':' 0 . ) r;:i "O ? •.,, -i .I.. '::>.... ':> C> 0 .:;: .'..) ..) '") ...... ·:" u.. ::::>::> :::> ·~- .:> 'J 0 ·:::> ::::> "'."> ;) LL.:::>
0 0 C) 0 :> ·:> ".:) .J.. ::> ..... J.. 0

u

J

._, J

.) ..) Xl .J..

:> ·.:> .J... 0

II

11

II

II

II

II

~"'o"'

•

II

11

II

11

Cf ENTEREt,

R~QUEST,

PL!ASE •••to be t~pEd en the terttjnal and tbe CP envircn~e~t is entered.

8~]S.H£.D§!JS:

DEEUG ENTERED, EXTERNAl INT.
CMS was previously IPLcd. When the external interrupt occurred,
the Debuq environment was entered.

,....

:> 0 '..) :> .J ·->? ' : ) .....,·'.) ':'l....,·'.> ..J ~ c:>On a real machine an external interrupt is a means ty which thecentral ~recessing unit res~onds to signals from the interrupt
key on the co~puter ccnsole.
EXTERNAL simulates this externalintertUft, which is then reflected to the victual machine, andcontrol is returned tc that uachine.
If the user had previously
IPled ens,' the Debug ouvironrnent of CMS will be entered ftcm theControl Prcgraro.
If the user had not IPLed CMS, the e~ternalinterrupt lill cause the message

If):i.....
.-c.::i .... :::i.:.>::ioc.o0 ..·1'.) ':::> 0 '..:> J r.) 0 J 'J ':!
-t"(t>l.)]§~.9.&:::sg

UU'.>:.J~J 0·~\ ~.J".)..) 0 :::>.. o ..:> '.) C-.• ,_•.) '::> 0 LL. 0 ·J'...:-r-00.JoOu..·..:.10
ro o ·:> •:J ·-· ·.-:J .::> ..1.. J oIIII..:- -0 ·J ::i ·.:> ::.:io"' ..:- 0 Xl

J:
I.I)

'.!) •!)

virtual mac=hine

u. u. ..L. 0

00

0

'I

u.. (.) u.J.. u..

0-'

ifaf;1f!Xtf.RNAl

BX7ERNAL simulates an external interrupt en theand returns ccnttcl to that eachino.

u. a- o c•
u. :.:.> ~ 0
u.. 0 ':'. .;lu. 0 ".) 0
u.. 0 -t ~u. 0 u f..)00
1:; ,".')..:>rnq.1.6.fnR2'fi~:~.... C(l<;u. 0 0 0
u.. 0 p u
I.I.. 0 '.:.l 0
u. II"\ 0,..,

:.>

.570

S-/I

u. <. ..... .,..

....

a..l.6·1

9-i?-67> >- ).. > _, _, ..J _, _, Q.

C~

BEQUEST, FLEASE.
systEm hdd been previou£ly lPLed;

E~2EEEC,

therefore, vheu
the external interrupt cccurted, control vas returned to CP.

No opcraticg

05/01/69

05/01/69

4.1.7-1

11.1.14.1.7-2

/lfd'

IPL

S/.-2...
lYHf.~lQ:

IPI causes the Control Program to sioulate an
Load (IPL) sequence on a sfecified device.

Initial Prcqram

6/3 .9'f!
-·

BAD AEGUi'IENT xx
An 'invalid, device address ~as siecified.

EEBCE CURING IPL SID.
CP is unatle to loarl from the specified device. If the card
reader had ~Een srecified, chock tc see that cards had been read
intc the ~irtual card reader by tho conputer operator.
UNADlE TC IFl SFECIFIEt UNIT TYPE •specified unit cculd net he IPLed.
Check to see if thes~ecifieddevice address is included in the virtual machine
contiquraticn.

.f.fH..9.!:

1he

lFL
I

I
I
.1
I

CMS

devaddI
I
Any ether resfonses are
beirg leaded.

I
.J

CMS

siecifies tbat a "saved" CCfY
cf the Cambridge Monitor Syste~
is to be htcught into core.

~evaddspecifies the address cf the devicetc be IPled •these cf

the new

envit'onment that.Y!29.!';:IPL si"ulates the IPL tuttcn on the computer console by resettinq
the virtual machine and causing a record to he read frc~ theffecified 1/0 device and exectued.
During the login procedure of CP when the message
READY AT XX.XX.XX ON XX/XX/XX

is typed out, where xx.xx.xx is the tine cf day and x~/xx/xx is
the date, CP is ready to accept any confole function. By issuinq"IFL Cl1S 11 or "IPL 190 11 , the Cambcidqe Hcnitot' System(CMS) isloaded and the CMS ccattand environment is entered.
1he "IPL 150" ccnsole functico vill lead in a copy of the nucleus~hich resides en disk 190.
Periodically, a copy of this nucleus

is saved ty a CP utility.
The "IPL CHS" console function will
load iri this "saved" copy cf the CMS nucleus. This means that if
thE nucleu~ on 190 has been modifiEd since the last copy was
saved, the versicns referenced by "IPL 190" and "IPL CHS" vill be
diffErent.
j . U.B.2.D1l~ :

~
1

I

•

~·

is

""i

~

.~

05 /01/ 6~!
4.1.B-1z,·' _,,LOGOUT"·1.S/:.;f-.-!J"\)/;/.f.l;!].Q~£:

lCGCUT remcvE~ the uset frcm the system by releasing the victual
uachine and any attached devices, clearing the temporary diskarea~ and clcsing the spccling areas.
·.f~H":..,.

--

lCGGU'I
LOG<anything>+ -· -

anythin4i

If any ncn-blan~ chatactet stringis specified with LOGOUT, thetelefhcnc line iE not hung UF andthe terminal remains connected to
CP fer ancther user to login or "dial" in •.Y!~.9j:

LOGCVT Jo~s the user cff. thesystem. 1he·teruporary disk area isand all spcoling areas are closea. If there is cutput inthe spQclinq areas,
it will be Ftinted or punched on a real~evice whet that device becones available, as in CLOSE.
clea~ed

Because of the finality ofaccepted js "lCG 11 •this command, theonly abtreviation

If 'HCID' is specified, a lCGOUT occurs in the nor~al nannet but
the coumunjcaticn line is net disabled. Upcn completJon of the
LOGCUT procedure the 'CP/67 online 1 message will indicate thatanot~er 1 lcqin' cc •dial• can pcocede •.l!l..HQ.D.§.f~:
1CGCU1 AT xx.xx.xx ON XX/XX/XX
i~ removed from the system.
day and the xx/xx/xx is the date.

The user

CF-67

C~LINExxxxxxx~xxxx~he

The xx.ix.xx is tbe time ofx~xxxxxxxxxx

CP-67 ONLINE
CP-67 ONLINE If one of the above messages is typed out after
LOGOU1 message, a non-blank character string .was specified

with LOGOU7; thereforeanot~eruser.

tbe terminal remaini connected

05/01/69
4.l.S-2

to CP forS1[ ~jt

11.1.s

r.sc

05/01/69
4.1.9-l05/01/69
4.l.9-2

'&/;7

&fl"

..S/b
1.Y.H.HQ!

USBB ~CT CN SYSTEM
1he spccifiEd uset was not logged
was not sett tc him.

;s/7

on the system sothe message~SG

sends a specified messaqe to either a specific user or to all
usetE.

.l!~..!J!Jg:

l~H.5!!:a.

MSG

user id11

CP

usetid
CP

line

..

msg CI please attach a tape drive to 181

1he message "please attach a tape drive to 181" isthe systeas oFcratcr•s terminal.

I

tyfed out atline I
I
I

specifies to whom the message shouldbE sent. If •cp• is sfecified, themessage is sent.to the systems operator
whatever his userid ·1ight be. For thisreason no user should have the id of
1 CP'i CPxxxx»x is acceptable thcugh.
is the messaqc to be sent to the
SFecified uset or users.

]§.B~:MSG allo•s the users to communicate with the CP operator in theecon a~ well as vith ether us:ers. The specified user
1ust be legged on the system before a messaqe can be sent to him.
If a specjfied user is not logged on, the 1essage "USER NOT ON
SYSTEM" is typed out and the message is not held until he loqs
en.
ccm~uterA message that is sent by !SG is in this format:
PBCM

userid: line

ThE messasE will be ty~ed out at the specified user's ter~inal\hen the terminal is not teady for . infut. If the terminal iswaiting fc1 input. the aGssaqe will be held until a carriage
return ~ccurs •.1Uli2D.§!s:'lhE

userid NOT BECEIVING
user has SUFJ:re:ued his receiving of 11esi:ages.

~
1'¥11.4iii4Uiiiiijli@\\!.l,IMllUii#.il,l!!i,iij#,l141iii4U!!Mli;.;:;,:;;;;c:;;;;:;:::uJ,.,.$&$11 )IJ.Li ¥11 ll.JU:,..

~;:: Id! ;: !4$,. ;z;:;;;g;: e;;;;:;;y:w;:;:... ;1::;;;;441;;;4 J.,# ,;;;::::. LUl•;;;u;;u;y:;;g' ,) +;!if iibf'l't~• ,,, .... ¥"ff,!', 1 ,,."l!"'!'!!''!"ii'#!!$;"fAl@,lii91i!§~l!f'\!i*'li!'lll#!l!¥'"~'!!!r""!!1j!!!'i'~'1'1!(!!!1!1~'1f'!l~!iM,•~~p

fl""

(""'\

'""'

05/01/69
4.1.10-1
11.1.10CUEliYo·s101/69
4.1.10-2

virtual machines using the CP-67 DIAL
capacity.
·~:/'

g1;1;1:!;/ ~.F..YJ..E.Qfill :S!'iUSER. NHESCUEEY ty~ef out either the number of users logged on or dialinq,
the idEntiiicaticn and ter~inal address of the users logged on,
the taximun number of users allowed to leg on the systen, the loq
mcs~ages sEt hy the CP cperatcr,
the maximum size of the console
disfatching queue, and the number of spooled input and output
files cutrently held by CP for the user.

same function as CUERY names.
USER USEiid

same as.QUERY USEiid.

l.Q!JH!!:

use.rid

types out the userid and the terminal
address ~here he is legged in, cc
qivcs •USER NCT CN SYSTEM•.

I

r

I
J
I
I
I

Fl LESlOGMSG
CVF:RY

c

~AX

NAMES

C2
USER <na~es>
USERlD <uscrid>

I
I

I

.

'flLESF.

types the number of spooled input andout~ut files currently held by CP for
the user.

Jl§~.9~:'UEEY is used to deteLreioe the numbet cf users lcqgea on or
dialing, ~to they are. and what their terminal addres~ is, howmany are allowed to log en, what the loq messaqe is, the size ofthe interacti~e dispatchinq queue, and the number of current
spooled files fer this uset. This information qives an idea ofthe systum load as well as any pertinent information about thesystem. !~e lcq r.essage i£ ncr~ally the messaqe that types out
cnce the ~~er has logged on under CP.
j:g~,f.f.!l§gf!

BAD A W'UMENT. xx

An invalia
lCGMSGtype~ out tho message of the day setlty tbE operatcr.

MAX

t

U~ES

N

(;2

c

ti SER

types out the maiimun number cf usersthat the operator allows to leg on to
CP. If it is zerc, nc naximum number
his been set.
types out the userid and terminal
address of all users en CP.
typen the ~aximuD size of the ccnsole
dispatching queue.

types out the number of •virtual machine•users and the nunter of users attached tonn

a~gument

was specified.

U~IRS;

If the USEF nn tIALEt arqument was specified,
this 1essaqe
indicates that nn usc~s are eithet legged in or "dialed in",tesrectively. If the MAX argument vas specified, this messaqe
indicates the aaxinu~ numhet of users allowed to log on to CP,
Conly nn USE~S printed).

usetid -xxx, usecid - xxx • • •If the ~A~ES argument
fout tc a line.

wa~

specified, current users are disflayed,·uscrid - xxx
This is the resFonse tc "Ouserid" if that user is loqged

USER ~OT ON SYSTEM
lhis is thE response to "0userid" if that user ls not lcqged anon~05/01/69
4.1.10-3

tc CP-67.

05/01/69
4.1.11-1,/J';tt}

PILES: xx BDB, xx PB1, xx PCfi
lbe au1ber of spooled files for this user is printed.

~-

q •.1.11

BEADY

h~.t'

s....ql.!!H.SJrn:

XXXXll ••• XXXXX

this is tt.e leg message obtained
LCGMSG atgtment.

as a result ofspecifying tho

6EACY

simul~tesad~viceend fer thes~ecifiedvirtual address.

I.2.!.!!!~...t:l.1.U.El!l§!

a.

- -._ - - -query user
04 USE5S; 06 DIALEC

RUDY

-

Fout usets are logged on the system.
Six users t.ave •DIALED' other ~irtual machines.
dEvaddt.

q namEs
HUMCN
OFER ATOR.

024

liCU1AN025, BlP-04B.YH..9~:ofusers en the system has notacuse~

Cn • nal aacHne aend isby the ccmpletion of an
I/C oreration at a ·device or, on some devices, by mar.uallychanging t~e device f~fm the net-ready to ready state. A devico
end normally indicates\ that the I/O device has become available
for anothEt Oferaticn~ READY Eimualtes this device end without
having tc complete an 'f-1.0 operation or without making a device
not-rea.dy.
\\

been set by the. ]~.U:.Q.!!.§~..§:

Cfetatcc.
d.

"

~vice

the system is typed cut on the

q DI aJ
00 CS IRS

A maxiau~ ~umher

specifies a virtual deviceaddr~ps, such as 191.

-023, CJCHNSON -024

009,-APL

A list of current users logqed onterminal.
Cede~add\'1\

BAD AfGUMENT xx\
An invalid device address \as specified.

g lcgasg

TS tOkN AT 12 SHARE\
ihen log messaqe
tyfed out~e.

"TS tOWN AT 12

SEAP", sEt by theo~erator,isNONE11S7ENT UNIT\
The speci1ied unit dGes ~ot
configuration.
·inthe -virtual

FILES: 01 BDB, 06 PRT, NO PCH.l.U!U:l£§:qa.
RUCY 191
A device e11d is simulated for the device whose address is 191.

tes~21

2'EMP21 ON 032
CJ

teap4

USEB

•·\A!¥-

machineg f i ]ES

1he nuabet of separate spooled files for the user is shcvn. It isa total fox all ~ittual card reader, printers or ·puncheE.
f.

exist

~O~

MJiii),,,j!iJJt;J;&:iit!i,... !;/SiW,.i..i!!!i.&JM&ii.i&,J...&!M& ...i.!Li£JUL..,~,ON SYSTEM

_,.
g

i..

;a

1$DWWWWW

P4Wi!!!!A

iiii!li!W

4ii;:;; nn1ii.4iiMIWFili

1n1•www&1HHU

iq11111!!111.--11111!11--lllll!lllllll!ll_ _ _ _ _ __~

1/26/70
4.1.11-1

- _J

READY

•

4. L 11 RE•.\DY•

Purpose:•READY sirnufatcs a device end for the specified virtu~ address•

.

•

:-

•

·Form:it:.--·~~~--~~~--~-~.-~~~~--~-~-~~·-~~.

t

.·

·

! .~iADY_} lIt

devadd!··----~---~-~----~~~~~~~-~~-~~--~~~~·

specifies a virtual device
address, such as 191.

dcvadd

·•

'

•

;

On a re~ machine a device end is ~used by the completion of an IiO oper:.ticn

..
t

....

Usa~

..

....

.·
·-~-.(.. .

at a. dcvicl.! or, on some d~vices. by m2i:ially chJ..i1gmg ri:e device f..roo t..':e :ictready to the re.:idy st:!.:2. A device end norm~ly ir.dicc.tcs t.l;.;::.t t.~c i/O de . . ·:~c
has become :i.v~bbk fo:- 2J1.0t~2r 0~~!'~to~. I!.EADY sir7!ubres t.":is device er.dwithout ho.vin; to complete an I/0 o::eratioLl.: or wiu.~out mak.t:g a device not-ready•
Responses:
BPJ) ARGt!~!E:~T.
An invalid device address \Vas ~pecificd.
I~ONEXIST!::~~T U~1T

The ·Specified u..1.it cccs r:ot exist in the virtual machir.e configurution.
Examp1cs:

a. READY 191-·

A device end is siffiubted for the device \vhose address is 191.

..

•

•
·.

-.. _........

..

•

..

.

l,

•

1/26/70
4.1.12-1....

4.1.12 RESET....._·.

.
•RESET simuLites L'le system reset key on the system control panel•..

•

Format:·

.:. t
~

:

!

....

:

~~~~~-~-~~-~--~-~

.

RESET

=:/i{S }

~--

:

'

:

:-...,;~----------------~---·. ....
:.-•

psage:-··":"'.:....,.

.......

RESET places rte virtu:ll machine in a stopped st~te and resets all penC.ing I/0
interrupts. All error cond.itio:is a=e reset. The system is automatically resetby IPL.

.

Respons~

None.

..

. ..

...

,.. ..
·•

.,

RESET

.

fur pose:

...

. __

•
..

.

.

·~·

"'

-"1·

~

9-17-67
4.1.13-1
STORE 5JJ

9-17-674.1. 12-1~:J...)_
RESET

4. l; 13 STORE

4. 1. 12 RESET
Purpose:RESET simulate~\hc system reset key on the system control panel.
Format:\r-•

STORE replaces the contents of specified locations in core storage, general
purpose registers, floating point registers, and the program status word.
Forma!;

I

l \RE':\Tl !
I''- - • - • • • - • . • -Purpose:I:\~..: - • • • • - I

Usage:\ \RESET places the virtual machine\~n a stopped state and resets all pending 1/0
interr;upts. All error conditions are reset. The system is automatically resetby IPL.

.----------------~------------------------~------------·
I

I
I
I

l:

I
I

{STORE}
ST

I
I

I

I

I

t

( Lhexloc hexinfol. .. hcxinfoN] .J[Greg hexinfol. .. hexinfoN]( Yrcg hcxinfol. .. hexin!oN](PSWQicxinfo~ hcxinfo~""f'---. ------- -----· -... ---.... ----... ---... --... ----. ----. --------I

Lhexloc hexinfol. •• hexinfoN stores the hexadecimal values hcxinfo1. •. hexinfoN
l.n successive full word locations starting at hexadecimal location hexloc.

Response:.:_,,-'·None.,

Greg hexinfol. •• hexinfoN stores the hexadecimal values hexin.foi. .. hexinfoN
J:n successive general purpose registers starting at
the register specified by reg. The parameter reg
must be an integer ranging from 0 to 15 and successive values of reg cannot exceed 15.
Yreg hexin.fol. •• hexinfoN stores the hexadecimal values hexinfo1. .• hcxinfoN
Jin successive floating point registers starting at theiregister specified by reg. The parameter rC'g must
be an integer between 0 and 6 and succc.ssive valuesof reg cannot exceed 6. If reg is an odd integer, it
will be adjusted w the preceding even integer.
PSW [ hexinfol] hexinfo2

stores the hexadecimal values hexinfo1 and hexinfo2
In the first and second words of the program status
word. If only hexinfo2 is specified, it is stored in
the second word of the PSW, The interrupt code is
set to zero. The hexinfo1 and hcxinfo2 must be separated by one or more blanks .

.

.

9-17-67
4. 1. 13-2 r Jd
STORE-"'..._!

5;2.'f'9-17-67
4. 1. 13-3
STORE

·=>

Usagi.:~~·

c1 psw

The smallest group of hc.icadecimal values that can be stored is one full word andalignment will be made ti:.> the nearest full word boundary. If the hexadecimalvalue being stored is less than a full word (eight hexadecimal characters), it will
be right adjusted in that word and filled in with high order zeroes.

Strl

8C00137~

S5 5 5 5pSlr/= 00000000 00055555

The contents of the l'SW is displayed. The hexadecimal number 55555 is rightjustified, filled with leading zeroes and then stored in the second word of the
PSW and the interrupt code set to zero. The PSW is then displayed to reflect
the change.

JC inv:ilid arguments nre specified, a message is typed out and the console function
terminotcs• If there arc any valid arguments before the invalid one, they are
executed properly.

d.

rf OS\'/

PS'.•Ist

Response:
rl

m

ns~

nsvt

PS 1 1

13AD ARGUMENT.
An invalicl argument was specified. If there were any valid arguments before
the invalid one, they were executed properly. The console functlon termlnatedon the lnvalid nrgumcnt.

ncnnnooo p~n0137~

111111 12000• nn11nnon ono12ono

The contents of the PS\V is displayed. The hexadecimal numhcrs 1111 H and
12000 are stored right justified in the first and second words of the PSW and
the interrupt code in the first word is set to zero. The PSW is then displayed
to reflect the change.

Exnmt!g~d 12011
L 12010

PS\'J

PS'·/

'1l1e options can be combined in any other desired, separated by one or morehlanks, up to one full line in length and issued in a single STORE console function.
Either L, G, or Y must he specified or the option will be invalid.

a.

• 00000000

PS'..J

5.:-< §'

= 4110D01r.

st 11201l 57'3
d 12011l
12010

00000579·A full word at core storage location 12011 is displayed after alignment is madet.o the nearest full word bound.:try 12010. TI1e hexadecimal number 579 is right;ustified, filled in with zeroes, and then stored inn full word beginning at
location 12010. That word is displayed again to reflect the changed vaJuc.
b.

d gS-8~s • ,00000400

st gS 123 456

oooooooc

0000049COOOOOOO!i00000456

OOOOOOAA

00000004~arl g;i-8"

5 • 00000123'The contents of general purpose registers 5 through 8 is displayed. The hexadecimal numbers 123, 456, and AA are right justified in separate words, filled
m with zeroes and then stored in general purpose registers 5, 6, and 7. The!Contents of registers 5 thr1~iugh 8 arc then displayed to show their stored contents.

•

'~)

~

~·

01/24/70

4.1.14-1

SET

4.1.14 SET(

Purpose:SET allows the user to (1) save the card file in his ·virtual card reader, (2) control the messages andwarnings typed at hi's terminal, (3) control his runningstatus, and (4) convey information describing his
physical terminal.
Format:••·--~----~--~--~~----------~---~--~~-~------~-~ON
I
II

CARDSAVI

MS GOFF

••I

-OFF

I

-

•
••

MSG ONI
I

I·-· SETI

RUNOFFRUN ONWNGOFF
WNGON
I·

•
I
I

.

. •

I
I
I

5

TIMEOUT

LINE
TABS

OFF
ON
SHORT
LONG

n 1 n 2 ~~~ n 7'---~--~---L~---------~---~~-~--~~--~---~~----CARDSAV ON saves the card file in the virtual card reader
so that it can be reread.

CARDSAV OFF erases the card file in the virtual card reader
once the r'eader has been closed.

(.

MSG OFF

specifies that no messages. are to be typed at
the terminal.

RUN ON

allows the user to activate the ATTN button
causing a "read" of a CP console function
without stopping his virtual machine. ~'>'ben the
CP function is typed in, it is irrnnediately·
executed and the virtual machine resumes execution.

RUNOFF

places the user in the normal CP environment
suc4 that when the ATTN key is hit, the virtual
machine stops.
#'l,1

01/24/70
4.1.14-2

SET

4.1.14 SET
YNGO~

specif !es that all warnings are to be typed
at the terminal.

WNGOFF.

specifies that no warnings or messages are to
be typed at the terminal.

TIMEOUT ON

specifies that the user's terminal is IB~f 1050like and lacks the timeout suppression feature.

TIMEOUT OFF negates the effect of TIMEOUT ON.

LINE LO~G

specifies that the user's terminal is teletypelike, but allows lines of 130 characters.

LINE SHORT~egates

TABS

specifies physical tab settings on the user's
terminal to reduce the time required to print

the effect of LINE LONG.

lines.
Usage:SET CARDSAV ON does not erase the cards in the virtualcard-reader once the reader has been closed. Therefore,
the SET CARDSAV ON allows the same virtaul card innut
to be read repeatedly from the beginning of the file.
If a file is not cospletelv read and the user wishes
to re-read it, "CLOSE devadd 11 must be issued, ~. .·~ere"devadd" is the address of the card-reader, to close
the file and reposition pointers to the beginnir.g of
the file. The ooeration is effective for all the user's
virtual card readers.
SET CARDSAV OFF is the normal mode of oneration forthe card-~eader. Once a virtual inout has been closed,
it is lost. To reread the file, it.must be physicaily
read into CP-67 again by the operator or via XFER.

c'

The normal oode of operation for messages and \•:arnings
typed at the terminai is HSGO~~ and 1·ll'-~GON, respectively.
Any messages directed to a user or broadcast oy theoperator will be typed at the terminal ~henever theterminal is not ready for input. A warning sent by
the CP opera tor ·wi 11 print ir:~-:;ediate ly re~ard 1 es s ofwhat is occurrir.g at the terminai. If MSGOFF is
specified, only warnings from the operator will typeat the terminal, and any messages sent by anotheruser or the operator will be lost.

Once MSGOFF or WNGOFF has been specified and the user
desires to accept messages or warnings, SET MSGON or
SET WNGON should be issued.

..

4.1.14(01/24/70
4.1.14.3
SET

SET

If WNGOFF is specified, no warnings or messages will
ever type on the terminal. If w°"NGOFF, and MSGON areboth set, only messages will type on the terminal.
SET WNGOFF.should be used with discretion.

..... - ·-.

The normal CTode of operation for running is RUNOFF.
When the ATT?l key is hit, the virtual machine stops
running and the terminal waits for a CP console_function. In a multi-access virtual machine, this isan acceptable method of operation; therefore, SET
RUNON can be issued to CP to allow the virtual machine
to continue running when the ATTN key is hit. wnen
RUNOFF is issued after RUNON had been previously set,
the virtual machine will continue to run until the· ATTN key is hit; this will cause the machine to stop
for input. Tne SET RUNOFF mode is automatically set
if the user gets an "idle" virtual machine, i.e. withthe message-

CP ENTERED, REQUEST, PLEASE.
For specific terminals (e.g., the IBM 1050), when thesystera is awaiting input from the terminal, the key-(,,board will lock if no data has been entered for any
15 second interval during the "read" request.

If

SET TIMEQUT ON has been entered, the keyboard will
unlock and allow the user to resume input.
SET TINEOUT OFF is the normal mode of operation andindicates that the timeout situation need not be
considered.
The standard teletype has an 80 character carriage;
CP, therefore, will split a long line destined for ateletype o~ teletype-like device into two shorter lines.
Ho,vever, there are certain teletype-like devices thathave full 130 characte= carriages. The user oay indicatethat he has such a teroinal by entering SET LINE LO~G,
thus requesting full 130 character output lines.

SET LINE SHORT is the normal mode of operation for
teletype users and indicates an 80 print position
carriage.

SET TABS informs CP where the user has placed physicaltab settings on his terminal..

When a line is presented

for terminal output, CP determines whether the user

has requested that tabs be inserted in his output line.
If so, any string of at least three (3) blanks extending
to the user's tab settings will be removed, and replaced
by a tab character. This reduces the number of charactersin the line to be typed, and, thus, reduces the amountof time needed to type a full line of output.

01/24/70
4.1.14-4

4.1.14 SET.(

To alter a previous setting, simply issue a new. SET TABS corr.rnand which will replace the old settings
with the new. A SET TABS comrnand with no specified
tab setting will nullify any previous SET TABS command
No tabs are assumed to be set until the first issuanceof this conu~and. A maximum of seven tab settings
may be specified, and the tab settings specified mustbe. in increasing order.
·'

Responses:'BAD:·ARGUHENT xx
An invalid argument was specified.

Examples:a.

SET CARDSAV ON.

The virtual innut file will be saved and not erased
once the reader is closedb~

SET MSGOFF.

No messages will type at the terminal, only warnings
from the operator.

c.

SET RU1~0N

The virtual oachine will immediatelv continue
execution. If the user now activat~s the ATTN key,a CP •read' will occur, but his virtual machine willcontinue to run.

d.

SET TIMEOUT ON

The user has an IB:! 1050 terminal without the timeout
suppression feature. If his keyboard locks, it willsubsequently unlock and become available again.

e.

SET LINE LONG

The user has a teletype-like terminal with a 130
character carriage. The full width of this carriage
may be used for terminal output.

f.

SET TABS

10

16

31

40

The user's terminal has tabs physically set in columns
10, 16, 31, and 40 (relative to the left margin, whichis column 1). All output to this terminal will beedited for possible insertion of tab characters.

g.

SET TABS

This nullifies the effect of any previous SET TABS command.

1/26/70
4.l.1.5-1•..

:'FE\.!.
--#•XFER . ·-··

4.1.15. Purnosc:

XFER controls the pnssing of files between users.
Form2t:1---------~--------------~------r---------r--~

:
I

XFER
.

:

J TO USERIDl'OFF

DEVADDI:
I:---------L---------------------L_________ ___:
DEVADD

Spccif ies the addr2ss of the device fromwhich _all su::ceeciing output is to be eithertransferred or norsally written out •. The
acceptable devices are the card-punch,normally OOD, or the printer, nore!allyoos.

TO USI:RID: Turns o:-i the transfer mode. "USERID" isthe cight-ch&racter user identificationof the user that is to receive the transferred
file.

OFF

Terminates the transferring of all further
output to nUSL:RID".

__.....__
Usa :zr::

XFER cont!:ols tb.2 pass1.nz of files b2t\·;cen us2rs. Whsn
,...
,
•
b
. ,. •
ii"'n Tlc-··· ..,.. .. ,,,th·1 et ran~;rer coc1e: l.S t..Urti~?Ci on y S?cciryJ_nz lu vi.Jr.;~..:-1.1 ,11
any succ2edi:1g Cllt~uL: \-;.riti.:0n to ''Di::VADD ·uill be p1.:-:.c2d
in the ct:rd-r-e:2(:2r of : Lj.~~.:;~I)j • For i 1USEEID:' to rcc9:Lvc
h ~·"' 7... ~ -1.-\ Ii" ' - S.:..
r I:!~ (~.• d ti1e:n
the tr2nsfcr~cJ files 0 rl 'l..;r... <" a• .• JL..) .u .1.'\ LJ
Lt
1..1
L.
.l.n t o i·.-.,.
1 '-'DdS
J. wL,Sli)"l1Cl1 ~c-.
lJ. s .t i ..r.. e : • J .• c • , }-U-.-.
.,"- .. 1 .. •CT:..:;:'r•··'!'l"- \..J 1 .. l-.4...L..,,
if0f1;'11~::n;:-:-.r'l~TTv·.·:.~·-;;'~·TJ::-,...
...
_..;.,r.·•=
,...
•
...
1
·~ C [!. Se of...
...,..... !v-~ .:..J ~ •• t..u_,l,. - ..,_ t .•. ...r .... J.
.0.:.. , l.Il ~ 1•11
punched f:Ll:2s, i f.l.Si~ LCl.D.
To turn the ti~O.n~;fer mode
off, the option ;!C?:.i• must be sp2cificd. i.\ny succe(~di.ng
output to the "D~V/,Dl)tr will be written onto dis-!~ as innormal spooling nnd put on the real device when that device
'i.

"

1

1

<...

.i....,

0.i_ • .) ..... ,

0

•

1

i

1

C..4. ~

.i.. .L .....

1

is free.
A second A1:'ER coln.i.T:cirHi issued tq ch:mzc "USFJ~ID" "tdll
11· 11.y turn o.i::r:£- t l1e Xli'ER to tnc'·"U~i:'n,·1·1'.
autor,w t icn.
prev J.ous.... ,...i., u1/26/70'•.1.15-2•

Responses:
BAD AP.CU:.!E~~T.

An invalid ar6i..L~cnt. was specified.
NONEXISTI.:·:T U~HT.

The specified unit docs not exist and is invalid.

Examples:A.

XFER D TO USERl
The.transfer mode is turned on. Any succeeding output
to device OOD will be placed in the card-reader of USERl.

B.

XFER

D OFF

The transfer mocle is turned off. Any succeeding output
to virtual COD Hill be written on the real device.
l

c.

•

(

XFER

E

TO

USER

The transfer ~ode is turned on. Any succeeding output
to device OOE will be placed in the card-reader of USERl.

..

(.

•

c

4.1.16 PURGE
Purpose:PURGE allows the user to delete some or all spooled
files still in the spooling area from his virtual
printer or punch, or to delete some or all of thespooled input for his virtual card reader without~eading the data.

FORMAT:t~~-~~----~~--~-------------------------I

- •

•

.. II
t
I

I

I

•
•

READER

I
I

R

I
t
I

p

•'•
' PURGE
• p
•
•

•••
•
...

I

I

I
I

I
I

I

-:..~·

<~>

I

i

•

I

<~~

PRINTER

·.-

•t

I
t

I

PUNCH
PU

'
I

I

~---~----~-------------------------~-~-jwhere n is the number of files to be purged, expresseda~ a decinal integer.
If n is greater than or equal tothe user's total nu~ber of files for that virtual
device, all of the files for that virtual device arepurged. The number n, if specified, must be greaterthan zero. If n is omitted, all files for that device
will be purged.
Usage:
If the user deter~ines that he does not require thefirst n (possibly all) files in his virtual nrinter,punch, or card reader, the PURGE corr~and can~be issued.
Responses:

BAD ARGUMENT XX(,.

An invalid device type was specified, of the numberof files to be purged was invalid.

'

01/24/70
4.1.16-2
.
PURGE

.

i

1

4.1.16 PURGE(.
xx FILES PURGED

This is the normal response, where "xx" is the numberof files actually purged, or the word NO, if there
were none to purge.
Examnles:a.

purge pun
NO FILES PURGED·there were no punch files awaiting spooled output
for the user.

b.
•purge reader 6
04 FILES PURGED
The user wished to nurge the first 6 reader spooled
files. Only 4 such~reade~ files existed, and.these
4 were subsequent~y purged.

·:'

..

. .w .•

'"

,

-1

""'

~

..,a:·''

the~serid~·05/01/69

ij,1.15-2

is invalid.

~630

If .the user "XFERcd" tc is currently

logged on to CP-67, he will

rece!vE the following\ message:.
. . c"~IlDS XFE11 1 D EY

h~self tc allcw him to. r4rnd a card file

he creat~d \iithout rcquiri'ztq operator
considEratlE savings in card \pandling •intervention andata.fsH..fH~~:

BAC AEGUKENT xx
invalid argument was

NCN~XJSTENT UUIT
!he specified dev!c€ dcesis invalfd.

DEVIC! EUSY
5FOCled Output is in operation
tc issued tc clear the status.

A 'close• should

l13J!..E.1£.§:

xfet d to user1

1he transfer mode is turned on.
Any
OOI will te Flaccd in the card-reader cf
x~er

output to deviced cff!he transfer mode is turned
virtual pct will be written onc•

X,f E td to

U s e I A4·

USfEA4 N01 IN DIRECTORY

output\to

OSERA4 docs not exist, thei:efore cards will not be t\ansferred ·to·
Ani active transfer mode is turned cff.

hi~.

J.

Cf

<---------environment confirmation1scri~t

**

..\

\.'l

r.

dump doctiroent**.!QH§:~.

.531 17./1

begin
C!'!S
di&~

C~DS XFFR D BY USER4
off llf\e read prog.2 data in

userid ..

\".

A~

4.l.15-3

4 to user20

R;'l='()2.19•here usetid is the tr~sferrinq user.

A user may de an XFEB to

05/0l/69
1

Out~ut de~ice ~OD is transferred to USEB20. Control i's returned
to CMS by issd~ng BEGIN to CP, and the file DOCUMENT SCRIPT istEansferrod to thE card reader of OSER20 in disk du~p format.
Meanwhile, cards ~er~ XFER 1 ed to this user ty USER4 and he reads
them onto his disk.

05/01/69'4,1.17-1

S3.2_, ~1/

PURGE

11.1.1605/01/69
4.l.16-1

4. 1. 11SLEEl?

.£rt
S33

iUE.2ti~:!.YHf.§~:PURGE all~~s the uset tc delete ~ll spool€d files (not currently
frccessed for outfut) from his virtual printer or punch, or todelete a.lJ his Sfccled infut for his virtual card readers without
reading the data.

SLEEP allcks tho user to place his terminal in a dcrsaDt CP tcde
such that he 1ay receive messages without hitting carriaqe
retuxn.
1.QH.£!.!;:

lf.!.ID~.!:''
REA&ERIi

PU fl GESLEEPPR INT EB

pp

EUNCliPU.!J!!B.£ :If the user does not expeci to be usinq the terminal fer a while,
the SLEEP conscle functicn will flace the terminal in a state toreceiv~ ~essages.
The user's virtual machine is not run, but be
is ~till accounted for 11 ccnnect 11 ti~e.
~heterminal can he"a~akened" by activatinq
the ATTN key which returns the user to
CP f cr mcrE in~ut.

J!Hgg:

the usEr deterrines that heprint output, or punch
all his infut reader files. thelf~fcolednet~equirc

eithnr his
he wishes tc purqe
can be hi sued.

.E!i!HQ.D.§£.§:!!U.J!.QJJ.ta.£.§: ,tione.
BAD AFGUl1ENT xx

An invalid device tyfe was Efecified.

jzj.!!£1£.2:

xx FlIES PURGED
2his is the normal response, 'where "xi\" is the num~er of files
actually fUrged er the wcrd ~o, if there\were none to purge.

a.

The terminal is placed in a dormant state to receive messages.
"Warnings" set by the operator are not affected. If the user has
done a SE7 MSGOFF he will cf ccurse net receive Qessages, only
warning~, if they are issued.

.f;1jJ!J;Jg11:
a.

sleq:

purge pun
NO FllES PURGED

There were no funch files awaiting spooled qutput for the user.

t.

pur
02

r·

nus PURGED

The ~vc Efcoled input tiles for the user have been deleted •....
~1 111111ts ::: ::11'9111

A#JU: . . llAJLJllUJtZiJJQ!ijJUU,lU:t. . &4J&IL.....aJ&JZ,,ULZCJi :~·~: .a 1211

21 ct

::

!!

:a .41. z:aaq·'9'··i'li'... ·····'""'!!Jl!r''"''""""""""''~··~,,,~~· 1 ·1 '""'''

H""''''""· .,.•,, .. ,

fl"·

!"'

~

05/0l/69
4.l.18-1"· 1. 1e

SPOOL

£-Ii
S.3:1

lY!Hi.§~:

the SPCCl console function allows the user to (1) direct his
spocled cutput tc a specif le unit recctd device at the computing
tacilit~ ald (2)to control the nature cf reading sfcoled input
files.

c:f:3::)'"

05/01/69
lJ, l. lB-2

Uhen multi1le ~hysical cara aecks ha•e been spooled onto disk hy~;:ccP. a uset must close each file before tbe next file can be read.
for coutiiucus virtual card reader input such that the card
·reader doeE not have to be closed tetvEen each file, tbe SPOOL
co1mand can te issued sfecif yinq the virtual card reade~ address
and CON'I.
The
virtual machine viU recei.vo an end-of-fileindication only after the laet card of the last spooled input
file has been Lead.
1o terminate the continuous reading of files,
specifying only the virtual card reader addcefis.

l-HJ.H:

issue

SPOOL

Jsu:
:ux

<OH yyy>

CCC<CONT>

SPCCl

xxx

is the virtual device address f rot ~hichoutrut is to le directed to tho specificreal devic~, yyy.

yyy

is the real device address cf the desired~utrut unit. It can only be a printer orpunch address.

CCC

Contin-0ous reading of infut files ebculd not be in effectwith SIT CARDS AVE ON, as an unending "wrap around" input file .
will exist.
•b.

tirectEd output is usefull and necessary if, for instance, an
installation has two printers; one with a "PN" train and anotherwith a "TN" train. If th user has "script" output to Ftoduee,
he may sFecify the desired cutfut ~tinted, perform bis printinq,
and then return his printer to normal spcoling.

.6.s!U~.D§J§:

is the virtual device address cf the card·
1cader that is to have "continuous"
spccled input.

BAD A~GUMENT xx
1his indicates that an error in specification has been aade, suchas invalid.virtual address, invalid 'teal address, br conflictinq
device tyfe~.
111.url~s=

JJ§H.f:When printing or punching files from victual devices, tho cutfut
i~ written
to disk or "srccled" until the physical device is~vailable foruse. If there are multiple printers or punches,.
the first available device will te used for the cutput.
To
conttol the Ercoled outfut direction, SPOOL can be issued
SFecifyi~9
the virtual device addr~ss and the real device towhich t~e outrut shculd qc. The victual and teal device types
must be the same; in 'ether \lords the virtual funch can .D.Q.!: bedirected tc the real printer.
1o discontinue the directed spooling and return . tc noLmal
spcoling, issue.SPOOL srccifyinq cnly the virtual device address.
SPCCL

a.

alsc controls

the vir~ual

card readinga.

spocl e c11 30
begin
CHS

.scrip .i;:rint report (offline center)
R;T=C!;.21<----~--A7TN key hit
CP<----~·-ccnfiuaticn cf envitonment
Sf e

The SPCOl console function is issued to CP to direct the virtual
printer OtE ctitput to the real Frintet 030.
BEGIN returns
central tc CMS, where REECBT SCRIPT is fcrmatted cffline. THE
ATTN key is bit tc qc to CP and the directed output cf frinterOOE is terminat~d. Normal si;:ooling will now occur on OOE.

characteristics.

b.

SfCcl c cont

OS/01/69
4.1.1905/01/69
IJ.1.18-3

bEgin

S-3/

63t, ;if1f;!

CMS

off line read

4.1.19* *REAC A fORTRA»
CFFlltE READ E FOETBAN
OfFLl~I RIAC CALC POR1RAN.
R;'l=02.01
OIFLl~E<~-----ATTN

DISCONNECT~_!l:

DISCONN cause~ the terminal to be disconnected frdm themachine and the virtual machine continues to

key hitvl~tua1CF

queq filEs
FILES: - NO RtR, 03 PET, NO PCH
S J:.OC}

I

&fl}

run.

C

.f.Q.r.m.il:

1he SPOOL command is issued to read multifie spooled input files
ls if the) were continuous. Con~rol is transferred to CHS by
HEGJN and thE spocled infut files ate read. The ATTN key is hit
to return to CE and the spooled files are quered. Input Sfoolinq
is then returned tc normal for ncn-ccntiou~us reading.

I

OISCONN.
-------

anything

Is any non-blank character stringthat signifies the µhone I inc is
not to be hung up upon DISlONNectlng.

<any th Ing>

I
I

~:

OISCONN causes the terminal to be disconnected frorn thevirtual machine.
lhe virtual machine wl11 continue torun as though the user had Issued BEGIN. \ny ''write::."to the terminal(virtual console) are Ignored.
lhevirtual machine 1vill be automatically Jogged out if (1)11aread" Is attempted from the terminal, or (2) the
vlrtu<:l1 machine goes Into the disabled wait state. The
DISCONNected virt~al machine wl11 run ~Ith low priority
In Q2 of the dispatcher.

If the <anything> option is selected, the line will not
be disabled.
lhe tennina1 can then be used to 11 LOGIN 11
with another 11 userid 11 or to 01.\L Into a multi-access• system.
At a later time, a user can "re-connect" with his
OISCONNcctcd machine si111ply by following the normal
11 1ogln"
procedure. 'lhls "re-connection" can be madefrom any terminal. The message:
RECONNECT .\ T xx/ xx/ xx ON xx/ xx/ xx
will be printed upon re-connection and the terminal
wlfl be placed In console function mode.
To continue
running the "virtual machine a BEGIN Is required •.

"" ""' "'·"'""""'"""1 . , .,,.

-

.

•

~
;::,;;;:zea.~ '!"~,,,.,, """1!.,.,~,,, ,l""''""'!"!"l'''!!'ll!!l!l!'!!I~"·"-· 0 ·' ·'*·"""""'"·""1'""*'·1•:::w11w••
1

..••

.....

,'1"11'11

,,,..,.~~

05/01/69
4. 1. ZO-Z~

05/01/69
4. 1. Z0-1~

4, 1. 20 LINK

03tf
Purn::isr;I

LIN~ nttaches the speclfl~d ~~vice ~o th~ requester's
vlrtu~l machine, based on Information ~ontalned In the
CP-67.User Directory.

&¥$'

"~h

2:1~

&J

desired access must be provided.

In g~noral, any number of u~ers ca 'link' simultaneouslyuser can havo
to a device In read-only mode~ Only~
write access. If B
access to a device If. the first link as
read-only link exists, and a write re uest ls ·Issued,· the 1 tnk
will be made In read-only mode~
Besoonses t

Forr.ia t:-----~---·------------------------I;
I
flASS)>I LINK I userld xxx YYY <W,R>
I
.
I LI
I
I
~--------•---"•••-•a----------"-~--EMTER PASSWORD:
Type the required pass;·mrd. B·Y. conven~lon, devices specified
as "public" have the password 'ALL'. A null llne·wlll default toALL.
BAD ARGUttENT

user rd

The name of the us'er 11 01\m Ing" the dev 1ce xxx

xxx

The 11 owncr 1 s 11 vlrtual device address In
hexf declrnalyyy

The hexldecfmal. adtiress tp be assigned 'In
the requestor's virtual machine

The request has been honored· as given~w

Write access mode Is

A write request cannot be honored du~ to exlstl~g read llnk(s).

RReadrnodc only Is 1requested.
Thls Is the default value.

(NO PASS)

acc~ssr~quLsted .

1
Used only If no special Pfssword
Is required
for the desired access mo,de (I.e. a 11 publtc 11
device).

Missing or Invalid arguments.
COMMAND ACCEPTEDREAD-ONLY

tlOMEXISTENT UNIT

Device xxx not found In the·speclfle~ directory.
ALREADY~ATTACHED

Requcstor alre?dY has a device yyy.
~

LINK allows attachment of dlrcctory~deflncd vfrtualdisks to the requester's virtual machi~e. The devfcc must
be described In the CP-67 Directory under the name anddevtce address C U$Crld,xxx ) speclfie~.

reques~or,

If the userld Is that of theno password Is
and rules governing access are the same asprevall at LOGIN time, However, If wrl1te access Is normallyallowed, but 'W' Is not specified, rea~-only access w111
be set. This allows. the requastor to establish write
protection on a dcvtc~.
requited~I·

If the LINK Is to some other userfd~ a password for the

BAD PASSWORD
The supplied password ts not valid,or the device ls not sharable.

i· USER LOGGING IN
I'userld' Is In proce~s of logging In. Try a~aln later.
DEVICE IN USE

A write llnk exists. LINK denied.
UNIT NOT READY
The required physical volume Is not mounted. Notify system operator.

..

·------~~ ... :...~~,.,_,,.,..;...-,,,, ....,.,. •"''"'""••·'"'"·"'''"''.05'/0l/69
U~IT

NOT DASO!

1q

I

4. 1. 20-3

I·!
I
Device xxx must be a DASOI dev t ce :for: l IN!<.

!4!!.li-4- . I • ::< ~) - ~s1o &1."J4-3-68sc/;

4. 2. 0-1

I

·I

. I

USER ~OT ON SYSTEM

4:2.0

Console Function Applications
Crnsole functions give the facilities of a computer console to each
virtual machine and they should be used accor<lingly. It is throughthese functions that a virtual machine is loaded, displayed, dumped,
alterc~d, and colltrolled by the user.

'userld 1 Is not. In the dlrectoiry.

Console fmictions have various uses. So1ne of the application areas
are described uelow, such as debugging, initializing CMS, andattaching/detaching additional I/O devices.

Console' functions arc• V<'ry USC'ful for ckhugging purposes.
Thc-·CI~-;;;vironmcnt can be cnlcrccl at any time and the contents of cor~storage, the rc{:istcrs, and the PSW rlisplayecl, dumpNI, or altered.
Execution can be sti'\rtcd tigain by issuing BJ<GJN, with or without aspecified hcxad(oc:i111al location.
Dch1q.:gini::.

If thl· CP environm<.·nl has bC'l'n entered frcnn CMS <tnd tile' llsE'r desires
to enter the Dchug environment of CMS, hL' can is!'illc EXTERNAL. The.EXTERNAL console function generates an external intc;rrupt and causes
DEBUG to be entered when BEGIN is issued or the ATTN key is hit.

Initializin~~~· If at any time the user destn>}'s his copy of CMS, a new copy
can be loaded again hy issuing' "IPL CMS" or "IPL 190". All pending i11tcrrupts
arc reset and CMS is started anew.

lf I/O e1~rors occur on the disk when logging in to CMS, the file directory fromthe pc.Tniane11t disk has probably been read into core incorrectly. DO NOT LOG·
2!:!J:~· Issue "IPL CMS" or "Il'L 190" again to initialize Cr-.1S.
:- - - ---~~-~:l_i_~g/Dctc1_c:_l2!!1~~.i.!LC1.~.0! I[_Q_g~~!_c_?~-· If an 1/0 device such as· a tapedrive, is needed tliut docs not bdong tu the virtual machine configuration, theuser must commu11icate with the C? opcrntor thnt he wants a device nttachc~lWith a specified address, such <JS 181. As soon as the device is attached by theoperator, the mcs:wgc "DEV devadd READY" is typed out .at the terminal. The.
specified device address cnn now be used.
The user can continue using the terminal whiJc he is wailing for a device to be
attached as long as he docs not address that device. Once the device is attachedand the appropriate message is typed out, the specified device is dedicated tothe one user.
·A
1mu::s1L i;

19 '11M~ ·~"·r··-fr,9,ifn¥.llF•'"Miiilii%..Mi qr;;z;:qq #UQ .,ffiJI 4#
..

ii

i

i.i

4.#M&

¢41

--

...
' "TI ~ll

1

6-15-70('

4.1.21-1

CARDS.

PURPOSE:The CARD command can be used to control the order of spooled
reader files.
FORMAT:r-------:~~:-----f----::-------r-----{-iii~;}_________ _
I

I

I

N2

L-------------------------------------~---------------

Nl

Specifies the reader file which is to be moved. It
can be any number 01 to NN depending on how many reader
files the user has spooled. But it must not exceed
the total number of files available.

FIRST

Specifies that the reader file designated by Nl is tobe moved to the beginning of the reader file chain,making it the first file in the reader .

LASTSpecifies that the reader file designated by Nl is tobe moved to the bottom of the reader file chain,making it the last file in the reader. Any new file
read in is located last.

N2

Specifies the reader file that is to be swapped with
Nl. It can be any number 01 to NN. When a swap ismade all other reader files remain in their same
relative positions.

RESPONSES:
COfv11'.1.AND ACCEPTED
The file aesignated by Nl was successfully moved.
FILE NOT FOUND
The NI or NZ file is not present in the reader.

BAD ARGU11ENTAn invalid argument was specified.

(When, there are four files in the reader, the following conunands
are given:A.

CARDS 03 FIRSTThe third file in the reader becomes the first;

6-15-70
4.1.21-2
CARDS

(

c

B.

CARDS 01 LAST
The first file in the reader becomes the last;c.

CARDS 02 04
The second file becomes the fourth and the fourth becomes
the second. The first and third remain the first and third;D.

CARDS 04 02
Sarne results as C.

4-3-68
4.2.0-2!/jJ,

5j,;_,

4-5-68S.1.0-1)
There is no tape laJ)cl checking performed by CP.
mount the correct tape.

~-

~

~

It is up· to the operator to'Ilic responsibility is left to the user to detach or remove the specified device
from his configuration. As long as the device is attached to him, it is unavailable
for use by any other user. By issuing "DETACH devadd", the device is removed
from the virtual machine configuration and the message "DEV clcvackl DETACHED"
is typed out at the terminal. A mcssag-c is automatically typed out to the operator
spccifyinr, the device that is free. If the detached device address is that of a tapedrive, the tape tvill be rewound nnd unloaded.

s. l. 0si.J

RECOVERY PROCEDURES

The recovery procedures discussed in this section deal with error
recovery as well as general. :recovery from user problems, The
recovery procedures arc as follows: errors during LOGIN, errors
specified by the E(xxxx:x:) me ssagc, recovering from the system going
down, re-initializing CMS, f:ile space full, and general recovery
procedures.
Errors During LOGIN: If 1/0 errors occur during the C1'.JS command"LOGIN UFD" or after CMS initialization and either a carriage returnor the first command has been issued, CMS has rccogni?.cd an error
condition while trying to read in the user file directory and will repeat the LOGIN °proccclure, The user will be asked to LOGIN again,
Re-issue thCl command "LOGIN UF'D". If the I/O error still occurs,
cnlcr the Control Progran-1 by hitting ATTN and issu<.• "IPL CMS" toreload the Cambridge Monitor System, Issue "LOGIN UFD" again.
If the I/ 0 error still persist!;, contact the responsible system. progran1n1cr, ·as the user file directory is unreadable or has been ·destroyed.
If 1/0 errors occur during tlic CMS 11 LOGIN NO UFD" command, issue"FORMAT P" to re-initialize t:hc permanent diili. If errors occur
clu'rin~ "l;-ORMAT P", issue "FORMAT PALL".
Er_:_ors __~_<:;5:ificc!___!ry__~_!:y~.~J.?:~~~9ssage. Any error conditions that occur
during a CMS command arc typed out with an E(:x:xxxx:) mt,ssagc when
the con1n1anc! i1:1 tern1inatcd. The xxx:x:x is the error cod.:~ nurnb(,r anrl it iscxpfainecl in Appendix C. If :files were permanently written out or updated
before the error condition occurred, the most current files arc rcfkctl'rl
in the user file diTcctory when the time (T=xx. xx) is typed out, unless otherwise stated by that comrnand 1 s description,
B:~E.?~!:E.!1~1:(- fr?~'.~~!:cS./'.:_stcm QoinJL Down. If the system goc s down while
using CMS, the files on the temporary disk arc lost ancl the files on thepe rn1ancnt disk arc as current as they were when the last Ready n1c ssagc(R:T.:.::x:x. xx) or error 1nessage (E(xxxxx); T:::xx. x:x:) was typi:cl out, with one
exception. If an EXEC command had been issued, the files used by the CMS
cornmands that had finished execution before the systc·rn .went down will bereilcctcd in the! cur rent user file directory even though no time (Tc.: xx. xx)
was specified between the commanc.ls. Except in lhe c'!se of 1::xEC, theu:;er file directory is always updated on disk whenever the: time· (T=xx. xx)
is typed at the h>rmina.l.
0

If a file is being edited or creatNI by EDIT when the system goc s down, it
may not be c01nplelcly lost:. Issue a LISTF and sec if the EDIT work fiks

. '

51 !
1

4-5-685.1.0-2

6/f''.Ii'IPUT FILE" or "INPUT I FILE" exist. If they both exist, take thelonger of the two if you are creating or adding to the file, or take theshorter file if you are deleting many lines, and then proceed as below;
if they both exist and are the same length, issue a PRINTF or OFFLINE
PHINT for both work files to sec which work file has the latest copy ofthe file being edited and then proceed as below; if only one work file exists
then proc.C(·d as below.

:)

4-5-685. 1. 0-3

st:;General Re_c:_~_c_!_Y.J:'.T.~£~dur~. II it is not clear which environment has
been cutcrcd, hit carrigc return and the response will confirm which environment has been entered,'
To kill execution of cl command or prograrn in CMS, the ATTN key should
be hit twice and "l<X" entered. To kill a type out in CMS, the ATTN key

ALTEH the filename and/or filetype of the appropriate work file. Thenissue EDIT for the ALTERecl file and begin editing, as this file contains
the latest copy of the file that was being edited when the· system went down.

should be hit twice and "KT" entered. To kill overrides in CMS, the ATTN
key should be hit twice and "KO" entered. To truncate a line to 7Z charactersthat is being typcrl out at the terminal, the ATTN key should be hit twice and"KE" entered.

If no work file exists, all input and changes made since the last FILE or
To prevent the updated or new file froin
behg lost, issue the FILE or SAVE request frequently.
SAVE request have been lost.

II all of the files on the per1nanent disk arc to be erased, the command"LOGIN NO UF'D" should be issued ini~tead of "ERASE':'':'".

_!{_~!!.~tializ_~CM~

If DEBUG is entered, CMS can be re-initialized asfollows: (1) the CMS "IPL" command can be issued from the DEBUG
environment or the CMS command environment, (2) the ATTN key can be
hit and "IPL CMS" or "IPL 190" issued to CP, or (3) "KX" issued in DEBUG
and tlll~n ''IPL CMS" issued to CP. Issuing "J<X 11 to DEBUG is the only way
anMng the previous thrt:e methods of re-initializing CMS to permanently up<h•L•! filt•s th:Jt li;,vc bet·n updatccl or created since the last T==xx. xx n1cssage.
Thr Restart request in DEBUG should not be used as an all-purpose reinitializcr, as it is primarily a speci<1l&bugging feature for checkout of
cxpcrimC'ntal systems and it is basically an in-core initializer.

H crrors persist in an executing progran1, USC' the DEBUG conunand (secSection 3. 3. 2) or, if the program is written in Fortran, use the Fortran G
Debug package (sC>e InM Systcm/360:. FORTH.AN IV Lani;.~~· Form
C28-65 l 5).

If transmiRsion l'rrors occur, issue the ECJJO con1mancl, using each of theoptions U, S, and X (sec Section 3, 5, 2) to test the transmission of data between the terrnin.al and the cpn1putcr.

If CMS docs not work as it· should, it could be that the copy of CMS in ths
virlual nrnchine has been destroyed by the user (no user can get to or
altc·r another uscrr~r.virlual machine or core storage). The user should

cit her (I) enter the Control Program by hitting the ATTN key and issue''IPL CMS" to reload CM.S, or (2) issue ''IPL" to the CMS commandenvironrnent.
The conunands 111PL", "LOGIN", and "FOHMAT" can be issued at any thne
in t'lC CMS command environment and not just at the beginning.
Fill'._§racc Full. If 9?% of the user's filcspace is full, an error message
is typed out and the user is logged out of CMS. Issue "IPL CMS" to CP
and if at all possible, erase some files, If there is still not sufficientspa·~e available on the disk, dump all or part of the files onto tape with
the CMS commands ''TAPE DUMP" or "DUMPREST" and then erase those
file:; on <lisk. Whenever the files on tape arc needed, the command<: "TAPE
LOi\D" (if ''TAPE DUMP" created the tape) or "DUMPREST" {if "DUMPREST"
created the tapd could read them back onto disk, If the user still needs
more filcspace, he should contact the system administrator for more disk
space.

*• .:m::::::u asm::;;i ,,, .... ,,,,,
1
•

-

~.,

I

~

~

·4 4$ PUMA4U4#1UI".;,, .¢JQA.i!Q.i4JHMJINM;Wllll!lll'llllli!'llll.l!l~

1

~

"""

.~

.-'t"'

05/01/69
5,2.0-1~.fS'-'/'OFFLIN! PROCEDURES

5.2.C

7-19-68

s. 3. 0-1

cards into a user•s file, the CPFLINE READ ~ommand ls
The first card ina deck-to be read nust be the ccntrol

The read
UtiEd.
C•i td5, 3, 0,,-77

CHANGING OBJECT PROGRAMSCP67USERID uscrid\here the uset•s ID is punched teginnin9 in coluon 13
Sfaces het\een CP67USEBID and the user's I~.

(i.o.~

twocards are r~ad by the OFFLINE REAC com~and in CMS and a file istotro£d whichis referred tc by its filename and filt?type. The
ccntiol card
CFFLINE BEA[ name type modesFecifying thti filenam~ arid filetypo, shculd bo placed before
each set cf cards which is to form a file where «na~c" is tho
fi 1 c n a 1t c , 1' t. yr e" is t he f i l e t y p'.! , a nd " mode " i s the f i 1 em o d e • I f
the 11 1Lcde 11 is not specified, each file w~ll be entered into theuser's file directcry with mcde P1.
~hen a user
wishes to have a deck cf cards read in offline, heshculd gi\E the deck t6 the CP operator and request that his dockte read into CP. If the user was logged in before th6 deck wasread ty CF, the follcwing ~essage will be tyred at the console.

Files which contain rC:locatablc object code and have a filetype of
TEXT can be read into• core storage and have their lin}.;agc's resolvedby the LOAD, USE, and REUSE commands. Three types of cards
can be added to a TEXT file. These arc the Set Location Counter(SLC). the Include Control Section (ICS), and the Replace (REP) cards,
which arc used to set the core location where LOAD will begin placing
the file in core and to rnake corrections and additions to the relocatableobject code in core once the file is loaded, The sc cards can be added
to the: TEXT filc(s) which have been OFF'LINE PUNClkcl ancl then theyca.n be read back in, or they can be added using the SPLIT a11d COMBINE
con1mancl i.)r the EDIT command.
Set Location Counter Card. The Set Location counl""r c.ird setsthe ~>caU·~-;:;--~~~ntcr used with the loader. The file ·1oaded in after the
SLC card wiH Le plac<>d in core beginning at the adrlrc·ss set by thisSLC carcl. Tlw SLC card has the format shown in FIGUH.E 5. 3, 0-A.
It acts the location counter in one of three ways:l.

With the absolute address specified as a hexadecirnal
number in columns 7-12,

2.

With the symbolic .address already defined as a p1·ogram
name or entry point. This is specified by a symbolic namepunched in columns 17-22.

3,

If both a hexadecinrnl address and a ·syrnbolic name arc
specified, the absolute address is convcrh!d to binary andaddc•d to the address as signed to the symbolic name; the resulting sum is the address to which the loader's location
counter is set. For example, if OOOOF8 was specified incolumns 7-lZ of the SLC i::ard image and GAMMA was
specified in columns 17-21, wlwre GAMMA has an assigned
address of 006100 (hexadecimal), I.he ab1rnlutc address incolu1nns 7-1:?. is acldcd to lite µcJdrcss as1~igncd to GAMMA
giving a tola] of OO(ilF8. Thus, the location counkr will be
set to 006 l F'B.

•+CARDS HAVE DEEU EEAD•*

the deck was
fcllcwing nessage
Jfr,aa by

CP bcfcre the user logged in, thewill be typed at t~e console as soon as theuser legs en: ·FILES: - xx HOU, xx PilT, xx PCH~hen

the dEck has

be~nread byCP, the~secshould issue the CMS

command
CFFLINE BEAi:

to cause CMS • tc read the ca:rdE*

and form the desired

files.

If

the deck is read by CP but the CMS command OFPIINE BEAD is not
isEued, the files will not be entered into the user's directory.

H there arc blanks in both columns 7-12 and 17-2Z or lhc symbolic namehas not yet been defined, the response "INVALID CARD xxx ... xxx" 1 is
typed out or, depending on whethet· the LOAD option SINV or PINY \•.:asspecified, is written in the file LOAD MAP. If only the symbol'ic address
is to he used,. columns 7-12 mt1st be left blank or all ~eros, If only theabsolute: address is to be used, colurnns 17-22 n1ust be left blank.

.l

5'/S'
7-19-68

s. 3. 0-2

5yJ

Set Location Counter Card,-----------.~------------------,--------------------------------------.

: Column

Contents.::~---------~~---------~-----------------------------------------------~

I

I

I

I

I

:
:

1

I
I

:
:

I

Loacl card identification (12-2-9).
card acceptable to the loader.

Identifies this as a

:
:

I
I

~-4

:

:

I

t

I

I

: 5-6

:

SLC.

Identifies the type of load card.

Blank.

I

I

7-12

I
I
I

'
I
I
I
I
I

13-16

Address in hexadecimal (to be added to the value of thes.ymbol, if any, in columns 17-22), The address mustbe right-justified in these columns, ancl unused leadingcolumns filled in with zeros.
Blank.

17-Zl
I

I
I
I
I
I

SyrnLolic nan1e, whose asuigncd location will be u nccl by
the loader. The symbol must be lcCt-justifit~d in thcflc
columns. If left blank, the address in the absolute field
is used.

I

23

.
I

I
I
I
I

:74-72

:

,.
I

I
I

.

1 "/3-80:1

Blank.

'

May be used for comments or left blank,':I

Not used by the loader. The user may leave them blankor insert program identification for his own convenience.

·I---~-------L---------------------------·------------------------·----~FIGURE 5. 3. 0-A.

-

Format of an SLC card.

•

I

_._

~

.I"

.~

·""""'
55'>
7.19.68

sSli

s-11

,

7-19-68..

5. 3. 0-4

. ..I

5.3.0-3
Include Control Section Card
Include Control Section Card.
The ICS card changes the length of a;p;-;ificcl control section or defines a new control section. It should
be used onl)f when Replace cards cause a control section to be increased in length. The format of an JCS card is shown in FIGURE
5. 3, O-n. An ICS card must be placed at the front of I.he card deck
or TEXT fil.e.

~~------------r--·--·--------------------·----------------------------1:

Column:I

Contents··

I~-~-----------r------------------------------------------------------1

lI

I
I
I

I
I

Load card identification (12-2-9).

Identifies this asa card acceptable to the loader.

I
I~~}2_l__<icc C~t!·

A Heplace card allows instructions and constants tobe changed :,ind/or additions made, The REP card n1ust be punched

2-4

in hcxadcci1pal code, The format of a REP card is shown in FIGURE
5. 3, 0-C. the data in colmnns 17-70, excluding the con1n1as, replaces
what has already bee11 lo:-idcd in lo core beginning at the address specified
in colu1on~; 7-12. REP cards arc placed in the card clr~ck either (1)immedizately preceding the last card (END c.ard) if the text deck does
not contai11 relocatable data such as address constants or (2) irnrn.ediately
preceding the first R LD (relocatable dictionary) card if there is relocatable
clata in the t.ext deck. If additions made by REP cards increase the lengthof a control section, ill1 Jnclucle Control Section c;irrl, which defines thetotal length of th1.: control section, must be placed at the front of the clcc.k.

5-16

.

I
I

,

.,

ICS.

ldcntifie s the type of load card.

I

.,
I

I
I

I
I

Blank.

17-22

Name of control section, left-justified in thesec:olun1ns.

23

Blank.

24, (co111ma)

25-28

Length (in bytes) i.n hexadecimal notation of the control
section. This must not be less than the actual lengthof a previously specified control section. The number
must be right justified in these columns, and unused
leading columns filled in with zeros.

29

B~ank.

30-72

May b.c usc<l for comments or left blank.

73-80

Not usl:<l by the loader. The user inay leave themblank or insert
program identification for his
own convenience.

I

I
I
I
I

I
I
I

~----------~--~------------------------------------------------------FIGURE 5, 3, 0-B.

Format of an ICS card.

. .. \

7-19-68

4-10-68
s. 4. 0-1

SS-I

5.3.0-55, 4. 0 LIBRARY USAGE

Replace Card~-------------~------------------------------------------------------.
·~
Column:Contents:
I

I.

CMS hns two types of libraries - macro libraries and text libraries.

I~-------------~-------------~----------------------------------------,1

'

l

:

REP.

5-6

Blank.

7-12

Starting address, in hexadecin1al, of the area to be
replaced, as assigned by the assembler, It mustbe right-justified in these columns, and unused
leading columns filled in with zeros.
Blank.

15-16

F:xtc rnal Symbol Jclcntifkation (ESID), which is the
hcxadccirnal nnrnber assigned to the ContJ·ol sectionin which replacement is to be made. The LISTING
file produced by the compHer indicates this ·number.

17-70

A maximum of 11 four-digit hexadecimal fields,
separated by c;o1nn1as, each replacing one previously
loaclctl hn.H-word (two bytes). The la st field mustnot Le followed by a comma,

I
I
I
I
I

I
I
I
I

.,

71- 72

Blank.

73-80

Not usccl by the loader. The user may leave themblank or insert program identification for his own
convenience.

ment in an assembler langu:ige program. The diction:iry is gC'neratcd by the
MJ\CLID command ancl is macle up of macro clefiniti.on names, the indexes or
locations of tlie m.1 cro definitions within the Jibrvry, <:lncl the si.zc or numberof c<rcl images in eHeh macro definition.
J3oth the user and th1~ syi-::tem may !rave macro libraries. The system macro
lilm1.ry has the idc111 ificr SYSLIB Mi\CLIB SY ancl r('sidcs on the system disk.
It is composed of commonly used macro definitions. Tile user c;in gcncrntc
his own librnrics on his pcrnwncnt disk by issuing the l\1ACLI13 comm:ind (secSection 3. 1. 10).
Macro lihn1rics arc scilrchccl during thl' i\SSl·:l\TIH.E comnwml for mi:;r.ing
macro cldinitio11s. Normally the only macro Jihr.1ry searched is SYSLJB
MAC! .rn SY. Once nwcro libraries have hr~cn i:C'ncratcd hy the user, there
arc two methods hy wltich the usc·1·'s MACLli\ filcF can lie sc:1n:l1cd for missing
macro clcfinifi<im;.
The first method is l>y issuing t!tc GLOJl,\L ASSEi\lBLLR command (:.;cc St_·clion
3. 2. 2). This con1111r111cl names from one to six l\1,\CLTB files that arc to be searched
fpr missing nwcro ddinition;c;. Jf the fil<' SYSLJl3 i'v1i\CLJIJ is to be se~n-checl in
ncklit:ion to the user's MACLlll files, SYSLIB rnu:;t he specified os one c>f the six
lihrnrncs in the c;J.0131\L .ASSE!'v1llLEit comm;intl. The 1v1ACLIB files arc sc:n:chcd
in tlw order in \Vhich thl~y :ire named. The GLOBAL nncro libraries nminln in
effect until either <111otl1cr GLOBAL 1\SSI·:MHLER command is issucrl, ih(' CMS
nucleus is re-initialized, or the user logs nut of CP.

I
I

I

I
I
I
I
I

~-------------t-------------------~----------------------------------1
FIGURE 5, 3, 0-C.

/\ mncro·Jibrary is created hy the MACLJB command; it is;;·1i·1~-th;;t..l~<~~ ~1-filctypc of Mi\CLIB and th:ll cnutairw m;icro ckfi11il'ions and <1
dictionar~'· i\ macro definition is a group of assembler langnetge statements identified by a unique name ;:incl used as an expansion of a source state-ldentifie s the type of load card.

13-14

I
I

Macro Libra:::ics.

Identifies this as

2-4

I

I
I
I

Load card identification {12-2-9).
a card acceptable to the loader.

.SS2. The second method is hy gc11cr:1ting a SYSLIB l\1ACLlB file on either the permanentor temporary disk. The 1\SSEMHLE command normally scnn:hcs for the file
SYSLlB MACLm for missing macro definitions. In looking for SYSLIH MACLJB,
the ASSEMBLE command scarclh:s the pcrnwncnt disk, the temporary disk, and thenthe sy:,;tcm disk in tlwt order. J[ a user file ha:_; the identifier SYSLIB MACLm, it
will be used in place of the system macro library.

Format of a REP card.

To terminate the searching of all MACLIB files, includin;;~ SYSLIB MACLIB, the
GLOI3AL ASSEtvIDLER command can be issued with no libnnmcs specified •. lf/lltti~•a:a :: .:::z:a1gz411aw . c;sJ.

-; ::wwwu:u_a11::1.i:aJ1c14.u: t.a:a:::;::::::;:4;1::;:4::;:;s:;:;;:1.:111::uaa: . 2111111.u: .#t Ms.:;::ue:;; .a '" . aaq•f n;::s4:;;1,,1;;,J;t."',.,a;;&.A\i!Fl'%iitsa11•f'·•11s.1•z.ItQ!hHl'll;. "'~''!'

fl"'\,~

4-10-68

S5J

5. '1. 0-2~

OS/01/69..5'53

5,5,0-1

5.5.C

6\:s-/'IAPE FRCCEDUl.tES

.ifAJ

)
Text Libraries. A text library, created by the TXTLIB command, is a file thathas· a"fffctypc of TXTLIB and th:-it contains a dictionary and the relocatable object
code fr0m TEXT files. 11ic dictionary is created by the TXTLI13 command andcont:iins contr.ol secti,on names, the entry points, their location, and the size ofeach TEXT file include:d in the text lilmiry.
Both the user and tlie system m:1y have t~xt libraries. The system text libraryh[ls the identifier SYSLil3 TXTLJB SY anc.l resides on the system disk. It is composed of the.: FORTRAN lihnny st1bro11ti.ncs. 'll1c user can ge1tcrate his own text
libraries on the pcrnlancnt disk by issuing the TXTLIB command (sec Section 3. 1. 16).

Text libraries arc searched by the J ,OAD, lJSE, and REUSE commands to findmissin;; subroutines wlivn resolving external references. Normally the ouly text
libr;1ry SC'[lrchct! if; SYSLm TXTLJB SY. Once text libraries have been gcn<.:rntvcl
hy tJi:., use;r, there arc thr('c methods hy which the t1f:er'1:1 text libra:t:ic:s can bes~arcltccl during th,: LOAD, USJ.:, and REusg commands.
111c: first m('thod is J1y issuing tlw GLOBAL LOADEH. comma ml (sec Section 3. 2. 2).
111is command namc11 from one to four TXTLJB fiks that arc to be &cm.:chcd for
missing suhn1:iti11cs. If the! fik SYSLHl TXTLH3 is to be searched in ntldition to the
usC'r's TXTLit3 files, SY.'.lLIB must be~ sp,xiJicd as one of the four libnames in the
GLOD1\L LOADER co111111am1. ·1i1c TXTLD3 files nre searched in the order in which
they are nr1J1wd. If the GLO!l,\L LOADER c0n1rnnml h:is been issued aud the user
wi.shcs to tcnninotc the use of his TX'J'LJn files, the GLOBAL LOADJo:R command
c::i11 he issued with no libn::imes specified. T!iis resets SYSLIB TXTLIB as the only
te>.t lihrnry to be sqn•chcd. 'flw GLOBAL text libraries remain in effect until either
another GI ,0:3AL LO~\DFR cornmancl is issued, the LOAD command is issued withthL' J .mE up'. ion, thu ci-..ts 1111ckqu ir; rL!··i11iti:dizcd, or the w;ci: logr; uut of CP.
'flic st·cond method is l1y is}:ui11g till' LOAD co111rnrind with the LlBE option and spcciCying
the text libraries to be usvd. (Sec ~;cction 3. /.. 3). If the file SYSLlB 'l'XTLm is to be
sc;1rchc·d vlong with the user's text lihrnrics, SYSLlB must Lie spc'cificu as one of the
lihnarncs. The Lli\l~ opUon with lhc· LO,\D c11m111and ovcrrid<!S the cU..:c:t o.f the.~ GLOBAL
LOP.DE!t cornmand for that LOAD i1ncl any following USE or Rl•:USE commands.
111e: third J'l'll!tbud is by gencr:iling n SYSLTB TXTLil3 file on cithc1: the pcrnrnncnt or
tl'mporary disk. J.(JAD, USE, rind IU.:IJSE normally r:C'arch for the file SYSLmTXTLIB for missing suhroutinvs. Jn looking for SYSLI!3 TXTLl.13, these commnncls
se<irclt tlic pcrmanq1t dis!:, llw tcmpon1ry dis!:, and then t11e systern diRk, in tl1at
order. If a user file has the idc:ntificr SYSLlU TXTLlB, it will I.Jc used in plocc: ofthe system text library.

A facility is available.~ot attachi~g aagnetic tapes to a virtual
machine. The selection of a physical tape drive is made by the CP
operatcr and th~ virtual device address is chosen by the terminal
user. the CMS TAPE co~mand requires that the tape have addresH
181. The TAPEIO functicn and the TECCEY ccronand associate thedevice names TAP1 and TAP2 with the devic€ addresses ,180 and 181
respectivEly.
To have a t~pe attached tc your virtual machino, send a mcssaqe
to the Cr cperator asking him to mount a tape fer ycu as·· a ..
specified device address. When the tape is ~ounted and ready foe
use, thG systeu will autcmati~ally type the reesaage:
DEVICE xxx ATTACHED
Since

are cnly a limited number cf tares available for use
a user should not keep a tape attached tc his
machine any lonqer than he is usinq it~ Tc release a tape from avirtual machine, enter the CF environment and type the CP ~onsole
function:

by

ther~

C¥.S usEr,

When· auser legs cut
autcroatically detached.

DE'lACH

devadd

of

CP,

all

attached

dr.vices

ar.e

·5(,

s5·s
6. o. 0-1

4-12-68

5Sl
4-12-68~"'!

../

6.0.0-2

I

CP/61 Onl inc
Ei. o. O

SAMPLE TEHMINAL SESSION

XDh65 Qsyosu

l cscl -<!-·----·---·------ ·-----Specify your own uscrid upon logging in.

ENTER PASSWORD:
A sample terminal sessicu is given on the following pages. User
inpnt is in lower case; typeout frorn the systcrn appears in uppercase. The foll:iwing is a description of the terminal sesl'!ion:
After logging in.to CP and utilizing CMS, a LISTF comn1anc1 isissued to obtain a list of all files stored on user CSC l 1 s permanentdisk. The file "MAIN FORTRAN" is then created and filed on theuser's permanent disk. Compilation of the file is tcrrninatcd due
to prograrn errors (indicated by a $ symbol below the error encountered), The file is then modified and edited to correct the line inerror.
and the new source tile stored on di tik. /,gain an error
is encountered and the file re ··edited.
After a successful compilation, the $ comrnancl is called to loacl
the file into core and execute it. LOAD and STAHT perforrn the·san1e function as $, as shown. Specifying the XF:Q option withLOAD command will also cause execution to begin after the file
is loaded.
LISTF nnrl }-;HASE opcrandf! arc, usccl to selectively list ancl eraio;cfiles, and the PEINTF command is used to print clll and tli<'n partof th~ c:ontcnls of a file, I<T c;rnscs typt~ont to be discontinued H
cntcl'cd after the attention key is hit twi cc.

The OFFLINE command. punches or prints the r.pccifiecJ file on
offlinc devices. STAT types out statistics regarding the amountof d!f,k space used cmd remaining. The ALTF:E command changes
the identifier of ti file. KX, t'ntcrccl after hitting the ilttcnt:ion
key t.wicq, stops excc:ution of the current pro~~rmn and returns
control to CP.
A new coPf of CMS is obtained by issuing the IPL console function
and an EXEC file (consit=:ting of C1v1S cornmancls) is created andfiled. Tlw file is then executed by issuing the EXEC command, which
will cause each of the con1mands contained in the file to be executed
indivi~ually. Operand substitution is illustrated by modifying andre-executing the.: file using & arguments.
..Ditting the attention key once transfers control to the Control
Program where the QUEH Y console functim is issued to determine
the nun1bcr of users on th1;: systc1u, theh· na111es, and the rnessage' of the day from the operator. The DEGIN console function thenreturns control to CMS and the u:;cr logs out from both CMS anc.l CP.
Each of the commnnds illur.tratcd in this terminal ~icssion is
discussed in detail in the section dealing with that command.
Fo1· a brie·f description. of each of the CMS commands, refer
to Appendix A. Command formats and references to the sections
dealing with each command are given in Appendix B.

!
...

•

<l-

CP ~Ill qf UP UNTIL 1500 TODAY.
RFADY ~T 09,55.29 ON 04/12/68

The protected password does notprint when entered.

lpl ens
CMS ••• VERSION I ,0 - 05/01/GS

1 is t f

FILENAME FILETYPE MOOE IW.HEC.
fNOIANLISTINGPl
005
DU~PRF.ST SYSINPl
OO!lSUPERSCR SYSIN
Pl
070
MY
FORrnANPl
001
002
INOIANTEXT
Pl
001
FORTCLn EXEC
Pl
003
LOAO
MAP
PS
Dll1·lP1ffST SYSUTI l
Pl
01'l
Flt!
SCf(IPTPl
001
TUES
SCl(IPT
Pl
001
FHST
SCl11PT
Pl
001
001
DUIWHEST l. I ST I Nr1
Pl002
AGENDASCRIPTPl
001
I rm I ANFORTHMJPl
R; T=O,Ofi
etlit ri1nin fortriln
F I l f D0 ES IJO T F. XI Sf; WI Ll HF. CRF. AT EO •llH'UT:c •11c.ir11 pror.r<Jm April 12, 19G8
write (6,10)
10 Ii f o rrno t ( ' a "' 1 )lrr!c.icl(5,20)Cl

2 Oc f o rr1w t ( 8 • 3 )lwritc (G,25) a,xlend·< J - - - - - - - - - - · - - - - - - - - · - N u l l line typed to transfer to Edit
ED IT:
environment.
file

R; T::0,11
fortran main

0004

20

FORMAT (8,3)$01)
ERR 13 SYNTAXCOMPILATION CANCELLED nuF. TO SOURCE PROGRAM FRROR(S).
F.(000}2); T•0.32

~

i

.'

--

~

~

-~

""

'"'
4-12-68
6.0.0-3

4-12-68
6.0.0-4t)§r/ .

~s7

edit m~I~ fortrane d i t ·111a i n fort ran
I)

20

WHITE (6,25) A,X
I 25dformat ( 1 a • 1 f8.3, 1 x • 20.3)(.; i·iAlf.i PIWGi;Ai·i
APRIL 12, 1968
H 1, I. TE ( G, 1 0 )•iuFul.;i·i"T c • A = • >p

25.FORMAT ( 1 A• 'F8.3,' X • 20.3)
c /20/ 1 f20/

Rt1\U ( 5, 2 U) A
FOl{;.j,, T ( 8, 3}20

25
f 11 eIm I.TE CG, 2 5) ;,, X£Or Rf;i\Cl~ED 13Y:

ma¢
fortran main$p 20
1 I fon1a t/
1 iJ
F(J l\1 ltl T ( I ,\ = I )l I for111i.l t/:rn
Fu 1<:; ;,1 T Cd • 3 }~lU

i: u hi 1A T

c I I I ·~'I
FOR,.. j/1T
10
f 20
2fJ
i IX

.,

ti. 250load main
H; T=0,25

FUl,l·iAT (Fl:;.3)
i.J**2stan

EXECUTIO;J BEGINS, ••

=?
A=

A

3.1

p

3.100
H; T::0,05

X "' A1:* 2

X=

9.610

load 11ialn (xeq)p 20

EH CUT I Oli BEG I NS ....

C 111\l:J Pl\vGl(.-\1-1\II" Tl
20

ma! n

A =
2. 500 l\ =H; T::u,33

u,1r:

l(J

The ~ deletes the line·.

A ., ?

= ? I)

I\-

2.5

c ' ,, = I )(I<I

LXECUT I 0;~ BEG I NS .. ·•Fu H,ii;d ( F 8 • 3 )u 2

x • I F2 0 • 3)

' F 8 • 3' I

.H; T=O. •16/'t;/f~/L0

F 0 IU·iA T ( I A •R; T=O,lti

l:.iJIJ

c

')

EDIT:
l /25/Eu IT:

S-5%/\PHIL l:l,

(Li, 1 0 )A "' ?

l!:J683.2" =3. 200
H; T=0,28= ? I)

FOl<1·;1\T (I ,,Hl.1\IJ (5,20) ;\F vi\l·lt\ "!" (I-" S • 3 )X .,. 11** :l11idll (ll,25)um

l i !; t f

IHJ Inx ..

*FILL1V\r-IL: FILLTYl't:
1·11-1 I IJ ·LI ST I iJG
l·iA IN
FUl:THAll

11,).

ECJF P.b\CJi[.U £lY:

TEXT

nA IN

p 20
f i 1el0 •. 2tiO

MOOE. NO.REC,
Pl
00~
Pl
001
Pl

002

H; T=0.03

h; T=u.51

1 i st f* 1 i st I nr;

FI LEN/\ME FI LETYPEIJWIArl

fortran ,,ii.Jin

ERi< 22

U1~DEF I iJELi

25
i.:0i-if' I LAT I (i,J C1\iJCE LLED UUi.: TO ~uURCE PillJGRAi·1 Ef<HiJR( 3).
EC0003:t); T=-0.tiO

LABEL

LISTINGLISTIMGl·IAl!JDUIWHEST LISTllW

MODE NO.REC.
Pl
Pl
Pl

003
003
007

H; T"0,01,,

cra5e *listing.../

R; l"'0,03

1 is t f .,,; I i st nis
1-"ll.E NOT FOU iJ
E.(UOU02); T"'

,03

.'

prlntf 1nuin fortranI.. i1,d1; Pl:uLiHI\:.,
l'.\PHIL 12,~H;l H( 0 I 1 u)·lJ
Hn.;;.ii\ T < ' I\ = ? ' )4-12-68
6.0.0-519l>8

4-12-68
b.0,0-6SS?

!X.c·alter •nain fortran

HLAlJ (5,20) A
20R;FU 1;;.j,\ T ( F 8 • 3 )>.. = i\**'l.
FUi\!·11\T ( 1i\= 'F8.3, 1

d00002);

1.,!.i;\l1J Pf::OGl\.\il* 3 25i·IY

FOltTlli\i~ilidiJul~E.

FOf..Tl<t\:,llJL.dMl

FOl~THJ\i~f1PHIL 12h;l1filTE (6,10)
F 0 i\i Ii\ T ( I A = ? I )10

T=0.03

1 islf • fortrcJn
FI LEi11\;·iE r I LETYPE f.'10iJE

T=U.01.i

printf io1ain fortran<3-----..---,----- KX for killing pxccution of $.

l~ILLl1h.1

c,;.\S EXECUTI01J .. ,P-ulSiZ:
0142 HLCOfWS II~ USE, 0258 LEFT (of 01100),
TOTAL CPU-Tli·lt (II~ S·ECOIWS) = 11.H

Ll, 19u8~p

The ATTN key was hit twicc toenter KT for killing the lypvoqt.

T=v. Oli

FILETYPE ,.;uut: rW.HEC.
f'l;)lJFLi\SGI; .:;vs111

Pl

F0i;TCL1.i

Pl
Pl

Lv1\I.,

i·l1~ I'

P!>
1-'1

U03
UOl

Pl

Ul~

Flit!Tl\A1J
ul1i.,l'f.lST SY.:>UTJ
I.) l;; it u: ;> T :i Y.:>UT 2

il•I LJ..i~hl l'T

SCi:J PT
SCl\I PT
ulii-1Pi~£S T ;:; Y.:>UT3
S<;i<lf'T
Ml•L:/HJ,\,,,,,,.

H: ,\'I

I ad)I ~;j

FUl\TH.\1i

Pl
l'l
1·1
Pl

001
001

l'1

002
001

Pl
Pl

I\;

::

::::

:::;

exec

FOl:TRA:l i·l1\ I 1H:liH:
LvAiJ
l·iA llJlJiJE ( XEQ)

cxu.:uT I Oil llCG I NS' ••

t\

r.c

?

3.~
f\ c

3 • 11 0 0
T=0.8G

025~

LEFT (of 01100),

3u~~

x ..

11. 5GO

FULL (of 010 LYL.)

l"v.Ol••11

fortcl~oT= 0. 011

I~;

Olli2 l;l:Curns l1J US!:.,

exec

exec fortclgo

T•c.l. OS

P-·vlSi~:deletes one ch::i.ractcr.

FCJRTHAJJ l\1\l;lu.Jl
LU1\U j.·,,.1:wi~[ (XEQ)

uol

stat
i~;

printfUl9

Pl

T;1~. (j!

H; T:=0.10

001

001
liOl

Oli/01/68-

EOI T:
f i Ic

009
07 u
001

FOhlh1\ll
ii.l:C(of Olu CYL.)

FIL[ OOES 1WT EX"ISl; ·~JILL uE CRCATEO.
I tJPUl:
fortrun 111ainonc$~)load 111i.l i none ( xcq)

dvooo2>; r~o.02

1\;

fortcl~u

edit

offlinc ,,rintcc Main listing
FI LE. ,JCJT FUUiW

L:Ui·1h;l:.> T SYS I 1~

f-ULL

Cl.lS

1 is t f 111a i nonn\:!c *~-r 1u::J1\i1[ FILLTYf'E t·iOLJE !JO.REC.
iii\ I IWlJE
FOl\THi\i·l
Pl001
H; T"0,03

cffline print main fortran3b:~

HEJ\UY.

Ci·\S . . . vrnslOi-J ti.O

off line 1)trnch 111ain tcxt;.!e~Jfortrani.; T=J.V7

f 1,;
I L1£S
HSTu;T[HEU,

if) l

I. t
I.; T=O. Uli

,.;y

001
001
001

kx

..; ;;,.t.1 Pi<O(d;1\il
J1Pfd l,;1:1Tt: (o,lv>
l J II<Jr------·

1 isl fPl

i.JO,l~EC.

The ATTN key was hit hvicc to t:'nter$ 1.1a inprintf 1aain fortran

FILEilhi·iE

PlPl

T=0.01

1.; T=v. 011

H;

I
/

f-1 l [ iH.1T FOUIHJ

x .. I F20.3)

£1~D

R;

* mainonc * *T:::G,02\istf ni<:iin Fortran'lil\ITE (u,25) A,X
25

5Z(.

s:s::w;s;;;;ggm,;a,.lH4¥Uii iild4JS$112142J .:•um:uzn::::u:::::ut:z: :u:::u:u:::iiiu:tu:u::: :::

lii!

·f'
:

:mm

I# zzi" .."'"*-1 ' '"""""""""'" """""'m,,,,IJ """'"'. ""' """ ,.,,.iii,.,.,,,..~.... ,

'i-it-6ts

6.0.0-7

edit fortclgo exec.."$6/

dJI T:

c /malnonc/ &l/ * g
F01nr:,\:1 ei.1

LUAU

•A = ?
l. ~x"

BEGINS •••A =1.900 X ~R; r.:o,93

26.0103.610<)----~--~~~~~~-·The AT'fN key was hit 0111cc to enter CP.

user
lv US EHSq

rnn EXIT

user na111esq.".:.tl
LlJ /Ii) ,U ( XEtl}
Eur l~L'\.ClllD i.,y:

CUIUlEilT UStltS MlE ••p 9
f i 1e
H; T=u.11

edit rnainonc fortranili IT:p 4

i 1 i/llJi~ I CK
l·iAl1K
hEYEf\OPE HA TOH

ON
Oil
u;J
UIJ

l3/1YLESCJONES

Oi·i 0119
o;J 020

?I )

;\

009

0i~

Oil 0211
Oi'J 0115
ON 028027

q10[;1115(;(.;I'

I/ILL l3E UP UIHIL

begin

ws

f I 1e badu11e
TciJ,f!i

!\i

04C
047

l~llS/\TU

S lYf·WUH

FU 1:1 ,;\ T ( I

02 9

l/Jij

r:r' 1

C i·iidi'I PHUliHi\1l
APHIL 12, 1%8
HtU TE (y, 10)10
FOl<l·iAT ( 1 ; \ " ' ? 1 )1500 CONTllJUOUSLY ..

-<!------·-·--------·- BEGil'~ returns control to CMS.

lo~our.

1 istf * fortr<ln
FI Lt.1t1t-ii:: FI LETYPE

INV/1LID Cl·lS. COMl·iA!~Df.,uu.: 1W.1{[C,
Pl
Pl

uul

FORT H1\il

Pl

001

[;,\iJU;'lL
FOi{ rn,xl~
i:; T=U. 03

Pl

001

i1Y

FUf~Thllil,.1.1 I ;;u,JE

FOHT!<f\l.l

I 1JlJ I 1\;~louout

CMS LOGGING OUT •••TOTAL CPU-TIME (IN SECONDS) • 2.99
er ENTERED, READY.

001l
LOGOFF AT 12.06.0G ON 04/12/68

CXcC fortc\&O uadonc
FUl\Tl"<Aii 1~1\00iJE

0002'

#

CP/Ci7 Online

FOHr·lfi.T (I ;\ "' ? I)$01)

EHR 02LAUEL

cG:iPIL;\TIOil t.:1\i~CELLEIJ DUE. TO SGUfH.:E PnOGl{A:-.\ EIUWRb).
!!!

T=U.12EXECUTIO~

FOfffl\1\IJ

L{()OU)2)

f1; T= U. 411~&2 &3 &4 &S (XEQ)

FORTl<AiJ 1\ii\ llJUIJE
LOAD:.1A I f'ILliJE CXEQ)eJit furtclco exect.lJI T:I E1 s c t c r r e x i t

b ~aul &2 l:c:S &4 &5

exec 111\:ifortclgo rnalnone

EXECUTION BEGINS •••

9

~l

56.L

* g

f 11 eR;exec fort~\g') ma 1 none
FOf..Tlt/\;J MAlt~U1JI:·:
LOAl.JW\l 1W1JE ( X£Q)pc /&l/&l &2 &3 &4 &5/
EUF RE1'.\CHEiJ BY:

T= U. 11,\ =$. 10 L)
H; T=C•.8:1

6.0.0-8

C /&1/&l &2 &3 &4 &5/ * G

file

A = '?
5.1

4-12-68

edit fortclgo exec
E:O IT:

LOAO* G

C fi.ii\11Jli;~E/ &.l/~:>ET"-JvJ._,

FOIHHANLil ( XEl.l)

EUF REi\CHEO BY:

t{;

!~·

~

"'4

!!I

. '

XDh65

~syosu;",.,...
11/01/68:1.0 .. 0-I

7. O. 0.~~

7.0,0-2

r..'>63

A deck to be submitted for CMS Batch must have an OS/360 standard
job card wit:h a progl'ammer 1 s name specified at the beginning of tho
deck, The control cards for CMS Batch specify a proccch1re nametogether whh optional pa1·a1nctcrs, Cont~·ol cards mnst have / / incolumns 1 and 2 ancl column 3 f!!Ust be blank. P1·oce<lurc names andparametci-s arc each separated by one Ol' more spaces. The CMS
Batch control cards a1·c listed in Ficm·e 7. 2. 0-.A and arc clcscrihedin auhscqncnl~ sections. To Ein1plHy the transition fro1n an OS/ 360
job to a CMS Batch job, selected OS/360 co1itrol cards arc translated
into CMS Batch control cards to pcrforn1 the corrccponding functions.
Th<~ OS/360 proccc:.lnrcs names which a1:c rccor;nizNl and the CMS
Batch control cards they arc cqt..ivalent to arc specified L<.:low:

A CMS l3af:ch Job
Sou1·cc, object, 01· data cards included in the job ntrcarr.1 a1·e stored as
scparc1te CMf; fil• s, Each file is idcntific:cl by a filename nncl a filetypc,
FORT.RAN, ASSEMJJLE, and TEXT control cards indicate that the filcf:ypc
tihould qc FOHTHAN, f:iYSIN, <ind TEXT rer:pcctivcly. Unluss spc.cifiecl,
the filename will Le chosen hy the 1;yslen1.

o~_~C:SJ proc~~~~·~-!~~~~FORTRANLARGi"ORTJJNKJo:Dl'f
LIN!\ OlJJ
LINKSH.C
EXECUTE
DJSl\.EXF:CASSEMBLEASEMJ,INK
PUNCH

When a FOHTHAN file i.r. cornpiJcd or .a SYSJN file if; as GC'.mblcd, a11object module is gcnci-aterl ;is a file with a filetypc of TEXT ancl a!ilenan10 the sanw as the filuna1nc of the source fi.le, Data filcf; to beread a[: ci. FOH.TRl\N lc>t;ical unit., rnur:t. be identified as FILE FTOnFOOl
where n is 1, 2, 3, -1, 7, or 8.
Files created by ,>vriting on 01~c ofthe above FDHTHAN logicill ~mil.:; will be identified in the S<1mc: way.
These fil~"c may be PIZINTcd or PUNCHed ui:>ini:: the appropriate control
card alld specifying tlic filenam!=! ancl filetype,"TPPCIJOBJ'··-~~-r~_..

..,_ ..

__::-. . :_ .:'.'!::.._--- •.• -_."'."'""--::=-~.... _. __ .,.

__

,

·~·.

_,.,..,. .. .,_,,. __ . _,..,.,..

//FORTRAN

II FOH'fHAN
11 TEXTII 'fEX'f
II 'fEX'J'
II GO
II GO.
// ASSEMBLl~~

II ASSEMBLE
11 PUNCII
11 PUNCH

The only 0~>/360 //EXEC cards th;it arc rccognhccl by CMS B<t1ch arcthc ones spccific:d above; all othe1· OS/360 control c:ar<b an.: ig11t•rt·cl.
A1Bo, only one job st1cip per proccdni•c: call iv .:dlowc:cl.

''

CMS ~~~~~..!:~5:.9~.rol canl_s··

No~:

Execution of obj1:d 1noclulc:s (TFX'f fih:s) ih iiiitiafcd hy tlw GO control
card, T}li1; conl.i uJ card caw:cf; <tll 'fEXT files lo be loaded into core.
Exccntiop is bef'.\111 at the c1.try point· spccifir:d in tl1c GO contruJ card or,if ckfauHcJ, al llw fi1·!;t progra1n c·.nccnmf"i·cd in the job strcmn. If
clurini.: the cxecu!i .. 11 of a pr(lgra1ii ii progra111 inl•:rruption occurs, theproi::ramp1c:r will i~ct a cotnplctc cor.c cl11n1p ancl the· job will be knniuatcd,
Data c;1rdi: follo\\'i11[: 1l1<' GO c·ont1·ol C<1rc1 c;1ll be read as FOHTH/\N logic.:11
unit ~ (r;ysiu). Any data cardi; following the GO control card which arc notread will be ignor<·d, An c>:awplt: of a CMS Hatch joh deck is shown in
Figure 7, 1.0-A.

..- .

66/

. 7. 2, 0 CMS Batch Control Cards

CMS Bo.tch Monitor
A Batel~ Monitor for running Express type jobn has been implemented
and c~m be run from a tctr minal along with othnr convc1· sational CMS
users, The Batch'11onitor pcrn1its a \lSer to con1pilc routines using
the FOilTRAN-G compiler and/or translate Assembly language in·ograms
using tl~e ASSEMDLEH-F translator, Programs can be selectively
assc1nbled or co111pilecl and then executed, Tcn1porary work files
referred to afi FUllTHAN logical files arc r.torcd on disk and f;!JouJd
be of lin1itctl si:-.e, ':rlw Batch Monitor's pcrrnanent dish is erased
and CMS is i·c-ipkcl whenever a JOB card is processed,

7. I. 04;.:~J

11/01/682/t)0·-- , ......

----·<> ___ ,....\

11/01/68

Stt

7.0.0-3I I

At;';:J..

Stanclard Job Card
Standard Name Card
FOHTRAN

S6S-

1.

2.

Fortran P1·ogram l Source Code

.

.

)~

.

Fortran Program 2 Source CodeEND
ASSEMBLE ABLE:-1

BCD_J:'.:~CD~--LIST~J <2.~:.'l~..:!~.

I I AE;SEMBI.J•;I

3.

I I TEXT

4.

11 DATASET

filcnainc

5.

I I GO

entry point
dcfciult CJltJ'y_ puin
[ -·----·~·---··~-··----~ .. -·6.

I I PUNCII

filename. 7.

I I PHINT

filcnan1c

Figure 7. 2. 0-A.

CMS Batch Contr.

Asscm~>ly I~rogram-~ x1n:vJ I11
1-~Q~\_~l~~J.

[filcnam\-

HENT -

L0)(1U:~l

END

I/

I / FORTHAN

ll /Ol/(187.0.0-1

l Source Code..

[fikt\P;.I
n:!\T

J<-:ND.

Assembly Program 2 Source Code

I /

I I

END
PUNCH ABLE

TEXT

.

. Object M?dule

11

Gb

.

Data Cards

/ /

/1

PHINT FJLF. FTOlFOOl
ASSEMBLE ABLE NOLIST
Secon<l Version o! Assembly Program ADLE

END
/ /

DATASET FILF. FT02F001.

Data Cards

I I

GO Al~LE..

Figur~ 7. 1. O·A,

I~""'"'',JI'....,,.., ·............,,... .,,. _ _ ,.,_,......,'1!1!1'1111'

Sample CMS Batch Stream,

-

~

I

~·

·"" .,..,,,..
......

·-·-··· - ·..""""·

"''""

'""

,.,.,.,,, ..

,.~~·

"",

-

.

·"

.. ~"'"~

l Wf4iiM44¥.J#OM~ ,.
' .:;a;::::.;,;;. ,.,;;: . ;:.

M ' ¥4#.' , '\I . '.

;•,.r~'rf~"'"""l""· '""···· ·''···"'"'••J •• , ••,)7.0.0-4

I.
~LIST
fil~n~el [('""
CLISTjl ~~;I~

..

}

1.

r

11 FORTRAN?.:J......'D~... •P....

!

~

f

r
II

(,
2.

I

11 ASSEhBLE

filename*
3.

II TEXT4 •.

II DATASETs.
6.

[LIST]
tmLISJ-~]
filename

II GO~

entry point. default entrv

II PUNCH

oint

filename.

6(

II PRINT

filename8.

11 LINK

user id9.

. 11 RETURN

Figure 7.2.0-A.

l(,f ilenarne" ....

.

I

letyp:J

TEXT
.

-

7.

NOXDt;""~,_'-.

f iletype..

f iletype·devadd

password

f iletype

CMS Batch Control Cards

Jjxm ~R:~~~co[:.-~.-"T'• ..... .;_.,L"CJ..

.~1

.~

"""
11/01/68
7.2.1-1/ /7. 2. l. / /Format:----/ / FORTRAN[
filename

MAP][ NOMAP]l[ N~!_:-1§.!_
DCD

filename[~.SZY

FORTRAN

1J

MAP] [LIST ] [ BCD
NOMA1j @WLIS~ .EBCDI<J··specifies the name of the file which will containthe cards following the //FOR TRAN control
card up to the next control card. The filctypc
will be FORTRAN.

11/01/68
7.Z.1-2

Z:.-4

I I FOH. TRAN

A compilation will result in a LISTING and a TEXT file being generated .
. The LISTING file will be automatically wdtten out on sysout. The TEXT file,i.e., object modules, can be punched using a I /PUNCH control card. The
filename of the TEXT file will be the same as the filename of the FO~ TRAN
source file.

Object modules, i.e., TEXT files, will be loaded into core and executed
when the I I GO control card is specified.
Output:I! MAP is specified, a table of addresses is generated for each of seven

'*

LIST

hP,,J

567

FORTRAN~·[ EBCDIC

If no parameters are specified, a filename will bechosen by the system and the default options willbe ·taken.

classifications of variables used in the source program. The classifications are COMMON, EQUIVALENCE, NAMELIST, FORMAT, scalarvariables, array variables,. and called subprogram names.

Includes tables of addresses of FOHTHAN variables,in the LISTING file".

If LIST is specified, .a listing of the object prog1;am is ge,nc1·ated with

Suppres&cs the tables of variables.

Diagnostic and error rnessages produced by the compiler are placed· inthe LISTING file and will be printed on sysout,

Includes a listing of object coder, in asst:mbly language
mnemonics in the· LISTING file.
Suppresses the objrict code listing.
Causes the source program to be interpreted using
the Binary Codt:d Decimal code,
Causes the soUl'l'C program to be interpreted using
the Extended Binary Codocl Decimal Interchange Code,

Uuage:All cards following the I /FOH.THAN control card and \lP to the ne:x:t control. card will be ~tssumcd to he FOHTR/\N source code. These cards will b(: readand stored as a file and will be compiled using the FOH'l'RAN-G compiler unde1·. the specified Ol' defaulted options. The source cards n1ay contain any nun1bcro{ routines each delimited by an END statement. If a filename is specified,
the source cards will be stored as a file with this filename and filctype of
FORTRAN. If filcr.arne is nc1t specified, the system will choose a unique
name. The options tpccified govern the compilation of the following source
cards. Any combination of options may be specified in any order. J{ anoption is not specified, the: underlined ddault choice is assumed.

.

relative addresses and instl·uctions translated into assembly language.

Notes:

a. Source cards can be punched in either Dinary Coded Decimal (BCD) cede·,or Extended Diirnry Coded Decimal Interchange Code (EBCDIC). If the BCD
code is used, the BCD option must be specified for the compilation.
b. The ent1·y point for the first main program will be the same as thefilename. Subsequent main prc)grams will have the: entry point MAIN.
The entry point !or subroutines, are specified in the SUBROUTINE statement.
c. Data can be read from sysin using FORTRAN logical unit 5 and written
onto sysout using FOHTHAN logical unit 6.
d. Only FORTHAN logical units 1-8 may be used.
·files a1·c defined as follows:
Logical Files

1-4
5

6
7
8

The FOHTRAN logical

Record Length
80' character records
80 character sysin records
130 charactc1· sysout records
80 character records
133 character records with carriage control

.:5bfdd11',/f1i-

ll /Ol /G8 ::J~ .l/<'.5/u11101168
7.2.1-3
11 FOHTRANI / ASSEMBLE

7. Z. Ze. An ID consisting of four characters is punched in columns 73-76· o{ object decks (TEXT files} and is followed by a sequence number incolumn 77-80. For a subroutine, the ID is formed from the first
four letters of the subroutine name. For a main program, the ID isformed from the first four letters of the filename if it is the first deckin the file, otherwise, an ID of 'MAIN' will be used.

7.2.2-1/ / ASSEMBLF:

Format:I /. ASSEMBLE

Refc1·cnccs:---··-----For information on the FORTRAN IV language, see IBM Systcm/360: .
FORTHAN IV LANGUAGE, Form CZS-6515, and FOH'fiThl'DVl:Jbrary
Subprograms, Form C2"""8-b596. For inforrnation on-colnp11er opcr<iTionand messages, sec.FORTRAN IV (G) Programmer's Guide, Form C28-6639.
Information in the Programmer 1 s Gu1cle on Opcratmg System job control
language and data management lS not applicable under CMS. The LOAD,
NAME:::, and LINECNT:::options are not supported.

.

[filename.

.*-

J~

[ LISTNOLIS1

XH!0F.:1

NOX1~LFr

H.ENT:NOHENTl}i,.:----- -_, -filename

specifics the nan1e of the file which will contain thecards !allowing the I I ASSEMBLE control card tip
to the next control card. The filctypc wil] be SYSIN.

*

If no parameters arc specified, a filename will be

LJST[ N"OLlST
XRE:F[ NOXRJ<~F

chosen by the system and the 9efault options will betaken.

JNOLIST suppresse.s creation of the LISTING file.

J

NOXREF suppresses creation of the cross-1·cfcrcncc
symbol tahlc within the LISTING file. This ciption is
ignored if NOLIST is spocificd.

RENT][ NOREN-i:.

RENT causes the assembler to generate messages inthe LISTING file if non-reentrant cocling is found in
the assembled program.

Usage:All carrls foll0wing the / /ASSEMBLE control card and up to the next control
card will be assumed to be Asscnibly Languap.e source code. These cards
will be read and stored as a file and will be translated using the F-lcvcl
Asse1nhlcr and the specified or defaulted options. The source cards n1ay
contain any nun1hcr of routines, each delimited by <in END statement. If· afilename is spedfiecl, the source cards will be stored as a file with thisfilename and filetype of SYSIN. If filename is not specified, the system
will choose a unique name. The options specifieci govern the transfation of·the following source cards. Any cor:nbination of opUons may be specified
in any orclcr. If :.rn option is not specified, the underlined default choice
i's assumed.
An assembly will result in a LISTING and a TEXT fill'.! being generated. The
l.ISTING file will be automatically writ.ten out on sysout. The TEXT file, i. c.,object module, can be punched using a I I PUNCH control card. Tho filenameof the TEXT file will be the same as the filename of the Assembly Language
source file.

- ·''M¢i

iii

-

--

JIJISICllll1 ;:;::w:1:;;::111a:w¥4z::z:as::::::1.w:;z:asu:::u:a::,,:u::ax:;uu:•a::ua,;u:1LJULMIU£)!$,,,QJIU$MUUl.JUll14U.. liUUtzi

1"$1$-llOAiiij·ifM !........

,;*' 4!44 "Mi#.l#!J,i . JIL,. ,J,.,,'"Ji..

Le; . ,,;::; . . Ail.ii.tU••ill~·"'
11/01/68 ~,7;7.2.2-2
I;~~f

11/01/68

Object modules. i.e. 1 TEXT files 1 will be loaded into coreand executed when the / /GO control card is specified,
Output:U LIST is specified, or defaulted, a listing of the assembled
machine-language code together with the source statements
and an external symbol directory is generated,

CMSTYPECMSAVECMSREGMAD CALL
MA DD PLMADTYPE
CMSYSREF
FIN JSRDBUF
GENIf XREF is specified, or defaulted, a cross-reference symbol
table will be included with the generated listing.

TYPl!-;

I! RENT is specified, messages will be included in the listi.ng

STATE.
CI<Ji:OF

if non-reentrant coding is found in the assembled program.

Diagnostic and error messages will appear at the end of tl:ie
listing.
Not~s:

a. 'fhc assembler searches the system macro library (SYSI~ID
MACLIB) for macro definitions. Names of the: macros includedin this library are shown in Figure 7. 7.. 1-A. Additional macros
may be included with. the source program.
.BE~~:For information on the Assembly Language, see IBM OS/360!_\~cmhkr Lang~1E_g~ Form C28-6514 and ~emblc~:-~-­.P-E~GE.'.~'};~?!:~~--g\.0_:1~, Form C28-6595. For information on
the l>ar.ic 3(,Q machine, Rec lnM_f?y::_tc1:_1/360 !:_'rincipl~fl of~~

7.2.2-3//ASSEMBLE 072{/ASSEMBLE

Fen
RDTYP

WHBUF
SETUP

OPEN
PUT
READ
SAVE
SPIE
TIME
WAIT
WRITE
WTO
WTOR
llIBRDWRD
HIBRDWRT.mno1

IllBINNRAllIBlmMAC

nmrmwn.K

TY PIN

mnn.nwRs
IHBOPI ..STIHBINNRBWAITR
RDJFCB

XCTL

ERASE

C,LOSEDCB
DCBD

FREE MAINNOTE
ClJJ·~GK

ABEND
FIND
POINT

GET

PUTX

FREEl:'.)OOLGETMAIN

RETURNGET POOLBSPFDIMEN

LINK

Operation, Form A2?.-682l.

Figu1·e 7. z. 1-A.

Assembler Languages Macros11/01/68
7. 2. 3-1
I I TEXT&U/
11/0l/68 6:~.~
7.2.4-1

S73
8. ?,, 3,//

DATASET07?'

I I TEXTI I

7. 2. 4

Format:DATASET

Format:I I TEXTI I DATASET

Usage:

filename filetypc

The cards following the I I TEXT control card and up to thenext control card will be read and stored as a file. A uniquefilename will be chosen by the system and the filetype will be
TEXT.

filename

filetype

specifics the identifier to re given
to the file which will contain tho
cards following the I / DATASET
control card up to the next control
card.

Usage:.:_
Example:The cards following the I /DATASF:,T control card and up to the next control
card will be read and stored as a file. If the file identifies FILE FTOnFOOl
when n is l, 2, 3, 4, 7, or 8, the file can be read as a FORTRAN logical

I I TEXT

unit.
Example:

I I

1

-

• ~11111111111 $Jiii!A lillllq ·" .

..,.......

.,•

.·

-

l>ATASET FILE F'l'OlFOOl..
"·'''!l''''~i

..

'

...

I

if ii# iiJJQl!Z##llU.ii. I. ,JllJWl.IiliJP!, Il!i , ,' • liiii!k .Ailll,lil¥fil!..4ili.#Ml•lllM!i

~

.~

"""
11/01/68 ~~y7.2.5-1

11101/68
7. Z. 5-Z
I I GO

I.I. GO7. 2. sI I

.S7..-S-

GO

&:/a

S?6

format:I I

GO

entry point
default e11~1·y point

entry point[ default entry poin~

E(00003)
REFERENCJE: TABLE OVERFLOW
There arc too many .entries for the entry points or cont,rol section
names ln the reference table that is ~milt <luring loading.

ljspecifics the name of a control scctt-0n or entry
point to which control will be passed at execution time.
the default entry point is the beginning of the firstprogram cncounte_red in the job stream.

E(00004)
THE FOLLOWING NAMES ARE UNDEFINED - xxxxxxxx
The na1ncs xxxxxxxx are referred to· in a file and have never been
defined.
E(00005)
NAME IS UNDEFINED - xxxxxxxx
The nan.1e xxxxxxxx specified as a~ 'entry point does not exist.

Usage:
This control card causes all TEXT files to be loaded into core together with therequired modules from the system library SYSLID TXTLIB .. The proper
linkages arc established between the program modules. Programs arc
loaded at X 1 12000 1 and many extend up to X 1 3DOOO'.

A load m<"Lp will be created containing the locr:1tion of control sections andentry points of the programs loaded and will be printed on sysout. Afterloading is completed, execution will be begun by transferring control toeither the entry point specified or to the default entry point.
Data cards following the I I GO control card can be read from FOR THAN
programs using logical unit 5, Data cards not read will be ignored. Output
wl"ittcn onto FOHTl~AN logical unit 6 will be written onto sysout and will be
printed.
Note:
An' "entry point~' ruust be. cithc1· a control sc'ction nmnc ox- an e'l1try point.
name. It may not be a filename if the filename is not identical to either acontrol s.ection name or an entry point na1ne.
~xamples:

a.

I I

GO

b.

/ /

GO ENTRY!

~rror ~cssa~

E(OOOOl),

DBFINEDMOHE THAN ONCE ·· xxxxxxxx

E{00002)
OVERLAY ERROR
The files being loaded have run out 'of core.

•

I

•

I

//ft/

S777 .ggJ·~

11/01/68

11/01/68

7.2.7-1

I I PH.INT

7.2.6-1/ I

7. 2. 77. Z. 6 //PUNCHForinal:----,l. ..

niename

I I

PUNCH

filename filetype

*

/

l

PRINT

t"ormat:---·--

f~netypcl J.

I I

LTEX'Jj

PHINT

filename

the identifier· of the file to be punched.

filctype

specifics P10 name of the file to be printed
on sysout.

filename filctypc

Usage:
Each line of the specified file is truncated to 130 characters and printed
on sysout. The first character of each line of LISTING file is not typed
and is used as a printer carriage control character.

indicates that all TEXT files are to be punched.

Usage:

The carriage control characters are interpreted as follows:

Files with records up to 80 characters in length will be punched into· an
80 column card.

Character

Examples:

a.

6/Y

PUNCH

I I

PUNCH
All "FEXT files will be punched.

b. / t PUNCH PROGl
The file PROGl TEXT will be punched.

EBCDIC

Action"11

40

print line and space 1

"O"

FO

space 1, print line, and space

"1"

Fl

skip to new page, print line, and spacexx

a.ny other character is used as a CCW
c01nn1and code.

c. / / PUNCH FILE FTOlFOOl
The FORTRAN logical file 1 will be punched.
Ex~me.!_r.:E

Error Message://

PRINT FILE FTOlFOOl

E(OOOOZ) • FILE NOT FOUND.
.Error Message:
E(00003}

FILE NOT FOUND.

\

•

•

I

,,,.
'i".....,,..,,__U:ZS!!Zlibil$2L.21Ji!IJ!dtULJiJL.
.. . LLX ......,.,_.
"'"'~""'""'"""., ~ · ~·. ,: '1 ~'i'l'"r.<'>"~'"'"j"'~"'f"''U:lllilG~~~""1"·""'"''''"'""~~ ~

..J.

I

~
I j

ii

"'. Jii 2111LUSL · IJJJJit.UQ.' .. ···'· ·,. ,~:,•IPl• 1• •1 •
1 ·

11·

7.2.8-1· //. "LH;K

7.2.8

II

Format:

..

' ~..

. ..

LTh1<

II LINK userid devadd password

user idis the owner of the device to be LINKed to

devadd·is the virtual device address of the disk1·.'

password· is the read-share password of the disk

Usage:

control card enables the Batch Monitor toaccess files on a disk which can be LH:Ked towith read-s ha.'re privileges. 'Ihe types of files·which can be handles in this·manner are FCRTF-~N,
SYSIN, and TEXT files, and Fortran logical files(FILE FTxxFyyy). Instead of having to sendlarge files· to the Batch nachine, the user cansend a small deck of control cards. The filewhich contains the control cards ~use havefiletype, RJE.

Notes:a.

The owner of the library disk to be·· LINKed to must not have the disk in
write status. If the Batch machine isun~bleto LH\lC. to the disk in question,
the user's job is delet~d and must be
re=submitted.

b.

If the I I Lr::;K control card l.S used'

I;

I.

i.

Thi~

I

-~ ..
(

.

Batch will atte~ot... to access all ~C~T~AK,
SYS I:{, TZXT, and Fort:.-an lcgical files f re~'

the library disk.
c.·

If the library disk has no password,
substitute the word, ALL, in pl~ce of
password.

'·

.....

·12/ 10/69

7.2.8-2. II LINK
'

(

~

.

..

Exanoies:l.

.

·- · J/ JOB

11 N.Al·lE TRYVTS99 -11 LI~~ TRYVTS99 291 ALL. . G.... '~P.1:"?
v \ t.....r.....
.......
II F ,...·RT""I"
11 TEXI' SUERTl
T

-r..~

11 TEXT SUBRT2'/I GO
. /*;
i
. l.

I

.

SUBRTl TEXT,. and

\.

'.
;

;

.

.

(_._

.

SUBRT2 TEXT.

It compiles GENREP, loads-·the three TEXT files, and executes .•

I

l.
I.

• i

Batch LI~Jes to TRYVTS.99 's ·291 with a password of "ALL",i.e., NOPASS. Batch attempts to access GElmEP FORTP.AN,

1.

2.

II JOB
11 NA}~ TRYVTS88
11 LINK TRYVIS88 191. TY8
II FCRTRA~ ILDECII DATASET FILE FT02F001
II GO

I/ PRI~"T FILE FT04F001
I*

ILDZC FCRTP.A.N and FILE FT02F001 are obtained from theP-disk (191) o£·T2YV:SS8. ILD:C is compiled and executed,
and its output file, FILE FT04F001 is printed on thehigh-speed princer.
I

Error Messeges:

~one.

..

(

12/10/69
7.2.9-1

11 RETUR::.

..

II RETURN

7.2.9· // RETCR~

Format::filena..~efilename f iletype

filetype

identifier of the file to be
returned to· the user

Usage:

Output as the result of a Batch job can be
returned to the ~ser at the termination of
his job. A// RETURN card must be includedin the job stream for each file the user
wishes to have sent to his machine. The
returned decks are in DISK DU}~p format.

Notes:a.

Exarnoles:

1.

'.·.

(
i,.

The returned files are XFERed to the
USERtD which appears on the //'NAME card.

II JOBI I NANE TRYVTS99
I I FCRTPJ:.~I GP.APH
DIME~'SION

. ;

.

•

X(lOO), Y(lOO)

•
•

•
•

•

..

•
•

END
II GO

I I RETUr:~·!

11 RETUI::\I*

G!AP:IFIL;:LISTIEG
FT03:?001

The records bet\·:ecn the FOP.TRAN and GO curds
are compiled as file, G~APH. The resulting
text is executed; G:?.APH LIS'I'IXG and FILE
FT03FC01 are DISK rn.n.·:Ped to TRYV'IS99.

_

.....

l."'-1 .. v/6~

i.2.9-2

II R t.'~IUn'·
•'-"'
:.:.·

2.

II JOB
11 N&·~E
11 LI~'K

VTSUSERVTS USE?. 191 PSHDSCRTI:-;;::// RETUR~ SCUTI~E TEA"T

11 ASSE·:ELE

I*·.

V£SUSER's ?-disk is used as a library disk.
SORTI:~E is assembled, and the text is· returned
to V'ISUSZR.

J.

·.·

.

.•

..

.

'

(

.•

l·:

•

•

II'.

~·

~

11-01-68
7.3.0-1;r4?tl..

S7'i
7. 3. 0ll-01-68
7 • 3. 0-2 S&t.>

2:IY/;

Running CMS Batch

CMS Batch accepts an input stream from either the card reader or tape.
The punched output cc:.n go to tape or directly to cards and the printer output
can go to tape or the printer. The tape assignments are as follows:
symbolic
address

X'OO'
X 1 01'X'OZ'

cancel current job without a dump (default value)
cancel current job with a dump
pause at end o! cul'rent job.

For example, to .;ct code 1 in 101cation X 14C 1 a~.d return to the Batch monito_,press the Attention key and type:----virtualad<lre.5s---·---

contents

track

TAPS

184

SYSIN

9

ST

'l'AP6185

SYSOUT

9E'l'J\P7

186

PUNCH

9

If the SYSIN tape is not attached to the DATCH machine, the system willassume that the input stream will come directly from the card reader. If
the PUNCll tape is not attached, the system will write the PUNCHed output
directly to llic onli1w punch. H the SYSOUT tape is not attached, the pri11tcr
will be uscd.
•
The tapes uged arc unlabeled ones. The SYSIN tape consists of unblockc~dcard iinages. The PUNCII t<1pc nlso consists of unblocked card hnagcs but
each job consists of a separate file, where the first record of each file contains
the job number and the progl'a1nmer' s name. The SYS6UT print tape consistsof unblocked 133 ch<tractcr records,
Each job is limited to 1 minutes of execution time and 5000 lines of printeroutput.

To run the CMS BA TCII stream,a) · LOGIN to GP as the DATCII userb)

IPL

the Batch Monitor 1 s Nucleus

and the batch stream is started automatically. To initiate anotherjob stream, IPL the Batch Monitor's nucleus each time.
Messages will be printed on the BATCH user's console indicating:
0

a)
b)
c)

the job number being run
a request to mount a new SYSOUT or PUNCH tapethe userid of the jobs which have PUNCH output

During the running of the Batch machine, the operator may cancel a job orrequest that the Bat..:.h monitor pause after the end of the cun·~nt job so that theoperator n1ay modify a syzlem p<tra1netcr. To interrupt the running of the Batch
monitor, the Attention Key should be pressed to enter GP. Storage location
X'4G' can then be modified to indicate the action desired. An external interrupt
to the Batch monito1 will then cause location X'1C' to be examined and appropdate
action taken. The byte at location X'1C' has the following meaning:

L4C 1

B
When a job is ·c<mcelled by the operator, a message is writ.ten on SYSOUT
to indicate to the prog1·ammcr what action was taken,
The following messages
may be printed on the prog1·aminer 1 s output.

TIME LIMIT EXCEEDEDThe running tirnc of the job cxcccdec1 Z40 seconds (4 minutes).
OUTPUT LIMIT EXCEEDEDThe numbe1· of lines of output is limited to 5000,

CANCEl,LED BY OPERATOR.
The operator can cancel a job either with or. without a c:ore dump.

f"'.

"""
9-4-67GLOSSARY
Page 1~·:l:)9/GLOSSARY OF TERMS
Terms with specific meanings in CP and CMS are described below
in alphabetical .order. For the definition of any term not appearing in thisGlossary, refer to the firstpage nwuber given for that term in the index.
ACTIVE FILE TABLE: a table residing in the user's copy of the CMS nucleus
which contains an entry for each of that user's currently opened files (upto a' maximum of eight).
ARGUMEI\11': any alphanunieric information, not exceeding eight bytes in length,
the address of which is to be passed to a program at the time it begins
execliting or to a Civ1S command.
ATTENTION INTrmrwvr: a sivnal to the system which will effect a transfer ofcontrol lictw.::en the Control Program and other environments. The terminal
keyboan.I will be unlocked, regardless of cu1Tent p1·ocessing, and the iPputline will be processC'd by the environment which has contJ:ol.
ATTENTION KEY: a key on the terminal keyboard which, ·when hit, causes
an attention interrupt. This key is lahl!kd ATTN on the 27,H, and RESETLINE on the 1050.
CARO IMAGE: an SO-character logical record in which eachcharacter corresprmds positionally to the columns of a punched card •.
CARRIAGE RETURN: the signal which indicates to the system the terminationof a line of input from the terminal. This signal is transmitted on the 2741
by hitting the key labeled RETURN; on the 1050, it is transmitted either
by hoklins down the ALTN CODING key while hitting the 5 key, or {ifthe 1050 is equipped with the Automatic EOB special feature) by hitting the
RETURN key.
CHARACTER-DELETE SYMBOL: a character appearing on the terminal key board which, when hit n times, will delete the preceding n charactersand itself from the input line. Currently defined as the.~ character.
CMS FUNCTION: a routine ~vailable to tha CMS command programs for thehandling of internal procc8sing, such as accessing and updating disk file
directories or handling disk and terminal I/ O.
CMS NUCLEUS: the core-residelll poJ'lion of CMS of which each user receives
a copy at the time he issues an IPL 190 comwle function.

9-4-67
5'8'cl.

GLOSSARY
Page 2"""'... .,'CONSOLE FUNCTION: a software facllit:y whereby the user, at his terminal,
can simulate a function he would normally be able to perform at a 360
console. The command facilities of the Control Program are referred to. collectively as CP cornaole fu"nctions.
CONTROL SECTION: a block of coding that can he relocated, independentof other coding, without altering or imparing the operating logic of theother coding.
CP/CMS SYSTEM: a time sharing system in which the Cambridge Monitor
System (CMS) runs as the operating system of a virtual machine createdby the Control Program (CP).

-l·CPU TIME: the period of time during which the central processing unit of thecomputer is actively engaged in the processing of instructions.
DEFAULT ENTRY POINT: the core location at which execution will begin
if no starting location is specified; either that given in the first non blank
operand of an END card image or, if all END operands arc blank, thebeginning of the first labeled control section of the loaded program(s).
ENTRY POINT: any symbol in a control section which can Le used by othercontrol sections to effect a branch operation or a data reference.
ENVIRONMENT: Lhat portion of Lhe CP/CMS system which has contJrol at thetime an input line is transmitted from the terminal, and which processes
that input line to determine its acceptability. Only a subset of all possible
input is acceptable in any given environment.
ERROR MESSAGE: the message "E(xxxxx); T= xx.xx", where xxxxx is theerror code returned in general purpose register 15 and xx. x.x is the CPU
time in seconds used since the last Ready 01· error message. Any in formation typed at the terminal which explains the meaning of the error. code may also be considered p::irt of the error message.
FILE DIRECTORY: a table for each disk file storage area which indicatesthe file identifier, file size, and location of each file stored in that area.
For example, the system file directory contains information for each filestored on the system disk,
PlLE IDENTIFIER: a three-part designation wMch uni<]ucly .identifies eachfile stored on the permanent, temporary, and system disks. This identifier con~~ists of a filename (any descriptive term), a filctypc {indicating
file contents), and a filem?'11e (indicating file location).

.

__,)

1
9-4 67

9- 4·67
GLOSSARYL<J j3

GLOSSARY

Page 4

Page 3typed by a user between the time the typing clement of his terminal comes torest following a ca.rriage return until another carriage return is issued.

PERMANENT DISK: a disk area allocated to each user (at the time he isauthorized to use the CP/CMS systNn) on which stored files will be
retained until the user requests that they be deleted.

LINE-DELETE SYMBOL: a character appearing on the terminal keyboard
which, when hit, will delete all preceding characters in the input line
and itself. Currently defined as the ¢ character.

READY MESSAGE: the message "R; T=xx.xx" which is typed as a response
indicating the successful completion of a CMS command and a return to
the CMS command environment. xx.xx in the above message is the CPU
time in seconds used since the last Ready or error message.

LINKAGE: the resolving of external references between control sections atload time.
LOAD MAP: a file containing the core locations of control sections and

REQUEST: inp~1t acceptable only to an e;ivironmcnt which is unique to a
specific Cl\.1S command.

entry points of programs loaded into core.
MACRO J.,IRRARY: a disk file (whose filetype is MACLIB) containing macrodefinitions in assembler language source code and a dictionary of thename, size, and location of each macro definition within the file.

RESPONSE: any non-i."!rror message typed out by the system at the' terminal.'
SPOOLING AREA: any disk area used by the Control Program to temporarily
hold input from thC' om inc card rc:ickr or output to the offline card punchor pri111er.
· ·NULL LINE: an input line consisting of a carriage return issued as the firstand only Information after the typing clement of the terminal has come torest following a previous carlt:iage return.

SYSTEM DJSK: a dh;k area contai11int; (1) the crv1S nucleus, of which c•1ch user
receives his own copy, and (2) the disk-resident portion of CMS, which isshared by all users.
· · ., · · ·;OFFLINE DEVICE: a device whose 1/0 is temporarily stored in a spoolingarea by the Control Program; namely, the card reader, printer, and card
punch.

SYSTEM FILE: any file residing on the system disk as opposed t~ the user's
pcnnnncnt or 1crnponiry disks.

ONLINE: auy operation performed at a terminal which is actively connected tothe computer.
OPERAND: any field •. delimited by one or more blanks, which may be spcclfied
in a command, request, or console function. The operands are distinct
from the command, request, or console function name, which is always
the firstfield specified.

·TEMPORARY DISK: a disk area allocatctl to the user at the time h~)ogs into
the Contnil Program, on which stored files will be retained only,for the;duration of the t•'rminal session.
.. ,-.

·,'TERMINAL SESSION: the period between a user's cornplcted login to CP until
he logs out froni CP. (Note th.at new copies of the CMS nucleus may beobtained.during a terminal session).
'

OUTPUT: any message or information typed by the systC'·m (as opposed to theuser) at the terminal. This term is also used to refer to information tobe punched onfo cards, printed on the printer, or written out on magnetic

TEXT LIBRARY: a user or system file, whose filctypc is TXTL113, \\'ldch iscomposed of (l) TEXT files containing relocatable object code and (2} adictionary inclic:.iting the loc:ition and size of each of these TEXT files

tape.
OVERRIDE: a flag set internally to indicate whether or not the user has requested the recording of trace information.

within the library.
TRACE INFORMAT10N: data (such as the contents of various registers andparameter lists) recorded by the system to enable the user to· tracetransfers to anti from SVC-called programs·.

PAGING AREA: a secondary storage area on disk which is assigned to aparticular virtual machine and Is used by the Control Program for ternpurary
storage of portions of core belonging to that virtual machine. in order
to allocnte main storage dynamically among the various users •i'J iilJZ ::;;:::. iiiiJJJiiiij· WWtiUl;ldilliQiiii4M'•**'•H•IMfiliii!i!iiill t 1.111111.

~
:

;.

•')

PARAMETER LIST: a string of cloulilc word~; used whenever a Ci\\S commandor function is call<~d by an SVC instn1ction. The format of the paramett~r
list varies depending on 11lc comnumd or function being called, hut will
always contain the name and operands of that command or function.
·

INPUT LINE: all information, up to a maximum of 130 characters in ]ength,

•

5-gf

;,:;;

.iii

. ')

·-... '~·
r~, . ,,3b.J•lt ",iif, . ff'"'i~!.,,AH-''•!';;1!1\t.L. .," :;:+p1!~

,,,,..,

f";'9··4-67
GLOSSARY
Page 5

6"8'5'UNIT RECORD DEVICE:• a card reader, card punch, or printer.
USER FILE: a file residing on the user's permanent or temporary disk as
opposc·d ,to the systc>rn disk.
USERID; any combination of from l to S characters which uniquely identifies
a user to the Control Program.

VIRTUAL MACtllNE: a functional simulation of a computer and its associateddevices. 111.c Control Program, by creating several virtual mach.iries andallocating the hardware facilities of a single computer among them, creates
an atmo$ph1.!rc in v:hich the useri:; of the virtual. mach!ncs may each funcllon
i1Klcpcmkntly anJ with different operating systems.

(
'·

~

·"""

~

""'
4-01-6s
APPEI\1DIX A·.f

6-Fb

587

CMS COMMANDS

4-01~68
APPENDIX A-?..
CMS C<.1MMA-;03

SR'/

,

...

·-.Y

APPENDIX ADUMPREST

dumps the contents of an entire disk area t:o magnetic
tape or restores the contents of an entire disk areafrom magnetic tape.

ECHO

tests terminal line transmission by repeating as typeout
whatever is typed in by the user.

EDIT.

allows the user to create card-image files on disk andto make changc:,s to existing files froin his txlrminal.

changes all or part of tl~e identifier (filename, filetype,and filcrnodc) of a file stored on the user's permanentor temporary disk without altering the contents of the
file.

ERASE

deletes the entry for a specified file (or files) from theappropriate directory, rendering the file inaccesi;able
to the user, and frcelng the disk area containing that lile.

converts assen'lhler languagQ source code into relocatableobjed coclc using the OS/3W F level a::;scmbler.

EXEC.

executes a file containing one or mo1·c CMS cornmands,
allowing a sequence of commands to be executed byis sning a single command.

signals the Control Program that I/Oto offline unit l·ecord
equipment h:.i f; been completed and thatthe spooling areas
for this 1/0 mc:1y be processed. CLOSIO is generally issued
auton'latically by the con'lmands which access unit record
equipment.

FINIS

closes the specified file (or files) hy writing the last record ofthat file on disk, updqting the user's file directory, andremoving the entry for that file from the user's table ofactive files.

clears overrides set by the SETERR and/or SETOVER
conin'lands and causes all recorded trace information to
be printed on the offline printer.

FORMAT

prcpan;s the user's permanent or temporary disk area for
CMS use by writing blank records over the currently storedinfo rma ti on.

.FORTRAN

converts Fortran language source code into relocatableobject code using the eS/360 Fortran G compiler.

GENMOD

creates a non·-relocatable core-image file on the user's
permanent disk which is a copy of the contents of core
between two given locations.

GLOBAL

specifies (1) macro definition libraries to be searchedduring the assembly process or ( 2) text libraries to be se:archc:dwhen loading files containing relocatable object code.

Summary of Com111ands, Requests, and Console Functions-----~----- ----·---------~ .. --·-·-~·------

Cfv15 C2_~c_I_!
1be CMS commands are briefly described in alphabetical order below.
Each of these commands constitutes the only valid input to the CMS
command environmC'nt,

ALTER

ASSEMBLE

CLOSIOCLROVERCOMBINEcopies the specified filc(s). concatenating them in theorder given, into a new file which is placed on the user's
pennancnt or temporary disk and assigned the specified• identifier.

DEBUG

allows the user to stop and restart programs at specified
poi11ts and to inspect and change the contents of registers,corl.! locations, and hardware control words online,

DEFINE

creates an entry for a specified file in the user's copy ofthe system file directory, enabling that file to be referenced
as a Cl\1S cun11nancl.

DISK

causes a CMS disk file to be punched out or read in from cards
which are in Cl\1S card format.

IPL .

performs an initial program load sequence 011 t11e versionof the CMS nucleus wllich has been saved ·by CP.

)

7-19-68
APPENDIX A-3
CMS COMMANDS

KE

SS;~

r;'b/

clears overrides previously set by the SETOVER or SETERR
commancls and causes all trace information recorded l.>y thesecommands to be printed on the offline priptt!r.

KT

·.

REUSE

reads the specified TEXT filc(s) - - containing relocatableobject c()(le - - from disk ;;nd lo;icls them into core, cs tablishinr, linkages with previously loaded files and changing
the cldault rntry point of Lhcsc fiks t.o that of thC' first filespecified in the REUSE command.

SCRIPTeither (1) allows the user to create arbitrary alphanumeric
text fiks on disk and to make changes to existing file's of
this type from the terminal or (2) types out the contents ofthe spec:ifie'-1 file, formatting it as indicated by control
words contained in the text.

SE TERR

sets error overrides which will ca11sc trace information
to be recorded for each SVC-called fll"O[~ram which returns
with an error code in general purpose rcgi0ter 15.

SETOVERsets normal and error overrides which will cause trncc
information to be rccorcled for a]] SVC-called programs • - boththose whicb arc executed normally and those which return
an error code in general purpose register 15.

SNOBOL

converts a card-image file in Snohol sonrcc lant,'11ag0 into
SPLl interpreter lang11ar;c, and executes SPLl programs.

SPLIT

copies the specified portion of a ca rd -image file and appends
it to a second specified cnrd-irnagc file.

stops typcout at the terminal for the duration of the currently
executing command or user program.

KX

SS/
)

truncates information currently being typed at the terminal to
72 characters per line. 'I11is truncation will remain in effectfor the duration of the currently executing command or user
program.

KO

4-01-68
APPENDIX A -4
CMS C OM1\1AN DS

terminates the currently executing program; updates the user's
permanent file directory; and logs out from CMS, transferring
control to the CP environment.

LISH'

eittier types out at the terminal the identifier and sizeof the specified disk file(s), or creates a file on the user's
permanent disk containing information for use by the EXEC
and/or $commands.

LOAD

reads the sp~cified TEXT file(s) - - containing relocatableobject code -- from disk. loads them into core, and establishes the proper linkages.

LOADMOD

reads a MODULE file - - which is in non -relocatable core image form - - from disk and loads it into core.

LOO INcauses the user's permanent disk files to be either saved ordeleted, as specified. If LOGIN is not issued, the files will
be saved.

START

begins execution of the loaded prngram(s) at the specified
or default 1,ntry point and passes the addrcs:-; of a stringof user arguments to the program{s).

LOO OUT

compacts the user's permanent file directory; executes any CMS
command specified as an operand; and logs out of CMS, trans~
fcrring control to the CP environment,

STAT

types statii;tics regarding the amount of permanent and/ or temporary
disk space used; lists all user-clcfincd commands; or compacts
the user's permanent file directory, as specifi.cd.

MAC LID

generates or adds to a specified macro libral'y,or types out the contents of the dictionary of that library,TAPE

MAPPRT

create.s, and optionally prints, a file containing a mapof entry points in the CMS nucleus.

writes the contents of CMS disk files of any type or'sizc onto
magnetic t!1pc, 0r r<:sL01:cs these f;Ies by writing them fromtape onto disk.

TAPRJNTOPFLINE

creates a disk file from card input, prints a disk fl.le on
the offlinc printer, or punches a disk file on cards.

prints tar>C' files created by the ASSEl'vrBLE or WRTTAP
commm1ds •>ll the offlin..:. printer.

TXTLIDeither (1) generates or adds to a specified text library,(2) types out the contents of the dictionary for that library,or (3) creates a file containing a list of entry points andcontrol section names contained in that library.

PLI

compiles program written in PL/I source language
into relocatable object code using the OS/360 PL/I (F)compiler.

PRINTF..

J

types at the terminal the content~ of alJ or part of a

specified disk file •:;UN,J.$1Mit41 li!!iii!QUl@iiliJlidiiJiilllllllJlllfai@JiiUS I ,.,jJ.l.,. .J,,k#U.. .ELiC . . JIJI. Jt .. IJJIUllJIUl;;ill!i£JJ . lllJ,.l .lilliiiii.ii'~~(I:~·:''"'~

\

11.ll

~llJ 1, ~...: $1iili IMP.,, ... ::; . ·~Q~ill . U . . . ,@J_,.llltd.lbkUl.'. 1 .J;;;;,. . 3 ... .a..,.,.Yijfl_,11iu::;;g11,,.!lf!.!..;;;,,,,,.-.~! ,,.....

~

·""'

'~

4-01-68§11
APPENDIX A-5
CMS COMMANDSUPDATEUSE

DEBUG Requests
BREAK'

specifies the core location at which a program
currently loaded into core is to be stopped during
its execution.

CAW

types out the contents of the channel address word
as it existed when DEBUG was entered.

csw

types out the contents of the channel status word
as it existed when DEBUG was entered.

updates the specified disk file with a file containing coutrol cards,
where each conl:i."ol card indicates whether the iuformation immediately
following it is to be resequenced, inserted, replaced, or deleted,

DEF

enters the specified symbol in the DEBUG syrnbol
table, allowing it to be used thereafter in other
DEBUG requests to refer to a specific core location.

reads the specified TEXT filc(s) - - containing relocatableohjcct coch.: - - from di<.k and load~: them into core, cstnblishinglinkages with previously loaded files.

DUMP

prints out the contents of the specified portion ofcore either at the terminal or on the offline printer.

GO

begins execution at either a specified location orat the point where execution was interrupted when
the Debug cnvironrnent was entered.

GPR

types out the contents of the specified general purpose
rcgistcr(s) as they existed at the time DEBUG wasentered.

IPL

performs an .initial program load sequence on the versionof the CMS nucleus which has been saved by CP

f>/u

UNDEJ?INE

5'/I

APPENDIX A-6
DEBUG REQU:C:STS

4-01-68

clears the specified entry (created by a previous DEFINE
command) from the user's copy of the system file directory.

WRTTAP

copies fixed-length files from any disk to tape.

$executes a file coutaining one or more CMS commauds, or loads
into corea file which is in either core image fonn
or 1clocatab1c object cock and begins execution of that file,KX

terminates the currc_ntly executing program; updates
the user's permanent file clirector)'; and logs out from
, CMS, transferring control to the: 'cp cnvironnwnt.

ORIGINestablishes a "base" address which will be added to all
hexadecimal focations specified in other DEBUG requests.

PSW

types out the contents of the old program status word
which was saved at the time DEBUG was entered.

RES1<ART

re-initializc:s the CMS system, leaving the user in
the CMS Co:mmand environn1ent.

RETURN

returns the user from the Debug environment to the
CMS Cornmand environment.

SETchanges the contents of the specified general purpose
register, word, channel address word, or program
status word by replacing it with specified information.

STOHEchanges the contents of the specified core location
by replacing it with specified information.

x

types at the terminal the contents of a spcciHccl 1>r

assumed numbcr of bytes of core starting at the specified
locat!o11.

-· ,/4-01-68_
APPENDIX A- 7
EDIT REQUESTS

~-f~L

57~'

4-01-68,--

EDIT 13equests

The EDIT requests arc described below in alphabetical order. 111cse
requests constitute the only valid input to the Edit environment, althoughsome of the requests affect the format of input to the Input environment.
BACKSPACE

defines a logical backspace character for use
in both the Edit and h1put environments. TI1c default
character is %.

BACKUP

repositions the pointer the specified number of lines above
the current line.

BLANK

places blanks in the indicated columns of theline at which the internal pointer is currently
positioned.
-

BOTTOM

positions the pointer after the la st line of the file.

BRIEF'

causes the brief mode of the Edit environrnent
to be entered, in which lines round or altered hy EDlT
requests are not automatically type<l out.

CHANGE

DELETE

replaces a specified string of infornwtion currently
in the file with another specified string of information,
deletes the specified number of lines from thefile, starting with the line at which the pointeris currently positioned.

APPENDIX A-8 ;5'jJ
l!~DIT REQUESTS

NEXT

moves the pointer -f6i-ward in the file for the number
of-lines specified,

OVERLAY

replaces characters _ in the line at which the pointeris currently positioned with the non-blank.characters
specified.

PRINT

types out the contents of a specified number of lines,
starliug with the line at which the pointer is currently
positioned.

QUIT

transfers from the Edit environment to the CMS
Command environment with~·nt saving the edited
file.

REPEAT

repents the following IlLANK 01· OVERLAY request the
specified number of times.

RETYPE

replaces tlie contents of the line at which the pointeris currently positioned with tlic line of sp.:?cific::dinformation.

SAVE

writes the C'dit:cd file on the' ur.('r's pC'rm.'.lnc·nt or tcmpor3ry
disk and returns to the l11put cnvironmcnt.

SERIALestablishes whether identification information is tobe placed in each line of the file and, if so, speCifies

that identification information.
FILE

writes the edited file on the user's permanent
disk and transfers from the Edit environment to
the CMS Command environment.

FIND

scans each line of the file , starting at the line im mediately following the one at which the pointeris currently positioned, for a column-dependentmatch •with the specified information.

INPUT

transfers the user from. the Edit environment to the
Input environment.

INSERT

inserts the specified line of information into the file
immediately after the line at which the pointer iscurrently positioned.

LOCATEscans the contents of the file, starting at the line
immediately following the one at which the pointeris currently positioned, for the specified string of
information.
' '

""'

·~

-

TABDEF

defines a character which is to be recognized as
the - logicai
tab character in the Edit and Input
environments. 111c default character is II •TABSETestablishes the internal or logical tab settings whicharc ·to be u<>ed in both the Edit and luput environments.

TOP

positions the: pointer to a null line which precedes the firstline of informal ion at the lx'ginni,·,g of the file.

UP

sec BACKUP.

VERIFYcauses the verify moue of the Edit environment to beentered, .in which the contents of lines fou11d or altered by
EDIT requests are automatically typed out.

~·

--\

~

~

4-01-68
APPENDIX A-9
SCRIPT EIHT REQUESTS

.~

5/t

7-19-68.5J{

APPENDIX A- l 0

SCRIP EDIT REQUESTS

:57/
SEEK

scans each line of the file, starting at the one at
which the pointer is currently positioned, fo1· acolumn-dependent match with the specified informati<:?n·

SCRIPT EDIT Requests
The SCRIPT EDIT n·qucsts a'rc described below in alphabetical order.
The request$ constitute the only valid input to the Script Edit environment~
DOTTOM

ment.

CHANGE

replaces the specified string of information in the current
Hnc with another specified string of information.

DELET!ldeletes the specified number onines from the file,starting witJ1 the line at which the pointer is currently
positioned,

FILE

writt:s lhL' cditud file on the user's permanent disk, andtransfers from the Script Edit environment to the CMS
Command environment.

INPUT

transfers the user from the Script Edit environment
to the Script Input environment.

INSERT

causes a single line of input to be added to the file withouttransferring to the Script Input enviromnent.

LOCATE

NEXT

PRINT

QUIT

creates a file on disk which consists of all material (1) fromthe lx·ginning of the current SCRIPT file or (2) from the point
at which the Inst KbEP was issued.
searches the SCRIPT file for the first occurrence of thespecified stxing.

moves the poil1lul" forward In the file for the: numberof lines specified.

SCRIPT PRINT Control Words

Page Format:.PLnspecifies the number of lines to be typed on a page (Thedefault value is 66 ),.BM n

specifics the number of lines to be allowed for the bottom
margin of each page (The default value is 3 ),.TM nspecifics the mm1ber of lines, including the header line, tobe allowed for the top margin of each page (The default valueis 5),

Spach~&.;• DS ndouble Elpaces ~he information being typed out,

.SS nsingle spaces the information being typed out.

.SP ninserts the specified nurnber of carriage returns prior
to typing the next line.

Paragraph Format:

types out the contents of a specified number of lines,
starting with the line at which the pointer is currently
positioned.

• LLn

specifics the line length in characters (The default value is 60),

,IN nallows the left side of th•3 printout to be indented.

transfers from the Script Edit environment to the
CMS Command environment without saving the edited.OF nallows printout to be offset by indentinf all but the fii:stline of a section.

file.

REPLACE

positions the pointer to a null line which precedes
the fir st line of information at the beginning of the file.

prints the last line of the fJle being edited, positions thepointer below this line, and enters the Script Input environ-

KEEP

TOP

replaces the contents of the line at which the pointeris c1trre111ly positioned with the line of specified in~fon11atiu11,')

7-19-()8
APPENDIX A- I I_SCRIPT PRINT CONTROL
WORDS

4-01-68

!;'ll

St/J

APPENDIX A-12
CP CONSOLE FUNCTIONS·---..,,S"')t)

Page Control::ontrol Progra1'.1 C~nsolc Fu::__i::_t~• PA nstarts the next 1inc on a new page •.PNcontrols both cxtcr11al and internal page numbcriug of thefile being printed •The Control P.i:ogram console f·unctions arc described below inalplwbctical order. ·n1csc cn11solc fonctio11s co11stiltlt1.: the only valid
input to the Control Protram environment• HE heading
causc~sthe next line to be used as a header line, and to betypc•d at the top of each page.
-

Fortnat Mode:• BH

causes a break, meaning th;"lt information appearing bt!fon·and aft.er the • BR request will be typc.<l on scpar;d.c lin('S,• FI''fills" the lines being typed out by (1) lengthening short linl':'by moving words from the following line (2) r:;l1ortening longlines by moving words to the follov,1ing line and (3) adjur:;ti;iglines to the right margin by inserting additional blanks between
words il1 the line.

• NF

• CE

types all lines exactly as they appear in the fili;, f runcatinglines longer than the currently-set line length (.FI is assumed
if neither • NH nor . FI is specified).

BEGIN

begins execution at the specified address or, if
no address is given, at the location at which
execution was interrupted.

CLOSE. releases the spooling arc:as containing input
froin the C'ard reader or output to the printeror card punc:h.

DETACH

ren10ves the specified device from the user's
virtual machine configuration.

DISPLAY

types af the terminal the contents of the specified
register(s), core location(s), or progra1n status
word .

DUMP

prints the contents of the specified registcr{s),core Jocation(s), or progran1 status word on the_ offline printer .

r.:XTEHNAL

simulntC'S an external intcr11.1pt tu the virtual machine.
An EXTERNAL console fonction followed by a BEGIN will
cm1sc tli..: Debug environment: tn be cnt<'rccl.

ce·nters the next line between the left and right margins.

§]~~ i al E~~l u r~:.RD nissues the specified number o! reads at the terminal to allow
user input to be inserted in the printer,

IPL

Simulates the Initial Program Load sequence on thespecified unit.

.CP ncauses a page eject to occur if less than the specified numberof lines remain on the current page.

LOGOUTreleases the user's virtual machine, including his
temporary disk area, and closes any spooling areas
which have not been released.

MSG

types out the spe,,ified mes sage at, the terminal of
the person whose uscrid is specified .

QUERYtypes ~lit eitlmr the numhor of users logged onto thesystem, the names of these users, or the maximum

Manuscript Layout:• AP nameappends the contents of the specified SCRIPT file to the filejuat prln~cd,

number of users allowed to log on, or the log message
set hy tl1c operator.

• IM nanie
inserts the contents of the specified file into the printout of
another SCRIPT file.

•~- ''~ii!i!iiii!lliiii!j!Jiji!Jiiil""M'i"l!lll!!fl,fil.!fil\!i,,""iiiffl,,. ISNl!!l!,,..,_,;£¥(_,,414Mi!Ui;tik.~J-"'iJMifl!¥1!!Mii,l,14$,J$&;aqt,,z ; II

:a.n

-~)
.....,.,.;F

;.: I

;

~
:.;::::;;.:;111"'*'11111;::

iii+•hl

""""

q

.~

""1

""

U/01/68

4-01-68
APPENDIX A-13

Appendix A- l 4,,,JX:~o/S/7

CP CONSOLE FUNCTIONSSJ~CMS Functions

READY

simulates a device encl for the specified unit.

RESET

simulates the system reset key on the 360 console
by rescttiug any pending I/O interrupts.

SET

controls the niessagcs typed at the terrninal,

STORE

replaces the contents of tli-1 ::ipecificd registcr(s),core ]ocntio11(s), or prugrc .n status word with the

CARD PH

Pl.mches a card from the specified area,

CARDRD

Reads one card into the ·specified area.

CONWAIT

Waits for console I/Oto. "finish" all stacked reads
and writes.

DESBUF

Releases buf!e1·s used by console routines,

ERASE

Performs the function similar to theERASE Command.

FINIS

Cloaca one 01· more spcci!iccl !ilea,

POINT

Sets a pointer for subsequent file i·efcl'enccs.

PRINTR

Pl'ints one line on the pdnter or issues a carriage restore.

RDBUF

Reads information from disk.

SCAN

Scans a line of inp\1t and places strings of non-planks
into a comrnancl buffer.

spc:dficd information.

TIMER

conti·ols whether real tin1c or CPU time is
kept fo1· tlw virtual inachitw,• STATE

Provides information about disk files,

STD EHR

Obtains information about the last cn·or.

TAPEIO

Reads/Writes and perfor ms various tape l/O functions.

TYPE

Types one :tine on the console with a carriage return.

TYPLIN

Types one :Line on the console and gives one carria[:creturn.·WAIT

Wait state is ente1·cd to await an intcn·uption from oneof the devices specified as arguments.

WAI'fRD

Waits until one line is read from the ccinsolc.

WHBUF

Writes info1·mat'ion onto disk. ··

0

hOO

7-19-68
APPEl\'DIX B-1

bor

4-01-68
APPENDIX B

APPENDTX B

APPENDIX B

For 11~~-o_f_S'_:Pm mancls L~C:.(l~~C:.~~~'l!1c!_9()1.! ~()I c:.l~ttr~C:.~io11~-_!.:ormat of Commands, Requests, and Consol~~~~~

Contents-------

Below is n key to the symbols used to represent command formats in thisappendix:Page

Key to Format Symbols

CMS Commands

4

DEBUG Requests·q

EDIT Rc9ucsts

10

SC Rf PT EDIT Requests

12.

SCRIPT PRINT Control Words

13

Control Program Console Functions

15

Option Meanings and Defaults

17

UPPERCASE

information given in capitals must be typed
exactly ns shown, although it may be enteredin either upper or lower caselowercaselower case iuf:irm;ition designates the contents of n field, and docs not in itsdf constitute meaningful Input. (All lowci:ca::;csymbols arc defined 011 p:1gc 3.)()

parentheses must be typed as shown ~vhen
any of the information appearing withinthem is specified
a period designates the beginning of a
Script .Print control word, and must be
typed as showna hyphen must be typed where shown, and mustnot be offset by blanksIa sla£h denotes any string delimiter, other thanblank, which docs not appear in the strh1g*

an asterisk, specified where shown, indicatesthe universality of an item or items

The following arc logical symbols only, and should not be typed:

~

~

[J

brackets indicate information which may b.eomitted[ J[ J

successive brackets enclose items which, if
specified, may appear in any order[[ J]

nested brackets indicate items which, if
specified, must appear in the order shown

..

,··.
11'''''"1'

~

"""'

·,"""',.....

7-19-68

I

7-19-68
APPENDIX B-2c,o),,&o.~{}braces enclose stacked items, only one ofwhich may be 1'>pccificd. With stacked items·not enclosed in braces, the underlined item
may not be specified.

these suffixes indicate first, !.l:cond, third,
and Nth items respectively~

this symbol indicates a continued linet63

All lowercase symbols used in this appendix are described in alphabeticalorder below:

anycomarg

an ellipsis indicated that the preceding item(s)may be repeated more than once in succession

1
2
3
N

APPENDIX D-3..

cdefentdefsetdevadcleditfn
entry
eof
first
fm
fn
ft
hexinfo
hexlocid
inlloclasts etunderlining indicates the value: whi.ch wm beassumed if none is specified. When no underlined item appears in bracketed [ 1 information,
the default value is none. Underlined items·not enclosed within hracc.s { } m~y not be
spccifil'd hy the user.

lengthlibnameline
nnolineno ." ·no:rec
newfm
newfn
newft
ncxtloc
olJfm
oldfn
oklft
optionreg

filename specified in EDIT commandan entry point or control section nameend of file
first occurrence of the specified Item foundfilemode
filename
fiJctypea full word or less of hexadecimal information
hexadecimal core locationan alphanumeric identifiercore location at which processing was interrupted
core location spccified in last DUMP request fn the
Debug environment
inherent lei1gth attributethe filename of a librarya group of position-dependent 2741 charactersa decimal number
line number not typed
no fornrntt:ing of first three clisk records
new filcmodenew filename
new filctype
nexi: available load location
old filcmodeold filename
old filetype
an option of the indicated command (see pages 14 and 15) ·the number of a register (in decimal)

sehnarstringsymbolsequential page nun~bering•
original margin or tab :.ettings
any group of 2741 charactersa name for which a DEF rcql!C'St has beensys Jib
type out
use rid

issued in the Debug environment
system text library, unless otherwise specified by an option
type out inforrnatiun at the terminalor previous command
identifier by which user logs in to CP

seq

,)

any CMS command
any user argument to be passed to a program
any text character appearing on the 27'11 keyboard
default entry point
default option settings
device address•I7-:19-68(,d

I

APPENDIX n-4

CMS COMM.ANDS. {ti,. .. \,j~-~~c;_c~1_11m~~~~~ALTER1( AL llASS~\fHLEl}CLOSIOJl" CLO~-G~!l_<:_~

oldfn oldft {olc~rm} · {ne~vrn} {ne':rt} {nC\~m}[ (oi:tion l ...

fn 1 .•• fnN[READERJ

rRif\i'TERJ

option~)J~UNCH]

l

DEBUG
{ DEB

:i EE~CJ\ FINISfni·.

[arg 1 •.• argNJ{r~}

3.1.1-1l FI .\ :3. 4.1··1{FORMAT!
FORM

3.1.Z-1:FORTRAN:

..

newfn

newft

.

\ GENMOD

newfm oldfn 1 oldft 1 oldfm 1 ~, , , oldfnN oldftN oldfmN

'

J

G

'

3. 1. 3-1
3.3.2-1: GLOBALl

GL\rDEFJNE/l DE

fn

lD~~K}{~ {ALL}~fn 1 ... fuN

3. 4. Z-1[(option 1 . . . optionN)J

3.2.1-1entry 2
ncxtloc{ ASSEM'.lLER MAC LIB}
LOADhR TXTLIB
libuamcN

3.1.4-1.LOAD

3. 5. 4-1

r J

3.5.1-1

DUMP fn ft fm}

3.1.8-1: c !
L nor~_c:_ j

)T:
. )

entry I

3.5.3-1

fo} ~t:~]rp :J

3.3.1-1CL

to:-1~1~m}Page Ref.

' xr ,.)F(CLROVtm]

7-19-68{.?t5 APPENDIX B-5

CMS COMMAl\'DS

3.2.2-1[ libname 1 ')J

f_IPL}IP .

3. 5. 14-1

KE

3.5.5-1

1

lDUM~RESTJ

3.1.5-1

KO[{HJ

3.5.2-1

ED~TJ

(rn]

3. 1. 6-1

J ERASFJfr} M. [fr}]

l
{

l

ECHO}
EC

ER

3. 5. 6-1

KT

3.5.7-1

KX

ft'. LISTF -'.
,

1 L
I.

·3.1. 7-1

..

)

[

{r~} b} [ {r:n} J] ' {(r._x.~ c) ~'P and T'-

LO

In 1... , fnN..
'''I I"",((( l!A.ibQUl!iiiiiii!iil4iiiUiil,iJSJCl22iUUSU::UilliJllllJl!JIJl!i

-,

{L)

3. 1. 9-1''

. rypcm~! ..

)LO.ADI

3.5.8-1[(option I .. , optfonN}~

3.Z.3-1llinmnmc 1 , .. tlhnnmc.:NlLsysllbJJ~~
2 i i21Jlli!Ui!i!UILJll212!1ii !. i i I ,JS:::::ss iiiiiiii!iiiiiiiiJ u:::

ii II

a ZS

@4

$S

I.

1"1'4 44. L,14ii4h # .. Q ·'"'"""moL¥' ,i.i@ .O§;t

''Tr·

!AM.

'"r· QL~,•,,, L ''·""""'

~~

t.tJ-,

{ig(,

.

')

\LOADMOD ~' LOADM \'.). LOGJN-.
' LOG! \7·19-68

7-·19-68
APPENDIX B-6
CMS COMMANDS

Page. Ref.

fn·~

3,:-2:-;r:-r-

APPENDIX B-7
CMS COMMANDS.....,/:07~ SETERRtl SETE J)

Pqge Ref.
~;-3~-,:i-~ SETOVERl

UPD}{ NO_UFD3, 5. 9-1

[anycon~

3.5.10-1

l

J

SE

[

SAME LAST ~ption 1 • • • optionN] ]~3. 3. 4-lll (option 1 • • • pption N ) )3. 4. 4-1'

\ LOGOUTt( LOG ~"I

MACLIB}\,M'( 'MAl'PRT[
\
MAP
J

{

GEN Jihnamc fn 1
ADD lihname fn 1
LIST Jilinamc

r
L

fnN}
fnN

I'

fn

{SP~~T}

3. 1. 10-1l~}f{g~F\r
f_ l ~() )Jj

SNOilOL\._
SN

{

1.

~ STAllTl

l STAR l

3.5.13-1

entry . [[~I

, OFFLINE:
~
0
:

REAi>

.

fn

ft

')

.~STATJ
' s

[rm]
first

I,,.

fnl

•••

f" f: [{'~}J}

3.1.11-1

.

R

fnN

\•TAPE y
T

.t

;

SC

Eoptionl .•• option

NU[M [M U0·:.,~JJ

fn ft

fn I • • • fnN [ (opti~n 1 ..• optionN) "\,.libnamc I . . . libnameNl]
Id~) SCRIPT

JJil

3.Z.6-1' HDJT~ FR!i'\'1'

•

fn
fn

g, .!• and.Q

J. REWIND~iirnoF ~s}j
fn ft

3. I. 15-1

Tp

3.4.3-1

{

TAPR

TAP!]
[TAP2

3. 1. 18-1

3. J. 12-1.

3. 2. 5-1

J[(option l ... option N) ~3.5.11-1·

LOAD

TAPRINT}.

.,:. REUSE

3. 1. 14-1

.,

HJ

DUMP

.; PRINTF ~·p·iargl ••• argN

cof
--.

\

PUNCH Pit INT{ PllINTCCPIUNTPI.l

{PLI}
PL

{i:a r{~:JlI

ful ftl fn2 ft2

3.l.13-1,J{ T~LJil}{ GEN~R.A TE }libnamefnl • · · fnN{ ~D}libnamc

ful . . • fnN~~NT}

libnamc{LI1~T}libname3.1:16-1

7-19-68

I,,;{'·;.(}~

APPENDIX B-9
DEBUG REQUESTS

7-19-68
APPENDIX 13-8
CMS COMMANDS

Pa~c Ref. /;.og{~1}( UNOEFINEl
\

·UN

)

\UPDATE

l

u

\

l

In

1

USE

{

m~~~JN} [{:~ ~} [{u:~~TE}JJ]. ~~W~~!!AP}symbol}{ hexloc·n

11REAK

Page Ref_:

3.3.2-4

3. 5. 12-1

fn 1 • • . fnN [(option 1 ••• optionN) "\(libname l ••. libnameNJJ
I/.

l us

/ 0j

~~!~-~~J_Q _R:~~~_'.:'.t~

fn

.ft

3. 1. 17-1

CAW

3,3,Z-10csw

3.3.2-11

DEF

symbol

DUMP

3.2.7-1

3. 1. 19-1{

hcxloc{~}J

3.3.Z-12

ONLINE}[{'symbol
symbol2id
hexloc 1I ) { hcxloc
2 }]3.3.2-15

*

0

~

J-

symbol }[{hcxlocGO[

3.3.2-21~$

fn

Erg l •.• argNJ

3. 2. 8-l

rcgl (rcg2]

GPR
IPL

3.3.2-26

KX

3.3.2-27
symbol }{ hcxloc

ORIGIN

3.3.2-30

RESTART3. 3. 3-32

RETURN

3.3.2-33

{

STORE

CAW

h{·~xinfo

csw

hex info
hex info
reg

PSW.

GPR

"'

j,3.2-34}[hcxinfo]

hexinfo [hexinfo

syinbol[{~} J}{ hexloc•11•:. :1;444;:4:4::;:a:::;::o::s114;::.;..u::.x:::11a iii!US!liil4112Uii IC!i#4U#JJ.Jll&fii!ii!i[hcxi.nfaj
Q1cxinfo]
hcxinfosymbol}.
{ hcxlocx1

3. 3. 2-28

PSW

SET

'

3.3.2-24(!iexinfo]

J

3.3.2-38

3.3.2-42

[{l}]

I

~
Jliii

t a

a

;: 111,,.:;:;;;wa. •==4 •• ""'*'"'"""'*u·~--·- 11-·'l""'""'!!"!1'!1'""":',, ...
11

1

F .•

"'

1'r""* '"'~·· .,.,,, . ""'""'"·"'!Fl

~

~·

"

7-19-68010

7-19-68
APPENDIX B-10
EDIT REQUESTS

610~prr Requests,!:~e Rei..:_[{~},]{BACKSPACE}
BACK
f BACKUP}
UPu{BL~NK}[f~} [{L~IlNO}]]

3. 1. 6-30

3.1.6-31

I. 3 . 1.6-11

line

fstringlfstring2/[W '[ri~kt J]

3.1.6-16~cdit!'n
fn J

3.1.6-18.

Htrlngf }/string/.

line

3. l. 6-33

SAVE[:it £u]3. 1. 6.;.34{SERIAL}{(~~)} [{~o}]3. I. 6-36

{TABDEF}
TARD

[{HJ

{TABSE'l}
TABS

r~l ... nN{ ~:CKUP}

3. I. 6-23

3. 1. 6-25

{
.'-')

·· ...

[{~} J{RE~YPE}

3. 1. 6-27.

3. 1. 6-38

l.:'

VERIFY}
VER

3. 1. 6-39

L~~

r~}

3. 1. 6-22

{LoCLATE}

3, l. 6-32

3. 1. 6-20

line

line

l( !}]SER

I{ f{1Ns;mT}

REPEAT

3. 1. 6-14

{IN~u:r}t]~'l}{P~IN'_f}{Q~}

3. l. 6-13

{1,.~D}line~' [{ !} .:{BRIE
BRI}·.

Fl LE{ovEgLAY}

3. 1. 6-28

3 . I. 6-10

3. 1. 6-12l DE~TE}

Page Ref.

')

3 . 1. 6-9{ BOTTOM}
BO

rll~NGE}-

6ff

APPENDIX B-11
EDJT REQUESTS

3. I. 6-41[{! }]

3. 1. 6-42

~2 } ]

3. l. 6-43.[{

{;o./.7-19-68
APPENDIX B-12
SCRIPT EDIT TIEQUESTSSCHIPT EDn.~]"{equests

Page Ref,{BO~TOM}

3. 1. .13-8{Cll~GE}{DE~ETE}/[string l] I [ string 2) I[{mr nfn "1

{FILE'!..
F J

I ofo !

fl>~SERT '\.
I. --,..,.

7-19-68
APPENDIX B-13
SCRIPT PRINT CONTROL
WORDS

_j

b/.J

SCH.IPT PRIN1:' Control Word~

3. 1. 13-9

line

J

{K~EP}

fn{ I.OCLATE}/string/. AP

fn

Page Ref.
3, I. 13-24

.BM

[l]

3, 1. 13-25

3. 1. 13-11

J; 1. 13-12.BR

3. I. 13-26

3. 1. 13-13.CE

3. I. 13-27

3.l.13-14.CP

1..-..;{1NiUT}'-

612.J

3. 1. 13-15

3. 1. 13-16

tE:T}

[{!}]

3.1.13-17{PR~NT}[{i}]

3.1.13-18n3. 1. 13-28. DS

3. 1. 13-29. FI

3. 1. 13-30

.HE

line

3. 1. 13-31

• JM

fri

3. l. 13-32• IN

3. I. 13-33[ :etmar]{Q~rr}

3.1.13-19

eEP~ACE}.

G1n~

3. I. 13-20{S~EK}

string3.1.13-22

r~~}

1

I

n

3. I. 1"3-34.NF[:oimar].PA[:.~ J.,)~

3. 1. 13-35.OF.---,.

3, l. 13-23"'4. . 11•1.LL

3. l. 13-36

3, 1. 13-37",_..........................................................................................

""'
l1

~

t""'

7 .. 19 .. 68

7--19-68(.,;f
APJ?ENDD: B-14
SCRIPT PRINT CONTROL

1
/

WORDS

Page Ref.

) · Control Program Console Functions

.PL
.PN

n

tN 1

3. l. 13-38

eE~I~}

r>exloc]~

4.1.1-1{CL~E}

devadd

4.l.Z-1{DETACH}

devndd

4.1.3-1{DIS~AY}

niexloc] [heJdocl-he~loc~ [Lhexloc] )4. 1. 4-1

3. l. 13-39

OFF~·

OFFNO .

,RD[I]

3. l. 13-40

.SP

[l]

3. l. 13-41

3. 1. l3-4l

. SS

,TM

11

(/~

APPENDIX B-15
CP CONSOLE FUNCTIONS 'DE[Lhexlocl-hexloc2] [Greg] [Gregl-reg2].

3. l. 13-43[Yrcg] [Yregl-rcg~ (:SW]{D~~p}.

J.

~exloc] Q1exlocl-hexloc1] (!,hexlo~ J 4. l. 5-1~hexlocl-bcxloc:~ [Greg) [Gregl-reg~ •[Yrcg] [!:regl-rcg~ ~S~

eXT~RNAL}.

JIPL

l

l I .!

{ux~,OUT}

J

4.1.6-1

CMS }{ clovaddl

4. 1.7-1

4.1.8-1'

01~

(/b

7-19-68

7-19-68

APPBNDIX D-16
CP CONSOLE FUNCTIONS

bf7

APPENDIX B- 17

CMS COMMAND OPTIONSPage Ref.
.QM~_Q__inmfilill__Qm_ig_us_{user!d}
ALL

{M~}

line

Default:,;

4.1.9-1~~-~!_l_!r~[L_o!_Qption

Q£ti?2!.

ASSEMDLE----·-3.4.1{{USER {NAMES] }QU~RY}.

4. 1. 10-1

LOGMSG

DECK
DIAG

LTST

MAX

NORE NTXREF
LDISK

devaddREADY

4.1.11-1{RE;(T}

4. 1. IZ-1

SET· {MSGOFF}
MSGON{ST~:E}[Lhexloc hex.info!

[oreg hcxinfol

hextufo~ ;) ..

hextnfoNJ

3.4.2

DECK
DIAG
EBCDICNOGONO LIST

4. 1. 13-1

NO MAPNO PRINTJ[Yreg hexinfo~ • • • hexinfoNJ~SW E;_exinfo ~ hexinfo

SOU~CEz] )MAP

NOC LEAR• [{~~F ~-j

NOTYPE
NOXEQ

4. L 15-i

PINV

\gy)

PREP
SLC12000

SYS LIBJ 45)s::;z,:'··""l!\.\....

H.

·'.. " " ' ' · •

O

•

O

H

'

RENT
NOXREF

write the L1STTNG file on the tape whose
symbolic address in T1\Pn

LTAPn

write the LISTING file on the offlincprinter

LPRINTor PRINT

do not cr<-'ale a TEXT fik
clo not type cli::ig11ostics at the terminal
Soun'.c prog mm is in BCD code
force compiler processing to completion
incJmle assembler mnemonics in LISTING
file
i11duclc storage rncip in LTSTING filepri.nt LISTING file on the offline printer'and erase it from the permanent disk
do not include source code in LISTL-..;G file

NODE CKNODIAG
BCD

GO
LIST
MAP
PRINT
NCSOURCE

do not crcntc.: a LOAD Mi\l' file
NOMAP
clear load region to zeroes before loading CLEAR
type load map contents at the terminal
TYPE
execute the loaded filc(s)XEQ
do not include invo.lid cards in the load map SH\1V
do not include Replace cards in the load
SHEP
map
stnrt loading program ~•t hexadecimal loSLCxxxxx
cation xxxxx
search only the specified TXTLil3 files
LIDE

~·

~'

~
11111
''

j

LOAD

3.2. 3{ TI~1ER}NODECKNOD I.AG
NOLIST

FORTRAN4. 1. 14-1.

do not create a TEXT file
do not type diagnostics at the terminal
do not create a LISTING file
check for re-cntrnnt coding
clo not create! a crosr. --reference tablein LISTING filewrite the LISTING file on the pernianent
disk

'O

.. O

•

O

? '~· J-, &!'~~1 '1'1'91"1",'1' . 1 1 1"'m'l!~~-!·'~· :mfl' 1 1 1.,T~.••~.~ 11•1111"
Q,111"'ff'l"F'WCP-,•..

'i''ffl!!!"!'!ll!'•iftl1'c;f!f"ml!J""!'r, r,rrp-·H:'--= ·r•"m,.•. "-· '''·"'. ,'.''' __ :_

-

..

... '

\11,

"'

,

"'

7-19-68
7-19-68

APPENDIX. 8- 19

01!

Defaults

Meaning of Option.QE_t_~

~

C60

n.
E
EB

FW
FW
NA

NLO
NM

NX

s
S2

ST
suppr.ess
punching of
TEXT fileinclude assembler nrneinonics in
LISTING file
crc;tte a SYSLIN file
con1pilc-time processing is required
include a Cro~s Hefcrcncc Listingin LISTING file
suppress listing 'or source program
supprc1>s listing of input to compilctiine processor
suppress st<1tcn1ent nun1bers in·execution-time diagnostics
punch TEXT file on offlinc punch

NC
C48

ND
NE
B

~!:..
3.4.4

F'E

FS

OFFLINE

start at print
position 1

center output on offline printerCENTER

write LISTING on

print LIS'I1NG file on offline printerOFFLI;'.\;'E orpermanent disk

STOP
NOWAIT
TRAI\'SLA 1'E
PAGExxx

PHI NTA

write LISTING on

type LISTING file at terminal. permanent disk
create LISTING filecompile SNOBOLONLINEL

do not create a LISTING file

execute SPL1 file

NOLLST
SPL1

LD
M

(

x
NS
NS2
NST

{CMsg:cK}lCMs~gPnj

suppresswriting of
LISTING
file on tape

lCMS'~PEl}write LISTING file on tape 181

pause at end o~ each page
start printing immediatelytranslate lower case to upper casestart printout at page xxx
print output on offline printerterminal{CMS~:iRIN1} suppress printing of LISTING file
on offlinc printerwrite LTSTINC file on tape lfrn

do not pause
wait
do not translate
start nt pnge 1
type output at

file

NL

Option----3.1.13

suppress compilation after compiletime processing has been completed
48-character set available on offline
printersuppress creation of TEXT file
suppress External Symbol Dictionary
in LISTING filesource program is punched in BCD
suppress warnings in LISTING file
suppress warnings and crtors in
LJSTING file-include only severe
erl'ors
include Attribute Listing in LISTING

Meaning of Option

SCRIPT PRINT .

PLI

c

/ c
L:fJ

CMS COMMAND OPTIONScj

APPENDIX B-18
CMS COMMAND OPTIONS

3. 4. 3

~

""

tlf

I

eMS'~~PEj

(

me:.

{/1v

7-19-68

2-05-68

APPENDIX B-19
CMS COMMAND OP'I10NS

6J<J

(

)

APPENDIX C
CP/CMS

Defaults~ca~i_i:i_g__<?.!_C?J.:t~on

MESSAGES.Ql~t!~~MESSAGE--

record no
GPR information

n·conl no
FPR information

record 2 linesof parameter list

record hasic
line for WAIT

use current

settings

record general purpose register (GPR)
contents before branch and after return
record GPR contents after return only
record GPR contents before branch only

GPRS

A r Ill IS fJISS!NG

TXTL IB3.1.16-3

GPRSA

ALROOY OHINCO

DEFINE03

J.5.1-2ANrecord no parameter list information
record 1 line of par2.mctcr list

NOPARM

record no inform3tion for WAIT
record same informalion for WAIT asfor other routines·record I line of parameter list for WAIT
record 2 lines of parameter list for WAIT

NOW AITWAITSAME

PARMl.

fllE ODES NOT EXIST.

MACLIB05

3.1.10-4

Ar lf1\ST ONE OF ltiE fllf:S H1 ASSEllBLE DOESt\'T
r XIS T CJR DOESN'T Hl\VE A COHREC T TYPE NMIE.

ASSEM13LE

01

3.4.1-7l\T l.fl\ST llNf:

or ltl( FILLS rn ASSEMBLE HAS
INCORR[Cf R(CORO LENGlH.

ASSEMBLE

01

3.4. 1-7

l\T LE,\ST ONE: OF TllE flLES lO Bf: COMPILf:D
COES~'T EXIST CR OCESN'T HAVE A 'FORTRAN'
TYPE NAt-'.E.

FORTRAN01

3.1•• 2-1

AT LFAST ONE OF THE fllfS TO BE COMPILED HASLOGICAL RlLURD LENGTH OIFFlRENT Of 80 BYTESfORTRANOl

3.4.2-7

ATT[t-'.PT TO COMBINE FIXED AND VARIABLE LENGTH

corm I NE

13

3. l. 3-2

OFH.INE06

3.l.11-6

l~PUT

FILES.

ATTEfJPT TO PRINT RECORD GREATER THAN 132
COLU,..NS.

WAl'flWAIT2DEFAULT

ATTEl-'PT TO PUNCH RECORD GRLATER THAN 80 COLUMNS OHLINE

03

3.1.ll-6

ATTEPPT TU hRITE OUTPUT FILE ON SYSTEM OISKILLEGAL.

cma1INL

12.

3.1.3-2

BhC i\RGLMENT

CP.
CP P.EG IN
CP CLOSE
CP DElACH
CP DISPLAY
CP DUMPCP I PLCP lt,SGCP ClJERYCP READY
CP STORE
CP TIMER'•. 1. 0-1
4.1.1-l4. 1. 2-2
4. l. 3-1
4. 1. 4-2
4. 1. 5-2,._ l. 7-1'•. l. 9-1
4. 1. l 0-1
4.1.11-1
4. 1. 13-2
4.1.15-1

l\flC P•)fl(

SPLIT).J.14-2

BAC CUTPUT TYPE

SPLIT

3. 1. l '•- 2

(\

..

I

,_
11

• :::::;u11:1 :z1:: 4, caw aa:.;a u

PAGE

REF.
3. 1. 16-3

record flo:iting point rcgistC'r (PPR) contents FPRS
before branch and after return:~cord FPR contents after return only
FPH.SArcct1nl FPR co11tC'nts hcforc hnrnch only
FPRSB

•

ERR.
CODE

TXTLIB

GPRSB

reset options to default values~UR£C.

A fllE HAS THE WRONG RECORD LENGTH.

SETO\'ER

3.3.4

62 1

APPENDIX C-1

~·

ir"l

: . m:u J1c:::::ag.11J1111S:au111UJU1111.:11u::::;u::::a::;:.::u1111:;;u:;;:;,. awm:a:a•11rn.wa,,. *""·''*, ;: 1.4 u11:•11s•••1:•e•••'' *' 'nm .
..

...... ...

. ... • . .

. . ••.

..

'.~,..,.

"""....

'.'!.· ,,,.,.,,f·, ,t!'~' .. ~··f' ., . , '·' , , i1

1 ,

I'

,

·*"' ufw:"™··. .· . ....................· . .·.....'.· ..·.· . ·..... ·... ·. .......... ·.......·. .·.·..... ·. · ....··· ·. . . ·. . · . ·.......•, ,1.: '··. , ·,·'~'"' ._) •• !! ••• " • ,, • , .: •. ,,.

..

~~~~~~~· ,.., 1 ~-~~·:::!i,!ll,;rn.i!fi!~~~~w~"r!ll!~~l!'~~~~·,™"~WPn'"~~ f' :iii·~1'•~iPT'll~,·lf:l~ ..

wi .11u11~if!:~...~ t~·~.~~ ~, ·1

fl"'\"

6.J-L

2-os-6s~{.1,L

2-05-68

APPENDIX C--2s,ER

mo SHALL

SPLIT

3.1.14-2

CAllEE=XXXXXXXX

CL ROVER

3.3.1-3

CALLrn=xxxxxxxx

CL ROVER

3. 3.1-3

CE ANO DE NOT fOUNO TOGETHER {VERY STRANGEJFORIMT04

3.5.4-2

FORMAT

CHS LOGGING OUT •••1 OT AL CPU Tl ME I 1N SECONDS)
CP E~TEREO, READY.

CMS LOGOUT

3.s.10-2

CMS

2.2.2-3

CMS.~.

11:

XX. XX

COMHAND-TU-DE-UNDEFINEO NOT FOUND IN SSTAT

COt-.lDITICN-CODE

SOURCE PROGRAM

ffl

06

ON SIO IN fORMATING DISKIBAOIUNOHINE02

f-ORTRAN

32

3.4 .. 2-7

FORMAT02

3. s. 1,-2

3.5 ·'·-2

DITICN-CODE 3 CN SIC IN FORMATING DISKfOADl

FORMAT02

3.5.4-2

CORRECT FORM; ERASE FILENA~t FILETYPE FILEMGOE, ERASETYPE MAY DE *• AND
MOCE MAY DE * OR BLANK~

01

3.1.7-2

NAM[ ANC/OR

DISK

01

COMBINE

10

OPTICNAL-~IL[HCOE~HlR[

COMMAND ISO

01.

USERS ARE •••1•ENDLINE 1 ,

ANll

1

01

3.1.13-5

MAC LI 801

3.1.10-3

TAPE

01

3.1.15-4

DEBUG

3.3.2~2

CEHUG ENTERED, EXTERNAL INT.

DEBUG
CP OEGlN
CP £:XTERNAL

3.3.2-2
4.1.1-1
4 .1.6- l

OEllUG

3.3.2-2

DEBUG

3.3.2-2SCRIPT

3. 1. 13-5

EDlT

3. 1. 6- 7

STAT

3.5.ll-2

CEB~G

E~TlRED

BREAKPOINT XX AT XXXXXXDEBUG ENTEREDPROGQAM INT. PSW=XXXXXXXXXXXXXXXX

CEFl~EDCOMMANOISl

DEFl~EDMORE THAN ONCE - XXXXXXXX'COMMANOl~ •• tOMMANON•

LOAD

01

REUSE

Ol

USE

3.L.3-2$

CEV XXX DETACHED.

CP DETACHDISK ERROR.

GENMOD

3.1.9-3

LO/iDMODPRINTFSCRIPTSPLJ T$OFFLINE01

3.1. 11-6

DISK l:RROR WHILE

R(AOING.

COMAJNESCRIPT
TAPE(_flSK ERROR hllllf WRITING.

PR I NTF

01

LINE-LIMIT 1 ARE:

OPTICNAL. '4.1.10-1

DEUUG ENTERED •••3.1.4-3

EXPECTED IN INPUT STREAM.

STARTLINE' 1

SCRIPTCP QUERY'PRINT', 1 flfUNlCC 1 , OR 'PUNCH•,
IF FlLENAMf=* UNDE~ READ M[OE, CONTROL CARDSCORRECT FURM IS: 1 PRINTF' I IU:Nf.M[ FILETYPESTARTLINE ENDL1NE ll~E-LIMIT, ~HERE·3.1.13-6t

TAPE DUMP FILENAME FILETYPE FJLEHODE
iAPE LO~O TAPE REWIND TAPE WRlTEOF TAPE SKIP

tREAC· 1 1
~

69

AUD •

CEFALLT TABS SET.

CORRECT FORM IS: LISTF FILENAME FILETYPE ~COE LISTF
hHERE FILENAME, FILETYPE, ANO MODE ARE OPTICNAL.
Fll(NAliE ANO/OR FILETYPE MAY BE*. MODE MAY BE
P,J,S,*• OR OMITTEC. SEARCH JS IP,J) IFCHITTEO, GK IP,T,Sflf *•CORRECT FORM IS : 1 0FFLlNE 1 CO!IMMW FILENAME

FILENAME.

3.5.12-2

02

CORRECT FORM IS: CO~BlNE Nl Tl Ml N2 T2 M2...
hHERE Nl,Tl,Ml ARE THE NAME, TYPE, ANO HOOE OF
THE FILE TO BE CREATED. AND N2 T2 M2, ETC.
ARE THE FILES TO UE CO~BINEO.

EDIT

MACLI B COMMAND MACll B-f J LE
IASP360 FILES) WHeRE COMMAND IS
GEN , LIST

CORM CT FORM:

CORRECT FORMS ARE:

FORMAT

COHl!ECT FO~M IS
OlSK DUMP FILENAME FILETVPE FlLEMODE
OR CJ SK LOAD •SCRIPTSCRIPT

3.5.4-2

CONDITICN-COCE 2 ON SIO lN FORMATING OlSK(BAOl

fllfTYPE

CORRtC r FORM l S:

CURR~NTVEMSJON J.O - 05/01/60

COMPil.ATION CANCELL~O DUEERRCRISI.

( ··"'':ORREC T FORM IS: 'SCRIPT 1 COMMAND NAME
wHERE COMMAND IS 'EDIT' OR 1 PRINT 1 •CR

CE AND CE NOT TOGETHER CHECKING NO. CYLINDERStJJAPPENDIX C-3

3.1.12-2

COr-AfHNE
TAPE

01
03

3.2.3-6
3.2.5-2
3. ?. 7-2
3.2.8-2
4.t .. 3-1

0 2- l 3 3. 7. • 1- 2
Ol-10 3.2.4-1
02
3.1.12-2
02
3. l. 13- 5
3.l.14-2

03

3.2.8-302
12

3.1 .. 3-2
3.}.13-6
3. l. l 'j-4

02
03

03

3. l. 3-2
3. l. 15-4

CISK FULL

SPLIT

3. l. l 4-2

C:UMP---xxxxxxxx

OEl3UG DUMP

3.3.?-15

6.25

tiy 2-05-68b'°21

Z-05-68
APPENDIX C-5

APPENDIX C-4

ERROR

)

~UMP/~ESTO~~ MOVED NNN CYL1NDERS.

. OUM PRESTElXXXXX) T=XX.XX

Cf.IS

WRITING

3.1. 5-1

THERE WERE ~NN RECOVERABLE TAPE ERRORS.

ERROlt Wti I LC hR Jr I NG 0 I ~K.

EXEC

E(X<XXXJ

W~ILI:ED 1 T :EDIT

END CA~D HISSING FROM DISK LOAD DECK.

DISKEND CF TAPE

TAPRlNT

ERRG~S

SYSIN REMAINS UNCHANGED.

[X[CLTICN Rl:GINS •••xxxxx 3 .. s. 3-'·02

3.1.10-3
3.1.16-3

CFHJNE08

3.1.11-1

UP CATE

3.1.17-'4

LOAD
START

3. 2. 3-5
3.2.6-2
3.2.8-2$

3.1 .. 6-7
3.1.13-5

SCRIPT

ENCG~NTERED.

MAC LIBTXTLI BFATAL DISK tRROR

DISK

TAPE

03
03

fATAI. l:RROR

WR TT AP

05

FATAL l'RR!JR l

UPDATE

3.1.17-3

FATAL

2UPDATE

3.t.17-3

FAT Al [RROR 3

UPDATE02

3.1.17-S

FATAL PLNCti ERKCR.

DISK

02

3.1.4-3

FATAL 1tEAO[K ER.ROtt.

DISK

04

3.1.4-3

FATAL TAPE ERRCR WHILE READING.

TAPE

04

3.1.15-4

SPLIT

3. t .13-11
3. l. lJ-16
3.1.13-17
3.1.11-18
3. l. l 3•22
3.1.14-2

TAPE

02

3.1.15-4

TAPRINT

3. t. 18-1

FILE ODES NOT EXIST.

FXEC

01

3.S.3-3

ED lT BLflNI<
EDIT CHANGE
EDIT DELETE

FILE 001:5 ~GT EXIST hill BE CREAiEO.

EDIT

FILE EMPTY-EXIT TAKENEDIT FILE
EDIT SAVE

02

EDIT OVERLAYEDIT PR INT

3.1.6-11
3.1.6-15
3.1.6-16
3.1.6-20
3. 1. 6-25
3.1. 6-27
3.1.6-28
3.1.6-30

COMBINE
TAPE

0l
01

3.l.15-4

ERRET=lCXXXXXXX

CL ROVER

3. 3. l-lt

FILE HAS hRONG RECCRD SIZE.

EXEC

04

3.5.3-4

ERROR DURING IPL SID.

CP I Pl

4.1~7-lFILE '"IUD If fl D

SPLIT

3.1.14-2

FILE NOT C'°'ANG(O

SPLIT

3.l.14-2

FILE NUT FOUNDLIS TF
OHLINEPR INTF

FILE NOT FCUNO - XXXXXXXXLOAD

ENOl~G

TAPE

RECORD OF FILE MISSING.

ENTER PASSWORD: .

CP LOGINEOF RE4CHEO.

SCRIPT DELETE

~OF

EDF

BY: XXX ••• XXX

3. 1. 4-3
3.1.10-1

06

3.1.15-5
2.2.2-2SCRIPT LOCATESCRIPT NEXTSCRIPT PRINTSCRIPT SU:K

REAC UN TAP.E
RE~CHEO

06

EOIT FIND
EOlf LOCATEEDIT NEXTERROR IN NAME, TYPE, OR MODE OF OUTPUT FILE

COP.BI NE

ERROR ON DISKSPLIT•••••ERROR-OVERRIDE

CL ROVERERROR WHILE LOADING THE IEYFORT MODULE.

FORTRAN16

3.4.2-7

ERROR WHILE PRINTING.

OFFLI NE01

3.1.11-6

ERROR WHILE PUNCHING.

OFFLI NE05

3.1.ll-t

ERROR WHILE REACINGHACLI 0TXTLIB

03

OFFL INE

04

ERROR

~HILE

READING DISK.

•i~l ••llJJl114i ; : : : t!Uliiif i#41Jlllli!iiA¥# #ii@IJ JJS:Cil#J

05

l:IWUP

fATAL. TAPE ERR.OR

W~ILE

hRITING.

GEN~OD

LOADMOD

FILE

3.1.3-2.
3.1.14-2

FILENAME FILETYPE FILEMOOE

3. 3.1-3

NOT FGUNO\oiRTTAP
R~USE

USE

01-04 3.2.4-1
3.1.f,-6
3.1. 6-18
3.1.6-34
3. l. 3-2

02
02
03
04

3.1.9-3
3.1.11-6
3.J.12-2
3.1.19-2

06
06
06

3.2.3-6
3.2.'>-2
1.2.1-2

3.1.10-3
3.1.16-3
3.1.11-6

euaua Uk .d!i ,JUJ!i SJL&. JU . . JU .2.,£ a.. UC JI Ubl. Sl.SSSJQL j IJildU :u; ""' . .

3.1.19-2

xxxxx 3.2.1-2/~

3.1.4-3
3.1.15-4

~

~

"""

~

6.J?

t1t

7

2-05-68(.21:.

APPENDIX C-7

2-05-68
OEllUG GPR
DEBUG ORIGIN

3. 3. 2-24
3.3.2-29

DEBUG SETDEBUG STOREDEBUG X

3. 3. 2-35
3. 3. 2-39

LOAD
REUSE
USE

3.2.3-5
3 •. 2.s-2

INVALID CMS COMMAND

CMS

3.0.0-2

INVALID CURE-ADDRESSDEBUG BREAK
DEnUG DEF

APPENDIX C- _ )FILE XXXXXXXX NOTFOU~OSCRIPT08

3.1.13-5'FILENAME FILETYPE FILEMOOE' LOADED

OISK

3. l. '•-2'FILENAME FlLETYPE' NOT FOUND

UPDATE

3.1.17-4'FILENAME ffLETYPE 1 Pl LOADED

TAPE

3.l.15-2

FILENAME NCT GIV&N. COHMAND FORMAT IS:' FILENAME UPTIC~AL ARGS$

01

3.2.8-4

UNDEf INED.

llSSEMBLE

01

3.4.1-7

FPRS AFTER=xxxxxxxx ••• xxxxxxxx

Cl ROVER

3.3.1-4

FPP.S BEFORE=XXXXIXXX ••• xxxxxxxx

Cl ROVER

3.3.1-4

FRCM USERIC: LINf

CP MSG

4.1.9-1

F/\/ FLAG WRCNG

SPLIT

3.1.14-2

GPKS AFTER=XXXXXIXX ••• xxxxxxxx

CLROVER

3. 3 .. 1-4

GPRS uEfURt=xxxxxxxx ••• xxxxxxxx

CLROVEROHIUG BREAKOEAUG CAW

3.3.1- 1•

OERUG CSWILLEGALCAR~OISK LOAD DECK.

DISKILLEGAL

CO~TROL

ARD

flLEISl TO~SSEHBLE

IN

ILLEGAL DEFINED
CR '.'~NCOUNTEREOOMMANO -- CAN'T USE

'*'•

1

. 3. l. 't-3

SCRIPT

16

3.1 .. 13-6

DEFINE04

3.5 .. 1-2

S~LIT

CHA~GE~XIT

lNCUP.RlCT OtBUG

ALTER

05

OEOUG DUMP
DEOUC GODEOUG ORIGINOEUUG STCRE
OE!1UG X
INVALlO CP REQUEST

CP

4.1.0-1

INVALID OE"UG RtCUEST

DEBUG

3.3.2-2
3. 3. 2-6
3.3.2-10
3.3.2-11

DEBUG DEF
DEBUG DUMPDEBUG GC
DEBUG GPR
DEBUG t PL
DEBUG KX3. 3. 2-13

3.3.2-17
3.3.2-22
3.3.2-24
3.3.2-26
3. 3. 2-21
3.3.2-29
3.3.2-31
3. 3. 2- 32
J.3.2-33
3.3.2-35

DEBUG RETURNDEBUG GCl NV AL I 0
3 .. 1.11-7

INCORRECT PARAMElER LISTSCRIPTO't

3. 1. 13-5

I NPt.. T :f.O IT INPUTHACLIB

l~VALIO

3.1.6-3'•
3.1.13-8
3 .. l. 13-1 3
3 .. 1.13-20
04

11'.jVALJD ARGUMENT

EXfST~.

3. l. l 0-1.

UP CATE

3.1.11-3'

DEBUG BREAK
DEBUG DEF
DEBUG DUMPDEBUG GC

J. 3. 2--6
3. 3. 2-· l 3
3. 3. 2- I 7

3.3.2-?.2

SCRIPT EDIT CGMMANO

110 fRRCR CN PR1NTtR.
A 'LISTiNG 1 DISK FILE

i

Fll~

~ H' I T

INVALIO R~CUEST:xxx ••• xxx

3. t. 6-2 2

EDIT SAVESCRIPT BOTTOMSCRIPT INPUTSCRIPT 11EPLACE

CORRECT MACRU FORMAT.

DE!IUG SETDEBUG STORE

3.3.2-33
3.3.2-22

09

I~

DEBUG PSh
DEBUG RESTART·OEflUG RETURN

3.1.1-2

OHi. I NE

lNfERM~ClATt

3.2.1-2

3.3.2-b
3. 3. 2- l 3
3. 3.2-17
3.3.2-22
3.3.2-29
3.3.2-39
3 .. 3.2-43

3.1. l't-2

INCCRRECT 'OFFLINE READ*' CONTROL CARD.

INPLl f[L( NOTXX'X ••• xxx

ornuG ORIGIN

ILLEGAL MOOE
ILLEGAL MOOE

1 ('

05

__ JNVALID_CARO -3. 3. 2-4 3

3.3.2-43

SPLIT

3.1.14-2

EOIT

3. 1. 6-7

SCRIPTSCRIPT KEEP

~PRl~T 1~ILL

3.3.2-39

DEBUG XBE

OPTION CA~CELLEO.
CREAT(O.

3.1.13-5
3. 1 .. 1 3-1 5

FORT~AN3.4.2-4

ITEt-' SILE

SPLIT

3.i.14-2

KILLING CMS EXECLTICN •••P-DISK: XXX RECCROS IN.USE, XXX LEFT (Cf XXX)
XX( fULl ICF XXX CYL.)OEAUG KX
KX

3. 3 .. 2-27

_lff l

Pf\HFNftlESIS MISSINGFORTRAN

3.5.8-1
01

3 .11. 2- 7

{15

2-05-68
0'! APPENDJX
C-8

2-05-68l.z;

APPENDIX C-9

TXTLI BLIBRARY NUT FOUND.

s

FAILE:O.

~DAC

LOhD PAPER

HIT Rf.TURN

UlGGEO CN Ar TEHM. XXXlOGGFr AT XX.XX.XX CN XX/XX/XX

OR

LOGI~

PLEASE

rcK~AT

3.l.16-3
03

3.2.8-4

SCRIPT

3.1.13-5

CP LOGIN2. 2. 2-2

CMS
02

3.5.9-2

LOGll\ UFO FAILED

CMS LOGIN

01

3.5.9-2

LOGCFF AT XX.XX.XX ON XX/XX/XX.

CP LOGOUT~hCLIB

CICTfCNARY OVERFLOW -TOC PANY MACROS. SCRRY.

MACLIB

OR

3.1.10-4

MACltU FILt SPECIFIED UCES.NOT EXIST.

MACLIBObMACLIB FILE SPECIFIED NOT IN CORRECT FORM.

MACLll3

07

1-!AX.
~ocE

CF

TRY FCRMAT P

LSERS EXCEEDEDSP~ClflEDFO~

OUTPUT FILE IS ILLEGAL.

MURE THAN E:IGHT ACTIVE FILES-REDUCE NESTING.
~O~E
~AME

THAN

2~6

LIBRARY ENTRIES. SORRY.·IS UNGEFINED - XXXXXXXX

NE~

FIL( ALKEACY EXISTSNO MCRE ROOM:FCR USER-DEFINED COMMANDSDEFINf.

NO PRIMARY NAME SPECIFIED.

EDITNO PRIMARY NAME SPECIFIED-RETRY

EDIT FILENORMAL CVERl<IDE

CLRCVER

3.3.1-3****NOTE--NORMAL- AND ERROR-OVERRIDES HAVE NOW
BEEN CLEARED****

CLROVER

3.3.l-'1

3.1.10-4••• NOW ASSEMULING FiLE FILENAME

ASSEMBLE

3.4.1-3

3.1.10-4

NRMRET: XXXXXXXX

CLROVER

3.3.1-3

2. 2. 2-2

CLO FIL[ NOT FOUND

ALTER
SCfU PT KEEP

01

ALTER

03

3.1.13-6

ClD

$

05
05
05

3.2.5-2
3.2.6-2
3.2.8-4

ALTER

02

3.1.1-2
3. 1 .. 13-15~ODE

ILLEGALCP QUERY". 1. 10-1

NO Cl-'ANGESCRIPT CHANGE

3. 1.13-10

1°110 Cl-ANGES MADE

ALTEROPEN FOR READ

SPLIT

3.1.14-2

OPEN FOR ~RITING

SPLIT

3 .... 14-2

CUlPLT TAPE FULL.
CHANG£: IT ANO Ill T CARRIAGE RETURN.

ASSEMBLE

3.4.1-4

OVERLAY [RIWR

LOAD
REUSE
USE

NO C\..RRENT LIN~SCRIPT PRINT

3. l .13-10

NU CLRRENT LINE.
INPl.TSCRIPT BCTTOM

3.1.13-0

0 CEflNEO COMMANDS

STAT

02

02
02
03

$

P-DISK: NNNN RECORDS IN USE,
NNN L[fl ICF NNNNI,
l\NI FULL (Of NNN CYL. I

02

WRTT AP
PAR~.-LiST=XXXXXXXX •••xxxxxxxx

PASSWORD INCGRRECT.

3.2.3-6
3.2.s-2
3.z.1-2
3.2.s-2
3.5.11-2

STAT

UPIJATE

PARh"'E TER ERROR

3.1.1-2

1.1.1-2
3.1.14-2

3.l.l-2

NN USERS

3.1.1-2
3.1.13-15

SPLIT

GPl:.N FILE LIMIT

3.1.16-3

Al TER3. 1. 17- 3
3.1.19-2

CLRCVER3. 3. l-4

· CP lOGlN ·2.2.2-3lOGOFF AT XX.XX.XX ON XX/XX/XX$

3.5.11-2

02)3.,2. 6-4

•

.....

3.1. 6-18
3.1.6-34

SAVE

3.1.14-2

24

04

3.1.6-6SPLIT

SCRIPT06

3.5.1-2

NONSTANCARD FILE

3.1.3-2SCRIPT KEEP

01".1. 3- l
1t.1.11-1

11

TX Tll 0

3.5.11-2

CP READY

NEk PUUE ILLEGALNU [X[(, MrOeLE, OR TEXT VERSION OF FILE xxxxxx
fOLl\C. i cc~~A~O Cflf\hCl BE EXECUTED.

STAT

3.4.2-7

CP OET ACH

COMO I NESTART

ND KNOWN T-DISK

01

NONFXISTENT UNll

4.• 1. 6-1

CP LOGIN

REUSEFORTRANEDIT

CMS LOGIN

LOGll\ NC UFO FAILECNO FILE TO OE CCMPILED IS DEFINED.

I~'mWl.H!iiiiSb09111MILll!Li@ Q . $fak.£SIJUlS,. ,,.U.1,.i._J.fa . ., . .M,.JU..,~.faMJE. ..,..lt..!S_",l.i . iii..J.J ..JLJLJU....._£.. U . ..12. . Xt..XilUJQQ ....U._QJ, UIJZUUlllC•IMLU! . 11'~1111011 aa•nm

&•1

.I"

t"''

~

2-05-68b'!!1')t 3c:

APPI:.:NDIX C-11

b3/

APPENDIX C-10

PERMAN(NT 1/0 ERROR CN DISK, ASSEMBLYASSEMBLE
CCNflNUES hlTllOUT l\RlllNG LISTING FILE ON DISK.

3.4.1-4~-.,\

PERMANENT 1/0 ERROR ON JAPETAPRINT

3.1.1e-1

1/0 ERROR CN TAPE
Ll~TING FILE Will BE hRITTEN ON DISKWRITING ON JAPE IS CANCELLED.

ASSEMBLE

3.4.1-4

PER~ANENTASSEMBLE

3.'i.1-3

16 SYMUOLS ALREADY DEFINEDDEBUG DEF

3. 3 .. 2-13

TAPE ERROHASSEMBLE

PERMl>NEflll I /O f.RRUn l\llJLE READING SYSlN Fll.E
fll[NAME UNAULE TO ASS[l'[!LE ALL TIIE FILF:.

ASSEMl.ILE

3.4.1-4
20xxxxx

3.1 .. 19-2

TAPE

05

3. 1. 15-5

LOAD
REUSE
USE

04
04
04

3. 2. 3-6
3.2.5-2

WR TT APTAPE IS NOT JNPERMANENT 1/0 ERROR CN THE PRINTER,
LISTING FILE WILL B~ ~RITTEN ON DISK.

TAPE LOADFORMAT.

THE FOLLUhlNG NAMES ARE UNDEFINED - XXXXXXXX

3.4.1-7$

Plf ASE :LOGIN ~FD' OR 'LOGIN NO UFO'

CMS LOGIN

PLlASE RfACY 1HE PRINTLHASSEMBLETAPRINT

PlrASL SPECIFY DISK: P[RMAl\ENT IPI CR
C~ TEMPCRARY IT>.

fORMAT

R;T=X.(.XXCMS~f A[;UPCATE

EHROR

..,./

SYMBCLIC TAPE ADDRESS INCORRECTLJSTING FILE WILL BE kRITTEN ON DISK.
WRITING ON TAPE IS CANCELLED.

03

01

3.2.!l-3

3. 5. 9-2

TOO MANY DUMMY ARGUMENTS.

EXEC

3.4.1-4
3. l. 18-1

TOO fo!ANV FILESSPLJ rToe MANY LEFT

3 .. 5.4-2

PARE~THESES.

. TRlJfllCATEO

3.1.17-3

3.?.7-2

03

3.5.3-4
3.J.14-2

FORTRAN01

EDIT
SCRIPT CHANGE

TYPE NOT. FOUNDSPLIT

UNAULF TO COMPILE ~ORL THAN 32 FILES IN ONE
RUN. PLEASE SPLIT VCUR RECUEST.

FORTRAN

3. '•. 2- 7
3. 1. 6-7
3. 1. l 3-1 ('

3.1
01

~'·-?

3.4.2-1

Rf l\f ll:\IL Y

SPLIT

3.1.14-2

KlA[Y AT XX.XX.XX CN XX/XX/XX

CP LOGIN2. 2. 2-3

UNAOLE TO IPL SPECIFIED UNIT TYPE

CP I PL4. 1. 7- 1

FORTRAN3.4.2-4

USER NUT IN OIRECTCRY.
LOGCFF AT XX.XX.XX ON XX/XX/XX

CP LOGIN

2.2.2-2

ASSEMBLE

3.4.1-4

UNEXPECTED UNIT-CHECK CHECKING NO. CYLINDERSFORMAT

01

CP

2. 2. 2-2

UNEXPECTED UNIT-CHECK IN FCRMATllNG DISKFORMAT

03

USER ~OT ON SYSTEMCP MSG

3.2.6-3

VARIABLE

WRTT AP

DEf\UG CREAi<

3.3.2-7

hRlTF.

SCRIPT

3 .1. 13-4

SE TERR
CLltCVl:R
SC TCVER

3. 3. 3-3
3. 3. 1-3
3. 3 .. 4-4

DUMl'REST

3.l.5-1

ECHO

3.5.2-2

KEAr.v fl,E PRINllR.

RlACY

T~E

JAPE

~NIT

ANO HIT CARRIAGE RETURN

REPfAT LOGIN
REFERENCE TAeLE

CVERFIC~

LOG!~

LOAD
REUSE
USE
$

REPLACES OLD BR(AKPGINT XX AT XXXXX~lM--- VERSION 2/5/6U

SETTING ERRCR-CV[RR!Dl TO rncvlDE A DYNAMIC
t~ACE OF c~s IANC CSI SVC-CALLS •••SP~ClfY'lll..MI" UR

START TERMlfllAL1

RE~T0Rf: 1 :TE~T

SVC-CLD-PS~=XXXXXXXXXXXXXXXX~YMHCLIC

TAP( ACCRESS!~CORRECT.

03
03
03
03

CL ROVER
TAPRlNT

3.2.3-6
3.2.5-2

3.2.7-2

LENGT~FILE

ERROi~

3.~.4-2

4. 1. 9-1
03

3.1.19-2

UPDATE3. 1. l 7-3

hRONG NUMUER OF PARAMETERS

SPLIT

3. l .14-2

X-C!SK:

FORMAT

3.5.4-1

NNN €YL.

3. 3.1-3
01

3. s. 4-2

3.1.18-2
"~

)

•

I

6-1-68

63.~

1 -6-1-68~3.3

CMS USER'S GVIDE

2 -

b33

INDEX

ASCll-B CODE

3.3.2-30

ASP360 FILETVPE 3.t.6-2, 3.1.6-lt 3.1.6-7, 3.1.6-15
ASSH'.llLE COMMAND
3.4.1-1, 3.1.16-2, 3.2.0-2, 3.2.2-1 1 3.2.2-3 1 3.1.18-1,
3.2.3-2, 3.1•• 1-2 nmu 3.4.1-1, 3.t.19-1,flPP.ll, APP.ll, APP.fl-15
3.t1o l-l TllllU 3.4.1-5, 3.4. l-7 1 3.1._ 1.1-3, 3.4.'t-2 lHRU 3.4.4-4,
3.4.4.1-3, 3.1.19-1, APP.B-15

ASSEMOLERASSEMALER F PROGRAMMER'S GUIDE MANUALA OPE~~NO OF MAPPRT COMMANDABBREVIATJNG CDMHANOSACCESSASSEMRLER LANGUAGE
2.1.0-3, 3.1.2-t, 3.1.10-1, 3.1.10-2, 3.2.e-2, 3.3.z-5,
3.'1.l-lt 3.4.1.1-1 THRU 3.4.1.1-4, 3.4.I.Z-l, 3.4.1.2-3, 3 ...,.z-1,
3.4.2-31 APP.A-I, GLOSS-3

3.0.0-1

AREND ~ACRO·INSTRUCTIONADNOR~AlTERMINATION3. 4.1.2-1

ASSEMOLtR LANGUAGE MANUAL(SEE LNRECOVERABLE ERROR)GLOSS, 2.1.0-4, 3.1.8-lt 3.3.2-32, 3.4.1.,2-13, APP.A-Z

ASlEHISK
2.l.0-2, 3.1.1-1, 3.1.7-1 1 3.t.8-1, 3.1.8-.?, 3.1.9-l, 3.1.11-2 HllW
3.1.11-4, 3.1.11-6, 3.1.11-1, 3.1.12-1, 3.1.11-3, 3.2.4-1, 3.3.2-12,
3.3.2-161 3.4.7-7, 3.5.1-2, 3.5.12-1, 4.1.2-lt APP.e-1, APP.B-4
lHRU Al'P.0-7

3.1.10-1, 3.l.0-2, 3.1.0-3, APP.B-6

AP.C f:PERAt.;O OF TXTLIB COM~ANO 3.1.16-lr 3.l.0-2, 3.1.16-2, APP.8-7

ATTACt1 COl';SUL°t: FUNCTION

ACCRfSS REFERENCE
ALIG~~FNT~LL

4.1.~·2,

ATT AChEO DEV l(.C:

4.l.5-2i 4.1.13-2

ALPHABET FILETYPE

3.5.13-3,3.,5.13-1

ALPHtNUH FlLETYPE

3.5.13-1

TURU

ATTENTION KEY
GLOSS, 2.2.1-1, 2.2.1-4, 2.2.2-2, 2.2.2-3, 2~3.0-2, 2.3.0-3,
4.2.0-1,3.1.11-3, 3.3.0-l, 3.3.2-16, 3.3.2-32, 3.4.l-4. 3.5.5-1, 3.5.6-1,
3.s.1-1, 3.s.1c-1, 6.0.0-1, .6.o.o-s,6.o.o-6, 6.o.o-a, s.1.0-1

3.5.13-3

ATJN KEY

3.1. l·· 1,3. 1. 0··2 ,3. l.1-2, 3.1.4-3, 3.1.15-5, 3.1.17-3,

3.4.l-2, 3.4.2-13, 3.5.1-2, APP.A, APP.a, 3.1.6-6,6.0.0-l/ILTN C:CDINC KEY

e2.2.1-4, 2.2.1-6, z.z.3-1, GLOSS-IeACK.AP lSEE APPEND CONTROL)

APPEtW CONTROL

4.1.3-1, 4.2.0-1, 4.2.0-2, 3.1.19-1

ATTENTION INTERRLPTGLCSS, z.2.1-1,· 3.3.2-17, J.5.5-1, 3.5.6-1, 3.5.7-1,
3.5.8-1, GLOSS-1

J.5.4-1

H TEP. COfHiMlO(SEE ATTENTIGN KEYi

ISEE BLANK RECLESTIISEE BACKSPACERECUESTl

BACKSPACE RC:~U[ST3.1.6-7, 2.3.4-1, 2.3.5-1, 3.1.6-3, 3.1.6-41 3.1.6-6,
3.l.13-2, 3~4.2-8, APP.A

3.[.13-24, 3.1.13-7, 3.l.13-32

ARGU!1E~T

GLOSS, 3.1 .. 6-5, 301.11-2, 3.2.6-1, 3.Z.6-2, 3 .. z.e-1 THRU 3.2.6-4,
3.3.;>--6, 3.3.2-13, 3.3.2-22, ,3.3.2-24, 3.3.2-29, 3.3.2-35, 3.3.2-39,
3.3.2-43, 3.4.4.1-1, 3.4.4.1-3, 1.5.3-t, 3.5.3-2, 3.5.3-4, 4.1.0-1,
4.1.1-1, 4.1.2-2, 4.1.3-1, 4.l.4-2, 4.1.s-2, 4.1.1-1, 4.1.9-1, 4.1.10-1,
4.l.ll-1, 4.1.13-2, APP.A-4, APP.8-3 THRU APP.8-5, APP.B-7,

BACKUP REOUEST ISEE ALSC LP

UALR INS TRUC 1 ICNBCO OP fl ON

4. 1. l 5- 1. 4. 1., 15·· 2t.

~

RE~UCST)

3.l.6-10, 3.1.6-8, 3.1.6-13, 3.l.6-43

3.0.0-1, 3.4.l.1-4

3.4.2-lt 3.4.2-2, APP.B-15

eCGIN CONSOLE FUNCTICN~

4.1.3-l3. 2. O·· l

3.4.1.1-3,

LPTIO~

3.l.2-1, 3.2.2-2, 3.2.2-3, 3.4.1-3,

ASSEMBLY
l.0.0-3, 3.2.2-2, 3.4.l-l THRU 3.4.1-5, 3.4.1-7, 3.4.l.2-lt
4.0.0-1, APP.A-2

APP.A-l

ACO UPERAND UF HACLIB COM~ANO

3.1.. 1-s

ASSEMBLER QP[RANO OF GLOBAL COMMAND
6.4.0-l,· APP.0-5

2.l.0-4, 2.1.0 ·lr 2.2.0-·lr 2.2.1-1• J.l.O-lt 3.1.0··2, 3.1.,4-3,
3.1.8-·J, 3e2o6·l, 3~2.6-2, 3.2.8-3, 3.4.l.2-lt 3o4elo2-7r 3e4o2.l-13t
3.ti.Z.l··Hi, 3.11~4.l·-l, 3.4.4.1-2, 3•5.1-1, 3.5.1-2, 3.5.4-·1, GLOSS-Lt

ACllVE FIL~ TABLE

3.4.1-5

3. 5.13-1

4.1.1-1. 2.3.0-3,4.1.1-2, 3.1.11-3, 4.0.0-1, 4.1.0-1,....
if. ···r

,,,._'~!""ti

6-1-68/3/ 3 4~2.0-1,

ISEE BOTTOM MARGIN CONTROL)
3.l.13-251 3.1.13-7, APP.A-9

BOTTCM MARGIN CONTROL
RECU~ST

BOTTOH

3.1.6-12, 3.1.6-8

lEDlT ENVIR.)

BOTTOM RlCUESl !SCRIPT ENVIR.l

3.1.13-0, 3.1.13-2, 3.1.13-6

eOUNOARY3.3.2-4 THRU 3.3.2-6t 3.3.2-161 3.3.2-22, 3.4.1.l-lt 4.t.4-2t
4.1.6-2. 4.1.13-2
eR

4 -CARD IMAGE GLOSS, 3.l.0-1, 3.l.6-1 1 3.1.6-2, 3.l.6-4, 3.1.6-5, 3.1.6-7,
3.1.6-9, 3.1.6-11, 3.1.6-15, 3.l.6-201 3.l.6-25, 3.1.6-321 3.1.6-431
3.1.9-2, 3.1.10-1 THRU 3.l.10-41 3.1.16-2, 3.2.3-1, 3.2.3-2, 3.2.3-4,
3.2.3-5, 3.2.6-1, 3.5.3-1, 3.5.3-2 1 5.4.0-1 1 GLOSS-1, CLOSS-2, APP.A-2t
APP.A-4
CARD INPUT

l.0.0-2, 3.1.11-1

CARO READER.3.l.Ll-11 3.1.11-3, 4.1.2-1, 4.1.2-2, 4.1.7-1 1 GLOSS-3 1 GLOSS-~,CARD STREAM

3.1.4-2, 3.1.11-1 nmu 3.1.11-3, 3.1.11-6, 3.4.4.1-1!SEE BRIEF' RECUESll
3~1.11~11

CARRIAGE CONTROL.BR

3.1.11-2. 3.1.19-11 3.1.19-2(SEE BREAK CONTROL)CRANCH

3.4.l.2-9 1 3.4.1.2-19, 3.4.4.1-3

bREAK CU~TROL

3.1.13-261 3.l.13-7, 3.1.13-251 3.1.13-271 3.1.13-291
3.1.13-301 3~1.13-33 THRU 3.t.13-38 1 3.1.13-40 THRU 3.1.13-1,7, APP.A-9

P.REAK RL:OUEST

2.3.3-11 3.3.2-3 TllRU 3.3.2-9, APP.A-1

AREAKPCINT
2.3.0-3, 2.3.3-11 2.3.3-21 3.3.2-11 3.3.2-21 3.3.2-4 THRU 3.3.2-81
3.3.2-21, 3.3.2-22, 3.3.2-321 3.3.2-33
3.3.2-61 3.3.2-21, 3.3.2-22

eREAKPCINT INTERRUPT~RIEF ~DOE

3.l.6-4 1 3.t.6-10, 3.1.6-11, 3.1.6-15, 3.1.6-13 1 3.1.6-251
3.l.6-201 3.l.6-43,3.l.6-33 1 ~PP.A-6 1 3.1.6-20

C!RIH REQUEST

3.1.6-13, 3.1.6-0, 3.1.6-6, 3.1.6-43, APP.A

BSP MACRO-INSTRUCTION
BUFFERc()_;~

3.4.1.2-91 3.4.1.2-10, 3.4.1.2-12 THRU 3.4.1.2-20, 3.4.2-2 THRU 3.4.2-41
3.4.2-1, 3.4.2-8, 3.4.2-13, 3.4.4-3, 3.4.4-4, 3.4.4.1-1, 3.4.4.1-2,
1.s.1~1, 3.s.1-2, 3.5.4-11 3.5.4-2, 3.s.s-1, 3.5.6-11 3.5.1-1, 3.s.11-1,
3.5.13-11 3.5.13-3, 4.0.0-1, 4.1.0-1, 4.l.6-1, 4.1.1-1, 4.2.0-1,
6.1.0-11 GLOSS-1, GLOSS-2, APP.A-1 THRU APP.A-~, 3.0.0-1, 3.5.10-1,
3.5.10-2, 3.5.14-l, 4.1.15-1~ 6.0.0-1, 6.o.o-8

APP.A, 6.0.0-1, 6.o.o-o

BLANK REQUEST
3.1.6-11, 3.1.6-1,3.1.6-4, 3.1.6-0, 3.1.6-13, 3.1.6-321
3.l.6-43 1 APP.A.BM

6-1-68/;3t

3.4. l. 2-1

3.l.3-2, 3.1.11-6, 3.l.14-21 3.4.1.2-71 3.4.1.2-81 3.4.1.2-101
3.4.l.2-f6, 3.4.1-2-17

CSEE CHANGE RECUESTl

C OPERAND OF

M~PPRT

C OPT I ON CF

FO~Ht. T

COMMAND

3.5.13-1, 3.5.13-2

C01'111AND

3. 5. 4- l ' 3. 5. 4-2

CARRIAGE CONTRC( CHARACTER
3.l.0-2, 3.1.ll-l, 3.1.11-2 1 3.1.11-5, 3.1.12-11
3.4.2-8, 3.4.2-lC, 3.4.4-1, 3.4.4.1-2
CARRIAGE RETURNGLOSS, 2.2.1-4, 2.2.1-6, 2.2.2-21 2.z.2-3, 2.2.3-11 3.1.5-1,
3.l.6-1, 3.1.6-3, 3.1.13-2 THRU 3.l.13-4, 3.3.0-1 1 3.3.2-6, 3.3.2-10,
3.3.2-111 3.3.2-13, 3.3.2-17. 3.3.2-221 3.3.2-24, 3.3.2-26, 3.3.2-29,
3.3.2-31, 3.3.2-33, 3.3.2-3511 3.3.2-391 3.3.2-43t 3.4.1-4, 3.4.4.1-2,
3.5.4-1, 4.1.0-l, GLOSS-31 3.0.0-1, 4.0.0-1
CAW

ISH CllJIN.NEL t.DORE:SS wCRDl

CAW RECUEST

ccw
.CE

ISEE CENTER

CENTER CONTROL

3.s.11-1, 3.s.10-2

CAHBRIGGE HONITOR SYSTEtl !CHS)
i.0.0-1. l.O.O-;>, l.0.0-31 2.0.0-1. 2.1.0-1,
2.1.0-2, 2.1.0-4, 2.2.0-1, 2.2.1-11 2.2.1-4, 2.2.2-1, 2.2.2-31 2.2.3-1,
2.3.0-l, 3.l.0-1, 3.l.C-"2 1 3.1.2-lt 3.l.4-2, 3.l.!;-11
3.l.6-13~ J.1.6-14, 3.1.0-1. 3.1.10-2, 3.l.ll-3, 3.1.11-4, 3.1.13-20,
3.1.11,-3, 3.1.15-Zt 3.1.17--4, 3.2.2-1 THRU 3.2.2-3, 3.2.B-2, 3.3.0-l,
3.3.2-l, .3.3.2-12, 3.3.2-13, 3.3.2-26 THRU 3.3.2-281 3.3.2-331 3.4.1-41
3.1,.1-~, 3.4.1.1-1, 3.1,.1.1-J, 3.1•• 1.2-l THRU 3.4.1.2-~)1 3.4.1.2-71

CO~TROL)3.1.13-27, 3.1.13-7, 3.1.13-44,

CENTER OPTION OF SCRIPT COMMAND
CENTRAL PROCESSING UNIT ICPUl

3.l.l~-45,

3.1.13-47

3.1.13-1
l.D.0-1, 3.3.2-301 4.1.6-1 1 GLOSS-2

CHANGE RECUEST (EDIT ENVIRtl
3.1 •. 6-14, 3.1.6-41 3.1.6-6, 3.1.6-131 3.l.6-20,
3.1.6-411 APP.A, 3.1.6-151 3.1.6-43
CHANGEC GPTICN OF STAT COMMAND

3.3.2-lt 3.3.2-3, APP.A

ISLE CHANNEL CCHMANO WORD)

CHANNELREtU~ST!SCRIPT ENVlR,)

3.~.2-11, 3.5.4-21 3.5.S-l, 3.5.6-1, 3.5.7-11 3.5.8-1

CHANNEL ADDRESS WORD ICAWI
3.3.2-35 1 APP.A-5
CllANNH

3.1.13-9, 3.1.13-61 3.l.13-10

C0~1MANOCOCE

CHANNEL COMMANIJ

wU~D

3.3.0-1 1 3.3.2-lr 3.3.2-101 3.3.2-21, 3.3.2-34r

3.1.11-2
ICChl

3.1.2-1, 3.1.11-2, 3.l.ll-6, 3.3.2-10, 3.3.2-11,/

6-1-68

6-1-68

I 1.

636

~;u

6 -

7

£37

5 -

CHM4NEl END

3.5.4-2

CHAN~EL STATUS WORD

CCSW)
3.3.2-35, APP.A-5

3.3.0-1, 3.3.2-1, 3.3.2-11, 3.3.2-21, 3.3.2-34t

CKEOF~ACRO-INSTRUCTION

3.4.1.2-1
3.4.1.2-9, 3.4.1.2-1 THRU 3.4.1.2-3, 3.4.1.2-7,

3.2.3-11 3.2.3-21 APP.B-15

CLOSE CONSOLE FUNCTION
4.l.8-1 1 APP.A-1

4.1.2-lt 4.1.5-2, 3.4.4.1-21 4.1.0-lt 4.1.2-2,

CLOSE MACRO-INSTRUCTION).4.l.2-l

3.5.13-1 THRU 3.5.13-3
MA~UALCHS PRCGRAM LOGIC

3.4.1.2-8
CLEAR OPT IONISEE LOGOuT COHMANDl
3.4.1.2-1 THRU 3.4.1.2-20

CMS-NUC FILENAME

2.2.2-1

CHECK MACRO-JNSTRUCTIONCMS LOGOUTCMS MACnus

CMS tWCLEUS . GLOSS, l.0.0-3, 2.1.0-1, 2.l.0-2, 2.2.2-3, 3.2.2-2, 3.2.2-3,
3.3.2-i6, 3.3.2-32, 3.4.1.1-11 3.4.1.1-1,, 3.1•• 1.2-19, 3.s.1-1, 3.5.1-2,
3.5.13-l, 3.0.c-1, 3.0.0-2, 3.5.13-2, 3.5.14-1, 5.4.0-1, 5.4.0-2,
GLOSS-11 GLOSS-4

CHARACTER-DELETE SYliGOU@>GLOSS, 2.2.3-1, 6.0.0-6, 3.1.6-31 3.1.13-2
3.3.2-21 3.4.1.2-161 3.4.1.2-171 3.4.4.1-2, 3.5.2-lt 3.5.5-lt 3.5.6-11
3.s.1-1, 3.s.a-1, 4.1.0-1
CHARACTER SET....... '!SEE LOGIN COHMANDl

ms LCGIN

3.4.l.l-3, 3.4.1.1-41 3.4.1.2-20

CHS SERVICE ROUTINE

2.3.0-1, 3.3.2-33, 3.4.1.1-1, 3.4.1.1-3

CHS SUPERVISOR CALL

(SEE Cl-'S SVC I

CHS SVC
2.3.0-31 ~.3.0-11 3.3.1-31 3.3.1-4, 3.3.3-1, 3.3.4-lt 3.3.4-2,
2.3.9-1, 3.3.0-l, 3.3.1-3, 3.3.1-4, 3.3.3-1, 3.3.3-3, 3.3.4-1, 3.3.4-2,
3.3.4-4, 3.4.1.1-3, 3.4.l.l-4, 3.4.1.2-1, 3.4.1.2-2, 3.4.1.2-1,
3.4.1.2-14, 3.4.l.2-16, 3.4.1.2-191 3.3.3-3

CLOSING FlLES
2.1.c-4, 3.1.a-1. 3.1.a-2, 3.1.10-4, 3.2.1-2. 3.2.4-2,
3.2.8-3, 3.3.2-27, 3.4.1.1-1, J.4.1.2-2, 3.4.1.2-13, 3.4.2-81 3.4.2-10,
3.5.e-1, 4.1.2-2, 4.1.5-2, 4.1.e-1, APP.A-2, 3.1.13-6, 3.1.13-241

3.1.13-32

CMSREG HACRO-INSTKCCTION

3.4.1.2-10, 3.4.1.2-2

CHSTYP( MACRC-INSTllUCT!Cf\:

3.4.1.2-15

CMSYSKEF MACKL-INSlRLCllUf\:

3.4.l.2-19 1 3.4.1.2-70, 3.4.1.2-21 3.1.11-22

3.J.6-20,

3.1.6-2~

3.1.2-1, 3.1.0-2, APP.A, APP.A

COLUMN OLPlNDbNCY

CLROVER COMMAND
3.3.1-1, 3.3.3-1, 3.3~0-l, 3.3.1-2 THRU 3.3.1-4,
3.3.4-3 1 3.5.6-lt APP.A, APP~B

COMLllN[ CCMMANO
3.1.15-4 1

3.l.3-1, 3.1.4-3, 3.1.0 2, 3.1.1-1, 3.l.l-2t 3.1.3-2,
3.l.15-~, APP.A, APP.A-1, APP.B

CLl'MAND CA!l.D

3.1.11--2

CLOS ro co;:lHArW

CMS(SEE CAMBRIDGE HCNITOR SYSTEHICMS CARO FORl·:AT

CCMHAf\:D lNVIRONHENT

3.1.0-11 3.l.4-1 1 /,PP.fl-1

CHS COHHANDS 2.3.2-1, 2.3.0-l THRU 2.3.0-3, 3.0.0-11 3.0.0-2, 3.1.0-l, 3.1.2-1,
3.1.a-1, 3.2.0-1, 3.2.e-1, 3.3.0-1, 3.3.2-32, 3.4.1.1-3, 3.4.1.2-1,
3.4.1.2-12, 3.5.l-l, 3.5.1-21 3.5.3-l THRU 3.5.3-4, ].5.5-11 3.5.6-l,
3.5.7-1, 3.5.B-11 3.5.10-1, 3.5.14-lt 4.0.0-1, 5.1.0-lr 6.0.0-11 GLOSS-1,
GLOSS-4, APP.A-1 THRU APP.A-4, APF.8 1 APP.D-3 1 APP.B-41 APP.B-15
CMS COFl'.AND ENVlRONl\F.Nl' 2.2.2-3, 2.3.0-l. 2.3.0·-3, 3.0.0-2, 3.1.6--10,·3.1.6--311 3.1.13··2 THRU 3.1.13-5, 3.1.13--7, 3.1.13-111 3.1.13-12,
3.1.13-191 3.1.\4-3, 3.1.17-4, 3.1.10-1, 3.3.2-5, 3.3.2-26, 3.3.2··32,
3.3.2-33, 3.3.4-3, 3.4.1.2-9, 3.4.1.2-10, 3.S.2-11 3.5.5-1, 3.5.6-1,
3.5.1-1," 3.5.0-1, 3.5.9-1, 3.s.10-2, 3.5.111-l, 4.1.l-lr 4.2.0-1, s.1.0-1,
GLOSS-4 1 APP.A-lt APP.A-31 APP.A-5 THRU APP.A-8
CMS FILE SIZECMS FUl\CTIONS

cor~MA~O

COl'.PILATICN

c~s

COMMAND [NVlRCNHENT)

3. 0. 0-1

COMPACTING ROUTINE

3.5.11-l. 3.5.10-1, 3.5.10-2

l.0.0-3, 3.4.2-l THRU 3.1,.2-4 1 3.4.2-7, 3.4.4-1, 3.4.4-2

COMPILER
3.4.2-1 Tl'RU 3.4.2-.;, 3.1,.1,-1 THRU 3.4.4-3 1 3.4.4.1-2, 3.4.4.1-3
5.5.0-5, APP.h-2, APP.0-151 3.l.19-1

CONCAT[NATIUN

3.l.l-2 1 APP.A-1

CCNDITION COCE

3.3.2-21, 3.5.4-2

ccr~ SOLE

2.1.c-4

NAM[

!Sll

!SH: TERMll\All

CCNSOLE FLNCTIONGLOSS, 4.0.0-11 4.2.0-l, 2.2.2-1, 2.2.2-3, 2.2.3-1, 2.3.0-l,
2.3.0-3, 3.5.9-1, 6.0.0-1, 3.1.11-3, 3.3.2-1, 3.3.2.-21, 4.1.0-1, 4.1.3-lt

GLOSS, 3.3.0-l, 3.4.1.1-3, GLOSS-4

CMS INITIALIZATION
2.2.2-3, 3.5.13-2,3.1.7-2, 3.2.2-2, 3.2.2-3, 3.3.2-261
3.3.Z-32, 4.2.0-11 5.4.0-l, 5.4.0-2t APP.A-5•
1111'•"'1111<111011'11111"'"!111111""'11!11111"1111111!11111111111G•1 ~!l!!!'!i!!!!!'!!!!i!IJlll!l!!r!''l!l!l!l'!!'!l!!!"!!!lll!l!I!!

'··--""'/

"'

~
,,

~

~

""
6-·l-6B

/}J'/

1 -

.b37

6-1-6s ;3.4.1.1-4, 3.4.1.2-8, 3.4.1.2-11, 3.4.4-4, 4.0.0-1, 4.1.1-J, 4.1.4-1,
4.l.t-2, 4.l.5-1, 4.1.5-2, 4.1.13-1, 4.1.13~2 1 APP.A-5, APP.8-3,
3.5.9-Z, 6.0.0-1

4.l.4-2, 4.l.4-3, 4.l.5-2, 4.1.5-3, 4.1.7-1, 4.1.13-2, 4.2.0-2, GLOSS-l
THRU GLOSS-41 APP.h-1, i\PP.0-15, 3.5.10-2
CONSOLE TYPEl!RlHR

CONSOLE USERCP(SEE TEIU·l!Ni\L)

1 •. 0. 0-2

CON TI NUA TI ON CAllD
CONTP.OL BYTELONTROL CHARAClfR

3.l.l~-1

CU~RENT

CP/CMS SYSTEM

3.:1.11-2, 3.1.11-6

CCNTRCL CARD
3.1.11-7,
3.4.4.L-3, APP.A-4(SEE CONTROL PRCGRAM).CP ISEE

3. 1. 6- 7

PAGE CONTROL)GLOSS, 2.2.2-1, GLOSS-2, GLOSS-4 1 3.5.10-1

CP LOGIN(S~E ALSO LOGGING IN)
GLOSS-4

THRU 3.1.17-4, 3.4.4-l THRU 3.4.4-3,!SEE ALSO LOGGING OUTI 2.2.2-3, 2.2.2-1, 3.2.2-2, 3.2.2-3,
3.3.0-1, 3.3.1-1, 3.3.3-1, 3.3.4-3, 4.l.2-21 4.1.0-l, 4.2.0-l, 5.4.0-1,
3.5.10-1

CROSS-REFfRENCE SYMOCL TABLECONTROL PP.OGP.All. CChSOL[ rt.;ric TIOfl

csw

ISEE CCNSCLE FUNCTION)

PR('G!:A:~ E!NV!f\OIH\U\T2.2.2-3, 2o 3.0-1 THf~U 2.3.0--3t 3.!1.10-2, 3u5. L0-2,
2.3.2·-Jr 2~3.3-lt ?..3.11-lr 2.3.5--1, 2.~.6-11 2o3.7··lt 2d.fJ-l, 2e3.9-lt
3.3.2-12, :i:.3.?.-16, 3.3.?-21, 3.1•• 1-4, 3.5.'J-l, 3.~.6-1, 3.5.7-l, 3.5.0-·l.
4.0.0-1 1 i1.,l.C--l, 4.l.J.-1 1 '•·l.6-1, 't.2.0-1 1 /1PP.f,-3, /\PP.A 5

CCNTRCLGLOSS, GLOSS-2, GLOSS-3

CPU.

ISEE CENTRAL PROCESSING UNIT>

CPU TIM[GLOSS, l.C.0-1, 3.3.2-32 1 3.3.2-33, 3.4.1.1-11 3.4.2-111
3.4.4.1-4, 3.5.13-2, GLOSS-2, GLOSS-4, 3.5.10-1, 3.5.10-2, 4.l.15-1,
4. l.15-2

CSh K[CUEST

c

COHE

2.0.0-l, 2.1.0-1, 2.2.2-3 1 2.2.3-1 1 2.3.0-1

CUAAl-1'.T PSW

3.3.2-21, 3.3.2-23 1 3.3.2-36

3.1.s-1, 3.1.5-2, 3.3.2-21, 3.5.4-1, 3.5.4-21 3.5.11-1

ISE[ DELETE

Rl~UESTIC OPTICN OF STAT COMMAND(SEE CORE STORAGE!

CATA Ct-ECK Kl:Y

COH(-IHAGE Form
3.2.0--1, 3.2.l-l nmu 3.2.l-3, 3.2.11-1, 3.5.l-lt 3.5.1·2,
APP.fl-2 T1mu APP.A-4, 3.0.0-1, 3.0.0-7.

LAT A- Pl '0Nf:

RESICENCE

l.0.0-3, 3.2.0-1, GLOSS-1

CORE STORfl(,ll.:o.0-1, l.0.0·-7 1 7.?.?-3 1 3.0.0-1, 3.1.3-2, 3.~.ll-6 1 3.l.l?-3 1
3.2.0-11 3.2.1--1, 3.2.l· 7, 3.7.3-1, 3.2.3-?, 3.2.3-5, 3.?..3-<1, 3.2.'1··113.2.4-2, 3.1.~-1, 3.Z.~-2, 3.2.6-1, 3.2.6-2, 3.2.1-1, J.2.1-2, 3.2.0-1
THRU 3.2.fl--3,

3.3.0- l, 3.3.1-3, 3.3.l'"'."'•• 3.3.2-5, 3.3.2-t., 3.3.2-10 1

3.3.2-16 H!ltU 3.3.7-101 3.3.2··26, 3.3.2-32, 3.3.2-42,

3.:~.2-1,3,

3.3.4-2,

3. 5. 11-·l?.. ?.. l-6

2. 2. o- l ' 2. 2. 0- ;> • 2. 2'. 1-1 ' 2. 2. 2- l

CAfA SET REF[KENC[

CORE LOCATION
3.3.2-2, 3.3.2-5 THRU 3.3.2-7, 3.3.2-10 THRU 3.3.2-161 3.3.2-21
TllflU 3.3.2-73, 3.3.2-2f' lHf~U 3.3.2-30, 3.3 .. 2-37.t 3.3.2-311 ltf:rn 3.3.2·-1101
3.3.2-42, 3.3.2-43, 4.1.1-2
COl~E

3.1.13-20, 3.1.13-7

CURRE~f LINE
3.l.6-41 3.1.6-10, 3.1.6-11, 3~1.6-14 THRU 3.1.6-17, 3.l.6-28
THRU 3.1.6-30, 3.l.6-32 THRU 3.1.6-34, 3.1.13-3, 3.1.13-9 THRU
3.1.13-111
3.1.13-17, 3.t.13-13, 3.l.U-18, 3.1.13-20 THRU 3.1.13-23

COfHROLCONVEhTIONS

3.3.2-3, 3.3.2-11 1 liPP.A

CUltRINT PAGE CCNTIWLCYLINDER

3.,l.13-3, 3.1.13-5, 3.1.13··1!:> THRU 3.lul3··27, 3.3.2-1, 3.3.2-!i,

3.i1.1-1, 3 •. 4.1-21 3.4.1-5, APP.B-15

tSEE CHANNEL STATt;S \o.OROJ

CONTHOL SECTICN u::.nE
3.1.16-·l nmu 3.1.16-·'·· 3.2.1-1, 3.~.3-l, 3.2.3-6,
3.2.5-7, 3 .. ,2.6-1., 3.2.(,·-?, 3.217-2, 3.2.!l-2 THRU 3.2.a-1, 1, !J.3.0-1,,
5.4.0-2 1 A~P.A-4, APP.B-3~iCRO

2.2.2-1 THRU 2.2.2-3, 3.1.11-3, 3.4.4.l-4,

CP LOGOUT

3.l.Jl-6

CONTROL PllOGf'.AM ICPl
l.0.0-1, l.0.0-2, l.0.0-3, 2.0.0-1, 2.l.0-1 1 2.2.0-1,
2.2.1-1, 1.2.1-4, 2.2.2-1 •. 2.2.2-3, 2.2.3-1, 2.3.0-lt 3.1.2-1, 3.1.4-21
3.1.4-3, :~.l.Jl-2t 3.1.11-3, 3ololl-(,t 3~lull•-7t 3.2.2-2u 3.2.2-3, 3.3.0-1
3.3.l-lt ).3.3-J.1 3.).11-31 3.5. 11-2, l1.0.0··l1 11.l.O-J, 4.l.2-lt 4ulo3-lt
4.1.5-2, 4.,1.6-1, '•·l-7-1, 4.1.,tO-l, 1,.2.0-21 5.1.0--1, 5.'i.O··l., !J.4.0-2,
GLOSS··l Tfll<ilJ GLOSS-~, .cH•P.A-1, APP.0-), 'tel.1-2, 3.l.18-l, 3.l.19-1,
3.5.10-1, ].5.10-2, 3.5.14-1, 6.0.0-11 6.0.0-8

CCNTRCL SECT I GM

a -

/;J/

N~MUER

3.4.2-6 THRµ 3.4.2-11, 3.4.2-13

CCU MACRO-INSTRUCJION

3.4.1.2-1

CCOO MACRC-JNSTR~CTJ~N

3.4.1.2-1

CCOUG COMMAND
2.3.3-1, 2.3.0-l, 2.J,0-3, 3.3.0-1 1 3.3.2-11 3.3.2-2 1 3.3.2-5 1
3.3.2-72, 3.3.7-]3, 5.t.0-2, APP.ft, APP.al.lBUC,[NYIRONMl:.NT
7.3.0-1 THHU 2.3.0-11 3.3.0-l, 3.3.1-1 1 3.3.2-1 THRU
3.3.2-44, 3.3.3-1, 3.3.4-3, 3.4.1.1-3, 4.1.1-1, 3.1.13-5, 4.1.6-1,)

6-1-68

bk

tiw

9 -

6-1-68(fl

10 -ClhGNOSTICS 3.4.1-1 TllRU 3.'1.1-3, 3.1,.1-5, 3.4.l-6, 3.11.2-1, 3.4.2-2, 3.4.4-3,
APP.B-IS

4.2.0-l, APP.A-5, APP.D-3
CtRUG REQUESTS

3.3.2-1 THRU 3.3.Z-3, 3.3.2-6, 3.3.2-10 THRU 3.3.2-13, 3.3.2-2'••
3.3.2-26 THRU 3.3.2-29, 3.3.2-H Tllf(U 3.3.2-33, 3.3.2-3\;i, 3.3.2-3CJ,
3.3.2-43, 4.1.6-1, APP.A, APP.a, APP.B-3, APP.B-9, 4.1.l-l, 3.1.13-5

CICTICNARY
3.1.10-1, 3.1.10-4, 3.1.16-2 THRU 3.l.16-4t APP.A-3, APP.A-4 1
GLOSS-3, GLOSS-4

DIRECT ACCESS FILE

3.3.2-3., 3.3.2-1,, 3.3.2-·6, 3.3.2-12 nun: 3.3.2-1'··
3.3.2-16, 3.3.2-ll, 3.3.2-21 TliRU 3.3.2.23, 3.3.2-26 1 3.3.6-28, 3.3.2-79,
3.3.2-30, 3.3.2-39, 3.3.2-42, 3.3.2-43

3.1•• 2-11, 3.4.2-12

CHlUG SYl\CIOL TABlECfBUGG!NG

f.IRECT

3.4.l-l, 3.4.2-1, 3.4.1-2, ].4.2-2t APP.0-15

3.3.2-3, 3.3.2-4, 3.3.2-6, 3.3.2-7, 3.3.2-13 THRU
3.3.Z-15, 3.3.2-17, 3.3.2-21, 3.3.2-22, 3.3.2-26, 3.3.2-20, 3.3.2-29,
3.3.2-38, 3.3.2-39, 3.3.2-42, 3.3.2-43, Arr.A

DEF RECUEST

C:ISK CCMM/.NO

CEFAUll OPTJur~

3.1.6-2, 3.1.6-5, 3~1.6-7, 3.1.6-10, 3.J.6-12
3.1.6-22, 3.1.6-25, 3.1~6-28, 3.l.6-30. 3.1.6-31, 3.1.9-1, 3.1.13-6,
3.1.13-9, 3.1.13-10, 3.t.13-15, 3.1.13-24, 3.1.13-25, 3.1.13-21, 3.2.0-1,
3.2.3-2 fHRU 3.2.3-6t 3.3.2-12, 3.3.2-14, 3.3.4-1 T~RU 3.3.4-~, 3.4.1-2 1
3•'•·1-5, 3.11.t.2-17, 3.4.2-2 lHRU 3.'•·2-4, 3.4.1,-1, 3.5.2-l, 3.5.11-1,
3.5.13-2, 4.1.1-1, APP.A-6, APP.A-9, APr.a, APP.B-3, APP.B-15, APP.D-16

CEFAULTVA~UE

rlSK Ur\IT4.1.1~-2

CELEfE CHARACTERISEE CHARACTER-DELETE SYMBCL, LINE-DELETE SVHOOL)

tlSPLAC(MENT
3.2.6-1, 3.2.6-2, 3~2.8-2, 3.2.8-3, 3.4.1.1-4 1 3.4.J.2-19,
3.4.1.2-20

3.1.6-16, 3.1.6-17, 3.1.6-4, 3.1.6-8, APP.A

CELETE REQUEST CSCRIPT EDIT ENVIR.J

3.1.13-llt 3.1.13-6
LISPLAY

C:EtCH SYfHlOL

4.l.4-1, 3.3.2-1, 4.l.0-1, 4.1.4-2, 4.1.4-3,

2.2.3-lr 3.1.6-14, 3.l.6-16t 3.l.6-25r 3.1.13-12, 3.1.13-9,
3.\.13~16, 3.1.13-20, 3.1.13-21, 3.4.l.l-l, 4.1.0-l, GLOSS-3, APP.B-1

COUBLE SPAC£ CONTROL 3.1.13-29, 3.1.13-7, 3.1.13-41, 3.l.13-4lr 3.l.f3-44,
3.1.13-46, APP.A-9

CEllMITING CHARAClER.CS

ISEE UC~BLE SPACE CCNTROLICUISEE DUMP CUNiOLE FU~CTJONl

r.U~PCO~SCLl

ISEE DELIMITER)

CEJACH CONSOLE ~UNCTION

CEVICE ASSIGNMENT

4.1.0-1, 4.1.3-1, 4.2.0-2, APP.A

3.4.2-13, 4.2.0-1

CEVICE ENO

3.5.4-2, 4.1.11-1

c:1,1G OPT ICN

3.4.l-lt 3.4.2-lt 3.4.1-2, 3.4.2-2, APP.B-15

FUNCTION

4.1.5-2, 4.1.5-3, APP.A
CU~P

OPERAND OF TAPE COMMAND
APP.C-7A,iii!!

crNSnLE fUNCTIUN

APP.A

SH CllARACTER·-UEU:TE SYIUlOL ANO LIN(-OELf:.TE SYMBOLCELIMITER

1~

ISC:E DISK)

2.1.0-1, L.n.o-<, 2.1.0-1,, 2.2 .. 2-3, 3.1.0-1, 3.1.0-?,
3.1.1-1, 3.1.2-1, 3.J.3-1, 3.1.3-2, 3.1.1,-1 llmu 3.1.1,-3, 3.1.':i-lr
3.1.6··1, 3.l.6-'t THfHJ 3.1.(,-6, 3.J.6-13r 3.l.l.·-14, 3.1.6-26, 3.1.7-l,
3.1.1--2,· 3.1.0-1, 3.1 ..1-1 nmu 3.1.9-3, 3.1.10-2, 3.1.10-3, 3.1.11-1,
3.1.12-2, 3.l.13-3, 3.l.13-5, 3.1.13-7, 3.1.13-11; 3.l.14-1, 3.1.14-2,
3. t. l '.>- l 1 Hrw 3. l. L~ - '.> , 3. t • l7- 3 , 3. 2. o- 1 , 3. 2 • 1- 2 , 3. 2. l - 3 , 3. 2. 3- 6,
3.2. 1.-·I, 3.2.4-2, 3.?.':i-lt 3.2.7-:1 1 3.3.?.-26 1 3.3.2-32, 3.1,.1-3 THHU
3.4.l-·5, 3.1•• 1.1-1, 3.1•• i.1-2, 3.1,.1.2-1, 3.1•• 1.2-u, 3.4.1.2-11, 3.4.2-4,
3.4.2-11, 3.4.4.I-lr 3.4.5-1, 3.4.5-2, 3.s.0-1, 3.5.11-11 3.5.11-2,
6.1.0-·1, GlOSS-1 THRU GLOSS-·4 1 APP.A-2 THRU APP.A-4

ISCE DEF REQUEST)CELETE RECUEST (EDIT ENVlR.)

3.1.2-lt APP.A, APP.UClSK US/\Gf

ISEE DEfAULT OPTION)

R[~UEST

3.1.~-1,

tlSK RESIOENC~ l.O.C-3, 2.t.O-l, 2.1.0-2 1 3.2.0-lr 3.4.1.1-4, 3.4.1.2-1 1
3.5.1-2, 5.4.0-1, 5.4.0-2, GLOSS-4, 3.0.0-1

CEFINE COMMAND
3.s.1-1, 3.5.1-2, 3.s.11-1, 3.5.12-1, 3.5.12-7,
APP.A, APP.A-4 1 APP.B
CEFINE

2. 2 - 2-1

CISK flLES 3.l.O-l, 3.l.0-2, 3.l.3-1, 3.l.4-lr 3.1.13-1, 3.l.13-3, 3.1.lS-lt
3.1.15-4, 3.4~1.2-1, 3.4.1.2-4, 3.4.1.2-6, 3.4.1.2-10, 3.4.1.?-12.
3.4.1.2-13, 3.4.2-4, GLOSS-1 THRU GLOSS-3, APP.A-I, APP.A-3, APP.A-4
3.5.9-1

CEFAULT ENTRY POINT
Gloss, 3.2.3-4, 3.2.0-1, 3.2.5-1, 3.2.5-2, 3.2.6-1,
3.2.7-1, hPP.A-3, APP.A-4, APP.0-3, APP.B-7

4.1.1~-1.

2. 2. 0- l t

ClRECTCRYISEE ALSC PERMANINT FILE OlRlCTorw, SYSTEM FILE ClRECTORY,TEMPORARY FILE DIP-CCTORYl
3.1.0-2, 3.1.1-2, 3.1.4-1, 3.1.5-l,
3.1.16-3, 3.1.7-1, 3.1.7·-2, 3.1.8-1, 3.1.9-1, 3.1.15-1 THHU 3.1.15-5,
3.4.1.2-5, 3.4.1.2-6, 3.4.2-7, 3.5.4-1, 3.5.12-1, 4.2.0-1, 5.1.0-1,
GLOSS-1 1 APP.A-2, 3.0.0-1, 3.5.10-1

3.3.0-l, 1.0.0-3, 3.3.2-1, 3.4.4.1-3, 4.2.0-l, 3.0.0-1

C~CK OPTICN~l!n!NC.

4.1.5-1, 3.1.5-lt 3.l.5-2, 4.1.0-1, 4.1.2-2,
3.1.l!.i-l, 3.1.0-l, 3.1.15-2 TllRU 3.1.15-5,ft· · · ·~· · · · · ·• 1 1• •1 1 1 1 1 ! !1!1! ! !1 1 1"1 1 1! !1 1 1 1 l l •!'l • ~-·1 1 1• •1 1 1"'!'!1 • • 'f'"'l l ! l l l! l! l l ! l l ! ! l!l l ! l!l ! ! l!l! ! l l l l !'!l ! ! !l l! ! ~ :~..

~~~1g;1;11;1:1a:-"~'~•'IM•1!lrn:11nM'''m_,,,,,~••_,,,,"',i'l'11ilZildlJWiii£ U£i!Q,,,,. 4#il. i!Af!U .:;::;;: .;.. I.'; Jil ;ii

I~7~7"'"••••••,J 111!\\\l-··-,.... ~~.;::µ:::..::.. ''.. · . ~:. 'if ·'!'' ~ ~·~~''""'!!Jf~~il~li;@ !,I~·~.,.,.•... "'" ........ ~:·:"1·~'1'1'~~~~'.•!·'""''l'.fi.ILl.UJJIJl•Sf,...

,,,,.,~

6··1-68

lf'..z.,6-1-68

t;Lb

11 -

12 ·-

/'/_3

ENVIRCNH~NT TRANSFER

3.3.2-5, 3.3.2-16, 3.3.2-23, 3.3.2-26, 3.3.2-27,
3.3.2-32 THRU 3.3.2-34, 3.5.5-1, 3.5.6-1, 3.5.7-1

CUHP REQUEST

3.1.4-lt 3.1.5-1, 3.1.5-2, 3.3.2-3, 3.3.2-lS THRU
3.3.2-20, APP.At APP.0-3

C:U~IPOPERAND OF 01 SK

CUHPING CORE
4.2.0-1

co1:1;Mio

3.1.4-1, 3.1.0-l, 3.1.4-2, 3.1.4-3,

APP.~-4

3.3.2-15 THRU 3.3.2-20v 4.D.0-1, 4.1.5-l THRU 4.1.5-3,'

3~3.0-1,OUMPREST cornu.rm

3.1.5-lt 3.1.0-l, 3.1.Z-l, 3.1.5-2, APP.A, APP.O

ISEE EXTERNAL CONSOLE FUNCTlOll)
EBCDIC CODE

3.3.2-30, 3.4.1.1-1, 3.4.4-3
3.4.2-1, 2.1.0-l, 2.2.1-2, 2.2.2-1, 3.l.4-2r 3.4.2-2, APP.B-15

EUtOIC OPTIONECHO CCHHAND
APP.B~.5.2-1,

2.3.0-l, 2.3.0-3, 3.1.6-3, 3.5.2-2, 5.1.0-2, APP.A,

ECHO ENVJnOIJH(flT

2.3.0-1 THRU 2.3.0-3, 3.5.2-1

EDIT CCMllAND

3.1.6-1, l.0.0-3, 2.3.0-l, 2.3.0-3, 3 .. l.0-1, 3.1.0-2,
3.1.6-2 THnu 3.1.6-43, 3.4.2-1, 3.5.3-J, 3.5.3-3, 3.5.3-5, s.1.0-1,
APP.A, APP.fl, APP.B-3

EDIT

O;VIROWH~~H

2.3.0-1 THr.u 2.3.0-3, 3.1.6-l THRU 3.1.6-7 1 3 .. t.6-131
3.1.6-22. 3.1.13-4, 3.5.13-2, 6.0.0-2

EDIT OPERAm> or srn1PT cnP:1tlf•O
3.1.13-11 3.1.0-lt 3.1.13-2, 3.1.13-5,
3.1.13-11, J.l.13· l'•t t.J·P.U··6
1t:DIT RHiUESTS

3.l.6-l, 3.1.(,·-'.J Tll:\U 3.1.6-7, 3.1.6-11, 3.1.13-'•• 3.1.13-5,
APP.A, APP.A-6 1 APP.A-7, APP.A-10, APP.A-11 1 APP.B, APP.B-9

END OF BLOCK (f00)

2.2.l-4, 2.2.1-6, 2.2.3-lt GLOSS-1

HID OF FILE IECiFl

3.1.2·1, 3.1.1,-1, 3.1.4-3, 3.l.6--t,, 3.l.6-5 1 3.l.6-·r,
3.1.6-llt 3.l.6-1'• Hlf;L 3ol.6-l7, 3.1.6-20, 3.1.6-25, 3.1.6-271 3.1.6-26,
3.l.6-30r 3.1.6-321 3.1.6-41, 3.1.11-2, 3.1.11-3, 3.1.12-1 1 3.1.12-2 1
3.1.13-4, 3.1.13-61 3.J.1.3-9 H:RU 3.1.13-111 3.1.13-13 1 3.1.13-16 HIRU
3.1.13-lB, 3.1.13-22 3.l.14-1, 3.1.14-7 1 3.1.l~-l, 3.1.15-2, 3.l.18-1,
3.1.19-l, 3.4.1.2-3, 3.4.1.2-7 THRU 3.~.1.2-9, 4.1.2-1, APP.D-3

END OF REEL IEOR)

3 •. l0

l ~-11. 3. l. 15-5' 3. l:. l ·· '·ENlRY POINTGLOSS, 3.t.L6-l nmu 3.l.16-11, 3.2.0-1, 3.2.1-1, 3.2.1-2, 3.2.3-11
3.2.3-6, 3.2.5-2, 3.2.6-1, 3.2.6-2, 3.2.7-2, 3.2.B-2 THRU 3.2.0-4,.
3.4.1.l-l~ 3.4.1.1-4, 3.4.1.2-19, 3.4.2-3, 3.~.13-1, 3.5.13-2, 5.5.0-l,
5.4.0-2, GLOSS-3 1 APP.A-4, APP.B-3, APP.0-5, APP.B-7
ENVIRCNl~EtH

2.~.0-·1 1 2.0.0-1, 2.2.1-1, 2.2.2-3, 2.3.0-2 1 3.1.6-1 THRU
3.1.6-33, 3.1.13-1 TllRU 3.1.13-4, 3.3.7.-1 Tllf!.U 3v3.2-5, 3.3.2-12,
3.3.2-13t 3.3.2-221 3.3.2-23, 3.3.2-26, 3.3.2-27 1 3.3.2-32 THRU 3.3.2-36,
4.0.0-lt 4.l.0-11 4.1.1-1, '1.l.7-1, 5.l.0-2, GLOSS, GLCSS-11 GLOSS-2,
GLDSS-4~.

EOU!SEE END OF OLOCK)

ear

ISEE END or FILE)

t:or((SEE ENO OF REEL!

ERASE COMllflNO
3.1.7-1, 3.1.0-2, 3.1.7-2, 3.1.7-3, 3.1.17-:ll, 3.4.l-3t 3.4.1-4t
3.4.1-7, 3.4.1.2-121 5.l.0-2, APP.A, APP.8

fRASE MACRO-INSTRUCf ION

3.4.1.2-12, 3.4.1.2-1, 3.4.1.2-2

ERROR CODE
3.1.1-1, 3.1.1-2, 3.L.3-2, 3.1.7-lt 3.1.7-2, 3.1.8-lt
3.1.6-2, 3.1.9-3, 3.l.10-3, 3.l.10-4, 3.1.11-6, 3.1.11-7, 3.1.12-2,
3.1.13-5~ 3.1.15-4, 3.1.15-5, 3.2.1-2. 3.2.2-3, 3.2.3-6, 3.2.4-1, 3.2.4-2t
3.2.5-2, 3.2.6-2, 3.2.1-1, 3.2.7-2, 3.2.0-2, 3.2.8-4, 3.3.0-l, 3.3.1-3,
3.3.1-41 3.3.2-·33 1 3.3.3-lr 3.3.3-3, 3 .. 3.~-7, 3.4.1-lr 3.1,.1-3, 3.4.l-4 1
3 • 4 • 1- 1 ' 3 • 4 • l • 1- 1 I 3 • 4 • l • 1-- 2 ' 3 • '• • l • 2- 3., 3 • 4 • 1 • 2. - 6 TII Ru 3 • 1, • l • 2- l.l '
3.4.1.2-10, 3.4.1.2-20, 3.4.2-21 3.4.2-4, 3.4.2-7, 3.4.4-4, 3.5.1-2,
3.5.3-2 HlRU 3.5.3-A, 3.S.lt··l 1 3.5.12-2 1 5.1.0-l, GLOSS-2, APP.A-4,
3.1.1.9-2, 3 .• J .13-6
EHROH COMPl.[TlON COO(

I SH ERROR CODE l£RMOK PESSAGE
GLOSS, 2.1.0-1 1 3.0.0-2, 3.L.1-lt 3.1.1-2 1
3.1.2-1, 3.l.3-2, 3.1.4-3, 3.1.5-2, 3.1.6-6, 3.1.6-13, 3.1.1-2, 3.l.8-2,
3.1.9-3 1 3.l.lC-2 THRU 3.1.10-4, 3.1.11-6, 3.1.11-7, 3.1.12-2, 3.1.13-5,
3.1.14-1 nmu 3.1.1 11-3, 3.1.15-4, 3.1.15-5, 3.1.16-3, 3.1.ll·-'•• 3.1.11-2,
3.l.l7-5, 3.1.10-1, 3.1.HJ-;~, 3.1.19-21
3.2.1-2. ·3.:?.7.-3, 3.2.3·-C., 3.?..11-J, 3.2.1,-2, 3.?.~-2. 3.2.b-2,
3.2.7··1, 3.2.7·"2, 3.2.£1-11, 3.3.l-'i• 3.3.3-3, 3.3.4··7, 3.4.l··l, 3.1,.1-1,
3.4.1.1-2 1 3.4.1.2-5, 3.'1.1.,2-?, ;i.1•• 1.?.-10, 3.1,.1.2-1s, 3.1•• 2-2 llllUJ
3.4.2-4, 3.4.2-·1, 3.11.4-3, :3.4.'•-'•·• 3.!>.1-2, 3.5.2-lt 3.5.3-? lHRU
3.5.3-'1 1 3.':J.11-lr :3.5.4-21 3.5.5-·l, 3.5.6-1, 3.5.7-l, 3.5,11-1 1 3.5.9-2,
3.5.10-2, 3.5.11-2 1 3.5.12-2 1 3.5.13-2, 3.5~14-1 1 5.1.0-l, GLOSS-21
Gl.OSS-4
ERROR OV[RRIDE:3.3.0-1,
3.3.4-4, APP.A-4
EVEN OOUNDAHY

3.3.l-l~

3.3.l-3 1 3.3.1-4, 3.3.J-3,

3.3.~-2

111RU!SEE HALF WORD BOUNDARY)fXEC CCMMAND
3.2.0-l, 3.5.3-1, 3.1.9-2, 3.2.6-l, 3.2.6-21 3.5.3-2 THRU
3.5.3-6, 5.L.0-1 1 6.0.G-l, APP.A, APP.A-3, APP.U
EXEC OPERAND GF LISTF~OMMAND

3 .. 1.9-11 3.1.9-2 THRU 3.1.9-4, APP.A-31 APP.B-':iEXECUTION
3.2.0-1, 3.2.0-2, l.0.0-2, 1.0.0-3, 2.1.0-2 1 2.l.0-4, 2.3.0-1,
2.3.0-3, 3.L.R·-1, 4.1.1-2, ''t.1.7-1, 3.0.0-1, 3.0.0-2, 3.5.10-1,
3.l.ll-3t 3.1.13··2 Tl!RU 3.1 .. 13-4, 3.1.13-6, 3.1.17-2 Tl-'RU 3.1.17-41
3.2.2-1, 3.2.2-3, 3.2.3-2 TllRU 3.2.3-6, 3.2.6-1, 3.2.6-2, 3.2.0-l THRU
3.2.8-4, 3.3.0-1 1 3.3.1-4, 3.3.2-1, 3.3.2-2, 3.3~2-4 TbRU 3.3.2-7,
3.3.2-21 TllRU 3.3.2-23, 3.3 .. 2-31, 3.3.2-32 1 3.3.4-1 1 3.4.1-2, 3.'1.1-1,,
3.4.l-~ 1 3.4.1-7 1 3.4.1.1-1 THRU 3.4.1.1-4, 3.1,.1.i-l Tt1RU 3.'t.l.2-3,
3.4.1.2-5 'JllttW 3,1,.1.2-7, 3.'i.l.2-9 1 3.4.1.2-11,, 3.11.2-3, 3.4.2-7,-..

6-1-68[Ir 133.4.?-0, 3.4.2-11 THRU 3.4.2-13, 3.4.4-1 THRU 3.4.4-4, ].4.4.1-3,
3.5.3-1 THRU 3.5.3~3, 3.5.5-1, 3.5.6-1, 3.5.7-lt 3.5.B-lt 3.5.11-lt
4.0.0-1, 4.1.0-1, 4.1.1-1, 4.1.4-2, 4.1.5-2, 4.1.13-2, 4.2.0-1, 6.1.0-1,
5.l.0-2r 6.0.0-1, 6.0.0-6, GLOSS-2r APP.A-2 TtiRU APP.A-5, APP.B-15

EXTENDED BCD CARO COCE

CSEE EBCDIC CODFIEXTERNAL CONSOLE ruNCTIGN
4.2.0-l, APP.A

4.1.6-l, 2.1.0-3, 4.1.1-1, 3.3.2-16, 4.1.0-1,

F

3.4.1-2

lSEE FIND RECU[ST)FCO MACRO-INSTRUCTION
3.4.1.2-4, 3.4.1.2-lr 3.4.1.2-2, 3.4.1.2-5 THRU
3.4.1.2-7, 3.4.l.2-10, 3.4.1.2-12 •• 3.4.1.2-13.Fl(SEE FILL CONTROL)

Flf:LC

3.1.1-1, 1:1.6-21 3.l.tl-2 1 3.1.12-1 1 3.l.l2-2t 3.l.14-l, 3.1.17-3,
3.2.3-41 3.2.6-1, 3.3.1-1, 3.3.1-3, 3.3.2-30, 3.3.2-35, 3.4.1.2-4,
3.4.1.2-7, 3.4.J.2-10, 3.4.1.2-17, 3.4.2-3, 3.4.4.1-2, 5.3.0-2, 5.3.0-5,
GLOSS-3

FILE OESIGNA110N
f ll E CI RFC HJllY

ISEE FlLE IUENTIFIERl!SEE OIRECTCRY)

b</S' 14 -3.1.. 4.1-1, 3.5.1-1, 3.5.1-2, 3.2.3-1, 3.5.3-3, 3.5.12-1, 3.5.12-2,
3.5.13-1, GLOSS-·2, APP.11--1, llPP.B-3 THflU APP.0-7, APP.B-9
3. 0. 0-- l t 3. 0. 0-· 2 ' 3. 1 • l CJ ·-1 t 3. 1. 19-·2.~\jFILE REQUEST (EDIT E~VIR.)
3.1.6-18, 3.1.6-8, 3.1.6-19, 3.1.6-5 THRU
3 • l. 6- 6, 3. 1. 6- 3 6, /',PP. A
FILE REQU[ST (SCRIPT fOIT ENVIRON.)

3.1.13-12, 3.1.13-3, 3.1.13- 1., 3.1.13-6

3.1.~-?, 3.1.16-1, 3.l.lG-2 1 3.2.3-6, 3.2.5-2, 3.7.7-2 1 GLOSS-2,
APP.A-3

FILETYPE
2.1.0-2, 2.1.C-l, 2.l.0-3, 3.0.0-l, 3.1.l-lt 3.l.l-2,
3.1.3-J, 3.1.3-7, J.1.11-t rtmu 3.1.11-3, 3 .. J..6-1, 3.1.t.-2, 3.1.6-5,
3.1.6-·27, 3.l.6-30, 3.l.f>-31, 3.1.1-1 nmu 3.1.7-3, ).1.n-1. 3.1.a-2,
3.1.9-1 lli:~U 3.1.9- 111 3.l.10-l, 3.1.10··7, 3.1.10·-'•• 3.1.11-1 THRU
3.t.11-1,, 3.1.11-6, 3.1.Jl-·7, 3.1.1.2-1, 3.1.12-2. 3.1.13-11 3.1.14-1,·3.}.l~-lt 3.l.15-4, 3.1.16-1, 3.}.}(,-;~, 3.1.17-1 THRU 3.l.l7-!i, 3.2.0-l,
3.2.l-·lr 3.7.1-2, 3.2.2-l lHRU 3.2.2-3, 3.2.3-1, TllHt.: 3.2.3-6, 3.2.4-1,
3.2.5-1, 3.7.5-2, 3.?.1-1, 3.2.1-2, 3.?,r:-1 nmu 3.2.u-1,, 3.4.1-2,
3.4.1-7, 3.4.1.1-3, 3.4.1.2-4, 3.4.1.2-0, 3.4.2-2 1 3.4.2-8 THRU
3,1,,7-12, 3.4.1,-1, 3,11.11.l-·1, 3.1,.1,.1-2, 3.'.i.1-1, 3.5.3-l, 3.5.3-3,
3.'.i.13-1, '.i.J.C-1, s. 1,,0··2, GLOSS-2 lHflU GLCSS-4 1 APP.A-I, f,PP.B-3 THIW
APP.B-7, 3.J.19-l, 3.l.19-2
FILL CONTROL
3.L.13-30, 3.l.13-7, 3.1.13-34, 3.1.13-3'.i, 3.1.13-44,
3.1.13-·461 3. l.13-- 117
fll.L

GLOSS

~'CIJLJ. 1. 13-21

FINO MnCRO-INSlRUCTICN

FILE lrENTlfl[R

GLCSS, 7.1.0-1 1 3.l.0-1, 3.l.0-2, 3.1.1-1, 3.1.1-2, 3.1.3-1,
3.l.3-2, 3.l".4-2, 3.1.4-3, 3.1.6--1, 3.1.6-;>, 3.1.6-4, 3.1.6-·5, 3.l.6-21.lt
3.1.6-29, 3.1.7-1, 3.1.0-2, :3.1.9-l THRU 3.l.9-3r 3.1.10-21 3.1.11--2,
3.1.11-4, 3.1.15-L, 3.1.15-'+; 3.1.15-5, 3.l.16-2t 3.t.17-2, 3.1.17--3,
3.2.1-1, 3,2.1-2, 3.2.2-?, 3.2.3-1, 3.4.1.2-3, 3.1•• 1.2-1.3, 3.1,.;>.8,
3.4.2-9, 3. 11.2-11 1 3.11.2-13, 3.4.4-3, GLOSS, GLOSS-2, hPP.fl-J, APP.f1-J,
APP.£1-3, 6.0.0-l

FILE MANIPULATION

6-1-68Fl(E Sill

EXTERNhL INT~RRUPT
3.3.2~1, 3.3.2-2t 3.3.2-16t 3.3.2-2lt 3.3.2-30, 3.3.2-31,
3.3.2-331 4.0.0-1, 4.1.6-1, 4.2.0-1, 4.1.1-1

LXTERNAL SYMOUL DIRECTORY~/(

3.1.0-2, 3.1.0-1, 3.1.6-6

flLEHCCE
2.l.0-2, 2.l.0-1, 3.1.1-1, 3.l.l-2 1 3.1.3-lt 3.1.3-7, 3.1.4-l THP.U
3.1.1,-3, 3.l.6-'tt 3.1.6-13, 3.1.7-1, 3.1.7-?, 3.1.H-l, 3.1.9-1 TltRU
3.1.1)-4, 3.1.11-1 THRU 3.J.11-3, 3.1.11-6, 3.1.11-7, 3.J.13-1, 3.1.11,..,1,
3.1.1s-1, 3.i.15-4, 3.1.1s-5, 3.1.n-3, 3.2.1-1, 3.2.1-2, 3.2.4-1,
3.2.4-21 3.2.8-4, 3.4.1.2-4, 3.4.1.2-6 1 3.4.1.7-11, 3.4.1.2-12, 3.4.2-8,
3.4.2-10 Tt•RU 3.4.2-12, Gl.OSS-2, APl'.A-1, APP.B-3 THRU flPP.0-6
2.1.0-2, ;i.1.0-1, 3.1.1-1, 3.1.i-2, :hl.J-1, 3.l.3--7, 3.1.1.-1 nrnu
3.1.1,-3, 3.1.6-1, 3.1.6-5, 3.l.6-13, 3.l.6-14, 3.l.6-20, 3.1.7-1 THRU
3.1.1-3, 3.1.e-1, J.1.e-2, 3.1.9-1 THRU 3.1.9-4, 3.1.10-1, 3.1.11-1 THRU
3.1.11-1, 3.1.12-1, 3.1.12-2, 3.l.13-1, 3.1.13-5, 3.1.11,-1, 3.1.15-1,
3.1.15-4, 3.1.16-lt 3.1.16-3, 3.l.17-1 THRU 3.1.17-5, 3.2.0-1, 3.2.l-lt
3.2.1.i-2, 3.2.3-1, 3.2.3-5, 3.2.3-6, 3.2.4-1, 3.2.5-l, 3.2.6-1, 3.2.1-1.
3.2.7-21 3.2.8-1 THRU 3.2.a-4, 3.4.1-1, 3.4.1-2, 3.4.1-7, ).4.1.1-lr
3.4.1.2-4, 3.4.1.2-8, 3.4.1.2-111 3.4.1.2-121 3.4.2-1 THRU 3.4.2-3,
3.4.2-7, 3.4.2-6, 3.4.2-10 THRU 3.4.2-12, 3.4.4-l T~RU 3.4.4-3,

ruet1Al"l:rlND KFQU!ST
3.l.6-J9,

3.1•• 1.2-1

3.1.6-?0, J.1.6-'t, 3.l.u-6, 3.1.6-8, 3.J.Ci-13, 3.1.6-25,
J.l.6-41, 3.1.<·-43, J.!.6-21, 1,Pr.1., :i.1.6-15

FINIS COMHANLJ
3.1.8-1, 2.1.0-4, 3.2.1-3, 3.1.0-2, 3.1.8-2 1 3.2.1-2,
3.2.4-2, 3.4.1.2-13, APP.A, APP.O

FINIS NACHO-JNSTHUCTIUN

3.4.1.2-13, 3.4.1.2-1, 3.4.1.7-2

flX[O L[NGTll RLCORO
3.L.3-lt 3.1.3-21 3.1.4-1, 3.1.11-3, 3.1.14-1, 3.l.15-lr
3.4.1-2, 3.4.1-7, 3.4.l.2-6, 3.4.1.2-7, 3.4.1.2-10, 3.4.1.2-11, 3.4.2-8
3.1.19-l, 3.1.19-2
flhG

3.1.14-2, 3.3.0-l, 3.J.2-30, GLOSS-3

fLOATl~G POl~T REGISlEH IFPRI
3.3.l-4t 3.3.2-1, 3.3.3-1, 3.3.4-1 T~RU 3.3.4-4,
3.4.l.2-10, 4.1. 11-l TttHU 4.J.11-3, 4.1.5-lr '1.l.13-l, 4.2.0-l, APP.B-16

l'LCW rJLUYPl

3.l.6--l

FURHAT COHMAl\O
3.5.4-l, 3.5.9-2, 3.1.7-2, 3.1.12-2, 3.5.1-1, 3.5.1-2,
3.5.4-1, 3.5.4-2, 5.1.c-1, flPP.A, APP.a, APP.B-5

fCRMAT COl\TRUL hCROS
rt'K TKhl\ CUMMANU

3.1.13-2 THHU 3.1.13-4, 3.1.13-6 1 3.1.13-7

3.4.2-1, 1.0.0-3, 3.1.19-1,3.1.10-2, 3.2.3-2, 3.2.a-2,
.

-,
j

,..
i~~Fi!JijllliiiiiC,,,,_,,.,_,,.,_..,•
1wo

11,...hi,

OilOIWllll>IMhH-iiiiiiiiih-HO'"'"""""'"-'"'''"···om•·

""'..

·~
;am
-==····-·····~.. ~·~.,,.,.,~-"'_4!!&,_,Ji§U IJii az::.

;;,,;a.;

;;,;

ii!ii

44;,;;:g;;_AIHQWA& IP¥UAU

6-1-68

/11

./A'!

3.1.6-33, 3.1.6-39, 3.1.6-1, 3.1.6-9, 3.1.9-2

FORTRAN FILETYPEFORTRAN IV LANGUAGE
FORTRAN IV LANGUAGE

3.4.2-4, APP.A-2
HANUA~

3.4.2-4, 3.4.2-9, 5.1.0-2

FORTRAN IV LIBRA~Y SUOPRUGRAHS MANUALFORTRAN lVIGl PROGRAMMER'S GLIDE MANUAL

6-1-683.4.2-4
3.4.2-4

ISEE FLOATING POINT REGISTER)

CPR RECUEST

3.3.2-3, 3.3.2-24, 3.3.2-25! APP.A

wPRS OPTICN

3.3.4-lt 3.3.1-41 3.3.4-2t 3.3.4-3, APP.8-16

GPRSA CPTION

3.3.4-1, 3.3.1-4, 3.3.4-2, 3.3.4-3, APP.B-16

CPRSLI CPTlON

3.3.1,-1, 3.3.1-4, 3.3.4-2 THRU 3.3.4-51 APP.B-16~Alf

WCRD OUUNOARY~ALT

1/0 lNSTRUCTICN

3.3.2-4 THRU 3.3.2-6, 3.3.2-22
3.3.2-11

ISEE H[AO CONTROL).HE

J.1.13-31, 3.1.13-7,

FPRS CPTICN 3.3.4-l, 3.3.1-4, 3.3.4-2 1 l.PP.0-16l•[AD CCNTROLFPllSA OPTIONh£.XACECIMAL R[PRESENTATICr\

FPflSl:I

3.3.4-1, 3.3.1-4 1 3.3.4-2, 3.3.4-4 1 3.3.4-5, APP.B-16

CPTlON

3~3.4-1,

3.3.1-4, 3.3.4-2, APP.D-16

FREEMAJN MACRU-INSTRLCTICN

3 • 11 • lo 2-1

fR[[PCCL Mf1CRO-· IN!) rn.1.,c TI cr1

3.'i.1.2-·l

FULL hCRO BOUNUARY

3.3.2-16, 4.1.4-2, 4.1.5-2, 4.1.13-2

G CPUci'lW OF Cfl.'<NGE RC.QUE ST

3. l. 6-1 '•Gl N CPERMHl OF 11/'ICL I[! CmlMAND
i'IPP.0-(,
Gf.N Ol'ERM-.D CF TXTLI 0

COMl~Mlfl

G£:NERAL PURPUSL REGI'.:>lEI:GENMUOCOMMAND

MACkU-INSTRUCTIO~

3.1•• 1.2-1

GETHAIN HACRC-INSTRUClIGN

3.4.1.2-1

GETPOOL MACRO-INSTRUCTION

3 • '•. 1. 2-1

GLCBAL COl!MAND
APP.O
GU OPTION(SEEPlRPOS~REGISTER)

l~CLUOE

CCNTkULll•CLLJL;f:SECTIU~

CARD)

3. l. 11-4

IM£1[0 CONTi{CL)CflNTROL

IS[I3~1.13-3;°>1

3.1.13-b, 3.1.13-7,3.1.13-24

INUENT CUNTROLl
CCNll1UL SECllCN lllSI CARD

INIJ£.Nr CONTRCI.
INDEX NUMBER

s.s .• 0-3,·5.s.o-4, 3.2.3-·5, 5.5.0-1

3.1.13-33, 3.l.13-4u 3.t.13-7, 3.1.13-37
3.l.lC-3, 3.l.16-2

lNlllAl PROGMAM LOAD (IPL)
4.1.7-lt 2.2.2-3, 2.3.0-3, 3.5.14-lr
3.3.2-27, 3.3.2-32, 3.5.4-l, 3.s.11-1, 4.0.0-1, 4.1.0-1, 4.1.6-l,
4.1.12-1, 4.?.C-1 1 5.1.0-l, APP.A
Jt>.illlfllll!Nl> CMS

INPUT

3.1,.2-1, 3.4.2-2 TllflU 3.11.2-4, 3.4.2-7, APP.B-15!SEE GENERAL

3.3.2-2, 3.3.2-4. 3.3.2-10, 3.3.2-11, 3.3.2-16,

3.5.4-11 3.S.4-2

IDE"lTlfICATJCN CARD ICPI
• If'

3.2.0-2, 3.2.2-1, 2.3.2-2, 3.2.2-2 1 3.2.2-3, 3.4.1-3, APP.A,

GO RUJt;lSl
3.J.2-1 1 3.3.2-3, 3.3.2-5, 3.3.2-l,, 3.3.2-21 THl\U3.3.2-23, 3.3.2-33, APP.A
GPR

ISi:~

ILS

3.l.16-l, 3.1.0-1, 3.l.16-2, APP.U-7

3.2.0-1, 3.2.1-1, 3.2.1-2, 3.2.1-3, 3.2.1.-1. 3.2.11-2,

APP.A-9!SEE INPLT RFUUEST, INSERT REQUEST, IPL CUNSOLI: FUNCTICNl

JMPFI

APP.A, M,l'.E\

GET

t·L/l.c l\f:llRl:SS.IN

2.3.0-3, 3.2.1-2,
3.2.6-l, 3.2.6-2, 3.2.fl-2, 3.2.8-3, 3.3.0-lr 3.3.J-3, 3.3.l-·4, 3.3.,2-·lr
3.3.2-16, 3~3.2-17, 3.3.2-2lt 3.3.2-24~ 3 .. 3.2·-33, 3.3.2-3'tr 3.3.2-36,
3.3.3-1, 3.• 3.3-3, 3.3.',-l Tlmu 3.3.'1·.Ji, 3.1•• 1.2-1n, 1•• 1.1,-1 t11nu '1.1.1,-3,
4.1.5-1, 4.1.13-lt 4.l.13-2, 4.2.0-1, GLOSS-2, APP.A-4, APP.A-~, APr.a-16

3.1~13-441

3. 3. 2- 3 l

3.1.10-1, 3.1.0-1, 3.1.10-2, 3. l. 10-3' 3. l • '·- 3'

IGPH)

16 -

{'/7

lS -

3.3.2-5, 3.3.2-a, 3.4.2-2 THRU 3.4.2-13, APP.A, APP.a, APP.B-15

FPR

~-

~

I":

t.o.o-3, 2.0.0-1, 2.2.0-1, 2.2.1-1, 2.2.1-3, 2.2.1-1, 2.2.2-1, 2.2.3-1,
2.3.0-:1 Ttmu 2.3.0-3, 3.1.0-1, 3.1.2-1, 3.1.3-1, b.0.0-1,
3.1.3-2, 3.1.4-2, 3.l.b-l TtiRU 3.1.b-Or 3.1.6-1~, 3.1.6-17, 3.J.6-18,
3.1.6-23, J.t.6-27 lltRl.i 3.l.6-3l1 J.l.10-2 TllRU 3.1.10-4, 3.1.ll-l THRU
3:1.ll-3, 3.l;ll-6, 3.3.2-lo 3.3.4-3, 3.4.1.2-41 3.4.1.2-51 3.~.l.2-7,
3.4.1.2-16, 3.'1.2-0, 3.4 •. 2-9, 3.4.1,-2, 3.4.11.1-2, 3.5.2-1, 3.5.7-lt
4.1.0-lr GLOSS-2, GLOSS-4, APP.A-31 APP.D-1)t;PUT CllAHAC. 11' I{
INPUt(SEE CMS INITIALIZATION)

ENVIRL~MENT

3.1.6-7, 3.} .. 6·-10, '1.l.6-20, 3.l.6-30
2.3.0-11 2.3.0-3, 3.1.6-lr 3.l.6-3·THRU 3.1.6-71 3.l.6-9,

_.,.

~

""'
6-1-68tlr 17 -\~6-1~6~ .

hirlf'L REt;;UEST

3.• 1.6-22, ).l.6-23, 3.1.6-39, 3.1.6-34· THRU 3.1.6-36, 3.1.13-4
INPUT FILE
3.1.3-1, 3.1.3-2, 3.1.6-51 3.1.10-4, 3.1.11-lt 3.1.13-11 3.1.13-41
3.4.1-21 3.4.1.2-4, 3.4.2-2, 3.4.2-31 3.4.2-8 1 3.4.4.1-1(INPUTl) FILENAME

3.1. 13-'4

FILENAME

3.1.13-4(l~PUT21

lNPUT/CUTPUT 11/0l
l.0.0-2, 2.2.0-1, 3.1.2-1, 3.1.6-5, 3.1.15-4 1 3.4.2-0,
3.4.2-11, 3.1•• 2--12, 3.11.4-3, 3.4.'1.1-1, 3.5.0-1, 4.0.0-1, 4.1.2-11
4.1.3-11 4~1.7-1, 4.1.11-lr 4.1.12-1, 4.2.0-l, GLOSS-1, GLOSS-3, APP.A-I,
INPUT/CUTPUT DEVICE

3.3.2-111 3.5.4-2, 3.5.0-1(l/O ERROR!
3.1.3-2 1 3.1.4-3 1 3.1.5-1, 3.1.7-2, 3.l.ll-6,
3.1.11-1, a.1.12-2. 3.1.13-~, 3.4.1-2, 3.4.1-4, 3.4.1-1, 3.4.2-4,
3.4.4.1-2, 3.1.10-1, 3.1.13-6, 4.2.0-1, 5.1.0-1

l~PUT/CUTPUT

Jr;PUT

3.l.6-23 1 3.1.6-24 1 3.1.6-B, 3.1.6-39, APP.A

fl;SFP.T RECUEST !5CRIPr EDIT ENVIR.)JNSTl:UCTICN LENGTH

3.1.13-14, 3.1.13-7

3. 3. 2-3 l

INTERRUPT
1.0.0--2, 2.3.0-3, 3.3.2-1, 3.3.2·-2, 3.3.2-Sr 3.3.2-16,
3.3.2-21, 3.3.2-22, 3.3.2-30, 3.3.2-31, 3.3.2-33, 3.3.2-34, :-s.3.2-::16,
3.5.5-1, 3.5.6-lr 3.5.7-1, 3.5.B-lr 4.1.6-1, 4.1.12-1, 1,.2.0-1, APP.A-5,
INTERRUPT COCE
(SEE

I /G ERROR'•. 1. 13-3!~PUT/OUTPUT)(SEE

110 I NTERRUP fl-CN

1/0 OPERATIONl PL UJl-l11ANOKHP REQUESTERROR)

3. 3. 2-11~. 3. 2- 11 '3.S.14-1,

3.1.13-15, 3.1.13-7
3.3.0-1, 3.3.1-1, 3.3.2-1, 3.3.3-1, 3.3.4-3, 3.5.6-1, APP.A, APP.D

KT .COHMANO

3.1.12-11 3.3.2-1, 3.5.7-1, APP.A, APP.a

KX COl'IJANOKXIHOUEST

3.4.l-4, 3.5.B-l, 6.0.0-l, 6.0.0-5, APP.A, APP.B
3.3.2-1, 3.3.~-3, J.3.2-22, 3.3.2!27, APP.A!StE LOCATE REQUEST, LOGCUT CGNSOLE FUNCTION)
LABEL

3.1.14-l, 3.1.14-2, 3.1.17-1, 3.4.1.2-1, 3.1,.1.2-4 THRU 3.4,1.2-7,
3.4.1.2-9, 3.4.1.2-10, 3.4.1.2-12 T~mu 3.4.1.2-14, 3.4.1.2-16, 3.4.1.2-11,

3. 4. 't- 3, 3,. 4 • 't. 1- 1 fl IR U 3 • 4 .. '1 o 1- 3

3.4.J-l, 3.4.1-2, 3.4.1-3

UH ACJUSTMENT

3.3.2-3, 3.3.2-12, 3.3.2-34, 3.3.2-38

LENGTH ATlRl!lUTE

3.3.2-12, 3.3.2-14, 3.3.2-42, 3.3.2-43

Ll'llc OPT!liN

3.2.3-2, 3.2.3-4 HIRU 3.2.3.-6r APP.U-15

Lil1NA11f.
3.1.10-1 THRU 3.l.10-4, 3.1.16-1 THRU 3.1-.16-3, 3.2.2-1, 3.2.2-2,
3.2.3-1, 3.2.3-2, 3.2.3-4 THRU 3.2.3-6, 3.2.5-1, 3.2.7-1, 5.4.0-l,
5.'1.0-2, APP.8-5 TllHU APf>.B-7.
llllflARY Fill

3.l.0-2, 3.2.2-1 TllRU 3.2.2-3, 5.4.0-l, GLCSS-4,. llPP.A-4,

3.~.q-1,

APP.A-2, APP.U-5

IPL CCN50LE FUNCJION
4.l.7-1, 2.2.2-3, 2.3.0-3, 3.5.4-lr 3.5.13-2, 3.5.9~1,
3.5.14-lr ~.O.O-lr 4.l.0-1, 4.1.1-lr 4.1.6-1, 4.1.12-lr 4.2.0-1, ~.l.0-1,
6.0.0-1.
.

APP.B--3

LINf-OELETE SYMDOL l~l
GLOSS, 2.2.3-1, 3.1.13-2, 3.1.13-4,
3.3.2-2, 3.4.1.2-16, 3.4.1.2-17, 3.4.4.1-2, 3.5.2-11 3.5.5-1, 3.5.6-1,
3.5.7-l, 3.5.0-l, 4.1.0-l, 6.0.0-4
2.2.1-6

LINE IDENTlflt:R
llNf:

3. 3. 2- 3 l

2.2.3-1, 2.3.0-2

KO CU11 MAND

LINE FEED KEY

INPCT/O~TPUT

CSEE KE, KC, KT, KXI

3.1.12-1, 3.3.2-1, 3.5.5-1, APP.A, APP.A-3, APP.OLDISK OPTION
3.1.13-13, 3.1.13-2, 3.1.13-31 3.l.l3-7!SEE CARU STREAM)

STREM~

INSflll REC:ULST (toll u.;vrn.1

l/G

KE CO~HANO

3.l.6-22, 3.1.6-8, 3.l.6-4, 3.1.6-6, 3.1.6-23,

INPUT REQUEST !SCRIPT EDIT ENVIR.I

3.4.2-4

JUSTIFICATION
3.1.13-16, 3.1.13-19, 3.1.13-21, 3.1.13-22, 3.3.2-3, 3.3.2-12,
3.3.2-34, 3.3.2-30, 4.1.2-11 4.l.13-2, 4.1.13-3, 5.3.0-2, 5.3.0-4, 5.3.0-5
3.1.13-26, 3.1.13-30, 3.1.13-35, 3.1.13-46

ERR~R

INPUT REOLEST ( EDIT ENVIM.)
3.1.6-36, APP.A

l ll

3.3.2-26, 3.3.2-1, 3.3.2-3, 3.3.2-12, 3.3.2-22, 3.3.2-33, 3.5.Q-l

JOO CCNTROL LANGUAGE

K-LEVEL COMMANDINPUT LINEGLOSS, 2.2.1-1, 2.2.1-4, 2.2..1-6, 2.2.3-1, 3.1.3-L, 3.1.6-1
TllRU 3.1.6-01 3.1.6-15, 3.1.6-17, 3.1.6-10, 3.1.6-23, 3.1.6-2'•• 3.1.6-27
THRU 3.1.6-311 3.1.13-1 1 3.1.13-2, 3.2.8-1 1 3.3.?-2 1 3.4.1-2, 3.4.1.2-16,
4.l.0-1~ 4.1.4-21 4.1.5-21 GLOSS-1 THRU GLOSS-3 1 2.3.0-1 1 2.3.0-2,
3.0.0-1, 4.0.0-1, 3.0.0-2

f/y

LENGTH

3.1.6-2, 3.l.6-15, 3.1.6-20, 3.1.6-25, 3.1.6-20, 3.1.6-31

3.1.13-161 3.l.l3-:t7, 3.1.13-19 THRU 3.1.13-21, APP.A-9

l.INf: LENGTH CONl"IWL
l I NI. NL'MllC I(

3.1.13-34, 3.1.13-7, 3.1.13-44, 3.1.13-46

3.1.l?.·-l., j.l.12-2,, APf'.11-3, APP.D-10

"'·

/so·

(,-J-68l lriEllO OPU:,\t;D/;Cl
LOCATE REQUEST (SCRIPT EOll ENVlR.I 3.l.13-16, 3.t.13-7
LOGGING lN

2.2.2-l, l.O.O-?., 2.0.0-1, 2.2.0-lt 2.2.1-3, 2.2.1-6, 2.z.1-1,
2.2.2-2, 2.2.2-3~ 3.1.11-2, 3.5.1-1, 3.5~4-l, 4.0.0-lt 4.1.1-1,
4.1.10-lt 4.l.10-?., 4.2.0-l, 5.1.0-l, 6.0.0-1 1 6.0.0-2, GLOSS-4, APP.0-3

3. 11.1.2-.1

llHl~AG(GLOSS, 3.2.0··l, 3.2.3-lt 3.7.3··5, 3.2.3-li, 3.2.!>-1 1 3.2.~•-2, 3.2.7-1,
3.2.7-2t 3.4.l.l-3t 3.4.l.l-4t ).4.1.2-1, J.4.l.2-lt 3o4vlo2-12v
3. 11.l.2··131 5.3.0-lt APP.f,-3, hPl)./,-·'1

USl OP::ru:w

ur- l:t·.Cllfl C01\:\f.llD

3.1.10·-I., 3.J.0-2, 3.Ll0-3. 3.l.10·-!i,l lST OPCl:Mw OF TXTLHI CCJllM!dm
APP. [I·· 7

U~lf

nmu :i.1.1i:,-~,.

3.3.2··5, 3.3.2-6, 3.11 .. l-ft 3.'t.2-1 1 3.'t.l.··2 1 3.t,.2-3·,

LOGICl\l SbITCllt l l [IUiL

3. 5. 3-2

LOGICAL TAB C.HARACTER (~)
3.1.6-2 Tllnu 3.l.6-5, 3.1.6-7, 3.1.6-llt 3.1.6-15,
3.1.6-20, 3.l.6-23, 3.l.6-25, 3.1.6-26, 3.1.6-33, 3.1.6-30, APP.A-7/\PP~D-l!i

CCJ:n'.t.tW
3.0.C-J, 3.l.0-2t 3.1.6-6, 3 .. 1.<J-2 lH~U 3.l.9·· 1. , 3.l.15·-2r
3.2.0-1,, 3.5.1:--21 3.5.3-1, 3.~.3-3, 3.!i.10-·l. 1 3.5.10-2 1 6.0.0··l, ltl'P • .t.,
Arf>.B.
.

USTlr\G FlLETYPE~LL

3.1.16-t, 3.1.0-2, 3.1.16··2

LOGGING OUT 2.2.2-1 THRU 2.2.2-31 3.l.2-lt 3.2.2-2t 3.2.2-3, 3.3.0-l, 3.3.1-lt
3.3.3-1, 3.3.4-3, 3.~.0-1, 3.s.11-1, 4.1.2-2, 4.1.0-1, 4.z.0-1, 5.4.0-1,!'>.4.0-2, 3.5.10-1 1 3.~.10-21 6.0.0-l, GLOSS-4, APP.t-3, APP.A-5,
LOGICf\L Cll\CKSf'hCl' Ctlllf'.l\CTrn 1~:,,3ol.6-lt 3.1.6-3 THP.U 3.1.6-51 3.1.6-9,
3.l.6-15, 3.l.6-25, 3.l.6-28r 3.1.6-29, 3.1.6-33

3.1.12-2, 3.4.1-3, APP.D-6

llST Of>TIOfl

lOGlCAl TAB SETTINGS
3.l.6-2,
3.1.6-29, 3.l.6-39

LOGUUl CONSOLE FUNCTIONLOGOUT CCW.llMW

3.7.(l··J, 3.?..3-J, ?.3 •. o-3, 3,.0.0-1, ?..,?.o-;i,3.2.Z- l n::~u 3.2.2-3, 3.2.3··?. THfW 3.;>.3--<,1 3.2.'J··lr 3.?.'.",--2,
3.1.-r-1, 3.?.7-·?, 3.2.ll-l nrnu 3.2nfl-t;, 3.''.i.2··'.i, 3.1•• 1--1. 3,1,,i.1-1,!i.:~.Jt-·l, 5.'1.0-?, 6.0~0·-lr APP .. f11.APl'.h-l~i, /,Pl'.l\.

IOW Cflil:.'.!W
3.2.1.··l,

GIOSS, 3.7.3-2, 3.2.3-1 1 3.2.3-3 HH:U 3.2.3--·1, 3c2,5-·l,
3.?.-f-21 5.3.0-1 1 f.PP.0··15

1.0/iD 111,por

Tfll'[

3.l~0-1,

cunr:t.NO

3.1.l!'>-J, 3.l.0-·1 1 3 .. 1.1~1-2 lllRU 3.1 .. l~>··'J,

3.1.4-1

TH~U 3.l.~-3,,.

ltPP.D-~

3.J.15-21 J.1.15-31

tOt.Or-R Ol'l'P./..llO OF Gll!ll/1l COl!~'.l'.t;O
3 o 2 • 3- 5 I 5 " 11 • 0- i' t /; f' p • !)- 5

3~2,.J-7.1

3.11.l-l(SfE MSG CONSOLE

I' /ICH IN(

CHoCK

THHU 3. 1,.1-1,,

3.l.JU-1, 3.l.19-1

F~NCTIONl

3. 3. i'-30

l'ACIUNF: l/'.NGUflGE CODE

3.1.19-11 1trr.n-1
101,0 ro1r11

3.5.10-1 1 3.'5.B-11 3.5.10--2, 3.5.11-l, APP.A, /1PP.B

lPSh lt\STRUCTICN

3.2.'..>·2,

C.Ct:!~/1ND

2.2.2-3 1 3.5.10-1 1 4.1.8-1, 4.l.0-1 1 APP.At APP.C

3.4.L-l ThnU 3.4.1-3

OPTIONLPKl~TlJAPN C'Pl:fl.ANC

tCJ\0 Cl'U:MW

THRU 3.1.6-8, 3.1.6-211 3.1.6-24,

3.5.9-l, 3.s.1-1, 3.5.1-2, 3.~.4-J, 3.5.9-21 3.5.13-2, s.1.0-1,
5.1.0-2 1 APP.A, APP.A-3, APP.B

LINE l[l;GUI CCiHP.('lJUJt.o Gf'cf:/.ND o;: Dl s:~~.l.6-5

LCGIN CUMVANO

3.1.10-1, 3.1.19-l

3. l'i. Ii. l ·• l Tl ;;~ u 3. 1, ~ '· • 1- 3($[[

J 20 bf>/l~3.l.6··30

1 rr~:~ 111icr.o- ms rnuc Tl er~

6-1-682.1.0-3, 3.4.1-1, 3.4.1-2, 3.4.2-1, 3.4.2-2

MACLJB COMt\ANO
3.1.10- THRl! 3.l.10-6, 3.l.19-11 3.l.19-2, 3.1,.1-3, 5.4.0-l,/.PP.A, APP.B

3.7.11-lt 3.3.2··20, 3.f;·.lw}-1;

3.2.2-1, 3.2.2-2, 3.2.2-3, 3.i'.3-2 11mu

l'l\CRO

3.1.10-1 THRl! 3.1.10-·6 1 3.1.12-2, 3.1.12-3, 3.2.0-2, 3.2.2-1 THRU
3.4.1-3 1 3.1,.t.1-11, 3.1,.1.2-1 TtlRU 3. 1+.1.2-7, 3.4.1.2-9 1

3.7..2-~ 1

3.1.. 1.2-10, 3.'i.l.2--12 lHHU 3.4.1.2-20

3.?.0-1, 3.l.0-2r 3.2.l-lr 3.2.1·-2, 3.?.2··1 Tlli:U 3.?..2-3 1 3.?.?.-·1 1
3.2.3··2, 3.Z.3··'• TIH:U 3.2.3-(,, 3.2.11-·1 1 3.2.11-2 1 3.2.~-1 1 3.?..',;·;> 1
3.2.6-lt 3.?.6--2, 3.2.7-1, 3.2.7-2, 3.2.ll-l THf'.U 3.2.0-1,, 3.3.?-1.l. Tll~(U•3. 3 .. 2-23, 3 •• !,. l--2, 3.1•• 1.1-111 3.'i. l.2·-20, 3.1,.1,-3, 3,1,.1,.-1., 3·'•·'•~ 1··3, .
3. 1•• 3-3, .3.~.11,-1, 1. . 0.0-1, 4.1.·r-l., '1.2.0-1, S.3.0-1, '.i.3.0- 1; , 5.3.0-·51
6.0.0-J, GLOSS-2, GLOSS-3, APl'.l\·-2 lllflU APP.A·-5, t.:•P.11-15

tCltd>HiGl'ACftG OF.f-lNlllDN

3.1.lO·l TlllW 3.l.10-41 3.1.10-6, 3.l.12-2, 3.1.12-3,
3.2.0-21 3.2.2-1 THRU 3.2.2-31 3.4.1-31 3.4.1.2-11 5.4.0-1, ~LOSS-3

rl\CRO CEFJNlllON Fllf
~ACRO

nrcuE~lIEOIT

GLOSS, 3.1.lC-l, 3.1.0-l, 3.t.0-2, 3.t.10-2 THRU J.1.10-4,

3.4.1-31 3.4.l.2-l, 5.4.0-l, APP.A-21 l\PP./1-3

lOAUMCD tllMMANO
3.2.1, •. 1, 3.0.0-11 3.2.0-l, 2.3.0-31 3.7.1.-1 1
3.2.11-21 3.?..r.-1, 3.2.C-3, ~.2.(1··4, hPP.r., Ar>r.n, /1PP.0-6
tOCAl[

LIHRARV

3.1.10-2, 3.l.10-3

l'ACf\O Nl\ML3.1.10-4

E~VI~.)

3.1.6-25, 3.1.6-4, 3.1.6-C, 3.1.6-13, 3.l.&-151).l.6-16, 3.1.6-201 3.1.6-26, 3.1.6-41, 3.l.6-43, 3.5.13-2, APP.A

\

"

-

~·

,,,...

~"'
6-1-68

15.L
fo'AJN PROGRAM

3.2.6-l, 3.4.2-3

MA l N S TOR/,GEtSEE CORE STOR/IGEI>I/IP FILE

3.~.16-1,

l'APPRT COHHANO

3.5.lJ-l THRU 3.5.13-3, APP.A-3 1 APP.B-6

l'ARCIN STOPS
l'ASK

2.2.1-3, 2.2.1-7(SEE P.OGRAH MASK, SYSTEM MASKI
3.1.6-1, 3.l.6-2, 3.1.6-6, 3.1.6-7, 3.1.6-15, 3.l.6-37, 3.1.6-43

H(;HO FIL ETVPE

1-'LMORY!SH CORE

STOl~AGEI

l'l:l-IORV RELOCAlION HAf\IJ\,ARr,..ODULEF ILETYPEC£NSOLE FUNCllUN~

CSEE NEXT RE,UESll

4.l.9-1, 4.1.0-l, APP.Ah OPERAND OF HAPPRl COMHA~O!\ES TING

3. '•. 4- 4'

hEXT FREE LOAD LCCAl!ON(~CRIPT! SEE NC

INCi

CPERAND

3.1.6-27, 3.l.·6-22, 3.1.(,-0, 3 .. 4.1.2-17, APP.A

EOIT [NVIM.)

3.1.13-17, 3.1.13-7

3.5.13-1

3.2.3-1, APP.8-15~.4.L-1.

l\OClAG OPllUN

3.4.1-1, 3.4.2-1, 3.4.l-2t 3.4.2-2, 3.4.2-4, APP.8-15

F J LLCCNTMC~

1\0 FI LL MCfJE

l\OGO CPTICN

3.4.2-1, 3.4.2-3, APP.B-15

3.4.2-1, 3.4.1-2, 3.4.2-3, APP.8-15

3.1.13-35, 3.1.13-7, 3.1.13-30, 3.l.13-34, 3.1.13-44
3. 1. 13-21).4.2-lt 3.4.2-2, APP.B-15

3. 4 .• l. 2-1

f\OTYPf OPTION

3. 2. 3-1, 3.2.3-5, APP.B-15

t\O UF 0 OPERAND

3.5.9-1, 3.5.9-2

l\OWA IT OPT ION OF SCRIPT CCMMAND:3.1.13-1, 3.1.13-3 THRU 3.>.• 13-5

NOhAIT OPTION OF SETCVER COMPAND

3.3.4-2,

CPTlON.EF UP1 ION~PP.0-16

3.2.3-2, 3.2.3-41 3.2.3-5, APP.8-15
3.4.l-l, 3.4.1-2, APP.G-15

ISEE CMS NlCt.EUSINULL LINC:GLOSS, 3.1.6-3 ll!RU 3.l.6-7, 3.l·.6-12r 3.1.6-30, 3.1.6-~6, 3.l.6-4lt
3.1.13-2, 3.1.13-4, 3.l.13-8, 3.1.13-11, 3.1.13-13, 4.t.0-1, 6.0.0-2,
APP.A·-7, AP.f'.A-0c

CSEF QVERt.AY REQUEST)COJEC T CODE

l\CCECK OPTlUN~.O~OKHAL OVERRIDE
3.3.0-1, 3.3.1-1, 3.3.1-3, 3.3.1-4, 3.3.3-3, 3.3.4-2 THRU
3.3.4-4, APP.A-4

l\Utl.ElJS

3.1.6-36, 3.1.6-37, 3.1.6-5, 3.1.6-7

l'CCt.EAR OPTICN

3.4.2-1, 3.4.2-2t 3.4.2-lt APP.C-15
3.4.1-1, 3.4.1-2, APP.8-15

3.2.1-1, 3.2.1-2, 3.2.4-1, APP.B-3, APP.B-5

f I LL CCNTROLI

1\0 OPERANC or MAPPMT COMHAND

3.2.3-lt 3.4.2-1, 3.2.3-2, 3.4.2-2, 3.4.2-31 APP.C-15

t\OREN!' OPTIONt;OXEQISEE NEXT AVAILABLE LCAD LCCATICNI

22 -OPT ION · 3. 3.4-2, 3. 3.4-3 TllRU 3 .. 3.4-5, APP.8-lb

NDPR INT OPT ION

l\L

M:XT REQUEST CEDIT [l\V!R.I

l\EXT REQUESTl\OMAP CPTION~OP ARM

3.5.13-1, 3.5.13-2

3. 5. 3-2

"lXf AVA[LABLC LOAD LOCATION

ls3.ST OPTION
3.4.1-1, 3.4.2-1, 3.4.1-2, 3.4.2-2 THRU 3.4.2-4, 3.4.4-J,
3.4.4-4, APP.B-15.

r-.on °MACRC-INS.TRUCTICN

3.2.4-1, 3.2.1-1, 3.2.1-2,..SG

6~1-68NCJSOURCE OPTION
1.0.0-1

3.1.10-4/'END CARD

~NF

~l

3.5.13-3~.2.3-i, 3.4.2-1, 3.2.3-2 THRU 3.2.3-5, 3.1._2-3, 3.4.2-'•• APP.B-.15

OPTION

~AP

lt3

21 -

COJ[CT P.ROGRAM

IS[[ RELOCATAOLE OOJECT CODE, MAClllNE LANGUAGE CUDEl

3.4.1-1, 3.4.2-3, 3.4.2-7.Of (SEE OPFSET CCNTROLICFF OPERAND er HAPPRT COMMAND

Cff OPERAND OF PAGE

NU~BER

3.5.13-1, 3.5.13-2

CONTROL3.1.13-39

CFFLINE CCMH/INO
3.1.11-lr 2.3.2-2, 3.1.2-lt 3.1.11-2 THRU 3.1.11-7, 3.4.1.2-1,
3.5.13-lr 6.0.0-l, APP.At APP.6
CFfL lNE OEV I CE
CFFLlNE

GLOSS, 3.4.1.2-1, 3.5.0-1, 6.0.0-1, APP.A-1
OF SCRIPT COMMAND

3. 1.13-l

CF' I NE OPT JCN OF SNODOL COMMAND

3.4.4-·1

OPTIO~. '6-I-68/,~s·-¥
2:

3.l.0-2, 3.1.9-2, 3.1.11-3, 3.3.0-l, 3.3.1-11 3.3.1-21
3.3.1-4 1 3.3.2-15, 3.3.2-17 1 3.3.2-lBr 3.3.2-20, 3.3.J-l, 3.3.4-·3 TllRU
3.3.4-61 3.4.1-1, 3.4.1-3, 3.4.2-1 THRU 3.4.2-4, 3.4.4-lt J.5.6-1,
3.5.13-l, 3.5.lJ-2, GLOSS-4, APP.A-3, APP.h-5, APP.A-lo, APP.B-15,
3.1.6-3, 3.1.13-1, 3.l.l3-3t 3.1.10-1, 3.1.19-·l

CFFLINE PRINTER

CS/360

CS SVCCUTPUT

3.5.13-1, 3.5.ll-2

CN OPERAND Of PAGE N~MBER CONTROL

3.1.13-39

GLOSS, 1.0.0-2, 3.2.3-1, 3.3.2-1 1 3.3.2-15, 3.4.l-l, 3.4.L-5, APP.A-1

CNLINE OlJl-lP

3.4.l.2-l

3.3.1-3, 3.3.3-3, 3.1.4-4
GLUSS, 2.2.0-1, 2.2.l-3, 2.2.1-6, 2.2.3-1, 2.3.0-2,
3olo0·-2,··3olo2·•11 3nlo3·-1, 3.1.3-2, 3.1.4-3, 3.l.10-2, 3olel0-5, ]olol0-61
3.1.11-2,: 3.1.11-3, 3.l"ll-'.i, 3.1.11-6, 3.i.12-2. 3.1.13-3, 3.1.13-4,
3.1.13-15, 3.1.13-lil Tlrnu 3.1.13-31, 3.l.1'1·--1, 3.l.14-2, 3.l.l'.i-3 THRU
3.l.l'.i-5, 3.2.0-1, 3.2.&-2, 3.3.1-1 THRU 3.3.1-4, 3.3.2-D, 3.3.2-9,
3.3.2-l~ lllflU 3.3.2-20, 3.3.2-22, 3.3.2-21., THHU 3.3.2-27 1 3.3.2-29,
3.3.2-31 nmu 3.3.2-33, 3.3.2-35, 3.3.2-37, 3.3.2-39, 3.3.2-41, 3.3.2-43,
3.3.2-44, 3.3.3-2, 3.3.3-3, 3.3.4-~ THRU 3.3.4-7, 3.4.1-2 THRU 3.4.1-4,
3.4.1.2-3, 3.4.1.2-~. 3.4.1.2-14, 3.4.2-2, 3.4.2-31 3.4.2-9, 3.4.4-2
THRU 3.4.4-4, 3.5.13-3, 4.l.0-1, 4.1.2-lt 1._1.2-2, 'i.l.'1-31 4.1.5-2,
4.1.8-1, GLUSS-4, APP.A ·10

CUTPUT fill3.1.3-1, 3.1.3-i't 3.1.11-3, 3.1.11-6, 3.J.13-20, 3.4.1.2-3,
3o4olo2-ltt 3oli.2-2t 3oltn2-·8

3. 3. 2-1 7

CNLit-.IE OPERAND

l.0.0-1, l.0.0··2, 3. 1•• 1-1 1 3.4.l·-~;, 3. 1•• l.2···1, 3.'i.l.2-2, 3.4.2-:h
3.4.2·· ''• 1,.0.0-1, GLOSS· 2, GLOSS-5, APP.A-1

CS MACRO-INSTRUCTIONS

3.1.13-36, 3.l.13-4, 3.1.13-7, 3.1.13~33

CFFSET CONTROL

CN OPERAND OF HAPPRT COMMAND

ta· 24 -6-1-63b~I)

3.1.13-39

CFFtlC CPrnMrn OF ;'/1G[ NtJMflER CONTROi.

CNL me.Ir/

3.3.2-151 3.3.2-17 THRU•3.3.Z-19

LUl PlJT UNl:

3.1.13-18, 3.J. 3-19, 3.l.13-21, 3.1.13--22, 3.5.5-l

LNLJNE OPTION 3.4.4-11 3.4.4-31 3.4.4-4

CVEl~LAY

rrENJNG FILFS
2.1.0-4: 3.1.11-6, 3.7.1-2t 3.2.1-3, 3.7.4-2, 3.3.2-771
3.4.1,2-8, 3.4.1.2-ll, 3.4.1.2-13, 3.4.4.1-2, 3.5.8-l, GLOSS-1

lVlRL/IV R[OUlST
3.l.6-28, 3.l.6-29, 3.l.6-1, 3.t.6-8, 3.1.6-13, 3.1.6-32,
3.1.6-39, 3.l.6-43, APP-A. (,P(N llACRO-INSTRlJCTION

3.4.1.2-1

l.0.0-2, 3.0.Q-l, 3.0.0-2, 3.l.6-lt 3.1.6--C,, 3.1.9-1, 3.L.9-l
3.L.14-lt 3.1.14-2, 3.l.17-2, 3.t.19-2, 3.Z.3-4, 3.2.4-J, 3.?.6-1,
3.2.0-1, 3.3.1-1. 3.3.2-2 Hmu 3.3.2-6, 3.3.2-10 TllHU 3.3.2-13, 3.3.2-15
rnr'i..; 3.3.2-111 3.3.2-21, 3.3.2-22, 3.3.2-24, 3.3.2-26 nmu 3.3.2··2?,
3.3.2-31 THRU 3.3.2-35t 3.3.2-38, 3.3.2-39, 3.3.2- 1<2t 3.3.3-3, 3.4.l •. 2-11
3.4.1.2-4, 3.4.1.2-5, 3.4.1.2-91 3.4.1.2-10, 3.4.1.2-13, 3.4.1.2-llt
3.4.4.1-1, 3.4.4.1-2, 3.5.4-2, 3.5.9-lt 3.5.9-21 3.5.10-1, 4.1.0-1.
4.l.13-l, 6.0.C-1, GLOSS-2 THRU GLOSS-,, APP.A-3

l:PEl:ANC:

CPERATING SYSTEM
iCPERATION CODECPTJONCfUGINGLOSS, 3.3.0·l, 3.\.1-1, 3.3.1-3, 3.3.l-4, 3.3.2-32, 3.3.3-31
3.3. 11--7 T1mu 3-~·'•-'•• 3.4.1-3, 3.1•• 1.2-1, 3.5.6-1, /IPP.11-1, APP.A-3

LVflHUCE

GlO'.>S,OPERAND SUBSTITUTION

3.2.8-l, 3.5.3-1 THRU 3.5.3-3

COMMM;ll

3.5.4-1, 3.s.1,-2, 3.5.1-1, 3.s.1-2, 3.5.9-2,

5.1.0-l, Al'l'.0-5

P CPTICN.PA

3.5.11-1, 3.5.11-2

ISEE PAGE CCNTRULIISEE OS/3601

PACE

PAGE: ICUTPUll
3.1.11-·2, 3.t.11-4, 3.l.tl-5, 3.1.13-J, 3.l.13-3, 3.I.13-15,
3.1.13-19, 3.l.13-2C, 3.l.13·-23 lllRU 3.1.13-2~, 3.l.13-27, 3.1.13-26,
3.1.13-31, 3.1.13-37, 3.1.13-38, 3.1.13- 1,3, 3.4.4.1-2

3.3.2-6, 3.3.2-7, 3.3.2-12 TllltU 3.3.2-lOt 3.3.2--21 THP-U 3.3.2-23,
3.3.2-28 1 3.3.2-32, 3.3.2-38 THRU 3.3.l-40, J.3.2-42, 3.3.2-43
3.3.2-3 1 3.3.2-4, 3.3.2-6, 3.3.2-12, 3.3.2-13,
3.3.2-161 3.3.2-11, 3.3.2-211 3.3.2-22. 3.3.2-281 3.3.2-29, 3.3.2-39,
3.3.Z-42t 3.3.2-43, APP.A.-.

(SEE PRINT REClJEST)
P UP[ fl AND OF FQf(llt\ l3.3.2-5, 3.3.2-22

3.1.q-2, 3.2.3-1, 3.2.3-Z, 3.2.3-4 THRU 3.2.3-6, 3.2.s-1, 3.2.s-2.
3.2.1-1, 3.2.1-2, 3.2.s-4, 3.3.1-1, 3.3.4-1 THRU 3.3.4-7, 3.4.1-11
3.11.1-2, 3.4.1-5, 3.4.2-1 THRU 3.1i.2-1,, 3.4.1,-1, 3.'••'i-3t 3.5.2-1,
3.!J.1,-1, 3.s.11-1, 3.s.11-21 3.s.13-1, 1,.1.u-2, s.3.0-1, 3.t.10-1,
3.l.19-lt 6,0.0-lr APP.B, APP.D-3t APP.B-4, APP.D-6, APP.B-l6r APP.8-17
lHRU APP.B-19

ORIGIN RECUEST

3.2.5-1, 3.2.7-1, 3.2.7-2, 3.2.8-2, 3.2.C-4, 3.4.4.1-3

CONTROL

NL~BLR

PAG[ ISTOH/\Gfl

1.0.0--1, l-0-0-·2

PAGE CCNTROL (.PAI
PAGE

3.l.13-i9, 3.1.13-7

3.1.13-7, 3.1.13-31, 3.1.13-37, 3.1.13-44, APP.A-9~EADING

3.1.11-2, 3.l.ll-4, 3.1.13-23, 3.1.13-25, 3.t.13-27, 3.l.13-31 1
3.1.13-37, 3.l.13-43

PA(;[ l.ENGHI CONTROL I. PLI

3.1.13-30, 3.1.13-7, APP.A-9

-.

Aa.!
H'·,.;:~~wm

EiijiijW!IE•n._am e¥

Ii..

!J!c1!iM!f*? d-i!iiliiii¥----.- .!#If

·

!#ii·

... .A!

......1 .•. .... \L..

,ff~

!

If

+

,fl"

""'

"""
6s-z,
6-1-68

\

b~l

67

25 -

6-1-68PAGl Nt.;MUER
3.1.11-2, 3.l.ll-4 1 3.1.13-20 1 3.1.13-23 1 3.l • .l3-27t 3.1.13-311
3. l • l 3- 3 7. 3 • l • l 3- } 9 ' 3. 1 • l 3- 4 3
PA~fXXX

OPT!Ch or SCRIPT

P /.C tr~ G l\IH t.

co~~ANU~~INCIPLE5

3. 1. 1 3-1

P~INT

Gl..CSS

PlllHd-'E;lER.

f PT I ON

l'/,RH ll~T

3.3.4-2,(~f(. PASShfflD

Pkl~l

P~l~T

OISK
GLOSS, 2.1.0-1, 2.J.0-4, 3.l.0-1 1 3.1.0-.?, 3.l.l-1 1 3.1.3-1,
3.1.3-2, '3.l.'1-1, 3.1.!'J-l, 3.L.!1-2, 3.1.6-lt 341.6-'•• 3.l.6--5, 3.1.l•-lfl,·3.1.1-t, 3.1.B-l, .3.t.U-2, 3.l.9-1 TllJW 3.1.9-·3, 3.1.11-1, 3.1.ll-·2,
3.l.ll-4, 1.1.12-1, 3.1.14-1, 3.1.14-2, 3.1.15-1, 3.l.J.5-3, 3.1.16-2,
3.J.16-4. 3.2.c-1, 3.?.1-1, 3.2.1-?, 3.2.2-1, 3.2.2-2, 3.2.3-2, 3.2.3-41
3.2.0-l, 3.2.D-3, 3.3.2-27, 3.4.1-1 THRU 3.4.l-Sr 3.4.1-7, 3.4.l.2-l,
3.4.1.2-$, 3.'4.1./-12, 3.4.1.2-13, 3.'i.2-3, 3.11.2-n, 3,.i+.2-11 HlltU
3.4.2-13, 3.s.1-1, 3.'J.1-2, 3.!J,1,-1, 3.5.'i-2, 3.s.11-1,, 3.5.11-2,
3.'>.13-1, 1,.2.0-1, s.1.0-1, 5.1.0--2, s.1•. 0-1, 6.0.0--1, 3.1.6-3'••
3.1.13-ll, 3.1.13· l'J, GLOS~-2, GLOSS-4, GLOSS-5, APP.A-·! THRU /\PP.A-4,!i-fl .• PP/I

.PL

3.1.11-1, 3.1.0-Zr 3.1.11-2 THRU 3.1.11-4,

CPEMANO OF SCNIPT COMMAND
3.1.13-1 1 3.1.13-3 THRU
3.1.13-30, 3.l.13-3lr APP.6-b

3.1.13-~,3.1.13-161

3.1.16-1, 3.1.0-1, 3.1.16-2 TtJRU 3.1.16-4,

CPTION

3.4.1-11 3.4.2-1, 3.4.1-2, 3.4.1-3, 3.4.2-3, 3.4.2-10, 3.4.4-J,

OPlRANC CF OfflJNE CCMHAND
3.1.ll-lt 3.1.0-2 1 3.t.Jl-2, 3.l.ll-3,
3.1.11-5, 3.1.11-6, 3.4.2-3, APP.0-6

P~l\ICC

f'Nl'llll<ll.il.;(Sf CEC!T ENV!R,I~~l~I

REQUEST (SCRIPT EDIT

3.1.6-30, 3.1.6-4, 3.l.6'-8 1
E~VlR.)

CLOSIO COl-'J-IAND

I ,1111 ilPfRfl!'-ID Cf-

APP.A

3.1.13-18, 3.1.13-7

3.1.2-1, APP.B-4

APP./1-flfll[ O!f\ECTOltY
3.1.7-1, 3~1.9-1 1 3.2.11-l, 3.2.8-1, 3.2.13-3, 3.2,£1-4,
J.4.1.2-$, 3.4.t.?-6, 3.5.1-1, APP.A-3 THRU APP.A--!>, 3 .. 0.0-1, 3.1.6-18

PL I

COH~AND

APP.B-15

f .. l'llf

Ull-'l'ANO
3.1.12-1, 6.0.0-1, 3.l.0-2, 3.1.<i-2, 3.1.10-31 3.1.10-6 1
1.1.12-2, 3.1.12-3, 3.tio2-·3, 3.5.3-3, APP.A, APP.O, 3.5.13-3

l'tlf.;I,

l.T

P~IHIA\IENT

PHYSJCAL

2.2.2-z3.l.ll-6, APP.B-bl•tKMll\~NT

TAB S~JTING

l'l'{V OPTICN

3.4.J-5

APP.D-7

2.2.2-1, 2:?.2-2, 2.2.2-3/IPl'.t..-6,

3.3.1-3, 3.3.2-lOr 3.3.Z-llr 3. 3.2-31,

PMINf CPLMANO OF TXTLIB CCMHAND

LISTI

26 -

3.1. 13-5
fEATUR~

pqJNT CPERAND or OFFLJNE

3.3.1,--3, 3.3.'i-4, 3.3.11-6, APP.11-16

PARA~lTEH

Of OPERATION MANUALCOMMANDPKINT INHIBITI 50: OPERAND)

Pt.t<Al-'.(TEk USl
GLOSS, 3.3.1-4, 3.3.3-1, 3.3.4-2 Tl!RU 3.3.4~·'11 3.4.t.l-l THHtl
3.4.l.l-41 3.4.1.2-1, 3.4.1.2-2, 3.4.1.2-4, 3.4.1.2-12, 3.4.1.2-14,
3.4.1.2-16, GLCSS-4, APP.U-lb
I' A~ I'. l"'

3.l.13-4, 3.1.6-0

3.2.3-11

3.2.3-5, APP.B-15

3.l.q-4, 3.l.10-5, 3.,1.10-la, ·3.l.11-4, 3.1.12-3, 3.l.1-3-28 TltP.U
3.l.13-31, 3.1.16-5, 3.3.2-3, 3.3.1-l THRl.J 3.3.1-4, 3.3.?-0, 3.l.2-9,
3.3.2-15, 3.3.2-19, 3.3.2--20, 3.3.2-25, 3.3.2-3'7, 3.3.2-41, 3.3.2-1.4,
3.3.3-2, 3.3.3-3., 3.3.11-4 THRU 3.3.'1-61 3.4.1-6, 3.5.3-5, 3.5.3-6 1
3.5.6-l, 3.5.13-1, 3.5.13-3, 4.1.2-1, 4.1.4-3, 4.1.5-3, 4.1.13-2,
4.l.13-3(Sf[ PAGE LENGTH CCNlRCLl

CO"MM.D

PL! flLETYPE

PROtH. H' S Tll TE

t.0.0-2,

Pt<CCEt C LI GtH

2.2.1-4, 2.2.1·-5

3.1•• 3-1,

3.l.6-2
PRCG~A".PN !SEE PAGC NUMBER CONTHOll
l'CINT "ACRU-INSTIU;CTICNPROGRMI ERROR

3.t.5-1, 3.1.6-4, 3.1.6-5, 3.1.6-7, 3.1.6-10, 3.1.6-12, 3.• 1.6-1'1 nmu
3.l.ti-16, J.1.t:-20, 3.1.6-22, 3.l.6-251 3.l.l.-27, 3.l.6-30, 3.1.6-33,
3.1.6-:36, 3.l.t.-:-17, 3.J.6-1.t, 3,1.6-42, 3.1.13-2 THRtJ 3.1.1:3-4, 3.1.13-6
THRL. 3.1.11-l'J, 3.l.13-·22, 3.1.13-23, 3.2.1-1, 3.3.2-ll, 3.11 .• ?-2, 3.S.11-l,
T~RU

APP.A-0

Pt<EP CPTILN 3.2.3-l,

E~VIRCNMENT

2. 3 • o- 11 2. 3. 0-· 3l. o. 0-2

3. 4. l. 2-1

POJNTER~PP.A-ti

3.3.2-31

3.4.3-1 Ttmu 3.4.3-'•

3.2.3-'.l• APP.11-15

Pl<f;C.RAM J(\jftRkLPT'3.3.2-1, 3.3.2-2, 3.3.2-'.i, 3.3.2-211 :1.3.2-22,
1.~.2-31,
3.3.2-33
PRCGNAM

MASK

pq~~qAI-'~FGMfNl

3.3.2-30,

3.3.2-31
3.2.0-lPIHJljRA" STATUS hllltD(PSwl
3.3.0-l, 3.3.2-1 1 .3.3.2-2, 3.3.2-21, 3.3.2-22,-,.3,;>-?3, .~.3.2-30, 3.3.2-3lt ·~.3.2-341 3.3.2-361 4.1.4-1 THRU 4.l.4-3,
1
1,.1. 1-l, 4.l.5-2, 4.1.13-1, 4.1.13-3, 4.2.0-l, APP.A-5, fl.PP.B-13

~\w

•

I

ISlf PkGGMAM STATUS

~ORO)

./

/.:-v·

Ir.,·[{i c) (.)

6-1-68l'SW REOUi::S 1

RE-ENlRl'.NC.E

3.,t. l.2-1

PUTX MACRO-INSTRUCTION

3.4.1.2-1~

3.4.1-1, 3.4.1~5; APP.B-15

3.1.2-1, APP.6-4

PUNCH OPERAND OF OFFLINE COMMAND
3.1.11-1, 3.l.0-1, 3.l.11-2, 3.1.11-3,
3.1.11-6, 3.4.1-2, 3.4.2-81 5.3.0-l, 5.3.0-3, APP.C--6

PUT M~CRO-INSTP.UCTION

REGlSTER (5El ALSO FLOATING POINT REGISTlR, GENERhl PURPCSE REGISTER)
3.3.2-1, 3.3.2-H,, 3.:i.. 2-11, 3.3.2-21, 3.3.2-2'•• J.3.2-33 nmu
3.3 • .?.··36, 3.4.1.1-1 Tllf:U 3-'••l.l-3t 3.'•• l.:?-3, 3.1,.1.2-6 THRU 3.4.1.2-:1,
3.4.l.2~14, 3.4.1.2-17, 3.4.1.2-18, 3.4.1.2-20, GLOSS-4, APP.A-1,
APP.D-3
REGI SHR 14(SEE RETURN RLG[STERIRELOCATAOLE OBJECT CODE
3.z.0-1, 3.1.16-2, 3.2.2-lt 3.2.3-1, 3.2.3-21 3.2.3-5,
3.2.5-1, 3.2.7-1, 3.4.l-l, 5.3.0-l, 5.4.0-2, GLOSS-4, APP.A-1 THRU APP.A-4(SEE QUIT REQUEST, QUERY CONSOLE FUNCTION!

CVERY CONSOLE FUNCTION
4.1.10-1, 6.0.0-1, 4.1.0-1, 4.1.10-2, APP.A
CUIT REQUlSl (EDIT ENVIR.)
3.1.6-31, 3. l.6-5t 3.1.6-8, 3.4.1.2-10, /1PP.A

REP

CUIT REQUEST lSCRlPT EOlT ENVIR.) 3.l.13~lQ• 3.1.13-3 1 3.1.13-l

REPEAT REQUFSTR(SEE RCTYP( RECUEST, REPLACE REQUEST, RESET CCNSOlf FUNCTION).HO (SEE READ CONT~Ol)

3.1.13-20, 3.1.13-Zlr 3.1.13-7, 2.3.6-1, APP.A
3. l • 6- 2. 3. l • 6-· 6

3. 't• 1. 2-1
R~~UESTGLOSS, 2.3.0-l THRU 2.3.0-3, 3.l.6-2 THRU 3.1.6-33, 3.1.13-2 THRU
3.1.13-13, 3.3.2-1, 3.1.2-1, nmu 3.3.2-1, 3.3.2-10 r11r-_u 3.3.2-19,

3.1.13-40, 3.1.13-7

RfAO /.li\CfW-INSrnucTIGN

3.l.6-32, 3.1.6-8, 3.1.6-11, 3.1.6-20

H[PLACE CARD !REP)
5.3.C-3, 5.3.0-5, 3.2.3-l, 3.2.3-2, 3.2.3-4, 3.2.3-5 1
5.3.0-l, APP.B-15

REPS F ll[TYP[

IH:JFC II 11/LCRO-l NS TRUC TI ON

READ cr·;LY

J.4.l-1, APP.fl-15(SEE RfPLACE CAROi

3.4.1.2-1, 3.4.1.2-n, 3.4.1.2-1 lHnu 3.4.1.2-4,

3. 4. 1. 2-9

RE AD CCNTROLRENT CPT ICN

Rf'PLJ\Cl RlOUf ST

Rl:l\Uf MACl-\0.,-fNS TIWC TION

3.t.0-1, 3.5.9-1, 3.3.2-21 nmu 3.3.2-41,, 4.t.0··2, GLOSS-3. APP.A-1, APP.B

3.4.1.2-1

2.1.0-1, 2.1.0-4, 3.1.1~1. 3.1.3-2, 3.1.7-1, 3.1.14-2, 3.4.J.?-11

RESrno KEY

2.2.1-4

RESET CONSOL[ FUNCTION

4.1.12-1, 3.1.11··3, '1.1.0-1, APP.II.

READ OPERAND OF OFFLINE CDHHAND
3.1.11-1, 3.l.0-1, 3.t.ll-2 THRU 3.l.11-4,
3.1.11-6, 3.l.ll-7, 4.1.2-1, 5.3.0-l, APP.B-6

RESET LINE KEY(SEE ATTENTION KEY)

READER OPERAND OF CLOSlO COMMAND

RC:SIDUAL COUNT

3.3.2-11

REIDY CONSOLE FUNCTI(N

3.1.2-l, APP.6-4

4.1.11-11 2.2.2-3 1 4.1.7-1,

APP.A,

3.1.11-3, 4.I.0-1,

READY MESShG~

GLOSS, 2.2.2-3, 3.1.1-1, 3.1.4-2, 3.l.6-13,
3.l.6-14, 3.1.1-1, 3.1.10-5, 3.1.12-2, 3.1.12-3, 3.1.15-2, 3.1.15-3,
3.l.16-5, 3.3.2-32, 3.1.2-33, 3.4.1.1-1, 3.4.7--4, 3.s.2-1, 3.5.3-5,
3.5.3-6, 3.5.4-1, 3.5.7-1, 4.0.0-1, 4.1.1-1, 4.2.0-l, 5.1.0-1, GLOSS-2

Rb'L !-!ACHIN::;
REi\l Tll\E

4.1.2-1, 4.1.6-1, 4.1.a-1, 4.1.11-1

RESOURCES

2.2.1-1, 2.2.1-1,

2.1:0-4, 3.1.11-6, 3.1.14-1, 3.1.15-lr 3.1.15-2, 3.1.15-5, 3.1.16-3
3.1.11-l, 1.1.11-3, 3.3.2-27, 3.4.1-3, 3.4.1-7, 3.4.1.1-4, 3.4.1.2-3,
3.4.1.2-4, 3.4.\.2-6, 3.4.1.2-lt 3.4.1.2-lOt 3.4.2-2, 3.4.2-7 THRUl • 0. o- 2

3.2.1-2, 3.2.4-1, 3.5.13-2, 4.1.1-1,
4.l.2-2, 4.1.6-1, 4.1.1-1, 4.l.10-1, 3.0.0-2, 3.1.19-1, 4.l.14-l, 4.1.15-1
GLOSS, GLOSS-4

RESTART RCCUEST

3.1.13-5, 3.3.0-1, 3.3.1-1, 3.3.2-l, 3.J.2-3,
3.3.3-t,1~3.2-6, 3.3.?-13, 3.3.2-22, 3.3.2-28, 3.3.2-32, 3.3.2-3~.

3.3.4-3, APP.A

HSTORE RCOUEST

R£1URN KE't'
RElOROl • 0. 0- l 'RESPONSE !SEE 11.LSO TERMINAL CUTPUT)

4.1.1s-1, 4.1.1s-2

RECEIVE INTERRUPT RPU

C5"J 2a _3.4.2-11, 3.4.2-13, 3.4.~.1-2, 3.5.3-4, 3.5.4-2, 3.5.6-1, 3.5.11-1,
APP.A-2

3.3.2-3, 3.3.2-30, 3.3.2-31, APP.A

PUNCH OPERAND OF CLOSIO CONHAND

6-1-68

1:.J/
21 •.

R~TURN

3. l. 5- l '3. l • 5- 2

2.2.1-1, 2.2.1-], 2.2.1-~, 2.2.1-6, 2.2.1-7, 2.2.3-1, GLOSS-1

MACRO-lNSTRUCTlCN

3.4.1.2-t

~-'

~

~

..
"ii···,,

,...

~
{to

6-·1-u8

RETURN REGISTt:R

3.4.1.2-3, 3.3.2-33, 3.4.1.1-1, 3.4.1.1-3, 3.4.1.1-4,

3.3.2-1, 3.3.2-3r 3.3.2-5, 3.3.2-1, 3.3.2-16, 3.3.2-22,
3.5.2-lt APP.A

RETYPE RECUEST

3.2.C-lt 3.2.0-2, 3.2.1-1, 3.2.2-1 HIRU 3.2.2-3, 3.2.5-1
3.2.5-2t 3.2.6-1, 3~2.7-1, 3.2.7-2, 5.3.0-l, 5.4.0-2, APP.t., APP.A-4,
i\PP.nCOl!MMWRl:wlNO OP[RMIO OFTAPE COl'llAIW

RUdNO RE CUE ST

3.1.5-1, 3.4.2-0, 3.4.2-9

3. l. l •J-2

3.3.2-34, 3.3.2-38

3.2.7-lr 3.3.2-33r 3.3.4-2, 3.4.l.l-lt 3.4.1.1-3, 3.4.l.t-4,
3.4.1.2-1, 3.4.l.2-2r 3.4.1.2-4~ 3.4.l.2-5r 3.4.l.2-7r 3.4.1.2-9,
3.4.1.2-10, 3.4.1.2-19, 3.4.1.2-20, 3.4.2-2, 3.4.2-3r 3.4.4-2, 3.4.4.l-3,
3 • 5. l l- l r 3. 5. 1 3- l r APP. 0-16

3.S.2-lr

3.~.2-2,

3.3.11-lr 3.3.'t-3r 3.3.4-11, 3.3.'1-6,

3.3.4-7, APP.U-6

SAVC

Mi\CRO-I~STRUCTICNSAV[~(QUEST

3.1.6-3~,.

3.1.6·-~0, 3.4.1.1--4, 3.'t.2-2r APP.A-6, APP.A-7
3.1.l:l-l TllRU 3.1.23-47, APP.A, APP.A-1,, APP.U

SCRIPT EDIT ENVIRONMlNl
2.3.0-1 TtlRU 2.3.D-3t 3.1.13-1 THRU 3.1.13-8,
3.l.13-lOr 3.l.13-11, 3.1.13-13, 3.1.13-14, 3.1.13-lBu 3.1.13-19,
3.l.13-23

SCRIPT EDIT RfQU[STS3.1.13-2 THRU 3.1.13-41 APP.A-Or APP.Br APP.8-17,

3.1.13-b
SCRIPT FILCTYPf

SCtUPT

3.1.6-36, 3.1.6-37, 3.1.6-2, 3.1.6-5 lHRU 3.l.6-8, APP.ASET CCNSOLE FUNCTION

TlllW

3.1.13-31 3.1.13-5, 3.1.13-l.5

SCRIPT PRINT CUNTRCL hrHOS (SEE ALSO FORMAT CCNTRi\L WORDS)
3.J.13-43, APl'.A 1 flPP.llr APP.Ll-13r APP.0-14
1. 0. 0-1

3.1.13-8 TllRU

4.1~14-1

5 .• 3 .. 0-l, 5.3.0-2, 3.2.3-5

3.3.2-3, 3 .. 3.2-34 THRU 3.3.2-37, APP.A.

SETOVER COMHANO
3.3.4-lr APP.B-7, 3.3.0-1, 3.3.1-1 THRU 3.3.1-3, 3.3.3-3r
3.3.'i-2 TllRU 3.3.4-7, 3.5.6-111 APP.Ar APP.A-1, APP.i'-3, APP.e, APP.B-16~ACRO-INSTRUCTION

SLC

3.4.1 .. 2-bt 3.4.1.2-1 lHRU 3.4.!.2-4r 3.4.1.2-B

3.4.1-3, 3.4.1-4, 3.4.2-2, 3.4.2-4

SINGLE SPACE CONTROL

3.l.13-42, 3.1.13-7, 3.1.13-44, 3.l.13-46

3.2.3-1, 3.2.3-2, APP.B-15

OPfRl\fm OF TAPE COM!\Mm

3.l.15-l, 3.1.15-2 THRU 3.1.15-41 APP.B-lt SEC Sl'T LOCATION COUNH.R CAfl.0 lSLCllooo OPTlONSLCXXXXX OPTION

3.2.3-l, APP.0-15

3.2.3-1, APP .. B-15

SNODCL COMMAND

3.4.4-l TlffiU 3.4.4-4, APP.A, APP.A-4, APP.D, APP.0-7

SNOUOL LANGUAGE

3.4.4-1 THMU 3.4.4-4, 3.4.4.1-1 THRSNOHOL USfR 1 S MANUAL

3.4.4.1-~,~.4.2.-1,

3.4.2-3, 6.4.0-l, APP.B-15

3.l.16-3r 3.4.2-lt 3.4.z-z. 3.4.4-1, 3.4.4-3~ 6.0.0-1,

6.0.0-3, 6.0.0-7•

SOURCE OPT IO,...

3.4.2-1, 3.4.2-2 THRU 3.1,.2-4, APJl.B-15

SOURCE PIWGIUIM!SEE SOLRCE LANGUAGEI

.SP

(~ll

SPACE

SPACE CONTROL

APP.A-4

3.'t.4-3r 3.it.4-4

2.l.0-3, 3.4.1-2,

SOURCE LANGUACErnPUT LNV!P[jNFrNT?.3.0-1 1 7..3.0-3 1 3.1.H-l TllHU 3.l.13··0, 3.1.13-12
Tl1RU 3.1.13-14, 3.1.13-201 3.1.13-21

SECCNDAR Y S 1 CRAG[·COUNTER lSLCI CARD

SOURCF.CODE
3.1.13·-l

4.1.0-1,

SfTl.:RR"CUf-ll\f>.1'110
3.3.3-1, l\PP.n-7, :~.3.0-1, 3.3.l-l, 3.3.1-3, 3.3.3-21 3.3.3-3r
3.3.1.. -3, 3.5.6-1, APP.A, APP.,J\-Lr APP.A-3~ APP.13

SI\.

3.J.(,-3,.tt 3.l.li-1, 3.1.6-11 TllRU 3.1.6-6, 3.1.,6-81

SCRIPf COMMAND'SERIAL REQUESTSINV OPTION

3. 1•• 1.2-1

3.l.L-36.

3.1.12-2

SEVER I TY CUDE

APP.B-4

SAMfLAST OPERAND OF SE10VER COHMANOSCAN(SEE SERIAL REQUEST)SERIAL NUMBER

SETUP

fSEE SFEK RfOUESTIOPTIC'N

3.4.2-s, 3.4.2-q, 3.4.2-11

SET RECUEST.

3.2~5-l,30 -

3.1.13-22, 3.l.13-7, APP.A

SL.... 1;.NTl/\l FILE

SET LOC/\rION

RIGHT ADJUSTMENT
ROUTINE

3.1.15-lt 3.1.15-2 THRU 3.1.15-4, APP.U-7

6-1-68SE(K £tEQUEST

SER

3.l.6-33, 3.l.6-39 1 3.1.6-6, APP.A

{&!

tt1

29 -

RETURN REQUEsr

REUSE

~-

i

CONTROL)
3.l.13-4lr :3.l.13-7, 3.1.13-28, 3.1.13-44 HIRU 3.1.13-46

41)

lt.lj6-l-68SPH

l~tCP,0-lNSTRlJCTION

SPLl

INTERPRET(R LANGUAG(

3.4.1 .. 2-1
3.4.4-1 THRU 3.4.4-4, 3.4.4.1-2, 3.4.4.1-3, APP.A-4

SPL/10 A STRING PRCCESSING LANGUAGE MANUALSPL/l CPTION

3.4.4-4

3.4.4-1, 3.4.4-2 ·nmu 3.l.l1t-3t /\PP.A, APP.13

SPOOLING ARLAGLOSS, l.c.0-2, 3.1.2-1, 4.1.2-1, 't.1.2-2, 4.1.5-2, 4.l.fl-1,

r. PP • r. - l

~YSIN

ST

IStt STLRE CCNSGLE FUNCTION!

STllCKEC 11-.rur? • 3. C-?

3.2.0-l, 3.2.6-1 1 2.3.0-3, 2.3.2-1 1 2.3.2-2 1 2.::\.9-1~ 3.2.0-·2,
3.2.3-4, .3.2.6-2, 3.2.e-1, 3.2.e-3, 3.3.2-5, 3.4.1 .. 1-1, APP.A, APP.B
l:.O. 0-1.

SHIH C(Jt',l'MW

STt.RT f/O INSTRlJCTION

3. '•. l ·- l • 3 • '•. 1- 3. !">. 3. 0- l 'STCRAGE PPOTECTfON KEY
r~~CTICN

4.1.13-3, APP.II

Stcru: REQf.,ESTI·I

3.4.2-2

II

3.4.1-1, 3.4.l-7

SYSLI ll OPT I ur~

3.2.3-2, 3.2.3-4 THRU 3.2.5-6 1

SYSl l U Mf\CL I £1
5. 4 .0-1

1.i.10-2, 3.1.ir,-3, 1.2.2-1 t1mu 3.2.2:-3, 3.'t.l-3, 3.4.1.2-1

SYSLIB TXTLIB

3.2.2-1 nmu 3.1..2-3, 3.2.3-2, 3.2.3-·6, 5.4.0-2

ADMINISTRAlOR

SYST[~

APP.8-1~

2. ! • 0·· 1

3.1.13-lr 3.1.13-2, J.1.13-37
SY~TLM

3.3.2-3, 3.3.2-36 THP.U 3.3.2-41, /.PP.A

3.1 .. 6-4, 3.1.6-14 rnr.u 3.1.6-17, 3.2.3-2, 3.7.6-1, 3.2.e-1, 3.2.8-2,
3.3.2-39; 3.1,. 1
3•'•·4.l-1 THP.U 3.4.4.1-1,, APP.A-1,, l!PP.l\-1 1 APP.8-9,
APP.fl-11, 3.1.6-25, 3.1.13-91 3.1.13-10, 3.1.13-lbt 3.1.13-22,-2,p~;ClSSING LAhG~~Gl

3.4.1,-2· GLCSS1 2.1.0-1, 2.1.0-2, 3.1.G-2, 3.1.l-lr 3.1.3-1, 3.1.3-21

3.l.ll-1, 3.l.l'>-3, 3.2.i'··l, 3.2.2-·?, 3.2.3-1,, 3.2.fl-lt 3.3.2-76,
3.3.2··32 1 3.11.1.2-1, 5.'1.0-1, GLOSS-·?, GLOSS-'tt GLOSS-5

3.3.2-10, ).3.2-llt 3.3.2-30
4.l.13-lr 2.3.1-1, 3.3.2-lr 4.l.0-1, 4.J.13-2,

OISK

3. 1.u-1, 3.1.0-2, 3.1.9-1, 3.l.9-2, 3.1.11-1, 3.1.11-2, 3.1.11-4,

Ut lCll:NCY

3.2.4-l, 3.2.e-1. 3.2.e-3, 3.2.8-4, 3.5.1-1, 3.5.1-2.
3.S.ll··l, 3.S.12-lt 3.5.U-2, GLOSS-2, APP.11-1, APP.A-4, 3.0.0-1

SYSf[~

LIHRARY ISEE ALSO SYSllB MACLIO, SYSLIB TXTL161

SYS H,.. MASK

3.4.1-3. 6.4.0-2

3.3.2-30

3.~.t,-.?,

3.l.ll-6t 3.l.11-7, 3.1.15-4, 3.4.1-4, 3.4.l-7t 3.5.1,-1,'1.0.0--1, 4.1.3-1, 4.1.1-1, 4.1.9-·l, 1,.1.10-1, 4.1.10-2, 4.2.0-1,

SYSHM RFSET K[YSUPEHllISOR ANO OAfA llAN!1Gf:MENT MACRO-INSTRUCTIONS folANur.L

SYSTLP TLXT LlURARY'• • 2. 0-2

SUPEKll(SGR CllLL (SEE SVC INSTRUCTION)SUPEIWISOf\ STATE

3.2.2-1, 3.2.2-2, 3.4.4.1-2,

SYSl[M Fil[ OlRfCTORYSYSHM OP[ftAlUR

3.4.1.2-1

l.C.0-1

SYSTEM r!LE
GLOSS, 2.t.b-1, 2.J.0-2, 2.l.0-4t
3.S.ll-2,· GLOSS-4

sur:r.uu111r
3.2.0-1. 3.;>.0-2, 3 .. 2.2-1 T11Ru 3.2.z-3, 3.2.3-i, 3.2.3-2, 3.z.3-4'iHRU 3.2.3-b, 3.?..b-·11 3.4.z~.3, 3.4 .. 4-2 THRU 3.4.4-4, 3.4.4.1-1 HIRU
3 • 4 • 4 • 1- 3 I 5 •It• 0- 2

ISEE TOP

4.0.0-1, 4.1.12-1, APP.A-11

3.2.3-4 1~.4.0-2,

APP.0-3

KED~lSTI

1.0.0-2, 3.3.2-1•

I

tlf//l!J4-••I IL!

3.?..A-J, 3.2.0-3, 3.5-3-l THRU 3.5.3-3t b.0.0-1

3.1•• 1.2-10, !>.3.0-1, s.·j.0-2

lKROK

!

3. 1 • l 0 ·-2

3.1.6-31, 3.1.11-4, 3.4.1-2, 3.l.6-1, 3.1.6-2, 3.1.6-7,

J.4.1.2-5, 3.4.1.2-l THRU 3.4.1.2-4, 3.4.J.Z-6,

ST!'P CPTICN OF SCltIPT COf.'l'llND

SlRING

3.3.2-'12 nmu 3.3.2-14, 3~3.2-16, 3.3.2-21. 3 .. 3.2-28. 3.3.2-38

ADORfSS

3.s.11-1, 3.s.11-2, 3.s.10-1, 6.0.0-1, APP.A, APP.B

J.1•• 1.2-n

SlRlNG~·

2.2.l-7

3.3.2-10, 3.3.2-11, 3.5.4-2

STt.TE 1-'ACP.0-INSTr.lJCTIONCONSOLE

PANEL

Fill

3.3.0-l, 3.3.3-1, 3.3.4-2, GLOSS-4

SYSIN FIU:IYPI.:~. 1. 6-15

~YST[~

ST 1\ T COlt\t.NO

ISLE ALSO CMS SVC, OS SVC)

32 -3.3.1--3, 3.3.3-l, 3.3.4-2

SYMllCLIC NAMI

3.2.3-lt 3.2.3-4, APP.B-15(SEE SINGLE SPACE CCNTROL)

PS~I

SYMlllJllC ARGUt:rrn If.I\)

SY~TAX.SS

STCRE

l~STKUCllON

OUJ

SY~llOLIC

3.1.14-1, APP.6-7, 3.1.0-z, 3.l.l't-1

c, toss- .h

S\IC
<;11c

~\J l TCH

t!.J

6-1-GBSYMBOL NAM(

SPLIT CUlii\/dJD

SH[P OPTlCN

31 -

/./.3

#WIWL~J~~ZUL~U~OO~~-·&~JllU~M~i~IAi&tJJMMJlijQJ•~·

UPifJ#ii®iitQ&.AL4W$441¥•?4*~-b~"aj~·MY!AL@@LAA?g~;a~Mf4*M#¥Wlfff~••~

·,..-·

kt,{

6iY
6-1-68CPLRANO OF FORMAT tOMMANO

H-

3.1.6-381 3.1.6-31 3.l.6-81 APP.ArABSI I R,l:CL.ESTI(SH

JA!!',l 1

RECUf:~I

1 Aµl

3.1.6-39 1 3.l.6-40, 3.1.6-21 3.l.6-8, APP.A
3.1.15-l, 2.3.2-2 1 3.l.15-2 THRU 3.1.15-5, APP.A, APP.B(CH HANO'i.l.l~•'-2

l Al'l · f.41\RK1.1.1 rI API

3. l. l P.-1

IA•KJ•.f u:MHM~D
llltP~[~lH<RU 3.1 .. 15-5, 3.1.18-1, 3.1.19.-1

l. 0. o- 2 t' 3. 1. o- ll Al'\ •:Pl RAN[,

llhl

C.L01SS,•.1.1-1,

3.1.6'-·4,•·'1 r. ,, ,\ 1' y I l Ll 0 I " l c; r cH v
1

3.1.1-1, 3.1.q-1, 3.2.4-t, 1.2.a-1, 3.2.0-3, 3.2.a-.:.

\.(;.Ci-1

3.1.6-5

HRMIN4L
2.2.0-1, l.C.C-3, i.0.0-1, 2.1.0-1, 2.1.0-1,, 2.2.0-2, 2.2.1-1,
2.2.1-3 T~HU 2.2.1-7, 2.2.2-1 THRU 2.2.2-31 2.2.3-11 2.3.0-11 2.3.0-21
3.0.0-1, J.0.0-2, 3.1.0-1, 3.1.0-2, 3.1.2-1, 3.l.6-2, 3.1.6-3, 3.1.6-161
1.1.n-1, 3.1.'13-3, 3.l.13-4, 3.1.13-24, 1.2.a-2, 1.2.0-3, J.3.0-1,
3.3.2-10, 3.3.7-111 3.3.2-15, 3.3.2-10, 3.3.2-241 3.3.2-301 3.3.2-311
1.3.2-39, 3.3.,2-42, 3.3,2-1,3, 3.1,.1-1, 3.4.1-2, 3.4.l-61 3.1o.1.2-1,).4.l.2-14 lHl{L. 3.4.1.7-17 1 3.4.2-J, 3.4.2-41 3.ti.2-9, 3.4.4.l-l,
3.t..4.l-?, 3.5.l-?1 3.5.2-1, 3.5.3-1, 3.5.3-2, 3.5.13-1, 4.0.0-11
4.l.J-1, 4.l.<J-r, 1,.1.10-2 1 t,.2.0-lr 1,.2.0-2, 6.l.0-2, GLOSS-1 THRU
~L~SS-4 1 APP.A-?r APP.A-3 1
APP.H-3, APP.B-15 1 3.5.10-2, 4.l.14-1~OOl

SE~SIONGLOSS, 2.2.2-1, 2.2.2-3 1 3.3.1~1 1 3.3.2-17, 3.3.4-3, 3.5.1-1 1
GLOSS··4r· 3.5.9--1, 3.5.10-l, 4.Jl.15-1 1 6.0.0-l HIRU 6.0.0-8

TERHl~AL

SWITCH2.2.1-1. 2.2.1:-3

JfHMINAL LUIPUI
2.l.C-4, 2.2.0-11 2.2.1-31 2.2.l-61 2.2.3-lt
J.t.O·?, t.l.6-ir 3.1.b-·5 Tli!IU 3.t.ti-6 1 3.l.ti-11 THllU 3.1.6-15, 3~·1.6-171
TliHIJ j.l.ti-:1, :i.l.t-i5 IHJ:U 3.l.6-·27 1 3.1.6-29 HIHU 3.1.6-Ht 3.1.7··1
lttt(L } . t . · - 1 , J_l.fi·-2 1 3.t.q-1 TllRU 3.l.9-4, 3.1.10-1, 3.1.10-3, 3.Lll-2
J111H, 3.l.il-1 1. .Ll.ll-t lltlH: 3.l.lZ-3, 3.1.13-2 Hlttlo 3.l.13-5, 3.l.13-8,.

2. 3. o- 2' 3. 5 •. 2- l

TRANSMISSIONTERMINAL TYPEOUTISEE TERMINAL OUTPUT)

l/IJ INSTRUCTION3. 3. 2-11

GLOSS, 3.1.0-1, 3.l.0-2, 3.1.16-l .THRU 3.1.16-3, 3.2.0-l, 3.2.2~1
TltRU 3.2.2-31 3.2.3-4 THRU 3.2.3-6, 5.4.0-l, 5.4.0-2 1 APP.A-21 APP.A-4

TEXT LIBRARYT.

MACRC-INSTRUCTICN

T l11 f: SI-AR I NG

3.4.1.2-1

l.C.0-1, 3.4.2-11 1 GLDSS-2
4.1.0-1, 4.1.1s-1, ~.1.1s-2

1 !Mf:R

CCJNSOU:, rlJNCTICN.TM

ISLE TUP MARGIN CONTROL)

TCP MARGIN CONTROL

Hl'PCRARV ._l.RK f i l l

2.2.1-3, 2.2.2-3

TERMINAL

2.2.0-11 2.2.2-1•'·1··.01RY (l'.al<

TEH~l~AL

TERM I ~AL POWER Sid TCH

TEST3.;i.1e-1, 3.l.16-2, 3.1.19-L, 1.1.19...;·2, APP.A-4, APP.B-7

2.l.0--1 1 2.1.0-4 1 3.1.0-2 1 3.1.1-l, 3.l.3-lt 3.1.3-2,
3.1.1-1, 3.J.B-lr 3.1.e-2, 3.1.9-1, 3.1.11-1, 1.1.11-2,:.t.tl··4, ~.l.l?··I, J.2.2-1, 3.2.2-·2 1 3.2.3-4 1 3.2.B-lr 3.'.>.'r·-lr 3.~.4-l,
l.· .• tl· 1 1 3,•,.'11-?, i..1:0-1, 5.l.0-1, 5.4.0-1 1 GLDSS--2, GLCSS-4, GLOSS-'l:,\p -,A-I, A1 1 P .. trL1 APP.A-4(

3.4.l-l THRU 3.4.1-3, 3.1,.1-5 nmu 3.'tol-7, 3.4.1.1-2, 3.1,.1.1-31

3.4.1.2-3, 3.4.1.2-14, 3.4.1.2-151 3.4.2-1 THRU 3.4.2-4, 3.4.2-3,
3.'•• 4-11 3.4.4·-3, 3.5.1-2, 3.5 .. 2-1, 3.5.3-2, 3.s.s-1, 3.s.1-1, 3.5.a-i.
3.5.12-1, 3.5.13-1, 3.S.13-2, 4.0.0-l, 4.1.1~1, 4.1.2-2, 4.1.3-1, 4.1.3-2 1
4.l.4-3, 4.L.!i·-2, '1.l.5-3, ti.l .. 8-1, 4.1.9-1, li.1.10-1, 4.).10-2 1 4.1.12-lt
4.1.13-2, 5.3.D-l, 5.1.0-lr 5.l.0-21 GLOSS-3, APP.A-2t APP.A-3 1 APP.A-Sr
6.0.0-l THHU 6.o.o-a, APP.B-3, APP.e-5

CSH lAliOEf RHlLESTI

"'"

I I.

3.Z.a-4, 3.3.l-l, 3.3.l-3t 3.3.1-41 3.3.2-2, 3.3.2-5 THRU 3.3.2-71
3.3.2-10, 3.3.2-111 3.3.2-13, 3.3.2-15, 3.3.2-11, 3.3.2-10, 3.3.2-22,
3.3.?-24, 3.3.2-26, 3.3.2-27~ :~.3.2-29 TtlRU 3.3.2-331 3.3.2-35, 3.3.2-37,
3.3.2·-39, 3.3.2-112, 3.3.2-43, :~.3.3-2, 3.3.3-3, 3.3.4-1, THRU 3.3:4.,.7, .

2.2.l-3 1 2.2.l-6 1 2.2.1-7 1 2.2.3-1 1 2.3.4-21 2.3.~-21 2.J.7-1,
l.l.6-?1 3.l.6-4 THRU 3.l.6-7, 3.1.6-16 1 3.1.6-241 3.1.6-27, 3.t.6-30,
3. l. 6- 31

IAt•.:lf P.fClJ[!.ftis. 34 "".

l.1.14-1, 3elel4-2t 3,t.15-2 THRU 3.1.15•4t 3,1.16-1 THRU 3.l.16·5,
311117-~ THRU 3el•l7-5t 3.2.l•2t 3.2.1-31 3.2.2-31 3.2.3-2, 3.2.l-5t
3.2.3-6t 3.2.4-1, 3.2.4-2t 3.2.5-2t 3.2.6-2, 3.2.7-1, 3.2.B-2 IHRU

J.!J.4-lt APP.B-5~l:YTl~G

1.~•·i6-1-683.1.13-to, 3.1.13-13, 3.l.13-15 THRU 3.1.13-25, 3.t.13-27 THRU 3.l.13-3lt

1.s.11-1, J.s.11-2

IJPl ICN

JAH

~

""'

!"':

3.1.13-43,

3.1~13-71

3.1.13-44

TOP REQUEST IEDIT ENVIR1)
3.1.6-411 3.1.6-41 3.1.6-8, 3.1.6-10, 3.1.6-14
T11RU 3.1.6-161 3.1.6-20, 3.1.6-25, 3,.1.6-27 1 3.1.6-30, APP.A
TOP RECUES~ ISCRJPT EDIT lNVIR.l

3.1.13-23, 3.1.13-3, 3.1.13-7

CSEE OVERRlOEI

TRACE"TRACE INFORMATIONGLOSS, !l.3.0-11 3.3.1-1 THRU J.3.l-4, 3.3.3-1 THRU :l.3.3-3 1
3.3.4-3 THRU 3.3.4-6, 3.5.6-1 1 GLOSS-3, APP.A-1 1 APP.A-3 1 APP.A-4
TRANSLATE OPTlCN OF SCRIPT CCMHANO

3.1.13-1

TRANSMIT

2.2.1-1, 2.2.1-4

INTERRUPT SPECIAL FEATURE

3.1.6-11 3.1.6-21 3.1.6-7, 3.l.6-39, 3.l.13-2t 3.1.13-10, 3.1.13-27
3.1.13-30, 3.1.13-34, 3.3.2-3, 3.3.2-121 3.3.2-'34, 3.3.2-38, 3.3.2-39,
3.4.l.l-l, 3.4.l.2-e, 3.5.5-1, APP.A-2

TRUNCATION)

. { /.l6-1-68TYPA~ATICFEATURELSERIDl.4.l.2-14, 3.4.1.2-15, 3.4.1.2-1, 3.4.1.2-2,

3. 4. 1. 2-9

TYPE OPT ION
lYPEOUTTERMIN~L

TYPIN "ACRO-INSTRUCTlON
TYPING ELEMENT\JCPTICNOUTPUT)

VCR(SEE TERHINAUTVPEWR ITER

VERIFY RECUEST

2.2.1-7, 3.1.6-3

1.1.1-22, 3.3.2-26, 3.3.2-29, 3.3.2-38, 3.~.2-39, 3.3.2-42-3.5.9-11 3.5.9-2

VIRTUAL INTE:RVAL TIMER

3.5.12-1, 2.3.2-2, 3.s.1-1, 3.s.1-2, 3.5.12-21 APP.At APP.B

l;NDH lf'.ED LABEL

3.4.2-2, 3.4.2-4

UNOEF INEO NAMES

3.z.s-2, 3.1.6-1, 3.2.1-1. 3.2.1-2\JNIT Ct-'ECK.J.5.4-2

LNIT STATUS

USE\.AITR

3.1.s-1, 3.3.2-1, 3.3.2-2, 3.3.2-33, 3.4.1-3

tm~t1ANO).1.6-42, 3.l.6-4, 3.1.6-8

3.l.0-1, 3.1.17-l THRU 3.l.17-5 1 APP.A, APP.A-5, APP.Or APP.B-8

3.1.0-1

CQ/J~tANO

3.2.0-lt 3.2.7-lt 3.2.0-2, 3.z.1-1, 3.2.2-1 THRU 3.2.2-3, 3.2.3-bt
3.2.5-lt 3.2.s-2, 3.2.1-2, 5.J.0-1, 5.4.0-2, APP.At APP.A-5, APP.a,i'IPP. ll-8

USER-DEFINED COMMANDS

3.5.l-lt 3.5.l-2t 3.5.11-lt 3.5.12-lt 3.5.12-2t APP.A-4

USER-CEFINED LIBRARY

3.4.1-3,~SEMs.• 4.o-z"

3. ]. 2-30

~AtMU-JNSTRUCTION

JlliL1221! Lill I. jj t

J.

I

:UC JI.. . •

2I II

'·•

3.4.1.2-1

3.3.4-21 3.3.4-3, APP.B-16\,A IT l CP Tl ON

3.3.4-2, APP.B-16\<!AIT2 CPllON

3.3.4-2, 3.3.L,-1,, 3.3.4-6, ·Arr.B-16

hORK FILE

3.1.13-4, 3.4.1-2 ' 3.1.6-5, 3.1.6-6\.ROUF MACRO-INSTRUCTION
3. 4. t. 2-4
hRlTl~ACRO-INSTRUCTION

OPERAND OF TAPE
3.,1.19-2~RITLOFWR TT APGLOSS, 2.1.0-1, 2.1.0-2, 2.1.0-4, 3.0.0-lr 3.1.1-lr 3.1.7-2,
3.1.1s-3, 3.5.4-L, 3.4.1.2-2, 3.t,.1.2-13, 3.5.e-1, 1.s.9-1, 3.s.10-1,
5.4.0-lt GLOSS-4, APP.A-2

Fil~

l.0.0-2, 4.1.3-"l, 't.1.7-lr 4.2.0-1, 4.2.0-2,

3.4.1.2-1

3.3.4-2 THRU 3.3.4-'tt APP.8-16

STATE

\.All

llAITSM'[ CPTIONUP REQUEST (SEE AtSO B~CKUP REQUEST)UPCATE f ILE

APP.A-1

i.0.0-2

UNR[CQV[Rf.OLE ERRORl;Pr:HEHACRC-l~STRLCTlON

hid r RCUT (NE
4.0.0~l,1.0.0-2, 3.1.2-1. 3•1.11-1

UNIT RECORD 1/0

VIRTUAL MACHINE
GLC~S, l.0.0-1, l.0.0-21 l.0.0-3, 3.l.ll-2r 3.4.2-111
1.s.11-2, 4.0.0-1, 4.1.3-J, 4.1.4-1, 4.1.6-1, 4.1.1-1, 4.1.s-1, 4.1.12-1,
4.2.0-l, 5.l.0-1, GLOSS-2, GLOSS-31 GLCSS-5~All

GLOSS, 3.1.2-lt 3.4.1.2-1,

4.1.15-1, 4.1.15-2

VINTUl\L Ml\CtHNE CON"IGURATION

3.2.6-lt 3.2.8-4

UNIT RECORD DEVICE

3.1.6-43, 3.1.6-13, 3.1.6-B, APP.A

3.3.2-1, 3.3.2-6r 3.3.2-13, 3.3.2-15 THRU 3.3.2-17, 3.3.2-21,

VIRTUAL CGRE

LNOEFINE COHHANOUNOEFlf'.EO SYMBOLS!SEE V[RIFY RECUESTIVERIFY MOOE
3.t.6-4, 3.1.6-13, 3.1.6-10, 3.1.6-llt 3.1.6-15, 3.1.6-20,
3.1.6-21, 3.1.6-231 3.l.6-2~, 3.1.6-26, 3.l.6-28, 3.1.6-33, 3.L.6-43

3.4.1.2-16, 3.4.1.2-17, 3.4.1.2-1, 3.4.1.2-2

3.5.2-1, 3.5.2-2, APP.B-4

UFO OPERAND

CLOSS, 2.2.2-11 2.2.2-2, 3.1.4-2, 3.l.ll-2 THRU 3.1.11-5, 4.1.2-lt
4.l.9-1, GLOSS-5, 6.0.C-2, APP.U-13

VARIABLE LENGTH RECORD
3.1.3-1, 3.1.3-2, 3.1.4-1 1 3.1.15-1, 3.4.1.2-6,
3.4.1.2-1, 3.4.1.2-11, 3.l.19-2

3.2.3-1, 3.2.3-2, 3.3.2-5, APP.D-15

lSEE

36 -

IJSER FILE OIRftTORY (SEE ALSO PERMANENT FILE otnECTORY, TEHPCRARY FILE
DIRECTORY)
3.3.2-27, 3.3.z-32, 3olol7-4t 3.4.1.1-1, 3.4.1.2-5, 3.5.8-1
3.5.q-1, 3.5.10-lr 3.s.10-2, 3.5.9-2

2.2.1-1

TYPE MACRO-INSTRUCTION

6-1-6835 -

3.1-16-1 nmu 3.1.16-5, 3.2.2-2, 5.4.0-2, APP.At APP.B

1XTL18 COH}!AND

£(J

h67

~TC

COMMAND

3.4.L.2-10,

3~4~1.2-11,

3.4.1.2-1, 3.4.1.2-2,

3.4.1.2-1
COM~AND

3.1.15-1, 3.1.15-2 TllfW 3.1.15-4, APP.B-7

3.1.10-1, 3.1.19-1, APP.A-5, APP.e-e, 3.1.19-2

MACRO-INSTRUCTIO~

3.4. l.2-l-,•t":···

iii IE . lIu~·
a d 1.i !i!i I

I JU

i •M

:a

'"

;;p ii Wi!l .. ,W?.

JIW y.;; I .. @@W. &i!ii!iiiiWIW... W!i!ii•lm'!'!!n"'
6-1-68~TOR

x OPTICN.
Jc

3.4.1.2-1

H~CRO-lNSTRUCTION

"1

~

37 -

5 - I - 69

66f;;
CP-67 /CMS USER'S GUIDE

3.4.1.2-n, 3.5.2-1, 3,5.2-2, APP.a-It

REQUEST

Update Ten'lpornry RZ

3.3.2-3, 3.3.2-391 3.3.2-41 THRU 3.3.2-441 APP.A

XCTL MACRO-INtTnUCT1CN

3.1,.1.2-1

XEQ OPTION).2.3-2, 3.2.3-4 ·rnrw 3.l.3-6, APP.e-15

XREF OPTICN

3.4.l-lt

3.4.1-~,

Previous Date

2.0.0-1, 2.2.0-1, 2.2.0-2, 2.2.1-4 TllllU 2.2·.1-6, 2.2.3-1

1051 CONTROL UNIT

2.2.1-41052 PR I NTH{ KEYOOARI}.
TERM! Niil

2~0.c-1,'2J2.'l-4, 2 .. 2.~1•-7.?.z.0-1. ·2.2.0-2, 2.2.1-1 nmu 2.2.1-3, 2.?..3-1'3.2.c...:1, 3.2.e-1 tH[{lj; 3.?.6-4, 3.l..9-2, 3.4.1-2., 3.4.1.1-1, 3.1•• 2-13
6.0.0-l, APP.A, APP.A-3, APP.A-5, APP.B, APP.D-0$COMMAND@I SEE Clfht<AC TER-DH E TE S Yl-:OOL I~(SEE LINf;_OELElE SYPUOl.I*

lSEE ASHiUSKI:ff:!SEE LOGICAL TAB CRARACTER, CCNTRCL SECTICN NAMEI%C.NI SEE LOGICAL 8/.(1'.SPACf CHARACTEf{)
ISEf SYPROLIC

Section_

Page Numbe1· s

~

!'1~~

R
R

5- 1-69

APP.D-15
Table of Contents•· •'0. 0. 0-1 thru 5
Terrninal Usage··" Z. 2. 0-1
Terminal Characteristics· /2, 2. 1-8 thru 10
Logging Procedures...... 2. 2. 2-1 thru 6
Dialing a Multil-Acc<!SS System"'2. 2. 3 -1 thru 4General Typing Conventions ···2. 2. 4-1thru2
Attention Interrupt....-'2, 2. 5-1

AA

9-27-67

Environnrnnt Conventions.,,., 2. 3. 0-1thru2, -4

E

5- 1-695- ) -(194- 1-68

5- 1-6<)5- J-(i<JE

11 - J -68

4- 1-68

Edit

E

9-18-67
9-12-67
7-19-68
4- 1-68
1-22-68
7-19-68
9-19-67

Listi
M<1clib
OfflineScriptSplit
Tape
T:xtlib
State
TapeioDnmpf
Dumpd
Execution Control
Genrnod
GlobalLoad
Loadmod
Reuse
Start
Use
Assemble
CMS Macros
OS Macros
CMS Nucleus Routine
Attn
CarclphCarel rd
ConwaitCpfunctn
Dcsbufv"'3, 0. 0-1thru2_......3. 1. 1-1 thru 2..-/3. l. 2 -3.....-3. 1. 6-8A thru SB,
44thru45,. 3. 1..9-1 thru4• 3. 1. l 0- 1 th ru 6
'3.1.ll-lthru7. . . . 3.1. l3-lthru69

RH

9-15-67

CMS Commands
Alter
Closio11- 1-68
5- 1-69
5- l -(i95- 1-6?
5- 1-69
11- 1-68
5-'1-69

7-19-68

lOSO TERMINAL

2741

#.
/;/, f

9-20-67
9-21-67
9-27-67
9-27-67

7-31-67

ARGUMC~TI

8-16-67
4- 1-68

9-13-67

9-18-67
4- 1-68
9-18-6?
9-18-67

9-18-67
9-21-67
1-2:2-68

5- 1-69

R

5,.. J -69

D/A5- ) -69

R
R
R
R~/3, l.1'1-lthru3H/ 3 , l.15-lthru6

R
R
A
A

,_,..-3, 1. 16-1 tl1ru 5......... 3. 1. 20-1.• 3. 1. 2 1 - l th ru 3
3. 1. 22-·3, 1. ?.3.~
3.2.0-lt.hru2·- 3. 2. i·- l Lhru 2...-3, 2. 2-1 thru4- 3. Z. 3-1thru7-- 3. 2. 4-1thru3,.... 3. 2. 5-1thru3--- -3. 2. 6-1 th r u 2-· 3. 2. 7-1t:nu3- 3. 4. 1-1thru9- 3. 4. 1. 2-1thru2
3. 4, 1. 3-1thru2- 3. 4.1. 4-1 thru2
3.4. l.4. l-·1...... 3. 4. 1. 4. 2 ·· l
/ 3.4.1.4.3--1..-·3.4.1.4.4--1:3.4.1.4.5--1. 3.4.1.4.6-1

5- 1 -69

A

5- J-69

10-23-68

5- l-69

A

5- 1-69l J - ·l -68·A

ll- 1-68

R
R

R
H
R
R
R

5-

.1-(;')

5555-

l -69: .
l -69
i~69

1-69

5- }~(,95- 1-69

R

5- 1-69R

55555-

R

A
A
A
A

A
A
A
A

55555-

l -69
I-£.9
1-69
1-69
1-69
1-£.9
1-69
l -69
1-69
1-69

1,:1

5-1-69Sectioof'revious Date

PaGe Numbers

Action6 7cl-· 3.4.1.4.7-1
3. 4. l. 4. 8-1

AA
llndint
3.4.l.4.9-lthru2 A
Bnclsvc
3. 4 . l. 4 . I 0 -1 th r u 2 A- 3.4.1.4.11-1
LogdskA
3. 4. 1. 4. 12-1
A
Point
3. 4. 1. 4. 13-1.
A
Pr in trA
Rdbuf
3. 4. l. 4. 14-i-·· 3. 4. 1. 4. 15-1
A
State
Tapeio-· 3. 4, 1. 4. 16-lthru3 A--3.4.1.4.17-1
ATrap- 3. 4. 1.4. 18-1
AType
- 3. 4. l. 4. 19-1
TyplinA• - 3. 4. 1. 4. 20-1
AWait
3. 4. 1. 4. 21 -lthruZ A
Waitrd
/3,4. 1.4.22-1
A
W1·Luf-"3". 4. 2, l-9 thru 11 E
Fortran Programming·- 3. 4. 3 -1 th ru 5
PLI
R-- 3. 4. 3. 1-1thru12 A
PL/I Prog1·ammingA
Bruin- 3.4.5-lthru2
D/A, 3 . 5. 1 - l th r u 2
Lb endH- 3 . 5. 3 - l th r u 1 1
Exec· · 3. 5. 8-1lhru2
RI<x·- 3. 5. 10-1thru2
R
LogoutDIA
Dlip-· 3. 5. 12
ARt- 3. 5. 15-1..... 3. 5. 16-1 th ru 2A
Chard cfA·- 3. 5.17-1 thru2
CpfunclnA-3~6.0-1
Utililic·s
A-·3.6.1-1
CNVT26A-3.6.2-1
CompareA- 3. 6. 3-1 thru2
CVTFV
A-· 3. 6. 4-1
ModmapA- 3.6.5-lthru3
Sort
A- 3. 6. 6-1thru2
TpcopyA- 3. 7. 0
Text LibrariesA.. 3 . 7. 1 - l th r u 3
Syslib Txtlib
A- 3. 7. 1. 1-1 thru 3
Tapsct RoutineA-3.7.l.2
Trap Houtinc
A-3.7.l.3
Blip HnutineA..... 3.7.1.4
Logdsk RoutineA... 3.7.1.5
Reread HoutineA- 3. 7. l. 6-1thru2
Define RoutineA-3.7.1.7-1
Dsdset RoutineA-3.7.1.8
Gclpar Routine./\•3. 7. 1. 9-1 thru2
Cpnmon/Cpnmof Routines
R
Console Function Descriptions· 4. 1. 0-1thru2
Finis

-

~

-

-

.

6- 1-68'

7-19-68
1-22-68
4- 1-68

4- 3-6R
7-19-68

Begin'4.1.1-1

R

5- 1 -69
5- 1-691"*"" * !li!iiiiil 4i\ij¥a;:;:;;::n;;;;;;:;;;:.JiifL.Pi¥$.. !!iiJj.,£XS! ...$. llllJQIL.ULl#Jij ...$!JJ.MCW. . $ U Ji#. IL44W, U
11

New Date-----_§~ct~on~:ge Numbers_

ActionExternal
Jpl
Logout
Msg
Query
Heady
Set
Xfcr
Purge
Sleep
Spool
Dis conn
Link.
Offlinc ProceduresTape Proccclures
CMS Batch Monitor/I Fortran·tl.1.6-1
ti. 1. 7 -1 th ru 2
4. 1. 8-1thru2· 4. 1. 9-1 thru Z
4. 1. 10-1thru3
4.1.11-1- 4. 1. 14-1thru3-- 4. 1. 15-1 thru 3- 4. 1. 16-1 .
··4.1.17-1 '.
-· 4." l. 18-1thru3-4.1.19.. 4. 1. 20>!i; 2. 0-1~· 5. 5. 0-1- 7. O. 0-1 thru3
7. 2, 1 -2 thru 3
7.:.2-lthru3
7.2.3-1
7.2.4-1
7. 2. 5-1tlnu2
7. 2. 6-1·
7. 2. 7- l
7. 3.0-1 thru2
A-14

R
H

:

4- 3-68
7-19-68
9-l'i-67
9-17-67
4- 3-68
9-17-67
4- 3-68

5- 1-695555555555555115555115551155555555-

1-69
1-69
1 -69
1-69
1-69
1-69
1-69
1 -69
I -69
1-69
1-69
1-69
1-69
1-68
1-69
1-69
1-69
1-(>9
1-68
1-69
1 -69
1-69
1-68
1-69·
1 -69
1-69
1-69
1-69
1-69
l -69
1-69
!:, - l - 69
11- 1-68
11- l-(i811- 1-6£:
11- l-68
11- 1-68
11- 1-68
11- 1-68
11- 1-68
11- 1-68
11- 1-68
Jl - l -68
5- 1-69·7-19-68

I/ AE~scrnblc
I/ Text/I Dataset//Go// Punch/I Print
Running- CMS Batch
Appendix

R
R
R
R
R

DIA
A
A
A
A
A
R
A
A
A
A
A
A
A
A
A
A

555555555555-

1-(191-(1<;
1-69
1-69

l-(19

1-69
1-69
1-69
1-69
1-69
1-69
1-69
5- 1-69
5- 1-69.
5- 1-69
11- J-68
11 - ] -68
11- l -l1P.
11- 1-68
11- 1-(>81111111111-

E

1-68
1-68
1-68
1-68
1-68

5- 1-69

..

•
''"''

6 '11

Ne\~Date

Pr~~~tt!l_~!.?_

Erase

fl

5-1-69. flllllll!ll!llP&liii¢¥49

IZ . liiilll\i I 4•I........

'H~
iH4UU

. WWW ¥AA!W 14.....

L........ Jill ......¥... "'" ,J . JJ Q . J .... 4.Q.@48' ...IJ#IQ,m ....

.lllll!lllllllQ

,....

f'.

i~

"l

c:.'

tf

- 2 -

673

t7,,L,CMS
IBM Cambridge Scientific Center
CP-67 /CMS Support Group
545 Technology Square
CamLriclgc, Massachusetts 02139
May 26, 1969

To:

1.

New commands:
CHAHDEF
LINE NDLINKCPFUNCTN
SORT
CNVT26CVTFVCOMPARE

CP-67 /CMS Installations

2.

!

Enclosed is 'one copy of the rough drafts of updates to .the CP-67 /CMS
User's Guide . . These updates reflect the coqtents of CMS V(:rsion I. 6
and CP-67 Version 2. 4. Thtse updates wiil be revised and corrected
and sent out' formally to all holders of the User's Guide at a later date.
Pleas~' note :th~1l this is onl}' a tPn1porary 11pcl.~1lc f~n· info1Tning }'Olll"
users of thi;:, new c.onknts of the syf;tcm.

3.

The CP-67 Installation Guide does not explain how to define TTY 33 or
35'.s in the REALIO cl<·ck. To define Teletype lines, use the type
"TT35T" in ,the DMXl>V 2T1acro. For example,
TTY024DMXDV HDEVADD:.: 02·1, TYPE= TT35T, SAD= 2,
HDEVPNT = TTY025..

LISTF (BXEC) now creates the file CMS EXEC, not
LISTF EXEC.
When a command is typed in, the order of search is foran

Also enclosed is a write-up on the installation of the CMS Batch Monitor.

TPCOPY
MODMAPSTATE
TAPEIO
DUMPF
DUMPD
BLIP
RT

EXEC filetype and thc_n a MODULE filetypc.

4.

Multiple commands can be stncked on onr. input line See LINEND.

5,

The line delete .and character delete symbols, as well as
the logical tab and backspace characters, can be
redefined vi;;i.,CHAHDEF.

·6.

The # is the default for the line-end chanicter as well as
the logic.al tab character, with the line-end charactertaking p1·cccckncc.

x

7.

Dynamic loader facilities.

Th.c typC' T1"35'.f define!; it Teletypc·.1vfoclcl 33 or 35, whc1·cas the type2702T cldin(~s either;, 1052 or 2741. The SAD addrcf;s does not indicate
the terminal type.
''
'
·
-

8.

PJ.,,/I execution.

9.

New SCRIPT PRINT options and conti·ol words.

The followirig is f\ brief list of new changes and Ad<litio;1s to CP-67 and
CMS:

. 10.

GP console functions can be issued from CP - sec CPFUNCTN .

11.

Mini-disks can be dynamic'.llly added to a user - sec LINK.

12.

Changes to the existing cornmands:.

CP-6~

1.

DIAL improvements.

2.

New U!·er console functions - XFEH, DIAL, PURGE, SLEEP,SPOOJ ., DIS CONN, . LIN!<3.

New operator cunsoll! functions - DHAIN, STAHT, SPACE.

4.

Chang,·s to coniwlc fundion.s -'MSG, OUEHY, EXTEHNAL,
SET.

LISTF

OFF LINE
TAPE:
START

MAC LIBTXTLIB
GLOI3ALLOAD

KXGood Luck and Happy Timesharing!

Love Seawright..
~t1·~·

.di'

!1r/

61~--

- 2 -

CMS Batch Monitor Installation
Release I. 6

Using a copy of the NUCLEUS text deck of version I. 6, remove the
DEBUG text dee~ -·located about three/fourths into the deck andprccec<lc<l by "OFFLINE READ DEBUG TEXT." Replace the Debug
c1eck with the following text decks:

Q:

VEHSION IDENTIFICATION:· H:

BATCH I. 6 (or any 15 bytes of prose)

The nucleus will be written onto- device CUU starting at cylinder N.
Then the mess<ige "HEADY" will be typed.

Before running any Batch

j<j. streams, IPL CUU.

BATCH, BOMB, DECODECC, IPL, JCB, LIST, PRESTORE,SYSCTL'l'hcse text decks may be obtained by asscrnbling the respective source
decks from the CMS SOURCE file.
Next, place the following REP cards into the NUCONTS deck - the firsttext deck after the loader deck:z

Col!'!:

7

12-2-9 H.EP 000354
12-2-9 REP 000360
lZ-2-9 REP 000390

so

140010185, 0000, E3C 1, D7F50010186, 0000, E3Cl, b7F60010187 I 0000, E3C 1, D7F7

TAP5
TAP6
TAP7

And plncc the following REP into the BATCH text deck:
12-2-9 REP 001034

001D046

IPL Rep

On the BATCH virtual machine, IPL the nucleus card deck. The following
questions will be nsked:

Q:

REWRITE NUCLEUS?

R:

YES.
Prepare to write a core-image copy of the Batch Nucleus.

Q:

DEVICE ADDRESS?

R:

OCUU
Where CUU is the address of a disk area that will be usedsolely for the Batch nucleus • say, two cylinders on
device 194.

Q:

STARTING CYLINDER?

R:

OOON
Where N is at least "1" and not more than "the number ofcylinders minus one." For a 2314, 2 cylinders is
sufficient; Z31 l, 4 cylinders arc needed.

,.
1·.

iii•liiuH::::::::a;::::::m...

,filtf!1:!

.'" . "' . .a. a: a 111#a11::;;1;#4,;;q:;;,;m;:aµ;usti'"*''f'-•••'"