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.