Steueranweisungen für die Ausgabe

Der Begriff "Ausgabe" bezieht sich auf die formatierte Version eines Dokuments, die entweder gedruckt, am Bildschirm angezeigt oder als neues Dokument abgelegt werden kann.

Dieses Dokument behandelt die folgenden Themen:


Die auszugebenden Seiten definieren

.OP NPG - Anzahl der auszugebenden Seiten

.OP NPG=zahl

Sie können angeben, wie viele formatierte Seiten Sie ausgeben möchten. Um z.B. die ersten 5 Seiten eines Dokuments auszugeben, geben Sie am Anfang des Rohtextes die folgende Anweisung an:

.OP NPG=5

Index und Inhaltsverzeichnis werden immer nach dem Dokumenttext ausgegeben. Sie werden von dieser Anweisung nicht beeinflusst.

.OP STA - Ausgabe ab einer bestimmten Seite

.OP STA=zahl

Sie können die Ausgabe des formatierten Dokuments mit einer bestimmten Seite beginnen. Alle Seiten vor der angegebenen Seitenzahl werden ignoriert. Um die Ausgabe z.B. mit Seite 11 zu beginnen, geben Sie die folgende Anweisung am Anfang des Rohtextes ein:

.OP STA=11

Anmerkung:
Wenn Sie die obige Anweisung z.B. auf Seite 5 angeben, werden alle Seiten bis zu dieser Anweisung auf Seite 5 ebenfalls ausgegeben.

Index und Inhaltsverzeichnis werden (falls Einträge dafür vorhanden sind) nur für die ausgegebenen Seiten erstellt.

.OP STO - Ausgabe bis zu einer bestimmten Seite

.OP STO=zahl

Sie können die Ausgabe des formatierten Dokuments an einer bestimmten Seite beenden. Alle Seiten nach der angegebenen Seitenzahl werden ignoriert. Um die Ausgabe z.B. mit Seite 20 zu beenden, geben Sie die folgende Anweisung am Anfang des Rohtextes (irgendwo vor Seite 20) an:

.OP STO=20

Index und Inhaltsverzeichnis werden (falls Einträge dafür vorhanden sind) nur für die ausgegebenen Seiten erstellt.

Die Papierkassette definieren

Wenn Ihr Drucker zwei Papierkassetten hat, können Sie angeben, welche benutzt werden soll. Die Anweisungen .OP BIN und .OP SSF müssen in Verbindung mit einem Druckerprofil verwendet werden.

.OP BIN - Papierkassette wählen

.OP BIN=1
.OP BIN=2

Sie können eine von zwei Papierkassetten auswählen.

Um Kassette 1 auszuwählen, geben Sie an:

.OP BIN=1

Um Kassette 2 auszuwählen, geben Sie an:

.OP BIN=2

Wenn die Anweisung .OP BIN im Rohtext vorkommt, erstellt Con-form intern die folgenden Symbole:

F1 Seitenvorschub Kassette 1 (bei .OP BIN=1)
F2 Seitenvorschub Kassette 2 (bei .OP BIN=2)

Wenn Sie keine Papierkassette angeben, erstellt Con-form intern das folgende Symbol:

FF Seitenvorschub

Für jedes Symbol müssen Sie die entsprechende Druckerbefehlsfolge (die in Ihrem Druckerhandbuch dokumentiert ist) in Ihrem Druckerprofil definieren (siehe Con-nect Benutzerhandbuch, Abschnitt Druckerprofile).

.OP SSF - Papierkassette wechseln

.OP SSF=ON
.OP SSF=OFF

Wenn die erste Seite der Ausgabe aus Papierkassette 1 und die folgenden Seiten aus Papierkassette 2 genommen werden sollen, geben Sie an:

.OP SSF=ON

Dies ist sinnvoll, wenn Sie die erste Seite eines Dokuments auf anderem Papier, z.B. auf dickerem oder farbigem Papier, ausdrucken möchten.

Anmerkung:
Wenn .OP SSF=ON angegeben ist, werden damit unvereinbare .OP BIN-Einstellungen ignoriert.

Anfänglich wird das Papier immer der gleichen Papierkassette entnommen. Dies entspricht der Anweisung:

.OP SSF=OFF

Leerzeichen

.CB - Leerzeichen unterdrücken

.CB ON
.CB OFF

Sie können mehrfache Leerzeichen in Ihrem Rohtext durch einzelne Leerzeichen ersetzen. Dazu muss der Zeilenausgleich eingeschaltet sein (.FI ON).

Um mehrfache Leerzeichen durch einzelne Leerzeichen zu ersetzen, geben Sie an:

.CB ON

Wenn sowohl der Zeilenausgleich als auch der Randausgleich eingeschaltet sind (.FI ON;.JU ON), können wegen des Blocksatzes einzelne Leerzeichen anschließend wieder "gedehnt" werden (d.h. zwischen Wörtern werden zusätzliche Leerzeichen eingefügt).

Die anfängliche Einstellung dieser Anweisung ist:

.CB OFF

.SB - Leerzeichen am Zeilenanfang ignorieren

.SB ON
.SB OFF

Ein oder mehrere Leerzeichen am Anfang einer Zeile verursachen einen Zeilenumbruch. Um die Leerzeichen am Zeilenanfang zu ignorieren, geben Sie an:

.SB ON

Die anfängliche Einstellung dieser Anweisung ist:

.SB OFF

Sie können die Anweisung .SB (anders als die Anweisung .CB) auch dann verwenden, wenn der Zeilenausgleich ausgeschaltet ist (.FI OFF). In diesem Fall beginnt die Zeile am linken Rand - ohne die vorausgehenden Leerzeichen.

Sie können auch "feste Leerzeichen" definieren (siehe die Anweisung .TR).

Beispiel

Dieses Beispiel zeigt, wie die Anweisungen .CB und .SB verwendet werden.

Rohtext

.LM 0;.RM 65
.FI ON;.JU OFF
.CB ON
Sie können    alle   mehrfachen Leerzeichen durch    einzelne
Leerzeichen ersetzen.
.IL 1
.FI ON;.JU ON
Wenn    der     Zeilenausgleich eingeschaltet     ist, können
einzelne Leerzeichen    jedoch wieder     "gedehnt" werden,
damit der Blocksatz erreicht wird.
.CB OFF
.IL 1
Ein Leerzeichen am Zeilenanfang bewirkt einen
 Zeilenumbruch. Das Leerzeichen erscheint jedoch in der
formatierten Ausgabe am Anfang der Zeile.
.IL 1
.SB ON
Wenn die Anweisung .SB eingeschaltet ist, wird ein Leerzeichen
         am Zeilenanfang ignoriert.
.IL 1
.FI OFF
Sie können die Anweisung .SB (im Gegensatz zur Anweisung .CB)
     auch benutzen, wenn der Zeilenausgleich ausgeschaltet ist.

Formatierte Ausgabe

Sie können alle mehrfachen Leerzeichen durch einzelne Leerzeichen
ersetzen.

Wenn  der  Zeilenausgleich  eingeschaltet  ist,  können  einzelne
Leerzeichen  jedoch wieder "gedehnt" werden, damit der  Blocksatz
erreicht wird.

Ein Leerzeichen am Zeilenanfang bewirkt einen
 Zeilenumbruch.   Das   Leerzeichen  erscheint  jedoch   in   der
formatierten Ausgabe am Anfang der Zeile.

Wenn die Anweisung .SB eingeschaltet ist, wird ein Leerzeichen am
Zeilenanfang ignoriert.

Sie können die Anweisung .SB (im Gegensatz zur Anweisung .CB)
auch benutzen, wenn der Zeilenausgleich ausgeschaltet ist.

Zeichen umsetzen

Sie können ein bestimmtes Zeichen aus dem Rohtext in der formatierten Ausgabe durch ein anderes Zeichen oder eine Zeichenkette ersetzen.

.TR - Zeichen umsetzen

.TR eingabezeichen ausgabezeichen
.TR 

Mit dieser Anweisung geben Sie für ein bestimmtes Zeichen des Rohtextes ein anderes Zeichen in der formatierten Ausgabe aus. Die Parameter sind jeweils ein einzelnes Zeichen oder deren entsprechende hexadezimale Darstellung.

Der erste Parameter (Eingabezeichen) definiert das Zeichen, das Sie umsetzen möchten; der zweite Parameter (Ausgabezeichen) definiert das Zeichen, das stattdessen ausgegeben werden soll. Zwischen den beiden Parametern muss ein Leerzeichen stehen.

Sie können so viele verschiedene .TR-Anweisungen angeben, wie erforderlich sind.

Ein einzelnes Zeichen umsetzen

Um z.B. den Kleinbuchstaben "a" in den Großbuchstaben "A" umzusetzen, geben Sie an:

.TR a A

Wenn Sie das Anweisungstrennzeichen (anfänglich das Semikolon) als Parameter angeben möchten, müssen Sie es doppelt eingeben (;;).

Hexadezimale Darstellung

Wenn Sie auf einem Mainframe arbeiten und den Kleinbuchstaben "a" in den Großbuchstaben "A" umsetzen möchten, müssen Sie die Anweisung .TR mit den entsprechenden EBCDIC-Zeichen angeben:

.TR 81 C1

Wenn Con-form auf einem Mainframe installiert ist, sollten die folgenden Zeichen nicht in der Anweisung .TR benutzt werden (X ist das umzusetzende Zeichen):

.TR X 00
.TR X 03
.TR X 04
.TR X 0E
.TR X 0F
.TR X 27
.TR X 3F
.TR X 40
.TR X FE

Ein "festes Leerzeichen" angeben

Wenn Sie sicherstellen möchten, dass beim Zeilenausgleich keine zusätzlichen Leerzeichen zwischen zwei Wörtern eingefügt werden, können Sie im Rohtext an den entsprechenden Stellen feste Leerzeichen definieren. An diesen Stellen findet auch kein Zeilenumbruch statt.

Um ein festes Leerzeichen zu definieren, müssen Sie ein hexadezimales Ausgabezeichen angeben.

40 ist die EBCDIC-Darstellung für das feste Leerzeichen. Beispiel:

.TR ^ 40
Siehe Kapitel^7.

In diesem Beispiel wurde das definierte Eingabezeichen (^) zwischen dem Wort "Kapitel" und der Kapitelnummer "7" eingefügt. In der formatierten Ausgabe werden diese in derselben Zeile mit genau einem Leerzeichen dazwischen ausgegeben.

Eine Zeichenumsetzung rückgängig machen

Um das Umsetzen eines Zeichens wieder rückgängig zu machen, müssen Sie das entsprechende Zeichen in beiden Parametern der Anweisung .TR angeben. Um z.B. die Anweisung .TR a A rückgängig zu machen, geben Sie an:

.TR a a

Alle Zeichenumsetzungen rückgängig machen

Um alle Zeichenumsetzungen wieder rückgängig zu machen, geben Sie die Anweisung .TR ohne Parameter an:

.TR

Alle Umsetzungen werden ausgeführt, nachdem eine Rohtextzeile formatiert wurde. Deshalb ist die Position der Anweisung .TR (die alle Zeichenumsetzungen rückgängig machen soll) wichtig, besonders bei eingeschaltetem Zeilenausgleich (.FI ON). Dies zeigt das folgende Beispiel:

.LM 0;.RM 72
.FI ON;.JU OFF
.TR a A
Jedes kleine "a" wird in ein großes "A" umgewandelt.
.TR
Die formatierte Ausgabe zeigt jedoch ein unerwartetes Ergebnis,
da die Anweisung .TR (die alle Umsetzungen rückgängig macht) an
einer Stelle im Rohtext steht, wo die gesamte Zeile noch nicht
formatiert (d.h. durch den Zeilenausgleich gefüllt) worden ist.
.IL
.TR a A
Wenn Sie ein bestimmtes Zeichen in einem Abschnitt durch ein
anderes Zeichen ersetzen möchten, sollte die Anweisung .TR (die
alle Umsetzungen rückgängig macht) nach dem nächsten Zeilenumbruch
angegeben werden.
.IL;.TR

Die formatierte Ausgabe sieht folgendermaßen aus:

Jedes kleine "a" wird in ein großes "A" umgewandelt. Die formatierte
Ausgabe zeigt jedoch ein unerwartetes Ergebnis, da die Anweisung .TR
(die alle Umsetzungen rückgängig macht) an einer Stelle im Rohtext
steht, wo die gesamte Zeile noch nicht formatiert (d.h. durch den
Zeilenausgleich gefüllt) worden ist.

Wenn Sie ein bestimmtes Zeichen in einem Abschnitt durch ein Anderes
Zeichen ersetzen möchten, sollte die Anweisung .TR (die Alle
Umsetzungen rückgängig mAcht) nAch dem nächsten Zeilenumbruch
Angegeben werden.

.TS - Ein Zeichen in eine Zeichenkette umsetzen

.TS eingabezeichen ausgabezeichenkette
.TS eingabezeichen
.TS

Mit dieser Anweisung setzen Sie ein bestimmtes Zeichen in eine Zeichenkette um. Der erste Parameter (Eingabezeichen) definiert das umzusetzende Zeichen; der zweite Parameter (Ausgabezeichenkette) gibt an, wie das Zeichen ausgegeben werden soll. Zwischen beiden Parametern muss ein Leerzeichen stehen.

Wie bei der Anweisung .TR muss als Eingabezeichen entweder ein einzelnes Zeichen oder seine entsprechende hexadezimale Darstellung angegeben werden. Die Ausgabezeichenkette kann aus mehreren Zeichen bestehen. Sie darf Leerzeichen enthalten, jedoch keine hexadezimalen Werte.

Sie können so viele verschiedene .TS-Anweisungen angeben, wie erforderlich sind.

Tipp:
Wenn Sie ein Zeichen in ein anderes einzelnes Zeichen umsetzen möchten, wird empfohlen, die Anweisung .TR zu verwenden.

Um z.B. das Zeichen "/" in die Zeichenkette "Schrägstrich" umzusetzen, geben Sie an:

.TS / Schrägstrich

Wenn das Eingabezeichen in der Ausgabezeichenkette wieder auftritt, wird es nicht noch einmal umgesetzt. Wenn Sie das Anweisungstrennzeichen (anfänglich das Semikolon) als Parameter angeben möchten, müssen Sie es doppelt eingeben (;;).

Alle Umsetzungen werden - anders als bei der Anweisung .TR - ausgeführt, bevor eine Rohtextzeile formatiert wird.

Anmerkung:
Alle Zeichen im Rohtext werden verarbeitet, auch diejenigen, die das Ergebnis einer Variablenersetzung sind (siehe die Anweisung .SV).

Eine Zeichenumsetzung rückgängig machen

Um das Umsetzen eines Zeichens wieder rückgängig zu machen, müssen Sie das Zeichen angeben, das Sie vorher als Eingabezeichen definierten. Die Ausgabezeichenkette müssen Sie nicht angeben.

Um z.B. die Umsetzung rückgängig zu machen, die durch die Anweisung .TS / Schrägstrich (siehe oben) definiert wurde, geben Sie an:

.TS /

Alle Zeichenumsetzungen rückgängig machen

Um alle Zeichenumsetzungen wieder rückgängig zu machen, geben Sie die Anweisung .TS ohne Parameter an:

.TS

Beispiel

Dieses Beispiel zeigt die Anweisungen .TR und .TS.

Rohtext

.TR - =
Der Bindestrich wird durch das Gleichheitszeichen ersetzt.
----------------------------------------------------------
.TR - -;.** Die vorherige Umsetzung rückgängig machen.
Nun wird der Bindestrich (-) in der formatierten Ausgabe nicht
umgesetzt.
.LM 0;.RM 45
.FI ON;.JU ON
.IL 1
.** Den Unterstrich als festes Leerzeichen benutzen.
.** Dieses Beispiel funktioniert in einer Mainframe-Umgebung.
.** Die hexadezimale Darstellung für das Leerzeichen ist 40.
.TR _ 40
Wenn Sie im Rohtext_feste_Leerzeichen definieren,_werden in_der
formatierten Ausgabe_an_diesen_Stellen keine zusätzlichen
Leerzeichen eingefügt. Außerdem erfolgt an der_Position_eines_
festen_Leerzeichens kein Zeilenumbruch.
.TR;.IL 1
.LM 0;.RM 70
.TS * Dieser Ausgabetext wird vom Stern (*) verursacht.
.TS / Noch ein Ausgabetext, diesmal verursacht vom Schrägstrich (/).
Wenn ein Stern im Rohtext vorkommt, wird folgendes ausgegeben: *
Wenn ein Schrägstrich im Rohtext vorkommt, wird folgendes
ausgegeben: /
.IL 1
.TS;.** Alle Umsetzungen rückgängig machen.
Wie im obigen Beispiel gezeigt, können Sie das Eingabezeichen (* und /)
in den Ausgabetext einfügen. In diesem Fall wird das Zeichen nicht
noch einmal umgewandelt.

Formatierte Ausgabe

Der Bindestrich wird durch das Gleichheitszeichen ersetzt.
==========================================================
Nun wird der Bindestrich (-) in der formatierten Ausgabe nicht
umgesetzt.

Wenn    Sie   im    Rohtext feste Leerzeichen
definieren, werden     in der    formatierten
Ausgabe an diesen Stellen  keine zusätzlichen
Leerzeichen  eingefügt.  Außerdem erfolgt  an
der Position eines   festen Leerzeichens kein
Zeilenumbruch.

Wenn  ein Stern im Rohtext vorkommt, wird folgendes ausgegeben: Dieser
Ausgabetext  wird  vom Stern (*) verursacht. Wenn ein Schrägstrich  im
Rohtext  vorkommt,  wird folgendes ausgegeben: Noch  ein  Ausgabetext,
diesmal verursacht vom Schrägstrich (/).

Wie  im obigen Beispiel gezeigt, können Sie das Eingabezeichen (*  und
/)  in den Ausgabetext einfügen. In diesem Fall wird das Zeichen nicht
noch einmal umgewandelt.

Die Textrichtung ändern

.TO - Textrichtung ändern

.TO L
.TO R

Diese Anweisung ist sinnvoll, wenn Sie Text in Ihr Dokument aufnehmen möchten, der während des Formatiervorgangs von rechts nach links verarbeitet werden soll (z.B. wenn Sie ein hebräisches Zitat in den Text einfügen möchten).

Diese Anweisung hat keine Auswirkung auf die Darstellung oder die Zeilenformatierung, da Con-form annimmt, dass der betreffende Text von der entsprechenden Hardware verarbeitet wird. Sie übergibt lediglich den Wert für die geltende Textrichtung an die Routine, die benutzt wird, um RFT-DCA-Dokumente in Con-form-Dokumente (und umgekehrt) zu konvertieren.

Anfänglich wird der Text von links nach rechts verarbeitet. Dies entspricht der Anweisung:

.TO L

Um den Text von rechts nach links zu verarbeiten, geben Sie an:

.TO R

Die Bedeutung von "links" und "rechts" für die Anweisungen .LM und .RM muss nun anders interpretiert werden. Der linke Rand ist z.B. die Seite, wo Sie zu schreiben beginnen (das ist nun physisch die rechte Seite), und der rechte Rand ist die Seite, wo Sie aufhören zu schreiben (physisch die linke Seite).

Auch wenn Text von rechts nach links verarbeitet wird, werden die arabischen Seitenzahlen (definiert durch das Seitenzahlzeichen - anfänglich das Zeichen #) immer von links nach rechts verarbeitet.

Anmerkung:
Siehe auch die Textfunktion I. Diese Textfunktion bewirkt, dass der Inhalt einer Variablen in umgekehrter Richtung verarbeitet wird.

Die Textrichtung mit Umschaltanweisungen ändern

Sie können auch Umschaltanweisungen verwenden, um die Richtung zu ändern, in der Ihr Text verarbeitet wird. Dazu müssen Sie zuerst das Umschaltzeichen definieren (siehe .OP ESC - Umschaltzeichen definieren).

Wenn Ihr Text von links nach rechts verarbeitet wird, können Sie die folgenden Symbole in den Rohtext eingeben, um die Richtung für den markierten Text zu ändern:

Z1 Richtung von-rechts-nach-links einschalten
Z0 Richtung von-rechts-nach-links ausschalten

Wenn Ihr Text von rechts nach links verarbeitet wird, können Sie die folgenden Symbole in den Rohtext eingeben, um die Richtung für den markierten Text zu ändern:

A1 Richtung von-links-nach-rechts einschalten
A0 Richtung von-links-nach-rechts ausschalten

Die obigen Symbole werden während der Zeilenformatierung verarbeitet. Sie können sie auch mit anderen Symbolen kombinieren (z.B. M1 und M0). Dabei müssen Sie darauf achten, die Symbole korrekt zu schachteln.

Für Text, der die obigen Symbole enthält, dürfen Sie das Tabulatorzeichen (siehe .TB - Tabulator setzen) nicht verwenden.

Fehlerbehebung

.OP ECH - Anweisungen ausgeben

.OP ECH=ON
.OP ECH=OFF

Sie können alle im Rohtext enthaltenen Con-form-Anweisungen in der formatierten Ausgabe vor dem jeweiligen Text ausgeben. Dies ist hilfreich, wenn die Ausgabe nicht wie gewünscht formatiert wurde und Sie überprüfen wollen, ob die Con-form-Anweisungen im Rohtext korrekt angegeben wurden.

Um die Con-form-Anweisungen auszugeben, geben Sie an:

.OP ECH=ON

Diese Option ist anfänglich ausgeschaltet. Dies entspricht der Anweisung:

.OP ECH=OFF

Wenn Sie nur einen Teil des Rohdokuments überprüfen möchten, können Sie den betreffenden Text zwischen die beiden obigen Anweisungen einschließen.

Anmerkung:
Die Con-form-Anweisungen werden nicht in allen Umgebungen ausgegeben.

.DU - Speicherauszug drucken

.DU

Diese Anweisung ist eine Diagnostikhilfe und sollte nur auf Anforderung des Software AG Support benutzt werden. Geben Sie die Anweisung .DU im Rohtext direkt vor dem Punkt an, an dem das Programm mit Fehler endete, und drucken Sie dann die formatierte Version des Rohtextes aus.