Recuadro de diálogo Crear trabajo por lotes

Utilice este recuadro de diálogo para someter un JCL definido por el usuario. Esta solicitud de acción es un equivalente más flexible a los mandatos del kit de utilidades que proporciona el producto.

El Separador Opciones de este recuadro de diálogo proporciona los campos que se describen a continuación. El apartado Limitaciones y consejos relativos al Kit de utilidades de almacenamiento proporciona información útil sobre la utilización de este recuadro de diálogo.

Para obtener información sobre las capacidades estándar de un recuadro de diálogo, consulte el apartado Separadores estándar de los recuadros de diálogo del Kit de utilidades de almacenamiento. El tema incluye un enlace a las Guías de consulta para los mandatos que se utilizan en el Kit de utilidades de almacenamiento.

Consulte el apartado Convenios para archivos JCL utilizados con el Kit de utilidades de almacenamiento. Consulte también el apartado Autenticación y autorización para ejecutar mandatos del Kit de utilidades de almacenamiento en referencia a la autorización necesaria para solicitudes de acción del Kit de utilidades de almacenamiento.
  • Conjunto de datos de sistema principal calificado al completo que contiene el JCL por lotes: Especifica el conjunto de datos que contiene el trabajo por lotes. El conjunto de datos debe ser secuencial o miembro de un conjunto de datos particionados (PDS). La longitud de registro lógico del conjunto de datos debe ser 80 y el conjunto de datos debe tener un formato con longitud fija. Para editar o crear el conjunto de datos, pulse el botón Editar JCL, que muestra el Recuadro de diálogo Editar conjunto de datos.
    Nota: El ID de usuario para Tivoli Enterprise Portal que utilice debe tener autorización en el sistema principal para acceder al conjunto de datos. Si el ID de usuario no tiene autorización, verá un mensaje de error al pulsar Editar JCL. Para obtener información adicional, consulte el apartado Autenticación y autorización para ejecutar mandatos del Kit de utilidades de almacenamiento.
  • Variables de sustitución y sus valores de sustitución en tiempo de ejecución: Especifica los valores de sustitución que deben utilizarse en tiempo de ejecución. Los valores de sustitución permiten que el trabajo por lotes haga referencia a objetos específicos como, por ejemplo, conjuntos de datos y volúmenes. Por ejemplo, estos objetos pueden corresponder a valores de las filas de tabla que se seleccionan antes de invocar este recuadro de diálogo.
    En la columna Variable, puede entrar un nombre exclusivo para cada variable de sustitución que existe en el conjunto de datos. En las celdas de la columna Atributo o cadena de caracteres puede seleccionar los nombres disponibles. Estos nombres reflejan los atributos de las filas de tabla que ha seleccionado en un espacio de trabajo, antes de invocar el recuadro de diálogo Crear trabajo por lotes. También puede especificar manualmente los valores en las celdas. Por ejemplo, puede que desee especificar valores como por ejemplo, nombre de trabajo, clase sysout y otros valores que pueden no estar presentes en la tabla de espacio de trabajo desde la que está seleccionando filas.
    Consejo: Utilice el convenio de signo de porcentaje para las variables de sustitución (%nombre%) que están presentes en el conjunto de datos JCL. De este modo, este recuadro de diálogo encuentra y lista automáticamente las variables de sustitución JCL.

    Consulte el apartado Variables de sustitución estándar del kit de utilidades para conocer las directrices que se aplican al uso de las variables de sustitución.

  • Archivos cuyo contenido debe copiarse para visualizarse posteriormente: Especifica los nombres de DD y los conjuntos de datos que deben conservarse como un registro de los resultados del trabajo por lotes. Los archivos están disponibles para visualizarse en el espacio de trabajo Detalles de resultados de Kit de utilidades de almacenamiento.
    En la columna Nombre de paso, especifique el nombre del paso cuyos datos desea guardar. En la columna Nombre de conjunto de datos o DD calificado al completo, especifique los conjuntos de datos secuenciales o miembros de un conjunto de datos particionados o los nombres de DD que desea copiar. La tabla siguiente muestra algunos valores de ejemplo para esta área del recuadro de diálogo:
    Tabla 1. Valores de ejemplo para "Archivos cuyo contenido debe copiarse para visualizarse más adelante"
    Nombre de paso Nombre de conjunto de datos o DD
    STEPX USER02.LOG.LISTING
    STEPY SYSPRINT
    La especificación de la fila uno conserva los datos del conjunto de datos USER02.LOG.LISTING.
    La especificación de la fila dos conserva el archivo SYSPRINT en STEPY. Esta salida se guarda en el archivo de punto de comprobación. Se aplican las restricciones siguientes:
    • Sólo se da soporte a los conjuntos de datos secuenciales o a miembros de un PDS.
    • Los conjuntos de datos VSAM no están soportados.
    • Es posible que los conjuntos de datos o archivos que contienen caracteres no imprimibles (por ejemplo, código hexadecimal) no se visualicen correctamente en el espacio de trabajo Detalles de resultados de Kit de utilidades de almacenamiento.
    • Las líneas de salida cuya longitud supere los 256 caracteres se truncan.
  • Conjuntos de datos calificados al completo necesarios para el trabajo que también contienen variables de sustitución: Especifica los conjuntos de datos que están fuera de la secuencia de trabajos JCL. Estos conjuntos de datos pueden ser necesarios para proporcionar dinámicamente variables de sustitución que correspondan a objetos (como conjuntos de datos y volúmenes) necesarios cuando se ejecuta el trabajo por lotes. Estos conjuntos de datos adicionales pueden ser conjuntos de datos secuenciales o miembros de conjuntos de datos particionados. La longitud de registro lógico de estos conjuntos de datos debe ser 80 y estos conjuntos de datos deben tener un formato con longitud fija.

    Por ejemplo, es posible que un trabajo IEHLIST utilice una sentencia SYSIN DD que señale a un conjunto de datos DASD y no a tarjetas de control de corriente de entrada. Dicho conjunto de datos puede contener variables de sustitución que se deban sustituir en tiempo de ejecución.

    Si ningún conjunto de datos contiene variables de sustitución a las que se hace referencia desde JCL, esta área del recuadro de diálogo puede permanecer vacía.

    Es posible que obtenga los códigos de retorno siguientes cuando no pueda acceder a los conjuntos de datos:
    Código de retorno Descripción
    119 (DataSetError) Servidor de conjunto de datos de usuario (UDS) anómalo.
    121 (AuthorizationFailure) Intenta acceder a un conjunto de datos para el cual no dispone de autorización RACF.
    123 (DataSetError) El conjunto de datos no existe, no tiene un formato soportado o una longitud de registro soportada.
    Es posible que reciba el código de retorno (estado) 117 (InvalidJCL). Este estado suele indicar que el JCL supera los 72 caracteres cuando se aplican las variables de sustitución. También puede indicar otros errores relacionados con el JCL, como la falta de una tarjeta JOB o que otro conjunto de datos que requiere sustitución de variables excede los 80 caracteres cuando se aplican las variables de sustitución.

    Asegúrese de consultar el resto de los mensajes sobre estos resultados en el RKLVLOG.

Cuando haya completado la configuración del trabajo por lotes, pulse Aceptar en el recuadro de diálogo Crear trabajo por lotes. Llegado este punto, el archivo JCL que proporcione y cualquier archivo que esté fuera del JCL que contiene las variables de sustitución se copiarán en los archivos temporales. Estos archivos temporales se utilizan al someter el JCL de trabajo por lotes.

Tema principal: Acciones personalizadas en el Kit de utilidades de almacenamiento
Información relacionada:
Utilización de variables de sustitución en el Kit de utilidades de almacenamiento
Ejemplos de variables de sustitución
Utilización del Kit de utilidades de almacenamiento

Convenios para archivos JCL utilizados con el Kit de utilidades de almacenamiento

El conjunto de datos para el JCL que cree o edite debe ser secuencial o miembro de un conjunto de datos particionados (PDS). Los conjuntos de datos JCL que utilice con el Kit de utilidades de almacenamiento deben seguir convenios para que Tivoli Enterprise Portal pueda sustituir los valores de los datos en tiempo de ejecución. Los elementos siguientes (que en la Figura 1 se muestran en negrita) son variables de sustitución que el Kit de utilidades de almacenamiento sustituirá durante la ejecución del trabajo:
  • %job-name% (véase la línea 000100)
  • %sysout% (véase la línea 000100)
  • %my-volser% (véase la línea 000800)
  • %dsname% (véase la línea 000800)
Figura 1. Elementos variables para archivos JCL utilizados con el Kit de utilidades de almacenamiento
****** ***************************** Top of Data ******************************
000100 //%job-name% JOB (),'DHODS',REGION=4M,MSGCLASS=%sysout%,NOTIFY=&SYSUID, 
000200 //         CLASS=A
000300 //* ------------------------------------------------------------------- 
000400 //LISTVTOC EXEC PGM=IEHLIST                                             
000500 //SYSPRINT DD SYSOUT=*                                                  
000600 //SYSIN    DD *                                                         
000700 )DOT                                                                    
000800   LISTVTOC DUMP,VOL=3390=%my-volser%,DSNAME=(%dsname%)                  
000900 )ENDDOT
001000 /*                                                                      
001100 //                                                                      
****** **************************** Bottom of Data ****************************
Consejo: Utilice el convenio de signo de porcentaje para las variables de sustitución (%nombre%) que están presentes en el conjunto de datos JCL. De este modo, este recuadro de diálogo encuentra y lista automáticamente las variables de sustitución JCL.
Las líneas )DOT y )ENDDOT de la Figura 1 indican el inicio y el fin del proceso de la tabla. Las líneas de JCL situadas entre las líneas )DOT y )ENDDOT se repiten para cada fila de la tabla que se pasa al agente del sistema principal en el tiempo de ejecución de JCL. Generalmente, estas líneas contienen variables de sustitución que se sustituyen por nuevos valores durante la ejecución. Por ejemplo, la salida de estas líneas del JCL SYSIN puede ser similar a este extracto:
000600 //SYSIN    DD *                                                         
000700   LISTVTOC DUMP,VOL=3390=TSO201,DSNAME=(SYS2.USER.CLIST)                    
000800   LISTVTOC DUMP,VOL=3390=TSO202,DSNAME=(SYS2.USER.PROCLIB)                    
000900   LISTVTOC DUMP,VOL=3390=MVSA12,DSNAME=(SYS2.PROD.LOADLIB)                    
001000 /*