⟦eaa9ef811⟧

TextFile

%*COMPAS ON-LINE HJÆLP: Editorkommandoer.

Den øverste oversigt gælder i MOVE mode, den nederste i EDIT mode.

&A  Skift til EDIT mode.          &C  Flyt en position mod venstre.
SPACE     Flyt en position mod højre.   &H  Flyt en position mod venstre.
&I  Flyt en position mod højre.   &B  Flyt mod højre i spring af 8.
&D  Flyt til start af ny linie.   &E  Flyt til start af linie.
&F  Skift auto-tabulator.         &J  Flyt en linie op.
&K  Flyt en linie ned.            &L  Flyt en side op.
&M  Flyt en side ned.             &N  Flyt til start af tekst.
&O  Flyt til slutning af tekst.   &P  Find tekststreng.
&Q  Fortsæt søgning.              &R  Udskift søgestreng.
&S  Udskift og fortsæt søgning.   &T  Sæt tekstmærke.
&U  Slet blok.                    &W  Indsæt edit-buffer.
&V  Udskriv blok på printer.      &X  Returner til kommandoniveau.

&A  Skift til MOVE mode.          &C  Slet tegn til venstre.
&H  Slet tegn til venstre.        &I  Genindsæt slettet tegn.
&B  Tabuler i spring af 8 tegn.   &D  Start ny linie.
&E  Slet til start af linie.      &F  Skift auto-tabulator.
% COMPAS ON-LINE HJÆLP: Kommandolinier.

Når COMPAS er klar til at modtage og udføre en kommandolinie, udskrives en dob-
belt vinkel ('>>'). De nedenfor viste kommandoer er tilgængelige:

LOAD      Læs kildetekst fra disk.      SAVE      Gem kildetekst på disk.
EDIT      Start editor.                 COMPILE   Oversæt kildetekst.
RUN       Start kørsel af program.      PROGRAM   Oversæt til programfil.
OBJECT    Oversæt til objektfil.        FIND      Find kørselsfejl i tekst.
WHERE     Find fejl i include-fil.      DIR       Udskriv directory af disk.
NEW       Aktiver nyindsat diskette.    MEMORY    Udskriv lagerparametre.
ZAP       Slet hele kildeteksten.       HELP      Udskriv hjælpetekster.
QUIT      Returner til CP/M.

Bemærk, at alle kommandoer kan forkortes til det første bogstav.

Yderligere hjælpetekst om en af de ovenstående kommandoer fås ved at taste
'HELP' eller 'H' efterfulgt af kommandoen (eller det første tegn i den). En
oversigt over editorkommandoer fås ved at taste 'HELP *', eller ved at trykke
@G i editoren.
%ECOMPAS ON-LINE HJÆLP: EDIT kommandoen.

EDIT kommandoen starter editoren. Denne arbejder i to forskellige modes: MOVE
mode og EDIT mode. MOVE mode bruges, når markøren flyttes rundt i teksten, og
EDIT mode når der indsættes eller slettes tegn. Ved start vælger editoren auto-
matisk MOVE mode. @A nøglen bruges til at skifte mellem MOVE og EDIT.

Hvergang EDIT mode bruges til at slette tegn, bliver disse tegn gemt i en edit-
buffer. Ved at trykke @W (i MOVE mode) kan edit-bufferens indhold kopieres
ind i teksten på ethvert sted. Når større blokke af tekst skal slettes, flyttes
eller kopieres, bruges @T til at markere slutningen af blokken. Ved der-
efter at flytte til begyndelsen af blokken og trykke @U, slettes alle tegn
mellem markøren og mærket. Før de slettes gemmer editoren dog en kopi i edit-
bufferen, og denne kan senere genindsættes som beskrevet ovenfor.

Når auto-tabulatoren er aktiveret, laver editoren automatisk en indrykning hver
gang en ny linie startes. Indrykningen svarer altid til linien ovenover.

Yderligere beskrivelse af editorens virkemåde findes i kapitel 3 i COMPAS Bru-
germanualen.

En oversigt over editorens kommandoer fås ved at taste 'HELP *' eller ved at
trykke @G i editoren.
%LCOMPAS ON-LINE HJÆLP: LOAD kommandoen.

LOAD kommandoen bruges til at indlæse en kildetekst fra en diskfil. Kommando-
liniens format er:

        LOAD <filnavn>

Systemet vælger automatisk '.PAS' hvis filtypen udelades. Når en kildetekst
indlæses, bliver den lagt i forlængelse af den kildetekst, der allerede findes
i arbejdslageret. Hvis filen ikke findes, udskriver COMPAS 'No such file', og
hvis der ikke er plads til filen i arbejdslageret, udskriver COMPAS 'File too
big'. Den kildetekst der eventuelt allerede findes i lageret, berøres ikke af
de ovennævnte fejl.
%SCOMPAS ON-LINE HJÆLP: SAVE kommandoen.

SAVE kommandoen bruges til at gemme kildeteksten i arbejdslageret i en diskfil.
Kommandoliniens format er:

        SAVE <filnavn>

Systemet vælger automatisk '.PAS' hvis filtypen udelades. Filer af samme navn,
som det der angives, får deres type ændret til '.BAK', før den nye fil opret-
tes. Hvis diskettens directory er fuldt, udskriver COMPAS 'Directory is full',
og hvis disketten er fuld, udskriver COMPAS 'Disk is full'. Hvis en af disse
fejl rapporteres, så indsæt en anden diskette, tast 'NEW', og brug derefter
SAVE igen.
%CCOMPAS ON-LINE HJÆLP: COMPILE kommandoen.

Når compileren startes fra en COMPILE kommando, bliver objektkoden gemt direkte
ud i arbejdslageret, umiddelbart efter kildeteksten.

Efter endt oversættelse (forudsat at der ikke blev fundet en fejl) informerer
systemet om størrelsen af objektkoden og dataarealet, samt antallet af ledige
bytes:

        Code: rrrrr bytes (aaaa-bbbb)
        Free: sssss bytes (cccc-dddd)
        Data: ttttt bytes (eeee-ffff)

Tallene i parentes er start- og slutadresserne (i hexnotation) på det pågæld-
ende område.

Bemærk, at når editoren anvendes, bliver en eventuel objektkode slettet.
%RCOMPAS ON-LINE HJÆLP: RUN kommandoen.

RUN kommandoen bruges til at starte kørsel af programmet. Hvis der ikke findes
en objektkode, når kommandoen gives, bliver compileren startet for at oversætte
kildeteksten. Forudsat at der ikke blev fundet en fejl under oversættelsen, el-
ler hvis objektkoden allerede er til stede, startes programmet. Når det slut-
ter, bliver kontrollen automatisk overgivet til COMPAS kommandoniveauet.

Hvis der opstår kørselsfejl under udførelsen af programmet, bliver det stoppet,
og en fejlmeddelelse udskrives:

        EXECUTION ERROR 04 AT PC=054E
        Program terminated

FIND kommandoen kan da bruges til at finde den sætning, der var skyld i fejlen
(se 'HELP FIND' hjælpeteksten).
%PCOMPAS ON-LINE HJÆLP: PROGRAM kommandoen.

Når compileren startes fra en PROGRAM kommando, bliver objektkoden lagret i en
diskfil. Mulige kommandolinier er:

        PROGRAM <filnavn>
        PROGRAM <filnavn>,<start>
        PROGRAM <filnavn>,<start>,<slut>
        PROGRAM <filnavn>,,<slut>

hvor <start> og <slut> er hex-adresser (op til fire hexcifre). Systemet vælger
automatisk '.COM' hvis filtypen udelades.

<start> angiver objektkodens startadresse. Hvis <start> udelades, bliver slut-
adressen på run-time programdelen automatisk valgt. <slut> angiver adressen på
toppen af programmets arbejdslager. Hvis <slut> udelades, bliver den nuværende
adresse på toppen af arbejdslageret valgt (denne bestemmes af CP/M operativ-
systemet). Bemærk, at programmer, der er oversat til en given størrelse af
arbejdslageret, ikke kan køres på systemer med mindre arbejdslager.

Førend kildeteksten oversættes, skrives COMPAS en kopi af run-time programdelen
ud i diskfilen. Efter endt oversættelse, kan programmet startes fra CP/M blot
ved at taste dets navn.
%OCOMPAS ON-LINE HJÆLP: OBJECT kommandoen.

OBJECT kommandoen svarer til PROGRAM kommandoen, med den undtagelse, at run-
time programdelen ikke medtages i den diskfil, der genereres af compileren.
Desuden er det ikke '.COM' der automatisk bliver valgt, men i stedet '.OBJ'.
Objektfiler kan kun startes ved et kald til chain standardproceduren fra en
anden COMPAS programfil. Yderligere beskrivelse heraf findes i kapitel 18 i
COMPAS Programmeringsmanualen.
%FCOMPAS ON-LINE HJÆLP: FIND kommandoen.

FIND kommandoen bruges til at finde en sætning i kildeteksten, der svarer til
en given adresse i objektkoden. Mulige kommandolinier er:

        FIND
        FIND <offset>

hvor <offset> er den relative adresse i objektkoden på den sætning, der ønskes
fundet. Adressen skal angives i hexnotation (op til fire hexcifre). Hvis <off-
set> udelades, vælger systemet automatisk adressen på den sidste kørselsfejl.
Således kan man, blot ved at taste 'FIND' efter en kørselsfejl, finde den sæt-
ning i kildeteksten, der er skyld i fejlen.

Hvis compileren finder den adresse der angives, stopper den og udskriver 'Tar-
get address found. Press <SPACE>'. Ved et tryk på <SPACE> startes editoren, og
markøren flytter automatisk til det sted i kildeteksten der blev fundet. I mod-
sat fald udskriver compileren 'Target address not found', hvorpå den returnerer
til kommandoniveauet.
%WCOMPAS ON-LINE HJÆLP: WHERE kommandoen.

WHERE kommandoen starter editoren og flytter markøren til en given position i
kildeteksten. Mulige kommandolinier er:

        WHERE
        WHERE <offset>

hvor <offset> er et hextal der angiver den relative adresse på det sted i kil-
deteksten, der ønskes fundet. Hvis <offset> ikke angives, vælger systemet den
relative adresse på den sidste compilerfejl i en include-fil. Den følgende me-
tode kan anvendes til at finde en compilerfejl, der forekom i en include-fil:
Gem først den nuværende programtekst med SAVE kommandoen, slet herefter teksten
med ZAP kommandoen, indlæs include-filen med LOAD kommandoen, og giv tilsidst
en WHERE kommando uden argument - denne vil starte editoren og flytte markøren
til det sted hvor fejlen forekom.

Når editoren forlades, gemmes markørens relative adresse som den adresse, WHERE
kommandoen anvender, når intet andet angives. Hvis man således bruger WHERE og
ikke EDIT til at starte editoren, bliver markøren placeret på det sted man
sidst forlod og ikke i starten af kildeteksten.
%DCOMPAS ON-LINE HJÆLP: DIR kommandoen.

DIR kommandoen bruges til at udskrive en diskettes directory (bibliotek). For-
matet af kommandolinien er:

        DIR <ffn>

hvor <ffn> er et flertydigt filnavn af samme format som det, der anvendes af
CP/M systemets DIR kommando, dvs. et filnavn hvori spørgsmålstegn (?) og stjer-
ner (*) må indgå.

Et spørgsmålstegn indikerer, at denne position kan indeholde ethvert tegn, og
en stjerne indikerer, at resten af tegnene i det pågældende felt (navnet eller
typen) kan være hvad som helst. Hvis både navnet og typen udelades, altså hvis
kun drive-identifieren og det efterfølgende kolon angives, udskrives navnene på
alle filer på den pågældende diskette. Hvis <ffn> udelades fuldstændigt, ud-
skrives navnene på alle filer på auto-disketten.
%NCOMPAS ON-LINE HJÆLP: NEW kommandoen.

NEW kommandoen bruges til at aktivere en nyindsat diskette og til at ændre
auto-disketten. Mulige kommandolinier er:

        NEW
        NEW <drive>:

hvor <drive> er en drive-identifier (A-P). En NEW kommando skal udføres hver
gang der skiftes diskette i en af diskettestationerne (ellers risikerer man,
at CP/M giver en R/O fejl når man prøver at skrive på disketten). Hvis <drive>
angives, bliver auto-disketten sat til denne diskstation.
%MCOMPAS ON-LINE HJÆLP: MEMORY kommandoen:

MEMORY kommandoen udskriver størrelsen af kildeteksten og det ubrugte arbejds-
lager:

        Text: rrrrr bytes (aaaa-bbbb)
        Free: sssss bytes (cccc-dddd)

hvor tallene i parentes er start- og slutadresserne (i hexnotation) for det på-
gældende område.
%ZCOMPAS ON-LINE HJÆLP: ZAP kommandoen.

ZAP kommandoen sletter den nuværende kildetekst. Som en sikkerhedsforanstalt-
ning spørger kommandoen 'Are you sure (Y/N)?'. Teksten slettes kun hvis der
svares 'Y' eller 'y'.
%QCOMPAS ON-LINE HJÆLP: QUIT kommandoen.

QUIT kommandoen afslutter COMPAS og returnerer til CP/M. COMPAS kan senere
varmstartes med kommandolinien 'COMPAS *'. Dette kræver dog, at der ikke i
mellemtiden er kørt programmer, der har overskrevet dele af arbejdslageret.
«eof»
DataMuseum.dk

CP/M

⟦eaa9ef811⟧ TextFile

Derivation

TextFile
