FORMAT

FORMAT [(rep)]   parameter dot3.gif (52 bytes)

Dieses Dokument behandelt folgende Themen:

Eine Erläuterung der in dem Syntax-Diagramm verwendeten Symbole entnehmen Sie dem Abschnitt Syntax-Symbole.

Verwandte Statements: ACCEPT/REJECT | AT BREAK | AT START OF DATA | AT END OF DATA | BACKOUT TRANSACTION | BEFORE BREAK PROCESSING | DELETE | END TRANSACTION | FIND | GET SAME | GET TRANSACTION | HISTOGRAM | LIMIT | PASSW | PERFORM BREAK PROCESSING | READ | RETRY | STORE | UPDATE

Gehört zur Funktionsgruppe: Erstellen von Ausgabe-Reports


Funktion

Das Statement FORMAT dient dazu, Werte für Eingabe- und Ausgabeparameter festzusetzen.

Die Gültigkeit der mit einem FORMAT-Statement festgesetzten Werte hat zur Kompilierungszeit Vorrang vor den auf Session-Ebene mit einem GLOBALS-Kommando, SET GLOBALS-Statement oder vom Natural-Administrator gesetzten Parameterwerten.

Die mit dem FORMAT-Statement festgesetzten Werte können ihrerseits auf Statement- oder Elementebene (Feldebene) von den mit den Statements DISPLAY, INPUT, PRINT, WRITE, WRITE TITLE oder WRITE TRAILER gesetzten Parameterwerten überschrieben werden.

Die Einstellungen gelten Sie bis zum Ende des betreffenden Programms, oder bis sie mit einem weiteren FORMAT-Statement geändert werden.

Das FORMAT-Statement generiert keinen ausführbaren Code im Natural-Programm. Seine Ausführung hängt nicht vom logischen Ablauf des Programms ab. Es wird während der Kompilierung ausgewertet, um die Parameter für die Kompilierung der betroffenen DISPLAY-, WRITE-, PRINT- und INPUT-Statements zu setzen. Das FORMAT-Statement wirkt sich auf alle nachfolgenden DISPLAY-, WRITE-, PRINT- und INPUT-Statements aus.

Syntax-Beschreibung

Syntax-Element Beschreibung
(rep)
Report-Spezifikation:

Mit der Notation (rep) kann ein bestimmter anderer Report angegeben werden, auf den sich das FORMAT-Statement beziehen soll.

Es kann ein Wert von 0 bis 31 oder ein logischer Name, der mit einem DEFINE PRINTER-Statement zugewiesen wurde, angegeben werden.

Falls nichts anderes angegeben wird, bezieht sich das FORMAT-Statement auf den ersten Report (Report 0).

Informationen zum Steuern des Formats eines mit Natural erzeugten Ausgabe-Reports siehe Steuerung der Ausgabe von Daten im Leitfaden zur Programmierung.

parameter
Parameter:

Die Parameter können in beliebiger Reihenfolge angegeben werden und müssen jeweils durch ein oder mehr Leerzeichen voneinander getrennt werden. Der Eintrag für einen Parameter darf nicht über das Ende einer Sourcecode-Zeile hinausgehen.

Die hier gültigen feldsensitiven Parameter-Einstellungen kommen nur für Variablenfelder in Betracht, die in einem INPUT-, WRITE-, DISPLAY- oder PRINT-Statement des ausgewählten Reports verwendet werden. Sie haben aber keine Auswirkung auf in einem der erwähnten Statements verwendete Text-Konstanten.

Beispiel:

DEFINE DATA LOCAL
1 VARI (A4)     INIT <'1234'>        /*     Output 
END-DEFINE                           /*    Produced
FORMAT AD=U                          /*    ---------
WRITE 'Text'           VARI          /*    Text 1234
WRITE 'Text' (AD=U)    VARI          /*    Text 1234
END

Siehe auch Parameter weiter unten.

Parameter

Die Beschreibungen der Parameter, die Sie beim FORMAT-Statement verwenden können, finden Sie in der Parameter-Referenz.

Parameter Beschreibung
AD Attribut-Definition
AL Alphanumerische Länge der Ausgabe
BX Feldumrahmung (Box-Definition)
CD Farbdefinition
DF Datumsformat
DL Ausgabelänge
EM Editiermaske
ES Leerzeilenunterdrückung
FC Füllzeichen für DISPLAY-Statement
FL Gleitkomma-Mantissenlänge
GC Füllzeichen für Gruppenüberschriften
HC Überschriften-Zentrierung
HW Überschriftenbreite
IC Einfügungszeichen
ICU Unicode-Einfügungszeichen
IP Eingabeaufforderungstext
IS Unterdrückung identischer Werte
KD PF-Tasten-Anzeige
LC Vorangestellte Zeichens
LCU Vorangestellte Unicode-Zeichen
LS Zeilenlänge
MC Anzahl multipler Feldwerte (Kann nur im Reporting Mode verwendet werden.)
MP Maximale Seitenzahl eines Reports
MS Manuelle Cursor-Positionierung
NL Numerische Länge der Ausgabe
PC Anzahl der Periodengruppen-Ausprägungen (Kann nur im Reporting Mode verwendet werden.)
PM Druck-Modus
PS Länge einer Reportseite
SF Spaltenabstand
SG Vorzeichen-Stelle
TC Nachgezogene Zeichen
TCU Nachgezogene Zeichen (Unicode)
UC Unterstreichungszeichen
ZP Anzeige von Nullwerten

Beispiel

** Example 'FMTEX1': FORMAT                                             
************************************************************************
DEFINE DATA LOCAL                                                       
1 EMPLOY-VIEW VIEW OF EMPLOYEES                                         
  2 NAME                                                                
  2 CITY                                                                
  2 POST-CODE                                                           
  2 COUNTRY                                                             
END-DEFINE                                                              
*                                                                       
FORMAT AL=7    /* Alpha-numeric field output length                     
       FC=+    /* Filler character for field header                     
       GC=*    /* Filler character for group header                     
       HC=L    /* Header left justified                                 
       IC=<<   /* Insert characters                                     
       IS=ON   /* Identical suppress on                                 
       TC=>>   /* Trailing character                                    
       UC==    /* Underline character                                   
       ZP=OFF  /* Zero print off                                 
*                                             
LIMIT 5                                       
READ EMPLOY-VIEW BY NAME                      
  DISPLAY NOTITLE                             
          NAME 3X CITY 3X POST-CODE 3X COUNTRY
END-READ                                      
*                                             
END                      

Ausgabe des Programms FMTEX1:

NAME+++++++   CITY+++++++   POSTAL+++++   COUNTRY++++
                              ADDRESS++++              
===========   ===========   ===========   ===========
                                                     
<<ABELLAN>>   <<MADRID >>   <<28014  >>   <<E  >>    
<<ACHIESO>>   <<DERBY  >>   <<DE3 4TR>>   <<UK >>    
<<ADAM   >>   <<JOIGNY >>   <<89300  >>   <<F  >>    
<<ADKINSO>>   <<BROOKLY>>   <<11201  >>   <<USA>>    
              <<BEVERLE>>   <<90211  >>