Upload
phungkhuong
View
232
Download
1
Embed Size (px)
Citation preview
IBM Tivoli Workload Scheduler for Applications
Guía del usuario
Versión 8.2
SC10-3867-00
���
IBM Tivoli Workload Scheduler for Applications
Guía del usuario
Versión 8.2
SC10-3867-00
���
Nota
Antes de utilizar esta información y el producto al que da soporte, lea la información contenida en el apartado “Avisos” en
la página 197.
Primera edición (Junio de 2003)
Este manual es la traducción del original inglés IBM Tivoli Workload Scheduler for Applications User’s Guide Version 8.2,
SC32-1278-00.
Esta edición se aplica a la versión 8, release 2 de IBM Tivoli Workload Scheduler for Applications (número de
programa 5698-WSE) y a todos los releases y modificaciones subsiguientes hasta que se indique lo contrario en
nuevas ediciones.
© Copyright International Business Machines Corporation 2000, 2003. Reservados todos los derechos.
Contenido
Prefacio . . . . . . . . . . . . . . vii
A quién va dirigido este manual . . . . . . . vii
Contenido del manual . . . . . . . . . . . vii
Publicaciones . . . . . . . . . . . . . . x
Publicaciones de IBM Tivoli Workload Scheduler x
Publicaciones de IBM Tivoli Workload Scheduler
for z/OS . . . . . . . . . . . . . . . x
Kit de colección en copia software para IBM
Tivoli Workload Scheduler for z/OS . . . . . xi
Publicaciones relacionadas . . . . . . . . xii
Acceso a las publicaciones en línea . . . . . xii
Pedido de publicaciones . . . . . . . . . xii
Envío de comentarios acerca de las publicaciones xii
Accesibilidad . . . . . . . . . . . . . xiii
Comunicación con el Soporte de software de IBM xiii
Convenios utilizados en este manual . . . . . xiii
Convenios de tipo de letra . . . . . . . . xiii
Variables y rutas dependientes del sistema
operativo . . . . . . . . . . . . . . xiv
Parte 1. Tareas comunes de
instalación y configuración . . . . . 1
Capítulo 1. Visión general del producto 3
Capítulo 2. Instalación de IBM Tivoli
Workload Scheduler for Applications . . 5
Procedimientos de instalación . . . . . . . . . 6
Utilización del asistente para la instalación . . . 7
Utilización de la instalación silenciosa . . . . 17
Utilización de Tivoli Configuration Manager . . 20
Desinstalación del producto . . . . . . . . . 23
Eliminación de una instalación mediante ISMP 24
Eliminación de una instalación mediante Tivoli
Configuration Manager . . . . . . . . . 24
Finalización de la eliminación del método de
acceso para Oracle e-Business Suite . . . . . 25
Capítulo 3. Establecimiento de
opciones con el Editor de opciones . . 27
Creación de un archivo de opciones locales . . . . 30
Herencia de valores de opciones . . . . . . . 30
Capítulo 4. Definición de estaciones de
trabajo de agente ampliado . . . . . . 31
Creación de una estación de trabajo con Job
Scheduling Console . . . . . . . . . . . . 31
Creación de una estación de trabajo desde la línea
de comandos . . . . . . . . . . . . . . 33
Definición de estaciones de trabajo para la
planificación global . . . . . . . . . . . . 34
Creación de la sentencia CPUREC . . . . . . 34
Definición de la estación de trabajo con ISPF . . 35
Capítulo 5. Definición de trabajos de
agente ampliado . . . . . . . . . . 37
Definición de trabajos con Job Scheduling Console 37
Definición de trabajos con la línea de comandos de
Tivoli Workload Scheduler . . . . . . . . . 40
Definición de trabajos para la planificación global 41
Parte 2. Método de acceso de
Oracle e-Business Suite . . . . . . 43
Capítulo 6. Introducción . . . . . . . 45
Funciones . . . . . . . . . . . . . . . 45
Requisitos de software . . . . . . . . . . . 45
Tareas posteriores a la instalación . . . . . . . 45
Software de interfaz . . . . . . . . . . . 47
Capítulo 7. Información de la definición
de trabajos . . . . . . . . . . . . . 49
Definición de trabajos en Oracle Applications . . . 49
Ejecución de un solo trabajo simultáneamente . . 49
Definición de trabajos de Oracle Applications en
Tivoli Workload Scheduler . . . . . . . . . 49
Parámetros de cadena de tarea para trabajos
Oracle Applications . . . . . . . . . . . 49
Estados de los trabajos Tivoli Workload Scheduler y
Oracle Applications . . . . . . . . . . . . 51
Capítulo 8. Referencia al archivo de
opciones MCMAGENT . . . . . . . . 53
Archivo de opciones . . . . . . . . . . . 53
Sintaxis de entrada . . . . . . . . . . . 53
Ejemplo . . . . . . . . . . . . . . 54
Cifrado de contraseñas de usuario de Oracle
Applications . . . . . . . . . . . . . 54
Parte 3. Método de acceso de
PeopleSoft . . . . . . . . . . . . 55
Capítulo 9. Introducción . . . . . . . 57
Funciones . . . . . . . . . . . . . . . 57
Visión general funcional . . . . . . . . . . 57
Trabajos de planificador de procesos de PeopleSoft 58
Seguimiento de trabajos PeopleSoft en Tivoli
Workload Scheduler . . . . . . . . . . 58
Seguridad . . . . . . . . . . . . . . . 58
Notas acerca del soporte de PeopleSoft Versión 8.x 58
Capítulo 10. Planificación de la
implementación . . . . . . . . . . . 61
PeopleSoft Versión 7.5 o anterior . . . . . . . 61
Requisitos del host . . . . . . . . . . . 61
Requisitos de software . . . . . . . . . . 61
© Copyright IBM Corp. 2000, 2003 iii
Configuración del usuario de Windows . . . . 61
Verificación del entorno PeopleSoft . . . . . 62
Creación de un ID de proceso por lotes en
PeopleSoft . . . . . . . . . . . . . . 62
Archivos instalados . . . . . . . . . . . 62
PeopleSoft Versión 8.x . . . . . . . . . . . 62
Requisitos del host . . . . . . . . . . . 62
Requisitos de software . . . . . . . . . . 63
Creación de un ID de proceso por lotes en
PeopleSoft . . . . . . . . . . . . . . 63
Archivos instalados . . . . . . . . . . . 63
Capítulo 11. Tareas posteriores a la
instalación . . . . . . . . . . . . . 65
Configuración del usuario para Windows . . . . 65
Creación del archivo de opciones . . . . . . . 65
Edición manual de archivos de opciones . . . . 68
Conexión a más de una base de datos PeopleSoft 69
Configuración del entorno PeopleSoft para la
versión 7.5 o anterior . . . . . . . . . . . 69
Personalización del servidor de procesos . . . 69
Configuración del cliente . . . . . . . . . 71
Ejecución del script de Data Mover . . . . . 72
Configuración del entorno PeopleSoft para la
versión 8.1x . . . . . . . . . . . . . . 74
Personalización del servidor de aplicaciones . . 74
Configuración del cliente . . . . . . . . . 75
Configuración del entorno PeopleSoft para la
versión 8.4x . . . . . . . . . . . . . . 75
Capítulo 12. Definición de trabajos
PeopleSoft . . . . . . . . . . . . . 77
Creación de definiciones de trabajo Peoplesoft en
Tivoli Workload Scheduler . . . . . . . . . 77
Parámetros de cadena de tarea para trabajos
PeopleSoft . . . . . . . . . . . . . . 77
Configuración de dependencias de apertura de 7.x
solamente . . . . . . . . . . . . . . . 78
Ejemplo de dependencias de apertura . . . . 79
Correlación de estados de trabajos IBM Tivoli
Workload Scheduler y PeopleSoft . . . . . . . 80
Parte 4. Método de acceso de R/3 83
Capítulo 13. Introducción . . . . . . . 85
Funciones . . . . . . . . . . . . . . . 85
Proceso de planificación para el agente ampliado
R/3 . . . . . . . . . . . . . . . . . 85
Soporte de la interfaz XBP 2.0 . . . . . . . . 86
Capítulo 14. Instalación . . . . . . . 87
Requisitos de software . . . . . . . . . . . 87
Visión general de la instalación . . . . . . . 87
Instalación en plataformas de 2 niveles . . . . . 88
Cifrado de contraseñas de usuario R/3 . . . . . 89
Capítulo 15. Configuración de R/3 . . . 91
Visión general . . . . . . . . . . . . . 91
Creación del usuario RFC de IBM Tivoli Workload
Scheduler . . . . . . . . . . . . . . . 91
Creación del perfil de autorización para el usuario
Tivoli Workload Scheduler . . . . . . . . . 91
Utilización de la transacción SU02 y creación
manual del perfil . . . . . . . . . . . 91
Utilización de la transacción PFCG (Generador
de perfiles) . . . . . . . . . . . . . 92
Copia de los archivos de corrección y transporte . . 94
Importación de módulos ABAP/4 a R/3 . . . . . 94
Instalación de los módulos ABAP de r3batch en el
sistema R/3 . . . . . . . . . . . . . . 95
Resolución de problemas . . . . . . . . . . 96
Cambio de la contraseña del ID de usuario RFC de
Tivoli Workload Scheduler . . . . . . . . . 97
Migración desde versiones anteriores . . . . . . 97
Utilización del soporte de XBP 2.0 . . . . . . . 98
Creación del perfil de autorización para el
usuario Tivoli Workload Scheduler . . . . . 98
Problemas de parámetros de impresión y clase de
trabajo . . . . . . . . . . . . . . . . 99
Capítulo 16. Definición de trabajos de
agente ampliado R/3 . . . . . . . . 101
Definición de un trabajo en R/3 . . . . . . . 101
Definición de un trabajo en Tivoli Workload
Scheduler . . . . . . . . . . . . . . . 101
Utilización de las ventanas específicas de SAP
de Job Scheduling Console . . . . . . . . 102
Parámetros de cadena de tarea para trabajos
R/3 . . . . . . . . . . . . . . . 109
Estados de trabajos Tivoli Workload Scheduler y
R/3 . . . . . . . . . . . . . . . . . 111
Capítulo 17. Volver a ejecutar trabajos 113
Copia anterior y copia nueva de un trabajo que se
vuelve a ejecutar . . . . . . . . . . . . 113
Capítulo 18. Business Information
Warehouse . . . . . . . . . . . . 115
Soporte de Business Information Warehouse -
InfoPackages . . . . . . . . . . . . . 115
Autorizaciones de usuario . . . . . . . . 115
Componentes de Business Warehouse . . . . . 115
Definición de trabajos de agente ampliado para
BIW . . . . . . . . . . . . . . . . 115
Opciones de planificación R/3 de InfoPackage . . 116
Capítulo 19. Conexión al sistema R/3 117
Conexiones a un servidor de aplicaciones específico 117
Grupos de inicio de sesión . . . . . . . . . 118
Capítulo 20. Archivos de opciones del
método de acceso de R/3 . . . . . . 119
Opciones de configuración . . . . . . . . . 119
Opciones globales . . . . . . . . . . . 119
Opciones locales . . . . . . . . . . . 120
Opciones generales . . . . . . . . . . 121
Uso de opciones de configuración . . . . . . 124
iv IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Migración de archivos de configuración . . . . 125
Capítulo 21. Espera BDC . . . . . . 127
Utilización de nombres de sesión BDC . . . . . 127
Utilización de ID de cola BDC con el informe
BDCRECXX . . . . . . . . . . . . . . 128
Utilización de los ID de cola BDC con FM
BDC_OPEN_GROUP . . . . . . . . . . . 129
Capítulo 22. Funciones de
interceptación de trabajos y
primario-secundario . . . . . . . . 131
Interceptación de trabajos . . . . . . . . . 131
Implementación de la interceptación de trabajos 131
Función primario-secundario . . . . . . . . 134
Capítulo 23. Soporte del idioma
nacional . . . . . . . . . . . . . 137
Opciones de soporte de idioma nacional . . . . 137
Páginas de códigos R/3 soportadas . . . . . . 138
Configuraciones soportadas y limitaciones . . . . 138
Parte 5. Método de acceso de
z/OS . . . . . . . . . . . . . . . 139
Capítulo 24. Introducción . . . . . . 141
Funciones . . . . . . . . . . . . . . 141
Requisitos de software . . . . . . . . . . 141
Visión general de la instalación . . . . . . . 141
Instalación en plataformas de 2 niveles . . . . 142
Instalación en z/OS . . . . . . . . . . 142
Establecimiento de autorizaciones en z/OS . . 144
Notas adicionales . . . . . . . . . . . 144
Versión de gateway z/OS . . . . . . . . 149
Capítulo 25. Configuración y
utilización . . . . . . . . . . . . . 151
Archivos de opciones de método . . . . . . . 151
Archivos de opciones de método de plataformas
de 2 niveles . . . . . . . . . . . . . 151
Definición de trabajos en z/OS . . . . . . . 152
Definición de trabajos z/OS en Tivoli Workload
Scheduler . . . . . . . . . . . . . . . 153
Sintaxis de definición de tareas para trabajos
z/OS planificados con Tivoli Workload
Scheduler . . . . . . . . . . . . . . 153
Sintaxis de definición de tareas para trabajos
que no son z/OS . . . . . . . . . . . 155
Sintaxis de dependencias de archivo (OPENS)
en archivos z/OS . . . . . . . . . . . 156
Capítulo 26. Información de referencia 159
Visión general técnica . . . . . . . . . . 159
Utilización con JES . . . . . . . . . . 159
Utilización de CA-7 . . . . . . . . . . 160
Otros consejos para CA-7 . . . . . . . . 161
Utilización en OPC o Tivoli Workload Scheduler
for z/OS . . . . . . . . . . . . . . 162
Comprobación de archivos en z/OS . . . . . 163
Consideraciones de temporización . . . . . 163
Información de diagnóstico . . . . . . . . . 164
Mensajes del gateway . . . . . . . . . . 164
Parte 6. Servicios comunes . . . . 169
Capítulo 27. Consulta de agente
ampliado . . . . . . . . . . . . . 171
¿Qué son los agentes ampliados? . . . . . . . 171
Definición de estación de trabajo . . . . . . 171
Interfaz de método de acceso . . . . . . . . 171
Sintaxis de la línea de comandos del método 171
Mensajes de respuesta del método . . . . . 174
Archivo de opciones del método . . . . . . 174
Ejecución del método . . . . . . . . . . . 175
Tarea Iniciar trabajo (LJ) . . . . . . . . . 175
Tarea Gestionar trabajo (MJ) . . . . . . . 176
Tarea Comprobar archivo (CF) . . . . . . . 176
Tarea Obtener estado (GS) . . . . . . . . 177
Comando cpuinfo . . . . . . . . . . . 178
Resolución de problemas . . . . . . . . . 178
Mensajes de error de la lista estándar de trabajo 178
Método no ejecutable . . . . . . . . . . 178
Mensajes de Console Manager . . . . . . . 178
Mensajes de Composer y Compiler . . . . . 179
Mensajes de Jobman . . . . . . . . . . 179
Capítulo 28. Biblioteca de correlación
de códigos de retorno . . . . . . . 181
Archivo de correlación de códigos de retorno . . . 181 181 181 182 182
Correlación de códigos de retorno para Psagent
y MCMAGENT . . . . . . . . . . . 183
Nombres de archivos de correlación de códigos
de retorno . . . . . . . . . . . . . 186
Capítulo 29. Configuración del
programa de utilidad de rastreo . . . 187
Capítulo 30. Resolución de problemas 189
Resolución de problemas de la instalación del
método de acceso de PeopleSoft . . . . . . . 190
Capítulo 31. Archivos instalados . . . 191
Parte 7. Apéndices . . . . . . . . 195
Avisos . . . . . . . . . . . . . . 197
Marcas registradas . . . . . . . . . . . . 199
Glosario . . . . . . . . . . . . . 201
Índice . . . . . . . . . . . . . . . 207
Contenido v
vi IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Prefacio
El manual IBM Tivoli Workload Scheduler for Applications Guía del usuario ofrece
información sobre cómo instalar, configurar y utilizar los métodos de acceso de
IBM Tivoli Workload Scheduler que ejecutan y controlan los trabajos de las
aplicaciones siguientes:
v Oracle e-Business Suite
v PeopleSoft
v R/3
v z/OS
Esta guía incluye y amplía el contenido de los manuales siguientes:
v IBM Tivoli Workload Scheduler for Applications Version 8.1.1 User’s Guide for Oracle
e-Business Suite
v IBM Tivoli Workload Scheduler for Applications Version 8.1.1 User’s Guide for
PeopleSoft
v IBM Tivoli Workload Scheduler for Applications Version 8.1.1 User’s Guide for R/3
v IBM Tivoli Workload Scheduler for Applications Version 8.1.1 User’s Guide for z/OS
A quién va dirigido este manual
Este manual está pensado para los programadores de trabajos que piensen ejecutar
y controlar los trabajos de estas aplicaciones con IBM Tivoli Workload Scheduler.
Los usuarios de esta guía deben conocer alguna información sobre:
v IBM Tivoli Workload Scheduler
v Tivoli Job Scheduling Console
v El entorno de aplicación específico
Contenido del manual
Este manual contiene las secciones siguientes:
Parte 1. Tareas comunes de instalación y configuración
La parte 1 contiene los capítulos siguientes:
v Capítulo 1, “Visión general del producto”, en la página 3
describe el funcionamiento básico de un agente ampliado.
v Capítulo 2, “Instalación de IBM Tivoli Workload Scheduler for Applications”, en
la página 5
describe varias formas de instalar y desinstalar el producto, conjuntamente con
las plataformas soportadas y los requisitos previos.
v Capítulo 3, “Establecimiento de opciones con el Editor de opciones”, en la
página 27
describe cómo utilizar el Editor de opciones.
v Capítulo 4, “Definición de estaciones de trabajo de agente ampliado”, en la
página 31
describe cómo definir las estaciones de trabajo de los agentes ampliados para
todos los métodos de acceso.
© Copyright IBM Corp. 2000, 2003 vii
v Capítulo 5, “Definición de trabajos de agente ampliado”, en la página 37
describe cómo definir los trabajos de agente ampliado para todos los métodos de
acceso.
Parte 2. Método de acceso de Oracle e-Business Suite
La parte 2 contiene los capítulos siguientes:
v Capítulo 6, “Introducción”, en la página 45
describe las funciones, los requisitos de software, las tareas posteriores a la
instalación y el software de interfaz específicamente para el método de acceso de
Oracle e-Business Suite.
v Capítulo 7, “Información de la definición de trabajos”, en la página 49
ofrece información para definir trabajos Tivoli Workload Scheduler
específicamente para este método de acceso.
v Capítulo 8, “Referencia al archivo de opciones MCMAGENT”, en la página 53
describe las opciones utilizadas por este método de acceso.
Parte 3. Método de acceso de PeopleSoft
La parte 3 contiene los capítulos siguientes:
v Capítulo 9, “Introducción”, en la página 57
describe las características, las funciones y otra información general específica
del método de acceso de PeopleSoft.
v Capítulo 10, “Planificación de la implementación”, en la página 61
describe los requisitos del host y del software y otra información importante
para las diferentes versiones de PeopleSoft soportadas por este método de
acceso.
v Capítulo 11, “Tareas posteriores a la instalación”, en la página 65
describe las tareas posteriores a la instalación para este método de acceso.
v Capítulo 12, “Definición de trabajos PeopleSoft”, en la página 77
ofrece información para definir trabajos Tivoli Workload Scheduler
específicamente para este método de acceso.
Parte 4. Método de acceso de R/3
La parte 4 contiene los capítulos siguientes:
v Capítulo 13, “Introducción”, en la página 85
describe las funciones del método de acceso de R/3.
v Capítulo 14, “Instalación”, en la página 87
ofrece información de instalación específica para este método de acceso y
describe cómo realizar una instalación en plataformas de 2 niveles.
v Capítulo 15, “Configuración de R/3”, en la página 91
describe cómo configurar este método de acceso para utilizarlo con R/3.
v Capítulo 16, “Definición de trabajos de agente ampliado R/3”, en la página 101
ofrece información para definir trabajos Tivoli Workload Scheduler
específicamente para el método de acceso de R/3.
v Capítulo 17, “Volver a ejecutar trabajos”, en la página 113
describe el mecanismo para volver a ejecutar trabajos.
v Capítulo 18, “Business Information Warehouse”, en la página 115
viii IBM Tivoli Workload Scheduler for Applications: Guía del usuario
ofrece información sobre cómo utilizar el método de acceso con R/3 Business
Information Warehouse.
v Capítulo 19, “Conexión al sistema R/3”, en la página 117
describe las conexiones R/3 y los grupos de inicio de sesión.
v Capítulo 20, “Archivos de opciones del método de acceso de R/3”, en la página
119
describe las opciones utilizadas por este método de acceso.
v Capítulo 21, “Espera BDC”, en la página 127
ofrece detalles sobre la Espera BDC.
v Capítulo 22, “Funciones de interceptación de trabajos y primario-secundario”, en
la página 131
describe las funciones de interceptación de trabajos y primarias-secundarias de
XBP 2.0.
v Capítulo 23, “Soporte del idioma nacional”, en la página 137
describe el soporte de idioma nacional para este método de acceso.
Parte 5. Método de acceso de z/OS
La parte 5 contiene los capítulos siguientes:
v Capítulo 24, “Introducción”, en la página 141
enumera las funciones del método de acceso de z/OS; describe cómo se puede
instalar la parte distribuida en plataformas de 2 niveles y cómo se instala el
componente de gateway en z/OS.
v Capítulo 25, “Configuración y utilización”, en la página 151
describe las opciones de este método de acceso y proporciona información
específica del método sobre la definición de trabajos.
v Capítulo 26, “Información de referencia”, en la página 159
ofrece información de consulta para utilizar los planificadores de trabajos
soportados y enumera los mensajes de gateway.
Parte 6. Servicios comunes
La parte 6 contiene los capítulos siguientes:
v Capítulo 27, “Consulta de agente ampliado”, en la página 171
ofrece información de consulta para desarrollar un método de acceso de Tivoli
Workload Scheduler.
v Capítulo 28, “Biblioteca de correlación de códigos de retorno”, en la página 181
describe cómo utilizar el programa de utilidad de correlación de códigos de
retorno.
v Capítulo 29, “Configuración del programa de utilidad de rastreo”, en la página
187
describe cómo configurar el programa de utilidad de rastreo.
v Capítulo 30, “Resolución de problemas”, en la página 189
Ofrece alguna información general de resolución de problemas.
v Capítulo 31, “Archivos instalados”, en la página 191
enumera los archivos instalados según la plataforma y característica.
Prefacio ix
Publicaciones
Este apartado indica las publicaciones de la biblioteca de IBM Tivoli Workload
Scheduler. También describe cómo acceder a las publicaciones en línea de Tivoli,
cómo pedir publicaciones de Tivoli y cómo realizar comentarios sobre las
publicaciones de Tivoli.
Publicaciones de IBM Tivoli Workload Scheduler
Este apartado indica las publicaciones de la biblioteca de IBM Tivoli Workload
Scheduler y los documentos relacionados. También describe cómo acceder a las
publicaciones en línea de Tivoli y cómo pedir las publicaciones de Tivoli.
v IBM Tivoli Workload Scheduler - Guía de instalación y planificación, SC10-3833
Describe cómo planificar una red de Tivoli Workload Scheduler y cómo instalar
y personalizar Tivoli Workload Scheduler y su software asociado.
v IBM Tivoli Workload Scheduler - Guía de consulta, SC10-3852
Explica la línea de comandos de Tivoli Workload Scheduler, incluyendo la
comprensión de cómo funcionan los agentes ampliados y de red y la integración
de Tivoli Workload Scheduler en NetView y en Tivoli Business Systems
Manager.
v IBM Tivoli Workload Scheduler Troubleshooting and Error Messages, SC32-1275
Interpreta los mensajes de error de Tivoli Workload Scheduler y ofrece fuentes
de información que le ayudarán a resolver los problemas con Tivoli Workload
Scheduler.
v IBM Tivoli Workload Scheduler Job Scheduling Console Release Notes, SC32-1258
Ofrece información acerca de la utilización de Tivoli Workload Scheduler, sin
tener en cuenta la plataforma, desde una GUI común.
v IBM Tivoli Workload Scheduler Job Scheduling Console - Guía del usuario, SC10-3171
Ofrece información acerca de la utilización de Tivoli Workload Scheduler, sin
tener en cuenta la plataforma, desde una GUI común.
v IBM Tivoli Workload Scheduler for Applications Release Notes, SC32-1279
Ofrece la información más reciente acerca de los agentes ampliados de Tivoli
Workload Scheduler.
v IBM Tivoli Workload Scheduler AS/400 Limited Fault-tolerant Agent User’s Guide,
SC32-1280
Describe la instalación, configuración y utilización de los agentes tolerantes a
errores de Tivoli Workload Scheduler en AS/400.
v IBM Tivoli Workload Scheduler Plus Module - Guía del usuario, SC10-3865
Explica la configuración y utilización del módulo Tivoli Workload Scheduler
Plus.
v IBM Tivoli Workload Scheduler Release Notes, SC32-1277
Explica la información más actual acerca de Tivoli Workload Scheduler.
Publicaciones de IBM Tivoli Workload Scheduler for z/OS
Los siguientes documentos están disponibles en la biblioteca de IBM Tivoli
Workload Scheduler for z/OS:
v IBM Tivoli Workload Scheduler for z/OS Customization and Tuning , SC32-1265
Describe cómo personalizar Tivoli Workload Scheduler for z/OS.
v IBM Tivoli Workload Scheduler for z/OS Diagnosis Guide and Reference, SC32-1261
x IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Ofrece información de ayuda para el diagnóstico y corrección de los posibles
problemas que surjan al utilizar el producto.
v IBM Tivoli Workload Scheduler for z/OS - Información general, SC10-3173
Describe las ventajas de toda la colección de Tivoli Workload Scheduler.
v IBM Tivoli Workload Scheduler for z/OS Getting Started, SC32-1262
Describe los conceptos y terminología de IBM Tivoli Workload Scheduler para
z/OS y ofrece instrucciones para que pueda empezar a trabajar con el producto
lo más rápidamente posible.
v IBM Tivoli Workload Scheduler for z/OS Installation Guide, SC32-1264
Explica cómo instalar Tivoli Workload Scheduler for z/OS.
v IBM Tivoli Workload Scheduler for z/OS Licensed Program Specifications, GI11-4208
Ofrece información de planificación acerca de Tivoli Workload Scheduler for
z/OS.
v IBM Tivoli Workload Scheduler for z/OS 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 IBM Tivoli Workload Scheduler for z/OS Memo to Users, GI11-4209
Ofrece un resumen de los cambios para el release actual del producto.
v IBM Tivoli Workload Scheduler for z/OS Messages and Codes, SC32-1267
Explica los mensajes y los códigos.
v IBM Tivoli Workload Scheduler for z/OS Program Directory, GI11-4203
Se suministra con la cinta de instalación de Tivoli Workload Scheduler for z/OS,
describe todo el material de instalación y ofrece instrucciones para la instalación,
específicas para el nivel de release o número de característica del producto.
v IBM Tivoli Workload Scheduler for z/OS Programming Interfaces, SC32-1266
Ofrece información para escribir programas de aplicación.
v IBM Tivoli Workload Scheduler for z/OS - Consulta rápida, SC10-3753
Ofrece una consulta rápida y fácil para utilizar el producto.
Kit de colección en copia software para IBM Tivoli Workload
Scheduler for z/OS
Todos los manuales de la biblioteca, excepto las publicaciones bajo licencia, están
disponibles en formato de copia software en los siguientes kits de colección:
v IBM Online Library Omnibus Edition OS/390 Collection Kit, SK2T-6700.
v IBM Online Library z/OS Software Products Collection Kit, SK2T-4270.
Puede consultar los manuales en copia software de los CD-ROM utilizando estos
programas bajo licencia de IBM:
v Softcopy Reader
v BookManager READ/2
v BookManager READ/DOS
v BookManager READ/6000
Todos los programas de BookManager necesitan un sistema personal equipado con
una unidad de discos CD-ROM (con capacidad para leer discos formateados en
ISO 9660 estándar) y un adaptador y cable coincidentes. Para obtener información
adicional sobre el hardware y el software, consulte la documentación para el
producto BookManager específico que esté utilizando.
Prefacio xi
Las actualizaciones de los manuales entre releases sólo se facilitan en copia
software.
Publicaciones relacionadas
Tivoli Software Glossary incluye definiciones de muchos términos técnicos
relacionados con el software Tivoli. Tivoli Software Glossary sólo está disponible en
inglés, en el siguiente sitio Web:
http://publib.boulder.ibm.com/tividd/glossary/termsmst04.htm
Acceso a las publicaciones en línea
El CD de documentación contiene las publicaciones que se hallan en la biblioteca
del producto. El formato de las publicaciones es PDF, HTML o ambos. Para
acceder a las publicaciones utilizando un navegador Web, abra el archivo
infocenter.html. El archivo está en el directorio de publicaciones adecuado del CD
del producto.
IBM ofrece las publicaciones para este y otros productos de Tivoli, cuando están
disponibles y siempre que se actualizan, en el sitio Web 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 en el vínculo de Tivoli Workload Scheduler para acceder a la biblioteca
del producto.
Nota: Si no imprime los documentos PDF en papel de tamaño carta, seleccione el
cuadro de selección Ajustar a página de la ventana Imprimir de Adobe
Acrobat. Esta opción está disponible cuando se hace clic en Archivo→
Imprimir. Ajustar a página garantiza que todas las dimensiones de una
página de tamaño carta se impriman en el papel que esté utilizando.
Pedido de publicaciones
Puede pedir muchas publicaciones de Tivoli en línea en el siguiente sitio Web:
http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi
También puede pedirlas 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 ver la lista de números de
teléfono:
http://www.ibm.com/software/tivoli/order-lit/
Envío de comentarios acerca de las publicaciones
Si desea realizar comentarios o sugerencias acerca de los productos y la
documentación de Tivoli, complete los comentarios del cliente del siguiente sitio
Web:
http://www.ibm.com/software/sysmgmt/products/support
xii IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Accesibilidad
Las funciones de accesibilidad ayudan a los usuarios con discapacidades físicas,
por ejemplo con movilidad o visión limitadas, a utilizar los productos de software
satisfactoriamente. Con este producto, puede utilizar las tecnologías asistidas para
escuchar y navegar por la interfaz. También puede utilizar el teclado en lugar del
ratón para usar todas las funciones de la interfaz gráfica de usuario.
Para obtener información adicional, consulte el apéndice sobre accesibilidad en la
publicación IBM Tivoli Workload Scheduler Job Scheduling Console - Guía del usuario.
Comunicación con el Soporte de software de IBM
Si tiene un problema con cualquier producto de Tivoli, puede ponerse en contacto
con el Soporte de software de IBM. Consulte la publicación IBM Software Support
Guide en el siguiente sitio Web:
http://techsupport.services.ibm.com/guides/handbook.html
La guía ofrece información acerca de cómo ponerse en contacto con el Soporte de
software de IBM dependiendo de la gravedad del problema y la información
siguiente:
v Registro y elegibilidad
v Números de teléfono y direcciones de correo electrónico, dependiendo del país
en el que se encuentre
v Información que debe disponer antes de ponerse en contacto con el Soporte de
software de IBM
Convenios utilizados en este manual
Este manual utiliza varios convenios para los términos y acciones especiales,
comandos y rutas dependientes del sistema operativo.
Convenios de tipo de letra
Este manual utiliza los siguientes convenios de tipo de letra:
Negrita
v Comandos en minúsculas o que combinan las mayúsculas y las
minúsculas (excepto los que están todo en mayúsculas) que son
difíciles de distinguir del texto que les rodea
v Controles de interfaz (cuadros de selección, pulsadores,
selectores, selectores cíclicos, campos, carpetas, iconos, cuadros
de listas, elementos de cuadros de lista, listas de múltiples
columnas, opciones de menú, nombres de menú, pestañas, hojas
de propiedades), etiquetas (como por ejemplo Consejo: y
Consideraciones del sistema operativo:)
v Encabezados de columna en una tabla
v Palabras clave y parámetros del texto
Los comandos (excepto los que están todo en mayúsculas) se
visualizan en negrita.
Cursiva
v Citas (títulos de manuales, disquetes y CD)
Prefacio xiii
v Palabras definidas en el texto
v Énfasis de palabras (palabras como palabras)
v Letras como letras
v Términos nuevos en el texto (excepto en una lista de
definiciones)
v Variables y valores que el usuario debe suministrar
Monoespaciado
v Ejemplos, ejemplos de código y salida
v Nombres de archivos, palabras clave de programación y otros
elementos que son difíciles de distinguir del texto que les rodea
v Texto de mensajes y solicitudes dirigidas al usuario
v Texto que el usuario debe escribir
v Valores para argumentos u opciones de comandos
Los ejemplos de código, la salida, el texto que el usuario debe
escribir y los mensajes del sistema se visualizan en monoespaciado.
barras de revisión
Los cambios técnicos del texto se indican por una línea vertical a la
izquierda del cambio.
Variables y rutas dependientes del sistema operativo
Este manual utiliza el convenio de UNIX para especificar las variables de entorno
y para la notación de directorios.
Cuando utilice la línea de comandos de Windows, sustituya $variable por
%variable% en las variables de entorno y sustituya todas las barras inclinadas (/)
por una barra inclinada invertida (\) en las rutas de directorio.
Nota: Si utiliza el shell bash en un sistema Windows, puede utilizar los convenios
de UNIX.
xiv IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Parte 1. Tareas comunes de instalación y configuración
© Copyright IBM Corp. 2000, 2003 1
2 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 1. Visión general del producto
Los agentes ampliados (XA) se utilizan para ampliar las funciones de planificación
de trabajos IBM Tivoli Workload Scheduler a otros sistemas y aplicaciones. Un
agente ampliado se define como una estación de trabajo que tiene un host y un
método de acceso.
El host es un agente tolerante a errores (FTA) o un agente estándar (SA) de Tivoli
Workload Scheduler.
El método de acceso es un programa que la estación de trabajo del host ejecuta
siempre que Tivoli Workload Scheduler, mediante la línea de comandos o Tivoli
Job Scheduling Console, debe interactuar con el sistema externo. Tivoli Workload
Scheduler for Applications incluye los siguientes métodos de acceso:
v Método de acceso de Oracle e-Business Suite (MCMAGENT)
v Método de acceso de PeopleSoft (psagent)
v Método de acceso de R/3 (r3batch)
v Método de acceso de z/OS (mvsca7, mvsjes y mvsopc)
Para iniciar y supervisar un trabajo en un agente ampliado, el host ejecuta el
método de acceso, pasándole detalles del trabajo como opciones de línea de
comandos. El método de acceso se comunica con el sistema externo para iniciar el
trabajo y devuelve el estado del trabajo.
Una estación de trabajo de agente ampliado sólo es una entidad lógica relacionada
con un método de acceso alojado en una estación de trabajo física de Tivoli
Workload Scheduler. Una misma estación de trabajo de Tivoli Workload Scheduler
puede alojar más de una estación de trabajo de agente ampliado y basarse en el
mismo método de acceso. El agente x se define en una definición de estación de
trabajo de Tivoli Workload Scheduler estándar, que da al agente x un nombre e
identifica el método de acceso.
La siguiente figura muestra cómo encajan estos elementos en una configuración de
agente ampliado típica.
© Copyright IBM Corp. 2000, 2003 3
Para iniciar un trabajo en un entorno externo, Tivoli Workload Scheduler ejecuta el
método de acceso del agente ampliado proporcionándole el nombre de estación de
trabajo de agente ampliado e información acerca del trabajo. El método consulta el
archivo correspondiente denominado <NOMBRE_ESTACIÓN_TRABAJO>_
<nombre_método>.opts para determinar a qué instancia de entorno externo se va a
conectar. Entonces, el método de acceso podrá iniciar trabajos en esa instancia y
supervisarlos hasta que finalicen y grabará la evolución del trabajo y la
información de estado en el archivo de lista estándar del trabajo.
Los agentes ampliados también se pueden utilizar para ejecutar trabajos en un
entorno global donde su programación y supervisión se realice desde un
controlador IBM Tivoli Workload Scheduler for z/OS.
Agente de Tivoli Workload Scheduler host
Método de accesoXA CPU 1
XA CPU 2
XA CPU 3
.OPTS FILE 1
.OPTS FILE 2
.OPTS FILE 3
Entorno externo 1
Entorno externo 2
Entorno externo 3
Figura 1. Funcionamiento de los agentes ampliados.
4 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 2. Instalación de IBM Tivoli Workload Scheduler for
Applications
En la mayoría de plataformas soportadas, todos los métodos de acceso de IBM
Tivoli Workload Scheduler for Applications descritos en esta guía se instalan
mediante un proceso de instalación común. Si sigue este proceso, instalará una
instancia de Tivoli Workload Scheduler for Applications (una instancia corresponde
a la adición de un método de acceso, cómo mínimo, a una instalación de Tivoli
Workload Scheduler existente) y seleccionará uno o varios métodos de acceso en
las funciones de instalación.
El proceso de instalación común está disponible para las siguientes plataformas
cuando tienen el soporte de un método de acceso:
v Microsoft Windows NT o 2000
v IBM AIX
v HP-UX
v Sun Operating Environment
v Linux para Intel
v Linux/390
En las plataformas siguientes, el proceso de instalación es el que se describe en la
documentación de los métodos individuales de los siguientes capítulos:
v Compaq Tru64
v SGI Irix
v IBM Sequent Dynix
La tabla siguiente indica las plataformas a las que esta versión de IBM Tivoli
Workload Scheduler for Applications da soporte:
Tabla 1. Plataformas soportadas
Método de acceso
Plataforma z/OS
(Gateway)
z/OS
(Servidor de
transacciones)
R/3 PeopleSoft Oracle eBusiness
Suite
IBM OS/390 V2R10 y
posteriores
X
IBM z/OS V1R1 y
posteriores
X
IBM AIX Versiones
4.3.3, 5.1, 5.2
X X X
IBM Sequent Dynix
Versión 4.5.1
X
Solaris Operating
Environment
Versiones 7, 8, 9
X X X
Hewlett Packard
PA-RISC Versiones
11.0, 11i
X X X
© Copyright IBM Corp. 2000, 2003 5
Tabla 1. Plataformas soportadas (continuación)
Método de acceso
Plataforma z/OS
(Gateway)
z/OS
(Servidor de
transacciones)
R/3 PeopleSoft Oracle eBusiness
Suite
SuSE Linux
Enterprise Server
Versión 7 para
OS/390 y zSeries
(kernel 2.4)
X X
RedHat Linux para
OS/390 y zSeries
Versión 7
X X
RedHat Linux (Intel)
Versiones 7.2, 7.3
X
SuSE Linux (Intel)
Enterprise Server
Versión 8
X
Microsoft Windows
NT Versión 4.0 con
Service Pack 6a
X X X
Microsoft Windows
2000 con Service Pack
3 Professional, Server,
Advanced
X X X
Compaq Tru64
Versión 5.1
X X
SGI Irix Versión 6.5.x X
Procedimientos de instalación
Puede elegir entre tres procedimientos alternativos para instalar Tivoli Workload
Scheduler for Applications:
v La utilización del asistente de InstallShield Multi-Platform (ISMP)
v La ejecución de la opción de instalación silenciosa de InstallShield
v La utilización del componente Software distribution de Tivoli Configuration
Manager
Antes de instalar el producto mediante cualquiera de estos métodos, asegúrese de
que satisface las condiciones siguientes:
v Debe disponer de una instalación válida de IBM Tivoli Workload Scheduler
Versión 7.0 o posterior en el sistema antes de instalar cualquiera de los métodos
de acceso.
v Debe tener derechos de root (Unix) o Administrador (Windows) para ejecutar la
instalación.
v Debe detener todos lo servicios de Tivoli Workload Scheduler antes de iniciar el
proceso de instalación.
v Para el método de acceso de PeopleSoft: La instalación de este método requiere
que previamente se haya instalado el entorno o entornos PeopleSoft
correspondientes y que se puedan acceder por completo desde la estación de
trabajo desde la que realiza la instalación.
6 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
v Para el método de acceso de Oracle eBusiness Suite: Se requiere el servidor
Oracle e-Business Suite en el mismo nodo físico que el método de acceso y el
host Tivoli Workload Scheduler.
v Asegúrese de que el proceso de instalación aún no se esté en ejecución en la
estación de trabajo. Este escenario podría darse en una red en la que usuarios
autorizados a dirigir remotamente la instalación de un método de acceso
abrieran más conexiones telnet en el mismo sistema Unix. Ejecute el siguiente
comando para averiguar si el proceso de instalación ya está activo en el sistema
en el que desea realizar la instalación:
ps -ef | grep setup.bin
Mediante la misma señal, si la estación de trabajo ejecuta más instancias de
Tivoli Workload Scheduler, impida la ejecución del proceso de instalación en
más de una instancia a la vez.
v Antes de instalar instancias adicionales del producto o actualizar las existentes,
asegúrese de que el Editor de opciones no esté en ejecución, ya que la
instalación podría fallar.
Consulte el Capítulo 31, “Archivos instalados”, en la página 191 para ver una lista
de los archivos que debería encontrar en el sistema tras la instalación.
Utilización del asistente para la instalación
Para poder utilizar el asistente para la instalación ISMP en el sistema, el sistema
operativo debe poder ejecutar Java Runtime Environment (JRE) Versión 1.3.1.
Algunas plataformas requieren niveles de mantenimiento para dar soporte a JRE
1.3.1. Consulte la tabla siguiente para saber si el sistema operativo requiere un
parche o no. Para las plataformas soportadas que no se incluyen en esta tabla, no
se requieren parches adicionales.
Tabla 2. Parches necesarios para ejecutar JRE 1.3.1
Sistema operativo Parches necesarios para ejecutar JRE 1.3.1
IBM AIX Versión 4.3.3 Nivel de mantenimiento recomendado AIX 4330–10.
IBM AIX Versión 5.1 Nivel de mantenimiento recomendado AIX 5100–02. Esto
requiere que se aplique y confirme previamente el APAR
IY19375.
Si utiliza uno de los entornos locales no UTF8 CKJ
soportados, necesitará uno de los siguientes sistemas de
archivos (disponibles en el CD base de AIX 5.1):
v X11.fnt.ucs.ttf (para ja_JP o Ja_JP)
v X11.fnt.ucs.ttf_CN (para zh_CN o Zh_CN)
v X11.fnt.ucs.ttf_KR (para ko_KR)
v X11.fnt.ucs.ttf_TW (para zh_TW o Zh_TW)
Para usuarios japoneses: si utiliza el Método de entrada
japonés, es aconsejable aplicar los siguientes PTF para
evitar algunos problemas relacionados con el método de
entrada.
v jkit.Wnn6.base 2.2.0.2 (PTF U479697 o APAR IY22917)
(sólo usuarios de Wnn6)
v X11.motif.lib 5.1.0.15 (PTF U479604 o APAR IY22933)
(sólo usuarios de AIX 5.1)
Solaris Operating
Environment Versiones 7, 8, 9
Clústeres de parches fechados en enero de 2002 o con
posterioridad.
Capítulo 2. Instalación de IBM Tivoli Workload Scheduler for Applications 7
Tabla 2. Parches necesarios para ejecutar JRE 1.3.1 (continuación)
Sistema operativo Parches necesarios para ejecutar JRE 1.3.1
Hewlett Packard PA-RISC
Versiones 11.0, 11i
Los parches de sistema operativo deben instalarse antes
del el producto. Para determinar los parches que deben
instalarse en el sistema, inicie la sesión como root y
ejecute:
/usr/sbin/swlist -l product
Para dar soporte a JRE 1.3.1.05, debe disponer de:
v Para HP-UX 11.0, Quality Pack QPK1100
v Para HP-UX 11i, Quality Pack GOLDQPK11i
Para instalar uno o varios de los métodos de acceso de Tivoli Workload Scheduler
for Applications en el sistema, haga lo siguiente:
1. Detenga todos los servicios de Tivoli Workload Scheduler.
2. En el CD del producto o desde una imagen, ejecute el comando de
instalación. Éste puede ser:
v setup.bin en Unix
v setup.exe en Windows
Se visualizará la ventana Bienvenido.
3. Haga clic en Siguiente (Next) para continuar. Aparecerá la ventana del
acuerdo de licencia de software (Software License Agreement).
Figura 2. Ventana Bienvenido.
8 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
4. Seleccione el botón de selección para aceptar el acuerdo y haga clic en
Siguiente (Next) para continuar. Aparecerá la ventana Seleccionar un tipo de
configuración.
5. Seleccione si va a realizar una nueva instalación de Tivoli Workload
Scheduler for Applications o si va a actualizar una existente. Si va a instalar
un método de acceso adicional, seleccione Actualizar una instancia (Update
an instance).
Figura 3. Ventana Acuerdo de licencia de software.
Figura 4. Ventana Seleccionar un tipo de configuración
Capítulo 2. Instalación de IBM Tivoli Workload Scheduler for Applications 9
v Si elige Crear una nueva instancia (Create a new instance), el programa de
instalación detectará y enumerará todas las instalaciones de Tivoli Workload
Scheduler del sistema.
v Si elige Actualizar una instancia (Update an instance), el programa de
instalación detectará y enumerará todas las instalaciones de Tivoli Workload
Scheduler for Applications del sistema.
Haga clic en Siguiente (Next) para continuar.
Si ha seleccionado Crear una nueva instancia (Create a new instance),
aparecerá una ventana similar a la de la Figura 5.
El programa de instalación buscará en el sistema y enumerará todas las
instancias de Tivoli Workload Scheduler existentes.
Notas:
a. Si el proceso de descubrimiento no encuentra instancias existentes, se
visualizará una ventana en la que podrá especificar la ruta de instalación y
el nombre de una instancia.
b. Si está en Unix y tiene varias instalaciones de Tivoli Workload Scheduler
versiones 7.0 ó 8.1 que no se han instalado correctamente bajo un
directorio inicial /home/usuarioTWS, la ventana indicará aleatoriamente una
sola de estas instancias y la denominará <desconocido>. Ésta será la única
instancia que podrá marcar para la instalación. Consulte la Tabla 24 en la
página 189 para ver los detalles.
Si ha seleccionado Actualizar una instancia (Update an instance), se
visualizará una ventana similar a la de la Figura 6 en la página 11.
Figura 5. Ventana Instancias instaladas de Tivoli Workload Scheduler.
10 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
El programa de instalación buscará en el sistema y enumerará todas las
instancias existentes de Tivoli Workload Scheduler for Applications.
6. Seleccione una o varias instancias y haga clic en Siguiente (Next) para
continuar. Se visualizará una ventana que indicará todos los métodos de
acceso que se pueden utilizar en Tivoli Workload Scheduler for Applications.
La lista varía según la plataforma en la que está realizando la instalación: las
instalaciones en Unix no listan el método de acceso para PeopleSoft, mientras
que las de Windows no listan el método de acceso para Oracle.
Este es un ejemplo para una instalación en Windows.
Figura 6. Ventana Instancias instaladas de Tivoli Workload Scheduler for Applications.
Figura 7. Ventana Seleccionar las funciones de Tivoli Workload Scheduler for Applications en MS Windows.
Capítulo 2. Instalación de IBM Tivoli Workload Scheduler for Applications 11
Este es un ejemplo para una instalación en Unix.
7. Seleccione el método o métodos de acceso que desee instalar en el sistema y
haga clic en Siguiente (Next) para continuar. Dependiendo de cuántos y de
qué métodos de acceso haya seleccionado, una o varias ventanas adicionales
solicitarán información específica para el método de acceso. Ésta puede ser:
v Para todos los métodos de acceso: el nombre del usuario de Tivoli
Workload Scheduler que ejecutará el método seleccionado. Puede ser el
mismo nombre que se ha definido al instalar Tivoli Workload Scheduler.
v Para el método de acceso de PeopleSoft: la versión del entorno PeopleTools
y uno de los elementos siguientes:
– Para PeopleSoft Versiones 7.0x ó 7.5x, la ruta para el directorio de
ejecución COBOL (normalmente <INICIO_PS>\cblbin).
– Para PeopleSoft Versión 8.1x, la ruta para las API externas de PeopleSoft
(normalmente <DIR_API_EXT>\bin\client\winx86_extapi).
– Para PeopleSoft Versión 8.4x, la ruta para el directorio cliente de
PeopleSoft (normalmente <INICI_PS>\bin\client\winx86).
Esta es la ventana para el método de acceso de R/3.
Figura 8. Ventana Seleccionar las funciones de Tivoli Workload Scheduler for Applications en Unix.
12 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Esta es la primera ventana para el Método de acceso de PeopleSoft.
Esta es la segunda ventana del Método de acceso de PeopleSoft.
Figura 9. Ventana Información adicional del usuario para el Método de acceso de R/3.
Figura 10. Primera ventana Información adicional del usuario para el Método de acceso de PeopleSoft.
Capítulo 2. Instalación de IBM Tivoli Workload Scheduler for Applications 13
Esta es la ventana para el Método de acceso de z/OS.
8. Especifique la información necesaria y haga clic en Siguiente (Next) para
continuar. Se visualizará una ventana de información de resumen. La
Figura 13 en la página 15 muestra un ejemplo de la información de resumen
para la instalación del método de acceso para R/3.
Figura 11. Segunda ventana Información adicional del usuario para el Método de acceso de PeopleSoft.
Figura 12. Ventana Información adicional del usuario para el Método de acceso de z/OS.
14 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
9. Haga clic en Siguiente (Next) para continuar. El proceso de instalación
empieza a instalar los métodos de acceso seleccionados en el sistema. Se
visualizará una ventana que mostrará la evolución de la instalación.
Cuando finalice la instalación, se visualizará la siguiente ventana solicitándole
si desea ejecutar el Editor de opciones. Se trata de un editor de archivos
basado en Java que le permite definir las opciones para los métodos de acceso
que ha instalado. Si opta por no ejecutar ahora el Editor de opciones, podrá
hacerlo más tarde.
Figura 13. Ventana Resumen de instalación.
Figura 14. Ventana Evolución de la instalación.
Capítulo 2. Instalación de IBM Tivoli Workload Scheduler for Applications 15
10. Haga clic en el botón de selección adecuado si desea ejecutar inmediatamente
el Editor de opciones o no y seleccione Siguiente (Next) para continuar.
Si hace clic en Sí (Yes), se visualizará el Editor de opciones y podrá establecer
las opciones para los métodos que ha instalado. Consulte el apartado
Capítulo 3, “Establecimiento de opciones con el Editor de opciones”, en la
página 27 para obtener información sobre cómo utilizar el Editor de opciones.
Cuando haya terminado de utilizar el Editor de opciones o si ha seleccionado
No en la ventana anterior, se visualizará la ventana de salida de la instalación.
11. Seleccione Finalizar (Finish) para salir del asistente para la instalación.
Figura 15. Ventana Inicio del Editor de opciones
Figura 16. Ventana Salida del asistente para la instalación.
16 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
El registro de la instalación denominado TWS4APPS.LOG se guardará en el
directorio maestro.
Utilización de la instalación silenciosa
Este método ofrece la opción de instalar el producto sin utilizar el asistente para la
instalación ISMP. Para realizar la instalación con este método, prepare de antemano
un archivo de opciones y especifique su nombre con el comando de instalación.
El uso del método de instalación silenciosa le permite instalar todos los métodos
de acceso simultáneamente.
El registro de la instalación denominado TWS4APPS.LOG se guardará en el directorio
maestro.
Formato: Para instalar Tivoli Workload Scheduler for Applications con el método
silencioso, utilice el comando siguiente:
v En Windows
setup.exe -silent -options ruta_y_nombre_archivo_opciones
v En Unix
setup.bin -silent -options ruta_y_nombre_archivo_opciones
Parámetros:
-silent Especifica que la instalación no la dirige una interfaz de usuario sino un
archivo de opciones.
-options ruta_y_nombre_archivo_opciones
Facilita la ruta y el nombre del archivo que contiene las opciones de
instalación. El archivo de opciones puede ser cualquier archivo de texto
con el nombre y extensión que elija el usuario. Las opciones se escriben
individualmente por línea.
Con el producto, se proporciona una plantilla para ejecutar una instalación
silenciosa. La plantilla se denomina silent.txt y está disponible en el
directorio RESPONSE_FILE del CD-Rom del producto.
La tabla siguiente indica las opciones que puede utilizar para dirigir la
instalación:
Tabla 3. Opciones necesarias para la instalación silenciosa.
Opción Descripción Valor
-P TWS4APPS.installLocation La ruta en la que desea instalar
Tivoli Workload Scheduler for
Applications. Esta opción es
obligatoria.
Una ruta absoluta.
-P TWS4APPS.name Un nombre para esta instancia
de Tivoli Workload Scheduler
for Applications. Esta opción es
obligatoria.
Un nombre. Enciérrelo entre
comillas dobles si contiene
un espacio en blanco.
-P MCMAGENT_FEATURE.active Especifica que debe instalarse
el método de acceso para
Oracle eBusiness Suite.
True o False.
Capítulo 2. Instalación de IBM Tivoli Workload Scheduler for Applications 17
Tabla 3. Opciones necesarias para la instalación silenciosa. (continuación)
Opción Descripción Valor
-W LJUSER_MCMAGENT_INPUT_BEAN.LJUSER El nombre del usuario de Tivoli
Workload Scheduler que va a
ejecutar el método de acceso
para Oracle eBusiness Suite.
Esta opción es obligatoria si
está instalando este método.
Un nombre de usuario de
Tivoli Workload Scheduler.
Enciérrelo entre comillas
dobles si contiene un
espacio en blanco.
-P R3BATCH_FEATURE.active Especifica que debe instalarse
el método de acceso para R/3.
True o False.
-W LJUSER_R3BATCH_INPUT_BEAN.LJUSER El nombre del usuario de Tivoli
Workload Scheduler que va a
ejecutar el método de acceso
para R/3. Esta opción es
obligatoria si está instalando
este método.
Un nombre de usuario de
Tivoli Workload Scheduler.
Enciérrelo entre comillas
dobles si contiene un
espacio en blanco.
-P ZOSAGENT_FEATURE.active Especifica que debe instalarse
el método de acceso para
z/OS.
True o False.
-W LJUSER_ZOSAGENT_INPUT_BEAN.LJUSER El nombre del usuario de Tivoli
Workload Scheduler que va a
ejecutar el método de acceso
para z/OS. Esta opción es
obligatoria si está instalando
este método.
Un nombre de usuario de
Tivoli Workload Scheduler.
Enciérrelo entre comillas
dobles si contiene un
espacio en blanco.
-P PSAGENT_FEATURE.active Especifica que debe instalarse
el método de acceso para
PeopleSoft.
True o False.
-W LJUSER_PSAGENT_INPUT_BEAN.LJUSER El nombre del usuario de Tivoli
Workload Scheduler que va a
ejecutar el método de acceso
para PeopleSoft. Esta opción es
obligatoria si está instalando
este método.
Un nombre de usuario de
Tivoli Workload Scheduler.
Enciérrelo entre comillas
dobles si contiene un
espacio en blanco.
18 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Tabla 3. Opciones necesarias para la instalación silenciosa. (continuación)
Opción Descripción Valor
-W LJUSER_PSAGENT_INPUT_BEAN.BEND_TYPE Especifica la versión del
entorno PeopleTools. Esta
opción es obligatoria si está
instalando este método.
Puede ser uno o varios de
los siguientes:
PS70MR2
PeopleTools 7.0x y
Merant NetExpress
2.x
PS70MR3
PeopleTools 7.0x y
Merant NetExpress
3.x
PS70WB4
PeopleTools 7.0x y
MF COBOL
Workbench 4.x
PS75MR2
PeopleTools 7.5x y
Merant NetExpress
2.x
PS75MR3
PeopleTools 7.5x y
Merant NetExpress
3.x
PS81 PeopleTools 8.1x
PS84 PeopleTools 8.4x
Múltiples entradas deben ir
separadas por punto y
coma.
-W PS70MR2_CBLDIR.DIRNAME La ruta del directorio COBOL
para PeopleTools 7.0x y Merant
NetExpress 2.x. Se utiliza si ha
especificado este entorno.
La ruta completa para este
directorio, normalmente
<INICIO_PS>\cblbin.
-W PS70MR3_CBLDIR.DIRNAME La ruta del directorio COBOL
para PeopleTools 7.0x y Merant
NetExpress 3.x. Se utiliza si se
especifica este entorno.
La ruta completa para este
directorio, normalmente
<INICIO_PS>\cblbin.
-W PS70WB4_CBLDIR.DIRNAME La ruta del directorio COBOL
para PeopleTools 7.0x y MF
COBOL Workbench 4.x. Se
utiliza si se especifica este
entorno.
La ruta completa para este
directorio, normalmente
<INICIO_PS>\cblbin.
-W PS75MR2_CBLDIR.DIRNAME La ruta del directorio COBOL
para PeopleTools 7.5x y Merant
NetExpress 2.x. Se utiliza si ha
especificado este entorno.
La ruta completa para este
directorio, normalmente
<INICIO_PS>\cblbin.
-W PS75MR3_CBLDIR.DIRNAME La ruta del directorio COBOL
para PeopleTools 7.5x y Merant
NetExpress 3.x. Se utiliza si ha
especificado este entorno.
La ruta completa para este
directorio, normalmente
<INICIO_PS>\cblbin.
Capítulo 2. Instalación de IBM Tivoli Workload Scheduler for Applications 19
Tabla 3. Opciones necesarias para la instalación silenciosa. (continuación)
Opción Descripción Valor
-W PS81_APIDIR.DIRNAME La ruta del directorio de API
externas para PeopleTools 8.1x.
Se utiliza si se especifica este
entorno.
La ruta completa para este
directorio, normalmente
<DIR_API_EXT>\bin\client\
winx86_extapi.
-W PS84_APIDIR.DIRNAME La ruta del directorio cliente de
PeopleSoft para PeopleTools
8.4x. Se utiliza si se especifica
este entorno.
La ruta completa para este
directorio, normalmente
<INICIO_PS>\bin\client\
winx86.
Ejemplos: El ejemplo siguiente utiliza un archivo de opciones denominado
silent_options.txt para instalar silenciosamente Tivoli Workload Scheduler for
Applications en un sistema Windows:
setup.exe –silent –options c:\tmp\silent_options.txt
El siguiente ejemplo utiliza un archivo de opciones denominado
silent_options.txt para instalar Tivoli Workload Scheduler for Applications
silenciosamente en un sistema Unix sin ningún X-Server disponible:
setup.bin –silent –options /tmp/silent_options.txt
El ejemplo siguiente es un archivo de opciones utilizado para dirigir la instalación
de Tivoli Workload Scheduler for Applications en un sistema Windows. Los
métodos de acceso para R/3 y PeopleSoft se definen como funciones de
instalación.
# UBICACIÓN DE LA INSTALACIÓN y NOMBRE DE INSTANCIA
-P TWS4APPS.installLocation=C:\win32app\maestro
-P TWS4APPS.name=SILENT
# VALORES DE R3BATCH
-P R3BATCH_FEATURE.active=true
-W LJUSER_R3BATCH_INPUT_BEAN.LJUSER=twsusuario
# VALORES DE PSAGENT
-P PSAGENT_FEATURE.active=true
-W LJUSER_PSAGENT_INPUT_BEAN.LJUSER=tws
-W LJUSER_PSAGENT_INPUT_BEAN.BEND_TYPE=PS70MR2;PS75MR3
-W PS70MR2_CBLDIR.DIRNAME=M:\PSDIRS\PS70Merant2
-W PS75MR3_CBLDIR.DIRNAME=N:\PSDIRS\PS75Merant3
Utilización de Tivoli Configuration Manager
Todos los métodos de acceso pueden instalarse mediante la distribución de un
bloque de paquetes de software (SPB) utilizando el Escritorio de Tivoli o el
comando winstsp del componente Software Distribution de IBM Tivoli
Configuration Manager, Versión 4.2. La distribución e instalación de Bloques de
paquetes de software puede realizarse a través de sistemas que ejecuten Tivoli
Management Framework.
El despliegue de Tivoli Workload Scheduler for Applications mediante este formato
de empaquetado ofrece las siguientes ventajas:
v No sólo despliega los archivos y directorios, sino también los elementos de
entorno como, por ejemplo, INI, registro, iconos, etcétera.
v UNDO en contraposición a REMOVE de cada uno de los elementos
incorporados anteriores en el paquete de software.
v Se utilizan variables (incorporadas, específicas del destino o predefinidas) en el
paquete.
20 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
v Se utilizan condiciones en el paquete de software mediante secciones específicas
para plataformas específicas.
v Se puede realizar un uso ilimitado de programas de usuario genéricos, para
diferentes fases de la ejecución y gestión personalizada de los códigos de retorno
de programas.
v El rearranque o reinicio en punto de comprobación durante la ejecución de
acciones SP
Con este método sólo puede instalar un método de acceso por bloque de paquete
de software. Si utiliza múltiples SPB para instalar más métodos de acceso, tenga
presente que debe utilizar diferentes nombres para los paquetes.
Si elige dirigir el proceso de instalación desde el Escritorio de Tivoli y el motor de
Tivoli Workload Scheduler de la estación de trabajo de destino es de la Versión 8.2,
asegúrese de que conoce el nombre del directorio de instalación del motor antes de
empezar.
Todos los SPB de Tivoli Workload Scheduler for Applications necesitan las
opciones siguientes para que la distribución del software los instale:
Tabla 4. Opciones necesarias para que Software Distribución instale todos los SPB de
Tivoli Workload Scheduler for Applications.
Opción Descripción
INSTALL_DIR La ruta del directorio maestro (que contiene los métodos)
LJUSER El nombre del usuario de Tivoli Workload Scheduler que va a
ejecutar el método de acceso.
Además, el SPB para el método de acceso de PeopleSoft requiere las opciones
siguientes:
Tabla 5. Opciones adicionales necesarias para instalar el método de acceso para
PeopleSoft SPB mediante Software Distribution.
Opción Descripción
INSTALL_BEND Especifica la versión del entorno PeopleTools. Puede ser uno o
varios de los siguientes:
PS70MR2
PeopleTools 7.0x y Merant NetExpress 2.x
PS70MR3
PeopleTools 7.0x y Merant NetExpress 3.x
PS70WB4
PeopleTools 7.0x y MF COBOL Workbench 4.x
PS75MR2
PeopleTools 7.5x y Merant NetExpress 2.x
PS75MR3
PeopleTools 7.5x y Merant NetExpress 3.x
PS81 PeopleTools 8.1x
PS84 PeopleTools 8.4x
Si las entradas son múltiples, deben ir separadas por punto y
coma.
Capítulo 2. Instalación de IBM Tivoli Workload Scheduler for Applications 21
Tabla 5. Opciones adicionales necesarias para instalar el método de acceso para
PeopleSoft SPB mediante Software Distribution. (continuación)
Opción Descripción
PS70MR2_CBLDIR La ruta del directorio COBOL para PeopleTools 7.0x y Merant
NetExpress 2.x. Se utiliza si ha especificado este entorno.
PS70MR3_CBLDIR La ruta del directorio COBOL para PeopleTools 7.0x y Merant
NetExpress 3.x. Se utiliza si se ha especificado este entorno.
PS70WB4_CBLDIR La ruta del directorio COBOL para PeopleTools 7.0x y MF
COBOL Workbench 4.x. Se utiliza si se ha especificado este
entorno.
PS75MR2_CBLDIR La ruta del directorio COBOL para PeopleTools 7.5x y Merant
NetExpress 2.x. Se utiliza si se ha especificado este entorno.
PS75MR3_CBLDIR La ruta del directorio COBOL para PeopleTools 7.5x y Merant
NetExpress 3.x. Se utiliza si se ha especificado este entorno.
PS81_APIDIR La ruta del directorio de las API externas para PeopleTools 8.1x.
Se utiliza si se ha especificado este entorno.
PS84_APIDIR La ruta del directorio cliente de PeopleSoft para PeopleTools
8.4x. Se utiliza si se ha especificado este entorno.
El producto también incluye un SPB que contiene Java Virtual Machine. Esto es útil
para instalar el Editor de opciones con este método. Sin embargo, tenga en cuenta
que este elemento Java Virtual Machine no puede sustituir al elemento Java Virtual
Machine requerido para ejecutar el producto PeopleSoft.
Para instalar un paquete de software, debe realizar las acciones siguientes,
utilizando la línea de comandos o el Escritorio de Tivoli:
1. Importe el SPB a un Perfil de paquete de software. Haga esto para los SPB de:
v Los métodos de acceso que desee instalar
v Java Virtual Machine (JVM)
v El Editor de opciones (para ejecutarse, requiere que ya estén instalados los
otros dos SPB)2. Instale el Perfil de paquetes de software en los puntos finales gestionados por
Tivoli Framework.
El ejemplo siguiente muestra cómo instalar el SPB del método de acceso de R/3 en
una estación de trabajo Windows.
1. Importe el archivo SBP TWS4APPS_R3BATCH_I386NT.SPB a un Perfil de paquete de
software de Tivoli Framework denominado, por ejemplo,
TWS4APPS_R3BATCH_I386NT.8.2. Utilice el comando siguiente:
wimpspo -c PROFILE_MANAGER -f <RUTA_FUENTE>/TWS4APPS_R3BATCH_I386NT.SPB -t build
-p <LOCAL_RUTA_DEST>/TWS4APPS_R3BATCH_I386NT.SPB TWS4APPS_R3BATCH_I386NT.8.2
Con este comando, el archivo RUTA_FUENTE/TWS4APPS_R3BATCH_I386NT.SPB se
importa a un Perfil de paquete de software denominado
TWS4APPS_R3BATCH_I386NT.8.2 que pertenece a un gestor de perfiles de Tivoli
Framework PROFILE_MANAGER.
TWS4APPS_R3BATCH_I386NT.8.2 debe hacer referencia a
<LOCAL_RUTA_DEST>/TWS4APPS_R3BATCH_I386NT.SPB como el archivo local que
contiene la información necesaria.
Nota: Para instalar una instancia adicional de este SPB en la misma estación de
trabajo, debe redenominar el SPB.
22 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
2. Instale el Perfil del paquete de software TWS4APPS_R3BATCH_I386NT.8.2 en un
sistema con el nombre de host epw2000 (que también debe estar definido como
punto final de Tivoli Framework). Utilice el comando siguiente:
winstsp -D INSTALL_DIR=inicioTWS -D LJUser=usuarioTWS
TWS4APPS_R3BATCH_I386NT.8.2 epw2000
Cuando el registro de instalación, en este caso el archivo denominado
$BINDIR/../swdis/work/TWS4APPS_R3BATCH_I386NT.log, muestre el mensaje
Operación satisfactoria, el proceso de instalación debe considerarse completado.
El ejemplo siguiente muestra cómo instalar el SPB de JVM para AIX en un sistema
AIX. Tenga en cuenta que existe un paquete de software JVM diferente para cada
plataforma.
1. Importe el paquete de software denominado JRE131_AIX.SPB a un Perfil de
paquete de software denominado JRE131AIX.8.2. Utilice el comando siguiente:
wimpspo -c PROFILE_MANAGER -f <RUTA_FUENTE>/JRE131_AIX.SPB -t build
-p <LOCAL_RUTA_DEST>/JRE131_AIX.SPB
JRE131AIX.8.2
2. Instale el Perfil de paquete de software JRE131AIX.8.2 en un sistema con el
nombre de host epAIX. Utilice el comando siguiente:
winstsp -D INSTALL_DIR=inicioTWS -D LJUser=usuarioTWS JRE131AIX.8.2 epAIX
El ejemplo siguiente muestra cómo instalar el SPB del Editor de opciones en el
mismo sistema AIX. Tenga en cuenta que el SPB del Editor de opciones es el
mismo para todas las plataformas.
1. Importe el paquete de software denominado OPTED.SPB a un Perfil de paquete
de software denominado OPTED.8.2. Utilice el comando siguiente:
wimpspo -c PROFILE_MANAGER -f <RUTA_FUENTE>/OPTED.SPB -t build
-p <LOCAL_RUTA_DEST>/OPTED.SPB
OPTED.8.2
2. Instale el Perfil de paquete de software OPTED.8.2 en un sistema con el nombre
de host epAIX. Utilice el comando siguiente:
winstsp -D INSTALL_DIR=inicioTWS -D LJUser=usuarioTWS OPTED.8.2 epAIX
Desinstalación del producto
Para desinstalar Tivoli Workload Scheduler for Applications de una estación de
trabajo debe seguir el mismo procedimiento que ha utilizado en el momento de la
instalación:
v Si ha utilizado ISMP para realizar la instalación, el método de desinstalación
debe ser compatible con ISMP.
v Si ha realizado la instalación mediante la distribución de software, utilice el
mismo método para la desinstalación.
Si piensa desinstalar el método de acceso para Oracle eBusiness suite, tenga en
cuenta que deberá completar manualmente la eliminación del producto. Consulte
el apartado “Finalización de la eliminación del método de acceso para Oracle
e-Business Suite” en la página 25.
Al desinstalar completamente el producto bajo ciertas condiciones, puede quedar el
directorio denominado _xauninst tras el proceso de desinstalación. En este caso,
elimínelo manualmente.
Capítulo 2. Instalación de IBM Tivoli Workload Scheduler for Applications 23
Eliminación de una instalación mediante ISMP
Para desinstalar el producto siguiendo una instalación ISMP:
v En Windows:
1. Seleccione Agregar o quitar programas en el Panel de control.
2. Busque IBM Tivoli Workload Scheduler for Applications (nombre_usuario).
3. Haga clic en Eliminar. Se abrirá la ventana Desinstalador en la que podrá
optar por suprimir todo el producto o uno o varios de los métodos de acceso
que se han instalado como funciones del producto.v En Unix:
1. Vaya al directorio <inicioTWS>/methods.
2. Ejecute el comando siguiente:
../_xauninst/uninstaller
Se abrirá la ventana Desinstalador en la que podrá optar por suprimir todo
el producto o uno o varios de los métodos de acceso que se han instalado
como funciones del producto.
Eliminación de una instalación mediante Tivoli Configuration
Manager
Para desinstalar el producto utilizando la distribución de software, utilice el
Escritorio de Tivoli o el comando wremovsp.
Para ver una lista de los paquetes instalados en el sistema mediante la distribución
de software, utilice uno de los procedimientos siguientes:
v Utilice Tivoli Inventory, incluido en Tivoli Configuration Manager Versión 4.2,
para ejecutar la consulta denominada CM_STATUS_QUERY y ver el método de
acceso que está instalado en cada estación de trabajo. Consulte la documentación
de Tivoli Inventory como referencia.
v Consulte los archivos de registro de Software Distribution del sistema. Cada
paquete de distribución de software tiene su propio archivo de registro: un
archivo de texto que registra la historia de la instalación y desinstalación del
paquete. Por ejemplo, el archivo de registro en un sistema AIX del paquete de
método de acceso de R/3, r3batch_tws_aix.log, se almacena en el directorio
$BINDIR/../swdis/work (donde $BINDIR es una ruta de entorno de Tivoli
Framework que se ha inicializado ejecutando el comando
/etc/Tivoli/setup_env.sh).
Consulte la documentación de Tivoli Software Distribution para ver los detalles.
24 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Finalización de la eliminación del método de acceso para
Oracle e-Business Suite
Cuando termine el proceso de desinstalación, realice los pasos siguientes:
1. Restaure APPLSYS.env a su contenido original mediante la eliminación de la
cadena de caracteres MCM de las variables APPLSHAR y APPLFUL. Por ejemplo:
APPLSHAR=’ALR FF MCM’
debe convertirse en
APPLSHAR=’ALR FF’
2. Elimine los archivos siguientes:
v <inicioTWS>/methods/MCMAGENT
v <inicioTWS>/catalog/C/mcm.cat
v MCMLJ, MCMSTAT y MCMTJ ubicados en el directorio $MCM_TOP/bin
v MCMprod.txt ubicado en el directorio $APPL_TOP/admin
v Todos los archivos de opciones
Capítulo 2. Instalación de IBM Tivoli Workload Scheduler for Applications 25
26 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 3. Establecimiento de opciones con el Editor de
opciones
Un archivo de opciones es un archivo de texto que contiene un conjunto de
opciones de configuración requeridas para ejecutar un agente ampliado. Las
opciones se escriben una por línea y tienen el formato siguiente:
OPCIÓN=VALOR
sin espacios alrededor ni entre las palabras clave.
Las opciones se utilizan para alterar las propiedades de tiempo de ejecución del
método de acceso como, por ejemplo, la contraseña necesaria para conectar con un
sistema externo (como SAP R/3) o el nombre de inicio de sesión para esa conexión.
Todos los métodos de acceso utilizan dos tipos de archivos de opciones. Éstos son:
Archivos de opciones globales
Un archivo de configuración común para una instancia en particular de un
método de acceso cuyos valores afectan a todas las estaciones de trabajo de
agente ampliado definidas en esa instancia. Lista las opciones que como,
por ejemplo, LJuser (que proporciona el nombre del usuario que ejecuta el
método de acceso) e IFuser (que proporciona el nombre del usuario que
ejecuta el método para recuperar la información de trabajo), se especifican
en parte en el tiempo de la instalación. El nombre de este archivo es
<nombre_método_acceso.opts.
Por ejemplo, para una instalación del método de acceso para R/3, el
nombre del archivo de opciones globales es r3batch.opts.
Archivo de opciones locales
Un archivo de configuración que es específico de cada estación de trabajo
de agente ampliado en una instancia en particular de un método de acceso.
Cada estación de trabajo de agente ampliado, excepto para z/OS, debe
tener un archivo de opciones locales con sus propias opciones de
configuración. El nombre de este archivo es Nombre de estación de
trabajo_<nombre_método_acceso>.opts.
Por ejemplo, si una instalación del método de acceso para R/3 incluye dos
estaciones de trabajo de agente ampliado, CPU1 y CPU2, los nombres de
los archivos de opciones locales serán respectivamente CPU1_r3batch.opts
y CPU2_r3batch.opts.
Los archivos deben residir en el subdirectorio methods de la instalación de Tivoli
Workload Scheduler y se leerán cuando se inicialice el agente ampliado. Las
opciones son específicas de cada método de acceso. Para conocer las opciones de
cada método de acceso, consulte:
v El Capítulo 8, “Referencia al archivo de opciones MCMAGENT”, en la página 53
para Oracle
v El Capítulo 11, “Tareas posteriores a la instalación”, en la página 65 para
PeopleSoft
v El Capítulo 20, “Archivos de opciones del método de acceso de R/3”, en la
página 119 para R/3
v El Capítulo 25, “Configuración y utilización”, en la página 151 para z/OS
© Copyright IBM Corp. 2000, 2003 27
Puede escribir archivos de opciones con el editor de texto de su elección o crearlos
con el Editor de opciones suministrado con el producto.
Antes de completar la instalación, Tivoli Workload Scheduler for Applications
inicia opcionalmente el Editor de opciones para permitirle definir las opciones
locales, aunque algunos de los valores que ha especificado durante el proceso se
utilizan para crear un archivo de opciones globales. Para iniciar el Editor de
opciones en otro momento, vaya al subdirectorio methods de la instalación de
Tivoli Workload Scheduler y ejecute los comandos opted.exe (Windows) u
opted.bin (Unix).
Si ha instalado el producto mediante Tivoli Configuration Manager, inicie el Editor
de opciones con uno de estos comandos:
v inicioTWS\methods\opted\opted.bat en Windows
v inicioTWS/methods/opted/opted.sh en Unix
El Editor de opciones carga automáticamente todos los archivos de opciones
globales y locales existentes. Además de editar los archivos existentes, puede crear
archivos de opciones locales para las estaciones de trabajo de agente ampliado de
nueva definición.
El Editor de opciones ofrece tres vistas posibles de un archivo de opciones:
Simple
Visualiza las opciones como una secuencia de pestañas y le permite editar
una opción cada vez. Para ver o editar una opción, seleccione la pestaña
que lleva el nombre de la opción y se visualizará el campo para el valor. Es
la manera más fácil de editar opciones, porque sólo se ve el valor real que
se utilizará en el archivo. Los valores heredados o predeterminados no se
visualizan. Las opciones obligatorias aparecen en amarillo y marcadas por
un asterisco (*).
Tabla Ofrece una vista tabular de todas las opciones para un archivo
seleccionado. Para cada opción, se visualizan las siguientes columnas:
Valor El valor especificado en el archivo.
Valor predeterminado
El valor utilizado por el método si no está disponible ningún otro.
Valor heredado
El valor obtenido del archivo de opciones globales, si el método da
soporte a la herencia.
Valor real
El valor que se utiliza realmente en el tiempo de ejecución. El
orden de utilización es: valor, si está disponible; valor heredado, si
está soportado; valor predeterminado.
Las opciones obligatorias aparecen sobre un fondo amarillo.
Texto Visualiza un archivo de opciones en el formato típico, mostrando
solamente las opciones que tienen un valor. Generalmente, esta vista se
utiliza como vista previa, ya que los archivos aparecen en formato de sólo
lectura. Los campos de contraseña aparecen cifrados.
La ventana Editor de opciones se compone de tres áreas principales, tal como se
muestra en la Figura 17 en la página 29. Son:
28 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Árbol de archivos de opciones
Muestra la lista de todos los archivos de opciones existentes, reunidos por
método.
Descriptor de opciones
Ofrece una descripción de la selección actual.
Vista de opciones de archivo
Visualiza las opciones de un archivo seleccionado en cualquiera de las tres
vistas disponibles.
Asegúrese de que el Editor de opciones no esté en ejecución antes de agregar o
actualizar funciones o instancias a una instalación de Tivoli Workload Scheduler
for Applications existente.
Debe restringir el acceso al ejecutable del Editor de opciones. Si dispone de
múltiples instalaciones de un agente ampliado, puede ampliar la seguridad
mediante el mantenimiento de una sola copia del Editor de opciones (en la
estación de trabajo maestra, por ejemplo). Mediante la utilización de FTP, puede
gestionar todos los archivos de opciones cifrados desde una ubicación.
Árbol de archivos de opciones
Descriptor de opcionesVista de opciones de archivo
Figura 17. Editor de opciones
Capítulo 3. Establecimiento de opciones con el Editor de opciones 29
Creación de un archivo de opciones locales
Aunque se generen archivos de opciones globales cada vez que se instala una
instancia de un método de acceso, puede crear archivos de opciones locales en
cualquier momento que desee, antes o después de definir una estación de trabajo
de agente ampliado. Para hacerlo con el Editor de opciones:
1. Haga clic en Archivo→Nuevo en la barra de menús. Se visualizará la ventana
Nuevo archivo de opciones.
2. Escriba el nombre de la estación de trabajo de agente ampliado que acaba de
definir o piense definir.
3. Seleccione un método de acceso entre los instalados en el menú desplegable. El
nuevo archivo de opciones tendrá el nombre:
<nombre_estación_trabajo_agente_ampliado>_<nombre_método>.opts.
4. Empiece a especificar los valores para las opciones.
Herencia de valores de opciones
Actualmente, esta propiedad sólo está disponible para r3batch. Implica que los
archivos de opciones locales pueden heredar los valores existentes de las mismas
opciones del archivo de opciones globales (r3batch.opts). De hecho, las opciones se
listan dos veces para un método de acceso: una vez como global y otra como local.
Si la opción local no indica su propio valor, entonces se utiliza el de su equivalente
global. De lo contrario, si existe, el valor local prevalece siempre sobre el global.
Por ejemplo, si desea definir el mismo usuario de R/3 y contraseña para todos los
sistemas R/3. Mediante la utilización de esta propiedad, en lugar de escribir los
mismos valores en todos los archivos de opciones locales, puede escribirlos una
vez en el archivo de opciones globales.
30 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 4. Definición de estaciones de trabajo de agente
ampliado
Se requiere una definición de estación de trabajo de agente ampliado para cada
entidad de un método de acceso mediante la cual Tivoli Workload Scheduler
planificará e iniciará trabajos. Las estaciones de trabajo de agente ampliado se
definen de manera estándar e incluyen el nombre de host del agente ampliado y el
nombre de método.
Para iniciar un trabajo en una estación de trabajo de agente ampliado, Tivoli
Workload Scheduler ejecuta el método de acceso, pasándole información acerca del
trabajo. El método de acceso se comunica con la instancia del sistema z/OS, R/3,
PeopleSoft u Oracle en particular y supervisa el trabajo hasta su terminación,
grabando la evolución del trabajo y la información del estado en el archivo de lista
estándar del trabajo.
Creación de una estación de trabajo con Job Scheduling Console
Para definir una estación de trabajo de agente ampliado con Job Scheduling
Console, siga estos pasos:
1. En la ventana principal, seleccione el icono Nueva estación de trabajo en la
barra de herramientas superior o haga clic con el botón derecho del ratón en el
nombre del motor de Tivoli Workload Scheduler y seleccione Nueva estación
de trabajo en el menú desplegable. Se visualizará la ventana Propiedades -
Estación de trabajo de base de datos.
2. Complete los campos utilizando la información de la Tabla 6 en la página 32.
3. Haga clic en Aceptar para guardar y cerrar la ventana.
Figura 18. Definición de una estación de trabajo con Job Scheduling Console
© Copyright IBM Corp. 2000, 2003 31
La tabla siguiente muestra cómo completar los campos de la ventana de
propiedades de la estación de trabajo en la que desea definir la estación de trabajo
de agente ampliado.
Tabla 6. Cómo completar los campos de la ventana Propiedades - Estación de trabajo de base de datos
Campo Descripción por método de acceso
PeopleSoft z/OS Oracle eBusiness Suite R/3
Nombre El nombre para la estación de trabajo de agente ampliado. Para todos los métodos de acceso
(excepto para el de z/OS que siempre está limitado a 8 caracteres), el nombre puede
contener hasta 8 ó 16 caracteres alfanuméricos dependiendo si utiliza bases de datos no
expandidas o expandidas. Puede incluir guiones y caracteres de subrayado, pero debe
empezar por una letra.
Para todos los métodos de acceso, este nombre debe ser coherente con el nombre del archivo
de opciones asociado a la estación de trabajo. Es decir, si el archivo de opciones (que
normalmente crea con el Editor de opciones) se denomina <micpu>_<mimétodo>.opts,
entonces micpu y Nombre deben ser iguales.
Nodo null. El nombre de nodo o
dirección IP del
sistema z/OS. Se
aceptan los nombres
de dominio
completamente
calificados.
null. null.
Puerto TCP Cualquier número
distinto de 0.
La dirección TCP
(número de puerto)
del gateway z/OS en
el sistema z/OS.
Especifique el mismo
valor que la variable
PORT de SYSTSIN
descrita en la Tabla 21
en la página 146.
Cualquier número
distinto de 0.
Cualquier número
distinto de 0.
Sistema operativo Seleccione OTHER.
Dominio El nombre del dominio Tivoli Workload Scheduler de la estación de trabajo del host. Si
necesita ayuda para encontrarlo, haga clic en los puntos suspensivos (...) para ver una lista
de los dominios existentes. Haga clic en Utilizar maestro, si sabe que la estación de trabajo
host está en el mismo dominio que el gestor de dominio maestro.
Huso horario Si la red de Tivoli Workload Scheduler utiliza la opción Huso horario, seleccione el huso
horario adecuado en la lista desplegable. Deje el campo en blanco, si no es este el caso.
Descripción Una descripción opcional en texto con formato libre de la estación de trabajo (hasta 40
caracteres).
Comunicación SSL No se utiliza en estaciones de trabajo de agente ampliado.
Tras un cortafuegos No se utiliza en estaciones de trabajo de agente ampliado.
Puerto seguro No se utiliza en estaciones de trabajo de agente ampliado.
Tipo de estación de
trabajo
Seleccione Agente ampliado.
AutoLink No se utiliza en estaciones de trabajo de agente ampliado.
Ignorar Seleccione esta opción únicamente si desea que Tivoli Workload Scheduler ignore la
definición de esta estación de trabajo. Esta opción es útil si desea predefinir secuencias de
trabajos y objetos para un sistema que aún no ha llegado.
Estado completo No se utiliza en estaciones de trabajo de agente ampliado.
32 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Tabla 6. Cómo completar los campos de la ventana Propiedades - Estación de trabajo de base de
datos (continuación)
Campo Descripción por método de acceso
PeopleSoft z/OS Oracle eBusiness Suite R/3
Resolver
dependencias
No se utiliza en estaciones de trabajo de agente ampliado.
Servidor No se utiliza en estaciones de trabajo de agente ampliado.
Método de acceso psagent Dependiendo de la
interfaz de
programación de
trabajo, uno de los
siguientes:
mvsca7 Para iniciar y
supervisar
trabajos
z/OS
mediante
CA-7.
mvsjes Para iniciar y
supervisar
trabajos
z/OS
mediante
JES2 o JES3.
mvsopc
Para iniciar y
supervisar
trabajos
z/OS
mediante
OPC o Tivoli
Workload
Scheduler for
z/OS.Nota: El nombre es
sensible a las
mayúsculas y
minúsculas (debe
estar en minúsculas)
en Unix.
MCMAGENT
Nota: El nombre es
sensible a las
mayúsculas y las
minúsculas y debe estar
en mayúsculas.
r3batch
Nota: El nombre es
sensible a las
mayúsculas y
minúsculas (debe
estar en minúsculas)
en Unix.
Host El nombre Tivoli Workload Scheduler del sistema host. Se trata del agente tolerante a errores
o el agente estándar Tivoli Workload Scheduler en el que está instalado el agente ampliado.
Haga clic en los puntos suspensivos (...) para ver una lista de los hosts existentes.
Creación de una estación de trabajo desde la línea de comandos
Las definiciones de estación de trabajo de agente ampliado también pueden crearse
en la línea de comandos de Tivoli Workload Scheduler utilizando el programa
composer. El ejemplo siguiente muestra una definición para una estación de
trabajo de agente ampliado z/OS denominada MVSCPU que utiliza el método de
acceso mvsjes.
cpuname MVSCPU description "agente ampliado zOS"
os other
node mvsesa36.rome.tivoli.com
tcpaddr 5000
Capítulo 4. Definición de estaciones de trabajo de agente ampliado 33
domain masterdm
for maestro
type x-agent
host ROCIOUS
access mvsjes
end
Consulte la publicación IBM Tivoli Workload Scheduler - Guía de consulta para
ver más detalles acerca de la definición de estaciones de trabajo con composer.
Definición de estaciones de trabajo para la planificación global
La planificación en un entorno global significa que Tivoli Workload Scheduler for
z/OS está planificando y supervisando trabajos que se están ejecutando físicamente
en estaciones de trabajo Tivoli Workload Scheduler.
Para este fin, las estaciones de trabajo de agente ampliado deben estar definidas
correctamente como estación de trabajo tolerante a errores en Tivoli Workload
Scheduler for z/OS.
Una estación de trabajo tolerante a errores es la definición de Tivoli Workload
Scheduler for z/OS de un agente de Tivoli Workload Scheduler existente en la red
distribuida. El agente Tivoli Workload Scheduler es donde el trabajo asociado con
la estación de trabajo tolerante a errores se ejecutará realmente en la red
distribuida.
Para definir la estación de trabajo de agente ampliado en Tivoli Workload
Scheduler for z/OS, debe:
1. Definir la estación de trabajo en la sentencia de inicialización CPUREC.
2. Agregar la misma definición de estación de trabajo a la base de datos mediante
ISPF o Job Scheduling Console. Para obtener una descripción de cómo definir la
estación de trabajo utilizando Job Scheduling Console, consulte la publicación
Tivoli Job Scheduling Console - Guía del usuario.
Creación de la sentencia CPUREC
Primero, cree la sentencia CPUREC para la estación de trabajo en la sentencia de
inicialización TOPOLOGY. La sentencia de inicialización TOPOLOGY se utiliza para
definir los parámetros relacionados con la topología de la red Tivoli Workload
Scheduler conectada. Dicha sentencia de topología de red se compone de una o
varias sentencias DOMREC (una por cada dominio) que describen la topología de la
red distribuida y varias sentencias CPUREC, una para cada estación de trabajo
tolerante a errores.
El ejemplo siguiente muestra una sentencia CPUREC para una estación de trabajo de
agente ampliado R/3 denominado R3XA. El agente ampliado se aloja en un agente
Tivoli Workload Scheduler denominado TWSA, que también es el gestor de dominio
de DOMAIN1.
34 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
****************MIEMBRO TPLGINFO ***************************
/*********************************************************************/
/* DOMREC: Definición de dominio */
/*********************************************************************/
DOMREC DOMAIN(DOMAIN1)
DOMMNGR(TWSA)
DOMPARENT(MASTERDM)
/*********************************************************************/
/* CPUREC: Definición de estación de trabajo de agente ampliado */
/*********************************************************************/
CPUREC CPUNAME(R3XA)
CPUOS(OTHER)
CPUNODE(NODE1)
CPUDOMAIN(DOMAIN1)
CPUHOST(TWSA)
CPUTYPE(XAGENT)
CPUACCESS(r3batch)
CPUUSER(usuarioTWS)
CPUTZ(’Europa/Roma’)
/*********************************************************************/
/* CPUREC: Definición de estación de trabajo de gestor de dominio */
/*********************************************************************/
CPUREC CPUNAME(TWSA)
CPUNODE(NODE1)
CPUAUTOLINK(ON)
CPUDOMAIN(DOMAIN1)
CPUTYPE(FTA)
CPUUSER(usuarioTWS)
CPUTZ(’Europa/Roma’)
Las siguientes palabras clave definen R3XA como un agente ampliado:
CPUACCESS
El método de acceso del agente ampliado. Para R/3, es r3batch.
CPUHOST
El nombre de la estación de trabajo de Tivoli Workload Scheduler que aloja
el agente ampliado. No puede ser otro agente estándar ni agente ampliado.
CPUTYPE
El tipo de estación de trabajo. Para un agente ampliado, debe ser XAGENT.
Para obtener más información sobre CPUREC, consulte la publicación Tivoli Workload
Scheduler for z/OS Customization and Tuning.
Definición de la estación de trabajo con ISPF
La Figura 19 en la página 36 muestra la definición de ISPF para R3XA.
En ISPF (o en Job Scheduling Console), defina la estación de trabajo como pc
automática y, después, establezca el campo Estación de trabajo FT en S. Es la
sentencia CPUREC con las tres palabras clave descritas en el apartado anterior que
proporciona la especificación del agente ampliado.
Nota: Asegúrese de que escribe la sentencia CPUREC antes de crear la definición
ISPF o Job Scheduling Console, ya que ellas solas no tienen ningún efecto
sin la sentencia CPUREC.
Capítulo 4. Definición de estaciones de trabajo de agente ampliado 35
-------------- CREACIÓN DE INFORMACIÓN GENERAL ACERCA DE UNA ESTACIÓN DE TRABAJO --------------
Comando ===>
Entre el comando R de recursos A de disponibilidad o M de método de acceso
arriba o entre los datos de abajo:
NOMB ESTACION TRAB ===> R3XA
DESCRIPCIÓN ===> Agente ampliado para el método de acceso R/3____________
TIPO EST TRABAJO ===> C G General, C Sistema, I Impresora
ATRIBUTOS INFORME ===> A A Automático, S Inicio y finalización manual
C Sólo finalización, N Sin información
Estación trabajo FT ===> Y Estación de trabajo FT, Y o N
DIREC SAL IMPRESA ===> SYSPRINT ddname del conjunto de datos de salida impresa diario
USO DE SERVIDOR ===> N Uso de servidor paralelo C , P , B o N
Opciones:
DIVISIBLE ===> N Se permite la interrupción de la operación, Y o N
CONFIG TRABAJO ===> N Se permite la edición de JCL, Y o N
TAREA INICIADA, STC===> N Soporte de tarea iniciada, Y o N
WTO ===> N WTO automático, Y o N
DESTINO ===> ________ Nombre de destino
Valores predeterminado:
HORA TRANSPORTE ===> 00.00 Hora de la estación de trabajo anterior HH.MM
DURACIÓN ===> ________ Duración de una operación normal HH.MM.SS
Figura 19. Definición de una estación de trabajo de agente ampliado
36 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 5. Definición de trabajos de agente ampliado
Este capítulo explica cómo definir los trabajos Tivoli Workload Scheduler asociados
a los trabajos externos que desea ejecutar mediante los agentes ampliados.
Para ejecutar y supervisar un trabajo PeopleSoft, R/3, Oracle o z/OS con Tivoli
Workload Scheduler, el agente ampliado (o método de acceso) requiere una
definición de trabajo Tivoli Workload Scheduler, en la que se especifique el trabajo
externo que intenta planificar, la estación de trabajo (también definida en Tivoli
Workload Scheduler) en la que se supone que va a ejecutarse y las acciones de
recuperación deseadas. Para definir el trabajo, puede utilizar uno de los elementos
siguientes:
v Tivoli Job Scheduling Console
v La línea de comandos de Tivoli Workload Scheduler
Si realiza la planificación en un entorno global, debe utilizar los diálogos ISPF de
Tivoli Workload Scheduler for z/OS para definir el trabajo. Además, debe crear un
miembro en SCRIPTLIB con una sentencia JOBREC para el trabajo.
Los trabajos de agente ampliado se agregan a la secuencia de trabajos y se
planifican igual que cualquier otro trabajo de Tivoli Workload Scheduler y Tivoli
Workload Scheduler for z/OS.
Definición de trabajos con Job Scheduling Console
Los pasos descritos aquí para definir un trabajo de agente ampliado son comunes
para todos los métodos de acceso. También, el método de acceso para R/3 ofrece
funciones suplementarias si utiliza los pasos alternativos descritos en el apartado
“Utilización de las ventanas específicas de SAP de Job Scheduling Console” en la
página 102.
Para todos los métodos de acceso, siga estos pasos:
1. En la lista Acciones de la ventana principal de Job Scheduling Console,
seleccione Nueva definición de trabajo.
2. Seleccione un motor de Tivoli Workload Scheduler y en la lista resultante haga
clic en Tarea de agente ampliado. Aparecerá la página General de la ventana
Propiedades - Definición de trabajo.
© Copyright IBM Corp. 2000, 2003 37
3. En esta página se proporciona la información acerca del trabajo Tivoli Workload
Scheduler que dirigirá el trabajo externo. Complete los campos de esta ventana
con la ayuda de la tabla siguiente.
Tabla 7. Página General de la ventana Propiedades - Definición de trabajo (Descripciones
de campos).
Campo Descripción
Tipo de tarea Se trata de un campo de sólo lectura y debe indicar Tarea de agente
ampliado.
Nombre El nombre del trabajo Tivoli Workload Scheduler que está definiendo.
Este trabajo dirigirá el trabajo de aplicación externa cuyo nombre se
facilitará en la página siguiente de esta ventana. El nombre puede
contener hasta 8 caracteres alfanuméricos si la base de datos no está
expandida o 40 si lo está. Puede incluir guiones y subrayados, pero
debe empezar por una letra. No se permiten los espacios intercalados.
Puede ser el mismo que el nombre de trabajo externo, siempre que
sea válido en Tivoli Workload Scheduler.
Estación de trabajo El nombre de la estación de trabajo de agente ampliado en el que se
supone que debe ejecutarse el trabajo. Puede hacer clic en el botón de
puntos suspensivos (...) para visualizar una ventana Buscar y
seleccionar una estación de trabajo disponible.
Descripción Un texto de descripción del trabajo de hasta 64 caracteres
alfanuméricos de longitud. Se trata de un campo opcional.
Figura 20. Página General de la ventana Propiedades - Definición de trabajo.
38 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Tabla 7. Página General de la ventana Propiedades - Definición de trabajo (Descripciones
de campos). (continuación)
Campo Descripción
Inicio de sesión El nombre de usuario necesario para ejecutar el trabajo en Tivoli
Workload Scheduler. Normalmente, se trata del valor del parámetro
LJuser, especificado durante la instalación de Tivoli Workload
Scheduler for Applications, que está en el archivo de opciones para el
método. Debe ser un usuario válido en la estación de trabajo del host
de Tivoli Workload Scheduler que también debe poder acceder al
producto externo. Se requiere planificar el trabajo en Tivoli Workload
Scheduler y aparecerá en las pantallas de Tivoli Workload Scheduler.
Opcionalmente, haga clic en Agregar parámetro para agregar
cualquier parámetro predefinido al ID de inicio de sesión.
Opciones de
recuperación
La respuesta automática de Tivoli Workload Scheduler si el trabajo
termina de forma anómala. El valor predeterminado es Detener. Para
obtener información sobre las opciones de recuperación, consulte la
publicación Tivoli Workload Scheduler - Guía de consulta.
Mensaje Un mensaje de texto o solicitud opcional que se visualiza cuando el
trabajo termina de forma anómala. No se acepta ninguna solicitud
predeterminada aquí.
Trabajo El nombre de un trabajo de recuperación que empieza
automáticamente cuando el trabajo termina de forma anómala. Haga
clic en los puntos suspensivos (...) para visualizar la ventana Buscar y
la lista de los trabajos existentes.
Estación de trabajo El nombre de la estación de trabajo que tiene la propiedad del trabajo
de recuperación.
4. Haga clic en Tarea para seguir en la página siguiente. Se visualizará la página
Tarea de la ventana.
Figura 21. La página Tarea de la ventana Propiedades - Definición de trabajo.
Capítulo 5. Definición de trabajos de agente ampliado 39
5. En esta página el usuario facilita la información del trabajo externo (o tarea)
que dirigirá el trabajo definido en la página anterior. Tenga en cuenta que la
tarea ya debe estar definida en la aplicación externa. Complete los campos de
esta ventana con la ayuda de la tabla siguiente.
Tabla 8. Página Tarea de la ventana Propiedades- Definición de trabajo (Descripciones de
campos).
Campo Descripción
Tipo de tarea Se trata de un campo de sólo lectura y debe indicar Tarea de
agente ampliado.
Comando Las especificaciones del trabajo externo (tarea). Cada aplicación
externa tiene un conjunto de parámetros diferente:
v Para los trabajos Oracle Applications, consulte el apartado
“Parámetros de cadena de tarea para trabajos Oracle
Applications” en la página 49.
v Para los trabajos Peoplesoft, consulte el apartado “Parámetros
de cadena de tarea para trabajos PeopleSoft” en la página 77.
v Para los trabajos R/3, consulte el apartado “Parámetros de
cadena de tarea para trabajos R/3” en la página 109.
v Para los trabajos z/OS, consulte el apartado “Sintaxis de
definición de tareas para trabajos z/OS planificados con Tivoli
Workload Scheduler” en la página 153.
Escriba los parámetros en una cadena de caracteres que tenga el
formato siguiente
-parámetro1 valor1 -parámetro2 valor2...-parámetron valorn
Si hace clic en Agregar parámetro... se visualizará la ventana
Buscar parámetros donde podrá listar y agregar parámetros
predefinidos de Tivoli Workload Scheduler al campo Comando.
Expresión de
correlación de códigos
de retorno
Una expresión lógica que define los códigos de retorno que
hacen que la tarea sea satisfactoria. Puede utilizar operadores de
comparación y lógicos. Por ejemplo, la expresión RC≥6 indica
que un código de retorno mayor o igual a 6 significa que la tarea
ha sido satisfactoria.
6. Haga clic en Aceptar para guardar la definición de trabajo.
Definición de trabajos con la línea de comandos de Tivoli Workload
Scheduler
Los trabajos también pueden definirse en la línea de comandos de composer de
Tivoli Workload Scheduler. El ejemplo siguiente documenta un trabajo Tivoli
Workload Scheduler denominado orajob2 que se ejecuta en una estación de trabajo
de agente ampliado Oracle Applications denominada ora002. Se registra en UNIX
como orajobs e inicia un trabajo bajo Oracle Applications. El trabajo Oracle
Applications se denomina poxacr y su propietario es global. Si se necesita la
recuperación, Tivoli Workload Scheduler ejecutará el trabajo recov2 y, a
continuación, continuará el proceso.
ora002#orajob2
streamlogon orajobs
scriptname "-user global
-job fnd ’application developer’ po poxacr
-prn ps4 2
-v1 ’abc’"
description "oracle apps job #2"
recovery continue after recov2
40 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Tenga en cuenta que los argumentos de scriptname difieren según la aplicación.
Para consulta, vea los apartados siguientes:
v “Parámetros de cadena de tarea para trabajos Oracle Applications” en la página
49.
v “Parámetros de cadena de tarea para trabajos PeopleSoft” en la página 77.
v “Parámetros de cadena de tarea para trabajos R/3” en la página 109.
v “Sintaxis de definición de tareas para trabajos z/OS planificados con Tivoli
Workload Scheduler” en la página 153.
Para obtener más información acerca de la utilización de la línea de comandos
para definir trabajos, consulte la publicación Tivoli Workload Scheduler - Guía de
consulta.
Definición de trabajos para la planificación global
Los trabajos de agente ampliado planificados para ejecutarse en un entorno global
no pueden definirse mediante Job Scheduling Console o la línea de comandos de
Tivoli Workload Scheduler. Deben agregarse a SCRIPTLIB de Tivoli Workload
Scheduler for z/OS.
En el panel ISPF OPERACIONES de Tivoli Workload Scheduler for z/OS, los trabajos
de agentes ampliados se definen como cualquier otro trabajo, pero la opción de
una estación de trabajo de agente ampliado indica su clase. El ejemplo siguiente
muestra la definición de un trabajo denominado SAPJOB. Se trata del trabajo Tivoli
Workload Scheduler for z/OS que va a dirigir la ejecución de un trabajo R/3
(denominado BAPRINT46B como verá en el ejemplo siguiente). Aparece como un
trabajo de agente ampliado porque la estación de trabajo asociada es una estación
de trabajo de agente ampliado denominada R3XA.
Debe crearse un miembro en SCRIPTLIB de Tivoli Workload Scheduler for z/OS con
detalles acerca de cada trabajo, en una sentencia JOBREC. Se ha creado un miembro
SAPJOB para el trabajo del ejemplo anterior. Contiene una sentencia JOBREC como
esta:
JOBREC
JOBCMD(’/-job BAPRINT46B -user MAESTRO -i 14160001 -c C’)
JOBUSR(twsila)
--------------------------------- OPERACIONES -----------------Fila 1 a 1 de 1
Comando ===> Desplazamiento ===> PÁG.
Entre/Cambie los datos de las filas y/o entre cualquiera de los siguientes
comandos de fila:
I(nn) - Insertar, R(nn),RR(nn) - Repetir, D(nn),DD - Suprimir
S - Seleccionar detalles de operación, J - Editar JCL
Entre el comando TEXT de arriba para incluir el texto de la operación en esta lista o
entre el comando GRAPH para ver la lista gráficamente.
Aplicación : APLL1 Apl FTW
Fila Oper Duración Nomb. tr. Predecesores internos Más pred.
cmd ws no. HH.MM.SS -IntExt-
’’’’ R3XA 001 00.00.01 SAPJOB___ ___ ___ ___ ___ ___ ___ ___ ___ 0 0
******************************* Fin de datos ********************************
Figura 22. Definición de un trabajo de agente ampliado para la planificación global.
Capítulo 5. Definición de trabajos de agente ampliado 41
El método de acceso lee e interpreta la cadena de caracteres de JOBCMD antes de la
ejecución del trabajo. El trabajo de este ejemplo, BAPRINT46B, se ha definido
previamente en R/3 y se le ha asignado el ID 14160001, que se ha transcrito
manualmente en JOBCMD.
El ejemplo siguiente es para un trabajo PeopleSoft. Tenga en cuenta que toda la
cadena de caracteres que sigue a la palabra clave JOBCMD debe ir entre comillas
dobles en lugar de comillas simples. Esto es así sólo cuando se trata de trabajos
PeopleSoft, porque las comillas simples ya se utilizan en la cadena de caracteres.
JOBREC
JOBCMD("/-operator PS -process XRFWIN -type ’SQR Report’ -runcontrol TWS")
JOBUSR(PsBuild)
Los argumentos de JOBCMD difieren según la aplicación. Como referencia, consulte
los apartados siguientes:
v “Parámetros de cadena de tarea para trabajos Oracle Applications” en la página
49.
v “Parámetros de cadena de tarea para trabajos PeopleSoft” en la página 77.
v “Parámetros de cadena de tarea para trabajos R/3” en la página 109.
v “Sintaxis de definición de tareas para trabajos z/OS planificados con Tivoli
Workload Scheduler” en la página 153.
42 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Parte 2. Método de acceso de Oracle e-Business Suite
© Copyright IBM Corp. 2000, 2003 43
44 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 6. Introducción
IBM Tivoli Workload Scheduler for Applications para Oracle e-Business Suite
ofrece la posibilidad de planificar trabajos Oracle e-Business Suite mediante la
utilización de las sofisticadas funciones de planificación de trabajos de Tivoli
Workload Scheduler.
En este manual, se utilizan los términos Oracle Applications y Oracle e-Business
Suite indistintamente para hacer referencia al mismo producto.
El host Tivoli Workload Scheduler, el agente ampliado de Tivoli Workload
Scheduler para Oracle e-Business Suite y la instancia de Oracle e-Business Suite
deben estar instalados en el mismo nodo físico.
Funciones
v Utilice las dependencias de trabajo estándar de Tivoli Workload Scheduler
(excepto las dependencias de apertura de archivo).
v Planifique los trabajos Oracle e-Business Suite para que se ejecuten en los días y
horas especificados y en el orden prescrito.
v Defina las interdependencias entre trabajos Oracle Applications y trabajos que se
ejecutan en sistemas diferentes como, por ejemplo, R/3 y PeopleSoft.
v Defina las interdependencias entre los trabajos Oracle Applications y los trabajos
que se ejecutan en plataformas diferentes.
v Personalice los códigos de retorno de ejecución de trabajos.
Requisitos de software
Para instalar y utilizar IBM Tivoli Workload Scheduler for Applications para Oracle
e-Business Suite debe disponer de:
v Uno de los siguientes sistemas operativos soportados:
– HP-UX 11.0, 11.i
– Solaris Operating Environment Versiones 7, 8, 9
– IBM AIX 4.3.3, 5.1v El siguiente software instalado:
– IBM Tivoli Workload Scheduler 7.0 o posterior
– Oracle Applications 10.7 u Oracle e-Business Suite 11.0 ó 11.i
– Sólo para usuarios de AIX y HP, el compilador gcc para la plataforma
respectiva. Los binarios del compilador gcc pueden recuperarse de varias
fuentes de la Web.
Para obtener la lista de plataformas soportadas más reciente, póngase en contacto
con un representante de Soporte al cliente.
Tareas posteriores a la instalación
Después de haber instalado el producto, tal como se explica en el Capítulo 2,
“Instalación de IBM Tivoli Workload Scheduler for Applications”, en la página 5,
efectúe los pasos siguientes para completar la instalación del método de acceso
para Oracle e-Business Suite:
© Copyright IBM Corp. 2000, 2003 45
1. Inicie la sesión como usuario Unix de Oracle Applications, que tiene acceso a
todos los archivos del directorio superior de Oracle Application.
2. Vaya la directorio de instalación:
cd <inicioTWS>/methods/OracleTMP
Nota: Si ejecuta la base de datos de demostración de Oracle Applications, sustituya
el archivo APPDEMO.env en los pasos 3 y 4. 3. Modifique el archivo APPLSYS.env de Oracle Applications de la manera
siguiente:
a. Agregue MCM a las variables APPLSHAR y APPLFULL.
APPLSHAR=’ALR FF MCM’
APPLFUL=’FND AD AX AK GL RG INV OP MCM’
b. Defina y exporte la variable de shell MCM_TOP:
MCM_TOP=$APPL_TOP/mcm/integration
export MCM_TOP
c. Agregue $MCM_TOP/bin a la variable PATH entrando las líneas siguientes al
final del archivo APPLSYS.env:
PATH=$PATH:$MCM_TOP/bin
export PATH
4. Ejecute el archivo APPLSYS.env para establecer el entorno:
. APPLSYS.env
Nota: Asegúrese de que el inicio de sesión de Oracle Applications tenga permisos
de grabación en los directorios inicioTWS y methods. 5. Cambie la propiedad de usuario y grupo de los archivos instalados por la del
propietario de Oracle Application.
6. Vaya al directorio /temp/usrxit.
7. Sólo para usuarios de AIX y HP:
v Debido al formato de los objetos MCMxxx.o, debe utilizar el compilador gcc
para la plataforma a fin de ejecutar los pasos siguientes. Los binarios del
compilador gcc pueden descargarse de varias fuentes de Internet.
v Sólo para usuarios de AIX: Personalice el script adrelink suministrado por
Oracle para las opciones de volver a enlazar de gcc:
a. Busque la línea siguiente:
AIXRIOS) LDFLAGS=’-s -H512 -T512 -bhalt:4 -brtl -L$(ORACL ....’
b. Suprima
-H512 -T512 -bhalt:4 -brtl
para que indique lo siguiente:
AIXRIOS) LDFLAGS=’-s -L$(ORACL ....’
v Asegúrese de que el compilador gcc esté configurado en la ruta del entorno
del propietario de Application. Como opción alternativa, puede editar el
archivo mcm.mk enviado con el producto para escribir la ruta completa de
gcc en la línea
CC="gcc"
Nota: IBM Tivoli Workload Scheduler for Applications para Oracle
e-Business Suite sólo soporta la versión 2.x del compilador gcc. La
versión 3.x no está soportada.
46 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
8. Ejecute el script de instalación mcminstall desde el directorio temp. Utilice el
comando siguiente:
sh mcminstall
Se visualizará una pantalla de Oracle Tivoli.
9. Responda a las peticiones de la pantalla de acuerdo a los valores de Oracle
Applications y los de la instalación de Tivoli Workload Scheduler.
Ahora el proceso de instalación intenta volver a enlazar los ejecutables de
Tivoli Workload Scheduler for Applications con las bibliotecas compartidas de
Oracle Applications
Cuando el proceso de volver a enlazar se complete satisfactoriamente,
encontrará los siguientes ejecutables en el directorio $MCM_TOP/bin:
v MCMLJ
v MCMSTAT
v MCMTJ
El programa de utilidad adrelink creará estos archivos binarios para Oracle
Applications. Este programa de utilidad también registrará MCM como
módulo en AOL.
Si encuentra problemas al volver a enlazar, debe arreglarlos y ejecutar de
nuevo el paso para volver a enlazar, porque este paso es responsable de crear
los archivos binarios que permiten a Tivoli Workload Scheduler for
Applications interactuar con Oracle Concurrent Manager al someter y
supervisar trabajos.
10. Edite el archivo de opciones. Consulte las siguientes secciones: Capítulo 8,
“Referencia al archivo de opciones MCMAGENT”, en la página 53 y
Capítulo 3, “Establecimiento de opciones con el Editor de opciones”, en la
página 27 para ver los detalles.
Ahora, la instalación se ha completado. Consulte la documentación de IBM Tivoli
Workload Scheduler para saber cómo iniciar Batchman, para definir estaciones de
trabajo y trabajos y otras operaciones de Tivoli Workload Scheduler.
Software de interfaz
La interfaz entre Tivoli Workload Scheduler y Oracle e-Business Suite se compone
del software siguiente:
MCMAGENT
El método de acceso de IBM Tivoli Workload Scheduler for Applications
para Oracle e-Business Suite.
MCMLJ
Somete un trabajo a Oracle Concurrent Manager (OCM).
MCMSTAT
Supervisa el estado del trabajo sometido.
MCMTJ
Termina el trabajo sometido, al recibir una señal de matar de Tivoli
Workload Scheduler.
mcm.mk
Un programa de utilidad makefile para enlazar los programas anteriores
con Oracle Applications.
Capítulo 6. Introducción 47
MCMAGENT.opts
Un archivo de opciones globales que contiene los valores de configuración
para el método de acceso. Se crea por el proceso de instalación de Tivoli
Workload Scheduler for Applications con algunos de los valores que entra
durante la instalación. Consulte las siguientes secciones: Capítulo 8,
“Referencia al archivo de opciones MCMAGENT”, en la página 53 y
Capítulo 3, “Establecimiento de opciones con el Editor de opciones”, en la
página 27 para ver los detalles.
<NOMBRE_ESTACIÓN_TRABAJO>_MCMAGENT.opts
Un archivo de opciones locales que contiene los valores de configuración
para el agente ampliado. Se requiere uno para cada estación de trabajo de
agente ampliado que defina. Consulte las siguientes secciones: Capítulo 8,
“Referencia al archivo de opciones MCMAGENT”, en la página 53 y
Capítulo 3, “Establecimiento de opciones con el Editor de opciones”, en la
página 27 para ver los detalles.
48 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 7. Información de la definición de trabajos
Este capítulo ofrece información para definir trabajos Oracle Applications en Tivoli
Workload Scheduler.
Definición de trabajos en Oracle Applications
En Oracle Applications, los trabajos que deben planificarse con Tivoli Workload
Scheduler se definen de la misma manera que otros trabajos Oracle Applications (y
pueden enviarse en OCM). Cuando envíe el trabajo en OCM, especifique la
información de planificación y de volver a enviar. Cuando envíe el trabajo
mediante Tivoli Workload Scheduler, Tivoli Workload Scheduler se hará cargo de la
información de planificación y de volver a enviar.
Para definir un trabajo, utilice los formularios Definir los ejecutables de programas
simultáneos y Definir programas simultáneos y especifique la información de datos
general para el trabajo. Ahora, el trabajo estará disponible para la planificación
desde Tivoli Workload Scheduler (y también podrá enviarse en OCM).
Ejecución de un solo trabajo simultáneamente
Si un trabajo de Oracle Applications está planificado para ejecutarse más de una
vez en Tivoli Workload Scheduler, y Tivoli Workload Scheduler lo inicia
simultáneamente, los trabajos se ejecutarán normalmente. Sin embargo, si el
usuario de Oracle Applications ha especificado que el trabajo no puede ejecutarse
simultáneamente, el segundo trabajo entrará en estado WAIT hasta que finalice el
primer trabajo.
Definición de trabajos de Oracle Applications en Tivoli Workload
Scheduler
Se requieren definiciones de trabajos Tivoli Workload Scheduler para cada trabajo
Oracle Applications que piense planificar. Los trabajos Oracle Applications se
definen en Tivoli Workload Scheduler como otros trabajos e incluyen el nombre del
trabajo, el nombre de usuario y las opciones de recuperación. Consulte el apartado
Capítulo 5, “Definición de trabajos de agente ampliado”, en la página 37.
Parámetros de cadena de tarea para trabajos Oracle
Applications
Este apartado describe los parámetros de cadena de tarea que controlan la
ejecución de trabajos Oracle Applications. Debe especificarlos en los lugares
siguientes al definir sus trabajos Tivoli Workload Scheduler asociados:
v En el campo Comando de la página Tarea de la ventana Propiedades -
Definición de trabajo, si utiliza Job Scheduling Console.
v Como argumentos de la palabra clave scriptname en la sentencia de definición
del trabajo, si utiliza la línea de comandos de Tivoli Workload Scheduler.
v Como argumentos de la palabra clave JOBCMD en la sentencia JOBREC de
SCRIPTLIB de Tivoli Workload Scheduler for z/OS, si planifica en un entorno
global.
© Copyright IBM Corp. 2000, 2003 49
Los parámetros se describen en la tabla siguiente.
Tabla 9. Parámetros de cadena de tarea para trabajos Oracle Applications.
Parámetro Descripción
-user iniciosesapps
El nombre de un usuario Oracle Applications (inicio
de sesión Apps).
-job espectrabajo
Los atributos del trabajo Oracle Applications. Hay
cuatro atributos de trabajo que deben especificarse
en el orden siguiente:
v El nombre del módulo de Applications utilizado
para iniciar la sesión en Oracle Applications (por
ejemplo, FND).
v Una responsabilidad válida para el módulo de
Applications (por ejemplo, ‘Application
Developer’). Este parámetro debe ir entre
comillas simples.
v El nombre de la aplicación que ha registrado el
trabajo (por ejemplo, PO).
v El nombre de trabajo (por ejemplo, POXACR). El
nombre de trabajo debe estar en mayúsculas.
Por ejemplo:
-job FND ’Application Developer’ PO POXACR
-prn opcimpr
Las dos opciones de impresora para el trabajo.
Deben especificarse en el orden siguiente:
v El nombre de impresora (opcional). Si se omite,
se utilizará la impresora predeterminada
especificada en el archivo de opciones.
v El número de copias.
Por ejemplo:
-prn ps4 2
[-vn (’valor’|null|:parámetro)]
Los parámetros del trabajo, si hay alguno. Esta serie
es opcional si no se especifican parámetros para el
trabajo Oracle Applications.
v n es el número de parámetro (v1, v2, etc.).
v Uno de los elementos siguientes:
valor Un valor real. Encierre el valor entre
comillas simples si contiene caracteres
especiales.
:parámetro
El nombre de un parámetro de Tivoli
Workload Scheduler que ya esté
definido. Consulte la publicación Tivoli
Workload Scheduler - Guía de consulta para
obtener más información acerca de
Tivoli Workload Scheduler.
El método de acceso agregará automáticamente
todos los parámetros que no especifique a la
definición con el valor null.
Estos son dos ejemplos:
-v4 ’abc’
-v15 :p1
50 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
El siguiente es un ejemplo de toda una especificación de cadena de tarea:
-user GLOBAL -job FND ’Application Developer’ PO POXACR -prn ps4 2 -v1 ’abc’
Estados de los trabajos Tivoli Workload Scheduler y Oracle
Applications
Cuando Tivoli Workload Scheduler inicia un trabajo Oracle Applications, podrá
supervisar su evolución con conman. Las transiciones de estado en Tivoli
Workload Scheduler y los estados correspondientes en Oracle Applications se
indican abajo.
Estados de Oracle Concurrent Manager Estados de Tivoli Workload Scheduler
Request Failure (Fallo Solicitud) o Request
not Found (Solicitud no encontrada)
UT (tarea no soportada)
Inactive (Inactivo) SUSP
Pending (Pendiente) WAIT
Pending Normal (Pendiente Normal) ADD
Running Normal (En ejecución Normal) EXEC
Completed Normal (Finalizado Normal) SUCC
Completed Warning (Finalizado
Advertencia)
SUCC
Completed Error (Finalizado Error) ABEND
Completed Terminated (Finalizado
Terminado)
ABEND
Completed Canceled (Finalizado Cancelado) ABEND
Para obtener más información acerca de la gestión de trabajos, consulte la
publicación Tivoli Workload Scheduler Reference Manual.
Capítulo 7. Información de la definición de trabajos 51
52 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 8. Referencia al archivo de opciones MCMAGENT
Este apartado ofrece información de referencia detallada acerca del archivo de
opciones de IBM Tivoli Workload Scheduler for Applications para Oracle
e-Business Suite.
Archivo de opciones
Cada instancia instalada del método de acceso de Oracle debe tener un archivo de
opciones coincidente. Puede crearlo durante o después de la instalación del método
de acceso con el Editor de opciones (consulte el Capítulo 3, “Establecimiento de
opciones con el Editor de opciones”, en la página 27) o con cualquier editor de
texto común. El convenio de denominación de cada archivo de opciones debe ser
<NOMBRE_ESTACIÓN_TRABAJO_MCMAGENT.opts y debe estar ubicado en el directorio
inicioTWS/methods. Si no crea uno, el agente utilizará de forma predeterminada el
archivo de opciones globales denominado MCMAGENT.opts.
Sintaxis de entrada
La tabla siguiente lista las opciones para el método de acceso MCMAGENT.
Tabla 10. Opciones de MCMAGENT.
Opción Descripción
ORACLE_HOME El directorio de Unix en el que el software de Oracle está
instalado.
ORACLE_SID El identificador del sistema Oracle de la instancia de base
de datos a la que se está conectando. Se corresponde con
el valor de la variable $ORACLE_SID de Oracle
Applications.
ORA_APP_TOPDIR El directorio de Unix donde Oracle Applications está
instalado.
FND_TOPDIR El directorio superior de FND donde reside la biblioteca
de objetos de Application.
PATH El valor de la variable PATH, incluyendo la ruta
existente, la ruta para el directorio bin de Oracle
Applications, la ruta para el directorio include bajo el
directorio superior de FND y otros, según se necesite.
ENV El archivo de entorno que debe ejecutarse. Cada instancia
de Oracle Applications tiene su propio archivo de
entorno (APPLSYS.env o APPDEMO.env). El nombre de
archivo .env que se da aquí se utilizará para establecer el
entorno dinámicamente cuando Tivoli Workload
Scheduler ejecute trabajos en el agente x de Oracle
Applications.
USERID Un ID de usuario de base de datos que tiene acceso a
todos los módulos de Oracle Applications. Debe poder
iniciar, gestionar y terminar trabajos en Oracle
Applications.
© Copyright IBM Corp. 2000, 2003 53
Tabla 10. Opciones de MCMAGENT. (continuación)
Opción Descripción
PASSWORD La contraseña para el ID de usuario seleccionado. Para
obtener el valor cifrado, utilice el programa de utilidad
enigma enviado con el producto. Consulte el apartado
“Cifrado de contraseñas de usuario de Oracle
Applications”.
PRINTER_NAME El ID de impresora predeterminada.
MIN_TIME El número de segundos que deben agregarse al intervalo
de sondeo anterior después del cual debe llevarse a cabo
la comprobación del estado del trabajo.
MAX_TIME El número de segundos tras los cuales el intervalo de
sondeo no se incrementará.
Todas las opciones son necesarias y deben escribirse una por línea con el siguiente
formato:
OPCIÓN=VALOR
sin blancos intercalados.
Ejemplo
El archivo HP113_MCMAGENT.opts es un archivo de opciones de ejemplo:
ORACLE_HOME=/general/ora716
ORACLE_SID=DEMO106
ORA_APP_TOPDIR=/apps106
FND_TOPDIR=$APPL_TOP/fnd/*
PATH=$PATH:$ORACLE_HOME/bin:$FND_TOP/include
ENV=$APPL_TOP/APPDEMO106.env
USERID=APPS_US
PASSWORD=APPS_US
PRINTER_NAME=PRINTER1
MIN_TIME=10
MAX_TIME=200
Cifrado de contraseñas de usuario de Oracle Applications
Cuando efectúe entradas en el archivo de opciones, el valor de contraseña se
cifrará automáticamente antes de grabarse en el archivo. Si modifica el archivo con
un editor de texto, debe ejecutar el programa enigma para cifrar la contraseña antes
de grabarla en el archivo. Ejecute el programa enigma de la manera siguiente:
enigma [contraseña]
Puede incluir la contraseña en la línea de comandos o entrarla en respuesta a una
solicitud. El programa devolverá la versión cifrada que podrá especificar en el
archivo de opciones.
54 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Parte 3. Método de acceso de PeopleSoft
© Copyright IBM Corp. 2000, 2003 55
56 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 9. Introducción
IBM Tivoli Workload Scheduler for Applications para PeopleSoft le permite
ejecutar y supervisar trabajos PeopleSoft desde el entorno Tivoli Workload
Scheduler. Estos trabajos pueden ejecutarse como parte de una planificación o
enviarse para el proceso de trabajos ad-hoc. Los trabajos de agente ampliado de
PeopleSoft pueden tener las mismas dependencias y opciones de recuperación que
otros trabajos Tivoli Workload Scheduler. Los trabajos PeopleSoft deben estar
documentados en Tivoli Workload Scheduler para ejecutarse y controlarse en el
entorno Tivoli Workload Scheduler.
Funciones
v El agente ampliado para las versiones 7.0, 7.5 y 8.x de PeopleSoft ha sido
certificado por PeopleSoft en Windows NT 4.0 con Service Pack 6 y en Windows
2000.
v Soporte de PeopleSoft 8.x.
v Utilice las dependencias de trabajos estándar de Tivoli Workload Scheduler en
los trabajos PeopleSoft.
v Planifique los trabajos PeopleSoft para que se ejecuten en los días y horas
especificados y en el orden prescrito.
v Defina las interdependencias entre los trabajos PeopleSoft y los trabajos Tivoli
Workload Scheduler que se ejecutan en diferentes aplicaciones como, por
ejemplo, R/3 y Oracle.
v Defina las interdependencias entre trabajos PeopleSoft y trabajos que se ejecutan
en plataformas diferentes.
v Personalice los códigos de retorno de ejecución de trabajos.
Visión general funcional
Tivoli Workload Scheduler puede iniciar y supervisar trabajos en el planificador de
procesos de PeopleSoft utilizando la estación de trabajo de agente ampliado de
PeopleSoft. El agente ampliado de PeopleSoft se define en una definición de
estación de trabajo estándar de Tivoli Workload Scheduler. Esta definición es un
nombre de estación de trabajo lógica y especifica el método de acceso como
psagent. El método de acceso se utiliza para comunicar las peticiones de trabajo al
planificador de procesos de PeopleSoft.
Para iniciar un trabajo PeopleSoft, Tivoli Workload Scheduler ejecuta el método
psagent, pasándole información acerca del trabajo. Un archivo de opciones
proporciona el método con la ruta, ejecutable y otra información acerca del
planificador de procesos de PeopleSoft y el servidor de aplicaciones utilizado para
iniciar el trabajo. Entonces el agente ampliado puede acceder a la tabla de
peticiones de procesos de PeopleSoft y realizar una entrada en ella para iniciar el
trabajo. La evolución y el estado del trabajo se graban en el archivo de lista
estándar del trabajo.
© Copyright IBM Corp. 2000, 2003 57
Trabajos de planificador de procesos de PeopleSoft
El planificador de procesos de PeopleSoft utiliza entradas en la tabla de peticiones
de procesos (PSPRCSRQST) para dirigir sus decisiones de trabajo. Estas entradas
describen los procesos que el agente de servidor del Planificador de procesos
iniciará. También contienen la información requerida para determinar el estado del
proceso. El método de acceso para PeopleSoft puede insertar entradas, consultar el
contenido y modificar la información de estado de esta tabla (PSPRCSRQST).
Al documentar un trabajo PeopleSoft en Tivoli Workload Scheduler, lo que el
usuario hace realmente es definir una petición de proceso que debe insertarse en la
tabla Petición de procesos (PSPRCSRQST). Una petición de proceso de Tivoli
Workload Scheduler debe contener tres fragmentos válidos de datos:
v Una definición de proceso que tiene dos partes:
– El tipo de proceso
– El nombre de procesov Un ID de operador (no es necesario en la ejecución en PeopleSoft 8.x)
v Un ID de control de ejecución
Todos estos elementos son necesarios para que se ejecute un trabajo PeopleSoft. El
método de acceso para PeopleSoft actualiza directamente la tabla PSPRCSRQST para
PeopleSoft 7.x (conexión de 2 niveles), mientras que para PeopleSoft 8.x explota el
servidor de aplicaciones PeopleSoft mediante la interfaz expuesta por la interfaz
del componente PROCESSREQUEST (conexión en 3 niveles).
Tenga en cuenta que el planificador de procesos y el servidor de aplicaciones se
ejecutan en Unix y en las estaciones de trabajo Windows FTA soportadas, mientras
que el agente ampliado sólo se ejecuta en Windows NT o Windows 2000.
Seguimiento de trabajos PeopleSoft en Tivoli Workload
Scheduler
Un trabajo PeopleSoft es una colección de procesos que se ejecutan conjuntamente
como una sola unidad. Los trabajos Tivoli Workload Scheduler pueden definirse de
una de las formas siguientes:
v Como los trabajos PeopleSoft, es decir, como una colección de procesos
PeopleSoft. En este caso, se hace un seguimiento del estado del trabajo
PeopleSoft, no del estado de los procesos individuales dentro del trabajo.
v Como procesos PeopleSoft. En este caso, se hace un seguimiento del estado de
los procesos individuales y se pueden definir planificaciones de Tivoli Workload
Scheduler a fin de crear interdependencias complejas y opciones de recuperación
entre procesos de PeopleSoft.
Seguridad
La seguridad para los trabajos PeopleSoft la maneja la seguridad estándar de Tivoli
Workload Scheduler.
Notas acerca del soporte de PeopleSoft Versión 8.x
Se han producido varios cambios en el soporte de PeopleTools 8.x que debe
conocer si piensa utilizar el método de agente x en el entorno.
v La palabra clave -operator utilizada en las especificaciones de trabajos Tivoli
Workload Scheduler y su parámetro correspondiente, se pasan por alto
58 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
actualmente por el método psagent y el tiempo de ejecución. Como
consecuencia, los trabajos se enviarán y ejecutarán con el mismo ID de operador
de PS que se utiliza para conectar con PeopleSoft. No es necesario que cambie
las definiciones de trabajo Tivoli Workload Scheduler si migra de PeopleTools 7.x
a PeopleTools 8.x. La diferencia será que todos los trabajos enviados a un agente
x de PeopleSoft 8.x se ejecutarán bajo el mismo ID especificado en el archivo
<NOMBRE_CPU>_psagent.opts.
v No hay necesidad de instalar la conectividad de base de datos en los FTA que
alojan agentes ampliados de PeopleSoft porque el método utiliza actualmente la
arquitectura de 3 niveles de PeopleSoft. Deberá configurar como mínimo un
Servidor de aplicaciones PeopleSoft para que el agente ampliado pueda
funcionar. El Servidor de aplicaciones deberá estar activo para que pueda enviar
satisfactoriamente trabajos al planificador de procesos PeopleSoft.
v No será necesario que cargue TVPUPSFT.dms en la base de datos de PeopleSoft 8.x
cuando utilice el modo de 3 niveles.
v Para PeopleSoft 8.1x, el método requiere la instalación del soporte de PeopleSoft
External Api en el FTA que aloja el método de agente ampliado. El directorio de
instalación de External API se utiliza durante los procesos de instalación y
configuración del agente ampliado cuando se le requiere que especifique el
directorio inicial de PeopleSoft o el directorio raíz de COBOL. Para instalar la
API externa utilice el ejecutable setup.exe ubicado en el directorio del servidor
de archivos de PeopleSoft 8.1x denominado: <INICIO_PS>\setup\PsExtAPI. La
instalación de PeopleSoft External API debe efectuarse antes de la instalación de
Tivoli Workload Scheduler for Applications. Verifique la instalación de External
API tal como indican las instrucciones de PeopleSoft: con la herramienta
jnitest.exe ubicada en el directorio de instalación PS External API. Deberá
rearrancar la estación de trabajo antes de poder utilizar la instalación de
PsExtAPI satisfactoriamente. Si no puede rearrancar, verá una ventana emergente
de TVPUPSFT.exe que indica:
"La aplicación no ha podido inicializarse correctamente (0xc0000005).
Haga clic en Aceptar para para terminar la aplicación"
Capítulo 9. Introducción 59
60 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 10. Planificación de la implementación
PeopleSoft Versión 7.5 o anterior
Este apartado describe la planificación de la implementación del agente ampliado
con PeopleSoft 7.5 o anterior.
Requisitos del host
Los requisitos de la estación de trabajo que aloja al agente ampliado son los
siguientes:
v Debe ser un agente tolerante a errores (FTA) o un agente estándar (SA) de Tivoli
Workload Scheduler que se ejecute en una versión soportada de Windows.
v Debe tener acceso de red a la base de datos de PeopleSoft.
v Debe ser capaz de ser una estación de trabajo PeopleSoft.
v Debe tener acceso a las bibliotecas de soporte de PeopleSoft y COBOL. El
soporte de COBOL debe ser compatible con el compilador utilizado para el
entorno del planificador de procesos NT.
Requisitos de software
Los requisitos de software de IBM Tivoli Workload Scheduler for Applications para
PeopleSoft son los siguientes:
v Windows NT 4.0 con Service Pack 6 o Windows 2000 con Service Pack 2.
v IBM Tivoli Workload Scheduler Versión 7.0 o posterior
v PeopleSoft versión 7.0, 7.5
v Compilador COBOL de PeopleSoft
Notas:
1. El agente ampliado para las versiones 7.0 y 7.5 de PeopleSoft está disponible
con MicroFocus NetExpress 2.1 y MicroFocus NetExpress 3.1.
2. El agente ampliado para PeopleSoft versión 7.0 también se ha compilado en
Micro Focus COBOL Workbench Compiler versión 4.1
3. Para Peoplesoft versiones 7.x, se requiere recompilar el planificador de procesos
Windows Peoplesoft si va a utilizarlo para trabajos gestionados con Tivoli
Workload Scheduler.
Configuración del usuario de Windows
v Cree un ID de usuario local o de dominio con autorización para acceder al
software PeopleSoft y Tivoli Workload Scheduler o configure el usuario existente
para permitirle el acceso al software PeopleSoft y Tivoli Workload Scheduler.
Consulte el apartado “Configuración del usuario para Windows” en la página 65
para ver los detalles.
v Inicie la sesión como el nuevo usuario.
v Conéctese a las unidades adecuadas para PeopleSoft. Asegúrese de seleccionar
Conectar de nuevo al iniciar la sesión. La letra de la unidad debe ser la misma
que ha especificado como PSDRIVE en psagent.opts.
v Efectúe una configuración de PeopleSoft. Siga las instrucciones facilitadas con el
software de PeopleSoft.
© Copyright IBM Corp. 2000, 2003 61
Verificación del entorno PeopleSoft
Asegúrese de que el entorno PeopleSoft esté configurado correctamente y que el
planificador de procesos pueda ejecutar satisfactoriamente los trabajos PeopleSoft.
Notas:
1. Verifique la conectividad de la base de datos con la base de datos PeopleSoft
utilizando el ID de usuario de Windows que ha creado antes. La conexión
puede comprobarse ejecutando un comando de base de datos con el programa
de utilidad ODBC.
2. Verifique el acceso al servidor de archivos Peoplesoft o la disponibilidad de la
copia local de los ejecutables.
Creación de un ID de proceso por lotes en PeopleSoft
Debe crear un ID de operador en PeopleSoft dedicado a la planificación por lotes.
Todos los trabajos sometidos por Tivoli Workload Scheduler deben utilizar ese ID
de operador.
Archivos instalados
Los archivos siguientes se instalan en los directorios de Tivoli Workload Scheduler
y PeopleSoft durante la instalación de Tivoli Workload Scheduler for Applications:
Destino Archivos Propietario
inicioTWS \methods\PeopleSoft v TVPUPSFT7xx.dms, donde
xxespecifica el release de
PeopleSoft Versión 7.
v PTCUDCOP.cbl
Usuario de Tivoli
Workload Scheduler
inicioTWS\methods v psagent.exe
v enigma.exe
Usuario de Tivoli
Workload Scheduler
<UNIDADPS_VERPS>\cblbin v TVPUPSFT.exe
v TVPUPSFT.gnt
Propietario de
PTPUPRCS.exe
Nota: inicioTWS indica el nombre del directorio en el que ha instalado Tivoli
Workload Scheduler.
PeopleSoft Versión 8.x
Este apartado describe la planificación de la implementación del agente ampliado
con PeopleSoft versión 8.x.
Requisitos del host
La estación de trabajo que aloja el agente ampliado debe ser un agente tolerante a
errores o estándar de Tivoli Workload Scheduler en una plataforma soportada de
Windows.
Si el sitio tiene múltiples servidores de procesos para una sola base de datos
PeopleSoft, puede configurar una estación de trabajo de agente ampliado
(utilizando múltiples archivos de opciones) para procesar trabajos en múltiples
servidores de procesos.
62 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Requisitos de software
Los requisitos de software de IBM Tivoli Workload Scheduler for Applications para
PeopleSoft son los siguientes:
v Windows NT 4.0 con Service Pack 6 o Windows 2000 con Service Pack 2.
v IBM Tivoli Workload Scheduler Versión 7.0 o posterior.
v PeopleSoft versión 8.1xo 8.4x.
v Para PeopleSoft versión 8.1x: PeopleTools External API versión 8.1x.
v Para PeopleSoft versión 8.4x: acceso a PeopleSoft File Server 8.4x o
disponibilidad de una copia local de ejecutables.
Creación de un ID de proceso por lotes en PeopleSoft
Debe crear un ID de operador en PeopleSoft dedicado a la planificación por lotes.
El ID de operador debe tener otorgada la autorización para utilizar la interfaz del
componente en el entorno PeopleTools. Todos los trabajos sometidos por IBM
Tivoli Workload Scheduler deben utilizar ese ID de operador.
Archivos instalados
Los archivos siguientes se instalan en los directorios de IBM Tivoli Workload
Scheduler y PeopleSoft durante la instalación de IBM Tivoli Workload Scheduler
for Applications para PeopleSoft:
Destino Archivos Propietario
inicioTWS\methods v psagent.exe
v enigma.exe
Usuario de Tivoli Workload
Scheduler
PSAPI_dir TVPUPSFT.exe Usuario de Tivoli Workload
Scheduler
Nota: inicioTWS indica el nombre del directorio en el que ha instalado Tivoli
Workload Scheduler.
Capítulo 10. Planificación de la implementación 63
64 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 11. Tareas posteriores a la instalación
Este capítulo describe tareas importantes que deben seguir a la instalación del
método de acceso.
Configuración del usuario para Windows
Cuando se utiliza un cliente PeopleSoft para enviar trabajos con IBM Tivoli
Workload Scheduler for Applications para PeopleSoft en el entorno de tres niveles
que utiliza un compartimiento en un servidor de archivos PeopleSoft, el inicio de
sesión de secuencia especificado en el envío del trabajo debe ser ″conocido″ en el
cliente que lo envía y en el servidor de archivos PeopleSoft. Lo que significa que
debe ser uno de los siguientes:
v Un usuario de dominio
v Un usuario local definido en el servidor de archivos PeopleSoft y en el cliente
PeopleSoft con el mismo nombre y la misma contraseña. El usuario debe
definirse, a continuación, en la base de datos Tivoli Workload Scheduler.
Si no se satisface esta condición, se producirán los síntomas siguientes:
v Los trabajos terminarán de forma anómala
v Se enviarán dos mensajes de error del sistema operativo a stdlist del trabajo, que
indicarán:
Error de inicio de sesión: nombre de usuario desconocido o contraseña incorrecta.
procwork.cpp(328): Ha terminado la canalización.
El usuario también debe formar parte del grupo Administrador en el cliente
PeopleSoft. Si no se satisface esta condición se producirán los síntomas siguientes:
v Los trabajos pasarán al estado INTRO (y se agregará un signo más ″+″ para
indicar un trabajo activo)
v Aparecerá una ventana emergente en la estación de trabajo Tivoli Workload
Scheduler que aloja el agente ampliado, con el título de ventana psagent.exe -
Error de aplicación, que indicará:
La aplicación no ha podido inicializarse correctamente (0xc0000005).
Haga clic en Aceptar para terminar la aplicación.
v Tras hacer clic en el botón Aceptar, los trabajos pasarán al estado de finalizado
anormalmente y el archivo stdlist del trabajo sólo mostrará el mensaje de
cabecera del programa JOBLNCH.
Creación del archivo de opciones
Los archivos de opciones de agentes ampliados PeopleSoft especifican, entre otra
información, el usuario de base de datos con el que el método se conecta a la base
de datos de PeopleSoft. También se utilizan para especificar el intervalo de sondeo
del módulo PeopleSoft para comprobar el estado del trabajo.
Este archivo debe residir en el sistema host para el agente ampliado, en el
directorio inicioTWS\methods.
Para crear un archivo de opciones, puede utilizar el Editor de opciones disponible
con este producto o cualquier editor de texto de su vínculo. Consulte el Capítulo 3,
“Establecimiento de opciones con el Editor de opciones”, en la página 27 para ver
© Copyright IBM Corp. 2000, 2003 65
los detalles sobre la creación o edición de archivos con el Editor de opciones y el
apartado “Edición manual de archivos de opciones” en la página 68 para ver los
ejemplos de los archivos de opciones para este método de acceso.
La tabla siguiente describe las opciones para el método de acceso psagent:
Tabla 11. Opciones de psagent.
Opción Descripción
LJuser El ID del usuario de Windows que inicia los trabajos IBM Tivoli
Workload Scheduler. Este usuario de Windows debe ser un usuario
válido de Tivoli Workload Scheduler en la estación de trabajo del
host.
CFuser El ID de usuario de Windows que ejecuta un archivo de
comprobación. El valor predeterminado es que coincida con Usuario
de inicio de trabajo.
CheckInterval El intervalo de tiempo entre comprobaciones de estado al supervisar
una petición de proceso. El valor predeterminado es de 2 minutos.
Utilice la opción CheckIntervalUnits para cambiar de minutos a
segundos.
CheckIntervalUnits Especifica que el Intervalo de comprobación de estado se especifica en
segundos (valor=1) en lugar de minutos (valor=60).
PSXA_TRACE El valor 1 habilita el rastreo de la ejecución. El valor 0 lo inhabilita.
PSDRIVE La letra de la unidad Windows para los archivos PeopleSoft (por
ejemplo, N:).
PSVER El directorio inicial para los archivos PeopleSoft (por ejemplo, \PT7.5
o \PT8) para todas las versiones de PeopleSoft excepto 8.1x. En este
caso, es el directorio en el que el archivo TVPUPSFT.exe está instalado
(por ejemplo, \PT817\bin\client\winx86_extapi)
COBROOT Para PeopleSoft 7.x: la ruta para el directorio base de las bibliotecas
de Micro Focus COBOL (por ejemplo, N:\PT7.5).
Para PeopleSoft 8.x: la ruta para el directorio base de PeopleSoft
External API. Es el mismo que el directorio inicial de PeopleSoft.
66 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Tabla 11. Opciones de psagent. (continuación)
Opción Descripción
CONNECT Una cadena de caracteres que contiene las entradas siguientes:
Tipo de conexión
El tipo de sistema RDBMS de PeopleSoft. Elija uno de los
siguientes:
v APPSERV (sólo PeopleSoft 8.x)
v ORACLE
v MICROSFT (Microsoft SQL Server)
v DB2 (DB2 para MVS)
v DB2UNIX
v SQLBASE
v DB2ODBC
v DB2400
v INFORMIX
v SYBASE
v DB2MDI
Nombre del servidor de bases de datos
El nombre del servidor de bases de datos. Sólo es para
Informix y Sybase. No se utiliza para PeopleSoft Versión
8.x.
Nombre de servidor
El nombre (dirección IP) del servidor especificado como
Tipo de conexión.
Para APPSERV, esta entrada debe ser Dirección IP:Puerto
TCP o el Nombre IP.
Puede especificar múltiples entradas siempre que estén
separadas por comas.
ID de operador
El ID de operador utilizado para conectar con la base de
datos PeopleSoft.
v Para PeopleSoft Versión 7.x, ningún trabajo se ejecutará
con este ID, sino con el ID especificado en la definición
de trabajo Tivoli Workload Scheduler.
v Para PeopleSoft Versión 8.x, todos los trabajos se
ejecutarán con este ID.
Contraseña de operador
La contraseña cifrada para el ID de operador. Si utiliza un
editor común para escribir el archivo de opciones, primero
debe utilizar la herramienta Enigma para cifrarlo. Si utiliza
el Editor de opciones, éste lo hará automáticamente.
Servidor de procesos predeterminado
El servidor de procesos predeterminado que ejecuta los
trabajos en PeopleSoft.
Las entradas van separadas por barras inclinadas (/), de modo que la
cadena de caracteres tiene el formato
elemento1/elemento2/.../elemento6y debe listarse en la secuencia
visualizada en esta explicación.
Todas las entradas son obligatorias a excepción de Nombre de
servidor de base de datos.
TWSXA_PT84_JVMPATH La ruta para Java Virtual Machine. Esta opción sólo está disponible
para utilizarla con PeopleTools Versión 8.4x.
Capítulo 11. Tareas posteriores a la instalación 67
Tabla 11. Opciones de psagent. (continuación)
Opción Descripción
UTF8cmdline Si se establece en 0, significa que el método de agente ampliado
espera que Tivoli Workload Scheduler envíe los datos necesarios para
iniciar el trabajo en la página de códigos local. De lo contrario, espera
los datos en formato UTF8. El valor predeterminado es 1 (por
ejemplo, formato UTF8).
TWSXA_CP La página de códigos que el agente ampliado utiliza al comunicarse
con la aplicación externa. Si la opción está ausente o tiene un valor no
válido, se utilizará la página de códigos local.
TWSMETH_CP La página de códigos que el método de agente ampliado utiliza para
generar la salida estándar. Si la opción está ausente o tiene un valor
no válido, se utilizará la página de códigos local.
TWSMETH_LANG El idioma que el método del agente ampliado utiliza para la salida
estándar (es decir, se abrirá el catálogo de mensajes especificado). Si
la opción está ausente o tiene un valor no válido, se utilizará el
idioma local.
TWSXA_LANG No está soportada para el agente ampliado de PeopleSoft.
Los nombres de opciones son sensibles a las mayúsculas y minúsculas y deben
escribirse tal como aparecen en la columna izquierda de la 11. Antes de utilizar el
archivo de opciones creado manualmente, compruebe que todos los nombres de
opciones estén escritos correctamente. Se pasarán por alto las opciones que no lo
estén.
Edición manual de archivos de opciones
Además del Editor de opciones, también puede utilizar cualquier editor común
para crear o cambiar manualmente un archivo de opciones.
Mas abajo encontrará dos archivos de opciones de ejemplo. Estos ejemplos están
pensados para ayudarle a determinar los requisitos locales específicos. El archivo
de opciones puede diferir de los ejemplos de abajo.
Recuerde que debe guardar el archivo en el directorio inicioTWS\methods
Ejemplo para PeopleSoft 7.x
LJuser=TwsUsr
CFuser=TwsUsr
PSDRIVE=N:
PSVER=\PS750
COBROOT=N:\PS750
CONNECT=ORACLE/HR75/PSUSA/#oqola4O7lxp5refgbAreV/PSNT
CheckInterval=15
CheckIntervalUnits=1
PSXA_TRACE=0
Ejemplo para PeopleSoft 8.1x
LJuser=TwsUsr
CFuser=TwsUsr
CheckInterval=15
PSDRIVE=D:
PSVER=\pt81x\bin\client\winx86_extapi
COBROOT=D:\pt81x\bin\client\winx86_extapi
CONNECT=AppServ/PSOFT81X:9000/PSDEV/jp5l83nlWe7wh5jxk46qeV/PSUNX
CheckIntervalUnits=1
PSXA_TRACE=1
68 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Conexión a más de una base de datos PeopleSoft
Puede que sea necesario que el método psagent deba conectarse a más de una base
de datos PeopleSoft. Por ejemplo, una sola instalación de PeopleSoft puede tener
un entorno TEST, DEMO y PRODUCTION, cada uno de ellos con una base de
datos independiente. Esto requiere que el método psagent utilice una cadena de
caracteres de conexión separada para cada base de datos.
Para dar soporte a esto, puede configurar múltiples estaciones de trabajo de agente
ampliado PeopleSoft que se conecten al mismo método pero utilicen diferentes
archivos de opciones. Cuando una estación de trabajo inicia el método, primero
busca el archivo de opciones con el nombre de estación de trabajo de agente
ampliado agregado al principio de psagent.opts. Por ejemplo, un agente ampliado
PeopleSoft llamado jupiter tendría el siguiente archivo de opciones:
jupiter_psagent.opts
El método psagent busca primero un archivo de opciones con el nombre de la
estación de trabajo de agente ampliado y, después, el archivo psagent.opts
predeterminado. Esto permite al usuario configurar un agente ampliado para cada
base de datos PeopleSoft.
Para conectarse a una sola base de datos, utilice el nombre predeterminado para el
archivo de opciones, psagent.opts.
Configuración del entorno PeopleSoft para la versión 7.5 o anterior
El siguiente apartado explica cómo configurar el entorno PeopleSoft si va a utilizar
el agente ampliado con PeopleSoft versión 7.5 o anterior.
Personalización del servidor de procesos
Sin tener en cuenta el tipo de sistema operativo en el que planificará los trabajos
Tivoli Workload Scheduler, deberá personalizar el ejecutable del servidor de
procesos correspondiente utilizando la fuente de COBOL PTCUDCOP.cbl facilitada
por IBM.
Debe sustituir el archivo PTCUDCOP.cbl proporcionado por PeopleSoft por el
archivo equivalente facilitado por IBM y volver a compilar el planificador de
procesos.
Podrá encontrar instrucciones completas sobre cómo volver a compilar el
planificador de procesos en los manuales de instalación de PeopleSoft. Cuando
reciba parches de PeopleSoft, deberá repetir el proceso de personalización del
servidor de procesos, si el archivo PTCUDCOP.cbl se sobregraba durante la
instalación del parche.
A continuación encontrará explicaciones sobre cómo ejecutar los pasos de
personalización en Windows y en UNIX.
Personalización en Windows
Si el planificador de procesos de PeopleSoft se ejecuta en Windows, consulte el
apartado ″Setting Up the Batch Environment on Windows NT/2000″ en el manual
de instalación de PeopleSoft para obtener la información actualizada. Debe haber
instalado un compilador COBOL en el servidor por lotes y debe efectuar la
compilación desde esa ubicación. El sistema que realiza la compilación debe tener
instalado un compilador COBOL y debe tener acceso de grabación para el servidor
de archivos.
Capítulo 11. Tareas posteriores a la instalación 69
Para crear el servidor de procesos en un sistema Windows:
1. Abra una ventana del indicador de comandos DOS.
2. Configure dos variables de entorno, PS_HOME y COBROOT, en el sistema en
el que piensa compilar COBOL. Utilice estos comandos:
set PS_HOME=n:\PS750
set COBROOT=c:\netexpress\base
3. Asegúrese de que el directorio de compilación c:\temp\compile exista; ya debe
existir si ha ejecutado CBLBLD.BAT. Si existe, elimine los archivos que residan
allí, como protección. Si no existe, debe crearlo con el comando siguiente:
mkdir c:\temp\compile
Nota: Asegúrese de que tiene permiso de grabación para el directorio de
compilación ya que el proceso de compilación tendrá lugar en esa
ubicación.
4. Vaya al directorio <PS_HOME>\setup.
5. Ejecute el comando siguiente para copiar todos los archivos fuente de COBOL
del directorio <PS_HOME> en el directorio de compilación:
cblsrc <directorio fuente> <directorio de compilación>
donde <directorio fuente> es la unidad y el directorio en el que reside la fuente
(debe ser igual que <PS_HOME>) y <directorio de compilación> es la unidad y
el directorio en el que se copiarán los archivos fuente.
Por ejemplo, el siguiente comando tomará la fuente COBOL de <PS_HOME> y
copiará todos los archivos necesarios en la ubicación en la que tendrá lugar el
proceso de compilación.
cblsrc <PS_HOME> c:\temp\compile
6. Copie el archivo PTCUDCOP.cbl proporcionado por IBM en el directorio de
compilación con el comando siguiente:
copy <TWS_HOME>\PeopleSoft\PTCUDCOP.cbl c:\temp\compile
7. Cuando CBLSRC finalice, cambie el directorio actual por el directorio de
compilación con el comando siguiente:
cd c:\temp\compile
8. Compile con el comando siguiente:
CBLMAKE.BAT PTPUPRCS EXE LIST
Si existen problemas de compilación, revise el archivo PTPUPRCS.lis para ver
los detalles y reintente el comando después de solucionar los problemas.
9. Cuando se complete CBLMAKE.BAT, copie los archivos EXE, GNT o INT en el
directorio <PS_HOME>\cblbin con los comandos siguientes:
copy PTPUPRCS.exe <PS_HOME>\cblbin
copy PTPUPRCS.gnt <PS_HOME>\cblbin
Personalización en UNIX
Si el planificador de procesos de PeopleSoft se ejecuta en UNIX, consulte el
apartado ″Setting Up the Batch Environment on UNIX″ del manual de instalación
de PeopleSoft para obtener información actualizada. Debe haber instalado un
compilador COBOL en el servidor por lotes y debe efectuar la instalación desde
esa ubicación. El sistema que realiza la compilación debe tener instalado un
compilador COBOL y debe tener acceso de grabación para el directorio
<PS_HOME>/cblbin.
Para crear el servidor de procesos en una máquina UNIX:
70 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
1. Inicie la sesión en el servidor UNIX.
2. Vaya del directorio actual al directorio inicial de PeopleSoft.
3. Ejecute el script psconfig.sh.
4. Cambie el directorio a $PS_HOME/src/cbl.
5. Cambie el nombre de PTCUDCOP.cbl por PTCUDCOP.old utilizando el
comando siguiente:
mv PTCUDCOP.cbl PTCUDCOP.old
6. Copie PTCUDCOP.cbl del agente ampliado (iniciotws/PeopleSoft) utilizando
FTP.
7. Ejecute los comandos siguientes:
cd ../../install
pscbl.mak PTPUPRCS LIST
8. Cuando se haya completado el script, compruebe los directorios de destino
para los nuevos archivos creados en
<PS_HOME>/src/cbl/int
<PS_HOME>/src/cbl/lst
<PS_HOME>/cblbin
Deben tener una longitud mayor que cero, así como una fecha e indicación de
la hora actuales. Si hay problemas con la compilación, revise el archivo
PTPUPRCS.lis por si hay errores, corríjalos y vuelva a intentar el paso de
compilación.
Configuración del cliente
Para ejecutar el método de acceso de PeopleSoft para un entorno PeopleTools 7.x,
debe ejecutarlo en un entorno PeopleSoft de dos niveles, utilizando una estación de
trabajo con una conectividad correcta para la base de datos.
Debe instalar el software cliente para la base de datos de su elección en la estación
de trabajo que aloja el agente ampliado y debe configurarlo para las
comunicaciones ODBC correctas. Pruebe su conexión utilizando las herramientas
de prueba ODBC proporcionadas con el software de cliente (por ejemplo, ODBC
32bit test for Oracle).
También necesita el acceso al servidor de archivos PeopleSoft. Correlacione el
compartimiento del servidor de archivos con una unidad de red de la estación de
trabajo Windows.
Para la instalación en una estación de trabajo para el entorno PeopleSoft 7.x:
1. Acceda a \\<servidor de archivos>\<compartimiento> como la unidad
compartida <d>: del sistema.
2. Establezca PS_HOME en el directorio adecuado de la nueva unidad compartida
con este comando:
set PS_HOME=<d>:\PS750
3. Ejecute:
%PS_HOME%\bin\CLIENT\WINX86\pscfg.exe
Se visualizará una ventana de configuración, tal como se muestra en la
Figura 23 en la página 72.
4. Seleccione la pestaña Client Setup (Instalación de cliente) y especifique los
valores requeridos asegurándose de que selecciona el cuadro de selección
Install PeopleSoft ODBC Driver (Instalar PeopleSoft ODBC Driver). Si ejecuta
Capítulo 11. Tareas posteriores a la instalación 71
SQL Server, también debe seleccionar el cuadro de selección Install ODBC
Driver Manager 3.0 (Instalar ODBC Driver Manager 3.0).
Nota: El indicador Install PeopleSoft ODBC Driver (Instalar PeopleSoft ODBC
Driver) instala un nombre de fuente de datos del ″usuario″. Si necesita
acceder a la fuente de datos desde otro perfil de usuario, deberá crear
una fuente de datos Sistema correspondiente, utilizando la
personalización ″Panel de control″-> ″Fuente de datos (ODBC)″ en la
máquina WinNT/2000 o para volver a ejecutar el paso de
personalización para todos los demás usuarios que desee utilizar para
enviar los trabajos de agente ampliado Tivoli Workload Scheduler.
Cuando haya terminado, en el menú ″Inicio/Programas″ deberá haber un nuevo
elemento etiquetado PeopleSoft 7.5.
Ejecución del script de Data Mover
Tras completarse la secuencia de instalación, se utilizará Data Mover (trasladador
de datos) de PeopleSoft para trasladar a su lugar los procedimientos almacenados
para el agente ampliado de PeopleSoft. Para obtener más información sobre el
script de Data Mover, consulte la documentación de Peoplesoft.
Figura 23. Ventana de Configuration Manager 7.5.
72 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
1. Haga clic en el icono Data Mover del grupo PeopleSoft. Se visualizará la
ventana Peoplesoft Signon (Inicio de sesión de Peoplesoft).
2. Seleccione la base de datos adecuada y haga clic en OK (Aceptar). Se
visualizará la ventana de inicio de sesión de PeopleSoft.
3. Cumplimente los campos del inicio de sesión y haga clic en OK (Aceptar). Se
visualizará la ventana Data Mover,
4. En el menú File (Archivo) de la ventana Data Mover, seleccione el comando
Open (Abrir). Abra el archivo siguiente en la ventana Data Mover de datos:
inicioTWS\PeopleSoft\TVPUPSFT.dms
5. Cuando haya cargado los scripts en la ventana Data Mover, ejecútelos.
La ventana Data Mover está dividida en dos partes. La sección superior
muestra las sentencias del script de Data Mover. La parte inferior muestra el
estado de las sentencias del script, a medida que se ejecutan.
6. Verifique que el script se ejecute satisfactoriamente.
Figura 24. Ventana Peoplesoft Signon (Inicio de sesión de PeopleSoft).
Capítulo 11. Tareas posteriores a la instalación 73
Si las sentencias fallan, compruebe que los valores de la ventana de inicio de
sesión Database Name (Nombre de base de datos), Login ID (ID de inicio de
sesión) y Password (Contraseña) sean correctos y, a continuación, repita este
proceso. Si el script de Data Mover continúa fallando, consulte al DBA para
determinar si hay un problema en la base de datos.
Nota: El script de Data Mover debe ejecutarse en cada base de datos que el agente
ampliado para PeopleSoft vaya a utilizar. Para ejecutar los scripts en otra
base de datos, cambie el nombre de base de datos y/o RDBMS en la
secuencia de inicio de sesión.
Configuración del entorno PeopleSoft para la versión 8.1x
El siguiente apartado explica cómo configurar el entorno PeopleSoft si va a utilizar
el agente ampliado con PeopleSoft versión 8.1x.
Personalización del servidor de aplicaciones
El método de acceso que da soporte a PeopleTools 8.1x sólo puede funcionar junto
con una arquitectura de tres niveles de PeopleSoft. Esto implica que debe
desplegar una arquitectura de tres niveles PeopleSoft de acuerdo a las
instrucciones de PeopleSoft. Aunque requiera un despliegue completo de la
arquitectura PeopleSoft con un servidor de aplicaciones PeopleSoft como mínimo y
un servidor de procesos, reducirá los requisitos de software y las dependencias de
la estación de trabajo del agente ampliado. No hay necesidad de instalar la
conectividad de la base de datos en la estación de trabajo que aloja al agente
ampliado. Además, no hay requisitos de personalización para el servidor de
procesos, como había con PeopleTools versión 7.x, y no habrá necesidad de
ejecutar scripts adicionales del trasladador de datos para la personalización de la
base de datos. El servidor de aplicaciones debe estar activo para enviar
satisfactoriamente los trabajos al planificador de procesos de PeopleSoft.
Para configurar correctamente el método de acceso, deberá obtener la siguiente
información del administrador de PeopleSoft:
Figura 25. Ventana Data Mover
74 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
v Nombre de host (o dirección IP) del servidor de aplicaciones
v Puerto Jolt del servidor de aplicaciones (normalmente 9000)
v Nombre de servidor de procesos
El ID de operador debe tener otorgada la autorización de utilizar la interfaz del
componente en el entorno PeopleTools.
Configuración del cliente
Para ejecutar el agente ampliado con un entorno PeopleTools 8.1x, debe instalar el
soporte de PeopleSoft External API en la estación de trabajo Tivoli Workload
Scheduler que aloje el agente ampliado.
La instalación de PeopleSoft External API debe realizarse antes de la instalación de
Tivoli Workload Scheduler for Applications para PeopleSoft.
Los manuales de instalación de PeopleSoft contienen información acerca de este
paso de la instalación. Consulte la documentación de PeopleSoft adecuada para
obtener instrucciones actualizadas, dependiendo de la versión real de Peoplesolft.
Para PeopleTools 8.17 deberá invocar el ejecutable setup.exe ubicado en el
directorio del servidor de archivos PeopleSoft 8 denominado
%PS_HOME%\setup\PsExtAPI.
Anote el directorio en el que instala External API, ya que lo necesitará durante la
instalación del agente ampliado y durante la configuración cuando se le solicite el
directorio PSHome o cuando se le pida el directorio raíz de Cobol.
Antes de utilizar External API, verifique la instalación tal como indican las
instrucciones de PeopleSoft, utilizando la herramienta jnitest.exe ubicada en el
directorio External API. La herramienta jnitest.exe verifica si dispone de MicroSoft
Java Virtual Machine for Java 3.2 versión 5.00.3167 o posterior. Si jnitest.exe
encuentra una versión aceptable, puede cargarse MicroSoft Java Virtual Machine.
De lo contrario, puede tener dificultades para cargarla correctamente. External API
no funcionará a menos que disponga de la versión correcta de MicroSoft Java
Virtual Machine.
También deberá rearrancar la estación de trabajo antes de poder utilizar la
instalación de PeopleSoft External API satisfactoriamente. Si no puede hacer esto,
cuando se envíe un trabajo PeopleSoft mediante ITWS, aparecerá una ventana
emergente de TVPUPSFT.exe que indicará:
"La aplicación no ha podido inicializarse correctamente (0xc0000005).
Haga clic en Aceptar para terminar la aplicación."
Configuración del entorno PeopleSoft para la versión 8.4x
Para PeopleTools Versión 8.4x ya no existe una instalación separada de las
PeopleSoft External API, que se entregue como parte del cliente Windows estándar;
se pueden acceder mediante el servidor de archivos PeopleSoft en el directorio
denominado PS_HOME\bin\client\winx86. Además, de acuerdo a PeopleSoft
Resolution ID 704309, debe:
v Poder acceder al directorio denominado PS_HOME\class que contiene el archivo
psjoa.jar.
v Tener acceso a una Java Virtual Machine (JVM) válida.
Capítulo 11. Tareas posteriores a la instalación 75
Nota: La JVM que se proporciona con este producto no es válida para esta
finalidad. Debe utilizar una JVM soportada por PeopleSoft.
El método psagent.exe se ocupará de definir y actualizar las variables de entorno
CLASSPATH y PS_HOME si aún no están definidas en el entorno en el que se
inicia el trabajo. Si el entorno de la ruta del sistema ya contiene un acceso válido a
jvm.dll, no necesita ninguna configuración adicional del entorno. Sino, debe
especificar una nueva opción en el archivo psagent.opts con un editor de texto,
para que psagent.exe pueda actualizar la ruta de dónde JVM está ubicada. Para
ello, agregue al archivo de opciones la línea siguiente:
TWSXA_PT84_JVMPATH=<ruta de jvm.dll>
PeopleSoft ya proporciona JVM válidas con los servidores de aplicaciones que dan
soporte a la arquitectura PIA, por ejemplo, ″BEA WebLogic Server″ (en el
subdirectorio jdk131\jre\bin\classic o jdk131\jre\bin\hotspot) o ″IBM
WebSphere Application Server″ (en el subdirectorio Java13\jre\bin\classic). Por
ejemplo, puede actualizar el archivo de opciones con una de las siguientes líneas:
v TWSXA_PT84_JVMPATH=D:\Archivos de programa\IBM\Java13\jre\bin\classic
v TWSXA_PT84_JVMPATH=D:\bea\jdk131\jre\bin\classic
v TWSXA_PT84_JVMPATH=D:\bea\jdk131\jre\bin\hotspot
Si no tiene esta palabra clave o si no tiene una ruta del sistema válida para
jvm.dll, recibirá uno de estos mensajes:
v AWS140020078E Se ha encontrado una excepción en el archivo TVPUPSFT.cpp(#)
durante la función Main
v AWS140020076E El problema encontrado puede estar relacionado con los valores
de entorno, verifique lo siguiente:
1) La ruta contiene un directorio de Java Virtual Machine válido o el archivo
de opciones contiene TWSXA_PT84_JVMPATH
2) La variable de entorno CLASSPATH contiene una ruta válida para psjoa.jar
3) El Servidor de aplicaciones de destino está activado y en ejecución
4) ha definido la variable de entorno PS_HOME
76 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 12. Definición de trabajos PeopleSoft
Este capítulo ofrece información de la definición de trabajos utilizando el agente
ampliado para PeopleSoft.
Creación de definiciones de trabajo Peoplesoft en Tivoli Workload
Scheduler
Se necesitan definiciones de trabajos Tivoli Workload Scheduler para cada trabajo
Peoplesoft que piense controlar. Un trabajo Tivoli Workload Scheduler se asocia a
un trabajo Peoplesoft ya definido y su definición incluye:
v Nombre del trabajo
v Nombre del propietario
v Especificaciones de archivo de script
v Opciones de recuperación
Consulte el apartado Capítulo 5, “Definición de trabajos de agente ampliado”, en la
página 37 como referencia.
Parámetros de cadena de tarea para trabajos PeopleSoft
Este apartado describe los parámetros de cadena de tarea que rigen la ejecución de
trabajos PeopleSoft. Debe especificarlos en los lugares siguientes al definir sus
trabajos Tivoli Workload Scheduler asociados:
v En el campo Comando de la página Tarea de la ventana Propiedades -
Definición de trabajo, si utiliza Job Scheduling Console.
v Como argumentos de la palabra clave scriptname en la sentencia de definición
del trabajo, si utiliza la línea de comandos de Tivoli Workload Scheduler.
v Como argumentos de la palabra clave JOBCMD en la sentencia JOBREC de
SCRIPTLIB de Tivoli Workload Scheduler for z/OS, si realiza la planificación en
un entorno global. Tenga en cuenta que en este caso toda la cadena de caracteres
que sigue a la palabra clave JOBCMD debe ir encerrada entre comillas dobles.
La tabla siguiente lista los parámetros.
Tabla 12. Parámetros de cadena de tarea para trabajos PeopleSoft.
Parámetro Descripción Versión de PeopleTools
-operator El ID del operador de
PeopleSoft que inicia el
trabajo.
7.x, 8.1x
-process El nombre del proceso para
el trabajo PeopleSoft.
7.x, 8.1x, 8.4x
-type El tipo de proceso para el
trabajo PeopleSoft. Esta
entrada debe ir encerrada
entre comillas simples.
7.x, 8.1x, 8.4x
-runcontrol El ID de control de ejecución
para el trabajo PeopleSoft.
7.x, 8.1x, 8.4x
-outputdest El destino de la salida del
trabajo PeopleSoft.
8.1x, 8.4x
© Copyright IBM Corp. 2000, 2003 77
Tabla 12. Parámetros de cadena de tarea para trabajos PeopleSoft. (continuación)
Parámetro Descripción Versión de PeopleTools
-outputtype El tipo de salida del trabajo
PeopleSoft. Los valores
válidos son:0 (Cualquiera)
1 (Ninguno)
2 (Archivo)
3 (Impresora)
4 (Ventana)
5 (Correo electrónico)
6 (Web)
7 (predeterminado)
8.1x, 8.4x
-outputformat El formato de la salida del
trabajo PeopleSoft. Los
valores válidos son:Ninguno
CSV
DOC
Predeterminado
HP
HTM
LP
OTRO
PS
RPT
RTF
SPF
TXT
WKS
XLS
8.1x, 8.4x
-runlocationdescr El planificador de procesos
PeopleSoft a cargo del
proceso del trabajo
PeopleSoft.
8.1x, 8.4x
-foldername El nombre de la carpeta de
informes utilizada para este
trabajo. La carpeta ya debe
haberse creado utilizando
PeopleSoft Report Manager.
8.4x
Nota: No se realiza ninguna comprobación de sintaxis de los valores de control de
salida, (outputdest, outputtype, outputformat y foldername). Si no se
reconocen los valores, se utilizan los predeterminados.
El siguiente es un ejemplo de una especificación completa de cadena de tarea para
un trabajo Peoplesoft 8.1x:
-operator PS -process XRFWIN -type ’SQR Report’ -runcontrol 1 -runlocationdescr PSNT
Configuración de dependencias de apertura de 7.x solamente
Puede configurar dependencias de apertura de Tivoli Workload Scheduler en los
trabajos PeopleSoft. Las dependencias de apertura de Tivoli Workload Scheduler se
correlacionan con un comando “select count” mediante una cláusula “where” en la
base de datos PeopleSoft. Este SQL comprueba básicamente que los valores que
78 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
seleccione existan en la base de datos. Si las entradas especificadas existen en la
base de datos, la cuenta devolverá un valor y el trabajo se ejecutará. Si las entradas
especificadas no existen en la base de datos, la cuenta devolverá un 0 y no se
permitirá la ejecución del trabajo. Un resultado de cero es falso; cualquier otro
valor es verdadero.
Nota: Al crear dependencias de apertura en Job Scheduling Console, la tabla se
lista bajo el cuadro de texto del archivo y la columna y los datos se listan
como calificadores en el cuadro de texto de calificadores
Por ejemplo:
opens /PSSERVERSTAT
da como resultado el siguiente comando SQL:
select count(*) from PSSERVERSTAT;
Esto devuelve una cuenta de las filas de PSSERVERSTAT. Un resultado de cero es
falso; cualquier otro valor es verdadero.
Otro ejemplo es:
opens /PSSERVERSTAT ("SERVERNAME = ’PSNT’ AND SERVERSTATUS = 3")
Esto da como resultado el siguiente comando SQL:
select count(*) from PSSERVERSTAT where SERVERNAME = ’PSNT’ AND SERVERSTATUS = 3;
Éste devuelve una cuenta de las filas de PSSERVERSTAT para el servidor PSNT,
donde el estado es 3 (en ejecución).
Para configurar una dependencia de apertura en un trabajo:
1. Edite la secuencia de trabajos donde desea agregar una dependencia de
apertura en modo de línea de comandos.
2. Agregue la siguiente cadena de caracteres de comando al trabajo:
cpu#job opens /tabla(“columna = ‘datos’”)
donde:
tabla Especifica el nombre de la tabla PeopleSoft que desea abrir.
columna
Especifica el nombre de la comuna que está buscando.
datos Especifica los datos de esa columna que coinciden con su búsqueda.3. Guarde los cambios que ha realizado y cierre la secuencia de trabajos.
Nota: Los datos de tabla que está buscando deben ir entre comillas dobles.
Ejemplo de dependencias de apertura
La siguiente secuencia de trabajos contiene ejemplos de dependencias de apertura.
Este es el primer ejemplo:
SCHEDULE PS_CPU#TEST01
ON EVERYDAY
:
PS_CPU#XRFWIN1
PS_CPU#XRFAPF1
PS_CPU#XRFPNP1 FOLLOWS XRFAPF1
PS_CPU#SYSAUDT1 FOLLOWS XRFWIN1
Capítulo 12. Definición de trabajos PeopleSoft 79
PS_CPU#PTPTEDT1 OPENS /PSPRCSRQST ("PRCSTYPE = ’SQR Report’ AND RUNSTATUS = 9")
PS_CPU#XRFILD1 FOLLOWS XRFPNP1,PTPTEDT1
PS_CPU#DDDAUDT1 FOLLOWS PTPTEDT1,TEST02.@
PS_CPU#TLS7011 FOLLOWS TEST02.@,DDDAUDT1
END
Este es otro ejemplo:
SCHEDULE PS_CPU#TEST02
ON EVERYDAY
AT 1330
:
PS_CPU#XRFWIN2 OPENS /PSSERVERSTAT ("SERVERNAME = ’PSNT’ AND SERVERSTATUS = 3")
PS_CPU#XRFAPF2 FOLLOWS TEST01.XRFAPF1
PS_CPU#XRFPNP2 FOLLOWS XRFAPF2
PS_CPU#SYSAUDT2 FOLLOWS XRFWIN2
PS_CPU#PTPTEDT2 OPENS /PSPRCSRQST ("PRCSTYPE = ’SQR Report’ AND RUNSTATUS = 9
AND PRCSNAME = ’DDDAUDIT’")
PS_CPU#XRFILD2 FOLLOWS XRFPNP2,PTPTEDT2
PS_CPU#DDDAUDT2
END
Correlación de estados de trabajos IBM Tivoli Workload Scheduler y
PeopleSoft
Cuando Tivoli Workload Scheduler inicia un trabajo PeopleSoft, puede supervisar
su evolución con Job Scheduling Console. A continuación, se indican las
transiciones de estado en IBM Tivoli Workload Scheduler y los estados
correspondientes en PeopleSoft.
Estado en PeopleSoft
Estado en IBM Tivoli
Workload Scheduler Descripción
CANCEL CANCEL/ABEND Un operador de PeopleSoft o el
método ha marcado para cancelación
la petición de proceso. El método lo
hará en respuesta a una tarea TJ.
DELETE CANCEL Un operador de PeopleSoft ha
marcado para supresión la petición de
proceso.
ERROR FAIL El intento de iniciar ha fallado por
alguna razón. En este caso la petición
de proceso nunca ha empezado la
ejecución realmente.
HOLD HOLD No se puede elegir el inicio del
proceso. Puede ser debido a
dependencias no satisfechas.
QUEUED READY Preparado para el inicio.
INITIATED INIT Se está intentando iniciar.
PROCESSING EXEC El proceso está en ejecución.
CANCELLED CANCEL/ABEND* El proceso se ha cancelado.
SUCCESSFUL SUCC La ejecución ha sido satisfactoria.
NOT SUCCESSFUL ABEND La ejecución ha fallado.
Notas:
1. Los procesos que se cancelan en PeopleSoft, terminarán de forma anómala si ya
se están ejecutando. La correlación de estados de IBM Tivoli Workload
80 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Scheduler debe reflejarlo. Un proceso cancelado que nunca se ha iniciado debe
ser CANCEL en Tivoli Workload Scheduler. Un proceso que se ha iniciado debe
ser ABEND.
2. Una petición de proceso marcada para supresión en el planificador de procesos
nunca puede elegirse para el inicio. El registro se borra de la tabla durante un
proceso de mantenimiento regular. Para el proceso de jnextday, estas peticiones
deben considerarse como no existentes.
Capítulo 12. Definición de trabajos PeopleSoft 81
82 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Parte 4. Método de acceso de R/3
© Copyright IBM Corp. 2000, 2003 83
84 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 13. Introducción
IBM Tivoli Workload Scheduler for Applications para R3 ofrece la posibilidad de
crear, planificar y controlar trabajos R/3 utilizando las funciones de planificación
de trabajos de Tivoli Workload Scheduler.
Funciones
Con IBM Tivoli Workload Scheduler for Applications para R3, puede realizar lo
siguiente:
v Utilice los controles y las dependencias de trabajos estándar de Tivoli Workload
Scheduler en los trabajos R/3.
v Cree trabajos R/3 utilizando la interfaz Tivoli Workload Scheduler.
v Planifique los trabajos R/3 para que se ejecuten en los días y horas especificados
y en el orden prescrito.
v Defina las interdependencias entre los trabajos PeopleSoft y los trabajos Tivoli
Workload Scheduler que se ejecutan en diferentes aplicaciones como, por
ejemplo, PeopleSoft y Oracle.
v Defina las interdependencias entre los trabajos R/3 y los trabajos que se ejecutan
en plataformas diferentes.
v Defina las opciones de soporte de Idioma nacional.
v Defina cómo utilizar las funcionalidades del soporte de R/3 Business
Warehouse.
v Personalice los códigos de retorno de ejecución de trabajos.
v Utilice grupos de inicio de sesión de R/3 para el equilibrio de la carga y la
tolerancia a errores.
v Trabaje con las variantes y los espacios reservados de R/3.
v Explote el soporte de la interfaz BC-XBP 2.0.
Proceso de planificación para el agente ampliado R/3
Tivoli Workload Scheduler inicia trabajos en R/3 mediante trabajos definidos para
ejecutarse en una estación de trabajo de agente ampliado Tivoli Workload
Scheduler. Una estación de trabajo de agente ampliado R/3 se define como una
estación de trabajo Tivoli Workload Scheduler que está alojada en una estación de
trabajo FTA o maestra que utiliza el método de acceso r3batch. La estación de
trabajo de agente ampliado R/3 utiliza el método de acceso r3batch para pasar
información específica de trabajo R/3 a instancias de R/3 predefinidas. El método
de acceso utiliza la información proporcionada en un archivo de opciones, que se
explica más adelante en esta guía, para conectar e iniciar trabajos en una instancia
de R/3. Pueden definirse numerosas estaciones de trabajo de agente ampliado para
que utilicen el mismo host; esto se hace utilizando las entradas de múltiples
opciones o archivos de múltiples opciones. Los trabajos R/3 definidos en Tivoli
Workload Scheduler deben corresponder a los trabajos existentes en el entorno
R/3. Mediante la utilización del nombre de agente ampliado R/3 como clave,
r3batch utiliza el archivo de opciones correspondiente para determinar la instancia
de R/3 que ejecutará el trabajo. Hace una copia de un trabajo plantilla en R/3 y lo
marca para que pueda ejecutarse con una hora de inicio de iniciar
inmediatamente. Finalmente, supervisa el trabajo hasta su terminación y graba la
© Copyright IBM Corp. 2000, 2003 85
evolución del trabajo y la información de estado en una lista estándar de trabajo
que se encuentra en la estación de trabajo host.
Para obtener más información acerca de la gestión de trabajos, consulte la
publicación IBM Tivoli Workload Scheduler - Guía de consulta SH19-4556.
Soporte de la interfaz XBP 2.0
Tivoli Workload Scheduler for Applications para R3 da soporte completo de la
interfaz XBP 2.0. Esto le brinda las siguientes ventajas:
v Hacer un seguimiento de los trabajos secundarios.
Un trabajo Tivoli Workload Scheduler permanece en estado EXEC hasta que se ha
completado todo su árbol de trabajos R/3. Los registros de los trabajos R/3 se
recuperan y almacenan en stdlist de Tivoli Workload Scheduler, junto con las
listas de spool de todos sus pasos ABAP.
v Interceptar los trabajos R/3.
Los trabajos planificados por usuarios R/3 se pueden interceptar antes de su
ejecución, basándose en los atributos del trabajo. Un trabajo ″Recopilador de
interceptaciones″ se planifica periódicamente como un comando de Unix o
Windows. En cada ejecución, recopila los trabajos R/3 interceptados y los envía
al plan actual basándose en una plantilla.
v Todos los atributos de trabajo se conservan al volver a ejecutar los trabajos.
Se eliminan las limitaciones que implican parámetros de impresión/archivado y
clases de trabajo junto con el uso de copias anteriores de los trabajos que se
vuelven a ejecutar.
v Pasos de comandos externos.
Consulte el apartado “Utilización del soporte de XBP 2.0” en la página 98 para ver
los detalles.
86 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 14. Instalación
Este apartado contiene información sobre la instalación de IBM Tivoli Workload
Scheduler for Applications para R3.
Requisitos de software
Para instalar IBM Tivoli Workload Scheduler for Applications para R3, debe
ejecutar lo siguiente:
v IBM Tivoli Workload Scheduler Versión 7.0 o posterior o IBM Tivoli Workload
Scheduler for z/OS global.
v R/3 Versión 3.1g, 3.1h, 3.1i, 4.0x, 4.5x, 4.6x, 4.7, 6.10 ó 6.20.
v Para las versiones anteriores a 6.20, el paquete de soporte (Support Package) de
R/3 adecuado que se indica en la tabla siguiente:
Tabla 13. Paquetes de soporte de R/3.
Versiones de R/3 Notas de R/3
R/3 3.1x 393708, 430087, 357924, 517672
R/3 4.0x 393708, 430087, 111696, 357924, 517672
R/3 4.5x 148436, 172245, 326202, 326752, 393708,
399449, 357924, 517672
R/3 4.6x 326752, 352606, 399449, 453135, 435111,
357924, 517672, 610480
R/3 4.7 610480
R/3 6.10 399449, 435111, 453135, 357924, 517672,
610480
Nota: Las notas 399449 y 430087 de R/3 resuelven los problemas de los
parámetros de impresión. Las notas 357924, 517672 y 519137 son
independientes del release.
Visión general de la instalación
La siguiente es una visión general de los pasos de instalación del método de acceso
de Tivoli Workload Scheduler for Applications para R/3. Antes de instalar el
método de acceso, asegúrese de que Tivoli Workload Scheduler esté correctamente
instalado en la estación de trabajo host.
1. En el sistema que será el host del agente ampliado para R/3 realice los pasos
siguientes:
a. Si la plataforma donde realiza la instalación es Compaq Tru64, siga las
instrucciones descritas en el apartado “Instalación en plataformas de 2
niveles” en la página 88. De lo contrario, siga las instrucciones descritas en
el apartado Capítulo 2, “Instalación de IBM Tivoli Workload Scheduler for
Applications”, en la página 5.2. Instale los ABAP de r3batch en el sistema R/3. Para hacerlo:
a. Inicie la sesión en la instancia de R/3 como Administrador base o usuario
con autorizaciones correctas.
b. Importe los archivos de corrección y transporte.
© Copyright IBM Corp. 2000, 2003 87
Instalación en plataformas de 2 niveles
1. Inicie la sesión como root y vaya al directorio inicioTWS.
2. Extraiga el software del CD-ROM de instalación:
tar xvf ruta_cd/TWS4APPS_R3BATCH_OSF.TAR
donde ruta_cd es el nombre de ruta de la unidad de CD-ROM.
3. Verifique que r3setup y r3btar.Z se hayan extraído satisfactoriamente en el
directorio actual.
4. Ejecute el script r3setup para descomprimir los archivos, realice la
configuración inicial y cree el archivo r3options:
/bin/sh r3setup -new|-update
donde:
-new
Especifica una nueva instalación. -update
Especifica que está realizando la instalación sobre una versión instalada
previamente.
Se le solicitará que especifique la información que se indica abajo. Consulte el
apartado Capítulo 20, “Archivos de opciones del método de acceso de R/3”, en
la página 119 para ver más detalles.
v El nombre del usuario Tivoli Workload Scheduler, si es diferente del valor
predeterminado (valor predeterminado: maestro).
v El directorio donde debe instalarse el agente ampliado (escriba la ruta para
inicioTWS).
v El Usuario de inicio LJuser (predeterminado: maestro). Se trata del nombre de
usuario Tivoli Workload Scheduler que ejecuta r3batch. Debe ser una cuenta
UNIX válida.
v El Usuario de información IFuser (predeterminado: maestro). Se trata del
nombre de usuario Tivoli Workload Scheduler que recupera la información
del trabajo. IFuser debe ser igual a LJuser.
v El tipo de definición del trabajo JobDef (predeterminado: r3batch). Se trata
del tipo de interfaz de definición de trabajos Tivoli Workload Scheduler.
Puede ser:
a. r3batch (predeterminado). Proporciona una interfaz de definición de
trabajos específica para trabajos R/3.
b. maestrogen o en blanco. Proporciona la interfaz de definición de trabajos
estándar sin ningún campo de entrada específico de R/3.v El nombre de CPU del host para la definición de agente ampliado Tivoli
Workload Scheduler.
v El nombre de host del servidor de aplicaciones R/3.
v Si desea especificar un host de gateway R/3 separado, escriba NO.
v El ID de tres caracteres del sistema R/3 (por ejemplo: OSS o TRN).
v El número de dos dígitos de instancia de R/3 (por ejemplo: 00 ó 01).
v El número de tres dígitos de cliente R/3 (por ejemplo: 100 ó 900).
v El ID de usuario de R/3 para las llamadas RFC (por ejemplo: rfcuser)
v La contraseña para el ID de usuario RFC de R/3.
v El nivel de auditoría de la interfaz R/3 (predeterminado: 0)
v Si desea definir el idioma de inicio de sesión de SAP R/3 para el agente
ampliado en este sistema R/3 (predeterminado No)
88 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
v Si desea definir otra instancia del agente ampliado. Si responde Sí, se le pide
que facilite otro conjunto de parámetros. Se inserta una entrada adicional en
el archivo de opciones de R/3.5. Abra Tivoli Job Scheduling Console o el programa Composer y cree una
definición de estación de trabajo en Tivoli Workload Scheduler para cada
instancia de R/3.
Cifrado de contraseñas de usuario R/3
Al agregar las entradas al archivo de opciones, el valor de r3pass se cifra
automáticamente antes de grabarse en el archivo. Si modifica el archivo con un
editor de texto, debe ejecutar el programa enigma para cifrar la contraseña antes
de grabarla en el archivo. Ejecute el comando de cifrado de la forma siguiente:
enigma [contraseña]
Puede incluir la contraseña en la línea de comandos o escribirla como respuesta a
una solicitud. El programa devolverá la versión cifrada que podrá especificar en el
archivo de opciones.
Capítulo 14. Instalación 89
90 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 15. Configuración de R/3
Para comunicar y controlar la ejecución de trabajos en sistemas R/3 utilizando el
método de acceso para R/3, debe realizar los siguientes pasos de configuración en
el entorno R/3.
Los pasos que se describen en este capítulo requerirán un Administrador BASIS de
R/3.
Visión general
Esta es una visión general del procedimiento de personalización:
1. Cree un nuevo ID de usuario de RFC en R/3 para Tivoli Workload Scheduler.
2. Cree el perfil de autorización, tal como se describe en el apartado “Creación del
perfil de autorización para el usuario Tivoli Workload Scheduler”.
3. Copie los archivos de corrección y transporte del servidor Tivoli Workload
Scheduler en el servidor R/3.
4. Importe los archivos de corrección y transporte a R/3 y verifique la instalación.
Nota: El procedimiento de importación sólo agrega nuevos módulos de función de
ABAP/4 y varias tablas internas nuevas al sistema R/3. No modifica
ninguno de los objetos existentes.
Creación del usuario RFC de IBM Tivoli Workload Scheduler
Para que Tivoli Workload Scheduler se comunique con R/3, debe crear un ID de
usuario en R/3 para el proceso por lotes de Tivoli Workload Scheduler. Por
razones de seguridad, utilice un nuevo ID de usuario en lugar de uno existente.
1. Cree un nuevo ID de usuario RFC.
2. Otorgue a este nuevo ID de usuario RFC los siguientes atributos:
v El tipo de usuario CPIC o Comunicaciones, dependiendo del release de R/3.
v Una contraseña de como mínimo seis caracteres de longitud. Tivoli Workload
Scheduler necesita esta contraseña para iniciar o supervisar trabajos R/3. Si
esta contraseña cambia en R/3, debe actualizar el archivo de opciones que
r3batch utiliza con la nueva contraseña.
v Asigne los perfiles de seguridad adecuados, dependiendo de la versión de
R/3.
Creación del perfil de autorización para el usuario Tivoli Workload
Scheduler
Hay dos formas alternativas de realizar esta tarea:
v Mediante la utilización de la transacción SU02 y la creación manual del perfil.
v Mediante la utilización del Generador de perfiles (transacción PFCG).
Utilización de la transacción SU02 y creación manual del perfil
Siga el procedimiento siguiente:
1. Escriba un nombre de perfil, por ejemplo, Z_TWS, y una descripción.
© Copyright IBM Corp. 2000, 2003 91
2. Agregue manualmente las autorizaciones de acuerdo a la tabla siguiente:
Objeto Descripción Autorización
S_ADMI_FCD Autorizaciones del sistema S_ADMI_ALL
S_BTCH_ADM Proceso de fondo:
Administrador de fondo
S_BTCH_ADM
S_BTCH_JOB Proceso de fondo:
Operaciones en trabajos de
fondo
S_BTCH_ALL
S_BTCH_NAM Proceso de fondo: Nombre
de usuario de fondo
S_BTCH_ALL
S_PROGRAM ABAP: comprobaciones de
ejecución de programas
S_ABAP_ALL
S_RFC Comprobación de
autorización para el acceso
RFC
S_RFC_ALL
S_SPO_ACT Spool: Acciones S_SPO_ALL
S_SPO_DEV Spool: Autorizaciones de
dispositivo
S_SPO_DEV_AL
S_XMI_LOG Autorizaciones de acceso
interno para el registro XMI
S_XMILOG_ADM
S_XMI_PROD Autorización para interfaces
de gestión externas (XMI)
S_XMI_ADMIN
Las autorizaciones están ubicadas en la clase de objeto ″Base: Administración″.
Dependiendo de la versión de R/3, es posible que la autorización S_RFC_ALL
esté ubicada en la clase de objeto ″Objetos de autorización de aplicaciones
cruzadas″ u ″Objetos de autorización no específica de aplicación″.
3. Guarde el perfil.
4. Vaya a la ventana de mantenimiento del usuario y asigne el perfil al usuario
R/3 de Tivoli Workload Scheduler.
5. Guarde los datos de usuario.
Utilización de la transacción PFCG (Generador de perfiles)
Siga el procedimiento siguiente:
1. Escriba un nombre, por ejemplo ZTWS, en Nombre de rol.
2. Haga clic en Crear rol y escriba una descripción para el rol como, por
ejemplo, ″Rol para el usuario TWS″.
3. Guarde el rol.
4. Seleccione la pestaña Autorizaciones.
5. Haga clic en Cambiar datos de autorización.
6. En la ventana emergente que aparecerá, seleccione Plantillas.
7. Agregue manualmente los siguientes objetos de autorización:
Objeto Descripción
S_ADMI_FCD Autorizaciones del sistema
S_BTCH_ADM Proceso de fondo: Administrador de fondo
S_BTCH_JOB Proceso de fondo: Operaciones en trabajos de fondo
92 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Objeto Descripción
S_BTCH_NAM Proceso de fondo: Nombre de usuario de fondo
S_PROGRAM ABAP: Comprobaciones de ejecución de programas
S_RFC Comprobación de autorización para el acceso RFC
S_SPO_ACT Spool: Acciones
S_SPO_DEV Spool: Autorizaciones de dispositivo
S_XMI_LOG Autorizaciones de acceso interno para el registro
XMI
S_XMI_PROD Autorización para interfaces de gestión externas
(XMI)
8. Cumplimente los valores según el esquema siguiente:
S_ADMI_FCD Autorizaciones del sistema
v Función de administración del sistema:
Autorización completa
S_BTCH_ADM Proceso de fondo: Administrador de fondo
v ID de administrador de fondo: Autorización
completa
S_BTCH_JOB Proceso de fondo: Operaciones en trabajos de fondo
v Operaciones de trabajo: Autorización completa
v Resumen de trabajos para un grupo:
Autorización completa
S_BTCH_NAM Proceso de fondo: Nombre de usuario de fondo
v Nombre de usuario de fondo para comprobación
de autorización: Autorización completa
S_PROGRAM ABAP: Comprobaciones de ejecución de programas
v Programa ABAP/4 de acciones de usuario:
Autorización completa
v Programa ABAP/4 de grupo de autorizaciones:
Autorización completa
S_RFC Comprobación de autorización para el acceso RFC
v Actividad: Autorización completa
v Nombre de RFC que debe protegerse:
Autorización completa
v Tipo de objeto RFC que debe protegerse:
Autorización completa
S_SPO_ACT Spool: Acciones
v Campo de autorización para acciones de spool:
Autorización completa
v Valor para la comprobación de autorización:
Autorización completa
S_SPO_DEV Spool: Autorizaciones de dispositivo
v Spool - Nombres largos de dispositivo:
Autorización completa
Capítulo 15. Configuración de R/3 93
S_XMI_LOG Autorizaciones de acceso interno para el registro
XMI
v Método de acceso para el registro XMI:
Autorización completa
S_XMI_PROD Autorización para interfaces de gestión externas
(XMI)
v Inicio de sesión XMI - Nombre de compañía:
TIVOLI*
v Inicio de sesión XMI - Nombre de programa:
MAESTRO*
v ID de interfaz: Autorización completa.
9. Guarde las autorizaciones.
10. Genere un perfil. Utilice el mismo nombre que ha escrito en Nombre de rol.
11. Salga de la ventana de gestión de autorizaciones y seleccione la pestaña
Usuario.
12. Agregue el usuario Tivoli Workload Scheduler al rol.
13. Guarde el rol.
Copia de los archivos de corrección y transporte
El archivo de configuración carga dos archivos de corrección y transporte en el
directorio inicial de Tivoli Workload Scheduler. Debe copiar esos archivos de
corrección y transporte en el servidor R/3 e importarlos a la base de datos R/3, de
la manera siguiente.
1. En el servidor de bases de datos R/3, inicie la sesión en el sistema R/3 como
administrador.
2. Copie el archivo de control y el archivo de datos del directorio
inicioTWS\methods en los directorios siguientes del servidor de bases de datos
R/3:
copy archivocontrol /usr/sap/trans/cofiles/
copy archivodatos /usr/sap/trans/data/
Los nombres de archivocontrol y archivodatos varían de un release a otro. Los
archivos están instalados en el directorio inicioTWS\methods y tienen los
siguientes nombres de archivo y formato: K000xxx.TV1 (archivo de control) y
R000xxx.TV1 (archivo de datos), donde xxx es un valor relacionado con el
release.
Importación de módulos ABAP/4 a R/3
Este procedimiento genera, activa y confirma nuevos módulos de función ABAP/4
en el sistema R/3 y varias tablas internas nuevas. No se modifican los objetos
existentes en el sistema R/3.
1. Vaya al siguiente directorio:
cd /usr/sap/trans/bin
2. Agregue el archivo de transporte al búfer:
tp addtobuffer transporte ids
donde:
transporte
es el archivo de petición de transporte. ids
94 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
es el ID del sistema R/3.
Bajo el directorio inicioTWS\methods, podrá encontrar un archivo denominado
K000xxx.TV1, por lo que la petición de transporte será tv1K000xxx.
3. Ejecute el comando tp tst para probar la importación:
tp tst transporte ids
Después de ejecutar este comando, examine los archivos de registro del
directorio /user/sap/trans/log para ver si hay mensajes de error. Los avisos de
nivel de gravedad 4 son normales.
Si existen errores, realice una comprobación con una persona experimentada en
la corrección y el transporte, o intente utilizar modos no condicionales para
realizar la importación.
4. Ejecute el comando siguiente para importar todos los archivos del búfer:
tp import transporte ids
Este comando genera los nuevos módulos ABAP/4 y los confirma en la base de
datos R/3. Se activan automáticamente.
Después de ejecutar este comando, examine los archivos de registro del
directorio /user/sap/trans/log para ver si hay mensajes de error. Los avisos de
nivel de gravedad 4 son normales.
Si encuentra un problema, utilice el modo no condicional cuando ejecute este
paso:
tp import transporte ids U126
5. Cuando se complete la importación, compruebe los archivos de registro para
verificar que la importación haya sido satisfactoria. Los archivos de registro
están en el directorio /usr/sap/trans/log.
Instalación de los módulos ABAP de r3batch en el sistema R/3
Instale los módulos ABAP de r3batch en el sistema R/3. Para ver los detalles
acerca de la instalación de módulos ABAP de r3batch, consulte Capítulo 15,
“Configuración de R/3”, en la página 91. Este capítulo incluye instrucciones para
crear un usuario RFC e instalar los módulos ABAP siguientes:
J_1O1_BDC_STATUS
J_1O1_DATE_TIME
J_1O1_JOB_ABAP_STEP_MODIFY
J_1O1_JOB_ADD_ABAP_STEP
J_1O1_JOB_ADD_EXTPGM_STEP
J_1O1_JOB_CLOSE
J_1O1_JOB_COPY
J_1O1_JOB_DEFINITION_GET
J_1O1_JOB_DELETE
J_1O1_JOB_EXTPGM_STEP_MODFY
J_1O1_JOB_FIND
J_1O1_JOB_FINDALL
J_1O1_JOB_HAS_EXTENDED_VARIANT
J_1O1_JOB_LOG
J_1O1_JOB_LOG_READ
J_1O1_JOB_OPEN
J_1O1_JOB_START
J_1O1_JOB_STATUS
J_1O1_JOB_STATUS_CHECK
J_1O1_JOB_STOP
J_1O1_RAISE_EVENT
J_1O1_REPORT_ALL_SELECTIONS
J_1O1_REPORT_DYNSEL_GET_DEF
J_1O1_REPORT_GET_TEXTPOOL
J_1O1_TABLE_GET_NAMETAB
J_1O1_VARIANT_COPY
Capítulo 15. Configuración de R/3 95
J_1O1_VARIANT_COPY_4X
J_1O1_VARIANT_CREATE
J_1O1_VARIANT_CREATE_NEW
J_1O1_VARIANT_DELETE
J_1O1_VARIANT_DELETE_NEW
J_1O1_VARIANT_EXISTS
J_1O1_VARIANT_GET_DEFINITION
J_1O1_VARIANT_GET_DEF_NEW
J_1O1_VARIANT_GET_HELP_VALUES
J_1O1_VARIANT_INFO_GET
J_1O1_VARIANT_MAINTAIN_CNT_TBL
J_1O1_VARIANT_MAINTAIN_SEL_TBL
J_1O1_VARIANT_MODIFY
J_1O1_VARIANT_MODIFY_NEW
Resolución de problemas
Si no puede enviar trabajos R/3 utilizando Tivoli Workload Scheduler después de
la configuración de R/3, realice las pruebas siguientes:
v Asegúrese de que puede ejecutar ping en el sistema R/3 desde el sistema Tivoli
Workload Scheduler. Esto mostrará la conectividad básica de red.
v Tenga en cuenta que al utilizar los direccionadores R/3 para acceder al sistema
R/3 se podría sobrepasar el tamaño de los búferes internos de la biblioteca RFC
utilizados para almacenar el nombre de host del sistema R/3. Cuando se
produce esto, el nombre de host se trunca, lo que provoca que falle la conexión
con el sistema R/3. Para solucionar este problema, no califique completamente el
nombre de los direccionadores R/3 o utilice, de forma alternativa, las direcciones
IP.
v Ejecute el siguiente comando telnet para verificar la conectividad:
telnet nombresistema 33xx
donde nombresistema es el nombre del sistema o la dirección IP del servidor R/3
y xx es la instancia de R/3.
v Inicie la sesión en el sistema R/3 como administrador y verifique que existe el
usuario RFC de Tivoli Workload Scheduler RFC (creado en el apartado
“Creación del usuario RFC de IBM Tivoli Workload Scheduler” en la página 91).
v Cree un nuevo trabajo IBM Tivoli Workload Scheduler para que se ejecute en
R/3, y agregue las siguientes opciones avanzadas:
-debug
-trace
Estas opciones se seleccionan utilizando botones de selección de la página
Propiedades - Tarea de definición de trabajos en Job Scheduling Console.
Si se utiliza la opción -debug, se incluye información de depuración adicional
en el archivo stdlist del trabajo (en Tivoli Workload Scheduler).
Cuando se utiliza la opción -trace, se crea un archivo de rastreo en el
directorio inicial de Tivoli Workload Scheduler. En UNIX, este archivo de
rastreo se denomina dev_rfc. En Windows, el archivo se denomina
rfcxxxxx_xxxxx.trc. Asegúrese de que suprime la opción de rastreo del
trabajo después de haber realizado los procedimientos de depuración. El
archivo de rastreo puede aumentar mucho de tamaño y llegar a ser imposible
de manejar.
Nota: Normalmente estas opciones son para la depuración del agente
ampliado y no deben utilizarse en la producción estándar.v Si por alguna razón el gateway R/3 trunca la cadena de caracteres de
conexión, sustituya el nombre IP por la dirección IP.
v Si realiza la instalación en un sistema AIX que no utiliza el inglés de EE.UU.,
debe instalar el entorno del idioma de EE.UU. en la estación de trabajo IBM
96 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Tivoli Workload Scheduler y la estación de trabajo de la base de datos R/3.
De lo contrario el error BAD TEXTENV (o un mensaje de error similar) puede
aparecer en el archivo de rastreo dev_rfc y las conexiones con R/3 fallarán.
Cambio de la contraseña del ID de usuario RFC de Tivoli Workload
Scheduler
Si se modifica la contraseña de un ID de usuario RFC de Tivoli Workload
Scheduler después de la instalación inicial, debe actualizarse con este cambio el
archivo de opciones que r3batch utiliza.
En UNIX, inicie la sesión como root en el sistema en el que Tivoli Workload
Scheduler está instalado.
En Windows, inicie la sesión como administrador e inicie un shell DOS en el
sistema en el que Tivoli Workload Scheduler está instalado, de la siguiente manera:
1. Genere una versión cifrada de la nueva contraseña utilizando el comando
enigma en inicioTWS/methods. Para ello, escriba en un shell de comandos:
enigma nuevacontraseña
donde nuevacontraseña es la nueva contraseña para el ID de usuario de RFC de
Tivoli Workload Scheduler.
El comando enigma imprime una versión cifrada de la contraseña.
2. Copie la contraseña cifrada en el archivo de opciones, que está ubicado en el
directorio inicioTWS/methods. El archivo puede editarse con cualquier editor de
texto.
Asegúrese de copiar la contraseña exacta, conservando las mayúsculas, las
minúsculas y los signos de puntuación. La contraseña cifrada tiene un aspecto
similar al siguiente:
#TjM-pYm#-z82G-rB
Si se escribe incorrectamente la contraseña cifrada, Tivoli Workload Scheduler no
podrá iniciar ni supervisar los trabajos por lotes de R/3.
Migración desde versiones anteriores
Esta versión del agente ampliado Tivoli Workload Scheduler para R/3 da soporte a
todas las versiones de R/3 indicadas en la Tabla 13 en la página 87. Para conseguir
un certificado XBP de R/3 para R/3 versiones 4.0 y 4.5, deben realizarse unos
cuantos cambios en el agente de planificación. El agente ampliado Tivoli Workload
Scheduler para R/3 versión 4.x utiliza las interfaces RFC de R/3 oficiales para la
planificación de trabajos. Éstas son:
v La interfaz SXMI_XBP para R/3 versiones 3.1g a 4.0x
v La interfaz BAPI_XBP a partir de la versión 4.5a
Para evitar conflictos con otros proveedores, los módulos ABAP de Tivoli
Workload Scheduler pertenecen ahora al espacio de nombres de asociado de Tivoli
Workload Scheduler J_1O1_xxx. Después de haber completado las importaciones
tal como se describe en el apartado “Importación de módulos ABAP/4 a R/3” en
la página 94, se instalan los módulos de función RFC J_1O1_xxx en el sistema.
Si dispone de una instalación anterior del agente ampliado Tivoli Workload
Scheduler para R/3 en el sistema, puede suprimir los siguientes módulos de
función del sistema R/3:
Capítulo 15. Configuración de R/3 97
Z_MAE2_BDC_STATUS
Z_MAE2_DATE_TIME
Z_MAE2_JOB_COPY
Z_MAE2_JOB_DELETE
Z_MAE2_JOB_FIND
Z_MAE2_JOB_FINDALL
Z_MAE2_JOP_OPEN
Z_MAE2_JOB_LOG
Z_MAE2_JOB_START
Z_MAE2_JOB_STATUS
Z_MAE2_JOB_STOP
Se trata de versiones anteriores de las funciones Tivoli ABAP, que pertenecen al
espacio de nombres de cliente. También puede suprimir el grupo de funciones
YMA3. No es necesario suprimir los módulos de función y el grupo de funciones,
pero deberá hacerlo si desea limpiar el sistema.
Utilización del soporte de XBP 2.0
La interfaz SAP para la planificación de trabajos externa (BC-XBP) se ha ampliado
recientemente para eliminar las limitaciones que los clientes y asociados han
informado. Se suministra mediante Basis Support Packages para todos los releases
de R/3 empezando por WAS 4.6B.
Se han eliminado las limitaciones siguientes:
v La clase de trabajo ya no se limita a C
v Están disponibles todos los parámetros de impresión
Se han agregado las funciones siguientes:
v Relación primario-secundario
v Interceptación de trabajos
v Soporte para trabajos con pasos de comandos externos
Compruebe y aplique las siguientes notas SAP antes de utilizar la interfaz XBP 2.0:
v 602683
v 612564
v 604496
Creación del perfil de autorización para el usuario Tivoli
Workload Scheduler
Hay dos maneras alternativas de agregar el objeto de autorización relacionado al
perfil de autorizaciones del usuario Tivoli Workload Scheduler:
v Utilización de la transacción SU02
v Utilización del Generador de perfiles
Utilización de la transacción SU02
Agregue el objeto siguiente:
Objeto Descripción Autorización
S_RZL_ADM CCMS: Administrador del sistema S_RZL_ALL
Utilización del Generador de perfiles
Siga el procedimiento siguiente:
98 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
1. Agregue manualmente el objeto siguiente:
Objeto Descripción
S_RZL_ADM CCMS: Administrador del sistema
2. Establezca el valor del campo actividad en Autorización completa.
Problemas de parámetros de impresión y clase de trabajo
El agente ampliado para R/3 utiliza las interfaces RFC oficiales de R/3 Versiones
4.x hasta 6.20 para la planificación de trabajos. Cuando se migra desde versiones
anteriores de R/3, pueden surgir problemas con los parámetros de impresión en
los trabajos iniciados por Tivoli Workload Scheduler. Esto es debido a las
limitaciones de las interfaces RFC.
Estas limitaciones ya no existen con XBP 2.0.
La tabla siguiente muestra los parámetros de impresión soportados por BAPI XBP
1.0.
Parámetro de
impresión 3.1x 4.0x
4.5x y posterior
dispositivo de salida U U U
imprimir
inmediatamente
U U U
suprimir después de
la salida
U U U
número de copias U U U
modalidad del
archivado
U U U
autorización U U U
selección de página
de cubierta
x U U
página de cubierta
sap
U U U
período de retención
en spool
U U U
destinatario x x U
líneas x x U
columnas x x U
Para resolver la pérdida de los parámetros de impresión durante la copia de
trabajos, instale el paquete de soporte de R/3 adecuado, tal como se indica en las
notas 399449 y 430087 de R/3.
Se aplica lo mismo a la clase de trabajo. Las interfaces oficiales de R/3 sólo
permiten trabajos de clase C. La instalación del paquete de soporte de R/3 también
resuelve este problema.
Capítulo 15. Configuración de R/3 99
100 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 16. Definición de trabajos de agente ampliado R/3
Para controlar la ejecución de los trabajos en la estación de trabajo R/3 desde
Tivoli Workload Scheduler debe definir lo siguiente:
v Los trabajos R/3 que desea ejecutar bajo el control de Tivoli Workload Scheduler.
Puede definir estos trabajos utilizando las herramientas estándar de R/3 o las
ventanas específicas de SAP de Job Scheduling Console.
v Los trabajos Tivoli Workload Scheduler que corresponden a los trabajos R/3. Las
definiciones de los trabajos Tivoli Workload Scheduler se utilizan en la
planificación y definición de las dependencias, pero los trabajos R/3 se ejecutan
realmente.
Definición de un trabajo en R/3
Para crear trabajos R/3 controlados por Tivoli Workload Scheduler, puede utilizar
una de las opciones siguientes:
v Las herramientas estándar de R/3 para definir trabajos
v Las ventanas específicas de SAP de Job Scheduling Console.
Consulte la documentación de R/3 para obtener información sobre la creación de
trabajos con las herramientas de R/3. Al crear trabajos en R/3, no asigne una hora
de inicio ni especifique ninguna dependencia. Éstas se especifican y controlan en
Tivoli Workload Scheduler. El trabajo se identifica en Tivoli Workload Scheduler
por su nombre y ID de trabajo R/3. Puede planificarse el mismo trabajo para que
Tivoli Workload Scheduler lo ejecute repetidamente sin tener que volverlo a definir
cada vez en R/3.
Nota: Para los trabajos R/3 controlados por Tivoli Workload Scheduler, la salida
del registro de trabajo R/3 se encontrará bajo el nombre de usuario definido
en la opción r3user del archivo de opciones.
Definición de un trabajo en Tivoli Workload Scheduler
Para definir el trabajo Tivoli Workload Scheduler, puede utilizar uno de los
elementos siguientes:
v Tivoli Job Scheduling Console.
v La línea de comandos de Tivoli Workload Scheduler.
v Los diálogos ISPF de Tivoli Workload Scheduler for z/OS, si piensa planificar el
trabajo en un entorno global.
Consulte el apartado Capítulo 5, “Definición de trabajos de agente ampliado”, en la
página 37 como referencia.
Los procedimientos descritos en el Capítulo 5, “Definición de trabajos de agente
ampliado”, en la página 37 son comunes a todos los agentes ampliados Tivoli
Workload Scheduler. El agente ampliado para R/3 ofrece uno adicional mediante
Job Scheduling Console.
En Job Scheduling Console, al seleccionar el tipo de tarea para una nueva
definición de trabajo, puede elegir entre dos tipos:
© Copyright IBM Corp. 2000, 2003 101
Tarea de agente ampliado
Es común a todos los agentes ampliados. Si elige esta opción:
v El trabajo R/3 asociado ya debe estar definido en la base de datos R/3 y
debe conocer su nombre.
v Puede utilizar el campo Comando de una de las ventanas de definición
de trabajos para especificar varios parámetros a fin de ejecutar el trabajo
R/3.
v Las estaciones de trabajo de agente ampliado que ha definido para R/3
(especificando r3batch como método de acceso) se listan como
estaciones de trabajo de agente ampliado genérico.
SAP Es específico para los trabajos de agente ampliado R/3. Si elige esta
opción:
v Podrá definir o actualizar el trabajo R/3, así como las variantes SAP o
parámetros para ejecutar el trabajo, en las ventanas de Job Scheduling
Console como si estuviera utilizando R/3.
v Las estaciones de trabajo de agente ampliado R/3 se consideran
estaciones de trabajo R/3. No aparecen en las listas de estaciones de
trabajo de agentes ampliados genéricos que se visualizan cuando se hace
clic en los puntos suspensivos situados junto al campo Estación de
trabajo. Debe conocer el nombre para escribirlo en un campo.
Para que se visualice SAP como tarea opcional en Job Scheduling Console, debe
establecer la opción jobdef en r3batch del archivo de opciones r3batch.opts
(ubicado en el subdirectorio methods de inicioTWS ) del maestro de Tivoli Workload
Scheduler.
Para obtener información sobre cómo definir un trabajo de agente ampliado R/3
utilizando la ventana Tarea de agente ampliado, consulte el Capítulo 5,
“Definición de trabajos de agente ampliado”, en la página 37. Para obtener
información sobre cómo definir un trabajo de agente ampliado R/3 utilizando las
ventanas de tareas de SAP, consulte el siguiente apartado.
Utilización de las ventanas específicas de SAP de Job
Scheduling Console
Para crear una definición de trabajo en la base de datos Tivoli Workload Scheduler
para un trabajo R/3, efectúe los pasos siguientes:
1. En la lista Acciones de la ventana principal de Job Scheduling Console,
seleccione Nueva definición de trabajo.
2. Seleccione un motor Tivoli Workload Scheduler y desde la lista resultante haga
clic en SAP. Se visualizará la ventana Propiedades - Definición de trabajo.
102 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
3. En la página General se define el trabajo Tivoli Workload Scheduler que
dirigirá el trabajo R/3. Complete los campos siguientes:
a. En el campo Nombre, especifique un nombre de Tivoli Workload Scheduler
para el trabajo R/3. El nombre puede contener ocho caracteres
alfanuméricos o 40 caracteres alfanuméricos si utiliza la opción de base de
datos expandida. El nombre del trabajo debe empezar por una letra.
b. En el campo Estación de trabajo, haga clic en el botón de puntos
suspensivos (...) para abrir la ventana Buscar y seleccionar una estación de
trabajo disponible.
c. En el campo Descripción, escriba una descripción del trabajo. Este campo es
una descripción de texto opcional del trabajo y puede tener hasta 64
caracteres alfanuméricos.
d. En el campo Inicio de sesión, escriba el ID de inicio de sesión de Tivoli
Workload Scheduler que se utiliza para ejecutar el trabajo.
e. Haga clic en Agregar parámetro para agregar cualquier parámetro
predefinido al ID de inicio de sesión.
f. En los campos Opciones de recuperación, especifique cualquier opción de
recuperación para el trabajo R/3. Consulte la publicación IBM Tivoli Workload
Scheduler - Guía de consulta para obtener información acerca de las opciones
de recuperación.4. Seleccione Tarea. Se visualizará la página Tarea.
Figura 26. Propiedades - Definición de trabajo
Capítulo 16. Definición de trabajos de agente ampliado R/3 103
En esta página, se entran las especificaciones del trabajo R/3 que el trabajo
Tivoli Workload Scheduler va a dirigir, definidas en la página anterior. También
puede utilizar esta página para crear trabajos R/3 estándar (pero no
InfoPackages ni Process Chains) en el sistema SAP.
5. Para especificar un trabajo R/3 existente:
a. En la página Tarea, especifique el tipo de trabajo y haga clic en los puntos
suspensivos (...) junto al campo Nombre de trabajo. Se visualizará la
ventana Lista de selección SAP.
b. Utilice la lista de selección para buscar y seleccionar un trabajo R/3 y haga
clic en Aceptar. La información de trabajo se visualiza en los elementos
siguientes de la página Tarea:
v El campo Nombre del trabajo
v El campo ID de trabajo
v El botón Tipo de trabajo R/3
Si el tipo es Trabajo R/3 estándar, podrá editarlo y ver sus detalles y estado.
Si el tipo de trabajo es Business Warehouse Info Package o Process Chain,
sólo podrá ver sus detalles.6. Para crear un trabajo R/3 estándar:
a. En la página Tarea, seleccione Trabajo R/3 estándar y haga clic en Nuevo.
Se visualizará la página Trabajo R/3 de la ventana Definición de trabajo
SAP.
Figura 27. Propiedades - Tarea de definición de trabajo
104 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
b. En la página Trabajo R/3, especifique la información acerca del trabajo que
está creando:
1) Escriba un nombre para el trabajo R/3 en el campo Nombre del trabajo.
2) Deje en blanco el campo ID de trabajo. El sistema R/3 le asignará un ID
cuando guarde la definición de trabajo.
3) Escriba el nombre de la estación de trabajo R/3 donde se ejecutará este
trabajo en el campo Host de destino.
4) Haga clic en Pasos para abrir la página siguiente.
Figura 28. Página Trabajo R/3 de la ventana Definición de trabajo SAP.
Capítulo 16. Definición de trabajos de agente ampliado R/3 105
c. En la página Pasos se especifica uno o varios ABAP o los programas
externos para el trabajo R/3. Repita los pasos siguientes para todos los
pasos que deba definir:
1) Haga clic en el botón Agregar fila para agregar una fila a la tabla de
pasos.
2) Haga doble clic en el campo Tipo y seleccione si va a ser un ABAP o un
programa externo.
3) En el campo Nombre, entre un nombre de ABAP o una ruta
completamente calificada y nombre de archivo de un programa externo.
4) En el campo Usuario, escriba el nombre del usuario R/3 que ejecuta este
paso.
5) En el campo Variantes/Parámetros, escriba un nombre de variante o un
parámetro, si es necesario. Las variantes se utilizan con los ABAP y los
parámetros se utilizan con los programas externos, pero ambos son
opcionales. No todos los ABAP requieren variantes y no todos los
programas externos requieren parámetros. Un botón de puntos
suspensivos (...) estará disponible junto al campo para visualizar una
lista de las variantes asociadas al ABAP. Puede utilizar esta lista para
seleccionar una variante, así como para crear o cambiar definiciones de
Figura 29. Página Pasos de la ventana Definición de trabajo SAP.
106 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
variantes. Consulte la “Definición o actualización de las variantes de
R/3 desde Job Scheduling Console” para ver los detalles.
6) En el campo Host de destino, especifique la estación de trabajo R/3
donde se ejecuta este paso. Los host de destino sólo son necesarios para
los programas externos.
7) Escriba los parámetros de impresión y las especificaciones de los
indicadores de control de acuerdo a los requisitos de R/3.d. Cuando haya terminado de crear el ABAP o los pasos de programa externo,
haga clic en Aceptar. La definición de trabajo R/3 se guarda en la base de
datos R/3 y se cierra la ventana. Si el trabajo R/3 se ha guardado
satisfactoriamente en la base de datos R/3, la página Propiedades - Tarea de
definición de trabajo debe visualizar un ID de trabajo R/3.7. Haga clic en Aceptar en la ventana Propiedades - Definición de trabajo para
guardar la definición del trabajo en la base de datos Tivoli Workload Scheduler.
Definición o actualización de las variantes de R/3 desde Job
Scheduling Console
La acción de hacer clic en los puntos suspensivos situados junto al campo
Variantes/Parámetros de la ventana Definición de trabajo SAP visualiza la ventana
Lista de variantes. Esta ventana lista todas las variantes asociadas al ABAP
indicado en el campo Nombre de la Definición de trabajo SAP y se parece a la que
se representa en la figura siguiente.
En esta ventana, además de otras acciones, puede crear o actualizar variantes. Para
ello, haga clic en Nuevo o Editar. Se visualizará una ventana Marco de variante
similar a esta (si la acción que realiza es editar, los campos y las selecciones no
estarán vacíos):
Figura 30. Ventana Lista de variantes.
Capítulo 16. Definición de trabajos de agente ampliado R/3 107
En la página Información de variante, haga lo siguiente:
1. Escriba/modifique el nombre de variante y descripción.
2. Opcionalmente, marque un cuadro Propiedades:
De fondo
La variante sólo puede utilizarse en el proceso de fondo.
Protegido
La variante se protege para que otros usuarios no puedan cambiarla.
Invisible
La variante no se visualizará en la lista de valores F4 de la SAP GUI.
Ampliado
Permite utilizar espacios reservados y contadores como valores de
variante. Si marca este cuadro, el botón Contador estará disponible.
Para las variantes ampliadas, puede utilizar espacios reservados y contadores
que eliminen la tarea, susceptible de errores, de ajustar valores y minimizar
espectacularmente el esfuerzo de mantenimiento de variantes. Tivoli Workload
Scheduler preprocesa los espacios reservados y los contadores y los valores se
ajustan automáticamente cuando se inicia el trabajo. Los espacios reservados y
los contadores son:
Tabla 14. Espacios reservados y contadores para variantes ampliadas.
Símbolo Significado Sintaxis
$S Indicación de la hora AAAAMMDDHHMM
$D Día del mes DD
$_D Fecha AAAAMMDD
$M Mes MM
Figura 31. Página Información de variante de la ventana Lista de variantes.
108 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Tabla 14. Espacios reservados y contadores para variantes ampliadas. (continuación)
Símbolo Significado Sintaxis
$Y Año AA
$_Y Año AAAA
$H Hora HH
$T Minuto MM
$_T Hora HHMMSS
$Nx Contadores 10 contadores: $N0 - $N9
($N = $N0)
$(expresión de fecha) Expresión de fecha Como el comando datecalc.
Encerrada entre $( y ).
$[expresión aritmética] Expresión aritmética Expresiones aritméticas que
permiten operaciones +, −, *
y / entre enteros y
contadores.
En la página Valores de variante, los campos y los valores se crean dinámicamente
mediante r3batch dependiendo de las características de la variante o paso y son
idénticos a los contenidos en la ventana SAP equivalente.
Parámetros de cadena de tarea para trabajos R/3
Este apartado describe los parámetros de cadena de tarea que dirigen la ejecución
de trabajos R/3. Debe especificarlos en los lugares siguientes al definir sus trabajos
Tivoli Workload Scheduler asociados:
v En el campo Comando de la página Tarea de la ventana Propiedades -
Definición de trabajo, si utiliza Job Scheduling Console y seleccione Tarea de
agente ampliado (y no SAP) para una nueva definición de trabajo.
v Como argumentos de la palabra clave scriptname en la sentencia de definición
del trabajo, si utiliza la línea de comandos de Tivoli Workload Scheduler.
v Como argumentos de la palabra clave JOBCMD en la sentencia JOBREC de
SCRIPTLIB de Tivoli Workload Scheduler for z/OS, si realiza la planificación en
un entorno global.
La sintaxis de cadena de caracteres es el siguiente:
-job nombre_trabajo ( -user nombre_usuario | -i (id_trabajo|ipack_|pchain_) )
[-client cliente_def] [-exec_client cliente_ejec] [-debug] [-trace]
Los parámetros se describen en la tabla siguiente.
Tabla 15. Parámetros de cadena de tarea para trabajos R/3.
Parámetro Descripción
-job nombre_trabajo
El nombre de la tarea que debe ejecutarse.
Es un nombre de trabajo R/3, un nombre
de campo técnico InfoPackage o un
nombre ProcessChain. Este parámetro es
obligatorio.
Capítulo 16. Definición de trabajos de agente ampliado R/3 109
Tabla 15. Parámetros de cadena de tarea para trabajos R/3. (continuación)
Parámetro Descripción
-user nombre_usuario
El usuario R/3 que es propietario del
trabajo de destino. Este parámetro sólo
puede utilizarse cuando el sistema R/3 de
destino sólo tenga un trabajo con el
nombre especificado para el usuario
especificado. No tiene ningún efecto con
trabajos InfoPackage o ProcessChain, ni
tampoco si se ha especificado un ID de
trabajo en la definición de trabajo.
-i id_trabajo
Uno de los elementos siguientes:
v El ID de trabajo R/3 exclusivo, si el
trabajo de destino es estándar.
v ipack_, si el trabajo de destino es
InfoPackage.
v pchain_, si el trabajo de destino es
ProcessChain.
Los parámetros -user, -client y
-exec_client no tendrán efecto, si
especifica un ID de trabajo. Para los
trabajos InfoPackage y ProcessChain, este
parámetro es obligatorio.
-client cliente_def
El número que identifica el cliente R/3
donde debe encontrarse la definición del
trabajo, sin tener en cuenta el número de
cliente definido por la clave r3client en el
archivo de opciones. Este parámetro no
tiene ningún efecto en trabajos
InfoPackage o ProcessChain, ni tampoco si
un ID de trabajo se ha especificado en la
definición de trabajo.
-exec_client cliente_ejec
El número que identifica el cliente R/3
donde debe ejecutarse el trabajo, sin tener
en cuenta el número de cliente
especificado por la clave r3client en el
archivo de opciones. Este parámetro no
tiene ningún efecto en trabajos
InfoPackage o ProcessChain, ni tampoco si
un ID de trabajo se ha especificado en la
definición de trabajo.
-debug
Activa el rastreo de r3batch más detallado.
-trace
Activa el rastreo de SAP RFC.
Notas:
1. Puede especificar -i y -user en la misma definición de trabajo, pero se pasará
por alto el nombre de usuario.
2. Cuando especifique el ID de trabajo, -client y -exec_client se pasarán por
alto ya que el ID es exclusivo para todo el sistema R/3.
El siguiente es un ejemplo para un trabajo R/3 denominado BVTTEST con el ID
03102401 y el usuario miusuario:
-job BVTTEST –i 03102401 -debug
110 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
El siguiente es un ejemplo para un trabajo InfoPackage cuyo campo técnico es
ZPAK_3LZ3JRF29AJDQM65ZJBJF5OMY:
-job ZPAK_3LZ3JRF29AJDQM65ZJBJF5OMY -i ipak_
Estados de trabajos Tivoli Workload Scheduler y R/3
Cuando Tivoli Workload Scheduler inicie un trabajo R/3, podrá supervisar su
evolución. Las transiciones de estado en Tivoli Workload Scheduler (estado
interno) y el estado R/3 correspondiente se indican en la tabla siguiente.
Estado de trabajo Tivoli Workload Scheduler Estado de trabajo R/3
INTRO N/A
WAIT Ready (Listo)
EXEC Active (Activo)
SUCC Finished (Terminado)
ABEND Canceled (Candelado)
El estado INTRO indica que Tivoli Workload Scheduler está introduciendo el
trabajo, pero en R/3, el trabajo no ha entrado todavía en estado preparado. Como
se tarda en poner un trabajo en cola y en la columna preparado, el estado INTRO
puede durar unos minutos si el sistema R/3 está muy ocupado.
Aunque un trabajo haya finalizado en R/3, Tivoli Workload Scheduler lo
mantendrá en el estado EXEC si sus sesiones BDC no se han completado y no ha
seleccionado la opción Inhabilitar espera BDC. Para utilizar esta opción, consulte
el Capítulo 21, “Espera BDC”, en la página 127.
Capítulo 16. Definición de trabajos de agente ampliado R/3 111
112 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 17. Volver a ejecutar trabajos
Antes de volver a ejecutar un trabajo R/3 con Tivoli Workload Scheduler, tiene la
opción de facilitar un nombre de paso para el trabajo. Al hacerlo, afectará a r3batch
de la siguiente manera: si el nombre de paso tiene el formato “xnnnnnn” o
“nnnnnnn” (donde “x” es un carácter que no es dígito y “n” es un carácter dígito),
se utiliza como número de paso de inicio para el trabajo R/3 que se vuelve a
ejecutar.
En todos los demás casos, este valor no tiene ningún efecto en el trabajo que se
vuelve a ejecutar. El trabajo se vuelve a ejecutar empezando desde el primer paso.
Sólo cuando r3batch vuelva a ejecutar un trabajo desde su primer paso, porque el
usuario lo haya especificado como paso de inicio o porque no se haya especificado
ningún paso de inicio, utilizará la función de copia nueva si se puede aplicar. Si el
paso de inicio es superior a uno, r3batch utilizará la copia anterior para volver a
ejecutar el trabajo.
El apartado siguiente explica la diferencia principal entre la copia nueva y la
anterior de un trabajo que se vuelve a ejecutar.
Copia anterior y copia nueva de un trabajo que se vuelve a ejecutar
Cuando el método de acceso para R/3 debe iniciar un trabajo, hace una copia de
un trabajo plantilla y la ejecuta.
La función de copia nueva está disponible para las versiones 3.1i y posteriores de
R/3. Copia todo el trabajo, conservando los pasos, la clase de trabajo y todos los
parámetros de impresión y archivado. Se realiza utilizando un nuevo módulo de
función R/3 que forma parte del paquete de soporte de R/3 tal como indican las
notas 399449 y 430087 de R/3.
Por el contrario, la función de copia anterior, basada en los módulos de función
estándar de R/3, crea un nuevo trabajo R/3 y agrega los pasos con un bucle que
empieza desde el nombre de paso o número que haya especificado. Tenga en
cuenta que, a menos que tenga soporte de XBP 2.0:
v La copia anterior no conserva todos los parámetros de impresión y archivado.
v La clase de trabajo de la copia siempre se establece en la clase ″C″.
Consulte el apartado “Problemas de parámetros de impresión y clase de trabajo”
en la página 99 para obtener más información sobre cómo resolver el problema de
la pérdida de la clase de trabajo y los parámetros de impresión y archivado.
© Copyright IBM Corp. 2000, 2003 113
114 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 18. Business Information Warehouse
Soporte de Business Information Warehouse - InfoPackages
Business Information Warehouse (BIW) es una solución de depósito de datos
adaptada a R/3. Permite el soporte de informe de actividad y decisiones.
Autorizaciones de usuario
Tivoli Workload Scheduler for Applications para R3 puede gestionar R/3 BIW Info
Packages y Process Chains. Para utilizar la funcionalidad BIW de R/3, debe definir
un usuario R/3 Tivoli Workload Scheduler en R/3 que necesitará las
autorizaciones adicionales siguientes:
Las autorizaciones de la tabla siguiente sólo son necesarias si desea utilizar las
funcionalidades de agente ampliado Business Warehouse.
Objeto Texto Autorización
S_DEVELOP Trabajo ABAP E_ABAP_ALL
Nota: Además del perfil Z_MAESTRO, debe agregarse el perfil S_RS_ALL al
usuario Tivoli Workload Scheduler.
Componentes de Business Warehouse
R/3 sólo da soporte a dos componentes BIW principales, InfoPackages y Process
Chains.
InfoPackage es el punto de entrada para el proceso de carga desde un componente
InfoSource específico (contenedor lógico de fuente de datos, generalmente
denominado InfoObject). Técnicamente, InfoPackage es un trabajo SAP real cuyo
fin es cargar datos. Como cualquier otro trabajo R/3, contiene parámetros
específicos del trabajo como, por ejemplo, la hora de inicio, las dependencias,
etcétera.
Process Chain es una cadena compleja de diferentes procesos y sus relaciones. Los
procesos de una cadena de procesos no se limitan a los procesos de carga de datos
o InfoPackages, sino que también incluyen:
v Ejecución de cambio de atributos/jerarquía
v Acumulación de agregaciones
v Programa ABAP
v Otra cadena de procesos
v Proceso de creación de cliente
Definición de trabajos de agente ampliado para BIW
InfoPackages y Process Chains sólo se pueden crear desde el entorno R/3. Sin
embargo, la función de nivel 1.3 de Job Scheduling Console soporta listas de
selección de InfoPackages y Process Chains, por lo que ahora puede definir
trabajos de agente ampliado Tivoli Workload Scheduler también para estos objetos.
© Copyright IBM Corp. 2000, 2003 115
Consulte el apartado “Utilización de las ventanas específicas de SAP de Job
Scheduling Console” en la página 102 para obtener información sobre cómo definir
trabajos de agente ampliado mediante las ventanas SAP de Job Scheduling
Console.
Consulte el Capítulo 5, “Definición de trabajos de agente ampliado”, en la página
37 para obtener información sobre cómo definir los trabajos de agente ampliado
mediante las ventanas Tarea de agente ampliado de Job Scheduling Console o con
Composer.
Consulte el apartado “Parámetros de cadena de tarea para trabajos R/3” en la
página 109 para conocer los parámetros de cadena de tarea para especificar
InfoPackages y Process Chains al definir un trabajo de agente ampliado mediante
las ventanas Tarea de agente ampliado de Job Scheduling Console o con Composer.
Opciones de planificación R/3 de InfoPackage
Para poder planificar InfoPackages mediante IBM Tivoli Workload Scheduler, las
opciones de planificación de InfoPackage deben ajustarse de la manera siguiente:
v El tipo de inicio debe establecerse en ″Iniciar después en proceso de fondo″.v La hora de inicio debe ser ″inmediatamente″
116 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 19. Conexión al sistema R/3
Tivoli Workload Scheduler for Applications para R3 utiliza la biblioteca SAP RFC
(llamada de conexión remota) para conectarse al sistema R/3. La dirección de
conexión para un sistema R/3 se indica como una cadena de conexión.
Conexiones a un servidor de aplicaciones específico
En su formato básico, una cadena de conexión consta de un nombre de host (o
nombre IP) de un servidor de aplicaciones R/3; por ejemplo:
/H/hemlock.tivlab.raleigh.ibm.com
Este tipo de cadena de conexión sólo funciona en entornos de red muy simples,
donde se puede llegar a todos los servidores de aplicaciones directamente,
mediante TCP/IP. Normalmente, las compañías modernas utilizan topologías de
red más complejas, con varias subredes pequeñas, que no pueden comunicarse
directamente mediante TCP/IP. Para dar soporte a este tipo de redes, la biblioteca
SAP RFC da soporte a los denominados direccionadores SAP, que se colocan en los
límites de las subredes y actúan como proxies. Para este tipo de redes, la cadena
de conexión es un compuesto de cadenas de conexión básicas para cada
direccionador SAP, seguidas por la cadena de conexión básica para el sistema R/3
de destino; por ejemplo:
/H/litespeed/H/amsaix33/H/hemlock.tivlab.raleigh.ibm.com
Además, es posible asegurar los direccionadores SAP con contraseñas, para evitar
el acceso no autorizado. En este caso, la cadena de conexión básica para este
direccionador SAP va seguida de /P/ y la contraseña del direccionador.
Nota: La biblioteca SAP RFC limita la longitud de la cadena de conexión a un
máximo de 128 caracteres. Este es un límite real en entornos de red
complejos. Como solución, se recomienda utilizar nombres de host simples,
sin el nombre del dominio, siempre que sea posible. De forma alternativa,
puede utilizar direcciones IP, pero no es recomendable, ya que es muy difícil
de mantener.
Tivoli Workload Scheduler for Applications para R3 da soporte a los dos tipos de
cadenas de conexión, básica y compuesta, donde:
r3host Es la cadena de conexión.
r3instance
Es el número de la instancia de R/3.
r3sid Es el ID del sistema R/3.
Por ejemplo:
r3host=/H/litespeed/H/amsaix33/H/hemlock.tivlab.raleigh.ibm.com
r3instance=00
r3sid=TV1
© Copyright IBM Corp. 2000, 2003 117
Grupos de inicio de sesión
En instalaciones grandes de R/3, normalmente los servidores de aplicaciones se
configuran en grupos de inicio de sesión para el equilibrio de la carga y la
tolerancia a errores. El equilibrio de la carga lo realiza un servidor dedicado,
denominado servidor de mensajes. El servidor de mensajes asigna
automáticamente usuarios al servidor de aplicaciones con la menor carga de
trabajo del grupo de inicio de sesión que controla.
Establezca las opciones siguientes para configurar r3batch a fin de que se conecte
al grupo de inicio de sesión:
r3host El nombre de host del servidor de mensajes.
r3group
El nombre del grupo de inicio de sesión.
r3sid El ID del sistema R/3.
Por ejemplo:
r3host=pwdf0647.wdf.sap-ag.de
r3group=PUBLIC
r3sid=QB6
118 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 20. Archivos de opciones del método de acceso de
R/3
Los archivos de opciones para el método de acceso de R/3 son los siguientes:
r3batch.opts
Un archivo de configuración común para el método de acceso r3batch,
cuyos valores afectan a todas las instancias de r3batch. Funciona como un
archivo de configuración “global”.
NOMBRECPU_r3batch.opts
Un archivo de configuración que es específico de cada estación de trabajo
de agente ampliado IBM Tivoli Workload Scheduler (aquí denominada
genéricamente “NOMBRECPU”) que utiliza el método de acceso r3batch.
Estas opciones sólo afectan a la instancia de r3batch que una estación de
trabajo en particular utiliza. Funciona como un archivo de configuración
“local”.
Por ejemplo, si desea definir dos agentes ampliados denominados estr1 y estr2
que accederán a dos sistemas R/3 (SAP1 y SAP2) con el método de acceso r3batch,
debe definir los tres archivos de configuración siguientes:
v El archivo global r3batch.opts
v El archivo local estr1_r3batch.opts
v El archivo local estr2_r3batch.opts
Nota: Si r3batch encuentra el archivo de configuración local para un agente
ampliado, pasa por alto la información contenida en r3options.
Opciones de configuración
Este apartado describe las opciones que puede configurar en r3batch.opts y en
NOMBRECPU_r3batch.opts.
Opciones globales
La tabla siguiente lista las opciones que debe colocar en el archivo de
configuración global r3batch.opts. Estas opciones sólo tienen efecto al ejecutar el
agente ampliado Tivoli Workload Scheduler en un entorno Unix.
Nota: Estas opciones sólo tienen efecto si se colocan en r3batch.opts.
Tabla 16. Opciones de configuración globales de r3batch.
Opción Descripción
job_sem_proj El ID del proyecto para el semáforo del
trabajo.
var_sem_proj El ID del proyecto para el semáforo de la
variante.
icp_sem_proj El ID del proyecto para el semáforo de
interceptación de trabajos.
© Copyright IBM Corp. 2000, 2003 119
Las opciones job_sem_project y var_sem_project son dos valores avanzados que le
permiten personalizar la sincronización entre trabajos. El sistema R/3 sincroniza el
acceso a la base de datos utilizando un sistema de gestión de bloqueos. Cuando
Tivoli Workload Scheduler for Applications para R3 está funcionando en el sistema
R/3, los módulos de función ABAP correspondientes bloquean y desbloquean
automáticamente diferentes objetos de la base de datos. Cuando se intenta
bloquear un objeto, el sistema de gestión de bloqueos sólo permite esperar un
período limitado de tiempo antes de rechazar el intento de bloqueo con un error
Cuando ocurre esto, el módulo de función actual también termina de forma de
anómala. El período de tiempo máximo en segundos para cada intento de bloqueo
se especifica en el parámetro del sistema enque/delay_max.
El código de retorno del módulo de función es demasiado general para distinguir
el desbordamiento de tiempo de espera de bloqueo máximo de otros errores de
base de datos. Por lo que, el método de acceso para R/3 no está disponible para
seguir e informa de un error. Si ocurre esto durante la ejecución de un trabajo R/3,
el trabajo se pone en estado abortar.
Esta situación empeora cuando Tivoli Workload Scheduler inicia varios trabajos
simultáneamente. Dependiendo del tiempo de espera de bloqueo máximo, varios
de ellos terminarán de forma anómala debido a la caducidad de los intentos de
bloqueo.
Para resolver este problema, Tivoli Workload Scheduler for Applications para R3
utiliza semáforos en el nivel de OS para sincronizar las llamadas de módulo de
función ABAP importantes. Esto evita el problema descrito con eficacia. Utiliza un
semáforo para las tareas relacionadas con el trabajo y otro para las tareas
relacionadas con el mantenimiento de variantes.
Para coincidir en la misma estructura IP en un entorno UNIX, los asociados de
comunicación tienen que ponerse de acuerdo en un identificador para esta
estructura. Hay varias maneras de elegir este identificador. Tivoli Workload
Scheduler for Applications para R3 utiliza dos parámetros: un nombre de ruta y un
ID de proyecto (que es un valor de carácter). El parámetro de nombre de ruta se
toma de la ruta absoluta para el archivo de opciones. El ID del proyecto se toma
de las opciones descritas en la Tabla 16 en la página 119. Si se omiten estas
opciones, Tivoli Workload Scheduler for Applications para R3 utiliza los valores
predeterminados, que funcionarán bien en la mayoría de instalaciones.
Opciones locales
La tabla siguiente lista las opciones que debe colocar en los archivos de
configuración locales.
Tabla 17. Opciones de configuración locales de r3batch.
Opción Descripción
r3client El número de cliente R/3. Esta opción es
necesaria.
r3gateway El nombre de host del gateway R/3.
r3group El nombre del grupo de inicio de sesión
R/3.
r3gwservice El número de servicio del gateway R/3.
120 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Tabla 17. Opciones de configuración locales de r3batch. (continuación)
Opción Descripción
r3host El nombre de host del servidor de mensajes
R/3 cuando se utilizan grupos de inicio de
sesión o el nombre de host del servidor de
aplicaciones en todos los demás casos. Esta
opción es necesaria.
r3instance El número de instancia R/3. Esta opción es
necesaria.
r3password La contraseña para r3user. El valor es
sensible a las mayúsculas y las minúsculas.
Esta opción es necesaria.
r3sid El ID del sistema R/3. Esta opción es
necesaria.
r3user El nombre del usuario R/3 con el que el
método de acceso se conecta al sistema R3.
Esta opción es necesaria.
r3version Fuerza al método de acceso a funcionar sólo
con sistemas R/3 que dispongan de la
versión especificada. Utilice esta opción con
cuidado.
xbpversion Fuerza al método de acceso a funcionar con
sistemas R/3 que den soporte a la versión
XBP especificada. Utilice esta opción con
cuidado.
Opciones generales
La tabla siguiente lista opciones adicionales que puede colocar en cualquier archivo
de configuración.
Tabla 18. Opciones de configuración generales de r3batch.
Opción Descripción Predeterminado
r3auditlevel El nivel de auditoría para el
XBP. Un número de 0 a 3.
3
short_interval El intervalo corto, en
segundos, para las
comprobaciones de estado.
Un valor superior a 10
segundos.
10
long_interval El intervalo largo, en
segundos, para las
comprobaciones de estado.
Valor inferior a 3600
segundos.
3600
Capítulo 20. Archivos de opciones del método de acceso de R/3 121
Tabla 18. Opciones de configuración generales de r3batch. (continuación)
Opción Descripción Predeterminado
twsxa_cp La codificación que r3batch
va a utilizar para abrir las
conexiones RFC con sistemas
R/3. Puede ser uno de estos
valores:
v 1100
v 1103
v 8000
v 8300
v 8400
1100
twsxa_lang El idioma utilizado para
iniciar la sesión en sistemas
R/3. Puede ser:
v DE para alemán
v EN para inglés
v JA para japonés
EN
twsmeth_cp La codificación que r3batch
debe utilizar para grabar su
salida. Puede ser cualquiera
de las páginas de códigos
TIS existentes.
La página de códigos local
twsmeth_lang El idioma utilizado para los
mensajes de informe.
El idioma local
utf8cmdline Un valor, 0 ó 1, que
especifica si r3batch debe
esperar parámetros
ampliados codificados en
UTF-8. Un valor de 1
significa que lo hará.
1
retry La cuenta de reintentos para
las llamadas de módulo de
función R/3. Un número
superior a 0.
5
nojobdefs Permitir/prohibir la
definición de nuevos trabajos
R/3 mediante la GUI de
Tivoli Workload Scheduler.
0
oldcopy Fuerza al método de acceso a
utilizar la manera anterior de
copiar trabajos. Especifique
un valor que no sea cero
para habilitarlo.
0
122 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Tabla 18. Opciones de configuración generales de r3batch. (continuación)
Opción Descripción Predeterminado
old_picklist_mode Esta opción sólo se aplica a
R/3 versiones 4.5 y
posteriores. Si esta opción
está inhabilitada (valor 0), la
Lista de selección de trabajos
se recupera mediante el
módulo de función
BAPI_XBP_JOB_SELECT. Si está
habilitada (valor distinto de
cero), la Lista de selección de
trabajos se recupera
mediante el módulo de
función BAPI_XBP_JOB_COUNT.
Esta opción debe
inhabilitarse ya que el
módulo de función
BAPI_XBP_JOB_COUNT se
ejecuta con problemas.
0
rfc_open_retry La cuenta de reintentos para
abrir una conexión RFC con
el sistema R/3. El valor es
un número mayor que 0 para
limitar el número de
reintentos, -1 para un
número ilimitado de
reintentos.
5
rfc_open_delay El número máximo de
segundos que debe esperarse
entre dos llamadas
consecutivas antes de abrir
una conexión RFC.
1800
log_r3syslog Si está habilitada, hace que el
método de acceso grabe las
últimas entradas del registro
del sistema R/3 en su
archivo de rastreo cuando un
RFC devuelva un error
general. Especifique ON para
habilitarla, OFF para
inhabilitarla.
OFF
rcmap Habilita las posibilidades de
correlación de Tivoli
Workload Scheduler for
Applications para R3.
Especifique ON para
habilitarla, OFF para
inhabilitarla.
ON
max_name_counter El valor máximo del
contador de nombres de
variante. Si el contador de
nombres alcanza el valor
especificado, vuelve a
empezar en 0.
40
Capítulo 20. Archivos de opciones del método de acceso de R/3 123
Tabla 18. Opciones de configuración generales de r3batch. (continuación)
Opción Descripción Predeterminado
name_counter_policy Política de contador de
nombres:
step El contador de
nombres se
incrementa en cada
paso.
job El contador de
nombres se
incrementa una vez
para el trabajo.
job
max_n0_counter Valor máximo del contador
N0. Si el contador N0 llega al
valor especificado, vuelve a
empezar desde 0.
2^15 - 1
n0_counter_policy Política del contador N0:
step El contador N0 se
incrementa en cada
paso.
job El contador N0 se
incrementa una vez
para el trabajo.
job
Uso de opciones de configuración
El formato del archivo de configuración NombreCPU_r3batch.opts es el siguiente:
opción1=valor1
opción2=valor2
opción3=valor3
...
sin espacios en blanco antes de la opción ni después del valor, ni entre ellos y el
carácter igual.
En r3batch.opts puede poner toda la información común como, por ejemplo, las
opciones LJuser, IFuser, JobDef y LogFileName, mientras que en un archivo de
configuración local (por ejemplo, estr1_r3batch.opts) puede colocar los datos
adaptados para el sistema R/3 de destino del agente ampliado (por ejemplo, SAP1).
Puede colocar una opción local en el archivo de configuración global si necesita
otorgar la misma opción a todas las instancias de r3batch. Si el nombre de usuario
R/3 es igual en todos los sistemas R/3, puede colocar la opción r3user en el
archivo global sin duplicar esa información en todos los archivos de configuración
local.
Tenga en cuenta que estos archivos de configuración no se crean durante el
proceso de instalación.
Una opción global, como job_sem_proj, sólo tiene efecto en el archivo de
configuración global, si coloca esta opción en un archivo local no tendrá ningún
efecto.
124 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
r3batch lee primero el archivo de configuración global, después el archivo local.
Por lo que todas las opciones (excepto las opciones globales) contenidas en el
archivo de configuración local prevalecerán sobre los archivos globales. Por
ejemplo, si los archivos de configuración global y local contienen la opción r3user,
r3batch utilizará el archivo local.
Hay seis opciones obligatorias que r3batch requiere; puede colocarlas todas en el
archivo de configuración local o puede separarlas entre los archivos global y local.
Por ejemplo puede colocar r3user y r3password en el archivo de configuración
global r3sid, r3instance, r3client y r3host en el local.
La opción r3user es local y obligatoria. Debe colocarse en el archivo de
configuración global o en el archivo local.
Migración de archivos de configuración
Este apartado le ofrece un ejemplo de migración de un archivo de configuración
desde r3options a varios archivos .opts locales (CPU_r3batch.opts).
Desde un archivo r3options con el siguiente contenido:
xacpu1 sap1 tv1 00 100 maestro 2QGp4-7JU5-MY2A-mX 30 300 2
xacpu1 sap2 d04 10 200 tws z57I-U5MY-2Amp-4X 30 100 2
puede crear dos archivos locales, xacpu1_r3batch.opts y xacpu2_r3batch.opts.
Este es el contenido de xacpu1_r3batch.opts:
R3host=sap1
R3sid=tv1
R3instance=00
R3client=100
R3user=maestro
R3password=2QGp4-7JU5-MY2A-mX
short_interval=30
long_interval=300
R3auditlevel=2
Este es el contenido de xacpu2_r3batch.opts:
R3host=sap2
R3sid=d04
R3client=200
R3instance=10
R3user=tws
R3password=z57I-U5MY-2Amp-4X
short_interval=30
long_interval=100
R3auditlevel=2
El siguiente script Perl ofrece un ejemplo de una migración automática.
Empezando a partir del archivo r3options, produce los archivos de configuración
local.
$r3options = "r3options";
unless (-e $r3options) {
die "Error: archivo $r3options no encontrado\n";
}
unless (-r $r3options) {
die "Error: archivo $r3options ilegible \n";
}
format OPTSFORMAT =
R3host=@<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
$host
Capítulo 20. Archivos de opciones del método de acceso de R/3 125
R3sid=@<<<
$sid
R3instance=@<<
$inst
R3client=@<<<
$client
R3user=@<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
$user
R/3password=@<<<<<<<<<<<<<<<<<
$passwd
short_interval=@<<<<
$sint
long_interval=@<<<<
$lint
R3auditlevel=@<<
$audit
.
open (INPUT, "<$r3options");
while (<INPUT>) {
if(!/^#/ && !/^(\s)+$/) {
($cpu,$host,$sid,$inst,$client,$user,$passwd,$sint,$lint,$audit)=split(/ /);
$optsfile = $cpu . "_r3batch.opts";
open (OPTSFORMAT,">$optsfile") || die "no se puede crear el archivo $optsfile";
write (OPTSFORMAT);
close OPTSFORMAT;
}
}
close INPUT;
Para utilizar este ejemplo:
1. Instale un intérprete PERL en el sistema.
2. Copie el ejemplo en un archivo que puede llamarse, por ejemplo, migrate.pl y
almacenarlo en el directorio <inicioTWS/methods.
3. Ejecute perl migrate.pl.
Los archivos de configuración locales se crearán en el directorio
<inicioTWS>/methods.
126 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 21. Espera BDC
Con la opción de espera Batch Data Collector (BDC), puede especificar que un
trabajo R/3 iniciado por IBM Tivoli Workload Scheduler no se considere finalizado
hasta que todas sus sesiones BDC se hayan completado. Esto impide que se inicien
otros trabajos IBM Tivoli Workload Scheduler que sean dependientes del trabajo
R/3 hasta que todas las sesiones BDC relacionadas para el trabajo R/3 se hayan
completado.
Para utilizar esta opción, un trabajo R/3 debe grabar mensajes informativos en su
registro de trabajos. Esto puede hacerse agregando una sentencia de mensaje al
BDCREXX del informe proporcionado por SAP, tal como se describe más abajo,
utilizando el nombre de sesión BDC (hasta 12 caracteres), o el ID de cola BDC
(hasta 20 caracteres). Se pueden grabar múltiples mensajes para permitir la
supervisión de múltiples sesiones BDC.
De forma alternativa, si no desea realizar modificaciones de R/3, también puede
copiar BDCRECXX con otro nombre, por ejemplo ZBDCRECXX, realizar los
cambios en la copia e incluirla en todos los programas que generen sesiones BDC.
Debe hacerlo manualmente para cada trabajo.
Si las sesiones BDC no se crean utilizando la transacción SM35, sino directamente
por un componente SAP, puede que no utilicen el informe BDCRECXX. En este
caso, puede realizar modificaciones en el módulo de función proporcionado por
SAP BDC_OPEN_GROUP, tal como se describe más abajo. Tenga en cuenta que
debe modificar el informe BDCRECXX (o su copia ZBDCRECXX) o el módulo de
función BDC_OPEN_GROUP. No debe modificar ambos objetos.
Nota: El estado de finalización de un trabajo R/3 iniciado por IBM Tivoli
Workload Scheduler, ya sea SUCC o ABEND, se basa completamente en el
estado de ejecución del trabajo por lotes. No está relacionado con el éxito o
la anomalía de ninguna sesión BDC, las cuales se consideran terminadas sin
tener en cuenta los errores encontrados durante el proceso BDC. Si desea
reaccionar ante los errores de una sesión BDC, puede utilizar la
funcionalidad de correlación de códigos de retorno de Tivoli Workload
Scheduler, tal como se describe en el Capítulo 28, “Biblioteca de correlación
de códigos de retorno”, en la página 181.
Utilización de nombres de sesión BDC
Para utilizar nombres de sesión BDC, modifique formulario open_group del objeto
BDCRECXX de R/3, de la manera siguiente:
v Para releases SAP anteriores a 4.6c:
form open_group.
if session = ’X’.
skip.
write: /(20) ’Create group’(i01), group.
skip.
* open batchinput group
call function ’BDC_OPEN_GROUP’
exporting client = sy-mandt
group = group
user = user
keep = keep
© Copyright IBM Corp. 2000, 2003 127
holddate = holddate.
message i001(92) with group.
write: /(30) ’BDC_OPEN_GROUP’(i02), (12) ’returncode:’(i05), sy_subrc.
endif.
endform.
v Para SAP releases 4.6c y posteriores:
form open_group.
skip.
write: /(20) ’Create group’(i01), group.
skip.
* open batchinput group
call function ’BDC_OPEN_GROUP’
exporting client = sy-mandt
group = group
user = user
keep = keep
holddate = holddate.
message i001(92) with group.
write: /(30) ’BDC_OPEN_GROUP’(i02), (12) ’returncode:’(i05), sy_subrc.
endform.
Cuando se especifiquen las sesiones BDC por el nombre, Tivoli Workload
Scheduler no esperará a que finalice la sesión BDC nombrada si hay otras sesiones
BDC completadas con el mismo nombre.
Ejemplo
Un trabajo R/3 iniciado por Tivoli Workload Scheduler inicia tres sesiones BDC
con el nombre ORD2 y emite el siguiente mensaje BDCWAIT:
BDCWAIT:ORD2
Cuando se completa la primera sesión ORD2, el estado del trabajo R/3 aparecerá
como SUCC en Tivoli Workload Scheduler. r3batch no distingue entre BDC no
exclusivos (es decir BDC con nombre).
Otro problema de utilizar sesiones BDC con nombres es la probabilidad de que las
horas del sistema sean diferentes en un entorno R/3 distribuido. r3batch explora
las sesiones BDC con los nombres especificados que se han generado durante el
tiempo de ejecución del trabajo creador. Si el trabajo creador sólo inicia las sesiones
BDC, el tiempo de ejecución es muy corto. Si no se se ha instalado la
sincronización horaria, la hora del sistema de diferentes estaciones de trabajo
normalmente difiere en un entorno R/3 distribuido. Esta diferencia horaria puede
ser mayor que el tiempo de ejecución del trabajo. Por lo tanto, es posible que se
explore un intervalo de tiempo erróneo y que las sesiones BDC no se detecten
nunca.
Por lo tanto, se recomienda encarecidamente utilizar el método de ID de cola BDC
descrito en las siguientes secciones.
Utilización de ID de cola BDC con el informe BDCRECXX
Para resolver los problemas provocados cuando las sesiones BDC se especifican
por nombre, también pueden especificarse por ID de cola, el identificador de 20
dígitos de sesión BDC. Puesto que cada ID de cola asignado por R/3 es exclusivo,
debe emitirse un mensaje BDCWAIT para cada ID de cola separado que deba
supervisarse.
128 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Para determinar el ID de cola, modifique el formulario open_group del objeto
BDCRECXX R/3, de la manera siguiente:
v Para releases SAP anteriores a 4.6c:
form open_group.
if session = ’X’.
skip.
write: /(20) ’Create group’(i01), group.
skip.
* open batchinput group
call function ’BDC_OPEN_GROUP’
exporting client = sy-mandt
group = group
user = user
keep = keep
holddate = holddate
importing qid = myquid.
message i001(92) with myqid.
write: /(30) ’BDC_OPEN_GROUP’(i02), (12) ’returncode:’(i05), sy_subrc.
endif.
endform.
v Para SAP releases 4.6c y posteriores:
form open_group.
skip.
write: /(20) ’Create group’(i01), group.
skip.
* open batchinput group
call function ’BDC_OPEN_GROUP’
exporting client = sy-mandt
group = group
user = user
keep = keep
holddate = holddate
importing qid = myquid.
message i001(92) with myqid.
write: /(30) ’BDC_OPEN_GROUP’(i02), (12) ’returncode:’(i05), sy_subrc.
endform.
No olvide de definir la variable myqid en BDCRECXX. Con este enfoque, se obtiene
un cambio global en el sistema R/3.
Utilización de los ID de cola BDC con FM BDC_OPEN_GROUP
Las sesiones BDC que no ha creado la transacción SM35, sino un componente SAP,
puede que no utilicen el informe BDCREXX. En este caso, la mejor solución para
hacer un seguimiento de estas sesiones BDC es modificar el módulo de función
BDC_OPEN_GROUP de SAP de la manera siguiente:
FUNCTION BDC_OPEN_GROUP.
...
CALL ’BDC_OPEN_GROUP’ ID ’CLIENT’ FIELD CLIENT
ID ’GROUP’ FIELD GROUP
ID ’USER’ FIELD USER
ID ’KEEP’ FIELD KEEP
ID ’HOLDDATE’ FIELD HOLDDATE
ID ’DESTINATION’ FIELD DEST
ID ’QID’ FIELD QID
ID ’RECORD’ FIELD RECORD
ID ’PROG’ FIELD PROG.
*
IF SY-SUBRC EQ 0.
BQID = QID.
BUSER = SY-MSGV1.
Capítulo 21. Espera BDC 129
BGROUP = GROUP.
* CALL FUNCTION ’DB_COMMIT’.
CALL FUNCTION ’ENQUEUE_BDC_QID’
EXPORTING DATATYP = ’BDC ’
GROUPID = BGROUP
QID = BQID
EXCEPTIONS FOREIGN_LOCK = 98
SYSTEM_FAILURE = 99.
IF SY-SUBRC EQ 0.
message i001(92) with qid.
ENDIF.
ENDIF.
*
PERFORM FEHLER_BEHANDLUNG USING SY-SUBRC.
*
*
ENDFUNCTION.
Tenga en cuenta que los parámetros reales de la llamada de la función C (CALL
‘BDC_OPEN_GROUP’ ID ...) pueden variar dependiendo del número de release de
SAP.
Con este enfoque, se obtiene un cambio global en el sistema R/3.
130 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 22. Funciones de interceptación de trabajos y
primario-secundario
Este capítulo describe cómo Tivoli Workload Scheduler for Applications da soporte
a las funciones de interceptación de trabajos y primario-secundario de BC-XBP 2.0.
Interceptación de trabajos
La interceptación de trabajos es una función de la interfaz BC-XBP 2.0. Permite que
Tivoli Workload Scheduler tenga un control muy sofisticado sobre los trabajos
iniciados por los usuarios R/3 desde la interfaz gráfica SAP.
El mecanismo de interceptación de trabajos se activa cuando el planificador de
trabajos R/3 está a punto de iniciar un trabajo R/3 (es decir, el momento en que se
satisfacen las condiciones de inicio de un trabajo R/3). Comprueba los parámetros
de los trabajos (nombre de trabajo, creador, cliente) con las entradas de la tabla
TBCICPT1 de R/3 y, cuando los parámetros del trabajo coinciden con los criterios, el
trabajo R/3 se vuelve a establecer en estado planificado y se marca con un
indicador especial, que indica que el trabajo se ha interceptado.
Si se ha configurado Tivoli Workload Scheduler para manejar la interceptación de
trabajos, ejecutará periódicamente su propio trabajo para recuperar la lista de
trabajos interceptados y los volverá a planificar. Puede hacerse referencia a este
trabajo como recopilador de interceptaciones.
Implemente los pasos siguientes para configurar Tivoli Workload Scheduler a fin
de que maneje la interceptación de trabajos en un entorno R/3:
1. Instale la interfaz BC-XBP 2.0.
2. Active la función de interceptación de trabajos de la interfaz BC-XBP 2.0.
3. Defina un trabajo Tivoli Workload Scheduler para que recopile periódicamente
los trabajos R/3 interceptados.
4. Especifique los criterios de interceptación en el sistema R/3.
5. Especifique los criterios de interceptación en la parte de Tivoli Workload
Scheduler.
Tenga en cuenta que los trabajos iniciados por Tivoli Workload Scheduler, o por
cualquier otro planificador externo utilizando la interfaz de BC-XBP, no se pueden
interceptar. Esto es debido al diseño del mecanismo de interceptación, que sólo
tiene en cuenta los trabajos cuyas condiciones de inicio se satisfacen debido al
tiempo o a las restricciones de eventos SAP.
Implementación de la interceptación de trabajos
Este apartado describe la acción que debe realizar para implementar la
interceptación de trabajos.
Activación de la función de interceptación de trabajos
Consulte la nota 604496 de SAP para conocer si el sistema R/3 ya tiene la interfaz
BC-XBP 2.0 o el paquete de soporte SAP que debe instalar para habilitarla.
© Copyright IBM Corp. 2000, 2003 131
Para habilitar la función de interceptación de trabajos, ejecute el informe INITXBP2
de ABAP. Este informe le indica el estado actual de las funciones de interceptación
de trabajos y primario-secundario, y permite conmutar el estado de ambas
funciones.
Recopilación de trabajos interceptados periódicamente
Puesto que los trabajos interceptados permanecen en estado planificado hasta que
se vuelven a iniciar, debe definir un trabajo Tivoli Workload Scheduler para
recopilarlos y reiniciarlos.
A continuación encontrará la sintaxis de la definición de trabajos para el
recopilador de interceptaciones de Tivoli Workload Scheduler:
NOMBRECPU#NOMBRETRABAJO
SCRIPTNAME "inicioTWS/methods/r3batch -HIJ -c NOMBRECPU"
DESCRIPTION "Recopila los trabajos interceptados en SAP XA NOMBRECPU"
STREAMLOGON usuarioTWS
RECOVERY STOP
donde:
NOMBRECPU
El nombre de la estación de trabajo del agente ampliado.
NOMBRETRABAJO
El nombre que desee utilizar para el trabajo Tivoli Workload Scheduler.
inicioTWS
La ruta completa para la instalación de Tivoli Workload Scheduler.
usuarioTWS
El nombre del usuario Tivoli Workload Scheduler que iniciará el método
de acceso.
El trabajo recopilador de interceptaciones debe ejecutarse a intervalos
periódicos; por ejemplo, cada 10 minutos. Recuperará todos los trabajos que se
hayan interceptado desde la última ejecución del recopilador de interceptaciones y
volverá a iniciarlos de acuerdo a la plantilla descrita a continuación.
Configuración de los criterios de interceptación en el sistema
R/3
En R/3, los criterios de interceptación están contenidos en la tabla TBCICPT1. Sólo
los trabajos que coinciden con los criterios de esta tabla se interceptan, cuando se
satisfacen las condiciones de inicio. Todos los demás trabajos se ejecutan
normalmente.
Puede mantener las entradas de esta tabla utilizando la transacción se16. Aquí
puede establecer lo siguiente:
v Número de cliente
v Máscara de trabajo
v Máscara de usuario.
Configuración de los criterios de interceptación en Tivoli
Workload Scheduler
En Tivoli Workload Scheduler, los criterios de interceptación se definen y utilizan
mediante los siguientes elementos:
v Archivos de criterios de interceptación
v Archivos de plantillas
132 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Utilización de archivos de criterios de interceptación: Los criterios de
interceptación para cada sistema R/3 se almacenan en un archivo separado
denominado NOMBRECPU_r3batch.icp y están ubicados en el directorio
inicioTWS/methods/r3batch_icp del host Tivoli Workload Scheduler. R3batch lee
este archivo cuando ejecuta el trabajo del recopilador de interceptaciones.
Cada una de las líneas del archivo se considera un criterio de interceptación y se
caracteriza por la siguiente sintaxis:
client job_mask user_mask template
donde client, job_mask y user_mask corresponden a columnas de la tabla
TBCICPT1, mientras que template es el nombre de la plantilla que debe utilizar el
recopilador de interceptaciones para volver a iniciar el trabajo R/3. Los parámetros
se separan por uno o varios espacios. Puede utilizar cualquier editor de texto para
mantener el contenido de este archivo.
Utilización de archivos de plantillas: Una plantilla es un archivo con la extensión
.jdf ubicado en el mismo directorio (inicioTWS/methods/r3batch_icp) que el
archivo de criterios de interceptación. El archivo de plantilla contiene instrucciones
para el recopilador de interceptaciones sobre cómo ejecutar el trabajo R/3
interceptado bajo el control de Tivoli Workload Scheduler. Su sintaxis corresponde
a la sintaxis de docommand en conman. Puede utilizar cualquier editor de texto para
mantener este archivo.
Si el archivo de plantilla del usuario está vacío, se utilizará un archivo de plantilla
denominado default.jdf. Si default.jdf no existe, se utilizarán las instrucciones
siguientes:
alias=SAP_$RUN_$JOBNAME_$JOBCOUNT
Esto significa que los trabajos R/3 interceptados deben reiniciarse inmediatamente,
debido a la ausencia de la opción de trabajo at=. Sus nombres Tivoli Workload
Scheduler se componen de la cadena de caracteres SAP_, el número de ejecución
actual del recopilador de interceptaciones y el nombre y ID del trabajo R/3.
Por lo tanto, el conjunto de instrucciones para reiniciar un trabajo R/3 interceptado
se recupera en el orden siguiente:
1. En el archivo de plantilla, si se especifica una plantilla existente en el archivo
de criterios de interceptación.
2. En el archivo de plantilla predeterminado, si la plantilla se especifica en el
archivo de criterios de interceptación pero no existe o si la plantilla no se
especifica en el archivo de criterios de interceptación.
3. Del conjunto de instrucciones predeterminado, si el archivo de plantilla
predeterminada no existe.
Ejemplo de interceptación de trabajos: La tabla de criterios de interceptación de
R/3 contiene la entrada siguiente:
000 * fa*
El archivo de criterios de interceptación de Tivoli Workload Scheduler contiene la
entrada siguiente:
000 * fa* at1700
El archivo de plantilla at1700.jdf contiene la entrada siguiente:
alias;at=1700
Capítulo 22. Funciones de interceptación de trabajos y primario-secundario 133
Esto implica que todos los trabajos, iniciados en el cliente 000 por los usuarios R/3
cuyo nombre de usuario empiece por fa, se interceptarán. El recopilador de
interceptaciones reiniciará los trabajos utilizando las instrucciones del archivo de
plantilla at1700.jdf. Los trabajos R/3 se reiniciarán a las 17:00 horas con un
nombre elegido al azar, debido al comando alias.
Utilización de espacios reservados: En los archivos de plantillas puede utilizar
varios espacios reservados que el recopilador de interceptaciones vuelve a colocar
en tiempo de ejecución. Se listan en la tabla siguiente.
Tabla 19. Espacios reservados para los archivos de plantillas de interceptación de trabajos.
Espacio reservado Descripción
$CPU El nombre de la estación de trabajo del agente ampliado
en el que se ejecuta el recopilador de interceptaciones.
$CLIENT El número de cliente del trabajo R/3 interceptado.
$JOBNAME El nombre del trabajo R/3 interceptado.
$JOBCOUNT El ID del trabajo R/3 interceptado.
$USER El nombre del usuario que ha iniciado el trabajo R/3.
$JOBNUM El número de trabajo del recopilador de
interceptaciones.
$RUN El número de ejecución actual del recopilador de
interceptaciones.
$SCHED El nombre de planificación del recopilador de
interceptaciones.
$RAND Número aleatorio.
Por lo tanto, la plantilla
alias=ICP_$RAND_$JOBNAME_$JOBCOUNT_$CLIENT;at=1000
daría instrucciones al recopilador de interceptaciones para que reiniciase el trabajo
R/3 denominado DEMO_JOB con el ID de trabajo 12345678 en el cliente 100 a las
10:00 como trabajo Tivoli Workload Scheduler
ICP_1432_DEMO_JOB_12345678_100
Función primario-secundario
En algunas situaciones, un trabajo R/3 genera dinámicamente otros trabajos; por
ejemplo, para distribuir la carga de trabajo a los servidores de aplicaciones libres.
Un ejemplo destacado son los trabajos de actividad masiva del componente R/3
FI-CA. Antes de BC-XBP 2.0, era difícil que los planificadores externos manejaran
esta situación, ya que el proceso de la actividad no finaliza normalmente con la
terminación del trabajo inicial (trabajo primario o padre), sino con la terminación
de todos los subtrabajos (trabajos secundario o hijo).
La interfaz BC-XBP 2.0 permite determinar si un trabajo ha iniciado subtrabajos,
junto con su nombre e ID, por lo que ahora es posible hacer un seguimiento de
ellos.
Para activar esta función, utilice el informe INITXBP2 de ABAP, que también puede
utilizarse para conmutar el estado de la interceptación de trabajos.
134 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Cuando la función primario-secundario está activa, Tivoli Workload Scheduler
únicamente considera que un trabajo R/3 ha finalizado, después de que hayan
terminado todos sus trabajos secundarios; es decir, el estado del trabajo Tivoli
Workload Scheduler continúa como EXEC mientras el trabajo primario o cualquiera
de sus trabajos secundarios esté en ejecución.
El estado del trabajo Tivoli Workload Scheduler pasa a ser SUCC si el trabajo
primario y todos los trabajos secundarios han terminado satisfactoriamente. Si
cualquiera de los trabajos se ha terminado por un error, el estado del trabajo Tivoli
Workload Scheduler pasa a ser ABEND.
Tenga en cuenta que la función primario-secundario puede interferir con la
interceptación de trabajos, aunque el trabajo primario no pueda interceptarse,
cualquiera de sus trabajos secundarios pueden ser interceptados si coinciden con
los criterios de interceptación. En este caso, el trabajo Tivoli Workload Scheduler
permanece en estado EXEC hasta que el trabajo secundario interceptado se haya
vuelto a iniciar y haya terminado.
Los registros de trabajos de los trabajos secundarios se agregan al archivo stdlist
de Tivoli Workload Scheduler después del registro de trabajos del trabajo primario.
Capítulo 22. Funciones de interceptación de trabajos y primario-secundario 135
136 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 23. Soporte del idioma nacional
Mediante la utilización del nuevo esquema de archivos de configuración, con los
archivos de configuración locales y globales, puede configurar r3batch para que
utilice páginas de códigos e idiomas diferentes para la salida y la conexión con el
sistema R/3 remoto.
Esta función le permite instalar r3batch en una estación de trabajo Tivoli Workload
Scheduler localizada y utilizar caracteres localizados para los nombres de trabajo
Tivoli Workload Scheduler, las secuencias de trabajo y las variantes SAP.
Nota: Tenga en cuenta las configuraciones y limitaciones soportadas de esta
función.
Opciones de soporte de idioma nacional
La opción TWSXA_CP afecta la página de códigos utilizada para abrir la conexión
entre r3batch y el sistema R/3 de destino. Su valor podría ser una de las páginas
de códigos R/3 instaladas en el sistema R/3; el valor predeterminado es la página
de códigos 1100 de SAP, similar al estándar ISO8859-1.
TWSXA_LANG afecta al idioma que r3batch utiliza para iniciar la sesión; puede ser
uno de los siguientes:
1. Inglés (EN, el valor predeterminado)
2. Alemán (GE)
3. Japonés (JA)
TWSMETH_CP es la página de códigos que r3batch utiliza para la salida. Se trata de
una opción avanzada y puede alterar la salida y el archivo de registro. Su valor
predeterminado es la página de códigos utilizada por la estación de trabajo Tivoli
Workload Scheduler que aloja a r3batch. Se recomienda utilizar esta opción con
cuidado.
Nota: Es verdadero si utiliza la función de nivel 1.2 de Job Scheduling Console. La
función de nivel 1.3 interactúa con r3batch mediante UTF-8, por lo tanto
esta limitación ya no existe.
TWSMETH_LANG afecta al idioma del catálogo utilizado por r3batch. Esta versión sólo
contiene el catálogo de mensajes en inglés, por lo tanto esta opción no tiene un
efecto real.
© Copyright IBM Corp. 2000, 2003 137
Páginas de códigos R/3 soportadas
Tivoli Workload Scheduler for Applications para R3 puede comunicarse con R/3
utilizando las páginas de códigos siguientes:
Tabla 20. Páginas de códigos R/3 soportadas
Páginas de códigos R/3 Descripción
1100 8859-1, el valor predeterminado
1103 MS 850
8000 SJIS: Desplazamiento JIS
8300 BIG5: Chino tradicional
8400 GBK: Chino simplificado
Configuraciones soportadas y limitaciones
Si se utiliza la función de nivel 1.2 de Job Scheduling Console se aplicará lo
siguiente. La función de nivel 1.3 interactúa con r3batch mediante UTF-8, por lo
tanto esta limitación ya no existe.
Es necesario que Tivoli Workload Scheduler for Applications para R3 esté instalado
en una estación de trabajo que utilice una página de códigos compatible con uno
de los sistemas R/3 de destino. Por ejemplo, si desea utilizar un sistema R/3
japonés que utilice la página de códigos SAP 8000, debe instalar r3batch en una
estación de trabajo que utilice una página de códigos japonesa como SJIS o MS932.
Si desea recuperar la salida de r3batch con Job Scheduling Console, debe ejecutar
Job Scheduling Console en un sistema que utilice la misma página de códigos que
la estación de trabajo Tivoli Workload Scheduler donde r3batch está instalado. Si el
agente de alojamiento utiliza MS932, deberá ejecutar Job Scheduling Console en un
sistema japonés con esa página de códigos.
138 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Parte 5. Método de acceso de z/OS
© Copyright IBM Corp. 2000, 2003 139
140 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 24. Introducción
IBM Tivoli Workload Scheduler for Applications para z/OS le ofrece la posibilidad
de planificar y controlar trabajos OS/390 o z/OS utilizando las funciones
sofisticadas de planificación de trabajos de Tivoli Workload Scheduler.
Nota: En este manual, el término z/OS se utiliza para hacer referencia también a
las versiones soportadas de OS/390. Consulte el apartado sobre los
requisitos de software.
Funciones
v Utilice Tivoli Workload Scheduler para planificar los trabajos z/OS a fin de que
se ejecuten a horas específicas y en un orden prescrito.
v Defina las dependencias entre los trabajos Tivoli Workload Scheduler que se
ejecutan en sistemas y plataformas diferentes.
v Defina las dependencias para los trabajos Tivoli Workload Scheduler basadas en
la finalización de los trabajos z/OS que Tivoli Workload Scheduler no ha
iniciado.
v Defina dependencias para los trabajos Tivoli Workload Scheduler basadas en la
existencia de archivos en un sistema z/OS.
Requisitos de software
IBM Tivoli Workload Scheduler for Applications requiere el software siguiente:
Requisitos de software Versiones
IBM Tivoli Workload Scheduler 7.0 o posterior.
Sistema operativo OS390 2.10 o posterior o z/OS.
TCP/IP Una de las siguientes: IBM 3.1 o posterior;
Interlink 3.1 o posterior; Open Connect 2.3 o
posterior.
Interfaz de planificación de trabajos v JES2 o JES3.
v Interfaz OPC: OPC 2.3.0 o IBM Tivoli
Workload Scheduler for z/OS.
v Interfaz CA7: cualquier versión soportada
actualmente.
Visión general de la instalación
El software de IBM Tivoli Workload Scheduler for Applications para z/OS consiste
en el método de acceso de z/OS que debe residir en el host Tivoli Workload
Scheduler y en el software de gateway que reside en z/OS. El software de gateway
puede instalarse desde un cartucho de cinta 3480 separado o desde el CD-Rom de
IBM Tivoli Workload Scheduler for Applications.
Antes de instalar el método de acceso, asegúrese de que Tivoli Workload Scheduler
esté correctamente instalado en la estación de trabajo host.
© Copyright IBM Corp. 2000, 2003 141
1. En el sistema que será el host del método de acceso para z/OS, si la plataforma
en la que realiza la instalación es una de las siguientes:
v Compaq Tru64
v SGI Irix
v IBM Sequent Dynix
siga las instrucciones descritas en el apartado “Instalación en plataformas de 2
niveles”.
De lo contrario, siga las instrucciones descritas en el apartado Capítulo 2,
“Instalación de IBM Tivoli Workload Scheduler for Applications”, en la página
5.
2. Instale el software de gateway en z/OS.
3. Establezca las autorizaciones necesarias en z/OS.
Instalación en plataformas de 2 niveles
El software del método de acceso de z/OS para las plataformas de 2 niveles se
suministra como un archivo tar en el CD. Siga estos pasos para instalarlo:
1. Detenga Tivoli Workload Scheduler en la estación de trabajo donde está
instalando el método.
2. Inicie la sesión como root y cambie el directorio por iniciotws/methods.
3. Monte el CD de instalación y restaure el archivo tar con el siguiente comando:
tar xvf carpeta_cd/archivotar
donde:
parámetro tar Descripción
carpeta_cd El nombre de ruta de la unidad de CD o carpeta.
archivotar El archivo TAR dependiendo de la plataforma de destino. Puede
ser uno de los siguientes:
v TWS4APPS_ZOSAGENT_DYNIX.TAR para IBM Sequent
Dynix
v TWS4APPS_ZOSAGENT_IRIX.TAR para SGI Irix
v TWS4APPS_ZOSAGENT_OSF.TAR para Compaq True 64
4. Ejecute el comando siguiente desde el directorio iniciotws/methods:
./mvsinstall.sh -user usuariotws
Instalación en z/OS
El módulo de gateway se entrega en los dos soportes siguientes:
v Un cartucho de cinta 3480 que se ha grabado en formato no IDRC (no
comprimido).
v El CD-Rom de IBM Tivoli Workload Scheduler for Applications.
Ambos soportes contienen los dos archivos siguientes:
v La biblioteca de carga.
v Los ejemplos de los dos procedimientos.
Puede elegir el soporte que prefiera para descargar los archivos, que tienen un
contenido idéntico.
142 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Descarga de los archivos del CD-Rom
Los archivos de gateway están almacenados en el directorio ZOS del CD-Rom del
producto y se denominan:
v LOADLIB
v SAMPLES
Para descargar los archivos en el sistema z/OS:
1. Desde el emulador de sesión TSO, seleccione el shell de comandos ISPF
(comando TSO) y utilice el programa de utilidad de Transferencia de archivos
(Enviar a host) para transferir la biblioteca LOADLIB y el miembro SAMPLES
del CD-Rom al sistema z/OS, estableciendo la transferencia para una longitud
de registro lógico de 80 y un formato de registro fijo.
2. Reciba los miembros en conjuntos de datos de salida utilizando la opción
INDSN. Esto descargará 11 módulos de carga en la biblioteca de salida y 2
ejemplos en la biblioteca de ejemplos.
Descarga de los archivos desde la cinta
Modifique y envíe un JCL que tenga un aspecto como el siguiente para descargar
la cinta. Personalice la tarjeta de trabajo y modifique los dos siguientes parámetros
de acuerdo a los estándares de entorno:
v Especifique un nombre de trabajo adecuado.
v Identifique un dispositivo de cinta 3480.//MVSXAUNL JOB (876903,D07),’OPCL3’,MSGLEVEL=(1,1),
// MSGCLASS=A,CLASS=A,NOTIFY=&SYSUID
//**********************************************************************
//* *
//* ESTE ES EL TRABAJO QUE DESCARGA TIVOLI WORKLOAD SCHEDULER FOR *
//* APPLICATIONS z/OS Método de acceso Versión 8.2.0 PARA PERSONALIZAR *
//* *
//**********************************************************************
//STEP01 EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=*
//INDD DD DSN=TWSX.V8R2M0.SAMPLES,
// DISP=(OLD,PASS),UNIT=600,
// VOL=SER=IBM001,
// LABEL=(1,SL)
//OUTDD DD DSN=TWSX.V8R2M0.SAMPLES,
// DISP=(NEW,CATLG),
// SPACE=(32760,(2,2,10)),
// DCB=(RECFM=FB,LRECL=80,BLKSIZE=0),
// UNIT=3390,VOL=SER=OPC00C
//SYSUT3 DD UNIT=SYSDA,SPACE=(TRK,(20,1,10))
//SYSUT4 DD UNIT=SYSDA,SPACE=(TRK,(20,1,10))
//SYSIN DD *
COPY OUTDD=OUTDD,INDD=((INDD,R))
//STEP02 EXEC PGM=IEBCOPY
//SYSPRINT DD SYSOUT=*
//INDD DD DSN=TWSX.V8R2M0.SERVICE.APFLIB1,
// DISP=(OLD,PASS),UNIT=600,
// VOL=SER=IBM001,
// LABEL=(2,SL)
//OUTDD DD DSN=TWSX.V8R2M0.SERVICE.APFLIB1,
// DISP=(NEW,CATLG),
// SPACE=(32760,(50,50,50)),
// DCB=(RECFM=U,BLKSIZE=32760),
// UNIT=3390,VOL=SER=OPC00C
//SYSUT3 DD UNIT=SYSDA,SPACE=(TRK,(20,1,10))
//SYSUT4 DD UNIT=SYSDA,SPACE=(TRK,(20,1,10))
//SYSIN DD *
COPY OUTDD=OUTDD,INDD=((INDD,R))
//*
Capítulo 24. Introducción 143
Visión general de la instalación
Los dos componentes del programa z/OS del gateway Tivoli Workload Scheduler
son:
EEWTCP02
Este programa establece que Tivoli Workload Scheduler está haciendo un
seguimiento en el sistema z/OS. El programa se inicia por el trabajo
EEWSPACE.
EEWTCP00
Este es el programa “gateway” que gestiona las comunicaciones TCP/IP
entre Tivoli Workload Scheduler y el sistema z/OS. Se inicia por el trabajo
EEWSERVE. EEWTCP00 convierte los comandos Tivoli Workload
Scheduler en equivalentes de z/OS, direcciona la información de z/OS de
vuelta a Tivoli Workload Scheduler y realiza conversiones de datos
EBCDIC-ASCII.
Ambos programas se ejecutan como tareas iniciadas, con el parámetro
TIME=NOLIMIT. EEWTCP02 siempre se inicia primero, seguido de EEWTCP00. Si
los programas deben terminarse por alguna razón, deberán detenerse y no
cancelarse, para garantizar su conclusión correcta sin afectar a otros programas que
utilizan la salida IEFU84.
Establecimiento de autorizaciones en z/OS
Tras instalar el producto en z/OS, autorice la biblioteca de carga. Esto puede
hacerlo mediante:
1. La emisión del comando SETPROG desde el registro de consola. Por ejemplo:
SETPROG APF,ADD,DSN=twsx.SERVICE.APFLIB1,
VOL=xxxxxx
donde: xxxxxxx es el número de serie del volumen donde está ubicada la
biblioteca de carga o:
SETPROG APF,ADD,DSN=twsx.SERVICE.APFLIB1,VOL=SMS
que indica un volumen bajo el control de SMS.
2. Actualice el miembro PROGxx de SYS1.PARMLIB, o la autorización se perderá
en el siguiente IPL.
3. Agregue EEWTCP00 a la sección AUTCHCMD NAMES de
SYS1.PARMLIB(IKJTSOxx).
Notas adicionales
Las siguientes secciones ofrecen información adicional para el funcionamiento del
agente ampliado.
Salida IEFU84
El agente ampliado para z/OS hace un seguimiento de las secuencias de trabajos
utilizando la salida IEFU84. Esta salida debe activarse en el miembro SMF parm de
SYS1.PARMLIB. IBM distribuye una salida IEFU84 ficticia con el sistema operativo
que es un programa IEFBR14. El trabajo EEWSPACE (explicado más adelante) se
encadenará dinámicamente a la salida IEFU84. Si la salida IEFU84 se está
utilizando actualmente, EEWSPACE “adelantará” la salida IEFU84, obtendrá la
información que requiere y, a continuación, bifurcará hacia la salida o salidas de
usuario existentes. Cuando finalice EEWSPACE, se eliminará a si mismo de la
144 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
cadena y la restaurará a su estado original. Es importante tener que cuenta que
EEWSPACE no tiene ningún efecto en la salida o salidas IEFU84 existentes, que
continuarán ejecutándose normalmente.
Seguridad
La seguridad se refuerza en varias áreas, normalmente, RACF, Top Secret, ACF2,
etc. El trabajo EEWSERVE (explicado más adelante) debe tener la posibilidad de
someter trabajos que se ejecutan bajo los ID de usuarios que se suministran en el
JCL que debe enviarse. El JCL no debe contener contraseñas. Puede autorizarse
utilizando los recursos de clase SURROGAT en RACF y los equivalentes en ACF2
y Top Secret. Los recursos de clase PROPCNTL en RACF deben utilizarse para
impedir que los trabajos enviados se ejecuten bajo el ID de usuario EEWSERVE.
Los equivalentes de ACF2 y Top Secret también pueden utilizarse. La clase de
recurso JESJOBS de RACF, y los equivalentes de ACF2 o Top Secret, pueden
utilizarse para controlar los nombres de trabajo e ID de usuario (con o sin
contraseñas) que EEWSERVE puede enviar.
Tenga en cuenta que Tivoli Workload Scheduler no da soporte a la utilización de la
seguridad CA-7.
Seguridad de consola
El trabajo EEWSERVE (explicado más adelante) tiene la propiedad completa de la
consola cuando se visualizan secuencias de trabajos y se emiten comandos de
modificación a CA-7. Debe tener autorización para utilizar una consola ampliada.
Consulte al administrador de seguridad para garantizar que sea así. Tenga en
cuenta que debe configurarse CA-7 para permitir a los usuarios emitir los
comandos de modificación mediante las consolas maestra y ampliada. OPERCMDS
debe modificarse para permitir esta funcionalidad si aún no está permitida.
Consulte también el apartado “Variables SYSTSIN” en la página 146 para obtener
información acerca de la especificación de un ID de usuario de autorización.
Puede utilizarse la seguridad externa (consulte el apartado Seguridad más arriba)
para autorizar al usuario CA-7 especificado en EEWSERVE, ya que Workload
Scheduler no da soporte al suministro de una contraseña con el nombre de
usuario.
Inicio
Siga estos pasos:
1. Personalice e inicie el procedimiento EEWSPACE (siguiendo las instrucciones
comentadas que se encuentran allí) para iniciar el Espacio de datos de gateway
del agente ampliado. El trabajo debe ser una tarea iniciada y no debe
cancelarse. Consulte el apartado “Variables SYSTSIN” en la página 146 para
obtener una descripción de los valores de parámetros. EEWSPACE creará el
Espacio de datos e instalará la salida IEFU84. Para terminar el trabajo, utilice el
comando STOP EEWSPACE en cualquier consola z/OS.
Notas:
a. EEWSPACE debe activarse antes de iniciar EEWSERVE.
b. Para concluir, detenga EEWSERVE antes de detener EEWSPACE.2. Personalice e inicie el procedimiento EEWSERVE que sigue a las instrucciones
comentadas que se contienen allí. Consulte el apartado “Variables SYSTSIN” en
la página 146 para obtener una descripción de los valores de parámetros.
3. Para terminar el trabajo, utilice el comando STOP EEWSERVE desde cualquier
consola z/OS.
Capítulo 24. Introducción 145
Variables SYSTSIN
Las variables SYSTSIN se describen a continuación. Puede modificar los valores tal
como requiera la configuración local. Los valores predeterminados están entre
paréntesis.
Tabla 21. Variables SYSTSIN.
Variable Descripción
CA7INTERFACE(CONSOLE) CONSOLE es la única interfaz
soportada para CA-7 y es el valor
predeterminado para esta variable.
Debe establecerse en NO si no se
utiliza esta interfaz.
CA7NAME(CA7ONL) El nombre del espacio de dirección
de la región de control CA-7. Se
pasa por alto si no se utiliza CA-7.
CA7OPTIONS(X’32’) Las opciones de release de CA-7. El
valor predeterminado se determina
a partir de la entrada de tabla de
vectores del subsistema CA-7 y no
debe cambiarlo a menos que se lo
indique el Soporte técnico de IBM.
CA7SPAN(9999) Esta variable se aplica
exclusivamente a la interfaz CA7.
El número representa el intervalo
mínimo (en horas y minutos)
después de los cuales es posible
iniciar desde Tivoli Workload
Scheduler el mismo trabajo sin
especificar un SCHID diferente. El
valor predeterminado se establece
en 9999 intencionadamente, un
valor no válido, para poder
distinguir los casos en que no se
utiliza la variable. Si se especifica,
debe ser un número de 4 dígitos
con el formato HHMM. Por
ejemplo:
v CA7SPAN(0010) significa 10
minutos.
v CA7SPAN(0130) significa 1 hora
y 30 minutos.
Consulte el apartado “Otros
consejos para CA-7” en la página
161 para ver más detalles.
El intervalo mínimo en minutos
(cuatro dígitos) después del cual es
posible iniciar el mismo trabajo
desde Tivoli Workload Scheduler
sin tener que especificar un SCHID
diferente. Debe pasarse por alto si
se establece CA7INTERFACE igual
a NO.
CA7SUBSYSTEM(UC07) El nombre del subsistema CA-7.
146 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Tabla 21. Variables SYSTSIN. (continuación)
Variable Descripción
CA7USER(CA7CNSL) El ID de usuario que se utiliza para
emitir comandos CA-7. Se pasa por
alto si no se utiliza CA-7.
COMPLETIONCODE(LASTSTEP/MAXSTEP) La opción del código de
finalización del trabajo de múltiples
pasos JES predeterminado.
LASTSTEP, el valor
predeterminado, indica que el
código de finalización para el
trabajo de múltiples pasos JES se
determina por el último paso
ejecutado en el trabajo. MAXSTEP
indica que el código de finalización
se determina por el código de
finalización superior de cualquier
paso ejecutado en el trabajo. Esta
variable establece el valor
predeterminado para los trabajos
cuya opción no se ha alterado
temporalmente en la configuración
Tivoli Workload Scheduler del
trabajo.
DEBUG(NO) Si se establece en YES, hace que el
gateway genere mensajes de
diagnóstico. Se debe utilizar
únicamente en coordinación con el
Soporte técnico de IBM.
INTERLINKSUBSYSTEM(ACSS) El nombre del subsistema utilizado
por la pila TCPIP de Interlink. Se
pasa por alto si Interlink no se
utiliza como pila TCPIP.
JESCMDCHR($) El carácter de reconocimiento de
comandos de trabajo. El valor
predeterminado se establece en un
signo de dólar ($) para los sistemas
JES2 y en un asterisco (*) para los
sistemas JES3. Esta variable sólo
debe cambiarse si se está utilizando
un carácter de reconocimiento de
comandos diferente.
MAXWAIT(500) El período máximo de tiempo, en
centésimas de segundos, que debe
esperarse una respuesta de los
comandos. Debe pasarse por alto si
se establece CA7INTERFACE igual
a NO.
MCSSTORAGE(3) La cantidad de almacenamiento, en
megabytes, utilizados por cada
consola ampliada utilizada por el
gateway. Debe pasarse por alto si
se establece CA7INTERFACE igual
a NO.
Capítulo 24. Introducción 147
Tabla 21. Variables SYSTSIN. (continuación)
Variable Descripción
OPCINTERFACE(PIF) PIF es la única interfaz soportada
para OPC o Tivoli Workload
Scheduler for z/OS y es el valor
predeterminado para esta variable.
Debe establecerse en NO si no se
utiliza esta interfaz.
OPCMSGCLASS(*) La clase de mensaje para los
registros de mensajes asignados
dinámicamente por OPC o Tivoli
Workload Scheduler for z/OS. El
asterisco hace que se establezca
igual que EEWSERVE. Se pasa por
alto si no se utilizan OPC ni Tivoli
Workload Scheduler for z/OS.
OPCSUBSYSTEM(OPCS) El nombre de subsistema utilizado
para las comunicaciones con la
región de control de OPC o Tivoli
Workload Scheduler for z/OS.
PEERADDRESS(0 0 0 0) El valor predeterminado, 0 0 0 0,
permite el acceso por cualquier
host. Para una mejor seguridad,
escriba la dirección IP del host
Workload Scheduler del agente x
de z/OS. Nota: No incluya el ″.″
(punto) entre los 0 del código. Los
puntos aparecerían en la pantalla.
PORT(5000) El número de puerto TCP utilizado
por Tivoli Workload Scheduler y el
gateway para comunicaciones.
Debe ser el mismo que el valor
especificado en el campo Dirección
TCP de la definición de estación de
trabajo de agente x de z/OS.
PUTLINE(YES) Cuando se establece en YES, dirige
la información de rastreo a
DDNAME SYSTSPRT.
QLIMIT(2000) El número máximo de mensajes
que deben ponerse en cola para
una consola ampliada.
SUBSYS(UNIS) El prefijo utilizado por el agente
ampliado para z/OS como los
cuatro primeros caracteres de los
nombres de consola ampliada.
También se utiliza como los cuatro
primeros caracteres del lector
interno DDNAMES. Sólo debe
cambiarse en coordinación con el
Soporte Técnico de IBM.
SVCDUMP(NO) Cuando se establece en YES, las
terminaciones anómalas provocarán
un vuelco SVC. Se debe utilizar
únicamente en coordinación con el
Soporte técnico de IBM.
148 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Tabla 21. Variables SYSTSIN. (continuación)
Variable Descripción
TCPIPSTACK(IBM) El proveedor de pila TCPIP (IBM,
INTERLINK o OPENCONNECT).
TCPNAME(TCPIP) El nombre del espacio de
direcciones TCPIP cuando se utiliza
la versión de IBM de la pila TCPIP.
TERMINATOR(X’25’) El carácter de terminación de
transacción. No debe cambiarse el
valor predeterminado a menos que
lo indique el Soporte técnico de
IBM.
WTP(NO) Cuando se establece en YES,
dirigirá la información de rastreo a
SYSLOG como información grabada
para el programador. Puede
utilizarse si SYSTSPRT no satisface
sus necesidades.
Cuando utilice CA-7, se requerirán
PUTLINE(YES) y WTP(NO) si
DEBUG(YES).
ZOSV1R2(NO) Debe establecerse en YES si utiliza
la interfaz JES3 con z/OS V1R2 o
posterior. Este parámetro se pasa
por alto si no utiliza la interfaz
JES3, porque:
v Si utiliza la interfaz JES2, el nivel
del sistema operativo no
representa ninguna diferencia
para el producto
v Si utiliza las interfaces CA7 o
Tivoli Workload Scheduler for
z/OS, se garantiza el soporte de
z/OS V1R2 o posterior, siempre
que el release del subsistema o
subsistemas correspondientes le
den soporte.
Versión de gateway z/OS
La versión de EEWSERVE (y EEWSPACE) aparecerá en la primera línea del
registro EEWSERVE (y EEWSPACE). Por ejemplo:
EEWTCP10 VERSION RELEASE MODIFICATION LEVEL = VxRyMz
donde VxRyMz contiene la versión, release y niveles de modificación.
Capítulo 24. Introducción 149
150 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 25. Configuración y utilización
Tivoli Workload Scheduler inicia los trabajos en un agente ampliado para la
estación de trabajo z/OS. El agente ampliado para z/OS se define en la definición
estándar de la estación de trabajo Tivoli Workload Scheduler que le da un nombre
e identifica el método de acceso que debe utilizarse. El agente ampliado para la
estación de trabajo z/OS es una definición de estación de trabajo enlazada a una
instancia del sistema z/OS.
Para iniciar un trabajo en un agente ampliado para la estación de trabajo z/OS,
Tivoli Workload Scheduler ejecuta el método de acceso, pasándole información
acerca del trabajo. El método de acceso se comunica con la instancia del host z/OS
y supervisa el trabajo hasta que finaliza, grabando la evolución del trabajo y la
información de estado en el archivo de lista estándar del trabajo.
Este capítulo describe cómo:
v Crear un archivo de opciones para seleccionar opciones para un método.
v Definir un agente ampliado para el trabajo z/OS
v Planificar un agente ampliado para el trabajo z/OS
Consulte el Capítulo 4, “Definición de estaciones de trabajo de agente ampliado”,
en la página 31 para obtener información sobre cómo definir una estación de
trabajo de agente ampliado en Tivoli Workload Scheduler.
Archivos de opciones de método
En todas las plataformas soportadas excepto Compaq Tru64, SGI Irix e IBM
Sequent Dynix, utilice el Editor de opciones para crear los archivos de opciones
necesarios. Consulte el apartado Capítulo 3, “Establecimiento de opciones con el
Editor de opciones”, en la página 27 como referencia.
Archivos de opciones de método de plataformas de 2 niveles
En Compaq Tru64, SGI Irix e IBM Sequent Dynix, cree un archivo de opciones para
seleccionar las opciones para un método. El archivo debe tener el mismo nombre
de ruta que el método y una extensión opts. Por ejemplo, cree los archivos
siguientes en UNIX (suponiendo que el directorio inicial de Tivoli Workload
Scheduler sea /usr/lib/tws):
/usr/lib/tws/methods/mvsca7.opts
/usr/lib/tws/methods/mvsjes.opts
/usr/lib/tws/methods/mvsopc.opts
O cree los archivos siguientes en Windows (suponiendo que Tivoli Workload
Scheduler esté instalado en la ruta C:\WIN32APP\tws):
c:\win32app\tws\methods\mvsca7.opts
c:\win32app\tws\methods\mvsjes.opts
c:\win32app\tws\methods\mvsopc.opts
© Copyright IBM Corp. 2000, 2003 151
Para mvsca7, mvsjes y mvsopc, las entradas de archivo de opciones son:
Entradas de archivos de opciones Descripción
LJuser=nombre Asigna el nombre de usuario utilizado por el método
de acceso para iniciar trabajos. Debe ser un usuario
válido de UNIX o Windows que envíe trabajos locales
y pueda conectarse al gateway z/OS de Tivoli
Workload Scheduler del sistema z/OS. El valor
predeterminado es el parámetro de inicio de sesión
de la definición de trabajo.
CFuser=nombre (Necesario) Asigna el nombre de usuario utilizado
por el método de acceso para comprobar las
dependencias de archivo. Puede ser el mismo que
LJuser.
GSuser=nombre (Opcional) Asigna el nombre de usuario utilizado por
el método de acceso para comprobar los trabajos no
iniciados por Tivoli Workload Scheduler en z/OS que
se utilizan como dependencias. El valor
predeterminado es root.
CheckInterval=min (Opcional) Define el intervalo de sondeo, en minutos,
para comprobar el estado de los trabajos z/OS que se
han iniciado por el método. Se aceptan los valores
fraccionales; por ejemplo, ,5 para 30 segundos o 1,5
para un minuto y 30 segundos. El valor
predeterminado es 2.
Cuando se comprueban trabajos no iniciados por
Tivoli Workload Scheduler en z/OS que se utilizan
como dependencias, el método utiliza la opción local
de Tivoli Workload Scheduler bm check status en
lugar de CheckInterval para determinar su intervalo
de sondeo.
BlockTime=min (Opcional) Define el período de tiempo, en minutos,
que el método esperará una respuesta para una
comprobación de estado antes de exceder el tiempo
de espera. Este valor debe ser inferior al valor de
CheckInterval (descrito arriba) y la opción local de
Tivoli Workload Scheduler bm check status. Se
aceptan los valores fraccionales; por ejemplo, ,5 para
30 segundos o 1,5 para un minuto y 30 segundos. El
valor predeterminado es 2.
RetryCount=cuenta (Opcional) Define el número de veces que se
intentará una comprobación de estado antes de que
Tivoli Workload Scheduler grabe un mensaje de
tiempo de espera excedido en un archivo stdlist y lo
marque en estado de terminación anómala. Consulte
CheckInterval y BlockTime más arriba para obtener
más información. El valor predeterminado es 10.
Definición de trabajos en z/OS
En z/OS, los trabajos que se planifican con Tivoli Workload Scheduler se definen
tal como se prescribe para JES, CA-7 y OPC o Tivoli Workload Scheduler for z/OS.
152 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Definición de trabajos z/OS en Tivoli Workload Scheduler
Se requieren definiciones de trabajo Tivoli Workload Scheduler para cada trabajo
z/OS que piense planificar e iniciar con Tivoli Workload Scheduler. Se definen
como otros trabajos Tivoli Workload Scheduler e incluyen el nombre del trabajo, el
nombre de usuario, las opciones de nombre de script especiales y las opciones de
recuperaciones opcionales.
Consulte el apartado Capítulo 5, “Definición de trabajos de agente ampliado”, en la
página 37 como referencia.
Sintaxis de definición de tareas para trabajos z/OS
planificados con Tivoli Workload Scheduler
Las siguientes son descripciones de la sintaxis de la definición de tareas (línea de
comandos “scriptname”) para los trabajos que Tivoli Workload Scheduler planifica
e inicia mediante estaciones de trabajo de agente ampliado utilizando los métodos
mvsjes (trabajos JES2/3), mvsca7 (trabajos CA-7) o mvsopc (OPC o trabajos IBM
Tivoli Workload Scheduler for z/OS).
Estos parámetros de cadena de tarea se especifican en los lugares siguientes al
definir sus trabajos Tivoli Workload Scheduler asociados:
v En el campo Comando de la página Tarea de la ventana Propiedades -
Definición de trabajo, si utiliza Job Scheduling Console.
v Como argumentos de la palabra clave scriptname en la sentencia de definición
del trabajo, si utiliza la línea de comandos de Tivoli Workload Scheduler.
v Como argumentos de la palabra clave JOBCMD en la sentencia JOBREC de
SCRIPTLIB de Tivoli Workload Scheduler for z/OS, si realiza la planificación en
un entorno global.
Para trabajos JES:
La sintaxis es:
conjuntodatos [<|= códigocond]
donde:
conjuntodatos
El conjunto de datos del trabajo JES o el nombre del conjunto de datos
particionado.
códigocond
El código de condición que indica la finalización satisfactoria del trabajo. Si
va precedido por <, el código de condición debe ser inferior o igual a este
valor. Si va precedido de =, el código de condición debe ser igual a este
valor. Si se omite, se utiliza “= 0000”. Tenga en cuenta que debe haber un
espacio a ambos lados del operador (< o =).
Ejemplo:
gold.apayable.cntl(apayjob1) = 0004
Para trabajos CA-7:
La sintaxis es:
nombretrabajo [SCHID(nnn)] [CC(nnnn) ] [...]
[RO(EQ|LT|GT|GE|LE|NE|#S|IG|NO) ]
[SET(SKP|NTR|NDB) ]
Capítulo 25. Configuración y utilización 153
donde:
nombretrabajo
El nombre del trabajo en CA-7.
SCHID
El ID de planificación (un número de 1 a 255) que debe asignarse al
trabajo.
CC El código de condición utilizado con RO que indica la finalización
satisfactoria del trabajo.
RO El operador relacional para el código de condición CC.
SET Establece las opciones de trabajo para saltarse la siguiente ejecución
planificada (SKP), inhabilitar del desencadenamiento de trabajos normal
(NTR) o saltarse la carga de la base de datos cuando finalice (NDB).
Para ver descripciones completas de los parámetros, consulte la publicación CA-7
Commands Guide.
Ejemplo:
ARCVJOB SCHID(203) CC(0001) RO(EQ) SET(NDB)
Para trabajos OPC o Tivoli Workload Scheduler for z/OS:
La sintaxis es:
apl [IA(aammddhhmm)|IATIME(hhmm) ] [...]
[DEADLINE(aammddhhmm)|DEADLINETIME(hhmm) ]
[PRIORITY(pri) ]
[CPDEPR(Y|N|P|S) ]
donde:
apl El nombre de la aplicación OPC o Tivoli Workload Scheduler for z/OS que
debe insertarse en el plan actual.
IA La fecha y hora de la llegada de entrada en el formato: aammddhhmm .
IATIME
La hora de la llegada de entrada con el formato: hhmm.
DEADLINE
La fecha y la hora de llegada del plazo límite con el formato:
aammddhhmm.
DEADLINETIME
La hora de llegada del plazo límite con el formato: hhmm.
PRIORITY
La prioridad (1-9) con la que debe ejecutarse la aplicación..
CPDEPR
La selección de resolución de dependencias del plan actual.
Y Agrega todas las dependencias del sucesor y del predecesor.
N No agrega ninguna dependencia. (El valor predeterminado.)
P Agrega las dependencias de predecesor.
S Agrega las dependencias de sucesor.
154 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Para ver descripciones completas de los parámetros, consulte la documentación de
OPC o Tivoli Workload Scheduler for z/OS.
Ejemplo:
PREFABJOB44 IA(0202181000) PRIORITY(5) CPDEPR(Y)
Sintaxis de definición de tareas para trabajos que no son z/OS
Las siguientes son descripciones de la sintaxis de la definición de tarea (línea de
comandos “scriptname”) para los trabajos z/OS que Tivoli Workload Scheduler no
ha iniciado, pero que deben supervisarse hasta la finalización. La finalización de
estos trabajos z/OS puede utilizarse como dependencia de “continuación” para los
trabajos iniciados por Tivoli Workload Scheduler. Los trabajos que no son Tivoli
Workload Scheduler pueden ser JES, CA-7 u OPC o Tivoli Workload Scheduler for
z/OS.
La sintaxis básica es:
trabajo-tws follows agentex::"trabajo-mvs"
donde:
trabajo-tws
El nombre del trabajo Tivoli Workload Scheduler que depende de la
finalización del trabajo z/OS especificado.
agentex
El nombre de la estación de trabajo de agente x Tivoli Workload Scheduler
asociada al planificador del trabajo z/OS— es decir, un agente x definido
por los métodos mvsjes, mvsca7 o mvsopc. Tenga en cuenta que los dos
puntos son un delimitador necesario.
trabajo-mvs
La identificación del trabajo z/OS. Tenga en cuenta que esta cadena debe ir
entre comillas. Consulte las descripciones de sintaxis que encontrará más
abajo.
Para trabajos JES:
La sintaxis es:
"nombretrabajo[<|= códigocond]"
donde:
nombretrabajo
El nombre del trabajo en JES.
códigocond
El código de condición que indica la finalización satisfactoria del trabajo. Si
va precedido de <, el código de condición debe ser inferior o igual a este
valor. Si va precedido de =, el código de condición debe ser igual a este
valor. Si se omite, se utiliza “= 0000”. Tenga en cuenta que debe haber un
espacio a ambos lados del operador (< o =).
Ejemplo:
job5 follows jesworkstation::"apayable = 0004"
Para trabajos CA-7:
La sintaxis es:
"nombretrabajo [SCHID(nnn) ] [...]"
[DATE(*|*aaddd)} ]
Capítulo 25. Configuración y utilización 155
[SPAN( {* }) ]
{ámbito }
{fecha }
{(fechainicio,horainicio,ámbito) }
{(fechainicio,horainicio,fechafin,horafin) }
donde:
nombretrabajo
El nombre del trabajo en CA-7.
SCHID
El ID de planificación (un número de 1 a 255) del trabajo.
DATE Una fecha de registro específica que debe buscarse para el trabajo.
SPAN El espacio de registros del registro en que debe buscarse el trabajo.
Para ver descripciones completas de los parámetros, consulte la publicación de
CA-7 Commands Guide. Por ejemplo:
joba follows workstation::"arcvjob schid(203) span(12)"
Consulte también el apartado “Otros consejos para CA-7” en la página 161
Para trabajos OPC o Tivoli Workload Scheduler for z/OS:
La sintaxis es:
"aplicación[IA(aammddhhmm)|IATIME(hhmm)][...]"
[JOBNAME(nombretrabajo) ]
[OPNO(núm) ]
donde:
aplicación
El nombre de la aplicación OPC o Tivoli Workload Scheduler for z/OS
(secuencia de trabajos) del plan actual.
IA La fecha y la hora de la llegada de entrada.
IATIME
La hora de la llegada de entrada.
JOBNAME
El nombre de trabajo z/OS.
OPNO
El número de operación (1-255). Si se incluye, la aplicación se considera
completada cuando alcanza este número de operación.
Para ver descripciones completas de los parámetros, consulte la documentación de
OPC o Tivoli Workload Scheduler for z/OS. Por ejemplo:
joba follows opcworkstation::"PREFABJOB44 IA(0202181000) JOBNAME(PFJ3)"
Sintaxis de dependencias de archivo (OPENS) en archivos
z/OS
Los trabajos y las secuencias de trabajos Tivoli Workload Scheduler pueden utilizar
archivos z/OS como dependencias. La sintaxis básica es:
trabajo-tws opens agentex#"cns1.cns2.cns3"
156 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
donde:
trabajo-tws
El nombre del trabajo Tivoli Workload Scheduler que depende del archivo
z/OS.
agentex
El nombre de la estación de trabajo de agente x Tivoli Workload Scheduler
asociada al planificador del trabajo z/OS— es decir, un agente x definido
por los métodos mvsjes, mvsca7 o mvsopc. Tenga en cuenta que el signo #
es un delimitador necesario.
cns1.cns2.cns3
La identificación del archivo z/OS en términos de calificador de nivel
superior. Tenga en cuenta que esta cadena debe ir entre comillas.
Consulte el apartado “Comprobación de archivos en z/OS” en la página 163 para
obtener más información.
Capítulo 25. Configuración y utilización 157
158 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 26. Información de referencia
Visión general técnica
Este capítulo describe los estados del trabajo cuando se utiliza en JES, CA-7 y OPC
o Tivoli Workload Scheduler for z/OS en el entorno Tivoli Workload Scheduler.
Utilización con JES
Se aplica lo siguiente cuando se utiliza con JES.
Inicio de trabajos JES
Para iniciar y controlar un trabajo JES, Tivoli Workload Scheduler pasa el nombre
del conjunto de datos JCL o pds que desea ejecutar al gateway z/OS, que a su vez,
lo envía a JES. Los envíos se producen utilizando los lectores internos asignados
dinámicamente en JES. El Gateway asigna un lector interno al inicio de cada tarea
y, a continuación, envía el trabajo al lector.
Cuando se envía un trabajo, el nombre del trabajo y el ID de trabajo JES también
se entran en el Espacio de tabla. Cuando un registro SMF que contiene datos de
planificación de trabajos importante se pasa a través de la salida IEFU84, la
información de trabajo y el código de condición estarán disponibles para Tivoli
Workload Scheduler. Puesto que Workload Scheduler hace un seguimiento del
nombre de trabajo y el ID de trabajo JES, puede comprobar el trabajo específico
que ha enviado. (Actualmente el Gateway utiliza registros SMF de tipo 30 y
también los subtipos 1,4,5.)
Tivoli Workload Scheduler comprueba los trabajos enviados periódicamente para
ver si están activos. Si un trabajo enviado por Tivoli Workload Scheduler no está
activo y no se encuentra información del mismo mediante la salida IEFU84, el
trabajo se marca como abend en las pantallas de Tivoli Workload Scheduler. Esta
situación puede producirse si un trabajo falla por razones de seguridad o
problemas de sintaxis JCL.
Estados de trabajo para JES: La tabla siguiente lista los estados de trabajos JES
con respecto a Tivoli Workload Scheduler.
Estado de
trabajo Tivoli
Workload
Scheduler Estado de trabajo JES Comentario
intro na Workload Scheduler está iniciando el método.
wait Queued
wait na Si el trabajo permanece en este estado, puede
ser debido a una violación de seguridad en
z/OS. Compruebe el trabajo en el sistema
z/OS.
exec Executing El trabajo se está ejecutando.
succ Completed El código de condición del trabajo satisface los
criterios de finalización de la definición de
trabajo Tivoli Workload Scheduler.
© Copyright IBM Corp. 2000, 2003 159
Estado de
trabajo Tivoli
Workload
Scheduler Estado de trabajo JES Comentario
abend Completed El código de condición del trabajo no satisface
los criterios de finalización de la definición del
trabajo Tivoli Workload Scheduler o se ha
producido una terminación anómala del sistema
o del usuario. Los códigos de terminación
anómala del sistema, en hexadecimal, llevan el
prefijo ″S″, y los códigos de terminación
anómala de usuario, en decimal, llevan el
prefijo ″U″. Ambos tipos de códigos se graban
en el archivo stdlist del trabajo.
extrn na Estado desconocido. Sólo puede producirse
cuando se comprueba un trabajo que se utiliza
como dependencia.
Comprobación de trabajos JES: Para comprobar un trabajo JES que Tivoli
Workload Scheduler no ha iniciado, Tivoli Workload Scheduler pasa el nombre del
trabajo al Gateway. Puesto que Tivoli Workload Scheduler no ha enviado el trabajo,
el ID de trabajo JES no está disponible. El Gateway entra el nombre en el Espacio
de tabla y espera que la información acerca del trabajo aparezca en los registros
SMF pasados a través de la salida IEFU84.
Utilización de CA-7
Cuando se utiliza CA-7, se aplica lo siguiente.
Inicio de trabajos CA-7
Para iniciar y supervisar un trabajo CA-7, Tivoli Workload Scheduler pasa el
nombre del trabajo y, opcionalmente, el schedID de CA-7, que desea que se ejecute
al Gateway z/OS. En el momento de la petición de envío, el Gateway recibe el
Número de trabajo CA-7 que se utiliza para hacer un seguimiento de toda la
actividad subsiguiente para el trabajo. Es importante tener en cuenta que CA-7 en
si debe estar autorizado para aceptar comandos desde la consola para que este
mecanismo funcione. Consulte la documentación de CA-7 para ver una explicación
de los comandos de Modificación y de Inicio de sesión para obtener más
información sobre esta función.
Estados de trabajo para CA-7
La tabla siguiente lista los estados de trabajo CA-7 con respecto a Tivoli Workload
Scheduler.
Estado de
trabajo Tivoli
Workload
Scheduler
Estado de trabajo
CA-7 Comentario
intro na Workload Scheduler está iniciando el método.
wait Request Queue o
Ready Queue
El estado wait también puede indicar que el
trabajo se ha trasladado de la Cola activa a la
Cola de petición como resultado de una
terminación anómala. El trabajo permanece en la
Cola de petición, con una solicitud de reinicio,
hasta que el operador lo reinicia o lo cancela.
exec Active Queue
160 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Estado de
trabajo Tivoli
Workload
Scheduler
Estado de trabajo
CA-7 Comentario
succ Completed El código de condición del trabajo satisface los
criterios de finalización de la definición de trabajo
Tivoli Workload Scheduler.
abend na El código de condición del trabajo no satisface los
criterios de finalización del trabajo en la
definición de trabajo Tivoli Workload Scheduler.
Vea también la nota de abajo.
extrn na Estado desconocido. Sólo puede producirse
cuando se comprueba un trabajo que se utiliza
como dependencia. Vea también la nota de abajo.
Nota: Si el trabajo permanece en los estados abend o extrn, puede ser debido a
una violación de seguridad en z/OS. Compruebe el trabajo en el sistema
z/OS.
Comprobación de trabajos CA-7
Para comprobar un trabajo CA-7 que Tivoli Workload Scheduler no ha iniciado,
Tivoli Workload Scheduler pasa el nombre del trabajo y, opcionalmente, el schedID
de CA-7, al Gateway. Para ver si CA-7 está planificando o ejecutando actualmente
el trabajo, el Gateway busca en las siguientes colas CA-7, por este orden: Cola de
petición, Cola preparada y Cola activa. Si no se encuentra el trabajo, Tivoli
Workload Scheduler vuelve a comprobar a intervalos definidos por el valor de bm
check status en su archivo de Opciones locales.
Otros consejos para CA-7
v Cuando se utiliza CA-7, CA7USER también debe ser un ID válido de UNIX.
v El límite de las versiones anteriores del producto que forzaba a los usuarios a
identificar exclusivamente las ocurrencias cuando se definían trabajos CA-7 en
Tivoli Workload Scheduler (es decir, agregando el SCHID y/u operandos SPAN)
se ha eliminado ahora gracias al nuevo parámetro de inicialización CA7SPAN.
La lógica detrás de la implementación de CA7SPAN es la siguiente: si se
especifica SPAN en la definición Tivoli Workload Scheduler de un trabajo,
CA7SPAN se pasa por alto. Si no se especifica SPAN (o no se puede especificar,
como en el caso de los trabajos iniciados por Tivoli Workload Scheduler),
entonces se toma en consideración CA7SPAN y se utiliza su valor en las
consultas a CA7 como SPAN. Esto salva la limitación según la cual cada
aparición debe identificarse exclusivamente y permite iniciar desde Tivoli
Workload Scheduler el mismo trabajo con el mismo SCHID, con la única
condición de que el intervalo entre los 2 envíos debe ser mayor que el valor
especificado con CA7SPAN.
Es importante conocer que, si se especifica, se utilizará el valor de CA7SPAN en
todas las consultas a CA7 (si hacen referencia a trabajos que Tivoli Workload
Scheduler ha iniciado o si se emiten para comprobar las dependencias inter-red
para trabajos que Tivoli Workload Scheduler no ha iniciado) con la única
excepción de los trabajos que han especificado SPAN en su definición Tivoli
Workload Scheduler.
v Si ejecuta productos– como AFOPER– que suprime los mensajes de consola,
asegúrese de que no suprimen los mensajes de CA-7.
Capítulo 26. Información de referencia 161
Utilización en OPC o Tivoli Workload Scheduler for z/OS
Cuando se utiliza en OPC o en Tivoli Workload Scheduler for z/OS, se aplica lo
siguiente.
Inicio de trabajos OPC o Tivoli Workload Scheduler for z/OS
Para iniciar y supervisar un trabajo OPC o Tivoli Workload Scheduler for z/OS,
Tivoli Workload Scheduler pasa el nombre de aplicación, y otros parámetros
opcionales, que desea ejecutar al Gateway z/OS. Si existe en la base de datos OPC
o Tivoli Workload Scheduler for z/OS, la aplicación se inserta en el plan actual.
Los parámetros de llegada de entrada, llegada del plazo límite, prioridad y
resolución automática de dependencias, si se incluyen, prevalecen sobre cualquier
valor especificado en OPC o Tivoli Workload Scheduler for z/OS.
A intervalos definidos por el valor CheckInterval en el archivo de opciones del
método, Tivoli Workload Scheduler comprueba el estado de la apariencia
(aplicación) en OPC o Tivoli Workload Scheduler for z/OS.
Estados de utilización de OPC o Tivoli Workload Scheduler for
z/OS
La tabla siguiente lista los estados de la utilización de OPC o Tivoli Workload
Scheduler for z/OS con respecto a Tivoli Workload Scheduler.
Estado de trabajo Tivoli Workload
Scheduler
Estado de utilización de OPC o Tivoli Workload
Scheduler for z/OS
wait pending (pendiente)
wait undecided (sin decidir)
wait wait (espera)
wait ready (listo)
exec started (iniciado)
succ complete (finalizado)
abend interrupted (interrumpido)
abend error (error)
abend deleted (suprimido)
abend na
extrn na
Estados de apariciones de OPC o Tivoli Workload Scheduler for
z/OS
La tabla siguiente lista los estados de apariciones de utilización de OPC o Tivoli
Workload Scheduler for z/OS con respecto a Tivoli Workload Scheduler.
Estado de secuencia de
trabajo Tivoli Workload
Scheduler
Estado de aparición OPC o Tivoli Workload Scheduler for
z/OS
wait pending (pendiente)
wait undecided (sin decidir)
exec started (iniciado)
succ complete (finalizado)
abend error (error)
abend deleted (suprimido)
162 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Estado de secuencia de
trabajo Tivoli Workload
Scheduler
Estado de aparición OPC o Tivoli Workload Scheduler for
z/OS
abend N/A
extrn N/A Estado desconocido. Sólo puede producirse cuando se
comprueba un trabajo que se utiliza como dependencia. Vea
también la nota de abajo.
Comprobación de trabajos OPC o Tivoli Workload Scheduler for
z/OS
Para comprobar un trabajo OPC o Tivoli Workload Scheduler for z/OS que Tivoli
Workload Scheduler no ha iniciado, se pasa el nombre de aplicación y,
opcionalmente, la utilización al Gateway. Se efectúa una comprobación para ver si
la aparición o la utilización está en el plan actual. Si no se encuentra, Tivoli
Workload Scheduler vuelve a comprobar un intervalo definido por el valor bm
check status en su archivo de Opciones locales.
Comprobación de archivos en z/OS
La existencia de un archivo puede utilizarse como una dependencia en Tivoli
Workload Scheduler. Para comprobar la existencia de un archivo en z/OS, Tivoli
Workload Scheduler pasa el nombre de archivo al Gateway. El nombre de archivo
se asigna con DISP=OLD, y se considera que existe si se aplican las condiciones
siguientes:
v Los datos están catalogados
v Está asignado
v No lo utiliza otra tarea
Si el conjunto de datos no existe, Tivoli Workload Scheduler continúa esperando y
comprobando el archivo a intervalos predeterminados.
Tenga en cuenta que Tivoli Workload Scheduler sólo puede utilizar nombres de
conjuntos de datos completamente calificados para archivos no particionados. Si se
va a utilizar un nombre de Grupo de datos de generación, debe ser un nombre
completamente calificado y no un nombre relativo (por ejemplo, xxxxx.xxxxx(-1) no
puede utilizarse).
Consideraciones de temporización
Cuando se comprueban trabajos z/OS que Tivoli Workload Scheduler no ha
iniciado, algunos puntos de temporización son importantes para garantizar que las
dependencias de trabajos asociados se resuelvan correctamente. Estos problemas
surgen como resultado de la concepción de un día de proceso de Tivoli Workload
Scheduler. Puede encontrar una explicación completa en la publicación Tivoli
Workload Scheduler - Guía de consulta. En resumen, Tivoli Workload Scheduler
vuelve a generar su planificación de producción cada día a una hora
preestablecida; por ejemplo, a las 6:00 de cada mañana. Para mantener una relación
de trabajo entre los trabajos que se ejecutan bajo z/OS y los trabajos que se
ejecutan bajo Tivoli Workload Scheduler, es necesaria alguna sincronización entre
los dos entornos. Por ejemplo, si un trabajo z/OS se inicia fuera de Tivoli
Workload Scheduler y se completa antes de iniciar el día de proceso de Tivoli
Workload Scheduler, no estará visible para Tivoli Workload Scheduler y no deberá
utilizarse en una dependencia de trabajo Tivoli Workload Scheduler. Tivoli
Workload Scheduler no intenta determinar el estado de los trabajos que se han
completado antes del inicio del día.
Capítulo 26. Información de referencia 163
Si no se toma en cuenta la sincronización, tal como se explica arriba, Tivoli
Workload Scheduler puede esperar indefinidamente para resolver una dependencia
de trabajo. Un problema similar puede producirse como resultado de una anomalía
en la comunicación entre los entornos z/OS y Tivoli Workload Scheduler que
impide a Tivoli Workload Scheduler determinar el estado de un trabajo z/OS para
satisfacer una dependencia de trabajo.
Información de diagnóstico
Los trabajos z/OS enviados por Tivoli Workload Scheduler no pueden completarse
debido a varias razones. El paso en el proceso de envío en el que un trabajo falla
determina cuánta información está disponible y Tivoli Workload Scheduler la
proporciona de la manera siguiente:
v Si un trabajo falla antes de que se inicie realmente (normalmente como resultado
de un JCL o un problema de seguridad), Tivoli Workload Scheduler reconoce
que ya no existe y lo marca como terminado de forma anómala en las pantallas
de Console Manager (Conman). No proporciona más información.
v Si un trabajo falla después de iniciarse, Tivoli Workload Scheduler:
1. Obtiene su código de condición y el código de terminación anómala del
usuario, si existe
2. Los graba en el archivo de lista estándar del trabajo
3. Marca el trabajo como abend en las pantallas Console Manager (Conman) o
Job Scheduling Console
Las listas estándar de trabajo pueden visualizarse con Console Manager
(Conman) y con Job Scheduling Console.
Mensajes del gateway
El programa de gateway z/OS crea dinámicamente mensajes informativos. Junto
con la información específica de la condición, los mensajes pueden incluir:
v Indicación de la hora en el formato aammdd hhmmss
v Nombre del módulo
v Etiqueta con el módulo
v Nombre de macro
v Código de razón (registro 0)
v Código de retorno (registro 15)
Los mensajes de gateway z/OS se listan más abajo. Para los nombres de módulo
(módulo), consulte más abajo.
EEWI01E aammdd hhmmss módulo FAILED, MACRO macro NEAR LABEL etiqueta WITH RETURN
CODE = código & REASON CODE = código
EEWI02E aammdd hhmmss módulo FAILED, MACRO macro NEAR LABEL etiqueta WITH RETURN
CODE = código & ERROR NUMBER = err
EEWI03I aammdd hhmmss módulo ISSUED, MACRO macro NEAR LABEL etiqueta TO OBTAIN
SOCKET DESCRIPTOR = desc
EEWI04I aammdd hhmmss módulo ISSUED, MACRO macro NEAR LABEL etiqueta
TO OBTAIN HOSTNAME = host
EEWI05I aammdd hhmmss módulo TCPIP ADDRESS = direcciónip
EEWI06I aammdd hhmmss módulo name = nombre
EEWI07I aammdd hhmmss módulo ISSUED, MACRO macro NEAR LABEL etiqueta FOR núm
CHARACTER MESSAGE = msj
EEWI08S aammdd hhmmss module FAILED AT OFFSET desplaz
164 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
EEWI09E aammdd hhmmss módulo FAILED, MACRO macro NEAR LABEL etiqueta WITH RETURN
CODE = código
EEWI10S aammdd hhmmss módulo ABENDED WITH ASSOCIATED REASON CODE código
EEWI11I aammdd hhmmss módulo CONSOLE nombre ACTIVATED WITH CONSOLE ID id
EEWI12I aammdd hhmmss módulo SUBTASK nombre COMPLETED WITH COMPLETION CODE código
EEWI13I aammdd hhmmss módulo CALL TO "nombre" NEAR LABEL etiqueta COMPLETED WITH
COMPLETION CODE código
EEWI14S aammdd hhmmss módulo INVALID DATA SPACE FOUND NEAR LABEL etiqueta
EEWI15E aammdd hhmmss módulo DATASET "cdatos" DDNAME "dd" FAILED TO OPEN
NEAR LABEL etiqueta
EEWI16I aammdd hhmmss módulo SUBMITTED JOB "trabajo" WITH JES IDENTIFICATION "id"
EEWI17I aammdd hhmmss módulo PEERADDRESS = direcciónip
EEWI18E aammdd hhmmss módulo INVALID TERMINATOR término
EEWI19E aammdd hhmmss módulo NEAR LABEL etiqueta INVALID VALUE FOUND nombre = valor
EEWI20E aammdd hhmmss módulo NEAR LABEL etiqueta FAILED TO FIND ACTIVE SMF IEFU84
EXIT
EEWI21E aammdd hhmmss msjerr
EEWI22I aammdd hhmmss TASK tarea MODULE módulo ISSUED, MACRO macro NEAR
LABEL etiqueta TO CLOSE SOCKET DESCRIPTOR zócalo
EEWI24E aammdd hhmmss módulo NEAR LABEL etiqueta
EEWI25I aammdd hhmmss módulo NEAR LABEL etiqueta APPLICATION apl WAS INSERTED IN
CURRENT PLAN WITH INPUT ARRIVAL DATE AND TIME horafechalle
EEWI26I aammdd hhmmss módulo NEAR LABEL etiqueta JOB nombretrabajo (idtrabajo)
EEWI27I aammdd hhmmss APPLICATION apl WAS INSERTED IN CURRENT
PLAN WITH INPUT ARRIVAL DATE AND TIME horafechallegent
EEWI28W aammdd hhmmss APPLICATION apl WAS NOT INSERTED IN
CURRENT PLAN WITH INPUT ARRIVAL DATE AND TIME horafechallegent
EEWI29I aammdd hhmmss TASK tarea MODULE módulo ISSUED, MACRO macro NEAR LABEL
etiqueta WITH RETURN CODE = código AND ERROR NUMBER = err
EEWI30S aammdd hhmmss module CA7SPAN MUST BE 4 DIGITS IN FORMAT HHMM
Los nombres de módulo son:
Nombre de módulo Descripción
EEWPRE84 Salida SMF anterior
EEWTCP00 Rutina de proceso principal
EEWTCP01 Vehículo de prueba de servidor
EEWTCP02 Rutina de construcción de espacio de datos principal
EEWTCP05 Establece la rutina ESTAE para emitir mensaje de anomalía
EEWTCP07 Busca el nombre del conjunto de datos asociado a abrir ACB/DCB
EEWTCP08 Busca el nombre del conjunto de datos asociado a DDNAME
EEWTCP10 Inicializa y examina variables
EEWTCP15 Localiza e inicializa los bloques de control
EEWTCP20 Localiza e inicializa los bloques de control
EEWTCP21 Vehículo de prueba de cliente
EEWTCP22 Vehículo de prueba de cliente
EEWTCP23 Vehículo de prueba de cliente
EEWTCP25 Servidor simultáneo
EEWTCP26 Proveedor TCPIP de Interlink del servidor simultáneo
Capítulo 26. Información de referencia 165
Nombre de módulo Descripción
EEWTCP27 Servidor simultáneo de la pila TCPIP de Openconnect
EEWTCP30 Tarea de servidor secundario
EEWTCP31 Tarea de servidor secundario para la pila TCPIP de Interlink
EEWTCP32 Tarea de servidor secundario
EEWTCP84 Salida de registro SMF para SMFEWTM
EEWTCP87 Interfaz OPC
EEWTCP88 Anotación de interfaz OPC
EEWTCP89 CA7 BTI
EEWTCP90 Emite el comando y espera la respuesta
EEWTCP91 Emite TERROR para formatear mensajes y emite WTOS
EEWTCP92 Busca una subcadena dentro de una cadena de caracteres
EEWTCP93 Emite el comando CA-7 y espera una respuesta
EEWTCP94 Salida STIMER para anotar ECB que se ha pasado en parámetro
EEWTCP95 Llama a IKJEFF02 para extraer el búfer utilizando EEWTCP99
EEWTCP96 Rutina ESTAE para emitir un mensaje de anomalía
EEWTCP97 Llama a IKJEFF19 (DAIRFAIL/VSAMFAIL) para emitir un
mensaje
EEWTCP98 Llama a IKJEFF02 para emitir un mensaje desde EEWTCP99
EEWTCP99 Tabla de mensajes
EEWTCPC7 Comprueba el trabajo CA7
EEWTCPCA Comprueba el manejador de peticiones de aplicación
EEWTCPCF Comprueba el manejador de peticiones de archivo
EEWTCPCJ Comprueba el manejador de peticiones de trabajo
EEWTCPCO Comprueba el manejador de peticiones de operación
EEWTCPCV Enumera el trabajo
EEWTCPED Cifra/descifra la cadena de caracteres
EEWTCPEJ Enumera el manejador de peticiones de trabajo
EEWTCPFJ Libera el manejador de peticiones de trabajo
EEWTCPIA Inserta aplicación
EEWTCPIE Inicialización de cadena de caracteres
EEWTCPKJ Mata el manejador de peticiones de trabajo
EEWTCPKO Suprime la aplicación OPC
EEWTCPL7 Inicia el manejador de peticiones de trabajo CA-7
EEWTCPLJ Inicia el manejador de peticiones de trabajo
EEWTCPLO Inserta aplicación OPC
EEWTCPQ7 Consulta el manejador de peticiones de trabajo CA-7
EEWTCPQJ Consulta el manejador de peticiones de trabajo
EEWTCPQO Consulta la aplicación OPC
EEWTCPQS Consulta el manejador de peticiones de subsistema
EEWTCPRC Código de retorno
166 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Nombre de módulo Descripción
EEWTCPSC Terminación anómala del sistema
EEWTCPSE Cifrado/descifrado de cadena de caracteres
EEWTCPUC Terminación anómala de usuario
EEWTCPWT Espera un período de tiempo especificado
EEWTCPXX Manejador de peticiones no válido
Como ayuda a la resolución de problemas, asegúrese de obtener el registro JES
para las tareas iniciadas EEWSPACE y EEWSERVE. Esto le ayudará a determinar el
contexto en el que se ha emitido el mensaje. Dependiendo de la interfaz de
planificación que utilice, puede obtener información de ayuda adicional en otros
registros. Por ejemplo, si utiliza CA-7, debe obtener lo siguiente:
v El registro CA-7
v El registro de consola para el intervalo que cubre el período de prueba
v El registro del trabajo que contiene el error (si es este el caso)
v El archivo de script UNIX relacionado con ese trabajo
Capítulo 26. Información de referencia 167
168 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Parte 6. Servicios comunes
© Copyright IBM Corp. 2000, 2003 169
170 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 27. Consulta de agente ampliado
Este capítulo describe la interfaz del agente ampliado y ofrece información para los
programadores que deben crear métodos de acceso personalizados.
¿Qué son los agentes ampliados?
Los agentes ampliados se utilizan para ampliar las funciones de planificación de
trabajos de Tivoli Workload Scheduler a otros sistemas y aplicaciones.
Un agente ampliado se define como una estación de trabajo que tiene un host y un
método de acceso. El host es cualquier otra estación de trabajo que no sea el agente
ampliado. El método de acceso es un script o programa suministrado por IBM o el
usuario que el host ejecuta siempre que se hace referencia al agente ampliado en el
plan de producción. Por ejemplo, para iniciar un trabajo en un agente ampliado, el
host ejecuta el método de acceso, pasándole detalles del trabajo como opciones de
línea de comandos. El método de acceso se comunica con el sistema externo o
aplicación para iniciar el trabajo y devolver el estado del trabajo.
Definición de estación de trabajo
Cada agente ampliado debe tener una definición de estación de trabajo lógica. Esta
estación de trabajo lógica debe estar alojada en una estación de trabajo física de
Tivoli Workload Scheduler, ya sea una estación de trabajo FTA, un gestor de
dominio o un maestro. La definición de la estación de trabajo de agente ampliado
hace referencia al nombre de método de acceso y la estación de trabajo host.
Cuando se inician trabajos en la estación de trabajo de agente ampliado, se llamará
al método de acceso y pasará la información del trabajo al sistema externo.
Interfaz de método de acceso
La interfaz entre Tivoli Workload Scheduler y un método de acceso consiste de la
información que se pasa al método en la línea de comandos y de los mensajes
devueltos al planificador en stdout.
Sintaxis de la línea de comandos del método
El host del planificador ejecuta un método de acceso utilizado la siguiente sintaxis
de la línea de comandos:
nombremétodo -t opcionestarea -- cadenatarea
donde:
nombremétodo
Especifica el nombre de archivo del método de acceso. Todos los métodos
de acceso deben almacenarse en el directorio: inicioTWS/methods
-t tarea Especifica la tarea que debe realizarse, donde tarea es una de las siguientes:
LJ Inicia un trabajo.
MJ Gestiona un trabajo iniciado anteriormente. Utilice esta opción para
la resincronización si una tarea LJ anterior ha terminado
inesperadamente.
© Copyright IBM Corp. 2000, 2003 171
CF Comprueba la disponibilidad de un archivo. Utilice esta opción
para comprobar las dependencias de apertura del archivo.
GS Obtiene el estado de un trabajo. Utilice esta opción para comprobar
las dependencias de continuación.
opciones
Especifica las opciones asociadas a la tarea. Consulte el apartado “Opciones
de tarea” para obtener más información.
cadenatarea
Una cadena de un máximo de 255 caracteres asociada a la tarea. Consulte
el apartado “Opciones de tarea”.
Opciones de tarea
Las opciones de tarea se listan en la tabla siguiente. Una X significa que la opción
es válida para la tarea.
Tarea Opciones
Cadena
de tarea
-t -c -n -p -r -s -d -l -o -j -q -w -S
LJ X X X X X X X X X X cadenalj
MJ X X X X X X X X X cadenamj
CF X X X X cadenacf
GS X X X X X X cadenags
-c agentex,host,maestro
Especifica los nombres de planificador del agente ampliado, el host y el
gestor de dominio maestro separados por comas.
-n nombrenodo
Especifica el nombre de nodo del sistema asociado al agente ampliado, si
hay alguno. Se define en el campo Nodo de la definición de estación de
trabajo del agente ampliado.
-p númeropuerto
Especifica el número de puerto TCP asociado al agente ampliado, si existe.
Se define en el campo Dirección TCP de la definición de la estación de
trabajo del agente ampliado.
-r ejecuciónactual,ejecuciónespecífica
Especifica el número de ejecución actual del planificador y el número de
ejecución específica asociada al trabajo separados por una coma. Los
números de ejecución actual y específica pueden ser diferentes si el trabajo
se ha transportado desde una ejecución anterior.
-s cadenasectr
Especifica el nombre de la secuencia del trabajo.
-d fechaplanif,época
Especifica la fecha de planificación (aammdd) y la época equivalente,
separadas por una coma.
-l usuario
Especifica el nombre de usuario del trabajo. Esto se define en el campo
Inicio de sesión de la definición de trabajo.
172 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
-o stdlist
Especifica todo el nombre de ruta del archivo de lista estándar del trabajo.
Cualquier salida del trabajo debe grabarse en este archivo.
-j nombretrabajo,id
Especifica el nombre del trabajo y el identificador exclusivo asignado por
el planificador, separados por una coma. El nombre se define en el campo
Nombre de trabajo de la definición de trabajo.
-q calificador
Especifica el calificador que debe utilizarse en un comando de prueba
emitido por el método en el archivo.
-w tiempoespera
Especifica el período de tiempo, en segundos, que el planificador esperará
para obtener una respuesta de un trabajo externo antes de enviar una señal
SIGTERM al método de acceso. El valor predeterminado es 300.
-S nuevo nombre
Especifica que el trabajo se vuelve a ejecutar utilizando este nombre en
lugar del nombre de trabajo original. En un script de trabajo, puede
utilizar el comando jobinfo para devolver el nombre de trabajo y ejecutar
el script de forma diferente para cada iteración. Consulte la descripción del
comando conman rerun en la publicación IBM Tivoli Workload Scheduler -
Guía de consulta para obtener más información.
-- cadenalj
Se utiliza con la tarea LJ. La cadena de los campos Archivo de script o
Comando de la definición de trabajo.
-- cadenamj
Se utiliza con la tarea MJ. La información proporcionada al planificador
por el método en una respuesta %CJ a una tarea LJ. Normalmente,
identifica el trabajo que se ha iniciado. Por ejemplo, un método Unix
puede proporcionar la identificación del proceso (PID) del trabajo que ha
iniciado y que el planificador enviará como parte de una tarea MJ.
-- cadenacf
Se utiliza con la tarea CF. Para una dependencia de apertura de archivo, la
cadena de caracteres del campo Archivos de apertura de la definición de
secuencia de trabajos.
-- cadenags
Se utiliza con la tarea GS. Especifica el trabajo cuyo estado se comprueba.
El formato es el siguiente:
trabajocontinuación[,idtrabajo]
donde:
trabajocontinuación
La cadena de caracteres de la lista Planificación/Trabajo de
continuación de la definición de secuencia de trabajos.
idtrabajo
Un identificador de trabajo opcional recibido por el planificador en
una respuesta %CJ a una tarea GS anterior.
Capítulo 27. Consulta de agente ampliado 173
Mensajes de respuesta del método
Los métodos devuelven información a Tivoli Workload Scheduler en mensajes que
se graban en stdout. Cada línea que empieza por un signo de porcentaje (%) y que
finaliza en nueva línea se interpreta como mensaje. Los mensajes tienen el formato
siguiente:
%CJ estado [cadenamj | idtrabajo]
%JS [horacpu]
%RC rc
%UT [mensajeerror]
donde:
CJ Cambia el estado del trabajo.
estado El estado al que cambia el trabajo. Todos los estados de trabajos
del planificador son válidos excepto hold y ready. Para la tarea
GS, también son válidos los estados siguientes:
ERROR
Se ha producido un error.
EXTRN
El estado es desconocido.
cadenamj
Una cadena de hasta 255 caracteres que el planificador incluirá en
cualquier tarea MJ asociada al trabajo. Consulte el apartado 173.
idtrabajo
Una cadena de hasta 64 caracteres que el planificador incluirá en
cualquier tarea GS asociada al trabajo. Consulte el apartado 173.
JS [horacpu]
Indica la finalización satisfactoria de un trabajo y proporciona su tiempo
de ejecución transcurrido en segundos.
RC rc rc es un número que Tivoli Workload Scheduler interpreta como el código
de retorno del trabajo de agente ampliado. El código de retorno sólo se
toma en cuenta si se ha especificado una condición de código de retorno
en la definición del trabajo de agente ampliado. Si no es este caso, se pasa
por alto y la presencia del mensaje %JS [horacpu] indica la finalización
satisfactoria del trabajo del agente ampliado. De igual forma, si el método
no envía el mensaje %RC, la finalización satisfactoria del trabajo de agente
ampliado se indica por la presencia del mensaje %JS [horacpu].
UT [mensajeerror]
Indica que el método no da soporte a la tarea solicitada. Visualiza una
cadena de hasta 255 caracteres que el planificador incluirá en su mensaje
de error.
Archivo de opciones del método
Puede utilizar un archivo de opciones del método para especificar información de
inicio de sesión especial y otras opciones. El planificador lee el archivo, si existe,
antes de ejecutar un método. Si el archivo se modifica después de iniciar el
planificador, los cambios surtirán efecto cuando se detiene y reinicia.
174 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
El archivo puede contener opciones de planificador y otra información del método.
Las opciones que el planificador reconoce son las siguientes:
LJuser=nombreusuario
CFuser=nombreusuario
GSuser=nombreusuario
GStimeout=segundos
donde:
LJuser=nombreusuario
Especifica el inicio de sesión que debe utilizarse para las tareas LJ y MJ. El
valor predeterminado es el inicio de sesión desde la definición de trabajo.
CFuser=nombreusuario
Especifica el inicio de sesión que debe utilizarse para la tarea CF. El valor
predeterminado es root para Unix y para Windows es el nombre de
usuario de la cuenta en la que se ha instalado el planificador.
GSuser=nombreusuario
Especifica el inicio de sesión que debe utilizarse para las tareas GS. El
valor predeterminado es root para Unix y para Windows es el nombre de
usuario de la cuenta en la que se ha instalado el planificador.
GStimeout=segundos
Especifica el período de tiempo, en segundos, que el planificador espera
una respuesta antes de matar el método de acceso. El valor
predeterminado es 300 segundos.
Nota: Si el host del agente ampliado es un sistema Windows, estos usuarios deben
definirse como objetos de usuario del planificador.
El archivo de opciones debe tener el mismo nombre de ruta que su método de
acceso, con la extensión de archivo .opts. Por ejemplo, el nombre de ruta Windows
de un archivo de opciones para un método denominado netmth es:
v inicioTWS\methods\netmth.opts (global).
v inicioTWS\methods\<nombreCPU>_netmth.opts (local).
Ejecución del método
Los temas siguientes describen el intercambio entre Tivoli Workload Scheduler y
un método de acceso.
Tarea Iniciar trabajo (LJ)
La tarea LJ da instrucciones al método del agente ampliado para que inicie un
trabajo en un sistema externo o aplicación. Antes de ejecutar el método, Tivoli
Workload Scheduler establece un entorno de ejecución. El parámetro LJuser se lee
en el archivo de opciones del método para determinar la cuenta de usuario con la
que debe ejecutarse el método. Si el parámetro no está presente o el archivo de
opciones no existe, se utiliza la cuenta de usuario especificada en el campo Inicio
de sesión de la definición de trabajo. Además, se establecen las variables de
entorno siguientes:
Capítulo 27. Consulta de agente ampliado 175
HOME
El directorio inicial del usuario de inicio de sesión.
LOGNAME
El nombre del usuario de inicio de sesión.
PATH Para Unix, se establece en /bin:/usr/bin. Para Windows, se establece en
%SYSTEM%\SYSTEM32.
TZ El huso horario.
Si no se puede ejecutar el método, el trabajo se coloca en estado fail.
Cuando el método está en ejecución, graba los mensajes en stdout e indican el
estado del trabajo en el sistema externo. Los mensajes se resumen en la tabla
siguiente.
Tarea Respuesta del método Acción de Tivoli Workload Scheduler
LJ y MJ %CJ estado [cadenamj] Establece el estado del trabajo en estado.
Incluye cadenamj en cualquier tarea MJ
subsiguiente.
%JS [horacpu] Establece el estado del trabajo en succ.
Código de salida=no cero Establece el estado del trabajo en abend.
%UT [mensajeerror] y Código
de salida=2
Establece el estado del trabajo en abend y
visualiza mensajeerror.
La secuencia típica consiste en uno o varios mensajes %CJ que indican los cambios
en el estado del trabajo y, después, un mensaje %JS antes de las salidas del método
para indicar que el trabajo ha finalizado satisfactoriamente. Si el trabajo no es
satisfactorio, el método debe salir sin grabar el mensaje %JS. Un método que no da
soporte a la tarea LJ, graba un mensaje %UT en stdout y sale con el código de
salida 2.
Tarea Gestionar trabajo (MJ)
La tarea MJ se utiliza para la sincronización con un trabajo iniciado previamente si
el planificador determina que la tarea LJ ha terminado inesperadamente. El
planificador configura el entorno de la misma manera que para la tarea LJ y para
en la cdenamj. Consulte el apartado “Tarea Iniciar trabajo (LJ)” en la página 175
para obtener más información.
Si el método localiza el trabajo especificado, responde con los mismos mensajes
que una tarea LJ. Si el método no puede localizar el trabajo, sale con un código de
salida distinto de cero, lo que provoca que el planificador ponga el trabajo en
estado abend.
Matar un trabajo
Mientras se ejecutan las tareas LJ o MJ, el método debe atrapar una señal
SIGTERM (señal 15). La señal se envía cuando un operador emite un comando Kill
mediante el gestor de la consola del planificador. Al recibir la señal, el método
debe intentar detener (matar) el trabajo y, a continuación, salir sin grabar ningún
mensaje %JS.
Tarea Comprobar archivo (CF)
La tarea CF pide al método de agente ampliado que compruebe la disponibilidad
de un archivo en el sistema externo. Antes de ejecutar el método, el planificador
176 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
establece un entorno de ejecución. El parámetro CFuser se lee en el archivo de
opciones del método para determinar la cuenta de usuario con la que debe
ejecutarse el método. Si el parámetro no está presente o el archivo de opciones no
existe, se utiliza el usuario root en Unix y, en Windows, el nombre de usuario de la
cuenta en la que se ha instalado el planificador. Si el método no puede ejecutarse,
se marca la dependencia de apertura de archivo como anómala, es decir, el estado
del archivo se establece en NO y no se permite ejecutar ningún trabajo ni
secuencia de trabajos dependiente.
Una vez en ejecución, el método ejecutará un comando de prueba, o el equivalente,
en el archivo utilizando el calificador que se le ha pasado en la opción de línea de
comandos -q. Si la prueba de archivo es verdadera, el método sale con el código de
salida cero. Si la prueba de archivo es falsa, el método sale con un código de salida
diferente de cero. Esto se resume en la tabla siguiente.
Tarea Respuesta del método Acción de Tivoli Workload Scheduler
CF Código de salida=0 Establece el estado del archivo en YES.
Código de salida=no cero Establece el estado del archivo en NO.
%UT [mensajeerror] y Código
de salida=2
Establece el estado del archivo en NO.
Un método que no da soporte a la tarea CF grabará un mensaje %UT en stdout y
saldrá con el código de salida 2.
Tarea Obtener estado (GS)
La tarea GS indica al método del agente ampliado que compruebe el estado de un
trabajo. Esto es necesario cuando otro trabajo depende de la finalización
satisfactoria de un trabajo externo. Antes de ejecutar el método, se lee el parámetro
GSuser del archivo de opciones del método para determinar la cuenta de usuario
con la que se debe ejecutar el método. Si el parámetro no está presente o el archivo
de opciones no existe, se utilizará el usuario root en Unix y, en Windows, el
nombre de usuario de la cuenta en la que se ha instalado el planificador. Si no se
puede ejecutar el método, no se permitirá la ejecución del trabajo o la secuencia de
trabajos dependiente. Si está disponible un idtrabajo de una tarea GS anterior, se
pasará al método.
El método comprueba el estado del trabajo especificado y lo devolverá en un
mensaje %CJ grabado en stdout. Después saldrá con el código de retorno cero. A
intervalos especificados por la opción local bm check status, se volverá a ejecutar
el método con una tarea GS hasta que devuelva uno de los estados siguientes:
abend El trabajo ha terminado de forma anómala.
succ El trabajo se ha completado satisfactoriamente.
cancl El trabajo se ha cancelado.
done El trabajo ha terminado, pero no se conoce si ha sido satisfactorio o
anómalo.
fail El trabajo no se ha podido ejecutar.
error Se ha producido un error en el método mientras se comprobaba el estado
del trabajo.
extrn La comprobación del trabajo ha fallado o el estado del trabajo no se ha
podido determinar.
Capítulo 27. Consulta de agente ampliado 177
Tenga en cuenta que GStimeout del archivo de opciones del método especifica el
tiempo que el planificador esperará una respuesta antes de matar el método.
Consulte el apartado “Archivo de opciones del método” en la página 174 para
obtener más información.
Las respuestas del método se resumen en la tabla siguiente:
Tarea Respuesta del método Acción de Tivoli Workload Scheduler
GS %CJ estado [idtrabajo] Establece el estado del trabajo en estado e
incluye el idtrabajo en cualquier tarea GS
subsiguiente.
%UT [mensajeerror] y Código
de salida=2
El estado del trabajo no varía.
Un método que no da soporte a la tarea GS grabará un mensaje %UT en stdout y
saldrá con el código de salida 2.
Comando cpuinfo
El comando cpuinfo puede utilizarse en un método de acceso para devolver
información de una definición de estación de trabajo. Consulte la publicación IBM
Tivoli Workload Scheduler - Guía de consulta para obtener información completa sobre
el comando.
Resolución de problemas
Los temas siguientes se proporcionan para ayudar a resolver los problemas y a
depurar los problemas de agente ampliado y método de acceso.
Mensajes de error de la lista estándar de trabajo
Todos los mensajes de salida de un método de acceso, excepto los que empiezan
por un signo de porcentaje (%), se graban en el archivo de lista estándar el trabajo
(stdlist). Para las tareas GS y CF que no están asociadas a trabajos de planificador,
los mensajes se graban en el archivo de lista estándar de planificador. Para obtener
información relativa a un problema de cualquier clase, compruebe estos archivos.
Método no ejecutable
Si un método de acceso no puede ejecutarse, ocurrirá lo siguiente:
v Para las tareas LJ y MJ, el trabajo se colocará en estado fail.
v Para la tarea CF, la dependencia de archivo no se resolverá y el trabajo
dependiente permanecerá en estado hold.
v Para la tarea GS, la dependencia de trabajo no se resolverá y el trabajo
dependiente permanecerá en estado hold.
Para obtener más información, revise los archivos de lista estándar (stdlist) para el
trabajo y el planificador.
Mensajes de Console Manager
Este mensaje de error se visualiza si se emiten los comandos start, stop, link o
unlink para un agente ampliado:
Error al ejecutar comando: No está implementado para agentes
ampliados. [2202.58]
178 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Este error no se visualiza si se selecciona un agente ampliado como resultado de
utilizar caracteres comodín.
Mensajes de Composer y Compiler
Los siguientes mensajes de error se generan cuando Composer encuentra que la
sintaxis de una definición de estación de trabajo no es válida:
ACCESS METHOD no es sintácticamente válido [1116.45]
Palabra clave ACCESS duplicada [1116.46]
Falta ACCESS METHOD o no es válido [1116.47]
Si se define un agente ampliado con un método de acceso pero sin un host, se
visualizará el mensaje siguiente:
"El método necesita una CPU de host"
Mensajes de Jobman
Para los agentes ampliados, los mensajes de error, de aviso e informativos se
graban en el archivo stdlist de Jobman.
Un inicio de trabajo satisfactorio genera el mensaje siguiente:
Trabajo nombretrabajo iniciado para la estacióntrabajo, #Jidtrabajo
para el usuario nombreusuario.
Si no se puede iniciar un trabajo se genera el mensaje siguiente:
Error al iniciar nombretrabajo para la estacióntrabajo: textoerror
Si no se puede comprobar la tarea del archivo se genera el mensaje siguiente:
Error al invocar nombremétodo para estacióntrabajo: textoerror
Si no se puede gestionar una tarea de trabajo se genera el siguiente mensaje:
Error al gestionar nombretrabajo para estacióntrabajo utilizando nombremétodo:
textoerror
Cuando un método envía un mensaje a Jobman que no se reconoce, se genera el
mensaje siguiente:
Error: mensaje no válido para nombretrabajo, #jnúmerotrabajo para
estacióntrabajo utilizando nombremétodo.
"los 64 primeros caracteres del mensaje incorrecto"
Capítulo 27. Consulta de agente ampliado 179
180 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 28. Biblioteca de correlación de códigos de retorno
La funcionalidad de correlación de códigos de retorno ofrece una manera estándar
de correlacionar los mensajes con los valores de código de retorno. Además, la
correlación de códigos de retorno se puede personalizar por los usuarios. Esta
funcionalidad está disponible para los métodos de acceso de:
v Oracle eBusiness Suite
v Peoplesoft
v R/3
Esta funcionalidad ofrece más granularidad en la definición de políticas de
éxito/fallo de los trabajos y una flexibilidad mejorada en el control de los flujos de
ejecución de trabajos basándose en los resultados de la ejecución. La correlación de
los códigos de retorno de trabajos ofrece las siguientes posibilidades:
v Los usuarios pueden definir un estado de terminación de trabajo (satisfactorio o
anómalo) basándose en una condición del código de retorno de la ejecución del
programa/script del trabajo.
v El código de retorno también se puede proporciona al trabajo de recuperación
que está asociado a la definición del trabajo. Esto provoca que el trabajo de
recuperación realice diferentes procesos basándose en el código de retorno.
Archivo de correlación de códigos de retorno
Este archivo le permite personalizar sus propios códigos de retorno con respecto a
determinadas condiciones que pueden afectar a un trabajo al ejecutarse. A partir de
ahí, es posible establecer la condición de satisfactorio del trabajo para que Tivoli
Workload Scheduler evalúe si el trabajo se completa satisfactoriamente o con error.
El código de retorno se envía a Tivoli Workload Scheduler con el formato de
mensaje %RC nnnn. Si se recibe este mensaje, el estado del trabajo se actualiza de
acuerdo a ello.
Formato
La sintaxis del archivo de correlación de códigos de retorno es la siguiente:
[#] “patrón1” “patrón2”...“patrónn” = valor RC
Parámetros
# Comentario opcional. Todas las líneas que empiezan por este símbolo (#)
no se utilizan para la correlación.
patrónn
Cadenas de patrones delimitadas por comillas dobles (“ y ”). Si sólo utiliza
una cadena de patrón, puede omitir las comillas dobles. Si la cadena de
patrón contiene un carácter de comillas dobles, debe protegerse mediante
una barra inclinada invertida (\). La cadena puede contener los siguientes
comodines y caracteres especiales:
Asterisco (*)
Coincide con una cantidad arbitraria de caracteres.
Signo de interrogación (?)
Coincide con un solo carácter.
© Copyright IBM Corp. 2000, 2003 181
Barra inclinada invertida (\)
Carácter de escape.
Valor RC
El valor de código de retorno. El método envía este valor a Tivoli
Workload Scheduler mediante un mensaje %RC nnnn.
Ejemplos
En el ejemplo siguiente de un archivo de correlación de códigos de retorno, los
números de línea en negrita no pertenecen al archivo sino que aparecen como
referencia:
1. # Se trata de un archivo de correlación RC para el registro de trabajos.
2.
3. “Usuario * falta ” = 102
4. “\*\*\*” = 103
5. “Usuario \
6. * \
7. falta” = 102
donde:
v La línea 1 es un comentario y no se utiliza para correlación.
v La línea 2 está en blanco y se pasa por alto. Todos los espacios en blanco que
preceden o siguen a una cadena de patrón se pasan por alto, así como los que se
encuentran entre el signo igual y el valor del código de retorno.
v La línea 3 coincide con todos los mensajes que empiezan por la cadena de
caracteres Usuario y finalizan con la cadena de caracteres falta.
v La línea 4 coincide con todos los mensajes que empiezan por tres asteriscos (*)
seguidos por un espacio en blanco. Cuando se utiliza el asterisco así y no como
comodín, es necesario protegerlo con una barra inclinada invertida.
v Las líneas 5 a 7 contienen un patrón que ocupa varias líneas. Coincide con los
mismos mensajes que el patrón de la línea 3.
Comentarios
Tenga en cuenta los hechos siguientes:
v El orden de las líneas de patrones es importantes ya que la primera línea de
patrones coincidente se utiliza para crear el valor de código de retorno.
v El procedimiento de coincidencia de patrones pasa por alto las cadenas da
patrón vacías (“”).
Por ejemplo, la siguiente es una secuencia de patrones válida. La primera línea es
más restrictiva que la segunda.
“625” “Usuario * falta” = 104
“” “Usuario * falta” = 102
La siguiente secuencia de patrones tiene un formato válido, pero la segunda línea
de patrones no se utiliza nunca; puesto que la primera línea es más general,
siempre coincide antes.
“” “Usuario * falta” = 102
“625” “Usuario * falta” = 104
182 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Correlación de códigos de retorno para Psagent y
MCMAGENT
Para los métodos de acceso de PeopleSoft y de Oracle e-Business Suite, puede
grabar los archivos de correlación de códigos de retorno mediante la asociación de
los estados internos indicados en la Tabla 22 y la Tabla 23 en la página 184.
Cuando no se han definido archivos de correlación de códigos de retorno o cuando
una cadena de caracteres devuelta por el método de acceso no satisface ninguno de
los patrones coincidente del archivo de correlación, los métodos utilizan los
códigos de retorno estándar respectivos indicados en las mismas tablas.
Tabla 22. Estados de trabajo y códigos de retorno para el método de acceso de PeopleSoft.
Estado de trabajo Psoft Código de retorno Psoft
″CANCEL″ 1
″DELETE″ 2
″ERROR″ 3
″HOLD″ 4
″QUEUED″ 5
″INITIATED″ 6
″PROCESSING″ 7
″CANCELLED″ 8
″SUCCESS″ 9
″NO SUCCESSPOSTED″ 10
″POSTED″ 11
″NOT POSTED″ 12
″RESEND″ 13
″POSTING″ 14
″GENERATED″ 15
Capítulo 28. Biblioteca de correlación de códigos de retorno 183
Tabla 23. Estados de trabajo y códigos de retorno para el método de acceso de Oracle
e-Business Suite.
Estado de trabajo MCMAGENT Código de retorno MCMAGENT
″RUNNING″ 1
″PENDING″ 2
″COMPLETE″ 3
″INACTIVE″ 4
″NORMAL″ 5
″TERMINATING″ 6
″PAUSED″ 7
″RESUMING″ 8
″STANDBY″ 9
″SCHEDULED″ 10
″WAITING″ 11
″WARNING″ 13
″ERROR″ 14
″TERMINATED″ 15
″DELETED″ 16
″ON HOLD″ 17
″DISABLED″ 18
″NO MANAGER″ 19
″SUSPENDED″ 20
″TEST FAILURE″ 21
″NOT FOUND″ 22
184 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Ejemplos: El agente ampliado para Oracle e-Business Suite devuelve la cadena de
caracteres TERMINATED. El código de retorno resultante sería el siguiente
dependiendo de estas condiciones:
v No existe archivo de correlación de códigos de retorno. En este caso, el método
enviará el valor de código de retorno 15 indicado en la Tabla 23 en la página
184.
v Existe un archivo de correlación de código de retorno y es
"NORMAL"=0
"TERMINATED","DELETED"=1
En este caso, el método encontrará el patrón coincidente y enviará el valor de
código de retorno 1.
v El archivo de correlación de código de retorno es
"NORMAL"=0
"ERROR","DELETED"=1
En este caso, el método no encontrará el patrón coincidente y enviará un valor
de código de retorno 15, tal como indica la Tabla 23 en la página 184.
Capítulo 28. Biblioteca de correlación de códigos de retorno 185
Nombres de archivos de correlación de códigos de retorno
Cada método tiene su propio conjunto de archivos para correlacionar los mensajes
con los valores de código de retorno. Los archivos de correlación pueden ser
globales o locales para una estación de trabajo.
Los archivos de correlación de códigos de retorno específicos para una estación de
trabajo se denominan siguiendo el esquema siguiente:
<inicioTWS>/methods/rcm/<nombre_método>-<tipo>-<estación de trabajo>.rcm
Los archivos de correlación global deben tener un nombre de archivo de acuerdo al
esquema siguiente:
<inicioTWS>/methods/rcm/<nombre_método>-<tipo>.rcm
Para los métodos de acceso de PeopleSoft y Oracle e-Business, tipo es siempre igual
a rcmap. Para el método de acceso R/3, tipo es tal como se describe en el apartado
siguiente.
Nombres de archivos de correlación de códigos de retorno para
r3batch
El método para R3 utiliza los archivos de correlación de códigos de retorno
globales siguientes:
<inicioTWS>/rcm/methods/r3batch-joblog.rcm
Correlaciona mensajes del registro de trabajos de un trabajo R3 con los
valores de código de retorno. Si este archivo no está presente, se pasan por
alto los mensajes del registro de trabajos.
<inicioTWS>/rcm/methods/r3batch-pchainlog.rcm
Correlaciona los mensajes del protocolo de Process Chain con los valores
de código de retorno. Si este archivo no está presente, se pasan por alto los
mensajes del protocolo.
<inicioTWS>/rcm/methods/r3batch-spool.rcm
Correlaciona los mensajes de la lista de spool de trabajos de un trabajo
SAP con los valores de códigos de retorno. Si este archivo no está presente,
se pasan por alto los mensajes de la lista de spool.
<inicioTWS>/rcm/methods/r3batch-syslog.rcm
Correlaciona los mensajes de syslog de un sistema SAP con los valores de
códigos de retorno. Si este archivo no está presente, se pasan por alto los
mensajes de syslog.
<inicioTWS>/rcm/methods/r3batch-msgrc.rcm
Correlaciona las excepciones ABAP / códigos de retorno BAPI de los
módulos de función RFC con los valores de código de retorno. Si este
archivo no está presente, la correlación se hace utilizando una tabla
codificada.
186 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 29. Configuración del programa de utilidad de
rastreo
Todos los métodos de acceso ofrecen la posibilidad de configurar las opciones de
rastreo. Para ello, puede editar una serie de propiedades de rastreo en el archivo
de configuración <nombre_método_acceso>.properties ubicado en el subdirectorio
methods de inicioTWS.
Las propiedades de rastreo configurables son:
v Nivel de rastreo (MIN,MID,MAX)
v Ubicación de los archivos de rastreo (en lo que se refiere a la ruta absoluta)
El ejemplo siguiente es un archivo de configuración para el método de acceso de
R/3. Se denomina r3batch.properties. Las palabras clave que se explican en este
apartado aparecen resaltadas para que facilitar su uso:
r3batch.organization=IBM
r3batch.product=TWS4APPS
r3batch.component=R3BATCH
r3batch.trace.tracers.level=DEBUG_MIN
r3batch.trace.tracers.listenerNames=r3batch.trace.handlers.traceFile
r3batch.trace.handlers.traceFile.fileDir=home/maestro/methods
r3batch.trace.handlers.traceFile.appending=true
r3batch.trace.handlers.traceFile.formatterName=r3batch.trace.formatter
Con la palabra clave level, el mecanismo de rastreo da soporte a tres niveles de
rastreo:
DEBUG_MIN
Sólo se indican los errores muy graves. Se trata del valor predeterminado.
DEBUG_MID
También se relacionan los mensajes informativos y los avisos.
DEBUG_MAX
Se visualiza una salida de depuración más detallada.
Los valores del archivo de propiedades afectan a todas las ejecuciones del método
de acceso correspondiente. Para especificar un valor de rastreo diferente para un
trabajo en particular, agregue la opción siguiente a la definición del trabajo:
-tracelvl=(1|2|3)
donde:
v 1 = DEBUG_MIN
v 2 = DEBUG_MID
v 3 = DEBUG_MAX
Sólo para el método de acceso de R/3, puede marcar el cuadro de selección
Depuración en la ventana Propiedades-Definición de trabajo de Job Scheduling
Console, para establecer el nivel de rastreo en DEBUG_MAX para un trabajo específico.
Observe que el cuadro de selección Rastreo habilita el rastreo SAP RFC.
Los rastreos se graban en formato XML. De forma predeterminada, los archivos de
rastreo se almacenan en el directorio methods. Para cambiar esta ruta, puede
utilizar la palabra clave fileDir. Asegúrese de que la nueva ruta que especifique
© Copyright IBM Corp. 2000, 2003 187
ya se haya creado como una ruta absoluta con derechos de grabación. Utilice
siempre barras inclinadas (o barras inclinadas invertidas) al especificar una nueva
ruta, aunque esté en Windows.
Los archivos de rastreo ofrecen información acerca de la ejecución del método con
el nivel de detalle deseado. El nivel mínimo de rastreo siempre está activado, para
garantizar la posibilidad de First-Failure Data Capture (FFDC).
El valor de la clave appending determina si un archivo de rastreo nuevo se agrega
a otro anterior (true) o lo sobregraba (false). Siempre se recomienda el valor true.
En particular, no debe cambiarse a false mientras se ejecutan trabajos, ya que
provocaría la pérdida de rastreos.
188 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 30. Resolución de problemas
Este capítulo enumera varios elementos en los que puede encontrar problemas al
instalar o utilizar Tivoli Workload Scheduler for Applications o los métodos de
acceso.
Tabla 24. Resolución de problemas de elementos
Área Elemento
Instalación:
Descubrimiento
de instancias de
Tivoli Workload
Scheduler
Problema: Si está en Unix y dispone de varias instalaciones de Tivoli Workload Scheduler
versiones 7.0 ó 8.1 que no se han instalado correctamente bajo un directorio inicial
/home/usuarioTWS, el programa de instalación indica aleatoriamente una de estas instancias y la
denomina <desconocido>.
Solución: Para cada una de estas instancias, cree un directorio inicial adecuado que apunte al
directorio de instalación real de Tivoli Workload Scheduler. Siga el procedimiento siguiente:
1. En la raíz, cree un directorio denominado /home/usuarioTWS, que vincule con el directorio en
el que se ha instalado el producto.
2. En el archivo /usr/unison/components, agregue una entrada llamada /home/usuarioTWS que
vincule con la entrada de una instancia en particular.
Instalación:
Instalación de
psagent
Problema: Mientras instala el método de acceso para la función PeopleSoft, puede visualizarse
el siguiente mensaje emergente:
El ordinal 6654 no ha podido localizarse en el dll MFC42u.dll
Esto ocurre porque se ha encontrado una versión anterior de MFC42u.dll en el directorio del
sistema Windows.
Solución: Sustituya MFC42u.dll por una versión más reciente para solucionar el problema.
Generalmente, podrá encontrar una versión más reciente del dll en el directorio inicial
PeopleSoft.
r3batch:
Planificación de
trabajos R/3
Problema: Al crear un trabajo SAP, aparece el siguiente mensaje mientras intenta ver los detalles
de la variante del ABAP:
AWSO0101E
Falta rutina ABAP.
J_101_REPORT_ALL_SELECTIONS instale la rutina ABAP más reciente para Maestro!!
Solución: Este defecto está provocado por un error en el módulo de función SAP. SAP describe
este problema y las posibles soluciones en las notas 0351293 y 0116354 de SAP.
Entorno mixto:
Mensajes de los
registros de
trabajos de
psagent y
zosagent
Si el entorno de planificación está compuesto por Tivoli Workload Scheduler Versión 8.1 y Tivoli
Workload Scheduler for Applications Versión 8.2, los mensajes de los registros de trabajos para
los métodos de acceso de z/OS y PeopleSoft aparecen con prefijos dobles:
v AWSxxxx EEWIaaaa <texto de mensaje> para zosagent
v AWSxxxx EEWNaaaa <texto de mensaje> para psagent
Entorno mixto:
códigos de
retorno para
trabajos de agente
ampliado
Si el entorno de planificación está compuesto por Tivoli Workload Scheduler Versión 8.2 y Tivoli
Workload Scheduler for Applications Versión 8.1.1, lo que aparece como código de retorno de
un trabajo de agente ampliado enviado (mediante Job Scheduling Console o conman) es en
realidad el código de salida de ese trabajo. No debe interpretarse como código de retorno.
© Copyright IBM Corp. 2000, 2003 189
Resolución de problemas de la instalación del método de acceso de
PeopleSoft
La instalación de este método de acceso requiere que especifique el entorno
PeopleSoft en términos de un directorio que depende de la versión de PeopleSoft.
Algunos ejecutables del método de acceso se instalan ahí. La tabla siguiente
relaciona los directorios y los archivos que debe buscar para la resolución de
problemas de la instalación.
Tabla 25. Rutas de entorno PeopleSoft.
Versión de
PeopleSoft
Nombre de directorio Busque estos
archivos
7.x <INICIO_PS>\cblbin
donde <INICIO_PS> es el directorio inicial del
servidor de archivos Peoplesoft y está accesible
local o remotamente desde la estación de trabajo
que ejecuta el método de acceso.
TVPUPSFT.exe
cblrtss.dll
8.1x <DIR_API_EXT>\bin\client\winx86_extapi
donde <DIR_API_EXT> es el directorio en el que
las API externas de PeopleSoft están instaladas.
TVPUPSFT.exe
pspiadapter.dll
8.4x <PS_HOME>\\bin\client\winx86
donde <PS_HOME> es el directorio inicial del
servidor de archivos Peoplesoft y está accesible
local o remotamente desde la estación de trabajo
que ejecuta el método de acceso.
TVPUPSFT.exe
pspiadapter.dll
190 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Capítulo 31. Archivos instalados
Este capítulo ofrece un listado de los archivos que debe encontrar en el sistema
después de la instalación de Tivoli Workload Scheduler for Applications. Se
proporciona la información por plataforma y función. No incluye los archivos
instalados para el soporte de Java que no se requieren para la desinstalación del
producto.
La tabla siguiente lista los archivos instalados en Windows.
Tabla 26. Archivos instalados en Windows.
Función Archivos
Método de acceso de
PeopleSoft
TWS_HOME\catalog\C\peoplesoft.cat
TWS_HOME\methods\PeopleSoft\PTCUDCOP.bl
TWS_HOME\methods\PeopleSoft\TVPUPSFT700.dms
TWS_HOME\methods\PeopleSoft\TVPUPSFT750.dms
TWS_HOME\methods\defs\psagent.def
TWS_HOME\methods\enigma.exe
TWS_HOME\methods\msvcrt.dll
TWS_HOME\methods\oslayer.dll
TWS_HOME\methods\psagent.exe
TWS_HOME\methods\psagent.opts
TWS_HOME\methods\psagent.properties
Para PeopleTools 7.0x y Merant NetExpress 2:PSHOME70CBL2\cblbin\TVPUPSFT.exe
PSHOME70CBL2\cblbin\TVPUPSFT.gnt
Para PeopleTools 7.0x y Merant NetExpress 3:PSHOME70CBL3\cblbin\TVPUPSFT.exe
PSHOME70CBL3\cblbin\TVPUPSFT.gnt
PeopleTools 7.0x y MF COBOL Workbench 4.x:PSHOME70CWB4\cblbin\TVPUPSFT.exe
PSHOME70CWB4\cblbin\TVPUPSFT.gnt
Para PeopleTools 7.5x y Merant NetExpress 2:PSHOME75CBL2\cblbin\TVPUPSFT.exe
PSHOME75CBL2\cblbin\TVPUPSFT.gnt
Para PeopleTools 7.5x y Merant NetExpress 3:PSHOME75CBL3\cblbin\TVPUPSFT.exe
PSHOME75CBL3\cblbin\TVPUPSFT.gnt
Para PeopleTools 8.1x:PSHOME81X\bin\client\winx86_extapi\TVPUPSFT.exe
Para PeopleTools 8.4x:PSHOME84X\bin\client\winx86\TVPUPSFT.exe
© Copyright IBM Corp. 2000, 2003 191
Tabla 26. Archivos instalados en Windows. (continuación)
Función Archivos
Método de acceso de R/3 TWS_HOME\methods\K000443.TV1
TWS_HOME\methods\R000443.TV1
TWS_HOME\methods\r3batch.exe
TWS_HOME\methods\r3batch.opts
TWS_HOME\methods\r3batch.properties
TWS_HOME\methods\r3batch_cp.map
TWS_HOME\methods\librfc32.dll
TWS_HOME\methods\enigma.exe
TWS_HOME\methods\msvcrt.dll
TWS_HOME\methods\msvbvm60.dll
TWS_HOME\methods\msvcp60.dll
TWS_HOME\methods\defs\r3batch.def
TWS_HOME\catalog\C\r3batch.cat
Método de acceso de z/OS TWS_HOME\methods\mvsca7.exe
TWS_HOME\methods\mvsca7.opts
TWS_HOME\methods\mvsca7.properties
TWS_HOME\methods\mvsjes.exe
TWS_HOME\methods\mvsjes.opts
TWS_HOME\methods\mvsjes.properties
TWS_HOME\methods\mvsopc.exe
TWS_HOME\methods\mvsopc.opts
TWS_HOME\methods\mvsopc.properties
TWS_HOME\methods\oslayer.dll
TWS_HOME\methods\defs\mvsca7.def
TWS_HOME\methods\defs\mvsjes.def
TWS_HOME\methods\defs\mvsopc.def
TWS_HOME\methods\msvcrt.dll
TWS_HOME\catalog\C\mvs.cat
Comunes TWS_HOME\methods\opted\jakarta-oro-2.0.6.jar
TWS_HOME\methods\opted\opted.bat
TWS_HOME\methods\opted\tws4apps.jar
TWS_HOME\methods\opted\tws4appsbeans.jar
TWS_HOME\methods\opted\uil.jar
TWS_HOME\methods\opted\xercesImpl.jar
TWS_HOME\methods\opted\xmlParserAPIs.jar
TWS_HOME\methods\opted.exe
Desinstalación TWS_HOME\methods\_xauninst\uninstall.dat
TWS_HOME\methods\_xauninst\uninstall.jar
TWS_HOME\methods\_xauninst\uninstaller.exe
192 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
La tabla siguiente indica los archivos instalados en Unix (plataformas de 1 nivel).
Tabla 27. Archivos instalados en Unix (plataformas de 1 nivel).
Función Archivos
Método de acceso de Oracle
e-Business Suite
TWS_HOME/catalog/C/mcm.cat
TWS_HOME/methods/MCMAGENT.opts
TWS_HOME/methods/MCMAGENT.properties
TWS_HOME/methods/OracleTMP/MCMAGENT
TWS_HOME/methods/OracleTMP/MCMLJ.o
TWS_HOME/methods/OracleTMP/MCMSTAT.o
TWS_HOME/methods/OracleTMP/MCMTJ.o
TWS_HOME/methods/OracleTMP/MCMprod.txt
TWS_HOME/methods/OracleTMP/libusr.a
TWS_HOME/methods/OracleTMP/mcm.mk
TWS_HOME/methods/OracleTMP/mcminstall
TWS_HOME/methods/OracleTMP/mcmoptions
TWS_HOME/methods/defs/MCMAGENT.def
TWS_HOME/methods/enigma
Método de acceso de R/3 TWS_HOME/catalog/C/r3batch.cat
TWS_HOME/methods/K000443.TV1
TWS_HOME/methods/R000443.TV1
TWS_HOME/methods/defs/r3batch.def
TWS_HOME/methods/enigma
TWS_HOME/methods/r3batch
TWS_HOME/methods/r3batch.opts
TWS_HOME/methods/r3batch.properties
TWS_HOME/methods/r3batch_cp.map
Método de acceso de z/OS TWS_HOME/catalog/C/mvs.cat
TWS_HOME/methods/defs/mvsca7.def
TWS_HOME/methods/defs/mvsjes.def
TWS_HOME/methods/defs/mvsopc.def
TWS_HOME/methods/mvsca7
TWS_HOME/methods/mvsca7.opts
TWS_HOME/methods/mvsca7.properties
TWS_HOME/methods/mvsjes
TWS_HOME/methods/mvsjes.opts
TWS_HOME/methods/mvsjes.properties
TWS_HOME/methods/mvsopc
TWS_HOME/methods/mvsopc.opts
TWS_HOME/methods/mvsopc.properties
Comunes TWS_HOME/methods/opted.bin
TWS_HOME/methods/opted/jakarta-oro-2.0.6.jar
TWS_HOME/methods/opted/opted.sh
TWS_HOME/methods/opted/tws4apps.jar
TWS_HOME/methods/opted/tws4appsbeans.jar
TWS_HOME/methods/opted/uil.jar
TWS_HOME/methods/opted/xercesImpl.jar
TWS_HOME/methods/opted/xmlParserAPIs.jar
Desinstalación TWS_HOME/methods/_xauninst/uninstall.dat
TWS_HOME/methods/_xauninst/uninstall.jar
TWS_HOME/methods/_xauninst/uninstaller
Capítulo 31. Archivos instalados 193
194 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Parte 7. Apéndices
© Copyright IBM Corp. 2000, 2003 195
196 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Avisos
Esta información se ha desarrollado para productos y servicios comercializados en
EE.UU. Es posible que IBM no ofrezca los productos, servicios o funciones que se
tratan en este documento en otros países. Consulte al representante de IBM local
para obtener información sobre los productos y servicios actualmente disponibles
en su área. Cualquier referencia a un producto, programa o servicio de IBM no
implica que sólo se pueda utilizar ese producto, programa o servicio de IBM.
Puede utilizarse, en su lugar, cualquier producto, programa o servicio
funcionalmente equivalente que no infrinja ningún derecho de la 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 patente que cubran el tema
descrito en este documento. La posesión de este documento no le otorga ninguna
licencia para esas patentes. Puede enviar consultas sobre licencias, por escrito a:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785 U.S.A.
Para las 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
Tokyo 106, Japan
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, LAS
GARANTÍAS DE NO INFINGIMIENTO, 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.
Esta información puede incluir imprecisiones técnicas o errores tipográficos.
Periódicamente se realizan cambios en la información aquí contenida; estos
© Copyright IBM Corp. 2000, 2003 197
cambios se incorporarán en nuevas ediciones de la publicación. IBM puede realizar
mejoras y/o cambios en el producto o productos y/o en el programa o programas
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
indican únicamente para su comodidad y no constituyen recomendaciones de
dichos sitios Web. El material estos sitios Web no forma parte del material
correspondiente a este producto IBM y el uso de esos sitios Web se realiza bajo
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 U.S.A.
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 programa 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.
Los datos de rendimiento contenidos en este documento se han determinado en un
entorno controlado. Por lo tanto, los resultados obtenidos en otros entornos
operativos pueden variar significativamente. Algunas mediciones pueden haberse
realizado en sistemas en nivel de desarrollo y no se garantiza que sean las mismas
en los sistemas comercializados. Además, algunas mediciones pueden haberse
estimado mediante extrapolación. Los resultados reales pueden variar. Los usuarios
de este documento deben verificar los datos aplicables a su entorno específico.
La información relativa a productos no IBM se ha obtenido de los proveedores de
estos productos, su publicidad u otras fuentes públicamente disponibles. IBM no
ha probado estos productos y no puede confirmar la precisión del rendimiento, su
compatibilidad ni otras reclamaciones relativas a productos que no son de IBM.
Las preguntas relativas a las posibilidades de productos no IBM deben dirigirse a
los suministradores de esos productos.
Esta información contiene ejemplos de datos e informes utilizados en las
operaciones comerciales diarias. Para ilustrarlas lo mejor posible, los ejemplos
contienen nombres de personas, compañías, marcas y productos. Todos estos
nombres son ficticios y cualquier parecido a nombres y direcciones utilizados en
empresas comerciales reales son mera coincidencia.
198 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Si consulta esta información en formato software, las fotografías y las ilustraciones
a color pueden no aparecer.
Marcas registradas
IBM, el logotipo de IBM, Tivoli, AIX, AS/400, Dynix, MVS/ESA, OS/390, RACF,
RS/6000, Sequent, z/OS y zSeries son marcas comerciales o marcas registradas de
International Business Machines Corporation en Estados Unidos y/o otros países.
Microsoft y Windows NT son marcas registradas de Microsoft Corporation en
Estados Unidos y/o en otros países.
UNIX es una marca registrada de The Open Group en Estados Unidos y en otros
países.
Java y todas las marcas y logotipos basados en Java son marcas comerciales o
marcas registradas de Sun Microsystems, Inc. en Estados Unidos y en otros
países.
Otros nombres de compañías, productos y servicios pueden ser marcas registradas
o de servicio de otras empresas.
Avisos 199
200 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Glosario
A
Agente ampliado. Los agentes ampliados se utilizan
para integrar las funciones de control de trabajos de
Tivoli Workload Scheduler en otros sistemas operativos
(por ejemplo, MVS) y aplicaciones (por ejemplo, Oracle
Applications, Peoplesoft y R/3). Los agentes ampliados
utilizan scripts denominados métodos de acceso para
comunicarse con los sistemas externos.
Agente de red. Un tipo de agente ampliado utilizado
para crear dependencias entre trabajos y secuencias de
trabajos de redes de Tivoli Workload Scheduler
separadas. Véase también “Dependencia inter-red
(INET)”.
Agente tolerante a errores. Una estación de trabajo de
agente en la red de Tivoli Workload Scheduler que
puede resolver las dependencias locales e iniciar sus
trabajos en ausencia de un gestor de dominio.
Agente X. Véase “Agente ampliado”.
Archivo stdlist. Se crea un archivo de lista estándar
para cada trabajo iniciado por Tivoli Workload
Scheduler. Los archivos de lista estándar contienen
cabeceras y pies de página, comandos con echo, errores
y avisos. Estos archivos pueden utilizarse para
solucionar problemas de ejecución de trabajos.
Archivo Symphony. Este archivo contiene la
información de planificación que el proceso de Control
de producción (batchman) necesita para ejecutar el
plan. El archivo se crea y carga durante la fase anterior
a la producción. Durante la fase de producción, se
actualiza continuamente para indicar el estado actual
del proceso de producción: si el trabajo se ha
completado, está en progreso o debe empezar. Para
gestionar el proceso de producción, el contenido del
archivo Symphony (plan) puede visualizarse y
modificarse con Job Scheduling Console.
B
Base de datos. La base de datos contiene todas las
definiciones que ha creado para los objetos de
planificación (por ejemplo, trabajos, secuencias de
trabajos, recursos, estaciones de trabajo, etc). Además,
la base de datos contiene otra información importante
como, por ejemplo, las estadísticas de la ejecución de
trabajos y secuencias de trabajos, la información sobre
el ID de usuario que ha creado un objeto y la fecha de
la última modificación de un objeto. En contraposición,
el plan sólo contiene los trabajos y las secuencias de
trabajos (incluyendo los objetos dependientes) cuya
ejecución está planificada en la producción del día de
hoy.
Base de datos expandida. Las bases de datos
expandidas permiten nombres más largos para los
objetos de base de datos como, por ejemplo, los
trabajos, las secuencias de trabajos, las estaciones de
trabajo, los dominios y los usuarios. Las bases de datos
expandidas se configuran utilizando el comando
dbexpand o como una opción durante la instalación.
No expanda las bases de datos sin comprender antes
las implicaciones y el impacto de este comando.
Batchman. Batchman es un proceso que se inicia al
empezar cada día de proceso Tivoli Workload
Scheduler, para iniciar trabajos según la información
del archivo Symphony.
C
Calendario. Un calendario es un objeto definido en la
base de datos de Tivoli Workload Scheduler que
contiene una lista de fechas de planificación. Puesto
que es un objeto exclusivo definido en la base de datos,
puede asignarse a múltiples secuencias de trabajos. La
asignación de un calendario a una secuencia de trabajos
hace que ésta se ejecute en los días especificados en el
calendario. Tenga en cuenta que el calendario puede
utilizarse como ciclo de ejecución incluyente o
excluyente.
Ciclo de ejecución. Un ciclo de ejecución especifica
los días que una secuencia de trabajos tiene planificada
la ejecución. En Tivoli Workload Scheduler, hay tres
tipos de ciclos de ejecución que se pueden especificar
para una secuencia de trabajos, un Ciclo de ejecución
semanal o un Ciclo de ejecución de calendario
(normalmente denominado calendario). Tenga en
cuenta que cada tipo de ciclo de ejecución puede ser
incluyente o excluyente. Es decir, cada ciclo de
ejecución puede definir los días en que una secuencia
de trabajos se incluye en el ciclo de producción, o los
días en que una secuencia de trabajos se excluye del
ciclo de producción. Cuando defina múltiples ciclos de
ejecución para una secuencia de trabajos y los ciclos de
ejecución incluyentes y excluyentes especifiquen los
mismos días, los ciclos de ejecución excluyentes tienen
prioridad.
Ciclo de ejecución excluyente. Ciclo de ejecución que
especifica los días en que una secuencia de trabajo no
puede ejecutarse. Los ciclos de ejecución excluyentes
tienen prioridad sobre los ciclos de ejecución
incluyentes.
© Copyright IBM Corp. 2000, 2003 201
Ciclo de ejecución incluyente. Un ciclo de ejecución
que especifica los días en los que una secuencia de
trabajos tiene planificado su ejecución. Los ciclos de
ejecución excluyentes tienen prioridad sobre los ciclos
de ejecución incluyentes.
Ciclo de ejecución semanal. Un ciclo de ejecución que
especifica los días de la semana en que se debe ejecutar
la secuencia de trabajos. Por ejemplo, puede
especificarse que una secuencia de trabajos se ejecute
cada lunes, miércoles y viernes utilizando un ciclo de
ejecución semanal. Un ciclo de ejecución semanal se
define para una secuencia de trabajos específica y no
puede utilizarse para múltiples secuencias de trabajos.
Para obtener más información consulte Ciclo de
ejecución.
Ciclo de ejecución simple. Un ciclo de ejecución
simple es un conjunto específico de días definidos por
el usuario en que se ejecuta una secuencia de trabajos.
Un ciclo de ejecución simple se define para una
secuencia de trabajos específicos y no puede utilizarse
por múltiples secuencias de trabajos. Para obtener más
información consulte Ciclo de ejecución.
Clase de estación de trabajo. Una clase de estación de
trabajo es un grupo de estaciones de trabajo. Pueden
colocarse cualquier número de estaciones de trabajo en
una clase. Pueden asignarse que secuencias de trabajos
y trabajos se ejecuten en una clase de estación de
trabajo. Esto facilita la duplicación de un trabajo o una
secuencia de trabajos en muchas estaciones de trabajo.
Comandos de utilidad. Un conjunto de ejecutables de
la línea de comandos para gestionar el planificador.
Comodines. Los comodines para Tivoli Workload
Scheduler son: ? Sustituye un carácter alfanumérico. %
Sustituye un carácter numérico. * Sustituye cero o más
caracteres alfanuméricos. Generalmente, los comodines
se utilizan para definir más una búsqueda de uno o
varios objetos en la base de datos. Por ejemplo, si desea
visualizar todas las estaciones de trabajo, puede entrar
el asterisco (*) como comodín. Para obtener un listado
de las estaciones de trabajo de sitio1 a sitio8, puede
entrar sitio%.
Composer. Composer es una aplicación de línea de
comandos heredada para gestionar las definiciones de
los objetos de planificación de la base de datos.
Conman. Conman (gestor de consola) es una
aplicación de línea de comandos heredada para
gestionar el entorno de producción. Conman realiza las
tareas siguientes: inicia y detiene los procesos de
producción, altera y visualiza las planificaciones y
trabajos del plan y controla el proceso de vinculación
de la estación de trabajo en una red.
D
Delimitación. La delimitación de trabajos es un
control maestro sobre la ejecución de trabajos en una
estación de trabajo. La delimitación de trabajos es un
nivel de prioridad que un trabajo o una secuencia de
trabajos deben sobrepasar para que puedan ejecutarse.
Por ejemplo, si se establece la delimitación en 40,
impide que se inicien los trabajos cuya prioridad sea 40
o inferior.
Dependencia. Una dependencia es un requisito previo
que debe satisfacerse antes de que la ejecución de un
trabajo o una secuencia de trabajos pueda proseguir. El
número máximo de dependencias permitidas para un
trabajo o secuencia de trabajos es 40. Los cuatro tipos
de dependencias que Tivoli Workload Scheduler utiliza
son las dependencias de continuación, las dependencias
de recursos, las dependencias de archivo y las
dependencias de solicitud.
Dependencia de continuación. Una dependencia en la
que un trabajo o secuencia de trabajos no pueden
empezar su ejecución hasta que otros trabajos o
secuencias de trabajos se hayan completado
satisfactoriamente.
Dependencias inter-red (INET). Una dependencia
entre trabajos o secuencias de trabajos en redes Tivoli
Workload Scheduler separadas. Véase también “Agente
de red”.
Dominio. Un dominio es un grupo con nombre de
estaciones de trabajo Tivoli Workload Scheduler que
consisten en uno o varios agentes y un gestor de
dominio que actúa como centro de gestión. Todos los
dominios tienen un dominio primario excepto el
dominio maestro.
Duración. El tiempo que se espera que el trabajo tarde
en completarse. En la Vista de franja horaria de los
trabajos de la base de datos, la duración se representa
por una barra azul claro en el centro de la barra de
actividad o por un rombo azul claro.
E
Estación de trabajo. Una estación de trabajo es
normalmente un sistema individual en el que se
ejecutan los trabajos y las secuencias de trabajo. Se
definen en la base de datos de Tivoli Workload
Scheduler como un objeto exclusivo. Se requiere una
definición de estación de trabajo para cada sistema que
ejecuta trabajos o secuencias de trabajos en la red de
Workload Scheduler.
Estado. El Estado refleja el estado actual del trabajo o
la secuencia de trabajos en Job Scheduling Console. El
estado de Job Scheduling Console es común a Tivoli
Workload Scheduler y IBM Tivoli Workload Scheduler
for z/OS. Véase también Estado interno.
202 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Estado de trabajo. Véase “Estado”.
Estado interno. El estado interno refleja el estado
actual de los trabajos y secuencias de trabajos del
motor del planificador. El estado interno es exclusivo
en Tivoli Workload Scheduler. Véase también Estado.
G
Gestor de dominio. El centro de gestión de un
dominio Tivoli Workload Scheduler. Todas las
comunicaciones de un dominio dirigidas a los agentes
y las que ellos originan se direccionan mediante del
gestor de dominio.
Gestor de dominio maestro. En una red de Tivoli
Workload Scheduler, el gestor de dominio maestro
mantiene los archivos utilizados para documentar los
objetos de planificación. Crea el plan al principio de
cada día, y realiza todos los registros e informes para la
red.
H
Hora de inicio más temprana. Hora antes de la cual
no puede iniciarse el trabajo o la secuencia de trabajos.
La hora de inicio más temprana se estima basándose en
las experiencias anteriores de la ejecución del trabajo o
secuencia de trabajos. Sin embargo, el trabajo o
secuencia de trabajos puede empezar después del
tiempo que especifique, siempre que se satisfagan todas
las demás dependencias. En la franja horaria, la hora de
inicio se representa por el principio (borde izquierdo)
de la barra de actividad azul marino. Para las
instancias de trabajos, la hora de inicio que IBM Tivoli
Workload Scheduler for z/OS calcula, se representa
mediante una barra azul claro. Véase también “Hora de
inicio real” y “Hora de inicio planificada”.
Hora de inicio planificada. La hora en que el
planificador estima que una instancia de trabajo
empezará. Esta estimación se basa en las horas de
inicio de las ejecuciones anteriores.
Host. Una estación de trabajo Workload Scheduler
necesaria para los agentes ampliados. Puede ser
cualquier estación de trabajo del planificador excepto
otro agente ampliado.
I
Instancia de secuencia de trabajos. Una secuencia de
trabajos que se planifica para una fecha de ejecución
específica del plan. Véase también “Secuencia de
trabajos”.
Instancia de trabajo. Un trabajo planificado para una
fecha de ejecución específica del plan. Véase también
“Trabajo”.
L
Límite. Los límites de trabajos proporcionan un medio
para asignar un número específico de ranuras de
trabajo en las que Tivoli Workload Scheduler tiene
permitido iniciar trabajos. Puede establecerse un límite
de trabajos para cada secuencia de trabajos y para cada
estación de trabajo. Por ejemplo, si se establece el límite
de trabajos de la estación de trabajo en 25 permite que
el planificador ejecute 25 trabajos simultáneamente en
la estación de trabajo.
Lista. Una lista visualiza objetos de planificación de
trabajos. Debe crear listas separadas para cada objeto
de planificación de trabajos. Para cada objeto de
planificación de trabajos, hay dos tipos de listas: una de
definiciones en la base de datos y otra de instancias en
el plan.
M
Método de acceso. Un método de acceso es un
ejecutable que los agentes ampliados utilizan para
conectar y controlar la ejecución de trabajos en otros
sistemas operativos (por ejemplo, MVS) y aplicaciones
(por ejemplo, Oracle Applications, Peoplesoft y R/3). El
método de acceso debe especificarse en la definición de
estación de trabajo para el agente ampliado.
O
Opciones globales. Las opciones globales se definen
en el gestor de dominio maestro del archivo globalopts
y estas opciones se aplican a todas las estaciones de
trabajo de la red Tivoli Workload Scheduler. Véase
también “Opciones locales”.
Opciones locales. Las opciones locales se definen en
el archivo localopts. Cada estación de trabajo de la red
Tivoli Workload Scheduler debe tener un archivo
localopts. Los valores de este archivo sólo se aplican a
esa estación de trabajo. Véase también “Opciones
globales”.
P
Parámetro. Los parámetros se utilizan para sustituir
valores de los trabajos y secuencias de trabajos. Cuando
de utiliza un parámetro en un script de trabajo, el valor
se sustituye en el tiempo de ejecución. En este caso, el
parámetro debe definirse en la estación de trabajo
donde se utilizará. Los parámetros no pueden utilizarse
al crear scripts de trabajos de agentes ampliados.
Plan. El plan contiene toda la actividad de
planificación de trabajos planificada para un período de
un día. En Tivoli Workload Scheduler, el plan se crea
cada 24 horas y consiste en todos los trabajos, las
secuencias de trabajos y los objetos de dependencias
cuya ejecución está planificada para ese día. Todas las
Glosario 203
secuencias de trabajos para las que ha creado ciclos de
ejecución se planifican automáticamente y se incluyen
en el plan. A medida que el ciclo de producción
progresa, los trabajos y las secuencias de trabajos del
plan se van ejecutando de acuerdo a las restricciones
horarias y otras dependencias. Cualquier trabajo o
secuencia de trabajos que no se ejecute
satisfactoriamente se traslada la plan del día siguiente.
Plazo límite. El último momento del tiempo en que
un trabajo o secuencia de trabajos puede empezar a
ejecutarse. Se corresponde con la hora Hasta en el
Maestro heredado.
Predecesor. Un trabajo que debe completarse
satisfactoriamente antes de que los trabajos sucesores
puedan empezar la ejecución.
Prioridad. El planificador dispone de un sistema de
cola para los trabajos y las secuencias de trabajos del
plan. Puede asignar un nivel de prioridad para cada
trabajo y secuencia de trabajos, de 0 a 101. Una
prioridad de 0 no se ejecutará.
R
Recurso. Los recursos pueden representar recursos
físicos o lógicos del sistema. Una vez definidos en la
base de datos de Tivoli Workload Scheduler, pueden
utilizarse como dependencias para trabajos y secuencias
de trabajos. Por ejemplo, puede definir un recurso
denominado ″cintas″ con el valor de unidad dos.
Después, puede definir los trabajos que requieran dos
unidades de cintas disponibles como dependencia. Los
trabajos con esta dependencia no pueden ejecutarse
simultáneamente porque cada vez que se ejecutan, el
recurso “cintas” está en uso.
Restricciones horarias. Pueden especificarse
restricciones horarias para los trabajos y las secuencias
de trabajos. Puede especificarse una hora para que
empiece la ejecución o una hora después de la cual no
debe intentarse la ejecución. Si se especifican ambas,
puede definir una ventana en la cual se ejecutará un
trabajo o una secuencia de trabajos. Para los trabajos,
también puede especificar un intervalo de repetición.
Por ejemplo, puede hacer que Tivoli Workload
Scheduler inicie el mismo trabajo cada 30 minutos entre
las 8:30 de la mañana y la 1:30 de la tarde.
S
Secuencia de trabajos. Una Secuencia de trabajos
consiste en una lista de trabajos que se ejecutan como
una unidad (por ejemplo, una aplicación de copia de
seguridad semanal), junto con horas, prioridades y
otras dependencias que determinan el orden exacto de
la ejecución de trabajos.
Secuencia de trabajos final. La secuencia de trabajos
FINAL debe ser la última secuencia de trabajos que se
ejecuta en un día de producción. Contiene un trabajo
que ejecuta el archivo de script Jnextday.
Solicitud. Las solicitudes pueden utilizarse como
dependencias para trabajos y secuencias de trabajos.
Una solicitud debe responderse afirmativamente para
que se inicie el trabajo o la secuencia de trabajos
dependientes. Hay dos tipos de solicitudes: predefinida
y ad hoc. Una solicitud ad hoc se define en las
propiedades de un trabajo o secuencia de trabajos y es
exclusivo para ese trabajo o secuencia de trabajos. Una
solicitud predefinida se define en la base de datos del
planificador y puede utilizarse por cualquier trabajo o
secuencia de trabajos.
Sucesor. Un trabajo que no puede iniciarse hasta que
todos los trabajos predecesores de los que depende se
hayan completado satisfactoriamente.
T
Trabajo. Un trabajo es una unidad de trabajo que se
procesa en una estación de trabajo. La definición de
trabajo consiste en un nombre de trabajo exclusivo en
la base de datos del planificador junto con otra
información necesaria para ejecutar el trabajo. Cuando
se agrega un trabajo a una secuencia de trabajos, puede
definir sus dependencias y sus restricciones horarias
como, por ejemplo, la hora de inicio estimada y el
plazo límite.
Trabajo externo. Trabajo de una secuencia de trabajos
que es el predecesor de un trabajo de otra secuencia de
trabajos. Un trabajo externo se representa mediante un
icono de espacio reservado en la vista Gráfico.
Trabajo Jnextday. El proceso anterior y posterior a la
producción puede automatizarse completamente
mediante la planificación de la ejecución del trabajo
Jnextday para el final de cada día. Un ejemplo de
trabajo jnextday se proporciona como
inicioTWS\Jnextday. El trabajo Jnextday efectúa lo
siguiente: configura el proceso del día siguiente
(contenido en el archivo Symphony), imprime informes,
transfiere las secuencias de trabajos no finalizadas y
detiene y reinicia el planificador.
Trabajo / secuencia de trabajos inter-red (INET). Un
trabajo o secuencia de trabajos de la red Tivoli
Workload Scheduler remota que es el predecesor de un
trabajo o secuencia de trabajos de la red local. Un
trabajo inter-red se representa mediante un icono de
espacio reservado en la vista Gráfico de la secuencia de
trabajos. Véase también “Agente de red”.
Trabajos interactivos. Un trabajo que se ejecuta
interactivamente en un escritorio Windows NT.
204 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
U
Usuario . Sólo para Windows NT, el nombre de
usuario especificado en el campo “Inicio de sesión” de
una definición de trabajo debe tener una definición de
usuario que coincida. Las definiciones facilitan las
contraseñas de usuario necesarias para que el
planificador inicie trabajos.
V
Vista de árbol. La vista en el lado izquierdo de Job
Scheduling Console que visualiza el servidor del
planificador, grupos de listas predeterminadas y grupos
de listas creadas por el usuario.
Glosario 205
206 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
Índice
Aaccesibilidad xiii
agenteestándar 45
tolerante a errores 45
agente ampliadoconsulta 171
definición de estación de trabajo 171
visión general 171
agente x de Oracle Applicationsfunciones 45
agregar, ABAP 106
agregar, pasos 106
agregar, programa externo 106
archivo de control 94
archivo de datos 94
archivo de opciones 57
archivo de opciones, R3OPTIONS 85
Archivo de script 155
archivo mcmagent.optsejemplo 54
sintaxis de entrada 53
visión general 53
archivo R3OPTIONS 85
archivos de corrección y transporte 94
archivos de opciones psagent 65
Bbases de datos Peoplesoft, múltiples 69
bm check status 161, 163
CCA7INTERFACE 146
CA7NAME 146
CA7OPTIONS 146
CA7SPAN(9999) 146
CA7SUBSYSTEM 146
CA7USER 147
cambiar contraseña, usuario RFC 97
Centro de información de software de
Tivoli xii
CFuser 152
cifrado de contraseñas 54
cifrado de contraseñas de usuario 54
cifrar contraseña de usuario R/3 89
comentarios acerca de publicaciones xii
compatibilidad 87
COMPLETIONCODE 147
conectar a múltiples bases de datos 69
conexión a R/3, solucionar
problemas 96
conexión R/3 96
contacto por correo electrónico xii
contraseña de usuario RFC 97
controlar la ejecución de trabajos 101
conveniostipo de letra xiii
convenios de tipo de letra xiii
correlación de estados de trabajos 80
correlacionar estados de trabajos 80
creación de trabajos de agente
ampliado 77
crear el perfil de autorización 91
crear un trabajo 102
crear un trabajo en R/3 101
crear una dependencia de apertura 78
CHCheckInterval 152
DDEBUG 147
definición de trabajos en Oracle
Applications 49
definición de trabajos en peoplesoft 58
definiciones de trabajos 77
definir trabajos de Oracle Applicationsen Tivoli Workload Scheduler 49
definir trabajos en R/3 101
dependencia de apertura 78
dependencia de trabajos zOS 155
dependencias de trabajos zOS 155
depurar 96
Eejecución de trabajos 203
ejemplo de dependencias de apertura 79
ejemplos de dependencia de apertura 79
enigma 54
espera BDC 127
estado de trabajos, correlación 80
estados, trabajo 111
estados de apariciones para OPC 162
estados de aplicaciones para OPC 162
estados de trabajo para CA7 160
estados de trabajo para JES 159
estados de trabajo para OPC 162
estados de trabajosMaestro y Oracle Applications 51
estados de trabajos R/3 111
Ffunciones 45, 57, 141
Ggateway z/OS
descargar archivos del CD-Rom 143
descargar archivos desde cinta 143
Hhost de destino 105
Iinformación de diagnóstico 164
inicio 145
instalación 149
instalar módulos ABAP 91
INTERLINKSUBSYSTEM 147
introducción 57
JJCL para descargar la cinta 143
JESCMDCHR 147
Llibros
véase publicaciones x, xii
LJuser 152
Mmanuales
véase publicaciones x, xii
MAXWAIT 147
MCMAGENT 47
MCMAGENT.opts 48
MCSSTORAGE 147
mensajes 167
mensajes de error 167
mensajes de gateway 167
método 85
método R3BATCH 85
módulos ABAP 106
módulos ABAP, importar 94
múltiples bases de datos Peoplesoft 69
NNOMBRE_ESTACIÓN_TRABAJO
_MCMAGENT.opts 48
nombres de directorio, notación xiv
nombres de ruta, notación xiv
notaciónnombres de rutas xiv
tipo de letra xiv
variables de entorno xiv
OOPCINTERFACE 148
opción de espera BDC 96
opciones psagent 65
OPCMSGCLASS 148
OPCSUBSYSTEM 148
© Copyright IBM Corp. 2000, 2003 207
OPERCMDS 145
Ppedir publicaciones xii
PEERADDRESS 148
perfil de autorización, crear 91
perfil RFC 91
pila TCPIP 149
planificar agentevisión general 85
PORT 148
programa enigma 89
programa externo 106
psagent 57, 69
publicaciones x
acceder en línea xii
pedir xii
publicaciones en líneaacceder xii
PUTLINE 148
QQLIMIT 148
Rrastrear 96
registro de trabajos 127
requisitos de software 61, 63
requisitos del host 61
Ssalida IEFU84 144
seguridad 145
seguridad de consola 145
sintaxis, archivo mcmagent.opts 53
softwarecomponentes 47
requisitos 45
software de interfaz 47
solucionar problemas de conexión
R/3 96
soporte al clientevéase soporte de software xiii
soporte de softwarecomunicar con xiii
SUBSYS 148
SVCDUMP 148
TTCPIPSTACK 149
TCPNAME 149
TERMINATOR 149
trabajosestados de trabajos 111
trabajos CA7 153
trabajos de Oracle Applicationsdefinición 49
trabajos JES 153
trabajos OPC 154
Uusuario RFC 96
Vvariables, notación para xiv
variables de entorno, notación xiv
variables SYSTSIN 146
versión de TCP/IP 141
visión general 57
visión general de la instalación 87
Visión general de la utilización de
CA7 160
visión general de la utilización de
JES 159, 160
visión general de la utilización de
OPC 162
visión general técnica 159
WWTP 149
ZZOSV1R2 149
208 IBM Tivoli Workload Scheduler for Applications: Guía del usuario
���
Printed in Denmark by IBM Danmark A/S
SC10-3867-00