Informationen aus einer Kalenderdatei anfordern
Komponente: | CALENDAR |
Funktionsbereich: | Auftragsverarbeitung |
Anwendungsbereich: | UTILITIES |
Privilegierung: | STD-PROCESSING |
Funktionsbeschreibung
Das Kommando SHOW-CALENDAR informiert über die Kalenderdaten aus der angegebenen Kalenderdatei.
Standardmäßig (SELECT=*TODAY) werden folgende Informationen über den aktuellen Tag ausgegeben: der Name der Kalenderdatei, das aktuelle Datum, die Bezeichnung des Wochentags (Montag...Sonntag), das Attribut des aktuellen Tags (freier Tag / Arbeitstag), die Anzahl der zugehörigen SYMDAT (symbolische Datumsangaben), die Arbeitszeit, gegebenenfalls der Feiertagsname, die Namen der zugehörigen SYMDAT mit zugeordneten Zeitangaben.
Mit SELECT=*BASIC-INFORMATION werden die Basis-Informationen der Kalenderdatei zur Ausgabe angefordert: Name des Kalenders, Kalendergrenzen und Definitionen der Standard-Arbeitswoche. In der Standard-Arbeitswoche sind das Attribut und die Arbeitszeit für die Wochentage festgelegt.
Mit SELECT=*DATE werden die Tagesinformationen über einen oder mehrere Tage angefordert: das Datum, die Wochentagsbezeichnung, das Attribut, die Anzahl der zugeordneten SYMDAT, die Arbeitszeit, gegebenenfalls der Feiertagsname, über spezielle Angabe auch die Namen der zugehörigen SYMDAT mit zugeordneten Zeitangaben.
Mit SELECT=*SYMBOLIC-DATE werden Informationen über SYMDAT zur Ausgabe angefordert. SYMDAT sind symbolische Datumsangaben, unter deren Namen mehrere Kalendertage zusammengefasst werden (vgl. Handbuch „CALENDAR“ [4]).
Mit SELECT=*HOLIDAY werden Informationen über Feiertage zur Ausgabe angefordert. Die Ausgabe kann nach SYSOUT oder SYSLST gelenkt werden.
Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").
SHOW-CALENDAR greift nur lesend auf die angegeben Kalenderdatei zu. Eine Kalenderdatei kann mit dem Dienstprogramm CALENDAR oder über die
Programmschnittstelle (Makro CALENDR) erstellt und modifiziert werden. Das Dienstprogramm CALENDAR wird mit dem Kommando START-CALENDAR-EDITOR gestartet. Das Dienstprogramm und die Programmschnittstelle sind in dem Handbuch „CALENDAR“ [4] ausführlich beschrieben.
Format
SHOW-CALENDAR | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operandenbeschreibung
CALENDAR-NAME = <filename 1..54>
Name der Kalenderdatei, aus der Informationen zur Ausgabe angefordert werden.
SELECT = *TODAY / *BASIC-INFORMATION / *DATE(...) / *SYMBOLIC-DATE(...) / *HOLIDAY(...)
Gibt an, welche Informationen aus der Kalenderdatei ausgegeben werden sollen.
SELECT = *TODAY
Gibt die Informationen für den aktuellen Tag aus:
den Namen der Kalenderdatei
das aktuelle Datum
die Bezeichnung des Wochentages
das Attribut: W (Work) = Arbeitstag oder F (Free) = freier Tag
die Anzahl der zugehörigen SYMDAT
die Arbeitszeit (Beginn und Ende)
gegebenenfalls den Namen des Feiertags
eine Liste mit den Namen der zugehörigen SYMDAT und den diesen zugeordneten Zeitangaben (sortiert nach Zeiteinträgen)
SELECT = *BASIC-INFORMATION
Gibt die Basis-Informationen des Kalenders aus:
den Namen der Kalenderdatei
die Kalendergrenzen
die Tage der Standard-Arbeitswoche mit Attributen (Arbeitstag / freier Tag).
SELECT = *DATE(...)
Gibt Tagesinformationen für einen Bereich von Tagen aus. Der gewünschte Bereich wird über die untergeordneten Operanden FROM und TO ausgewählt. Für jeden ausgewählten Tag wird ausgegeben:
das Datum
die Bezeichnung des Wochentages
das Attribut: W (Work) = Arbeitstag oder F (Free) = freier Tag
die Anzahl der zugehörigen SYMDAT
die Arbeitszeit (Beginn und Ende)
gegebenenfalls den Namen des Feiertags
Über den untergeordneten Operanden ASSIGNED-SYM-DATE kann zusätzlich eine Liste mit den Namen der zugehörigen SYMDAT und den diesen zugeordneten Zeiten angefordert werden.
FROM = *TODAY / *FIRST-CALENDAR-DATE / <date>
Bestimmt den ersten Tag, ab dem Informationen ausgegeben werden sollen.
FROM = *TODAY
Die Ausgabe beginnt mit dem aktuellen Tag.
FROM = *FIRST-CALENDAR-DATE
Die Ausgabe beginnt mit dem ersten Tag in der Kalenderdatei.
FROM = <date>
Die Ausgabe beginnt mit dem angegebenen Datum.
TO = *SAME / *TODAY / *LAST-CALENDAR-DATE / <date> / *BY-NUMBER-OF-DAYS(...)
Bestimmt den letzten Tag, bis zu dem Informationen ausgegeben werden sollen.
TO = *SAME
Es werden nur Informationen über den bei FROM angegebenen Tag ausgegeben.
TO = *TODAY
Die Ausgabe endet mit dem aktuellen Tag.
TO = *LAST-CALENDAR-DATE
Die Ausgabe endet mit dem letzten Tag in der Kalenderdatei.
TO = *BY-NUMBER-OF-DAYS(...)
Bestimmt die Größe des gewünschten Bereichs in Tagen, beginnend mit dem bei FROM angegebenen Tag.
NUMBER-OF-DAYS = <integer 1..1827 days >
Anzahl der Tage.
ASSIGNED-SYM-DATE = *NONE / *ALL(...) / <filename 1..20 without-cat-user-gen-vers with-wild>(...)
Gibt an, ob zusätzlich zu der Ausgabe von Kalendertagen die zugeordneten SYMDAT ausgegeben werden.
Voreingestellt ist *NONE, d.h. es wird keine zusätzliche Liste ausgegeben.
ASSIGNED-SYM-DATE = *ALL(...)
Es werden zusätzlich alle Namen der den angegebenen Kalendertagen zugeordneten SYMDAT ausgegeben.
ORDER-WITHIN-DAY = *BY-TIME / *BY-SYMBOLIC-DATE
Bestimmt das Sortierkriterium. Die Ausgabe wird nach der zugeordneten Uhrzeit (*BY-TIME; Voreinstellung) oder alphabetisch nach SYMDAT-Namen (*BY-SYMBOLIC-DATE) sortiert.
ASSIGNED-SYM-DATE = <filename 1..20 without-cat-user-gen-vers with-wild>(...)
Es wird zusätzlich das angegebene SYMDAT bzw. die über die Musterzeichenfolge benannte Gruppe von SYMDAT ausgegeben. (Über eine Musterzeichenfolge können mehrere SYMDAT mit einer Angabe ausgewählt werden, wobei nur das Musterzeichen * am Ende für beliebige Zeichenfolge erlaubt ist.)
ORDER-WITHIN-DAY = *BY-TIME / *BY-SYMBOLIC-DATE
Bestimmt das Sortierkriterium.
Die Ausgabe kann nach der zugeordneten Uhrzeit (*BY-TIME; Voreinstellung) oder alphabetisch nach SYMDAT-Namen (*BY-SYMBOLIC-DATE) sortiert werden.
SELECT = *SYMBOLIC-DATE(...)
Gibt Informationen über die im Kalender definierten SYMDAT aus. Der Umfang der Ausgabe wird über die untergeordneten Operanden FROM und TO festgelegt. Über den untergeordneten Operanden ASSIGNED-DATES kann die zusätzliche Ausgabe der zugeordneten Tage veranlasst werden.
FROM = *FIRST-SYMBOLIC-DATE / <filename 1..20 without-cat-user-gen-vers with-wild>
Gibt an, ab welchem SYMDAT die Ausgabe erfolgen soll.
FROM = *FIRST-SYMBOLIC-DATE
Die Ausgabe beginnt mit dem in alphabetischer Reihenfolge ersten SYMDAT.
FROM = <filename 1..20 without-cat-user-gen-vers with-wild>
Die Ausgabe beginnt mit dem angegebenen SYMDAT bzw. mit der Gruppe von SYMDAT (in alphabetischer Reihenfolge), die durch die Musterzeichenfolge benannt wird. (Über eine Musterzeichenfolge können mehrere SYMDAT ausgewählt werden, wobei nur das Musterzeichen * am Ende für beliebige Zeichenfolge erlaubt ist.)
TO = *SAME / *LAST-SYMBOLIC-DATE / <filename 1..20 without-cat-user-gen-vers with-wild> /
*BY-NUMBER-OF-SYMBOLIC-DATES(...)
Gibt an, bis zu welchem SYMDAT die Ausgabe erfolgen soll.
TO = *SAME
Es gilt dieselbe Angabe wie im Operanden FROM.
TO = *LAST-SYMBOLIC-DATE
Die Ausgabe endet mit dem SYMDAT, das in alphabetischer Reihenfolge an letzter Stelle steht.
TO = <filename 1..20 without-cat-user-gen-vers with-wild>
Die Ausgabe endet mit dem angegebenen SYMDAT bzw. der Gruppe von SYMDAT (in alphabetischer Reihenfolge), die durch die Musterzeichenfolge benannt wird.
(Über eine Musterzeichenfolge können mehrere SYMDAT ausgewählt werden, wobei nur das Musterzeichen * am Ende für beliebige Zeichenfolge erlaubt ist.)
TO = *BY-NUMBER-OF-SYMBOLIC-DATES(...)
Bestimmt die Anzahl der auszugebenden SYMDAT, beginnend mit dem bei FROM angegeben SYMDAT.
NUMBER-OF-SYM-DATES = <integer 1..4096>
Anzahl der SYMDAT.
ASSIGNED-DATES = *NO / *ALL / *NEXT-DATE / *INTERVAL(...)
Gibt an, ob zusätzlich die einem ausgewählten SYMDAT zugeordneten Kalendertage ausgegeben werden sollen.
Voreingestellt ist *NO, d.h. es wird keine zusätzliche Liste ausgegeben.
ASSIGNED-DATES = *ALL
Es werden zusätzlich alle Kalendertage, die dem ausgewählten SYMDAT zugordnet sind, ausgegeben.
ASSIGNED-DATES = *NEXT-DATE
Es werden zusätzlich alle Kalendertage, die dem ausgewählten SYMDAT zugeordnet sind, ab dem aktuellen Datum ausgegeben.
ASSIGNED-DATES = *INTERVAL(...)
Bestimmt einen Bereich von aufzulistenden Tagen.
FROM = *TODAY / *FIRST-ASSIGNED-DATE / <date>
Erster Tag im Bereich der aufzulistenden Tage.
FROM = *TODAY
Der Bereich beginnt mit dem aktuellen Tag.
FROM = *FIRST-ASSIGNED-DATE
Der Bereich beginnt mit dem ersten zugeordneten Tag.
FROM = <date>
Der Bereich beginnt mit dem angegeben Tag.
TO = *SAME / *TODAY / *LAST-ASSIGNED-DATE / <date> / *BY-NUMBER-OF-DAYS(...)
Letzter Tag im Bereich der aufzulistenden Tage.
TO = *SAME
Es gilt dieselbe Angabe wie im Operanden FROM.
TO = *TODAY
Der Bereich endet mit dem aktuellen Tag.
TO = *LAST-ASSIGNED-DATE
Der Bereich endet mit dem letzten zugeordneten Tag.
TO = <date>
Der Bereich endet mit dem angegebenen Tag.
TO = *BY-NUMBER-OF-DAYS(...)
Bestimmt die Anzahl der aufzulistenden Tage, beginnend mit dem bei FROM
angegebenen Tag.
NUMBER-OF-DAYS = <integer 1..1827 days >
Anzahl der Tage.
SELECT = *HOLIDAY(...)
Gibt Informationen über Feiertage aus. Ausgegeben werden die Namen der Feiertage und ihre Eigenschaften (Typ: zyklisch / nicht-zyklisch; Aktivierungszustand: ja / nein). Der Umfang der Ausgabe wird über die untergeordneten Operanden FROM und TO festgelegt. Über den untergeordneten Operanden ASSIGNED-DATES kann zusätzlich eine Auflistung der zugeordneten Kalendertage angefordert werden.
FROM = *FIRST-HOLIDAY / <filename 1..30 without-cat-user-gen-vers with-wild>
Gibt an, mit welchem Feiertag die Ausgabe beginnen soll.
FROM = *FIRST-HOLIDAY
Die Ausgabe beginnt mit dem alphabetisch ersten Feiertag in der Kalenderdatei.
FROM = <filename 1..30 without-cat-user-gen-vers with-wild>
Die Ausgabe beginnt mit dem angegebenen Feiertag bzw. der Gruppe von Feiertagen(in alphabetischer Reihenfolge), die durch die Musterzeichenfolge benannt wird.
(Über eine Musterzeichenfolge können mehrere Feiertage ausgewählt werden, wobei nur das Musterzeichen * am Ende für beliebige Zeichenfolge erlaubt ist.)
TO = *SAME / <filename 1..30 without-cat-user-gen-vers with-wild> / *LAST-HOLIDAY /
*BY-NUMBER-OF-HOLIDAYS(...)
Gibt an, bis zu welchem Feiertag ausgegeben werden soll.
TO = *SAME
Es gilt dieselbe Angabe wie im Operanden FROM.
TO = *LAST-HOLIDAY
Die Ausgabe endet mit dem alphabetisch letzten Feiertag in der Kalenderdatei.
TO = <filename 1..30 without-cat-user-gen-vers with-wild>
Die Ausgabe endet mit dem angegebenen Feiertag bzw. der Gruppe von Feiertagen (in alphabetischer Reihenfolge), die durch die Musterzeichenfolge benannt wird.
(Über eine Musterzeichenfolge können mehrere Feiertage ausgewählt werden, wobei nur das Musterzeichen * am Ende für beliebige Zeichenfolge erlaubt ist.)
TO = *BY-NUMBER-OF-HOLIDAYS(...)
Bestimmt die Anzahl der auszugebenden Feiertage, beginnend mit dem bei FROM angegebenen Feiertag.
NUMBER-OF-HOLIDAYS = <integer 1..1024 days >
Anzahl der auszugebenden Tage.
ASSIGNED-DATES = *NO / *YES
Gibt an, ob zusätzlich alle Kalendertage aufgelistet werden, die auf die ausgewählten Feiertage fallen.
Voreingestellt ist *NO, d.h. es wird keine zusätzliche Liste ausgegeben.
OUTPUT = *SYSOUT / list-poss(2): *SYSOUT / *SYSLST(...)
Gibt an, ob die Ausgabe nach SYSOUT oder SYSLST erfolgen soll.
Voreingestellt ist *SYSOUT. Die gleichzeitige Ausgabe nach SYSLST und SYSOUT ist möglich (Listenangabe).
OUTPUT = *SYSLST(...)
Die Ausgabe erfolgt nach SYSLST.
SYSLST-NUMBER = *STD / <integer 1..99>
Nummer der SYSLST-Datei.
Voreingestellt ist *STD, d.h. die Ausgabe erfolgt nach SYSLST.
Bei Angabe einer Nummer ist darauf zu achten, dass der entsprechenden SYSLST-Datei (SYSLST01 bis SYSLST99) eine katalogisierte Datei zugewiesen ist (vgl. Kommando ASSIGN-SYSLST).
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
0 | CMD0001 | Kommando erfolgreich ausgeführt | |
64 | CLD1031 | Kalenderdatei existiert nicht | |
64 | CLD1032 | Kalenderdatei existiert nicht |
Ausgabeformate
Über den Operanden OUTPUT kann die gewünschte Ausgabe nach SYSOUT und / oder nach SYSLST gelenkt werden. Der Anwender hat die Möglichkeit, eine deutschsprachige Oberfläche einzustellen. Die nachfolgend beschriebenen Layouts der englischen Oberfläche sind für SYSOUT und SYSLST identisch.
SHOW-CALENDAR kalender.arbeit-3
%------------------------------------------------------------------------ % INFORMATION ABOUT CURRENT DAY %------------------------------------------------------------------------ % CALENDAR NAME: :2OSG:$USER1.KALENDER.ARBEIT-3 % %------------------------------------------------------------------------ % DATE DAY ATTR #SYM WORKING HOURS HOLIDAY %------------------------------------------------------------------------ % % 2012-01-30 MON W 2 07:30-15:00 % %- SYMBOLIC DATE ---------- TIME ----- SYMBOLIC DATE ---------- TIME ---- % % INFOTAG 13:00:00 ULTIMO 13:00:00 %------------------------------------------------------------------------ ... ...
SHOW-CALENDAR kalender.arbeit-3,SELECT=*BASIC-INFORMATION
%------------------------------------------------------------------------ % BASIC INFORMATION %------------------------------------------------------------------------ % CALENDAR NAME: :2OSG:$USER1.KALENDER.ARBEIT-3 % %------------------------------------------------------------------------ % CALENDAR LIMITS START : 2011-01-30 % END : 2012-01-30 %------------------------------------------------------------------------ % STANDARD WEEK WORKING HOURS % START END % DAY ATTR (HH:MM) (HH:MM) %------------------------------------------------------------------------ % MON W 08:30 - 17:00 % TUE W 08:30 - 17:00 % WED W 08:30 - 17:00 % THU W 08:30 - 17:00 % FRI W 07:30 - 15:00 % SAT F 00:00 - 23:59 % SUN F 00:00 - 23:59 %------------------------------------------------------------------------
SHOW-CALENDAR kalender.arbeit-3,SELECT=*DATE(FROM=2011-12-20,TO=2012-01-02)
/sh-cal kalender.arbeit-3,sel=*date(from=2011-12-20,to=2012-01-02)
%------------------------------------------------------------------------ % LIST OF DAYS %------------------------------------------------------------------------ % CALENDAR NAME: :2OSG:$USER1.KALENDER.ARBEIT-3 % %------------------------------------------------------------------------ % DATE DAY ATTR #SYM WORKING HOURS HOLIDAY %------------------------------------------------------------------------ % % 2011-12-20 TUE F 0 00:00-23:59 % 2011-12-21 WED F 0 00:00-23:59 % 2011-12-22 THU W 0 08:30-17:00 % 2011-12-23 FRI W 0 08:30-17:00 % 2011-12-24 SAT W 0 08:30-17:00 % 2011-12-25 SUN F 0 08:30-17:00 ERSTER.WEIHNACHTSFEIERTAG % 2011-12-26 MON F 0 07:30-15:00 ZWEITER.WEIHNACHTSFEIERTAG % 2011-12-27 TUE F 0 00:00-23:59 % 2011-12-28 WED F 0 00:00-23:59 % 2011-12-29 THU W 0 08:30-17:00 % 2011-12-30 FRI W 0 08:30-17:00 % 2011-12-31 SAT W 2 08:30-17:00 % 2012-01-01 SUN F 0 08:30-17:00 NEUJAHR % 2012-01-02 MON W 0 07:30-15:00 %------------------------------------------------------------------------
SHOW-CALENDAR kalender.arbeit-3,SELECT=*DATE(FROM=2012-01-29,
TO=2012-02-01,ASSIGNED-SYM-DATE=*ALL)
%------------------------------------------------------------------------ % DAY INFORMATION %------------------------------------------------------------------------ % CALENDAR NAME: :2OSG:$USER1.KALENDER.ARBEIT-3 % %------------------------------------------------------------------------ % DATE DAY ATTR #SYM WORKING HOURS HOLIDAY %------------------------------------------------------------------------ % % 2012-01-29 THU W 0 08:30-17:00 % %------------------------------------------------------------------------ % DATE DAY ATTR #SYM WORKING HOURS HOLIDAY %------------------------------------------------------------------------ % % 2012-01-30 FRI W 2 07:30-15:00 % %- SYMBOLIC DATE ---------- TIME ----- SYMBOLIC DATE ---------- TIME ---- % % INFOTAG 13:00:00 ULTIMO 13:00:00 %------------------------------------------------------------------------ % DATE DAY ATTR #SYM WORKING HOURS HOLIDAY %------------------------------------------------------------------------ % % 2012-01-31 SAT F 0 00:00-23:59 % %------------------------------------------------------------------------ % DATE DAY ATTR #SYM WORKING HOURS HOLIDAY %------------------------------------------------------------------------ % % 2012-02-01 SUN F 0 00:00-23:59 %
SHOW-CALENDAR kalender.arbeit-3,SELECT=*SYMBOLIC-DATE
(FROM=*FIRST-SYMBOLIC-DATE,TO=*LAST-SYMBOLIC-DATE)
%------------------------------------------------------------------------ % LIST OF SYMBOLIC DATES %------------------------------------------------------------------------ % CALENDAR NAME: :2OSG:$USER1.KALENDER.ARBEIT-3 % %------------------------------------------------------------------------ % SYMBOLIC DATE TIME TYPE CYCLTYP CYCLVAL CYCLALT %------------------------------------------------------------------------ % % MONATSINFO 09:00:00 C MONTH 1 AFTER % ULTIMO 13:00:00 C MONTH 1 BEFORE %------------------------------------------------------------------------
SHOW-CALENDAR kalender.arbeit-3,SELECT=*SYMBOLIC-DATE
(FROM=*FIRST-SYMBOLIC-DATE,TO=*LAST-SYMBOLIC-DATE,
ASSIGNED-DATES=*INTERVAL(FROM=*TODAY,TO=2012-02-09))
%------------------------------------------------------------------------ % SYMBOLIC DATE INFORMATION %------------------------------------------------------------------------ % CALENDAR NAME: :2OSG:$USER1.KALENDER.ARBEIT-3 % %------------------------------------------------------------------------ % SYMBOLIC DATE TIME TYPE CYCLTYP CYCLVAL CYCLALT %------------------------------------------------------------------------ % % MONATSINFO 09:00:00 C MONTH 1 AFTER % %---------------------------- ASSIGNED DATES ---------------------------- % % 2012-02-09 %------------------------------------------------------------------------ % SYMBOLIC DATE TIME TYPE CYCLTYP CYCLVAL CYCLALT %------------------------------------------------------------------------ % % ULTIMO 13:00:00 C MONTH 1 BEFORE % %---------------------------- ASSIGNED DATES ---------------------------- % % 2012-01-30 2012-02-27 %------------------------------------------------------------------------
SHOW-CALENDAR kalender.arbeit-2,SELECT=*HOLIDAY(FROM=*FIRST, TO=neujahr)
%------------------------------------------------------------------------ % LIST OF HOLIDAYS %------------------------------------------------------------------------ % CALENDAR NAME: :2OSG:$USERXY01.KALENDER.ARBEIT-2 % %------------------------------------------------------------------------ % HOLIDAY NAME TYPE ACTIVE %------------------------------------------------------------------------ % % CHRISTI.HIMMELFAHRT N Y % ERSTER.WEIHNACHTSFEIERTAG C Y % FRONLEICHNAM N Y % KARFREITAG N Y % MAIFEIERTAG C Y % NEUJAHR C Y %------------------------------------------------------------------------
SHOW-CALENDAR kalender.arbeit-2, SELECT = *HOLIDAY(FROM=oster*,
TO=*SAME,ASSIGNED-DATES=*YES)
%------------------------------------------------------------------------ % CALENDAR NAME: :2OSG:$QM224RZK.KALENDER.ARBEIT-2 % %------------------------------------------------------------------------ % HOLIDAY NAME TYPE ACTIVE DATE %------------------------------------------------------------------------ % % OSTERMONTAG N Y % %---------------------------- ASSIGNED DATES ---------------------------- % % 2011-04-25 2012-03-09 %------------------------------------------------------------------------ % HOLIDAY NAME TYPE ACTIVE DATE %------------------------------------------------------------------------ % % OSTERSONNTAG N Y % %---------------------------- ASSIGNED DATES ---------------------------- % % 2011-04-24 2012-03-08 %------------------------------------------------------------------------
Bedeutung der Ausgabefelder
Ausgabefeld | Bedeutung |
|---|---|
ACTIVE | Aktivierungszustand des Feiertags: Y = aktiviert, N = nicht aktiviert |
ASSIGNED DATES | Datumsangaben für die Kalendertage, die einem SYMDAT oder einem Feiertag zugeordnet sind; Ausgabe in der Form yyyy-mm-dd |
ATTR | Attribut des Wochentags: W (Work) = Arbeitstag, F (Free) = freier Tag |
CALENDAR LIMITS | Kalendergrenzen: |
| Erstes Datum im Kalender (untere Kalendergrenze); Ausgabe in der Form yyyy-mm-dd |
| Letztes Datum im Kalender (obere Kalendergrenze); Ausgabe in der Form yyyy-mm-dd |
CALENDAR NAME | Name der Kalenderdatei |
CYCLALT | Alternative für den Fall, dass ein berechneter SYMDAT-Eintrag ein freier Tag ist; Mögliche Werte: |
CYCLTYP | Zyklus-Art des SYMDAT: DAY (Tag), WORKDAY (Arbeitstag), MONTH (Monat), WEEK (Woche) |
CYCLVAL | Zyklus-Wert |
DATE | Datum; Ausgabe in der Form yyyy-mm-dd; für zyklische Feiertage Ausgabe in der Form: ****-mm-dd |
DAY | Bezeichnung des Wochentags: MON (Montag), TUE (Dienstag), WED (Mittwoch), THU (Donnerstag), FRI (Freitag), SAT (Samstag), SUN (Sonntag) |
HOLIDAY | Name des zugehörigen Feiertags |
HOLIDAY NAME | Name des Feiertags; max. 30 Zeichen |
SYMBOLIC DATE | Name eines SYMDAT; max. 20 Zeichen |
STANDARD WEEK | Definitionen der Standard-Arbeitswoche beinhalten folgende Informationen: DAY, ATTR und WORKING HOURS (Beschreibungen siehe dort) |
TIME | Zeiteintrag, der dem SYMDAT zugeordnet ist. Ausgabe in der Form hh:mm:ss |
TYPE | Typ des SYMDATs oder Feiertags: C (cyclic) = zyklisch, N (non cyclic) = nicht-zyklisch |
WORKING HOURS | Beginn und Ende der Arbeitszeit; Ausgabe in der Form hh:mm-hh:mm |
#SYM | Anzahl der dem Tag zugeordneten SYMDAT |
Ausgabe in S-Variable
Der Operand SELECT des Kommandos legt fest, welche S-Variablen erzeugt werden. Folgende Angaben sind für SELECT möglich:
Schreibweise im Kommando | gekürzte Schreibweise in Tabelle |
|---|---|
SEL=*BASIC-INFORMATION | 1 |
SEL=*DATE(ASSIGNED-SYM-DATE=*NONE) | 2 |
SEL=*DATE(ASSIGNED-SYM-DATE=*ALL/name) | 3 |
SEL=*HOLIDAY(ASSIGNED-DATES=*NO) | 4 |
SEL=*HOLIDAY(ASSIGNED-DATES=*YES) | 5 |
SEL=*SYMBOLIC-DATE(ASSIGNED-DATES=*NO) | 6 |
SEL=*SYMBOLIC-DATE(ASSIGNED-DATES=*ALL/*NEXT-DATE/*INTERVAL) | 7 |
SEL=*TODAY | 8 |
Ausgabe-Information | Name der S-Variablen | T | Inhalt | Bedingung |
|---|---|---|---|---|
Aktivierung des Feiertags | var(*LIST).ACTIVE | S | *NO | 4,5 |
Alternative, falls ein berechnetes SYMDAT auf einen freien Tag fällt | var(*LIST).ALT | S | *AFTER | 6,7 |
Datum der Tage, die dem SYMDAT oder Feiertag zugeordnet sind | var(*LIST).ASS-DATE(*LIST) | S | <yyyy-mm-dd> | 5,7 |
Art des Tages | var(*LIST).ATTR | S | *FREE | 2,3,8 |
erstes Datum im Kalender (untere Grenze) | var(*LIST).CALEN-BEGIN | S | <yyyy-mm-dd> | 1 |
letztes Datum im Kalender (obere Grenze) | var(*LIST).CALEN-END | S | <yyyy-mm-dd> | 1 |
Name der Kalenderdatei | var(*LIST).CALEN-NAME | S | <filename 1..54> | |
Zyklusart des symbolischen Datums | var(*LIST).CYCL-TYPE | S | *DAY | 6,7 |
Zykluswert | var(*LIST).CYCL-VAL | I | <integer 1..9999> | 6,7 |
Datum | var(*LIST).DATE | S | <yyyy-mm-dd> | 2,3,5,8 |
Name des Wochentags | var(*LIST).DAY | S | MON | 2,3,8 |
bezeichneter Tag ist ein Feiertag (s. var(*LIST).DATE) | var(*LIST).HOLIDAY | S | *NO | 2,3,8 |
Name des Feiertags | var(*LIST).HOLIDAY-NAME | S | ’’ | 2,3,4,5,8 |
Anzahl der dem Tag zugehörigen SYMDAT (s. var(*LIST).DATE) | var(*LIST).NUM-OF-SYMB-DATE | I | <integer 0..4096> | 2,3,8 |
Art des Tages | var(*LIST).STD-WEEK(*LIST).ATTR | S | *FREE | 1 |
Name des Wochentags (Standardarbeitswoche) | var(*LIST).STD-WEEK(*LIST).DAY | S | MON | 1 |
Beginn der Arbeitszeit (Standardarbeitswoche) | var(*LIST).STD-WEEK(*LIST).WORK-TIME-BEGIN | S | <hh:mm> | 1 |
Ende der Arbeitszeit (Standardarbeitswoche) | var(*LIST).STD-WEEK(*LIST).WORK-TIME-END | S | <hh:mm> | 1 |
Name des SYMDAT | var(*LIST).SYMB-DATE-NAME | S | <name 1..20> | 6,7 |
Name des SYMDAT, das dem Tag zugeordnet ist (s. var(*LIST).DATE); ist kein SYMDAT definiert, wird die S-Variable nicht erzeugt | var(*LIST).SYMB-DATE(*LIST).NAME | S | <name 1..20> | 3,8 |
Uhrzeit des SYMDAT, das dem Tag zugeordnet ist (s. var(*LIST).DATE); ist kein SYMDAT definiert, wird die S-Variable nicht erzeugt | var(*LIST).SYMB-DATE(*LIST).TIME | S | <hh:mm:ss> | 3,8 |
Uhrzeit, die dem SYMDAT zugeordnet ist | var(*LIST).TIME | S | <hh:mm:ss> | 6,7 |
Art des SYMDAT oder Feiertages | var(*LIST).TYPE | S | *CYCL | 4,5,6,7 |
Beginn der Arbeitszeit | var(*LIST).WORK-TIME-BEGIN | S | <hh:mm> | 2,3,8 |
Ende der Arbeitszeit | var(*LIST).WORK-TIME-END | S | <hh:mm> | 2,3,8 |
Erläuterung zu var(*LIST).ALT:
1 | *AFTER: Der nächste Arbeitstag wird im Bereich „berechnetes Datum +(Zykluswert -1 )“ gesucht. Bei erfolgreicher Suche wird der alternative Tag nach dem ursprünglich berechneten Datum eingetragen. Wird in diesem Zeitraum kein Arbeitstag gefunden, entfällt der Eintrag. |
2 | *BEFORE: Der nächste Arbeitstag wird im Bereich „berechnetes Datum - (Zykluswert - 1 )“ gesucht. Bei erfolgreicher Suche wird der alternative Tag vor dem ursprünglich berechneten Datum eingetragen. Wird in diesem Zeitraum kein Arbeitstag gefunden, entfällt der Eintrag. |