44
IBM Tivoli Workload Scheduler Agente tolerante a errores limitado para AS/400 Versión 8.2 (Release de mantenimiento, abril de 2004) SC10-9992-01

Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

  • Upload
    others

  • View
    2

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

IBM Tivoli Workload Scheduler

Agente tolerante a errores limitado para

AS/400

Versión 8.2 (Release de mantenimiento, abril de 2004)

SC10-9992-01

���

Page 2: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo
Page 3: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

IBM Tivoli Workload Scheduler

Agente tolerante a errores limitado para

AS/400

Versión 8.2 (Release de mantenimiento, abril de 2004)

SC10-9992-01

���

Page 4: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Nota

Antes de utilizar esta información y el producto al que se da soporte, lea la información del apartado “Avisos” en la página

27.

Edición actualizada (abril de 2004)

Este manual es la traducción del original inglés IBM Tivoli Workload Scheduler Limited Fault-tolerant Agent for AS/400

Version 8.2 (Maintenance Release April 2004), (SC32-1280-01).

Esta edición atañe a la versión 8, release 2, modificación 0 de IBM Tivoli Workload Scheduler (número de programa

5698-WSH) y a todos los releases y modificaciones subsiguientes hasta que se indique lo contrario en nuevas

ediciones.

© Copyright International Business Machines Corporation 1991, 2004. Reservados todos los derechos.

Page 5: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Contenido

Prefacio . . . . . . . . . . . . . . . v

Release de mantenimiento . . . . . . . . . . v

A quién va dirigido este manual . . . . . . . . v

Contenido de este manual . . . . . . . . . . v

Publicaciones . . . . . . . . . . . . . . vi

Publicaciones para Tivoli Workload Scheduler . . vi

Publicaciones para Tivoli Workload Scheduler for

z/OS . . . . . . . . . . . . . . . vi

Acceso a las publicaciones en línea . . . . . vii

Solicitud de publicaciones . . . . . . . . viii

Envío de comentarios sobre las publicaciones viii

Accesibilidad . . . . . . . . . . . . . viii

Cómo ponerse en contacto con IBM Software

Support . . . . . . . . . . . . . . . viii

Convenios utilizados en este manual . . . . . . ix

Convenios tipográficos . . . . . . . . . . . ix

Variables y rutas dependientes del sistema operativo ix

Capítulo 1. Instalación y configuración . 1

Introducción . . . . . . . . . . . . . . 1

Características . . . . . . . . . . . . . . 1

Requisitos de software . . . . . . . . . . . 1

Antes de la instalación . . . . . . . . . . . 1

Procedimiento de instalación . . . . . . . . . 1

Instalación mediante RSTLICPGM . . . . . . 1

Inicio de Netman . . . . . . . . . . . . . 3

Adición de un Agente tolerante a errores limitado

para AS/400 . . . . . . . . . . . . . . 4

Ejemplo de interfaz gráfica de usuario de Job

Scheduling Console . . . . . . . . . . . 4

Ejemplo de línea de comandos . . . . . . . 6

Opciones locales . . . . . . . . . . . . . 6

Cómo establecer las opciones locales . . . . . 6

Archivo de configuración de Netman . . . . . . 11

Desinstalación de Tivoli Workload Scheduler . . . 12

Capítulo 2. Utilización . . . . . . . . 13

Definición de trabajos de AS/400 en Tivoli

Workload Scheduler . . . . . . . . . . . 13

Uso de la palabra clave NOSTDLIST . . . . . 13

Estado del trabajo en Tivoli Workload Scheduler 13

Trabajos de AS/400 controlados por Tivoli

Workload Scheduler: modalidad normal . . . . 14

Trabajos de AS/400 controlados por Tivoli

Workload Scheduler: modalidad ampliada . . . 15

Planificación de trabajos de AS/400 . . . . . . 17

Ejemplo de línea de comandos . . . . . . . 18

Control del entorno de trabajo con JOBMANRC . . 18

Gestión de Tivoli Workload Scheduler en el Agente

tolerante a errores limitado para AS/400 . . . . 19

Autorización necesaria . . . . . . . . . . 19

Comandos de Tivoli Workload Scheduler . . . 19

Inicio automático de Tivoli Workload Scheduler 20

Gestión de la producción de Tivoli Workload

Scheduler en el Agente tolerante a errores

limitado para AS/400 . . . . . . . . . . 20

Visualización de trabajos de Tivoli Workload

Scheduler en el Agente tolerante a errores

limitado para AS/400 . . . . . . . . . . 20

Mensajes de consola e indicadores de Tivoli

Workload Scheduler . . . . . . . . . . 21

Programas de utilidad de Tivoli Workload

Scheduler no soportados . . . . . . . . . 21

Capítulo 3. Resolución de problemas 23

Limitaciones y soluciones provisionales . . . . . 23

Avisos . . . . . . . . . . . . . . . 27

Marcas registradas . . . . . . . . . . . . 28

Índice . . . . . . . . . . . . . . . 29

© Copyright IBM Corp. 1991, 2004 iii

||

| |

Page 6: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

iv Agente tolerante a errores limitado para AS/400

Page 7: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Prefacio

El Agente tolerante a errores limitado de Tivoli Workload Scheduler para AS/400

permite planificar, iniciar y controlar trabajos en un sistema AS/400 mediante las

sofisticadas herramientas de planificación de trabajos de Tivoli Workload

Scheduler.

Release de mantenimiento

Se trata de una actualización de mantenimiento del manual correspondiente de

IBM Tivoli Workload Scheduler Versión 8.2, número de formulario SC10–9992–00.

Contiene actualizaciones para los problemas siguientes:

v Defectos internos:

– 168587

– 168588

– 168589

– 168651

– 168777v APAR IY55408

Se han marcado las secciones nuevas o modificadas del libro con barras de

revisión. Si su versión del producto no se ha arreglado para un APAR (informe

autorizado de análisis de programa) en concreto, consulte la versión original del

manual para obtener la información correspondiente.

A quién va dirigido este manual

Este manual está destinado a los gestores de sistemas que deseen instalar y

configurar Agentes tolerantes a errores limitados de Tivoli Workload Scheduler en

AS/400, así como a los administradores de sistemas que realicen tareas diarias de

administración.

Los usuarios de esta guía deberían estar familiarizados con:

v Tivoli Workload Scheduler

v El sistema operativo AS/400

Contenido de este manual

El manual Tivoli Workload Scheduler - Agente tolerante a errores limitado para

AS/400 contiene los capítulos siguientes:

v Capítulo 1, “Instalación y configuración”, en la página 1, Instalación y

configuración

Contiene instrucciones de instalación y configuración del agente de AS/400.

v Capítulo 2, “Utilización”, en la página 13, Utilización

Describe cómo definir y planificar trabajos para ejecutar el agente de AS/400.

v Capítulo 3, “Resolución de problemas”, en la página 23, Resolución de

problemas

Proporciona información sobre cómo solucionar problemas.

© Copyright IBM Corp. 1991, 2004 v

|

|||

|

|

|

|

|

|

|

||||

Page 8: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Publicaciones

Esta sección lista las publicaciones de la biblioteca de Tivoli Workload Scheduler for

z/OS y de todos los documentos relacionados. También describe cómo acceder a las

publicaciones de Tivoli en línea, cómo solicitar publicaciones de Tivoli y cómo

hacer comentarios sobre las mismas.

Publicaciones para Tivoli Workload Scheduler

Los manuales siguientes están disponibles en la biblioteca de Tivoli Workload

Scheduler:

v Tivoli Workload Scheduler - Planificación e instalación, SC10-3833

Describe la planificación e instalación de Tivoli Workload Scheduler.

v Tivoli Workload Scheduler - Guía de consulta, SC10-3852

Explica la utilización de la línea de comandos de Tivoli Workload Scheduler,

describiendo cómo funcionan los agentes ampliados y de red y cómo se integra

Tivoli Workload Scheduler con NetView y Tivoli Business Systems Manager.

v Tivoli Workload Scheduler Troubleshooting and Error Messages, SC32-1275

Interpreta los mensajes de error de Tivoli Workload Scheduler y proporciona

fuentes de información que le ayudarán a resolver problemas con Tivoli

Workload Scheduler.

v Tivoli Workload Scheduler for Applications User’s Guide, SC32-1278

Describe la instalación, utilización y resolución de problemas de agentes

ampliados de Tivoli Workload Scheduler.

v Tivoli Workload Scheduler for Applications Release Notes, SC32-1279

Proporciona la información más reciente sobre los agentes ampliados de Tivoli

Workload Scheduler.

v Tivoli Workload Scheduler - Guía del usuario para el Agente tolerante a errores para

AS/400, SC10-9992

Describe la instalación, configuración y utilización de agentes tolerantes a errores

paraAS/400 de Tivoli Workload Scheduler.

v Tivoli Workload Scheduler - Guía de usuario del módulo Plus, SC10-3865

Explica la configuración y utilización del módulo Plus de Tivoli Workload

Scheduler.

v Tivoli Workload Scheduler Release notes, SC32-1277

Explica las últimas novedades sobre Tivoli Workload Scheduler.

Publicaciones para Tivoli Workload Scheduler for z/OS

Los manuales siguientes están disponibles en la biblioteca de Tivoli Workload

Scheduler for z/OS:

v Customization and Tuning, SC32-1265

Describe la personalización de Tivoli Workload Scheduler for z/OS.

v Installation Guide, SC32-1264

Describe el proceso de instalación de Tivoli Workload Scheduler for z/OS.

v Diagnosis Guide and Reference, SC32-1261

Proporciona información para ayudar a diagnosticar y corregir los problemas

que pueden surgir al utilizar el producto.

v General Information, SC32-1256

Describe las ventajas de toda la suite de productos de Tivoli Workload

Scheduler.

vi Agente tolerante a errores limitado para AS/400

Page 9: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

v Getting Started, SC32-1262

Describe conceptos y terminología de Tivoli Workload Scheduler for z/OS y

proporciona instrucciones para que el usuario pueda trabajar con el producto lo

antes posible.

v IBM Job Scheduling Console Release Notes, SC32-1258

Proporciona información sobre cómo trabajar con Tivoli Workload Scheduler,

independientemente de la plataforma utilizada, desde una GUI común.

v IBM Job Scheduling Console - Guía del usuario, SC10-3171

Proporciona información sobre cómo trabajar con Tivoli Workload Scheduler,

independientemente de la plataforma utilizada, desde una GUI común.

v Licensed Program Specifications, GI11-4208

Proporciona información para planificar Tivoli Workload Scheduler for z/OS.

v Managing the Workload, SC32-1263

Explica cómo planificar y programar la carga de trabajo y cómo controlar y

supervisar la planificación actual.

v Memo to Users, GI11-4209

Proporciona un resumen de las modificaciones del release actual del producto.

v Messages and Codes, SC32-1267

Explica los mensajes y los códigos.

v Program Directory, GI11-4203

Incorpora la cinta de instalación de Tivoli Workload Scheduler for z/OS,

describe todos los materiales de instalación y proporciona instrucciones de

instalación específicas del nivel de release del producto o del número de

característica.

v Programming Interfaces, SC32-1266

Proporciona información sobre cómo escribir programas de aplicación.

v Quick Reference, SC32-1268

Proporciona una referencia de consulta rápida y fácil para utilizar el producto.

Acceso a las publicaciones en línea

El CD del producto contiene las publicaciones que existen en la biblioteca del

producto. El formato de las publicaciones es PDF, HTML o ambos. Para acceder a

las publicaciones mediante un navegador Web, abra el archivo infocenter.html. El

archivo se encuentra en el directorio de publicaciones correspondiente en el CD del

producto.

IBM envía publicaciones, para éste y todos los demás productos de Tivoli, a

medida que están disponibles y siempre que se actualizan, al sitio Web de Tivoli

Software Information Center. Tivoli Software Information Center está ubicado en la

siguiente dirección Web:

http://publib.boulder.ibm.com/tividd/td/tdprodlist.html

Haga clic sobre el vínculo Tivoli Workload Scheduler for z/OS para acceder a la

biblioteca del producto.

Nota: Si imprime documentos PDF en papel que no sea de tamaño carta,

seleccione el cuadro de selección Ajustar a página en el diálogo Imprimir

de Adobe Acrobat. Esta opción está disponible haciendo clic en Archivo →

Imprimir. Ajustar a página garantiza que todas las dimensiones de la

página de tamaño carta se imprimirán en el papel que está utilizando.

Prefacio vii

Page 10: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Solicitud de publicaciones

Puede solicitar muchas publicaciones de Tivoli en línea desde el siguiente sitio

Web:

http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi

También puede solicitarlas por teléfono, llamando a uno de estos números:

v En Estados Unidos: 800-879-2755

v En Canadá: 800-426-4968

En otros países, consulte el siguiente sitio Web para obtener un listado de los

números de teléfono:

http://www.ibm.com/software/tivoli/order-lit/

Envío de comentarios sobre las publicaciones

Si quiere hacer comentarios o sugerencias sobre los productos y la documentación

de Tivoli, rellene nuestro formulario de comentarios en el siguiente sitio Web:

http://www.ibm.com/software/sysmgmt/products/support

Accesibilidad

Las funciones de accesibilidad permiten que los usuarios que padecen alguna

discapacidad física, como movilidad limitada o visión reducida, utilicen los

productos de software de manera satisfactoria. Con este producto, es posible

emplear tecnologías de asistencia para la escucha y navegación de la interfaz.

También puede utilizarse el teclado, en lugar del ratón, para trabajar con la

mayoría de las funciones de la interfaz gráfica de usuario.

Si desea información adicional, consulte el apéndice dedicado a la accesibilidad en

el manual Tivoli Workload Scheduler for z/OS Guía de instalación.

Cómo ponerse en contacto con IBM Software Support

Si surge un problema con algún producto de Tivoli, puede ponerse en contacto con

IBM Software Support. Consulte la publicación IBM Software Support Guide en el

siguiente sitio Web:

http://techsupport.services.ibm.com/guides/handbook.html

Esta guía proporciona información sobre cómo ponerse en contacto con IBM

Software Support, en función de la la gravedad del problema y de la información

siguiente:

v Registro y eligibilidad

v Números de teléfono y direcciones de correo electrónico, en función del país en

el que se encuentre

v Información de la que debe disponer antes de contactar con IBM Software

Support

viii Agente tolerante a errores limitado para AS/400

Page 11: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Convenios utilizados en este manual

En este manual se utilizan diversos convenios tipográficos para términos y

acciones especiales. Estos convenios son los siguientes:

Tipo de información Convenio estilístico Ejemplo

Comandos Todo en mayúsculas CREATE

Referencias en el texto a

campos de paneles

Todo en mayúsculas CANTIDAD

Texto que el usuario debe

entrar en los campos de los

paneles

Monoespaciado MIAPLICACIÓN

Primera vez que se utiliza un

nuevo término

Cursiva Aplicación

Convenios tipográficos

Esta guía utiliza los siguientes convenios tipográficos:

Negrita

v Comandos en minúsculas y en mayúsculas y minúsculas que, de lo

contrario, no pueden distinguirse fácilmente del texto que los rodea.

v Controles de la interfaz (cuadros de selección, pulsadores, botones de

selección, selectores cíclicos, campos, carpetas, iconos, cuadros de lista,

elementos incluidos en cuadros de lista, listas de varias columnas,

contenedores, opciones de menú, nombres de menús, pestañas, hojas de

propiedades), etiquetas (como por ejemplo Consejo: y Consideraciones

sobre el sistema operativo:)

v Títulos de columnas en una tabla

v Palabras clave y parámetros en el texto

Cursiva

v Citas (títulos de libros, disquetes y CD)

v Palabras definidas en el texto

v Énfasis en palabras (palabras como palabras)

v Letras como letras

v Nuevos términos en el texto (excepto en una lista de definiciones)

v Variables y valores que debe proporcionar el usuario

Monoespaciado

v Ejemplos y ejemplos de códigos

v Nombres de archivos, palabras clave de programación y otros elementos

que no pueden distinguirse fácilmente del texto que los rodea

v Textos de mensajes y solicitudes dirigidas al usuario

v Texto que debe escribir el usuario

v Valores para argumentos u opciones de comandos

Variables y rutas dependientes del sistema operativo

Esta guía utiliza el convenio UNIX para especificar variables de entorno y para la

notación de directorios.

Prefacio ix

Page 12: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Cuando utilice la línea de comandos de Windows, sustituya $variable por %

variable% en el caso de variables de entorno y sustituya cada barra inclinada (/) por

una barra inclinada invertida ( \) en el caso de las rutas de directorios.

Nota: Si utiliza el shell bash en un sistema Windows, puede utilizar los convenios

de UNIX.

x Agente tolerante a errores limitado para AS/400

Page 13: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Capítulo 1. Instalación y configuración

Introducción

El Agente tolerante a errores limitado de Tivoli Workload Scheduler para AS/400

permite planificar, iniciar y controlar trabajos en un sistema AS/400 utilizando las

sofisticadas herramientas de planificación de trabajos de Tivoli Workload

Scheduler.

Características

v Utiliza dependencias de trabajos de Tivoli Workload Scheduler estándar en

trabajos de AS/400.

v Planifica trabajos de AS/400 en días específicos y a horas concretas.

v Asigna diferentes prioridades a trabajos de AS/400 para que se ejecuten en un

orden determinado.

v Define interdependencias entre trabajos de AS/400 y trabajos que se ejecutan en

otros sistemas, como UNIX, Windows NT y SAP R/3.

Requisitos de software

Para instalar y utilizar el Agente tolerante a errores limitado de Tivoli Workload

Scheduler para AS/400, es preciso utilizar una versión con soporte de OS/400.

Llame al servicio de soporte al cliente para obtener información actualizada sobre

las versiones de OS/400 soportadas.

Antes de la instalación

Para instalar el Agente tolerante a errores limitado de Tivoli Workload Scheduler

para AS/400, es preciso ser QSECOFR o tener autorización *ALLOBJ. Además, el

valor del sistema QALWOBJRST debe estar establecido en *ALWPGMADP o

*ALL.

Procedimiento de instalación

Para instalar el Agente tolerante a errores limitado de Tivoli Workload Scheduler

para AS/400, siga el procedimiento que se indica a continuación.

Lea detenidamente las instrucciones antes de empezar la instalación.

Nota: desinstale el producto antes de intentar instalar el software encima de una

instalación anterior. Consulte la sección “Desinstalación de Tivoli Workload

Scheduler” en la página 12 si desea obtener más información.

Instalación mediante RSTLICPGM

Siga este procedimiento para instalar el Agente tolerante a errores limitado de

Tivoli Workload Scheduler para AS/400 mediante el comando RSTLICPGM en

AS/400.

1. Inserte el CD 2 de IBM Tivoli Workload Scheduler Versión 8.2 en el sistema

UNIX o Windows. En UNIX, monte el CD utilizando el comando de la

plataforma adecuado.

© Copyright IBM Corp. 1991, 2004 1

|||

Page 14: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

2. De forma opcional, abra una CLI del shell para UNIX o un Indicador de

comandos de DOS en Windows.

3. De forma opcional, cree un directorio temporal para copiar el archivo del

producto. Por ejemplo:

mkdir twslftatmp

4. Diríjase al directorio temporal. Por ejemplo:

cd twslftatmp

5. Copie el archivo del producto LFTA (Agente tolerante a errores limitado) en el

directorio temporal. Por ejemplo,

v En UNIX:

cp /DIR_MONTAJE/As400/QTWS.V1R3M0.SAVF .

donde DIR_MONTAJE es el directorio en el que se ha montado el CD ROM.

v En Windows:

copie X:\As400\QTWS.V1R3M0.SAVF .

donde X es el identificador de letra del CD ROM. 6. En el sistema AS/400, cree un archivo de salvar. Por ejemplo:

CRTSAVF QGPL/QFTASAVF

donde QGPL/QFTASAVF es el nombre del archivo de salvar.

7. En el sistema UNIX, utilice ftp para copiar el archivo de salvar en el archivo

de salvar de AS/400. Por ejemplo:

ftp 124.56.34.130

User: QSECOFR

Password: xxxxx

ftp> bin

ftp> put QTWS.V1R3MO.SAVF QGPL/QFTASAVF

ftp> quit

donde QTWS.V1R3MO.SAVF es el nombre del archivo del producto para los

sistemas RISC AS/400.

8. En el sistema AS/400, ejecute el comando RSTLICPGM. Por ejemplo:

RSTLICPGM LICPGM(5G97WKB) DEV(*SAVF) SAVF(QGPL/QFTASAVF)

9. En el sistema AS/400, ejecute el comando CUSTOMIZE.

a. Para realizar una instalación nueva, utilice la sintaxis siguiente:

CUSTOMIZE TYPE(*NEW) THISCPU(nombre) MASTER(nombre)

GROUP(grupo) COMPANY(nombre) EXPANDED(*YES | *NO)

donde:

TYPE(*NEW)

Especifica que se trata de una nueva instalación del Agente

tolerante a errores limitado de Tivoli Workload Scheduler para

AS/400. Este parámetro es obligatorio en las nuevas instalaciones.

THISCPU(nombre)

Especifica el nombre en Tivoli Workload Scheduler del Agente

tolerante a errores para AS/400. Este nombre se utilizará

posteriormente para definir formalmente la estación de trabajo en

Tivoli Workload Scheduler. Este parámetro es obligatorio.

MASTER(nombre)

Especifica el nombre en Tivoli Workload Scheduler de la estación

de trabajo principal. Este parámetro es obligatorio.

2 Agente tolerante a errores limitado para AS/400

||

||

|

|

|

||

|

|

|

|

|

|

||

Page 15: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

GROUP(grupo)

Especifica el nombre del grupo de producto en el que se va a

instalar el Agente tolerante a errores para AS/400. Los grupos de

producto permiten la instalación de varias instancias de un

producto. Por ejemplo, puede instalarse una versión de prueba del

producto en el grupo TEST y una versión de producción en el

grupo PROD. Este parámetro es obligatorio.

COMPANY(nombre)

Especifica el nombre de su empresa. Este parámetro es obligatorio.

EXPANDED *YES

La modalidad de la base de datos para el Agente tolerante a

errores limitado debe coincidir con la modalidad de la base de

datos para la estación de trabajo principal de Tivoli Workload

Scheduler. Este parámetro es obligatorio.Por ejemplo:

CUSTOMIZE TYPE(*NEW) THISCPU(‘AS400-2’) MASTER(CENTRAL) GROUP(PRODUCTION)

COMPANY(‘AJAX FOODS’) EXPANDED(*YES)

b. Para actualizar una instalación existente, utilice la sintaxis siguiente:

CUSTOMIZE TYPE(*UPDATE) GROUP(grupo) COMPANY(nombre)

donde:

TYPE(*UPDATE)

Especifica que se trata de una actualización de una instalación

existente del Agente tolerante a errores limitado de Tivoli

Workload Scheduler para AS/400. Este parámetro es obligatorio

para las instalaciones de actualización.

GROUP(grupo)

Especifica el nombre del grupo de producto que se va a actualizar.

Este parámetro es obligatorio.

COMPANY(nombre)

Especifica un nombre nuevo de empresa para sustituir el nombre

existente. Este parámetro es obligatorio.Por ejemplo:

CUSTOMIZE TYPE(*UPDATE) GROUP(PRODUCTION) COMPANY(TIVOLI)

10. Para instalar los programas de utilidad no soportados de Tivoli Workload

Scheduler en la biblioteca QTWSTOOLS, entre el comando siguiente:

RSTLIB SAVLIB(QTWSTOOLS) DEV(*SAVF) SAVF(QTWS/QTWSTOOLS)

Si desea obtener información sobre los programas de utilidad, consulte la

sección “Programas de utilidad de Tivoli Workload Scheduler no soportados”

en la página 21.

Inicio de Netman

Para empezar a utilizar el Agente tolerante a errores limitado para AS/400, inicie el

proceso NETMAN. Para iniciar NETMAN, inicie la sesión como usuario con

autorización *ALLOBJ en el sistema AS/400 y especifique los siguientes comandos:

CRTJOBD JOBD(QGPL/QMAESTRO) USER(QMAESTRO)

CHGOBJOWN OBJ(QGPL/QMAESTRO) OBJTYPE(*JOBD) NEWOWN(QMAESTRO)

CHGUSRPRF USRPRF(QMAESTRO) PASSWORD(contraseña) JOBD(QGPL/QMAESTRO)

Capítulo 1. Instalación y configuración 3

Page 16: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Cuando desee iniciar el trabajo NETMAN, inicie la sesión como perfil de usuario

QMAESTRO y ejecute lo siguiente:

STRNETMAN

Adición de un Agente tolerante a errores limitado para AS/400

Para empezar a planificar trabajos en un agente tolerante a errores limitado para

AS/400, debe añadirlo a la red de Tivoli Workload Scheduler. Para ello, añada una

definición de CPU para el sistema AS/400 mediante el programa de la interfaz

gráfica de usuario de Job Scheduling Console o la línea de comandos de Job

Scheduling Console.

Ejemplo de interfaz gráfica de usuario de Job Scheduling

Console

La figura siguiente muestra la ventana de definición de CPU de Job Scheduling

Console para un agente tolerante a errores limitado para AS/400 denominado

AS400-2. Para obtener información sobre el uso de la consola para añadir

definiciones de CPU, consulte la publicación Tivoli Job Scheduling Console - Guía del

usuario.

A continuación se describen los campos de una definición de CPU:

Nombre

Especifica el nombre en Tivoli Workload Scheduler del agente de AS/400.

El nombre debe empezar con una letra y puede contener caracteres

alfanuméricos, guiones (-) y subrayados (_). Con bases de datos no

ampliadas, puede contener un máximo de ocho caracteres. Con bases de

datos ampliadas, puede contener hasta 16 caracteres.

Nodo Especifica el nombre de nodo o dirección IP del AS/400.

Puerto TCP

Especifica el número de puerto TCP de NETMAN en el agente de AS/400.

El valor predeterminado es 31111. Debe ser el mismo que el valor de la

4 Agente tolerante a errores limitado para AS/400

Page 17: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

opción nm port del archivo de opciones locales. Consulte la sección

“Opciones locales” en la página 6 si desea obtener más información acerca

de las opciones locales.

Sistema operativo

Especifica el tipo de sistema operativo. Seleccione OTHER.

Descripción

Descripción del agente. Puede contener 40 caracteres alfanuméricos como

máximo.

Dominio

Especifica el dominio de Tivoli Workload Scheduler del que es miembro el

agente. Pulse en el botón Dominios... para visualizar una lista de los

dominios disponibles entre los que puede elegir. El valor predeterminado

es el dominio maestro, que normalmente se denomina masterdm.

Tipo de estación de trabajo

Especifica el tipo de agente. Seleccione Agente tolerante a errores.

Enlace automático

Seleccione Enlace automático para que el enlace de comunicación del

agente se abra automáticamente cuando se inicie su gestor de dominio.

Ignorar

Seleccione esta opción para pasar por alto esta definición de CPU. Resulta

útil si desea predefinir objetos de planificación para un agente que no está

instalado.

Resolver dependencias

Seleccione esta opción para que el proceso de control de producción del

agente funcione en la modalidad de resolución de todas las dependencias.

En esta modalidad, el agente hace un seguimiento de las dependencias de

todos los trabajos y todas las planificaciones, incluidos los que se ejecutan

en otras estaciones de trabajo.

Si no se selecciona esta opción, el agente realiza únicamente un

seguimiento de sus propios trabajos y planificaciones. Con esto se reduce

el uso de la CPU, pues se limita la actividad general de proceso.

Para mantener el archivo de control de producción del agente al mismo

nivel de detalle que su gestor de dominio, seleccione las opciones Estado

completo y Resolver dependencias. Vea Estado completo, a continuación.

Estado completo

Seleccione esta opción para que el enlace del gestor de dominio funcione

en la modalidad Estado completo. En esta modalidad, el agente dispone de

información actualizada sobre el estado de los trabajos y las planificaciones

que se ejecutan en otras estaciones de trabajo de la red.

Si esta opción no está seleccionada, el agente sólo dispone de información

sobre el estado de los trabajos y las planificaciones de otras estaciones de

trabajo que afectan a sus propios trabajos y planificaciones. Esto puede

mejorar el funcionamiento, al reducir el tráfico de la red.

Para mantener el archivo de control de producción del agente al mismo

nivel de detalle que su gestor de dominio, seleccione las opciones Estado

completo y Resolver dependencias. Vea Resolver dependencias, más arriba.

Servidor

Utilice este campo para identificar un servidor Mailman en el gestor de

dominio para gestionar las comunicaciones con el agente. Puede ser una

Capítulo 1. Instalación y configuración 5

Page 18: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

letra o un número (A-Z o 0-9). Los ID son exclusivos de cada gestor de

dominio, de modo que puede utilizar los mismos ID para agentes de

dominios diferentes sin que entren en conflicto. Si se necesitan más de 36

ID de servidor en un dominio, considere la posibilidad de dividirlo en dos

o más dominios.

De forma predeterminada, los mensajes enviados a un agente estándar o

tolerante a errores los gestiona un único proceso Mailman en el gestor de

dominio. Al especificar un ID de servidor, se crea un proceso Mailman

adicional. Puede utilizarse el mismo ID de servidor para varios agentes. El

uso de los servidores reduce el tiempo necesario para inicializar los agentes

y mejora la puntualidad de los mensajes. Como orientación, conviene

definir servidores adicionales para evitar que un solo Mailman gestione

más de ocho agentes.

Ejemplo de línea de comandos

También se pueden entrar definiciones de estación de trabajo en la línea de

comandos de Job Scheduling Console. La definición de estación de trabajo del

ejemplo anterior se puede entrar mediante la línea de comandos de Job Scheduling

Console de la siguiente manera:

cpuname as400-2

node 12.134.67.24

tcpaddr 31111

os other

domain masterdm

description "AS/400 fault-tolerant agent #2"

for maestro

autolink on

fullstatus on

resolvedep on

end

Para obtener información sobre el uso de la interfaz de la línea de comandos de

Job Scheduling Console para crear definciones de CPU, consulte la publicación

Tivoli Job Scheduling Console - Guía del usuario.

Opciones locales

En el Agente tolerante a errores limitado para AS/400, las opciones locales definen

los parámetros de funcionamiento de los procesos de Tivoli Workload Scheduler.

Las opciones locales se almacenan en el archivo localopts. Este archivo se instala

automáticamente y contiene los valores predeterminados proporcionados por

Tivoli.

Cómo establecer las opciones locales

Para modificar el archivo de opciones locales localopts, siga los pasos siguientes:

1. Copie el archivo localopts mediante ftp a una estación de trabajo UNIX o

Windows NT. Por ejemplo:

ftp 124.56.34.130

User: root

Password: xxxxx

ftp> namefmt 1

ftp> put /Maestro/localopts

ftp> quit

2. Edite el archivo localopts. Para obtener más información, consulte la

publicación Tivoli Workload Scheduler - Guía del usuario.

6 Agente tolerante a errores limitado para AS/400

Page 19: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

ftp 124.56.34.130

User: root

Password: xxxxx

ftp> namefmt 1

ftp> get localopts /Maestro/localopts

ftp> quit

3. Tras volver a copiar el archivo en el sistema AS/400, utilice el siguiente

comando para definir QMAESTRO como propietario del archivo:

CHGOWN OBJ(’/maestro/localopts’) NEWOWN(QMAESTRO)

Los cambios realizados no son efectivos hasta que se detiene y se reinicia Tivoli

Workload Scheduler.

En la tabla siguiente se describe la sintaxis del archivo localopts. Las entradas no

distinguen entre mayúsculas y minúsculas.

Sintaxis de la opción local Valor predeterminado

# comentario

bm check file = segundos 120

bm check status = segundos 300

bm check until = segundos 300

bm look = segundos 30

bm read = segundos 15

bm stats = on|off off

bm verbose = on|off off

jm job table size = entradas 160

jm look = segundos 300

jm nice = valor 0

jm no root = yes|no no

jm read = segundos 10

merge stdlists = yes|no yes

mm read = segundos 15

mm response = segundos 600

mm retry link = segundos 600

mm sound off = yes|no no

mm unlink = segundos 960

nm ipvalidate = none|full none

nm mortal = yes|no no

nm port = dirección_TCP 31111

nm read = segundos 60

nm retry = segundos 800

stdlist width = columnas 80

syslog local = recurso -1

thiscpu = estación_trabajo thiscpu

wr read = segundos 600

wr unlink = segundos 600

Capítulo 1. Instalación y configuración 7

Page 20: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Sintaxis de la opción local Valor predeterminado

mozart directory = dir_compartido_mozart ninguno

unison network directory = dir_compartido_unison ninguno

parameters directory = dir_compartido_parms ninguno

# comentario

Todo lo que aparece a partir del símbolo de almohadilla hasta el final de la

línea es un comentario.

bm check file

Especifique el número mínimo de segundos que Batchman esperará antes

de volver a comprobar la existencia de un archivo que se utiliza como

dependencia.

bm check status

Especifique el número de segundos que Batchman esperará entre cada

comprobación del estado de una dependencia interred.

bm check until

Especifique el número máximo de segundos que Batchman esperará antes

de notificar que ha transcurrido la hora de finalización para un trabajo o

una corriente de trabajos. Si se define un valor inferior al predeterminado,

es posible que el sistema se cargue innecesariamente. Si se define un valor

inferior al de la opción local bm read, se utilizará el valor de bm read en

su lugar.

bm look

Especifique el número mínimo de segundos que Batchman esperará antes

de explorar y actualizar su archivo de control de producción.

bm read

Especifique el número máximo de segundos que Batchman esperará un

mensaje en su archivo de mensajes.

bm stats

Especifique on para que Batchman envíe sus estadísticas de arranque y

conclusión a su archivo de lista estándar. Especifique off para impedir que

las estadísticas de Batchman se envíen a su archivo de lista estándar.

bm verbose

Especifique on para que Batchman envíe todos los mensajes de estado de

trabajo a su archivo de lista estándar. Especifique off para impedir que el

conjunto ampliado de mensajes de estado de trabajo se envíe al archivo de

lista estándar.

jm job table size

Especifique el tamaño, en número de entradas, de la tabla de trabajos que

utiliza Jobman.

jm look

Especifique el número mínimo de segundos que Jobman esperará antes de

buscar trabajos completados y realizar tareas generales de gestión de

trabajos.

jm nice

Sólo para UNIX. Especifique el valor de prioridad de ejecución que debe

aplicarse a los trabajos iniciados por Jobman.

8 Agente tolerante a errores limitado para AS/400

Page 21: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

jm no root

Sólo para UNIX. Especifique yes para impedir que Jobman inicie trabajos

root. Especifique no para permitir que Jobman inicie trabajos root.

jm read

Especifique el número máximo de segundos que Jobman esperará un

mensaje en su archivo de mensajes.

merge stdlists

Especifique yes para que todos los procesos de control de Tivoli Workload

Scheduler, excepto Netman, envíen sus mensajes de consola a un único

archivo de lista estándar. El archivo recibe el nombre de MAESTRO.

Especifique no para que cada proceso cree su propio archivo de lista

estándar.

mm read

Especifique la frecuencia, en segundos, con la que Mailman comprueba si

hay mensajes en el buzón. Si se omite, el valor predeterminado es 15

segundos. Si define un valor inferior, Tivoli Workload Scheduler se

ejecutará con mayor rapidez a costa de utilizar más tiempo de procesador.

mm response

Especifique el número máximo de segundos que Mailman esperará una

respuesta antes de informar que otra CPU no responde. El tiempo de

respuesta no debe ser inferior a 90 segundos.

mm retry link

Espere el número máximo de segundos que Mailman esperará, después de

desvincularse de una CPU que no responde, antes de intentar volver a

conectarse a la CPU.

mm sound off

Determina cómo responderá Mailman a un comando tellop ? de conman.

Especifique yes para que Mailman muestre información sobre todas las

tareas que está realizando. Especifique no para que Mailman envíe

únicamente su propio estado.

mm unlink

Especifique el número máximo de segundos que Mailman esperará antes

de desvincularse de otra CPU que no responde. El tiempo de espera no

debería ser inferior al tiempo de respuesta especificado para la opción local

nm response.

nm ipvalidate

Especifique full para habilitar la validación de dirección IP; así, si la

validación de IP no es satisfactoria, no se permite la conexión. Especifique

none para permitir conexiones aun cuando la validación de IP no sea

satisfactoria.

nm mortal

Especifique yes para salir de Netman cuando se hayan detenido todos sus

procesos secundarios. Especifique no para que Netman se siga ejecutando

aunque sus procesos secundarios se hayan detenido.

nm port

Especifique el número de puerto TCP al que responde Netman en este

sistema. Debe coincidir con la dirección TCP de la definición de CPU del

sistema.

Capítulo 1. Instalación y configuración 9

Page 22: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

nm read

Especifique el número máximo de segundos que Netman esperará una

petición de conexión antes de comprobar si hay comandos stop/start en su

cola de mensajes.

nm retry

Especifique el número máximo de segundos que Netman esperará antes de

volver a intentar una conexión que ha fallado.

stdlist width

Define la anchura máxima de los mensajes de la consola de Tivoli

Workload Scheduler. Puede entrar un número de columna entre 1 y 255;

las líneas terminarán en esa columna o antes, en función de la presencia de

caracteres de control de carro intercalados. Si entra un número negativo o

cero, se hará caso omiso del ancho de línea.

syslog local

Únicamente para sistemas UNIX. Habilita o inhabilita el registro

cronológico del sistema de Tivoli Workload Scheduler. Especifique -1 para

desactivar el registro cronológico del sistema para Tivoli Workload

Scheduler. Especifique un número entre 0 y 7 para activar el registro

cronológico del sistema y para que TWS utilice el recurso local

correspondiente (LOCAL0 a LOCAL7) para sus mensajes. Especifique

cualquier otro número para activar el registro cronológico del sistema y

para que Tivoli Workload Scheduler utilice el recurso USER para sus

mensajes.

thiscpu

Nombre de esta CPU en Tivoli Workload Scheduler.

wr read

Especifique el número de segundos que Writer esperará un mensaje de

entrada antes de comprobar si hay una petición de terminación procedente

de Netman.

wr unlink

Especifique el número de segundos que Writer esperará antes de concluir

si no se recibe ningún mensaje de entrada. El límite más bajo es 120 y el

valor predeterminado es 600.

mozart directory

No se utiliza.

unison network directory

No se utiliza.

parameters directory

No se utiliza.

Ejemplo de archivo de opciones locales

El archivo modelo siguiente contiene los valores predeterminados de Tivoli:

/maestro/config/localopts

Durante el proceso de instalación, una copia de trabajo del archivo de opciones

locales se instala como:

/maestro/localopts

Puede personalizar la copia de trabajo de acuerdo con sus necesidades. A

continuación se muestra un ejemplo de archivo de opciones locales.

10 Agente tolerante a errores limitado para AS/400

Page 23: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

# Localopts file defines attributes of this CPU.

#-----------------------------------------------------

thiscpu =sys1

merge stdlists =yes

stdlistwidth =80

sysloglocal =-1

#-----------------------------------------------------

# Attributes of this CPU for Batchman process:

bm check file =120

bm check until =300

bm look =30

bm read =15

bm stats =off

bm verbose =off

#-----------------------------------------------------

# Attributes of this CPU for jobman process:

jm job table size =160

jm look =300

jm nice =0

jm no root =no

jm read =10

#-----------------------------------------------------

# Attributes of this CPU for mailman process:

mm response =600

mm retrylink =600

mm sound off =no

mm unlink =960

#-----------------------------------------------------

# Attributes of this CPU for netman process:

nm mortal =no

nm port =31111

nm read =60

nm retry =800

#-----------------------------------------------------

# Attributes of this CPU for writer process:

wr read =600

wr unlink =720

#-----------------------------------------------------

# Optional attributes of this CPU for remote

# database files

# mozart directory = d:\tws\mozart

# parameters directory = d:\tws

# unison network directory = d:\tws\..\unison\network

#

#------------------------------------------------------------

# End of localopts.

Archivo de configuración de Netman

El archivo Netconf define los servicios que proporciona el proceso Netman de

Tivoli Workload Scheduler. Se trata de los servicios siguientes:

2001 Iniciar un proceso de transcripción para gestionar mensajes de entrada.

2002 Iniciar TWS.

2003 Detener TWS.

2004 Buscar y devolver un archivo de lista estándar (stdlist) al Gestor de

consola cliente que lo ha solicitado.

A continuación se muestra un listado del archivo instalado por Tivoli. Póngase en

contacto con el centro de soporte al cliente de Tivoli antes de realizar ningún

cambio en este archivo.

2001 client /qsys.lib/qtws.lib/writer.pgm

Capítulo 1. Instalación y configuración 11

Page 24: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

2002 son /qsys.lib/qtws.lib/mailman.pgm -parm 32000

2003 client /qsys.lib/qtws.lib/qstopsrv.pgm

2004 slinet /qsys.lib/qtws.lib/scribner.pgm

Desinstalación de Tivoli Workload Scheduler

Nota: antes de desinstalar el producto, detenga todos los procesos de Tivoli

Workload Scheduler. Para ello, ejecute el comando ENDTWS y espere a que

se detengan todos los procesos.

Para desinstalar Tivoli Workload Scheduler, entre el comando siguiente:

DLTLICPGM LICPGM(5G97WKB)

12 Agente tolerante a errores limitado para AS/400

Page 25: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Capítulo 2. Utilización

Definición de trabajos de AS/400 en Tivoli Workload Scheduler

El Agente tolerante a errores limitado para AS/400 puede ejecutar los trabajos en el

sistema AS/400 en dos modalidades:

v Modalidad normal, que puede ejecutar cualquier comando en AS/400, excepto

SBMJOB, que debe evitarse. Cuando se ejecutan trabajos en modalidad normal,

todos los trabajos del sistema recibirán MONPROC como nombre de trabajo.

v Modalidad ampliada, que utiliza la palabra clave “submit:” en el comando o el

script. Se puede ejecutar cualquier comando en el sistema AS/400, pero el

trabajo se ejecutará mediante un comando SBMJOB.

La única diferencia entre las dos modalidades consiste en la sintaxis del comando.

Nota: si desea beneficiarse del comando SBMJOB y de sus parámetros, utilice la

modalidad ampliada, que da soporte a la mayoría de los parámetros de SBMJOB.

Evite el uso del comando SBMJOB en la modalidad normal.

Uso de la palabra clave NOSTDLIST

En la práctica habitual, todos los archivos en spool generados por los trabajos se

incluyen en stdlist. En los casos en los que no desea que los archivos en spool se

copien en stdlist, utilice la palabra clave NOSTDLIST. Los dos ejemplos siguientes

muestran cómo utilizar la palabra clave NOSTDLIST:

1. DOCOMMAND "CALL MSTRTEST/TESTONE NOSTDLIST:QPRINT"

En este caso, la salida del programa MSTRTEST/TESTONE producida en el

archivo QPRINT no se incluirá en stdlist.

2. DOCOMMAND "DSPLIBL NOSTDLIST:QPRTLIBL"

En este caso, la salida del comando DSPLIBL de AS/400 producida en el

archivo QPRTLIBL no se incluirá en stdlist.

Estado del trabajo en Tivoli Workload Scheduler

Una vez que Tivoli Workload Scheduler somete a ejecución un trabajo, el estado

del trabajo en Tivoli Workload Scheduler cambiará de READY a WAIT. Un estado

WAIT indica que el trabajo está en la cola del JOBQ correspondiente, pero que no

está actualmente ACTIVO. Incluso aunque el trabajo pase inmediatamente a estar

ACTIVO, el estado del trabajo seguirá siendo WAIT en Tivoli Workload Scheduler

durante un “intervalo de comprobación” completo. El “intervalo de comprobación”

es un parámetro configurado que define el número de segundos que transcurre

entre comprobaciones de estado del trabajo. El valor predeterminado del “intervalo

de comprobación” es 60 segundos. Una vez que un trabajo está ACTIVO, el estado

del trabajo en Tivoli Workload Scheduler pasará de WAIT a EXEC. En este punto,

el Agente esperará un mensaje de terminación normal o anormal del trabajo. Si se

recibe un mensaje de terminación normal del trabajo, el estado del trabajo en Tivoli

Workload Scheduler pasará de EXEC a SUCC. Con un mensaje de terminación

anormal, el estado pasaría de EXEC a ABEND.

© Copyright IBM Corp. 1991, 2004 13

|||

Page 26: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Trabajos de AS/400 controlados por Tivoli Workload

Scheduler: modalidad normal

Se requiere una definición de trabajo para cada trabajo de AS/400 que desee

planificar con Tivoli Workload Scheduler. Una definición de trabajo incluye el

nombre del trabajo, el comando utilizado para ejecutarlo, el nombre del usuario

con el que se ejecuta el trabajo y opciones de recuperación del trabajo. La figura

siguiente muestra una ventana de definición de trabajo para un trabajo

denominado ASJOB2 ejecutado en un agente de AS/400 llamado AS400-2.

Para obtener información sobre el uso del programa de Job Scheduling Console

para crear definiciones de trabajos, consulte la publicación Tivoli Workload Scheduler

- Guía del usuario.

A continuación se describen los campos de la ventana de definición de trabajo:

CPU Especifica el nombre en Tivoli Workload Scheduler del agente de AS/400.

Nombre del trabajo

Especifica el nombre en Tivoli Workload Scheduler del trabajo de AS/400.

El nombre debe empezar con una letra y puede contener caracteres

alfanuméricos, guiones y subrayados. No se permiten los espacios en

blanco. Con bases de datos no ampliadas, el nombre puede contener un

máximo de ocho caracteres. Con bases de datos ampliadas, el nombre

puede contener hasta 16 caracteres.

Este nombre se utiliza para planificar el trabajo en Tivoli Workload

Scheduler.

Inicio de sesión

Especifica el nombre del usuario para el que se ejecuta el trabajo en el

agente de AS/400. Debe ser un usuario válido en el sistema AS/400.

Descripción

Especifica una descripción del trabajo. Puede contener 40 caracteres

alfanuméricos como máximo.

14 Agente tolerante a errores limitado para AS/400

Page 27: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Archivo script

Especifique el comando que se utilizará para ejecutar el trabajo en el

agente de AS/400. Por ejemplo:

CALL AP/APLJOB PARM(45)

Nota: evite el uso del comando SBMJOB en el campo Archivo script y en

un trabajo especificado en el campo Archivo script. El comando

SBMJOB envía trabajos independientemente de que Tivoli Workload

Scheduler no pueda supervisarlos.

Comando

No se utiliza.

Es interactivo

No se utiliza.

Opciones de recuperación

Para obtener información sobre las opciones de recuperación, consulte la

publicación Tivoli Workload Scheduler - Guía del usuario.

Ejemplo de línea de comandos

También es posible definir trabajos mediante la interfaz de línea de comandos de

Job Scheduling Console. El siguiente ejemplo muestra un trabajo de Tivoli

Workload Scheduler denominado ASJOB2 que se ejecuta en la CPU del agente de

AS/400 AS400-2.

as400-2#gljob

streamlogon SALLY

scriptname "CALL GL/JGLJOB PARM(’5’ ’20’)"

description "GL job on AS/400 LFTA"

recovery stop

Trabajos de AS/400 controlados por Tivoli Workload

Scheduler: modalidad ampliada

Con el Agente tolerante a errores limitado para AS/400, Tivoli Workload Scheduler

puede iniciar la ejecución de trabajos en un sistema AS/400. Del mismo modo que

ocurre con cualquier otro trabajo de Tivoli Workload Scheduler, la ejecución no

empezará hasta que se hayan resuelto todas las dependencias especificadas para el

trabajo. A través del agente, el comando SBMJOB del OS/400 envía los trabajos

para su ejecución. Al igual que ocurre al ejecutar el comando SBMJOB desde la

línea de comandos, a no ser que se especifique lo contrario, los trabajos iniciados

por Tivoli Workload Scheduler se ejecutarán con los atributos del perfil de usuario

utilizado para iniciar el programa AS400AGENT.

Los trabajos de AS/400 se documentan en Tivoli Workload Scheduler mediante la

ventana de documentación de trabajos de Tivoli Workload Scheduler estándar. En

el campo de inicio de sesión se puede especificar si hay algún perfil de usuario de

AS/400 válido y activo. Los parámetros para un trabajo de AS/400 se especifican

en el campo de comando o de script de la ventana de documentación del trabajo

con la sintaxis que se muestra a continuación. Los paréntesis y el texto incluido

deben sustituirse por los parámetros de SBMJOB adecuados para el trabajo.

"submit: job(testjob) cmd(dsplib lib(qtws)) user(usera) jobd(qgpl/testjobd)"

En la tabla siguiente se muestran los parámetros asociados con el comando

SBMJOB del OS/400. No todos los parámetros se pueden utilizar en una estación

de trabajo AS/400 con un Agente tolerante a errores limitado. En la tabla se

describe cada parámetro y se indica si se puede utilizar en la estación de trabajo

AS/400.

Capítulo 2. Utilización 15

Page 28: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Parámetro de SBMJOB Soportado Descripción

CMD() S Para obtener más información, consulte

la documentación sobre SBMJOB.

JOB() S Si no se especifica, el nombre del

trabajo de AS/400 equivaldrá a los 10

primeros caracteres del nombre del

trabajo de Tivoli Workload Scheduler.

JOBD() S Para obtener más información, consulte

la documentación sobre SBMJOB.

JOBQ() S Para obtener más información, consulte

la documentación sobre SBMJOB.

JOBPTY() S Para obtener más información, consulte

la documentación sobre SBMJOB.

OUTPTY() S Para obtener más información, consulte

la documentación sobre SBMJOB.

PRTDEV() S Para obtener más información, consulte

la documentación sobre SBMJOB.

OUTQ() S Para obtener más información, consulte

la documentación sobre SBMJOB.

USER() S Para obtener más información, consulte

la documentación sobre SBMJOB.

PRTTXT() S Para obtener más información, consulte

la documentación sobre SBMJOB.

RTGDTA() S Para obtener más información, consulte

la documentación sobre SBMJOB.

RQSDTA() S Para obtener más información, consulte

la documentación sobre SBMJOB.

SYSLIBL() S Para obtener más información, consulte

la documentación sobre SBMJOB.

CURLIB() S Para obtener más información, consulte

la documentación sobre SBMJOB.

INLLIBL() S Para obtener más información, consulte

la documentación sobre SBMJOB.

LOG() S Para obtener más información, consulte

la documentación sobre SBMJOB.

Si no está especificado, el LFTA

establecerá este parámetro en LOG(4 10

*SECLVL) de forma predeterminada.

LOGCLPGM() S Para obtener más información, consulte

la documentación sobre SBMJOB.

INQMSGRPY() S Para obtener más información, consulte

la documentación sobre SBMJOB.

HOLD() N Tivoli Workload Scheduler envía todos

los trabajos retenidos y, luego, los

libera.

SCDDATE() N Tivoli Workload Scheduler realiza la

función de planificación.

SCDTIME() N Tivoli Workload Scheduler realiza la

función de planificación.

16 Agente tolerante a errores limitado para AS/400

||||

|||

Page 29: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Parámetro de SBMJOB Soportado Descripción

DATE() S Para obtener más información, consulte

la documentación sobre SBMJOB.

SWS() S Para obtener más información, consulte

la documentación sobre SBMJOB.

DSPSBMJOB() S Para obtener más información, consulte

la documentación sobre SBMJOB.

MSGQ() N Todos los trabajos de Tivoli Workload

Scheduler envían mensajes de

terminación a la cola de mensajes

QCOMPLETE de la biblioteca QTWS.

SRTSEQ() S Para obtener más información, consulte

la documentación sobre SBMJOB.

LANGID() S Para obtener más información, consulte

la documentación sobre SBMJOB.

CNTRYID() S Para obtener más información, consulte

la documentación sobre SBMJOB.

CCSID() S Para obtener más información, consulte

la documentación sobre SBMJOB.

SBMFOR() S Para obtener más información, consulte

la documentación sobre SBMJOB.

JOBMSGQMX() S Para obtener más información, consulte

la documentación sobre SBMJOB.

JOBMSGQFL() S Para obtener más información, consulte

la documentación sobre SBMJOB.

CPYENVVAR() S Para obtener más información, consulte

la documentación sobre SBMJOB.

Por ejemplo, para enviar un trabajo mediante el comando submit docommand de

conman a una estación de trabajo denominada as400-2, entre:

sbd as400-2#"submit: job(testjob) cmd(dsplib lib(qtws)) user(usera)

jobd(qgpl/testjobd)";alias=job1;logon=userb

Observe que el resultado de este ejemplo sería que, en la máquina AS/400 as400-2,

se utilizaría el perfil de usuario USERB para emitir el comando siguiente:

SBMJOB CMD(DSPLIB LIB(QTWS)) JOB(TESTJOB) USER(USERA) JOBD(QGPL/TESTJOBD)

Asegúrese de que USERB tiene la autorización necesaria para emitir este comando

en el sistema AS/400.

Planificación de trabajos de AS/400

Los trabajos que se ejecutan en agentes de AS/400 se planifican del mismo modo

que otros trabajos de Tivoli Workload Scheduler y pueden incluir restricciones

temporales y dependencias sobre otros trabajos, indicadores de solicitud, archivos

y recursos. Utilice el componente Tivoli Job Scheduling Console para crear una

definición de corriente de trabajos (planificación).

Para obtener información sobre cómo utilizar Job Scheduling Console para crear

planificaciones, consulte la publicación Tivoli Job Scheduling Console - Guía del

usuario.

Capítulo 2. Utilización 17

Page 30: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Ejemplo de línea de comandos

También es posible especificar planificaciones mediante la interfaz de la línea de

comandos de Job Scheduling Console . En el ejemplo siguiente se define la

planificación APSKED, que se ejecuta en la CPU UX-1:

SCHEDULE UX-1#APSKED

ON REQUEST

FOLLOWS UX-1#GL.@

:

AS400-1#APJOB1

AS400-2#APJOB2

FOLLOWS APJOB1

APJOB3

FOLLOWS APJOB2

END

Para obtener información sobre el uso de la interfaz de línea de comandos de Job

Scheduling Console para crear planificaciones, consulte la publicación Tivoli

Workload Scheduler - Guía de consulta.

Control del entorno de trabajo con JOBMANRC

Para definir un entorno genérico para la ejecución de todos los trabajos iniciados

por Tivoli Workload Scheduler o preprocesar sus códigos de retorno, puede crear

un programa denominado JOBMANRC en la biblioteca QTWS. A continuación se

muestra una plantilla que puede utilizar como modelo para crear su programa

JOBMANRC.

/*****************************************************/

/* */

/* JOBMANRC SAMPLE PROGRAM */

/* */

/*****************************************************/

PGM PARM(&JCL_NAME &JCL_LEN)

/* Here we receive the name of the program to launch */

DCL VAR(&JCL_NAME) TYPE(*CHAR) LEN(128)

DCL VAR(&JCL_LEN) TYPE(*CHAR) LEN(3)

DCL VAR(&RC) TYPE(*CHAR) LEN(20) VALUE(’ ’)

DCL VAR(&CL_STATUS) TYPE(*CHAR) LEN(7) VALUE(’ ’)

DCL VAR(&USR_STATUS) TYPE(*CHAR) LEN(4) VALUE(’ ’)

DCL VAR(&MESSAGE) TYPE(*CHAR) LEN(255)

DCL VAR(&COMMAND) TYPE(*CHAR) LEN(255)

DCL VAR(&CMD_LEN) TYPE(*DEC) LEN(3 0)

/*****************************************************/

/* HERE WE CALL TO THE TWSEXEC UTILITY PROGRAM */

/*****************************************************/

CALL PGM(QTWS/TWSEXEC) PARM(&JCL_NAME &JCL_LEN &RC )

CHGVAR VAR(&CL_STATUS) VALUE(%SST(&RC 1 7))

CHGVAR VAR(&CMD_LEN) VALUE(&JCL_LEN)

CHGVAR VAR(&COMMAND) VALUE(%SST(&JCL_NAME 1 &CMD_LEN))

/********************************************/

/* VERIFY FOR A POSSIBLE ERROR IN EXECUTION */

/********************************************/

IF COND(&CL_STATUS *NE ’CPF0000’) THEN(DO)

CHGVAR VAR(&MESSAGE) VALUE(’QTWS/400: JOBMANRC ERROR -> ’ +

*BCAT &CL_STATUS *BCAT ’ executing the program: -> ’ +

*BCAT &COMMAND)

/***********************************************/

/* SEND A WARNING TO THE OPERATOR */

/***********************************************/

SNDMSG MSG(&MESSAGE) TOUSR(*SYSOPR)

/***********************************************/

/* SEND AN ERROR TO ALLOW THIS PROGRAM TO FAIL */

/***********************************************/

SNDPGMMSG MSGID(CPF0006) MSGF(QCPFMSG) MSGTYPE(*ESCAPE)

18 Agente tolerante a errores limitado para AS/400

Page 31: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

ENDDO

CHGVAR VAR(&USR_STATUS) VALUE(%SST(&RC 12 4))

/********************************************/

/* VERIFY FOR A POSSIBLE ERROR IN EXECUTION */

/********************************************/

IF COND(&USR_STATUS *NE ’0000’) THEN(DO)

CHGVAR VAR(&MESSAGE) VALUE(’QTWS/400: JOBMANRC PROGRAM USER ERROR -> ’ +

*BCAT &USR_STATUS *BCAT ’ executing the program: -> ’ +

*BCAT &COMMAND)

/***********************************************/

/* SEND A WARNING TO THE OPERATOR */

/***********************************************/

SNDMSG MSG(&MESSAGE) TOUSR(*SYSOPR)

/***********************************************/

/* SEND AN ERROR TO ALLOW THIS PROGRAM TO FAIL */

/***********************************************/

SNDPGMMSG MSGID(CPF0006) MSGF(QCPFMSG) MSGTYPE(*ESCAPE)

ENDDO

EXITNOERR:

ENDPGM

Si existe un programa JOBMANRC en la biblioteca QTWS, Tivoli Workload

Scheduler lo ejecutará en lugar de ejecutar los trabajos planificados reales. Para

cada trabajo, Tivoli Workload Scheduler pasará el nombre del trabajo planificado al

programa JOBMANRC en la variable &JCL_NAME. El trabajo planificado lo

ejecuta el programa TWSEXEC, suministrado por Tivoli, que se debe ejecutar tal

como se muestra en la plantilla. TWSEXEC devuelve el código de retorno del

trabajo planificado en la variable &RC, que entonces puede verificarse para

determinar la acción que se debe llevar a cabo.

JOBMANRC captura mediante el programa TWSEXEC el código de retorno del

programa del usuario o el mensaje del sistema emitido por éste. Si el código de

retorno es diferente de 0 o el mensaje de sistema es diferente de CPF0000,

JOBMANRC envía un mensaje de escape a Tivoli Workload Scheduler para

establecer el estado de terminación del trabajo planificado en ABEND. Si el código

de retorno es 0 y el mensaje del sistema enviado por el programa del usuario es

CPF0000, el programa JOBMANRC no envía un mensaje de escape a Tivoli

Workload Scheduler, por lo que el estado de terminación del trabajo planificado se

establecerá en SUCC.

Gestión de Tivoli Workload Scheduler en el Agente tolerante a errores

limitado para AS/400

El control de Tivoli Workload Scheduler sobre el Agente tolerante a errores

limitado para AS/400 se limita a iniciar y detener los procesos de Tivoli Workload

Scheduler. Todas las demás operaciones se realizan en el gestor de dominio

maestro de Tivoli Workload Scheduler.

Autorización necesaria

Para ejecutar los comandos de Tivoli Workload Scheduler en el sistema AS/400, es

necesario ser un usuario con autorización *ALLOBJ o tener autorización *USE para

la biblioteca QTWS y autorización *ALL para los objetos de la biblioteca.

Comandos de Tivoli Workload Scheduler

Los comandos que se describen en esta sección permiten controlar localmente los

procesos de Tivoli Workload Scheduler en el sistema AS/400. Para todos los demás

comandos, utilice el Gestor de consolas (conman) en el gestor de dominio maestro.

Capítulo 2. Utilización 19

Page 32: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Para obtener más información sobre el Gestor de consolas, consulte la publicación

Tivoli Job Scheduling Console - Guía del usuario.

STRNETMAN

Ejecute este comando para iniciar sólo el proceso NETMAN.

STARTTWS

Ejecute este comando para iniciar los demás procesos de Tivoli Workload

Scheduler, después de haber iniciado NETMAN con STRNETMAN.

STOPTWS

Ejecute este comando para detener todos los procesos de Tivoli Workload

Scheduler excepto NETMAN.

ENDTWS

Ejecute este comando para detener todos los procesos de Tivoli Workload

Scheduler, incluidos NETMAN, MAILMAN y BATCHMAN.

Inicio automático de Tivoli Workload Scheduler

Puede hacer que Tivoli Workload Scheduler arranque al reiniciar el sistema

AS/400. Para ello, especifique una secuencia de comandos como la siguiente.

CRTJOBD JOBD(QGPL/QTWS) USER(QMAESTRO) RQSDTA(QTWS/STRNETMAN)

ADDAJE SBSD(QSYSWRK) JOB(STRNETMAN) JOBD(QGPL/QTWS)

Nota: los servicios TCP/IP deben estar cargados y en ejecución cuando se inicie

NETMAN.

Gestión de la producción de Tivoli Workload Scheduler en el

Agente tolerante a errores limitado para AS/400

Para gestionar la producción de Tivoli Workload Scheduler en un agente tolerante

a errores limitado para AS/400, utilice el Gestor de consolas en el gestor de

dominio maestro. También hay una interfaz de línea de comandos limitada de

conman en el Agente tolerante a errores limitado para AS/400. Están disponibles la

mayoría de los comandos estándar de conman. Tenga en cuenta las siguientes

limitaciones:

v No se permite ejecutar programas de shell.

v No hay ayuda en línea disponible.

v No hay ningún programa gconman.

v No hay acceso a Remote Console.

v El tamaño de pantalla del sistema AS/400 no resulta adecuado para algunos

comandos de visualización. No obstante, no se pierde información, pues puede

desplazarse por la pantalla para ver todos los datos.

v Si entra una respuesta incorrecta para un indicador de solicitud que espera un sí

o un no, el trabajo se cuelga.

Para obtener más información sobre cómo gestionar la producción con el Gestor de

consolas, consulte la publicación Tivoli Job Scheduling Console - Guía del usuario.

Visualización de trabajos de Tivoli Workload Scheduler en el

Agente tolerante a errores limitado para AS/400

Para visualizar los trabajos de Tivoli Workload Scheduler en el sistema AS/400,

especifique el comando siguiente:

WRKUSRJOB USER(QMAESTRO)

20 Agente tolerante a errores limitado para AS/400

Page 33: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Tenga en cuenta que todos los trabajos de Tivoli Workload Scheduler (NETMAN,

JOBMAN, WRITER, etc.) en AS/400 se ejecutan en el subsistema QSYSWRK y no

se pueden modificar.

Mensajes de consola e indicadores de Tivoli Workload

Scheduler

Los procesos de producción de Tivoli Workload Scheduler escriben mensajes de

estado y mensajes de consola en los archivos de lista estándar (stdlist). Estos

mensajes incluyen los indicadores que se utilizan como dependencias de trabajo y

de planificación. Los archivos de lista estándar se encuentran en el directorio

/maestro/stdlist.

Programas de utilidad de Tivoli Workload Scheduler no

soportados

La biblioteca QTWSTOOLS contiene los siguientes programas de utilidad no

soportados:

CAT.PGM

El programa CAT se puede utilizar para visualizar archivos de lista

estándar (stdlist) de Tivoli Workload Scheduler. Uso:

CALL QTWSTOOLS/CAT PARM(’nombre_archivo’)

donde nombre_archivo es el nombre del archivo stdlist. Por ejemplo, para

visualizar el archivo stdlist de producción de Tivoli Workload Scheduler

correspondiente al día 30 de agosto de 1999, ejecute el programa de la

manera siguiente:

CALL QTWSTOOLS/CAT PARM(’/maestro/stdlist/1999.08.30/QMAESTRO’)

CONMAN

Conman puede utilizarse en las máquinas AS/400. Este programa se

considera no soportado porque su uso presenta algunas limitaciones.

Conman se encuentra en la biblioteca QTWSTOOLS. Para obtener más

información sobre las limitaciones del conman local en el Agente tolerante

a errores limitado para AS/400, consulte la sección “Gestión de Tivoli

Workload Scheduler en el Agente tolerante a errores limitado para AS/400”

en la página 19

JAPJOB1.PGM

El trabajo JAPJOB1 se puede usar para mostrar y probar el funcionamiento

de Tivoli Workload Scheduler. Se ejecuta durante un período específico y

luego devuelve un estado satisfactorio o de finalización anormal. Uso:

CALL QTWSTOOLS/JAPJOB1 PARM(’estado’ ’segundos’)

donde:

estado Especifica el tipo de estado que desea que devuelva el trabajo. Los

valores válidos son:

0 Devolver estado satisfactorio.

<>0 Devolver estado de finalización anormal.

segundos

Especifica el número de segundos de inactividad del trabajo antes

de que finalice.

Por ejemplo, para que devuelva un estado satisfactorio al cabo de 30

segundos, ejecute el trabajo de la manera siguiente:

Capítulo 2. Utilización 21

|||

Page 34: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

CALL QTWSTOOLS/JAPJOB1 PARM(’0’ ’30’)

MORESTDL

El programa MORESTDL se utiliza para visualizar el archivo stdlist

correspondiente a la fecha de producción actual. Uso:

MORESTDL Este comando es equivalente a lo siguiente:

CALL QTWSTOOLS/QDSPF

PARM(’/maestro/stdlist/AAAA.MM.DD/QMAESTRO’)

Por ejemplo, para visualizar el archivo stdlist correspondiente al archivo

de producción actual:

MORESTDL

QDSPF.PGM

El programa QDSPF se puede utilizar para visualizar el archivo de lista

estándar (stdlist) de Tivoli Workload Scheduler mediante el Programa de

Utilidad para Entrada del Fuente (SEU) del AS/400. Puede utilizar este

programa para visualizar cualquier archivo continuo IFS. Uso:

CALL QTWSTOOLS/QDSPF PARM(’nombre_archivo’)

Por ejemplo, para visualizar el archivo stdlist denominado archivo_trabajo:

CALL QTWSTOOLS/QDSPF PARM(’archivo_trabajo’)

TERMINAL.PGM

El programa TERMINAL se puede utilizar para visualizar mensajes

generados por stdout y stderr. Uso:

CALL QTWSTOOLS/TERMINAL

Por ejemplo, para visualizar los mensajes anotados en stdout y stderr de la

sesión del usuario, ejecute el programa de la manera siguiente:

CALL QTWSTOOLS/TERMINAL

TOUCH.PGM

El programa TOUCH se puede utilizar para crear los archivos IFS

necesarios para demostrar dependencias de archivo. Uso:

CALL QTWSTOOLS/TOUCH PARM(’nombre_archivo’)

donde nombre_archivo es el nombre del archivo creado. Por ejemplo, para

crear /tmp/testfile con permisos de lectura/escritura, ejecute el programa

de la manera siguiente:

CALL QTWSTOOLS/TOUCH PARM(’/tmp/testfile’)

22 Agente tolerante a errores limitado para AS/400

Page 35: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Capítulo 3. Resolución de problemas

Este capítulo contiene información sobre resolución de problemas para este

producto.

Limitaciones y soluciones provisionales

Se conocen las limitaciones siguientes:

v Supresión del Agente tolerante a errores limitado para AS/400.

Tenga presente que el comando DLTLICPGM fallará si ha añadido algún objeto

nuevo, con excepción del programa JOBMANRC, a la biblioteca QTWS. Si falla

el comando DLTLICPGM, proceda de la manera siguiente:

1. Suprima el directorio /maestro de la manera siguiente:

WRKLINK OBJ(’maestro’)

Utilice la opción 4.

2. Suprima el directorio /usr/unison de la manera siguiente:

WRKLINK OBJ(’/usr/unison’)

3. Suprima los comandos de TWS del directorio QSYS de la manera siguiente:

DLTCMD QSYS/CUSTOMIZE

DLTCMD QSYS/STRNETMAN

DLTCMD QSYS/STARTTWS

DLTCMD QSYS/STOPTWS

DLTCMD QSYS/ENDTWS

4. Suprima la biblioteca QTWS de la manera siguiente:

DLTLIB QTWS

5. Suprima el usuario QMAESTRO de la manera siguiente:

DLTUSRPRF USRPRF (QMAESTRO) OWNOBJOPT(*DLT)

v El Agente tolerante a errores limitado para AS/400 de IBM Tivoli Workload

Scheduler, Versión 8.2, no da soporte a la base de datos no ampliada. Se puede

personalizar estableciendo el parámetro de versión ampliada (Expanded Version)

en *YES. Utilice el Agente tolerante a errores limitado para AS/400 de IBM

Tivoli Workload Scheduler, Versión 8.2, sólo en una red de Tivoli Workload

Scheduler de base de datos ampliada.

v Tivoli Workload Scheduler normalmente decide establecer el estado de un

trabajo ejecutado en función del código de retorno del programa de usuario

invocado. Si el código de retorno del programa de usuario es igual a 0, el estado

de los trabajos ejecutados se establece en SUCC; de lo contrario, se establecen en

ABEND. Tenga en cuenta que el Agente tolerante a errores limitado para AS/400

de Tivoli Workload Scheduler, Versión 8.2, sólo recibe el código de retorno de

programa de usuario para programas basados en lenguaje C. Para otro tipo de

programas (por ejemplo, programas basados en RPG y COBOL) la gestión puede

mejorarse utilizando la modalidad ampliada, tal como se describe en “Trabajos

de AS/400 controlados por Tivoli Workload Scheduler: modalidad ampliada” en

la página 15.

v El Agente tolerante a errores limitado para AS/400 de Tivoli Workload

Scheduler, Versión 8.2, se distribuye por razones de compatibilidad; no incluye

ninguna función nueva implementada en Tivoli Workload Scheduler Versión 8.2,

las funciones implementadas son las mismas funciones que las del Agente

tolerante a errores limitado para AS/400 de Tivoli Workload Scheduler, Versión

6.1.

© Copyright IBM Corp. 1991, 2004 23

|

|

|

|||

|

|

|

|

|

|

|||||

|

|

|

|

||||||

|||||||||||

||||||

Page 36: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

v Si el Agente tolerante a errores limitado para AS/400 de Tivoli Workload

Scheduler, Versión 8.2, se ha instalado en un AS/400 con un idioma primario

distinto de 2924, podrían surgir algunos problemas durante los procedimientos

de instalación y de ejecución. Utilice el procedimiento siguiente como solución

provisional :

1. Instale sólo la parte del programa (no la parte del idioma) utilizando :

RSTLICPGM LICPGM(5G97WKB) DEV(*SAVF) RSTOBJ(*PGM) LNG(2924)

SAVF( (*1)LIBRARY_NAME/QFTASAVF )

(*1) La biblioteca donde se ha ubicado el archivo save (salvar) del producto.

2. Instale sólo el idioma en una biblioteca diferente (por ejemplo, la biblioteca

QTWS_2924)

RSTLICPGM LICPGM(5G97WKB) DEV(*SAVF) RSTOBJ(*LNG) LNG(2924)

SAVF( (*1)LIBRARY_NAME/QFTASAVF ) LNGLIB(QTWS_2924)

(*1) La biblioteca donde se ha ubicado el archivo save (salvar) del producto.

3. Copie los dos siguientes objetos de QTWS_2924 (o de otra biblioteca de

idiomas que el usuario seleccione) en la biblioteca QTWS:

QFTALANG *PRDLOD

QMAESTRO *MSGF

4. Establezca la autorización para los objetos anteriores en la biblioteca QTWS

de la manera siguiente:

QMAESTRO *ALL

*PUBLIC *EXCLUDE

5. Ejecute CUSTOMIZE

6. Ahora ya puede comprobar la instalación mediante el comando:

DSPSFWRSC

Podrá visualizar:

5G97WKB *BASE 5001 Tivoli Workload Scheduler for OS400 8.2

5G97WKB *BASE 2924 Tivoli Workload Scheduler para OS400 8.2

o utilizando la opción 10 del comando(GOLICPGM), podrá visualizar:

5G97WKB *NOPRIMARY Tivoli Workload Scheduler for OS400 8.2

7. Mediante un editor, por ejemplo Edtf, abra (ruta)/maestro/NetConf y podrá

visualizar su contenido de la manera siguiente:

# Archivo de configuración Netman para el Agente tolerante a errores

# para OS400

#

#@(#) $Id: NetConf.400,v 1.1 1999/08/11 18:27:10 mjuarez Exp $

#

# cada entrada consta de 4 partes:

# petición de servicio, tipo de servicio, programa y opciones

# el tipo de servicio es client (pueden ser varios y obtener circuito TCP)

# son (sólo uno a la vez y no circuito TCP)

#

2001 client /QSYS.LIB/QTWS.LIB/WRITER.PGM

2002 son /QSYS.LIB/QTWS.LIB/MAILMAN.PGM -parm 32000

2003 client /QSYS.LIB/QTWS.lib/QSTOPSRV.PGM

2004 client /QSYS.LIB/QTWS.lib/SCRIBNER.PGM

24 Agente tolerante a errores limitado para AS/400

|||||

|

||

|

||

||

|

||

||

||

||

|

|

|

|

||

|

|

||

|||||||||||

|||||||

Page 37: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Suprima todas las líneas comentadas que empiecen por el carácter ″#″ que se

encuentran al principio del archivo y deje sólo la línea que contiene la

especificación del servicio.

8. Realice todas las operaciones descritas en “Inicio de Netman” en la página 3.

Capítulo 3. Resolución de problemas 25

|||

|

Page 38: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

26 Agente tolerante a errores limitado para AS/400

Page 39: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Avisos

Esta información se ha desarrollado para productos y servicios suministrados en

EE.UU. Es posible que IBM no proporcione los productos, servicios y funciones

que se tratan en este documento en otros países. Consulte al representante local de

IBM para obtener información sobre los productos y servicios actualmente

disponibles en su área. Cualquier referencia a productos, programas o servicios de

IBM no implica que sólo se puedan utilizar dichos productos, programas o

servicios de IBM. Puede utilizarse en su lugar cualquier producto, programa o

servicio funcionalmente equivalente que no infrinja ningún derecho de propiedad

intelectual de IBM. Sin embargo, será responsabilidad del usuario evaluar y

verificar el funcionamiento de cualquier producto, programa o servicio que no sea

de IBM.

IBM puede tener patentes o aplicaciones pendientes de patentes que aborden los

temas descritos en este documento. La posesión de este documento no le otorga

ninguna licencia sobre dichas patentes. Puede enviar consultas sobre licencias, por

escrito, a:

IBM Director of Licensing

IBM Corporation

North Castle Drive

Armonk, NY 10504-1785 EE.UU.

Para consultas de licencias relativas a información de doble byte (DBCS), póngase

en contacto con el Departamento de propiedad intelectual de IBM en su país o

envíe las consultas, por escrito, a:

IBM World Trade Asia Corporation

Licensing

2-31 Roppongi 3-chome, Minato-ku

Tokio 106, Japón

El siguiente párrafo no se aplica en el Reino Unido ni en ningún otro país en el

que dichas declaraciones entren en conflicto con la legislación local:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA

ESTA PUBLICACIÓN ″TAL CUAL″, SIN GARANTÍAS DE NINGÚN TIPO, NI

EXPLÍCITAS NI IMPLÍCITAS, INCLUIDAS, AUNQUE SIN LIMITARSE A ELLAS,

LAS GARANTÍAS DE NO CONTRAVENCIÓN, COMERCIALIZACIÓN O

ADECUACIÓN A UN PROPÓSITO DETERMINADO.

Algunos estados no permiten la renuncia de garantías explícitas o implícitas en

determinadas transacciones, por lo que es posible que este párrafo no se aplique en

su caso.

© Copyright IBM Corp. 1991, 2004 27

Page 40: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Esta información podría incluir imprecisiones técnicas o errores tipográficos.

Periódicamente se realizan cambios en la información aquí contenida; estos

cambios se incorporarán en nuevas ediciones de la publicación. IBM puede realizar

mejoras y/o cambios en el(los) producto(s) y/o en el(los) programa(s) descritos en

esta publicación en cualquier momento y sin previo aviso.

Cualquier referencia de esta información a sitios Web que no sean de IBM se indica

únicamente para su comodidad y en n ingún caso constituyen recomendaciones de

dichos sitios Web. El material de dichos sitios Web no forma parte del material

correspondiente a este producto de IBM y el uso de estos sitios Web se realiza por

cuenta y riesgo del usuario.

IBM puede utilizar o distribuir cualquier información que suministre el usuario del

modo que considere adecuado, sin incurrir por ello en ninguna obligación con el

usuario.

Los propietarios de licencias de este programa que deseen obtener información

sobre el mismo con el fin de permitir: (i) el intercambio de información entre

programas creados de forma independiente y otros programas (incluido este) y (ii)

el uso mutuo de la información que se ha intercambiado, deben ponerse en

contacto con:

IBM Corporation

2Z4A/101

11400 Burnet Road

Austin, TX 78758 EE.UU.

Puede que esta información esté disponible, sujeta a los términos y condiciones

adecuados, y puede incluir en algunos casos, el pago de una tarifa.

IBM suministra el material bajo licencia que se describe en este documento y todo

el material bajo licencia disponible para el mismo, bajo los términos del Acuerdo

de cliente de IBM, el Acuerdo internacional de licencias de programas de IBM o

cualquier acuerdo equivalente entre las partes.

Marcas registradas

Los términos siguientes son marcas comerciales de International Business Machines

Corporation en los Estados Unidos o en otros países: AIX, BookManager, CICS,

DB2, DB2 Universal Database, Hiperbatch, Hiperspace, IBM, el logotipo de IBM,

IMS, MVS, NetView, OS/390, RACF, SAA, Sysplex Timer, VTAM y z/OS. Tivoli y

el logotipo de Tivoli son marcas comerciales o marcas registradas de International

Business Machines Corporation en los Estados Unidos, en otros países o en ambos.

Microsoft y Windows NT son marcas comerciales de Microsoft Corporation en los

Estados Unidos o en otros países.

Es posible que otros nombres de empresa, de producto o de servicio puedan ser

marcas comerciales o marcas de servicio de otras compañías.

28 Agente tolerante a errores limitado para AS/400

Page 41: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

Índice

Aactualizar 3

archivo de configuración de Netman 11

archivo Netconf 11

archivo Script 15

autorización 19

Bbm check file 8

bm check status 8

bm check until 8

bm look 8

bm read 8

bm stats 8

bm verbose 8

Ccaracterísticas 1

comando CUSTOMIZE 2, 23

comando ENDTWS 20

comando STARTTWS 20

comando STOPTWS 20

comando STRNETMAN 20

comandos de TWS 19

comentarios sobre las publicaciones viii

comunicación por correo electrónico viii

conveniostipográficos ix

convenios tipográficos ix

Ddefinición de cpu

ejemplo de línea de comandos 6

definición de CPUComposer 4

definición de planificaciónejemplo de línea de comandos 18

definición de trabajo 14

ejemplo de línea de comandos 15

desinstalar TWS 12

dominio 5

Eenlace automático 5

estado completo 5

Iiniciar NETMAN 3

inicio automático de TWS 20

inicio de sesión 14

Jjm job table size 8

jm look 8

jm read 9

JOBMANRC 18

Mmanuales

comentarios vi

en línea vi

solicitud vi

mensajes de consola de TWS 21

merge stdlists 9

mm read 9

mm response 9

mm retry link 9

mm sound off 9

mm unlink 9

Nnm ipvalidate 9

nm mortal 9

nm port 9

nm read 10

nm retry 10

nodo 4

nombre de CPU 4

nombre del trabajo 14

nombres de directorio, notación ix

nombres de ruta, notación ix

notaciónnombres de ruta ix

tipo de letra ix

variables de entorno ix

Oopciones de recuperación 15

Opciones locales 6

ejemplo 10

Pprocedimiento de instalación 1

programa CAT 21

programa TERMINAL 22

programas de utilidad no soportados 3,

21

publicacionescomentarios vi

en línea vi

solicitud vi

publicaciones en líneaacceso vii

puerto TCP 4

Rrequisitos de software 1

resolver dependencias 5

RSTLICPGM 1, 23

SServicio de soporte al cliente viii

servidor 5

solicitud de publicaciones viii

stdlist width 10

Tthiscpu 10

TOUCH, programa 22

trabajo JAPJOB1 21

Vvariables, notación para ix

variables de entorno, notación ix

visualizar procesos de TWS 20

Wwr read 10

wr unlink 10

© Copyright IBM Corp. 1991, 2004 29

Page 42: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

30 Agente tolerante a errores limitado para AS/400

Page 43: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo
Page 44: Agente tolerante a errores limitado para AS/400publib.boulder.ibm.com/tividd/td/TWS/SC32-1280-01/es_ES/PDF/as400mst.pdf · dependientes en del sistema operativo ix Scheduler Capítulo

���

Número de Programa: 5698-WSH

SC10-9992-01