t l tivoli workload -...

Tivoli® IBM Tivoli Workload

Scheduler

Guía de consulta

Versión 8.2 (revisada en diciembre de 2004)

SC10-3852-02

��

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

Tercera edición (diciembre de 2004)

Este manual es la traducción del original inglés IBM Tivoli Workload Scheduler Reference Guide Version 8.2 (Revised

December 2004), (SC32-1274-02).

Esta edición se aplica a la versión 8, release 2, nivel de modificación 0 de IBM Tivoli Workload Scheduler (número

de programa 5698-WSH) y a todos los releases y modificaciones posteriores hasta que se indique otra cosa en

nuevas ediciones.

Esta edición sustituye a la publicación SC10–3852–01.

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

Contenido

Figuras . . . . . . . . . . . . . . vii

Tablas . . . . . . . . . . . . . . . ix

Acerca de esta guía . . . . . . . . . xi

Novedades de esta guía . . . . . . . . . . xi

A quién va dirigida esta guía . . . . . . . . xi

Contenido de esta guía . . . . . . . . . . . xi

Publicaciones . . . . . . . . . . . . . . xii

Biblioteca de IBM Tivoli Workload Scheduler . . xii

Publicaciones relacionadas . . . . . . . . xv

Cómo acceder a las publicaciones en línea . . . xvi

Cómo solicitar publicaciones . . . . . . . xvii

Cómo proporcionar información de usuario

sobre las publicaciones . . . . . . . . . xvii

Accesibilidad . . . . . . . . . . . . . xvii

Entrenamiento técnico en Tivoli . . . . . . . xvii

Información de soporte . . . . . . . . . . xvii

Convenios utilizados en esta guía . . . . . . xviii

Convenios de tipos de letra . . . . . . . xviii

Variables y rutas que dependen del sistema

operativo . . . . . . . . . . . . . xviii

Sintaxis de los comandos . . . . . . . . xix

Capítulo 1. Arranque rápido . . . . . . 1

Creación de un plan . . . . . . . . . . . . 2

Gestión de trabajos y secuencias de trabajos . . . . 5

Capítulo 2. El ciclo de producción . . . 9

Interfaces y procesos principales del producto . . . 9

Interfaces de usuario . . . . . . . . . . . 9

Comandos previos y posteriores a la producción 10

Comandos de seguridad . . . . . . . . . 10

Procesos de producción . . . . . . . . . 10

El árbol de procesos en las plataformas UNIX . . 11

El árbol de procesos en las plataformas Windows 13

Automatización del ciclo de producción . . . . . 15

Cómo personalizar la secuencia de trabajos final 15

Cómo personalizar la secuencia de trabajos final 16

Cómo iniciar un ciclo de producción . . . . . 16

Gestión del entorno de producción . . . . . . 17

Cómo elegir el inicio del día de IBM Tivoli

Workload Scheduler . . . . . . . . . . 17

Cómo cambiar el inicio del día . . . . . . . 17

Creación de un plan para fechas futuras o

pasadas . . . . . . . . . . . . . . . 18

Cómo utilizar informes . . . . . . . . . 18

Inicio de trabajos . . . . . . . . . . . . 18

Variables de entorno de trabajo . . . . . . . 19

Script de configuración estándar - jobmanrc . . 19

Script de configuración local - $HOME/.jobmanrc 21

Comandos del proceso de producción . . . . . 22

El comando schedulr . . . . . . . . . . 23

El comando compiler . . . . . . . . . . 25

El comando stageman . . . . . . . . . . 27

El comando logman . . . . . . . . . . 30

El comando wmaeutil . . . . . . . . . . 32

Capítulo 3. Consulta de Composer . . . 35

Gestión de objetos de planificación . . . . . . 35

Definiciones de estación de trabajo . . . . . 37

Definiciones de clases de estación de trabajo . . 43

Definiciones de dominio . . . . . . . . . 45

Definiciones de trabajo . . . . . . . . . 47

Definiciones de usuario . . . . . . . . . 53

Definiciones de calendario . . . . . . . . 56

Definiciones de parámetros . . . . . . . . 57

Definiciones de solicitudes . . . . . . . . 59

Definiciones de recursos . . . . . . . . . 61

El programa de línea de comandos Composer . . . 62

Cómo ejecutar Composer . . . . . . . . . 62

Sintaxis de los comandos . . . . . . . . . 64

Descripciones de comandos . . . . . . . . . 65

add . . . . . . . . . . . . . . . . 67

build . . . . . . . . . . . . . . . 68

continue . . . . . . . . . . . . . . 69

create . . . . . . . . . . . . . . . 70

delete . . . . . . . . . . . . . . . 72

display, list, print . . . . . . . . . . . 74

edit . . . . . . . . . . . . . . . . 78

exit . . . . . . . . . . . . . . . . 79

modify . . . . . . . . . . . . . . . 80

new . . . . . . . . . . . . . . . . 82

redo . . . . . . . . . . . . . . . . 83

replace . . . . . . . . . . . . . . . 85

system, comando . . . . . . . . . . . 86

validate . . . . . . . . . . . . . . . 87

version . . . . . . . . . . . . . . . 88

Capítulo 4. El lenguaje de planificación 89

Sintaxis para las secuencias de trabajos . . . . . 89

Palabras clave . . . . . . . . . . . . 90

Dependencias . . . . . . . . . . . . . 91

Sensibilidad a las mayúsculas y minúsculas . . 91

Descripciones de palabras clave . . . . . . . 92

at . . . . . . . . . . . . . . . . . 93

carryforward . . . . . . . . . . . . . 95

comments . . . . . . . . . . . . . . 96

confirmed . . . . . . . . . . . . . . 97

deadline . . . . . . . . . . . . . . 98

end . . . . . . . . . . . . . . . . 99

every . . . . . . . . . . . . . . . 100

except . . . . . . . . . . . . . . . 101

follows . . . . . . . . . . . . . . 104

freedays . . . . . . . . . . . . . . 105

Sentencia de trabajo . . . . . . . . . . 107

keyjob . . . . . . . . . . . . . . . 112

keysched . . . . . . . . . . . . . . 113

limit . . . . . . . . . . . . . . . 114

© Copyright IBM Corp. 1999, 2004 iii

||

||

||||||

||||||||||||||

||

needs . . . . . . . . . . . . . . . 115

on . . . . . . . . . . . . . . . . 116

opens . . . . . . . . . . . . . . . 119

priority . . . . . . . . . . . . . . 121

prompt . . . . . . . . . . . . . . 122

schedule . . . . . . . . . . . . . . 123

until . . . . . . . . . . . . . . . 124

Capítulo 5. Consulta de Conman . . . 127

Ejecución de Conman . . . . . . . . . . 127

Ejemplos . . . . . . . . . . . . . . 127

Caracteres de control . . . . . . . . . . 127

Ejecución de comandos del sistema . . . . . 127

Emisión de mensajes de solicitud al usuario . . 128

Salida de terminal . . . . . . . . . . . 128

Salida fuera de línea . . . . . . . . . . 128

Selección del indicador de comandos de

Conman . . . . . . . . . . . . . . 129

Sintaxis de los comandos . . . . . . . . . 129

Caracteres comodín . . . . . . . . . . 130

Delimitadores y caracteres especiales . . . . 130

Lista de comandos . . . . . . . . . . 131

Selección de trabajos en comandos . . . . . . 133

Sinopsis . . . . . . . . . . . . . . 133

Argumentos . . . . . . . . . . . . . 133

Selección de secuencias de trabajos en comandos 141

Sinopsis . . . . . . . . . . . . . . 141

Argumentos . . . . . . . . . . . . . 141

Descripciones de comandos . . . . . . . . 148

Proceso de comandos de Conman . . . . . 148

adddep job . . . . . . . . . . . . . 149

adddep sched . . . . . . . . . . . . 151

altpass . . . . . . . . . . . . . . . 153

altpri . . . . . . . . . . . . . . . 154

cancel job . . . . . . . . . . . . . . 155

cancel sched . . . . . . . . . . . . . 157

confirm . . . . . . . . . . . . . . 159

console . . . . . . . . . . . . . . 161

continue . . . . . . . . . . . . . . 162

deldep job . . . . . . . . . . . . . 163

deldep sched . . . . . . . . . . . . 165

display . . . . . . . . . . . . . . 167

exit . . . . . . . . . . . . . . . . 168

fence . . . . . . . . . . . . . . . 169

help . . . . . . . . . . . . . . . 171

kill . . . . . . . . . . . . . . . . 172

limit cpu . . . . . . . . . . . . . . 173

limit sched . . . . . . . . . . . . . 174

link . . . . . . . . . . . . . . . . 175

listsym . . . . . . . . . . . . . . 177

recall . . . . . . . . . . . . . . . 178

redo . . . . . . . . . . . . . . . 179

release job . . . . . . . . . . . . . 181

release sched . . . . . . . . . . . . 183

reply . . . . . . . . . . . . . . . 185

rerun . . . . . . . . . . . . . . . 186

resource . . . . . . . . . . . . . . 189

setsym . . . . . . . . . . . . . . 190

showcpus . . . . . . . . . . . . . 191

showdomain . . . . . . . . . . . . 195

showfiles . . . . . . . . . . . . . . 196

showjobs . . . . . . . . . . . . . . 198

showprompts . . . . . . . . . . . . 207

showresources . . . . . . . . . . . . 209

showschedules . . . . . . . . . . . . 211

shutdown . . . . . . . . . . . . . 215

start . . . . . . . . . . . . . . . 216

status . . . . . . . . . . . . . . . 218

stop . . . . . . . . . . . . . . . 219

stop ;progressive . . . . . . . . . . . 221

submit docommand . . . . . . . . . . 222

submit file . . . . . . . . . . . . . 224

submit job . . . . . . . . . . . . . 226

submit sched . . . . . . . . . . . . 228

switchmgr . . . . . . . . . . . . . 230

system . . . . . . . . . . . . . . 231

tellop . . . . . . . . . . . . . . . 232

unlink . . . . . . . . . . . . . . . 233

version . . . . . . . . . . . . . . 235

Capítulo 6. Comandos de utilidad . . . 237

Descripciones de comandos . . . . . . . . 237

Comandos at y batch . . . . . . . . . . 239

caxtract . . . . . . . . . . . . . . 243

cpuinfo . . . . . . . . . . . . . . 244

datecalc . . . . . . . . . . . . . . 246

dbexpand . . . . . . . . . . . . . 250

delete . . . . . . . . . . . . . . . 252

evtsize . . . . . . . . . . . . . . . 253

jbxtract . . . . . . . . . . . . . . 255

jobinfo . . . . . . . . . . . . . . . 257

jobstdl . . . . . . . . . . . . . . . 259

maestro . . . . . . . . . . . . . . 261

makecal . . . . . . . . . . . . . . 262

metronome.pl . . . . . . . . . . . . 264

morestdl . . . . . . . . . . . . . . 265

parms . . . . . . . . . . . . . . . 267

paxtract . . . . . . . . . . . . . . 268

prxtract . . . . . . . . . . . . . . 269

r11xtr . . . . . . . . . . . . . . . 270

release . . . . . . . . . . . . . . . 271

rextract . . . . . . . . . . . . . . 273

rmstdlist . . . . . . . . . . . . . . 274

showexec . . . . . . . . . . . . . . 275

StartUp . . . . . . . . . . . . . . 276

version . . . . . . . . . . . . . . 277

wmaeutil . . . . . . . . . . . . . . 279

xrxtrct . . . . . . . . . . . . . . . 281

Comandos no soportados . . . . . . . . 286

Capítulo 7. Los comandos de informe 287

Comandos de informe . . . . . . . . . . 287

Salida de los comandos . . . . . . . . . 287

Comandos rep1 - rep4b . . . . . . . . . 289

Comando rep7 . . . . . . . . . . . . 290

Comando rep8 . . . . . . . . . . . . 291

Comando rep11 . . . . . . . . . . . 292

Comando reptr . . . . . . . . . . . . 293

Comando xref . . . . . . . . . . . . 295

Informes de ejemplo . . . . . . . . . . 296

iv IBM Tivoli Workload Scheduler - Guía de consulta

| |

Capítulo 8. Consulta del agente

ampliado . . . . . . . . . . . . . 299

Qué son los agentes ampliados . . . . . . . 299

Definición de estación de trabajo . . . . . . 299

Interfaz del método de acceso . . . . . . . . 299

Sintaxis de la línea de comandos del método 299

Mensajes de respuesta de métodos . . . . . 302

Archivo de opciones de métodos . . . . . . 303

Ejecución del método . . . . . . . . . . . 303

Tarea Iniciar trabajo (LJ) . . . . . . . . . 304

Tarea Gestionar trabajo (MJ) . . . . . . . 304

Tarea Comprobar archivo (CF) . . . . . . . 305

Tarea Obtener estado (GS) . . . . . . . . 305

El comando cpuinfo . . . . . . . . . . 306

Resolución de problemas . . . . . . . . . 306

Mensajes de error de lista estándar de trabajos 306

Método no ejecutable . . . . . . . . . . 306

Mensajes del Gestor de consola . . . . . . 307

Mensajes de Composer y Compiler . . . . . 307

Mensajes de Jobman . . . . . . . . . . 307

Capítulo 9. Consulta del Agente de

red . . . . . . . . . . . . . . . . 309

Visión general . . . . . . . . . . . . . 309

Configuración de una estación de trabajo de

Agente de red . . . . . . . . . . . . . 309

Ejemplo de línea de comandos del Agente de

red . . . . . . . . . . . . . . . . 311

Archivo de opciones . . . . . . . . . . 311

Dependencias inter-red . . . . . . . . . . 312

Creación de una dependencia inter-red para una

secuencia de trabajos . . . . . . . . . . 312

Dependencias inter-red y Conman . . . . . 314

Capítulo 10. Establecimiento de

definiciones de seguridad del usuario . 317

Centralización de la seguridad . . . . . . . 317

Trabajo con el archivo de seguridad . . . . . . 318

Creación del archivo de seguridad . . . . . 318

Modificación del archivo de seguridad . . . . 318

Sintaxis del archivo de seguridad . . . . . . . 319

Definiciones de usuario . . . . . . . . . 319

Archivo de seguridad de ejemplo . . . . . . . 329

dumpsec . . . . . . . . . . . . . . . 334

makesec . . . . . . . . . . . . . . . 335

Apéndice A. Información de soporte 337

Búsqueda en bases de información . . . . . . 337

Búsqueda en el centro de información de la red

o del sistema local . . . . . . . . . . . 337

Búsqueda en el centro de información del sitio

Web de soporte de IBM . . . . . . . . . 337

Búsqueda en Internet . . . . . . . . . . 338

Obtención de arreglos . . . . . . . . . . 338

Cómo ponerse en contacto con el Servicio de

soporte de software de IBM . . . . . . . . 338

Determinación del impacto comercial del

problema . . . . . . . . . . . . . . 339

Descripción del problema y recopilación de

información de antecedentes . . . . . . . 340

Sometimiento del problema al Servicio de

soporte de software de IBM . . . . . . . 340

Apéndice B. Gestión de husos

horarios . . . . . . . . . . . . . . 341

Activación de la función de huso horario . . . . 341

Ejecución de una secuencia de trabajos sin el

huso horario habilitado cuando el gestor de

dominio maestro está adelantado respecto al

agente tolerante a errores . . . . . . . . 342

Ejecución de una secuencia de trabajos con el

huso horario habilitado cuando el maestro está

adelantado respecto al agente tolerante a errores 342

Ejecución de una secuencia de trabajos sin el


dominio maestro está atrasado respecto al

agente tolerante a errores . . . . . . . . 343

Ejecución de una secuencia de trabajos con el


dominio maestro está atrasado respecto al

agente tolerante a errores. . . . . . . . . 343

Sometimiento ad hoc de una secuencia de

trabajos especificando una dependencia at . . . 343

Sometimiento de una secuencia de trabajos

especificando una dependencia at que se

produce durante el horario de verano . . . . 344

Lista de husos horarios . . . . . . . . . . 345

Apéndice C. La función de auditoría 347

Habilitación de la función de auditoría . . . . . 347

Formato del registro de auditoría . . . . . . . 348

Cabecera del registro de auditoría . . . . . . 351

Ejemplos de entradas del registro de auditoría . . 352

Avisos . . . . . . . . . . . . . . 353

Marcas registradas . . . . . . . . . . . . 354

Glosario . . . . . . . . . . . . . 355

Índice . . . . . . . . . . . . . . . 361

Contenido v

|||||||||||||||||||||

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

vi IBM Tivoli Workload Scheduler - Guía de consulta

Figuras

1. Árbol de procesos en UNIX . . . . . . . 12

2. Árbol de procesos en Windows . . . . . . 14

3. Vínculos de red . . . . . . . . . . . 176

4. Estaciones de trabajo iniciadas de la red 217

5. Estaciones de trabajo detenidas de la red 220

6. Estaciones de trabajo de red desvinculadas 234

7. Redes locales y remotas . . . . . . . . 311

8. Zonas muertas . . . . . . . . . . . 341

© Copyright IBM Corp. 1999, 2004 vii

||||

| |

viii IBM Tivoli Workload Scheduler - Guía de consulta

Tablas

1. Sintaxis de los comandos . . . . . . . . xix

2. Variables de entorno de trabajo . . . . . . 19

3. Variables de jobmanrc . . . . . . . . . 20

4. Lista de palabras reservadas . . . . . . . 36

5. Valores para los sistemas operativos

soportados . . . . . . . . . . . . . 38

6. Tipo de comunicación en función del valor de

securitylevel. . . . . . . . . . . . . 40

7. Operador de comparación . . . . . . . . 49

8. Operadores lógicos . . . . . . . . . . 49

9. Operador de comparación . . . . . . . 109

10. Operadores lógicos . . . . . . . . . . 109

11. Atributos de objeto . . . . . . . . . 321

12. Acciones . . . . . . . . . . . . . 322

13. Acciones (continuación) . . . . . . . . 323

© Copyright IBM Corp. 1999, 2004 ix

||

| | | | | |

x IBM Tivoli Workload Scheduler - Guía de consulta

Acerca de esta guía

IBM Tivoli Workload Scheduler simplifica la gestión de sistemas en entornos

distribuidos integrando las funciones de gestión de sistemas. IBM Tivoli Workload

Scheduler planifica, automatiza y controla el proceso de toda la carga de trabajo de

producción de la empresa. La publicación IBM Tivoli Workload Scheduler - Guía de

consulta proporciona información detallada sobre la interfaz de línea de comandos,

el idioma de planificación y los comandos de utilidad para IBM Tivoli Workload

Scheduler.

Novedades de esta guía

Esta edición es una renovación de la publicación IBM Tivoli Workload Scheduler -

Guía de consulta, Versión 8.2, renovada previamente en abril de 2004.

Éstas son las principales mejoras realizadas en la guía:

v Se ha proporcionado un nuevo apartado ″Véase también″ en la descripción de

varios comandos.

v Se han proporcionado más ejemplos para los comandos.

v En el Capítulo 2 se ha añadido una nueva sección que describe los procesos y

las interfaces del producto, consulte el apartado “Interfaces y procesos

principales del producto” en la página 9.

v Se ha añadido un nuevo capítulo, denominado ″Arranque rápido″, para los

nuevos usuarios.

v Se ha añadido más información sobre el Archivo de seguridad, consulte el

Capítulo 10, “Establecimiento de definiciones de seguridad del usuario”, en la

página 317.

v Se ha añadido un nuevo apéndice que proporciona información sobre cómo

ponerse en contacto con el Servicio de soporte de IBM, consulte el Apéndice A,

“Información de soporte”, en la página 337.

v Se ha añadido un nuevo apéndice para describir la función de huso horario,

consulte el Apéndice B, “Gestión de husos horarios”, en la página 341.

v La información contenida en esta guía se ha actualizado de forma que refleje los

dos APAR IY58702 e IY53459.

A quién va dirigida esta guía

Esta guía va dirigida a administradores y usuarios avanzados de IBM Tivoli

Workload Scheduler.

Contenido de esta guía

Esta publicación contiene los capítulos siguientes:

v Capítulo 1, “Arranque rápido”, en la página 1

Explica los pasos básicos que un usuario nuevo debe seguir para empezar a

utilizar IBM Tivoli Workload Scheduler por primera vez.

v Capítulo 2, “El ciclo de producción”, en la página 9

© Copyright IBM Corp. 1999, 2004 xi

|

||

|

||

|

|||

||

|||

|||

||

||

Describe cómo determina IBM Tivoli Workload Scheduler, al final de cada día,

qué planificaciones se deben ejecutar el día siguiente, en base a la información

guardada en la base de datos y al resultado del proceso del día de producción

actual.

v Capítulo 3, “Consulta de Composer”, en la página 35

Describe los objetos de planificación que se pueden definir en la base de datos

de IBM Tivoli Workload Scheduler y explica el uso y la sintaxis de los comandos

utilizados en el programa Composer para gestionar dichos objetos en la base de

datos.

v Capítulo 4, “El lenguaje de planificación”, en la página 89

Explica cómo crear una secuencia de trabajos, en base a los objetos de

planificación definidos en la base de datos de IBM Tivoli Workload Scheduler,

utilizando el comando composer.

v Capítulo 5, “Consulta de Conman”, en la página 127

Describe la interfaz de línea de comandos de Conman. Se utiliza para supervisar

y gestionar trabajos y secuencias de trabajos durante un día de producción.

v Capítulo 6, “Comandos de utilidad”, en la página 237

Describe los comandos de utilidad de IBM Tivoli Workload Scheduler que

gestionan el entorno.

v Capítulo 7, “Los comandos de informe”, en la página 287

Describe cómo imprimir distintos tipos de informes.

v Capítulo 8, “Consulta del agente ampliado”, en la página 299

Describe cómo crear y utilizar agentes ampliados para ampliar las funciones de

planificación de trabajos de IBM Tivoli Workload Scheduler a otros sistemas y

aplicaciones, como por ejemplo Sistemas UNIX locales o remotos, Peoplesoft,

SAP R/3, z/OS, OPC, Oracle CCM y VMS.

v Capítulo 9, “Consulta del Agente de red”, en la página 309

Describe cómo crear y utilizar una estación de trabajo de agente de red para

gestionar dependencias inter-red de planificación.

v Capítulo 10, “Establecimiento de definiciones de seguridad del usuario”, en la

página 317

Describe cómo gestionar el Archivo de seguridad.

v Apéndice A, “Información de soporte”, en la página 337

Describe las distintas opciones para obtener soporte para los productos de IBM.

v Apéndice B, “Gestión de husos horarios”, en la página 341

Lista los husos horarios a los que IBM Tivoli Workload Scheduler da soporte.

v Apéndice C, “La función de auditoría”, en la página 347

Describe cómo habilitar y utilizar la opción de auditoría para hacer un

seguimiento de los cambios aplicados a la base de datos y al plan.

Publicaciones

Este apartado lista las publicaciones de la biblioteca de Tivoli Workload Scheduler y

otros documentos relacionados. También describe cómo acceder a las publicaciones

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

Biblioteca de IBM Tivoli Workload Scheduler

IBM Tivoli Workload Scheduler consta de varios productos separados disponibles

en una variedad de plataformas, y la biblioteca se divide de forma parecida:

xii IBM Tivoli Workload Scheduler - Guía de consulta

|

||

Biblioteca de la suite de IBM Tivoli Workload Scheduling

Esta biblioteca contiene todas las publicaciones de plataformas cruzadas y

productos cruzados para IBM Tivoli Workload Scheduler.

Biblioteca distribuida de IBM Tivoli Workload Scheduler

Esta biblioteca contiene todas las publicaciones que hacen referencia a la

utilización de IBM Tivoli Workload Scheduler en plataformas distintas de

z/OS.

Biblioteca de IBM Tivoli Workload Scheduler for z/OS

Esta biblioteca contiene todas las publicaciones que se aplican únicamente

a IBM Tivoli Workload Scheduler for z/OS.

Biblioteca de IBM Tivoli Workload Scheduler for Applications


a IBM Tivoli Workload Scheduler for Applications.

Biblioteca de IBM Tivoli Workload Scheduler for Virtualized Data Centers


a IBM Tivoli Workload Scheduler for Virtualized Data Centers.

Biblioteca de la suite de IBM Tivoli Workload Scheduling

Las publicaciones siguientes están disponibles en la biblioteca de la suite de IBM

Tivoli Workload Scheduling. Esto incluye publicaciones comunes a todos los

productos, plataformas y componentes.

v IBM Tivoli Workload Scheduler: General Information, SC32-1256

Proporciona información general sobre todos los productos de IBM Tivoli

Workload Scheduler. Ofrece una visión general de cómo se pueden utilizar en

conjunto para proporcionar soluciones de gestión de la carga de trabajo para

toda la empresa.

v IBM Tivoli Workload Scheduler: Job Scheduling Console - Guía del usuario, SC10-3171

Describe cómo trabajar con IBM Tivoli Workload Scheduler, independientemente

de la plataforma, utilizando una GUI común denominada Job Scheduling Console.

v IBM Tivoli Workload Scheduler: Job Scheduling Console Release Notes, SC32-1258

Proporciona información de última hora sobre Job Scheduling Console.

v IBM Tivoli Workload Scheduler: Warehouse Enablement Pack Versión 1.1.0

Implementation Guide for Tivoli Enterprise Data Warehouse, Versión 1.1,

Proporciona información sobre cómo habilitar IBM Tivoli Workload Scheduler

para Tivoli Data Warehouse.

Nota: Esta guía sólo está disponible en el CD del producto. No es posible

acceder a ella en línea, tal como se puede hacer con las otras

publicaciones (consulte el apartado “Cómo acceder a las publicaciones en

línea” en la página xvi).

Biblioteca distribuida de IBM IBM Tivoli Workload Scheduler

Las publicaciones siguientes están disponibles en la biblioteca distribuida de IBM

IBM Tivoli Workload Scheduler. Esto incluye publicaciones que hacen referencia a

la utilización del producto en todas las plataformas a excepción de z/OS.

v IBM Tivoli Workload Scheduler: Release Notes, SC32-1277

Proporciona información de última hora sobre IBM Tivoli Workload Scheduler

en plataformas distintas de z/OS.

v IBM Tivoli Workload Scheduler: Guía de planificación e instalación, SC10-3833

Acerca de esta guía xiii

|||

||||

|||

|||

|||

||||

|

||||

|

||

|

|

||

||

||||

||||

|

||

|

Describe cómo planificar e instalar IBM IBM Tivoli Workload Scheduler en

plataformas distintas de z/OS, y cómo integrar IBM Tivoli Workload Scheduler

con NetView, Tivoli Data Warehouse e IBM IBM Tivoli Business Systems

Manager.

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

Describe la línea de comandos de IBM Tivoli Workload Scheduler utilizada en

plataformas distintas de z/OS, y cómo funcionan los agentes ampliados y de

red.

v IBM Tivoli Workload Scheduler: Administration and Troubleshooting, SC32-1275

Proporciona información sobre cómo administrar IBM Tivoli Workload Scheduler

en plataformas distintas de z/OS, y lo que se debe hacer si algo va mal. Incluye

ayuda para muchos mensajes generados por los componentes principales de

IBM Tivoli Workload Scheduler.

v IBM Tivoli Workload Scheduler: Agente tolerante a errores limitado para OS/400,

SC10-9992

Describe cómo instalar, configurar y utilizar agentes tolerantes a errores

limitados de IBM Tivoli Workload Scheduler en AS/400.

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

Describe cómo configurar y utilizar el módulo Plus de IBM Tivoli Workload

Scheduler.

Para ver una presentación del producto, diríjase a

http://www.ibm.com/software/tivoli/products/scheduler/.

Biblioteca de IBM IBM Tivoli Workload Scheduler for z/OS

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

Scheduler for z/OS:

v IBM Tivoli Workload Scheduler for z/OS: Getting Started, SC32-1262

Explica cómo definir los datos de la instalación para IBM Tivoli Workload

Scheduler for z/OS, y cómo crear y modificar planes.

v IBM Tivoli Workload Scheduler for z/OS: Installation Guide

Describe cómo instalar 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: Managing the Workload, SC32-1263

Explica cómo planear y planificar la carga de trabajo, y cómo controlar y

supervisar el plan actual.

v IBM Tivoli Workload Scheduler for z/OS: Quick Reference, SC32-1268

Proporciona una guía de consulta rápida y fácil para trabajar con Tivoli

Workload Scheduler for z/OS.

v IBM Tivoli Workload Scheduler for z/OS: Diagnosis Guide and Reference, SC32-1261

Proporciona información de ayuda para el diagnóstico y la corrección de

posibles problemas cuando se utilice Tivoli Workload Scheduler for z/OS.

v IBM Tivoli Workload Scheduler for z/OS: Messages and Codes, SC32-1267

Explica mensajes y códigos de Tivoli Workload Scheduler for z/OS.

v IBM Tivoli Workload Scheduler for z/OS: Programming Interfaces, SC32-1266

Proporciona información para escribir programas de aplicación para Tivoli

Workload Scheduler for z/OS.

v IBM Tivoli Workload Scheduler for z/OS: Licensed Program Specifications, GI11-4208

xiv IBM Tivoli Workload Scheduler - Guía de consulta

||||

|

|||

|

||||

||

||

|

||

||

|||

|

||

|

|

|

|

|

||

|

||

|

||

|

|

|

||

|

http://www.ibm.com/software/tivoli/products/scheduler/

Proporciona información de planificación sobre Tivoli Workload Scheduler for

z/OS.

v IBM Tivoli Workload Scheduler for z/OS: Memo for program 5697-WSZ, GI11-4209

Proporciona un resumen de cambios efectuados en el release actual del

producto.

v IBM Tivoli Workload Scheduler for z/OS: Program Directory for program 5697-WSZ,

GI11-4203

Se suministra con la cinta de instalación de Tivoli Workload Scheduler for z/OS

(programa 5697-WSZ), describe todos los materiales de instalación y brinda

instrucciones de instalación específicas para el nivel de release o número de

función del producto.

v IBM Tivoli Workload Scheduler for z/OS: Program Directory for program 5698-WSC,

GI11-4207

Se suministra con la cinta de instalación de Tivoli Workload Scheduler for z/OS

(programa 5698-WSC), describe todos los materiales de instalación y brinda

instrucciones de instalación específicas para el nivel de release o número de

función del producto.


http://www.ibm.com/software/tivoli/products/scheduler-zos/.

Biblioteca de IBM Tivoli Workload Scheduler for Applications

Las publicaciones siguientes están disponibles en la biblioteca de IBM Tivoli

Workload Scheduler for Applications:

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

Proporciona información de última hora sobre los agentes ampliados de IBM

Tivoli Workload Scheduler.

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

Describe cómo instalar, utilizar y resolver los problemas de los agentes

ampliados de IBM Tivoli Workload Scheduler.


http://www.ibm.com/software/tivoli/products/scheduler-apps/.

Biblioteca de IBM Tivoli Workload Scheduler for Virtualized Data

Centers

Las publicaciones siguientes están disponibles en la biblioteca de IBM Tivoli

Workload Scheduler for Virtualized Data Centers:

v IBM Tivoli Workload Scheduler for Virtualized Data Centers: Release Notes, SC32-1453

Proporciona información de última hora sobre IBM Tivoli Workload Scheduler

for Virtualized Data Centers.

v IBM Tivoli Workload Scheduler for Virtualized Data Centers: User’s Guide, SC32-1454

Describe cómo ampliar las posibilidades de planificación de IBM Tivoli

Workload Scheduler para optimizar la carga de trabajo y el cálculo de Grid

habilitando el control de trabajos de IBM LoadLeveler e IBM Grid Toolbox.


http://www.ibm.com/software/info/ecatalog/en_US/

products/Y614224T20392S50.html.

Publicaciones relacionadas

Los documentos siguientes también proporcionan información de utilidad:

Acerca de esta guía xv

||

|

||

||

||||

||

||||

||

|||

|

||

|

||

||

||||

|

||

|

|||

|||

http://www.ibm.com/software/tivoli/products/scheduler-zos/

http://www.ibm.com/software/tivoli/products/scheduler-apps/

http://www.ibm.com/software/info/ecatalog/en_US/products/Y614224T20392S50.html

http://www.ibm.com/software/info/ecatalog/en_US/products/Y614224T20392S50.html

v IBM Redbooks: High Availability Scenarios with IBM Tivoli Workload Scheduler and

IBM Tivoli Framework

Este manual técnico de IBM muestra cómo diseñar y crear entornos de IBM

Tivoli Workload Scheduler e IBM Tivoli Management Framework (servidor TMR,

Nodos gestionados y Puntos finales) altamente disponibles. Presenta estudios de

casos de High Availability Cluster Multiprocessing (HACMP) para AIX y

Microsoft Windows Cluster Service (MSCS).

Puede encontrar este manual técnico en el sitio Web de Redbooks, en la

dirección http://www.redbooks.ibm.com/abstracts/sg246632.html

v IBM Redbooks: Customizing IBM Tivoli Workload Scheduler for z/OS V8.2 to Improve

Performance

Este manual técnico de IBM trata las técnicas que se pueden utilizar para

mejorar el rendimiento de Tivoli Workload Scheduler for z/OS (incluida la

planificación de extremo a extremo).



v IBM Redbooks: End-to-End Scheduling with IBM Tivoli Workload Scheduler Version 8.2

Este manual técnico de IBM considera la mejor forma de proporcionar una

planificación de extremo a extremo utilizando componentes de Tivoli Workload

Scheduler Versión 8.2, tanto distribuido (conocido anteriormente como Maestro)

como de sistema principal (conocido anteriormente como OPC).



Tivoli Software Glossary incluye definiciones para muchos de los términos técnicos

relacionados con el software de Tivoli. El Tivoli Software Glossary está disponible en

el sitio Web de bibliotecas de software de Tivoli siguiente:

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

Cómo acceder a las publicaciones en línea

El CD del producto contiene las publicaciones que se encuentran en la biblioteca

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

acceder a las publicaciones mediante un explorador Web, abra el archivo

infocenter.html. Este archivo se encuentra en el directorio de publicaciones

adecuado del CD del producto.

IBM sitúa publicaciones para este y otros productos de Tivoli, a medida que están

disponibles y siempre que se actualizan, en el sitio Web del centro de información

de software de Tivoli. Acceda al centro de información de software de Tivoli yendo

primero a la biblioteca de software de Tivoli, que se encuentra en la dirección Web

siguiente:

http://www.ibm.com/software/tivoli/library/

Desplácese hacia abajo y haga clic en el vínculo Product manuals. En la ventana

Tivoli Technical Product Documents Alphabetical Listing, haga clic en el vínculo

del producto Tivoli Workload Scheduler apropiado para acceder a las bibliotecas

del producto en el centro de información de software de Tivoli. Todas las

publicaciones de la biblioteca de la suite de IBM Tivoli Workload Scheduler, de la

biblioteca distribuida y de la biblioteca de z/OS se pueden encontrar en la entrada


xvi IBM Tivoli Workload Scheduler - Guía de consulta

http://www.redbooks.ibm.com/abstracts/sg246632.html



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

http://www.ibm.com/software/tivoli/library/

Nota: Si imprime documentos PDF en papel con tamaño distinto al de carta,

establezca la opción de la ventana Archivo → Imprimir que permite que

Adobe Reader imprima páginas de tamaño carta en el papel local.

Cómo solicitar publicaciones

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

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 los Estados Unidos: 800-879-2755

v En Canadá: 800-426-4968

En otros países, en el sitio Web siguiente encontrará una lista de números de

teléfono:

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

Cómo proporcionar información de usuario sobre las

publicaciones

Si tiene comentarios o sugerencias sobre los productos y la documentación de

Tivoli, cumplimente el formulario de información del cliente en el sitio Web

siguiente:

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

Accesibilidad

Las funciones de accesibilidad son de ayuda para que los usuarios que padecen

una discapacidad física, como por ejemplo una movilidad o una visión limitadas,

puedan utilizar satisfactoriamente los productos de software. Con este producto se

pueden utilizar tecnologías de asistencia para oír y navegar por la interfaz.

También se 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 Job Scheduling Console - Guía del usuario.

Entrenamiento técnico en Tivoli

Para obtener información sobre el entrenamiento técnico en Tivoli, consulte el sitio

Web de IBM Tivoli Education siguiente:

http://www.ibm.com/software/tivoli/education

Información de soporte

Si tiene un problema con el software de IBM, deseará resolverlo con rapidez. IBM

brinda los medios siguientes para que obtenga el soporte que necesita:

v Búsqueda en bases de información: Puede realizar búsquedas en una gran

colección de problemas conocidos y correcciones, Notas técnicas y otras

informaciones.

Acerca de esta guía xvii

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

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

v Obtención de arreglos: Puede localizar los últimos arreglos que ya están

disponibles para el producto.

v Establecimiento de contacto con el Centro de soporte de software de IBM: Si

todavía no puede resolver su problema y necesita trabajar con alguien de IBM,

puede utilizar diversas maneras de ponerse en contacto con el Soporte de

software de IBM.

Para obtener más información sobre estas tres maneras de resolver problemas,

consulte el Apéndice A, “Información de soporte”, en la página 337.

Convenios utilizados en esta guía

En esta guía se utilizan varios convenios para indicar términos y acciones

especiales, rutas y comandos que dependen del sistema operativo, y gráficos de

márgenes.

Convenios de tipos de letra

Esta guía utiliza los convenios de tipo de letra siguientes:

Negrita

v Comandos en minúsculas y en una mezcla de minúsculas y mayúsculas,

que de otro modo serían difíciles de distinguir del texto circundante

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

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

elementos contenidos en cuadros de lista, listas con varias columnas,

opciones de menú, nombres de menú, tabuladores, hojas de propiedad),

etiquetas (como, por ejemplo, Sugerencia: y Consideraciones sobre el

sistema operativo:)

v Palabras clave y parámetros en el texto

Cursiva

v Palabras definidas en el texto

v Énfasis de palabras (palabras en sí)

v Términos nuevos en el texto (excepto en una lista de definición)

v Variables y valores que el usuario debe proporcionar

Monoespaciado

v Ejemplos y ejemplos de código

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

que resultan difíciles de distinguir del texto circundante

v Texto de mensajes y solicitudes dirigidos al usuario

v Texto que el usuario debe escribir

v Valores para argumentos y opciones de comandos

Variables y rutas que dependen del sistema operativo

En esta guía se utiliza el convenio de UNIX para especificar variables de entorno y

para la notación de directorios.

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

variable% para las variables de entorno, y sustituya cada barra inclinada (/) por una

barra inclinada invertida (\) en las rutas de directorios. Los nombres de las

variables de entorno no siempre son iguales en Windows y UNIX. Por ejemplo,

%TEMP% en Windows es equivalente a $tmp en UNIX.

xviii IBM Tivoli Workload Scheduler - Guía de consulta

Nota: Si está utilizando el shell bash en un sistema Windows, puede utilizar los

convenios de UNIX.

Sintaxis de los comandos

Esta guía utiliza la sintaxis siguiente siempre que describe comandos:

Tabla 1. Sintaxis de los comandos

Convenio de

sintaxis

Descripción

Corchetes ([ ]) La información encerrada entre corchetes ([ ]) es opcional. Cualquier

cosa que no esté encerrada entre corchetes se tiene que especificar.

Llaves ({ }) Las llaves ({ }) identifican un conjunto de opciones que se excluyen

mutuamente, en que se requiere una opción.

Subrayado ( _ ) Un subrayado (_) conecta varias palabras de una variable.

Barra vertical ( |

)

Las opciones que se excluyen mutuamente se separan mediante una

barra vertical ( | ). Puede entrar una de las opciones separadas por la

barra vertical, pero no puede entrar varias de ellas en un solo uso del

comando. Se puede utilizar una barra vertical para separar opciones

opcionales o requeridas.

Negrita El texto en negrita designa información literal que se debe entrar en la

línea de comandos exactamente tal como se muestra. Esto es aplicable a

los nombres de comando y a las opciones que no son variables.

Cursiva El texto en cursiva e variable y se debe sustituir por cualquier cosa a la

que represente.

Acerca de esta guía xix

xx IBM Tivoli Workload Scheduler - Guía de consulta

Capítulo 1. Arranque rápido

EL juego de productos IBM Tivoli Workload Scheduler brinda la posibilidad de

gestionar el entorno de producción y automatizar muchas actividades del

operador. IBM Tivoli Workload Scheduler prepara trabajos para su ejecución,

resuelve interdependencias e inicia cada uno de los trabajos, haciendo un

seguimiento de éstos. Puesto que los trabajos comienzan tan pronto como se

satisfacen sus dependencias, se minimiza el tiempo de desocupación y mejora

significativamente el rendimiento. Los trabajos nunca se ejecutan fuera de

secuencia y, si un trabajo falla, IBM Tivoli Workload Scheduler maneja el proceso

de recuperación con poca o ninguna intervención del operador.

El apartado “Creación de un plan” en la página 2 le ofrece una ruta paso a paso de

información básica y operaciones para implementar IBM Tivoli Workload

Scheduler en el entorno utilizando la interfaz de línea de comandos. Como

alternativa, puede utilizar Job Scheduling Console para realizar las mismas tareas.

Para obtener más información, consulte la publicación Job Scheduling Console - Guía

del usuario.

Para realizar la planificación de trabajos con IBM Tivoli Workload Scheduler

existen dos conceptos básicos:

la base de datos

Reside en el Master Domain Manager y contiene todas las definiciones

para objetos de planificación, como por ejemplo trabajos, secuencias de

trabajos, recursos y estaciones de trabajo. También contiene estadísticas de

la ejecución de trabajos y secuencias de trabajos, así como información

sobre el ID de usuario que ha creado un objeto y cuándo se ha modificado

un objeto por última vez. El programa utilizado para gestionar objetos en

la base de datos es Composer. Para obtener información adicional, consulte

el Capítulo 3, “Consulta de Composer”, en la página 35.

el plan

Contiene toda la actividad de planificación de trabajos planeada para un

periodo de un día. En IBM Tivoli Workload Scheduler, el plan se crea en el

Master Domain Manager cada 24 horas y está formado por todos los

trabajos, secuencias de trabajos y objetos de dependencia que se han

planificado para que se ejecuten ese día. Al final del día de producción, las

secuencias de trabajos que no se han completado satisfactoriamente, o que

se están ejecutando o se encuentran en espera de ejecución, se pueden

pasar al plan del día siguiente. Para obtener información adicional sobre

cómo el Master Domain Manager produce el plan, consulte el Capítulo 2,

“El ciclo de producción”, en la página 9. El programa utilizado para

interactuar con el plan durante el día de proceso actual es Conman. Para

obtener información adicional, consulte el Capítulo 5, “Consulta de

Conman”, en la página 127.

Cuando haya instalado el entorno de planificación siguiendo las instrucciones

indicadas en la publicación IBM Tivoli Workload Scheduler - Guía de planificación e

instalación, ya podrá crear un plan que se ejecute diariamente con la información

necesaria relativa al entorno. Para ver cómo hacerlo, consulte el apartado “Creación

de un plan” en la página 2.

© Copyright IBM Corp. 1999, 2004 1

|

|

|||||||||

||||||

||

|||||||||

||||||||||||||

|||||

Creación de un plan

Para crear un plan que se ejecute diariamente, lleve a cabo los pasos siguientes:

1.

Inicie una sesión con un shell en el Master Domain Manager

Inicie la sesión utilizando el ID de usuario que ha especificado

durante la instalación y, desde este shell, realice todas las operaciones

descritas en los pasos siguientes. 2.

Inicie los procesos de IBM Tivoli Workload Scheduler

Realice este paso desde la línea de comandos del usuario ejecutando

el comando Startup para iniciar el proceso de gestión de la red del

planificador. Para conocer más detalles sobre el comando Startup,

consulte el apartado “StartUp” en la página 276. 3.

Añada a la base de datos las definiciones para describir la topología del

entorno de planificación

Este paso se puede dividir del modo siguiente:

a.

Definir las estaciones de trabajo en el entorno

Una estación de trabajo suele ser una estación de trabajo

física en la que se ejecutan trabajos y secuencias de

trabajos; sin embargo, en el caso de agentes ampliados, las

estaciones de trabajo son definiciones lógicas que deben

estar en una estación de trabajo física. Defina una estación

de trabajo para cada máquina que pertenezca al entorno de

planificación, con la excepción del Master Domain

Manager, que se define automáticamente durante la

instalación de IBM Tivoli Workload Scheduler. Para

obtener información adicional, consulte el apartado

“Definiciones de estación de trabajo” en la página 37.b.

Definir dominios

Utilice este paso si desea crear un árbol jerárquico de la

ruta a través de los dominios. IBM Tivoli Workload

Scheduler avanza hacia abajo del árbol cuando distribuye

el plan al comienzo del día de producción, y hacia arriba

cuando envía al Master Domain Manager información

sobre los trabajos y secuencias de trabajos que se ejecutan

en las estaciones de trabajo de destino. Para obtener

información adicional, consulte el apartado “Definiciones

de dominio” en la página 45. 4.

Defina usuarios que tengan permitido ejecutar trabajos en estaciones de

trabajo Windows

Únicamente en las estaciones de trabajo Windows, defina cualquier

usuario que tenga permitido ejecutar trabajos utilizando IBM Tivoli

Workload Scheduler especificando nombre de usuario y contraseña.

Para obtener información adicional, consulte el apartado “Definiciones

de usuario” en la página 53. 5.

2 IBM Tivoli Workload Scheduler - Guía de consulta

||

|

|

||||

|

|||||

|

|||

|

||||||||||||

|

||||||||||

|

|||||||

|

Defina dependencias

Las dependencias son condiciones que se deben cumplir para que se

pueda iniciar un trabajo. Se pueden definir para la propia secuencia

de trabajos, para un trabajo de la secuencia de trabajos, o para ambos.

El número máximo de dependencias que se pueden establecer para un

trabajo o secuencia de trabajos es 40. Para obtener información

adicional, consulte el apartado Capítulo 4, “El lenguaje de

planificación”, en la página 89. A continuación se muestran algunas de

las dependencias que se pueden establecer:

a.

Dependencias de tiempo

Establezca una dependencia de tiempo para especificar la

hora más temprana o tardía que se puede iniciar un

trabajo o una secuencia de trabajos, o la hora en que debe

haber finalizado un trabajo o una secuencia de trabajos.

También puede identificar los días en que no se debe

ejecutar la secuencia de trabajos. Para conocer más detalles,

consulte el apartado “Palabras clave” en la página 90.b.

Dependencias de archivo abierto

Utilice dependencias de archivo abierto para especificar

archivos que deben estar disponibles para que se pueda

iniciar un trabajo o una secuencia de trabajos. Para conocer

más detalles, consulte el apartado “opens” en la página

119.c.

Dependencias de seguimiento

Establezca una dependencia de seguimiento para definir

los otros trabajos y secuencias de trabajos que deben

completarse satisfactoriamente antes de un trabajo o

secuencia de trabajos. Para conocer más detalles, consulte

el apartado “follows” en la página 104.d.

Recursos

Utilice recursos para especificar objetos físicos o lógicos

que pertenezcan a una estación de trabajo y que sean

necesarios para ejecutar un trabajo en esa estación de

trabajo. Puesto que se comprueba la disponibilidad de los

recursos antes de ejecutar trabajos en una estación de

trabajo específica, los recursos se pueden utilizar como

dependencias para hacer que la gestión de trabajos y

secuencias de trabajos sea más flexible. Por ejemplo, puede

definir un recurso llamado TAPES, con un valor de 2,

identificando las dos unidades de cintas del sistema y, a

continuación, definir dos trabajos que necesiten que ambas

unidades de cintas estén disponibles como dependencia.

Los trabajos con esta dependencia no pueden ejecutarse

simultáneamente porque cada vez que se ejecuta un

trabajo el recurso TAPES está en uso. Para obtener


de recursos” en la página 61.e.

Capítulo 1. Arranque rápido 3

|||||||||

|

||||||||

|

||||||

|

||||||

|

||||||||||||||||||

|

Solicitudes

Utilice una solicitud cuando desee asociar un nombre

exclusivo a un mensaje textual que solicite una respuesta

del operador. Las solicitudes se utilizan como

dependencias para impedir que los trabajos comiencen

hasta que se reciba una respuesta afirmativa. Para obtener


de solicitudes” en la página 59.f.

Límite Establezca Límite para establecer el número máximo de

trabajos que se pueden ejecutar simultáneamente en una

secuencia de trabajos. Para obtener información adicional,

consulte el apartado “limit” en la página 114.g.

Prioridad

Utilice esta dependencia para establecer la prioridad de un

trabajo o de una secuencia de trabajos. Para obtener

información adicional, consulte el apartado “priority” en la

página 121. 6.

Defina trabajos

Un trabajo es una unidad de trabajo que se ejecuta en estaciones de

trabajo, como por ejemplo un archivo ejecutable, un programa o un

comando planificados e iniciados por IBM Tivoli Workload Scheduler

formando parte del proceso de una secuencia de trabajos.

Normalmente, incluye todos los programas, vínculos, archivos e

instrucciones necesarios para el sistema operativo. No incluye fechas y

horas planificadas en que se debe efectuar la ejecución, puesto que

éstas se definen como argumentos de la definición de las secuencias

de trabajos. Para obtener información adicional, consulte el apartado

“Definiciones de trabajo” en la página 47. 7.

Defina secuencias de trabajos

Una secuencia de trabajos es una secuencia ordenada de trabajos

que se deben ejecutar respetando las dependencias establecidas. Los

trabajos se pueden agrupar en una secuencia de trabajos porque todos

ellos se ejecutarán el mismo día, porque comparten una función

común o porque comparten dependencias comunes. Para obtener

información adicional, consulte el Capítulo 4, “El lenguaje de

planificación”, en la página 89. 8.

Defina calendarios

Un calendario define si se tiene que ejecutar una secuencia de

trabajos y cuándo se debe hacer. Utilice esta opción para incluir o

excluir días en un ciclo de ejecución diaria. Una definición de

calendario se puede asignar a una o más secuencias de trabajos. Para

obtener información adicional, consulte el apartado “Definiciones de

calendario” en la página 56. 9.


||||||||

|

|||||

|

|||||

|

|||||||||||

|

||||||||

|

|||||||

|

Defina parámetros que representen variables dentro de trabajos o

secuencias de trabajos

Una definición de parámetro es la correlación entre un nombre y un

valor, siendo éste el valor de una variable utilizada en un trabajo o en

una secuencia de trabajos para un argumento específico. Los nombres

de parámetro se sustituyen por los valores correspondientes, dentro de

las definiciones de trabajos o secuencias de trabajos, al final de un día

de proceso, cuando se crea el plan de producción para el siguiente día

de proceso. Para obtener información adicional, consulte el apartado

“Definiciones de parámetros” en la página 57.10.

Automatice la generación del plan al final del día de producción actual

Añada la secuencia de trabajos final a la base de datos para realizar

los procesos previo y posterior a la producción, a fin de asegurarse

una automatización completa de la generación del plan al final de

cada día de producción actual. Para obtener información adicional,

consulte el apartado “Automatización del ciclo de producción” en la

página 15.11.

Genere el plan

Ejecute el comando Jnextday para generar el plan. Este comando inicia

el proceso de la información de planificación guardad en la base de

datos y crea el plan para el siguiente día de producción. Si ha

automatizado la generación del plan tal como se describe en el paso

10, sólo tendrá que ejecutar el comando Jnextday la primera vez.

Este plan se guarda en un archivo denominado Symphony, que se

distribuye desde el Master Domain Manager a los dominios hijo a la

hora de inicio del día (de forma predeterminada, a las 6:00 AM). Una

vez que haya comenzado el nuevo día de producción, cualquier

modificación que realice en los objetos guardados en la base de datos

no tendrá ningún efecto sobre el proceso del día de producción actual,

a excepción de los trabajos y secuencias de trabajos o archivos

sometidos utilizando conman sbj o conman sbs. Para obtener

información adicional, consulte el Capítulo 2, “El ciclo de producción”,

en la página 9.

Cuando termine este proceso paso a paso, el entorno de planificación estará

activado y en funcionamiento, y se estará efectuando un proceso por lotes de una

secuencia ordenada de trabajos y secuencias de trabajos con los recursos definidos

en un conjunto de estaciones de trabajo. De forma predeterminada, la primera vez

que ejecuta el comando Jnextday, el número de trabajos que se pueden ejecutar

simultáneamente en una estación de trabajo es de cero, por lo que deberá

asegurarse de incrementar este valor cambiando cpu limit de forma que permita

la ejecución de trabajos en esa estación de trabajos; para conocer más detalles,

consulte el apartado “limit cpu” en la página 173. Este proceso por lotes se

resuelve en un ciclo de 24 horas y el Master Domain Manager lo vuelve a generar

al final de cada día de producción.

Gestión de trabajos y secuencias de trabajos

Si ahora desea modificar algo durante el día, mientras ya se está procesando el

plan del día de producción, utilice el programa conman. Puede definir o modificar

un trabajo y añadirlo al plan utilizando el comando conman sbj únicamente si el

trabajo se va a ejecutar en una estación de trabajo que ya ha recibido el plan. Para


||||||||||

|

|||||||

|

||||||

||||||||||

|||||||||||

||

||||

conocer más detalles sobre el programa conman, consulte el Capítulo 5, “Consulta

de Conman”, en la página 127. Las acciones que puede realizar utilizando el

comando conman son las siguientes:

Añadir o suprimir dependencias

Utilice este comando para añadir o suprimir dependencias en una

secuencia de trabajos o en un trabajo de una secuencia de trabajos. Para

obtener información adicional sobre cómo añadir dependencias, consulte el

apartado “Proceso de comandos de Conman” en la página 148, y para

obtener información adicional sobre cómo suprimir dependencias, consulte

el apartado “deldep job” en la página 163.

Cambiar límites

Realice esta operación para cambiar el límite del número de trabajos que se

pueden ejecutar simultáneamente en una estación de trabajos, o el límite

de trabajos para una secuencia de trabajos. Para conocer más detalles,

consulte el apartado “limit cpu” en la página 173.

Cambiar la prioridad

Utilice esta opción para alterar la prioridad de un trabajo o una secuencia

de trabajos. Para conocer más detalles, consulte el apartado “altpri” en la

página 154.

Cambiar la delimitación de trabajos

La delimitación es un valor que se pueden establecer en las estaciones de

trabajo. Establezca la delimitación de trabajos en una estación de trabajo

para impedir que en la misma se ejecuten trabajos cuya prioridad sea

menor o igual al valor establecido como delimitación. Para conocer más

detalles, consulte el apartado “fence” en la página 169.

Liberar un trabajo o una secuencia de trabajos

Realice esta operación para liberar dependencias específicas o todas las

dependencias de un trabajo o una secuencia de trabajos. Para obtener

información adicional sobre cómo hacerlo, consulte el apartado “release

job” en la página 181.

Cancelar un trabajo o una secuencia de trabajos

Realice esta operación si desea cancelar un trabajo o una secuencia de

trabajos, ya sea inmediatamente o después de que se resuelvan sus

dependencias. Para obtener información adicional sobre cómo hacerlo,

consulte el apartado “cancel job” en la página 155.

Detener la ejecución de un trabajo o volver a ejecutar un trabajo

Realice esta operación si desea detener la ejecución de un trabajo

ejecutando el comando kill. Para obtener más información, consulte el

apartado “kill” en la página 172. Utilice rerun job para volver a ejecutar el

trabajo. Para obtener información, consulte el apartado “rerun” en la

página 186.

Nota: Cuando se vuelve a ejecutar un trabajo, se coloca en la misma

secuencia de trabajos que el trabajo original y hereda las

dependencias del trabajo original.

Vincular o desvincular estaciones de trabajo en el entorno de planificación

Realice esta operación para conectar o desconectar una estación de trabajo

de la red de planificación. Puesto que IBM Tivoli Workload Scheduler

utiliza un tecnología de guardar y reenviar para mantener la coherencia y

la tolerancia a errores en la red, cuando se desvincula una estación de

trabajo todos los mensajes se guardan en el archivo de mensajes y luego se

envían, todos a la vez, tan pronto como se restablece el vínculo. Este


|||

|||||||

|||||

||||

||||||

|||||

|||||

||||||

|||

|||||||

comando no afecta a ningún otro proceso que se esté ejecutando en el

sistema. Para obtener información adicional sobre la vinculación de

estaciones de trabajo, consulte el apartado “link” en la página 175, y sobre

la desvinculación de estaciones de trabajo, consulte el apartado “unlink” en

la página 233.

Detener, iniciar o concluir los procesos de IBM Tivoli Workload Scheduler

Realice esta operación para actuar sobre procesos de producción, por

ejemplo los procesos de IBM Tivoli Workload Scheduler, a excepción del

proceso de gestión de la red. La operación de conclusión detiene todos los

procesos de IBM Tivoli Workload Scheduler, incluyendo el proceso de

gestión de la red. Para obtener información adicional, consulte los

apartados “stop” en la página 219, “start” en la página 216 y “shutdown”

en la página 215.

Someter un comando

Realice esta operación para someter un comando en una estación de

trabajo como trabajo del planificador. Si no se especifica en las opciones de

sometimiento, el nombre de trabajo predeterminado es una serie que

empieza por el nombre del comando, y la secuencia de trabajos

predeterminada es JOBS. Los eventos que informan del resultado de la

ejecución se registran en la base de datos. Para obtener información

adicional, consulte el apartado “submit docommand” en la página 222.

Someter un trabajo

Realice esta operación para someter un comando para ejecutar un trabajo,

definido en la base de datos dentro de una secuencia de trabajos, durante

el día de producción actual en una estación de trabajo que haya recibido el

plan. Si no se especifica en las opciones de sometimiento, la secuencia de

trabajos predeterminada es JOBS. Este comando sólo se puede ejecutar en

el Master Domain Manager. Los eventos que informan del resultado de la

ejecución se registran en la base de datos. Para obtener información

adicional, consulte el apartado “submit job” en la página 226.

Someter una secuencia de trabajos

Realice esta operación para someter un comando para ejecutar una

secuencia de trabajos, definida en la base de datos, durante el día de

producción actual en una estación de trabajo que haya recibido el plan.

Este comando sólo se puede ejecutar en el Master Domain Manager. Los

eventos que informan del resultado de la ejecución se registran en la base

de datos. Para obtener información adicional, consulte el apartado “submit

sched” en la página 228.

Someter un archivo

Realice esta acción si desea someter un archivo script como trabajo, dentro

de una secuencia de trabajos, durante el día de producción actual en una

estación de trabajo que haya recibido el plan. Si no se especifica en las

opciones de sometimiento, el nombre de trabajo predeterminado es el

nombre del archivo y la secuencia de trabajos predeterminada es JOBS. Los

eventos que informan del resultado de la ejecución se registran en la base

de datos. Para obtener información adicional, consulte el apartado “submit

file” en la página 224.


|||||

||||||||

||||||||

|||||||||

||||||||

|||||||||

Capítulo 2. El ciclo de producción

El plan de IBM Tivoli Workload Scheduler es la lista de tareas pendientes que

indica a IBM Tivoli Workload Scheduler los trabajos que se tienen que ejecutar y

las dependencias que se deben satisfacer antes de que se inicie cada trabajo. El

plan abarca 24 horas. Al período comprendido por el plan se le denomina día de

producción. El plan empieza a la hora definida por la opción global start, que está

establecida, de forma predeterminada, en las 6:00 a.m.

Se crea un nuevo plan cuando comienza el día de producción y se sitúa en un

archivo de control de la producción denominado Symphony. Una vez que se ha

creado el plan, se envía una copia de este archivo a todas las estaciones de trabajo

subordinadas. Los gestores de dominio subordinados distribuyen su copia a todos

los FTA de su dominio y a todos los gestores de dominio que son subordinados

suyos, y así sucesivamente en sentido descendente. Esto permite que los agentes

tolerantes a errores de la red continúen el proceso aunque se desactive la conexión

de la red con su gestor de dominio.

En cada FTA de destino, los procesos de IBM Tivoli Workload Scheduler acceden a

la copia del archivo Symphony, leen las instrucciones sobre el trabajo que se tiene

que ejecutar y realizan llamadas al sistema operativo para iniciar los trabajos

necesarios. El sistema operativo ejecuta el trabajo e informa a IBM Tivoli Workload

Scheduler sobre si el trabajo ha finalizado satisfactoriamente o no. Esta información

se entra en el archivo Symphony para indicar el estado del trabajo. De este modo,

el archivo Symphony se actualiza continuamente con el estado de los trabajos: el

trabajo que se debe hacer, el trabajo en proceso y el trabajo que se ha completado.

Si el FTA no es de estado completo, sólo supervisa los aspectos concernientes a su

propio proceso de trabajos. Si es de estado completo, supervisa también lo que

sucede en su dominio y los dominios hijos de éste.

Cada FTA recibe el mismo archivo Symphony y cada FTA actualiza las partes del

archivo Symphony con las que está relacionado, mientras que el gestor de dominio

maestro (y la copia de seguridad del mismo) contiene una copia del archivo

Symphony que refleja todas estas actualizaciones.

Para pasar a un nuevo día, se realiza una configuración previa a la producción

para el día que comienza, y se realiza una información y un registro posterior a la

producción para el día que acaba de terminar. En este capítulo se describen los

procedimientos y los comandos utilizados para llevar a cabo estas tareas.

Interfaces y procesos principales del producto

En este apartado se describen las interfaces y los procesos principales utilizados

por IBM Tivoli Workload Scheduler.

Interfaces de usuario

Se proporciona una combinación de programas de interfaz gráfica y de línea de

comandos para ejecutar IBM Tivoli Workload Scheduler. La interfaz de línea de

comandos (CLI) está disponible para determinadas funciones avanzadas que no

están disponibles en la interfaz gráfica de usuario (Job Scheduling Console). Las

interfaces de usuario son:


||||||

|||||||||||

||||

|

||

|

|||||

Composer

Programa de línea de comandos utilizado para definir objetos de

planificación y componer planificaciones.

Conman

Programa de línea de comandos utilizado para supervisar y controlar el

entorno de producción de IBM Tivoli Workload Scheduler.

Job Scheduling Console

Interfaz gráfica de usuario utilizada para crear, modificar y suprimir

objetos en el plan y en la base de datos del producto.

Comandos previos y posteriores a la producción

Los comandos siguientes se utilizan para configurar el día de proceso de IBM

Tivoli Workload Scheduler. Para automatizar el proceso, normalmente se sitúan los

comandos en una planificación que se ejecuta al comienzo de cada día.

schedulr

Este comando selecciona planificaciones para su ejecución.

compiler

Este comando compila el archivo de control de la producción.

stageman

Este comando traspasa al día siguiente las planificaciones no completadas e

instala el archivo de control de la producción.

logman

Este comando registra estadísticas sobre los trabajos.

Comandos de seguridad

Los comandos siguientes se utilizan para definir y mantener privilegios de usuario.

dumpsec

Este comando crea una copia editable del archivo de seguridad del

producto.

makesec

Este comando compila e instala el archivo de seguridad del producto.

Procesos de producción

Los procesos de producción de IBM Tivoli Workload Scheduler son los siguientes:

Netman

Proceso que recibe peticiones de servicio e invoca los programas

apropiados.

Mailman

Proceso que dirige mensajes a estaciones de trabajo locales o remotas.

Batchman

Proceso que comunica directamente con el plan y lo actualiza.

Jobman (en Windows y UNIX), Jobmon (en Windows), joblnch.exe (en

Windows)

Procesos que controlan la ejecución real de los trabajos. Son responsables

de iniciar trabajos, y hacer un seguimiento de los mismos, utilizando los

scripts jobmanrc y .jobmanrc. Para obtener información sobre estos scripts,

consulte el apartado “Inicio de trabajos” en la página 18.


|||

|||

|||

|

|||

||

||

|||

||

|

|

|||

||

|

|

|||

||

||

||||||

Writer Proceso, generado por Netman, que establece el vínculo entre estaciones de

trabajo en la red de IBM Tivoli Workload Scheduler.

El árbol de procesos en las plataformas UNIX

La Figura 1 muestra el árbol de procesos de IBM Tivoli Workload Scheduler en las

plataformas UNIX:

Capítulo 2. El ciclo de producción 11

|||

|

|||

Figura 1. Árbol de procesos en UNIX


|

|||||

El árbol de procesos en las plataformas Windows

La Figura 2 muestra el árbol de procesos de IBM Tivoli Workload Scheduler en las

plataformas Windows:


|

|||

Figura 2. Árbol de procesos en Windows


|

||||

Automatización del ciclo de producción

El proceso previo y posterior a la producción se puede automatizar totalmente

agregando la secuencia de trabajos final suministrada con el producto, o una

equivalente suministrada por el usuario, a la base de datos. Existe una copia de la

secuencia de trabajo suministrada en el archivo Sfinal del directorio

TWShome/Sfinal. Encontrará una copia del script de trabajos en el directorio

TWShome/Jnextday. Puede resultar conveniente imprimir copias que le ayudarán a

conocer el proceso de producción.

La secuencia de trabajos final se coloca en la producción todos los días y da como

resultado la ejecución de un trabajo llamado Jnextday antes de que comience el

nuevo día. El trabajo realiza las tareas siguientes:

1. Ejecuta el comando schedulr para seleccionar secuencias de trabajos para el

plan de producción del nuevo día. Para obtener más información, consulte el

apartado “El comando schedulr” en la página 23.

2. Ejecuta el comando compiler para compilar el plan de producción. Para obtener

más información, consulte el apartado “El comando compiler” en la página 25.

3. Ejecuta el comando reptr para imprimir informes previos a la producción. Para

obtener más información, consulte el apartado “Comando reptr” en la página

293.

4. Detiene el planificador.

5. Ejecuta el comando stageman para traspasar al día siguiente las secuencias de

trabajos no completadas, registrar el plan de producción antiguo e instalar el

plan nuevo. Para obtener más información, consulte el apartado “El comando

stageman” en la página 27.

6. Ejecuta el comando wmaeutil para detener todas las instancias de conector y, a

continuación, las reinicia para renovar el archivo Symphony. Para obtener más

información, consulte el apartado “El comando wmaeutil” en la página 32.

7. Inicia el planificador para el nuevo día.

8. Ejecuta el comando reptr para imprimir informes posteriores a la producción

del día anterior. Para obtener más información, consulte el apartado “Comando

reptr” en la página 293.

9. Ejecuta el comando logman para registrar estadísticas de trabajos para el día

anterior. Para obtener más información, consulte el apartado “El comando

logman” en la página 30.

Cómo personalizar la secuencia de trabajos final

Antes de utilizar la secuencia de trabajos final, la puede modificar para que se

adapte a sus necesidades o puede crear una distinta y utilizarla en su lugar.

Cuando cree su propia secuencia de trabajos, siga el modelo de la suministrada

con el producto. Si elige crear su propia secuencia de trabajos, tenga en cuenta lo

siguiente:

v Si decide cambiar el modo en que stageman genera los nombres de archivos de

registro, recuerde que reptr y logman deben utilizar los mismos nombres.

v Si desea imprimir los informes previos a la producción antes de un nuevo día,

puede dividir el trabajo Jnextday en dos trabajos. El primer trabajo ejecutará

schedulr, compiler y reptr. El segundo trabajo detendrá el planificador, ejecutará

stageman, iniciará el planificador y ejecutará reptr y logman. De este modo, el

primer trabajo puede planificarse para que se ejecute en cualquier momento

antes del final del día, mientras que el segundo trabajo se planifica para que se

ejecute justo antes del final del día.


|||||||

Cómo personalizar la secuencia de trabajos final

Una vez que haya instalado un gestor de dominio maestro, independientemente

del método de instalación que haya utilizado, debe agregar la secuencia de trabajos

final a la base de datos y ejecutar Jnextday. Esta secuencia de trabajos se coloca en

la producción todos los días, y tiene como consecuencia la ejecución de un trabajo

denominado Jnextday antes de que comience un nuevo día. La instalación crea en

la estación de trabajo un archivo Sfinal que contiene la definición de la secuencia

de trabajos final. Puede utilizar este archivo Sfinal o crear y personalizar uno

nuevo. Para conocer detalles sobre la personalización de la secuencia de trabajos

final, consulte la publicación IBM Tivoli Workload Scheduler - Guía de planificación e

instalación, versión 8.2.

A continuación se muestra un ejemplo de configuración de un gestor de dominio

maestro después de la instalación:

1. Inicie una sesión como usuario de TWS.

2. Ejecute el script tws_env para establecer el entorno de IBM Tivoli Workload

Scheduler del modo siguiente:

v UNIX: en los shells C, inicie source/inicio_tws/tws_env.sh

v UNIX: en los shells Korn, inicie ./inicio_tws/tws_env.sh

v Desde una línea de comandos de Windows: inicie \inicio_tws\tws_env.cmd

Donde inicio_tws representa el directorio de instalación del producto.

3. Ejecute el comando composer.

4. Agregue la definición de la secuencia de trabajos final a la base de datos

ejecutando el comando siguiente:

composer add Sfinal

Si no ha utilizado el archivo Sfinal proporcionado con el producto, sino que ha

creado uno nuevo, utilice el nombre de éste último en lugar de Sfinal.

Cómo iniciar un ciclo de producción

Para iniciar un ciclo de producción, lleve a cabo los pasos siguientes:

1. Inicie una sesión como usuario de TWS en el gestor de dominio maestro.

2. En un indicador de comandos, ejecute el trabajo Jnextday entrando el comando

siguiente:

Jnextday

Esto llevará a cabo el proceso previo a la producción e iniciará los procesos de

producción del planificador.

Nota: No actualice ni cree la base de datos de Tivoli Workload Scheduler

mientras se esté ejecutando Jnextday, puesto que podría dañar la base de

datos.

3. Cuando finalice el trabajo Jnextday, compruebe el estado de IBM Tivoli

Workload Scheduler:

conman status

Si IBM Tivoli Workload Scheduler se ha iniciado correctamente, el estado será

Batchman=LIVES.

4. Aumente el límite para permitir que se ejecuten trabajos. El límite de trabajos

predeterminado después de la instalación es de cero. Esto significa que no se

ejecutará ningún trabajo, por lo que es posible que desee aumentar ahora dicho

límite:


||

|

|

|

|

|

||

|

||

|||

||

|

||

||||

conman "limit;10"

Gestión del entorno de producción

En este apartado se proporciona información acerca de cómo cambiar el inicio del

día para IBM Tivoli Workload Scheduler y cómo crear un plan para ejecutar

procesos de días pasados o futuros.

Cómo elegir el inicio del día de IBM Tivoli Workload Scheduler

Para comenzar el día de producción puede elegir entre tres opciones comunes:

v A primera hora de la mañana

v A última hora de la tarde

v A medianoche

A continuación se explican brevemente algunas consecuencias de la planificación:

Hora de inicio y Última hora de inicio

Las horas de inicio (palabra clave at) siempre se especifican en relación

con la hora de inicio del día de producción del planificador. Es posible que

tenga que añadir “+ 1 day” a las secuencias de trabajos cuyos trabajos se

procesen en varios días de producción. Asimismo, asegúrese de que la

última hora de inicio (palabra clave until) corresponda a una hora

posterior a la hora de inicio.

Palabra clave on

Los días de producción y los días de calendario pueden no coincidir. Si su

día de producción empieza a las 06:00 a.m. (el valor predeterminado), las

05:59 a.m. será el último minuto del día de producción. Una secuencia de

trabajos cuya ejecución se defina para EL LUNES a las 05:30 se seleccionará

el lunes y se ejecutará el día de calendario martes a las 5:30 a.m.

Palabra clave carryforward

Establecer el inicio del día cerca de la medianoche para que se corresponda

con el día de calendario tenderá a producir un gran número de secuencias

de trabajos traspasadas al día siguiente. Esto puede aumentar la

complejidad de la gestión del centro de datos.

Plazo límite

Se envían notificaciones cuando los trabajos y las secuencias de trabajos

han alcanzado su plazo límite pero todavía no se han iniciado, o bien si no

ha finalizado su ejecución. Un plazo límite especifica la hora en que un

trabajo o una secuencia de trabajos tiene que haber finalizado.

Cómo cambiar el inicio del día

El inicio del día para IBM Tivoli Workload Scheduler es el momento en que se

ejecuta la secuencia de trabajos final y se detienen y reinician los procesos del

planificador. Para especificar el inicio del día para el planificador:

1. Modifique la opción start en el archivo globalopts. Esta opción representa la

hora de inicio del día del proceso en formato de 24 horas: hhmm (0000-2359). La

hora de inicio predeterminada es las 6:00 a.m.

2. Modifique la hora de inicio (palabra clave at) de la secuencia de trabajos final

para que se ejecute un minuto antes del final del día.


|

Creación de un plan para fechas futuras o pasadas

Puede crear un plan que ejecute los procesos normalmente planificados para un

día de proceso futuro o pasado. Este procedimiento recrea de forma eficaz

cualquier día de proceso especificado. Es posible que necesite utilizar este

procedimiento si ha perdido un día de proceso debido a una emergencia.

1. Desvincule y detenga todas las estaciones de trabajo de la red del planificador.

De este modo, se detienen todos los procesos de la red.

2. Ejecute el comando schedulr con la opción date para crear un archivo

prodsked:

schedulr -date ddmmaaaa

Con la opción date puede especificar que se cree un plan basado en un día de

proceso pasado o futuro.

3. Ejecute el comando compiler para crear un archivo Symnew:

compiler (-date ddmmaaaa)

Puede utilizar la opción date con el comando compiler para especificar la fecha

de hoy o la fecha del día que está intentando recrear. Esta opción puede ser

necesaria si tiene secuencias de trabajos que contienen parámetros de entrada

sensibles a la fecha. El parámetro scheddate viene determinado por la fecha

especificada con el comando compiler.

4. Ejecute el gestor de consola para detener los procesos del planificador:

conman stop @!@;wait

Si ha definido por lo menos una estación de trabajo como Behindfirewall en

una red de IBM Tivoli Workload Scheduler Versión 8.2, debe entrar el comando

siguiente:

conman stop ;progressive

5. Ejecute stageman para crear el archivo Symphony nuevo:

stageman

6. Ejecute el gestor de consola para iniciar los procesos del planificador:

conman start

Cómo utilizar informes

La utilización de informes le ayudará a gestionar el ciclo de producción. Para

obtener más información, elCapítulo 7, “Los comandos de informe”, en la página

287 y el apartado “Comando reptr” en la página 293.

Inicio de trabajos

Los trabajos se inician bajo la dirección del proceso de control de la producción

Batchman. Batchman resuelve todas las dependencias de los trabajos para asegurar

un orden correcto en la ejecución y, a continuación, emite un mensaje de inicio de

trabajo para el proceso Jobman.

Jobman produce un proceso supervisor de trabajos que empieza estableciendo un

grupo de variables de entorno y, luego, ejecuta el script de configuración estándar

(inicio_tws/jobmanrc). Si el usuario tiene permitido utilizar un script de

configuración local, y si el script $HOME/.jobmanrc existe, también se ejecuta el

script de configuración local. Luego, bien el script de configuración estándar o bien

el local ejecutan el trabajo.


Cada uno de los procesos iniciados por Jobman, incluidos los scripts de

configuración y los trabajos, conserve el nombre de usuario registrado con el inicio

de sesión de secuencia del trabajo. En el caso de trabajos sometidos, conservan el

nombre del usuario que los ha sometido. Para hacer que los trabajos se ejecuten

con el entorno del usuario, asegúrese de añadir el entorno .profile del usuario al

script de configuración local.

Variables de entorno de trabajo

Jobman establece y exporta las variables que se relacionan en la tabla siguiente.

Tabla 2. Variables de entorno de trabajo

Nombre de variable Valor

HOME Directorio del nombre del usuario de inicio

de sesión

LOGNAME Nombre del usuario de inicio de sesión

PATH Para Windows:

%SYSTEMROOT\SYSTEM32. Para UNIX:

/bin:/usr/bin

TZ Huso horario

UNISON_SHELL Shell de inicio de sesión del usuario

UNISON_CPU Nombre de esta CPU

UNISON_HOST Nombre de la CPU del maestro/host

UNISON_JOB Nombre de trabajo completamente

calificado: cpu#sched.job

UNISON_JOBNUM Número de trabajo (ppid)

UNISON_MASTER Nombre de la CPU del maestro

UNISON_RUN Número de ejecución actual de Tivoli

Workload Scheduler

UNISON_SCHED Nombre de planificación

UNISON_SCHED_DATE Fecha de producción de Tivoli Workload

Scheduler (aammdd)

UNISON_SCHED_EPOCH Fecha de producción de Tivoli Workload

Scheduler, expresada en formato de época

UNISON_SYM Número de registro de Symphony

UNISON_EXEC_PATH Ruta completamente calificada de jobmanrc

TIVOLI_JOB_DATE Fecha planificada para un trabajo

Script de configuración estándar - jobmanrc

Con IBM Tivoli Workload Scheduler se proporciona una plantilla de script de

configuración estándar denominada inicio_tws/config/jobmanrc. Esta plantilla se

instala automáticamente como inicio_tws/jobmanrc. El administrador del sistema

puede utilizar este script para establecer el entorno deseado antes de que se ejecute

cada uno de los trabajos. Si desea modificar el script, realice las modificaciones en

la copia de trabajo (inicio_tws/jobmanrc), dejando el archivo de plantilla intacto. El

archivo contiene variables que se pueden configurar, así como comentarios que

ayudan a comprender la metodología. La Tabla 3 describe las variables de

jobmanrc.


|

|

||

||

|||

||

||||

||

||

||

||

|||

||

||

|||

||

|||

|||

||

||

|||

|

Tabla 3. Variables de jobmanrc


UNISON_JCL Nombre de ruta del archivo script del

trabajo.

UNISON_STDLIST Nombre de ruta del archivo de lista estándar

del trabajo.

UNISON_EXIT (Configurable) Si se establece en yes, el

trabajo termina inmediatamente en caso de

que cualquier comando devuelva un código

de salida distinto de cero. Si se establece en

no, el trabajo se sigue ejecutando aunque un

comando devuelva un código de salida

distinto de cero. Cualquier otro valor se

interpreta como no.

LOCAL_RC_OK (Configurable) Si se establece en yes, se

ejecuta el script de configuración local del

usuario, pasando $UNISON_JCL como

primer argumento. Al usuario se le puede

permitir o denegar esta opción. Para obtener

más información, consulte el apartado

“Script de configuración local -

$HOME/.jobmanrc” en la página 21. Si se

establece en no, se ignora la presencia de un

script de configuración local y se ejecuta

$UNISON_JCL. Cualquier otro valor se

interpreta como no.

MAIL_ON_ABEND (Configurable) Si se establece en yes, se

envía un mensaje al buzón del usuario de

inicio de sesión en caso de que el trabajo

termine con un código de salida distinto de

cero. También se puede establecer con uno o

más nombres de usuario, separados por

espacios, y se envía un mensaje a cada

usuario. Por ejemplo, ″root mis sam mary″.

Si se establece en no, no se envía ningún

mensaje en caso de que el trabajo termine de

forma anómala. Los mensajes de terminación

anómala tienen el formato siguiente:

cpu#sched.job

archivo-jcl failed with

código-salida

Please review

nombarchivo-lista-estándar


Tabla 3. Variables de jobmanrc (continuación)


SHELL_TYPE (Configurable) Si se establece en standard,

se lee el primer trabajo del archivo jcl para

determinar qué shell se debe utilizar para

ejecutar el trabajo. Si la primera línea no

empieza por #!, se utiliza /bin/sh para

ejecutar el script de configuración local o

$UNISON_JCL. Los comandos se repiten en

el archivo de lista estándar del trabajo. Si se

establece con el usuario, el shell de inicio de

sesión del usuario ($UNISON_SHELL)

ejecuta el script de configuración local o

$UNISON_JCL. Los comandos se repiten en

el archivo de lista estándar del trabajo. Si se

establece en script, el script de configuración

local o $UNISON_JCL se ejecutan

directamente y los comandos no se repiten a

menos que el script de configuración local o

$UNISON_JCL contengan un comando set

-x. Cualquier otro valor se interpreta como

standard.

USE_EXEC (Configurable) Si se establece en yes, se

ejecuta el trabajo o el script de configuración

local del usuario utilizando el comando

exec, y eliminando así un proceso adicional.

Si MAIL_ON_ABEND también se establece

en yes, se altera temporalmente esta opción.

Cualquier otro valor se interpreta como no,

en cuyo caso otro proceso de shell ejecuta el

trabajo o el script de configuración local.

Script de configuración local - $HOME/.jobmanrc

Utilizando el script de configuración local, puede establecer el entorno deseado

para la ejecución de sus propios trabajos. El script sólo se ejecuta bajo las

condiciones siguientes:

1. El script de configuración estándar, jobmanrc, debe estar instalado y la variable

de entorno LOCAL_RC_OK debe estar establecida en yes (vea la Tabla 3).

2. Si existe el archivo inicio_tws/localrc.allow, el nombre del usuario debe aparecer

en el archivo. Si no existe el archivo allow, el nombre del usuario no debe

aparecer en el archivo, inicio_tws/localrc.deny. Si no existe ninguno de estos

archivos, se permite al usuario que utilice un script de configuración local.

3. El script de configuración local debe estar instalado en el directorio inicial del

usuario ($HOME/.jobmanrc) y debe tener permiso de ejecución (execute).

Si piensa utilizar un archivo de configuración local, éste debe, por lo menos,

ejecutar el archivo script del trabajo ($UNISON_JCL). El script de configuración

estándar suministrado por Tivoli, jobmanrc, ejecuta el script de configuración local

del usuario del modo siguiente:

$EXECIT $USE_SHELL $HOME/.jobmanrc "$UNISON_JCL" $IS_COMMAND

El valor de USE_SHELL se establece con el valor de la variable SHELL_TYPE de

jobmanrc (vea la Tabla 3 en la página 20). IS_COMMAND se establece en yes si el

trabajo se ha planificado o sometido utilizando la construcción docommand.


EXECIT se establece en exec si la variable USE_EXEC se establece en yes (vea la

Tabla 3 en la página 20), de lo contrario es nulo.

El ejemplo siguiente muestra cómo ejecutar el archivo script de un trabajo, o

comando, en el script de configuración local:

#!/bin/ksh

PATH=inicio_tws:inicio_tws/bin:$PATH

export PATH

/bin/sh -c "$UNISON_JCL"

El ejemplo siguiente muestra un .jobmanrc que realiza el proceso en base al código

de salida del trabajo del usuario:

#!/bin/sh

#

PATH= inicio_tws:inicio_tws/bin:$PATH

export PATH

/bin/sh -c "$UNISON_JCL"

#o use eval "$UNISON_JCL" y las comillas son necesarias

RETVAL=$?

if [ $RETVAL -eq 1 ]

then

echo "Exit code 1 - Non Fatal Error"

exit 0

elif [ $RETVAL -gt 1 -a $RETVAL -lt 100 ]

then

conman "tellop This is a database error - page the dba"

elif [ $RETVAL -ge 100 ]

then

conman "tellop Job aborted. Please page the admin"

fi

Comandos del proceso de producción

En los apartados siguientes se describen los comandos del proceso previo y

posterior a la producción que ejecuta el trabajo Jnextday.


El comando schedulr

El comando schedulr selecciona secuencias de trabajos para una fecha específica

del archivo de base de datos mastsked, y las copia en un nuevo archivo de

planificación de producción llamado prodsked.

Debe tener acceso build a los archivos de base de datos del planificador.

Sinopsis

schedulr -v|-u

schedulr [-date fecha|-autodate] [-scheds {archivo-entrada|-}] [-prodsked

{archivo-salida|-}]

Argumentos

-u Mostrar la información sobre el uso del comando.

-v Mostrar la versión del comando.

-date Seleccionar secuencias de trabajos para una fecha específica. La fecha se

entra como mm/dd/[aa]aa.

-autodate

Seleccionar secuencias de trabajos para la fecha actual del sistema.

-scheds

Además de las seleccionadas mediante -date o -autodate, si hay alguna,

seleccionar las secuencias de trabajos especificadas en el archivo-entrada. Los

nombres deben aparecer en el archivo como [esttrabajo#]secuenciatrab, y

debe haber un nombre por línea. Si se entra un guión en lugar de un

nombre de archivo, schedulr solicita nombres de secuencias de trabajos en

la entrada estándar.

-prodsked

Dirigir la salida de schedulr al archivo-salida. Si se entra un guión en lugar

de un nombre de archivo, la salida se dirige a la salida estándar. Si el

argumento se omite, la salida se graba en un archivo llamado prodsked.

Descripción

Si -autodate y -date se omiten, schedulr solicita una fecha. Si responde a la

solicitud pulsando Intro, se seleccionan secuencias de trabajos sólo del

archivo-entrada.

Ejemplos

Seleccionar secuencias de trabajos para la fecha de hoy, además de las secuencias

de trabajos especificadas en el archivo myskeds:

schedulr -autodate -scheds myskeds

Seleccionar secuencias de trabajos para el 15 de febrero de 2001, no solicitar

nombres de secuencias de trabajos adicionales y grabar la salida en el archivo

myprodsked:

schedulr -date 2/15/01 -prodsked myprodsked

Seleccionar secuencias de trabajos para el 15 de febrero de 2001 y solicitar

secuencias de trabajos adicionales:

schedulr -date 2/15/2001 -scheds -


Solicitar la fecha de producción y secuencias de trabajos adicionales (tenga en

cuenta que “planificación” es lo mismo que “secuencia de trabajos”):

schedulr

Entrar fecha de planificación: 4/14/01

Entrar una lista de planificaciones adicionales

Nombre de planificación: site1#sked2

Nombre de planificación: <Intro>

<lista de secuencias de trabajos seleccionados>

Fin del programa


El comando compiler

El comando compiler compila el archivo de planificación de producción y crea un

archivo de plan de producción provisional.

Sinopsis

compiler -v|-u

compiler [-date fecha] [-input archivo-entrada] [-output archivo-salida]

Argumentos



-date La fecha de producción que se ha de registrar en el archivo de plan de

producción provisional. La fecha se entra como mm/dd/[aa]aa.

-input El nombre del archivo que contiene la planificación de producción. Si este

argumento se omite, el nombre predeterminado es prodsked.

-output

Dirigir la salida de compiler al archivo-salida. Si el argumento se omite, la

salida se graba en un archivo llamado Symnew.

Descripción

Si omite el argumento -date, al archivo Symnew se le asigna la misma fecha que la

registrada en el archivo de planificación de producción creado por schedulr. Si no

hay ninguna fecha en el archivo de planificación de producción, se utiliza la fecha

actual del sistema. La fecha de Symnew es la fecha en que el planificador

empezará a ejecutar el plan de producción. La posibilidad de entrar una fecha

distinta puede utilizarse para preparar el proceso para fechas pasadas o futuras.

Mensajes para objetos que faltan: El comando compiler genera los mensajes

siguientes para indicar que faltan objetos de planificación. Los mensajes se

encuentran normalmente en el archivo de lista estándar del trabajo Jnextday.

trabajo. 5 ... Parámetro no definido en la serie

"planificación"; no se sustituye.

Un parámetro especificado en una secuencia de trabajos no existe en la base de

datos del planificador. No se lleva a cabo la sustitución y se utiliza la propia serie

de parámetro.

AWSBIC102W ... No se encuentra el nombre

de trabajo en la base de datos. Se ha agregado un trabajo ficticio

en

estado anómalo (FAIL).

Un trabajo especificado en una secuencia de trabajos no existe en la base de datos

del planificador. Un trabajo ficticio con el mismo nombre se coloca en la

planificación de producción con una prioridad cero y un estado FAIL.

AWSBIC103W ... No se encuentra el

nombre de solicitud. Se ha agregado el nombre de solicitud a Symphony.

Una solicitud especificada en una secuencia de trabajos no existe en la base de

datos del planificador. Se utiliza en su lugar una solicitud ficticia que contiene el


texto siguiente: No se ha encontrado el nombre de solicitud en la base de datos.

Este texto es ficticio. ¿Desea continuar? (S/N).

AWSBIC104W ...No se encuentra el

nombre de recurso para el nombre de CPU en la base de datos.

Se ha

agregado el nombre de recurso con 0 unidades.

Un recurso especificado en una secuencia de trabajos no existe en la base de datos

del planificador. Se utiliza en su lugar un recurso ficticio con cero unidades

disponibles:

AWSBIC106W ... El nombre de CPU no existe

en la base de datos de CPU.

Se ignora el nombre de planificación.

Una secuencia de trabajos está definida para ejecutarse en una cpu que no existe.

La secuencia de trabajos se ignora y no se coloca en la planificación de producción.

Ejemplos

Compilar prodsked en Symnew:

compiler

Compilar prodsked en Symnew y entrar la fecha de producción 15 de mayo de

2002:

compiler -date 5/15/02

Compilar el archivo mysked en un archivo llamado mysym:

compiler -input mysked -output mysym


El comando stageman

El comando stageman traspasa las secuencias de trabajos no completadas, registra

el plan de producción antiguo e instala el plan de producción nuevo. El archivo de

plan de producción nuevo se llama Symphony. También se crea una copia del

archivo Symphony, llamada Sinfonia. Sinfonia se envía a los gestores de dominio

y a los agentes como parte del proceso de inicialización del nuevo día.

Debe tener acceso build al archivo Symphony.

Sinopsis

stageman -v

stageman [-carryforward {yes|no|all}] [-log archivo-registro|- nolog] [symnew]

Argumentos


-carryforward

Definir el tipo de traspaso de la siguiente manera:

no No traspasar ninguna secuencia de trabajos.

yes Traspasar únicamente las secuencias de trabajos no completadas

que estén habilitadas para el traspaso.

all Hacer caso omiso de si las secuencias de trabajos están habilitadas

para el traspaso, y traspasar todas las secuencias de trabajos no

completadas.

-log Registrar el plan de producción antiguo y asignar este nombre al archivo

de registro. Para obtener más información, consulte el apartado “Nombres

de archivos de registro” en la página 28.

-nolog No registrar el plan de producción antiguo.

symnew

El nombre del archivo de plan de producción provisional creado por el

comando compiler. Si se omite, se utiliza el archivo Symnew.

Descripción

Si omite -carryforward, el valor predeterminado para el traspaso viene

determinado por la opción global carryforward.

Sólo en UNIX, stageman determina también qué archivos ejecutables se pueden

suprimir para los trabajos sometidos con los comandos at y batch. Estos son

trabajos que no se traspasaron. Los archivos se suprimen en realidad cuando se

inicia el planificador para un nuevo día.

Si hay procesos del planificador que todavía se están ejecutando y accediendo al

archivo Symphony, stageman muestra el mensaje:

No se ha podido obtener acceso exclusivo a Symphony.

Concluya batchman y mailman.

Para continuar, detenga el planificador y vuelva a ejecutar stageman. Si stageman

termina anormalmente por cualquier motivo, debe volver a ejecutar tanto compiler

como stageman.


Los usuarios que acceden al plan mediante la CLI durante la conmutación al

nuevo Symphony reciben el mensaje:

El archivo Symphony actual es antiguo. Se cambia al nuevo Symphony.

Planificación mm/dd/aa (nnnn) en cpu, Symphony conmutado.

Puede que algunos comandos de usuario ejecutados durante la conmutación no se

ejecuten correctamente porque los trabajos o secuencias de trabajos de destino no

se traspasaron.

Nombres de archivos de registro: Los archivos de registro del plan de producción

se almacenan en el directorio DirInicialTWS/schedlog. El convenio de

denominación predeterminado que utiliza stageman cuando se omiten los

argumentos -log y -nolog es el siguiente:

DirInicialTWS/schedlog/Maaaammddhhtt

donde aaaammddhhtt es el año, mes, día, hora y minuto en que se creó el archivo

de registro.

El convenio de denominación anterior está codificado en el script Jnextday

suministrado por Tivoli. Si lo desea, puede cambiar el convenio de denominación

cuando automatice el ciclo de producción. Para obtener más información consulte

el apartado “Automatización del ciclo de producción” en la página 15.

Nota: Asegúrese de supervisar el espacio en disco del directorio schedlog y de

eliminar con regularidad los archivos de registro más antiguos.

Secuencias de trabajos traspasadas: La opción de traspaso permanece habilitada

en las secuencias de trabajos que se traspasan, de modo que puedan ser

traspasadas de nuevo. Si una secuencia de trabajos no satisfactoria se traspasa y

sigue terminando en un estado distinto de SUCC, se puede traspasar

indefinidamente a menos que se cancele o que su hora de finalización caduque.

Las secuencias de trabajos traspasadas mantienen internamente su fecha de

producción original. Todos los trabajos incluidos en las secuencias de trabajos que

utilicen comandos datecalc usarán esta fecha de producción si se utiliza la palabra

clave ″scheddate″. Para obtener más información consulte el apartado “datecalc” en

la página 246.

Para que la función de traspaso funcione correctamente en una red, el archivo de

plan de producción, Symphony, del gestor de dominio maestro debe actualizarse

con el estado de secuencia de trabajos más reciente de sus agentes y gestores de

dominio subordinados. Esto se puede llevar a cabo entrando lo siguiente en un

indicador de comandos del gestor de dominio maestro antes de ejecutar stageman:

conman "link @"

Nombres de secuencias de trabajos: Las secuencias de trabajos que se traspasan se

renombran de la siguiente manera:

CFaajjjnnxxxxxxxxx

donde aa son los dos últimos dígitos del año, jjj es la fecha juliana, nn es un

número de secuencia (00-99, AA-ZZ) y xxxxxxxxx es una cadena alfabética

aleatoria.

Solicitudes de traspaso (carryforward): Para mantener la continuidad al traspasar

secuencias de trabajos al día siguiente, stageman crea solicitudes especiales en el


nuevo plan de producción para detectar dependencias de continuación (Follows)

desconectadas. Estas solicitudes se emiten después de que comience el nuevo día

de proceso, cuando el planificador comprueba si el trabajo o secuencia de trabajos

está listo para iniciarse, y se responden como solicitudes estándar. El siguiente es

un ejemplo de una solicitud de traspaso:

INACT 12 (SYS1#CF9123AA) follows SYS1#SKED3 satisfied?

Esta solicitud indica que una secuencia de trabajos del día anterior se ha

traspasado como CF9123AA, y que va a continuación de una secuencia de trabajos

llamada sked3 que no se ha traspasado. El estado de la solicitud, INACT en este

caso, define el estado de la dependencia de continuación correspondiente. Los

posibles estados son:

INACT

La solicitud no se ha emitido y la dependencia no se ha satisfecho.

FORMULADA

La solicitud se ha emitido y está en espera de una respuesta. La

dependencia no se ha satisfecho.

NO Se ha recibido una respuesta ″no″, o se determinó antes de que se llevara a

cabo el traspaso que la secuencia de trabajos precedente (sked3) no se

había completado satisfactoriamente. La dependencia no se ha satisfecho.

SÍ Se ha recibido una respuesta ″sí″, o se determinó antes de que se llevara a

cabo el traspaso que la secuencia de trabajos precedente (sked3) se había

completado satisfactoriamente. La dependencia se ha satisfecho.

Nota: Se genera una solicitud si la planificación se traspasa y tiene una

dependencia follows respecto de otra planificación que no se traspasa. En el

caso de dependencias inter-red, aunque se traspasan ambas planificaciones

se genera una solicitud. Esto es debido a que, en el caso de las dependencias

inter-red, no se dispone de ningún mecanismo para mantenerlas conectadas.

El sucesor no puede saber si la planificación del otro extremo se ha

traspasado o no, y el vínculo de la dependencia se rompe en cualquier caso.

Para conocer más detalles, consulte el Capítulo 9, “Consulta del Agente de

red”, en la página 309.

Ejemplos

Traspasar todas las secuencias de trabajos no completadas (independientemente del

estado de la opción carryforward), registrar el archivo Symphony antiguo y crear

el archivo Symphony nuevo:

DATE=’datecalc today pic YYYYMMDDHHTT’

stageman -carryforward all -log schedlog/M$DATE

Traspasar todas las secuencias de trabajos no completadas según lo definido por la

opción global carryforward, no registrar el archivo Symphony antiguo y crear un

nuevo archivo de control de producción llamado mysym:

stageman -nolog mysym


|||||||||

El comando logman

El comando logman registra estadísticas de trabajos de un archivo de registro de

plan de producción.

Sinopsis

logman -v|-u

logman [-smooth porcentaje] [-minmax {elapsed|cpu}] archivo-registro

Argumentos



-smooth

Utilizar un coeficiente de ponderación que favorezca la ejecución más

reciente del trabajo al calcular el tiempo de ejecución normal (promedio) de

un trabajo. Esto se expresa como un porcentaje. Por ejemplo, -smooth 40

aplicará un coeficiente de ponderación del 40% a la ejecución más reciente

del trabajo y del 60% al promedio existente. El valor predeterminado es

cero.

-minmax

Definir cómo se registran y notifican los tiempos mínimo y máximo de

ejecución de los trabajos.

elapsed

Basar los tiempos mínimo y máximo de ejecución en el tiempo

transcurrido.

cpu Basar los tiempos mínimo y máximo de ejecución en el tiempo de

CPU.

archivo-registro

El nombre del archivo de plan de producción o archivo de registro del que

se extraen las estadísticas de trabajos.

Descripción

Los trabajos que ya se han registrado no se pueden volver a registrar. Si intenta

hacerlo, se genera un mensaje de error 0 trabajos registrados.

Tiempo transcurrido en comparación con el tiempo de CPU: El tiempo

transcurrido, expresado en minutos, se ve afectado considerablemente por la

actividad del sistema. Incluye tanto el periodo de tiempo que un trabajo utilizó la

CPU como los intervalos que el trabajo tuvo que esperar a que otros procesos

liberaran la CPU. Por ejemplo, en periodos de alto ritmo de actividad del sistema,

un trabajo puede tener un tiempo transcurrido largo y, sin embargo, no utilizar

más tiempo de CPU que en periodos de bajo ritmo de actividad del sistema. Por

otra parte, el tiempo de CPU, expresado en segundos, es una medida del tiempo

real que un trabajo ha utilizado la CPU, y no incluye los intervalos cuando el

trabajo estaba esperando.

Si ejecuta logman con el argumento -minmax elapsed, los tiempos y las fechas

mínimos y máximos de ejecución se basan únicamente en el tiempo transcurrido

de un trabajo. Los valores sólo se actualizan si la ejecución más reciente del trabajo

tiene un tiempo transcurrido mayor que el máximo existente o menor que el

mínimo existente. Los tiempos de CPU, en este caso, no indicarán necesariamente

sus extremos máximo y mínimo.


Si ejecuta logman con el argumento -minmax CPU, los tiempos y las fechas

mínimos y máximos de ejecución se basan únicamente en el tiempo de CPU de un

trabajo. Los valores sólo se actualizan si la ejecución más reciente del trabajo tiene

un tiempo de CPU mayor que el máximo existente o menor que el mínimo

existente. Los tiempos transcurridos, en este caso, no indicarán necesariamente sus

extremos máximo y mínimo.

Si ejecuta logman sin el argumento -minmax, los valores de tiempo transcurrido y

de tiempo de CPU se actualizan de forma independiente para indicar sus extremos

máximo y mínimo, pero las fechas de ejecución se corresponden solamente con los

valores de tiempo transcurrido. En este caso, no se guarda ningún registro de las

fechas de ejecución para los tiempos máximo y mínimo de CPU.

Ejemplos

Registrar estadísticas de trabajos del archivo de registro M199903170935:

logman schedlog/M199903170935

Registrar estadísticas de trabajos del archivo de registro M$DATE basándose en el

tiempo transcurrido, aplicando a las ejecuciones de trabajos más recientes una

ponderación del 40% al calcular los tiempos de ejecución normales (promedio):

logman -smooth 40 -minmax elapsed schedlog/M$DATE

La variable $DATE contiene la fecha e indicación de la hora que stageman utiliza

para crear el nombre del archivo de registro. Para obtener más información,

consulte el apartado “El comando stageman” en la página 27.


El comando wmaeutil

El comando wmaeutil se utiliza para detener el servidor de conector para el plan,

la base de datos y el motor. El comando makesec no se ejecutará satisfactoriamente

en plataformas Windows hasta que se detengan los conectores.

Nota: Si vuelve a crear un archivo de plan manualmente (sin utilizar Jnextday),

debe detener los conectores ejecutando el comando wmaeutil y luego renovar las

vistas de Job Scheduling Console para ver el nuevo día de producción. De lo

contrario, las vistas de la Job Scheduling Console permanecerán en el día de

producción anterior.

Sinopsis

UNIX:

wmaeutil.sh nombre_instancia [-stop DB | PL | EG | “*”] [-version DB | PL | EG

| “*”] [-dbinfo DB | PL] [-sethome] [-gethome] [ALL -stop]

Windows:

wmaeutil.cmd nombre_instancia [-stop DB | PL | EG | “*”] [-version DB | PL |

EG | “*”] [-dbinfo DB | PL] [-sethome] [-gethome] [ALL -stop]

Argumentos

nombre_instancia

El nombre de la instancia del planificador. Hace referencia al nombre de

instancia que ha especificado durante la instalación del motor del

planificador y la instalación del conector.

-stop DB | PL | EG | *

Esta opción puede utilizarse para concluir el servidor de conector

especificado. El asterisco (*) puede utilizarse para concluir los tres

servidores de conector.

-version DB | PL | EG | *

Esta opción se utiliza para obtener el número de versión del servidor de

conector para el plan, la base de datos y el motor que está instalada en el

sistema. El asterisco (*) puede utilizarse para obtener las versiones de los

tres servidores de conector.

-dbinfo DB | PL

Esta opción se utiliza para averiguar si la base de datos del planificador y

el plan al que este conector está vinculado es expandida o no expandida.

Con IBM Tivoli Workload Scheduler, Versión 8.2, las bases de datos y los

planes siempre se expanden, pero esta opción existe a efectos de

compatibilidad con versiones anteriores.

-sethome

Esta opción se utiliza para establecer el atributo TWShome de los objetos

del planificador (Motor, Base de datos y Plan) en la base de datos de

objetos de Tivoli. Este atributo vincula los conectores para la instancia de

objeto especificada con el producto planificador base. Adopta el nombre

calificado al completo del directorio inicial del planificador como

argumento. Además, la serie de nombre de ruta debe estar entre comillas

para impedir cualquier interpretación del shell.

-gethome

Esta opción no requiere ningún argumento e imprime el valor del atributo


TWShome para las instancias de los objetos Motor, Base de datos y Plan,

tal como está definido en la base de datos de objetos.

ALL -stop

Esta opción detiene los servidores de conector para todas las instancias de

conector del planificador conectadas a la instalación del planificador actual,

es decir, detiene los servidores de conector para todas las instancias cuyo

atributo TWShome coincida con el directorio inicial de la instalación actual

del planificador.

Notas sobre el uso

Variables de entorno establecidas: Para poder ejecutar satisfactoriamente

wmaeutil, antes debe ejecutar el archivo siguiente a fin de establecer el entorno de

trabajo.

Para Windows:

c: \> %SystemRoot%\system32\drivers\etc\Tivoli\setup_env.cmd

Para UNIX:

$. /etc/Tivoli/setup_env.sh

Puede actualizar el perfil de UNIX para ejecutar este archivo, a fin de evitarse el

tener que ejecutar el comando manualmente.

Consideraciones acerca de makesec: El comando wmaeutil.sh se debe ejecutar

antes de ejecutar el comando makesec. El comando makesec no se ejecutará

satisfactoriamente en plataformas Windows hasta que se detengan los conectores.

También debe detener los conectores cuando utilice el comando makesec en UNIX.

Nombre de instancia de IBM Tivoli Workload Scheduler: Si no está seguro del

nombre de instancia que se especificó durante la instalación, siga estos pasos:

1. Establezca el origen de las variables de entorno de Tivoli:

. /etc/Tivoli/setup_env.sh (para UNIX)

C:\winnt\system32\drivers\etc\Tivoli\setup_env.cmd (para Windows)

2. Ejecute el comando wlookup para obtener el nombre de instancia del

planificador:

wlookup -ar MaestroEngine

maestro2 1697429415.1.596#Maestro::Engine#

donde maestro2 es el nombre de instancia del planificador.

Ejemplos

Detener los conectores de la base de datos, el plan y el motor para una instancia

llamada maestro:

wmaeutil.sh maestro -stop ALL

Detener los conectores de la base de datos para una instancia llamada tws:

wmaeutil.sh tws -stop ALL DB

Obtener las versiones de los conectores de la base de datos, el plan y el motor para

una instancia llamada maestro2:

wmaeutil.sh maestro2 -version *


Capítulo 3. Consulta de Composer

El programa de línea de comandos Composer se utiliza para gestionar objetos de

planificación de la base de datos de IBM Tivoli Workload Scheduler. Los objetos de

planificación son estaciones de trabajo, clases de estación de trabajo, dominios,

trabajos, secuencias de trabajos, recursos, solicitudes, calendarios y parámetros.

Este capítulo describe lo siguiente:

v Gestión de objetos de planificación

v Programa de línea de comandos Composer

v Descripciones de comandos

Gestión de objetos de planificación

Los objetos de planificación se gestionan con el programa de línea de comandos

Composer y se guardan en la base de datos del planificador. El programa de línea

de comandos Composer utiliza archivos de edición para actualizar la base de datos

de planificación; para obtener información adicional sobre el formato del archivo

de edición utilizado para un objeto específico, consulte la definición de dicho

objeto específico que se describe al final de esta parte. Por ejemplo, para añadir un

nuevo objeto tiene que entrar la definición del mismo en un archivo de edición; a

continuación, utilizando el programa de línea de comandos composer, puede crear

o modificar el objeto especificando el archivo de edición que contiene la definición,

el programa de línea de comandos composer comprueba la sintaxis en dicho

archivo de edición y, si es correcta, añade la definición a la base de datos.

Según la clase de objetos que se desee gestionar utilizando el programa de línea de

comandos Composer, se gestiona ese objeto específico individualmente en la base de

datos, o se accede a la lista de objetos de la misma clase definidos en la base de

datos y se modifica la entrada en la lista que representa ese objeto específico.

Puede acceder a las entradas de la base de datos para secuencias de trabajos,

trabajos, usuarios, estaciones de trabajo, dominios y clases de estación de trabajo, y

gestionarlos de forma individual. Por ejemplo, para modificar una definición de

trabajo existente, se tiene que utilizar el programa de línea de comandos Composer

con la opción create para hacer que la definición de ese trabajo se copie desde la

base de datos en un archivo de edición, se tiene que modificar ese archivo de

edición y, a continuación, utilizando el programa de línea de comandos Composer

con la opción modify para modificar la definición de trabajo, el programa de línea

de comandos Composer comprueba que la sintaxis del archivo de edición es

correcta y, luego, copia de nuevo la definición de trabajo en la base de datos,

sustituyendo la definición existente.

Las entradas de la base de datos correspondientes a calendarios, parámetros,

solicitudes y recursos se gestionan como listas completas. Por ejemplo, para

modificar un recurso existente, se tiene que utilizar el programa de línea de

comandos Composer con la opción modify resources, la lista de recursos entera se

copia desde la base de datos en un archivo de edición que se puede editar

directamente desde dentro de la interfaz de Composer y luego guardarlo; cuando

se guarda el archivo de edición, el programa de línea de comandos Composer

comprueba si la sintaxis utilizada en el archivo es correcta y, luego, copia de nuevo

la nueva lista en la base de datos, sustituyendo la lista existente.


Composer no emite avisos específicos si se utilizan palabras clave del lenguaje de

planificación como nombres de objetos de planificación. Sin embargo, el uso de

palabras clave puede producir errores. Evite utilizar las palabras clave siguientes

cuando defina objetos de planificación:

Tabla 4. Lista de palabras reservadas

abendprompt end i18n_priority on schedule

after every in onuntil scriptname

at everyday interactive op server

autodocoff except isuserjob opens stop

autodocon extraneous jobfilename order streamlogon

behindfirewall fdignore keyjob os su

carryforward fdnext keysched priority timezone_tzid

confirmed fdprev maestro prompt token_in

cpuname filename needs qualifier until

dateval follows netdelim quoted_string weekday(s)

day(s) freedays nextjob recovery workday(s)

day_of_week go node request

deadline hi notempty rerun

docommand i18n_id number sa


Definiciones de estación de trabajo

Una estación de trabajo es un objeto de planificación que ejecuta trabajos. Una

estación de trabajo suele ser un sistema individual en el que se ejecutan trabajos y

secuencias de trabajos. Es necesaria una definición de estación de trabajo para cada

sistema que ejecute trabajos en la red de IBM Tivoli Workload Scheduler.

Principalmente, las definiciones de estación hacen referencia a estaciones de trabajo

físicas. Sin embargo, en el caso de agentes ampliados, las estaciones de trabajo son

definiciones lógicas que deben estar en una estación de trabajo física. Puede incluir

varias definiciones de estaciones de trabajo en el mismo archivo, junto con

definiciones de clases de estación de trabajo y de dominio. Cada definición de

estación de trabajo tiene el formato y los argumentos siguientes:

Sinopsis

#[ comentario]

cpuname esttrabajo [description ″texto″]

os tipo-OS

node nombrehost [tcpaddr puerto]

[secureaddr puerto][timezone|tz nombrehusohorario]

[domain nombredominio]

[for maestro [host esttrabajo-host [access método]]

[type fta | s-agent | x-agent]

[ignore]

[autolink on | off]

[behindfirewall on | off]

[securitylevel enabled | on | force]

[fullstatus on | off]

[resolvedep on | off]

[server idservidor]]

end

[cpuname ...]

[cpuclass ...]

[domain ...]

Argumentos

# comentario

Especifica que se trate como un comentario lo que hay desde el signo

numérico hasta el final de la línea.

cpuname esttrabajo

Especifica el nombre de la estación de trabajo. El nombre debe empezar

con una letra y puede contener caracteres alfanuméricos, guiones y

subrayados. Puede contener hasta 16 caracteres. Para ver una lista de las

palabras que debe evitar utilizar cuando especifique el cpuname, consulte

la Tabla 4 en la página 36.

Nota: Los nombres de estación de trabajo deben ser exclusivos y no

pueden ser iguales que nombres de dominio o de clase de estación

de trabajo.

description “texto”

Proporciona una descripción de la estación de trabajo. El texto debe

incluirse entre comillas.

Capítulo 3. Consulta de Composer 37

os tipo_SO

Especifica el sistema operativo de la estación de trabajo. Los valores

válidos incluyen UNIX, WNT y OTHER, donde

Tabla 5. Valores para los sistemas operativos soportados

Utilice estos valores... Para estos sistemas operativos...

UNIX HP-UX, Sun Solaris, AIX, Linux para Intel,

Linux para S/390 y z/Series, Linux para

ISeries y PSeries, Irix, OSF, Dynix, Compaq

WNT Windows NT, Windows 2000, Windows 2000

NET Server, Windows XP Professional

OTHER Se utiliza en relación con agentes ampliados.

Nota: Para ver una lista actualizada de las plataformas soportadas,

consulte la publicación IBM Tivoli Workload Scheduler Release Notes.

node nombrehost

Especifica el nombre de host o la dirección IP de la estación de trabajo. Se

aceptan nombres de dominio calificado al completos.

tcpaddr puerto

Especifica el número de puerto TCP que el planificación utiliza para las

comunicaciones en la estación de trabajo. El valor predeterminado es 31111.

secureaddr

Define el puerto utilizado para escuchar las conexiones SSL de entrada.

Este valor tiene que coincidir con el definido en la opción local nm puerto

SSL de la estación de trabajo. Debe ser distinto de la opción local nm

puerto que define el puerto utilizado para las comunicaciones normales. Si

se especifica securitylevel pero falta este atributo, se utiliza 31113 como

valor predeterminado. Para realizar consultas sobre la autenticación SSL,

consulte la publicación IBM Tivoli Workload Scheduler - Guía de planificación e

instalación.

timezone|tz nombrehusohorario

Especifica el huso horario de la estación de trabajo. Para obtener más

información sobre nombres válidos de huso horario, consulte el

Apéndice B, “Gestión de husos horarios”, en la página 341. Para asegurar

la exactitud de las horas de planificación, este huso horario debe ser el

mismo que el del sistema operativo de la máquina.

domain nombredominio

Especifica el nombre del dominio del planificador de la estación de trabajo.

El valor predeterminado para agentes tolerantes a errores y agentes

estándar es el dominio maestro, que normalmente recibe el nombre de

MASTERDM. El valor predeterminado para un gestor de domino es el

dominio en el cual está definido como gestor. El valor predeterminado

para un agente ampliado es el dominio de la estación de trabajo host.

host esttrabajo-host

Especifica el nombre de la estación de trabajo host del agente. Esta opción

es necesaria para agentes ampliados. El host es la estación de trabajo con la

que se comunica el agente ampliado y donde reside su método de acceso.

Tenga en cuenta que el host no puede ser otro agente ampliado.


access método

Especifica el método de acceso para agentes ampliados y de red. Debe ser

el nombre de un archivo que resida en el directorio TWShome/methods de

la estación de trabajo host del agente.

type Especifica el tipo de estación de trabajo. Entre una de las siguientes

opciones:

fta Agente tolerante a errores, incluidos gestores de dominio y

gestores de dominio de reserva.

s-agent

Agente estándar.

x-agent

Agente ampliado.

ignore Especifica que el planificador ignorará esta definición de estación de

trabajo.

autolink

Especifica si se debe abrir o no el vínculo entre estaciones de trabajo

durante el inicio. Para agentes tolerantes a errores y agentes estándar,

especifique on para hacer que el gestor de dominio abra el vínculo con el

agente cuando se inicie el gestor de dominio. Para un gestor de dominio,

especifique on para hacer que sus agentes abran vínculos con el gestor de

dominio cuando estos se inicien.

El vínculo automático es útil principalmente durante la secuencia de inicio

que tiene lugar al comienzo de cada nuevo día. En ese momento, se crea y

compila un nuevo plan de producción en el gestor de dominio maestro, y

todas las estaciones de trabajo se detienen y reinician. Para cada agente

que tenga el autolink (vínculo automático) seleccionado, el gestor de

dominio envía automáticamente una copia del nuevo plan de producción e

inicia el agente. Si la opción autolink también está activada, el agente, a su

vez, abre un vínculo con el gestor de dominio. Si la opción autolink tiene

el valor off para un agente, éste se inicializa cuando se ejecuta un

comando link de Conman en el gestor de dominio del agente o el gestor

de dominio maestro.

behindfirewall

Si este atributo se establece en ON, significa que existe un cortafuegos

entre la estación de trabajo y el gestor de dominio maestro. Sólo se permite

una conexión directa entre la estación de trabajo y su gestor de dominio.

Para todas las estaciones de trabajo que tengan behindfirewall establecido

en ON, se envían los comandos start esttrabajo, stop esttrabajo y showjobs a

continuación de la jerarquía del dominio, en lugar de hacer que el maestro

o el gestor de dominio abran una conexión directa con la estación de

trabajo.

fullstatus

Especifica si el agente se actualiza con estado completo o parcial. Esto es

sólo para agentes tolerantes a errores. Entre on para que el agente funcione

en modalidad Estado completo. En esta modalidad, el agente se actualiza

con el estado de los trabajos y las secuencias de trabajos que se ejecutan en

todas las demás estaciones de trabajo de su dominio y de dominios

subordinados, pero no en los dominios iguales o primarios.

Si fullstatus tiene el valor off, el agente sólo recibe información sobre el

estado de trabajos y las secuencias de trabajos en otras estaciones de


trabajo que afectan a sus propios trabajos y secuencias de trabajos. Esto

puede aumentar el rendimiento al reducir la actividad en la red.

Para mantener el plan de producción de un agente al mismo nivel de

detalle que su gestor de dominio, establezca fullstatus y resolvedep en el

valor on. Establezca siempre estas modalidades en el valor on para los

gestores de dominio de reserva.

securitylevel

Especifica el tipo de autenticación SSL para la estación de trabajo. Debe

tener uno de los valores siguientes:

enabled

La estación de trabajo sólo utiliza autenticación SSL si la estación

de trabajo de su gestor de dominio, u otro agente tolerante a

errores que se encuentre por debajo del mismo, la necesita.

on La estación de trabajo utiliza autenticación SSL cuando conecta con

su gestor de dominio. El gestor de dominio utiliza autenticación

SSL cuando conecta con su gestor de dominio primario. El agente

tolerante a errores rechaza cualquier conexión de entrada

procedente de su gestor de dominio si no se trata de una conexión

SSL.

force La estación de trabajo utiliza autenticación SSL para todas sus

conexiones y acepta conexiones de los gestores de dominio

primario y subordinados. Rechazará cualquier conexión de entrada

que no sea una conexión SSL.

Si se omite este atributo, la estación de trabajo no está configurada para

conexiones SSL. En este caso, se ignorará cualquier valor de secureaddr.

También se debe establecer la opción local nm ssl port en 0 para

asegurarse que netman no abra este puerto. Para realizar consultas sobre la

autenticación SSL, consulte la publicación IBM Tivoli Workload Scheduler -

Guía de planificación e instalación. En la tabla siguiente se describe el tipo de

comunicación que se utiliza para cada tipo de valor de securitylevel.

Tabla 6. Tipo de comunicación en función del valor de securitylevel.

Agente tolerante a errores

(Gestor de dominio)

Gestor de dominio (Gestor de

dominio primario)

Tipo de conexión

- - TCP/IP

Enabled - TCP/IP

On - Ninguna conexión

Force - Ninguna conexión

- On TCP/IP

Enabled On TCP/IP

On On SSL

Force On SSL

- Enabled TCP/IP

Enabled Enabled TCP/IP

On Enabled SSL

Force Enabled SSL

- Force Ninguna conexión

Enabled Force SSL

On Force SSL


Tabla 6. Tipo de comunicación en función del valor de securitylevel. (continuación)

Force Force SSL

resolvedep

Especifica si un agente hará un seguimiento de todas las dependencias o

sólo de las suyas. Esto es sólo para agentes tolerantes a errores. Indique on

para que el agente opere en modalidad Resolver todas las dependencias.

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

todos los trabajos y secuencias de trabajos, incluyendo los que se ejecutan

en otras estaciones de trabajo. Tenga en cuenta que fullstatus también debe

tener el valor on para que el agente pueda recibir información sobre la

actividad producida en otras estaciones de trabajo. Si resolvedep tiene el

valor off, el agente hace el seguimiento únicamente de las dependencias de

sus propios trabajos y secuencias de trabajos. Esto reduce la actividad

general de proceso.

Para mantener el plan de producción de un agente al mismo nivel de

detalle que su gestor de dominio, establezca fullstatus y resolvedep en on.

Establezca siempre estas modalidades en el valor on para los gestores de

dominio de reserva.

server idservidor

Especifica un servidor Mailman en el gestor de dominio para manejar las

comunicaciones con el agente. Esto es sólo para agentes tolerantes a errores

y agentes estándar. No utilice esta opción para gestores de dominio. El uso

de servidores puede reducir el tiempo necesario para inicializar los agentes

y mejorar la puntualidad de los mensajes.

El ID está formado por una sola letra o un número (A-Z y 0-9). Los ID son

exclusivos de cada gestor de dominio, de modo que puede utilizar los

mismos ID en otros dominios sin que entren en conflicto. Si se necesitan

más de 36 ID de servidor en un dominio, considere la posibilidad de

dividirlo en dos o más dominios.

Si no se especifica un ID de servidor, las comunicaciones con el agente las

maneja el proceso Mailman principal en el gestor de dominio.

Cuando se inicia, el gestor de dominio crea un servidor separado para

cada ID de servidor exclusivo. Si se utiliza el mismo ID para varios

agentes, se crea un solo servidor para manejar las comunicaciones de todos

ellos. Como ejemplo, deben definirse servidores adicionales para evitar que

un solo servidor maneje más de ocho agentes.

Ejemplos

En el ejemplo siguiente se crea un gestor de dominio maestro denominado hdq-1 y

un agente tolerante a errores denominado hdq-2 en el dominio maestro. Tenga en

cuenta que el argumento domain es opcional en este ejemplo porque el dominio

maestro toma el valor predeterminado masterdm.

cpuname hdq-1 description “DM maestro de oficina central”

os unix

tz pst

node sultan.ibm.com

domain masterdm

for maestro type fta

autolink on

fullstatus on

resolvedep on

end


cpuname hdq-2

os wnt

tz pst

node opera.ibm.com

domain masterdm


autolink on

end

En el siguiente ejemplo se crea un dominio denominado distr-a con un gestor de

dominio denominado distr-a1 y un agente estándar denominado distr-a2:

domain distr-a

manager distr-a1

parent masterdm

end

cpuname distr-a1 description “Gestor de dominio del distrito A”

os wnt

tz est

node pewter.ibm.com

domain distr-a


autolink on

fullstatus on

resolvedep on

end

cpuname distr-a2

os wnt

node quatro.ibm.com

tz est

domain distr-a

for maestro type s-agent

end

En el ejemplo siguiente se crea una estación de trabajo con autenticación SSL. La

definición de seguridad securitylevel especifica que la conexión entre la estación

de trabajo y su gestor de dominio sólo puede ser del tipo SSL. El puerto 32222 está

reservado para escuchar conexiones SSL de entrada.

cpuname ENNETI3

os WNT

node apollo

tcpaddr 30112

secureaddr 32222

for maestro

autolink off

fullstatus on

securitylevel on

end

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de una

estación de trabajo z/OS″ y ″Creación de una estación de trabajo distribuida″ en la

publicación IBM Tivoli Workload Scheduler Job Scheduling Console - Guía del usuario.


|||

Definiciones de clases de estación de trabajo

Una clase de estación de trabajo es un grupo de estaciones de trabajo para el que

se pueden crear secuencias de trabajos comunes. Puede incluir varias definiciones

de clases de estación de trabajo en el mismo archivo de texto, junto con las

definiciones de estación de trabajo y de dominio. Cada definición de clase de

estación de trabajo tiene el formato y los argumentos siguientes:

Sinopsis

# comentario

cpuclass claseesttrabajo

members {esttrabajo | @} [...]

end

[cpuname ...]

[cpuclass ...]

[domain ...]

Argumentos

# comentario



cpuclass claseesttrabajo

Especifica el nombre de la clase de estación de trabajo. El nombre debe

empezar con una letra y puede contener caracteres alfanuméricos, guiones

y subrayados. Puede contener hasta 16 caracteres.

Nota: No puede utilizar los mismos nombres para estaciones de trabajo,

clases de estaciones de trabajo y dominios.

members esttrabajo

Especifica una lista de nombres de estaciones de trabajo, separados por

espacios, que son miembros de la clase. El signo de arroba (@) como

carácter comodín para incluir todas las estaciones de trabajo.

Ejemplos

En el ejemplo siguiente se define una clase de estación de trabajo denominada

reserva:

cpuclass reserva

members

main

site1

site2

end

En el ejemplo siguiente se define una clase de estación de trabajo denominada

todascpus que contiene todas las estaciones de trabajo:

cpuclass todascpus

members

@

end

Véase también


clase de estación de trabajo″ en la publicación IBM Tivoli Workload Scheduler Job


||

Scheduling Console - Guía del usuario.


|

Definiciones de dominio

Un dominio es un grupo de estaciones de trabajo que consta de uno o más agentes

y un gestor de dominio. El gestor de dominio actúa como centro de gestión de los

agentes del dominio. Puede incluir varias definiciones de dominio en el mismo

archivo de texto, junto con las definiciones de estación de trabajo y definiciones de

clases de estación de trabajo. Cada definición de dominio tiene el formato y los

argumentos siguientes:

Sinopsis

# comentario

domain nombredominio[description “texto”]

manager esttrabajo

[parent nombredominio]

end

[cpuname ...]

[cpuclass ...]

[domain ...]

Argumentos

# comentario

Trata todo lo que hay desde el signo numérico hasta el final de la línea

como un comentario.

domain nombredominio

El nombre del dominio. Debe empezar con una letra y puede contener

caracteres alfanuméricos, guiones y subrayados. Puede contener hasta 16

caracteres. No puede utilizar los mismos nombres para estaciones de

trabajo, clases de estaciones de trabajo y dominios.


Proporciona una descripción del dominio. El texto debe incluirse entre

comillas.

manager esttrabajo

Especifica el nombre de la estación de trabajo que es el gestor de dominio.

Esta estación de trabajo debe pertenecer al dominio que se está definiendo.

El gestor de dominio debe ser un agente tolerante a errores que tenga las

opciones fullstatus y resolvedep set to on.

parent nombredominio

El nombre del dominio padre al que está vinculado el gestor de dominio.

El valor predeterminado es el dominio maestro, que no precisa ninguna

definición de dominio. El dominio maestro se define mediante las opciones

globales maestro y dominio maestro.

Ejemplos

En el ejemplo siguiente se define un dominio denominado este, con el dominio

maestro como padre y dos dominios subordinados denominados nordeste y

sudeste:

domain este description “El dominio del este”

manager cyclops

end

domain nordeste description “El dominio del nordeste”

manager boxcar parent este


end

domain sudeste description “El dominio del sudoeste”

manager sedan parent este

end

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de un

dominio″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console -

Guía del usuario.


|||

Definiciones de trabajo

Un trabajo es un archivo ejecutable, programa o comando que planifica e inicia

IBM Tivoli Workload Scheduler. Puede escribir definiciones de trabajo en archivos

de edición y luego agregarlas a la base de datos del planificador con el programa

de línea de comandos Composer. Puede incluir varias definiciones de trabajos en

un único archivo de edición.

Nota: Un trabajo en sí no tiene ninguna dependencia, éstas se tienen que añadir a

un trabajo de una secuencia de trabajos. El lenguaje de planificación

utilizado para crear las secuencias de trabajos también permite agregar y

modificar definiciones de trabajos. Consulte el capítulo siguiente para

obtener información adicional sobre cómo utilizar el lenguaje de

planificación para escribir secuencias de trabajos.Cada definición de trabajo tiene el formato y los argumentos siguientes:

Sinopsis

$jobs

[esttrabajo#]nombtrabajo

scriptname nombarchivo |

docommand “comando”streamlogon nombusuario

[description “texto”]

[interactive]

[rccondsucc ″Condición éxito″]

[recovery

{stop | continue | rerun}

[after [esttrabajo#]nombtrabajo]

[abendprompt “texto”] ]

[ [esttrabajo#]nombtrabajo... ]

Argumentos

esttrabajo#

Especifica el nombre de la estación de trabajo o clase de estación de trabajo

en la que se ejecuta el trabajo. El valor predeterminado es la estación de

trabajo en la que se ejecuta Composer. El signo numérico (#) es un

delimitador obligatorio. Si especifica una clase de estación de trabajo, ésta

debe coincidir con la clase de estación de trabajo de todas las secuencias de

trabajos en la que se incluye el trabajo.

nombtrabajo

Especifica el nombre del trabajo. El nombre debe empezar con una letra y

puede contener caracteres alfanuméricos, guiones y subrayados. Puede

contener hasta 40 caracteres.

scriptname nombarchivo

Especifica el nombre del archivo que el trabajo ejecuta. Utilice scriptname

para trabajos en UNIX y Windows. Para un archivo ejecutable, especifique

el nombre de archivo y todas las opciones y argumentos aplicables. La

longitud de nombarchivo más la longitud de Condición éxito (de la palabra

clave rccondsucc) no debe exceder de 4095 caracteres. También puede

utilizar parámetros de IBM Tivoli Workload Scheduler. Para obtener más

información, consulte el apartado “Utilización de parámetros en

definiciones de trabajos” en la página 52.


Para trabajos de Windows, incluya las extensiones de archivo. Se permiten

nombres UNC (Convenio de denominación universal). No especifique

archivos de unidades correlacionadas.

Si se incluyen espacios o caracteres especiales, que no sean barras

inclinadas (/) y barras inclinadas invertidas (\), la serie entera debe

indicarse entre comillas (″).

Si el nombre de archivo contiene espacios en blanco, entre el nombre en

otro archivo cuyo nombre no contenga espacios y utilice el nombre del

segundo archivo en este argumento.

docommand comando

Especifica un comando que el trabajo ejecuta. Entre un comando válido y

las opciones y argumentos pertinentes entre comillas (″). La longitud de

comando más la longitud de Condición éxito (de la palabra clave rccondsucc)

no debe exceder de 4095 caracteres. Se ejecutará directamente un comando

y, a diferencia de scriptname, no se ejecutará el script de configuración,

jobmanrc. De lo contrario, el comando se trata como un trabajo y se le

aplican todas las normas de los trabajos. También puede entrar parámetros

de IBM Tivoli Workload Scheduler. Para obtener más información, consulte

el apartado “Utilización de parámetros en definiciones de trabajos” en la

página 52.

streamlogon nombusuario

El nombre de usuario bajo el que se ejecuta el trabajo. El nombre puede

contener hasta 47 caracteres. Si contiene caracteres especiales, debe

escribirse entre comillas (″). Especifique un usuario que pueda iniciar la

sesión en la estación de trabajo en la que se ejecuta el trabajo. También

puede entrar parámetros de IBM Tivoli Workload Scheduler. Para obtener

más información, consulte el apartado “Utilización de parámetros en


Para trabajos de Windows, el usuario también debe tener una definición de

usuario. Para obtener más información sobre los requisitos de usuario,

consulte el apartado “Definiciones de usuario” en la página 53.


Proporciona una descripción del trabajo. El texto debe incluirse entre

comillas.

interactive

Para trabajos de Windows, incluya esta palabra clave para indicar que el

trabajo se ejecuta de forma interactiva en el escritorio de Windows NT.

rccondsucc ″Condición éxito″

Expresión que determina el código de retorno (RC) necesario para

considerar que un trabajo ha resultado satisfactorio. La longitud máxima

de la condición de éxito debe ser de 256 caracteres. Esta expresión puede

contener una combinación de expresiones booleanas y de comparación:

Expresión de comparación

Especifica los códigos de retorno del trabajo. La sintaxis es:

(RC operador operando)

RC La palabra clave RC.

operador

Operador de comparación. Puede tener los valores

siguientes:


Tabla 7. Operador de comparación

Ejemplo Operador Descripción

RC<a < Menor que

RC<=a <= Menor o igual que

RC>a > Mayor que

RC>=a >= Mayor o igual que

RC=a = Igual que

RC!=a != No igual que

RC<>a <> No igual que

operando

Un entero entre -2147483647 y 2147483647.

Por ejemplo, puede definir un trabajo satisfactorio como aquél que

termina con un código de retorno menor o igual que 3, del modo

siguiente:

rccondsucc "(RC <= 3)"

Expresión booleana

Especifica una combinación lógica de expresiones de comparación.

La sintaxis es:

expresión_comparación operador expresión_comparación

expresión_comparación

La expresión se evalúa de izquierda a derecha. Puede

utilizar paréntesis para asignar una prioridad a la

evaluación de la expresión.

operador

Operador lógico. Puede tener los valores siguientes:

Tabla 8. Operadores lógicos

Ejemplo Operador Resultado

expr_a y expr_b And TRUE si ambas expresiones,

expr_a y expr_b, son TRUE

(se cumplen).

expr_a o expr_b Or TRUE si cualquiera de las

expresiones, expr_a o expr_b,

es TRUE (se cumple).

No expr_a Not TRUE si la expresión expr_a

no es TRUE (no se cumple).


termina con un código de retorno menor o igual que 3 o con un

código de retorno no igual a 5, y menor que 10, del modo

siguiente:

rccondsucc "(RC<=3) OR ((RC!=5) AND (RC<10))"

recovery

Opciones de recuperación para el trabajo. El valor predeterminado es stop

sin ningún trabajo de recuperación ni ninguna solicitud de recuperación.


Entre una de las opciones de recuperación, stop, continue o rerun. A

continuación puede indicarse un trabajo de recuperación, una solicitud de

recuperación o los dos.

stop Si el trabajo finaliza de forma anómala, no continuar con el trabajo

siguiente.

continue

Si el trabajo finaliza de forma anómala, continuar con el trabajo

siguiente.

rerun Si el trabajo finaliza de forma anómala, volver a ejecutar el trabajo.

after [esttrabajo#]nombtrabajo

Especifica el nombre de un trabajo de recuperación que se ejecutará

si el trabajo padre finaliza de forma anómala. Los trabajos de

recuperación se ejecutan una sola vez para cada instancia del

trabajo padre que finaliza de forma anómala.

Puede especificar la estación de trabajo del trabajo de recuperación

si es distinta de la estación de trabajo del trabajo padre. El valor

predeterminado es la estación de trabajo del trabajo padre. No

todos los trabajos pueden tener trabajos de recuperación que se

ejecuten en una estación de trabajo distinta. Siga estas directrices:

v Si cualquiera de las dos estaciones de trabajo es un agente

ampliado, debe estar en un gestor de dominio o en un agente

tolerante a errores con el valor on en fullstatus.

v La estación de trabajo del trabajo de recuperación debe estar en

el mismo dominio que la estación de trabajo del trabajo padre.

v Si la estación de trabajo del trabajo de recuperación es un agente

tolerante a errores, debe tener el valor on en fullstatus.

abendprompt “texto”

Especifica el texto de una solicitud de recuperación, indicado entre

comillas, que se visualizará si el trabajo finaliza de forma anómala.

El texto puede contener hasta 64 caracteres. Si el texto empieza con

dos puntos (:), se muestra la solicitud pero no es necesaria ninguna

respuesta para continuar con el proceso. Si el texto empieza con un

signo de exclamación (!), la solicitud no se visualiza pero es

necesaria una respuesta para continuar.

En la siguiente tabla se muestra un resumen de todas las combinaciones de

acciones y opciones de recuperación posibles. La tabla se basa en los

siguientes criterios de una secuencia de trabajos denominada sked1:

v La secuencia de trabajos sked1 tiene dos trabajos, job1 y job2.

v Si se selecciona para job1, el trabajo de recuperación es jobr.

v job2 depende de job1 y no se iniciará hasta que job1 finalice.


Stop Continue Rerun

Solicitud de

recuperación: No

Trabajo de

recuperación: No

Es necesaria la

intervención.

Ejecutar job2. Volver a ejecutar

job1. Si job1 finaliza

de forma anómala,

emitir solicitud de

planificador. Si la

respuesta es sí,

repetir lo anterior. Si

job1 finaliza

satisfactoriamente,

ejecutar job2.

Solicitud de

recuperación: Sí

Trabajo de

recuperación: No

Emitir solicitud

de recuperación.

Es necesaria la

intervención.

Emitir solicitud

de recuperación.

Si la respuesta es

sí, ejecutar job2.

Emitir solicitud de

recuperación. Si la

respuesta es sí, volver

a ejecutar job1. Si

job1 finaliza de forma

anómala, repetir lo

anterior. Si job1

finaliza

satisfactoriamente,

ejecutar job2.

Solicitud de

recuperación: No

Trabajo de

recuperación: Sí

Ejecutar jobr. Si

finaliza de forma

anómala, es

necesaria la

intervención. Si

finaliza

satisfactoria-

mente, ejecutar

job2.

Ejecutar jobr.

Ejecutar job2.

Ejecutar jobr. Si jobr

finaliza de forma

anómala, es necesaria

la intervención. Si

jobr es satisfactorio,

volver a ejecutar job1.

Si job1 finaliza de

forma anómala,

emitir solicitud de

planificador. Si la

respuesta es sí,


job1 finaliza

satisfactoriamente,

ejecutar job2.

Solicitud de

recuperación: Sí

Trabajo de

recuperación: Sí

Emitir solicitud

de recuperación.

Si la respuesta es

sí, ejecutar jobr.

Si finaliza de

forma anómala,

es necesaria la

intervención. Si

finaliza

satisfactoria-

mente, ejecutar

job2.

Emitir solicitud

de recuperación.

Si la respuesta es

sí, ejecutar jobr.

Ejecutar job2.

Emitir solicitud de

recuperación. Si la

respuesta es sí,

ejecutar jobr. Si jobr

finaliza de forma

anómala, es necesaria

la intervención. Si

jobr es satisfactorio,

volver a ejecutar job1.

Si job1 finaliza de

forma anómala,


job1 finaliza

satisfactoriamente,

ejecutar job2.

Notas:

1. ″La intervención es necesaria″ significa que job2 no se ha liberado de su

dependencia de job1 y, por lo tanto, el operador debe hacerlo.

2. La opción de recuperación continuar prevalece sobre el estado de

terminación anómala, que puede causar que la planificación que


incluye el trabajo con finalización anómala se marque como

satisfactorio. Esto impedirá que la planificación se traspase al siguiente

día.

3. Si selecciona la opción Rerun (volver a ejecutar) sin indicar una

solicitud de recuperación, el planificador generará su propia solicitud.

4. Para hacer referencia a un trabajo de recuperación en Conman, debe

utilizar el nombre del trabajo original (en el ejemplo anterior job1, no

jobr). Los trabajos de recuperación sólo se ejecutan una vez por cada

terminación anormal.

Utilización de parámetros en definiciones de trabajos: A continuación se

muestran los usos y las limitaciones de los parámetros en las definiciones de

trabajos:

v Se permiten los parámetros en los valores streamlogon, scriptname y

docommand.

v Un parámetro puede utilizarse como una serie entera o como parte de la misma.

v Se permiten varios parámetros en una sola variable.

v Indique los nombres de parámetros entre signos de intercalación (^) y la serie

entera entre comillas.

v Asegúrese de que los caracteres de intercalación no vayan precedidos de una

barra inclinada invertida en la cadena. Si así sucediera, mueva la barra inclinada

invertida de la definición del parámetro entre signos de intercalación. Por

ejemplo, en lugar de entrar la definición de parámetros siguiente:

$PARM

MYDIR "scripts"

job01 scriptname "c:\pippo\home\^MYDIR^\test.cmd"

debe entrar:

$PARM

MYDIR "\scripts"

job01 scriptname "c:\pippo\home^MYDIR^\test.cmd"

En el ejemplo siguiente se utiliza un parámetro llamado mis en el valor

streamlogon. Si desea ver más ejemplos, consulte el apartado “Definiciones de

parámetros” en la página 57.

Ejemplos

A continuación se muestra un archivo que contiene dos definiciones de trabajos:

$jobs

cpu1#gl1

scriptname "/usr/acct/scripts/gl1"

streamlogon acct

description "general ledger job1"

bkup

scriptname "/usr/mis/scripts/bkup"

streamlogon "^mis^"

recovery continue after recjob1

Véase también


definición de trabajo″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling

Console - Guía del usuario.


|||

Definiciones de usuario

Los nombres de usuario utilizados como valor de streamlogon para definiciones

de trabajos de Windows deben tener definiciones de usuario. No es necesario para

los usuarios que ejecutan trabajos en otras plataformas. Cada definición de usuario

tiene el formato y los argumentos siguientes:

Sinopsis

# comentario

username[esttrabajo#]nombusuario

password “contraseña”

end

[username ...]

Argumentos

# comentario



username [esttrabajo#]nombusuario

Especifica el nombre de un usuario de Windows.

esttrabajo

Especifica la estación de trabajo en la que el usuario puede iniciar

los trabajos. Es necesario indicar el signo numérico. El valor

predeterminado es un espacio en blanco, lo que significa todas las

estaciones de trabajo.

nombusuario

Especifica el nombre de usuario de la siguiente forma:

[dominio\]usuario

donde dominio es el dominio de Windows del usuario y usuario es

el nombre del usuario.

El nombre de dominio puede contener un máximo de 16 caracteres

(incluida la barra inclinada invertida) y el nombre de usuario

puede contener hasta 31 caracteres.

Tenga en cuenta que los nombres de usuario de Windows son

sensibles a las mayúsculas y minúsculas. Además, el usuario debe

poder iniciar la sesión en la estación de trabajo en la que el

planificador iniciará los trabajos y tener el derecho de usuario

avanzado Iniciar sesión como proceso por lotes.

Si el nombre no es exclusivo en Windows, se considera que es un

usuario local, un usuario de dominio o un usuario de dominio de

confianza, en este orden.

contraseña

Especifica la contraseña del usuario. La contraseña puede contener como

máximo 29 caracteres y debe escribirse entre comillas. Para no indicar

ninguna contraseña, utilice dos comillas consecutivas sin ningún espacio

(″″). Después de compilar una definición de usuario, no podrá leer la

contraseña. Los usuarios con privilegios de seguridad adecuados pueden

modificar o suprimir un usuario, pero la información de contraseña nunca

se visualiza.


Utilización de las definiciones de streamlogon y de usuario de Tivoli Workload

Scheduler: En Windows, las definiciones de usuario se especifican mediante

Composer el formato [esttrabajo#]nombusuario. El nombre de estación de trabajo es

opcional; indicando la ausencia del mismo todas las estaciones de trabajo que se

ejecutan en Windows en la red de Tivoli Workload Scheduler.

Cuando se define o somete un trabajo mediante Composer, se deben especificar

tanto una estación de trabajo como un inicio de sesión de usuario válido para la

estación de trabajo. En estos casos, el inicio de sesión no es más que un

nombusuario—, un nombre de usuario válido para Windows— sin el complemento

del nombre de estación de trabajo. Por ejemplo, en la definición de trabajo

siguiente:

$JOB

esttrabajo job01 docommand "dir"

streamlogon nombusuario

el valor para streamlogon es nombusuario y no esttrabajo#nombusuario.

Sin embargo, cuando utilice el comando altpass debe recordar que tiene que usar

la definición de usuario con el formato

esttrabajo#nombusuario

Para este comando, sólo puede omitir el nombre de estación de trabajo en el caso

de que esté cambiando la contraseña de la estación de trabajo desde la que está

ejecutando el comando.

Usuario de dominio de confianza: Si el planificador debe iniciar trabajos para un

usuario de dominio de confianza, preste una especial atención al definir las cuentas

de usuario. Suponiendo que el planificador esté instalado en Domain1 para la

cuenta de usuario maestro y la cuenta de usuario sue que está en Domain2

necesita iniciar un trabajo, debe cumplirse lo siguiente:

v Debe haber una confianza mutua entre Domain1 y Domain2.

v En Domain1 de los sistemas en los que se inician los trabajos, sue debe tener el

derecho Iniciar la sesión como proceso por lotes.

v En Domain1, maestro debe ser un usuario del dominio.

v En los controladores de dominio de Domain2, maestro debe tener el derecho

Acceder este sistema desde la red.

Ejemplos

En el siguiente ejemplo se definen cuatro usuarios:

username joe

password "okidoki"

end

#

username server#jane

password "okitay"

end

#

username dom1\jane

password "righto"

end

#

username jack

password ""

end


Véase también


usuario de Windows″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling



|||

Definiciones de calendario

Los calendarios son listas de fechas que puede utilizar para planificar secuencias

de trabajos. Las definiciones de calendario se entran utilizando el comando de

modificación de Composer. Cuando se entra el comando, Composer copia la lista

completa de definiciones de calendario en un archivo de edición e inicia un editor

en el que se puede modificar la lista. Cada definición de calendario tiene el

formato y los argumentos siguientes:

Sinopsis

$calendar

nombrecalendario [“descripción”]

fecha [...]

[nombrecalendario ...]

Argumentos

nombrecalendario

Especifica el nombre del calendario. El nombre puede contener como

máximo 8 caracteres alfanuméricos, incluidos guiones (-) y subrayados (_),

y debe empezar por una letra.

“descripción”

Proporciona una descripción del calendario. Debe incluirse entre comillas.

Puede contener caracteres alfanuméricos siempre que empiece por una

letra. Puede contener los caracteres siguientes: coma (,), punto (.), guión (-),

signo más (+), comilla simple (’) y signo igual (=). No puede contener

comillas dobles (″) aparte de las que la envuelven, signos de dos puntos (:),

signos de punto y coma (;) ni signos &.

fecha [...]

Especifica una o varias fechas, separadas por espacios. El formato es

dd/mm/aa.

Ejemplos

En el siguiente ejemplo se definen tres calendarios llamados monthend (final de

mes), paydays (días de pago) y holidays (festivos):

$calendar

monthend "Fechas fin de mes primera mitad 1999"

01/31/99 02/28/99 03/31/99 04/30/99 05/31/99 06/30/99

paydays

01/15/99 02/15/99

03/15/99 04/15/99

05/14/99 06/15/99

holidays

01/01/99 02/15/99 05/31/99

Véase también


calendario″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console -

Guía del usuario.


|||

Definiciones de parámetros

Los parámetros son valores que sustituyen variables en definiciones de trabajos y

secuencias de trabajos a medida que se crea el nuevo plan de producción. Las

definiciones de parámetros se entran utilizando el comando composer modify.

Cuando se entra el comando, Composer copia la lista completa de definiciones de

parámetros en un archivo de edición e inicia un editor en el que se puede

modificar la lista. Cada definición de parámetro tiene el formato y los argumentos

siguientes:

Sinopsis

$parm

nombreparámetro “valor”

[nombreparámetro ...]

Argumentos

nombreparámetro

El nombre del parámetro. El nombre puede contener como máximo 8

caracteres alfanuméricos, incluidos guiones (-) y subrayados (_), y debe

empezar por una letra.

valor Especifica el valor asignado al parámetro. No incluya los nombres de otros

parámetros.

Notas sobre el uso

Todos los trabajos, secuencias de trabajos y solicitudes tienen acceso a los

parámetros. Cuando se utilizan en la planificación, los nombres de parámetros se

sustituyen por sus valores al compilar el plan de producción correspondiente a un

nuevo día de proceso.

Puede utilizar varios parámetros en una sola variable. Cuando utilice un

parámetro, indíquelo entre signos de intercalación (^) y especifique la cadena

entera entre comillas. Asegúrese de que los caracteres de intercalación no vayan

precedidos de una barra inclinada invertida en la cadena. Si así sucediera, mueva

la barra inclinada invertida de la definición del parámetro entre signos de

intercalación. Por ejemplo, en lugar de entrar la definición de parámetros siguiente:

$PARM

MYDIR "scripts"

job01 scriptname "c:\pippo\home\^MYDIR^\test.cmd"

debe entrar:

$PARM

MYDIR "\scripts"

job01 scriptname "c:\pippo\home^MYDIR^\test.cmd"

Ejemplos

Se definen dos parámetros, glpath y gllogon, del modo siguiente:

$parm

glpath "/glfiles/daily"

gllogon "gluser"

Los parámetros glpath y gllogon se utilizan en el trabajo gljob2 de la secuencia de

trabajos glsched:

schedule glsched on weekdays

:

gljob2


scriptname "/usr/gl^glpath^"

streamlogon "^gllogon^"

opens "^glpath^/datafile"

prompt ":^glpath^ started by ^gllogon^"

end

Véase también


parámetro″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console -

Guía del usuario.


|||

Definiciones de solicitudes

Las solicitudes pueden utilizarse como dependencias para trabajos y secuencias de

trabajos. Una solicitud se define mediante un nombre exclusivo asociado a un

mensaje textual y debe responderse afirmativamente para que el trabajo o

secuencia de trabajos dependiente se inicie. Las definiciones de solicitudes se

entran utilizando el comando composer modify. Cuando se entra el comando,

Composer copia la lista completa de definiciones de solicitudes en un archivo de

edición e inicia un editor en el que se puede modificar la lista.

Hay dos tipos de solicitudes:

v ad hoc o local

v predefinida o global

Una solicitud local se define en las propiedades de un trabajo o secuencia de

trabajos y es exclusiva para el trabajo o secuencia de trabajos indicados.

Una solicitud global se define en la base de datos del planificador y puede ser

utilizada por cualquier trabajo o secuencia de trabajos.

Nota: Las definiciones de solicitudes predefinidas o globales se restablecen cada

vez que se ejecuta el comando Jnextday.

Sinopsis

$prompt

nombsolicitud “[: | !]texto”

[nombsolicitud ...]

Argumentos

nombsolicitud

Especifica el nombre de la solicitud. El nombre puede contener como

máximo 8 caracteres alfanuméricos, incluidos guiones (-) y subrayados (_),

y debe empezar por una letra.

texto

Proporciona el texto de la solicitud. Si el texto empieza con dos puntos (:),

se muestra la solicitud pero no es necesaria ninguna respuesta para

continuar con el proceso. Si el texto empieza con un signo de exclamación

(!), la solicitud no se visualiza pero es necesaria una respuesta para

continuar.

Para una solicitud, puede utilizar uno o varios parámetros como la serie de

texto entera o como parte de la misma. Si utiliza un parámetro, la serie de

parámetro debe escribirse entre signos de intercalación (^). Si desea ver un

ejemplo, consulte el apartado “Definiciones de parámetros” en la página

57.

Nota: Dentro de una solicitud local, cuando no se designa ningún

parámetro, los signos de intercalación (^) deben ir precedidos de

una barra inclinada invertida (\) o se producirán errores en la

solicitud. Dentro de las solicitudes globales, los signos de

intercalación no tienen que ir precedidos por una barra inclinada

invertida.


Puede incluir una barra inclinada invertida y una n (\n) en el texto para

crear una nueva línea.

Ejemplos

En el siguiente ejemplo se definen tres solicitudes:

$prompt

prmt1 "¿está preparado para job4? (s/n)"

prmt2 ":job4 iniciado"

prmt3 "¿desea continuar?"

Véase también


solicitud″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console -

Guía del usuario.


|||

Definiciones de recursos

Los recursos representan recursos de planificación físicos o lógicos que pueden

utilizarse como dependencias para trabajos y secuencias de trabajos. Las

definiciones de recursos se entran utilizando el comando composer modify. Cuando

se entra el comando, Composer copia la lista completa de definiciones de recursos

en un archivo de edición e inicia un editor en el que se puede modificar la lista.

Cada definición de recurso tiene el formato y los argumentos siguientes:

Sinopsis

$resource

esttrabajo#nombrerecurso unidades [“descripción” ]

[esttrabajo#nombrerecurso ...]

Argumentos

esttrabajo


en la que se utiliza el recurso.

nombrerecurso

Especifica el nombre del recurso. El nombre puede contener como máximo

8 caracteres alfanuméricos, incluidos guiones (-) y subrayados (_), y debe


unidades

Especifica el número de unidades del recurso disponibles. Los valores

pueden estar comprendidos entre 0 y 1024.

“descripción”

Proporciona una descripción del recurso. Debe incluirse entre comillas.

Ejemplos

En el siguiente ejemplo se definen cuatro recursos:

$resource

ux1#tapes 3 "unidades de cinta"

ux1#jobslots 24 "intervalos de trabajo"

ux2#tapes 2 "unidades de cinta"

ux2#jobslots 16 "intervalos de trabajo"

Véase también


recurso distribuido″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling



|||

El programa de línea de comandos Composer

El programa de línea de comandos Composer gestiona objetos de planificación de

la base de datos del planificador.

Cómo ejecutar Composer

Para ejecutar el programa, utilice el siguiente comando:

composer [″comando[&[comando]][...]″]

A continuación se proporcionan ejemplos del comando:

v Ejecuta Composer y solicita un comando:

composer

v Ejecuta los comandos print y version y sale.

composer "p parms&v"

v Ejecuta los comandos print y version, y luego solicita un comando:

composer "p parms&v&"

v Lee los comandos del archivocomandos:

composer < archivocomandos

v Dirige los comandos del archivocomandos a Composer:

cat cmdfile | composer

Caracteres de control

Puede entrar los caracteres de control siguientes en modalidad de conversación

para interrumpir Composer si los valores de stty están configurados para hacerlo.

Control+c

Composer detiene la ejecución del comando actual en el siguiente paso que

puede interrumpirse y devuelve un indicador de comandos.

Control+d

Composer finaliza después de ejecutar el comando actual.

Salida de terminal

La salida del sistema la controlan las variables de shell, MAESTROLINES y

MAESTROCOLUMNS. Si no están establecidas, se utilizarán las variables del

shell estándar, LINES y COLUMNS. Al final de cada página que aparece en

pantalla, Composer le solicita continuar. Si MAESTROLINES (o LINES) se

establece en cero o en un número negativo, Composer no hace una pausa al final

de la página.

Salida fuera de línea

La opción ;offline en los comandos de Composer se utiliza para imprimir la salida

de un comando. Cuando se incluye, las siguientes variables controlan la salida:

Variables de Windows:

$MAESTROLP

Especifica el archivo en el que se graba la salida de un comando. El valor

predeterminado es stdout.

$MAESTROLPLINES

Especifica el número de líneas por página. El valor predeterminado es 60.


$MAESTROLPCOLUMNS

Especifica el número de caracteres por línea. El valor predeterminado es

132.

Variables de UNIX: La opción ;offline en los comandos de Composer se utiliza

para imprimir la salida de un comando. Cuando se incluye, las siguientes variables

del shell controlan la salida:

$MAESTROLP

Especifica el destino de la salida de un comando. Entre una de las

siguientes opciones:

> archivo

Redirige la salida a un archivo y graba encima del contenido del

archivo. Si el archivo no existe, se crea.

>> archivo

Redirige la salida a un archivo y añade la salida al final del


| comando

Dirige la salida a un proceso o comando del sistema. El comando

del sistema se ejecuta tanto si se genera salida como si no se

genera.

|| comando


del sistema no se ejecuta si no hay salida.

El valor predeterminado es | lp -tCONLIST que dirige la salida del

comando a la impresora con el título “CONLIST” en la página de mensaje

de cabecera de la salida impresa.

$MAESTROLPLINES


$MAESTROLPCOLUMNS


132.

Debe exportar las variables antes de ejecutar Composer.

El editor de Composer

Varios de los comandos de Composer abren automáticamente un editor de texto.

Puede seleccionar qué editor desea que Composer utilice.

Windows: En Windows, el editor predeterminado es el editor ‘edit’ de MS-DOS.

Sin embargo, este editor sigue los convenios de denominación 8.3 que puede ser

una limitación cuando Composer lo utiliza para modificar objetos de base de

datos. Si el nombre del objeto tiene más de 8.3 caracteres, el comando MODIFY de

Composer mostrará un error. Se recomienda utilizar otro editor como, por ejemplo,

Bloc de notas (Notepad). Para cambiar el editor, establezca la variable EDITOR

con el nombre del nuevo editor antes de ejecutar Composer.

UNIX: Varios de los comandos de Composer abren automáticamente un editor de

texto. El tipo de editor viene determinado por el valor de las dos variables del

shell. Si la variable VISUAL está establecida, su valor definirá el editor; si no lo

está, será la variable EDITOR la que definirá el editor. Si no está definida ninguna

de las dos, se abrirá el editor vi.


Selección del indicador de comandos de Composer en UNIX

El indicador de comandos de Composer se define en el archivo

TWShome/localopts. El indicador de comandos predeterminado es un guión (-).

Para seleccionar uno distinto, edite la opción de indicador de Composer en el

archivo localopts y cambie el guión. El indicador puede tener como máximo diez

caracteres, sin incluir el signo numérico de cola necesario (#):

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

# Personalizar atributos de formato

#

date format = 1 # Los valores posibles son 0-amd, 1-mda,

2-dma, 3-NLS.

composer prompt = -

conman prompt = %

switch sym prompt = <n>%

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


Los comandos de Composer están formados por los siguientes elementos:

nombrecomando selección argumentos

donde:

nombrecomando

Especifica el nombre del comando.

selección

Especifica el objeto o conjunto de objetos en los que se debe realizar una

acción.

argumentos

Especifica los argumentos de comandos.

Caracteres comodín

En algunos comandos de Composer se aceptan los siguientes caracteres comodín:

@ Sustituye uno o más caracteres alfanuméricos.

? Sustituye un carácter alfanumérico.

% Sustituye un carácter numérico.

Delimitadores y caracteres especiales

Los siguientes caracteres tienen un significado especial en los comandos de

Composer.

Carácter Descripción

& Delimitador de comando. Consulte el apartado “Cómo ejecutar

Composer” en la página 62.

; Delimitador de argumento. Por ejemplo:

;info;offline

= Delimitador de valor. Por ejemplo:

sched=sked5

: ! Prefijos de comandos que pasan el comando al sistema. Estos prefijos

son opcionales; si Composer no reconoce el comando, lo pasa

automáticamente al sistema. Por ejemplo:

!ls o :ls


|


<< >> Corchetes angulares de comentarios. Los comentarios pueden ponerse en

una sola línea en cualquier lugar de una secuencia de trabajos. Por

ejemplo:

schedule foo <<comentario>> on everyday

* Prefijo de comentario. Cuando este prefijo es el primer carácter de una

línea, toda la línea es un comentario. Cuando el prefijo va a

continuación de un comando, el resto de la línea es un comentario. Por

ejemplo:

*comentario

o

print& *comentario

> Redirige la salida del comando a un archivo y graba encima del

contenido del archivo. Si el archivo no existe, se crea. Por ejemplo:

display parms > parmlist

>> Redirige la salida del comando a un archivo y añade la salida al final

del archivo. Si el archivo no existe, se crea. Por ejemplo:

display parms >> parmlist

| Dirige la salida del comando a un proceso o comando del sistema. El

comando del sistema se ejecuta tanto si se genera salida como si no se

genera. Por ejemplo:

display parms | grep alparm

|| Dirige la salida del comando a un proceso o comando del sistema. El

comando del sistema no se ejecuta si no hay salida. Por ejemplo:

display parms || grep alparm

Descripciones de comandos

En las siguientes páginas se describen los comandos de Composer.

Comando Descripción Página

add Agrega objetos de planificación. “add” en la

página 67

build Crea o vuelve a crear un archivo de IBM Tivoli Workload

Scheduler.

“build” en la

página 68

continue Ignora el siguiente error. “continue”

en la página

69

create Crea un archivo para su edición. “create” en

la página 70

delete Suprime objetos de planificación. “delete” en

la página 72

display Muestra objetos de planificación. “display, list,

print” en la

página 74

edit Edita un archivo. “edit” en la

página 78

exit Finaliza la ejecución de Composer. “exit” en la

página 79


Comando Descripción Página

list Lista objetos de planificación. “display, list,

print” en la

página 74

modify Modifica objetos de planificación. “modify” en

la página 80

new Edita y agrega objetos de planificación. “new” en la

página 82

print Imprime objetos de planificación. “display, list,

print” en la

página 74

redo Edita el comando anterior. “redo” en la

página 83

replace Sustituye objetos de planificación. “replace” en

la página 85

validate Valida un archivo. “validate” en

la página 87

version Muestra el mensaje de cabecera del programa de línea de

comandos Composer.

“version” en

la página 88

comando del

sistema

Pasa un comando del sistema al sistema. “system,

comando” en

la página 86

Los nombres de comandos pueden escribirse tanto en mayúsculas como en

minúsculas. También se pueden abreviar a unos cuantos caracteres iniciales

necesarios para distinguirlos unos de otros.


add

Agrega trabajos, secuencias de trabajos, usuarios, estaciones de trabajo, clases de

estaciones de trabajo y dominio. Deberá tener acceso add para los objetos nuevos.

Si un objeto ya existe, debe tener acceso modify para el objeto.

Sinopsis

add nombarchivo

Argumentos

nombarchivo

Especifica el nombre del archivo que contiene lo siguiente:

v Definiciones de trabajos. (La primera línea del archivo debe ser $jobs.)

v Definiciones de secuencias de trabajos.

v Cualquier combinación de definiciones de estación de trabajo, clase de

estación de trabajo y dominio.

v Definiciones de usuario.

Notas sobre el uso

La sintaxis del archivo se comprueba siempre antes de grabarla en la base de

datos. Se informa de todos los errores y avisos. Si existen errores de sintaxis, se le

solicitará si desea editar el archivo para efectuar correcciones. Si un objeto ya

existe, se le pedirá si se debe sustituir o no.

Ejemplos

Para añadir los trabajos del archivo myjobs, ejecute el comando siguiente:

add myjobs

Para añadir las secuencias de trabajos del archivo mysked, ejecute el comando

siguiente:

a mysked

Para añadir las estaciones de trabajo, clases de estaciones de trabajo y dominios del

archivo cpus.src, ejecute el comando siguiente:

a cpus.src

Para añadir las definiciones de usuario del archivo users_nt, ejecute el comando

siguiente:

a users_nt

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Supervisión de

tareas″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console - Guía

del usuario.


||

|

||

|

||

|

||

|

||||

build

Crea o vuelve a crear archivos de base de datos del planificador. Debe tener acceso

build al archivo.

Si ha implementado el FixPack 8.2-TWS-FP04, puede utilizar este comando

mientras se está ejecutando IBM Tivoli Workload Scheduler. Si no ha

implementado este FixPack o uno posterior, es aconsejable que detenga todos los

procesos de IBM Tivoli Workload Scheduler antes de ejecutar este comando.

Sinopsis

build nombarchivo

Argumentos

nombre archivo base de datos

Especifica uno de los siguientes nombres de archivo:

calendars

El archivo que contiene definiciones de calendarios.

cpudata

El archivo que contiene definiciones de estaciones de trabajo, clase

de estaciones de trabajo y dominios.

jobs El archivo que contiene definiciones de trabajos.

mastsked

El archivo que contiene definiciones de secuencias de trabajos.

parms El archivo que contiene definiciones de parámetros.

prompts

El archivo que contiene definiciones de solicitudes.

resources

El archivo que contiene definiciones de recursos.

userdata

El archivo que contiene definiciones de usuario.

Notas sobre el uso

Si no existe ningún archivo, se crea. Si el archivo existe, se vuelve a crear. La

reconstrucción de un archivo de base de datos puede resultar útil cuando la base

de datos queda fragmentada debido a muchas adiciones y supresiones. La

reconstrucción eliminará los registros no utilizados y optimizará las claves.

Ejemplos

Para reconstruir los archivos que contienen definiciones de secuencias de trabajos,

ejecute el comando siguiente:

build mastsked

Para reconstruir el archivo que contiene calendarios, ejecute el comando siguiente:

build calendars

Para reconstruir el archivo que contiene estaciones de trabajo, ejecute el comando

siguiente:

b cpudata


||||

|||

|

|

|

||

|

|

continue

Especifica que se debe ignorar el error de comando siguiente.

Sinopsis

continue

Notas sobre el uso

Este comando es útil cuando se entran varios comandos en la línea de comandos o

se redirigen varios comandos desde un archivo. Indica a Composer que debe

continuar ejecutando los comandos incluso aunque el comando que sigue a

continue, produzca un error. Este comando no es necesario cuando se entran

comandos interactivamente porque Composer no finalizará al encontrar un error.

Ejemplos

Si desea que Composer continúe con el comando print si el comando delete

produce un error, ejecute el comando siguiente:

composer "continue&delete cpu=site4&print cpu=@"


|||

|

create

Crea un archivo que contiene definiciones de objetos. Debe tener acceso display a

los objetos que se copian.

Sinopsis

create nombarchivo from calendars | parms | prompts | resources

| cpu={esttrabajo | claseesttrabajo | dominio} |

jobs=[esttrabajo#]nombtrabajo |

sched=[esttrabajo#]secuenciatrab |

users=[esttrabajo#]nombusuario

Argumentos

nombarchivo

Especifica un nombre de archivo.

calendars

Copia todos los calendarios en el archivo.

parms Copia todos los parámetros en el archivo.

prompts

Copia todas las solicitudes en el archivo.

resources

Copia todos los recursos en el archivo.

cpu Copia una estación de trabajo, una clase de estación de trabajo o un

dominio en el archivo.

esttrabajo

El nombre de estación de trabajo. Se permiten caracteres comodín.

claseesttrabajo

El nombre de la clase de estación de trabajo. Se permiten caracteres

comodín.

dominio

El nombre del dominio. Se permiten caracteres comodín.

jobs Copia trabajos en el archivo.

esttrabajo

El nombre de la estación de trabajo o clase de estación de trabajo

en la que se ejecuta el trabajo. Se permiten caracteres comodín. El

valor predeterminado es la estación de trabajo en la que se ejecuta

Composer.

nombtrabajo

El nombre del trabajo. Se permiten caracteres comodín.

sched Copia secuencias de trabajos en el archivo.

esttrabajo


en la que se ejecuta la secuencia de trabajos. Se permiten caracteres

comodín. El valor predeterminado es la estación de trabajo en la

que se ejecuta Composer.

secuenciatrab

El nombre de la secuencia de trabajos. Se permiten caracteres

comodín.


users Copia usuarios en el archivo. El campo de contraseña no se copia por

razones de seguridad.

esttrabajo

El nombre de la estación de trabajo en la que se ha definido el

usuario. Se permiten caracteres comodín. El valor predeterminado

es la estación de trabajo en la que se ejecuta Composer.

nombusuario

El nombre de usuario. Se permiten caracteres comodín.

Nota: Es conveniente crear regularmente una copia de seguridad de los objetos

guardados en la base de datos.

Notas sobre el uso

Después de crear un archivo, puede utilizar el comando edit para efectuar cambios

en el mismo. A continuación se puede utilizar el comando add o replace para

agregar o actualizar la definición.

Ejemplos

Para crear un archivo que contenga todos los calendarios, ejecute el comando

siguiente:

create caltemp from calendars

Para crear un archivo que contenga todas las secuencias de trabajos, ejecute el

comando siguiente:

cr stemp from sched=@

Véase también



del usuario.


||

|||

|

||

|

||||

delete

Suprime definiciones de objetos de la base de datos. Debe tener acceso delete a los

objetos que se suprimen.

Sinopsis

delete cpu={esttrabajo | claseesttrabajo | dominio} |




Argumentos

cpu Suprime estaciones de trabajo, clases de estación de trabajo o dominios.

esttrabajo


claseesttrabajo


comodín.

dominio


jobs Suprime trabajos.

esttrabajo




Composer.

nombtrabajo


sched Suprime secuencias de trabajos.

esttrabajo





secuenciatrab


comodín.

users Suprime usuarios.

esttrabajo




nombusuario


Notas sobre el uso

Si utiliza caracteres comodín para especificar un conjunto de definiciones,

Composer necesita una confirmación antes de suprimir cada definición que

coincide.


Ejemplos

Para suprimir job3, que se inicia en la estación de trabajo site3, ejecute el comando

siguiente:

delete jobs=site3#job3

Para suprimir todas las estaciones de trabajo cuyos nombres empiecen por ux,


de cpu=ux@

Para suprimir todas las secuencias de trabajos cuyos nombres empiecen por test de

todas las estaciones de trabajo, ejecute el comando siguiente:

de sched=@#test@

Véase también



del usuario.


|||

|

||

|

||

|

||||

display, list, print

Muestra, lista o imprime definiciones de objeto. Para display y print, debe tener

acceso display al objeto. En realidad, display muestra el contenido del objeto de

base de datos, mientras que list y print muestran el nombre y los atributos de

dicho objeto.

Sinopsis

display | list | print calendars | parms | prompts | resources

| cpu={esttrabajo | claseesttrabajo | dominio} |




Argumentos

calendars

Muestra todos los calendarios.

parms Muestra todos los parámetros.

prompts

Muestra todas las solicitudes.

resources

Muestra todos los recursos.

cpu Muestra una estación de trabajo, una clase de estación de trabajo o un

dominio.

esttrabajo


claseesttrabajo


comodín.

dominio


jobs Muestra un trabajo.

esttrabajo




Composer.

nombtrabajo


sched Muestra una secuencia de trabajos.

esttrabajo





secuenciatrab


comodín.


users Muestra un usuario. El campo de contraseña no se copia por razones de

seguridad.

esttrabajo




nombusuario


Salida del comando

El comando list sólo muestra los nombres de objetos. La salida del comando print

la controla la variable MAESTROLP. Para obtener más información, consulte el

apartado “Salida fuera de línea” en la página 62.

Formato de calendars:

Calendario

El nombre del calendario.

Descripción

Descripción en formato libre del calendario.

Después de estos campos aparecerá una lista de fechas de calendario.

Formato de CPU:

ID de CPU

El ID de una estación de trabajo, una clase de estación de trabajo o un

dominio.

Creador

El nombre del usuario que creó la definición de estación de trabajo.

Última actualización

La fecha en que se ha actualizado por última vez la definición de estación

de trabajo.

Después de estos campos aparecerá la definición de la estación de trabajo o de la

clase de estación de trabajo.

Formato de Jobs:

ID de CPU

El nombre de la estación de trabajo en la que se ejecuta el trabajo.

Trabajo

El nombre del trabajo.

Inicio de sesión

El nombre del usuario de inicio de sesión para el trabajo.

Última fecha de ejecución

La fecha en la que se ha ejecutado por última vez el trabajo.

Después de estos campos aparecerá la definición del trabajo.

Formato de Parms:

Parámetro

El nombre del parámetro.


Valor El valor del parámetro.

Formato de Prompts:

Solicitud

El nombre de la solicitud.

Mensaje

El texto de mensaje de la solicitud.

Formato de Resources:

ID de CPU

El nombre de la estación de trabajo en la que se ha definido el recurso.

Nombre

El nombre del recurso.

Núm disponible

El número total de unidades del recurso.

Descripción

La descripción con formato libre del recurso.

Formato Sched:

ID de CPU

El nombre de la estación de trabajo en la que se ejecuta la secuencia de

trabajos.

Planificación

El nombre de la secuencia de trabajos.

Creador

El nombre del usuario que creó la definición de la secuencia de trabajos.


La fecha en que se ha actualizado por última vez la definición de secuencia

de trabajos.

Después de estos campos aparecerá la definición de la secuencia de trabajos.

Formato de Users:

ID de CPU

El nombre de la estación de trabajo en la que el usuario está autorizado a

ejecutar trabajos.

Usuario

El nombre del usuario.

Creador

El nombre del usuario que creó la definición de usuario.


La fecha en que se ha actualizado por última vez la definición de usuario.

Después de estos campos aparecerá la definición de usuario.

Ejemplos

Para mostrar todos los calendarios, ejecute el comando siguiente:

display calendars


||

|

Para imprimir todas las secuencias de trabajo emitidas en la estación de trabajo

site2, ejecute el comando siguiente:

di sched=site2#@;offline

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Trabajo con listas de

objetos″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console -

Guía del usuario.


||

|

||||

edit

Edita un archivo.

Sinopsis

edit nombarchivo

Notas sobre el uso

Se inicia un editor y el archivo especificado se abre para su edición. Para obtener

más información, consulte el apartado “El editor de Composer” en la página 63.

Ejemplos

Para abrir el archivo mytemp para su edición, ejecute el comando siguiente:

edit mytemp

Para abrir el archivo resfile para su edición, ejecute el comando siguiente:

ed resfile

Véase también



del usuario.


||

|

|

|

|||

exit

Sale del programa de línea de comandos Composer.

Sinopsis

exit

Notas sobre el uso

Cuando se ejecuta el programa de línea de comandos Composer en modalidad de

ayuda, este comando devuelve a Composer a la modalidad de entrada de

comandos.

Ejemplos

Para salir del programa de línea de comandos Composer, ejecute el comando

siguiente:

exit

o:

e


|||

|

|

|

|

modify

Modifica o agrega objetos de planificación. Se debe tener acceso modify al objeto o

al archivo de base de datos afectado.

Sinopsis

modify calendars | parms | prompts | resources |

cpu={esttrabajo | claseesttrabajo | dominio} |




Argumentos

calendars

Modifica todos los calendarios.

parms Modifica todos los parámetros.

prompts

Modifica todas las solicitudes.

resources

Modifica todos los recursos.

cpu Modifica una estación de trabajo, una clase de estación de trabajo o un

dominio.

esttrabajo


claseesttrabajo


comodín.

dominio


jobs Modifica un trabajo.

esttrabajo




Composer.

nombtrabajo


sched Modifica una secuencia de trabajos.

esttrabajo





secuenciatrab


comodín.

users Modifica un usuario.


esttrabajo




nombusuario


Notas sobre el uso

El comando modify copia la definición o lista de objetos en un archivo temporal,

lo edita y luego agrega el contenido del archivo al archivo de base de datos

adecuado. Equivale a la siguiente secuencia de comandos:

create file from object-specification

edit file

add file

Si la operación de adición se realiza satisfactoriamente, el archivo de edición se

elimina. Para obtener más información, consulte las descripciones de los comandos

create, edit y add de este capítulo.

Para las definiciones de usuario, si un campo de contraseña permanece vacío al

salir del editor, se retiene la contraseña anterior. Para especificar una contraseña

nula utilice dos comillas dobles consecutivas (“”).

Ejemplos

Para modificar todos los calendarios, ejecute el comando siguiente:

modify calendars

Para modificar la secuencia de trabajos sked9, que se inicia en la estación de

trabajo site1, ejecute el comando siguiente:

m sched=site1#sked9

Véase también



del usuario.


||

|

||

|

||||

new

Agrega un nuevo objeto de planificación. Se debe tener acceso add para los nuevos

objetos de la estación de trabajo. Para los objetos existentes, se debe tener acceso

modify al objeto o al archivo de base de datos afectado.

Sinopsis

new

Notas sobre el uso

El comando new crea un archivo temporal, edita el archivo y luego agrega el

contenido del archivo. Para calendarios, parámetros, recursos y solicitudes, utilice

el comando modify de la página 80.

Ejemplos

Para crear un archivo temporal, editar el archivo y después agregar el contenido

del archivo a la base de datos, ejecute el comando siguiente:

new

o:

n


|||

|||||

redo

Edita y vuelve a ejecutar el comando anterior.

Sinopsis

redo

Contexto

Cuando se ejecuta el comando redo, Composer muestra el comando anterior para

que se pueda editar y volver a ejecutar. Utilice la barra espaciadora para mover el

cursor bajo el carácter que se debe modificar y entre las directivas siguientes.

Directivas

d[dir] Suprime el carácter encima de la d. Puede ir seguido de otras

directivas.

itexto Inserta texto antes del carácter que está encima de la i.

rtexto Sustituye uno o más caracteres por texto, empezando por el

carácter que está encima de la r. La sustitución es implícita si no se

entra ninguna otra directiva.

>texto Agrega texto al final de la línea.

>d[dir | texto]

Suprime caracteres al final de la línea. Puede ir seguida de otra

directiva o de texto.

>rtexto Sustituye caracteres al final de la línea por texto.

Ejemplos de directivas

ddd Suprime los tres caracteres que están encima de las d.

iabc Inserta abc antes del carácter que está encima de la i.

rabc Sustituye los tres caracteres, empezando por el que está encima de

la r, por abc.

abc Sustituye los tres caracteres que están encima de abc por abc.

d diabc

Suprime el carácter que está encima de la primera d, salta un

carácter, suprime el carácter que está encima de la segunda d e

inserta abc en su lugar.

>abc Agrega abc al final de la línea.

>ddabc

Suprime los dos últimos caracteres de la línea e inserta abc en su

lugar.

>rabc Sustituye los tres últimos caracteres de la línea por abc.

Ejemplos

Para insertar un carácter, ejecute el comando siguiente:

redo

dislay site1#sa@

ip

display site1#sa@

Para sustituir un carácter, ejecute el comando siguiente:


||

||||

|

redo

display site1#sa@

r2

display site2#sa@


||||

|

replace

Sustituye objetos de planificación. Debe tener acceso modify a los objetos o al

archivo de base de datos afectado.

Sinopsis

replace nombarchivo

Argumentos

nombarchivo

Especifica el nombre de un archivo que contiene lo siguiente:

v Definiciones de trabajos. La primera línea del archivo debe ser $jobs.

v Definiciones de secuencias de trabajos.

v Cualquier combinación de definiciones de estación de trabajo, clase de

estación de trabajo y dominio.

v Definiciones de usuario.

v Un conjunto completo de calendarios, parámetros, solicitudes o recursos.

Notas sobre el uso

El comando replace es parecido al comando add excepto en que no hay ninguna

solicitud para sustituir objetos existentes. Para obtener más información, consulte el

apartado “add” en la página 67.

Ejemplos

Para sustituir los trabajos del archivo myjobs, ejecute el comando siguiente:

replace myjobs

Para sustituir las secuencias de trabajos del archivo mysked, ejecute el comando

siguiente:

rep mysked

Para sustituir todos los recursos por los contenidos en el archivo myres, ejecute el

comando siguiente:

rep myres


||

|

||

|

||

|

|

system, comando

Ejecuta un comando del sistema.

Sinopsis

[: | !] comando-sist

Argumentos

comando-sist Especifica cualquier comando de sistema válido. El prefijo de dos

puntos (:) o signo de exclamación (!) sólo es necesario cuando el

comando se deletrea igual que un comando de Composer.

Ejemplos

Para ejecutar un comando ps en UNIX, ejecute el comando siguiente:

ps -ef

Para ejecutar un comando dir en Windows, ejecute el comando siguiente:

dir \bin


||

|

|

|

|

validate

Valida un archivo que contiene objetos de planificación.

Sinopsis

validate nombarchivo[;syntax]

Argumentos

nombarchivo

Especifica el nombre de un archivo que contiene calendarios, estaciones de

trabajo, clases de estación de trabajo, dominios, trabajos, parámetros,

solicitudes, recursos o secuencias de trabajos. Entre prodsked para validar

el archivo de plan de producción creado durante el proceso del día de

preproducción.

syntax Comprueba si hay errores de sintaxis en el archivo.

Notas sobre el uso

El comando validate efectúa las mismas comprobaciones y validación de sintaxis

que se realizan al agregar o modificar objetos. También puede utilizarse para

validar el archivo de planificación de producción, prodsked, creado durante el

proceso del día de preproducción. Prodsked contiene las secuencias de trabajos

que se deben ejecutar un día determinado y puede modificarse con un editor para

incluir cambios ad hoc antes de que empiece el día de proceso. Validate deberá

utilizarse en estos casos para garantizar que el plan de producción todavía sea

válido.

Para las secuencias de trabajos, si se omite la opción de sintaxis (syntax), la

validación y la información incluyen lo siguiente:

v Verificar los nombres de trabajos con el archivo de trabajo maestro.

v Examinar las dependencias para asegurarse de que existen los objetos. Por

ejemplo, se informa acerca de una dependencia needs de un recurso no

existente. Esto también comprobará las referencias a calendarios no existentes.

v Comprobar las dependencias circulares. Por ejemplo, si job1 sigue a job2, y job2

sigue a job1, existe una dependencia circular.

La salida del comando validate puede redirigirse a un archivo del modo siguiente:

composer "validate nombarchivo" > archivosalida

Para incluir mensajes de error en el archivo de salida, utilice lo siguiente:

composer "validate nombarchivo" > archivosalida 2>&1

Ejemplos

Para comprobar la sintaxis de un archivo que contiene definiciones de estación de

trabajo, ejecute el comando siguiente:

validate misCPU;syntax

Para revalidar todas las secuencias de trabajos, ejecute el comando siguiente:

create allskeds from sched=@#@

validate allskeds

Esto puede realizarse para verificar la integridad de las referencias a otros objetos

de planificación después de que se hayan efectuado cambios.


|||

|

|

||

||

version

Muestra el mensaje de cabecera del programa de línea de comandos Composer.

Sinopsis

version

Ejemplos

Para mostrar el mensaje de cabecera del programa de línea de comandos

Composer, ejecute el comando siguiente:

version

o:

v


|||

|

|

|

Capítulo 4. El lenguaje de planificación

En este capítulo se describe cómo crear una secuencia de trabajos. en base a los

objetos de planificación definidos en la base de datos, utilizando el programa de

línea de comandos Composer. Las secuencias de trabajos creadas con la interfaz

gráfica de usuario no hacen referencia a las palabras clave indicadas en este

capítulo, aunque todas las secuencias de trabajos del planificador se guardan

utilizando las mismas palabras clave y sintaxis del lenguaje de planificación. En

este capítulo se suministra información acerca de lo siguiente:

v Sintaxis para las secuencias de trabajos

v Descripciones de palabras clave

Sintaxis para las secuencias de trabajos

A continuación se muestra la estructura de una secuencia de trabajos, con las

palabras clave en negrita. Una secuencia de trabajos empieza con una palabra

clave schedule seguida de los atributos y las dependencias. El delimitador dos

puntos presenta los trabajos que forman la secuencia de trabajos. Cada trabajo

tiene sus propios atributos y dependencias.

schedule [cpu#]planif

[freedays nombre_calendario [-sa] [-su] ]

on {fecha| día | calendario | petición}[,...] [fdignore | fdnext | fdprev]

[on {fecha| día | calendario | petición}[,...] [fdignore | fdnext | fdprev]]

[,...]

[deadline hora [timezone|tz nombrehusohorario][+n day[s] [,...]

[except{fecha| día | calendario}[,...] [fdignore | fdnext | fdprev] ]

[,...]

[at hora[timezone|tz nombrehusohorario][+ n day [s] ] ] [,...]

[carryforward]

[follows { [cpu#] sched [. trabajo] [,...] } ]

[keysched]

[limit número]

[needs recurso]

[opens archivo]

[priority número]

[prompt nombre|texto]

[until hora [timezone|tz nombrehusohorario][+n day[s]] [onuntil acción]

:

sentencia-trabajo

[at hora[timezone|tz nombrehusohorario][+ n day [s] ] ] [,...]

[confirmed]

[deadline hora [timezone|tz nombrehusohorario][+n day[s] [,...]

[every frecuencia]

[follows job|secuenciatrab]

[keyjob]

[needs recurso]

[opens archivo]

[priority número]

[prompt nombre|texto]


[until hora [timezone|tz nombrehusohorario][+n day[s]] [onuntil acción]

[sentencia-trabajo...]

end

No intente escribir secuencias de trabajos en una sola línea, puesto que el comando

schedulr las rechazará después de que, aparentemente, Composer las haya

aceptado. Por ejemplo, si escribe en una línea la planificación siguiente:

SCHEDULE cbdbu01#NN_CBCID1001YS31 ON CBZZ0001 PRIORITY 10 FOLLOWS

cbdbu02#NN_CBTND10011501:cbdbu01#JN_CBCID1001YS1GA1 PRIORITY 10 OPENS

"/st01/st01if/in/CUBCIFYS1GA1001.dat.ok"

se devolverá un error cuando schedulr procese la planificación. Para este ejemplo

debe realizar una de las opciones siguientes:

v Utilice composer para:

1. Crear un nombarchivo a partir de schedule=cbdbu01#NN_CBCID1001YS31 (o

todas las planificaciones que se definen de este modo).

2. Ejecutar composer add nombarchivo

v Divida la planificación del modo siguiente:

SCHEDULE

cbdbu01#NN_CBCID1001YS31 ON CBZZ0001 PRIORITY 10 FOLLOWS

cbdbu02#NN_CBTND10011501:cbdbu01#JN_CBCID1001YS1GA1 PRIORITY 10 OPENS

"/st01/st01if/in/CUBCIFYS1GA1001.dat.ok"

Palabras clave

En la siguiente tabla se proporciona una breve descripción de las palabras clave de

planificación.

Palabra clave Descripción Página

at Define la hora a la que comienza la ejecución del

trabajo o la secuencia de trabajos.

“at” en la

página 93

carryforward Traspasa esta secuencia de trabajos al día siguiente

si no se ha completado.

“carryforward”

en la página 95

comments Incluye comentarios en una definición de secuencia

de trabajos.

“comments” en

la página 96

confirmed Especifica que la conclusión de este trabajo requiere

confirmación.

“confirmed” en

la página 97

deadline Especifica la hora en que se debe completar un

trabajo o una secuencia de trabajos.

“deadline” en

la página 98

end Marca el final de una secuencia de trabajos. “end” en la

página 99

every Inicia este trabajo repetidamente con una frecuencia

especificada.

“every” en la

página 100

except Especifica las fechas que son excepciones a las

fechas en que se selecciona la secuencia de datos

para su ejecución.

“except” en la

página 101

follows Especifica no iniciar este trabajo o secuencia de

trabajos hasta que otros trabajos y secuencias de

trabajos se hayan completado satisfactoriamente.

“follows” en la

página 104

freedays Especifica un calendario de días libres para calcular

los días laborables de la secuencia de trabajos. Los

sábados y domingos también los puede establecer

como días laborables.

“freedays” en

la página 105


Palabra clave Descripción Página

Sentencia job Define un trabajo y sus dependencias. “Sentencia de

trabajo” en la

página 107

keyjob Marca un trabajo como clave o crítico tanto en la

base de datos como en el plan diario, para que lo

supervisen las aplicaciones, como por ejemplo IBM

Tivoli Business Systems Manager o Tivoli Enterprise

Console.

“keyjob” en la

página 112

keysched Marca una secuencia de trabajos como clave o

crítica tanto en la base de datos como en el plan

diario, para que la supervisen las aplicaciones,

como por ejemplo IBM Tivoli Business Systems

Manager o Tivoli Enterprise Console.

“keysched” en

la página 113

limit Establece un límite para el número de trabajos que

pueden iniciarse simultáneamente desde la

secuencia de trabajos.

“limit” en la

página 114

needs Define el número de unidades de un recurso que el

trabajo o la secuencia de trabajos necesita antes de

poder iniciarse.

“needs” en la

página 115

on Define las fechas en las que la secuencia de trabajos

se selecciona para su ejecución.

“on” en la

página 116

opens Define los archivos a los que se debe poder acceder

para que el trabajo o la secuencia de trabajos pueda

iniciarse.

“opens” en la

página 119

priority Define la prioridad de un trabajo o de una


“priority” en la

página 121

prompt Define las solicitudes que deben responderse para

que el trabajo o la secuencia de trabajos pueda

iniciarse.

“prompt” en la

página 122

schedule Asigna un nombre a la secuencia de trabajos. “schedule” en

la página 123

until Define una hora después de la cual no puede

iniciarse el trabajo o la secuencia de trabajos.

“until” en la

página 124

Dependencias

Una dependencia es una condición que debe satisfacerse antes de iniciar un trabajo

o una secuencia de trabajos. Hay dos secuencias de trabajos con las palabras clave

follows, needs, opens y prompt. El número máximo de dependencias permitidas

para un trabajo o secuencia de trabajos es 40.

Nota: La única dependencia que se comprueba inmediatamente antes de ejecutar

un trabajo es NEEDS. Una dependencia OPENS se considera resuelta

automáticamente antes de ejecutar el trabajo.

Sensibilidad a las mayúsculas y minúsculas

Salvo los nombres de ruta, nombres de usuario y comandos de UNIX, que son

sensibles a las mayúsculas y minúsculas, al escribir las planificaciones puede

utilizar caracteres tanto en mayúsculas como en minúsculas.


Descripciones de palabras clave

En las siguientes página se describe la sintaxis de las palabras clave de lenguaje de

planificación.


at

Define la hora más temprana de inicio a la que se iniciará un trabajo o secuencia

de trabajos.

Sinopsis

at hora [timezone|tz nombrehusohorario][+n day[s]] [,...]

Argumentos

hora Especifica la hora del día. Los valores posibles están comprendidos entre

0000 y 2359.

nombrehusohorario

Especifica el huso horario que se va a utilizar al calcular la hora de inicio.

Para ver los nombres de zonas horarias, consulte el Apéndice B, “Gestión

de husos horarios”, en la página 341. El valor predeterminado es el huso

horario de la estación de trabajo en la que se inicia el trabajo o la secuencia

de trabajos.

Nota: Si se especifica una hora de inicio, at, y una hora final, until, ambas

deben tener el mismo huso horario.

n Especifica un desplazamiento en días de la fecha y la hora de inicio

planificadas.

Notas sobre el uso

Si no se especifica una hora at para un trabajo o secuencia de trabajos, su hora de

inicio la determinan sus dependencias y prioridad.

El valor hora en la opción at tiene las siguientes consideraciones:

Si el valor indicado en la hora es inferior a la hora actual, hará referencia al día

siguiente.

Si el valor indicado en la hora es superior a la hora actual, se aplicará al día

actual.

Si se especifica un valor de hora superior a 2400, el valor se divide por 2400

para obtener el número de días. Si especifica días, estos se añaden al valor

obtenido dividiéndolos por 2400.

Ejemplos

En los siguientes ejemplos se supone que el día de proceso de IBM Tivoli

Workload Scheduler empieza a las 6:00 a.m.

v La secuencia de trabajos siguiente, seleccionada los martes, no se inicia antes de

las 3:00 a.m. de la madrugada del miércoles. Sus dos trabajos se inician lo antes

posible después de esa hora.

schedule sked7 on tu at 0300:

job1

job2

end

v El huso horario de la estación de trabajo sfran está definido como Hora oficial

del Pacífico (pst) y el huso horario de la estación de trabajo nycity está definido

como Hora oficial del Este de EEUU (est). La secuencia de trabajos siguiente está

seleccionada para ejecutarse el viernes. Se inicia en la estación de trabajo sfran a

las 10:00 a.m. pst del sábado. El trabajo job1 se inicia en sfran lo antes posible

después de esta hora. job2 se inicia en sfran a las 2:00 p.m. est (11:00 a.m. pst)

del sábado. job3 se inicia en la estación de trabajo nycity a las 4:00 p.m. est (1:00

p.m. pst) del sábado.


sfran#schedule sked8 on fr at 1000 + 1 day :

job1

job2 at 1400 tz est

nycity#job3 at 1600

end


carryforward

Hace que una secuencia de trabajos sea elegible para ser traspasada al plan de

producción del día siguiente si no se ha completado antes del final del plan de

producción del día actual.

Sinopsis

carryforward

Ejemplos

La secuencia de trabajos siguiente se traspasa si sus trabajos no se han completado

antes de que empiece el proceso de preproducción para un nuevo día.

schedule sked43 on th

carryforward

:

job12

job13

job13a

end


comments

Incluye comentarios en la definición de una secuencia de trabajos.

Sinopsis

*text | <<texto>>

Argumentos

*texto Inserta una línea de comentario. El primer carácter de la línea debe ser un

asterisco.

<<texto>>

Inserta texto de comentario en una línea. El texto debe estar entre corchetes

angulares dobles.

Ejemplos

El ejemplo siguiente incluye ambos tipos de comentarios:

****************************************

* Los trabajos de borrado semanales

****************************************

*

schedule wkend on fr at 1830

carryforward

:

job1 <<totales finales e informes>>

job2 <<actualizar base de datos>>

end


confirmed

Especifica que la conclusión de un trabajo debe confirmarse mediante la ejecución

del comando confirm de Conman. Para obtener más información, consulte el

apartado “confirm” en la página 159.

Sinopsis

confirmed

Ejemplos

En la siguiente secuencia de trabajos, debe recibirse la confirmación de la

conclusión de job1 antes de iniciar los trabajos job2 y job3.

schedule test1 on fr:

job1 confirmed

job2 follows job1

job3 follows job1

end


deadline

Especifica la hora en que se debe completar un trabajo o una secuencia de trabajos.

Los trabajos o las secuencias de trabajos que aún no se han iniciado o que se

siguen ejecutando una vez que ha transcurrido el plazo límite, se consideran tardíos

en el plan. Cuando un trabajo (o una secuencia de trabajos) es tardío, se realizan

las acciones siguientes:

v El trabajo se muestra como tardío en Conman y Job Scheduling Console.

v Se envía un evento a Tivoli Enterprise Console y a IBM Tivoli Business Systems

Manager.

v Se emite un mensaje para stdlist y para los registros de la consola.

Sinopsis

deadline hora [timezone|tz nombrehusohorario][+n day[s] [,...]

Argumentos


0000 y 2359.

nombrehusohorario

Especifica el huso horario que se va a utilizar al calcular el plazo límite.

Para ver los nombres de zonas horarias, consulte el Apéndice B, “Gestión

de husos horarios”, en la página 341. El valor predeterminado es el huso

horario de la estación de trabajo en la que se inicia el trabajo o la secuencia

de trabajos.

n Especifica un desplazamiento en días desde la hora límite planificada.

Ejemplos

El ejemplo siguiente activa la secuencia de trabajos sked7 cada día y el trabajo jobc

para que se empiece a ejecutar a las 14:30 y haya terminado a las 16:00.

schedule sked7 on everyday :

jobc at 1430 deadline 1600

end


end

Marca el final de una definición de secuencia de trabajos.

Sinopsis

end

Ejemplos

schedule test1 on monthend

:

job1

job2

job3

end << end of job stream >>


every

Define la frecuencia de repetición de un trabajo. El trabajo se inicia de forma

repetitiva con la frecuencia especificada. Si el trabajo tiene una dependencia que no

se cumple, se inicia la repetición cuando se satisface la dependencia.

Sinopsis

every frecuencia

Argumentos

frecuencia

La frecuencia de repetición expresada en horas y minutos, en el formato:

hhmm. La frecuencia puede ser superior a 24 horas.

Notas sobre el uso

Si un trabajo repetitivo (every) finaliza de forma anómala, la repetición continúa. Si

la opción every se utiliza con la dependencia AT, los trabajos se inician en

momentos concretos. Si se retarda una reejecución (por una dependencia o

cualquier otra razón), IBM Tivoli Workload Scheduler se volverá a alinear con la

hora AT. En este caso, es posible que una o dos repeticiones no respeten la

cadencia EVERY. Si la opción EVERY se utiliza sin la dependencia AT, los trabajos

de reejecución se planificarán respetando la cadencia EVERY especificada,

empezando por la hora en que se inició realmente el trabajo. SI, Y SÓLO SI, la

opción EVERY se utiliza con la dependencia AT, puede haber cualquier número de

repeticiones que no respeten la cadencia EVERY. Para todos los otros casos siempre

se respeta la cadencia EVERY.

Ejemplos

E ejemplo siguiente ejecuta el trabajo testjob cada hora:

testjob every 100

El ejemplo siguiente ejecuta el trabajo testjob1 cada 15 minutos, entre las 6:00 p.m.

y las 8:00 p.m.:

testjob1 at 1800 every 15 until 2000

El trabajo se ejecutará a las 1800, 1815, 1830, y así sucesivamente. Si el trabajo se

somete adhoc a las 1833, las reejecuciones se producirán a las 1833,1834,1845, y así

sucesivamente.

El ejemplo siguiente no inicia la repetición del trabajo testjob2 hasta que el trabajo

testjob1 ha terminado satisfactoriamente:

testjob2 every 15 follows testjob1


|||||||||||

except

Define las fechas que son excepciones a las fechas on de una secuencia de trabajos.

Para obtener más información, consulte el apartado “on” en la página 116.

Sinopsis

except {fecha| día | calendario } [fdignore | fdnext | fdprev][,...]

[except {fecha| día | calendario }] [fdignore | fdnext | fdprev][,...]]

Argumentos

fecha Una fecha en el formato: dd/mm/aa.

día Un día de la semana. Especifique una o más de las siguientes opciones:

mo Lunes

tu Martes

we Miércoles

th Jueves

fr Viernes

sa Sábado

su Domingo

weekdays

Todos los días salvo sábados y domingos.

workdays

Puede ser una de las posibilidades siguientes:

v Si se ha especificado un calendario de días libres, los días

laborables son todos los días con excepción de sábados y domingos

(a menos que se especifique -sa o -su junto con la palabra clave

freedays) y de todas las fechas del calendario de días libres

especificados.

v Si no se ha especificado un calendario de días libres, los días


y de todas las fechas del calendario holidays.freedays

Los días marcados en el calendario de días libres, si ha

especificado una.

calendario

Las fechas especificadas en un calendario con este nombre. El nombre del

calendario puede ir seguido de un desplazamiento en el formato siguiente:

{+ | -}n {day[s] | weekday[s] | workday[s]}

Donde:

n El número de días, días de la semana o días laborables.

days Representa todos los días de la semana.

weekdays

Representa todos los días de la semana, a excepción de sábado y

domingo.

workdays


domingo (salvo que se especifique otra cosa mediante la palabra

clave freedays) y las fechas marcadas en un calendario de días

libres designado o en el calendario holidays.


regla para días libres

Especifica una regla que debe aplicarse cuando la fecha seleccionada para

su exclusión cae en un día libre. Puede ser una de las siguientes:

fdignore

No excluir la fecha.

fdnext Excluir el día laborable más cercano después de un día libre.

fdprev

Excluir el día laborable más cercano antes de un día libre.

Notas sobre el uso

Se pueden definir varias instancia de la palabra clave except para la misma

secuencia de trabajos. Cada instancia equivale a un ciclo de ejecución al que se

puede asociar una regla de día libre.

Para indicar varias instancias except éstas deben indicarse de forma consecutiva en

definición de secuencias de trabajos.

Cada instancia de la palabra clave puede contener cualquiera de los valores que la

sintaxis except permite.

Ejemplos

En el siguiente ejemplo se selecciona la secuencia de trabajos testskd2 para que se

ejecute todos los días de la semana excepto aquellos días que aparecen en los

calendarios llamados monthend y holidays:

schedule testskd2 on weekdays

except monthend,holidays


ejecute todos los días laborables excepto el 15 de mayo de 1999 y el 23 de mayo de

1999:


except 15/05/99,23/05/99


ejecute todos los días excepto dos días de la semana antes de cualquier fecha que

aparezca en el calendario monthend:

schedule testskd4 on everyday

except monthend-2 weekdays

Seleccionar la secuencia de trabajos sked4 para que se ejecute los lunes, martes y

dos días de la semana antes de cada fecha indicada en el calendario MONTHEND.

Si el día de ejecución es un día libre, ejecutar la secuencia de trabajos en el

siguiente día laborable más cercano. No ejecutar la secuencia de trabajos los

miércoles.

schedule sked4

on mo

on tu, MONTHEND -2 weekdays fdnext

except we

Seleccionar la secuencia de trabajos testskd2 para que se ejecute todos los días la

semana excepto los días que aparecen en MONTHEND. Si una fecha que aparece

en MONTHEND cae en día libre, excluir el día laborable más cercano anterior. En

este ejemplo, los días libres son sábados, domingos y todas las fechas indicadas en

el calendario holidays predeterminado.


schedule testskd2

on weekdays

except MONTHEND fdprev


follows

Define los otros trabajos y secuencias de trabajos que deben completarse

satisfactoriamente antes de que un trabajo o secuencia de trabajos pueda iniciarse.

Sinopsis

Utilice la siguiente sintaxis para las secuencias de trabajos:

follows [agentered::][esttrabajo#]secuenciatrab[.nombretrabajo | @] [,...]

Utilice la siguiente sintaxis para los trabajos:

follows [agentered::][esttrabajo#]secuenciatrab{.nombretrabajo | @} | nombretrabajo [,...]

Argumentos

agentered

El nombre del agente de red donde está definida la dependencia inter-red.

esttrabajo

La estación de trabajo en la que se ejecuta el trabajo o secuencia de trabajos

que debe completarse. El valor predeterminado es la misma estación de

trabajo que el trabajo o secuencia de trabajos dependiente.

Si no se especifica una esttrabajo con un agentered, el valor predeterminado

es la estación de trabajo a la que el agente de red está conectado.

secuenciatrab

El nombre de la secuencia de trabajos que debe completarse. Para un

trabajo, el valor predeterminado es la misma secuencia de trabajos que el

trabajo dependiente.

nombretrabajo

El nombre del trabajo que debe completarse. Se puede utilizar un signo de

arroba (@) para indicar que todos los trabajos de la secuencia de trabajos

deben completarse satisfactoriamente.

Ejemplos

En el ejemplo siguiente se especifica no iniciar la secuencia de trabajos skedc hasta

que se haya completado satisfactoriamente la secuencia de trabajos sked4 en la

estación de trabajo site1, y el trabajo joba de la secuencia de trabajos sked5 en la

estación de trabajo site2:

schedule skedc on fr

follows site1#sked4,site2#sked5.joba

No iniciar sked6 hasta que jobx en la secuencia de trabajos skedx de la red remota

cluster4 se haya completado satisfactoriamente:

sked6 follows cluster4::site4#skedx.jobx

En el ejemplo siguiente se especifica no iniciar jobd hasta que joba en la misma

secuencia de trabajos y job3 en la secuencia de trabajos skeda se hayan

completado satisfactoriamente:

jobd follows joba,skeda.job3

En el ejemplo siguiente se especifica no iniciar jobe hasta que todos los trabajos de

la secuencia de trabajos skedb de la estación de trabajo unix1 se hayan completado

satisfactoriamente:

jobe follows unix1#skedb.@


freedays

Permite especificar el nombre del calendario de días libres (en la Guía del usuario

encontrará una descripción de los calendarios de días libres) que lista los días en

los que no debe ejecutarse la secuencia de trabajos. Tivoli Workload Scheduler

utiliza este calendario como base para calcular los días laborables de la secuencia de

trabajos.

La palabra clave sólo afecta a la planificación de las secuencias de trabajos para los

que se especifica.

Sinopsis

freedays nombre_calendario [-sa] [-su]

Argumentos

nombre_calendario

El nombre del calendario que debe utilizarse como calendario de días

libres para la secuencia de trabajos. Si el nombre_calendario no está en la

base de datos, Tivoli Workload Scheduler emite un mensaje de aviso

cuando se guarda la secuencia de trabajos. Si el nombre_calendario no está

en la base de datos al ejecutar el planificador, Tivoli Workload Scheduler

emite un mensaje de error y utiliza el calendario predeterminado holidays

en su lugar. No utilice los nombres de los días de la semana como nombres

de calendario.

-sa Considerar los sábados como días laborables.

-su Considerar los domingos como días laborables.

Notas sobre el uso

Si se ha especificado un calendario de días libres en la definición de la secuencia

de trabajos, la palabra clave workdays asumirá el siguiente valor: días laborables =

todos los días excluyendo sábados y domingos (a menos que se especifique -sa o -su

junto con freedays) y excluyendo todas las fechas de nombre_calendario

Si no se especifica freedays en la definición de secuencia de trabajos: workdays =

todos los días con excepción de sábado y domingo y todas las fechas del calendario

holidays.

De forma predeterminada, sábados y domingos se consideran días libres salvo que se

especifique lo contrario agregando -sa y -su después de nombre_calendario..

Ejemplos

Seleccionar la secuencia de trabajos sked2 para que se ejecute el 01/01/2001 y

todos los días laborables siempre y cuando que no estén listadas en el calendario

de días laborables GERMHOL.

schedule sked2

freedays GERMHOL

on 01/01/2001, workdays

Seleccionar la secuencia de trabajos sked3 para que se ejecute dos días laborables

antes de cada fecha en el calendario PAYCAL. Los días laborables son todos los

días de lunes a sábado, siempre y cuando no estén listados en el calendario de días

libres denominada USAHOL.

schedule sked3

freedays USAHOL -sa

on PAYCAL -2 workdays


Seleccionar la secuencia de trabajos sked3 en las fechas listadas en el calendario

APDATES. Si la fecha seleccionada es un día libre, no ejecutar la secuencia de

trabajos. En este ejemplo, se consideran días libres los domingos y todas las fechas

que aparecen en el calendario GERMHOL. Todos los días de lunes a sábado,

excepto las fechas específicas indicadas en GERMHOL, son días laborables.

schedule sked3

freedays GERMHOL -sa

on APDATES fdignore

Seleccionar la secuencia de trabajos testsked3 para que se ejecute cada día

laborable, excepto el 15/05/2002 y el 23/05/2002. Si el 23/05/2002 es un día libre,

no incluirlo. En este ejemplo, se consideran días libres los sábados, domingos y

todas las fechas que aparecen listadas en GERMHOL. Todos los días de lunes a

viernes, excepto las fechas específicas indicadas en GERMHOL, son días

laborables.

schedule testskd3

freedays GERMHOL

on weekdays

except 5/15/2002 fdignore

except 23/05/2002

Seleccionar la secuencia de trabajos testsked4 para que se ejecute cada día excepto

los dos días de la semana anteriores a cada fecha listada en el calendario

MONTHEND. Si la fecha que debe excluirse es un día libre, no incluirlo, aunque sí

se debe incluir el siguiente día laborable más cercano. En este ejemplo, los días

libres son todas las fechas listadas en USAHOL, mientras que son días laborables

todos los días de lunes a domingo que no están listados en USAHOL.

schedule testskd4

freedays USAHOL -sa -su

on everyday

except MONTHEND -2 weekdays fdnext


Sentencia de trabajo

Las sentencias de trabajo colocan trabajos en una secuencia de trabajos y definen

las dependencias de los trabajo. En una sentencia de trabajo, puede incluir también

atributos del trabajo y opciones de recuperación que agregan un nuevo trabajo en

la base de datos o modifican uno existente. Para obtener más información, consulte

las “Notas sobre el uso”.

Sinopsis

[esttrabajo#]nombretrabajo

[description “texto”]

[scriptname nombarchivo| docommand “líneacomandos”][streamlogon nombusuario]

[interactive]

[rccondsucc ″Condición éxito″]

[recovery {stop | continue | rerun}

[after [esttrabajo#]nombtrabajo]

[abendprompt “texto”] ]

[dependencia-trabajo [,...]]

Argumentos

esttrabajo


en la que se ejecuta el trabajo. El valor predeterminado es la estación de

trabajo en la que se ejecuta la secuencia de trabajos. El signo numérico (#)

es un delimitador obligatorio. Si especifica una clase de estación de trabajo,

ésta debe coincidir con la clase de estación de trabajo de todas las

secuencias de trabajos en la que se incluye el trabajo.

nombretrabajo

Especifica el nombre del trabajo. El nombre debe empezar con una letra y

puede contener caracteres alfanuméricos, guiones y subrayados. Puede

contener hasta 40 caracteres.

Nota: No utilice la palabra recovery como nombre de trabajo. Está

reservada.

descripción

Una descripción de formato libre del trabajo, indicada entre comillas.

scriptname nombarchivo

Especifica el nombre del archivo que el trabajo ejecuta. Utilice scriptname

para trabajos en UNIX y Windows. Para un archivo ejecutable, especifique

el nombre de archivo y todas las opciones y argumentos aplicables. La

longitud de nombarchivo más la longitud de Condición éxito (de la palabra

clave rccondsucc) no debe exceder de 4095 caracteres. También puede

utilizar parámetros de IBM Tivoli Workload Scheduler. Para obtener más

información, consulte el apartado “Utilización de parámetros en


Para trabajos de Windows, incluya las extensiones de archivo. Se permiten

nombres UNC (Convenio de denominación universal). No especifique

archivos de unidades correlacionadas.

Si se incluyen espacios o caracteres especiales, que no sean barras

inclinadas (/) y barras inclinadas invertidas (\), la serie entera debe

indicarse entre comillas (″).


Si el nombre de archivo contiene espacios en blanco, entre el nombre en

otro archivo cuyo nombre no contenga espacios y utilice el nombre del

segundo archivo en este argumento.

docommand comando

Especifica un comando que el trabajo ejecuta. Entre un comando válido y

las opciones y argumentos pertinentes entre comillas (″). La longitud de

comando más la longitud de Condición éxito (de la palabra clave rccondsucc)

no debe exceder de 4095 caracteres. Se ejecutará directamente un comando

y, a diferencia de scriptname, no se ejecutará el script de configuración,

jobmanrc. De lo contrario, el comando se trata como un trabajo y se le

aplican todas las normas de los trabajos. También puede entrar parámetros

de IBM Tivoli Workload Scheduler. Para obtener más información, consulte

el apartado “Utilización de parámetros en definiciones de trabajos” en la

página 110.

En los agentes tolerantes a errores basados en Windows, los trabajos

fallarán si la ruta del script/programa que se debe ejecutar contiene un

blanco. Por ejemplo, la sentencia

CMD.EXE /C "C:\ARCHIVOS DE PROGRAMA\CCR\CCR_CONSOLIDATE.BAT"

fallará, produciendo el mensaje siguiente:

El nombre

especificado no se reconoce como comando interno ni externo, programa

operable o archivo de proceso por lotes.

porque no se gestionan blancos en este contexto.

streamlogon

El nombre de usuario bajo el que se ejecuta el trabajo. El nombre puede

contener hasta 47 caracteres. Si contiene caracteres especiales, debe

escribirse entre comillas (″). Especifique un usuario que pueda iniciar la

sesión en la estación de trabajo en la que se ejecuta el trabajo. También

puede entrar parámetros de IBM Tivoli Workload Scheduler. Consulte el

apartado “Utilización de parámetros en definiciones de trabajos” en la

página 110.

Para trabajos de Windows, el usuario también debe tener una definición de

usuario. Para obtener más información sobre los requisitos de usuario,

consulte el apartado “Definiciones de usuario” en la página 53.

interactive

Para trabajos de Windows, incluya esta palabra clave para indicar que el

trabajo se ejecuta de forma interactiva en el escritorio de Windows.

rccondsucc ″Condición éxito″

Expresión que determina el código de retorno (RC) necesario para

considerar que un trabajo ha resultado satisfactorio. La longitud máxima

de la condición de éxito debe ser de 256 caracteres. Esta expresión puede

contener una combinación de expresiones booleanas y de comparación:

Expresión de comparación

Especifica los códigos de retorno del trabajo. La sintaxis es:

(RC operador operando)

RC La palabra clave RC.

operador

Operador de comparación. Puede tener los valores


siguientes:

Tabla 9. Operador de comparación

Ejemplo Operador Descripción

RC<a < Menor que

RC<=a <= Menor o igual que

RC>a > Mayor que

RC>=a >= Mayor o igual que

RC=a = Igual que

RC!=a != No igual que

RC<>a <> No igual que

operando

Un entero entre -2147483647 y 2147483647.


termina con un código de retorno menor o igual que 3, del modo

siguiente:

rccondsucc "(RC <= 3)"

Expresión booleana

Especifica una combinación lógica de expresiones de comparación.

La sintaxis es:

expresión_comparación operador expresión_comparación

expresión_comparación

La expresión se evalúa de izquierda a derecha. Puede

utilizar paréntesis para asignar una prioridad a la

evaluación de la expresión.

operador

Operador lógico. Puede tener los valores siguientes:

Tabla 10. Operadores lógicos

Ejemplo Operador Resultado

expr_a y expr_b And TRUE si ambas expresiones,

expr_a y expr_b, son TRUE

(se cumplen).

expr_a o expr_b Or TRUE si cualquiera de las

expresiones, expr_a o expr_b,

es TRUE (se cumple).

No expr_a Not TRUE si la expresión expr_a

no es TRUE (no se cumple).


termina con un código de retorno menor o igual que 3 o con un

código de retorno no igual a 5, y menor que 10, del modo

siguiente:

rccondsucc "(RC<=3) OR ((RC!=5) AND (RC<10))"

recovery

Opciones de recuperación para el trabajo. El valor predeterminado es stop

sin ningún trabajo de recuperación ni ninguna solicitud de recuperación.


Entre una de las opciones de recuperación, stop, continue o rerun. A

continuación puede indicarse un trabajo de recuperación, una solicitud de

recuperación o los dos.

stop Si el trabajo finaliza de forma anómala, no continuar con el trabajo

siguiente.

continue

Si el trabajo finaliza de forma anómala, continuar con el trabajo

siguiente.

rerun Si el trabajo finaliza de forma anómala, volver a ejecutar el trabajo.

after [esttrabajo#]nombtrabajo

Especifica el nombre de un trabajo de recuperación que se ejecutará

si el trabajo padre finaliza de forma anómala. Los trabajos de

recuperación se ejecutan una sola vez para cada instancia del

trabajo padre que finaliza de forma anómala.

Puede especificar la estación de trabajo del trabajo de recuperación

si es distinta de la estación de trabajo del trabajo padre. El valor

predeterminado es la estación de trabajo del trabajo padre. No

todos los trabajos pueden tener trabajos de recuperación que se

ejecuten en una estación de trabajo distinta. Siga estas directrices:

v Si cualquiera de las dos estaciones de trabajo es un agente

ampliado, debe estar en un gestor de dominio o en un agente

tolerante a errores con el valor on en fullstatus.

v La estación de trabajo del trabajo de recuperación debe estar en

el mismo dominio que la estación de trabajo del trabajo padre.

v Si la estación de trabajo del trabajo de recuperación es un agente

tolerante a errores, debe tener el valor on en fullstatus.


Especifica el texto de una solicitud de recuperación, indicado entre

comillas, que se visualizará si el trabajo finaliza de forma anómala.

El texto puede contener hasta 64 caracteres. Si el texto empieza con

dos puntos (:), se muestra la solicitud pero no es necesaria ninguna

respuesta para continuar con el proceso. Si el texto empieza con un

signo de exclamación (!), la solicitud no se visualiza pero es

necesaria una respuesta para continuar.

dependencia-trabajo

Especifica palabras clave y argumentos de planificación. Las palabras clave

válidas para los trabajos son: at, confirmed, every, follows, needs, opens,

priority, prompt y until.

Utilización de parámetros en definiciones de trabajos: A continuación se

muestran los usos y las limitaciones de los parámetros en las definiciones de

trabajos:

v Se permiten los parámetros en los valores streamlogon, scriptname y

docommand.

v Un parámetro puede utilizarse como una serie entera o como parte de la misma.

v Se permiten varios parámetros en una sola variable.

v Indique los nombres de parámetros entre signos de intercalación (^) y la serie

entera entre comillas.


En el ejemplo siguiente se muestra un parámetro llamado mis que se utiliza en el

valor streamlogon. Si desea ver más ejemplos, consulte el apartado “Definiciones

de parámetros” en la página 57.

Notas sobre el uso

Un trabajo debe definirse una sola vez en la base de datos, y puede utilizarse en

múltiples secuencias de trabajos. Cuando se agrega o modifica una secuencia de

trabajos, también se agregan o modifican los atributos u opciones de recuperación

de sus trabajos.

Al definir trabajos, se debe tener presente lo siguiente:

v Los trabajos se pueden definir por separado (como se describe en el apartado

“Definiciones de trabajo” en la página 47) o como parte de secuencias de trabajo.

En cualquiera de los dos casos, los cambios se efectúan en la base de datos y no

afectan al plan de producción hasta el inicio de un nuevo día de proceso.

v Al agregar o sustituir una secuencia de trabajos, todas las modificaciones en los

trabajos afectarán a todas las demás secuencias de trabajos que utilicen los

trabajos. Tenga en cuenta que puede utilizar el Informe de referencias cruzadas

para determinar los nombres de las secuencias de trabajos en las que está

incluido un determinado trabajo.

Ejemplos

En el siguiente ejemplo se define una secuencia de trabajos con tres trabajos

definidos previamente:

schedule bkup on fr at 20:00 :

cpu1#jbk1

cpu2#jbk2

needs 1 tape

cpu3#jbk3

follows jbk1

end

La siguiente definición de secuencia de trabajos contiene sentencias de trabajo que

agregan o modifican las definiciones de dos trabajos en la base de datos:

schedule sked4 on mo :

job1 scriptname “d:\apps\maestro\scripts\jcljob1”

streamlogon jack

recovery stop abendprompt “continue production”

site1#job2 scriptname “d:\apps\maestro\scripts\jcljob2”

streamlogon jack

follows job1

end


keyjob

La palabra clave keyjob se utiliza para marcar un trabajo como clave o crítico tanto

en la base de datos como en el plan diario, y para que lo supervisen las

aplicaciones, como por ejemplo Tivoli Business Systems Manager. Para obtener más

información sobre cómo habilitar el mecanismo del distintivo clave, consulte la

publicación IBM Tivoli Workload Scheduler - Guía de planificación e instalación.

Ejemplos

El ejemplo siguiente

SCHEDULE cpu1#sched1

ON everyday

KEYSCHED

AT 0100

cpu1#myjob1 KEYJOB

END


keysched

La palabra clave keysched se utiliza para marcar una secuencia de trabajos como

clave o crítica tanto en la base de datos como en el plan diario, y para que la

supervisen las aplicaciones, como por ejemplo Tivoli Business Systems Manager.

Para obtener más información sobre cómo habilitar el mecanismo del distintivo

clave, consulte la publicación IBM Tivoli Workload Scheduler - Guía de planificación e

instalación.

Sinopsis

keysched

Ejemplos

El ejemplo siguiente:

SCHEDULE cpu1#sched1

ON everyday

KEYSCHED

AT 0100

cpu1#myjob1 KEYJOB

END


limit

Limita el número de trabajos que se pueden ejecutar simultáneamente en una


Sinopsis

limit límitetrabajos

Argumentos

límitetrabajos Especifica el número de trabajos que pueden ejecutarse al mismo

tiempo en la planificación. Los valores posibles son del 0 a 1024. Si

se especifica 0, se impide que se inicien todos los trabajos.

Ejemplos

En el siguiente ejemplo se limita a cinco el número de trabajos que se pueden

ejecutar simultáneamente en la secuencia de trabajos sked2:

schedule sked2 on fr

limit 5 :


needs

Define los recursos que deben estar disponibles antes de iniciar un trabajo o una


Sinopsis

needs [n] [esttrabajo#]nombrerecurso [,...]

Argumentos

n Especifica el número de unidades de recurso necesarias. Los

valores posibles son del 0 al 32. El valor predeterminado es uno.

Nota: El número de trabajos y planificaciones que utilicen un

recurso a la vez no puede exceder de 32.

esttrabajo Especifica el nombre de la estación de trabajo en la que está

definida localmente el recurso. El valor predeterminado es la

estación de trabajo del trabajo o secuencia de trabajos dependiente.

Los recursos los pueden utilizar como dependencias únicamente

los trabajos y las secuencias de trabajos que se ejecuten en la

misma estación de trabajo que el recurso. No obstante, un agente

estándar y su host pueden hacer referencia a los mismos recursos.

nombrerecurso Especifica el nombre del recurso.

Ejemplos

En el ejemplo siguiente se impide que la secuencia de trabajos sked3 se inicie hasta

que estén disponibles tres unidades de cputime y dos unidades de tapes:


needs 3 cputime,2 tapes :

El recurso jlimit se ha definido con dos unidades disponibles: En el ejemplo

siguiente se permite no se ejecuten simultáneamente más de dos trabajos en la

secuencia de trabajos sked4:

schedule sked4 on mo,we,fr :

joba needs 1 jlimit

jobb needs 1 jlimit

jobc needs 2 jlimit <<se ejecuta en solitario>>

jobd needs 1 jlimit

end


on

Esta es una palabra clave de secuencia de trabajos necesaria que define cuándo y

con qué frecuencia se selecciona una secuencia de trabajos para su ejecución. La

palabra clave on debe ir a continuación de la palabra clave schedule. Para obtener

más información, consulte el apartado “except” en la página 101.

Sinopsis

on {fecha| día | calendario |petición}[,...] [fdignore | fdnext | fdprev][,...]

[on {fecha| día | calendario | petición}[,...] [fdignore | fdnext | fdprev]][,...]

Argumentos

fecha Especifica una fecha en el formato dd/mm/aa.

día Un día de la semana. Puede especificar una o varias de las siguientes

opciones:

mo Lunes

tu Martes

we Miércoles

th Jueves

fr Viernes

sa Sábado

su Domingo

weekdays

Todos los días salvo sábados y domingos.

everyday

Todos los días de la semana.

workdays

Puede ser una de las posibilidades siguientes:

v Si se ha especificado un calendario de días libres, los días


(a menos que se especifique -sa o -su junto con la palabra clave

freedays) y de todas las fechas del calendario de días libres

especificados.

v Si no se ha especificado un calendario de días libres, los días


y de todas las fechas del calendario holidays.freedays

Los días marcados en el calendario de días libres, si ha

especificado una.

calendario

Las fechas especificadas en un calendario con este nombre. El nombre del

calendario puede ir seguido de un desplazamiento en el formato siguiente:

{+ | -}n {day[s] | weekday[s] | workday[s]}

Donde:

n El número de días, días de la semana o días laborables.

days Representa todos los días de la semana.

weekdays

Representa todos los días de la semana. a excepción de sábado y

domingo.

workdays



domingo (salvo que se especifique otra cosa mediante la palabra

clave freedays) y las fechas marcadas en un calendario de días

libres designado o en el calendario holidays.

request

Selecciona la secuencia de trabajos sólo cuando se solicita. Se utiliza para

las secuencias de trabajos que se seleccionan por el nombre en lugar de por

la fecha. Para impedir que una secuencia de trabajos planificada se

seleccione para Jnextday, cambie la definición de la misma por ON

REQUEST.

Nota: Cuando intente ejecutar una secuencia de trabajos que contiene

horas ″on request″, considere lo siguiente:

v ″On request″ siempre tiene prioridad sobre ″at″.

v ″On request″ nunca tiene prioridad sobre ″on″.

regla para días libres

Especifica una regla que debe aplicarse cuando la fecha seleccionada cae en

un día libre. Puede ser una de las siguientes:

fdignore

No ejecutar la secuencia de trabajos.

fdnext Ejecutar la secuencia de trabajos en el siguiente día laborable más

cercano posterior al día libre.

fdprev

Ejecutar la secuencia de trabajos en el día laborable más cercado

anterior al día libre.

Notas sobre el uso

Se pueden definir varias instancia de la palabra clave on para la misma secuencia

de trabajos. Cada instancia equivale a un ciclo de ejecución al que se puede asociar

una regla de día libre.

Para indicar varias instancias on éstas deben indicarse de forma consecutiva en

definición de secuencias de trabajos.

Cada instancia de la palabra clave puede contener cualquiera de los valores que la

sintaxis on permite.

Debe especificar la palabra clave on como mínimo una vez en la definición de una


Ejemplos

En el siguiente ejemplo se selecciona la secuencia de trabajos sked1 para que se

ejecute los lunes y los miércoles:

schedule sked1 on mo,we


ejecute el 15 de junio de 1999, y en las fechas indicadas en el calendario apdates:

schedule sked3 on 15/06/99,apdates


ejecute dos días de la semana antes de cada fecha que aparece en el calendario

monthend:

schedule sked4 on monthend -2 weekdays


||||||

||

|

|

|


ejecute todos los días excepto los miércoles:


except we


ejecute todos los días excepto el 15 de mayo de 1999 y el 24 de mayo de 1999:


except 05/16/99,05/24/99


ejecute todos los días excepto dos días de la semana antes de cualquier fecha que

aparezca en el calendario monthend:

schedule testskd4 on everyday

except monthend -2 weekdays

Seleccionar la secuencia de trabajos sked1 para que se ejecute todos los lunes, los

viernes y el 29/12/2001. Si los lunes y el 29/12/2001 son días libres, ejecutar la

secuencia de trabajos el siguiente día laborable más cercano. Si los viernes son días

libres, ejecutar la secuencia de trabajos el día anterior más cercano. En este

ejemplo, los días libres son los sábados, los domingos y todas las fechas indicadas

en el calendario predeterminado HOLIDAYS. Los días laborables son todos los días

de lunes a viernes, siempre y cuando no estén listados en HOLIDAYS.

schedule sked1

on mo, 29/12/2001 fdnext

on fr fdprev


opens

Especifica los archivos que deben estar disponibles antes de iniciar un trabajo o

una secuencia de trabajos.

Sinopsis

opens [esttrabajo#]″nombarchivo″ [(calificador)] [,...]

Argumentos

esttrabajo

Especifica el nombre de la estación de trabajo o de la clase de estación de

trabajo en la que existe el trabajo. El valor predeterminado es la estación de

trabajo o la clase de estación de trabajo del trabajo o la secuencia de

trabajos dependiente. Si utiliza una clase de estación de trabajo, debe ser la

misma que la de la secuencia de trabajos que incluye esta sentencia.

nombarchivo

Especifica el nombre del archivo, entre comillas. Los parámetros de IBM

Tivoli Workload Scheduler pueden utilizarse como la serie de nombre de

archivo entera o parte de la misma. Si utiliza un parámetro, debe escribirse

entre signos de intercalación (^).

El nombre de archivo tiene que estar completamente calificado para todos

los tipos de estación de trabajo a excepción de los agentes ampliados (XA),

en que esto no es requisito:

calificador

Especifica una condición de prueba válida. En UNIX, el calificador se pasa

a un comando test, que se ejecuta como root en bin/sh.

En Windows, la función test se realiza como usuario maestro. Los

calificadores válidos son:

-d %p Verdadero si el archivo existe y es un directorio.

-e %p Verdadero si el archivo existe.

-f %p Verdadero si el archivo existe y es un archivo regular.

-r %p Verdadero si el archivo existe y se puede leer.

-s %p Verdadero si el archivo existe y su tamaño es mayor que

cero.

-w %p Verdadero si el archivo existe y se puede grabar.

Tanto en UNIX como en Windows, la expresión %p inserta el nombre del

archivo.

Si se entra (notempty) es lo mismo que si se entra (-s %p). Si no se

especifica ningún calificador, el valor predeterminado es (-f %p).

Notas sobre el uso

La combinación de la ruta del archivo y los calificadores no puede exceder de 120

caracteres, y el nombre del archivo no puede exceder de 28 caracteres.

Ejemplos

En el siguiente ejemplo se comprueba que el archivo

c:\users\fred\datafiles\file88 de la estación de trabajo nt5 está disponible para

acceso de lectura antes de iniciar ux2#sked6:

schedule ux2#sked6 on tu opens nt5#"c:\users\fred\datafiles\file88"


||

En el siguiente ejemplo se comprueba que los tres directorios, /john, /mary y

/roger, existan antes de iniciar el trabajo jobr2:

jobr2 opens "/users"(-d %p/john -a -d %p/mary -a -d %p/roger)

En el siguiente ejemplo se comprueba que cron haya creado su archivo FIFO antes

de iniciar el trabajo job6:

job6 opens "/usr/lib/cron/FIFO"(-p %p)

En el siguiente ejemplo se comprueba que el archivo d:\work\john\execit1 de la

estación de trabajo dev3 exista y no esté vacío antes de ejecutar el trabajo jobt2:

jobt2 opens dev3#"d:\work\john\execit1"(notempty)

En el siguiente ejemplo se comprueba que el archivo c:\tech\checker\startf de la

estación de trabajo nyc exista con un tamaño mayor que cero y que pueda grabarse

en él, antes de iniciar el trabajo job77:

job77 opens nyc#"C:\tech\checker\startf"(-s %p -a -w %p)

Seguridad para los comandos test(1): En UNIX, una función de seguridad

especial impide un uso no autorizado de otros comandos en el calificador. Por

ejemplo, el archivo que se muestra a continuación contiene un comando en el

calificador:

/users/xpr/hp3000/send2(-n "’ls /users/xpr/hp3000/m*’" -o -r %p)

Si el calificador contiene otro comando, se llevan a cabo las siguientes

comprobaciones:

1. La opción local jm que no sea para root debe tener el valor no.

2. En el archivo de seguridad, el usuario que documenta la planificación o agrega

la dependencia Abrir archivos con un comando addep de Conman, debe tener

acceso para someter a un trabajo con los atributos siguientes:

name=cmdstest.fileeq

logon=root

jcl=la ruta de los archivos Opens

cpu=la CPU en que residen los archivos Opens

Tenga en cuenta que cmdstest y fileeq no existen.


priority

Establece la prioridad de un trabajo o secuencia de trabajos.

Sinopsis

priority número | hi | go

Argumentos

número Especifica la prioridad. Los valores posibles son del 0 al 99. Una

prioridad de cero impide que el trabajo o la secuencia de trabajos

se inicie.

hi El equivalente de la prioridad 100.

go El equivalente de la prioridad 101, la prioridad más alta.

Ejemplos

En el siguiente ejemplo se muestra la relación entre las prioridades de secuencias

de trabajos y de trabajos. Los trabajos se inician en el siguiente orden: job1, job2,

joba, jobb.

schedule sked1 on tu

priority 50

:

job1 priority 15

job2 priority 10

end


priority 10

:

joba priority 60

jobb priority 50

end

Si las prioridades de secuencias de trabajos fueran las mismas, los trabajos se

iniciarían en el siguiente orden: joba, jobb, job1, job2.


prompt

Especifica las solicitudes a las que se debe responder afirmativamente para que un

trabajo o una secuencia de trabajos pueda iniciarse.

Sinopsis

prompt nombsolicitud [,...]

prompt ″[: | !]texto″ [...]

Argumentos

nombsolicitud Especifica el nombre de una solicitud de la base de datos.

texto Especifica una solicitud literal como una serie de texto indicada

entre comillas (″). Para los mensajes largos se pueden utilizar

varias series separadas por una barra inclinada invertida y una

letra n (\n). Si la serie empieza con dos puntos (:), se muestra el

mensaje pero no es necesaria ninguna respuesta. Si la serie

empieza con un signo de exclamación (!), el mensaje no se muestra

pero requiere una respuesta. Puede incluir una barra inclinada

invertida y una n (\n) dentro del texto para crear nuevas líneas.

Puede utilizar uno o más parámetros como la serie de texto o

como parte de ella. Para utilizar un parámetro, especifique el

nombre del parámetro entre signos de intercalación (^).

Nota: Dentro de una solicitud local, cuando no se designa ningún

parámetro, los signos de intercalación (^) deben ir

precedidos de una barra inclinada invertida (\) o se

producirán errores en la solicitud. Dentro de las solicitudes

globales, los signos de intercalación no tienen que ir

precedidos por una barra inclinada invertida.

Ejemplos

En el siguiente ejemplo se muestran las solicitudes literales y las solicitudes con

nombre. La primera solicitud es una solicitud literal que utiliza un parámetro

llamado sys1. Cuando se recibe una sola respuesta afirmativa para la solicitud con

nombre apmsg, se satisfacen las dependencias para job1 y job2.

schedule sked3 on tu,th

prompt "¿Todos los usuarios ap han finalizado la sesión en ^sys1^? (s/n)"

:

job1 prompt apmsg

job2 prompt apmsg

end

En el siguiente ejemplo define una solicitud literal que aparecerá en más de una

línea. Se define con una barra inclinada invertida y una n (\n) al final de cada

línea:


prompt "Los trabajos de esta secuencia de trabajos consumen\n

una gran cantidad de tiempo de CPU.\n

¿Desea iniciarla ahora? (s/n)"

:

j1

j2 follows j1

end


schedule

Especifica el nombre de la secuencia de trabajos. Con excepción de los comentarios,

debe ser la primera palabra clave en una secuencia de trabajos y debe ir seguida

de la palabra clave on.

Sinopsis

schedule [esttrabajo#]nombsecuenciatrab on ...

Argumentos

esttrabajo Especifica el nombre de la estación de trabajo en la que se inicia la

secuencia de trabajos. El valor predeterminado es la estación de

trabajo en la que Composer está agregando la secuencia de

trabajos.

nombsecuenciatrab

Especifica el nombre de la secuencia de trabajos. El nombre debe

empezar por una letra y puede contener caracteres alfanuméricos,

guiones y subrayados. Puede contener hasta 16 caracteres.

on

Especifica cuándo, o con qué frecuencia, se selecciona la secuencia

de trabajos para su ejecución. Para obtener más información,

consulte el apartado “on” en la página 116.

Ejemplos

En el siguiente ejemplo se especifica la secuencia de trabajos sked1 que se ejecuta

en la estación de trabajo en la que se está ejecutando Composer:


En el siguiente ejemplo se especifica la secuencia de trabajos sked-2 que se ejecuta

en la estación de trabajo en la que se está ejecutando Composer:

schedule sked-2 on everyday except fr

En el siguiente ejemplo se especifica la secuencia de trabajos skedux7 que se

ejecuta en la estación de trabajo hpux3:

schedule hpux3#skedux7 on monthend


until

Define la hora límite después de la cual un trabajo o secuencia de trabajos no se

iniciará.

Sinopsis

until hora [timezone|tz nombrehusohorario][+n day[s]] [onuntil acción]

Argumentos


0000 y 2359.

nombrehusohorario

Especifica el huso horario que se va a utilizar al calcular la hora. Para ver

los nombres de zonas horarias, consulte el Apéndice B, “Gestión de husos

horarios”, en la página 341. El valor predeterminado es el huso horario de

la estación de trabajo en la que se inicia el trabajo o la secuencia de

trabajos.

Nota: Si se especifica una hora final, until, y una hora de inicio, at, ambas

deben tener el mismo huso horario.

n Especifica un desplazamiento en días de la fecha y la hora planificadas.

onuntil acción

Especifica la acción que se debe emprender sobre un trabajo o una

secuencia de trabajos cuya hora especificada para until haya transcurrido,

pero si el trabajo o la secuencia de trabajos no se ha iniciado todavía. Los

valores posibles del parámetro acción son los siguientes:

suppr El estado de la secuencia de trabajos final es HOLD si la secuencia

de trabajos contiene por lo menos un trabajo every. De lo

contrario, el estado final se calcula utilizando las reglas normales, y

los trabajos con la opción onuntil suppr se consideran en estado

SUCC cuando se produce la hora until, aunque sus dependencias

no se hayan liberado en realidad.

cont El trabajo o la secuencia de trabajos se ejecuta cuando se cumplen

todas las condiciones necesarias, y se graba en el registro un

mensaje de notificación cuando transcurre la hora especificada para

until.

canc Un trabajo o una secuencia de trabajos se cancela cuando

transcurre la hora especificada para until. Cualquier trabajo o

secuencia de trabajos que dependiera de la terminación de un

trabajo o secuencia de trabajos que se ha cancelado se ejecutará,

puesto que la dependencia ya no existe.

Ejemplos

En el siguiente ejemplo se impide que sked1 se inicie los martes después de las

5:00 p.m.:

schedule sked1 on tu until 1700 :

El ejemplo siguiente inicia sked1 a las 5:00 p.m., cuando transcurre la hora

especificada para ″until″:

schedule sked1 until 1700 onuntil cont


|||||||

En el ejemplo siguiente se inicia job1 entre las 1:00 p.m. y las 5:00 p.m. todos los

días de la semana:

schedule sked2 on weekdays :

job1 at 1300 until 1700

end

En el ejemplo siguiente se inicia joba cada 15 minutos los lunes entre las 10:30

p.m. y las 11:30 p.m.:

schedule sked3 on mo :

joba at 2230 every 0015 until 2330

end

En el ejemplo siguiente se inicia la secuencia de trabajos sked4 los domingos entre

las 8:00 a.m. y la 1:00 p.m. Los trabajos se deben iniciar dentro de este intervalo:

schedule sked4 on fr at 0800 + 2 days

until 1300 + 2 days

:

job1

job2 at 0900 <<iniciado en domingo>>

job3 follows job2 at 1200 <<iniciado en domingo>>

end

El ejemplo siguiente inicia la secuencia de trabajos sked8 los días de la semana a

las 4:00 p.m. y se tiene que haber terminado de ejecutar a las 5 p.m. Si la secuencia

de trabajos no ha terminado a las 5 p.m., se considera una secuencia de trabajos

tardía. Los trabajos se deben iniciar del modo siguiente: job1 se ejecuta a las 4 p.m.

o, como máximo, a las 4:20 p.m., hora en que, si job1 todavía no ha comenzado, se

grabará un mensaje de notificación en el registro y se empezará a ejecutar. job2 se

ejecuta a las 4:30 p.m. o, como máximo, a las 4:50 p.m., hora en que, si job2

todavía no se ha iniciado, se cancelará.

schedule sked8 on weekdays at 1600 deadline 1700 :

job1 at 1600 until 1620 onuntil cont

job2 at 1630 until 1650 onuntil canc

end

En el ejemplo siguiente se inicia la secuencia de trabajos sked01: Cuando se

produce el evento until, la secuencia de trabajos sked02 se ejecuta porque la

secuencia de trabajos sked01 se pone en estado SUCC. En cambio, la secuencia de

trabajos sked03 no se ejecuta porque tiene una dependencia de hora puntual

respecto al trabajo job01 que no se ha liberado.

SCHEDULE sked01 on everyday:

job01 until 2035 onuntil suppr

end

SCHEDULE sked02 on everyday follows sked01.@

:

job02

end

SCHEDULE sked03 on everyday follows sked01.JTEST

:

job03

END


|||||

|||

||||

||||

Capítulo 5. Consulta de Conman

El programa de línea de comandos Conman gestiona el entorno del plan de

producción de IBM Tivoli Workload Scheduler. Conman se utiliza para iniciar y

detener procesos, modificar y mostrar el plan de producción (Symphony) así como

para controlar el proceso de vinculación de estaciones de trabajo en una red. En

este capítulo se suministra información acerca de lo siguiente:

v Cómo ejecutar Conman.

v Cómo seleccionar y calificar trabajos y secuencias de trabajos.

v La sintaxis y el uso de los comandos de Conman.

Ejecución de Conman

Para ejecutar el Conman, entre el siguiente comando:

conman [“command[&...][&]"]

Ejemplos

En el siguiente ejemplo, Conman se inicia y solicita un comando:

conman

En el siguiente ejemplo, Conman ejecuta los comandos sj y sp y luego sale:

conman"sj&sp"

En el siguiente ejemplo, Conman ejecuta los comandos sj y sp, y luego solicita un

comando:

conman"sj&sp&"

En el siguiente ejemplo, Conman lee los comandos del archivo cfile:

conman < cfile

En el siguiente ejemplo, los comandos del archivo cfile se dirigen a Conman:

cat cfile | conman

Caracteres de control

Entre los siguientes caracteres de control para interrumpir Conman.

Control+c

Conman detiene la ejecución del comando actual en el siguiente paso que

puede interrumpirse y vuelve al indicador de comandos.

Control+d

Conman finaliza después de ejecutar el comando actual.

Ejecución de comandos del sistema

Cuando se entra un comando del sistema con una barra o un prefijo de comando

del sistema (: o !), lo ejecuta un proceso hijo. El ID de usuario activo del proceso

hijo se establece en el ID del usuario que ejecuta Conman para impedir que se

produzcan infracciones de seguridad.


Emisión de mensajes de solicitud al usuario

Cuando se utilizan caracteres comodín para seleccionar los objetos sobre los que

actuará un comando, Conman solicita la confirmación después de encontrar cada

objeto coincidente. Si se responde sí se lleva a cabo la acción y si se responde no se

ignora el objeto sin realizar la acción.

Cuando Conman se ejecuta de forma interactiva, las solicitudes de confirmación se

emiten en su sistema. Si se pulsa la tecla Intro en respuesta a una solicitud se

interpretará como una respuesta no. La emisión de mensajes de solicitud puede

inhabilitarse incluyendo la opción ;noask en un comando.

Aunque no se emitan solicitudes de conformación cuando Coman no se está

ejecutando en modalidad interactiva, se actuará como si se hubiera respondido no

en cada caso, y no se lleva a cabo ninguna acción sobre ningún objeto. Por lo tanto,

es importante incluir la opción ;noask en los comandos cuando Conman no se

ejecuta en modalidad interactiva.

Salida de terminal

La salida del sistema la especifican las variables del shell, MAESTROLINES y

MAESTROCOLUMNS. Si no están establecidas, se utilizarán las variables del shell

estándar, LINES y COLUMNS. Las variables pueden establecerse del modo

siguiente:

$MAESTROLINES

Especifica el número de líneas por pantalla. El valor predeterminado es 24.

Al final de cada página que aparece en pantalla, Conman le solicita

continuar. Si MAESTROLINES (o LINES) se establece en cero o en un

número negativo, Conman no hace una pausa al final de la página.

$MAESTROCOLUMNS


80.

$MAESTRO_OUTPUT_STYLE

Especifica el método de visualización de nombres de objetos. Si se

establece en LONG, se mostrarán los nombres completos. Si no se

establece o se establece en cualquier valor distinto de LONG, los nombres

largos se truncan en ocho caracteres seguidos de un signo más (+).

Salida fuera de línea

La opción ;offline en los comandos de Conman se suele utilizar para imprimir la

salida de un comando. Cuando se incluye, las siguientes variables del shell

controlan la salida:

$MAESTROLP

Especifica el destino de la salida de un comando. Entre una de las

siguientes opciones:

> archivo

Redirige la salida a un archivo y graba encima del contenido del


>> archivo

Redirige la salida a un archivo y añade la salida al final del



| comando


del sistema se ejecuta tanto si se genera salida como si no se

genera.

|| comando


del sistema no se ejecuta si no hay salida.

El valor predeterminado es | lp -tCONLIST que dirige la salida del

comando a la impresora con el título “CONLIST” en la página de mensaje

de cabecera de la salida impresa.

$MAESTROLPLINES


$MAESTROLPCOLUMNS


132.

Las variables deben exportarse antes de ejecutar Conman.

Selección del indicador de comandos de Conman

De forma predeterminada, el indicador de comandos de Conman es un signo de

porcentaje (%). Se define en el archivo TWShome/localopts. El indicador de

comandos predeterminado es un guión (-). Para seleccionar uno distinto, edite la

opción de indicador de Composer en el archivo localopts y cambie el signo de

porcentaje. El indicador puede tener como máximo diez caracteres, sin incluir el

signo numérico de cola necesario (#).

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

# Personalizar atributos de formato

#

date format = 1 # Los valores posibles son 0-amd, 1-mda,

2-dma, 3-NLS.

composer prompt = -

conman prompt = %

switch sym prompt = <n>%

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


Los comandos de Conman están formados por los siguientes elementos:

nombrecomando selección argumentos

donde:

nombrecomando

Especifica el nombre del comando.

selección

Especifica el objeto o conjunto de objetos en los que se debe realizar una

acción.

argumentos

Especifica los argumentos de comandos.

A continuación se muestra un ejemplo de un comando de Conman:

sj sked1.@+state=hold~priority=0;info;offline

Capítulo 5. Consulta de Conman 129

donde:

sj La forma abreviada del comando showjobs.

sked1.@+state=hold~priority=0

Selecciona todos los trabajos de la secuencia de trabajos sked1 que están en

el estado hold con una prioridad distinta de cero.

;info;offline

Argumentos del comando showjobs.

Caracteres comodín

Se aceptan los siguientes caracteres comodín:

@ Sustituye uno o más caracteres alfanuméricos.



Delimitadores y caracteres especiales

Los siguientes caracteres tienen un especial significado en los comandos de

Conman:


& Delimitador de comando. Consulte el apartado “Ejecución de Conman” en la

página 127.

+ Delimitador utilizado para seleccionar objetos para comandos. Añade un

atributo que el objeto debe tener. Por ejemplo:

sked1.@+priority=0

~ Delimitador utilizado para seleccionar objetos para comandos. Añade un

atributo que el objeto no debe tener. Por ejemplo:

sked1.@~priority=0

; Delimitador de argumento. Por ejemplo:

;info;offline

, Delimitador de repetición y de rango. Por ejemplo:

state=hold,sked,pend

= Delimitador de valor. Por ejemplo:

state=hold

: ! Prefijos de comandos que pasan el comando al sistema. Estos prefijos son

opcionales; si Conman no reconoce el comando, lo pasa automáticamente al

sistema. Por ejemplo:

!ls o :ls

<<>> Corchetes angulares de comentarios. Por ejemplo:

sj @#@.@ <<comentario>>

* Prefijo de comentario. El prefijo debe ser el primer carácter en una línea de

comandos o indicarse a continuación de un delimitador de comandos. Por

ejemplo:

*comentario

o

sj& *comentario


|


> Redirige la salida del comando a un archivo y graba encima del contenido del

archivo. Si el archivo no existe, se crea. Por ejemplo:

sj> joblist

>> Redirige la salida del comando a un archivo y añade la salida al final del

archivo. Si el archivo no existe, se crea. Por ejemplo:

sj >> joblist

| Dirige la salida del comando a un proceso o comando del sistema. El

comando del sistema se ejecuta tanto si se genera salida como si no se genera.

Por ejemplo:

sj| grep ABEND

|| Dirige la salida del comando a un proceso o comando del sistema. El

comando del sistema no se ejecuta si no hay salida. Por ejemplo:

sj || grep ABEND

Lista de comandos

En la siguiente tabla se lista el conjunto de comandos de Conman. Los nombres de

comandos y las palabras clave pueden especificarse tanto en mayúsculas como en

minúsculas, y se pueden abreviar a unos pocos caracteres iniciales necesarios para

distinguirlos entre sí. Algunos de los nombres de comandos también tienen formas

abreviadas.

Comando

Forma

abreviada Descripción Tipo1 Página

adddep adj | ads Agrega dependencias de

trabajos o secuencias de

trabajos.

M,F 149, 151

altpass Modifica una contraseña de

definición de un objeto de

usuario.

M,F 153

altpri ap Modifica las prioridades de

trabajo o secuencia de trabajos.

M,F 154

cancel cj | cs Cancela un trabajo o una


M,F 163, 157

confirm Confirma la finalización de un

trabajo.

M,F 159

console Asigna la consola de IBM


M,F,A 161

continue Ignora el siguiente error. M,F,A 162

deldep ddj | dds Suprime dependencias de


trabajos.

M,F 181, 165

display df | dj |

ds

Muestra archivos, trabajos y

secuencias de trabajos.

M,F,A2 167

exit Finaliza la ejecución de

Conman.

M,F,A 168

fence Establece la delimitación de

trabajos de IBM Tivoli

Workload Scheduler.

M,F,A 169


Comando

Forma


help5 Muestra información de

comandos.

M,F,A 171

kill Detiene la ejecución de un

trabajo.

M,F 172

limit lc | ls Modifica el límite de trabajos

de una estación de trabajo o de

una secuencia de trabajos.

M,F,A3 173, 174

link lk Abre vínculos de estación de

trabajo.

M,F,A 175

listsym Muestra una lista de archivos

de registro de Symphony.

M,F 177

recall rc Muestra mensajes de solicitud. M,F 178

redo Edita el comando anterior. M,F,A 179

release rj | rs Libera dependencias de


trabajos.

M,F 155, 183

reply Responde a un mensaje de

solicitud.

M,F 185

rerun rr Vuelve a ejecutar un trabajo. M,F 186

resource Cambia el número de unidades

del recurso.

M,F 189

setsym Selecciona un archivo de

registro de Symphony.

M,F 190

showcpus sc Muestra información de

estaciones de trabajo y

vínculos.

M,F,A 191

showdomain Muestra información de

dominios.

M,F,A 195

showfiles sf Muestra información sobre

archivos.

M,F 196

showjobs sj Muestra información sobre

trabajos.

M,F 198

showprompts sp Muestra información sobre

solicitudes.

M,F 207

showresources sr Muestra información sobre

recursos.

M,F 209

showschedules ss Muestra información sobre

secuencias de trabajo.

M,F 211

shutdown Detiene los procesos de

producción de IBM Tivoli

Workload Scheduler.

M,F,A 215

start Inicia los procesos de


Workload Scheduler.

M,F,A 216

status Muestra el estado de


Workload Scheduler.

M,F,A 218


Comando

Forma


stop Detiene los procesos de


Workload Scheduler.

M,F,A 219

stop ;progressive Detiene jerárquicamente los

procesos de producción de

IBM Tivoli Workload

Scheduler.

221

submit sbd |

sbf |

sbj |

sbs

Somete un comando, archivo,


M,F,A4 222,

224,

226,

228

switchmgr Conmuta el gestor de dominio. M,F 230

comando-sist Envía un comando al sistema. M,F,A 231

tellop to Envía un mensaje a la consola. M,F,A 232

unlink Cierra vínculos de estación de

trabajo.

M,F,A 233

version v Muestra el mensaje de

cabecera del programa de línea

de comandos Conman.

M,F,A 235

1. Tipos de estación de trabajo: gestores de dominio (M), agentes tolerantes a

errores (F), agentes estándar (A).

2. Los archivos sólo pueden mostrarse en un agente estándar.

3. Sólo se puede cambiar el límite de los trabajos activados en una estación de

trabajo de un agente estándar.

4. Puede utilizar submit job (sbj) y submit sched (sbs) en un agente estándar

sólo si el directorio mozart el agente estándar puede acceder al gestor de

dominio maestro.

5. No está disponible en plataformas Windows soportadas.

Selección de trabajos en comandos

Para los comandos que efectúan acciones en trabajos, los trabajos de destino se

seleccionan por medio de atributos y calificadores. A continuación se muestra la

sintaxis para la selección de trabajos, que se describe en detalle en las páginas

siguientes.

Sinopsis

[esttrabajo#] {secuenciatrab.trabajo | númerotrab} [+ | ~calificadortrab[...]]

o:

agentered::[esttrabajo#] secuenciatrab.trabajo

Argumentos

esttrabajo

Cuando se utiliza con secuenciatrab.trabajo, especifica el nombre de la

estación de trabajo en la que se ejecuta la secuencia de trabajos. Cuando se


utiliza con númerotrabajo, especifica la estación de trabajo en la que se

ejecuta el trabajo. Se permiten caracteres comodín.

secuenciatrab

Especifica el nombre de la secuencia de trabajos en la que se ejecuta el

trabajo. Se permiten caracteres comodín.

trabajo Especifica el nombre del trabajo. Se permiten caracteres comodín.

númerotrab

Especifica el número de trabajo.

calificadortrab

Consulte el apartado siguiente, “Calificadores de trabajos”.

agentered

Especifica el nombre del agente de red del planificador que intercambia

información con la red de planificador remota que contiene el trabajo de

destino. Los dos signos de dos puntos (::) son un delimitador obligatorio.

Se permiten caracteres comodín. Para obtener más información, consulte el

apartado Capítulo 9, “Consulta del Agente de red”, en la página 309.

Calificadores de trabajos

Los calificadores de trabajos especifican atributos de trabajos en los que los

comandos pueden realizar una acción. Llevan como prefijo un signo + o una ~. Un

signo + significa que los trabajos con el atributo califican al comando. Una ~

significa que los trabajos con el atributo se excluyen del comando.

Las palabras clave de calificadores de trabajos se pueden abreviar a unos pocos

caracteres iniciales necesarios para distinguirlas entre sí.

at[=hora | horamínima | horamáxima | horamínima,horamáxima [absolute | abs]]

Selecciona o excluye trabajos basándose en la hora de inicio planificada.

hora

Especifica la hora de inicio planificada expresada del modo

siguiente:

hhmm[+n days | fecha] [timezone|tz nombrehusohorario]

donde:

hhmm La hora y los minutos.

+n days

La siguiente ocurrencia de hhmm en n número de días.

fecha La siguiente ocurrencia de hhmm en fecha, expresada como

dd/mm/aa.


El nombre del huso horario del trabajo. Para obtener más

información sobre nombres válidos, consulte el Apéndice B,

“Gestión de husos horarios”, en la página 341.

hora se ajusta a las reglas siguientes:

v Cuando hhmm es anterior a la hora actual, la hora de inicio

corresponde a mañana; cuando hhmm es posterior a la hora

actual, la hora de inicio corresponde a hoy.


v Cuando hhmm es mayor que 2400, se divide por 2400. En el

resultado, la parte entera representa el número de + días,

mientras que la parte decimal representa las horas.

horamínima

Especifica el límite inferior de un rango de horas, expresado en el

mismo formato que hora. Se seleccionan trabajos que tienen las

horas de inicio planificadas a dicha hora o después de la misma.

horamáxima

Especifica el límite superior de un rango de horas, expresado en el

mismo formato que hora. Se seleccionan trabajos que tienen las

horas de inicio planificadas a dicha hora o antes de la misma.

absolute | abs

Especifica la hora de inicio planificada para el día actual. Esta

palabra clave sólo se puede utilizar con timezone|tz

nombrehusohorario y hhmm. Se ajusta a las reglas siguientes:

v Cuando hhmm es anterior a la hora actual, la hora de inicio es

inmediatamente.

v Cuando hhmm es posterior a la hora actual, la hora de inicio es

la hora del día actual especificada por hhmm.

v Cuando hhmm supera las 2400, se divide por 2400 para obtener

el día y la hora calculados. Del resultado de la división, la parte

entera representa el día calculado (el número de + días), mientras

que la parte decimal representa la hora calculada:

– Si la hora calculada es anterior a la hora actual, la hora de

inicio corresponde a un día antes del día calculado a la hora

calculada.

– Si la hora calculada es posterior a la hora actual, la hora de

inicio corresponde al día y la hora calculados.

Por ejemplo, si la hora actual es 1200 y se somete un trabajo a

las hhmm=3500 (2400 + 1100), especificando la palabra clave abs,

se activa el trabajo a las 1100 del día siguiente. En cambio, si no

se especifica la palabra clave abs, se activa el trabajo a las 1100,

dos días más tarde.

Si at se utiliza solo, el rango no tiene un límite fijo y los trabajos se

seleccionan o excluyen si tienen alguna hora de inicio planificada.

confirmed

Selecciona o excluye trabajos que se han planificado utilizando la palabra

clave confirm.

deadline[=hora | horamínima, | ,horamáxima | horamínima,horamáxima]

Especifica la hora en que se debe completar un trabajo.



+n days

Desplazamiento en días desde la hora límite planificada.


dd/mm/aa.


Especifica el huso horario que se va a utilizar al calcular el plazo

límite. Para ver los nombres de zonas horarias, consulte el


Apéndice B, “Gestión de husos horarios”, en la página 341. El valor

predeterminado es el huso horario de la estación de trabajo en la

que se inicia el trabajo o la secuencia de trabajos.

horamínima


mismo formato que hora. Se seleccionan trabajos que tienen plazos

límite planificados a esta hora o después de la misma.

horamáxima


mismo formato que hora. Se seleccionan trabajos que tienen plazos

límite planificados a esta hora o antes de la misma.

every[=frecuencia | frecuenciamínima, | ,frecuenciamáxima |

frecuenciamínima,frecuenciamáxima]

Selecciona o excluye trabajos basándose en si tienen o no una frecuencia de

repetición.

frecuencia

Especifica la frecuencia de ejecución planificada, expresada en

horas y minutos (hhmm).

frecuenciamínima

Especifica el límite inferior de un rango de frecuencias, expresado

en el mismo formato que frecuencia. Se seleccionan trabajos que

tienen frecuencias de repetición iguales o mayores que ésta.

frecuenciamáxima

Especifica el límite superior de un rango de frecuencias, expresado

en el mismo formato que frecuencia. Se seleccionan trabajos que

tienen frecuencias de repetición menores o iguales que ésta.

Si every se utiliza solo, el rango no tiene un límite fijo y los trabajos se

seleccionan o excluyen si tienen alguna frecuencia de repetición.

finished[=hora | horamínima, | ,horamáxima | horamínima,horamáxima]

Selecciona o excluye trabajos basándose en si éstos han finalizado o no.

hora Especifica la hora exacta a la que han finalizado los trabajos,

expresada del modo siguiente:

hhmm [fecha] [timezone|tz nombrehusohorario]



dd/mm/aa.





horamínima


mismo formato que hora. Se seleccionan trabajos que han finalizado

a esta hora o después de la misma.

horamáxima


mismo formato que hora. Se seleccionan trabajos que han finalizado

a esta hora o antes de la misma.


Si finished se utiliza solo, el rango no tiene un límite fijo y los trabajos se

seleccionan o excluyen si han terminado de ejecutarse.

follows[=[agentered::][[esttrabajo#] secuenciatrab.]trabajo[;nocheck][;wait=hora]]

Selecciona o excluye trabajos basándose en si tienen o no una dependencia

follows.

agentered

Especifica el nombre del agente de red del planificador que

intercambia información con la red de planificador remota que

contiene el trabajo de prerrequisito. Se permiten caracteres

comodín. Para obtener más información, consulte el Capítulo 9,

“Consulta del Agente de red”, en la página 309.

esttrabajo

Especifica el nombre de la estación de trabajo en la que se ejecuta

el trabajo de prerrequisito. Se permiten caracteres comodín.

secuenciatrab

Especifica el nombre de la secuencia de trabajos en la que se

ejecuta el trabajo de prerrequisito. Se permiten caracteres comodín.

Si se entra secuenciatrab.@, se especifica que el trabajo de destino

debe ir al final todos los trabajos de la secuencia de trabajos.

trabajo Especifica el nombre del trabajo de prerrequisito. Cuando se entra

sin una secuenciatrab, significa que el trabajo prerrequisito está en la

misma secuencia de trabajos como trabajo de destino. No

especifique el nombre de trabajo utilizando caracteres comodín

para una dependencia de continuación.

nocheck

Sólo es válido para los comandos sbd, sbj y sbs. Conman no

comprueba la existencia de trabajos requeridos previamente en

Symphony. Cuando Batchman procesa el comando submit, agrega

los argumentos del comando submit a Symphony (como, por

ejemplo, el trabajo que se debe someter) incluyendo las

dependencias de los trabajos requeridos previamente que existen

en Symphony. Para los trabajos requeridos previamente que no

existan en el archivo Symphony, Batchman imprime un aviso en

stdlist.

wait=hora

Sólo es válido para los comandos sbd, sbj y sbs. Para el intervalo

de tiempo especificado, Conman comprueba cada segundo la

existencia de los trabajos requeridos previamente en el archivo

Symphony. Conman realiza estas comprobaciones hasta que

encuentra los trabajos requeridos previamente o transcurre el

intervalo de tiempo especificado para la palabra clave wait.

Cuando se encuentran todos los trabajos requeridos previamente,

Batchman procesa el comando submit. Aunque no se encuentre en

Symphony uno sólo de los trabajos requeridos previamente y

transcurra el intervalo de tiempo, Conman no procesará el

comando submit y devolverá un mensaje de error. El número

máximo de segundos es 1200.

Si se especifica nocheck junto con wait, cuando transcurra el

intervalo de tiempo, Batchman procesará el comando submit

aunque uno sólo de los trabajos requeridos previamente no exista


en Symphony. El trabajo que se debe someter y los trabajos

requeridos previamente que existan en Symphony se agregará a

Symphony.

Si follows se utiliza solo, los trabajos se seleccionan o excluyen si tienen

alguna dependencia follows.

logon=nombusuario

Selecciona trabajos basándose en los nombres de usuario bajo los que se

ejecutan. Si nombusuario contiene caracteres especiales, debe escribirse entre

comillas (″). Se permiten caracteres comodín.

needs[=[esttrabajo#]nombrerecurso]


de recurso.

esttrabajo

Especifica el nombre de la estación de trabajo en la que está

definida el recurso. Se permiten caracteres comodín.

nombrerecurso

Especifica el nombre del recurso. Se permiten caracteres comodín.

Si needs se utiliza solo, los trabajos se seleccionan o excluyen si tienen

alguna dependencia de recurso.

opens[=[esttrabajo#]nombarchivo[(calificador)]]

Selecciona trabajos basándose en si tienen o no una dependencia de

archivo. Se produce una dependencia de archivo cuando un trabajo o una

secuencia de trabajos depende de la existencia de uno o más archivos para

que pueda comenzar su ejecución.

esttrabajo

Especifica el nombre de la estación de trabajo en la que existe el

archivo. Se permiten caracteres comodín.

nombarchivo

Especifica el nombre del archivo. El nombre debe estar entre

comillas (″) si contiene caracteres distintos de los siguientes:

alfanuméricos, guiones (-), barras inclinadas (/), barras inclinadas

invertidas (\) y subrayados (_). Se permiten caracteres comodín.

calificador

Condición de prueba válida. Si se omite, los trabajos se seleccionan

o se excluyen sin tomar en consideración un calificador.

Si opens se utiliza solo, los trabajos se seleccionan o excluyen si tienen

alguna dependencia de archivo. Se produce una dependencia de archivo

cuando un trabajo o una secuencia de trabajos depende de la existencia de

uno o más archivos para que pueda comenzar su ejecución.

priority=pri | primínima, | ,primáxima | primínima,primáxima

Selecciona o excluye trabajos basándose en sus prioridades.

pri Especifica el valor de prioridad. Puede entrar un valor de 0 a 99,

hi o go.

primínima

Especifica el límite inferior de un rango de prioridades. Se

seleccionan trabajos con prioridades iguales o mayores que este

valor.


primáxima

Especifica el límite superior de un rango de prioridades. Se

seleccionan trabajos con prioridades menores o iguales a este valor.

prompt[=nombsolicitud | númmensaje]


de solicitud.

nombsolicitud

Especifica el nombre de una solicitud global. Se permiten caracteres

comodín.

númmensaje

Especifica el número de mensaje de una solicitud local.

Si prompt se utiliza solo, los trabajos se seleccionan o excluyen si tienen

alguna dependencia de solicitud.

recovery=opción-recup

Selecciona o excluye trabajos basándose en sus opciones de recuperación.

opción-recup

Especifica la opción de recuperación de trabajo como stop,

continue o rerun.

scriptname=nombarchivo

Selecciona o excluye trabajos basándose en sus nombres de archivo

ejecutable.

nombarchivo

Especifica el nombre de un archivo ejecutable. El nombre debe

estar entre comillas (″) si contiene caracteres distintos de los

siguientes: alfanuméricos, guiones (-), barras inclinadas (/), barras

inclinadas invertidas (\) y subrayados (_). Se permiten caracteres

comodín.

started[=hora | horamínima, | ,horamáxima | horamínima,horamáxima]

Selecciona o excluye trabajos basándose en si se han iniciado o no.

hora Especifica la hora exacta a la que se han iniciado los trabajos,

expresada del modo siguiente:




dd/mm/aa.





horamínima


mismo formato que hora. Se seleccionan trabajos que se han

iniciado a esta hora o después de la misma.

horamáxima


mismo formato que hora. Se seleccionan trabajos que se han

iniciado a esta hora o antes de la misma.


Si started se utiliza solo, el rango no tiene un límite fijo y los trabajos se

seleccionan o excluyen si se han iniciado.

state=estado[,...]

Selecciona o excluye trabajos basándose en sus estados.

estado Especifica el estado actual del trabajo. Los estados válidos del

trabajo son los siguientes:

abend El trabajo ha terminado con un código de salida distinto de

cero.

abenp Se ha recibido una confirmación abend pero el trabajo no

se ha completado.

add Se está sometiendo el trabajo.

done El trabajo se ha completado en un estado desconocido.

error Sólo para dependencias inter-red, se ha producido un error

mientras se comprobaba el estado remoto.

exec El trabajo se está ejecutando.

extrn Sólo para dependencias inter-red, el estado es desconocido.

Se ha producido un error, se acaba de efectuar una acción

de reejecución en el trabajo de la secuencia de trabajos

externa o bien la secuencia de trabajos o el trabajo remoto

no existen.

fail No se puede iniciar el trabajo.

fence La prioridad del trabajo está por debajo de la delimitación.

hold El trabajo está esperando la resolución de dependencias.

intro Se da entrada al trabajo para que el sistema lo inicie.

pend El trabajo se ha completado y está en espera de

confirmación.

ready El trabajo está preparado para iniciarse y todas las

dependencias se han resuelto.

sched La hora at del trabajo no ha llegado.

succ El trabajo se ha completado con un código de salida de

cero.

succp Se ha recibido una confirmación succ pero el trabajo no se

ha completado.

wait El trabajo está en estado de espera. (Sólo Agente ampliado)

until[=hora | horamínima, | ,horamáxima | horamínima ,horamáxima [absolute |

abs]] Selecciona o excluye trabajos basándose en su fecha límite planificada.

hora Especifica la fecha límite planificada expresada del modo siguiente:



+n days



dd/mm/aa.






horamínima


mismo formato que hora. Se seleccionan trabajos que tienen horas

de finalización planificadas a dicha hora o después de la misma.

horamáxima


mismo formato que hora. Se seleccionan trabajos que tienen horas

de finalización planificadas a dicha hora o antes de la misma.

absolute | abs





inmediatamente.









calculada.








Si until se utiliza solo, el rango no tiene un límite fijo y los trabajos se

seleccionan o excluyen si tienen alguna fecha límite planificada.

Selección de secuencias de trabajos en comandos

Para los comandos que efectúan acciones en secuencias de trabajos, las secuencias

de trabajos de destino se seleccionan por medio de atributos y calificadores. La

sintaxis de selección de secuencias de trabajos se muestra a continuación y se

describe en las páginas siguientes.

Sinopsis

[esttrabajo#] secuenciatrab [+ | ~califsecuenciatrab[...]]

Argumentos

esttrabajo

Especifica el nombre de la estación de trabajo en la que se ejecuta la

secuencia de trabajos. Se permiten caracteres comodín.


secuenciatrab

Especifica el nombre de la secuencia de trabajos. Se permiten caracteres

comodín.

califsecuenciatrab

Consulte el apartado “Calificadores de secuencias de trabajos” que se

proporciona a continuación.

Calificadores de secuencias de trabajos

at[=hora | horamínima, |,horamáxima | horamínima,horamáxima [absolute | abs]]

Selecciona o excluye secuencias de trabajos basándose en la hora de inicio

planificada.

hora Especifica la hora de inicio planificada expresada del modo

siguiente:



+n days



dd/mm/aa.


El nombre del huso horario de la secuencia de trabajos.

Para obtener más información sobre nombres válidos,

consulte el Apéndice B, “Gestión de husos horarios”, en la

página 341.

absolute | abs

Especifica la hora de inicio planificada para el día actual.

Esta palabra clave sólo se puede utilizar con timezone|tz


v Cuando hhmm es anterior a la hora actual, la hora de

inicio es inmediatamente.

v Cuando hhmm es posterior a la hora actual, la hora de

inicio es la hora del día actual especificada por hhmm.

v Cuando hhmm supera las 2400, se divide por 2400 para

obtener el día y la hora calculados. Del resultado de la

división, la parte entera representa el día calculado (el

número de + días), mientras que la parte decimal

representa la hora calculada:

– Si la hora calculada es anterior a la hora actual, la

hora de inicio corresponde a un día antes del día

calculado a la hora calculada.

– Si la hora calculada es posterior a la hora actual, la

hora de inicio corresponde al día y la hora calculados.

Por ejemplo, si la hora actual es 1200 y se somete un

trabajo a las hhmm=3500 (2400 + 1100), especificando la

palabra clave abs, se activa el trabajo a las 1100 del día

siguiente. En cambio, si no se especifica la palabra clave

abs, se activa el trabajo a las 1100, dos días más tarde.

horamínima



mismo formato que hora. Se seleccionan secuencias de trabajos que

tienen las horas de inicio planificadas a dicha hora o después de la

misma.

horamáxima



tienen las horas de inicio planificadas a dicha hora o antes de la

misma.

Si at se utiliza solo, el rango no tiene un límite fijo y las secuencias de

trabajos se seleccionan o excluyen si tienen alguna hora de inicio

planificada.

carriedforward

Selecciona o excluye las secuencias de trabajos que se traspasaron.

carryforward

Selecciona o excluye secuencias de trabajos que se han planificado

utilizando la palabra clave carryforward.

finished[=hora | horamínima, | ,horamáxima | horamínima,horamáxima]

Selecciona o excluye secuencias de trabajos basándose en si éstas han

finalizado o no.

hora Especifica la hora exacta a la que han finalizado las secuencias de

trabajos, expresada del modo siguiente:




dd/mm/aa.





página 341.

horamínima



han finalizado a esta hora o después de la misma.

horamáxima



han finalizado a esta hora o antes de la misma.

Si finished se utiliza solo, el rango no tiene un límite fijo y las secuencias

de trabajos se seleccionan o excluyen si han terminado de ejecutarse.

follows[=[agentered::][esttrabajo#] secuenciatrab[.trabajo[;nocheck][;wait=hora]]

Selecciona o excluye secuencias de trabajos basándose en si tienen o no

una dependencia follows.

agentered

Especifica el nombre del agente de red que intercambia

información con la red de planificador remota que contiene la

secuencia de trabajo o el trabajo de prerrequisito. Se permiten


caracteres comodín. Para obtener más información sobre agentes de

red, consulte el Capítulo 9, “Consulta del Agente de red”, en la

página 309.

esttrabajo


el trabajo o las secuencias de trabajos de prerrequisito. Se permiten

caracteres comodín.

secuenciatrab

Especifica el nombre de la secuencia de trabajos de prerrequisito.

Se permiten caracteres comodín.

trabajo Especifica el nombre del trabajo de prerrequisito. Se permiten


nocheck

Sólo es válido para los comandos sbd, sbj y sbs. Conman no

comprueba la existencia de trabajos requeridos previamente en

Symphony. Cuando Batchman procesa el comando submit, agrega

los argumentos del comando submit a Symphony (como, por

ejemplo, el trabajo que se debe someter) incluyendo las

dependencias de los trabajos requeridos previamente que existen

en Symphony. Para los trabajos requeridos previamente que no

existan en el archivo Symphony, Batchman imprime un aviso en

stdlist.

wait=hora

Sólo es válido para los comandos sbd, sbj y sbs. Para el intervalo

de tiempo especificado, Conman comprueba cada segundo la

existencia de los trabajos requeridos previamente en el archivo

Symphony. Conman realiza estas comprobaciones hasta que

encuentra los trabajos requeridos previamente o transcurre el

intervalo de tiempo especificado para la palabra clave wait.

Cuando se encuentran todos los trabajos requeridos previamente,

Batchman procesa el comando submit. Aunque no se encuentre en

Symphony uno sólo de los trabajos requeridos previamente y

transcurra el intervalo de tiempo, Conman no procesará el

comando submit y devolverá un mensaje de error. El número

máximo de segundos es 1200.

Si se especifica nocheck junto con wait, cuando transcurra el

intervalo de tiempo, Batchman procesará el comando submit

aunque uno sólo de los trabajos requeridos previamente no exista

en Symphony. El trabajo que se debe someter y los trabajos

requeridos previamente que existan en Symphony se agregará a

Symphony.

Si follows se utiliza solo, las secuencias de trabajos se seleccionan o

excluyen si tienen alguna dependencia follows.

limit[=límite | límiteinf, | ,límitesup | límiteinf,límitesup]


una dependencia de límite de trabajos.

límite Especifica el valor exacto del límite de trabajos.

límiteinf

Especifica el límite inferior del rango. Se seleccionan secuencias de

trabajos que tienen límites de trabajos iguales o mayores que este

límite.


límitesup

Especifica el límite superior de un rango. Se seleccionan secuencias

de trabajos que tienen límites de trabajos iguales o menores que

este límite.

Si limit se utiliza solo, el rango no tiene un límite fijo y las secuencias de

trabajos se seleccionan o excluyen si tienen algún límite de trabajos.

needs[=[esttrabajo#]nombrerecurso]


una dependencia de recurso.

esttrabajo

Especifica el nombre de la estación de trabajo en la que está

definida el recurso. Se permiten caracteres comodín.

nombrerecurso

Especifica el nombre del recurso. Se permiten caracteres comodín.

Si needs se utiliza solo, las secuencias de trabajos se seleccionan o excluyen

si tienen alguna dependencia de recurso.

opens[=[esttrabajo#]nombarchivo[(calificador)]]


una dependencia de archivo. Se produce una dependencia de archivo

cuando un trabajo o una secuencia de trabajos depende de la existencia de

uno o más archivos para que pueda comenzar su ejecución.

esttrabajo

Especifica el nombre de la estación de trabajo en la que existe el

archivo. Se permiten caracteres comodín.

nombarchivo

Especifica el nombre del archivo. El nombre debe estar entre



invertidas (\) y subrayados (_). Se permiten caracteres comodín.

calificador

Condición de prueba válida. Si se omite, las secuencias de trabajos

se seleccionan o se excluyen sin tomar en consideración un

calificador.

Si opens se utiliza solo, las secuencias de trabajos se seleccionan o

excluyen si tienen alguna dependencia de archivo. Se produce una

dependencia de archivo cuando un trabajo o una secuencia de trabajos

depende de la existencia de uno o más archivos para que pueda comenzar

su ejecución.

priority=pri | primínima, | ,primáxima | primínima,primáxima

Selecciona o excluye secuencias de trabajos basándose en sus prioridades.

pri Especifica el valor de prioridad. Puede entrar un valor de 0 a 99,

hi o go.

primínima

Especifica el límite inferior de un rango de prioridades. Se

seleccionan secuencias de trabajos con prioridades iguales o

mayores que este valor.


primáxima

Especifica el límite superior de un rango de prioridades. Se

seleccionan secuencias de trabajos con prioridades menores o

iguales a este valor.

prompt[=nombsolicitud | númmensaje]


una dependencia de solicitud.

nombsolicitud


comodín.

númmensaje

Especifica el número de mensaje de una solicitud local.

Si prompt se utiliza solo, las secuencias de trabajos se seleccionan o

excluyen si tienen alguna dependencia de solicitud.

started[=hora | horamínima, | ,horamáxima | horamínima,horamáxima]

Selecciona o excluye secuencias de trabajos basándose en si se han iniciado

o no.

hora Especifica la hora exacta a la que se han iniciado las secuencias de

trabajos, expresada del modo siguiente:




dd/mm/aa.





página 341.

horamínima



se han iniciado a esta hora o después de la misma.

horamáxima



se han iniciado a esta hora o antes de la misma.

Si started se utiliza solo, el rango no tiene un límite fijo y las secuencias de

trabajos se seleccionan o excluyen si se ha iniciado su ejecución.

state=estado[,...]

Selecciona o excluye secuencias de trabajos basándose en sus estados.

estado Especifica el estado actual de la secuencia de trabajos. Los estados

válidos de las secuencias de trabajos son los siguientes:

abend La secuencia de trabajos ha terminado de forma anormal.

add La planificación acaba de someterse.

exec La secuencia de trabajos se está ejecutando.


hold La secuencia de trabajos está esperando la resolución de

dependencias.

ready La secuencia de trabajos está preparada para iniciarse y

todas las dependencias se han resuelto.

stuck Se ha interrumpido la ejecución. No se inicia ningún

trabajo sin intervención del operador.

succ La secuencia de trabajos se ha completado

satisfactoriamente.

until[=hora | horamínima, | ,horamáxima | horamínima ,horamáxima [absolute |

abs]] Selecciona o excluye secuencias de trabajos basándose en la hora de

finalización planificada.

hora Especifica la fecha límite planificada expresada del modo siguiente:



+n days



dd/mm/aa.





página 341.

horamínima



tienen las horas de finalización planificadas a dicha hora o después

de la misma.

horamáxima


mismo formato que hora. Se seleccionan las secuencias de trabajos

que tienen horas de finalización planificadas a dicha hora o antes

de la misma.

absolute | abs





inmediatamente.









calculada.









Si until se utiliza solo, el rango no tiene un límite fijo y las secuencias de

trabajos se seleccionan o excluyen si tienen alguna fecha límite planificada.


En las siguientes páginas se incluyen descripciones detalladas de los comandos de

Conman.

Nota: En los comandos, los términos sched y schedule hacen referencia a

secuencias de trabajos y el término cpu hace referencia a estaciones de

trabajo.

Proceso de comandos de Conman

Cuando se utilizan varios comandos, debe tener en cuenta el modo en que se

procesan los comandos de Conman.

Cuando se cambian las dependencias de un trabajo o una planificación en

Symphony, Conman impide que se inserten las dependencias evitando que el

comando pertinente se envíe a Batchman. Sin embargo, es posible que pueda

parecer que el cambio no se haya realizado satisfactoriamente, a pesar de que sí se

ha llevado a cabo.

La razón de ello es que Conman no graba directamente en Symphony, sino que

solicita a Batchman que lo haga. Batchman recibe una secuencia de eventos a

medida que se van produciendo en cada sistema de la red, y en la misma

secuencia en que tienen lugar. A medida que Batchman procesa estos eventos, los

estados de Symphony cambian en la red del planificador. Si un proceso Batchman

está ocupado por alguna razón, los comandos Conman se ponen en cola y

Symphony no se actualiza hasta que Batchman lea los comandos de Mailbox y los

procese. De este modo, un comando de Conman podría llevar a cabo distintas

acciones, según cuando se procese.

Además, cuando Batchman procesa el evento no se notifica al operador. Como

consecuencia, se podría suprimir una dependencia y podría parecer que no se ha

suprimido porque Batchman estaba ocupado. Si vuelve a ejecutar el comando, la

supresión puede haber sido satisfactoria, aunque se visualice un mensaje indicando

que el comando se ha enviado a Batchman.


adddep job

Agrega dependencias a un trabajo.

Debe tener acceso adddep al trabajo. Para incluir las dependencias needs y

prompt, debe tener acceso use a los recursos y a las solicitudes globales.

Sinopsis

adj seleccióntrab[;dependencia[;...]][;noask]

Argumentos

seleccióntrab

Consulte el apartado “Selección de trabajos en comandos” en la página

133.

dependencia

El tipo de dependencia. Especifique una de las siguientes opciones: No se

permiten caracteres comodín.

at=hhmm[timezone | tz nombrehusohorario][+n days | mm/dd/aa] | [absolute

| abs]

confirmed

deadline= hora [timezone|tz nombrehusohorario][+nday[s | mm/dd/aa]

every=frecuencia

follows=[agentered::][esttrabajo#]secuenciatrab{.trabajo | @} | trabajo[,...]

needs=[núm] [esttrabajo#]recurso[,...]

opens=[esttrabajo#]″nombarchivo″[(calificador)][,...] priority[=pri | hi | go]

prompt=″[: | !]texto″ | nombsolicitud[,...]

until hora [timezone|tz nombrehusohorario][+n day[s]] | [absolute | abs]

[onuntil acción]

noask Especifica que no se debe solicitar confirmación antes de efectuar la acción

en cada trabajo calificado.

Notas sobre el uso

Si no especifica ningún valor para priority, el trabajo vuelve a la prioridad original

planificada. Si no especifica ninguna estación de trabajo en follows, needs o opens,

el valor predeterminado es la estación de trabajo en la que se ejecuta el trabajo.

Para agregar dependencias de solicitud mientras se ejecuta Conman en un agente

tolerante a errores, debe tener acceso al directorio TWShome/mozart del gestor de

dominio maestro.

No se puede utilizar este comando para añadir un recurso o un mensaje de

solicitud como dependencias, a menos que ya les haga referencia un trabajo o una

planificación en el archivo Symphony.

Ejemplos

Para agregar una dependencia de recurso al trabajo job3 de la secuencia de

trabajos sked9, ejecute el comando siguiente:

adddep sked9.job3;needs=2 tapes

Para agregar una dependencia de archivo, y una hora until, al trabajo job6 de la

secuencia de trabajos sked2, ejecute el comando siguiente:


|||

|||

|

||

adj sked2.job6;opens="/usr/lib/prdata/file5"(-s %p);

until=2330

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de

dependencias entre trabajos″ y ″Adición de dependencias externas a una secuencia

de trabajos″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console -

Guía del usuario.


||

|||||

adddep sched

Agrega dependencias a una secuencia de trabajos.

Debe tener acceso adddep a la secuencia de trabajos. Para incluir las dependencias

needs y prompt, debe tener acceso use a los recursos y a las solicitudes globales.

Sinopsis

ads selecciónsecuenciatrab[;dependencia[;...]][;noask]

Argumentos

selecciónsecuenciatrab

Consulte el apartado “Selección de secuencias de trabajos en comandos” en

la página 141.

dependencia

El tipo de dependencia. Especifique una de las siguientes opciones: No se


at=hhmm[timezone | tz nombrehusohorario][+n days | mm/dd/aa] | [absolute

| abs]

carryforward

deadline= hora [timezone|tz nombrehusohorario][+nday[s | mm/dd/aa]


limit=límite




until hora [timezone|tz nombrehusohorario][+n day[s] | [absolute | abs]]

[onuntil acción]


en cada secuencia de trabajos calificada.

Notas sobre el uso

v Si no especifica ningún valor para priority, la secuencia de trabajos vuelve a la

prioridad original planificada.

v Si no especifica ningún valor para limit, se toma el valor predeterminado 0.

v Si no especifica ninguna estación de trabajo con follows, needs u opens, el valor

predeterminado es la estación de trabajo en la que se ejecuta la secuencia de

trabajos.

v Para agregar dependencias de solicitud mientras se ejecuta Conman en un

agente tolerante a errores, debe tener acceso al directorio TWShome/mozart del

gestor de dominio maestro.

v No se puede utilizar este comando para añadir un recurso o un mensaje de

solicitud como dependencias, a menos que ya les haga referencia un trabajo o

una planificación en el archivo Symphony.

Ejemplos

Para agregar una dependencia de mensaje de solicitud a la secuencia de trabajos

sked3, ejecute el comando siguiente:

adddep sched=sked3;prompt=msg103


|||

|||

|

Para agregar una dependencia follows y un límite de trabajos a la secuencia de


ads sked4;follows=sked3;limit=2

Véase también


dependencias en una secuencia de trabajos″ y ″Creación de dependencias entre

secuencias de trabajos″ en la publicación IBM Tivoli Workload Scheduler Job



||

|

|||||

altpass

Modifica la contraseña de un objeto de usuario en el plan de producción actual.

Debe tener acceso altpass al objeto de usuario.

Sinopsis

altpass [esttrabajo#]nombusuario[;″contraseña″]

Argumentos

esttrabajo Especifica la estación de trabajo en la que se ha definido el usuario.

El valor predeterminado es la estación de trabajo en la que se

ejecuta Conman.

nombusuario Especifica el nombre de un usuario.

contraseña Especifica la contraseña nueva. Debe incluirse entre comillas. Par

no indicar ninguna contraseña para el usuario, utilice dos comillas

consecutivas (″″).

Notas sobre el uso

Si no especifica una contraseña, Conman solicitará una contraseña y una

confirmación. En este caso, la contraseña no se visualiza cuando se entra y no debe

indicarse entre comillas. Tenga en cuenta que el cambio sólo se realiza en el plan

de producción actual y, por consiguiente, es temporal. Para llevar a cabo un

cambio permanente, consulte el apartado “Definiciones de usuario” en la página

53.

Ejemplos

Para cambiar la contraseña del usuario jim en la estación de trabajo mis5 por

giraffe, ejecute el comando siguiente:

altpass mis5#jim;”giraffe”

Para cambiar la contraseña del usuario jim en la estación de trabajo mis5 por

giraffe sin mostrar la contraseña, ejecute el comando siguiente:

altpass mis5#jim

password: xxxxxxxx

confirm: xxxxxxxx

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Cambio de las

contraseñas de usuario de Windows″ en la publicación IBM Tivoli Workload

Scheduler Job Scheduling Console - Guía del usuario.


|||

|

||

|||

||||

altpri

Modifica la prioridad de un trabajo o de una secuencia de trabajos.

Debe tener acceso altpri al trabajo o secuencia de trabajos.

Sinopsis

ap seleccióntrab | selecciónsecuenciatrab[;pri][;noask]

Argumentos

seleccióntrab Consulte el apartado “Selección de trabajos en comandos” en la

página 133.


Consulte el apartado “Selección de secuencias de trabajos en

comandos” en la página 141.

pri Especifica el nivel de prioridad. Puede entrar un valor de 0 al 99,

hi o go.

noask Especifica que no se debe solicitar confirmación antes de efectuar

la acción en cada secuencia de trabajos o trabajo

Ejemplos

Para cambiar la prioridad del trabajo balance de la secuencia de trabajos glmonth,


altpri glmonth.balance;55

Para cambiar la prioridad de todos los trabajos de la secuencia de trabajos mis5,


ap mis5.@;25

Para cambiar la prioridad de la secuencia de trabajos glmonth, ejecute el comando

siguiente:

altpri glmonth;10

Para cambiar la prioridad de la secuencia de trabajos mis5, ejecute el comando

siguiente:

ap mis5;30


|||

|

||

|

||

|

||

|

|

cancel job

Cancela un trabajo.

Debe tener acceso cancel al trabajo.

Sinopsis

cj seleccióntrab[;pend][;noask]

Argumentos


página 133.

pend Sólo cancela el trabajo después de haber resuelto sus dependencias.


la acción en cada trabajo calificado.

Notas sobre el uso

Si un trabajo se cancela antes de iniciarse, no se iniciará. Si se cancela un trabajo

después de haberse iniciado, el trabajo continuará ejecutándose. Si un trabajo en

ejecución se cancela y se completa en estado abend, no se intentará realizar ningún

paso de recuperación automática del trabajo.

Si no utiliza la opción ;pend, los trabajos y las secuencias de trabajos que son

dependientes del trabajo cancelado se liberan inmediatamente de la dependencia.

Si incluye la opción ;pend y el trabajo no se ha iniciado, se pospone la cancelación

hasta que se resuelvan todas las dependencias, incluida una hora at (de inicio).

Una vez resueltas todas las dependencias, se cancela el trabajo y los trabajos o las

secuencias de trabajos que son dependientes del trabajo cancelado se liberan de la

dependencia. En el período durante el cual se pospone la cancelación, la notación

[Cancel Pend] se lista en la columna Dependencias del trabajo de una pantalla

showjobs.

Si incluye la opción ;pend y el trabajo ya se ha iniciado, se ignora la opción y los

trabajos y las secuencias de trabajos que son dependientes del trabajo cancelado se

liberan inmediatamente de la dependencia.

Puede utilizar el comando rerun para volver a ejecutar trabajos que se han

cancelado o que se han marcado como [Cancel Pend]. También puede agregar y

suprimir dependencias de trabajos que se han marcado como [Cancel Pend].

Para cancelar inmediatamente un trabajo que se ha marcado como [Cancel Pend],

puede entrar un comando release para el trabajo o entrar otro comando cancel si

la opción ;pend.

Para trabajos con horas caducadas until, la notación [Until] se lista en la columna

Dependencias en una pantalla showjobs y sus dependencias ya no se evalúan. Si

un trabajo de este tipo también se ha marcado como [Cancel Pend], no se

cancelará hasta que se libere o suprima la hora until (de finalización) o se entre

otro comando cancel sin la opción ;pend.

Para dejar de evaluar las dependencias, establezca la prioridad de un trabajo en el

valor cero con el comando altpri. Para reanudar la evaluación de dependencias,

establezca la prioridad en un valor mayor que cero.


Nota: En el caso de dependencias inter-red, si se cancela un trabajo de la secuencia

de trabajos externa se liberarán los trabajos y las secuencias de trabajos

locales de la dependencia. Los trabajos de la secuencia de trabajos externa

representan trabajos y secuencias de trabajos que se han especificado como

dependencias inter-red. El estado de una dependencia de inter-red no se

comprueba después de efectuar una operación cancel. Para obtener más

información consulte el apartado “Dependencias inter-red” en la página 312.

Ejemplos

Para cancelar el trabajo report de la secuencia de trabajos apwkly de la estación de


cancel site3#apwkly.report

Para cancelar el trabajo setup de la secuencia de trabajos mis5, si no está en estado

abend, ejecute el comando siguiente:

cj mis5.setup~state=abend

Para cancelar el trabajo job3 de la secuencia de trabajos sked3, sólo después de

haber resuelto las dependencias del mismo, ejecute el comando siguiente:

cj sked3.job3;pend

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Supresión de un

trabajo de una secuencia de trabajos″ en la publicación IBM Tivoli Workload



|||

|

||

|

||

|

||||

cancel sched

Cancela una secuencia de trabajos.

Debe tener acceso cancel a la secuencia de trabajos.

Sinopsis

cs selecciónsecuenciatrab[;pend][;noask]

Argumentos




pend Cancela la secuencia de trabajos sólo después de haber resuelto sus

dependencias.


la acción en cada secuencia de trabajos calificada.

Notas sobre el uso

Si se cancela una secuencia de trabajos antes de que se inicie, dicha secuencia no se

iniciará. Si se cancela una vez que se ha iniciado, se dejará que se lleven a cabo los

trabajos que han empezado, pero no se iniciará ningún otro.

Si no utiliza la opción ;pend, los trabajos y las secuencias de trabajos que son

dependientes de la secuencia de trabajos cancelada se liberan inmediatamente de la

dependencia.

Si utiliza la opción ;pend y la secuencia de trabajos no se ha iniciado, se pospone

la cancelación hasta que se resuelvan todas las dependencias, incluida una hora at

(de inicio). Una vez resueltas todas las dependencias, se cancela la secuencia de

trabajos y los trabajos o las secuencias de trabajos dependientes se liberan de la

dependencia. En el período durante el cual se pospone la operación cancel, la

notación [Cancel Pend] se lista en la columna Dependencias de una pantalla

showschedules.

Si incluye la opción ;pend y la secuencia de trabajos ya se ha iniciado, los trabajos

restantes de la secuencia de trabajos se cancelan y los trabajos y las secuencias de

trabajos dependientes se liberan de la dependencia.

Para cancelar inmediatamente una secuencia de trabajos que se ha marcado como

[Cancel Pend], puede entrar un comando release para la secuencia de trabajos o

entrar otro comando cancel si la opción ;pend.

Para secuencias de trabajos con horas caducadas until, la notación [Until] aparece

en la columna Dependencias en una pantalla showschedules y sus dependencias

ya no se evalúan. Si una secuencia de trabajos de este tipo también se ha marcado

como [Cancel Pend], no se cancelará hasta que se libere o suprima la hora until

(de finalización) o se entre otro comando cancel sin la opción ;pend.

Para dejar de evaluar las dependencias, establezca la prioridad de una secuencia

de trabajos en el valor cero con el comando altpri. Para reanudar la evaluación de

dependencias, establezca la prioridad en un valor mayor que cero.


Ejemplos

Para cancelar la secuencia de trabajos sked1 de la estación de trabajo site2, ejecute

el comando siguiente:

cancel site2#sked1

Para cancelar la secuencia de trabajos mis2, si está en estado stuck, ejecute el

comando siguiente:

cs mis2+state=stuck

Para cancelar la secuencia de trabajos sked3, sólo después de haber resuelto las

dependencias de la misma, ejecute el comando siguiente:

cs sked3;pend

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Supresión de




|||

|

||

|

||

|

||||

confirm

Confirma la conclusión de un trabajo que se planificó con la palabra clave

confirmed. En la sección “Notas acerca del uso” se indica una excepción.

Debe tener acceso confirm al trabajo.

Sinopsis

confirm seleccióntrab;{succ | abend}[;noask]

Argumentos


página 133.

succ Confirma que el trabajo ha finalizado satisfactoriamente.

abend Confirma que el trabajo no ha finalizado satisfactoriamente.



Notas sobre el uso

Al cambiar el estado de un trabajo abend por succ no es necesario utilizar la

palabra clave confirmed para planificar el trabajo. Para obtener más información

sobre confirmación de trabajos, consulte el apartado “confirmed” en la página 97.

Para obtener más información sobre trabajos externos, consulte el apartado

“Dependencias inter-red” en la página 312.

En la siguiente tabla se muestra el efecto del comando confirm en varios estados

de trabajos:

Estado inicial del trabajo

Estado después de confirm

;succ

Estado después de confirm

;abend

ready ningún efecto ningún efecto

hold ningún efecto ningún efecto

exec succp abenp

abenp succp ningún efecto

succp ningún efecto ningún efecto

pend succ abend

done succ abend

succ ningún efecto ningún efecto

abend succ ningún efecto

fail ningún efecto ningún efecto

skel ningún efecto ningún efecto

cualquier trabajo externo succ abend

Ejemplos

Para emitir una confirmación succ para el trabajo job3 de la secuencia de trabajos

misdly, ejecute el comando siguiente:

confirm misdly.job3;succ


|||

|

Para emitir una confirmación abend para el número de trabajo 234, ejecute el

comando siguiente:

conf 234;abend


||

|

|

console

Asigna la consola del planificador y establece el nivel de mensajes.

Debe tener acceso console a la estación de trabajo.

Sinopsis

console [sess | sys][;level=nivelmsj]

Argumentos

sess Envía solicitudes y mensajes de consola del planificador a la salida

estándar.

sys Deja de enviar solicitudes y mensajes de consola del planificador a

la salida estándar. Esto se produce automáticamente al salir de

Conman.

nivelmsj El nivel de los mensajes del planificador que se envían a la

consola. Especifique uno de los siguientes niveles:

0 Ningún mensajes. Es el valor predeterminado en agentes

tolerante a errores.

1 Mensajes de excepción, por ejemplo solicitudes de

operador y terminaciones anormales de trabajo.

2 Nivel 1 más mensajes satisfactorios de secuencias de

trabajos.

3 Nivel 2 más mensajes satisfactorios de trabajos. Es el valor

predeterminado en el gestor de dominio maestro.

4 Nivel 3 más mensajes iniciados de trabajos.

Notas sobre el uso

Si entra el comando console sin ninguna opción, se muestra el estado actual de la

consola.

Por omisión, los procesos de control del planificador graban las solicitudes y los

mensajes de consola en archivos de lista estándar. En UNIX, también puede hacer

que se envíen al daemon syslog.

Ejemplos

Para empezar a grabar solicitudes y mensajes de consola en la salida estándar y

cambiar el nivel de mensaje por 1, ejecute el comando siguiente:

console sess;level=1

Para detener la grabación de solicitudes y mensajes de consola en la salida

estándar y cambiar el nivel de mensaje por 4, ejecute el comando siguiente:

cons sys;l=4

Para mostrar el estado actual de la consola, ejecute el comando siguiente:

cons

Console is #J675, level 2, session

675 es el ID del proceso del shell del usuario.


|||

|

||

|

|

||

|

continue

Ignora el error de comando siguiente.

Sinopsis

continue

Notas sobre el uso

Este comando es útil cuando se entran comandos de forma no interactiva. Indica a

Conman que siga ejecutando comandos incluso si el comando siguiente, el que va

a continuación de continue, produce un error.

Ejemplos

Para hacer que Conman siga ejecutando el comando rerun aunque falle el

comando cancel, ejecute el comando siguiente:

conman "continue&cancel=176&rerun job=sked5.job3"


|||

|

deldep job

Suprime las dependencias de un trabajo.

Debe tener acceso deldep al trabajo.

Sinopsis

ddj seleccióntrab;dependencia[;...][;noask]

Argumentos

seleccióntrab


133.

dependencia

El tipo de dependencia. Especifique como mínimo una de las siguientes

opciones. Puede utilizar caracteres comodín en esttrabajo, secuenciatrab,

trabajo, recurso, nombarchivo, y nombsolicitud.

at[=hora | horamínima | horamáxima | horamínima,horamáxima]

confirmed

deadline[=hora[timezone | tz nombrehusohorario][+n days | mm/dd/aa]]

every

follows[=[agentered::][esttrabajo#]secuenciatrab{.trabajo | @} | trabajo[,...]]

needs[=[núm] [esttrabajo#]recurso[,...]]

opens[=[esttrabajo#]″nombarchivo″[(calificador)][,...]]

priority

prompt[=″[: | !]texto″ | nombsolicitud[,...]]

until[=hora [timezone|tz nombrehusohorario][+n day[s]] [ onuntil acción]]



Notas sobre el uso

Si se suprime priority, el trabajo vuelve a la prioridad original planificada. Si se

suprime una dependencia opens, sólo se puede incluir el nombre de archivo base y

Conman efectúa una búsqueda no sensible a las mayúsculas y minúsculas de

archivos coincidentes, ignorando los nombres de directorio. Se suprimen las

dependencias de todos los archivos que coinciden.

En determinadas circunstancias, después de someter un comando deldep, dicho

comando podría haber sido satisfactorio aunque se remita de nuevo a Batchman.

Para obtener más información, consulte el apartado “Proceso de comandos de

Conman” en la página 148.

Ejemplos

Para suprimir una dependencia de recurso del trabajo job3 de la secuencia de


deldep sked5.job3;needs=2 tapes

Para suprimir todas las dependencias follows del trabajo job4 de la secuencia de


ddj sked3.job4;follows


|||

|

||

|

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Gestión de trabajos″

en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console - Guía del

usuario.


||||

deldep sched

Suprime las dependencias de una secuencia de trabajos.

Debe tener acceso deldep a la secuencia de trabajos.

Sinopsis

dds selecciónsecuenciatrab;dependencia[;...][;noask]

Argumentos



133.

dependencia

El tipo de dependencia. Especifique como mínimo una de las siguientes

opciones. Puede utilizar caracteres comodín en esttrabajo, secuenciatrab,

trabajo, recurso, nombarchivo, y nombsolicitud.


carryforward



limit



priority





Notas sobre el uso

Si se suprime priority, el trabajo vuelve a la prioridad original planificada. Si se

suprime una dependencia opens, sólo se puede incluir el nombre de archivo base y

Conman efectúa una búsqueda no sensible a las mayúsculas y minúsculas de

archivos coincidentes, ignorando los nombres de directorio. Se suprimen las



comando podría haber sido satisfactorio aunque se remita de nuevo a Batchman.

Para obtener más información, consulte el apartado “Proceso de comandos de

Conman” en la página 148.

Ejemplos

Para suprimir una dependencia de recurso de la secuencia de trabajos sked5,


deldep sked5;needs=2 tapes

Para suprimir todas las dependencias follows de la secuencia de trabajos sked3,


dds sked3;follows


|||

|

||

|

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Gestión de




||||

display

Muestra un archivo de trabajo o una definición de secuencia de trabajos.

Si especifica un archivo por el nombre, deberá tener acceso de lectura (read) al

archivo. Para definiciones de secuencias de trabajo y archivos de trabajos, debe

tener acceso display al trabajo o a la secuencia de trabajos.

Sinopsis

df nombarchivo[;offline]

dj seleccióntrab[;offline]

ds selecciónsecuenciatrab[;offline]

Argumentos

nombarchivo Especifica el nombre del archivo, generalmente un archivo script

de trabajo. El nombre debe estar entre comillas (″) si contiene

caracteres distintos de los siguientes: caracteres alfanuméricos,

guiones (-), barras inclinadas (/), barras inclinadas invertidas (\) y

subrayados (_). Se permiten caracteres comodín. Se tiene que poder

acceder al archivo desde la estación de trabajo de inicio de sesión.

seleccióntrab Trabajo cuyo archivo de trabajo se visualiza. Consulte el apartado

“Selección de trabajos en comandos” en la página 133. Se tiene que

poder acceder al archivo de trabajo desde la estación de trabajo de

inicio de sesión.


La secuencia de trabajos cuya definición se visualiza. Consulte el

apartado “Selección de secuencias de trabajos en comandos” en la página

141. Desde la estación de trabajo de inicio de sesión se tiene que

poder acceder al directorio mozart del planificador del gestor de

dominio maestro.

offline Envía la salida del comando al dispositivo de salida de Conman.

Para obtener más información sobre este dispositivo, consulte el


Ejemplos

Para mostrar el archivo c:\maestro\jclfiles\arjob3, ejecute el comando siguiente:

df c:\apps\maestro\jclfiles\arjob3

Para mostrar el archivo script para el trabajo job6 de la corriente de trabajos sked3

fuera de línea, ejecute el comando siguiente:

dj sked3.job6;off

Para mostrar la definición de la secuencia de trabajos sked9, ejecute el comando

siguiente:

ds sked9

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Gestión de trabajos″

y ″Gestión de secuencias de trabajos″ en la publicación IBM Tivoli Workload



||

|

||

|

||

|

||||

exit

Sale del programa de línea de comandos Conman.

Sinopsis

e

Notas sobre el uso

Cuando se está en modalidad de ayuda en UNIX, este comando devuelve a

Conman a la modalidad de entrada de comandos.

Ejemplos

Para salir del programa de línea de comandos Conman, ejecute el comando

siguiente:

exit

o

e


|||

|

|

|

fence

Cambia las delimitaciones de trabajo en una estación de trabajo. Los trabajos no se

inician en la estación de trabajo si sus prioridades son inferiores o iguales a la

delimitación de trabajo.

Debe tener acceso fence a la estación de trabajo.

Sinopsis

fence estacióntrabajo;pri[;noask]

Argumentos

esttrabajo Especifica el nombre de la estación de trabajo. El valor

predeterminado es la estación de trabajo de inicio de sesión.

pri Especifica el nivel de prioridad. Puede entrar un valor de 0 a 99, hi

o go. Si se entra system, se establece la delimitación de trabajo en

cero.


la acción en cada estación de trabajo calificada.

Notas sobre el uso

La delimitación de trabajo impide que se inicien trabajos de prioridad baja,

independientemente de las prioridades de sus secuencias de trabajos. Por

consiguiente, es posible detener trabajos de prioridad baja de secuencias de

trabajos de prioridad alta, al mismo tiempo que se permite iniciar trabajos de

prioridad alta de secuencias de trabajos de prioridad baja.

La primera vez que inicie IBM Tivoli Workload Scheduler después de la

instalación, la delimitación de trabajo tiene el valor cero. Una vez que haya

cambiado la delimitación de trabajo, ésta se pasa durante el proceso de

preproducción al plan de producción del día siguiente.

Para mostrar el valor actual de la delimitación de trabajo, utilice el comando

status.

Ejemplos

Para cambiar la delimitación de trabajo en la estación de trabajo site4, ejecute el

comando siguiente:

fence site4;20

Para cambiar la delimitación de trabajo en la estación de trabajo en la que está

ejecutando Conman, ejecute el comando siguiente:

f ;40

Para impedir que el planificador inicie todos los trabajos en la estación de trabajo

tx3, ejecute el comando siguiente:

f tx3;go

Para cambiar la delimitación de trabajo por cero en la estación de trabajo en la que

se está ejecutando Conman, ejecute el comando siguiente:

f ;system

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Visualización y

modificación de propiedades de estación de trabajo″ en la publicación IBM Tivoli


|||

|

||

|

||

|

||

|

|||

Workload Scheduler Job Scheduling Console - Guía del usuario.


|

help

Muestra información de ayuda acerca de comandos. No está disponible en

Windows.

Sinopsis

help comando

Argumentos

comando

Especifica el nombre de un comando de Conman o del sistema. Para los

comandos de Conman, entre el nombre de comando completo; no se da

soporte a las abreviaturas ni a las formas abreviadas. En el caso de

comandos que constan de dos palabras, entre la primera palabra y se

mostrará ayuda para todas las versiones del comando. Por ejemplo, si

entra help display se mostrará información sobre los comandos display

file, display job y display sched. También puede entrar las palabras clave

siguientes:

commands

Lista todos los comandos de Conman.

jobselect

Lista información acerca de la selección de trabajos para comandos.

jobstates

Lista información acerca de los estados de los trabajos.

schedselect

Lista información sobre la selección de secuencias de trabajos para

comandos.

schedstates

Lista información sobre estados de secuencias de trabajos.

Ejemplos

Para mostrar una lista de todos los comandos de Conman, ejecute el comando

siguiente:

help commands

Para mostrar información sobre el comando fence, ejecute el comando siguiente:

help fence

Para mostrar información sobre los comandos altpri job y altpri sched, ejecute el

comando siguiente:

h altpri


|||

|

|

|

||

|

|

kill

Detiene la ejecución de un trabajo. En UNIX, esto se logra con un comando kill de

UNIX.

Sinopsis

kill seleccióntrab[;noask]

Argumentos


página 133.



Notas sobre el uso

La operación kill no la lleva a cabo Conman, la ejecuta un proceso de producción

del planificador y, por consiguiente, es posible que se produzca una pequeña

demora.

Los trabajos abortados terminan en estado abend. Los trabajos o las secuencias de

trabajos que son dependientes de un trabajo abortado no se liberan. Los trabajos

abortados pueden volverse a ejecutar.

Ejemplos

Para terminar el trabajo report de la secuencia de trabajos apwkly en la estación de


kill site3#apwkly.report

Para terminar el trabajo número 456, ejecute el comando siguiente:

k 456


|||

|

|

|

|

limit cpu

Cambia el límite de trabajos activados en una estación de trabajo de un agente

estándar. Debe tener acceso limit a la estación de trabajo.

Sinopsis

lc esttrabajo;límite[;noask]

Argumentos

esttrabajo Especifica el nombre de la estación de trabajo de agente estándar.

Se permiten caracteres comodín. El valor predeterminado es la

estación de trabajo de inicio de sesión.

límite Especifica el límite de trabajos. Puede entrar valores comprendidos

entre 0 y 1024. Si se entra system, se establece el límite de trabajos

en el valor cero. Si se establece un límite de cero, no se iniciará

ningún trabajo distinto de los trabajos de prioridad hi y go, en la

estación de trabajo.



Notas sobre el uso

Para mostrar el límite de trabajos actual de la estación de trabajo de inicio de

sesión, utilice el comando status.

La primera vez que inicie IBM Tivoli Workload Scheduler después de la

instalación, el límite de trabajos de la estación de trabajo estará establecido en cero

y deberá aumentarse antes de que se inicie cualquier trabajo. Una vez que haya

cambiado el límite, éste se pasa durante el proceso de preproducción al plan de

producción del día siguiente.

El planificador intenta iniciar tantos trabajos como sea posible dentro del límite de

trabajos. Existe un límite práctico en el número de procesos que se pueden iniciar

en una estación de trabajo. Si se alcanza el límite, el sistema responde con un

mensaje que indica que los recursos del sistema no están disponibles. Cuando un

trabajo no se puede iniciar por este motivo, entra en estado fail. Una reducción del

límite de trabajos puede evitar que esto suceda.

Ejemplos

Para cambiar el límite de trabajos en la estación de trabajo site3, ejecute el

comando siguiente:

limit cpu=site3;25

Para cambiar el límite de trabajos en la estación de trabajo en la que está

ejecutando Conman, ejecute el comando siguiente:

lc ;12

Para cambiar el límite de trabajos en la estación de trabajo rx12, ejecute el comando

siguiente:

lc rx12;6

Véase también


modificación de propiedades de estación de trabajo″ en la publicación IBM Tivoli

Workload Scheduler Job Scheduling Console - Guía del usuario.


|||

|

||

|

||

|

||||

limit sched

Cambia el límite de trabajos para una secuencia de trabajos. Debe tener acceso

limit a la secuencia de trabajos.

Sinopsis

ls selecciónsecuenciatrab;límite[;noask]

Argumentos




límite Especifica el límite de trabajos. Puede entrar valores comprendidos

entre 0 y 1024. Si especifica un límite de cero, no se iniciará ningún

trabajo adicional de la secuencia de trabajos.


la acción en cada secuencia de trabajos calificada.

Ejemplos

Para cambiar el límite de trabajos en todas las secuencias de trabajos que incluyen

sales en su nombre, ejecute el comando siguiente:

limit sched=sales@;4

Para cambiar el límite de trabajos en la secuencia de trabajos apwkly, ejecute el

comando siguiente:

ls apwkly;6

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Gestión de




|||

|

||

|

||||

link

Abre vínculos de comunicaciones entre estaciones de trabajo. En una red del

planificador, los agentes tolerantes a errores y los agentes estándar se vinculan a

sus gestores de dominio y los gestores de dominio se vinculan a sus gestores de

dominio padre. Los agentes ampliados no se vinculan; se comunican a través de

un host.

Debe tener acceso link a la estación de trabajo de destino.

Sinopsis

lk [dominio!]esttrabajo[;noask]

Argumentos

dominio Especifica el nombre del dominio en el que se abren vínculos. Se


Este argumento es útil cuando se vincula más de una estación de

trabajo en un dominio. Por ejemplo, para vincular todos los

agentes del dominio stlouis, utilice el siguiente comando:

link stlouis!@

El dominio no es necesario si no incluye caracteres comodín in

esttrabajo.

Si no incluye dominio e incluye caracteres comodín en esttrabajo, el

dominio predeterminado es aquél en el que se está ejecutando

Conman.

esttrabajo Especifica el nombre de la estación de trabajo que se debe vincular.




Notas sobre el uso

Si la opción autolink se establece en el valor on en una definición de estación de

trabajo, su vínculo se abre automáticamente cada vez que se inicia el planificador.

Si autolink se establece en el valor off, deberá utilizar los comandos link y unlink

para controlar el vínculo. Para obtener más información sobre autolink, consulte el

apartado “Definiciones de estación de trabajo” en la página 37.

Suponiendo que un usuario tenga acceso link a las estaciones de trabajo que se

están vinculando, se aplican las reglas siguientes:

v Un usuario que ejecuta Conman en el gestor de dominio maestro puede vincular

cualquier estación de trabajo de la red.

v Un usuario que ejecuta Conman en un gestor de dominio distinto del maestro

puede vincular cualquier estación de trabajo en su propio dominio y los

dominios subordinados. El usuario no puede vincular estaciones de trabajo en

dominios de igual.

v Un usuario que ejecuta Conman en un agente puede vincular con cualquier

estación de trabajo de su dominio local siempre que dicha estación de trabajo

sea un gestor de dominio o un host. No se puede vincular con un agente igual

del dominio local.

v Para vincular un dominio subordinado mientras se ejecuta Conman en un

dominio superior, no es necesario que los vínculos que intervienen estén

abiertos.


Ejemplos

En la ilustración y la tabla que siguen se muestran los vínculos abiertos por los

comandos link ejecutados por usuarios en diversas ubicaciones de la red.

DMn son gestores de dominio y Ann son agentes.

Comando

Vínculos abiertos

por Usuario1

Vínculos abiertos

por Usuario2

Vínculos abiertos

por Usuario3

link @!@ Todos los vínculos

están abiertos.

DM1-DM2

DM2-A21

DM2-A22

DM2-DM4

DM4-A41

DM4-A42

DM2-A21

link @ DM1-A11

DM1-A12

DM1-DM2

DM1-DM3

DM1-DM2

DM2-A21

DM2-A22

DM2-DM4

DM2-A21

link DOMAIN3!@ DM3-A31

DM3-A32

No se permite. No se permite.

link DOMAIN4!@ DM4-A41

DM4-A42

DM4-A41

DM4-A42

No se permite.

link DM2 DM1-DM2 No aplicable. DM2-A21

link A42 DM4-A42 DM4-A42 No se permite.

link A31 DM3-A31 No se permite. No se permite.

Figura 3. Vínculos de red


listsym

Lista los archivos de registro del plan de producción (Symphony).

Debe tener acceso display al archivo Symphony.

Sinopsis

listsym [;offline]

Argumentos




Salida del comando

Fecha de planificación

Fecha utilizada por el comando schedulr para seleccionar secuencias de

trabajos para su ejecución.

Fecha real

Fecha en la que batchman ha empezado a ejecutar el archivo Symphony.

Hora de inicio

Hora en la que batchman ha empezado a ejecutar el archivo Symphony.

Fecha de registro

Fecha en la que el plan (Symphony) ha sido registrado por el comando

stageman.

Núm ejec

El número de ejecución asignado al plan (Symphony). Se utilizan

internamente para la sincronización de red del planificador.

Tamaño

Tamaño del archivo de registro en registros.

Núm registro

Número de registro que indica el orden cronológico de los archivos de

registro. Este número puede utilizarse en un comando setsym para

conmutar a un archivo de registro.

Nombre del archivo

Nombre del archivo de registro asignado por el comando stageman.

Ejemplos

Para listar los archivos de registro del plan de producción, ejecute el comando

siguiente:

listsym

Para listar los archivos de registro del plan de producción para el dispositivo de

salida de Conman, ejecute el comando siguiente:

lis ;off


|||

|

||

|

recall

Muestra solicitudes que están esperando una respuesta.

Debe tener acceso display a las solicitudes.

Sinopsis

rc [esttrabajo][;offline]

Argumentos

esttrabajo Especifica el nombre de la estación de trabajo en la que se ha

emitido la solicitud. Si no especifica una estación de trabajo, sólo se

mostrarán solicitudes para la estación de trabajo de inicio de sesión

y las solicitudes globales.




Salida del comando

Estado

Estado de la solicitud. El estado de las solicitudes pendientes es siempre

ASKED.

Mensaje o solicitud

Para solicitudes con nombre, número de mensaje, nombre de la solicitud y

texto del mensaje. Para solicitudes sin nombre, número de mensaje,

nombre del trabajo o de la secuencia de trabajos y texto del mensaje.

Ejemplos

Para mostrar las solicitudes pendientes emitidas en la estación de trabajo en la que

está ejecutando Conman, ejecute el comando siguiente:

recall

o:

rc

Para mostrar las solicitudes pendientes en la estación de trabajo site3, ejecute el

comando siguiente:

rc site3

Para mostrar solicitudes pendientes en todas las estaciones de trabajo y hacer que

la salida se envíe al dispositivo fuera de línea de Conman, ejecute el comando

siguiente:

rc @;offline


|||

|

|

|

||

|

|||

|

|

redo

Edita y vuelve a ejecutar el comando anterior.

Sinopsis

redo

Contexto

Cuando se ejecuta el comando redo, Conman muestra el comando anterior para

que se pueda editar y volver a ejecutar. Utilice la barra espaciadora para mover el

cursor bajo el carácter que se debe modificar y entre las directivas siguientes.

Directivas

d[dir] Suprime el carácter encima de la d. Puede ir seguido de otras

directivas.

itexto Inserta texto antes del carácter que está encima de la i.

rtexto Sustituye uno o más caracteres por texto, empezando por el

carácter que está encima de la r. La sustitución es implícita si no se

entra ninguna otra directiva.

>texto Agrega texto al final de la línea.

>d[dir | texto]

Suprime caracteres al final de la línea. Puede ir seguida de otra

directiva o de texto.

>rtexto Sustituye caracteres al final de la línea por texto.

Ejemplos de directivas

ddd Suprime los tres caracteres que están encima de las d.

iabc Inserta abc antes del carácter que está encima de la i.

rabc Sustituye los tres caracteres, empezando por el que está encima de

la r, por abc.

abc Sustituye los tres caracteres que están encima de abc por abc.

d diabc

Suprime el carácter que está encima de la primera d, salta un

carácter, suprime el carácter que está encima de la segunda d e

inserta abc en su lugar.

>abc Agrega abc al final de la línea.

>ddabc

Suprime los dos últimos caracteres de la línea e inserta abc en su

lugar.

>rabc Sustituye los tres últimos caracteres de la línea por abc.

Ejemplos

Para insertar un carácter, ejecute el comando siguiente:

redo

setsm 4

iy

setsym 4

Para sustituir un carácter, ejecute el comando siguiente:


||

||||

|

redo

setsym 4

5

setsym 5


||||

|

release job

Libera trabajos de dependencias.

Debe tener acceso release al trabajo.

Sinopsis

rj seleccióntrab[;dependencia[;...]][;noask]

Argumentos

seleccióntrab

Especifica el trabajo o los trabajos que se deben liberar. Consulte el

apartado “Selección de trabajos en comandos” en la página 133.

dependencia

El tipo de dependencia. Puede especificar uno de los siguientes. Puede

utilizar caracteres comodín en esttrabajo, secuenciatrab, trabajo, recurso,

nombarchivo, y nombsolicitud.


confirmed


every




priority





Notas sobre el uso

Si se libera una dependencia opens, sólo se puede incluir el nombre de archivo

base y Conman efectúa una búsqueda no sensible a las mayúsculas y minúsculas

de archivos coincidentes, ignorando los nombres de directorio. Se liberan las


Para dependencias needs, se le proporciona al trabajo liberado el número necesario

de unidades del recurso, aunque puede que éstas no estén disponibles. Esto puede

hacer que las unidades las unidades Disponibles de un showresources muestren

un número negativo.

Cuando se libera un trabajo de una dependencia priority, el trabajo vuelve a la

prioridad original planificada.

Ejemplos

Para liberar el trabajo job3 de la secuencia de trabajos ap de todas sus

dependencias, ejecute el comando siguiente:

release job=ap.job3


|||

|

Para liberar el trabajo job2 de la secuencia de trabajos skedr de todas sus

dependencias opens, ejecute el comando siguiente:

rj skedr.job2;opens

Para liberar todos los trabajos de la estación de trabajo site4 de sus dependencias

en una solicitud llamada glprmt, ejecute el comando siguiente:

rj site4#@.@;prompt=glprmt

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Liberación de una

instancia de trabajo de las dependencias″ en la publicación IBM Tivoli Workload



||

|

||

|

||||

release sched

Libera secuencias de trabajos de dependencias.

Debe tener acceso release a la secuencia de trabajos.

Sinopsis

rs selecciónsecuenciatrab[;dependencia[;...]][;noask]

Argumentos


Consulte el apartado “Selección de secuencias de trabajos en comandos” en

la página 141.

dependencia

El tipo de dependencia. Especifique una de las siguientes opciones: Puede

utilizar caracteres comodín en esttrabajo, secuenciatrab, trabajo, recurso,

nombarchivo, y nombsolicitud.


carryforward



limit



priority





Notas sobre el uso

Si se suprime una dependencia opens, sólo se puede incluir el nombre de archivo

(nombre base) y Conman efectúa una búsqueda no sensible a las mayúsculas y

minúsculas de archivos coincidentes, ignorando los nombres de directorio. Se

liberan las dependencias de todos los archivos que coinciden.

Para dependencias needs, se le proporciona a la secuencia de trabajos liberada el

número necesario de unidades del recurso, aunque puede que éstas no estén

disponibles. Esto puede hacer que las unidades Disponibles de un showresources

muestren un número negativo.

Cuando se libera una planificación de una dependencia priority, la secuencia de

trabajos vuelve a la prioridad original.


comando podría haber sido satisfactorio aunque se remita a Batchman. Para

obtener más información, consulte el apartado “Proceso de comandos de Conman”

en la página 148.


Ejemplos

Para liberar la secuencia de trabajos ap de todas sus dependencias, ejecute el

comando siguiente:

release sched=ap

Para liberar la secuencia de trabajos sked5 de todas sus dependencias opens,


rs sked5;opens

Para liberar todas las secuencias de trabajos de la estación de trabajo site3 de sus

dependencias en la secuencia de trabajos main#sked23, ejecute el comando

siguiente:

rs site3#@;follows=main#sked23

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Liberación de una

instancia de secuencia de trabajos de las dependencias″ en la publicación IBM

Tivoli Workload Scheduler Job Scheduling Console - Guía del usuario.


|||

|

||

|

|||

|

||||

reply

Responde a una solicitud de trabajo o de secuencia de trabajos.

Debe tener acceso reply a la solicitud con nombre o global. Para responder a una

solicitud sin nombre, debe tener acceso reply a solicitudes y acceso reply al trabajo

o a la secuencia de trabajos asociada.

Sinopsis

reply { nombsolicitud | [esttrabajo#]númmensaje};respuesta[;noask]

Argumentos

nombsolicitud Especifica el nombre de una solicitud global. Se permiten caracteres

comodín.

esttrabajo Especifica el nombre de la estación de trabajo en la que se ha

emitido una solicitud sin nombre.

númmensaje Especifica el número de mensaje de una solicitud sin nombre.

Puede visualizar números de mensajes con los comandos recall y

showprompts.

respuesta Especifica la respuesta, Y para sí o N para no.


la acción en cada solicitud calificada.

Notas sobre el uso

Si la respuesta es Y, se satisfacen las dependencias en la solicitud. Si la respuesta es

N, las dependencias no se satisfacen y no se vuelve a emitir la solicitud.

Se puede responder a las solicitudes antes de que se emitan. Puede utilizar el

comando showprompts para mostrar todas las solicitudes, tanto si se han emitido

como si no.

Ejemplos

Para responder Y a la solicitud global arprmt, ejecute el comando siguiente:

reply arprmt;y

Para responder N al mensaje número 24 de la estación de trabajo site4, ejecute el

comando siguiente:

rep site4#24;n


||

|

||

|

|

rerun

Vuelve a ejecutar un trabajo.

Debe tener acceso rerun al trabajo.

Sinopsis

rr seleccióntrab[;from=[esttrabajo#]trabajo[;at=hora][;pri=pri]][;noask]

rr seleccióntrab[;step=paso][;noask]

Argumentos

seleccióntrab

Especifica el nombre de uno o más trabajos. Se permiten caracteres

comodín.

from=[esttrabajo#]trabajo

Especifica el nombre de un trabajo definido en la base de datos del

planificador cuyo archivo de trabajo o comando se ejecutará en vez del

trabajo especificado por seleccióntrab.

esttrabajo#


el trabajo from. El valor predeterminado es la estación de trabajo

en la que se ejecuta Conman.

trabajo Especifica el nombre de la definición de trabajo from. Los

siguientes tipos de nombres de trabajo no se pueden utilizar:

v Los nombres de trabajos sometidos con los comandos submit

file y submit docommand.

v Los nombres de alias de trabajos sometidos con el comando

submit job.

Para utilizar el argumento from, deberá tener acceso a la base de datos del

planificador desde el sistema en el que se ejecuta Conman.

at=hora

Especifica la hora de inicio del trabajo que se vuelve a ejecutar, expresado

como:

hhmm [timezone|tz nombrehusohorario] [+n days | fecha]

donde:


+n days



dd/mm/aa.





pri=pri

Especifica la prioridad que se debe asignar al trabajo que se vuelve a

ejecutar. Si no especifica una prioridad, se le da al trabajo la misma

prioridad que el trabajo original.


step=paso

Especifica que el trabajo se vuelve a ejecutar utilizando este nombre en

lugar del nombre de trabajo original. Para obtener más información,

consulte las “Notas sobre el uso”.



Notas sobre el uso

Puede volver a ejecutar trabajos que están en estado succ, fail o abend. Un trabajo

que se ha vuelto a ejecutar se coloca en la misma secuencia de trabajos que el

trabajo original y hereda las dependencias del trabajo original. Si vuelve a ejecutar

un trabajo repetitivo (every), el trabajo que se ha vuelto a ejecutar se planificará de

modo que se ejecute con la misma frecuencia que el trabajo original.

Nota: Puede emitir rerun para trabajos de la secuencia de trabajos externa que

están en estado error. Los trabajos de la secuencia de trabajos externa

representan trabajos y secuencias de trabajos que se han especificado como

dependencias inter-red. El estado del trabajo se establece inicialmente en

extrn inmediatamente después de ejecutar una operación rerun, y Conman

empieza a comprobar el estado.

Cuando se utiliza ;from, el nombre del trabajo que se ha vuelto a ejecutar depende

del valor de la opción global retener nombres de trabajo reejecutados. Si la opción

se establece en Y, los trabajos reejecutados retienen los nombres de trabajo

originales. Si la opción se establece en N, a los trabajos reejecutados se les dan los

nombres de trabajo from (originales). Para obtener más información, consulte la


En las pantallas de Conman, los trabajos reejecutados se muestran con la notación

>>rerun as. Para hacer referencia a un trabajo reejecutado en otro comando, por

ejemplo altpri, debe utilizar el nombre de trabajo original.

Cuando un trabajo se vuelve a ejecutar con la opción ;step, el trabajo se ejecuta con

paso en vez de su nombre original. Dentro de un script de trabajo, puede utilizar el

comando jobinfo para devolver el nombre de trabajo y ejecutar el script de forma

diferente para cada repetición. Por ejemplo, en el siguiente script de UNIX, se

utiliza el comando jobinfo para establecer una variable denominada STEP con el

nombre utilizado para ejecutar el trabajo. Luego, se utilizará la variable STEP para

determinar cómo se ejecuta el script.

...

MPATH=`maestro`

STEP=`$MPATH/bin/jobinfo nombre_trabajo`

if [$STEP = JOB3]

then

...

STEP=JSTEP1

fi

if [$STEP = JSTEP1]

then

...

STEP=JSTEP2

fi

if [$STEP = JSTEP2]

then

...

fi

...


En pantallas de Conman, los trabajos reejecutados con la opción ;step se muestran

con la notación >>rerun step.

Para obtener más información sobre jobinfo, consulte el apartado “jobinfo” en la

página 257.

Ejemplos

Para volver a ejecutar el trabajo job4 de la secuencia de trabajos sked1 de la

estación de trabajo main, ejecute el comando siguiente:

rerun main#sked1.job4

Para volver a ejecutar el trabajo job5 de la secuencia de trabajos sked2 utilizando

la definición de trabajo para el trabajo jobx, en que la hora at del trabajo está

establecida en las 6:30 p.m. y la prioridad está establecida en 25, ejecute el

comando siguiente:

rr sked2.job5;from=jobx;at=1830;pri=25

Para volver a ejecutar el trabajo job3 de la secuencia de trabajos sked4 utilizando

el nombre de trabajo jstep2, ejecute el comando siguiente:

rr sked4.job3;step=jstep2

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Reejecución de una

instancia de trabajo″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling



|||

|

||||

|

||

|

||||

resource

Cambia el número de unidades totales de un recurso.

Debe tener acceso resource al recurso.

Sinopsis

resource [esttrabajo#]recurso;núm[;noask]

Argumentos


definida el recurso. El valor predeterminado es la estación de

trabajo en la que se ejecuta Conman.

resource Especifica el nombre del recurso.

núm Especifica el número total de unidades de recurso. Los valores

válidos son los comprendidos entre 0 y 1024.


la acción en cada recurso calificado.

Ejemplos

Para cambiar el número de unidades de recurso tapes por 5, ejecute el comando

siguiente:

resource tapes;5

Para cambiar el número de unidades de recurso jobslots de la estación de trabajo

site2 por 23, ejecute el comando siguiente:

res site2#jobslots;23

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Gestión de recursos

de la base de datos″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling



|||

|

||

|

||||

setsym

Selecciona un archivo archivador de plan de producción. Los comandos de

visualización subsiguientes muestran el contenido del plan de producción

archivado. La información de un archivo archivador de plan de producción no se

puede modificar.

Sinopsis

setsym [númarchivo]

Argumentos

númarchivo Especifica el número del archivo archivador del plan de

producción. Si no especifica un número de archivo de registro, el

puntero vuelve a cero, el plan de producción actual (Symphony).

Utilice el comando listsym para listar números de archivo

archivador.

Ejemplos

Para seleccionar el archivo archivador de plan de producción 5, ejecute el comando

siguiente:

setsym 5

Para seleccionar el plan de producción actual (Symphony), ejecute el comando

siguiente:

set


|||

|

||

|

|

showcpus

Muestra información sobre estaciones de trabajo y vínculos.

Sinopsis

sc [[dominio!]esttrabajo][;info|;link][;offline]

Argumentos

dominio Especifica el nombre de un dominio. El valor predeterminado es el

dominio en el que se ejecuta el comando.

esttrabajo Especifica el nombre de una estación de trabajo. El valor

predeterminado es la estación de trabajo en la que se ejecuta el

comando. Si no se especifican dominio ni estación de trabajo, la

salida será la siguiente:

v El comando siguiente muestra todas las estaciones de trabajo

que existen en el dominio de la estación de trabajo en la que se

ha ejecutado el comando, además de todos los gestores de

dominio conectados si la estación de trabajo es un gestor de

dominio.

conman "sc"

v El comando siguiente muestra todas las estaciones de trabajo

que existen en el dominio de la estación de trabajo en la que se

ha ejecutado el comando, sin los gestores de dominio

conectados.

conman "sc @"

info Muestra información en formato info.

link Muestra información en formato link.




Salida del comando

La salida del comando se produce en tres formatos, estándar, info y link.

Formato standard:

IDCPU

Nombre de la estación de trabajo a la que se aplica esta información.

EJEC Número de ejecución del archivo de Control de producción (Symphony).

NODO

El tipo de nodo y el tipo de estación de trabajo. Los tipos de nodo son los

siguientes:

v UNIX

v WINT

v OTROS

Los tipos de estaciones de trabajo son los siguientes:

v MASTER

v MANAGER

v FTA

v S-AGENT

v X-AGENT


LÍMITE

El límite de trabajos del planificador.

DELIMITACIÓN

La delimitación del trabajo del planificador.

FECHA HORA

Fecha y hora en la que el planificador ha empezado a ejecutar el plan de

producción actual (Symphony).

ESTADO

El estado de los vínculos de la estación de trabajo. Se muestran como

máximo de cinco caracteres del modo siguiente:

[L] [T|H|X] [I] [J] [W|H|X]

L El vínculo primario está abierto (vinculado) para su gestor de

dominio/superior.

T El vínculo es TCP/IP.

H La estación de trabajo está vinculada a través de su host.

X La estación de trabajo está vinculada como un agente ampliado

(agente x).

I El programa jobman ha finalizado la inicialización del inicio.

J El programa jobman se está ejecutando.

W La estación de trabajo está vinculada mediante TCP/IP.

F La estación de trabajo está completamente vinculada mediante una

conexión primaria y todas las secundarias.

Nota: Si la estación de trabajo que ejecuta Conman es el host del agente

ampliado, el estado del agente x es

LXI JX

Si la estación de trabajo que ejecuta Conman no es el host del agente

ampliado, el estado del agente x es

LHI JH

MÉTODO

Nombre del método de acceso especificado en la definición de estación de

trabajo. Sólo para agentes ampliados.

DOMINIO

Nombre del dominio del que la estación de trabajo es miembro.

Formato info:

IDCPU


VERSIÓN

La versión del programa jobman de IBM Tivoli Workload Scheduler.

HUSO HORARIO

El huso horario de la estación de trabajo. Es el mismo que el valor de la

variable de entorno TZ. Para un agente ampliado, es el huso horario de su

host.

INFO Versión de Sistema operativo y modelo de hardware. Para agentes

ampliados, no se lista información.

Formato link:

IDCPU



|||

|||

HOST Nombre de la estación de trabajo que actúa como host para un agente

estándar o un agente ampliado. Para gestores de dominio y agentes

tolerante a errores, es el mismo que IDCPU. Para estaciones de trabajo de

agente estándar, es el nombre del gestor de dominio. Para agentes

ampliados, es el nombre de la estación de trabajo host.

DISTINTIVOS

El estado de los vínculos de la estación de trabajo. Se muestran como

máximo de cinco caracteres del modo siguiente:

[A] [F] [s] [T]

A Se activa el vínculo automático en la definición de estación de

trabajo.

F Se activa la modalidad de Estado completo en la definición de

estación de trabajo.

s El ID del servidor mailman para la estación de trabajo.

T El vínculo está definido como TCP/IP.

DIREC

Número de puerto TCP para la estación de trabajo.

NODO

Nombre de nodo de la estación de trabajo.

Ejemplos

1. Para mostrar información sobre la estación de trabajo en la que está ejecutando

Conman en formato info, ejecute el comando siguiente:

showcpus ;info

2. Para mostrar información de vínculo fuera de línea para todas las estaciones de

trabajo, ejecute el comando siguiente:

sc @!@;link;off

3. Para mostrar información sobre la estación de trabajo, ejecute el comando

siguiente:

showcpus

Si ejecuta este comando en un entorno cuando la conexión primaria de la

estación de trabajo con su gestor de dominio o superior no está activa, recibirá

la salida siguiente:

MASTER 360 *WNT MASTER 10 0 12/04/03 13:48 I J MASTERDM

FTA1 360 WNT FTA 10 0 12/04/03 13:48 FTI JW MASTERDM


FTA3 360 WNT MANAGER 10 0 12/04/03 13:48 LTI JW DOMAIN1

FTA4 360 WNT FTA 10 0 12/04/03 13:48 F I J DOMAIN1

FTA5 360 WNT FTA 10 0 12/04/03 13:48 I J DOMAIN1

SA1 360 WNT S-AGENT 10 0 12/04/03 13:48 F I J DOMAIN1

XA_FTA4 360 OTHR X-AGENT 10 0 12/04/03 13:48 L I J DOMAIN1

FTA6 360 WNT MANAGER 10 0 12/04/03 13:48 F I J DOMAIN2



estación de trabajo con su gestor de dominio o superior está activa y por lo

menos existe una conexión secundaria que no está activa, recibirá la salida

siguiente:




FTA3 360 WNT MANAGER 10 0 12/04/03 13:48 FTI JW DOMAIN1


FTA5 360 WNT FTA 10 0 12/04/03 13:48 L I DOMAIN1



||

|

||

|

||

|

|||

||||||||||||||

|||||||





estación de trabajo con su gestor de dominio o superior y todas las conexiones

secundarias están activas, recibirá la salida siguiente:




FTA3 360 WNT MANAGER 10 0 12/04/03 13:48 FTI JW DOMAIN1


FTA5 360 WNT FTA 10 0 12/04/03 13:48 F I DOMAIN1





Véase también



Guía del usuario.


||||||

||||||||||

||||

showdomain

Muestra información de dominios.

Sinopsis

showdomain [dominio][;info][;offline]

Argumentos

dominio Especifica el nombre del dominio. El valor predeterminado es el

dominio en el que se ejecuta Conman. Se permiten caracteres

comodín.





Salida del comando

La salida del comando se produce en dos formatos, estándar e info.

Formato standard:

DOMINIO

Nombre del dominio al que se aplica esta información.

GESTOR

Nombre del gestor de dominio.

PADRE

Nombre del dominio padre.

Formato info:

DOMINIO

Nombre del dominio al que se aplica esta información.

CPU-MIEMBRO

Los nombres de las estaciones de trabajo del dominio.

TIPO-CPU

Tipo de cada estación de trabajo: MASTER, MANAGER, FTA, S-AGENT o

X-AGENT.

Ejemplos

Para mostrar información sobre el dominio masterdm, ejecute el comando

siguiente:

showdomain masterdm

Para mostrar las estaciones de trabajo miembros de todos los dominios en formato

info, ejecute el comando siguiente:

showdomain @;info

Véase también


modificación de propiedades de dominio″ en la publicación IBM Tivoli Workload



|||

|

||

|

||||

showfiles

Muestra información acerca de dependencias de archivo. Se produce una

dependencia de archivo cuando un trabajo o una secuencia de trabajos depende de

la existencia de uno o más archivos para que pueda comenzar su ejecución.

Sinopsis

sf [[esttrabajo#]archivo][;estado[;...]][;keys][;offline]

sf [[esttrabajo#]archivo][;estado[;...]][;deps[;keys | info | logon]][;offline]

Argumentos

esttrabajo Especifica el nombre de la estación de trabajo en la que existe el

archivo. El valor predeterminado es la estación de trabajo en la que

se ejecuta Conman. Se permiten caracteres comodín.

archivo Especifica el nombre del archivo. El nombre debe estar entre



invertidas (\) y subrayados (_). El valor predeterminado es mostrar

todas las dependencias de archivo. Se permiten caracteres comodín.

estado Especifica el estado de las dependencias de archivos que se deben

mostrar. El valor predeterminado es mostrar las dependencias de

archivos en todos los estados. Los estados son los siguientes:

yes El archivo existe y está disponible.

no El archivo no está disponible o no existe.

? Se está comprobando la disponibilidad.

<blanco>

El archivo aún no se ha comprobado o el archivo estaba

disponible y se ha utilizado para satisfacer una

dependencia de trabajo o de secuencia de trabajos.

keys Muestra una lista de una sola columna de los objetos seleccionados

por el comando.

deps Muestra información en formato deps. Utilice keys, info o logon

para modificar la pantalla.




Salida del comando

La salida del comando se produce en tres formatos: estándar, keys y deps. Los

argumentos keys, info y logon modifican la pantalla deps.

Formato standard:

Existe Estado de la dependencia de archivo.

Nombre del archivo

El nombre del archivo.

Formato keys: Se listan los archivos con un archivo en cada línea. Los nombres de

directorios no se incluyen. Cada archivo se lista en el formato siguiente:

wkstation#file


Formato deps: Se listan los archivos seguidos de los trabajos y las secuencias de

trabajos dependientes. Los trabajos se listan en formato showjobs estándar. Las

secuencias de trabajos se listan en formato showschedules estándar.

Formato deps;keys: Se listan, uno en cada línea, trabajos y secuencias de trabajos

que tienen dependencias de archivo, en el siguiente formato:

wkstation#jstream[.job]

Formato deps;info: Se listan los archivos, seguidos de los trabajos y las secuencias

de trabajos dependientes. Los trabajos se listan en formato showjobs;info estándar.

Las secuencias de trabajos se listan en formato showschedules estándar.

Formato deps;logon: Se listan los archivos seguidos de los trabajos y las

secuencias de trabajos dependientes. Los trabajos se listan en formato

showjobs;logon. Las secuencias de trabajos se listan en formato showschedules

estándar.

Ejemplos

Para mostrar el estado de una dependencia de archivo para

d:\apps\mis\lib\data4, ejecute el comando siguiente:

showfiles d:\apps\mis\lib\data4

Para mostrar fuera de línea el estado de todas las dependencias de archivo de

todas las estaciones de trabajo en formato deps, ejecute el comando siguiente:

sf @#@;deps;offline


|||

|

||

|

|

showjobs

Muestra información sobre trabajos.

Sinopsis

sj [seleccióntrab] [;keys | info | step | logon | retcod][;short | single][;offline]

sj [seleccióntrab] [;deps[;keys | info | logon]][;short | single][;offline]

sj [seleccióntrab|wkstation# {jobnumber.hhmm}] [;stdlist[;keys]][;short |

single][;offline]

Argumentos

seleccióntrab Consulte el apartado “Selección de trabajos en comandos” en la página

133.

esttrabajo El nombre de la estación de trabajo en la que se ejecuta el trabajo.


jobnumber El número de trabajo.

hhmm La hora de inicio del trabajo. Utilícela, junto con los argumentos

stdlist y single, para mostrar una instancia específica del trabajo.


por el comando.


step Muestra información en formato step.

logon Muestra información en formato logon.

retcod Muestra el código de retorno del trabajo.

stdlist Muestra información en formato stdlist. Utilice el argumento keys




short Acorta la pantalla para los trabajos every y rerun de modo que

incluyan sólo lo siguiente:

v La primera repetición

v Trabajos en estados diferentes

v Trabajos que coinciden exactamente

single Selecciona sólo el trabajo padre de una cadena que puede incluir

reejecuciones, repeticiones y trabajos de recuperación. El trabajo

debe identificarse por el número de trabajo de seleccióntrab. Esto es

especialmente útil con la opción stdlist.




Salida del comando

La salida del comando showjobs se produce en siete formatos: standard, keys,

info, step, logon, deps y stdlist. Los argumentos keys, info y logon modifican las

pantallas.

Formato standard:


CPU Estación de trabajo en la que se ejecuta el trabajo.

Planificación


Trabajo

El nombre del trabajo. La anotación siguiente puede preceder a un nombre

de trabajo:

>> rerun as

Un trabajo que se ha vuelto a ejecutar con el comando rerun o

como resultado de la recuperación automática.

>> rerun step

Un trabajo que se ha vuelto a ejecutar con el comando rerun ;step.

>> every run

La segunda ejecución y las ejecuciones subsiguientes de un trabajo

repetitivo (every).

>>recovery

Ejecución de un trabajo de recuperación.

Estado

El estado del trabajo o de la secuencia de trabajos. Los estados de los

trabajos son los siguientes:

abend El trabajo ha terminado con un código de salida distinto de cero.

abenp Se ha recibido una confirmación abend pero el trabajo no se ha

completado.

add Se está sometiendo el trabajo.

done El trabajo se ha completado en un estado desconocido.



exec El trabajo se está ejecutando.

extrn Sólo para dependencias inter-red, el estado es desconocido. Se ha

producido un error, se acaba de efectuar una acción de reejecución

en el trabajo de la secuencia de trabajos externa o bien la secuencia

de trabajos o el trabajo remoto no existen.

fail No se puede iniciar el trabajo.

fence La prioridad del trabajo está por debajo de la delimitación.

hold El trabajo está esperando la resolución de dependencias.

intro Se da entrada al trabajo para que el sistema lo inicie.

pend El trabajo se ha completado y está en espera de confirmación.

ready El trabajo está preparado para iniciarse y todas las dependencias se

han resuelto.

sched La hora at del trabajo no ha llegado.

succ El trabajo se ha completado con un código de salida de cero.

succp Se ha recibido una confirmación succ pero el trabajo no se ha

completado.

wait El trabajo está en estado de espera. (Agente ampliado)


Los estados de secuencia de trabajos son los siguientes:

abend La secuencia de trabajos ha terminado con un código de salida

distinto de cero.

add La secuencia de trabajos se ha agregado con intervención del

operador.

cancel La secuencia de trabajos se ha cancelado.

cancel pend

La secuencia de trabajos está pendiente de cancelación. La

cancelación se pospone hasta que se resuelven todas las

dependencias, incluida una hora de inicio (at).




extrn Sólo para dependencias inter-red, la secuencia de trabajos está en

una red de planificador remota y el estado es desconocido. Se ha



de trabajos o el trabajo INET no existen.

hold La secuencia de trabajos está esperando la resolución de

dependencias.

ready La secuencia de trabajos está preparada para iniciarse y todas las

dependencias se han resuelto.

stuck Se ha interrumpido la ejecución de la secuencia de trabajos. No se

inicia ningún trabajo sin intervención del operador.

succ La secuencia de trabajos se ha completado satisfactoriamente.

Pr Prioridad de la secuencia de trabajos o del trabajo. Un signo más (+) antes

de la prioridad significa que el trabajo se ha iniciado.

Inicio(Est)

Hora de inicio de la secuencia de trabajos o del trabajo. Los paréntesis

indican una estimación de la hora de inicio. Si la fecha de inicio es anterior

a 24 horas en el pasado o posterior a 24 horas en el futuro, se lista la fecha

en lugar de la hora.

Transc(Est)

Tiempo de ejecución de la secuencia de trabajos o del trabajo. Los

paréntesis indican una estimación basada en estadísticas registradas.

dependencias

Lista de dependencias de trabajos y comentarios. Se puede listar cualquier

combinación de lo siguiente:

v Para una dependencia follows, se muestra un nombre de secuencia de

trabajos o un nombre de trabajo.

v Para una dependencia opens, se muestra el nombre de archivo. Si el

archivo reside en un agente ampliado y su nombre tiene más de 25

caracteres, sólo se mostrarán los últimos 25 caracteres.

v Para una dependencia needs, se muestra un nombre de recurso entre

guiones (-). Si el número de unidades solicitadas es mayor que uno, se

muestra el número antes del primer guión.


v Para una hora deadline, se muestra la hora precedida de un corchete

angular (<).

v Para una frecuencia every, se muestra la frecuencia de repetición

precedida de un símbolo &.

v Para una hora until, se muestra la hora precedida de un corchete

angular (<).

v Para una dependencia prompt, se muestra el número de solicitud en

formato #núm. Para las solicitudes globales, el nombre de solicitud va a

continuación entre paréntesis.

v Para trabajos que se están ejecutando, se muestra el número de

identificación de proceso (PID) en formato #Jnnnnn.

v Los trabajos cometidos en UNIX utilizando los comandos at y batch de

IBM Tivoli Workload Scheduler tienen la etiqueta [Userjcl].

v Los trabajos cancelados tienen la etiqueta [Cancelled].

v Los trabajos cancelados con la opción ;pend tienen la etiqueta [Cancel

Pend].

v Los trabajos con horas until caducadas, incluidos los trabajos cancelados

con la opción ;pend, tienen la etiqueta [Until].

v [Recovery] significa que es necesaria la intervención del operador.

v [Confirm] significa que la confirmación es necesaria porque el trabajo se

ha planificado utilizando la palabra clave confirm.

v [Script] únicamente se aplica a las redes de extremo a extremo; esto

significa que este trabajo tiene un script centralizado y que Tivoli

Workload Scheduler for z/OS aún no lo ha descargado para el agente.

Formato keys: Se listan, uno en cada línea, nombres de trabajos en el formato

siguiente:

wkstation#jstream.job

Formato info:


Planificación


Trabajo


de trabajo:

>> rerun as



>> rerun step

Un trabajo que se ha vuelto a ejecutar con el comando rerun ;step.

>> every run


repetitivo (every).

>>recovery

Ejecución de un trabajo de recuperación.

Archivo de trabajo

El nombre del archivo ejecutable o del archivo script del trabajo. Puede


que los nombres de archivo largos pasen a la línea siguiente, produciendo

una paginación incorrecta. Para evitarlo, indique more a después de la

barra vertical. Por ejemplo:

conman “sj;info | more

Opc Opción de recuperación de trabajo, si hay alguno. Las opciones de

recuperación son RE para volver a ejecutar, CO para continuar y ST para

detener.

Trabajo

Nombre del trabajo de recuperación, si hay alguno.

Solicitud

Número de la solicitud de recuperación, si hay alguno.

Formato step: Windows no da soporte a este formato.


Planificación


Trabajo


de trabajo:

>> rerun as



>> repeated as


every.

Estado

El estado del trabajo o de la secuencia de trabajos. Para obtener más

información sobre el estado, consulte el apartado “Formato standard”.

Código de retorno

El código de retorno del trabajo.

NúmTrab

El número de identificación del proceso mostrado como #Jnnnnn.

Paso Lista de procesos descendientes que están asociados con el trabajo. Para

trabajos de agente ampliado, sólo se listan los procesos del host.

Formato logon:


Planificación


Trabajo


de trabajo:

>> rerun as




>> repeated as


every.

Estado

El estado del trabajo o de la secuencia de trabajos. Para obtener más

información sobre el estado, consulte el apartado “Formato standard”.

Código de retorno

El código de retorno del trabajo.

NúmTrab

El número de identificación del proceso mostrado como #Jnnnnn.

Inicio de sesión

El nombre de usuario bajo el que se ejecuta el trabajo.

Formato stdlist: Jobmon crea automáticamente un archivo de lista estándar en

Windows, o Jobman lo crea en UNIX, para cada trabajo iniciado por Jobmon y

Jobman. Puede mostrar el contenido de los archivos de lista estándar mediante

Conman. Un archivo de lista estándar contiene:

v Mensajes de cabecera y cola.

v Comandos con ″echo″.

v La salida stdout del trabajo.

v La salida stderr del trabajo.

Para especificar un formato de fecha determinado que se deberá utilizar en los

archivos de lista estándar, cambie el formato de fecha de IBM Tivoli Workload

Scheduler antes de crear los archivos de lista estándar. Hágalo modificando el

formato de fecha en la configuración local.

En función del entorno, cambie el formato en la configuración local llevando a

cabo los pasos que se indican a continuación:

v En UNIX, establezca la variable LANG en el entorno cuando se inicie Netman.

Si no se establece la variable LANG, el entorno local del sistema operativo se

establece, de forma predeterminada, en ″C″.

v En Windows, lleve a cabo los pasos siguientes:

1. Vaya a Panel de control→Configuración regional y establezca el entorno local

(ubicación).

2. Con el botón derecho del ratón, haga clic en ″Mi PC″, vaya a Propiedades,

haga clic en ″Avanzado″, vaya a Variables de entorno y establezca la variable

LANG como variable del sistema.

3. Concluya y reinicie el sistema.

Se muestran los archivos de lista estándar para los trabajos seleccionados.

Formato stdlist;keys: Se listan, uno en cada línea, los nombres de los archivos de

lista estándar para los trabajos seleccionados.

Formato deps: Se listan los trabajos utilizados en las dependencias follows,

seguidos de los trabajos y las secuencias de trabajos dependientes. Los trabajos se

listan en formato showjobs estándar. Las secuencias de trabajos se listan en

formato showschedules estándar.

Formato deps;keys: Se listan, uno en cada línea, los trabajos y las secuencias de

trabajos que tienen dependencias follows.


||||

|

|

|

|

||||

||

|||

|

||

|||

|

|

Formato deps;info: Se listan los trabajos utilizados en las dependencias follows,


listan en formato showjobs;info estándar. Las secuencias de trabajos se listan en


Formato deps;logon: Se listan los trabajos utilizados en las dependencias follows,


listan en formato showjobs;logon. Las secuencias de trabajos se listan en formato

showschedules estándar.

Ejemplos

Para mostrar el estado de todos los trabajos de todas las secuencias de trabajos

acctg de la estación de trabajo site3, ejecute el comando siguiente:

showjobs site3#acctg@.@

Para mostrar el estado de todos los trabajos de la estación de trabajo en la que está

ejecutando Conman en formato logon, ejecute el comando siguiente:

sj ;logon

Para mostrar el estado de todos los trabajos en estado hold de todas las estaciones

de trabajo en formato deps, ejecute el comando siguiente:

sj @#@.@+state=hold;deps

Para mostrar todos los archivos de lista estándar para el trabajo sendmail de la

secuencia de trabajos mail de la estación de trabajo WN1, funcionando en un

entorno Windows, ejecute el comando siguiente:

sj WN1#mail.sendmail;stdlist

La salida es la siguiente:

=================================================================

= JOB : WN1#MAIL.SENDMAIL

= USER : xpress

= JCLFILE : \users\xpress\sendxpmail

= Job Number : 8027

= Fri Jun 5 12:17:10 1997

=================================================================

...

... <stdout, stderr y comandos con "echo">

...

=================================================================

= Exit Status : 0

= System Time (Seconds) : 0 Elapsed Time (Minutes) : 0

= User Time (Seconds) : 0

= Fri Jun 5 12:17:12 1997

==================================================================

donde:

Exit Status

Estado del trabajo cuando finalizó.

Elapsed Time

Tiempo transcurrido para el trabajo.

System Time

Tiempo que el sistema del kernel ha invertido para el trabajo.

User Time

Tiempo que el usuario del sistema ha invertido para el trabajo.


|||

|

||

|

||

|

|||

|

|

||||||||||||||||

|

||

||

||

||

Nota: Los campos System Time y User Time sólo se utilizan en UNIX. En

Windows, sus valores siempre se establecen en 0. Esto es debido a que, en

Windows, el proceso joblnch.exe se ejecuta en muy poco tiempo, que se

puede considerar nulo.

En el siguiente ejemplo se muestra el estado del trabajo dbseload con código de

retorno 7 y estado SUCCESSFUL:

$ conman sj workstation#DAILY_DB_LOAD

TWS for UNIX (AIX)/CONMAN 8.2 (1.36.1.7)

Licensed Materials Property of IBM

5698-WKB

(C) Copyright IBM Corp 1998,2001

US Government User Restricted Rights

Use, duplication or disclosure restricted by GSA ADP Schedule Contract

with IBM Corp.

Installed for user ‘’

Locale LANG set to “en_US”

Schedule (Exp) 09/30/03 (#126) on MASTER. Batchman LIVES. Limit: 10,

Fence: 0, Audit Level: 1

sj workstation#DAILY_DB_LOAD

(Est) (Est)

CPU Schedule Job State Pr Start

Elapse Dependencies Return Code

WORKSTATION #DAILY_DB_LOAD **************************************** SUCC 10 22:11

00:04

DATASPLT SUCC 10 22:11

00:01 #J17922 0

DATAMRGE ABEND 10 22:12

00:01 #J17924 1

CHCKMRGE SUCC 10 22:12

00:01 #J17926 0

DATACLNS SUCC 10 22:12

00:01 #J17932 0

DATARMRG SUCC 10 22:13

00:01 #J18704 0

DBSELOAD SUCC 10 22:13

00:01 #J18706 7

DATAREPT SUCC 10 22:13

00:01 #J18712 0

DATARTRN SUCC 10 22:14

00:01 #J18714 0

$

También existe un nuevo argumento, retcod, que si se utiliza junto con el

argumento keys proporciona el código de retorno para un trabajo determinado, tal

como se muestra en el ejemplo siguiente:

$ conman sj workstation#daily_db_load.dbseload\;keys\;retcod

TWS for UNIX (AIX)/CONMAN 8.2 (1.36.1.7)


5698-WKB



Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM

Corp.

Installed for user ‘’

Locale LANG set to “en_US”

Schedule (Exp) 10/16/03 (#150) on MASTER. Batchman LIVES. Limit: 10, Fence:

0,

Audit Level: 1

sj workstation#daily_db_load.dbseload;keys;retcod

8$


||||

||

||||||||||||||||||||||||||||||||||||

|||

|||||||||||||||

La función retcod, si se integra en un script, se puede convertir en totalmente

potente.

Véase también



Guía del usuario.


||

|||

showprompts

Muestra información sobre solicitudes.

Sinopsis

sp [selecciónsolicitud][;keys][;offline]

sp [selecciónsolicitud] [;deps[;keys | info | logon]][;offline]

Argumentos

selecciónsolicitud

[nombsolicitud | [esttrabajo#]númmensaje][;estado[;...]]

nombsolicitud


comodín.

esttrabajo

Especifica el nombre de la estación de trabajo en la que se ha

emitido una solicitud sin nombre. El valor predeterminado es la

estación de trabajo en la que se ejecuta Conman.

númmensaje

Especifica el número de mensaje de una solicitud sin nombre.

estado Especifica el estado de las solicitudes que se deben mostrar. Los

estados son los siguientes:

YES Si ha respondido a la solicitud con y.

NO Si ha respondido a la solicitud con n.

ASKED

Se ha emitido la solicitud, pero no se ha dado ninguna

respuesta.

INACT

La solicitud no se ha emitido.

keys Muestra una lista de una sola columna de los objetos seleccionados por el

comando.

deps Muestra información en formato deps. Utilice keys, info o logon para

modificar la pantalla.



offline

Envía la salida del comando al dispositivo de salida de Conman. Para

obtener más información sobre este dispositivo, consulte el apartado

“Salida fuera de línea” en la página 128.

Salida del comando



Formato standard:

Estado

Estado de la solicitud.


Mensaje o solicitud

Para solicitudes con nombre, número de mensaje, nombre y texto de la

solicitud. Para solicitudes sin nombre, número de mensaje, nombre del

trabajo o de la secuencia de trabajos y texto de la solicitud.

Formato keys: Se listan las solicitudes, una en cada línea. Las solicitudes con

nombre se listan con sus números de mensaje y nombres. Las solicitudes sin

nombre se listan con sus números de mensaje y los nombres de los trabajos o de

las secuencias de trabajos donde aparecen como dependencias.

Formato deps: Se listan solicitudes utilizadas como dependencias, seguidas de los

trabajos y de las secuencias de trabajos dependientes. Los trabajos se listan en

formato showjobs estándar. Las secuencias de trabajos se listan en formato



que tienen dependencias de solicitud.

Formato deps;info: Se listan solicitudes utilizadas como dependencias, seguidas

de los trabajos y de las secuencias de trabajos dependientes. Los trabajos se listan

en formato showjobs;info estándar. Las secuencias de trabajos se listan en formato


Formato deps;logon: Se listan solicitudes utilizadas como dependencias, seguidas

de los trabajos y de las secuencias de trabajos dependientes. Los trabajos se listan

en formato showjobs;logon. Las secuencias de trabajos se listan en formato


Ejemplos

Para mostrar el estado de todas las solicitudes emitidas en la estación de trabajo en

la que está ejecutando Conman, ejecute el comando siguiente:

showprompts

Para mostrar el estado de todas las solicitudes mis que se han emitido, en formato

deps, ejecute el comando siguiente:

sp mis@;asked;deps

Para mostrar el estado de la solicitud número 34 de la estación de trabajo main,


sp main#34

Véase también


modificación de propiedades de solicitud″ en la publicación IBM Tivoli Workload



|||

|

||

|

||

|

||||

showresources

Muestra información sobre recursos.

Sinopsis

sr [[esttrabajo#]nombrerecurso][;keys][;offline]

sr [[esttrabajo#]nombrerecurso][;deps[;keys | info | logon]][;offline]

Argumentos


definida el recurso. El valor predeterminado es la estación de

trabajo en la que se ejecuta Conman.

nombrerecurso Especifica el nombre del recurso. Se permiten caracteres comodín.


por el comando.








Salida del comando



Formato standard:

CPU La estación de trabajo en la que se ha definido el recurso.

Recurso El nombre del recurso.

Total Número total de unidades de recurso definidas.

Disponible Número de unidades de recurso que no se han asignado.

Cant Número de unidades de recurso asignadas a un trabajo o a una


Usado por Nombre del trabajo o de la secuencia de trabajos.

Formato keys: Se listan las solicitudes, una en cada línea.

Formato deps: Se listan recursos utilizados como dependencias, seguidos de los

trabajos o las secuencias de trabajos dependientes. Los trabajos se listan en formato

showjobs estándar. Las secuencias de trabajos se listan en formato showschedules

estándar.


que tienen dependencias de recurso.

Formato deps;info: Se listan recursos utilizados como dependencias, seguidos de

los trabajos o las secuencias de trabajos dependientes. Los trabajos se listan en

formato showjobs;info estándar. Las secuencias de trabajos se listan en formato



Formato deps;logon: Se listan recursos utilizados como dependencias, seguidos

de los trabajos o las secuencias de trabajos dependientes. Los trabajos se listan en

formato showjobs;logon. Las secuencias de trabajos se listan en formato


Ejemplos

Para mostrar información sobre todos los recursos de la estación de trabajo en la

que está ejecutando Conman, ejecute el comando siguiente:

showresources

Para mostrar información sobre el recurso dbase de la estación de trabajo main en

formato deps, ejecute el comando siguiente:

sr main#dbase;deps

Véase también


modificación de propiedades de recurso″ en la publicación IBM Tivoli Workload



|||

|

||

|

||||

showschedules

Muestra información sobre secuencias de trabajo.

Sinopsis

ss [selecciónsecuenciatrab][;keys][;offline]

ss [selecciónsecuenciatrab][;deps[;keys | info | logon]][;offline]

Argumentos





por el comando.








Salida del comando



Formato standard:

CPU Estación de trabajo en la que se ejecuta la secuencia de trabajos.

Planificación


Estado

Estado de la secuencia de trabajos. Los estados son los siguientes:

add La secuencia de trabajos se ha agregado con intervención del

operador.

abend La secuencia de trabajos ha terminado con un código de salida

distinto de cero.

cancel La secuencia de trabajos se ha cancelado.

cancel pend

La secuencia de trabajos está pendiente de cancelación. La

cancelación se pospone hasta que se resuelven todas las

dependencias, incluida una hora de inicio (at).




extrn Sólo para dependencias inter-red, la secuencia de trabajos está en

una red de planificador remota y el estado es desconocido. Se ha




de trabajos o el trabajo INET no existen.

hold La secuencia de trabajos está esperando la resolución de las

dependencias.

ready La secuencia de trabajos está preparada para iniciarse y se han

resuelto todas las dependencias.

stuck Se ha interrumpido la ejecución de la secuencia de trabajos. No se

inicia ningún trabajo sin intervención del operador.

succ La secuencia de trabajos se ha completado satisfactoriamente.

Pr Prioridad de la secuencia de trabajos.

Inicio(Est)

Hora de inicio de la secuencia de trabajos. Los paréntesis indican una

estimación de la hora de inicio. Si la fecha de inicio es anterior a 24 horas

en el pasado o posterior a 24 horas en el futuro, se lista la fecha en lugar

de la hora.

Transc(Est)

Tiempo de ejecución de la secuencia de trabajos. Los paréntesis indican

una estimación basada en estadísticas registradas.

Núm Trab

Número de trabajos de la secuencia de trabajos.

Trab OK

Número de trabajos que se han completado satisfactoriamente.

Lím Planif

Límite de trabajos de la secuencia de trabajos. Si no se lista ninguno, no

hay ningún límite en vigor.

dependencias

Lista de dependencias de secuencias de trabajos y comentarios. Se puede

listar cualquier combinación de lo siguiente:

v Para una dependencia follows, se muestra un nombre de secuencia de

trabajos o un nombre de trabajo.

v Para una dependencia opens, se muestra el nombre de archivo. Si el

archivo reside en un agente ampliado y su nombre tiene más de 25

caracteres, sólo se mostrarán los últimos 25 caracteres.

v Para una dependencia needs, se muestra un nombre de recurso entre

guiones (-). Si el número de unidades solicitadas es mayor que uno, se

muestra el número antes del primer guión.

v Para una hora until, se muestra la hora precedida de un corchete

angular (<).

v Para una dependencia prompt, el número de solicitud se muestra

como#núm. Para las solicitudes globales, el nombre de solicitud va a

continuación entre paréntesis.

v Las secuencias de trabajos canceladas tienen la etiqueta [Cancelled].

v Las secuencias de trabajos canceladas con la opción ;pend tienen la

etiqueta [Cancel Pend].

v Para una hora deadline, se muestra la hora precedida de un corchete

angular (<).


v Las secuencias de trabajos con horas until caducadas, incluidas las

secuencias de trabajos canceladas con la opción ;pend, tienen la etiqueta

[Until].

v Las secuencias de trabajos que contienen la palabra clave carryforward

tienen la etiqueta [Carry].

v Para secuencias de trabajos que se han pasado desde el día anterior, se

muestran el nombre original y la fecha entre corchetes.

Formato keys: Se listan las secuencias de trabajos una en cada línea.

Formato deps: Se listan secuencias de trabajos utilizadas como dependencias,

seguidas de los trabajos y las secuencias de trabajos dependientes. Los trabajos se

listan en formato showjobs estándar. Las secuencias de trabajos se listan en


Formato deps;keys: Las secuencias de trabajos que tienen dependencias follows

se listan una en cada línea.

Formato deps;info: Se listan secuencias de trabajos utilizadas como dependencias,

seguidas de los trabajos y las secuencias de trabajos dependientes. Los trabajos se

listan en formato showjobs;info estándar. Las secuencias de trabajos se listan en


Formato deps;logon: Se listan secuencias de trabajos utilizadas como

dependencias, seguidas de los trabajos y las secuencias de trabajos dependientes.

Los trabajos se listan en formato showjobs;logon. Las secuencias de trabajos se

listan en formato showschedules estándar.

Ejemplos

Para mostrar el estado de todas las secuencias de trabajos en estado hold de la

estación de trabajo en la que está ejecutando Conman, ejecute el comando

siguiente:

showschedules @+state=hold

Para mostrar el estado de todas las secuencias de trabajos corp de la estación de

trabajo site2 en formato deps;info, ejecute el comando siguiente:

ss site2#corp@;deps;info

Para mostrar fuera de línea el estado de todas las secuencias de trabajos que están

en estado abend en todas las estaciones de trabajo, ejecute el comando siguiente:

ss @#@+state=abend;off

Para mostrar el estado de todas las secuencias de trabajos de todas las estaciones

de trabajo, ejecute el comando siguiente:

%ss @#@

Después de ejecutar el comando, recibirá una salida parecida a la siguiente:

CPU Schedule State Pr Start Elapse # OK Lim

TWS820A #SCHED-1 ABEND 10 09/03 0:00 100 0

TWS820A #SCHED-2 READY 10 100 0

TWS820A #SCHED-3 ABEND 10 09/03 0:00 100 0

TWS820A #SCHED-4 EXEC 10 09/03 100 0



TWS820A #SCHED-7 SUCC 10 09/03 0:02 2 2

TWS820A #SCHED-8 READY 10 ( 0:01) 1 0


||||

|

||

|

||

|

||

|

|

|||||||||

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Visualización de

una secuencia de trabajos″ en la publicación IBM Tivoli Workload Scheduler Job



||||

shutdown

Detiene de forma incondicional todos los procesos de producción del planificador,

incluidos Batchman, Jobman, Netman, Mailman, todos los servidores Mailman y

todos los transcriptores.

Debe tener acceso shutdown a la estación de trabajo.

Sinopsis

shutdown [;wait]

Argumentos

wait Espera a que se hayan detenido todos los procesos antes de

solicitar otro comando.

Notas sobre el uso

El comando shutdown sólo detiene los procesos de la estación de trabajo en la que

se está ejecutando Conman. Para reiniciar únicamente Netman, ejecute el comando

StartUp. Para obtener más información sobre el comando StartUp, consulte el

apartado “StartUp” en la página 276. Para reiniciar todo el árbol de procesos,

ejecute un comando start de Conman.

Debe ejecutar un comando unlink @ de Conman antes de ejecutar un comando

shutdown.

Ejemplos

Para concluir la producción en la estación de trabajo en la que está ejecutando

Conman, ejecute el comando siguiente:

unlink @

shutdown

Para concluir la producción en la estación de trabajo en la que está ejecutando

Conman y esperar a que se detengan todos los procesos, ejecute el comando

siguiente:

unlink@;noask

shut ;wait


|||

||

|||

||

|

start

Inicia los procesos de producción del planificador.

Debe tener acceso start a la estación de trabajo.

Sinopsis

start[dominio!]esttrabajo[;mgr][;noask][;demgr]

Argumentos

dominio Especifica el nombre del dominio en el que se inician las estaciones

de trabajo. Se permiten caracteres comodín.

Este argumento es útil cuando se inicia más de una estación de

trabajo en un dominio. Por ejemplo, para iniciar todos los agentes

del dominio stlouis, utilice el siguiente comando:

start stlouis!@

Si dominio se omite y esttrabajo contiene caracteres comodín, el


Conman.

esttrabajo Especifica el nombre de la estación de trabajo que se debe iniciar.


mgr Esto sólo se puede entrar en la estación de trabajo en la que se está

ejecutando Conman. Inicia la estación de trabajo local como gestor

de dominio. La estación de trabajo se convierte en el nuevo gestor

de dominio y el gestor de dominio actual se convierte en un agente

tolerante a errores. Este formato del comando generalmente va a

continuación del comando stop. Tenga en cuenta que el método

preferido para conmutar un gestor de dominio consiste en utilizar

un comando switchmgr. Para obtener más información, consulte el

“switchmgr” en la página 230.



demgr Esta opción impide la apertura de conexiones externas durante el

tiempo de transición entre el momento en que se inicia un agente

como gestor de dominio antiguo y el momento en que se ejecuta el

comando switchmgr, privando al agente de la función de gestor de

dominio. Esta opción se ejecuta automáticamente pero, hasta que el

gestor de dominio antiguo ha procesado el evento switchmgr (por

ejemplo, en el caso de un reinicio retardado o de un reinicio

después de reparar un agente dañado), se debe utilizar la opción

demgr para iniciar el gestor de dominio antiguo desde la línea de

comandos local. Para conocer más detalles sobre esta opción,

consulte la publicación IBM Tivoli Workload Scheduler - Guía de

planificación e instalación.

Notas sobre el uso

El comando start se utiliza al principio de cada día para reiniciar el planificador a

continuación del proceso de preproducción. En ese momento hace que los agentes

estándar y los agentes tolerante a errores vinculados automáticamente se inicialicen

e inicien automáticamente. Los agentes que no se vinculan automáticamente se

inicializan e inician cuando se ejecuta un comando link.


|

|||||||||||||

Suponiendo que el usuario tenga acceso start a las estaciones de trabajo que se

están iniciando, se aplican las reglas siguientes:

v Un usuario que ejecuta Conman en el gestor de dominio maestro puede iniciar



puede iniciar cualquier estación de trabajo de dicho dominio y de los dominios

subordinados. El usuario no puede iniciar estaciones de trabajo en dominios de

igual.

v Un usuario que ejecuta Conman en un agente puede iniciar estaciones de trabajo

de las que dicho agente es el host.

Ejemplos

En la ilustración y la tabla siguientes se muestran las estaciones de trabajo

iniciadas por comandos start ejecutados por usuarios en diversas ubicaciones de la

red.


Comando

Iniciada por

Usuario1

Iniciada por

Usuario2

Iniciada por

Usuario3

start @!@ Se han iniciado

todas las estaciones

de trabajo.

DM2

A21

A22

DM4

A41

A42

A21

start @ DM1

A11

A12

DM2

A21

A22

A21

start DOMAIN3!@ DM3

A31

A32

No se permite. No se permite

start DOMAIN4!@ DM4

A41

A42

DM4

A41

A42

No se permite

start DM2 DM2 DM2 No se permite

start A42 A42 A42 No se permite

start A31 A31 No se permite. No se permite

Figura 4. Estaciones de trabajo iniciadas de la red


status

Muestra el mensaje de cabecera de Conman y el estado de producción de IBM


Sinopsis

status

Salida del comando

A continuación de la palabra Schedule en la segunda línea de la salida, la

modalidad del plan de producción (Symphony) se muestra entre paréntesis. Puede

aparecer la información Def o Exp. Def significa que el plan de producción está en

modalidad no expandida y Exp significa que está en modalidad expandida. La

modalidad del plan de producción la determina el valor de la opción global

expanded version. Con IBM Tivoli Workload Scheduler, Versión 8.2, las bases de

datos y los planes siempre se expanden, pero esta información aparece a efectos de


Ejemplos

En el siguiente ejemplo se muestra el estado del plan de producción actual. A

continuación, establece el puntero del plan de producción en 2 y muestra el estado

de dicho plan de producción.

%status

TWS for WINDOWS NT/CONMAN 8.2 (1.36.1.7)


5698-WKB



Use, duplication or disclosure restricted by GSA ADP Schedule Contract

with IBM Corp.

Schedule (Exp) 05/19/03 (#17) on DEMOCPU. Batchman down.

Limit: 30, Fence: 0, Audit Level: 1


stop

Detiene los procesos de producción del planificador. Para detener el proceso

Netman, utilice el comando shutdown. Debe tener acceso stop a la estación de

trabajo.

Sinopsis

stop [dominio!]esttrabajo[;wait][;noask]

Argumentos

dominio Especifica el nombre del dominio en el que se detienen las

estaciones de trabajo. Dado que las estaciones de trabajo tienen

nombres exclusivos, el dominio no es necesario cuando se detiene

una estación de trabajo específica. Se permiten caracteres comodín.

Este argumento es útil cuando se detiene más de una estación de

trabajo en un dominio. Por ejemplo, para detener todos los agentes

del dominio stlouis, utilice el siguiente comando:

stop stlouis!@

Si dominio se omite y esttrabajo contiene caracteres comodín, el


Conman.

esttrabajo Especifica el nombre de la estación de trabajo que se debe detener.


wait Especifica no aceptar otro comando hasta que se hayan detenido

todos los procesos.



Notas sobre el uso

Si el comando stop no puede aplicarse a una estación de trabajo lejana (por

ejemplo, si la ruta de TCP/IP no está disponible), el comando se almacena

localmente en un archivo pobox y se envía a la estación de trabajo cuando ésta

pasa a estar vinculada.

Suponiendo que el usuario tenga acceso stop a las estaciones de trabajo que se

están deteniendo, se aplican las reglas siguientes:

v Un usuario que ejecuta Conman en el gestor de dominio maestro puede detener



puede detener cualquier estación de trabajo de dicho dominio y de los dominios

subordinados. El usuario no puede detener estaciones de trabajo en dominios de

igual.

v Un usuario que ejecuta Conman en un agente puede detener cualquier estación

de trabajo del dominio local.

Al emitir un comando stop @ en un gestor de dominios, se ejecutará un comando

conman stop local en las CPU remotas. El comando se empieza a ejecutar en las

estaciones de trabajo más bajas de la jerarquía de la red y al final se ejecuta en el

gestor de dominio. Sin embargo los archivos Symphony no se actualizarán hasta

que no se apaguen las CPU. Por lo tanto, si emite un comando conman sc@!@

desde cualquier CPU, la información resultante podría mostrar una imagen precisa

de los estados de las CPU, incluso del gestor de dominio.


Ejemplos

En la ilustración y la tabla siguientes se muestran las estaciones de trabajo

detenidas por distintos comandos stop ejecutados por usuarios en distintas

ubicaciones de la red.


Comando

Detenida por

Usuario1

Detenida por

Usuario2

Detenida por

Usuario3

stop @!@ Se han detenido

todas las estaciones

de trabajo.

DM2

A21

A22

DM4

A41

A42

DM2

A21

A22

stop @ DM1

A11

A12

DM2

A21

A22

DM2

A21

A22

stop DOMAIN3!@ DM3

A31

A32


stop DOMAIN4!@ DM4

A41

A42

DM4

A41

A42

No se permite.

stop DM2 DM2 DM2 DM2

stop A42 A42 A42 No se permite.

stop A31 A31 No se permite. No se permite.

Figura 5. Estaciones de trabajo detenidas de la red


stop ;progressive

Detiene jerárquicamente los procesos de producción del planificador cuando se ha

definido por lo menos una estación de trabajo como Behindfirewall en una red

IBM Tivoli Workload Scheduler Versión 8.2. Es parecido al comando stop @!@, pero

es más eficaz en una mejoría del rendimiento de ejecución de planes. El comando

no se ejecuta desde el dominio en que se ha emitido inicialmente el comando para

cada dominio subordinado, sino que se ejecuta en cada nivel jerárquico.

Debe tener acceso stop a la estación de trabajo.

Sinopsis

stop ;progressive

Notas sobre el uso

Cuando se emite el comando en un gestor de dominio, se detienen todas las

estaciones de trabajo de dicho dominio y, a continuación, se detiene el propio

gestor de dominio y se sigue ejecutando el comando en los dominios

subordinados. El comando se sigue ejecutando de esta forma jerárquica, el gestor

de dominio detiene las estaciones de trabajo del mismo dominio, se detiene a sí

mismo y luego se continúa ejecutando en los dominios subordinados.

Ejemplos

La Figura 5 en la página 220 y la tabla siguiente muestran las estaciones de trabajo

detenidas mediante la emisión del comando stop ;progressive en DM2.

Comando Detenida por DM2 Detenida por DM4

stop ;progressive A21

A22

DM2

A41

A42

DM4


submit docommand

Somete un comando que se debe iniciar como un trabajo del planificador.

Debe tener acceso submit al trabajo. Para incluir las dependencias needs y prompt,

debe tener acceso use a los recursos y a las solicitudes globales.

Sinopsis

sbd [esttrabajo#]″mdt″[;alias[=nombre]][;into=secuenciatrab]

[;opcióntrab[;...]]

Argumentos

esttrabajo

Especifica el nombre de la estación de trabajo en la que se iniciará el

trabajo. Se permiten caracteres comodín, en cuyo caso el trabajo se inicia en

todas las estaciones de trabajo calificadas. El valor predeterminado es la

estación de trabajo en la que se ejecuta Conman. No puede especificar un

dominio o una clase de estación de trabajo.

mdt Especifica un comando de sistema válido de un máximo de 255 caracteres.

El comando entero debe estar entre comillas (″). Se trata al comando como

un trabajo y se aplican todas las reglas de los trabajos.

alias=nombre

Especifica un nombre exclusivo que se debe asignar al trabajo. Si se entra

la palabra clave alias sin especificar ningún nombre, se crea uno utilizando

como máximo los seis primeros caracteres alfanuméricos (en mayúsculas)

del comando, según el número de caracteres que contenga el comando,

seguidos de un número aleatorio de diez dígitos. Si el comando contiene

espacios en blanco, se crea el nombre utilizando como máximo los seis

primeros caracteres alfanuméricos anteriores al espacio en blanco. Por

ejemplo, si el comando es ″rm apfile″, el nombre generado será parecido a

RM0123456789. Si el comando contiene más de seis caracteres

alfanuméricos, como por ejemplo ″wlsinst″, el nombre generado será

wlsins0396578515.

Si no se incluye alias la primera vez que se someta el comando, se creará

un nombre de trabajo utilizando como máximo 255 caracteres del nombre

del comando. Si se somete por segunda vez un comando desde la misma

estación de trabajo, la palabra clave alias es obligatoria y debe ser

exclusiva para cada sometimiento del comando.

into=secuenciatrab

Especifica el nombre de la secuencia de trabajos en la que se colocará el

trabajo para iniciarlo. Entre el nombre del modo siguiente:

[esttrabajo#]secuenciatrab Si no especifica ninguna esttrabajo, el valor

predeterminado es la estación de trabajo en la que se ejecuta Conman. Si

no se utiliza into, el trabajo se agrega a la secuencia de trabajos JOBS.

opcióntrab

Especifique una de las siguientes opciones:

at= hhmm [timezone|tz nombrehusohorario] [+n days | mm/dd/aa] |

[absolute | abs]

confirmed

deadline=hora [timezone|tz nombrehusohorario][+n day[s | mm/dd/aa]

every=frecuencia


follows=[agentered::][esttrabajo#]secuenciatrab{.trabajo | @} |

trabajo[;nocheck][;wait=hora][,...]

interactive

logon=usuario




rccondsucc″Condición éxito″

recovery=stop | continue | rerun

after [esttrabajo#] nombtrabajo


until hora [timezone|tz nombrehusohorario][+nday[s] | [absolute | abs]]

[onuntil acción]

Notas sobre el uso

Si no especifica una estación de trabajo con follows, needs u opens, el valor

predeterminado es la estación de trabajo del trabajo. Si el trabajo se ejecuta en un

agente tolerante a errores, y desea incluir una dependencia prompt o

recoveryprompt, el directorio de mozart (TWShome/mozart) del gestor de dominio

maestro debe ser accesible, ya sea montado o compartido.

Ejemplos

Para someter un comando rm en la secuencia de trabajos JOBS con una

dependencia follows, ejecute el comando siguiente:

submit docommand="rm apfile";follows sked3

Para someter un comando sort con el alias sortit y colocar el trabajo en la

secuencia de trabajos reports con una hora at de las 5:30 p.m., ejecute el comando

siguiente:

sbd "sort < file1 > file2";alias=sortit;into=reports;at=1730

Para someter comandos chmod en todas las estaciones de trabajo cuyos nombres

empiecen por site, ejecute el comando siguiente:

sbd site@#"chmod 444 file2";alias


|||

|

|||

|

||

|

|

submit file

Somete un archivo que se debe iniciar como un trabajo del planificador.



Sinopsis

sbf nombarchivo[;alias[=nombre]][;into=secuenciatrab][;opcióntrab[;...]][;noask]

Argumentos

nombarchivo

Especifica el nombre del archivo, hasta 255 caracteres. Se permiten

caracteres comodín. El nombre debe estar entre comillas (″) si contiene

caracteres distintos de los siguientes: caracteres alfanuméricos, guiones (-),

barras inclinadas (/), barras inclinadas invertidas (\) y subrayados (_).

alias=nombre

Especifica un nombre exclusivo que se debe asignar al trabajo. Si se entra

la palabra clave alias sin especificar ningún nombre, se crea uno utilizando

como máximo los seis primeros caracteres alfanuméricos (en mayúsculas)

del nombre de archivo, según el número de caracteres que contenga el

nombre de archivo, seguidos de un número aleatorio de diez dígitos. Por

ejemplo, si el nombre de archivo es jclttx5, el nombre generado será

parecido a JCLTTX0123456789.

Si no incluye alias, se creará un nombre de archivo utilizando como

máximo 255 caracteres alfanuméricos del nombre base del archivo, en

mayúsculas.

En cualquiera de los dos casos anteriores, si el nombre de archivo no

empieza por una letra, se le solicitará que utilice alias= nombre.

Si se somete por segunda vez un archivo desde la misma estación de

trabajo, la palabra clave alias es obligatoria y debe ser exclusiva para cada

sometimiento del archivo.

into=secuenciatrab

Nombre de la secuencia de trabajos en la que se colocará el trabajo para

iniciarlo. Entre el nombre como:



no se utiliza into, el trabajo se agrega a la secuencia de trabajos JOBS.

opcióntrab



[absolute | abs]

confirmed

deadline=hora[timezone | tz nombrehusohorario][+n days | mm/dd/aa]

every=frecuencia


interactive

logon=usuario










[onuntil acción]


en cada archivo calificado.

Notas sobre el uso


predeterminado es la estación de trabajo en la que Conman se está ejecutando. Si

el trabajo se ejecuta en un agente tolerante a errores, y desea incluir una

dependencia prompt o recoveryprompt, el directorio de mozart (TWShome/mozart)

del gestor de dominio maestro debe ser accesible, ya sea montado o compartido.

Ejemplos

Para someter un archivo en la secuencia de trabajos jobs (el nombre del trabajo es

myjcl), ejecute el comando siguiente:

submit file=d:\jobs\lib\daily\myjcl

Para someter un archivo, con el nombre de trabajo misjob4, en la secuencia de

trabajos missked, ejecute el comando siguiente:

sbf /usr/lib/mis/jcl4;alias=misjob4;into=missked ;needs=2 slots

El trabajo necesita dos unidades del recurso slots.

Para someter todos los archivos cuyos nombres empiecen por back en la secuencia

de trabajos bkup, ejecute el comando siguiente:

sbf "/usr/lib/backup/back@";into=bkup


|||

|

||

|

|

||

|

|

submit job

Somete un trabajo para que lo inicie el planificador.



Para someter un trabajo, Conman debe ejecutarse en el gestor de dominio maestro

o tener acceso a las bases de datos del planificador en el gestor de dominio

maestro.

Sinopsis

sbj [esttrabajo#]nombtrabajo[;alias[=nombre]][;into=secuenciatrab]

[;opcióntrab[;...]][;noask]

Argumentos

esttrabajo

Especifica el nombre de la estación de trabajo en la que se iniciará el

trabajo. Se permiten caracteres comodín, en cuyo caso el trabajo se inicia en

todas las estaciones de trabajo calificadas. El valor predeterminado es la

estación de trabajo en la que se ejecuta Conman. No puede especificar un

dominio o una clase de estación de trabajo.

nombtrabajo

Especifica el nombre del trabajo. Se permiten caracteres comodín, en cuyo

caso se someten todos los trabajos calificados. Si el trabajo ya está en el

plan de producción y se está sometiendo a la misma secuencia de trabajos,

deberá utilizar el argumento alias para asignar un nombre exclusivo.

alias=nombre

Especifica un nombre exclusivo que se debe asignar al trabajo en lugar de

nombtrabajo. Si entra la palabra clave alias sin especificar un nombre, se

crea uno utilizando los dos primeros caracteres alfanuméricos de

nombtrabajo seguidos de un número aleatorio de seis dígitos. El nombre se

convierte siempre a mayúsculas. Por ejemplo, si nombtrabajo es jcrttx5, el

nombre generado será parecido a JC123456.

into=secuenciatrab

Especifica el nombre de la secuencia de trabajos en la que se colocará el

trabajo para iniciarlo. Entre el nombre como:



no se utiliza into, el trabajo se agrega a la secuencia de trabajos jobs.

opcióntrab



[absolute | abs]

confirmed


every=frecuencia












[onuntil acción]



Notas sobre el uso


predeterminado es la estación de trabajo del trabajo. Si el trabajo se ejecuta en un

agente tolerante a errores, y desea incluir una dependencia prompt o

recoveryprompt, el directorio de mozart (TWShome/mozart) del gestor de dominio

maestro debe ser accesible, ya sea montado o compartido.

Ejemplos

Para someter los trabajos test en la secuencia de trabajos JOBS, ejecute el comando

siguiente:

submit job=test

Para someter un trabajo con el alias rptx4 y colocar el trabajo en la secuencia de

trabajos reports con una hora at de las 5:30 p.m., ejecute el comando siguiente:

sbj rjob4;alias=rptx4;into=reports;at=1730

Para someter el trabajo txjob3 en todas las estaciones de trabajo cuyos nombres

empiecen por site, ejecute el comando siguiente:

sbj site@#txjob3;alias

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Sometimiento de

trabajos″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console -

Guía del usuario.


|||

|

||

|

||

|

||||

submit sched

Somete una secuencia de trabajos para que la inicie el planificador.

Debe tener acceso submit a la secuencia de trabajos. Para incluir las dependencias

needs y prompt, debe tener acceso use a los recursos y a las solicitudes globales.

Para someter una secuencia de trabajos, Conman debe ejecutarse en el gestor de

dominio maestro o tener acceso a las bases de datos del planificador en el gestor

de dominio maestro.

Sinopsis

sbs [esttrabajo#]nombsecuenciatrab[;alias[=nombre]]

[;opciónsecuenciatrab[;...]][;noask]

Argumentos

esttrabajo

Especifica el nombre de la estación de trabajo en la que se iniciará la

secuencia de trabajos. Se permiten caracteres comodín, en cuyo caso, la

secuencia de trabajos se inicia en todas las estaciones de trabajo calificadas.

El valor predeterminado es la estación de trabajo en la que se ejecuta

Conman. No puede especificar un dominio o una clase de estación de

trabajo.

nombsecuenciatrab

Especifica el nombre de la secuencia de trabajos. Se permiten caracteres

comodín, en cuyo caso, se someten todas las secuencias de trabajos

calificadas. Si la secuencia de trabajos ya está en el plan de producción,

deberá utilizar el argumento alias para asignar un nombre exclusivo.

alias=nombre

Especifica un nombre exclusivo que se debe asignar a la secuencia de

trabajos en lugar de nombsecuenciatrab. Si entra la palabra clave alias sin

especificar un nombre, se crea uno utilizando los dos primeros caracteres

alfanuméricos de nombsecuenciatrab seguidos de un número aleatorio de

seis dígitos. El nombre se convierte siempre a mayúsculas. Por ejemplo, si

nombsecuenciatrab es sttrom, el nombre generado será parecido a ST123456.

opciónsecuenciatrab

Entre una de las siguientes opciones:


[absolute | abs]

carryforward




limit=límitetrabajos





[onuntil acción]



en cada secuencia de trabajos trabajo calificada.

Notas sobre el uso


predeterminado es la estación de trabajo de la secuencia de trabajos. Si la secuencia

de trabajos se ejecuta en un agente tolerante a errores, y desea incluir una

dependencia prompt o recoveryprompt, el directorio de mozart (TWShome/mozart)

en el gestor de dominio maestro debe ser accesible, ya sea montado o compartido.

Ejemplos

Para someter la secuencia de trabajos adhoc en la estación de trabajo site1 y

marcarla como secuencia de trabajos carryforward, ejecute el comando siguiente:

submit sched=site1#adhoc;carryforward

Para someter la secuencia de trabajos fox4 con un límite de trabajos de 2, una

prioridad de 23 y una hora until de medianoche, ejecute el comando siguiente:

sbs fox4;limit=2;pri=23;until=0000

Para someter la secuencia de trabajos sched3 en todas las estaciones de trabajo

cuyos nombres empiecen por site, ejecute el comando siguiente:

sbs site@#sched3

Véase también

Para la tarea equivalente de Job Scheduling Console, consulte ″Gestión de planes

distribuidos″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console -

Guía del usuario.


|||

|

||

|

||

|

||||

switchmgr

Conmuta la gestión de dominio del gestor de dominio actual a un gestor de

dominio de reserva.

Debe tener acceso start y stop al gestor de dominio de reserva.

Sinopsis

switchmgr dominio;gestornuevo

Argumentos

dominio Especifica el dominio en el que desea conmutar gestores.

gestornuevo Especifica el nombre del nuevo gestor de dominio. Debe ser una

estación de trabajo del mismo dominio y debe definirse de

antemano como agente tolerante a errores con las opciones Resolve

Dependencies (Resolver dependencias) y Full Status (Estado

completo) habilitadas.

Notas sobre el uso

El comando detiene una estación de trabajo especificada y la reinicia como gestor

de dominio. Se informa a todas las estaciones de trabajo miembros del dominio

acerca de la conmutación y el gestor de dominio anterior se convierte en un agente

tolerante a errores del dominio.

Si el proceso del nuevo día (el trabajo Jnextday) se realiza en el gestor de dominio

antiguo, el dominio actuará como si se hubiera ejecutado otro comando switchmgr

y el gestor de dominio antiguo reanudará automáticamente las responsabilidades

de gestión de dominio.

Ejemplos

Para conmutar el gestor de dominio por la estación de trabajo orca del dominio

masterdm, ejecute el comando siguiente:

switchmgr masterdm,orca

Para conmutar el gestor de dominio por la estación de trabajo ruby del dominio

bldg2, ejecute el comando siguiente:

switchmgr bldg2,ruby


|||

|

||

|

|

system

ejecuta un comando system.

Sinopsis

[: | !] comando-sist

Argumentos

comando-sist Especifica cualquier comando de sistema válido. El prefijo (: o !)

sólo es necesario cuando un nombre de comando se deletrea igual

que un comando de Conman.

Ejemplos

Para ejecutar un comando ps en UNIX, ejecute el comando siguiente:

ps -ef

Para ejecutar un comando dir en Windows, ejecute el comando siguiente:

dir \bin


||

|

|

|

|

tellop

Envía un mensaje a la consola del planificador.

Sinopsis

to [texto]

Argumentos

texto Especifica el texto del mensaje. El mensaje puede contener un

máximo de 900 caracteres.

Notas sobre el uso

Si tellop en el gestor de dominio maestro, el mensaje se envía a todas las

estaciones de trabajo vinculadas. Si se emite en un gestor de dominio, el mensaje

se envía a todos los agentes vinculados de su dominio y de los dominios

subordinados. Si se emite en una estación de trabajo distinta de un gestor de

dominio, el mensaje sólo se envía a su gestor de dominio si está vinculada. El

mensaje sólo se muestra si el nivel de mensaje de consola es mayor que cero.

Consulte el apartado “console” en la página 161.

Si tellop se entra solo, solicita el texto del mensaje. En la solicitud, escriba cada

línea y pulse la tecla Intro. Al final del mensaje, escriba dos barras inclinadas (//)

o un punto (.)y pulse la tecla Intro. Puede utilizar la secuencia de línea nueva (\n)

para formatear los mensajes. Si se pulsa Control+c en cualquier momento, saldrá

del comando tellop sin enviar el mensaje.

Ejemplos

Para enviar un mensaje, ejecute el comando siguiente:

tellop TWS se detendrá a las\n4:30 durante 15 minutos.

Para solicitar texto antes de enviar un mensaje, ejecute el comando siguiente:

to

TELLOP>*********************************

TELLOP>* TWS se detendrá a las *

TELLOP>* 4:30 durante 15 minutos. *

TELLOP>*********************************

TELLOP>//


||

|

|

||||||

|

unlink

Cierra vínculos de comunicaciones entre estaciones de trabajo.

Debe tener acceso unlink a la estación de trabajo de destino.

Sinopsis

unlink [dominio!]esttrabajo[;noask]

Argumentos

dominio Especifica el nombre del dominio en el que se deben cerrar los

vínculos. No es necesario especificar el nombre de dominio de una

estación de trabajo del dominio maestro. Se permiten caracteres

comodín.

Nota: Siempre que se desvincule una estación de trabajo que no se

encuentre en el dominio maestro, se debe especificar el

nombre de dominio.

Este argumento es útil cuando se desvincula más de una estación

de trabajo en un dominio. Por ejemplo, para desvincular todos los

agentes del dominio stlouis, utilice el siguiente comando:

link stlouis!@

Si no especifica dominio y esttrabajo incluye caracteres comodín, el


Conman.

esttrabajo Especifica el nombre de la estación de trabajo que se debe

desvincular. Se permiten caracteres comodín.



Notas sobre el uso

Suponiendo que un usuario tenga acceso unlink a las estaciones de trabajo que se

están desvinculando, se aplican las reglas siguientes:

v Un usuario que ejecuta Conman en el gestor de dominio maestro puede

desvincular cualquier estación de trabajo de la red.


puede desvincular cualquier estación de trabajo de su propio dominio y de los

dominios subordinados. El usuario no puede desvincular estaciones de trabajo

en dominios de igual.

v Un usuario que ejecuta Conman en un agente puede desvincular cualquier

estación de trabajo de su dominio local siempre que dicha estación de trabajo

sea un gestor de dominio o un host. No se puede desvincular un agente igual

del mismo dominio.

Para obtener más información, consulte el apartado “link” en la página 175.

Ejemplos

En la ilustración y la tabla siguientes se muestran los vínculos cerrados por

comandos unlink ejecutados por usuarios en distintas ubicaciones de la red.



Comando

Cerrado por

Usuario1

Cerrado por

Usuario2

Cerrado por

Usuario3

unlink @!@ Todos los vínculos

están cerrados.

DM1-DM2

DM2-A21

DM2-A22

DM2-DM4

DM4-A41

DM4-A42

DM2-A21

unlink @ DM1-A11

DM1-A12

DM1-DM2

DM1-DM3

DM1-DM2

DM2-A21

DM2-A22

DM2-DM4

DM2-A21

unlink DOMAIN3!@ DM3-A31

DM3-A32


unlink DOMAIN4!@ DM4-A41

DM4-A42

DM4-A41

DM4-A42

No se permite.

unlink DM2 DM1-DM2 No aplicable. DM2-A21

unlink A42 DM4-A42 DM4-A42 No se permite.

unlink A31 DM3-A31 No se permite. No se permite.

Figura 6. Estaciones de trabajo de red desvinculadas


version

Muestra el mensaje de cabecera del programa de línea de comandos Conman.

Sinopsis

version

Ejemplos

Para mostrar el mensaje de cabecera del programa de línea de comandos Conman,


%version

MAESTRO for UNIX (HPUX)/CONMAN 6.0 (3.34) (C) Tivoli Systems 1998

Schedule 5/16/98 (#7) on SFO. Batchman down. Limit: 6, Fence: 0


|||

|||

Capítulo 6. Comandos de utilidad

En este capítulo se describen los comandos de utilidad de IBM Tivoli Workload

Scheduler. Estos comandos son herramientas que son de gran utilidad para

gestionar el planificador. Los comandos, con la excepción de StartUp y version, se

instalan en el directorio TWShome/bin. StartUp se instala en el directorio TWShome

y version se instala en el directorio TWShome/version.


Comando Descripción

at Sólo para UNIX. Somete un trabajo para que se ejecute a una hora

específica.

batch Sólo para UNIX. Somete un trabajo para que se ejecute lo antes

posible.

caxtract Extrae información sobre calendarios.

cpuinfo Devuelve información sobre una definición de estación de trabajo.

datecalc Convierte la fecha y la hora al formato deseado.

dbexpand Expande las bases de datos del planificador.

delete Elimina archivos script y archivos de lista estándar según su nombre.

evtsize Define el tamaño máximo de los archivos de mensajes de eventos.

jbxtract Extrae información sobre trabajos.

jobinfo Devuelve información sobre un trabajo.

jobstdl Devuelve los nombres de ruta de archivos de lista estándar.

listproc Sólo para Windows. Lista procesos. No se da soporte a este

comando.

killproc Sólo para Windows. Aborta procesos. No se da soporte a este

comando.

maestro Devuelve el directorio inicial del planificador.

makecal Crea calendarios personalizados.

metronome.pl Obtiene una instantánea de IBM Tivoli Workload Scheduler y genera

un informe html para ayudar en la resolución de problemas.

morestdl Muestra el contenido de archivos de lista estándar.

parms Muestra, cambia y añade parámetros.

paxtract Extrae información sobre parámetros.

prxtract Extrae información sobre solicitudes.

r11xtr Extrae información sobre secuencias de trabajo.

release Libera unidades de un recurso.

rextract Extrae información sobre recursos.

rmstdlist Elimina archivos de lista estándar por antigüedad.

showexec Sólo para UNIX. Muestra información sobre la ejecución de trabajos.

StartUp Inicia un proceso Netman.

version Sólo para UNIX. Muestra la información de versión.


Comando Descripción

xrxtrct Extrae información sobre referencias cruzadas.

wmaeutil Extrae información sobre referencias cruzadas.


Comandos at y batch

Sólo para UNIX. Somete comandos y trabajos ad hoc para que IBM Tivoli

Workload Scheduler los inicie.

Para obtener más información sobre la disponibilidad para los usuarios, consulte

at.allow y at.deny.

Sinopsis

at -v | -u

at -ssecuenciatrab | -qcolaespecif-hora

batch -v | -u

batch [-s secuenciatrab]

Argumentos

-v Muestra la versión del comando.

-u Muestra información sobre el uso del comando.

-s secuenciatrab

Especifica el nombre de una secuencia de trabajos a la que se somete el

trabajo. Si la secuencia de trabajos no existe, se crea. El nombre debe

empezar con una letra y puede contener caracteres alfanuméricos y

guiones. Puede contener hasta 16 caracteres.

Si se omiten los argumentos -s y -q, el nombre de la secuencia de trabajos

se selecciona basándose en el valor de la variable de entorno ATSCRIPT. Si

ATSCRIPT contiene la palabra maestro, el nombre de la secuencia de

trabajos estará formado por los ocho primeros caracteres del nombre de

grupo del usuario. Si ATSCRIPT no está establecido o tiene un valor

distinto de maestro, el nombre de la secuencia de trabajos será at (para los

trabajos sometidos con at) o batch (para los trabajos sometidos con batch).

Para obtener más información sobre secuencias de trabajos, consulte el

apartado “Otras consideraciones” en la página 241.

-q cola Especifica que se debe someter el trabajo a una secuencia de trabajos

llamada cola, que puede ser una sola letra (de la a a la z). Para obtener más

información sobre secuencias de trabajos, consulte el apartado “Otras

consideraciones” en la página 241.

especif-hora

Especifica la hora a la que se iniciará el trabajo. Sólo para trabajos at. La

sintaxis es la misma que se utiliza con el comando at de UNIX.

Notas sobre el uso

Después de entrar at o batch, entre los comandos que constituyen el trabajo. Para

finalizar cada línea de entrada, pulse la tecla Intro. La secuencia entera se finaliza

con fin de archivo (normalmente Control+d) o entrando una línea con un punto (.).

Alternativamente, utilice un corchete angular (<) para leer comandos de un

archivo. Consulte el apartado “Ejemplos” en la página 241.

Capítulo 6. Comandos de utilidad 239

La información sobre at y batch se envía al gestor de dominio maestro, donde los

trabajos se agregan a las secuencias de trabajos del plan de producción, Symphony.

Los trabajos se inician basándose en las dependencias incluidas en las secuencias

de trabajos.

El shell de UNIX que se utiliza para los trabajos sometidos con los comandos at y

batch de IBM Tivoli Workload Scheduler viene determinado por la variable

SHELL_TYPE del script de configuración jobmanrc. No utilice el shell C. Para

obtener más información, consulte la publicación IBM Tivoli Workload Scheduler -

Guía de planificación e instalación.

Una vez sometidos, los trabajos se inician del mismo modo que otros trabajos

planificados. Cada trabajo se ejecuta en el entorno del usuario que lo somete. Para

asegurarse de que el entorno es completo, se insertan comandos set en el script

para que se correspondan con los valores de las variables del entorno del usuario.

Sustitución de los comandos de UNIX: Los comandos estándar de UNIX at y

batch se pueden sustituir por comandos del planificador. Los comandos siguientes

muestran cómo sustituir los comandos de UNIX at y batch:

$ mv /usr/bin/at /usr/bin/uat

$ mv /usr/bin/batch /usr/bin/ubatch

$ ln -s TWShome/bin/at /usr/bin/at

$ ln -s TWShome/bin/batch /usr/bin/batch

Únicamente en plataformas de nivel 2, cuando se instala el planificador mediante

el script customize, de forma predeterminada se crean los vínculos siguientes:

/usr/bin/mat —>TWShome/bin/at

/usr/bin/mbatch —> TWShome/bin/batch

Esto permite ejecutar los comandos de la siguiente manera:

/usr/bin/mat

/usr/bin/mbatch

Los archivos at.allow y at.deny: Los comandos at y batch utilizan los archivos

/usr/lib/cron/at.allow y /usr/lib/cron/at.deny pare restringir el uso. Si el archivo

at.allow existe, sólo los usuarios listados en el mismo tienen permiso para utilizar

at y batch. Si el archivo no existe, se comprueba at.deny para ver si al usuario se

le ha denegado explícitamente el permiso. Si no existe ninguno de los dos archivos,

sólo el usuario root tiene permiso para utilizar los comandos. Únicamente en las

plataformas de nivel 2, si los comandos se ejecutan como mat y mbatch, se hace

caso omiso de at.allow y at.deny y no se aplica ninguna restricción.

Archivos script: Los comandos que se entran con at o batch se almacenan en

archivos script. El planificador crea el archivo utilizando los convenios de

denominación siguientes:

TWShome/atjobs/epoch.sss

donde:

epoch El número de segundos desde las 00:00 del 1/1/70.

sss Los tres primeros caracteres del nombre de la secuencia de trabajos.


Nota: El planificador elimina los archivos script de los trabajos que no se traspasan

al día siguiente. No obstante, Tivoli le recomienda que supervise el espacio

en disco del directorio atjobs y elimine los archivos antiguos si es necesario.

Nombres de trabajos: El planificador asigna nombres exclusivos a todos los

trabajos at y batch en el momento de someterlos. Los nombres están formados por

el ID de proceso del usuario (PID) precedido por el nombre del usuario truncado

de modo que no exceda de ocho caracteres. El nombre resultante se convierte a

mayúsculas.

Otras consideraciones: Tivoli recomienda que las secuencias de trabajos en las

que se someten los trabajos at y batch se creen de antemano con Composer. Las

secuencias de trabajos pueden contener dependencias que determinen cuándo se

han de iniciar los trabajos. Como mínimo, las secuencias de trabajos deben

contener la palabra clave carryforward. Esto garantizará que los trabajos que no se

completen, o que no se inicien, durante el día actual se traspasarán al plan de

producción del día siguiente. A continuación se ofrecen otras sugerencias sobre las

secuencias de trabajos at y batch:

v Incluya la expresión on everyday para que las secuencias de trabajos se

seleccionen todos los días.

v Utilice la palabra clave limit para limitar el número de trabajos sometidos que

pueden ejecutarse simultáneamente.

v Utilice la palabra clave priority para establecer la prioridad de los trabajos

sometidos con relación a otros trabajos.

Si el valor indicado en la hora es inferior a la hora actual, hará referencia al día

siguiente. Si el valor indicado en la hora es superior a la hora actual, se aplicará al

día actual. Si se especifica un valor de hora superior a 2400, el valor se divide por

2400 para obtener el número de días. Si se especifica el valor de hora en días,

dicho valor se agrega al valor que se ha obtenido después de efectuar la división

por 2400.

Ejemplos

Para someter un trabajo en la secuencia de trabajos sched8 de forma que se inicie

lo antes posible, ejecute el comando siguiente:

batch -s sched8

comando <Intro>

...

<Control d>

Para someter un trabajo en la secuencia de trabajos k de forma que se inicie a las

9:45 p.m., ejecute el comando siguiente:

at -qk 21h45

comando <Intro>

...

<Control d>

Para someter un trabajo de forma que se inicie dos horas después de la hora en

que se entró el comando, ejecute el comando siguiente:

at now + 2 hours

comando <Intro>

...

<Control d>


|||

||||

||

||||

||

||||

Si la variable ATSCRIPT es nula, el trabajo se somete en una secuencia de trabajos

que tiene el mismo nombre del grupo del usuario. De lo contrario, se somete a una

secuencia de trabajos denominada at.

Para someter un trabajo en la secuencia de trabajos sked-mis de forma que se

inicie a las 5:30 p.m., ejecute el comando siguiente:

at -s sked-mis 17h30

comando <Intro>

...

<Control d>

El ejemplo siguiente es igual que el anterior, excepto en que los comandos del

trabajo se leen de un archivo:

at -s sked-mis 17h30 < ./myjob

El hecho de que los comandos se lean de un archivo no cambia el modo en que se

procesan. Es decir, los comandos se copian del archivo ./myjob en un archivo

script.


|||

||

||||

||

|

|||

caxtract

Extrae información sobre calendarios de la base de datos del planificador.

Sinopsis

caxtract [-v | -u] [-o archivo]

Argumentos



-o archivo

Especifica el archivo de salida. El valor predeterminado es stdout.

Salida del comando

Cada registro de calendario contiene campos de longitud variable delimitados por

tabuladores. Los campos se describen en la tabla siguiente.

Campo Descripción

Longitud máxima

(bytes)

1 nombre de calendario 8

2 descripción de calendario 64

Ejemplos

Para extraer información sobre todas las definiciones de calendario y dirigir la

salida al archivo cainfo, ejecute el comando siguiente:

caxtract -o cainfo


|||

|

|

cpuinfo

Devuelve información sobre una definición de estación de trabajo.

Sinopsis

cpuinfo -v | -u

cpuinfo esttrabajo[tipoinfo] [...]

Argumentos



esttrabajo

El nombre de la estación de trabajo.

tipoinfo

El tipo de información a visualizar. Especifique una o más de las siguientes

opciones:

os_type

Devuelve el valor del campo os: UNIX, WNT u OTHER.

node Devuelve el valor del campo node.

port Devuelve el valor del campo port.

autolink

Devuelve el valor del campo autolink: ON u OFF.

fullstatus

Devuelve el valor del campo fullstatus: ON u OFF.

resolvedep

Devuelve el valor del campo resolvedep: ON u OFF.

host Devuelve el valor del campo host.

method

Devuelve el valor del campo access.

server Devuelve el valor del campo server.

tipo Devuelve el tipo de estación de trabajo: MASTER, MANAGER,

FTA, S-AGENT y X-AGENT.

time_zone

Devuelve el huso horario de la estación de trabajo. Para un agente

ampliado, el campo está en blanco.

version

Devuelve la versión del planificador que está ejecutándose en esta

estación de trabajo. Para un agente ampliado, el campo está en

blanco.

info Devuelve la versión del sistema operativo y el modelo de estación

de trabajo. Para un agente ampliado, el campo está en blanco.

Notas sobre el uso

Los valores se devuelven, separados por nuevas líneas, en el mismo orden en el

que se entraron los argumentos en la línea de comandos. Si no se especifica ningún

argumento, toda la información aplicable se devuelve con etiquetas, separadas por

nuevas líneas.


Ejemplos

Los ejemplos siguientes se basan en la definición de estación de trabajo siguiente:

cpuname oak

os UNIX

node oak.tivoli.com

tcpaddr 31111

for maestro

autolink on

fullstatus on

resolvedep on

end

Para imprimir el tipo de sistema operativo (os) de la estación de trabajo oak,


>cpuinfo oak os_type

UNIX

Para imprimir el nodo y el puerto (node y port) de la estación de trabajo oak,


>cpuinfo oak node port

oak.tivoli.com

31111

Para imprimir toda la información de la estación de trabajo oak, ejecute el

comando siguiente:

>cpuinfo oak

OS TYPE:UNIX

NODE:oak.tivoli.com

PORT:31111

AUTOLINK:ON

FULLSTATUS:ON

RESOLVEDEP:ON

HOST:

METHOD:

SERVER:

TYPE: FTA

TIME ZONE:US/Pacif

VERSION:6.1

INFO:SunOS 5.3 Generic 1016 sun4m


||

|||||||||

||

||

||

|||

||

||||||||||||||

|

datecalc

Resuelve las expresiones de fecha y devuelve las fechas en los formatos deseados.

Sinopsis

datecalc -v | -u

datecalc fecha-base [desplazamiento] [pic formato][freedays nombre_calendario [-sa]

[-su]]

datecalc -t hora [fecha-base] [desplazamiento] [pic formato]

datecalc aaaaddmmhhtt [desplazamiento] [pic formato]

Argumentos



fecha-base


día | fecha | today | tomorrow | scheddate

donde:

día Especifica un día de la semana. Los valores válidos son: su, mo, tu,

we, th, fr o sa.

fecha Especifica una fecha, en el formato elemento/elemento[/elemento],

donde elemento es: d[d], m[m], and aa[aa].

Si se utilizan dos dígitos para el año aa), un número mayor que 70

es una fecha del siglo XX, y un número menor que 70 es una fecha

del siglo XXI.

Los valores válidos para el mes m[m]) son jan, feb, mar, apr, may,

jun, jul, aug, sep, oct, nov o dec.

Las barras inclinadas (/) pueden sustituirse por guiones (-), puntos

(.), comas (,) o espacios. Por ejemplo, la fecha 28 de marzo de 1999

se puede entrar de cualquiera de las siguientes maneras:

28/03/99

28-03-1999

28.mar.99

99,28,3

29 de marzo de 1999

3 28 99

Si se utilizan números, es posible entrar una fecha ambigua, por

ejemplo, 2,7,98. En este caso, datecalc utiliza el formato de fecha

definido en el catálogo de mensajes del planificador para

interpretar la fecha. Si la fecha no coincide con el formato, datecalc

genera un mensaje de error.

today Especifica la fecha actual del sistema.

tomorrow

Especifica la fecha actual del sistema más un día o, en el caso de

cálculos de tiempo, más 24 horas.


scheddate

Especifica la fecha del plan de producción. Es posible que no sea la

misma que la fecha del sistema. Si se utiliza en trabajos de una

secuencia de trabajos que no es una secuencia de trabajos

traspasada, devuelve la fecha en que se debe ejecutar el trabajo,

que puede ser distinta de la fecha de producción de la secuencia

de trabajos si se ha especificado una dependencia AT para el

trabajo. Si se utiliza en trabajos de una secuencia de trabajos

traspasada, devuelve la fecha en que se tiene que haber ejecutado

el trabajo, que puede ser distinta de la fecha de producción de la

secuencia de trabajos traspasada si se ha especificado una

dependencia AT para el trabajo. Si se utiliza la dependencia AT con

la sintaxis siguiente: at=hhmm + n days, los n days no se agregan a

la variable TIVOLI_JOB_DATE y, por consiguiente, el comando

datecalc no informa de estos días.

-t hora [fecha-base]

Especifica la hora en uno de los siguientes formatos:

now | noon | midnight | [h[h][[:]mm] [am | pm] [zulu]

donde:

now Especifica la fecha y la hora actuales del sistema.

noon Especifica las 12:00 p.m. (o 1200).

midnight

Especifica las 12:00 a.m. (o 0000).

h[h][[:]mm]

Especifica la hora y los minutos en formato de 12 horas (si se

utiliza am o pm), o en formato de 24 horas. El delimitador

opcional de dos puntos (:) puede sustituirse por un punto (.)una

coma (,), un apóstrofo (’), la letra h o un espacio. Por ejemplo, las

8:00 p.m. se puede entrar de cualquiera de las maneras siguientes:

8:00pm

20:00

0800pm

2000

8pm

20

8,00pm

20.00

8\’00pm

20 00

zulu Especifica que la hora que ha entrado es Hora Media de

Greeenwich (Hora universal coordinada). datecalc la convertirá en

hora local.

aaaammddhhtt

Especifica el año, mes, día, hora y minuto expresado en doce dígitos

exactamente. Por ejemplo, para el 7 de mayo de 1999 a las 9:15 a.m., entre

lo siguiente: 199905070915

desplazamiento

Especifica un desplazamiento de la fecha-base en el siguiente formato;


{[+ | > | - | < número | nearest] | next} day[s] | weekday[s] |

workday[s] | week[s] | month[s] | year[s] | hour[s] | minute[s] |

día | calendario

donde:

+ | > Especifica un desplazamiento a una fecha u hora posterior. Utilice

un signo + (más) en Windows. Utilice un signo > (mayor que) en

UNIX. Asegúrese de utilizar un código escape para el corchete

angular (″\>″).

- | < Especifica un desplazamiento a una fecha u hora anterior. Utilice

un signo - (menos) en Windows. Utilice un signo < (menor que) en

UNIX. Asegúrese de utilizar un código escape para el corchete

angular (″\<″).

número

El número de unidades del tipo especificado.

nearest

Especifica un desplazamiento a la ocurrencia más cercana del tipo

de unidad (anterior o posterior).

next Especifica la siguiente ocurrencia del tipo de unidad.

day[s] Especifica todos los días.

weekday[s]

Especifica todos los días excepto sábado y domingo.

workday[s]

Igual que weekday[s], aunque también excluye las fechas del

calendario holidays.

week[s]

Especifica siete días.

month[s]

Especifica meses civiles.

year[s]

Especifica años civiles.

hour[s]

Especifica horas de reloj.

minute[s]

Especifica minutos de reloj.

día Especifica un día de la semana. Los valores válidos son: su, mo, tu,

we, th, fr o sa.

calendario

Especifica las entradas de un calendario con este nombre.

pic formato

Especifica el formato en el que se devuelve la fecha y la hora. Los

caracteres de formato son los siguientes:

m Número del mes.

d Número del día.

a Número del año.

j Número del día según el calendario juliano.


h Número de la hora.

t Número del minuto.

^|/ Un espacio. Utilice un signo ^ (carácter de intercalación) en UNIX

(este carácter se debe indicar con código escape (\) en el shell

Bourne). Utilice una barra inclinada (/) en Windows.

También puede incluir caracteres de puntuación. Estos son los mismos que

los delimitadores utilizados en fecha y hora.

Si no se define un formato, datecalc devuelve la fecha y hora en el formato

definido por las variables de entorno NLS (Native Language Support). Si

las variables NLS no están definidas, el idioma nativo toma por omisión el

valor C.

freedays

Especifica el nombre de un calendario de días libres nombre_calendario que

va a sustituir a holidays en la evaluación de días laborables.

En este caso días laborables se evalúa como todos los días con excepción de

sábado, domingo y todas las fechas listadas en nombre_calendario.

De forma predeterminada, sábado y domingo no se consideran días laborables,

salvo que se especifique lo contrario agregando -sa y/o -su después de

nombre_calendario.

También puede especificar holidays como nombre del calendario de días

libres.

Ejemplos

Para devolver la fecha siguiente, a partir del día de hoy, del calendario monthend,


>datecalc today next monthend

En los ejemplos siguientes, la fecha actual del sistema es viernes 9 de abril de 1999.

>datecalc today +2 days pic mm/dd/aa

04/11/99

>datecalc today next tu pic aa\^mm\^dd

99 04 13

>LANG=american;export LANG

>datecalc -t 14:30 tomorrow

Sat, Apr 10, 1999 02:30:00 PM

>LANG=french;datecalc -t 14:30 tomorrow

Samedi 10 avril 1999 14:30:00

En el ejemplo siguiente, la hora actual del sistema es las 10:24.

>datecalc -t now \> 4 hours pic hh:tt

14:24


||

dbexpand

Convierte las bases de datos del gestor de dominio maestro de modalidad no

expandida a modalidad expandida. El comando establece la opción global

expanded version en el valor yes y efectúa copias de reserva de sus archivos de

base de datos antiguos que, si es necesario, puede utilizar para volver a la

modalidad no expandida.

Si actualiza la red en etapas y ésta contiene estaciones de trabajo que ejecutan

Tivoli Maestro Versión 5.x o anteriores, debe utilizar bases de datos no expandidas

hasta que todos los sistemas se hayan actualizado a Tivoli Maestro 6.x o IBM Tivoli

Workload Scheduler. Después de actualizar todos los sistemas, ejecute dbexpand

en el gestor de dominio maestro para pasar las bases de datos a modalidad

expandida.

Sinopsis

dbexpand -v | -u

dbexpand -n [-b dir-copia-seguridad]

Argumentos



-n

Especifica que no se ha de solicitar un nombre de directorio de reserva. Si

se incluye -b, el directorio nombrado se utiliza para la copia de seguridad.

Si no se incluye -b se utiliza el directorio predeterminado. En cualquiera de

los dos casos, si el directorio existe, se grabará encima del mismo.

-b dir-copia-seguridad

Especifica un directorio en el que guardar la copia de seguridad de los

archivos de base de datos. El directorio predeterminado es:

TWShome/mozart/mozart.old

Si se omite -n y el directorio de copia de seguridad ya existe, se le

solicitará un nombre de directorio de copia de seguridad.

Notas sobre el uso

Puede ejecutar el comando dbexpand sin detener el planificador. Sin embargo, no

puede someter trabajos o secuencias de trabajos al plan de producción actual hasta

después de que tenga lugar el movimiento del nuevo día. Por este motivo, Tivoli

recomienda ejecutar dbexpand poco antes de que se ejecute el trabajo Jnextday.

Ejemplos

Para expandir las bases de datos y obtener una copia de seguridad de los archivos

actuales en el directorio /usr/lib/maestro/temp, ejecute el comando siguiente:

dbexpand -n -b /usr/lib/maestro/temp

Si el directorio ya existe, se graba encima de su contenido.

Para expandir las bases de datos y obtener una copia de seguridad de los archivos

actuales en el directorio c:\programs\wsched\temp, ejecute el comando siguiente:

dbexpand -b c:\programs\wsched\temp


|||

|

|

||

|

Si el directorio ya existe, se visualiza una solicitud.


|

delete

Elimina archivos. Este comando sirve para eliminar archivos de lista estándar. Los

usuarios maestro y root en UNIX, y Administrador en Windows pueden eliminar

cualquier archivo. Otros usuarios sólo pueden eliminar archivos asociados con sus

propios trabajos.

Sinopsis

delete -v | -u

delete nombarchivo

Argumentos



nombarchivo

Especifica el nombre del archivo o grupo de archivos que se debe eliminar.

El nombre debe estar entre comillas (″) si contiene caracteres distintos de

los siguientes: alfanuméricos, guiones (-), barras inclinadas (/), barras

inclinadas invertidas (\) y subrayados (_). Se permiten caracteres comodín.

PRECAUCIÓN:

Tenga cuidado al utilizar este comando. El uso incorrecto de los caracteres

comodín puede ocasionar la eliminación accidental de archivos.

Ejemplos

Para eliminar todos los archivos de lista estándar del 4/11/04, ejecute el comando

siguiente:

delete d:\win32app\maestro\stdlist\2004.4.11\@

El script siguiente, incluido en un trabajo planificado en UNIX, elimina el archivo

de lista estándar del trabajo si no existen errores:

...

#Eliminar la lista estándar para este trabajo:

if grep -i error $UNISON_STDLIST

then

exit 1

else

`maestro`/bin/delete $UNISON_STDLIST

fi

...

Tenga en cuenta que el script de configuración estándar, jobmanrc, define la

variable UNISON_STDLIST con el nombre del archivo de lista estándar de

trabajos. Para obtener más información acerca de jobmanrc, consulte la publicación

IBM Tivoli Workload Scheduler - Guía de planificación e instalación.


||

|

evtsize

Define el tamaño de los archivos de eventos del planificador. Este comando se

utiliza para aumentar el tamaño de un archivo de eventos después de recibir el

mensaje “Fin de archivo en archivo de eventos.” Para poder ejecutar evtsize, debe

ser un usuario maestro o root en UNIX, o Administrador en Windows. Asegúrese

de detener el motor de IBM Tivoli Workload Scheduler antes de ejecutar este

comando.

Sinopsis

evtsize -v | -u

evtsize nombarchivo size

evtsize -show nombarchivo

Argumentos



-show nombarchivo

Consulta la longitud de cola actual del archivo especificado.

nombarchivo

El nombre del archivo de eventos. Especifique una de las siguientes

opciones:

Courier.msg

Intercom.msg

Mailbox.msg

pobox/esttrabajo.msg

tamaño El tamaño máximo del archivo de eventos en bytes. Cuando el planificador

lo crea por primera vez, el tamaño máximo se establece en 10 MB.

Ejemplos

Para establecer el tamaño máximo del archivo Intercom en 20 MB, ejecute el

comando siguiente:

evtsize Intercom.msg 20000000

Para establecer el tamaño máximo del archivo pobox para la estación de trabajo

chicago en 15 MB, ejecute el comando siguiente:

evtsize pobox\chicago.msg 15000000

El comando siguiente:

evtsize -show Intercom.msg

devuelve la salida siguiente:

TWS for Windows NT/EVTSIZE 8.2 (1.2.2.2)


5698-WKB



Use, duplication or disclosure restricted by GSA ADP

Schedule Contract with IBM Corp.

AWS11140703 Queue size current 880, maximum 10000000 bytes

(read 48, write 928)


|||

|

||

|

|

|

|

|||||||||

donde:

880 Es el tamaño de la cola actual del archivo Intercom.msg

10000000

Es el tamaño máximo del archivo Intercom.msg

read 48

Es la posición del puntero para leer registros

write 928

Es la posición del puntero para grabar registros


|||||||||

jbxtract

Extrae información sobre trabajos de la base de datos del planificador.

Sinopsis

jbxtract [-v | -u] [-j trabajo] [-c esttrabajo] [-o archivo]

Argumentos



-j trabajo

Especifica el trabajo sobre el que se extrae la información. El valor

predeterminado es todos los trabajos.

-c esttrabajo

Especifica la estación de trabajo de los trabajos sobre el que se extrae la

información. El valor predeterminado es todas las estaciones de trabajo.

-o archivo


Salida del comando

La variable MAESTRO_OUTPUT_STYLE especifica el estilo de salida para

nombres de objetos largos. Establezca la variable en LONG para utilizar campos

de longitud completa (largos) para nombres de objetos. Si no se establece la

variable o se establece en cualquier valor distinto de LONG, los nombres largos se

truncan en ocho caracteres y un signo más. Por ejemplo: A1234567+.

Cada registro de trabajo contiene campos de longitud variable delimitados por


Campo Descripción

Longitud máxima

(bytes)

1 nombre de estación de trabajo 16

2 nombre de trabajo 16

3 nombre de archivo script de trabajo 4096

4 descripción de trabajo 65

5 nombre de trabajo de recuperación 16

6 opción de recuperación (0=detener, 1=reejecutar,

2=continuar)

5

7 texto de solicitud de recuperación 64

8 distintivo de documentación automática (0=inhabilitado,

1=habilitado)

5

9 nombre de usuario de inicio de sesión de trabajo 36

10 nombre de usuario de creador de trabajo 36

11 número de ejecuciones satisfactorias 5

12 número de ejecuciones finalizadas anormalmente 5

13 tiempo total transcurrido de todas las ejecuciones de

trabajo

8

14 tiempo total de CPU de todas la ejecuciones de trabajo 8

15 promedio de tiempo transcurrido 8


Campo Descripción

Longitud máxima

(bytes)

16 última fecha de ejecución (aammdd) 8

17 última hora de ejecución (hhmm) 8

18 último tiempo de CPU 8

19 último tiempo transcurrido 8

20 cantidad máxima de segundos de CPU 8

21 tiempo máximo transcurrido 8

22 fecha máxima de ejecución (aammdd) 8

23 cantidad mínima de segundos de CPU 8

24 tiempo mínimo transcurrido 8

25 fecha mínima de ejecución (aammdd) 8

Ejemplos

Para extraer información sobre el trabajo myjob de la estación de trabajo main y

dirigir la salida al archivo jinfo, ejecute el comando siguiente:

jbxtract -j myjob -c main -o jinfo


|||

|

|

jobinfo

Se utiliza en un script de trabajo para devolver información sobre el trabajo.

Sinopsis

jobinfo -v | -u

jobinfo opción-trabajo [...]

Argumentos



opción-trabajo

La opción de trabajo. Especifique una o más de las siguientes opciones:

confirm_job

Devuelve YES si el trabajo requiere confirmación.

is_command

Devuelve YES si el trabajo se ha planificado o sometido utilizando

la estructura docommand.

job_name

Devuelve el nombre del trabajo sin los nombres de estación de

trabajo y secuencia de trabajos.

job_pri

Devuelve el nivel de prioridad del trabajo.

programmatic_job

Devuelve YES si el trabajo se ha sometido con el comando at o

batch del planificador. Sólo para UNIX.

re_job Devuelve YES si el trabajo se está volviendo a ejecutar como

resultado de un comando rerun de Conman o de la opción de

recuperación volver a ejecutar.

re_type

Devuelve la opción de recuperación del trabajo (stop, continue o

rerun).

rstrt_flag

Devuelve YES si el trabajo se está ejecutando como trabajo de

recuperación.

rstrt_retcode

Si el trabajo actual es un trabajo de recuperación, devuelve el

código de retorno del trabajo primario.

time_started

Devuelve la hora a la que empezó a ejecutarse el trabajo.

Notas sobre el uso

Los valores de opciones de trabajo se devuelven, separados por nuevas líneas, en

el mismo orden en el que se solicitaron.


Ejemplos

1. El archivo script /jcl/backup se documenta dos veces, y se le asignan los

nombres de trabajo partback y fullback. Si el trabajo se ejecuta como partback,

realiza una copia de seguridad parcial. Si se ejecuta como fullback, realiza una

copia de seguridad completa. En el script, se utilizan comandos como los

siguientes para tomar la determinación:

#Determinar parcial (1) o completa (2):

if [ "`\`maestro\`/bin/jobinfo nombre_trabajo`" = "PARTBACK" ]

then

bkup=1

else

bkup=2

fi

...

2. Para mostrar el código de retorno del trabajo padre, si el trabajo actual es un

trabajo de recuperación, ejecute el comando siguiente:

$ jobinfo rstrt_retcode

El primer trabajo (trabajo padre) se ha definido en el script recovery.sh,

mientras que el segundo trabajo (trabajo de recuperación) sólo se habilita si el

primer trabajo finaliza de forma anómala.

SI se combina con una condición de código de retorno, se puede utilizar

jobinfo rstrt_retcode para indicar al trabajo de recuperación que emprenda

acciones distintas en función del código de retorno del trabajo padre. En el

ejemplo siguiente se muestra un trabajo de recuperación:

$JOBS

MASTER#DBSELOAD DOCOMMAND "/usr/local/tws/maestro/scripts/populate.sh"

STREAMLOGON "^TWSUSER^"

DESCRIPTION "populate database manual"

RECOVERY RERUN AFTER MASTER#RECOVERY

RCCONDSUCC "(RC = 0) OR ((RC > 4) AND (RC < 11))"

Observe que el trabajo se define con la acción de recuperación RERUN. Esto

permite que el trabajo de recuperación emprenda alguna acción correctora antes

de que se vuelva a intentar ejecutar el trabajo padre.

El propio trabajo de recuperación se define tal como se muestra en el ejemplo

siguiente:

$ JOBS

MASTER#RECOVERY DOCOMMAND "^TWSHOME^/scripts/recovery.sh"

STREAMLOGON "^TWSUSER^"

DESCRIPTION "populate database recovery manual"

RECOVERY STOP


||

|

|||

||||

|||||||

|||

||

|||||

|

jobstdl

Devuelve los nombres de archivos de lista estándar. Debe ejecutar este comando el

usuario para el que se ha instalado IBM Tivoli Workload Scheduler. Si utiliza este

comando sin ningún parámetro, asegúrese de haber iniciado la sesión como

usuario de IBM Tivoli Workload Scheduler.

Sinopsis

jobstdl -v | -u

jobstdl [-day núm] [-first | -last | -num n | -all]

[-name secuenciatrab.trabajo | númtrabajo]

Argumentos



-day núm

Devuelve los nombres de archivos de lista estándar que tienen los días de

antigüedad especificados (1 para ayer, 2 para anteayer y así

sucesivamente). El valor predeterminado es cero (hoy).

-first Devuelve el nombre del primer archivo de lista estándar calificado.

-last Devuelve el nombre del último archivo de lista estándar calificado.

-num n

Devuelve el nombre del archivo de lista estándar para la ejecución

especificada de un trabajo.

-all Devuelve el nombre de todos los archivos de lista estándar calificados.

-name secuenciatrab.trabajo

Especifica el nombre de la secuencia de trabajos y el trabajo para los que se

devuelven nombres de archivos de lista estándar.

númtrabajo

Especifica el número de trabajo del trabajo para el que se devuelven

nombres de archivos de lista estándar.

Notas sobre el uso

Los nombres de archivo se devuelven en un formato de entrada adecuado para

otros comandos. Si se devuelven varios nombres, éstos aparecen separados por un

espacio.

Ejemplos

Para devolver los nombres de las rutas de todos los archivos de lista estándar para

el día actual, ejecute el comando siguiente:

jobstdl

Para devolver el nombre de la ruta de la lista estándar para la primera ejecución

del trabajo mailxhg1.getmail del día actual, ejecute el comando siguiente:

jobstdl -first -name mailxhg1.getmail

Para devolver el nombre de la ruta de la lista estándar para la segunda ejecución

del trabajo mailxhg1.getmail del día actual, ejecute el comando siguiente:

jobstdl -num 2 -name mailxhg1.getmail


|

||||

||

||

|

||

||

||||

||

||

|||

||

|||

|||

||||

|||

|

||

|

||

|

Para devolver los nombres de las rutas de los archivos de lista estándar para todas

las ejecuciones del trabajo mailxhg1.getmail de hace tres días, ejecute el comando

siguiente:

jobstdl -day 3 -name mailxhg1.getmail

Para devolver el nombre de la ruta de la lista estándar para la última ejecución del

trabajo mailxhg1.getmail de hace cuatro días, ejecute el comando siguiente:

jobstdl -day 4 -last -name mailxhg1.getmail

Para devolver el nombre de la ruta de la lista estándar para el trabajo número 455,


jobstdl 455

Para imprimir el contenido del archivo de lista estándar para el trabajo número

455, ejecute el comando siguiente:

cd `maestro`/bin

lp -p 6 `jobstdl 455`


|||

|

||

|

||

|

||

||

|

maestro

Devuelve el nombre de la ruta del directorio inicial del planificador, al que se hace

referencia como TWShome.

Sinopsis

maestro [-v | -u]

Argumentos



Ejemplos

Para mostrar el directorio inicial del planificador, ejecute el comando siguiente:

$ maestro

/usr/lib/maestro

Para cambiar al directorio inicial del planificador, ejecute el comando siguiente:

$ cd `maestro`


||

||

|

|

|

makecal

Crea un calendario personalizado. En UNIX, se necesita el shell Korn para ejecutar

este comando.

Sinopsis

makecal [-v | -u]

makecal [-c nombre] -d n | -e | {-f 1 | 2 | 3 -s fecha} | -l | -m | -p n |

{-r n -s fecha} | -w n [-i n] [-x | -z][-freedays nombre_calendario [-sa] [-su] ]

Argumentos



-c nombre

Especifica un nombre para el calendario. Las palabras clave de IBM Tivoli

Workload Scheduler (como Freedays o Schedule) no pueden utilizarse como

nombres de calendarios. El nombre puede contener un máximo de ocho

caracteres y debe empezar por una letra. No utilice los nombres de los días

de la semana como nombres de calendario. El nombre predeterminado es:

Chhmm, donde hhmm es la hora y minuto actuales.

-d n Especifica el día n de cada mes.

-e Especifica el último día de cada mes.

-f 1 | 2 | 3

Crea un calendario de fin de mes fiscal que contiene el último día del mes

fiscal. Especifique uno de los siguientes formatos:

1 Formato de 4-4-5 semanas



Este argumento requiere el argumento -s.

-i n Especifica poner n fechas en el calendario.

-l Especifica el último día laborable de cada mes. Para que este argumento

funcione correctamente, ya deben existir el plan de producción (archivo

Symphony) y el calendario holidays.

Nota: Si se utiliza este argumento se creará un nuevo calendario que

también incluirá el último día laborable del mes anterior a la fecha

de creación del calendario.

-m Especifica el primer día y el decimoquinto día de cada mes.

-p n Especifica el día laborable anterior al n día de cada mes. Para que este

argumento funcione correctamente, ya deben existir el plan de producción

(archivo Symphony) y el calendario holidays.

-r n Especifica cada día n. Este argumento requiere el argumento -s.

-s fecha

Especifica la fecha inicial para los argumentos -f y -r. La fecha debe ir entre

comillas, y debe ser válida y no ambigua, por ejemplo, utilice JAN 10 1999

en vez de 1/10/99. Para obtener más información sobre formatos de fecha,

consulte fecha-base para datecalc en la página 246.


-w n Especifica el día laborable después del día n del mes. Para que este

argumento funcione correctamente, ya deben existir el plan de producción

(archivo Symphony) y el calendario holidays.

-x Envía la salida del calendario a stdout en lugar de agregarla a la base de

datos del calendario.

-z Agrega el calendario a la base de datos de calendarios y compila el plan de

producción (archivo Symphony). AVISO: Este argumento vuelve a someter

trabajos y secuencias de trabajos del plan de producción del día actual. Es

posible que sea necesario cancelar trabajos y secuencias de trabajos.

-freedays

Especifica el nombre de un calendario de días libres nombre_calendario que

va a sustituir a holidays en la evaluación de días laborables.

En este caso días laborables se evalúa como todos los días con excepción de

sábado, domingo y todas las fechas listadas en nombre_calendario.

De forma predeterminada, sábado y domingo no se consideran días laborables,

salvo que se especifique lo contrario agregando -sa y/o -su después de

nombre_calendario.

También puede especificar holidays como nombre del calendario de días

libres.

Esta palabra clave afecta al proceso de makecal con las opciones -l, -p y

-w.

Ejemplos

Para crear un calendario de dos años con el último día de cada mes seleccionado,


makecal -e -i24

Para crear un calendario con 30 días que empieza el 30 de mayo de 1999 y tiene

seleccionado cada tercer día, ejecute el comando siguiente:

makecal -r 3 -s "30 MAY 1999" -i30


|||

|

||

|

|

metronome.pl

Script PERL que obtiene una instantánea de IBM Tivoli Workload Scheduler y

genera un informe html. Cuando un usuario se encuentra con un problema del

producto, este informe puede ser de ayuda para el servicio de soporte al cliente de


Notas sobre el uso

Para obtener más información sobre el programa de utilidad metronome, consulte

la publicación IBM Tivoli Workload Scheduler Troubleshooting and Error Messages.


morestdl

Muestra el contenido de archivos de lista estándar. Debe ejecutar este comando el

usuario para el que se ha instalado IBM Tivoli Workload Scheduler. Si utiliza este

comando sin ningún parámetro, asegúrese de haber iniciado la sesión como

usuario de IBM Tivoli Workload Scheduler.

Sinopsis

morestdl -v | -u

morestdl [-day núm] [-first | -last | -num n | -all]

[-name secuenciatrab.trabajo | númtrabajo]

Argumentos



-day núm

Muestra los archivos de lista estándar que tienen los días de antigüedad

especificados (1 para ayer, 2 para anteayer y así sucesivamente). El valor

predeterminado es cero (hoy).

-first Muestra el primer archivo de lista estándar calificado.

-last Muestra el último archivo de lista estándar calificado.

-num n

Muestra el archivo de lista estándar para la ejecución especificada de un

trabajo.

-all Muestra todos los archivos de lista estándar calificados.

-name secuenciatrab.trabajo

Especifica el nombre de la secuencia de trabajos y del trabajo para los que

se muestra el archivo de lista estándar.

númtrabajo

Especifica el número de trabajo del trabajo para el que se muestra el

archivo de lista estándar.

Ejemplos

Para mostrar el archivo de lista estándar para la primera ejecución del trabajo

mailxhg1.getmail del día actual, ejecute el comando siguiente:

morestdl -first -name mailxhg1.getmail

Para mostrar el archivo de lista estándar para la segunda ejecución del trabajo

mailxhg1.getmail del día actual, ejecute el comando siguiente:

morestdl -num 2 -name mailxhg1.getmail

Para mostrar los archivos de lista estándar para todas las ejecuciones del trabajo

mailxhg1.getmail de hace tres días, ejecute el comando siguiente:

morestdl -day 3 -name mailxhg1.getmail

Para mostrar el archivo de lista estándar para la última ejecución del trabajo

mailxhg1.getmail de hace cuatro días, ejecute el comando siguiente:

morestdl -day 4 -last -name mailxhg1.getmail

Para imprimir el contenido del archivo de lista estándar para el trabajo número

455, ejecute el comando siguiente:


|||

|

||

|

||

|

||

|

||

morestdl 455 | lp -p 6


|

|

parms

Devuelve el valor actual de un parámetro, cambia el valor de un parámetro o

agrega un nuevo parámetro.

Sinopsis

parms [-v | -u]

parms nombre

parms -c nombre valor

Argumentos



nombre Especifica el nombre del parámetro cuyo valor se muestra.

-c nombre valor

Especifica el nombre y el valor de un parámetro. El valor puede contener

hasta 72 caracteres. Si el valor contiene caracteres especiales, debe

especificarse entre comillas. Si el parámetro no existe, se agrega a la base

de datos. Si el parámetro ya existe, se modifica su valor.

Notas sobre el uso

Cuando se ejecuta parms en la línea de comandos sin argumentos, solicita los

nombres y valores de los parámetros.

Ejemplos

Para devolver el valor de myparm, ejecute el comando siguiente:

parms myparm

Para cambiar el valor de myparm, ejecute el comando siguiente:

parms -c myparm "item 123"

Para crear un nuevo parámetro denominado hisparm, ejecute el comando

siguiente:

parms -c hisparm "item 789"

Para cambiar el valor de myparm y añadir herparm, ejecute el comando siguiente:

parms

¿Nombre del parámetro? myparm < Intro>

¿Valor del parámetro ? "item 456" < Intro>

¿Nombre del parámetro? herparm < Intro>

¿Valor del parámetro ? "item 123" < Intro>

¿Nombre del parámetro? < Intro>


||

|

|

|

||

|

|

||||||

|

paxtract

Extrae información sobre parámetros de la base de datos del planificador.

Sinopsis

paxtract [-v | -u] [-o archivo]

Argumentos



-o archivo


Salida del comando

Cada registro de parámetro contiene campos de longitud variable delimitados por


Campo Descripción

Longitud máxima

(bytes)

1 nombre del parámetro 8

2 valor del parámetro 64

Ejemplos

Para extraer información sobre todas las definiciones de parámetros y dirigir la

salida al archivo painfo, ejecute el comando siguiente:

paxtract -o painfo


|||

|

|

prxtract

Extrae información sobre solicitudes de la base de datos del planificador.

Sinopsis

prxtract [-v | -u] [-o archivo]

Argumentos



-o archivo


Salida del comando

Cada registro de solicitud contiene campos de longitud variable delimitados por


Campo Descripción

Longitud máxima

(bytes)

1 nombre de la solicitud 8

2 valor de la solicitud 200

Ejemplos

Para extraer información sobre todas las definiciones de solicitudes y dirigir la

salida al archivo prinfo, ejecute el comando siguiente:

prxtract -o prinfo


|||

|

|

r11xtr

Extrae información sobre secuencias de trabajos de la base de datos del

planificador.

Sinopsis

prxtract [-v | -u] [-m mm[aa]] [-c esttrabajo] [-o archivo]

Argumentos



-m mm[aa]

Especifica el mes (mm) y, si se desea, el año (aa) de las secuencias de

trabajos. El valor predeterminado es el mes y año actual.

-c esttrabajo

Especifica la estación de trabajo de las secuencias de trabajos. El valor

predeterminado es todas las estaciones de trabajo.

-o archivo


Salida del comando






Cada registro de secuencia de trabajos contiene campos de longitud variable

delimitados por tabuladores. Los campos se describen en la tabla siguiente.

Campo Descripción

Longitud máxima

(bytes)


2 nombre de secuencia de trabajos 16

3 fecha de secuencia de trabajos (aammdd) 6

4 segundos estimados de cpu 6

5 distintivo de varias estaciones de trabajo (* significa que

algunos trabajos se ejecutan en otras estaciones de

trabajo)

1

6 número de trabajos 4

7 día de la semana (Su, Mo, Tu, We, Th, Fr, Sa) 2

Ejemplos

Para extraer información sobre secuencias de trabajos en junio de 1999 para la

estación de trabajo main, ejecute el comando siguiente:

r11xtr -m 0699 -c main

Para extraer información sobre secuencias de trabajos en junio de este año para

todas las estaciones de trabajo y dirigir la salida al archivo r11out, ejecute el

comando siguiente:

r11xtr -m 06 -o r11out


|||

|

|||

|

release

Libera unidades de un recurso en el nivel de secuencia de trabajos o de trabajo.

Sinopsis

release -v | -u

release [-s] [esttrabajo#]nombrerecurso

Argumentos



-s Libera unidades de recurso sólo en el nivel de secuencia de trabajos.

Si no se utiliza -s las unidades de recurso se liberan en el nivel de trabajo,

o en el nivel de secuencia de trabajos si no se encuentra el recurso en el

nivel de trabajo.

esttrabajo#

Especifica el nombre de la estación de trabajo o la clase de estación de

trabajo en la que está definido el recurso. El valor predeterminado es la

estación de trabajo local.

nombrerecurso

Especifica el nombre del recurso.

Notas sobre el uso

Las unidades de un recurso las adquiere un trabajo o una secuencia de trabajos en

el momento en que se inicia y liberan automáticamente cuando el trabajo o la

secuencia de trabajos se completa. El comando release puede utilizarse en un

script de trabajo para liberar recursos antes de la conclusión del trabajo o de la

secuencia de trabajos. Las unidades de un recurso se liberan en el mismo orden en

que se adquirieron.

Ejemplos

En la siguiente secuencia de trabajos, la secuencia sked5 necesita dos unidades del

recurso sked5:

schedule ux1#sked5 on tu

needs 2 dbase :

job1

jobrel follows job1

job2 follows jobrel

end

Para liberar el recurso dbase antes de que se inicie job2, el archivo script para

jobrel contiene el siguiente comando:

`maestro`/bin/release -s dbase

Tenga en cuenta que el argumento -s puede omitirse, ya que no se reservaron

recursos en el nivel de trabajo.

En la siguiente secuencia de trabajos, job2 necesita ocho unidades del recurso

discio. Esto se define en dos bloques de 5 y 3 de modo que puedan liberarse

gradualmente en el mismo orden en que fueron adquiridos.


|

schedule ux1#sked7 on weekdays

:

job1

job2 follows job1 needs 5 discio,3 discio

job3 follows job2

end

Para liberar el recurso discio gradualmente mientras job2 se está ejecutando, el

script para job2 contiene las siguientes líneas de comandos:

...

# Liberar 5 unidades de discio:

`maestro`/bin/release discio

...

# Liberar 3 unidades de discio:

`maestro`/bin/release discio

...


rextract

Extrae información sobre recursos de la base de datos del planificador.

Sinopsis

rextract [-v | -u] [-o archivo]

Argumentos



-o archivo


Salida del comando

Cada registro de recurso contiene campos de longitud variable delimitados por

tabuladores. Los campos se describen en la siguiente tabla.

Campo Descripción

Longitud máxima

(bytes)

1 nombre de estación de trabajo 8/16

2 nombre del recurso 8

3 total de unidades del recurso 4

4 descripción del recurso 72

Ejemplos

Para extraer información sobre todas las definiciones de recursos y dirigir la salida

al archivo reinfo, ejecute el comando siguiente:

rextract -o reinfo


|||

|

|

rmstdlist

Elimina o muestra archivos de lista estándar basándose en la antigüedad del

archivo.

Sinopsis

rmstdlist -v | -u

rmstdlist [-p] [antigüedad]

Argumentos



-p Muestra los nombres de directorios de archivos de lista estándar

calificados. No se eliminan directorios ni archivos. Si no especifica -p, los

archivos de lista estándar calificados se eliminan.

antigüedad

La antigüedad mínima, en días, de los directorios de archivos de lista

estándar que se deben mostrar o eliminar. El valor predeterminado es 10

días.

Ejemplos

Para mostrar los nombres de los directorios de archivos de lista estándar que

tienen más de 14 días de antigüedad, ejecute el comando siguiente:

rmstdlist -p 14

Para eliminar todos los archivos de lista estándar (y sus directorios) que tienen

más de 7 días de antigüedad, ejecute el comando siguiente:

rmstdlist 7


|||

|

||

|

|

showexec

Muestra el estado de los trabajos en ejecución. Sólo para UNIX. Este comando es

para los agentes estándar. En los gestores de dominio y en los agentes tolerante a

errores, utilice en su lugar el comando conman showjobs de Conman.

Sinopsis

showexec [-v | -u | -info]

Argumentos



-info Muestra el nombre del archivo de trabajo en lugar del usuario, fecha y

hora.

Salida del comando

La salida del comando está disponible en dos formatos: estándar e info.

Formato standard:


Planificación El nombre de la secuencia de trabajos en la que se ejecuta el

trabajo.

Trabajo El nombre del trabajo.

NúmTrab El número de trabajo.

Usuario El nombre de usuario del trabajo.

Fecha de inicio

La fecha en la que empezó a ejecutarse el trabajo.

Hora de inicio

La hora a la que empezó a ejecutarse el trabajo.

Transc(Est) El tiempo estimado, en minutos, que tardará en ejecutarse el

trabajo.

Formato info:


Planificación El nombre de la secuencia de trabajos en la que se ejecuta el

trabajo.

Trabajo El nombre del trabajo.

NúmTrab El número de trabajo.

JCL El nombre de archivo del trabajo.

Ejemplos

Para mostrar los trabajos en ejecución en formato standard, ejecute el comando

siguiente:

showexec

Para mostrar los trabajos en ejecución en formato info, ejecute el comando

siguiente:

showexec -info


|||

|

||

|

StartUp

Inicia el proceso de gestión de red del planificador, Netman. Debe tener acceso

start a la estación de trabajo.

Sinopsis

StartUp [-v | -u]

Argumentos



Notas sobre el uso

En Windows, el servicio Netman se inicia automáticamente cuando se reinicia un

sistema. StartUp puede utilizarse para reiniciar el servicio si éste se detiene por

cualquier motivo.

En UNIX, el comando StartUp se suele instalar en el archivo /etc/rc, de forma que

Netman se inicia cada vez que se rearranca un sistema. StartUp puede utilizarse

para reiniciar Netman si éste se detiene por cualquier motivo.

El resto del árbol de procesos puede reiniciarse con un comando conman start.

Para obtener más información, consulte el apartado “start” en la página 216.

Ejemplos

Para mostrar el nombre y la versión del comando, ejecute el comando siguiente:

StartUp -v

Para iniciar el proceso Netman, ejecute el comando siguiente:

StartUp


|

||

|

|

|

|

version

Muestra información sobre la versión del planificador. Sólo para UNIX. La

información se extrae de un archivo de versión.

Sinopsis

version/version -V | -u | -h

version/version [-a] [-f archvers] [-p producto] [archivo [...]]

Argumentos

-V Muestra la versión del comando.


-h Muestra la información de ayuda para el comando.

-a Muestra información sobre todos los archivos de producto. El valor

predeterminado es mostrar información sólo acerca de los archivos

especificados.

-f archvser

Especifica el nombre del archivo de versión. El valor predeterminado es un

archivo denominado version.info en el directorio de trabajo actual o en el

directorio de producto especificado con -p.

-p producto

Especifica el nombre del producto Tivoli cuyo directorio está

inmediatamente debajo del directorio de trabajo actual y contiene un

archivo version.info. Si se omite, se utiliza -f, o su valor predeterminado.

archivo Especifica los nombres de los archivos de producto, separados por

espacios, para los que se muestra información de la versión. El valor

predeterminado es no visualizar ninguna información de archivo o, si se

utiliza -a, toda la información de archivo.

Salida del comando

La cabecera de la salida contiene el nombre del producto, la versión, la plataforma,

el nivel de parche y la fecha de instalación. El resto de la pantalla muestra

información sobre el archivo o archivos especificados. Los archivos se listan en el

formato siguiente:

Archivo El nombre del archivo.

Revisión El número de revisión del archivo.

Parche El nivel de parche del archivo, si lo hay.

Tamaño (bytes)

El tamaño del archivo en bytes.

Suma de comprobación

La suma de comprobación para el archivo. Las sumas de

comprobación se calculan con el comando sum de UNIX. En AIX,

sum se utiliza con el argumento -o.

Notas sobre el uso

La información de archivo de IBM Tivoli Workload Scheduler está incluida en el

archivo version.info. Este archivo se coloca en el directorio TWShome/version

durante la instalación. El archivo version.info está en un formato específico y no

debe alterarse.


Puede trasladar el archivo version.info a otro directorio. No obstante, deberá

incluir el argumento -f para localizar el archivo.

Puede utilizar el argumento -p si el directorio actual contiene los directorios de

varios productos Tivoli. Esto le permite acceder a la información sobre la versión

especificando el nombre del producto.

Ejemplos

Para mostrar información sobre todos los archivos, ejecute el comando siguiente:

version/version -a -f version/version.info

Para mostrar información sobre el archivo customize, ejecute el comando siguiente:

cd version

./version customize

Para mostrar información sobre el archivo customize, cuando version.info está

ubicado en /apps/maestro, ejecute el comando siguiente:

cd version

./version -f /apps/maestro/version.info customize


||

|

|

||

||

||

|

wmaeutil

Se utiliza para detener el servidor de conector para el plan, la base de datos y el

motor. El comando makesec no se ejecutará satisfactoriamente en plataformas

Windows hasta que se detengan los conectores.

Sinopsis

UNIX:

wmaeutil.sh nombre_instancia[-stop DB | PL | EG | “*”] [-version DB | PL | EG

| “*”] [-dbinfo DB | PL] [-sethome] [-gethome] [ALL -stop]

Windows:

wmaeutil.cmd nombre_instancia[-stop DB | PL | EG | “*”] [-version DB | PL |

EG | “*”] [-dbinfo DB | PL] [-sethome] [-gethome] [ALL -stop]

Argumentos

nombre_instancia

El nombre de la instancia del planificador. Hace referencia al nombre de

instancia que ha especificado durante la instalación del motor del

planificador y la instalación del conector.

-stop DB | PL | EG | “*”

Esta opción puede utilizarse para concluir el servidor de conector

especificado. El asterisco (*) puede utilizarse para concluir los tres

servidores de conector. Si se utiliza, debe indicarse entre comillas.

-version DB | PL | EG | “*”

Esta opción se utiliza para obtener el número de versión del servidor de

conector para el plan, la base de datos y el motor que está instalada en el

sistema. El asterisco (*) puede utilizarse para obtener las versiones de los

tres servidores de conector. Si se utiliza, debe indicarse entre comillas.

-dbinfo DB | PL

Esta opción se utiliza para averiguar si la base de datos del planificador y

el plan al que está vinculado este conector es expandida o no expandida.

Con IBM Tivoli Workload Scheduler, Versión 8.2, las bases de datos y los

planes siempre se expanden, pero esta opción existe a efectos de


-sethome

Esta opción se utiliza para establecer el atributo TWShome de los objetos

del planificador (Motor, Base de datos y Plan) en la base de datos de

objetos de Tivoli. Este atributo vincula los conectores para la instancia de

objeto especificada con el producto planificador base. Adopta el nombre

calificado al completo del directorio inicial del planificador como

argumento. Además, la serie de nombre de ruta debe estar entre comillas

para impedir cualquier interpretación del shell.

-gethome

Esta opción no requiere ningún argumento e imprime el valor del atributo

TWShome para las instancias de los objetos Motor, Base de datos y el Plan,

tal como está definido en la base de datos de objetos.

ALL -stop

Esta opción detiene los servidores de conector para todas las instancias de

conector del planificador conectadas a la instalación del planificador actual,


es decir, detiene los servidores de conector para todas las instancias cuyo

atributo TWShome coincida con el directorio inicial de la instalación actual

del planificador.

Notas sobre el uso

Variables de entorno establecidas: Para poder ejecutar wmaeutil

satisfactoriamente, antes debe:

1. Establecer el entorno de Tivoli Management Framework:

En Windows:c:\>%SystemRoot%\system32\drivers\etc\Tivoli\setup_env.cmd

En UNIX:$ . /etc/Tivoli/setup_env.sh

2. Establecer el entorno de IBM Tivoli Workload Scheduler:

En Windows:TWShome\tws_env.cmd

En UNIX:TWShome/tws_env.sh para shells Bourne y TWShome/tws_env.csh para

shells C.

Puede actualizar el perfil de UNIX para que ejecute este archivo y evitarse así el

tener que ejecutar el comando de forma manual.

Consideraciones acerca de makesec: El comando wmaeutil debe ejecutarse antes

de ejecutar el comando makesec. El comando makesec no se ejecutará

satisfactoriamente en plataformas Windows hasta que se detengan los conectores.

También debe detener los conectores cuando utilice el comando makesec en UNIX.

Nombre de instancia de IBM Tivoli Workload Scheduler: Si no recuerda el

nombre de instancia que se especificó durante la instalación, siga estos pasos:

1. Establezca el origen de las variables de entorno de Tivoli:

. /etc/Tivoli/setup_env.sh (para UNIX)

C:\winnt\system32\drivers\etc\Tivoli\setup_env.cmd (para Windows)

2. Ejecute el comando wlookup para obtener el nombre de instancia del

planificador:

wlookup -ar MaestroEngine

maestro2 1697429415.1.596#Maestro::Engine#

donde maestro2 es el nombre de instancia del planificador.

Ejemplos

Para detener los conectores de la base de datos, el plan y el motor para una

instancia llamada maestro, ejecute el comando siguiente:

wmaeutil.sh maestro ALL -stop

Para detener los conectores de la base de datos para una instancia llamada tws,


wmaeutil.sh tws ALL -stop DB

Para detener las versiones de conector de la base de datos, el plan y el motor para

una instancia llamada maestro2, ejecute el comando siguiente:

wmaeutil.sh maestro2 -version *


|||

|

||

|

||

|

|

xrxtrct

Extrae información sobre referencias cruzadas de la base de datos del planificador.

Sinopsis

xrxtrct [-v | -u]

Argumentos



Salida del comando






La salida del comando se graba en ocho archivos, xdep_job, xdep_sched, xfile,

xjob, xprompt, xresources, xsched y xwhen.

Archivo xdep_job: El archivo xdep_job contiene dos tipos de registro. El primero

incluye información sobre trabajos y secuencias de trabajos que son dependientes

de un trabajo. Cada registro de trabajo y secuencia de trabajos dependiente

contiene campos de longitud fija sin delimitadores. Los campos se describen en la

tabla siguiente.

Campo Descripción Longitud (bytes)

1 03 2




5 no se utiliza 240

6 nombre de estación de trabajo de secuencia de trabajos

dependiente

16

7 nombre de secuencia de trabajos dependiente 16

8 nombre de estación de trabajo dependiente 16

9 nombre de trabajo dependiente 40

10 no se utiliza 6

11 no se utiliza 6

12 no se utiliza 8

13 fin de registro (nulo) 1

El segundo tipo de registro incluye información sobre trabajos y secuencias de

trabajos que son dependientes de una dependencia de inter-red. Cada registro de

trabajo y secuencia de trabajos dependiente contiene campos de longitud fija sin

delimitadores. Los campos se describen en la tabla siguiente.


1 08 2





4 no se utiliza 128


dependiente

16




9 no se utiliza 6

10 no se utiliza 6

11 no se utiliza 8


Archivo xdep_sched: El archivo xdep_sched contiene información sobre

secuencias de trabajos que son dependientes de una secuencia de trabajos. Cada

registro de secuencia de trabajos dependiente contiene campos de longitud fija sin

delimitadores. Los campos se describen en la tabla siguiente.


1 02 2



4 no se utiliza 248


dependiente

16


7 no se utiliza 8

8 no se utiliza 8

9 no se utiliza 6

10 no se utiliza 6

11 no se utiliza 8


Archivo xfile: El archivo xfile contiene información sobre trabajos y secuencias de

trabajos que son dependientes de un archivo. Cada registro contiene campos de

longitud fija sin delimitadores. Los campos se describen en la tabla siguiente.


1 07 2


3 nombre de archivo 256


dependiente

16






8 no se utiliza 6

9 no se utiliza 6

10 no se utiliza 8


Archivo xjob: El archivo xjob incluye información sobre las secuencias de trabajos

en las que aparece el trabajo. Cada registro de trabajo contiene campos de longitud

fija sin delimitadores. Los campos se describen en la tabla siguiente.


1 04 2



4 no se utiliza 248

5 nombre de estación de trabajo de secuencia de trabajos 16


7 no se utiliza 8

8 no se utiliza 8

9 no se utiliza 6

10 no se utiliza 6

11 no se utiliza 8


Archivo xprompt: El archivo xprompt incluye información sobre trabajos y

secuencias de trabajos que son dependientes de una solicitud. Cada registro de

solicitud contiene campos de longitud fija sin delimitadores. Los campos se

describen en la tabla siguiente.


1 05 2


3 texto o nombre de solicitud 20

4 no se utiliza 236


dependiente

16




9 no se utiliza 6

10 no se utiliza 6

11 no se utiliza 8




Archivo xresource: El archivo xresource incluye información sobre trabajos y

secuencias de trabajos que son dependientes de un recurso. Cada registro de

recurso contiene campos de longitud fija sin delimitadores. Los campos se



1 06 2


3 nombre del recurso 8

4 no se utiliza 248


dependiente

16




9 unidades asignadas 6

10 no se utiliza 6

11 no se utiliza 8


Archivo xsched: El archivo xsched incluye información sobre secuencias de

trabajos. Cada registro de secuencia de trabajos contiene campos de longitud fija

sin delimitadores. Los campos se describen en la tabla siguiente.


1 00 2



4 no se utiliza 248

5 nombre de estación de trabajo (igual que el campo 2) 16

6 nombre de secuencia de trabajos (igual que el campo 3) 16

7 no se utiliza 8

8 no se utiliza 8

9 no se utiliza 6

10 no se utiliza 6

11 no se utiliza 8


Archivo xwhen: El archivo xwhen incluye información sobre cuando se

ejecutarán las secuencias de trabajo. Cada registro de secuencia de trabajos

contiene los siguientes campos de longitud fija sin delimitadores. Los campos se




1 01 2


3 Nombre o fecha de ON/EXCEPT 8

4 distintivo de excepción (*=EXCEPT) 1

5 no se utiliza 247



8 no se utiliza 8

9 no se utiliza 8

10 no se utiliza 6

11 número de desplazamiento 6

12 unidad de desplazamiento 8


Ejemplos

Para extraer información sobre todas las referencias cruzadas, ejecute el comando

siguiente:

xrxtrct


|||

|

|

Comandos no soportados

Los siguientes comandos de utilidad no soportados ofrecen, en Windows,

funciones parecidas a los comandos ps y kill de UNIX. Se pueden utilizar si no se

dispone de programas de utilidad de Windows similares.

Sinopsis

listproc

killproc pid

Notas sobre el uso

listproc

Muestra un listado en forma de tabla de los procesos del sistema.

killproc

Aborta el proceso que tiene el ID de proceso pid.

Nota: Cuando lo ejecuta el Administrador, killproc puede abortar procesos del

sistema.


Capítulo 7. Los comandos de informe

En este capítulo se describen los comandos de informe que permiten obtener

información resumida o detallada sobre el día de producción anterior o siguiente.

Comandos de informe

En la tabla siguiente se listan los comandos de informe de IBM Tivoli Workload

Scheduler.

Comando Informe

rep1 Informe 01 - Listado de detalles del trabajo

rep2 Informe 02 - Listado de solicitudes

rep3 Informe 03 - Listado de calendarios

rep4a Informe 04A - Listado de parámetros

rep4b Informe 04B - Listado de recursos

rep7 Informe 07 - Listado histórico de trabajos

rep8 Informe 08 - Histograma de trabajo

rep11 Informe 11 - Planificación de producción

reptr Informe 09A - Resumen de producción planificada

Informe 09B - Detalle de producción planificada

Informe 09D - Detalle de producción planificada (nombres largos)

Informe 10A - Resumen de producción real

Informe 10B - Detalle de producción real

xref Informe 12 - Informe de referencias cruzadas

Salida de los comandos

La salida de los comandos de informe está controlada por las variables siguientes:

MAESTROLP

Especifica el destino de la salida de un comando. El valor predeterminado

es stdout. Puede establecerla en uno de los siguientes valores:

nombarchivo

Grabar la salida en un archivo.

> nombarchivo

Sólo para UNIX. Redirigir la salida a un archivo, sobregrabando el

contenido del archivo. Si el archivo no existe, se crea.

>> nombarchivo

Sólo para UNIX. Redirigir la salida a un archivo, agregándola al

final del archivo. Si el archivo no existe, se crea.

| comando

Sólo para UNIX. Dirigir la salida a un comando del sistema o un

proceso. El comando del sistema siempre se ejecuta.

|| comando

Sólo para UNIX. Dirigir la salida a un comando del sistema o un

proceso. El comando del sistema no se ejecuta si no hay salida.


MAESTRO_OUTPUT_STYLE

Especifica el estilo de salida para nombres de objeto largos. Establezca la

variable en LONG para utilizar campos de longitud completa (largos) para

nombres de objetos.

Si no se establece o se establece en cualquier otro valor distinto de LONG,

los nombres largos se truncan en ocho caracteres y un signo más. Por

ejemplo: A1234567+.

Cambio del formato de fecha

En IBM Tivoli Workload Scheduler, el formato de fecha afecta a todos los

comandos que aceptan una fecha como opción de entrada (con excepción del

comando datecalc) y a las cabeceras de todos los informes. El formato de fecha

predeterminado es mm/dd/aa. Para seleccionar otro formato, edite la opción local de

formato de fecha. Los valores son:

0 Para seleccionar: aa/mm/dd

1 Para seleccionar: mm/dd/aa

2 Para seleccionar: dd/mm/aa

3 Para utilizar: Variables NLS (Native language Support).

Para conocer detalles sobre la modificación de variables locales, consulte la



Comandos rep1 - rep4b

Estos comandos imprimen los informes siguientes:

Informe 01 - Listado de detalles del trabajo

Informe 02 - Listado de mensajes de solicitud

Informe 03 - Listado de calendarios de usuario

Informe 04A - Listado de parámetros de usuario

Informe 04B - Listado de recursos de Maestro

Sinopsis

rep[x] [-v|-u]

Argumentos

x Un número que corresponde al informe. Los números son: 1, 2, 3, 4a o 4b.

-u Mostrar la versión del comando.

-v Mostrar la información sobre el uso del comando.

Ejemplos

Imprimir el Informe 03, Listado de calendarios de usuario:

rep3

Mostrar información sobre el uso del comando rep2:

rep2 -u

En UNIX, imprimir dos copias del informe 04A, Listado de parámetros de usuario,

en la impresora lp2:

MAESTROLP="| lp -dlp2 -n2"

export MAESTROLP

rep4a


Comando rep7

Este comando imprime el Informe 07, Listado histórico de trabajos.

Sinopsis

rep7 -v|-u

rep7 [-c esttrabajo] [-s secuenciatrab] [-j trabajo] [-f fecha -t fecha] [-l]

Argumentos



-c esttrabajo

Especifica el nombre de la estación de trabajo en la que se ejecuta el

trabajo. El valor predeterminado es todas las estaciones de trabajo.

-s secuenciatrab

Especifica el nombre de la secuencia de trabajos en la que se ejecuta el

trabajo. El valor predeterminado es todas las secuencias de trabajos.

-j trabajo

Especifica el nombre del trabajo. El valor predeterminado es todos los

trabajos.

-f fecha

Especifica imprimir el histórico de trabajos desde esta fecha en adelante.

Entre la fecha como aaaammdd. El valor predeterminado es la fecha más

antigua disponible.

-t fecha Especifica imprimir el histórico de trabajos hasta esta fecha. Entre la fecha

como aaaammdd. El valor predeterminado es la fecha más reciente.

-l Limita la información de la línea de resumen a los trabajos que están

comprendidos en el rango de fechas especificado en las opciones -f o -t. Si

utiliza esta opción se invertirá el orden de la salida: la línea de resumen de

trabajos se imprimirá después de las líneas de ejecución de trabajos

individuales. Esta opción sólo es válida si también se especifica, como

mínimo, una de las opciones -f o -t.

Ejemplos

Imprimir todo el histórico de trabajos para la estación de trabajo ux3:

rep7 -c ux3

Imprimir todo el histórico de trabajos para todos los trabajos de la secuencia de

trabajos sked25:

rep7 -s sked25

Imprimir el histórico de trabajos para todos los trabajos de la secuencia de trabajos

mysked en la estación de trabajo x15 entre el 21/1/99 y el 25/1/99:

rep7 -c x15 -s mysked -f 19990121 -t 19990125


Comando rep8

Este comando imprime el Informe 08, Histograma de trabajo.

Sinopsis

rep8 -v|-u

rep8 [-f fecha -b hora -t fecha -e hora] [-i archivo] [-p ]

rep8 [-b hora -e hora] [-i archivo] [-p ]

Argumentos



-f fecha

Especifica imprimir el histórico de trabajos desde esta fecha en adelante.

Entre la fecha como aaaammdd. El valor predeterminado es la fecha del día.

-b hora

Especifica imprimir el histórico de trabajos desde esta hora en adelante.

Entre la hora como hhmm. El valor predeterminado es la hora de inicio del

día del planificador.

-t fecha Especifica imprimir el histórico de trabajos hasta esta fecha. Entre la fecha

como aaaammdd. El valor predeterminado es la fecha más reciente.

-e hora Especifica imprimir el histórico de trabajos hasta esta hora. Entre la hora

como hhmm. El valor predeterminado es la hora de inicio del día del

planificador.

-i archivo

Especifica el nombre del archivo de registro del que se extrae el histórico

de trabajos. Tenga en cuenta que los archivos de registro se almacenan en

el directorio schedlog. El valor predeterminado es el plan actual (archivo

Symphony).

Nota: Asegúrese de que el rango de tiempo especificado por los

argumentos [-f fecha -b hora -t fecha -e hora] queda dentro del rango

de fechas y horas definido en el argumento -i archivo del archivo de

registro.

-p Especifica insertar un salto de página después de cada fecha de ejecución.

Ejemplos

Imprimir un histograma de trabajo que incluya toda la información del plan actual

(archivo Symphony):

rep8

Imprimir un histograma de trabajo que empiece a las 6:00 a.m. del 25/1/99 y

termine a las 5:59 a.m. del 26/1/99.

rep8 -f 19990125 -b 0600 -t 19990126 -e 0559 -i schedlog/M199801260601

Imprimir un histograma de trabajo, del plan actual (archivo Symphony), que

empiece a las 6:00 am y termine a las 10:00 pm:

rep8 -b 0600 -e 2200


Comando rep11

Este comando imprime el Informe 11, Planificación de producción.

Sinopsis

rep11 -v|-u

rep11 [-m mm[aa] [...]] [-c esttrabajo [...]] [-o archivo]

Argumentos



-m mm[aa]

Especifica los meses que ha de incluir el informe. Entre el número del mes

como mm. El valor predeterminado es el mes actual.

También puede entrar un año como aa. El valor predeterminado es el año

actual o el año próximo si especifica un mes anterior al mes actual.

-c esttrabajo

Especifica las estaciones de trabajo que ha de incluir el informe. El valor

predeterminado es todas las estaciones de trabajo.

-o archivo

Especifica el archivo de salida. El valor predeterminado es el archivo

definido por la variable MAESTROLP. Si MAESTROLP no está

establecida, el valor predeterminado es stdout.

Ejemplos

Crear un informe de junio, julio y agosto de 1999 para las estaciones de trabajo

main, site1 y sagent1:

rep11 -m 0699 0799 0899 -c main site1 sagent1

Crear un informe de junio, julio y agosto de este año para todas las estaciones de

trabajo y dirigir la salida al archivo r11out:

rep11 -m 06 07 08 -o r11out

Crear un informe del mes y año actual para la estación de trabajo site2:

rep11 -c site2


Comando reptr

Este comando imprime los siguientes informes:

v Informe 09A - Resumen de producción planificada

v Informe 09B - Detalle de producción planificada

v Informe 10A - Resumen de producción real

v Informe 10B - Detalle de producción real

Sinopsis

reptr [-v|-u]

reptr -pre [-{summary | detail}] [archivosym]

reptr -post [-{summary | detail}] [archivoregistro]

Argumentos



-pre Especifica imprimir los informes de pre-producción (09A, 09B).

-post Especifica imprimir los informes de post-producción (10A, 10B).

-summary

Especifica imprimir los informes de resumen (09A, 10A). Si se omiten

-summary y -detail, se imprimen los dos grupos de informes.

-detail Especifica imprimir los informes de detalle (09B, 10B). Si se omiten

-summary y -detail, se imprimen los dos grupos de informes.

archivosym

Especifica el nombre del archivo de plan del cual se imprimirán los

informes. El valor predeterminado es Symnew en el directorio actual.

archivoregistro

Especifica el nombre del archivo de registro del cual se imprimirán los

informes. Tenga en cuenta que los archivos de registro del plan se

almacenan en el directorio schedlog. El valor predeterminado es el plan

actual (archivo Symphony).

Si el comando se ejecuta sin ninguna opción, se imprimen todos los informes

previos y posteriores.

Ejemplos

Imprimir el informe de detalle de pre-producción del archivo Symnew:

reptr -pre -detail

Imprimir el informe de resumen de pre-producción del archivo mysym:

reptr -pre -summary mysym

Imprimir el informe de resumen de post-producción del archivo de registro

M199903170935:

reptr -post -summary schedlog/M199903170935

Imprimir todos los informes de pre-producción y post-producción.

reptr


Los informes de pre-producción se basan en información leída del archivo

Symnew. Los informes de post-producción se basan en información leída del

archivo Symphony.


Comando xref

Este comando imprime el Informe 12, Informe de referencias cruzadas.

Sinopsis

xref [-V|-U]

xref [-cpu esttrabajo][-depends|-files|-jobs|-prompts|-resource|-schedules|-when [...]]

Argumentos

-U Mostrar la versión del comando.

-V Mostrar la información sobre el uso del comando.

-cpu esttrabajo

Especifica imprimir el informe para la estación de trabajo nombrada. El

comodín @ está permitido, en cuyo caso, se incluye información de todas

las estaciones de trabajo calificadas. El valor predeterminado es todas las

estaciones de trabajo.

-depends

Especifica imprimir un informe que muestre los trabajos y secuencias de

trabajos que son sucesores de cada trabajo.

-files Especifica imprimir un informe que muestre los trabajos y secuencias de

trabajos que dependen de cada archivo.

-jobs Especifica imprimir un informe que muestre las secuencias de trabajos en

las que se ejecuta cada trabajo.

-prompts


trabajos que dependen de cada solicitud.

-resource


trabajos que dependen de cada recurso.

-schedules


trabajos que son sucesores de cada secuencia de trabajos.

-when Especifica imprimir un informe que muestre las fechas de inclusión y

exclusión de secuencias de trabajos.

Si el comando se ejecuta sin ninguna opción, se seleccionan todas las estaciones de

trabajo y todas las opciones.

Ejemplos

Imprimir un informe para todas las estaciones de trabajo que muestre toda la

información de referencias cruzadas:

xref

Imprimir un informe para todas las estaciones de trabajo. Incluir información de

referencias cruzadas sobre todas las dependencias de sucesor:

xref -cpu @ -depends -schedules


Informes de ejemplo

Informe 01 — Listado de detalles del trabajo:

TWS para UNIX (SOLARIS)/INFORME1 8.2 (1.8)

IBM Pág. 1

Informe 01 Listado de detalles

de trabajo 06/11/03

Trabajo: SUN001 #ACC

Descripción:

Archivo JCL : ^ACCHOME^

Inicio sesión : ^ACCLOGIN^ Creador:

maestro

Trabajo de recuperación :

Tipo de recuperación : STOP

Solicitud de recuperación :

Autodoc. Composer : Sí

Ejec. totales : 0 - 0 Satisfact., 0 Canceladas

T. transc.(min.) CPU(seg.)

Total 00:00:00 0

Normal 00:00:00

Última ejecución 00:00:00 0 (Activo a las 00:00)

Máximo 00:00:00 0 (Activo )

Mínimo 00:00:00 0 (Activo )

Informe 02 — Listado de solicitudes:

TWS para UNIX (SOLARIS)/INFORME2 8.2 (1.6) IBM

Pág. 1

Informe 02 Listado de mensajes de solicitud

06/11/03

Mensaje de solicitud

ACCRES Responda SÍ cuando esté preparado para ejecutar acc103 y acc104.

ACCUSERS ¿Han finalizado la sesión todos los usuarios de ACC?

CALLNO 555-0911

CALLOPER Llame a ^PERSONONCALL^ en ^CALLNO^ para asegurarse que se

han procesado todas las tarjetas de tiempo.

HRSRES Responda SÍ cuando esté preparado para ejecutar hrs103 y hrs104.

MISRES Responda SÍ cuando esté preparado para ejecutar mis103 y mis104.

PERSONONCALL Lou Armstrong

Número total de solicitudes en archivo: 7

Informe 03 — Listado de calendario:


Informe 03 Listado de calendario de usuario 06/22/03

Tipo de calendario: DÍASPAGO Descripción: Días de pago de la compañía

Oct. 2003 Nov. 2003

Dom Lun Mar Mié Jue Vie Sáb Dom Lun Mar Mié Jue Vie

. . . . . . . . . . . . .

12 . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . 27 28

Informe 04A — Listado de parámetros:

TWS para UNIX (SOLARIS)/INFORME4A 8.2 (1.6) IBM

Pág. 1

Informe 4A Listado de parámetros de usuario

06/11/03

Nombre de parámetro Contenido

ACCHOME /usr/local/Tivoli/maestro/scripts

ACCLOGIN maestro

BADEXIT 99

GOODEXIT 0


|

|

||||||||||||||||||||

|

||||||||||||||

|

|||||||||

|

|||||||||

LONG 2000

SCRPATH /usr/local/Tivoli/maestro/scripts

SHORT 20

Número de parámetros en archivo: 7

Informe 04B — Listado de recursos:

TWS para UNIX (SOLARIS)/INFORME4B 8.2 (1.6) IBM

Pág. 1

Informe 4B Listado de recursos TWS

06/11/03

Recurso Número

CPU Nombre Dispon. Descripción

SUN001 #ACCDB 1 Base de datos

SUN001 #ACCODB 5 Recurso de clase Maestro

SUN001 #ACCONE 1 Recurso de clase Maestro

SUN001 #ACCPRT 2 Impresoras

SUN001 #ACCTAPE 1 Unidad de cintas

SUN001 #HRSODB 5 Recurso de clase Maestro

SUN001 #HRSONE 1 Recurso de clase Maestro

SUN001 #MISODB 5 Recurso de clase Maestro

SUN001 #MISONE 1 Recurso de clase Maestro

Número de recursos en archivo: 9

Informe 07 — Listado de historia de trabajo:

TWS para UNIX (SOLARIS)/INFORME7 8.2 (1.10)

IBM Pág. 1

Informe 07 Listado de historia

de trabajo 06/11/03

Fecha Hora Nombre planif. Tpo. transc. CPU

Estado

Trabajo:SUN001 #ACCJOB01 Ejecuciones: Canceladas 1 Satisfactorias 1 Tiempo

transcurrido: Normal 2 Mín 2 Máx 2

06/10/03 09:36 SUN001 #ACCW01 2 1

SU

06/10/03 10:32 SUN001 #ACCW11 2 1

AB

Trabajo:SUN001 #ACCJOB02 Ejecuciones: Canceladas 1 Satisfactorias 1 Tiempo

transcurrido: Normal 2 Mín 1 Máx 2

06/10/03 09:44 SUN001 #ACCW01 2 1

SU

06/10/03 10:31 SUN001 #ACCW11 1 1

AB

Informe 08 — Histograma de trabajo:


Pág. 1

Informe 08 Histograma de trabajo 06/10/03 12:41 - 06/11/03 12:40

06/11/03

Intervalo por columna: 15 minutos

2 0 0 0 0 0 0 0 1 1

CPU es SUN001 3 0 2 3 5 6 8 9 1 2

1 4 1 4 1 4 1 4 1 4

Trabajo Nombre Est 1 1 1 1 1 1 1 1 1 0

06/11/03

TESTRET+.ACCJOB03SU .

ACCW02 .ACCJOB14AB .

HRSW02 .HRSJOB14AB .

MISW02 .MISJOB14AB .

JOBS .ACCENV SU .

Informe 11 — Planificación de producción:

TWS para UNIX/INF11 8.2

AWSBJA001I Licensed Materials Property of IBM

5698-WKB


||||

|

||||||||||||||||

|

||||||||||||||||||

|

|||||||||||||||

|

|||



Uso, duplicación o revelación restringidos por el GSA ADP Schedule Contract

TWS para UNIX (SOLARIS)/INFORME11 8.2 (1.5.1.1) IBM

Informe 11 Planificación de producción para JUNIO de 2003

CPU: SUN001

Núm. Est. CPU 1 2 3 4 5 6 7

12 13 14 15 16 17 18 19 20

26 27 28 29 30

Planif. Trabs. Hora Dom Lun Mar Mié Jue Vie

Mié Jue Vie Sáb Dom Lun Mar Mié Jue

Mié Jue Vie Sáb Dom Lun

ACCDAIL+ 1 0 * * * * * * * * * *

ACCW01 4 4 * * * * * * * * * *

ACCW02 5 3 * * * * * * * * * *

ACCW11 3 3 * * * * * * * * * *

ACCW12 3 3 * * * * * * * * * *

FINAL 1 4 * * * * * * * * * * * * * * *

HRSW01 4 0 * * * * * * * * * *

HRSW02 5 2 * * * * * * * * * *

Informe 12 — Informe de referencias cruzadas:

TWS para UNIX (SOLARIS)/REFCRUZ 8.2 (1.5)

IBM Pág. 1

Informe 12 Informe de referencias cruzadas para dependencias

de trabajo. 06/13/03

CPU: SUN001

Nombre de trabajo Dependencias

ACCR01 #ACCJOB01 ACCR01 .ACCJOB02

ACCW01 #ACCJOB01 ACCW01 .ACCJOB04










||||||||||||||||||||

|

||||||||||||||||

|

Capítulo 8. Consulta del agente ampliado

En este capítulo se describe la Interfaz de agente ampliado y se proporciona

información para los programadores que desean crear métodos de acceso

personalizados. Se utilizan Agentes ampliados para ampliar las funciones de

planificación de trabajos de IBM Tivoli Workload Scheduler a otros sistemas y

aplicaciones, como por ejemplo los siguientes: Sistemas UNIX locales o remotos,

Peoplesoft, SAP R/3, z/OS, OPC, Oracle CCM y VMS. En este capítulo se

suministra información acerca de lo siguiente:

v ¿Qué son los agentes ampliados?

v Interfaz del método de acceso

v Ejecución del método

v Resolución de problemas

Qué son los agentes ampliados

Los agentes ampliados sirven para prolongar las funciones de planificación de

trabajos de 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 puede ser cualquier otra estación de trabajo, excepto

otro agente ampliado. El método de acceso es un programa o script suministrado

por IBM o por el usuario que ejecuta el host 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 y le pasa los detalles del

trabajo en forma de opciones de línea de comandos. El método de acceso se

comunica con la aplicación o el sistema externo 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 tener como host una estación de trabajo física de

IBM Tivoli Workload Scheduler, ya sea una estación de trabajo maestra, un gestor

de dominio, un FTA o un agente estándar. La definición de estación de trabajo

agente ampliado hace referencia al nombre del método de acceso y a la estación de

trabajo host. Cuando se inician trabajos en la estación de trabajo agente ampliado,

se llama al método de acceso y se pasa la información del trabajo al sistema

externo.

Interfaz del método de acceso

La interfaz entre IBM Tivoli Workload Scheduler y un método de acceso consiste

en la información que se pasa al método en la línea de comandos y 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 utilizando la siguiente

sintaxis de línea de comandos:

nombremétodo -t tareas opciones

-- serietareas


donde:

nombremétodo

Especifica el nombre de archivo del método de acceso. Todos los métodos

de acceso se deben almacenar en el directorio: TWShome/methods

-t tarea Especifica la tarea que se debe llevar a cabo, donde tarea es una de las

siguientes:

LJ Inicia un trabajo.

MJ Gestiona un trabajo iniciado anteriormente. Utilice esta opción para

volver a sincronizar en el caso de que una tarea LJ haya finalizado

inesperadamente.

CF Comprueba la disponibilidad de un archivo. Utilice esta opción

para comprobar las dependencias opens del archivo.

GS Obtiene el estado de un trabajo. Utilice esta opción para comprobar

las dependencias follows del trabajo.

opciones

Especifica las opciones asociadas a la tarea. Para más información, consulte

el apartado “Opciones de tarea”.

serietarea

Serie de como máximo 255 caracteres asociada a la tarea. Consulte el

apartado “Opciones de tarea”.

Opciones de tarea

En la tabla siguiente se listan las opciones de tarea. Una X significa que esta opción

es válida para la tarea.

Tarea Opciones

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

MJ X X X X X X X X X seriemj

CF X X X X seriecf

GS X X X X X X seriegs

-c agenteampliado,host,maestro

Especifica los nombres del planificador del agente ampliado, el host y el

gestor de dominio maestro separados por comas.

-n nombrenodo

Especifica el nombre del nodo del sistema asociado al agente ampliado, si

hay alguno. Se define en el campo Nodo en la definición de estación de

trabajo de agente ampliado.

-p númeropuerto

Especifica el número de puerto TCP asociado al agente extendido, si hay

alguno. Se define en el campo Dirección TCP en la definición de estación

de trabajo de 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 separado por una coma. Los

números de ejecución actual y específica pueden ser distintos si el trabajo

se traspasó de una ejecución anterior.


-ssecuenciatrab

Especifica el nombre de la secuencia de trabajos del trabajo.

-d fechaplan,é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. Se define en el campo Inicio

de sesión de la definición del trabajo.

-o listaestándar

Especifica el nombre completo de la ruta del archivo de lista estándar del

trabajo. Toda la salida del trabajo deben 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 del trabajo.

-q calificador

Especifica el calificador que debe utilizarse en un comando de prueba

emitido por el método que afecta al archivo.

-w tiempoespera

Especifica el intervalo de tiempo, en segundos, que el planificador espera

para obtener una respuesta sobre un trabajo externo antes de enviar una

señal SIGTERM al método de acceso. El valor predeterminado es 300.

-S nombre nuevo

Especifica que el trabajo se vuelve a ejecutar utilizando este nombre en

lugar del nombre de trabajo original. Dentro de un script de trabajo, puede

utilizar el comando jobinfo para devolver el nombre de trabajo y ejecutar

el script de forma diferente para cada repetición. Para obtener más

información, consulte la descripción del comando conman rerun en la

publicación IBM Tivoli Workload Scheduler Reference Guide.

-- serielj

Se utiliza con la tarea LJ. La serie del campo Archivo script o Comando de

la definición del trabajo.

-- seriemj

Se utiliza con la tarea MJ. La información que el método proporciona al

planificador en una respuesta %CJ para una tarea LJ. Generalmente,

identifica el trabajo que se inició. Por ejemplo, un método UNIX puede

proporcionar la identificación de proceso (PID) del trabajo que ha iniciado,

que a continuación el planificador enviará formando parte de una tarea

MJ.

-- seriecf

Se utiliza con la tarea CF. Para una dependencia opens de archivo, la serie

del campo Opens Files de la definición de la secuencia de trabajos.

-- seriegs

Se utiliza con la tarea GS. Especifica el trabajo cuyo estado se comprueba.

El formato es el siguiente:

trabajocontinuación[,idtrabajo]

donde:

Capítulo 8. Consulta del agente ampliado 301

trabajocontinuación

La serie de la lista de definiciones de secuencias de trabajos

Follows Sched/Job.

idtrabajo

Identificador de trabajo opcional que recibe el planificador en una

respuesta %CJ a una tarea GS anterior.

Mensajes de respuesta de métodos

Los métodos devuelven información a IBM Tivoli Workload Scheduler en mensajes

grabados en stdout. Todas las líneas que empiezan con un signo de porcentaje (%)

y finalizan con una nueva línea se interpretan como un mensaje. Los mensajes

tienen el siguiente formato:

%CJ estado [seriemj | idtrabajo]

%JS [tiempocpu]

%RC cr

%UT [mensajeerror]

donde:

CJ Cambia el estado del trabajo.

estado El estado por el cual se cambia el trabajo. Todos los estados de

trabajos del planificador son válidos con excepción de hold y

ready. Para la tarea GS, también son válidos los siguientes estados:

ERROR

Se ha producido un error.

EXTRN

El estado es desconocido.

seriemj Serie de hasta 255 caracteres que el planificador incluirá en

cualquier tarea MJ asociada con el trabajo. Consulte el apartado

301.

idtrabajo

Serie de hasta 64 caracteres que el planificador incluirá en

cualquier tarea GS asociada con el trabajo. Consulte el apartado

301.

JS [tiempcpu]

Indica la conclusión satisfactoria de un trabajo y proporciona el tiempo de

ejecución transcurrido en segundos.

RC cr cr es un número que IBM Tivoli Workload Scheduler interpreta como

código de retorno del trabajo de agente ampliado. El código de retorno

sólo se tiene en cuenta si se ha especificado una condición de código de

retorno en la definición del trabajo de agente ampliado. Si éste no es el

caso, se ignora y se indica la terminación satisfactoria del trabajo de agente

ampliado mediante la presencia del mensaje %JS [horacpu]. Y, de igual

modo, si el método no envía el mensaje %RC, la terminación satisfactoria

del trabajo de agente ampliado se indica mediante la presencia del mensaje

%JS [horacpu].


UT [mensajeerror]

Indica que el método no da soporte a la tarea solicitada. Muestra una serie

de hasta 255 caracteres que el planificador incluirá en su mensaje de error.

Archivo de opciones de métodos

Puede utilizar un archivo de opciones de método para especificar información de

inicio de sesión especial y otras opciones. Antes de ejecutar un método, el

planificador lee el archivo, si existe. Si se modifica el archivo después de iniciar el

planificador, los cambios entrarán en vigor después de detenerlo e iniciarlo.

El archivo puede incluir opciones del planificador y cualquier otra información de

método. Las opciones que el planificador reconoce son las siguientes:

LJuser=nombusuario

CFuser=nombusuario

GSuser=nombusuario

GStimeout=segundos

donde:

LJuser=nombusuario

Especifica el inicio de sesión que se debe utilizar para las tareas LJ y MJ.

El valor predeterminado es el inicio de sesión de la definición del trabajo.

CFuser=nombusuario

Especifica el inicio de sesión que se debe utilizar 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=nombusuario

Especifica el inicio de sesión que se debe utilizar 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 intervalo de tiempo, en segundos, durante el cual el

planificador espera a recibir una respuesta antes de abortar el método de

acceso. El valor predeterminado es 300 segundos.

Nota: Si el host del agente ampliado es un sistema Windows, estos usuarios se

deben definir como objetos de usuario del planificador.

El archivo de opciones debe tener el mismo nombre de ruta que su método de

acceso, con una extensión de archivo .opts. Por ejemplo, el nombre de ruta en

Windows de un archivo de opciones para un método denominado netmth es

TWShome\methods\netmth.opts.

Ejecución del método

Los siguientes temas describen el intercambio entre IBM Tivoli Workload Scheduler

y un método de acceso.


Tarea Iniciar trabajo (LJ)

La tarea LJ indica al método de agente ampliado para iniciar un trabajo en un

sistema o una aplicación externos. Antes de ejecutar el método, IBM Tivoli

Workload Scheduler establece un entorno de ejecución. El parámetro LJuser se lee

del archivo de opciones de método para determinar la cuenta de usuario con la

que debe ejecutarse el método. Si el parámetro no está en el archivo o el archivo de

opciones no existe, se utilizará la cuenta de usuario especificada en el campo Inicio

de sesión de la definición del trabajo. También se establecen las siguientes

variables de entorno:

HOME

El directorio inicial del usuario que ha iniciado la sesión.

LOGNAME

El nombre del usuario que ha iniciado la 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, se pone el trabajo en estado fail.

Cuanto un método se está ejecutando, éste graba los mensajes a su archivo stdout

que indica el estado del trabajo del sistema externo. En la siguiente tabla se

muestra un resumen de los mensajes.

Tarea Respuesta del método Acción de IBM Tivoli Workload Scheduler

LJ y MJ %CJ estado [seriemj] Establece el estado del trabajo en el estado

indicado. Incluye seriemj en todas las tareas

MJ subsiguientes.

%JS [tiempocpu] Establece el estado del trabajo en succ.

Código 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

muestra mensajeerror.

Una secuencia típica está formada por uno o varios mensajes %CJ que indican los

cambios realizados en el estado del trabajo y luego un mensaje %JS antes de que el

método finalice para indicar que el trabajo ha finalizado satisfactoriamente. Si el

trabajo no finaliza satisfactoriamente, el método debe finalizar si grabar el mensaje

%JS. Un método que no da soporte a la tarea LJ, graba un mensaje %UT en el

archivo stdout y finaliza con el código de salida 2.

Tarea Gestionar trabajo (MJ)

La tarea MJ se utiliza para coordinarse con un trabajo iniciado previamente si el

planificador determina que la tarea LJ ha finalizado inesperadamente. El

planificador configura el entorno igual que para la tarea LJ y pasa en la seriemj.

Para obtener más información, consulte el apartado “Tarea Iniciar trabajo (LJ)”.

Si el método localiza el trabajo especificado, responderá con los mismos mensajes

que una tarea LJ. Si el método no puede localizar el trabajo, finalizará con un

código de salida distinto de cero, lo que causará que el planificador coloque el

trabajo en estado abend.


Cómo abortar un trabajo

Mientras se está ejecutando una tarea LJ o MJ, el método debe generar como

condición de excepción una señal SIGTERM (señal 15). La señal se envía cuando

un operador emite un comando Kill a través del gestor de consola del planificador.

Cuando recibe la señal, el método debe intentar detener (kill) el trabajo y después

finalizar sin grabar un mensaje %JS.

Tarea Comprobar archivo (CF)

La tarea CF solicita al método del agente ampliado que compruebe la

disponibilidad de un archivo en un sistema externo. Antes de ejecutar el método,

el planificador establece un entorno de ejecución. El parámetro CFuser se lee del

archivo de opciones de 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, en UNIX se utilizará el usuario root en UNIX y, en Windows,

se utilizará el nombre de usuario de la cuenta en la que se ha instalado el

planificador. Si no se puede ejecutar el método, la dependencia opens del archivo

se marcará como anómala; es decir, el estado del archivo se establece en NO y no

se podrá ejecutar ningún trabajo ni secuencia de trabajos dependientes.

Una vez que está funcionando, el método ejecuta un comando de prueba, o el

equivalente, sobre el archivo que utiliza el calificador que se ha pasado al mismo

en la opción de línea de comandos -q. Si la prueba del archivo es verdadera, el

método finaliza con un código de salida de cero. Si la prueba del archivo es falsa,

el método finaliza con un código de salida distinto de cero. En la siguiente tabla se

muestra un resumen.


CF Código de salida=0 Establecer estado de archivo en YES.

Código salida=no cero Establecer estado de archivo en NO.


de salida=2

Establecer estado de archivo en NO.

Un método que no da soporte a la tarea CF, graba un mensaje %UT en el archivo

stdout y finaliza 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 conclusión

satisfactoria de un trabajo externo. Antes de ejecutar el método, el parámetro

GSuser se lee del archivo de opciones de 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, en UNIX se utilizará el usuario root en UNIX y, en

Windows, se utilizará 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 podrá ejecutar el trabajo o

la secuencia de trabajos que dependan del mismo. Si idtrabajo está disponible de

una tarea GS anterior, éste se pasará al método.

El método comprueba el estado del trabajo especificado y lo devuelve en un

mensaje %CJ grabado en stdout. Después finaliza con un código de salida de cero.

A una velocidad establecida por la opción local bm check status, se volverá a

ejecutar el método con una tarea GS hasta que se devuelva uno de los estados de

trabajo siguientes:

abend El trabajo ha terminado de forma anormal.


succ El trabajo ha finalizado satisfactoriamente.

cancl El trabajo se ha cancelado.

done El trabajo ha finalizado, pero no se sabe 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 No se ha podido llevar a cabo la comprobación del trabajo o no ha podido

determinarse el estado del trabajo.

Tenga en cuenta que GStimeout en el archivo de opciones del método especifica el

intervalo de tiempo que el planificador puede esperar una respuesta antes de

abortar el método. Para obtener más información, consulte el apartado “Archivo de

opciones de métodos” en la página 303.

En la siguiente tabla se muestra un resumen de las respuestas del método.


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

indicado e incluye el idtrabajo en todas las

tareas GS subsiguientes.


de salida=2

El estado del trabajo no se cambia.

Un método que no da soporte a la tarea GS, graba un mensaje %UT en el archivo

stdout y finaliza con el código de salida 2.

El comando cpuinfo

El comando cpuinfo puede utilizarse en un método de acceso para devolver

información desde una definición de estación de trabajo. Para obtener información

detallada sobre el comando, consulte el apartado “cpuinfo” en la página 244.

Resolución de problemas

Los siguientes temas se proporcionan para ayudarle a resolver problemas y a

depurar los problemas relacionados con el agente ampliado y el método de acceso.

Mensajes de error de lista estándar de trabajos

Todos los mensajes de salida de un método de acceso, salvo aquellos que empiezan

con un signo de porcentaje (%), se graban en el archivo de lista estándar del

trabajo (stdlist). Para las tareas GS y CF que no están asociadas a trabajos del

planificador, se graban mensajes en el archivo de lista estándar del planificador. En

estos archivos encontrará información sobre todos los tipos de problemas.

Método no ejecutable

Si no se puede ejecutar un método de acceso, sucederá lo siguiente:

v En las tareas LJ y MJ, el trabajo se pone en estado fail.

v En las tareas CF, la dependencia de archivo no se resuelve y el trabajo

dependiente permanece en estado hold.

v En las tareas GS, la dependencia de trabajo no se resuelve y el trabajo

dependiente permanece en estado hold.


Para obtener más información, revise los archivos de lista estándar (stdlist) del

trabajo y del planificador.

Mensajes del Gestor de consola

Este mensaje de error se visualiza si se emite un comando start, stop, link o

unlink para un agente ampliado:

Error al ejecutar el comando: El comando no está implementado para

agentes ampliados. [2202.58]

Este error no se visualizará si un agente ampliado se selecciona como resultado de

utilizar caracteres comodín.

Mensajes de Composer y Compiler

Los siguientes mensajes de error se generan cuando Composer encuentra sintaxis

no válida en una definición de estación de trabajo:

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 sin un host, aparece el

siguiente mensaje:

"El método necesita una CPU de host"

Mensajes de Jobman

Para los agentes ampliados, los mensajes de error, aviso e informativos se graban

en el archivo stdlist de Jobman.

Cuando se inicia un trabajo satisfactoriamente se genera el siguiente mensaje:

Launched job nombretrabajo for esttrabajo, #Jidtrabajo for user nombusuario.

Cuando no se puede iniciar un trabajo se genera el siguiente mensaje:

Error launching nombretrabajo for esttrabajo: textoerror

Cuando no se puede realizar una tarea de comprobación de archivo se genera el

siguiente mensaje:

Error invoking nombremétodo for esttrabajo: textoerror

Cuando no se puede realizar una tarea de gestión de trabajo se genera el siguiente

mensaje:

Error managing nombretrabajo for esttrabajo using nombremétodo: textoerror

Cuando un método envía un mensaje a Jobman que no se reconoce, se genera el

siguiente mensaje:

Error: message invalid for nombretrabajo, #jnúmerotrabajo for

esttrabajo using nombremétodo.

"primeros 64 caracteres del mensaje"


Capítulo 9. Consulta del Agente de red

Las dependencias inter-red de IBM Tivoli Workload Scheduler permiten que

trabajos y secuencias de trabajos de una red de planificador local utilicen trabajos y

secuencias de trabajos de una red remota como dependencias de continuación. En

este capítulo se describe cómo utilizar las dependencias inter-red. En este capítulo

se suministra información acerca de lo siguiente:

v Visión general

v Configuración de una estación de trabajo de agente de red

v Dependencias inter-red

Visión general

Un agente de red es una definición de estación de trabajo lógica que permite

dependencias de continuación entre una red de planificador local y una red de

planificador remota. Las dependencias de continuación remotas se asignan a los

trabajos y secuencias de trabajos del mismo modo que las dependencias de

continuación locales, salvo que se incluye el nombre del agente de red para

identificar que el trabajo o secuencia de trabajos está en una red de planificador

externa. Este tipo de dependencia se denomina dependencia inter-red.

Si se incluyen secuencias de trabajos con dependencias inter-red en el plan, se crea

una secuencia de trabajos especial llamada EXTERNAL para mostrar el estado de

estas dependencias. Esta secuencia de trabajos EXTERNAL contiene trabajos de

espacio reservado para representar cada dependencia de continuación remota.

La definición de estación de trabajo para un agente de red contiene el nombre del

método de acceso de red, netmth. Un archivo de opciones se utiliza para

especificar el usuario bajo el que se ejecuta el método, y la frecuencia con que se

comprueba la dependencia del trabajo remoto o secuencia de trabajos remota. Este

archivo de opciones debe tener el mismo nombre de ruta que el método de acceso,

y debe denominarse netmth.opts.

El planificador invoca el método de acceso cada vez que necesita comprobar el

estado de un trabajo remoto o una secuencia de trabajos remota. El método de

acceso consulta en la red remota el estado del trabajo o secuencia de trabajos

anteriores. El planificador sigue efectuando la comprobación hasta que el trabajo

remoto o la secuencia de trabajos remota alcanza el estado SUCC, CANCEL o

ERROR.

Puede supervisar el estado de las dependencias inter-red con Job Scheduling

Console visualizando la secuencia de trabajos EXTERNAL.

Configuración de una estación de trabajo de Agente de red

Para poder especificar una dependencia inter-red, antes debe crear una definición

de estación de trabajo de planificador para la red remota. La definición de estación

de trabajo de una red remota se denomina agente de red. Las definiciones de

estación de trabajo de agente de red se definen de un modo estándar como

Agentes ampliados y requieren una estación de trabajo host y un método de

acceso, netmeth.


Utilizando Job Scheduling Console, defina una estación de trabajo de agente de red

en la base de datos del planificador, del modo siguiente:

1. En el panel Lista de acciones de Job Scheduling Console, abra el conmutador

Nueva estación de trabajo.

2. Haga clic en el nombre de motor. Aparecerá la ventana Propiedades - Estación

de trabajo en la base de datos.

3. En el campo Nombre, especifique un nombre para esta estación de trabajo. El

nombre de estación de trabajo puede tener un máximo de 16 caracteres

alfanuméricos. El nombre puede incluir un guión y un subrayado, pero debe

empezar por una letra, como por ejemplo MasterB.

4. En el campo Nodo, especifique el nombre de nodo o la dirección IP de esta

estación de trabajo. Se aceptan nombres de dominio calificado al completos.

Este campo es necesario.

5. En el campo Puerto TCP, entre el número de puerto utilizado por el gestor de

dominio maestro en la red remota. En el ejemplo siguiente, el número de

puerto utilizado por MasterA.

6. En el campo Sistema operativo, seleccione OTRO.

7. En el campo Dominio, especifique el dominio de la estación de trabajo host.

8. En el campo Huso horario, especifique el huso horario de esta estación de

trabajo (opcional).

9. En el campo Descripción, especifique una descripción de la estación de

trabajo. La descripción puede tener una longitud de hasta 40 caracteres y debe


10. En el campo Tipo de estación de trabajo, seleccione Agente ampliado en la

lista desplegable.

11. Deje en blanco el cuadro de selección Ignorar.

12. En el campo Método de acceso, entre netmeth.

13. En el campo Host, especifique el nombre de nodo de la estación de trabajo

host (en el ejemplo, el nombre de host MasterB) o seleccione uno de la lista

que aparece haciendo clic en el botón Estaciones de trabajo.

14. Haga clic en Aceptar. La estación de trabajo de agente de red se guarda en la

base de datos del planificador de MasterB (red local).

En el ejemplo siguiente se muestra cómo definir una estación de trabajo de agente

de red para una red remota, Red A, que permita que la red local, Red B, utilice

trabajos y secuencias de trabajos de la red remota como dependencias de

continuación.


Los pasos siguientes muestran cómo definir una estación de trabajo de agente de

red llamada NetAgent que utilice el método de acceso netmth.

1. Defina la CPU de MasterA en la base de datos de MasterA. El usuario de esta

CPU es tws_masterA.

2. Especifique el número de puerto TCP para MasterA como 12345.

3. Especifique el nodo para MasterA como MasterA.rome.tivoli.com.

4. Defina la CPU de MasterB en la base de datos de Master B. El usuario de esta

CPU es tws_masterB.

5. Especifique el nodo para MasterB como MasterB.rome.tivoli.com.

La definición de la estación de trabajo de agente de red se guarda en la base de

datos de Master B.

Ejemplo de línea de comandos del Agente de red

En el ejemplo siguiente se muestra la definición de la estación de trabajo de línea

de comandos para el agente de red NetAgent de la Figura 7:

CPUNAME NETAGENT

DESCRIPTION "AGENTE DE RED"

OS OTHER

NODE MASTERA.ROME.TIVOLI.COM

TCPADDR 12345

(La CPU de NetAgent escucha en el puerto de MasterA.)

FOR maestro

HOST MASTERB

ACCESS NETMTH

END

Archivo de opciones

Debe crearse un archivo de opciones para especificar el usuario bajo el que se

ejecuta el método de acceso y la frecuencia con que se comprueba la dependencia

Figura 7. Redes locales y remotas

Capítulo 9. Consulta del Agente de red 311

de un trabajo remoto o de una secuencia de trabajos remota. Los cambios

realizados en este archivo no entrarán en vigor hasta que se detenga y reinicie el

planificador.

Este archivo de opciones debe tener el mismo nombre de ruta que el método de

acceso, y debe denominarse netmth.opts.

TWShome/methods/netmth.opts

Sintaxis

GSuser=nombre_inicio_sesión

GStimeout=segundos

donde:

nombre_inicio_sesión

El inicio de sesión utilizado para ejecutar el método. Si el host del agente

de red es un sistema Windows, se debe definir este usuario en el

planificador.

segundos

El intervalo de tiempo, en segundos, durante el cual el planificador espera

a recibir una respuesta antes de abortar el método de acceso. El valor

predeterminado es 300 segundos. Si se llama de nuevo al método de

acceso, éste se iniciará automáticamente.

Archivo de opciones de ejemplo

A continuación se proporciona un archivo de opciones de ejemplo para el método

netmth en MasterB:

GSuser=tws_masterA

GStimeout=600

Dependencias inter-red

Cuando se utiliza Job Scheduling Console, las dependencias inter-red se especifican

en el Editor de secuencias de trabajos. Utilice el botón Agregar dependencia en

Inter-red para agregar un icono de trabajo Inter-red a la secuencia de trabajos (que

representa el predecesor) y después crear la dependencia de continuación a partir

de este icono para cualquier otro trabajo con el botón Agregar vínculo.

Nota: los trabajos remotos y las secuencias de trabajos remotas se definen y

ejecutan en sus redes locales en modalidad estándar. Su uso como dependencias

inter-red no afectan a su comportamiento local.

Cuando se especifican trabajos remotos o secuencias de trabajos remotas como

dependencias de continuación en secuencias de trabajos locales, Conman hace un

seguimiento en una secuencia de trabajos EXTERNAL creada especialmente. Se

generan nombres para las dependencias y se tratan como trabajos en la secuencia

de trabajos EXTERNAL.

Creación de una dependencia inter-red para una secuencia de

trabajos

Para agregar una dependencia inter-red a una secuencia de trabajos, haga lo

siguiente:

1. Abra la Vista de gráfico, haciendo clic con el botón derecho del ratón en una

secuencia de trabajos y seleccionando Abrir en el menú emergente.


2. En la Vista de gráfico, haga clic en el botón Agregar dependencia en Inter-red

de la barra de herramientas. Aparecerá la ventana Dependencia inter-red.

3. Haga clic en el botón Buscar (...) y utilice la ventana Buscar estación de trabajo

para seleccionar el nombre del agente de red.

4. En el campo Dependencia, especifique la dependencia de formato libre, o el

predecesor del trabajo o de la secuencia de trabajos en el formato

esttrabajo#secuenciatrab.trabajo. La longitud máxima de este campo es:

v 120 para caracteres de forma libre

v 16 para la estación de trabajo v

v 16 para la secuencia de trabajos

v 40 para el trabajo5. Haga clic en Aceptar para cerrar la ventana. Si está agregando una nueva

dependencia inter-red, se agregará a la Vista de gráfico un nuevo botón de

dependencia inter-red.

6. Guarde la secuencia de trabajos.

Utilización de la línea de comandos

Las dependencias inter-red pueden incluirse en secuencias de trabajos compuestas

creadas por Composer en la línea de comandos. Por ejemplo, para crear una

dependencia de continuación para un trabajo y una secuencia de trabajos

utilizando la palabra clave follows, lleve a cabo los pasos siguientes:

v Dependencia inter-red de secuencia de trabajos

1. Defina una secuencia de trabajos denominada schedA en la base de datos de

MasterA.

2. Defina una secuencia de trabajos denominada schedB en la base de datos de

MasterB con una dependencia de schedA.

Utilice la línea de comandos de Composer para definir la dependencia inter-red

de la secuencia de trabajos, del modo siguiente:

schedule schedB

on everyday

follows NetAgt::MasterA#schedA

:

end

v Dependencia inter-red de trabajo

1. Defina un trabajo denominado jobA en la base de datos de MasterA.

2. Defina un trabajo denominado jobB en la base de datos de MasterB con una

dependencia de jobA.

Utilice la línea de comandos de Composer para definir la dependencia inter-red

de la secuencia de trabajos, del modo siguiente:

$jobs

jobB

......

follows NetAgt::MasterA#jobA

end

end

Véase también





|||

Dependencias inter-red y Conman

Las dependencias inter-red se muestran y manipulan en el plan en varios días.

v Planificación Adhoc

v la secuencia de trabajos EXTERNAL

Planificación Adhoc y dependencias inter-red

Las dependencias inter-red se pueden utilizar como dependencias de continuación

para trabajos y secuencias de trabajos que se someten al plan. Las dependencias se

especifican de la misma forma que se especifican otras dependencias de

continuación. Para obtener más información, consulte el apartado “Creación de una

dependencia inter-red para una secuencia de trabajos” en la página 312.

Secuencias de trabajo EXTERNAL

Las dependencias inter-red se muestran en una secuencia de trabajos denominada

EXTERNAL. Las dependencias se listan como trabajos independientemente de si se

han definido o no para trabajos o secuencias de trabajos. Hay una secuencia de

trabajos EXTERNAL para cada agente de red del plan.

Los nombres de trabajo exclusivo se generan del siguiente modo:

Ennnmmss

donde:

nnn es un número aleatorio.

mm representa los minutos actuales.

ss representa los segundos actuales.

El nombre real del trabajo o de la secuencia de trabajos se guarda en la sección JCL

del registro de trabajo.

Estados de trabajos externos

El estado de liberación de los trabajos viene determinado por el método de acceso

y se lista en el campo Estado de liberación de la secuencia de trabajo EXTERNAL.

El estado es tan actual como la última vez que se efectuó un sondeo en la red

remota. Es posible que parezca que los trabajos se salten estados que se producen

entre sondeos.

Todos los estados de trabajos y secuencias de trabajos se listan, salvo FENCE.

Además, hay dos estados que son exclusivos a los trabajos EXTERNAL:

ERROR

Se ha producido un error mientras se comprobaba el estado remoto.

EXTRN

Estado desconocido. Se ha producido un error, se ha realizado una acción

de reejecución en la secuencia de trabajos EXTERNAL o el trabajo o

secuencia de trabajos INET no existe.

Llevar a cabo acciones sobre trabajos externos

Puede efectuar tres acciones en trabajos remotos en una planificación EXTERNAL:

cancelar, volver a ejecutar y confirmar.

Nota: Ninguno de estos comandos afectará al trabajo remoto o a la secuencia de

trabajos remota de la red remota. Simplemente manipulan la dependencia

para la red local.


Cancelar

Cancela el trabajo EXTERNAL, liberando la dependencia de los trabajos y

las planificaciones locales. Deja de comprobarse el estado de la

dependencia.

Volver a ejecutar

Indica a Conman que reinicie la comprobación del estado del trabajo

externo EXTERNAL. Después de ejecutar una operación de reejecución, el

estado del trabajo se establecerá inmediatamente en EXTRN.

Volver a ejecutar es útil para trabajos EXTERNAL en estado ERROR. Por

ejemplo, si un trabajo EXTERNAL no puede iniciarse porque el método de

acceso a la red no otorga permiso de ejecución, el trabajo entra en estado

ERROR y su estado deja de comprobarse. Después de corregir los

permisos, el método puede iniciarse pero Conman no iniciará la

comprobación del trabajo EXTERNAL hasta que lleve a cabo una nueva

ejecución.

Confirm SUCC / ABEND

Establece el estado del trabajo EXTERNAL a SUCC o ABEND, liberando la

dependencia de todos los trabajos y todas las planificaciones locales. Deja

de comprobarse el estado de la dependencia.

Llevar a cabo acciones sobre dependencias inter-red para

trabajos y planificaciones

Las dependencias inter-red se listan en la columna Dependencias de las ventanas

SHOWJOBS y SHOWSCHEDULES en el siguiente formato:

net::net_dep

donde:

net El nombre de CPU del agente de red. Los dos

signos de dos puntos (::) son un delimitador

obligatorio. Se permite utilizar caracteres comodín.

net_dep La dependencia inter-red en el siguiente formato:

[cpu#] sched[.job]

Si no se especifica una CPU, el valor

predeterminado es la CPU del planificador a la que

el agente de red está conectado. Lo determinan los

campos Nodo y Dirección TCP de la definición de

CPU del agente de red. Se permite utilizar


Las acciones Liberar, Agregar dependencia y Suprimir dependencia surten el

mismo efecto en las dependencias inter-red que en otras dependencias.

Especificación de línea de comandos de Conman

Los comandos de Conman que pueden especificar dependencias inter-red se listan

a continuación con un ejemplo basado en:

v Una CPU de planificador local denominada local1

v Una planificación definida para local1 denominada sched1

v Un trabajo en local1#sched1 denominado job1

v Un agente de red de planificador denominado netagt

v Una CPU de planificador en la red remota netagt denominada remote1


v Una planificación definida para remote1 denominada rcshed

v Un trabajo en remote1#rsched denominado rjob

adddep job: Agregar un trabajo remoto como una dependencia de continuación a

un trabajo:

adj local1#sched1.job1;follows=netagt::remote1#rsched.rjob

adddep sched: Agregar una planificación remota como una dependencia de

continuación a una planificación:

ads local1#sched1;follows=netagt::remote1#rsched

cancel job: Cancelar todos los trabajos EXTERNAL para un agente de red (los dos

comandos son equivalentes):

cj netagt#EXTERNAL.@

cj netagt::@

confirm: Confirmar que un trabajo EXTERNAL ha finalizado satisfactoriamente:

confirm netagt::remote1#rsched.rjob;succ

deldep job: Suprimir la dependencia de un trabajo remoto de un trabajo:

ddj local1#sched1.job1;follows=netagt::remote1#rsched.rjob

deldep sched: Suprimir una dependencia de trabajo remoto de una planificación:

dds local1#sched1;follows=netagt::remote1#rsched.rjob

release job: Liberar un trabajo de una dependencia de inter-red:

rj local1#sched1.job1;follows=netagt::remote1#rsched.rjob

release sched: Liberar una planificación de una dependencia de inter-red:

rs local1#sched1;follows=netagt::remote1#rsched.rjob

rerun: Ejecutar un trabajo EXTERNAL (los dos comandos son equivalentes):

rr netagt#EXTERNAL.rjob

rr netagt::remote1#rsched.rjob

showjobs;info: Mostrar todas las dependencias remotas para un agente de red

con los nombres originales y los nombres generados por el planificador:

sj netagt#EXTERNAL.@;info

submit: Someter un comando rm en la planificación JOBS con una planificación

remota como dependencia de continuación:

sbd "rm apfile";follows=netagt::remote1#rsched

Véase también





|||

Capítulo 10. Establecimiento de definiciones de seguridad del

usuario

Los comandos y programas de IBM Tivoli Workload Scheduler determinan las

posibilidades de un usuario comparando el nombre del usuario con las

definiciones de usuario del archivo de seguridad. En este capítulo se explica cómo

escribir definiciones de usuario y gestionar el archivo de seguridad.

Centralización de la seguridad

La opción global de seguridad centralizada permite que el administrador de Tivoli

Workload Scheduler elija entre los dos modelos de seguridad siguientes:

Seguridad centralizada

Los archivos de seguridad de todas las estaciones de trabajo de la red de

Tivoli Workload Scheduler sólo se pueden crear y modificar en el gestor de

dominio maestro, y el administrador de Tivoli Workload Scheduler es

responsable de su producción, mantenimiento y distribución.

Nota: Si se trabaja con bases de datos no expandidas de IBM Tivoli

Workload Scheduler no se soporta la seguridad centralizada.

Seguridad local

El archivo de seguridad de cada estación de trabajo lo puede manejar su

administrador o usuario root. El usuario local puede ejecutar el comando

makesec para crear o actualizar el archivo.

Establezca en ON la opción global de seguridad centralizada para que el maestro

de IBM Tivoli Workload Scheduler habilite el mecanismo de seguridad

centralizada. Una vez que la opción global está activa, el programa de utilidad

Jnextday vuelve a cargar información relativa a la seguridad en el archivo

Symphony. Asimismo, el archivo Symphony registra la opción como activada. Una

vez que el gestor de dominio maestro distribuye el archivo Symphony en la red,

cada estación de trabajo tiene un archivo Symphony que contiene la misma

información de seguridad.

El mecanismo de seguridad centralizada se activa cada vez que se establece un

vínculo, así como cuando se ejecuta un comando de IBM Tivoli Workload

Scheduler.

En una red con la seguridad centralizada, dos estaciones de trabajo no podrán

establecer conexión si una de ellas tiene desactivada la seguridad centralizada en

su archivo Symphony o si la información contenida en sus archivos de seguridad

no coincide. No obstante, una estación de trabajo siempre debe aceptar conexiones

de entrada procedentes del gestor de dominio, aunque la información del archivo

de seguridad enviada desde el gestor de dominio no coincida con la información

contenida en el archivo Symphony de la estación de trabajo. Y así se impone para

permitir que el administrador modifique el archivo de seguridad en el maestro sin

tener que redistribuirlo a toda la red antes ed ejecutar Jnextday.

Cada vez que se ejecuta un comando en la estación de trabajo de una red que tiene

la seguridad centralizada, ya sea mediante Conman o desde Job Scheduling

Console, las rutinas de seguridad verifican que la información de seguridad


|

|

|

||||

||

||

|||||

||

||||

||||||||

|||

|||||||||

|||

contenida en el archivo Symphony coincide con la información del archivo de

seguridad local. De no ser así, no se otorga acceso (o se otorga un acceso reducido)

a los comandos y objetos de IBM Tivoli Workload Scheduler, y se registra un

mensaje de violación de la seguridad.

La seguridad centralizada no se aplica a las operaciones de IBM Tivoli Workload

Scheduler para las que no se requiere el archivo Symphony. Los comandos que no

precisan del archivo Symphony para su ejecución utilizan el archivo de seguridad

local. Por ejemplo, el comando parms, utilizado para modificar o mostrar la base

de datos de parámetros local, sigue funcionando según el archivo de seguridad

local, aunque la seguridad centralizada esté activa y el archivo de seguridad local

difiera de las normas de la seguridad centralizada.

Si el archivo de seguridad de una estación de trabajo se suprime y se vuelve a

crear, la información de seguridad contenida en el mismo no coincidirá con la

información del archivo de seguridad del maestro (que también está registrada en

el archivo Symphony). Además, un mecanismo asociado al proceso de creación del

archivo Symphony asegura que se impida la falsificación del archivo.

Trabajo con el archivo de seguridad

Cada estación de trabajo de una red de IBM Tivoli Workload Scheduler (gestores

de dominio, agentes tolerantes a errores y agentes estándares) tiene su propio

archivo de seguridad. Puede mantener un archivo en cada estación de trabajo, o

puede crear un archivo de seguridad en el gestor de dominio maestro y copiarlo

en cada gestor de dominio, agente tolerante a errores y agente estándar. Asegúrese

de que a todos los usuarios de IBM Tivoli Workload Scheduler se les asigne la

autorización necesaria en el archivo de seguridad.

Con el software se proporciona un archivo de plantilla denominado

TWShome/config/Security.conf. Durante la instalación, se instala una copia de la

plantilla como TWShome/config/Security.conf, y se instala una copia operativa

compilada como TWShome/Security.conf.

Creación del archivo de seguridad

Para crear definiciones de usuario, edite el archivo de plantilla

TWShome/Security.conf. No modifique la plantilla original que se encuentra en

TWShome/config/Security.conf. Utilice el comando makesec para compilar e

instalar un nuevo archivo de seguridad operativo. Una vez que esté instalado,

puede realizar más modificaciones mediante el comando dumpsec. Consulte los

apartados “dumpsec” en la página 334 y “makesec” en la página 335.

Modificación del archivo de seguridad

Para modificar el archivo de seguridad, lleve a cabo los pasos siguientes:

1. Detenga los conectores. Consulte el apartado “Detención de conectores para

implementar cambios” en la página 319.

2. Ejecute dumpsec para descargar el archivo de seguridad. Consulte el apartado

“dumpsec” en la página 334.

3. Modifique la sintaxis del archivo de seguridad. Consulte el apartado “Sintaxis

del archivo de seguridad” en la página 319.

4. Ejecute makesec para subir el archivo de seguridad. Consulte el apartado

“makesec” en la página 335.


||||

|||||||

|||||

||

|||||||

||||

|

||||||

|

|

||

||

||

||

5. Detenga e inicie conman o composer para implementar los cambios en el

archivo de seguridad. Consulte el Capítulo 5, “Consulta de Conman”, en la

página 127 o el Capítulo 3, “Consulta de Composer”, en la página 35.

Detención de conectores para implementar cambios

En Windows, debe detener el conector antes de ejecutar el comando makesec. En

UNIX, lo puede detener antes o después de ejecutar makesec.

Utilice el comando wmaeutil para detener el conector.

Ejecución de wmaeutil: Para ejecutar el comando wmaeutil:

1. Establezca el entorno de Tivoli:

v Desde una línea de comandos de UNIX:

– Para ksh:

. /etc/Tivoli/ent_conf.sh

– Para csh:

source /etc/Tivoli/ent_conf.sh

v Desde una línea de comandos de Windows:

%SYSTEMROOT%\system32\drivers\etc\Tivoli\ent_conf.cmd

2. Entre el comando siguiente:

v En UNIX

wmaeutil.sh ALL -stop

v En Windows

wmaeutil.cmd ALL -stop

Sintaxis del archivo de seguridad

El archivo de seguridad contiene una o más definiciones de usuario.

Definiciones de usuario

Una definición de usuario define un conjunto de usuarios, los objetos a los que

pueden acceder y las acciones que pueden realizar.

Sinopsis

[# comentario]

user nombre-def atributos-usuario

begin [* comentario]

tipo-objeto [atributos-objeto] access[=acción[,...]]

[tipo-objeto ... ]

[end]

Parámetros

[# | *] comentario

Todo el texto que sigue a un signo de libre o a un asterisco y, como

mínimo, a un espacio se trata como comentario. Los comentarios no se

copian en el archivo de seguridad operativo instalado por el comando

makesec.

Capítulo 10. Establecimiento de definiciones de seguridad del usuario 319

|||

|||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

||

|

|

||

||

|

|

|

|

|

|

|||||

nombre-def

Especifica el nombre de la definición de usuario. El nombre puede

contener un máximo de 36 caracteres alfanuméricos y debe empezar por

un carácter alfabético.

atributos-usuario

Especifica uno o más atributos que identifican el conjunto de usuarios a los

que se aplica la definición. Especifique los atributos de usuario del modo

siguiente:

atributo-usuario[{+ | ~}atributo-usuario[...]]

Utilice un signo más (+) para añadir un atributo que el usuario o los

usuarios deben tener. Utilice una tilde (~) para añadir un atributo que el

usuario o los usuarios no deben tener. Un atributo-usuario se define del

modo siguiente:

cpu=esttrabajo|$framework|@ [,...]

donde:

esttrabajo

Especifica la estación de trabajo en la que está registrado el

usuario. Se permiten caracteres comodín. Se pueden

utilizar las variables de IBM Tivoli Workload Scheduler

siguientes:

$master

El usuario está registrado en el gestor de dominio

maestro de IBM Tivoli Workload Scheduler.

$remotes

El usuario está registrado en cualquier agente

estándar de IBM Tivoli Workload Scheduler.

$slaves

El usuario está registrado en cualquier agente

tolerante a errores de IBM Tivoli Workload

Scheduler.

$thiscpu

El usuario está registrado en la estación de trabajo

de IBM Tivoli Workload Scheduler en la que se

está ejecutando el programa protegido.

Para los usuarios de Job Scheduling Console, utilice

$framework.

$framework

Especifica la estación de trabajo desde la que el usuario

está ejecutando Job Scheduling Console.

@ Especifica que el usuario está accediendo a IBM Tivoli

Workload Scheduler mediante Job Scheduling Console o

que está registrado en cualquier estación de trabajo de IBM


group=nombregrupo[,...]

Sólo para usuarios de UNIX. No utilice este argumento para

usuarios de Job Scheduling Console. Especifica el grupo de UNIX

del que el usuario es miembro. Se permiten caracteres comodín.

logon=nombusuario|admin-tme|@ [,...]

donde:


||||

||||

|

||||

||

|||||

|||

|||

||||

||||

||

|||

|||||

||||

||

nombusuario

Especifica el nombre con que el usuario está registrado en

una estación de trabajo de IBM Tivoli Workload Scheduler.

Se permiten caracteres comodín. El atributo cpu= se debe

establecer en un nombre de estación de trabajo o en @.

admin-tme

Especifica el nombre del grupo de administradores de

Tivoli del que el usuario es miembro. Si el nombre contiene

espacios, se debe encerrar entre comillas dobles. Se

permiten caracteres comodín. El atributo cpu= se debe

establecer en $framework o en @.

@ Especifica que el usuario está registrado con cualquier

nombre o es miembro de cualquier grupo de

administradores de Tivoli.

tipo-objeto

Especifica el tipo de objeto para el que se otorga permiso de acceso al

usuario. Los tipos de objeto son los siguientes:

calendar Calendarios de usuario.

cpu Estaciones de trabajo y dominios.

file Archivos de base de datos de IBM Tivoli

Workload Scheduler.

job Trabajos planificados.

parameter Parámetros de usuario.

prompt Solicitudes globales.

resource Recursos de planificación.

schedule Secuencias de trabajos.

userobj Objetos de usuario.

Puede incluir varios tipos de objeto en una definición de usuario. Si se

omite un tipo de objeto, se impide el acceso a todos los objetos de ese tipo.

atributos-objeto

La Tabla 11 lista atributos de objeto según el tipo de objeto.

Tabla 11. Atributos de objeto

Atributo Nombre cpu jcl logon

Objeto

calendar sí no no no

cpu no sí no no

file sí no no no

job sí sí sí sí

parameter sí sí no no

prompt sí no no no

resource sí sí no no

schedule sí sí no no

userobj no sí no sí

Especifica uno o más atributos que identifican un conjunto de objetos del

tipo especificado. Si no se especifica ningún atributo, están accesibles todos

los objetos del tipo especificado. Especifique los atributos de objeto del

modo siguiente:

atributo-objeto[{+ | ~}atributo-objeto[...]]


|||||

||||||

||||

||||||||||||||||||||||

||

||

||

|||||

|||||

|||||

|||||

|||||

|||||

|||||

|||||

|||||

|||||

||||||||||

|

Utilice un signo más (+) para añadir un atributo que los objetos deben

tener. Utilice una tilde (~) para añadir un atributo que los objetos no deben

tener. Un atributo-objeto puede ser cualquiera de los siguientes:

name=nombre[,...]

Especifica uno o más nombres para el tipo de objeto. Se permiten

caracteres comodín. Si se indican varios nombres, se deben separar

mediante comas. Si no se especifica este atributo, se puede acceder

a todos los objetos definidos. Los valores siguientes son adecuados

para el tipo de objeto file:

calendars Contiene calendarios.

cpudata Contiene estaciones de trabajo y

dominios.

jobs Contiene trabajos.

mastsked Contiene secuencias de trabajos.

parameters Contiene parámetros.

prodsked Contiene la planificación de

producción.

prompts Contiene solicitudes.

resources Contiene recursos.

security El archivo de seguridad.

Symphony Contiene el plan de producción.

cpu=esttrabajo[,...]

Especifica uno o más nombres de estación de trabajo o de dominio.

Se permiten caracteres comodín. Si se indican varios nombres, se

deben separar mediante comas. Si se omite, cuentan todas las

estaciones de trabajo. Se permiten las variables de IBM Tivoli

Workload Scheduler siguientes: $master, $remotes, $slaves y

$thiscpu. Para obtener más información, consulte el apartado “Las

variables suministradas con el producto” en la página 326.

jcl=″ruta″ | ″comando″

Especifica el comando o el nombre de ruta del archivo ejecutable

de un objeto de trabajo. El comando o la ruta se deben encerrar

entre comillas (″). Se permiten caracteres comodín. Si se omite,

cuentan todos los archivos de trabajo y comandos.

logon=nombusuario[,...]

Especifica los nombres de usuario. Se permiten caracteres comodín.

Si se indican varios nombres, se deben separar mediante comas. Si

se omite, cuentan todos los nombres de usuario. Para el tipo de

objeto job, se permiten las variables siguientes: $jclowner, $owner

y $user. Para obtener más información, consulte el apartado “Las

variables suministradas con el producto” en la página 326.

acción Especifica las acciones que el usuario puede realizar. Si se indican varias

acciones, se deben separar mediante comas. Si no se especifica ninguna, no

se permite ninguna acción. Si se entra access=@, se brinda a los usuarios la

posibilidad de realizar todas las acciones. La Tabla 12 y la Tabla 13 en la

página 323 listan todos los tipos de acción posibles en función del tipo de

objeto.

Tabla 12. Acciones

Acción add adddep altpass altpri build cancel confirm console deldep delete display fence kill

Objeto

calendar sí no no no no no no no no sí sí no no

cpu sí no no no no no no sí no sí sí sí no


|||

||||||||||||||||||||||||||||

||||||||

|||||

|||||||

|||||||

||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

Tabla 12. Acciones (continuación)

Acción add adddep altpass altpri build cancel confirm console deldep delete display fence kill

file no no no no sí no no no no sí sí no no

job sí sí no sí no sí sí no sí sí no no no

parameter sí no no no no no no no no sí sí no no

prompt sí no no no no no no no no sí sí no no

resource sí no no no no no no no no sí sí no no

schedule sí sí no sí no sí no no sí sí sí no no

useobj sí no sí no no no no no no sí sí no no

Tabla 13. Acciones (continuación)

Acción limit link list modify release reply rerun

shut

down start stop submit unlink use

Objeto sí

calendar no no no sí no no no no no no no no sí

cpu sí sí sí sí no no no sí sí sí no sí no

file no no no no no no no no no no no no no

job no no sí sí sí sí sí no no no sí no sí

parameter no no no sí no no no no no no no no no

prompt no no sí sí no no no no no no no no sí

resource no no sí sí no no no no no no no no sí

schedule sí no sí sí sí sí no no no no sí no no

useobj no no no sí no no no no no no no no no

Notas:

1. El tipo de objeto file se utiliza para gestionar la seguridad en la CLI y

sólo es válido para la CLI.

2. Para el tipo de objeto file, la acción clean es equivalente a la acción

build.

3. Para permitir que un usuario conmute la función de gestor de dominio

para una estación de trabajo, el usuario debe tener los dos accesos start

y stop para la estación de trabajo.

add Añadir y guardar nuevos calendarios en la

base de datos.

adddep Añadir dependencias a trabajos del plan de

producción. Esta acción no está disponible

en estaciones de trabajo conectadas a IBM

Tivoli Workload Scheduler for z/OS para

una planificación de extremo a extremo.

altpass Modificar contraseñas de usuario en la

base de datos.

altpri Alterar la prioridad de trabajos en el plan

de producción. Esta acción no está

disponible en estaciones de trabajo

conectadas a IBM Tivoli Workload

Scheduler for z/OS para una planificación

de extremo a extremo.

build Crear archivos de base de datos de IBM

Tivoli Workload Scheduler. Esta acción sólo

está disponible desde la línea de

comandos. La clave clean que aparece en el


||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

||

||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

|

||

||

|||

|||

||||||

|||

|||||||

|||||

archivo de seguridad para este objeto es

equivalente a la clave build.

cancel Cancelar trabajos del plan de producción.

Esta acción no está disponible en estaciones

de trabajo conectadas a IBM Tivoli

Workload Scheduler for z/OS para una

planificación de extremo a extremo.

confirm Confirmar la terminación de trabajos del

plan de producción. Esta acción no está





console Ver y alterar la consola de IBM Tivoli

Workload Scheduler.

deldep Suprimir dependencias de trabajos del plan

de producción. Esta acción no está





delete Suprimir calendarios de la base de datos.

display Mostrar calendarios de la base de datos.

fence Alterar las limitaciones de trabajos del plan

de producción.

kill Terminar trabajos del plan de producción.

limit Alterar los límites de trabajos de estación

de trabajo del plan de producción.

link Abrir vínculos de estación de trabajo.

list Permite al usuario mostrar estaciones de

trabajo y dominios del plan cuando ejecute

un comando show o una consulta de Job

Scheduling Console.

modify Modificar calendarios de la base de datos.

release Liberar trabajos de sus dependencias en el

plan de producción. Esta acción no está





reply Responder a solicitudes de trabajo del plan

de producción.

rerun Volver a ejecutar trabajos del plan de

producción. Esta acción no está disponible

en estaciones de trabajo conectadas a IBM

Tivoli Workload Scheduler for z/OS para

una planificación de extremo a extremo.

shutdown Concluir el proceso de IBM Tivoli


||

||||||

|||||||

|||

|||||||

||

||

|||

||

|||

||

|||||

||

|||||||

|||

||||||

||

Workload Scheduler. Esta acción sólo está

disponible en la línea de comandos.

start Iniciar el proceso de IBM Tivoli Workload

Scheduler.

stop Detener el proceso de IBM Tivoli Workload

Scheduler.

submit Someter trabajos en el plan de producción.

Esta acción no está disponible en estaciones

de trabajo conectadas a IBM Tivoli

Workload Scheduler for z/OS para una

planificación de extremo a extremo.

unlink Cerrar vínculos de estación de trabajo.

use Utilizar calendarios para planificar

secuencias de trabajos.

Orden de calificación de usuarios

Al calificar usuarios para acceder a objetos de IBM Tivoli Workload Scheduler, los

atributos reales de un usuario se comparan con las definiciones de usuario en el

orden en que se entran las definiciones en el archivo de seguridad. La primera

definición que coincide con el usuario determina las posibilidades del usuario. Por

este motivo, es importante ordenar las definiciones de usuario de las más concretas

a las menos concretas. Por ejemplo:

#Incorrecto:

#Primera definición de usuario en el archivo de seguridad

USER First

CPU=@+LOGON=TWSUser

Begin

...

End

#Segunda definición de usuario en el archivo de seguridad

USER Second

CPU=@+LOGON=TWSDomain/TWSUser

Begin

...

End

#Correcto:

#Primera definición de usuario en el archivo de seguridad

USER First

CPU=@+LOGON=TWSDomain/TWSUser

Begin

...

End

#Segunda definición de usuario en el archivo de seguridad

USER Second

CPU=@+LOGON=TWSUser

Begin

...

End

Para obtener más información, consulte el apartado “Archivo de seguridad de

ejemplo” en la página 329.

Orden de calificación de objetos

En una definición de usuario, se pueden utilizar varias sentencias para un solo tipo

de objeto, a fin de asignar distintas posibilidades de acceso a conjuntos de objetos


||

|||

|||

||||||

||

|||

|||||||

|

||||||

||||||

|

||||||

||||||

||

|||

diferentes. Puesto que se utiliza la primera sentencia coincidente, el orden de las

sentencias de objetos es importante. Se deben ordenar de más concreta a menos

concreta. Por ejemplo:

#Incorrecto:

job name=@ access=display

job name=ar@ access=@

#Correcto:

job name=ar@ access=@

job name=@ access=display

Para obtener más información, consulte el apartado “Archivo de seguridad de

ejemplo” en la página 329.

Las variables suministradas con el producto

Las variables suministradas con el producto que se pueden utilizar en atributos de

objetos son las siguientes:

$jclgroup

Nombre de grupo del archivo ejecutable de un trabajo.

$jclowner

Propietario del archivo ejecutable de un trabajo.

$master

Gestor de dominio maestro de IBM Tivoli Workload Scheduler.

$owner

Creador de una secuencia de trabajos y de los trabajos de la misma.

$remotes

Todas las estaciones de trabajo de agente estándar.

$slaves

Todas las estaciones de trabajo de agente tolerante a errores.

$thiscpu

Estación de trabajo en la que el usuario está ejecutando el programa o

comando de IBM Tivoli Workload Scheduler.

$user Usuario que está ejecutando el programa o comando de IBM Tivoli

Workload Scheduler.

Las variables $jclgroup y $jclowner sólo se pueden verificar si el usuario está

ejecutando un programa de IBM Tivoli Workload Scheduler en la estación de

trabajo en la que reside el archivo ejecutable del trabajo. Si se está ejecutando en

otra estación de trabajo, se deniega el acceso al usuario.

Caracteres comodín

Si así se indica en las descripciones de la sintaxis, se permiten los caracteres

comodín siguientes:



@ Sustituye cero o más caracteres alfanuméricos.

El superusuario en UNIX

Si no existe un archivo de seguridad, ningún usuario aparte del usuario root puede

acceder a los objetos de IBM Tivoli Workload Scheduler, y el usuario root tiene un

acceso no restringido a todos los objetos y puede ejecutar todos los comandos y

programas de IBM Tivoli Workload Scheduler. Para controlar al usuario root, cree


|||

|||

|||

||

|||

||

||

||

||

||

||

|||

|||

||||

|||

||

||

||

|||||

un archivo de seguridad con una definición de usuario para el usuario root. En el

archivo de seguridad para una red, puede hacer distinción entre los usuarios root

locales y el usuario root del gestor de dominio maestro. Por ejemplo, puede

restringir que los usuarios locales realicen operaciones que afecten únicamente a

sus estaciones de trabajo de inicio de sesión y permitir que el usuario root maestro

realice operaciones que afecten a cualquier estación de trabajo de la red. Para

obtener más información, consulte el apartado “Archivo de seguridad de ejemplo”.

Posibilidades de acceso

La tabla siguiente lista las palabras clave de acceso disponibles para cada tipo de

objeto, así como las posibilidades otorgadas a los usuarios en la línea de comandos

de Tivoli Workload Scheduler.

Tipo de objeto Palabra clave de acceso Posibilidad de usuario de la CLI

calendar add n/d

delete n/d

display composer display, create

modify n/d (véase modificación de archivo)

use composer - utilizar calendario en

planificaciones

cpu (Incluye

dominios)

add composer add, new

console conman console

delete composer delete


list conman showcpus

fence conman fence

limit conman limit

link conman link

modify composer modify, replace

shutdown conman shutdown

start conman start

stop conman stop

unlink conman unlink

file build composer build

delete n/d

display Seguridad de acceso con dumpsec

modify Seguridad de acceso con makesec y

composer modify calendars, parameters,

prompts y resources


|||||||

||||

||||

|||

||

||

||

|||

||||

||

||

||

||

||

||

||

||

||

||

||

||

|||

||

||

||||


job add composer add, new

adddep conman adddep

altpri conman altpri

cancel conman cancel

confirm conman confirm

deldep conman deldep


display conman display composer display

list conman showjobs

kill conman kill


release conman release

reply conman reply

rerun conman rerun

submit conman submit (docommand, file, job)

use composer - utilizar trabajo en

planificaciones

parameter add parms para añadir parámetros

delete n/d

display composer display, create y parms para

mostrar parámetros

modify n/d (véase también modificación de

archivo)

prompt add n/d

delete n/d

display composer display, create conman recall

list conman showprompts


reply conman reply

use composer - utilizar solicitud en secuencia

de trabajos, y conman - añadir

dependencias

resource add n/d

delete n/d


list conman showresources


resource conman resource

use composer - utilizar recurso en secuencia

de trabajos, y conman - añadir

dependencias


|||

|||

||

||

||

||

||

||

||

||

||

||

||

||

||

||

|||

|||

||

|||

|||

|||

||

||

||

||

||

||||

|||

||

||

||

||

||

||||


schedule add composer add, new

adddep conman adddep

altpri conman altpri

cancel conman cancel

deldep conman deldep


display composer display, create conman display

list conman showschedules

limit conman limit


release conman release

reply conman reply

submit conman submit sched

userjob add composer add, new


display composer display (no se muestra la

contraseña)

modify composer modify

altpass conman altpass

Archivo de seguridad de ejemplo

A continuación se muestra un archivo de seguridad de ejemplo. A continuación del

listado aparece una descripción del archivo.

###########################################################

# Archivo de seguridad de ejemplo

###########################################################

# (1) SE APLICA A USUARIOS MAESTRO O ROOT REGISTRADOS EN

# EL GESTOR DE DOMINIO MAESTRO O FRAMEWORK.

user mastersm cpu=$master,$framework + logon=maestro,root,Root_london-region

begin

# OBJETO ATRIBUTOS POSIBILIDADES ACCESO

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

job access=@

schedule access=@

resource access=@

prompt access=@

file access=@

calendar access=@

cpu access=@

parameter name=@ ~ name=r@ access=@

userobj cpu=@ + logon=@ access=@

end

###########################################################



|||

|||

||

||

||

||

||

||

||

||

||

||

||

||

|||

||

|||

||

|||

||

||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|||

# CUALQUIER ESTACION DE TRABAJO DISTINTA DEL GESTOR DE

# DOMINIO MAESTRO.

user sm logon=maestro,root

begin


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

job cpu=$thiscpu access=@

schedule cpu=$thiscpu access=@

resource cpu=$thiscpu access=@

prompt access=@

file access=@

calendar access=@

cpu cpu=$thiscpu access=@

parameter cpu=$thiscpu

~ name=r@ access=@

end

###########################################################

# (3) SE APLICA A USUARIOS REGISTRADOS EN EL GRUPO SYS

# EN EL GESTOR DE DOMINIO MAESTRO O FRAMEWORK.

user masterop cpu=$master,$fw + group=sys

begin


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

job cpu=@

+ logon=TWSDomain\TWSUser access=@

job cpu=@

+ logon=root access=adddep,altpri,cancel,

confirm,deldep,release,

reply,rerun,submit,use

job cpu=@

+ logon=$user,$jclowner

~ logon=root access=add,adddep,altpri,

cancel,confirm,

deldep,release,reply,

rerun,submit,use


schedule cpu=@ access=adddep,altpri,cancel,

deldep,limit,release,

submit

resource access=add,display,

resource,use

prompt access=add,display,reply,use

file access=build

calendar access=display,use

cpu cpu=@ access=@


end

###########################################################

# (4) SE APLICA A USUARIOS REGISTRADOS EN EL GRUPO SYS

# EN CUALQUIER ESTACION DE TRABAJO DISTINTA DEL

# GESTOR DE DOMINIO MAESTRO.

user op group=sys

begin


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

job cpu=$thiscpu

+ logon=$user access=@

job cpu=$thiscpu

+ logon=root access=adddep,altpri,cancel,



job cpu=$thiscpu

~ logon=root access=adddep,altpri,cancel,




resource access=add,display,resource,use


|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

prompt access=add,display,reply,use

file access=build

calendar access=use

cpu cpu=$thiscpu access=console,fence,limit,

link,start,stop,unlink


end

###########################################################

# (5) SE APLICA A USUARIOS REGISTRADOS EN EL GRUPO MIS

# EN CUALQUIER ESTACIÓN DE TRABAJO O FRAMEWORK.

user misusers group=mis

begin


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

job cpu=$thiscpu


job cpu=$thiscpu

+ logon=$jclowner

~ logon=root access=submit,use

schedule cpu=$thiscpu access=add,submit,

modify,display

parameter name=r@ access=@

parameter name=@ access=display

end

###########################################################

# (6) SE APLICA A TODOS LOS OTROS USUARIOS REGISTRADOS

# EN CUALQUIER ESTACION DE TRABAJO.

user default logon=@

begin


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

job cpu=$thiscpu


job cpu=$thiscpu

+ logon=$jclowner

~ logon=root access=submit,use

schedule cpu=$thiscpu access=add,submit,

modify,display

parameter name=u@ access=@

parameter name=@ ~ name=r@ access=display

end

###########################################################

Observe que el orden de las definiciones va de más a menos concreta. Debido a

este orden, primero se comparan los usuarios maestro y root, seguidos de los

usuarios del grupo sys y luego los del grupo mis. Todos los otros usuarios se

comparan con la última definición, que es la menos concreta.

# (1) SE APLICA A USUARIOS MAESTRO O ROOT REGISTRADOS EN EL

GESTOR DE DOMINIO MAESTRO O FRAMEWORK. user mastersm

cpu=$master,$fw + logon=maestro,root,Root_london-region

Esta definición de usuario se aplica al acceso de la GUI y la CLI para usuarios

maestro y root registrados en un gestor de dominio maestro. También otorga

acceso de GUI a los usuarios listados en el grupo de administradores

Root_london-region de Tivoli. Se les otorga un acceso no restringido a todos los

objetos, a excepción de los parámetros cuyos nombres empiezan por r. El acceso a

los parámetros r sólo se otorga a los usuarios del grupo mis.


||||||||||||||||||||||||||||||||||||||||||||

||||

|||

||||||


CUALQUIER ESTACION DE TRABAJO DISTINTA DEL GESTOR DE

DOMINIO MAESTRO. user sm logon=maestro,root

Esta definición de usuario se aplica a los usuarios maestro y root a los que no se

aplica la definición (1), que son aquéllos que están registrados en cualquier

estación de trabajo distinta del gestor de dominio maestro o un sistema

Framework. Se les otorga un acceso no restringido a todos los objetos de su propia

estación de trabajo de inicio de sesión. Observe que las solicitudes, los archivos y

los calendarios son de naturaleza global y no están asociados a ninguna estación

de trabajo.

# (3) SE APLICA A USUARIOS REGISTRADOS EN EL GRUPO SYS DEL

GESTOR DE DOMINIO MAESTRO O FRAMEWORK. user masterop

cpu=$master,$fw + group=sys

Esta definición de usuario se aplica a los usuarios registrados en el grupo sys del

gestor de dominio maestro o un sistema Framework. Se les asigna un conjunto

exclusivo de posibilidades de acceso. Se utilizan varias sentencias de objeto que

asignar a estos usuarios tipos de acceso específicos para los distintos conjuntos de

objeto. Por ejemplo, existen tres sentencias job:

v La primera sentencia job permite un acceso no restringido a los trabajos que se

ejecutan en cualquier estación de trabajo (@) bajo el nombre del usuario ($user).

v La segunda sentencia job permite tipos de acceso específicos a los trabajos que

se ejecutan en cualquier estación de trabajo y se ejecutan como root.

v La segunda sentencia job permite tipos de acceso específicos a los trabajos que

se ejecutan en cualquier estación de trabajo. Los trabajos se tienen que ejecutar

bajo el nombre del usuario ($user) o bajo el nombre del propietario del archivo

de trabajo ($jclowner). Se excluyen los trabajos que se ejecutan como root.

# (4) SE APLICA A USUARIOS REGISTRADOS EN EL GRUPO SYS EN

CUALQUIER ESTACIÓN DE TRABAJO DISTINTA DEL GESTOR DE

DOMINIO MAESTRO. user op group=sys

Esta definición de usuario se aplica a los usuarios del grupo sys a los que no se

aplica la definición (3), que son aquéllos que están registrados en cualquier

estación de trabajo distinta del gestor de dominio maestro o un sistema

Framework. Se les asigna un conjunto de posibilidades de acceso parecidas a las de

la definición (3). La excepción es que el acceso está restringido a los objetos de la

estación de trabajo de inicio de sesión del usuario ($thiscpu).

# (5) SE APLICA A USUARIOS REGISTRADOS EN EL GRUPO MIS EN

CUALQUIER ESTACIÓN DE TRABAJO O FRAMEWORK. user misusers

group=mis

Esta definición de usuario se aplica a los usuarios registrados en el grupo mis en

cualquier estación de trabajo o un sistema Framework. Se les asigna un conjunto

limitado de posibilidades de acceso. Se omiten recursos, solicitudes, archivos,

calendarios y estaciones de trabajo, lo cual impide acceder a estos objetos. A estos

usuarios se les asigna un acceso no restringido a los parámetros cuyos nombres

empiezan por r, pero sólo pueden mostrar otros parámetros.

# (6) SE APLICA A TODOS LOS OTROS USUARIOS REGISTRADOS EN

CUALQUIER ESTACION DE TRABAJO.


|||

|||||||

|||

|||||

||

||

||||

|||

||||||

|||

||||||

||

user default logon=@

Esta definición de usuario asigna un conjunto de posibilidades predeterminadas a

los usuarios distintos de los abarcados por las definiciones precedentes (1 a 5). A

estos usuarios se les asigna un acceso no restringido a los parámetros cuyos

nombres empiezan por u, pero sólo pueden mostrar otros parámetros. No se les

permite ningún acceso a los parámetros cuyos nombres empiezan por r.


|

|||||

dumpsec

Descompila el archivo de seguridad y envía la salida a stdout.

El usuario debe tener acceso display al archivo de seguridad.

Sinopsis

dumpsec -v | -u

dumpsec archivo-seguridad

Descripción

Si no se especifica ningún argumento, se vuelca el archivo de seguridad operativo

(TWShome/Security.conf). Para crear una copia editable de un archivo de

seguridad, redirija la salida del comando a otro archivo, tal como se muestra en los

ejemplos siguientes.

Argumentos

-v Muestra únicamente la información de versión del comando.

-u Muestra únicamente la información de uso del comando.

archivo-seguridad

Especifica el nombre del archivo de seguridad que se debe volcar.

Ejemplos

El comando siguiente muestra la versión del comando.

dumpsec -v

El comando siguiente vuelca el archivo de seguridad operativo en stdout:

dumpsec

El comando siguiente vuelca el archivo de seguridad operativo en un archivo

denominado mysec:

dumpsec > mysec

El comando siguiente vuelca un archivo de seguridad denominado sectemp en

stdout:

dumpsec sectemp


||

|

|

|

|

|

|

||||

|

||

||

||

|

|

|

|

|

||

|

||

|

|

makesec

Compila las definiciones de usuario e instala el archivo de seguridad. Los cambios

realizados en el archivo de seguridad se reconocerán cuando uno de los programas

siguientes se detenga y se reinicie:

Conman

Simplemente salga y vuélvalo a ejecutar.

Composer

Simplemente salga y vuélvalo a ejecutar.

Conectores de IBM Tivoli Workload Scheduler

Detenga los conectores ejecutando el comando wmaeutil. Los conectores se

reiniciarán automáticamente cuando se produzca la primera renovación de

consulta en Job Scheduling Console.

Para utilizar el comando makesec se debe tener el tipo de acceso modify para el

archivo de seguridad.

Sinopsis

makesec -v | -u

makesec [-verify] en-archivo

Descripción

El comando makesec compila el archivo especificado y lo instala como archivo de

seguridad operativo (../TWShome/Security). Si se especifica el argumento -verify, se

comprueba que la sintaxis del archivo sea correcta pero no se compila ni instala.

Argumentos

-v Muestra únicamente la información de versión del comando.

-u Muestra únicamente la información de uso del comando.

-verify

Comprueba la sintaxis de las definiciones de usuario únicamente en

en-archivo. No se instala el archivo como archivo de seguridad. (La

comprobación de la sintaxis se realiza automáticamente cuando se instala

el archivo de seguridad.)

en-archivo

Especifica el nombre de un archivo o conjunto de archivos que contiene

definiciones de usuario: Se permite un patrón de expansión del nombre de

archivo.

Ejemplos

El comando siguiente muestra la versión del comando.

makesec -v

El comando siguiente crea una copia editable del archivo de seguridad operativo

en un archivo denominado tempsec, modifica las definiciones de usuario mediante

un editor de texto, a continuación, compila tempsec y sustituye el archivo de

seguridad operativo.

dumpsec > tempsec

edit tempsec


||

|||

||

||

||||

||

|

|

|

|

|||

|

||

||

|||||

||||

|

|

|

||||

||

Aquí se realizan las modificaciones necesarias en el archivo tempsec. Cuando haya

terminado de modificar el archivo tempsec, ejecute el comando makesec para

cargar el archivo de seguridad en IBM Tivoli Workload Scheduler:

makesec

tempsec

El comando siguiente compila las definiciones de usuario del conjunto de archivos

userdef* y sustituye el archivo de seguridad operativo:

makesec userdef*


|||

||

||

|

|

Apéndice A. Información de soporte

En este apartado se describen las opciones siguientes para obtener soporte para los

productos de IBM:

v “Búsqueda en bases de información”

v “Obtención de arreglos” en la página 338

v “Cómo ponerse en contacto con el Servicio de soporte de software de IBM” en la

página 338

Búsqueda en bases de información

Si tiene un problema con el software de IBM, deseará resolverlo con rapidez.

Empiece por buscar en las bases de información disponibles para determinar si el

problema ya está documentado.

Búsqueda en el centro de información de la red o del sistema

local

IBM proporciona una amplia documentación de los productos que se puede

instalar en el sistema local o en un servidor de intranet. La documentación se

suministra en el CD de publicaciones disponible con el producto, se puede

descargar de IBM tal como se describe en el apartado “Cómo acceder a las

publicaciones en línea” en la página xvi o se puede solicitar, en copia impresa, tal

como se describe en el apartado “Cómo solicitar publicaciones” en la página xvii.

Abra las versiones pdf de los documentos y utilice las funciones de búsqueda

incorporadas de Adobe Reader para buscar la información que necesita.

Búsqueda en el centro de información del sitio Web de

soporte de IBM

El sitio Web de soporte de software de IBM tiene muchos documentos disponibles

en línea, uno o más de los cuales le pueden proporcionar la información que

necesita:

1. Vaya al sitio Web del Servicio de soporte de software de IBM

(http://www.ibm.com/software/support).

2. En Products A - Z, seleccione el nombre del producto: seleccione ″I″ por IBM y

luego desplácese hacia abajo hasta las entradas de productos que empiezan por

″IBM Tivoli Workload Scheduler″. De este modo se abrirán los sitios de soporte

específicos del producto.

3. En Self help y Learn, realice su selección en la lista de distintos tipos de

documentación de soporte de productos:

v Manuales

v Manuales técnicos

v Documentos técnicos

v Archivos Readme y otras documentaciones

Para acceder a algunos documentos es necesario registrarse (cosa que se indica

mediante un icono de llave junto al título del documento). Para registrarse,


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

seleccione el documento que desea examinar y, cuando se le solicite que firme, siga

los vínculos para registrarse. También se dispone de una ″pregunta más frecuente″

(FAQ) sobre las ventajas del registro.

Búsqueda en Internet

Si no puede encontrar una respuesta a su pregunta en el centro de información,

busque en Internet para encontrar otras informaciones que le puedan ser de ayuda

para resolver su problema.

Obtención de arreglos

Es posible que haya disponible un arreglo del producto para resolver su problema.

Puede determinar los arreglos que están disponibles para su producto de software

de IBM comprobándolo en el sitio Web de soporte del producto:

1. Vaya al sitio Web del Servicio de soporte de software de IBM

(http://www.ibm.com/software/support).

2. En Products A - Z, seleccione el nombre del producto: seleccione ″I″ por IBM y

luego desplácese hacia abajo hasta las entradas de productos que empiezan por

″IBM Tivoli Workload Scheduler″. De este modo se abrirán los sitios de soporte

específicos del producto.

3. En Self help, siga el vínculo a Search all Downloads, donde encontrará una

lista de arreglos, FixPacks y otras actualizaciones de servicio para el producto.

4. Haga clic en el nombre de un arreglo para leer la descripción del mismo y,

opcionalmente, descargarlo.

Para recibir, por correo electrónico, notificaciones semanales sobre los arreglos y

otras novedades acerca de los productos de IBM, lleve a cabo los pasos siguientes:

1. En la página de soporte de cualquier producto de IBM, haga clic en My

support en el panel de la parte izquierda de la página.

2. Si ya se ha registrado, pase al paso siguiente. De no ser así, haga clic en

Register, en el ángulo superior derecho de la página de soporte, para establecer

el ID de usuario y la contraseña.

3. Firme en My support.

4. En la página My support, seleccione la pestaña Edit profile y haga clic en

Subscribe to email. Seleccione una familia de productos y seleccione los

cuadros apropiados para el tipo de información que desea.

5. Haga clic en Update.

6. Para recibir notificaciones de correo electrónico para otros grupos de productos,

repita los Pasos 4 y 5.

Para obtener más información sobre los tipos de arreglos, consulte el Manual de

soporte de software (http://techsupport.services.ibm.com/guides/handbook.html).

Cómo ponerse en contacto con el Servicio de soporte de software de

IBM

El Servicio de soporte de software de IBM proporciona asistencia para los defectos

de los productos.

Antes de ponerse en contacto con el Servicio de soporte de software de IBM, la

compañía debe tener un contrato de mantenimiento de software de IBM activo, y


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

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

el usuario debe estar autorizado para someter problemas a IBM. El tipo de contrato

de mantenimiento de software que necesite dependerá del tipo de producto que

tenga:

v Para productos de software distribuidos por IBM (incluyendo, pero sin limitarse

a, productos Tivoli, Lotus y Rational, así como productos DB2 y WebSphere que

se ejecuten en sistemas operativos Windows o UNIX), inscríbase en Passport

Advantage de una de las maneras siguientes:

– En línea: Vaya a la página Web de Passport Advantage

(http://www.lotus.com/services/passport.nsf/WebDocs/

Passport_Advantage_Home) y haga clic en How to Enroll

– Por teléfono: Para conocer los números de teléfono a los que debe llamar en

su país, vaya al sitio Web del Servicio de soporte de software de IBM

(http://techsupport.services.ibm.com/guides/contacts.html) y haga clic en el

nombre de su región geográfica.v Para productos de software eServer de IBM (incluyendo, pero sin limitarse a,

productos DB2 y WebSphere que se ejecuten en entornos zSeries, pSeries e

iSeries), puede adquirir un contrato de mantenimiento de software trabajando

directamente con un representante de ventas de IBM o un IBM Business Partner.

Para obtener más información sobre el soporte para productos de software

eServer, vaya a la página Web de IBM Technical Support Advantage

(http://www.ibm.com/servers/eserver/techsupport.html).

Si no está seguro del tipo de contrato de mantenimiento de software que necesita,

llame por teléfono al número 1-800-IBMSERV (1-800-426-7378), en Estados Unidos,

o desde otros países vaya a la página de contactos del Manual del Servicio de

soporte de software de IBM en la Web

(http://techsupport.services.ibm.com/guides/contacts.html) y haga clic en el

nombre de la región geográfica correspondiente para averiguar los números de

teléfono del personal de soporte para su ubicación.

Para ponerse en contacto con el Servicio de soporte de software de IBM, lleve a

cabo los pasos siguientes:

1. Determine el impacto comercial del problema.

2. Describa el problema y recopile información de antecedentes.

3. Someta el problema al Servicio de soporte de software de IBM.

Determinación del impacto comercial del problema

Cuando informe de un problema a IBM, se le pedirá que indique un nivel de

gravedad. Por consiguiente, es necesario que comprenda y valores el impacto

comercial del problema sobre el que está informando. Utilice los criterios

siguientes:

Gravedad 1 Impacto comercial crítico: No se puede utilizar el programa, lo

cual tiene como consecuencia un impacto crítico sobre las

operaciones. Esta condición requiere una solución inmediata.

Gravedad 2 Impacto comercial significativo: Se puede utilizar el programa

pero se encuentra gravemente limitado.

Gravedad 3 Cierto impacto comercial: Se puede utilizar el programa habiendo

funciones menos significativas (no críticas para las operaciones)

que no están disponibles.

Gravedad 4 Impacto comercial mínimo: El problema ocasiona un pequeño

impacto sobre las operaciones, o se ha implementado una forma

razonable de salvar el problema.

Apéndice A. Información de soporte 339

http://www.lotus.com/services/passport.nsf/WebDocs/Passport_Advantage_Home

http://www.lotus.com/services/passport.nsf/WebDocs/Passport_Advantage_Home

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

http://www.ibm.com/servers/eserver/techsupport.html


Descripción del problema y recopilación de información de

antecedentes

Cuando exponga un problema a IBM, sea lo más concreto posible. Incluya toda la

información de antecedentes relevante para que los especialistas del Servicio de

soporte de software de IBM le puedan ayudar a resolver el problema con eficacia.

Para ahorrar tiempo, conozca de antemano las respuestas a las preguntas

siguientes:

v ¿Qué versiones de software se estaban ejecutando cuando se produjo el

problema?

v ¿Dispone de registros, seguimientos y mensajes relacionados con los síntomas

del problema? Es probable que el Servicio de soporte de software de IBM le

solicite esta información.

v ¿Se puede recrear el problema? Si es así, ¿qué pasos conducirían al error?

v ¿Se ha efectuado algún cambio en el sistema? (Por ejemplo, hardware, sistema

operativo, software de gestión de redes, etc.)

v ¿Actualmente está utilizando una solución provisional para este problema? Si es

así, prepárese para explicarla cuando informe sobre el problema.

Sometimiento del problema al Servicio de soporte de software

de IBM

Puede someter el problema de una de las dos maneras siguientes:

v En línea: Vaya a la página ″Submit and track problems″ del sitio del Servicio de

soporte de software de IBM

(http://www.ibm.com/software/support/probsub.html). Entre la información

en la herramienta de sometimiento de problemas apropiada.

v Por teléfono: Para conocer los números de teléfono a los que debe llamar en su

país, vaya a la página de contactos del Manual de soporte de software de IBM

en la Web (http://techsupport.services.ibm.com/guides/contacts.html) y haga

clic en el nombre de su región geográfica.

Si el problema que se somete corresponde a un defecto de software o a que falta

documentación o ésta es inexacta, el Servicio de soporte de software de IBM crea

un Informe autorizado de análisis de programa (APAR). El APAR describe el

problema en detalle. Si es posible, el Servicio de soporte de software de IBM

brinda una solución provisional que podrá implementar hasta que se resuelva el

APAR y se le entregue un arreglo. IBM publica diariamente los APAR resueltos en

las páginas Web de soporte de productos de IBM, de forma que otros usuarios que

experimenten el mismo problema se puedan beneficiar de las mismas resoluciones.

Para obtener más información sobre la resolución de problemas, consulte los

apartados Búsqueda en bases de información y Obtención de arreglos.


http://www.ibm.com/software/support/probsub.html


Apéndice B. Gestión de husos horarios

IBM Tivoli Workload Scheduler soporta distintos husos horarios. El hecho de

permitir husos horarios brinda la posibilidad de gestionar la carga de trabajo a

nivel global. Asimismo, la implementación de husos horarios facilita la

planificación en varios husos horarios y con trabajos que sea necesario ejecutar en

la ″zona muerta″. La zona muerta es la diferencia entre la hora de inicio del día de

IBM Tivoli Workload Scheduler en el gestor de dominio maestro y la hora en el

agente tolerante a errores de otro huso horario. Por ejemplo, si un maestro oriental

cuya hora de inicio del día de IBM Tivoli Workload Scheduler sea las 6 a.m.

inicializa un agente occidental con una diferencia de huso horario de 3 horas, la

zona muerta para este agente tolerante a errores está entre las 3 a.m. y las 6 a.m.

Anteriormente, se requería un manejo especial para ejecutar trabajos en este

período de tiempo. Ahora, habilitando la función de huso horario y especificando

un huso horario con una hora de inicio en un trabajo o una secuencia de trabajos,

IBM Tivoli Workload Scheduler los ejecuta en el momento esperado.

La Figura 8 muestra la hora de inicio del día y la zona muerta para un maestro

oriental con una hora de inicio del día de IBM Tivoli Workload Scheduler de las 6

a.m. y un agente occidental con una diferencia de huso horario de 3 horas.

Activación de la función de huso horario

Active la función de huso horario en IBM Tivoli Workload Scheduler llevando a

cabo los pasos siguientes:

1. Establezca en sí la opción Timezone enable del archivo

TWSHOME/mozart/globalopts del Gestor de dominio maestro. El valor

predeterminado es no, que significa que el huso horario no está habilitado.

2. Establezca un huso horario específico para cada estación de trabajo de la red de

IBM Tivoli Workload Scheduler modificando las propiedades de la estación de

trabajo mediante Job Scheduling Console.

Figura 8. Zonas muertas


|

||||

|

|

||||||||||

||||

|||||

||

||

|||

|||

Si no se especifica un huso horario para una estación de trabajo, ésta utiliza el

huso horario del gestor de dominio maestro.

Para conocer más detallas sobre cómo habilitar la función de huso horario, consulte

la publicación IBM Tivoli Workload Scheduler - Guía de planificación e instalación.

Ejecución de una secuencia de trabajos sin el huso horario

habilitado cuando el gestor de dominio maestro está

adelantado respecto al agente tolerante a errores

Este apartado muestra la sentencia de definición de secuencia de trabajos para

ejecutar una secuencia de trabajos cada día de la semana por la mañana en un

agente tolerante a errores, que se rige por la Hora oficial del Pacífico (PST) y está

conectado a un gestor de dominio maestro que tiene la Hora oficial del Este (EST)

con una hora de inicio del día de las 0600 a.m., si no se habilita la función de huso

horario. Para ejecutar la secuencia de trabajos cada día de la semana por la

mañana, la debe planificar de forma que se ejecute de domingo a jueves y

especificar las palabras clave carryforward y at del modo siguiente:

Schedule FTA# PST_SCHEDULE1

On SU, weekdays except FR

CARRYFORWARD

AT 0330

.

.

job1

job2

END

Si no se especifica la palabra clave carryforward, el trabajo nunca se ejecutará

porque el agente tolerante a errores se inicializará cada día a las 0300 a.m.

Ejecución de una secuencia de trabajos con el huso horario

habilitado cuando el maestro está adelantado respecto al

agente tolerante a errores



agente tolerante a errores PST que está conectado a un gestor de dominio maestro

EST con una hora de inicio del día de las 0600 a.m., si se habilita la función de

huso horario. Para ejecutar una secuencia de trabajos cada día de la semana por la

mañana, la debe planificar de forma que se ejecute cada día de la semana y

especificar la palabra clave at del modo siguiente:

Schedule FTA# PST_SCHEDULE2

On weekdays

AT 0330

.

.

job1

job2

END

Cuando el gestor de dominio maestro EST inicializa el agente tolerante a errores

PST a las 0300 a.m., el agente tolerante a errores inicia la secuencia de trabajos el

mismo día a las 0300 a.m.


||

||

|

|

|

||||||||

|||||||||

||

|

|

|

|||||||

||||||||

|||

Ejecución de una secuencia de trabajos sin el huso horario

habilitado cuando el gestor de dominio maestro está atrasado

respecto al agente tolerante a errores



agente tolerante a errores EST, que tiene un gestor de dominio maestro PST con

una hora de inicio del día de las 0600 a.m., si no se habilita la función de huso


mañana, la debe planificar de forma que se ejecute de domingo a jueves y

especificar la palabra clave carryforward y +1DAY para la palabra clave at, tal

como se muestra en la sentencia de definición de secuencia de trabajos siguiente:

Schedule FTA1#EST_SCHEDULE1


AT 0800 + 1 DAY CARRYFORWARD

.

.

job1

job2

END

Es necesario especificar la palabra clave carryforward porque, de lo contrario, la

secuencia de trabajos no se seleccionaría para su inclusión en el plan que se ejecute

el día siguiente. Sin la especificación +1DAY, la corriente de trabajos se iniciaría

inmediatamente después de la inicialización desde el maestro occidental, a las 0900

a.m.

Ejecución de una secuencia de trabajos con el huso horario

habilitado cuando el gestor de dominio maestro está atrasado

respecto al agente tolerante a errores.



agente tolerante a errores EST que tiene un gestor de dominio maestro PST con

una hora de inicio del día de las 0600 a.m., si se habilita la función de huso


mañana, especifique la sentencia de definición de secuencia de trabajos siguiente:

Schedule FTA1#EST_SCHEDULE2


AT 0800

.

.

job1

job2

END

Cuando el agente tolerante a errores oriental se inicializa, a las 0900 a.m., ejecuta la

secuencia de trabajos a las 0800 a.m. del día siguiente.

Sometimiento ad hoc de una secuencia de trabajos

especificando una dependencia at

Este apartado muestra cómo someter ad hoc una secuencia de trabajos

especificando una dependencia at. Si ha definido una secuencia de trabajos sin

ninguna dependencia de tiempo, y si desea someterla especificando una

dependencia de tiempo, especifique la dependencia at utilizando el programa

Conman en el gestor de dominio maestro. Por ejemplo, si ha definido la secuencia

de trabajos SCHED1 sin la dependencia at, del modo siguiente:

Apéndice B. Gestión de husos horarios 343

|

|

|

||||||||

||||||||

|||||

|

|

|

||||||

||||||||

||

|

|

||||||

Schedule FTA1#SCHED1

on request

.

.

job1

END

Para someter la secuencia de trabajos SCHED1 con una dependencia PST, ejecute el

comando de Conman siguiente en el gestor de dominio maestro:

sbs FTA1#SCHED1 ;at=0400 TZ PST

El gestor de dominio maestro convierte la hora de sometimiento, por ejemplo las

2:00 p.m. ECT, al huso horario (PST) que ha especificado en el comando. A

continuación, el gestor de dominio maestro compara el valor especificado en la

palabra clave at con el valor resultante:

v Si el valor de la dependencia at es posterior o igual al valor resultante, la

planificación se ejecuta el mismo día.

v Si el valor de la dependencia at es anterior o igual al valor resultante, la

planificación se ejecuta el día siguiente.

Ahora, el gestor de dominio maestro convierte la fecha obtenida y la hora

especificada en el comando (4:00 a.m. PST), pasándola del huso horario (PST)

especificado en el comando al huso horario especificado en la estación de trabajo

FTA1.

Sometimiento de una secuencia de trabajos especificando

una dependencia at que se produce durante el horario de

verano

Este apartado muestra cómo someter una secuencia de trabajos especificando una

dependencia at que se produce durante el horario de verano. Piense en un gestor

de dominio maestro definido en el huso horario ECT (GMT+1:00). La fecha es el 3

de abril de 2005. En esta fecha, la zona ECT ya tiene horario de verano y, por lo

tanto, ésta consiste en GMT+2:00. La secuencia de trabajos se somete con una

dependencia at relativa al huso horario PST (GMT-8:00):

Schedule MDM#SCHED1

AT 0230 TZ PST

.

.

job1

job2

END

En el huso horario PST, el 3 de abril de 2005 a las 2:00 a.m. se produce un cambio

de la hora estándar al horario de verano (DST); por lo tanto, la hora se adelanta a

las 3:00 a.m. y el huso horario pasa de GMT-8:00 a GMT-7:00. El gestor de dominio

maestro convierte la dependencia de tiempo AT 0230 TZ PST al huso horario del

agente tolerante a errores en que se debe ejecutar la secuencia de trabajos, que en

este caso es el huso horario del propio gestor de dominio maestro (ETC). Todas las

dependencias de tiempo entre AT 0200 TZ PST y AT 0259 TZ PST se convierten a

ECT 1159, puesto que todos los minutos del huso horario PST coinciden con un

único minuto del huso horario ECT. Fuera de este rango de dependencias de

tiempo, la conversión se realiza siguiendo las normas estándares de conversión.

Por ejemplo, una dependencia de tiempo de AT 0300 TZ PST se convierte a ECT

1200. Una dependencia de tiempo de AT 0301 TZ PST se convierte a ECT 1201, y

así sucesivamente.


||||||

||

|

||||

||

||

||||

|

|

|

||||||

|||||||

|||||||||||||

Lista de husos horarios

En este apartado se listan los husos horarios soportados, junto con la descripción

de los mismos.

Nombre Descripción Relativo a GMT

GMT Hora media de Greeenwich GMT

UTC Hora universal coordinada GMT

ECT Hora de Europa central GMT+1:00

EET Hora de Europa oriental GMT+2:00

ART Hora oficial de Egipto (Árabe) GMT+2:00

EAT Hora de África oriental GMT+3:00

MET Hora de Oriente Medio GMT+3:30

NET Hora de Próximo Oriente GMT+4:00

PLT Hora de Lahore, Pakistán GMT+5:00

IST Hora oficial de la India GMT+5:30

BST Hora oficial de Bangladesh GMT+6:00

VST Hora oficial de Vietnam GMT+7:00

CTT Hora de China / Taiwán GMT+8:00

JST Hora oficial de Japón GMT+9:00

ACT Hora de Australia (Centro) GMT+9:30

AET Hora de Australia (Este) GMT+10:00

SST Hora oficial de las Islas Salomón GMT+11:00

NST Hora oficial de Nueva Zelanda GMT+12:00

MIT Hora de las Islas Midway GMT-11:00

HST Hora oficial de Hawaii GMT-10:00

AST Hora oficial de Alaska GMT-9:00

PST Hora oficial del Pacífico GMT-8:00

PNT Hora oficial de Phoenix GMT-7:00

MST Hora oficial de las Montañas Rocosas GMT-7:00

CST Hora oficial central (EEUU y Canadá) GMT-6:00

EST Hora oficial del Este de EE.UU. GMT-5:00

IET Hora oficial de Indiana (Este) GMT-5:00

PRT Hora de Puerto Rico e Islas Vírgenes de EEUU GMT-4:00

CNT Hora de Terranova (Canadá) GMT-3:30

AGT Hora oficial de Argentina GMT-3:00

BET Hora de Brasil (Este) GMT-3:00

CAT Hora de África central GMT-1:00

Apéndice B. Gestión de husos horarios 345

||

||

||||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||

|||||

Apéndice C. La función de auditoría

Se dispone de una opción de auditoría para hacer un seguimiento de los cambios

efectuados en la base de datos y en el plan:

v Para la base de datos, se registran todas las modificaciones de los usuarios. Sin

embargo, no se registrará el resumen de las modificaciones, o imagen anterior e

imagen posterior. Si se abre y se guarda un objeto, la acción se registrará aunque

no se haya realizado ninguna modificación.

v Para el plan, se registrarán todas las modificaciones realizadas por los usuarios.

Las acciones se registran tanto si son satisfactorias como si no lo son.

Los registros de auditoría se crean en los directorios siguientes:

TWShome/audit/plan

TWShome/audit/database

Los archivos de auditoría se registran en un archivo de texto plano en máquinas

individuales de la red de IBM Tivoli Workload Scheduler. Así se minimiza el riesgo

de errores de auditoría debidos a problemas de la red y se proporciona un método

sencillo para grabar el registro. En un sentido general, los formatos de los registros

son iguales para el plan y la base de datos. Los registros constan de una sección de

cabecera, que es igual para todos los registros, un ID de acción y una sección de

datos que variará en función del tipo de acción. Todos los datos se conservan en

texto claro y en un formato que se puede leer y editar mediante un editor de texto,

como por ejemplo vi o el Bloc de notas.

Nota: Para los comandos de modificación, se efectúan dos entradas en el registro

para recursos, calendarios, parámetros y solicitudes. El comando de

modificación se visualiza en el registro en forma de comandos de supresión

y agregación.

Habilitación de la función de auditoría

La opción de auditoría se habilita mediante dos entradas en el archivo globalopts:

plan audit level = 0|1

database audit level = 0|1

Un valor de 1 habilita la auditoría y un valor de 0 la inhabilita. Actualmente, IBM

Tivoli Workload Scheduler toma como valor predeterminado 0, o auditoría

inhabilitada. Si estas opciones no aparecen en el archivo globalopts, la auditoría

está inhabilitada. De forma predeterminada, se inhabilita la auditoría al instalar el

producto.

Para iniciar una auditoría de la base de datos, se debe cerrar por completo IBM

Tivoli Workload Scheduler y utilizar el comando wmaeutil para detener la

instancia del conector. Cuando se reinicien IBM Tivoli Workload Scheduler y la

instancia del conector, se iniciará el registro de auditoría de la base de datos. La

auditoría de un plan entra en vigor cuando se ejecuta Jnextday.


Formato del registro de auditoría

Los formatos de los registros de auditoría son básicamente iguales para el plan y la

base de datos. El registro consta de una sección de cabecera, un ID de acción y

secciones de datos que varían en función del tipo de acción. Los datos están en

formato de texto claro y los elementos de datos se separan entre sí mediante una

barra vertical ( | ).

Las entradas del archivo de registro estarán en el formato siguiente:

Tipo de registro|Fecha GMT|Hora GMT|Fecha local|Hora

local|Tipo de objeto|Tipo de acción|Nombre de estación

de trabajo|ID de usuario|Usuario de Framework|Nombre de objeto|campos

de datos de acción

Los archivos de registro contienen la información siguiente:

Tipo de registro

Este campo muestra un valor de ocho caracteres que indica el origen del

registro anotado. A continuación se listan los tipos de registro soportados:

HEADER

Cabecera del archivo de registro

CONMAN

Texto del comando conman

FILEAID

Comando que abre un archivo

PLAN Acción del plan

STAGEMAN

Ejecución de stageman

RELEASE

Texto del comando release

DATABASE

Acción de la base de datos

PARMS

Texto del comando de parámetros

MAKESEC

Ejecución de makesec

DBEXPAND

Ejecución de dbexpand

Fecha GMT

Este campo muestra la fecha GMT en que se ha realizado la acción. El

formato es aaaammdd, donde aaaa corresponde al año, mm al mes y dd al

día.

Hora GMT

Este campo muestra la hora GMT en que se ha realizado la acción. El

formato es hhmmss, donde hh corresponde a la hora, mm a los minutos y ss

a los segundos.

Fecha local

Este campo muestra la fecha local en que se ha realizado la acción. La


fecha local se define mediante la opción de zona horaria de la estación de

trabajo. El formato es aaaammdd, donde aaaa corresponde al año, mm al mes

y dd al día.

Hora local

Este campo muestra la hora local en que se ha realizado la acción. La hora

local se define mediante la opción de zona horaria de la estación de

trabajo. El formato es hhmmss, donde hh corresponde a la hora, mm a los

minutos y ss a los segundos.

Tipo de objeto

Este campo muestra el tipo del objeto que se ha visto afectado por una

acción. El tipo de objeto es uno de los siguientes:

DATABASE

Definición de base de datos

DBWKSTN

Definición de estación de trabajo de base de datos

DBWKCLS

Definición de clase de estación de trabajo de base de datos

DBDOMAIN

Definición de dominio de base de datos

DBUSER

Definición de usuario de base de datos

DBJBSTRM

Definición de secuencia de trabajos de base de datos

DBJOB

Definición de trabajo de base de datos

DBCAL

Definición de calendario de base de datos

DBPROMPT

Definición de solicitud de base de datos

DBPARM

Definición de parámetro de base de datos

DBRES

Definición de recurso de base de datos

DBSEC

Seguridad de base de datos

PLAN Plan

PLWKSTN

Estación de trabajo del plan

PLDOMAIN

Dominio del plan

PLJBSTRM

Secuencia de trabajos del plan

PLJOB

Trabajo del plan

PLPROMPT

Solicitud del plan


PLRES

Recurso del plan

PLFILE

Archivo del plan

Tipo de acción

Este campo muestra qué acción se ha emprendido sobre el objeto. Los

valores apropiados para este campo dependen de la acción que se realice.

Para la base de datos, el Tipo de acción puede ser ADD, DELETE,

MODIFY, EXPAND o INSTALL. IBM Tivoli Workload Scheduler registrará

acciones ADD, DELETE y MODIFY para estaciones de trabajo, clases de

estación de trabajo, dominios, usuarios, trabajos, secuencias de trabajos,

calendarios, solicitudes, recursos y parámetros en la base de datos. El

campo Tipo de acción también registra la instalación de un nuevo archivo

de seguridad. Cuando se ejecute makesec, IBM Tivoli Workload Scheduler

lo registrará como acción INSTALL para un objeto de Definición de

seguridad. Cuando se ejecute dbexpand, se registrará como acción

EXPAND para un objeto DATABASE. Las acciones LIST y DISPLAY para

objetos no se registran. Para fileaid, IBM Tivoli Workload Scheduler sólo

registrará los comandos que tengan como consecuencia la apertura de un

archivo. Para los parámetros, se registra la línea de comandos con los

argumentos.

Nombre de estación de trabajo

Este campo muestra la estación de trabajo de IBM Tivoli Workload

Scheduler desde la que el usuario está realizando la acción.

ID de usuario

Este campo muestra el usuario de inicio de sesión que ha realizado esta

acción en concreto. En las plataformas Win32, se tratará del nombre de

dominio completamente calificado dominio\usuario.

Usuario de Framework

Este campo muestra el ID de usuario reconocido por Tivoli Framework. Se

trata del ID de inicio de sesión del usuario de Job Scheduling Console.

Nombre de objeto

Este campo muestra el nombre completamente calificado del objeto. El

formato de este campo dependerá del tipo de objeto, según se muestra a

continuación:

DATABASE

N/A

DBWKSTN

estación_trabajo

DBWKCLS

clase_estación_trabajo

DBDOMAIN

dominio

DBUSER

[estación_trabajo#]usuario

DBJBSTRM

estación_trabajo#secuenciatrab

DBJOB

estación_trabajo#trabajo


DBCAL

calendario

DBPROMPT

solicitud

DBPARM

estación_trabajo#parámetro

DBRES

estación_trabajo#recurso

DBSEC

N/A

PLAN N/A

PLWKSTN

estación_trabajo

PLDOMAIN

dominio

PLJBSTRM

estación_trabajo#instancia_secuenciatrab

PLJOB

estación_trabajo#instancia_secuenciatrab.trabajo

PLPROMPT

[estación_trabajo#]solicitud

PLRES

estación_trabajo#recurso

PLFILE

estación_trabajo#ruta(calificador)

Datos que dependen de la acción

Este campo muestra los campos de datos específicos de la acción. El

formato de estos datos depende del campo Tipo de acción.

Cabecera del registro de auditoría

Cada archivo de registro empezará por un registro de cabecera que contiene

información sobre cuándo se creó el registro y si se trata de un registro de plan o

de base de datos.

El contenido de la entrada del archivo de cabecera es el siguiente:

Tipo de registro

HEADER

Fecha GMT

Fecha GMT en que se creó el archivo de registro.

Hora GMT

Hora GMT en que se creó el archivo de registro.

Fecha local

Fecha local en que se creó el archivo de registro.

Hora local

Hora local en que se creó el archivo de registro.


Nombre de estación de trabajo

Nombre de la estación de trabajo de IBM Tivoli Workload Scheduler para

la cual se creó este archivo. Cada estación de trabajo de la red de IBM

Tivoli Workload Scheduler crea su propio registro.

ID de usuario

ID del usuario de IBM Tivoli Workload Scheduler que creó el archivo de

registro.

Tipo de objeto

Este campo contiene DATABASE para un archivo de registro de base de

datos y PLAN para un archivo de registro de plan.

Nombre de objeto

N/A

Tipo de acción

N/A

Datos que dependen de la acción

Este campo muestra la versión del archivo

Ejemplos de entradas del registro de auditoría

A continuación se muestran algunos ejemplos de entradas del archivo de registro:

HEADER |19991202|201200|19991202|131200|DATABASE| |GANGES

|RIVERS\pyasa |||1.0

DATABASE|19991202|224504|19991202|154504|DBWKSTN |ADD

|GANGES |RIVERS\pyasa ||JAMUNA|

DATABASE|19991203|001400|19991202|171400|DBJOB |MODIFY |SINDHU

|RIVERS\tairak ||NARMADA#dubo|


Avisos

Esta información se ha elaborado para productos y servicios ofrecidos en EEUU. Es

posible que IBM no ofrezca los productos, servicios o dispositivos tratados en este

documento en otros países. Para obtener información sobre los productos y

servicios de que se dispone actualmente en su zona, consulte al representante local

de IBM. Cualquier referencia a un producto, programa o servicio de IBM no

pretende establecer ni implicar que sólo se pueda utilizar dicho producto,

programa o servicio de IBM. En su lugar se puede utilizar cualquier producto,

programa o servicio de funcionamiento equivalente que no infrinja ninguno de los

derechos de propiedad intelectual de IBM. No obstante, son responsabilidad del

usuario la evaluación y verificación del funcionamiento de cualquier producto,

programa o servicio que no sea de IBM.

IBM puede tener patentes o solicitudes de patente pendientes relacionadas con el

tema tratado en este documento. La obtención de este documento no confiere

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

escrito, a:

IBM Director of Licensing

IBM Corporation

North Castle Drive

Armonk, NY 10504-1785 EE.UU.

Para efectuar consultas sobre licencias relativas a la información de doble byte

(DBCS), póngase en contacto con el Departamento de propiedad intelectual de IBM

en su país, o bien envíe sus consultas, por escrito, a:

IBM World Trade Asia Corporation

Licensing

2-31 Roppongi 3-chome, Minato-ku

Tokyo 106, Japón

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

que tales disposiciones entren en contradicción con la ley local:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA

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

EXPLÍCITAS NI IMPLÍCITAS, INCLUYENDO, PERO SIN LIMITARSE A ELLAS,

LAS GARANTÍAS IMPLÍCITAS DE COMERCIALIZACIÓN O DE ADECUACIÓN

A UN PROPÓSITO DETERMINADO.

Algunos países no permiten la renuncia a garantías expresas o implícitas en ciertas

transacciones, por lo que el párrafo anterior puede no aplicarse en su caso.

Esta información puede contener incorrecciones técnicas o errores tipográficos.

Periódicamente se efectúan cambios en la información aquí contenida; estos

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

cualquier momento, realizar mejoras, cambio o ambas cosas en el producto o los

productos, así como en el programa o los programas, descritos en esta publicación,

sin previo aviso.


Cualquier referencia que se haga en esta información a sitios Web que no sean de

IBM se proporciona, únicamente, a efectos de comodidad, y de ninguna manera

sirve de endoso de dichos sitios Web. Los materiales de dichos sitios Web no

forman parte de los materiales para este producto de IBM y el uso de los

mencionados sitios es a cuenta y riesgo del usuario.

IBM puede utilizar o distribuir la información que se le suministre del modo que

crea conveniente, sin incurrir por ello en ninguna obligación para con el remitente.

Los poseedores de licencias para este programa que deseen tener información

sobre el mismo a efectos de permitir: (i) el intercambio de información entre

programas creados independientemente y otros programas (incluido éste) y (ii) el

uso mutuo de la información que se haya intercambiado, se deben poner en

contacto con:

IBM, S.A.

National Language Solutions Center

Avda. Diagonal, 571, Edif. ″L’Illa″

08029 Barcelona España

Esta información puede estar disponible, sujeta a los términos y condiciones

apropiados, incluido en algunos casos el pago de una tasa.

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 IBM

Customer Agreement, del IBM International Program License Agreement o de

cualquier contrato equivalente entre ambas partes.

La información relativa a productos que no son de IBM se ha obtenido de los

proveedores de dichos productos, de los anuncios publicados por los mismos o de

otras fuentes a disposición del público. IBM no ha probado estos productos y no

puede confirmar la exactitud de las declaraciones de rendimiento, compatibilidad y

otras relacionadas con los productos que no son de IBM. Las preguntas sobre las

posibilidades de los productos que no son de IBM se deben dirigir a los

proveedores de dichos productos.

Esta información contiene ejemplos de datos e informes utilizados en operaciones

comerciales diarias. Para ilustrarlos de la forma más completa posible, los ejemplos

incluyen los nombres de personas, empresas, marcas comerciales y productos.

Todos estos nombres son ficticios y cualquier parecido con los nombres y

direcciones utilizados por una empresa comercial real son pura coincidencia.

Marcas registradas

IBM, el logotipo de IBM, z/OS, Tivoli y el logotipo de Tivoli son marcas

registradas o nombres comerciales de International Business Machines Corporation

en Estados Unidos y/o en 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 los Estados Unidos y en

otros países.

Otros nombres de compañías, productos y servicios pueden ser marcas registradas

o marcas de servicio de otras compañías.


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,

Aplicaciones Oracle, Peoplesoft y Baan). Los agentes

ampliados utilizan scripts llamados métodos de acceso

para comunicarse con sistemas externos.

Agente de red. Tipo de agente ampliado que se utiliza

para crear dependencias entre trabajos y secuencias de

trabajos que se encuentran en redes Tivoli Workload

Scheduler distintas. Véase también “Dependencia

inter-red (INET)”.

Agente tolerante a errores. Estación de trabajo de

agente de la red de Tivoli Workload Scheduler con

capacidad para resolver dependencias locales e iniciar

sus trabajos en ausencia de un gestor de dominio.

Archivo stdlist. Archivo de lista estándar que se crea

para cada trabajo que inicia Tivoli Workload Scheduler.

Los archivos de lista estándar contienen mensajes de

cabecera y de cola, comandos reenviados, errores y

avisos. Estos archivos se pueden utilizar para resolver

problemas de la ejecución del trabajo.

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 se carga durante la fase de

pre-producción previa. Durante la fase de

pre-producción, se actualiza continuamente para indicar

el estado actual del proceso de producción: trabajo

completado, trabajo en proceso, trabajo por realizar.

Para gestionar el proceso de producción, el contenido

del archivo Symphony (plan) se puede visualizar y

modificar con la Job Scheduling Console.

B

Base de datos. La base de datos contiene todas las

definiciones que se han creado para 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 estadísticas de la ejecución de trabajos y

secuencias de trabajos, información sobre el ID de

usuario que ha creado un objeto y la fecha de la última

modificación de un objeto. Por contraste, el plan sólo

contiene aquellos trabajos y secuencias de trabajos

(incluidos los objetos dependientes) que están

planificados para ejecutarse en la producción del día en

curso.

Base de datos expandida. Las bases de datos

expandidas admiten nombres más largos para objetos

de base de datos tales como trabajos, secuencias de

trabajos, estaciones de trabajo, dominios y usuarios. Las

bases de datos expandidas se configuran utilizando el

comando dbexpand o como una opción durante la

instalación. No expanda su base de datos antes de tener

bien claro las consecuencias y el efecto de este

comando.

Batchman. Batchman es un proceso que se inicia al

principio de cada día de proceso de Tivoli Workload

Scheduler para iniciar trabajos de acuerdo con la

información del archivo Symphony.

C

Calendario (agenda). Un calendario (o agenda) es un

objeto definido en la base de datos de Tivoli Workload

Scheduler que contiene una lista de fechas de

planificación. Dado que es un objeto exclusivo que se

define en la base de datos, puede asignarse a múltiples

secuencias de trabajos. El hecho de asignar un

calendario a una secuencia de trabajos hace que esa

secuencia de trabajos se ejecute los días especificados

en el calendario. Tenga en cuenta que un calendario

puede utilizarse como un ciclo de ejecución inclusivo o

excluyente.

Caracteres comodín. Los caracteres comodín para

Tivoli Workload Scheduler son:



* Sustituye cero o más caracteres alfanuméricos en

Tivoli Job Scheduling Console.

@ Sustituye cero o más caracteres alfanuméricos en la

línea de comandos de Tivoli Workload Scheduler.

Los caracteres comodín se utilizan normalmente para

restringir 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 comodín asterisco

(*). Para obtener un listado de las estaciones de trabajo

site1 a site8, puede entrar site%.

Ciclo de ejecución. Un ciclo de ejecución especifica

los días en que una secuencia de trabajos está

planificada para ejecutarse. En Tivoli Workload

Scheduler existen tres tipos de ciclos de ejecución que

se pueden especificar para una secuencia de trabajos:

un ciclo de ejecución Simple, un ciclo de ejecución

Semanal o un ciclo de ejecución de Calendario (al que

normalmente se le llama calendario). Tenga en cuenta


| |

| |

| |

| | |

| | |

| | | | | |

que cada tipo de ciclo de ejecución puede ser inclusivo

o excluyente. Es decir, cada ciclo de ejecución puede

definir los días en que una secuencia de trabajos está

incluida en el ciclo de producción o los días en que está

excluida del ciclo de producción. Cuando defina varios

ciclos de ejecución para una secuencia de trabajos, y

haya ciclos de ejecución inclusivos y excluyentes que

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

puede ejecutarse. Los ciclos de ejecución excluyentes

tienen prioridad sobre los ciclos de ejecución inclusivos.

Ciclo de ejecución inclusivo. Ciclo de ejecución que

especifica los días en los que se ha planificado la

ejecución de una secuencia de trabajos. Los ciclos de

ejecución excluyentes tienen prioridad sobre los ciclos

de ejecución inclusivos.

Ciclo de ejecución semanal. Ciclo de ejecución que

especifica los días de la semana en que se ejecuta una

secuencia de trabajos. Por ejemplo, puede utilizar un

ciclo de ejecución semanal para especificar que una

secuencia de trabajos se ejecute cada lunes, miércoles y

viernes. Un ciclo de ejecución semanal se define para

una secuencia de trabajos específica y no puede ser

utilizado por múltiples secuencias de trabajos. Para

obtener más información, véase 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 los que se ejecuta una secuencia de

trabajos. Un ciclo de ejecución simple se define para

una secuencia de trabajos específica y no puede ser

utilizado por múltiples secuencias de trabajos. Para

obtener más información, véase Ciclo de ejecución.

Clase de estaciones de trabajo. Una clase de

estaciones de trabajo es un grupo de estaciones de

trabajo. En una clase se pueden poner todas las

estaciones de trabajo que se desee. Se pueden asignar

trabajos y secuencias de trabajos para que se ejecuten

en una clase de estaciones de trabajo. Esto facilita la

reproducción de un trabajo o secuencia de trabajos en

muchas estaciones de trabajo.

Comandos de utilidad. Conjunto de ejecutables de

línea de comandos para gestionar Tivoli Workload

Scheduler.

Composer. Composer es una aplicación de línea de

comandos heredada que se utiliza para gestionar las

definiciones de los objetos de planificación en la base

de datos.

Conman. Conman (gestor de consola) es una

aplicación de línea de comandos heredada que se

utiliza para gestionar el entorno de producción.

Conman realiza las tareas siguientes: inicia y detiene

los procesos de producción, altera y muestra las

planificaciones y trabajos del plan, y controla el proceso

de vínculo de estaciones de trabajo en una red.

D

Delimitación. La delimitación de trabajo es un control

maestro sobre la ejecución de trabajos en una estación

de trabajo. La delimitación de trabajo es un nivel de

prioridad que un trabajo o secuencia de trabajos debe

exceder antes de que se pueda ejecutar. Por ejemplo,

establecer la delimitación en 40 impide que se inicien

los trabajos con prioridades de 40 o inferiores.

Dependencia. Una dependencia es un requisito previo

que debe satisfacerse antes de que pueda llevarse a

cabo la ejecución de un trabajo o secuencia de trabajos.

El número máximo de dependencias permitidas para

un trabajo o secuencia de trabajos es 40. Los cuatro

tipos de dependencias que utiliza Tivoli Workload

Scheduler son: dependencias de continuación (follows),

dependencias de recurso, dependencias de archivo y

dependencias de solicitud.

Dependencia de continuación (follows). Dependencia

en la que un trabajo o una secuencia de trabajos no

puede empezar a ejecutarse hasta que otros trabajos o

secuencias de trabajos se hayan completado

satisfactoriamente.

Dependencias inter-red (INET). Dependencia entre

trabajos o secuencias de trabajos que están en redes

Tivoli Workload Scheduler distintas. Véase también

“Agente de red”.

Dominio. Un dominio es un grupo de estaciones de

trabajo de Tivoli Workload Scheduler con nombre, que

consta de uno o varios agentes y de un gestor de

dominio que actúa como eje de gestión. Todos los

dominios tienen un dominio padre, excepto el dominio

maestro.

Duración. El tiempo que calcula que tardará en

completarse el trabajo. En la vista de Plazo de tiempo

de trabajos en la base de datos, la duración se

representa mediante una barra de color azul claro en el

centro de la barra de actividad o mediante un rombo

azul claro.

E

Estación de trabajo. Una estación de trabajo suele ser

un sistema individual en el que se ejecutan trabajos y

secuencias de trabajos. Se definen en la base de datos

de Tivoli Workload Scheduler como un objeto

exclusivo. Es necesaria una definición de estación de

trabajo para cada sistema que ejecute trabajos o

secuencias de trabajos en la red de Workload Scheduler.

Estado. El estado refleja el estado actual del trabajo o

secuencia de trabajos en Job Scheduling Console. El


estado de Job Scheduling Console es común para Tivoli

Workload Scheduler y OPC. Véase también Estado

interno.

Estado del trabajo. Véase “Estado”.

Estado interno. El estado interno refleja el estado

actual de los trabajos y secuencias de trabajos en el

motor de Tivoli Workload Scheduler. El estado interno

es exclusivo de Tivoli Workload Scheduler. Véase

también Estado.

G

Gestor de dominio. El eje de gestión en un dominio

de Tivoli Workload Scheduler. Todas las

comunicaciones dirigidas a, y emitidas desde, los

agentes del dominio, se direccionan a través del gestor

de dominio.

Gestor de dominio maestro. En una red de Tivoli

Workload Scheduler, el gestor de dominio maestro

mantiene los archivos que se utilizan para documentar

los objetos de planificación. Crea el plan al comienzo

del día y realiza todas las actividades de registro y

creación de informes para la red.

H

Hora de inicio más temprana. La hora antes de la

cual no puede iniciarse el trabajo o secuencia de

trabajos. La hora de inicio más temprana es un cálculo

aproximado basado en experiencias previas al ejecutar

el trabajo o secuencia de trabajos. No obstante, el

trabajo o secuencia de trabajos puede empezar después

de la hora que especifique siempre que se hayan

satisfecho todas las demás dependencias. En la vista de

Plazo de tiempo, la hora de inicio está representada por

el principio (borde izquierdo) de la barra de actividad

azul marino. Para las instancias de trabajos, la hora de

inicio que OPC calcula está representada por una barra

de color azul claro. Véase también “Hora de inicio real”

y “Hora de inicio planificada”.

Hora de inicio planificada. La hora a la que Tivoli

Workload Scheduler calcula que se iniciará una

instancia de trabajo. Este cálculo aproximado está

basado en las horas de inicio de ejecuciones anteriores.

Host. Estación de trabajo de Tivoli Workload

Scheduler que necesitan los agentes ampliados. Puede

ser cualquier estación de trabajo de Tivoli Workload

Scheduler excepto otro agente ampliado.

I

Instancia de secuencia de trabajos. Secuencia de

trabajos que está planificada para una fecha de

ejecución específica en el plan. Véase también

“Secuencia de trabajos”.

Instancia de trabajo. Trabajo planificado para una

fecha de ejecución específica en el plan. Véase también

“Trabajo”.

L

Límite. Los límites de trabajos proporcionan un medio

de asignar un número específico de intervalos de

trabajo en los que se permite a Tivoli Workload

Scheduler iniciar trabajos. Se puede establecer 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 una estación de trabajo en 25, no se

permite que Tivoli Workload Scheduler tenga más de

25 trabajos ejecutándose simultáneamente en la estación

de trabajo.

Lista. Una lista muestra objetos de planificación de

trabajos. Debe crear listas independientes 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 utilizan los agentes ampliados para

conectarse y controlar la ejecución de trabajos en otros

sistemas operativos (por ejemplo, MVS) y aplicaciones

(por ejemplo, Aplicaciones Oracle, Peoplesoft y Baan).

El método de acceso debe especificarse en la definición

de estación de trabajo de agente ampliado.

O

Opciones globales. Las opciones globales se definen

en el gestor de dominio maestro, en el archivo

globalopts, y se aplican a todas las estaciones de trabajo

de la red de 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

de Tivoli Workload Scheduler debe tener un archivo

localopts. Los valores de este archivo sólo se aplican a

una estación de trabajo. Véase también “Opciones

globales”.

P

Parámetro. Los parámetros se utilizan para sustituir

valores en los trabajos y las secuencias de trabajos.

Cuando se utiliza un parámetro en un script de trabajo,

el valor se sustituye durante la ejecución. En este caso,

el parámetro debe definirse en la estación de trabajo

donde se va a utilizar. No se pueden utilizar

parámetros al crear scripts de trabajos de agente

ampliado.

Glosario 357

Plan. El plan contiene toda la actividad de

planificación de trabajos planeada para un periodo de

un día. En Tivoli Workload Scheduler, el plan se crea

cada 24 horas y está formado por todos los trabajos,

secuencias de trabajos y objetos de dependencia que se

han planificado para que se ejecuten ese día. Todas las

secuencias de trabajos para las que ha creado ciclos de

ejecución se planifican e incluyen automáticamente en

el plan. A medida que el ciclo de producción avanza,

los trabajos y secuencias de trabajos del plan se

ejecutan según sus restricciones horarias y otras

dependencias. Los trabajos o secuencias de trabajos que

no se ejecutan satisfactoriamente se trasfieren al plan

del día siguiente.

Plazo límite. La hora tope a la que un trabajo o una

secuencia de trabajos puede empezar a ejecutarse.

Corresponde a la hora Hasta en el Maestro heredado.

Predecesor. Trabajo que debe completarse

satisfactoriamente antes de que los trabajos sucesores

puedan empezar a ejecutarse.

Prioridad. Tivoli Workload Scheduler tiene un sistema

de colas de espera para trabajos y secuencias de

trabajos en el plan. Puede asignar un nivel de prioridad

a cada trabajo y secuencia de trabajos de 0 a 101. Una

prioridad 0 hará que no se ejecute.

R

Recurso. Los recursos pueden representar recursos

físicos o lógicos existentes en el sistema. Una vez

definidos en la base de datos de Tivoli Workload

Scheduler, los recursos se pueden utilizar como

dependencias para los trabajos y las secuencias de

trabajos. Por ejemplo, puede definir un recurso llamado

″cintas″ con un valor de unidad de dos. A continuación,

defina trabajos que requieran dos unidades de cintas

disponibles como dependencia. Los trabajos con esta

dependencia no pueden ejecutarse simultáneamente

porque cada vez que un trabajo se ejecuta, el recurso

“cintas” está en uso.

Restricciones horarias. Se pueden especificar

restricciones horarias para trabajos y para secuencias de

trabajos. Se puede especificar una hora para que

empiece la ejecución o una hora después de la cual ya

no se intentará la ejecución. Si especifica ambas cosas,

puede definir una ventana en la que se ejecutará un

trabajo o una secuencia de trabajos. Para los trabajos,

también puede especificar una frecuencia de repetición.

Por ejemplo, puede hacer que Tivoli Workload

Scheduler inicie el mismo trabajo cada 30 minutos entre

las 8:30 a.m. y la 1:30 p.m.

S

Secuencia de trabajos. Una Secuencia de trabajos está

formada por una lista de trabajos que se ejecutan como

una unidad (tal como 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

ejecute en un día de producción. Contiene un trabajo

que ejecuta el archivo script Jnextday.

Solicitud. Las solicitudes pueden utilizarse como

dependencias para trabajos y secuencias de trabajos.

Una solicitud debe responderse afirmativamente para

que el trabajo o secuencia de trabajos dependiente se

inicie. Hay dos tipos de solicitudes: predefinidas y ad

hoc. Una solicitud ad hoc se define en las propiedades

de un trabajo o secuencia de trabajos y es exclusiva

para ese trabajo o secuencia de trabajos. Una solicitud

predefinida se define en la base de datos de Tivoli

Workload Scheduler y puede ser utilizada por cualquier


Sucesor. Trabajo que no puede iniciarse hasta que

todos los trabajos predecesores de los que depende se

hayan completado satisfactoriamente.

T

Tivoli Management Framework (TMF). El software

base que se necesita para ejecutar las aplicaciones de la

suite de productos Tivoli. Esta infraestructura de

software permite la integración de aplicaciones de

gestión de sistemas de Tivoli Systems Inc. y de los

partners de Tivoli. Tivoli Management Framework

incluye lo siguiente:

v Intermediario de peticiones de objetos (oserv)

v Base de datos de objetos distribuida

v Funciones básicas de administración

v Servicios básicos de aplicaciones

v Servicios básicos de escritorio, como la interfaz

gráfica de usuario

En un entorno Tivoli, Tivoli Management Framework

se instala en cada cliente y servidor. No obstante, el

servidor de TMR es el único servidor que contiene la

base de datos de objetos completa.

Tivoli Management Region (TMR). En un entorno

Tivoli, un servidor Tivoli y el conjunto de clientes a los

que da servicio. Una organización puede tener más de

una TMR. Una TMR se ocupa de la conectividad física

de los recursos mientras que una región de políticas se

ocupa de la organización lógica de los recursos.

Trabajo. Un trabajo es una unidad de trabajo que se

procesa en una estación de trabajo. La definición del

trabajo consiste en un nombre de trabajo exclusivo en

la base de datos de Tivoli Workload Scheduler, junto

con otra información necesaria para ejecutar el trabajo.

Cuando agrega un trabajo a una secuencia de trabajos,


puede definir sus dependencias y sus restricciones

horarias como, por ejemplo, la hora de inicio y la hora

de finalización estimadas.

Trabajo externo. Trabajo de una secuencia de trabajos

que es un predecesor para un trabajo en otra secuencia

de trabajos. Un trabajo externo se representa mediante

un icono de espacio reservado en la vista de Gráfico de

la secuencia de trabajos.

Trabajo Jnextday. El proceso de preproducción y

postproducción puede automatizarse totalmente

planificando el trabajo Jnextday de modo que se ejecute

al final de cada día. Se proporciona un trabajo jnextday

de ejemplo como TWShome\Jnextday. El trabajo

Jnextday hace lo siguiente: prepara el proceso del día

siguiente (contenido en el archivo Symphony), imprime

informes, traspasa al día siguiente las secuencias de

trabajos no completadas, y detiene y reinicia Tivoli

Workload Scheduler.

Trabajo / secuencia de trabajos inter-red (INET).

Trabajo o secuencia de trabajos de una red Tivoli

Workload Scheduler remota que es un predecesor para

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 de Gráfico de la secuencia

de trabajos. Véase también “Agente de red”.

Trabajos interactivos. Trabajo que se ejecuta de forma

interactiva en un escritorio de 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 coincidente. Las definiciones proporcionan las

contraseñas de usuario que Tivoli Workload Scheduler

necesita para iniciar trabajos.

V

Vista de árbol. La vista situada en el lado izquierdo

de Job Scheduling Console que muestra el servidor de

Tivoli Workload Scheduler, grupos de listas

predeterminadas y grupos de listas creadas por el

usuario.

X

X-agent. Véase “Agente ampliado”.

Glosario 359

Índice

Aabsolute, palabra clave 135, 141, 142,

147

adddep job, comando 149

adddep sched, comando 151

agente ampliadoconsulta 299

estación de trabajo, definición 299

visión general 299

agente de redarchivo de opciones 311

dependencia inter-red 312

ejemplo de línea de comandos de

estación de trabajo 311

estación de trabajo 309

netmth 309

visión general 309

altpass, comando 153

altpri, comando 154

APARIY46485 18

IY46918 201

IY48317 299

IY49121.1 327

IY49333 64, 130, 326

IY52215 203, 204

IY52475 100

IY52493 253

IY53050 108

IY53064 318, 335

IY53459 203

IY53755 90

IY57906 323

IY58702 29

árbol de procesos en UNIX 11

árbol de procesos en Windows 13

archivo de plantilla de seguridad 318

archivo de seguridadactualización 318

archivo de seguridad de ejemplo 329

arreglos, obtención 338

at, comando 238

at, palabra clave 17, 92

auditoríaarchivos de registro 347

ejemplos de entradas del registro 352

formato de la cabecera 351

formato del registro 348

habilitación 347

Bbases de información, búsqueda para

encontrar la resolución de problemas de

software 337

batch, comando 238

batchman 10

behindfirewall 39

biblioteca xii

biblioteca de productos xii

Ccancel job, comando 156

cancel sched, comando 157

caracteres comodín 64, 130

caracteres de control 62

caracteres de control, conman 127

caracteres especiales, Composer 64

caracteres especiales, conman 130

carryforward, palabra clave 17, 95

caxtract, comando 243

centro de información de software de

Tivoli xvi

centros de información, búsqueda para


software 337

ciclo de producción 9

automatización 15

cliente, soportevéase Servicio de soporte de

software 338

comando del sistema, conman 231

comando rep1 289

comando rep11 292

comando rep2 289

comando rep3 289

comando rep4a 289

comando rep4b 289

comando rep7 290

comando rep8 291

comando reptr 293

comando xref 295

comandosadd 67

adddep job 149

adddep sched 151

altpass 153

altpri 154

build 68

cancel job 155

cancel sched 157

compiler 10

confirm 159

console 161

continue 69, 162

create 70

deldep job 163

deldep sched 165

delete 72

display 74, 167

dumpsec 318, 334

edit 78

exit 79, 168

fence 169

help 171

kill 172

limit cpu 173

limit sched 174

link 175

list 74

listsym 177

logman 10

comandos (continuación)makesec 318, 335

modify 80

new 82

print 74

recall 178

redo 83, 179

release job 181

release sched 183

rep1 289

rep11 292

rep2 289

rep3 289

rep4a 289

rep4b 289

rep7 290

rep8 291

replace 85

reply 185

reptr 293

rerun 186

resource 189

schedulr 10

setsym 190

showcpus 191

showdomain 195

showfiles 196

showjobs 198

showprompts 207

showresources 209

showschedules 211

shutdown 215

stageman 10

start 216

status 218

stop 219

stop ;progressive 221

submit docommand 222

submit file 224

submit job 226

submit sched 228

switchmgr 230

system, comando 231

tellop 232

unlink 233

validate 87

version 88, 235

xref 295

comandos de utilidad 237

comandos del sistema, conman 127

comments, palabra clave 96

compiler, comando 10

composer 9

Composer, caracteres de control 62

Composer, descripciones de

comandos 65

Composer, editor 63

Composer, sintaxis de comandos 64

condición de éxito 48, 108

conector 319

confirm, comando 159


confirmed, palabra clave 97

conman 9

Conman, consulta 127

Conman, ejecución 127

Conman, indicador de comandos 129

Conman, lista de comandos 131

console, comando 161

consulta de Composer 35

contacto a través de correo

electrónico xvii

continue, comando 162

conveniostipo de letra xviii

convenios de tipos de letra xviii

cortafuegosestablecimiento 39

cpuinfo, comando 245

cpuname 37

creación de una dependencia

inter-red 312

creación del archivo de seguridad 318

Ddatecalc, comando 246

dbexpand, comando 250

deadline, palabra clave 98

Defectos155861 47

169932 191

170660 119

definición de calendario 56

definición de clases de estación de

trabajo 43

definición de dominio 45

definición de parámetro 57

definición de recurso 61

definición de solicitud 59

definición de trabajo 47

definición de usuario 53

definiciones de usuario de

seguridad 318

deldep, comando 163

deldep sched, comando 165

delete, comando 252

delimitadores 64

delimitadores, conman 130

dependenciaarchivo 138, 145, 196

inter-red 309, 312

dependencia de archivo 138, 145, 196

dependencia inter-red 309, 312

display, comando 167

dumpsec, comando 10, 318, 334

Eeditor, objeto de base de datos 63

ejecución de Composer 62

ejecución de Conman 127

ejemplos de entradas del registro de

auditoría 352

emisión de mensajes de solicitud al

usuario 128

en línea, publicacionesacceso xvi

end, palabra clave 99

ent_conf 319

entradas de la base de datos 35

entrenamiento técnico en Tivoli xvii

estación de trabajo, definición 37

estadotarde 98

estado tardío 98

estados, trabajos 140

every. palabra clave 100

evtsize, comando 254

except, palabra clave 101

exit, comando 168

Ffence, comando 169

follows, palabra clave 104

formaciónver entrenamiento técnico en

Tivoli xvii

freedays, palabra clave 105

Ggestión de la seguridad 318

gestión del huso horario 341

globalopts, archivofunción de auditoría 347

Hhabilitación de la auditoría 347

help, comando 171

hora de inicio 17

hora de inicio, última 17

huso horario 134

Iindicador de comandos 64

indicador de comandos, Conman 129

información de usuario sobre

publicaciones xvii

informes de ejemplo 296

interfaces de usuario 9

Internet, búsqueda para encontrar la

resolución de problemas de

software 338

Jjbxtract, comando 255

Jnextdayejecución 16

job launch 10

Job Scheduling Console 9

jobinfo, comando 257

jobman 10

jobmanrc 19

jobmon 10

jobstdl, comando 259

Kkeyjob, palabra clave 112

keysched, palabra clave 113

kill, comando 172

killproc, comando 286

Llenguaje de planificación 89

lenguaje de planificación, palabras

clave 90

limit, palabra clave 114

limit cpu, comando 173

limit sched, comando 174

link, comando 175

listproc, comando 286

listsym, comando 177

logman, comando 10

Mmaestro, comando 261

mailman 10

makecal, comando 262

makesec 319

makesec, comando 10, 318, 335

manuales xii

ver publicaciones xvi

metronome.pl, comando 264

morestdl, comando 265

Nneeds, palabra clave 115

netman 10

netmth, método de acceso 309

nivel de seguridadenabled 40

force 40

on 40

no soportados, comandos 286

nombres de directorio, notación xviii

nombres de ruta, notación xviii

notaciónnombres de ruta xviii

tipo de letra xviii

variables de entorno xviii

Oobjeto de base de datos, editor 63

objetos de planificación 35

on, palabra clave 17, 116

onuntil 124

onuntil, palabra clave 124

opens, palabra clave 119

orden de objetos en el archivo de

seguridad 325

orden de usuarios en el archivo de

seguridad 325


Ppalabras clave

absolute 135, 141, 142, 147

deadline 98

palabras clave, lenguaje de

planificación 90

palabras reservadas 36

parms, comando 267

paxtract, comando 268

pedidos de publicaciones xvii

plazo límite (deadline) 17

priority, palabra clave 121

problemas, determinacióndescripción del problema para el

Servicio de soporte de software de

IBM 340

determinación del impacto comercial

para el Servicio de soporte de

software de IBM 339

sometimiento del problema al Servicio

de soporte de software de IBM 340

programa Composer 62

progressive 221

prompt, palabra clave 122

prxtract, comando 269

publicaciones xii

acceso en línea xvi

pedir xvii

ver publicaciones xvi

Rr11xtract, comando 270

rccondsucc 48, 108

recall, comando 178

redo, comando 179

release, comando 271

release job, comando 181

release sched, comando 183

renovación de los conectores 347

reply, comando 185

rerun, comando 186

resource, comando 189

rextract, comando 273

rmstdlist, comando 274

Ssalida de terminal 62, 128

salida fuera de línea 128

salida fuera de línea de UNIX 63

schedule, palabra clave 123

schedulr, comando 10

secuencia de trabajos finalagregación 16

personalización 15

seguridadarchivo de ejemplo 329

archivo de plantilla 318

centralizada 317

creación del archivo de

seguridad 318

definiciones de usuario 319

dumpsec 318

gestión 318

local 317

seguridad (continuación)makesec 318

orden de definiciones de usuario 325

orden de objetos 325

sintaxis del archivo 319

superusuario de UNIX 326

variables 326

seguridad centralizada 317

seguridad local 317

selección de secuencias de trabajos en

comandos 141

selección de trabajos en comandos 133

sentencia de trabajo, palabras clave 107

Servicio de soporte de softwarecómo ponerse en contacto 338

descripción del problema para el

Servicio de soporte de software de

IBM 340

determinación del impacto comercial

para el Servicio de soporte de

software de IBM 339

sometimiento del problema al Servicio

de soporte de software de IBM 340

setsym, comando 190

Sfinalagregación 16

showcpus, comando 191

showdomains, comando 195

showexec, comando 275

showfiles, comandos 196

showjobs, comando 198

showprompts, comando 208

showresources, comando 209

showschedules, comando 211

shutdown, comando 215

sintaxis, lenguaje de planificación 89

sintaxis de comandos, conman 129

sintaxis de comandos de conman 129

sintaxis del archivo de seguridad 319

sitio Web de soporte, búsqueda para


software 337

SSL, comunicaciónenabled 40

force 40

on 40

stageman, comando 10

start, comando 216

startup, comando 276

status, comando 218

stop, comando 219

stop ;progressive, comando 221

stop scheduler processes 18, 221

submit docommand 222

submit file, comando 224

submit job, comando 226

submit sched, comando 228

switchmgr, comando 230

Ttellop, comando 232

tipo_SO 37

Tivoli, entrenamiento técnico xvii

trabajo, estados 140

Uúltima hora de inicio 17

UNIX, superusuario de seguridad 326

unlink, comando 233

until, palabra clave 124

Vvariables, notación para xviii

variables de entorno, notación xviii

variables del archivo de seguridad 326

version, comando 235, 277

Wwmaeutil 319

wmaeutil, comando 32, 279, 347

writer 10

Xxrxtrct, comando 281

Zzonas muertas 341

Índice 363

��

Número de Programa: 5698-WSH

SC10-3852-02