24.  Help-System
Aufruf der Help-Funktion
Der Benutzer von CFS kann zu jedem Zeitpunkt durch Eingabe von ?, ??, ?ALL, ?CON, ?cmd oder ?USER in das Help-System verzweigen um sich eine detaillierte Übersicht über die möglichen Eingaben zu verschaffen.
? Es werden alle Informationen zu dem markierten Feld ausgegeben.
?? Es wird eine Anleitung zur Benutzung des HELP-Systems ausgegeben.
?ALL | ?& | HELP Es wird das Hauptmenü des HELP-Systems angezeigt, über das alle vorhandenen HELP-Informationen erreicht werden können.
?NEWS Änderungsprotokoll anzeigen.
?CON Es werden die HELP-Informationen zu den Connections ausgegeben. Diese Zeichenfolge kann auch in Connections, sowohl im Line-Modus als auch im Format-Modus im ersten Feld einer Maske, eingegeben werden.
?cmd Es werden alle Informationen zu dem gewünschten Kommando cmd ausgegeben.
?USER [, par] Anzeige der Menues und Informationen aus der CFSHELP.USER Datei. Für ausführliche Informationen siehe Seite 24-.
Beispiele:
COMMAND : ?add
Es werden alle Informationen zum Kommando ADD ausgegeben.
FILENAME-SELECT : ?fstat
Es werden alle Informationen zu dem Schlüsselbegriff 'FSTAT' im Feld FILENAME-SELECT ausgegeben.
HELP-Informationen für mehrere Felder einer Maske
Es können in einer Bildschirmmaske auch mehrere Felder gleichzeitig durch '?' markiert werden. Die Erklärungen werden dann der Reihe nach für jedes einzelne Feld angezeigt.
Auswahlmenues des Help-Systems
Wenn die HELP-Informationen sehr umfangreich sind, werden die einzelnen Kapitel in einem Menue angezeigt. Durch Markieren mit einem beliebigen Zeichen können einzelne Menuepunkte ausgewählt werden.
Ein Menue kann sich auch über mehrere Bildschirmseiten erstrecken. In diesem Fall erscheint in der vorletzten Bildschirmzeile der Hinweis "Help continues".
Falls sich hinter einem Menuepunkt ein Untermenue verbirgt, so wird dies durch das Zeichen "Ö" angezeigt.
Standardmäßig werden die markierten Menuepunkte einer Bildschirmseite sofort angezeigt. Wenn die Menuepunkte über mehrere Masken hinweg gesammelt und nach Ausgabe der letzten Bildschirmseite des Menues angezeigt werden sollen, so ist die Menuemaske mit der F1-Taste zu senden.
Belegung der Datenübertragungstasten
K1 Die Ausgabe der Informationen zum aktuellen Punkt wird beendet. Die Ausgabe wird beim nächsten Menuepunkt bzw. beim nächsten mit "?" markierten Feld der Maske fortgesetzt. Falls der letzte Menuepunkt bzw. das letzte "?"-Feld der Ausgangsmaske erreicht ist, wird die HELP-Funktion beendet.
K3 Die Ausgabe der Informationen zum aktuellen Punkt wird beendet. Die Ausgabe wird fortgesetzt mit der Anzeige des vorhergehenden Menuepunkts fortgesetzt. Nach der Anzeige des ersten Menuepunkts wird in das übergeordnete Menue zurückverzweigt. Die HELP-Funktion wird beendet, wenn das erste Menue erreicht ist.
F1 Wenn sich ein Menue über mehrere Bildschirmseiten erstreckt, so werden die in der aktuellen Bildschirmseite markierten Menuepunkte bei Senden mit ENTER sofort ausgegeben. Wird das Menue jedoch mit der F1-Taste gesendet, so werden die markierten Menuepunkte gesammelt und nach Absenden der letzten Menueseite bzw. bei der ersten Anwendung von ENTER ausgegeben.
F2 Die F2-Taste hat die gleiche Wirkung wie das Kommando MEN (Verzweigen in das übergeordnete Menue).
F3 Die aktuell angezeigte Bildschirmseite wird in die CFS Hardcopy-Datei geschrieben. Sollen mehrere Seiten hintereinander hardcopymäßig mitprotokolliert werden, so empfiehlt sich hierfür das Kommando HC (Hardcopy-Modus einschalten).
Shift ENTER (DUE2)
Das Kommandogedächtnis wird aktiviert. Das in der Help-Maske zuletzt eingegebene Kommando wird angezeigt bzw. der angegebene String wird im Kommandogedächtnis gesucht und die entsprechende Eingabe angezeigt.
Ausgabemasken des HELP-Systems
Eingabe: ?? (Informationen zum HELP-System)
} dd.mm.yy hh:mm:ss H E L P - S Y S T E M TSN: .... {
} COMMAND : {
} INPUT : {
} Beschreibung des HELP-Systems {
} {
} Markieren Sie die gewuenschten Informationen mit "x". {
} {
}. Wie kann das HELP-System erreicht werden ("?", "?all", "?operand", "??") {
}. Eingaben im Feld "COMMAND" (Zeile 2 dieser Maske) {
}. Eingaben im Feld "INPUT" (Zeile 3 dieser Maske) {
}. Bedeutung der Sendetasten K1, F1, K3, F3 und DUE2 im HELP-System {
} {
} {
} {
} {
} {
} {
} {
} {
} {
} {
} {
} {
} {
Eingabe: help oder ?all (Hauptmenü des HELP-Systems)

Durch Klicken mit der Maus erhalten Sie eine Beschreibung zum gewünschten Feld.
Das Zeichen "Ö" besagt, daß unter diesem Menuepunkt ein weiteres Menue folgt.
Eingabe: ?on (Information über Variable Actions)
} dd.mm.yy hh:mm:ss H E L P - S Y S T E M TSN: .... {
} COMMAND : {
} INPUT : {
} ON Variable Action definieren {
} {
} In diesem Feld werden Aktionen mit umfangreicheren Parametern definiert. {
} Die Aktion kann für alle Dateien (&) oder für mit "X" markierte Dateien {
} definiert werden. {
} {
} Format: ONXvariable Action Aktion gilt nur für markierte Dateien {
} ON&variable Action Aktion gilt für alle Dateien der Dateienliste {
} {
} {
} Bitte wählen Sie: {
} {
}xÖMenü aller Variablen Actions {
}. Ausführliche Beschreibung des Systems der Variablen Actions {
} {
} {
} {
} {
} {
} {
} { 





 
} dd.mm.yy   hh:mm:ss          H E L P - S Y S T E M                    TSN: .... {

} COMMAND :                                                                       {

} INPUT   :                                                                       {

}                           Menü aller Variablen Actions                          {

}                                                                                 {

}. /       BS2000-Kommando ausführen       . REORG   Reorganisieren Bibliothek    {

}.ÖADD     Aufnehmen in Bibliotheken       . SEL     Selektieren aus Bibliothek   {

}x ARCHIVE Sichern mit Archive             . SETUDAT USER-Date setzen (PLAM)      {

}. CONV    Dateien konvertieren            . TSOSMT  Sichern mit TSOSMT           {

}. COPY    Kopieren                                                               {

}. DFLAM   Dekomprimieren mit FLAM                                                {

}. DPF     Generieren Dateinamen                                                  {

}. FIND    Durchsuchen nach String                                                {

}. FLAM    Komprimieren mit FLAM                                                  {

}.ÖFT      File-Transfer mit openFT                                               {

}. ICOPY   Kopieren INF-Katalog                                                   {

}. LIST    Erstellen Liste                                                        {

}. LISTCAT Ausgabe Katalogeintraege                                               {

}. MOVE    Uebertr. auf andere Datentr.                                           {

}.ÖRDAC    File-Transfer mit RDAC                                                 {

}. REN     Rename (Umbenennen)                                                    {

}                                                                                 {

}                                                                                 {

}                                                                                 {







Eingabemöglichkeiten im Feld  COMMAND  der Help-Maske






 
} dd.mm.yy   hh:mm:ss          H E L P - S Y S T E M                    TSN: .... {

} COMMAND :                                                                       {

} INPUT   :                                                                       {

}                         ARCHIVE :  Sichern mit Archive                          {

}                                                                                 {

} ONXARCHIVE archive-param                                                        {

}                                                                                 {

}           Es wird eine DO-Prozedur für den Sicherungslauf erstellt. Der Benutzer{

}           wird gefragt, ob er diese DO-Prozedur im Dialog oder im Enter         {

}           gestartet haben möchte, bzw. keine weiteren Aktionen wünscht          {

}           (nur Generierung einer DO-Prozedur).                                  {

}           Bei Sicherung im Dialog wird ein DO-Kommando abgesetzt. CFS wird      {

}           damit beendet.                                                        {

}                                                                                 {

}                                                                                 {

}           Beispiele:                                                            {

}                                                                                 {

}           ONXARCHIVE E L=SYSOUT,TAPES=888888                                    {

}                                                                                 {

}           ONXARCHIVE S NOW=NO,ER=YES,TAPES=123456                               {

}                                                                                 {

}                                                                                 {

}                                                                                 {

}                                                                                 {





 






 







 
+ | - Eine Bildschirmseite vorwärts / rückwärts blättern.





 
Falls im Kommandofeld nichts eingegeben wurde, so wird um eine Bildschirmseite vorwärts geblättert.





 
+n | -n n  Zeilen vorwärts / rückwärts blättern  (nicht zulässig in Menues).






++ | -- Zum Anfang / Ende des aktuellen Punktes (Informationen zu einem Feld oder eines Menuepunktes)  positionieren  (nicht zulässig in Menues).






LIST [datei] [, E|O]





Der gesamte Inhalt des gerade angezeigten Help-Items wird in eine Datei mit dem angegebenen Namen geschrieben. Falls sich der Benutzer z.B. im Änderungsprotokoll von CFS befindet (Kommando ?news), so wird mit  LIST CFS.NEWS  der gesamte Text des Änderungsprotokolls in eine druckaufbereitete Datei mit dem Namen CFS. NEWS geschrieben.






 
datei Name der Ausgabedatei. Falls kein Dateiname angegeben wurde, wird als Standardname CFS.HELPLIST.tsn  verwendet.





 
Falls bei einem späteren List-Kommando der Dateiname weggelassen wird, werden die Daten an die zuletzt verwendete List-Datei angehängt (Open=Extend).






 
E Ausgabedatei erweitern (Open=Extend).





 
O Ausgabedatei wird neu erstellt (Open=Output). Bereits vorhandene Daten werden überschrieben.





 








DKEY | NDKEY  Display Keys.  Es wird in der Bildschirmmaske der Isam-Schlüssel des ersten aus der Help-Datei gelesenen Datensatzes angezeigt. Die Information über die Isam-Schlüssel dient nur zu Diagnosezwecken.





Standard:  NDKEY






NF Next Field.  Informationen zum nächstes Feld ausgeben. Das Kommando entspricht der Bedeutung der K1-Taste.






LF Last Field. Informationen zum vorhergehenden Feld ausgeben (gleiche Wirkung wie K3-Taste).






MEN Zuletzt angezeigtes Menue wieder ausgeben. Das Senden mit der F2-Taste hat die gleiche Wirkung.







S&,.... Stichwortsuche in HELP-Datei.





Es wird in der gesamten HELP-Datei nach dem angegebenen String (z.B. Stichwort Reorganisieren) gesucht. Als Ergebnis wird eine Trefferliste mit allen Menuepunkten ausgegeben, die den Suchstring enthalten.  





Für eine ausführliche Beschreibung des Suche-Kommandos siehe Seite 8-.







S,.... String ab der aktuellen Position bis zum Ende der Informationen für das Feld suchen.






 Wird das S-Kommando in einer Menuemaske eingegeben, so werden alle Menuepunkte nach dem angegebenen String durchsucht. Die Menuepunkte, in denen der String gefunden wurde, werden mit  "S"  gekennzeichnet. Ist der Menuepunkt wieder ein Menue, so wird dieser stets mit "S" gekennzeichnet. Das Untermenue wird jedoch nicht durchsucht. Wird die auf diese Weise durch Markierungen vorbelegte Maske gesendet, so werden die Strings in den gekennzeichneten Menuepunkten angezeigt bzw. Untermenues wiederum durchsucht.






S-,.... Suchen String in Richtung Anfang der HELP-Informationen. Dieses Kommando ist nur zulässig nach  S,.....







E oder END Beenden HELP-Funktion.






/cmd BS2000-Kommando ausführen.






/ Break.  Verzweigen in den BS2000-Kommandomodus.






=arith Arithmetische Rechnung bzw. Hexadezimal <--> Character Konvertierung.





Ausführliche Beschreibung siehe Seite 7-.







HC | NHC Einschalten / Ausschalten der Hardcopy-Funktion von CFS.





Das HC-Kommando kann mit allen auf Seite 15- dargestellten Parametern angegeben werden. Im Zusammenhang mit dem HELP-System ist die Kommandovariante HC datei,R von Interesse (siehe Seite 15-). Es werden damit die am Bildschirm erscheinenden Informationen in reduzierter Form in die angegebene Datei protokolliert. Bei der reduzierten Protokollierung werden die Bildschirmrahmen und die in den Masken konstanten Überschrifts- und Fußzeilen nicht ausgegeben.






? Hinweise zu den Eingabemöglichkeiten im Feld  COMMAND  der HELP-Maske.





?? Allgemeine Informationen zum CFS HELP-System.






?ALL | ?&  Es wird das Hauptmenü des HELP-Systems angezeigt. Über dieses Menue können alle HELP-Informationen erreicht werden.







MES Mitteilung in CFS-Kommentardatei schreiben. Es wird eine Maske ausgegeben, in der Fehlermeldungen zu CFS, Änderungswünsche und sonstige Mitteilungen an die Fa. OPG eingetragen werden können. Diese Daten werden in die Datei $TSOS. CFSCOM geschrieben. Der Name der Datei kann bei der Installation vom Systemverwalter geändert werden.  Zum Format der Kommentarmaske siehe Kommando MES Seite 7-.






Eingabemöglichkeiten im Feld  INPUT  der Help-Maske







INPUT : Im Feld INPUT der Help-Maske kann der gültige Wert für das Feld der Ausgangsmaske eingegeben und während des Lesens der Help-Informationen vervollständigt werden - selbst über mehrere Bildschirme und Menues hinweg.






 Bei Beenden der Anzeige der Help-Informationen durch das Help-Kommando END oder die K1-Taste wird die im Feld INPUT stehende Zeichenfolge als Eingabe in die Ausgangsmaske übertragen.






 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.






 
 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.