Benutzereigene HELP-Datei |
Aufruf der Benutzermenues | |
Die Eingabe ?user [,name] im Kommandofeld von CFS bewirkt eine temporäre Umschaltung von CFSHELP auf eine vom Benutzer erstellte Helpdatei. | |
Suchreihenfolge der benutzereigenen Helpdatei | |
CFS durchläuft bei der Suche nach der zu verwendenden benutzereigenen Helpdatei folgende Schritte: | |
1) | der Name der Helpdatei wurde per File-Kommando zugewiesen (/FILE xxxx, LINK=HELPUSER) | |
2) | es existiert eine Datei mit dem Namen CFSHELP.jobname bzw. .acct falls kein Jobname vorhanden. | |
3) | es existiert eine Datei mit dem Namen CFSHELP.USER | |
4) | es existiert eine Datei mit dem Namen $userid.CFSHELP.USER | |
userid bezeichnet die Benutzerkennung, unter der das Programm CFS gespeichert ist. | ||
Generierung einer Helpdatei | |
Folgende Anweisungen sind zur Generierung einer Helpdatei notwendig: | |
/FILE helpfile,LINK=HELPFILE | ||
/EXEC (GENHELP,$CFS.CFSLIB) | ||
DATA=bibl(element-1) | ||
DATA= .... | ||
...... | ||
SOURCE=bibl(element-x) | ||
END | ||
Die mit element-n bezeichneten Bibliothekselemente müssen mit dem Elementtyp S in der PLAM-Bibliothek bibl gespeichert sein. | |
In der Bibliothek CFS.S.LMSLIB ist eine DO-Prozedur J/GENHELP zur Generierung einer User Helpdatei enthalten. | |
Aufbau der Daten für eine Helpdatei | |
Die wichtigsten verwendeten Syntaxelemente sind: | |
:MEN: | Menue-Anweisungen definieren Auswahlmenues. Diese können beliebig hierarchisch strukturiert sein. | |
:HDR: | Header-Sätze definieren die Kopfzeilen der Help-Bildschirme | |
:KEY:/:END: | Key- und End-Sätze dienen der Begrenzung der einzelnen Informationseinheiten in Copy-Strecken (siehe unten). | |
Im SOURCE-Element wird durch Key- und End-Sätze der Beginn und das Ende von Auswahlmenues definiert. | ||
:COP: | Cop-Anweisungen bewirken bei der Generierung das Kopieren einer Informationseinheit aus einem DATA-Element. | |
:DIR: | Directory-Anweisung. Alle in der Directory-Liste enthaltenen Menuepunkte können mit dem angegebenen Namen direkt, d.h. durch Eingabe von ?USER,name erreicht werden. Beispiel: ?USER,EBCD. | |
Es ist nur ein Directory-Block pro Helpdatei möglich. | ||
Die Elemente S/CFSHELP.USER.MENUE und S/CFSHELP.HELPTABS in der Bibliothek CFS.S.LMSLIB enthalten als Beispiel alle notwendigen Daten zur Generierung der User Helpdatei. | |