receive_jcl_jobtype.cfg

Das AFP-Unterstützung-Feature stellt die Datei receive_jcl_jobtype.cfg bereit.

RICOH ProcessDirector kann diese Steuerdatei verwenden, um eine JCL-Datei zu interpretieren, die mit einem PRD-Datensatz übergeben wurde, den RICOH ProcessDirector von einer Eingabeeinheit des Typs "Download" empfängt. Die JCL-Datei kann beispielsweise die folgenden Informationen enthalten:

"-odatat=af -oburst=no -occ=yes -occtype=m -ocop=1 -odatac=unblock 
-ofileformat=stream -of=F1HPSTP1 -ojobn=HPUNCH05 -ono=BLDPDEV9 
-opr=HPUNCH -ous=WAITE 
-opa=class=B,dest=LOCAL,forms=STD,jobid=JOB00105"

Um eine Steuerdatei zu verwenden, setzen Sie den Wert des Merkmals Initialisierungsschritt für untergeordneten Workflow für die Eingabeeinheit auf SetJobTypeFromRules oder SetJobTypeFromFileName, und legen Sie dann den Wert des Merkmals Syntaxanalyseregeln für untergeordneten Workflow auf den Pfad und den Dateinamen der Steuerdatei fest. Der Schritt SetJobTypeFromRules verwendet die Steuerdatei, um den Workflow für den Job festzulegen, eine optionale, mit dem Job übergebene Überschreibungsdatei in eine Datei im Format RICOH ProcessDirectorMerkmalname=Wert für das Festlegen von Jobmerkmalen zu konvertieren oder beides. Der Schritt SetJobTypeFromFileName verwendet die Steuerdatei, um Jobmerkmale festzulegen. Bei allen Informationen in der Steuerdatei muss die Groß-/Kleinschreibung beachtet werden.

Die Steuerdatei enthält die folgenden Abschnitte:

Abschnitt CONFIGURATION

Dies ist ein Abschnitt für globale Einstellungen, der aus Schlüsselwörtern besteht, mit denen definiert wird, wie RICOH ProcessDirector die JCL-Datei interpretiert.

FILE_MODE

Dieses Schlüsselwort steuert, wie RICOH ProcessDirector die JCL-Datei verarbeitet. Bei dem Wert "FILE" wird RICOH ProcessDirector angewiesen, alle Informationen in der Datei als einen einzigen Satz zu behandeln. In diesem Modus kann RICOH ProcessDirector Aktionen zum Suchen und Ersetzen ausführen. Benutzen Sie den Wert "FILE" immer für Steuerdateien, die JCL-Dateien verarbeiten. Die doppelten Anführungszeichen in dem Wert sind erforderlich.

ATTRIBUTE_PATTERN

Dieses Schlüsselwort gibt einen regulären Ausdruck an, mit dem definiert wird, wie RICOH ProcessDirector die Namen von Merkmalen erkennt. RICOH ProcessDirector stellt den Wert "\$\{Job.*\}" bereit. Die doppelten Anführungszeichen begrenzen den Ausdruck, und die umgekehrten Schrägstriche sind Escapezeichen, die den Sonderzeichen im Ausdruck vorangestellt sind.

Der Wert "\$\{Job.*\}" weist RICOH ProcessDirector an, Merkmalnamen als Zeichenfolgen zu erkennen, die mit Job. beginnen und denen weitere Zeichen folgen können, aber nicht müssen. RICOH ProcessDirector-Namen von Jobmerkmalen stimmen mit dieser Konvention überein, beispielsweise Job.Duplex und Job.Print.CumulativeSheetsStacked.

KEYWORD_CASE

Mit diesem Schlüsselwort wird die Groß-/Kleinschreibung der Zeichen in den Parameternamen der JCL-Datei definiert. Je nach den Einstellungen auf dem sendenden System können Parameter ausschließlich in Großbuchstaben oder ausschließlich in Kleinbuchstaben übergeben werden. Benutzen Sie je nach Anforderungen der Installation den Wert "UPPER" oder "LOWER".

NORMALIZER_PROGRAM

Mit diesem Schlüsselwort wird der Name eines Programms angegeben, das die JCL-Datei so ändert, dass alle in der Datei definierten Merkmale das Format "Schlüsselwort=Wert" haben. RICOH ProcessDirector stellt das Programm normalize_jcl.pl bereit, um die verschiedenen Arten von JCL-Parametern in das Format "Schlüsselwort=Wert" zu ändern.

Beachten Sie zum Beispiel diese JCL-Zeichenfolge:

"-odatat=af -oburst=no -opa=class=B,dest=LOCAL,forms=STD,jobid=JOB00105"

Wenn RICOH ProcessDirector das in der Steuerdatei angegebene Programm normalize_jcl.pl nutzt, ersetzt das Programm die JCL-Zeichenfolge durch den folgenden Wert:

datat=af,burst=no,class=B,dest=LOCAL,forms=STD,jobid=JOB00105,

.

Begrenzen Sie den Anfang und das Ende des Abschnitts CONFIGURATION mit CONFIGURATION und ENDCONFIGURATION.

Abschnitt REPLACE

Dieser Abschnitt benutzt Befehle sed zum Ersetzen von Zeichenfolgen in der JCL-Datei. Er ist in der Musterdatei auf Kommentar gesetzt, da das von dem Schlüsselwort NORMALIZER_PROGRAM definierte Programm die JCL-Datei konvertiert.

Die folgende Anweisung ersetzt beispielsweise alle Vorkommen von -opa= (auf das Leerzeichen am Anfang achten) durch Kommas:

#s! -opa=!,!

Begrenzen Sie den Anfang und das Ende des Abschnitts REPLACE mit REPLACE und ENDREPLACE.

Abschnitt PATTERN KEY_VALUE

In diesem Abschnitt wird beschrieben, wie RICOH ProcessDirector Schlüsselwörter und Werte findet und unter Verwendung von Gruppen mit regulären Ausdrücken in Token konvertiert. Der von RICOH ProcessDirector bereitgestellte Abschnitt sieht wie folgt aus:

PATTERN KEY_VALUE
"(.*?)=(.*?),"
ENDPATTERN

Das Muster ist durch doppelte Anführungszeichen begrenzt und das Muster links von dem Gleichheitszeichen stellt das Schlüsselwort dar. Das Muster rechts stellt den Wert dar. Dieses Muster erstellt eine durch Kommas begrenzte Liste von Paaren aus Schlüsselwort und Wert.

Abschnitt mit der Anweisung DEFINE

Dieser Abschnitt benutzt Symbolformeln zum Festlegen des RICOH ProcessDirector-Workflows und der Jobmerkmale aus den Werten für Parameter, die mit dem Job in der JCL-Datei übergeben werden. Nachfolgend sind Beispiele von Typen der Anweisungen DEFINE aufgeführt, die der Abschnitt enthalten kann:

DEFINE ${Job.JobType} AS "BILLS" WHEN (${DEST} == "LOCAL")
DEFINE ${Job.Class} AS "${CLASS}"
DEFINE ${Job.InputDatastream} AS "AFP" WHEN (${DATAT} == "af")
DEFINE ${Job.Destination} AS "${DEST}"
DEFINE ${Job.RequestedPrinter} AS "${DEST}"
DEFINE ${Job.Customer} AS "XYZ" WHEN (${CLASS} == "Z") FINALLY QUIT

Die erste Anweisung DEFINE ist eine bedingte Anweisung. Im Beispiel setzt RICOH ProcessDirector den Wert des Merkmals Job.JobType auf BILLS, wenn der Wert des Parameters DEST der JCL-Datei LOCAL lautet. Wenn der Parameter DEST einen anderen Wert besitzt, legt RICOH ProcessDirector den Workflow nicht mit der Steuerdatei fest. Beim Festlegen wird eine andere Methode verwendet, beispielsweise wird der Workflow verwenden, der der Eingabeeinheit des Typs "Download" zugeordnet ist.

Die zweite Anweisung DEFINIEREN ist eine nicht bedingte Anweisung. In diesem Beispiel setzt RICOH ProcessDirector den Wert des Jobmerkmals Job.Class auf den Wert des Parameters CLASS, der mit dem Job übergeben wird. Wenn die von RICOH ProcessDirector empfangene JCL-Zeichenfolge -opa=class=B enthält, setzt RICOH ProcessDirector den Wert des Merkmals Job.Class daher auf B.

Die dritte Anweisung DEFINE ist eine bedingte Anweisung. Im Beispiel setzt RICOH ProcessDirector den Wert des Jobmerkmals Job.InputDataStream auf AFP, wenn der Wert des Parameters DATAT der JCL-Datei af lautet. Wenn der Parameter DATAT einen beliebigen anderen Wert besitzt, legt RICOH ProcessDirector den Wert des Merkmals Job.InputDataStream nicht fest.

Die vierten und fünften Anweisungen DEFINE sind nicht bedingte Anweisungen, die die Werte von zwei unterschiedlichen Jobmerkmalen auf den Wert desselben Parameters setzen.

Die letzte Anweisung DEFINE ist eine bedingte Anweisung, die möglicherweise bewirkt, dass RICOH ProcessDirector keine weiteren Anweisungen DEFINE in der Steuerdatei mehr liest. Wenn die in der Anweisung definierte Bedingung wahr ist, stoppt RICOH ProcessDirector das Lesen der Steuerdatei. Ist die Bedingung falsch, setzt RICOH ProcessDirector die Auswertung von anderen DEFINE-Anweisungen fort, die auf die FINALLY QUIT-Anweisung folgen.