Guía del usuariopublib.boulder.ibm.com/tividd/td/ITWS/SC32-1278-00/es_ES/PDF/tws8… ·...

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


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


PeopleSoft . . . . . . . . . . . . 55


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


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


versión 8.1x . . . . . . . . . . . . . . 74

Personalización del servidor de aplicaciones . . 74

Configuración del cliente . . . . . . . . . 75


versión 8.4x . . . . . . . . . . . . . . 75

Capítulo 12. Definición de trabajos

PeopleSoft . . . . . . . . . . . . . 77

Creación de definiciones de trabajo Peoplesoft en



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


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


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


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


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


z/OS . . . . . . . . . . . . . . . 139

Capítulo 24. Introducción . . . . . . 141

Funciones . . . . . . . . . . . . . . 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


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



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


específicamente para este método de acceso.

Parte 4. Método de acceso de R/3



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


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



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


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

http://publib.boulder.ibm.com/tividd/glossary/termsmst04.htm

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

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

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

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

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

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

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.


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.


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


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.


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.


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


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.


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.


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.


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.


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.


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.


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.


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.


Tabla 3. Opciones necesarias para la instalación silenciosa. (continuación)


-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



para R/3. Esta opción es

obligatoria si está instalando

este método.





espacio en blanco.

-P ZOSAGENT_FEATURE.active Especifica que debe instalarse


z/OS.

True o False.

-W LJUSER_ZOSAGENT_INPUT_BEAN.LJUSER El nombre del usuario de Tivoli



para z/OS. Esta opción es


este método.





espacio en blanco.

-P PSAGENT_FEATURE.active Especifica que debe instalarse


PeopleSoft.

True o False.

-W LJUSER_PSAGENT_INPUT_BEAN.LJUSER El nombre del usuario de Tivoli



para PeopleSoft. Esta opción es


este método.





espacio en blanco.




-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


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.



NetExpress 3.x. Se utiliza si se

especifica este entorno.



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



<INICIO_PS>\cblbin.







<INICIO_PS>\cblbin.







<INICIO_PS>\cblbin.




-W PS81_APIDIR.DIRNAME La ruta del directorio de API

externas para PeopleTools 8.1x.

Se utiliza si se especifica este

entorno.



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



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


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.


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


PS70WB4

PeopleTools 7.0x y MF COBOL Workbench 4.x

PS75MR2


PS75MR3




Si las entradas son múltiples, deben ir separadas por punto y

coma.


Tabla 5. Opciones adicionales necesarias para instalar el método de acceso para

PeopleSoft SPB mediante Software Distribution. (continuación)


PS70MR2_CBLDIR La ruta del directorio COBOL para PeopleTools 7.0x y Merant

NetExpress 2.x. Se utiliza si ha especificado este entorno.


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.





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.


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.


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.


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


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:


Á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.


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


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.


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.


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


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.


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.


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


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


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



Parte 2. Método de acceso de Oracle e-Business Suite


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:


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.


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



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,




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





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.


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


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


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

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.


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.


Tabla 10. Opciones de MCMAGENT. (continuació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



Parte 3. Método de acceso de PeopleSoft



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.


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.


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


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


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.


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.



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

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


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.


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.


Tabla 11. Opciones de psagent. (continuació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)


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


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.


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:


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


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.


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).


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


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.


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


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:






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


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

PDF

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


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


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

Parte 4. Método de acceso de R/3



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


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.


Capítulo 14. Instalación

Este apartado contiene información sobre la instalación de IBM Tivoli Workload

Scheduler for Applications para R3.


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.


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)


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


Capítulo 14. Instalación 89

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.


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)


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


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:


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:


v Programa ABAP/4 de grupo de autorizaciones:


S_RFC Comprobación de autorización para el acceso RFC

v Actividad: Autorización completa

v Nombre de RFC que debe protegerse:


v Tipo de objeto RFC que debe protegerse:


S_SPO_ACT Spool: Acciones

v Campo de autorización para acciones de spool:


v Valor para la comprobación de autorización:


S_SPO_DEV Spool: Autorizaciones de dispositivo

v Spool - Nombres largos de dispositivo:


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:


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


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


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


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


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:


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



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



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:


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.


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


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.


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.


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.


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.


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:


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.





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.


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


Tabla 15. Parámetros de cadena de tarea para trabajos R/3. (continuació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


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


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.


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″


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


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


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.


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.


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.


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.


Tabla 17. Opciones de configuración locales de r3batch. (continuació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)


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


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




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




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.


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


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.


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


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.


skip.




group = group

user = user

keep = keep

holddate = holddate.

message i001(92) with group.


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.


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.


skip.




group = group

user = user

keep = keep

holddate = holddate

importing qid = myquid.

message i001(92) with myqid.


endif.

endform.

v Para SAP releases 4.6c y posteriores:

form open_group.

skip.


skip.




group = group

user = user

keep = keep

holddate = holddate

importing qid = myquid.

message i001(92) with myqid.


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.


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.


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


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.


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

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.


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.


Parte 5. Método de acceso de z/OS



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.


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


v Interfaz CA7: cualquier versión soportada

actualmente.


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.


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.


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


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



//SYSIN DD *

COPY OUTDD=OUTDD,INDD=((INDD,R))

//*



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


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.


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.


Tabla 21. Variables SYSTSIN. (continuació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


a NO.

MCSSTORAGE(3) La cantidad de almacenamiento, en

megabytes, utilizados por cada

consola ampliada utilizada por el

gateway. Debe pasarse por alto si


a NO.




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


OPCSUBSYSTEM(OPCS) El nombre de subsistema utilizado

para las comunicaciones con la

región de control de OPC o Tivoli


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.




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


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.


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.



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:







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.


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)} ]


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


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


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


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


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.


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)


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.


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


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



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



EEWTCP25 Servidor simultáneo

EEWTCP26 Proveedor TCPIP de Interlink del servidor simultáneo



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



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


Parte 6. Servicios comunes


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.


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.


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


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:


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


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.


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.


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.


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:


GS %CJ estado [idtrabajo] Establece el estado del trabajo en estado e

incluye el idtrabajo en cualquier tarea GS

subsiguiente.


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]


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


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


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


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.


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


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.


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.


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


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



PeopleTools 7.0x y MF COBOL Workbench 4.x:PSHOME70CWB4\cblbin\TVPUPSFT.exe

PSHOME70CWB4\cblbin\TVPUPSFT.gnt





Para PeopleTools 8.1x:PSHOME81X\bin\client\winx86_extapi\TVPUPSFT.exe

Para PeopleTools 8.4x:PSHOME84X\bin\client\winx86\TVPUPSFT.exe


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


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

Parte 7. Apéndices


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


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.


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

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.


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.


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.


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

Í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


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


��

Printed in Denmark by IBM Danmark A/S

SC10-3867-00

Guía del usuariopublib.boulder.ibm.com/tividd/td/ITWS/SC32-1278-00/es_ES/PDF/tws8… ·...

Documents

Transcript of Guía del usuariopublib.boulder.ibm.com/tividd/td/ITWS/SC32-1278-00/es_ES/PDF/tws8… ·...