receive_jcl_jobtype.cfg

La característica Soporte de AFP proporciona el archivo receive_jcl_jobtype.cfg.

RICOH ProcessDirector puede utilizar este archivo de control para interpretar un archivo JCL que acompaña a un conjunto de datos PRD, que RICOH ProcessDirector recibe de un dispositivo de entrada de Download. Por ejemplo, el archivo JCL puede contener esta información:

"-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"

Para usar un archivo de control, defina el valor de la propiedad Paso de inicialización de flujo de trabajo hijo para el dispositivo de entrada como SetJobTypeFromRules o SetJobTypeFromFileName y, a continuación, defina el valor de la propiedad Reglas de análisis de tipo de trabajo hijo como la vía de acceso y el nombre de archivo del archivo de control. El paso SetJobTypeFromRules utiliza el archivo de control para establecer el flujo de trabajo del trabajo, convertir un archivo de alteraciones temporales opcional sometido con un trabajo en un archivo en formato RICOH ProcessDirectornombre=valor de la propiedad para establecer las propiedades de trabajo, o ambos; el paso SetJobTypeFromFileName utiliza el archivo de control para establecer las propiedades de trabajo. Toda la información del archivo de control es sensible a las mayúsculas y minúsculas.

El archivo de control contiene estas secciones:

Sección CONFIGURATION

Ésta es una sección de valores globales que consta de palabras clave que definen la forma en que RICOH ProcessDirector interpreta el archivo JCL.

FILE_MODE

Esta palabra clave controla la forma en que RICOH ProcessDirector procesa el archivo JCL. El valor "FILE instruye a RICOH ProcessDirector para que trate toda la información del archivo como un solo registro. En esta modalidad, RICOH ProcessDirector puede realizar acciones de búsqueda y sustitución. Utilice siempre el valor "FILE" para los archivos de control que procesan archivos JCL. Es necesario indicar comillas en el valor.

ATTRIBUTE_PATTERN

Esta palabra clave especifica una expresión regular que define la manera en que RICOH ProcessDirector reconoce los nombres de las propiedades. Tal como indicó RICOH ProcessDirector, el valor es "\$\{Job.*\}". Las comillas dobles delimitan la expresión y las barras invertidas son caracteres de escape que preceden a los caracteres especiales de la expresión.

El valor "\$\{Job.*\}" indica a RICOH ProcessDirector que reconozca los nombres de propiedades como series que comienzan con Job. y a las que sigue un cero o más caracteres. Los nombres de propiedad del trabajo RICOH ProcessDirector coinciden con esta convención, como Job.Duplex y Job.Print.CumulativeSheetsStacked.

KEYWORD_CASE

Esta palabra clave define si los caracteres se escriben en mayúsculas o minúsculas en los nombres de parámetros del archivo JCL. Según los valores del sistema remitente, los parámetros se pueden pasar todos los caracteres en mayúsculas o con todos los caracteres en minúsculas. Utilice el valor "UPPER" o "LOWER" según los requisitos de la instalación.

NORMALIZER_PROGRAM

Esta palabra clave especifica el nombre de un programa que modifica el archivo JCL de modo que todas las propiedades que defina estén en la forma "palabra clave=valor". RICOH ProcessDirector proporciona el programa normalize_jcl.pl para modificar los diversos estilos de los parámetros JCL en el formulario "palabra clave=valor".

Por ejemplo, considere esta cadena JCL:

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

Cuando RICOH ProcessDirector utiliza el programa normalize_jcl.pl especificado en el archivo de control, reemplaza la cadena JCL con este valor

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

Delimite el principio y el final de la sección de CONFIGURACIÓN con CONFIGURATION y ENDCONFIGURATION.

Sección REPLACE

Esta sección utiliza mandatos sed para sustituir series en el archivo JCL. Está comentada en el archivo de ejemplo porque el programa definido por la palabra clave NORMALIZER_PROGRAM convierte el archivo JCL.

Por ejemplo, esta sentencia sustituye todas las apariciones de -opa= (observe el espacio inicial) con comas:

#s! -opa=!,!

Delimite el principio y el final de la sección REPLACE con REPLACE y ENDREPLACE.

Sección PATTERN KEY_VALUE

En esta sección se describe la manera en que RICOH ProcessDirector encuentra palabras clave y valores, y los convierte en señales utilizando grupos de expresiones regulares. Tal como indicó RICOH ProcessDirector, la sección tiene el siguiente aspecto:

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

El patrón está delimitado por las comillas dobles y el patrón a la izquierda del signo igual representa la palabra clave. El patrón a la derecha representa al valor. Este patrón crea una lista delimitad por comas de palabras clave y pares de valores.

Sección de sentencias DEFINE

Esta sección utiliza fórmulas de símbolos para definir el flujo de trabajo de RICOH ProcessDirector a partir de los valores de parámetros que se han pasado en el archivo JCL con el trabajo. Algunos ejemplos de los tipos de sentencias DEFINE que puede contener la sección son:

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

La primera sentencia DEFINE es una sentencia condicional. En este ejemplo, RICOH ProcessDirector establece el valor de la propiedad Job.JobType en BILLS cuando el valor del parámetro DEST del archivo JCL es LOCAL. Si el parámetro DEST tiene cualquier otro valor, RICOH ProcessDirector no define el flujo de trabajo a partir del archivo de control. Lo establece utilizando otro método, por ejemplo, utilizando el flujo de trabajo asignado al dispositivo de entrada de Download.

La segunda sentencia DEFINE es una sentencia no condicional. En este ejemplo, RICOH ProcessDirector define el valor de la propiedad de trabajo Job.Class en el valor del parámetro CLASS que se pasa con el trabajo. Por tanto, si la serie JCL original que recibe RICOH ProcessDirector contiene -opa=class=B, RICOH ProcessDirector define el valor de la propiedad Job.Class como B.

La tercera sentencia DEFINE es una sentencia condicional. En este ejemplo, RICOH ProcessDirector establece el valor de la propiedad Job.InputDataStream en AFP cuando el valor del parámetro DATAT de JCL es af. Si el parámetro DATAT tiene cualquier otro valor, RICOH ProcessDirector no establece el valor de la propiedad Job.InputDataStream.

La cuarta y quinta sentencia DEFINE son sentencias no condicionales que establecen los valores de dos propiedades distintas de trabajo en el valor del mismo parámetro.

La última sentencia DEFINE es una sentencia condicional que puede ocasionar que RICOH ProcessDirector deje de leer las sentencias DEFINE en el archivo de control. Si la condición que define la sentencia es cierta, RICOH ProcessDirector deja de leer el archivo de control. Si la condición es falsa, RICOH ProcessDirector continúa evaluando cualquier otra sentencia DEFINE que sigue a la sentencia FINALLY QUIT.