receive_jcl_jobtype.cfg
receive_jcl_jobtype.cfg
define el flujo de trabajo y las propiedades de trabajo para trabajos recibidos de
Descarga para z/OS y AFP Download Plus.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 RICOH ProcessDirector formato nombre de la propiedad=valor para establecer las propiedades de trabajo, o ambas cosas; 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, observe esta serie 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, sustituye la serie JCL por 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. Estos son algunos ejemplos de los tipos de sentencias DEFINE que puede incluir la sección:
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 esLOCAL
. 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 comoB
.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 esaf
. 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.