Tivoli® IBM Tivoli Workload
Scheduler
Guía de consulta
Versión 8.2 (revisada en diciembre de 2004)
SC10-3852-02
���
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
huso horario habilitado cuando el gestor de
dominio maestro está atrasado respecto al
agente tolerante a errores . . . . . . . . 343
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. . . . . . . . . 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
Esta biblioteca contiene todas las publicaciones que se aplican únicamente
a IBM Tivoli Workload Scheduler for Applications.
Biblioteca de IBM Tivoli Workload Scheduler for Virtualized Data Centers
Esta biblioteca contiene todas las publicaciones que se aplican únicamente
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
||||
|
|||
|
||||
||
||
|
||
||
|||
|
||
|
|
|
|
|
||
|
||
|
||
|
|
|
||
|
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.
Para ver una presentación del producto, diríjase a
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.
Para ver una presentación del producto, diríjase a
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.
Para ver una presentación del producto, diríjase a
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
||
|
||
||
||||
||
||||
||
|||
|
||
|
||
||
||||
|
||
|
|||
|||
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).
Puede encontrar este manual técnico en el sitio Web de Redbooks, en la
dirección http://www.redbooks.ibm.com/abstracts/sg246352.html
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).
Puede encontrar este manual técnico en el sitio Web de Redbooks, en la
dirección http://www.redbooks.ibm.com/abstracts/sg246624.html
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
IBM Tivoli Workload Scheduler.
xvi IBM Tivoli Workload Scheduler - Guía de consulta
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
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
información adicional, consulte el apartado “Definiciones
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
información adicional, consulte el apartado “Definiciones
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.
4 IBM Tivoli Workload Scheduler - Guía de consulta
||||||||
|
|||||
|
|||||
|
|||||||||||
|
||||||||
|
|||||||
|
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
Capítulo 1. Arranque rápido 5
||||||||||
|
|||||||
|
||||||
||||||||||
|||||||||||
||
||||
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
6 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|||||||
|||||
||||
||||||
|||||
|||||
||||||
|||
|||||||
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 1. Arranque rápido 7
|||||
||||||||
||||||||
|||||||||
||||||||
|||||||||
8 IBM Tivoli Workload Scheduler - Guía de consulta
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:
© Copyright IBM Corp. 1999, 2004 9
||||||
|||||||||||
||||
|
||
|
|||||
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.
10 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|||
|||
|
|||
||
||
|||
||
|
|
|||
||
|
|
|||
||
||
||||||
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
12 IBM Tivoli Workload Scheduler - Guía de consulta
|
|||||
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:
Capítulo 2. El ciclo de producción 13
|
|||
Figura 2. Árbol de procesos en Windows
14 IBM Tivoli Workload Scheduler - Guía de consulta
|
||||
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.
Capítulo 2. El ciclo de producción 15
|||||||
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:
16 IBM Tivoli Workload Scheduler - Guía de consulta
||
|
|
|
|
|
||
|
||
|||
||
|
||
||||
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.
Capítulo 2. El ciclo de producción 17
|
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.
18 IBM Tivoli Workload Scheduler - Guía de consulta
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.
Capítulo 2. El ciclo de producción 19
|
|
||
||
|||
||
||||
||
||
||
||
|||
||
||
|||
||
|||
|||
||
||
|||
|
Tabla 3. Variables de jobmanrc
Nombre de variable Valor
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
20 IBM Tivoli Workload Scheduler - Guía de consulta
Tabla 3. Variables de jobmanrc (continuación)
Nombre de variable Valor
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.
Capítulo 2. El ciclo de producción 21
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.
22 IBM Tivoli Workload Scheduler - Guía de consulta
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 -
Capítulo 2. El ciclo de producción 23
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
24 IBM Tivoli Workload Scheduler - Guía de consulta
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
-u Mostrar la información sobre el uso del comando.
-v Mostrar la versión del comando.
-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
Capítulo 2. El ciclo de producción 25
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
26 IBM Tivoli Workload Scheduler - Guía de consulta
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
-v Mostrar la versión del comando.
-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.
Capítulo 2. El ciclo de producción 27
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
28 IBM Tivoli Workload Scheduler - Guía de consulta
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
Capítulo 2. El ciclo de producción 29
|||||||||
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
-u Mostrar la información sobre el uso del comando.
-v Mostrar la versión del comando.
-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.
30 IBM Tivoli Workload Scheduler - Guía de consulta
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.
Capítulo 2. El ciclo de producción 31
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
32 IBM Tivoli Workload Scheduler - Guía de consulta
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 2. El ciclo de producción 33
34 IBM Tivoli Workload Scheduler - Guía de consulta
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.
© Copyright IBM Corp. 1999, 2004 35
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
36 IBM Tivoli Workload Scheduler - Guía de consulta
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.
38 IBM Tivoli Workload Scheduler - Guía de consulta
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
Capítulo 3. Consulta de Composer 39
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
40 IBM Tivoli Workload Scheduler - Guía de consulta
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
Capítulo 3. Consulta de Composer 41
cpuname hdq-2
os wnt
tz pst
node opera.ibm.com
domain masterdm
for maestro type fta
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
for maestro type fta
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.
42 IBM Tivoli Workload Scheduler - Guía de consulta
|||
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
Especifica que se trate como un comentario lo que hay desde el signo
numérico hasta el final de la línea.
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
Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de una
clase de estación de trabajo″ en la publicación IBM Tivoli Workload Scheduler Job
Capítulo 3. Consulta de Composer 43
||
Scheduling Console - Guía del usuario.
44 IBM Tivoli Workload Scheduler - Guía de consulta
|
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.
description “texto”
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
Capítulo 3. Consulta de Composer 45
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.
46 IBM Tivoli Workload Scheduler - Guía de consulta
|||
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.
Capítulo 3. Consulta de Composer 47
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
definiciones de trabajos” en la página 52.
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.
description “texto”
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:
48 IBM Tivoli Workload Scheduler - Guía de consulta
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).
Por ejemplo, puede definir un trabajo satisfactorio como aquél que
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.
Capítulo 3. Consulta de Composer 49
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.
50 IBM Tivoli Workload Scheduler - Guía de consulta
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í,
repetir lo anterior. Si
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,
repetir lo anterior. Si
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
Capítulo 3. Consulta de Composer 51
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
Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de una
definición de trabajo″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling
Console - Guía del usuario.
52 IBM Tivoli Workload Scheduler - Guía de consulta
|||
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
Especifica que se trate como un comentario lo que hay desde el signo
numérico hasta el final de la línea.
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.
Capítulo 3. Consulta de Composer 53
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
54 IBM Tivoli Workload Scheduler - Guía de consulta
Véase también
Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de un
usuario de Windows″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling
Console - Guía del usuario.
Capítulo 3. Consulta de Composer 55
|||
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
Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de un
calendario″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console -
Guía del usuario.
56 IBM Tivoli Workload Scheduler - Guía de consulta
|||
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
Capítulo 3. Consulta de Composer 57
scriptname "/usr/gl^glpath^"
streamlogon "^gllogon^"
opens "^glpath^/datafile"
prompt ":^glpath^ started by ^gllogon^"
end
Véase también
Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de un
parámetro″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console -
Guía del usuario.
58 IBM Tivoli Workload Scheduler - Guía de consulta
|||
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.
Capítulo 3. Consulta de Composer 59
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
Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de una
solicitud″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling Console -
Guía del usuario.
60 IBM Tivoli Workload Scheduler - Guía de consulta
|||
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
Especifica el nombre de la estación de trabajo o clase de estación de trabajo
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
empezar por una letra.
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
Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de un
recurso distribuido″ en la publicación IBM Tivoli Workload Scheduler Job Scheduling
Console - Guía del usuario.
Capítulo 3. Consulta de Composer 61
|||
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.
62 IBM Tivoli Workload Scheduler - Guía de consulta
$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
archivo. Si el archivo no existe, se crea.
| 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
Dirige la salida a un proceso o comando del sistema. El 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
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.
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.
Capítulo 3. Consulta de Composer 63
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>%
#----------------------------------------------------------------------------
Sintaxis de los comandos
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
64 IBM Tivoli Workload Scheduler - Guía de consulta
|
Carácter Descripción
<< >> 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
Capítulo 3. Consulta de Composer 65
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.
66 IBM Tivoli Workload Scheduler - Guía de consulta
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.
Capítulo 3. Consulta de Composer 67
||
|
||
|
||
|
||
|
||||
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
68 IBM Tivoli Workload Scheduler - Guía de consulta
||||
|||
|
|
|
||
|
|
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=@"
Capítulo 3. Consulta de Composer 69
|||
|
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
El nombre de la estación de trabajo o clase de estación de trabajo
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.
70 IBM Tivoli Workload Scheduler - Guía de consulta
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
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.
Capítulo 3. Consulta de Composer 71
||
|||
|
||
|
||||
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} |
jobs=[esttrabajo#]nombtrabajo |
sched=[esttrabajo#]secuenciatrab |
users=[esttrabajo#]nombusuario
Argumentos
cpu Suprime estaciones de trabajo, clases de estación de trabajo o dominios.
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 Suprime trabajos.
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 Suprime secuencias de trabajos.
esttrabajo
El nombre de la estación de trabajo o clase de estación de trabajo
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 Suprime usuarios.
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.
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.
72 IBM Tivoli Workload Scheduler - Guía de consulta
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,
ejecute el comando siguiente:
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
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.
Capítulo 3. Consulta de Composer 73
|||
|
||
|
||
|
||||
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} |
jobs=[esttrabajo#]nombtrabajo |
sched=[esttrabajo#]secuenciatrab |
users=[esttrabajo#]nombusuario
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
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 Muestra un trabajo.
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 Muestra una secuencia de trabajos.
esttrabajo
El nombre de la estación de trabajo o clase de estación de trabajo
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.
74 IBM Tivoli Workload Scheduler - Guía de consulta
users Muestra un usuario. 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.
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.
Capítulo 3. Consulta de Composer 75
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.
Última actualización
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.
Última actualización
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
76 IBM Tivoli Workload Scheduler - Guía de consulta
||
|
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.
Capítulo 3. Consulta de Composer 77
||
|
||||
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
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.
78 IBM Tivoli Workload Scheduler - Guía de consulta
||
|
|
|
|||
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
Capítulo 3. Consulta de Composer 79
|||
|
|
|
|
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} |
jobs=[esttrabajo#]nombtrabajo |
sched=[esttrabajo#]secuenciatrab |
users=[esttrabajo#]nombusuario
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
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 Modifica un trabajo.
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 Modifica una secuencia de trabajos.
esttrabajo
El nombre de la estación de trabajo o clase de estación de trabajo
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 Modifica un usuario.
80 IBM Tivoli Workload Scheduler - Guía de consulta
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.
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
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.
Capítulo 3. Consulta de Composer 81
||
|
||
|
||||
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
82 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|||||
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:
Capítulo 3. Consulta de Composer 83
||
||||
|
redo
display site1#sa@
r2
display site2#sa@
84 IBM Tivoli Workload Scheduler - Guía de consulta
||||
|
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
Capítulo 3. Consulta de Composer 85
||
|
||
|
||
|
|
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
86 IBM Tivoli Workload Scheduler - Guía de consulta
||
|
|
|
|
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.
Capítulo 3. Consulta de Composer 87
|||
|
|
||
||
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
88 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
|
|
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]
© Copyright IBM Corp. 1999, 2004 89
[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
90 IBM Tivoli Workload Scheduler - Guía de consulta
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
secuencia de trabajos.
“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.
Capítulo 4. El lenguaje de planificación 91
Descripciones de palabras clave
En las siguientes página se describe la sintaxis de las palabras clave de lenguaje de
planificación.
92 IBM Tivoli Workload Scheduler - Guía de consulta
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.
Capítulo 4. El lenguaje de planificación 93
sfran#schedule sked8 on fr at 1000 + 1 day :
job1
job2 at 1400 tz est
nycity#job3 at 1600
end
94 IBM Tivoli Workload Scheduler - Guía de consulta
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
Capítulo 4. El lenguaje de planificación 95
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
96 IBM Tivoli Workload Scheduler - Guía de consulta
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
Capítulo 4. El lenguaje de planificación 97
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
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 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
98 IBM Tivoli Workload Scheduler - Guía de consulta
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 >>
Capítulo 4. El lenguaje de planificación 99
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
100 IBM Tivoli Workload Scheduler - Guía de consulta
|||||||||||
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
laborables son todos los días con excepción de sábados y domingos
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
Representa todos los días de la semana, a excepción de sábado y
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.
Capítulo 4. El lenguaje de planificación 101
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
En el siguiente ejemplo se selecciona la secuencia de trabajos testskd3 para que se
ejecute todos los días laborables excepto el 15 de mayo de 1999 y el 23 de mayo de
1999:
schedule testskd3 on weekdays
except 15/05/99,23/05/99
En el siguiente ejemplo se selecciona la secuencia de trabajos testskd4 para que se
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.
102 IBM Tivoli Workload Scheduler - Guía de consulta
schedule testskd2
on weekdays
except MONTHEND fdprev
Capítulo 4. El lenguaje de planificación 103
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.@
104 IBM Tivoli Workload Scheduler - Guía de consulta
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
Capítulo 4. El lenguaje de planificación 105
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
106 IBM Tivoli Workload Scheduler - Guía de consulta
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
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 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
definiciones de trabajos” en la página 110.
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 (″).
Capítulo 4. El lenguaje de planificación 107
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
108 IBM Tivoli Workload Scheduler - Guía de consulta
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.
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 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).
Por ejemplo, puede definir un trabajo satisfactorio como aquél que
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.
Capítulo 4. El lenguaje de planificación 109
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.
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.
110 IBM Tivoli Workload Scheduler - Guía de consulta
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
Capítulo 4. El lenguaje de planificación 111
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
112 IBM Tivoli Workload Scheduler - Guía de consulta
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
Capítulo 4. El lenguaje de planificación 113
limit
Limita el número de trabajos que se pueden ejecutar simultáneamente en una
secuencia de trabajos.
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 :
114 IBM Tivoli Workload Scheduler - Guía de consulta
needs
Define los recursos que deben estar disponibles antes de iniciar un trabajo o una
secuencia de trabajos.
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:
schedule sked3 on fr
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
Capítulo 4. El lenguaje de planificación 115
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
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
laborables son todos los días con excepción de sábados y domingos
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
Representa todos los días de la semana, a excepción de sábado y
116 IBM Tivoli Workload Scheduler - Guía de consulta
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
secuencia de trabajos.
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
En el siguiente ejemplo se selecciona la secuencia de trabajos sked3 para que se
ejecute el 15 de junio de 1999, y en las fechas indicadas en el calendario apdates:
schedule sked3 on 15/06/99,apdates
En el siguiente ejemplo se selecciona la secuencia de trabajos sked4 para que se
ejecute dos días de la semana antes de cada fecha que aparece en el calendario
monthend:
schedule sked4 on monthend -2 weekdays
Capítulo 4. El lenguaje de planificación 117
||||||
||
|
|
|
En el siguiente ejemplo se selecciona la secuencia de trabajos testskd1 para que se
ejecute todos los días excepto los miércoles:
schedule testskd1 on weekdays
except we
En el siguiente ejemplo se selecciona la secuencia de trabajos testskd3 para que se
ejecute todos los días excepto el 15 de mayo de 1999 y el 24 de mayo de 1999:
schedule testskd3 on weekdays
except 05/16/99,05/24/99
En el siguiente ejemplo se selecciona la secuencia de trabajos testskd4 para que se
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
118 IBM Tivoli Workload Scheduler - Guía de consulta
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"
Capítulo 4. El lenguaje de planificación 119
||
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.
120 IBM Tivoli Workload Scheduler - Guía de consulta
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
schedule sked2 on tu
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.
Capítulo 4. El lenguaje de planificación 121
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:
schedule sked5 on fr
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
122 IBM Tivoli Workload Scheduler - Guía de consulta
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:
schedule sked1 on tu
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
Capítulo 4. El lenguaje de planificación 123
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
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. 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
124 IBM Tivoli Workload Scheduler - Guía de consulta
|||||||
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 4. El lenguaje de planificación 125
|||||
|||
||||
||||
126 IBM Tivoli Workload Scheduler - Guía de consulta
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.
© Copyright IBM Corp. 1999, 2004 127
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
Especifica el número de caracteres por línea. El valor predeterminado es
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. Si el archivo no existe, se crea.
>> archivo
Redirige la salida a un archivo y añade la salida al final del
archivo. Si el archivo no existe, se crea.
128 IBM Tivoli Workload Scheduler - Guía de consulta
| 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
Dirige la salida a un proceso o comando del sistema. El 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
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.
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>%
#----------------------------------------------------------------------------
Sintaxis de los comandos
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.
? Sustituye un carácter alfanumérico.
% Sustituye un carácter numérico.
Delimitadores y caracteres especiales
Los siguientes caracteres tienen un especial significado en los comandos de
Conman:
Carácter Descripción
& 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
130 IBM Tivoli Workload Scheduler - Guía de consulta
|
Carácter Descripción
> 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
secuencia de trabajos.
M,F 163, 157
confirm Confirma la finalización de un
trabajo.
M,F 159
console Asigna la consola de IBM
Tivoli Workload Scheduler.
M,F,A 161
continue Ignora el siguiente error. M,F,A 162
deldep ddj | dds Suprime dependencias de
trabajos o secuencias 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
Capítulo 5. Consulta de Conman 131
Comando
Forma
abreviada Descripción Tipo1 Página
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 o secuencias 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
producción de IBM Tivoli
Workload Scheduler.
M,F,A 216
status Muestra el estado de
producción de IBM Tivoli
Workload Scheduler.
M,F,A 218
132 IBM Tivoli Workload Scheduler - Guía de consulta
Comando
Forma
abreviada Descripción Tipo1 Página
stop Detiene los procesos de
producción de IBM Tivoli
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,
trabajo o secuencia de trabajos.
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
Capítulo 5. Consulta de Conman 133
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.
timezone|tz nombrehusohorario
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.
134 IBM Tivoli Workload Scheduler - Guía de consulta
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.
hhmm[+n days | fecha] [timezone|tz nombrehusohorario]
hhmm La hora y los minutos.
+n days
Desplazamiento en días desde la hora límite planificada.
fecha La siguiente ocurrencia de hhmm en fecha, expresada como
dd/mm/aa.
timezone|tz 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
Capítulo 5. Consulta de Conman 135
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
Especifica el límite inferior de un rango de horas, expresado en el
mismo formato que hora. Se seleccionan trabajos que tienen plazos
límite planificados a esta 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 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]
hhmm La hora y los minutos.
fecha La siguiente ocurrencia de hhmm en fecha, expresada como
dd/mm/aa.
timezone|tz nombrehusohorario
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.
horamínima
Especifica el límite inferior de un rango de horas, expresado en el
mismo formato que hora. Se seleccionan trabajos que han finalizado
a esta 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 han finalizado
a esta hora o antes de la misma.
136 IBM Tivoli Workload Scheduler - Guía de consulta
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
Capítulo 5. Consulta de Conman 137
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]
Selecciona o excluye trabajos basándose en si tienen o no 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, 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.
138 IBM Tivoli Workload Scheduler - Guía de consulta
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]
Selecciona o excluye trabajos basándose en si tienen o no una dependencia
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:
hhmm [fecha] [timezone|tz nombrehusohorario]
hhmm La hora y los minutos.
fecha La siguiente ocurrencia de hhmm en fecha, expresada como
dd/mm/aa.
timezone|tz nombrehusohorario
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.
horamínima
Especifica el límite inferior de un rango de horas, expresado en el
mismo formato que hora. Se seleccionan trabajos que se han
iniciado a esta 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 se han
iniciado a esta hora o antes de la misma.
Capítulo 5. Consulta de Conman 139
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:
hhmm[+n days | fecha] [timezone|tz nombrehusohorario]
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.
140 IBM Tivoli Workload Scheduler - Guía de consulta
timezone|tz nombrehusohorario
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.
horamínima
Especifica el límite inferior de un rango de horas, expresado en el
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
Especifica el límite superior de un rango de horas, expresado en el
mismo formato que hora. Se seleccionan trabajos que tienen horas
de finalización 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 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.
Capítulo 5. Consulta de Conman 141
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:
hhmm[+n days | fecha] [timezone|tz nombrehusohorario]
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.
timezone|tz nombrehusohorario
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
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.
horamínima
Especifica el límite inferior de un rango de horas, expresado en el
142 IBM Tivoli Workload Scheduler - Guía de consulta
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
Especifica el límite superior de un rango de horas, expresado en el
mismo formato que hora. Se seleccionan secuencias de trabajos que
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:
hhmm [fecha] [timezone|tz nombrehusohorario]
hhmm La hora y los minutos.
fecha La siguiente ocurrencia de hhmm en fecha, expresada como
dd/mm/aa.
timezone|tz nombrehusohorario
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.
horamínima
Especifica el límite inferior de un rango de horas, expresado en el
mismo formato que hora. Se seleccionan secuencias de trabajos que
han finalizado a esta 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 secuencias de 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 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
Capítulo 5. Consulta de Conman 143
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
Especifica el nombre de la estación de trabajo en la que se ejecuta
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
caracteres comodí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, las secuencias de trabajos se seleccionan o
excluyen si tienen alguna dependencia follows.
limit[=límite | límiteinf, | ,límitesup | límiteinf,límitesup]
Selecciona o excluye secuencias de trabajos basándose en si tienen o no
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.
144 IBM Tivoli Workload Scheduler - Guía de consulta
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]
Selecciona o excluye secuencias de trabajos basándose en si tienen o no
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)]]
Selecciona o excluye secuencias de 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, 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.
Capítulo 5. Consulta de Conman 145
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]
Selecciona o excluye secuencias de trabajos basándose en si tienen o no
una dependencia 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, 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:
hhmm [fecha] [timezone|tz nombrehusohorario]
hhmm La hora y los minutos.
fecha La siguiente ocurrencia de hhmm en fecha, expresada como
dd/mm/aa.
timezone|tz nombrehusohorario
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.
horamínima
Especifica el límite inferior de un rango de horas, expresado en el
mismo formato que hora. Se seleccionan secuencias de trabajos que
se han iniciado a esta 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 secuencias de 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 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.
146 IBM Tivoli Workload Scheduler - Guía de consulta
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:
hhmm[+n days | fecha] [timezone|tz nombrehusohorario]
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.
timezone|tz nombrehusohorario
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.
horamínima
Especifica el límite inferior de un rango de horas, expresado en el
mismo formato que hora. Se seleccionan secuencias de trabajos que
tienen las horas de finalización 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 las secuencias de trabajos
que tienen horas de finalización 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.
Capítulo 5. Consulta de Conman 147
– 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 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.
Descripciones de comandos
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.
148 IBM Tivoli Workload Scheduler - Guía de consulta
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:
Capítulo 5. Consulta de Conman 149
|||
|||
|
||
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.
150 IBM Tivoli Workload Scheduler - Guía de consulta
||
|||||
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
permiten caracteres comodín.
at=hhmm[timezone | tz nombrehusohorario][+n days | mm/dd/aa] | [absolute
| abs]
carryforward
deadline= hora [timezone|tz nombrehusohorario][+nday[s | mm/dd/aa]
follows=[agentered::][esttrabajo#]secuenciatrab{.trabajo | @} | trabajo[,...]
limit=límite
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 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
Capítulo 5. Consulta de Conman 151
|||
|||
|
Para agregar una dependencia follows y un límite de trabajos a la secuencia de
trabajos sked4, ejecute el comando siguiente:
ads sked4;follows=sked3;limit=2
Véase también
Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de
dependencias en una secuencia de trabajos″ y ″Creación de dependencias entre
secuencias de trabajos″ en la publicación IBM Tivoli Workload Scheduler Job
Scheduling Console - Guía del usuario.
152 IBM Tivoli Workload Scheduler - Guía de consulta
||
|
|||||
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.
Capítulo 5. Consulta de Conman 153
|||
|
||
|||
||||
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.
selecciónsecuenciatrab
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,
ejecute el comando siguiente:
altpri glmonth.balance;55
Para cambiar la prioridad de todos los trabajos de la secuencia de trabajos mis5,
ejecute el comando siguiente:
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
154 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
||
|
||
|
|
cancel job
Cancela un trabajo.
Debe tener acceso cancel al trabajo.
Sinopsis
cj seleccióntrab[;pend][;noask]
Argumentos
seleccióntrab Consulte el apartado “Selección de trabajos en comandos” en la
página 133.
pend Sólo cancela el trabajo después de haber resuelto sus dependencias.
noask Especifica que no se debe solicitar confirmación antes de efectuar
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.
Capítulo 5. Consulta de Conman 155
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
trabajo site3, ejecute el comando siguiente:
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
Scheduler Job Scheduling Console - Guía del usuario.
156 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
||
|
||||
cancel sched
Cancela una secuencia de trabajos.
Debe tener acceso cancel a la secuencia de trabajos.
Sinopsis
cs selecciónsecuenciatrab[;pend][;noask]
Argumentos
selecciónsecuenciatrab
Consulte el apartado “Selección de secuencias de trabajos en
comandos” en la página 141.
pend Cancela la secuencia de trabajos sólo después de haber resuelto sus
dependencias.
noask Especifica que no se debe solicitar confirmación antes de efectuar
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.
Capítulo 5. Consulta de Conman 157
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
secuencias de trabajos″ en la publicación IBM Tivoli Workload Scheduler Job
Scheduling Console - Guía del usuario.
158 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
||
|
||||
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
seleccióntrab Consulte el apartado “Selección de trabajos en comandos” en la
página 133.
succ Confirma que el trabajo ha finalizado satisfactoriamente.
abend Confirma que el trabajo no ha finalizado satisfactoriamente.
noask Especifica que no se debe solicitar confirmación antes de efectuar
la acción en cada trabajo calificado.
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
Capítulo 5. Consulta de Conman 159
|||
|
Para emitir una confirmación abend para el número de trabajo 234, ejecute el
comando siguiente:
conf 234;abend
160 IBM Tivoli Workload Scheduler - Guía de consulta
||
|
|
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.
Capítulo 5. Consulta de Conman 161
|||
|
||
|
|
||
|
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"
162 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
deldep job
Suprime las dependencias de un trabajo.
Debe tener acceso deldep al trabajo.
Sinopsis
ddj 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 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]]
noask Especifica que no se debe solicitar confirmación antes de efectuar la acción
en cada trabajo calificado.
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
trabajos sked5, ejecute el comando siguiente:
deldep sked5.job3;needs=2 tapes
Para suprimir todas las dependencias follows del trabajo job4 de la secuencia de
trabajos sked3, ejecute el comando siguiente:
ddj sked3.job4;follows
Capítulo 5. Consulta de Conman 163
|||
|
||
|
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.
164 IBM Tivoli Workload Scheduler - Guía de consulta
||||
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
selecciónsecuenciatrab
Consulte el apartado “Selección de trabajos en comandos” en la página
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]
carryforward
deadline[=hora[timezone | tz nombrehusohorario][+n days | mm/dd/aa]]
follows[=[agentered::][esttrabajo#]secuenciatrab{.trabajo | @} | trabajo[,...]]
limit
needs[=[núm] [esttrabajo#]recurso[,...]]
opens[=[esttrabajo#]″nombarchivo″[(calificador)][,...]]
priority
prompt[=″[: | !]texto″ | nombsolicitud[,...]]
until[=hora [timezone|tz nombrehusohorario][+n day[s]] [ onuntil acción]]
noask Especifica que no se debe solicitar confirmación antes de efectuar la acción
en cada secuencia de trabajos calificada.
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 de la secuencia de trabajos sked5,
ejecute el comando siguiente:
deldep sked5;needs=2 tapes
Para suprimir todas las dependencias follows de la secuencia de trabajos sked3,
ejecute el comando siguiente:
dds sked3;follows
Capítulo 5. Consulta de Conman 165
|||
|
||
|
Véase también
Para la tarea equivalente de Job Scheduling Console, consulte ″Gestión de
secuencias de trabajos″ en la publicación IBM Tivoli Workload Scheduler Job
Scheduling Console - Guía del usuario.
166 IBM Tivoli Workload Scheduler - Guía de consulta
||||
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.
selecciónsecuenciatrab
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
apartado “Salida fuera de línea” en la página 128.
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
Scheduler Job Scheduling Console - Guía del usuario.
Capítulo 5. Consulta de Conman 167
||
|
||
|
||
|
||||
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
168 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
|
|
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.
noask Especifica que no se debe solicitar confirmación antes de efectuar
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
Capítulo 5. Consulta de Conman 169
|||
|
||
|
||
|
||
|
|||
Workload Scheduler Job Scheduling Console - Guía del usuario.
170 IBM Tivoli Workload Scheduler - Guía de consulta
|
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
Capítulo 5. Consulta de Conman 171
|||
|
|
|
||
|
|
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
seleccióntrab Consulte el apartado “Selección de trabajos en comandos” en la
página 133.
noask Especifica que no se debe solicitar confirmación antes de efectuar
la acción en cada trabajo calificado.
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
trabajo site3, ejecute el comando siguiente:
kill site3#apwkly.report
Para terminar el trabajo número 456, ejecute el comando siguiente:
k 456
172 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
|
|
|
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.
noask Especifica que no se debe solicitar confirmación antes de efectuar
la acción en cada estación de trabajo calificada.
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
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.
Capítulo 5. Consulta de Conman 173
|||
|
||
|
||
|
||||
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
selecciónsecuenciatrab
Consulte el apartado “Selección de secuencias de trabajos en
comandos” en la página 141.
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.
noask Especifica que no se debe solicitar confirmación antes de efectuar
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
secuencias de trabajos″ en la publicación IBM Tivoli Workload Scheduler Job
Scheduling Console - Guía del usuario.
174 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
||||
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
permiten caracteres comodín.
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.
Se permiten caracteres comodín.
noask Especifica que no se debe solicitar confirmación antes de efectuar
la acción en cada estación de trabajo calificada.
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.
Capítulo 5. Consulta de Conman 175
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
176 IBM Tivoli Workload Scheduler - Guía de consulta
listsym
Lista los archivos de registro del plan de producción (Symphony).
Debe tener acceso display al archivo Symphony.
Sinopsis
listsym [;offline]
Argumentos
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
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
Capítulo 5. Consulta de Conman 177
|||
|
||
|
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.
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
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
178 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
|
|
||
|
|||
|
|
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:
Capítulo 5. Consulta de Conman 179
||
||||
|
redo
setsym 4
5
setsym 5
180 IBM Tivoli Workload Scheduler - Guía de consulta
||||
|
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.
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]]
noask Especifica que no se debe solicitar confirmación antes de efectuar la acción
en cada trabajo calificado.
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
dependencias de todos los archivos que coinciden.
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
Capítulo 5. Consulta de Conman 181
|||
|
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
Scheduler Job Scheduling Console - Guía del usuario.
182 IBM Tivoli Workload Scheduler - Guía de consulta
||
|
||
|
||||
release sched
Libera secuencias de trabajos de dependencias.
Debe tener acceso release a la secuencia de trabajos.
Sinopsis
rs 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: Puede
utilizar caracteres comodín en esttrabajo, secuenciatrab, trabajo, recurso,
nombarchivo, y nombsolicitud.
at[=hora | horamínima | horamáxima | horamínima,horamáxima]
carryforward
deadline[=hora[timezone | tz nombrehusohorario][+n days | mm/dd/aa]]
follows[=[agentered::][esttrabajo#]secuenciatrab{.trabajo | @} | trabajo[,...]]
limit
needs[=[núm] [esttrabajo#]recurso[,...]]
opens[=[esttrabajo#]″nombarchivo″[(calificador)][,...]]
priority
prompt[=″[: | !]texto″ | nombsolicitud[,...]]
until[=hora [timezone|tz nombrehusohorario][+n day[s]] [ onuntil acción]]
noask Especifica que no se debe solicitar confirmación antes de efectuar la acción
en cada secuencia de trabajos calificada.
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.
En determinadas circunstancias, después de someter un comando deldep, dicho
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.
Capítulo 5. Consulta de Conman 183
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,
ejecute el comando siguiente:
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.
184 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
|||
|
||||
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.
noask Especifica que no se debe solicitar confirmación antes de efectuar
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
Capítulo 5. Consulta de Conman 185
||
|
||
|
|
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#
Especifica el nombre de la estación de trabajo en la que se ejecuta
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:
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.
timezone|tz nombrehusohorario
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.
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.
186 IBM Tivoli Workload Scheduler - Guía de consulta
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”.
noask Especifica que no se debe solicitar confirmación antes de efectuar la acción
en cada trabajo calificado.
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
publicación IBM Tivoli Workload Scheduler - Guía de planificación e instalación.
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
...
Capítulo 5. Consulta de Conman 187
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
Console - Guía del usuario.
188 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||||
|
||
|
||||
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
esttrabajo Especifica el nombre de la estación de trabajo en la que está
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.
noask Especifica que no se debe solicitar confirmación antes de efectuar
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
Console - Guía del usuario.
Capítulo 5. Consulta de Conman 189
|||
|
||
|
||||
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
190 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
|
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.
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
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
Capítulo 5. Consulta de Conman 191
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
Nombre de la estación de trabajo a la que se aplica esta información.
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
Nombre de la estación de trabajo a la que se aplica esta información.
192 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|||
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
FTA2 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
FTA7 360 WNT FTA 10 0 12/04/03 13:49 F I J DOMAIN2
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 está activa y por lo
menos existe una conexión secundaria que 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
FTA2 360 WNT FTA 10 0 12/04/03 13:48 FTI JW MASTERDM
FTA3 360 WNT MANAGER 10 0 12/04/03 13:48 FTI 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 L I DOMAIN1
SA1 360 WNT S-AGENT 10 0 12/04/03 13:48 F I J DOMAIN1
Capítulo 5. Consulta de Conman 193
||
|
||
|
||
|
|||
||||||||||||||
|||||||
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
FTA7 360 WNT FTA 10 0 12/04/03 13:49 F I J DOMAIN2
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 y todas las conexiones
secundarias están activas, 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
FTA2 360 WNT FTA 10 0 12/04/03 13:48 FTI JW MASTERDM
FTA3 360 WNT MANAGER 10 0 12/04/03 13:48 FTI 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 F I 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
FTA7 360 WNT FTA 10 0 12/04/03 13:49 F I J DOMAIN2
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.
194 IBM Tivoli Workload Scheduler - Guía de consulta
||||||
||||||||||
||||
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.
info Muestra información en formato info.
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
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
Para la tarea equivalente de Job Scheduling Console, consulte ″Visualización y
modificación de propiedades de dominio″ en la publicación IBM Tivoli Workload
Scheduler Job Scheduling Console - Guía del usuario.
Capítulo 5. Consulta de Conman 195
|||
|
||
|
||||
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
comillas (″) si contiene caracteres distintos de los siguientes:
alfanuméricos, guiones (-), barras inclinadas (/), barras inclinadas
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.
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
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
196 IBM Tivoli Workload Scheduler - Guía de consulta
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
Capítulo 5. Consulta de Conman 197
|||
|
||
|
|
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.
Se permiten caracteres comodín.
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.
keys Muestra una lista de una sola columna de los objetos seleccionados
por el comando.
info Muestra información en formato info.
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
para modificar la pantalla.
deps Muestra información en formato deps. Utilice keys, info o logon
para modificar la pantalla.
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.
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
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:
198 IBM Tivoli Workload Scheduler - Guía de consulta
CPU Estación de trabajo en la que se ejecuta el trabajo.
Planificación
El nombre de la secuencia de trabajos.
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.
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. (Agente ampliado)
Capítulo 5. Consulta de Conman 199
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).
error Sólo para dependencias inter-red, se ha producido un error
mientras se comprobaba el estado remoto.
exec La secuencia de trabajos se está ejecutando.
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
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 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.
200 IBM Tivoli Workload Scheduler - Guía de consulta
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:
CPU Estación de trabajo en la que se ejecuta el trabajo.
Planificación
El nombre de la secuencia de trabajos.
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.
Archivo de trabajo
El nombre del archivo ejecutable o del archivo script del trabajo. Puede
Capítulo 5. Consulta de Conman 201
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.
CPU Estación de trabajo en la que se ejecuta el trabajo.
Planificación
El nombre de la secuencia de trabajos.
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.
>> repeated as
La segunda ejecución y las ejecuciones subsiguientes de un trabajo
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:
CPU Estación de trabajo en la que se ejecuta el trabajo.
Planificación
El nombre de la secuencia de trabajos.
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.
202 IBM Tivoli Workload Scheduler - Guía de consulta
>> repeated as
La segunda ejecución y las ejecuciones subsiguientes de un trabajo
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.
Capítulo 5. Consulta de Conman 203
||||
|
|
|
|
||||
||
|||
|
||
|||
|
|
Formato deps;info: 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;info estándar. Las secuencias de trabajos se listan en
formato showschedules estándar.
Formato deps;logon: 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;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.
204 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
||
|
|||
|
|
||||||||||||||||
|
||
||
||
||
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)
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) 10/16/03 (#150) on MASTER. Batchman LIVES. Limit: 10, Fence:
0,
Audit Level: 1
sj workstation#daily_db_load.dbseload;keys;retcod
8$
Capítulo 5. Consulta de Conman 205
||||
||
||||||||||||||||||||||||||||||||||||
|||
|||||||||||||||
La función retcod, si se integra en un script, se puede convertir en totalmente
potente.
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.
206 IBM Tivoli Workload Scheduler - Guía de consulta
||
|||
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
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. 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.
info Muestra información en formato info.
logon Muestra información en formato logon.
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
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:
Estado
Estado de la solicitud.
Capítulo 5. Consulta de Conman 207
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
showschedules estándar.
Formato deps;keys: Se listan, uno en cada línea, trabajos y secuencias de trabajos
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
showschedules estándar.
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
showschedules estándar.
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,
ejecute el comando siguiente:
sp main#34
Véase también
Para la tarea equivalente de Job Scheduling Console, consulte ″Visualización y
modificación de propiedades de solicitud″ en la publicación IBM Tivoli Workload
Scheduler Job Scheduling Console - Guía del usuario.
208 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
||
|
||||
showresources
Muestra información sobre recursos.
Sinopsis
sr [[esttrabajo#]nombrerecurso][;keys][;offline]
sr [[esttrabajo#]nombrerecurso][;deps[;keys | info | logon]][;offline]
Argumentos
esttrabajo Especifica el nombre de la estación de trabajo en la que está
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.
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.
info Muestra información en formato info.
logon Muestra información en formato logon.
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
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:
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
secuencia de trabajos.
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.
Formato deps;keys: Se listan, uno en cada línea, trabajos y secuencias de trabajos
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
showschedules estándar.
Capítulo 5. Consulta de Conman 209
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
showschedules estándar.
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
Para la tarea equivalente de Job Scheduling Console, consulte ″Visualización y
modificación de propiedades de recurso″ en la publicación IBM Tivoli Workload
Scheduler Job Scheduling Console - Guía del usuario.
210 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
||||
showschedules
Muestra información sobre secuencias de trabajo.
Sinopsis
ss [selecciónsecuenciatrab][;keys][;offline]
ss [selecciónsecuenciatrab][;deps[;keys | info | logon]][;offline]
Argumentos
selecciónsecuenciatrab
Consulte el apartado “Selección de secuencias de trabajos en
comandos” en la página 141.
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.
info Muestra información en formato info.
logon Muestra información en formato logon.
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
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:
CPU Estación de trabajo en la que se ejecuta la secuencia de trabajos.
Planificación
El nombre de la secuencia de trabajos.
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).
error Sólo para dependencias inter-red, se ha producido un error
mientras se comprobaba el estado remoto.
exec La secuencia de trabajos se está ejecutando.
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
producido un error, se acaba de efectuar una acción de reejecución
Capítulo 5. Consulta de Conman 211
en el trabajo de la secuencia de trabajos externa o bien la secuencia
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 (<).
212 IBM Tivoli Workload Scheduler - Guía de consulta
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 showschedules estándar.
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 showschedules estándar.
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-5 READY 10 100 0
TWS820A #SCHED-6 READY 10 100 0
TWS820A #SCHED-7 SUCC 10 09/03 0:02 2 2
TWS820A #SCHED-8 READY 10 ( 0:01) 1 0
Capítulo 5. Consulta de Conman 213
||||
|
||
|
||
|
||
|
|
|||||||||
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
Scheduling Console - Guía del usuario.
214 IBM Tivoli Workload Scheduler - Guía de consulta
||||
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
Capítulo 5. Consulta de Conman 215
|||
||
|||
||
|
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
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 iniciar.
Se permiten caracteres comodín.
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.
noask Especifica que no se debe solicitar confirmación antes de efectuar
la acción en cada estación de trabajo calificada.
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.
216 IBM Tivoli Workload Scheduler - Guía de consulta
|
|||||||||||||
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
cualquier estación de trabajo de la red.
v Un usuario que ejecuta Conman en un gestor de dominio distinto del maestro
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.
DMn son gestores de dominio y Ann son agentes.
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
Capítulo 5. Consulta de Conman 217
status
Muestra el mensaje de cabecera de Conman y el estado de producción de IBM
Tivoli Workload Scheduler.
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
compatibilidad con versiones anteriores.
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)
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.
Schedule (Exp) 05/19/03 (#17) on DEMOCPU. Batchman down.
Limit: 30, Fence: 0, Audit Level: 1
218 IBM Tivoli Workload Scheduler - Guía de consulta
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
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 detener.
Se permiten caracteres comodín.
wait Especifica no aceptar otro comando hasta que se hayan detenido
todos los procesos.
noask Especifica que no se debe solicitar confirmación antes de efectuar
la acción en cada estación de trabajo calificada.
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
cualquier estación de trabajo de la red.
v Un usuario que ejecuta Conman en un gestor de dominio distinto del maestro
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.
Capítulo 5. Consulta de Conman 219
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.
DMn son gestores de dominio y Ann son agentes.
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
No se permite. No se permite.
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
220 IBM Tivoli Workload Scheduler - Guía de consulta
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
Capítulo 5. Consulta de Conman 221
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
222 IBM Tivoli Workload Scheduler - Guía de consulta
follows=[agentered::][esttrabajo#]secuenciatrab{.trabajo | @} |
trabajo[;nocheck][;wait=hora][,...]
interactive
logon=usuario
needs=[núm] [esttrabajo#]recurso[,...]
opens=[esttrabajo#]″nombarchivo″[(calificador)][,...] priority[=pri | hi | go]
prompt=″[: | !]texto″ | nombsolicitud[,...]
rccondsucc″Condición éxito″
recovery=stop | continue | rerun
after [esttrabajo#] nombtrabajo
abendprompt “texto”
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
Capítulo 5. Consulta de Conman 223
|||
|
|||
|
||
|
|
submit file
Somete un archivo 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
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:
[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 days | mm/dd/aa]
every=frecuencia
follows=[agentered::][esttrabajo#]secuenciatrab{.trabajo | @} | trabajo[,...]
interactive
logon=usuario
needs=[núm] [esttrabajo#]recurso[,...]
224 IBM Tivoli Workload Scheduler - Guía de consulta
opens=[esttrabajo#]″nombarchivo″[(calificador)][,...] priority[=pri | hi | go]
prompt=″[: | !]texto″ | nombsolicitud[,...]
rccondsucc″Condición éxito″
recovery=stop | continue | rerun
after [esttrabajo#] nombtrabajo
abendprompt “texto”
until hora [timezone|tz nombrehusohorario][+nday[s] | [absolute | abs]]
[onuntil acción]
noask Especifica que no se debe solicitar confirmación antes de efectuar la acción
en cada archivo calificado.
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 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
Capítulo 5. Consulta de Conman 225
|||
|
||
|
|
||
|
|
submit job
Somete un trabajo para que lo inicie el 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.
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:
[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 days | mm/dd/aa]
every=frecuencia
follows=[agentered::][esttrabajo#]secuenciatrab{.trabajo | @} |
trabajo[;nocheck][;wait=hora][,...]
needs=[núm] [esttrabajo#]recurso[,...]
226 IBM Tivoli Workload Scheduler - Guía de consulta
opens=[esttrabajo#]″nombarchivo″[(calificador)][,...] priority[=pri | hi | go]
prompt=″[: | !]texto″ | nombsolicitud[,...]
rccondsucc″Condición éxito″
recovery=stop | continue | rerun
after [esttrabajo#] nombtrabajo
abendprompt “texto”
until hora [timezone|tz nombrehusohorario][+nday[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 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 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.
Capítulo 5. Consulta de Conman 227
|||
|
||
|
||
|
||||
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:
at= hhmm [timezone|tz nombrehusohorario] [+n days | mm/dd/aa] |
[absolute | abs]
carryforward
deadline=hora[timezone | tz nombrehusohorario][+n days | mm/dd/aa]
follows=[agentered::][esttrabajo#]secuenciatrab{.trabajo | @} |
trabajo[;nocheck][;wait=hora][,...]
limit=límitetrabajos
needs=[núm] [esttrabajo#]recurso[,...]
opens=[esttrabajo#]″nombarchivo″[(calificador)][,...] priority[=pri | hi | go]
prompt=″[: | !]texto″ | nombsolicitud[,...]
until hora [timezone|tz nombrehusohorario][+nday[s] | [absolute | abs]]
[onuntil acción]
228 IBM Tivoli Workload Scheduler - Guía de consulta
noask Especifica que no se debe solicitar confirmación antes de efectuar la acción
en cada secuencia de trabajos trabajo calificada.
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 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.
Capítulo 5. Consulta de Conman 229
|||
|
||
|
||
|
||||
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
230 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
|
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
Capítulo 5. Consulta de Conman 231
||
|
|
|
|
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>//
232 IBM Tivoli Workload Scheduler - Guía de consulta
||
|
|
||||||
|
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
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
desvincular. Se permiten caracteres comodín.
noask Especifica que no se debe solicitar confirmación antes de efectuar
la acción en cada estación de trabajo calificada.
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.
v Un usuario que ejecuta Conman en un gestor de dominio distinto del maestro
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.
Capítulo 5. Consulta de Conman 233
DMn son gestores de dominio y Ann son agentes.
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
No se permite. No se permite.
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
234 IBM Tivoli Workload Scheduler - Guía de consulta
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,
ejecute el comando siguiente:
%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 5. Consulta de Conman 235
|||
|||
236 IBM Tivoli Workload Scheduler - Guía de consulta
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.
Descripciones de comandos
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.
© Copyright IBM Corp. 1999, 2004 237
Comando Descripción
xrxtrct Extrae información sobre referencias cruzadas.
wmaeutil Extrae información sobre referencias cruzadas.
238 IBM Tivoli Workload Scheduler - Guía de consulta
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.
240 IBM Tivoli Workload Scheduler - Guía de consulta
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>
Capítulo 6. Comandos de utilidad 241
|||
||||
||
||||
||
||||
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.
242 IBM Tivoli Workload Scheduler - Guía de consulta
|||
||
||||
||
|
|||
caxtract
Extrae información sobre calendarios de la base de datos del planificador.
Sinopsis
caxtract [-v | -u] [-o archivo]
Argumentos
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-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
Capítulo 6. Comandos de utilidad 243
|||
|
|
cpuinfo
Devuelve información sobre una definición de estación de trabajo.
Sinopsis
cpuinfo -v | -u
cpuinfo esttrabajo[tipoinfo] [...]
Argumentos
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
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.
244 IBM Tivoli Workload Scheduler - Guía de consulta
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,
ejecute el comando siguiente:
>cpuinfo oak os_type
UNIX
Para imprimir el nodo y el puerto (node y port) de la estación de trabajo oak,
ejecute el comando siguiente:
>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
Capítulo 6. Comandos de utilidad 245
||
|||||||||
||
||
||
|||
||
||||||||||||||
|
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
fecha-base
Especifique una de las siguientes opciones:
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.
246 IBM Tivoli Workload Scheduler - Guía de consulta
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;
Capítulo 6. Comandos de utilidad 247
{[+ | > | - | < 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.
248 IBM Tivoli Workload Scheduler - Guía de consulta
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,
ejecute el comando siguiente:
>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
Capítulo 6. Comandos de utilidad 249
||
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-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
250 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
|
||
|
Si el directorio ya existe, se visualiza una solicitud.
Capítulo 6. Comandos de utilidad 251
|
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
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.
252 IBM Tivoli Workload Scheduler - Guía de consulta
||
|
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-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)
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.
AWS11140703 Queue size current 880, maximum 10000000 bytes
(read 48, write 928)
Capítulo 6. Comandos de utilidad 253
|||
|
||
|
|
|
|
|||||||||
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
254 IBM Tivoli Workload Scheduler - Guía de consulta
|||||||||
jbxtract
Extrae información sobre trabajos de la base de datos del planificador.
Sinopsis
jbxtract [-v | -u] [-j trabajo] [-c esttrabajo] [-o archivo]
Argumentos
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-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
Especifica el archivo de salida. El valor predeterminado es stdout.
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
tabuladores. Los campos se describen en la tabla siguiente.
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
Capítulo 6. Comandos de utilidad 255
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
256 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
|
jobinfo
Se utiliza en un script de trabajo para devolver información sobre el trabajo.
Sinopsis
jobinfo -v | -u
jobinfo opción-trabajo [...]
Argumentos
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
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.
Capítulo 6. Comandos de utilidad 257
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
258 IBM Tivoli Workload Scheduler - Guía de consulta
||
|
|||
||||
|||||||
|||
||
|||||
|
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-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
Capítulo 6. Comandos de utilidad 259
|
||||
||
||
|
||
||
||||
||
||
|||
||
|||
|||
||||
|||
|
||
|
||
|
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,
ejecute el comando siguiente:
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`
260 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
||
|
||
||
|
maestro
Devuelve el nombre de la ruta del directorio inicial del planificador, al que se hace
referencia como TWShome.
Sinopsis
maestro [-v | -u]
Argumentos
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
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`
Capítulo 6. Comandos de utilidad 261
||
||
|
|
|
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-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
2 Formato de 4-5-4 semanas
3 Formato de 5-4-4 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.
262 IBM Tivoli Workload Scheduler - Guía de consulta
-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,
ejecute el comando siguiente:
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
Capítulo 6. Comandos de utilidad 263
|||
|
||
|
|
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
IBM Tivoli Workload Scheduler.
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.
264 IBM Tivoli Workload Scheduler - Guía de consulta
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-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:
Capítulo 6. Comandos de utilidad 265
|||
|
||
|
||
|
||
|
||
morestdl 455 | lp -p 6
266 IBM Tivoli Workload Scheduler - Guía de consulta
|
|
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
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>
Capítulo 6. Comandos de utilidad 267
||
|
|
|
||
|
|
||||||
|
paxtract
Extrae información sobre parámetros de la base de datos del planificador.
Sinopsis
paxtract [-v | -u] [-o archivo]
Argumentos
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-o archivo
Especifica el archivo de salida. El valor predeterminado es stdout.
Salida del comando
Cada registro de parámetro 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 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
268 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
|
prxtract
Extrae información sobre solicitudes de la base de datos del planificador.
Sinopsis
prxtract [-v | -u] [-o archivo]
Argumentos
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-o archivo
Especifica el archivo de salida. El valor predeterminado es stdout.
Salida del comando
Cada registro de solicitud 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 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
Capítulo 6. Comandos de utilidad 269
|||
|
|
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-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
Especifica el archivo de salida. El valor predeterminado es stdout.
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 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)
1 nombre de estación de trabajo 16
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
270 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
|||
|
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-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.
Capítulo 6. Comandos de utilidad 271
|
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
...
272 IBM Tivoli Workload Scheduler - Guía de consulta
rextract
Extrae información sobre recursos de la base de datos del planificador.
Sinopsis
rextract [-v | -u] [-o archivo]
Argumentos
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-o archivo
Especifica el archivo de salida. El valor predeterminado es stdout.
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
Capítulo 6. Comandos de utilidad 273
|||
|
|
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-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
274 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
|
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
-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:
CPU Estación de trabajo en la que se ejecuta el trabajo.
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:
CPU Estación de trabajo en la que se ejecuta el trabajo.
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
Capítulo 6. Comandos de utilidad 275
|||
|
||
|
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
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
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
276 IBM Tivoli Workload Scheduler - Guía de consulta
|
||
|
|
|
|
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.
-u Muestra información sobre el uso 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.
Capítulo 6. Comandos de utilidad 277
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
278 IBM Tivoli Workload Scheduler - Guía de consulta
||
|
|
||
||
||
|
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
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 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,
Capítulo 6. Comandos de utilidad 279
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,
ejecute el comando siguiente:
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 *
280 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|
||
|
||
|
|
xrxtrct
Extrae información sobre referencias cruzadas de la base de datos del planificador.
Sinopsis
xrxtrct [-v | -u]
Argumentos
-v Muestra la versión del comando.
-u Muestra información sobre el uso del comando.
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+.
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
2 nombre de estación de trabajo 16
3 nombre de trabajo 40
4 nombre de secuencia de trabajos 16
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.
Campo Descripción Longitud (bytes)
1 08 2
Capítulo 6. Comandos de utilidad 281
Campo Descripción Longitud (bytes)
2 nombre de estación de trabajo 16
3 nombre de trabajo 120
4 no se utiliza 128
5 nombre de estación de trabajo de secuencia de trabajos
dependiente
16
6 nombre de secuencia de trabajos dependiente 16
7 nombre de estación de trabajo dependiente 16
8 nombre de trabajo dependiente 40
9 no se utiliza 6
10 no se utiliza 6
11 no se utiliza 8
12 fin de registro (nulo) 1
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.
Campo Descripción Longitud (bytes)
1 02 2
2 nombre de estación de trabajo 16
3 nombre de secuencia de trabajos 16
4 no se utiliza 248
5 nombre de estación de trabajo de secuencia de trabajos
dependiente
16
6 nombre de secuencia de trabajos 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
12 fin de registro (nulo) 1
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.
Campo Descripción Longitud (bytes)
1 07 2
2 nombre de estación de trabajo 16
3 nombre de archivo 256
4 nombre de estación de trabajo de secuencia de trabajos
dependiente
16
5 nombre de secuencia de trabajos dependiente 16
282 IBM Tivoli Workload Scheduler - Guía de consulta
Campo Descripción Longitud (bytes)
6 nombre de estación de trabajo dependiente 16
7 nombre de trabajo dependiente 40
8 no se utiliza 6
9 no se utiliza 6
10 no se utiliza 8
11 fin de registro (nulo) 1
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.
Campo Descripción Longitud (bytes)
1 04 2
2 nombre de estación de trabajo 16
3 nombre de trabajo 40
4 no se utiliza 248
5 nombre de estación de trabajo de secuencia de trabajos 16
6 nombre 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
12 fin de registro (nulo) 1
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.
Campo Descripción Longitud (bytes)
1 05 2
2 nombre de estación de trabajo 16
3 texto o nombre de solicitud 20
4 no se utiliza 236
5 nombre de estación de trabajo de secuencia de trabajos
dependiente
16
6 nombre de secuencia de trabajos dependiente 16
7 nombre de estación de trabajo dependiente 16
8 nombre de trabajo dependiente 40
9 no se utiliza 6
10 no se utiliza 6
11 no se utiliza 8
Capítulo 6. Comandos de utilidad 283
Campo Descripción Longitud (bytes)
12 fin de registro (nulo) 1
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
describen en la tabla siguiente.
Campo Descripción Longitud (bytes)
1 06 2
2 nombre de estación de trabajo 16
3 nombre del recurso 8
4 no se utiliza 248
5 nombre de estación de trabajo de secuencia de trabajos
dependiente
16
6 nombre de secuencia de trabajos dependiente 16
7 nombre de estación de trabajo dependiente 16
8 nombre de trabajo dependiente 40
9 unidades asignadas 6
10 no se utiliza 6
11 no se utiliza 8
12 fin de registro (nulo) 1
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.
Campo Descripción Longitud (bytes)
1 00 2
2 nombre de estación de trabajo 16
3 nombre de secuencia de trabajos 16
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
12 fin de registro (nulo) 1
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
describen en la tabla siguiente.
284 IBM Tivoli Workload Scheduler - Guía de consulta
Campo Descripción Longitud (bytes)
1 01 2
2 nombre de estación de trabajo 16
3 Nombre o fecha de ON/EXCEPT 8
4 distintivo de excepción (*=EXCEPT) 1
5 no se utiliza 247
6 nombre de estación de trabajo 16
7 nombre de secuencia de trabajos 16
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
13 fin de registro (nulo) 1
Ejemplos
Para extraer información sobre todas las referencias cruzadas, ejecute el comando
siguiente:
xrxtrct
Capítulo 6. Comandos de utilidad 285
|||
|
|
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.
286 IBM Tivoli Workload Scheduler - Guía de consulta
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.
© Copyright IBM Corp. 1999, 2004 287
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
publicación IBM Tivoli Workload Scheduler - Guía de planificación e instalación.
288 IBM Tivoli Workload Scheduler - Guía de consulta
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
Capítulo 7. Los comandos de informe 289
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
-u Mostrar la versión del comando.
-v Mostrar la información sobre el uso del comando.
-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
290 IBM Tivoli Workload Scheduler - Guía de consulta
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
-u Mostrar la versión del comando.
-v Mostrar la información sobre el uso del comando.
-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
Capítulo 7. Los comandos de informe 291
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
-u Mostrar la versión del comando.
-v Mostrar la información sobre el uso del comando.
-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
292 IBM Tivoli Workload Scheduler - Guía de consulta
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
-u Mostrar la versión del comando.
-v Mostrar la información sobre el uso del comando.
-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
Capítulo 7. Los comandos de informe 293
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.
294 IBM Tivoli Workload Scheduler - Guía de consulta
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
Especifica imprimir un informe que muestre los trabajos y secuencias de
trabajos que dependen de cada solicitud.
-resource
Especifica imprimir un informe que muestre los trabajos y secuencias de
trabajos que dependen de cada recurso.
-schedules
Especifica imprimir un informe que muestre los trabajos y secuencias de
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
Capítulo 7. Los comandos de informe 295
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:
TWS para UNIX (SOLARIS)/INFORME3 8.2 (1.7) IBM
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
296 IBM Tivoli Workload Scheduler - Guía de consulta
|
|
||||||||||||||||||||
|
||||||||||||||
|
|||||||||
|
|||||||||
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:
TWS para UNIX (SOLARIS)/INFORME8 8.2 (1.7) IBM
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
Capítulo 7. Los comandos de informe 297
||||
|
||||||||||||||||
|
||||||||||||||||||
|
|||||||||||||||
|
|||
(C) Copyright IBM Corp 1998,2003
US Government User Restricted Rights
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
ACCR01 #ACCJOB02 ACCR01 .ACCJOB03
ACCR01 #ACCJOB03 ACCR01 .ACCJOB04
ACCW01 #ACCJOB03 ACCW01 .ACCJOB01
ACCW01 #ACCJOB04 ACCW01 .ACCJOB02
ACCR01 #ACCJOB05 ACCR01 .ACCJOB06
ACCW02 #ACCJOB11 ACCW02 .ACCJOB12
ACCW02 #ACCJOB12 ACCW02 .ACCJOB13
ACCW02 #ACCJOB14 ACCW02 .ACCJOB15
298 IBM Tivoli Workload Scheduler - Guía de consulta
||||||||||||||||||||
|
||||||||||||||||
|
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
© Copyright IBM Corp. 1999, 2004 299
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.
300 IBM Tivoli Workload Scheduler - Guía de consulta
-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].
302 IBM Tivoli Workload Scheduler - Guía de consulta
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.
Capítulo 8. Consulta del agente ampliado 303
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.
304 IBM Tivoli Workload Scheduler - Guía de consulta
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.
Tarea Respuesta del método Acción de IBM Tivoli Workload Scheduler
CF Código de salida=0 Establecer estado de archivo en YES.
Código salida=no cero Establecer estado de archivo en NO.
%UT [mensajeerror] y código
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.
Capítulo 8. Consulta del agente ampliado 305
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.
Tarea Respuesta del método Acción de IBM Tivoli Workload Scheduler
GS %CJ estado [idtrabajo] Establece el estado del trabajo en el estado
indicado e incluye el idtrabajo en todas las
tareas GS subsiguientes.
%UT [mensajeerror] y código
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.
306 IBM Tivoli Workload Scheduler - Guía de consulta
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 8. Consulta del agente ampliado 307
308 IBM Tivoli Workload Scheduler - Guía de consulta
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.
© Copyright IBM Corp. 1999, 2004 309
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
empezar por una letra.
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.
310 IBM Tivoli Workload Scheduler - Guía de consulta
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.
312 IBM Tivoli Workload Scheduler - Guía de consulta
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
Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de
secuencias de trabajos″ en la publicación IBM Tivoli Workload Scheduler Job
Scheduling Console - Guía del usuario.
Capítulo 9. Consulta del Agente de red 313
|||
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.
314 IBM Tivoli Workload Scheduler - Guía de consulta
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
caracteres comodín.
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
Capítulo 9. Consulta del Agente de red 315
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
Para la tarea equivalente de Job Scheduling Console, consulte ″Creación de
secuencias de trabajos″ en la publicación IBM Tivoli Workload Scheduler Job
Scheduling Console - Guía del usuario.
316 IBM Tivoli Workload Scheduler - Guía de consulta
|||
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
© Copyright IBM Corp. 1999, 2004 317
|
|
|
||||
||
||
|||||
||
||||
||||||||
|||
|||||||||
|||
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.
318 IBM Tivoli Workload Scheduler - Guía de consulta
||||
|||||||
|||||
||
|||||||
||||
|
||||||
|
|
||
||
||
||
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
Tivoli Workload Scheduler.
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:
320 IBM Tivoli Workload Scheduler - Guía de consulta
||||
||||
|
||||
||
|||||
|||
|||
||||
||||
||
|||
|||||
||||
||
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[...]]
Capítulo 10. Establecimiento de definiciones de seguridad del usuario 321
|||||
||||||
||||
||||||||||||||||||||||
||
||
||
|||||
|||||
|||||
|||||
|||||
|||||
|||||
|||||
|||||
|||||
||||||||||
|
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
322 IBM Tivoli Workload Scheduler - Guía de consulta
|||
||||||||||||||||||||||||||||
||||||||
|||||
|||||||
|||||||
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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
Capítulo 10. Establecimiento de definiciones de seguridad del usuario 323
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
||
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||
||
|||
|||
||||||
|||
|||||||
|||||
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á
disponible en estaciones de trabajo
conectadas a IBM Tivoli Workload
Scheduler for z/OS para una planificación
de extremo a extremo.
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á
disponible en estaciones de trabajo
conectadas a IBM Tivoli Workload
Scheduler for z/OS para una planificación
de extremo a extremo.
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á
disponible en estaciones de trabajo
conectadas a IBM Tivoli Workload
Scheduler for z/OS para una planificación
de extremo a extremo.
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
324 IBM Tivoli Workload Scheduler - Guía de consulta
||
||||||
|||||||
|||
|||||||
||
||
|||
||
|||
||
|||||
||
|||||||
|||
||||||
||
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
Capítulo 10. Establecimiento de definiciones de seguridad del usuario 325
||
|||
|||
||||||
||
|||
|||||||
|
||||||
||||||
|
||||||
||||||
||
|||
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 un carácter alfanumérico.
% Sustituye un carácter numérico.
@ 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
326 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|||
|||
||
|||
||
||
||
||
||
||
|||
|||
||||
|||
||
||
||
|||||
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
display composer display, create
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
Capítulo 10. Establecimiento de definiciones de seguridad del usuario 327
|||||||
||||
||||
|||
||
||
||
|||
||||
||
||
||
||
||
||
||
||
||
||
||
||
|||
||
||
||||
Tipo de objeto Palabra clave de acceso Posibilidad de usuario de la CLI
job add composer add, new
adddep conman adddep
altpri conman altpri
cancel conman cancel
confirm conman confirm
deldep conman deldep
delete composer delete
display conman display composer display
list conman showjobs
kill conman kill
modify composer modify, replace
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
modify n/d (véase modificación de archivo)
reply conman reply
use composer - utilizar solicitud en secuencia
de trabajos, y conman - añadir
dependencias
resource add n/d
delete n/d
display composer display, create
list conman showresources
modify n/d (véase modificación de archivo)
resource conman resource
use composer - utilizar recurso en secuencia
de trabajos, y conman - añadir
dependencias
328 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|||
||
||
||
||
||
||
||
||
||
||
||
||
||
||
|||
|||
||
|||
|||
|||
||
||
||
||
||
||||
|||
||
||
||
||
||
||||
Tipo de objeto Palabra clave de acceso Posibilidad de usuario de la CLI
schedule add composer add, new
adddep conman adddep
altpri conman altpri
cancel conman cancel
deldep conman deldep
delete composer delete
display composer display, create conman display
list conman showschedules
limit conman limit
modify composer modify, replace
release conman release
reply conman reply
submit conman submit sched
userjob add composer add, new
delete composer delete
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
###########################################################
# (2) SE APLICA A USUARIOS MAESTRO O ROOT REGISTRADOS EN
Capítulo 10. Establecimiento de definiciones de seguridad del usuario 329
|||
|||
||
||
||
||
||
||
||
||
||
||
||
||
|||
||
|||
||
|||
||
||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|||
# CUALQUIER ESTACION DE TRABAJO DISTINTA DEL GESTOR DE
# DOMINIO MAESTRO.
user sm logon=maestro,root
begin
# OBJETO ATRIBUTOS POSIBILIDADES ACCESO
# ---------- ------------ ----------------------
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
# OBJETO ATRIBUTOS POSIBILIDADES ACCESO
# ---------- ------------ ----------------------
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=$thiscpu access=@
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=@
parameter name=@ ~ name=r@ 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
# OBJETO ATRIBUTOS POSIBILIDADES ACCESO
# ---------- ------------ ----------------------
job cpu=$thiscpu
+ logon=$user access=@
job cpu=$thiscpu
+ logon=root access=adddep,altpri,cancel,
confirm,deldep,release,
reply,rerun,submit,use
job cpu=$thiscpu
~ logon=root access=adddep,altpri,cancel,
confirm,deldep,release,
reply,rerun,submit,use
schedule cpu=$thiscpu access=@
resource access=add,display,resource,use
330 IBM Tivoli Workload Scheduler - Guía de consulta
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
prompt access=add,display,reply,use
file access=build
calendar access=use
cpu cpu=$thiscpu access=console,fence,limit,
link,start,stop,unlink
parameter name=@ ~ name=r@ access=@
end
###########################################################
# (5) SE APLICA A USUARIOS REGISTRADOS EN EL GRUPO MIS
# EN CUALQUIER ESTACIÓN DE TRABAJO O FRAMEWORK.
user misusers group=mis
begin
# OBJETO ATRIBUTOS POSIBILIDADES ACCESO
# ---------- ------------ ----------------------
job cpu=$thiscpu
+ logon=$user access=@
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
# OBJETO ATRIBUTOS POSIBILIDADES ACCESO
# ---------- ------------ ----------------------
job cpu=$thiscpu
+ logon=$user access=@
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.
Capítulo 10. Establecimiento de definiciones de seguridad del usuario 331
||||||||||||||||||||||||||||||||||||||||||||
||||
|||
||||||
# (2) SE APLICA A USUARIOS MAESTRO O ROOT REGISTRADOS EN
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.
332 IBM Tivoli Workload Scheduler - Guía de consulta
|||
|||||||
|||
|||||
||
||
||||
|||
||||||
|||
||||||
||
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.
Capítulo 10. Establecimiento de definiciones de seguridad del usuario 333
|
|||||
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
334 IBM Tivoli Workload Scheduler - Guía de consulta
||
|
|
|
|
|
|
||||
|
||
||
||
|
|
|
|
|
||
|
||
|
|
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
Capítulo 10. Establecimiento de definiciones de seguridad del usuario 335
||
|||
||
||
||||
||
|
|
|
|
|||
|
||
||
|||||
||||
|
|
|
||||
||
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*
336 IBM Tivoli Workload Scheduler - Guía de consulta
|||
||
||
|
|
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,
© Copyright IBM Corp. 1999, 2004 337
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
338 IBM Tivoli Workload Scheduler - Guía de consulta
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
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.
340 IBM Tivoli Workload Scheduler - Guía de consulta
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
© Copyright IBM Corp. 1999, 2004 341
|
||||
|
|
||||||||||
||||
|||||
||
||
|||
|||
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
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 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.
342 IBM Tivoli Workload Scheduler - Guía de consulta
||
||
|
|
|
||||||||
|||||||||
||
|
|
|
|||||||
||||||||
|||
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
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 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
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 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
On SU, weekdays except FR
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.
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 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
horario. Para ejecutar la secuencia de trabajos cada día de la semana por la
mañana, especifique la sentencia de definición de secuencia de trabajos siguiente:
Schedule FTA1#EST_SCHEDULE2
On SU, weekdays except FR
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.
344 IBM Tivoli Workload Scheduler - Guía de consulta
||||||
||
|
||||
||
||
||||
|
|
|
||||||
|||||||
|||||||||||||
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
||
||
||||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||
|||||
346 IBM Tivoli Workload Scheduler - Guía de consulta
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.
© Copyright IBM Corp. 1999, 2004 347
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
348 IBM Tivoli Workload Scheduler - Guía de consulta
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
Apéndice C. La función de auditoría 349
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
350 IBM Tivoli Workload Scheduler - Guía de consulta
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.
Apéndice C. La función de auditoría 351
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|
352 IBM Tivoli Workload Scheduler - Guía de consulta
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.
© Copyright IBM Corp. 1999, 2004 353
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.
354 IBM Tivoli Workload Scheduler - Guía de consulta
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 un carácter alfanumérico.
% Sustituye un carácter numérico.
* 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
© Copyright IBM Corp. 1999, 2004 355
| |
| |
| |
| | |
| | |
| | | | | |
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
356 IBM Tivoli Workload Scheduler - Guía de consulta
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
trabajo o secuencia de trabajos.
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,
358 IBM Tivoli Workload Scheduler - Guía de consulta
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
360 IBM Tivoli Workload Scheduler - Guía de consulta
Í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
encontrar la resolución de problemas de
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
© Copyright IBM Corp. 1999, 2004 361
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
362 IBM Tivoli Workload Scheduler - Guía de consulta
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
encontrar la resolución de problemas de
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
364 IBM Tivoli Workload Scheduler - Guía de consulta
���
Número de Programa: 5698-WSH
SC10-3852-02