REXX Command Interface Facility (RXCIF)

Problemstellung. Jeder kennt das: man möchte gerade in seiner Prozedur einen TSO-Befehl auf Grund unterschiedlichen Variablen zusammen basteln, aber stellt dabei fest, dass man die Syntax oder den Namen des Operanden oder die möglichen Optionen nicht mehr im Kopf hat, weil sie zu der Sorte angehören, die man selten braucht. Eine langwierige Suche zuerst der Literatur, danach in der Literatur fängt an. Und als Endergebnis entsteht ein fest verdrahteter TSO-Befehl in der Prozedur. Zeit fressend und unflexibel.

Lösung. Eine universelle, flexible Schnittstelle zwischen den TSO-Befehlen und REXX-Prozeduren: REXX Command Interface Facility kurz RXCIF. Diese Schnittstelle eignet sich besonders für die Prozeduren, die mehrere differenzierte Befehle automatisch generieren müssen.

Beschreibung. Die Schnittstellenfunktionen sind pro Befehl zu definieren. Eine Befehlsschnittstelle besteht aus jeweils 3 befehlsbezogenen internen REXX-Funktionen und aus einer allgemeinen Schnittstellenfunktion, die entweder intern oder extern definiert werden darf:

• Cmd_namePrepare - eine Beschreibungsfunktion. Sie hat die Aufgabe einer Befehlsreferenz und dient als Hilfe zum Aussuchen und zum Definieren der benötigten Befehlsoperanden in der, als Teil der Schnittstelle fungierenden, Stem-Variablen cmd_name..
• Cmd_nameTpl - ein Syntax-Muster für die Zuordnungsparameter des TSO-Befehls. Man unterscheidet hierbei zwischen den Schlüsslewortparametern (das Schlüsslewort ist selbst der Parameter) und den Zuordnungsparametern (der Parameter wird dem Operanden zugeordnet, z. B.: DATASET(parameter_value)).
• SetOp - die allgemeine Schnittstellenfunktion. Sie ist für die Generierung der Befehlsoperanden, aus Angaben in den o. g. Funktionen oder in der Stem-Variablen, zuständig.
• Cmd_name - die Befehls-Hauptfunktion. Führt die Generierung des gesamten Befehls und seine Ausführung durch.

• RACF-Befehle
• TSO-Befehle