ckdate(1M) ckdate(1M)
NAME
ckdate, errdate, helpdate, valdate - Fordert zur Eingabe eines Datums
auf und überprüft die Eingabe auf ihre Gültigkeit
SYNTAX
/usr/bin/ckdate [-Q] [-W width] [-f format] [-d default] [-h help]
[-e error] [-p prompt] [-k pid [-s signal]]
/usr/sadm/bin/errdate [-W] [-e error] [-f format]
/usr/sadm/bin/helpdate [-W] [-h help] [-f format]
/usr/sadm/bin/valdate [-f format] input
BESCHREIBUNG
ckdate fordert den Benutzer zu einer Eingabe auf und überprüft deren
Gültigkeit. Über diesen Befehl können unter anderem auch eine Eingabe-
anforderung, auf die ein Datum eingegeben werden muß, ein Hilfetext
und Fehlermeldungen definiert werden, ebenso ein Standardwert, der vom
System zurückgegeben wird, wenn der Benutzer auf die Eingabeaufforde-
rung hin <RETURN> drückt. Die Eingabe des Benutzers muß dem definier-
ten Datumsformat entsprechen.
Alle Meldungen sind auf eine Länge von 70 Zeichen begrenzt und werden
automatisch formatiert. Zwischenräume in der Definition, auch das
Neue-Zeile-Zeichen, werden entfernt. Mit der Option -W wird die auto-
matische Formatierung unterdrückt. Wird am Anfang oder am Ende einer
Meldungsdefinition eine Tilde eingefügt, erscheint an dieser Stelle
der Standardtext, so daß ein vom Benutzer entworfener Text und der
Standardtext zusammen angezeigt werden können.
Wird keine Eingabeaufforderung, Hilfe- oder Fehlermeldung definiert,
wird die entsprechende Standardmeldung angezeigt, wie sie unter HIN-
WEISE beschrieben ist.
Drei visuelle Module sind mit dem Kommando ckdate verbunden, nämlich
errdate zur Formatierung und Anzeige einer Fehlermeldung, helpdate zur
Formatierung und Anzeige einer Hilfemeldung und valdate zur Überprü-
fung der Benutzereingabe. Diese Module sollten zusammen mit FML-
Objekten verwendet werden. In diesem Fall definiert das FML-Objekt die
Eingabeaufforderung. Wenn format in den Modulen errdate und helpdate
definiert wird, beschreiben die Meldungen das erwartete Format.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
ckdate(1M) ckdate(1M)
OPTIONEN
-Q Gibt an, daß quit nicht als gültige Antwort gilt.
-W width Gibt an, daß Eingabeaufforderungs-, Hilfe- und Fehlermel-
dungen auf die Zeilenlänge width formatiert werden.
-f format Gibt das Format an, auf das hin die Eingabe überprüft wird.
Es folgen die Formate und ihre Definitionen:
%b = abgekürzter Monatsname
%B = vollständiger Monatsname
%d = Tag des Monats (01 - 31)
%D = Datum in der Form %m/%t/%j (Standardformat)
%e = Tag des Monats (1 - 31; einfachen Ziffern geht ein
Leerzeichen voraus)
%h = abgekürzter Monatsname (jan, feb, mar)
%m = Monatszahl (01 - 12)
%y = zwei letzten Ziffern der Jahreszahl (z. B. 89)
%Y = vollständige Jahreszahl in der Form JJJJ (z. B.
1989)
-d default default wird als Standardwert definiert. Der Standardwert
braucht den Formatkriterien nicht zu entsprechen.
-h help help erscheint als Hilfemeldung.
-e error error erscheint als Fehlermeldung.
-p prompt prompt erscheint als Eingabeaufforderungsmeldung.
-k pid Gibt an, daß an die Prozeßnummer pid ein Signal gesendet
werden soll, wenn der Benutzer den Vorgang abbricht.
-s signal Gibt an, daß an die Prozeßnummer pid, die über die Option
-k definiert wurde, das Signal signal gesendet werden soll,
wenn der Benutzer quit auswählt. Wird kein Signal angege-
ben, wird SIGTERM benutzt.
eingabe Eingabe, die auf die Übereinstimmung mit den Formatkrite-
rien hin überprüft werden soll.
DIAGNOSE
0 = Ausführung erfolgreich
1 = EOF (Dateiende) bei Eingabe
2 = Falsche Verwendung
3 = Abbruch durch Benutzer (quit)
4 = Verstümmelte Formatangabe
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
ckdate(1M) ckdate(1M)
HINWEISE
Die standardmäßige Eingabeaufforderung von ckdate lautet:
Enter the date [?,q]:
(Datum eingeben [?,q]:)
Die standardmäßige Fehlermeldung lautet:
ERROR - Please enter a date, using the following format: <format>.
(Fehler - Bitte Datum im folgenden Format eingeben: <format>.)
Die standardmäßige Hilfemeldung lautet:
Please enter a date. Format is: <format>.
(Bitte Datum im folgenden Format eingeben: <format>.)
Wird die Option quit, sofern sie erlaubt ist, gewählt, wird q zusammen
mit dem Rückkehrcode 3 zurückgegeben. Das Modul valdate erzeugt keine
Ausgabe. Wenn keine Fehler vorliegen, wird 0 zurückgegeben, ansonsten
eine andere Zahl.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98