Awsrgmst

Workload Scheduler
Verso 8.6
Guia do Usurio e Referncia
S517-7781-11
Workload Scheduler
Verso 8.6
S517-7781-11
Comunicado
Antes de utilizar estas informaes e o produto suportado por elas, leia as informaes em Notas.
Esta edio se aplica verso 8, release 6 do IBM Tivoli Workload Scheduler (nmero de programa 5698-WSH) e a
todos os releases e modificaes subsequentes at indicado o contrrio em novas edies.
Esta edio substitui a SC32127410.
Copyright IBM Corporation 1999, 2011.
ndice
Figuras . . . . . . . . . . . . . . vii
Tabelas . . . . . . . . . . . . . . . ix
Sobre esta publicao . . . . . . . . xi
O que H de Novo Nesse Release?. . . . . .
O Que H de Novo nesta Publicao . . . . .
Publicaes . . . . . . . . . . . . .
Acessibilidade . . . . . . . . . . . .
Treinamento Tcnico Tivoli . . . . . . . .
Informaes sobre suporte . . . . . . . .
Convenes Utilizadas Nesta Publicao . . .
Convenes de Fontes . . . . . . . .
variveis e caminhos dependentes do sistema
operacional . . . . . . . . . . . .
Sintaxe do Comando . . . . . . . . .
. xi
. xi
. xii
. xii
. xii
. xii
. xiii
. xiii
. xiii
. xiv
Captulo 1. Viso Geral do Tivoli

Workload Scheduler . . . . . . . . . 1
Entendendo Conceitos Bsicos . . . . . . . . 1
Objetos de Banco de Dados do Tivoli Workload
Scheduler . . . . . . . . . . . . . . 1
A Rede do Tivoli Workload Scheduler . . . . 13
Configurando seu Ambiente de Tempo de
Execuo do Tivoli Workload Scheduler . . . . 14
Definindo Atividades de Planejamento Utilizando
Tivoli Workload Scheduler . . . . . . . . 15
Controlando a Tarefa e o Processamento do Fluxo
de Tarefas . . . . . . . . . . . . . . 15
Gerenciando Atividades de Planejamento de
Produo com o Tivoli Workload Scheduler . . 19
Automatizando a Carga de Trabalho Utilizando
Regras de Eventos . . . . . . . . . . . 19
Interfaces com o Usurio do Tivoli Workload
Scheduler . . . . . . . . . . . . . . . 20
Iniciando a Produo . . . . . . . . . . . 21
Captulo 2. Entendendo Processos

Bsicos da Estao de Trabalho. . . . 25
Processos da Estao de Trabalho do Tivoli

Workload Scheduler . . . . . . . . . .
Iniciando e Parando Processos em uma Estao de
Trabalho . . . . . . . . . . . . . .
Iniciando e parando o agente dinmico . . .
Comunicao Interprocesso de Estao de Trabalho
Comunicao da Rede do Tivoli Workload
Scheduler . . . . . . . . . . . . . .
Suporte para o Protocolo da Internet Verso 6 .
. 25
. 31
. 33
33
. 34
. 36
Captulo 3. Configurando o Ambiente

de Tarefa . . . . . . . . . . . . . . 39
Viso Geral do Ambiente de Tarefa . . . . .
Variveis de Ambiente Exportadas por jobman .
Customizando Formatao de Dados no stdlist
Copyright IBM Corp. 1999, 2011
. 39
. 40
42
|
|
|
|
|
Customizando o Processamento da Tarefa em uma

Estao de Trabalho UNIX - jobmanrc . . . . .
Customizando a Seo MAIL_ON_ABEND de
jobmanrc . . . . . . . . . . . . . .
Customizando o Processamento de Tarefas para um
Usurio nas Estaes de Trabalho UNIX - .jobmanrc .
Customizando o Processamento de Tarefa em uma
Estao de Trabalho Windows - jobmanrc.cmd. . .
Customizando a Seo MAIL_ON_ABEND de
jobmanrc.cmd . . . . . . . . . . . .
Customizando Processamento de Tarefa em uma
Estao de Trabalho com o Windows djobmanrc.cmd . . . . . . . . . . . . .
Configurando Opes para Utilizao das Interfaces
com o Usurio . . . . . . . . . . . . .
43
45
46
47
48
49
50
Captulo 4. Gerenciando o Ciclo de

Produo . . . . . . . . . . . . . 53
Conceitos Bsicos de Gerenciamento de Planos .
Plano de Pr-Produo . . . . . . . . .
Identificando Instncias do Fluxo de Tarefas no
Plano . . . . . . . . . . . . . .
Gerenciando Dependncias de
Acompanhamentos Externos para Tarefas e
Fluxos de Tarefas . . . . . . . . . .
Plano de Produo . . . . . . . . . . .
Entendendo as Opes de Transporte de Saldo
Plano Trial. . . . . . . . . . . . . .
Plano de Previso . . . . . . . . . . .
Customizando o Gerenciamento de Planos
Utilizando Opes Globais . . . . . . . .
Criando e estendendo o plano de produo . .
Linha de Comandos Planman . . . . . . .
Criando um Plano de Produo Intermedirio .
Criando um Plano Intermedirio para uma
Extenso de Plano . . . . . . . . . .
Recuperando informaes sobre o plano de
produo . . . . . . . . . . . . .
Criando um Plano Trial . . . . . . . .
Criando um Plano Trial de uma Extenso de
Plano de Produo . . . . . . . . . .
Criando um Plano de Previso . . . . . .
Regras de Implementao . . . . . . .
Desbloqueando o Plano de Produo . . . .
Reconfigurando o plano de produo. . . .
O comando stageman . . . . . . . . . .
Gerenciando Acessos Simultneos ao Arquivo
Symphony. . . . . . . . . . . . . .
Cenrio 1: Acesso ao Arquivo Symphony
Bloqueado por Outros Processos do Tivoli
Workload Scheduler . . . . . . . . .
Cenrio 2: Acesso ao Arquivo Symphony
Bloqueado pelo stageman. . . . . . . .
Gerenciando Dependncias Follows Utilizando
Prompt de Transporte de Saldo . . . . . . .
. 53
. 54
. 56
. 57
. 68
68
. 70
. 71
.
.
.
.
72
76
79
81
. 82
. 83
. 84
.
.
.
.
.
.
85
86
87
88
88
89
. 91
. 91
. 91
. 91
iii
O comando logman . . . . . . . . . .
Iniciando o Processamento do Plano de Produo
Automatizando o processamento do plano de
produo . . . . . . . . . . . . . .
. 92
94
. 95
Captulo 5. Utilizando Garantia do

Servio de Carga de Trabalho . . . . . 97
Ativando e Configurando a Garantia do Servio de
Carga de Trabalho . . . . . . . . . . . . 98
Planejando Tarefas Crticas . . . . . . . . . 102
Processando e Monitorando Tarefas Crticas . . . 103
Cenrio de Garantia de Servio de Carga de
Trabalho . . . . . . . . . . . . . . . 106
Captulo 6. Customizando a Carga de

Trabalho Utilizando Tabelas de
Variveis . . . . . . . . . . . . . 109
A Tabela de Variveis Padro . . . . . . .
Integridade de Dados para Tabelas de Variveis .
Mecanismo de Bloqueio para Tabelas de Variveis
Segurana da Tabela de Varivel . . . . . .
Resoluo de Varivel . . . . . . . . .
. 110
. 111
111
. 111
. 112
Captulo 7. Automao de Carga de

Trabalho Orientada pelo Evento em
Execuo . . . . . . . . . . . . . 115
O Processo de Gerenciamento de Regras de

Eventos . . . . . . . . . . . . . . .
Utilizando as Interfaces e Comandos Envolvidos
Definindo Regras de Eventos . . . . . . . .
Exemplos de Regras de Eventos . . . . . .
Notas sobre a operao de regras. . . . . .
Elementos de Regra Acionados . . . . . . .
Definindo Eventos Customizados. . . . . . .
118
121
123
125
130
131
132
Captulo 8. Definindo Objetos no

Banco de Dados . . . . . . . . . . 133
Definir objetos de planejamento . . . . .
Definio de estao de trabalho . . . .
Definio de classe de estao de trabalho .
Definio de domnio. . . . . . . .
Definio de tarefa . . . . . . . .
definio de usurio do Windows . . .
Definio do calendrio . . . . . . .
Definio do parmetro do banco de dados
Definio da Tabela de Variveis . . . .
Definio do Prompt . . . . . . . .
Definio do recurso . . . . . . . .
Definio de fluxo de tarefas . . . . .
Detalhes da Palavra-chave de Definio do
Fluxo de Tarefas . . . . . . . . .
Definio da Regra de Evento . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
133
135
152
153
155
182
184
185
189
191
193
194
.
.
. 199
. 234
Captulo 9. Gerenciando Objetos no

Banco de Dados - Composer . . . . 247
Configurando o Programa fe Linha de Comandos
composer. . . . . . . . . . . . . . . 247
Configurando o Ambiente do Composer . . . 247
iv
IBM Tivoli Workload Scheduler: Guia do Usurio e Referncia
Executando o Programa composer . . .

Executando Comandos a partir do Composer
Filtros e Curingas . . . . . . . . .
Delimitadores e caracteres especiais . . .
Composer commands . . . . . . . .
Verificao de Integridade Referencial . .
add. . . . . . . . . . . . . .
authenticate . . . . . . . . . . .
continue . . . . . . . . . . . .
delete . . . . . . . . . . . . .
display . . . . . . . . . . . .
edit. . . . . . . . . . . . . .
exit . . . . . . . . . . . . . .
extract. . . . . . . . . . . . .
help . . . . . . . . . . . . .
list . . . . . . . . . . . . . .
lock . . . . . . . . . . . . .
modify . . . . . . . . . . . .
new . . . . . . . . . . . . .
print . . . . . . . . . . . . .
redo . . . . . . . . . . . . .
rename . . . . . . . . . . . .
replace . . . . . . . . . . . .
system command . . . . . . . . .
unlock. . . . . . . . . . . . .
validate . . . . . . . . . . . .
version . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
249
251
251
255
256
257
262
264
265
265
269
274
275
275
279
280
286
290
294
296
296
297
300
301
301
305
306
Captulo 10. Gerenciando Objetos no

Plano - conman . . . . . . . . . . 307
Configurando o Programa de linha de Comandos
conman . . . . . . . . . . . . . . .
Configurando o Ambiente do conman . . . .
Executando conman . . . . . . . . . .
Executando comandos a partir do conman. . . .
Curingas . . . . . . . . . . . . . .
Delimitadores e caracteres especiais . . . . .
Processamento de comandos do conman . . .
Selecionando Tarefas em Comandos . . . . . .
Sintaxe . . . . . . . . . . . . . .
Argumentos . . . . . . . . . . . . .
Selecionando Fluxos de Tarefas em Comandos . .
Sintaxe . . . . . . . . . . . . . .
Argumentos . . . . . . . . . . . . .
Gerenciando Tarefas e Fluxos de Tarefas a partir de
Agentes de Nvel Anterior . . . . . . . . .
Conman commands . . . . . . . . . . .
adddep job . . . . . . . . . . . . .
adddep sched . . . . . . . . . . . .
altpass. . . . . . . . . . . . . . .
altpri . . . . . . . . . . . . . . .
bulk_discovery . . . . . . . . . . . .
cancel job. . . . . . . . . . . . . .
cancel sched . . . . . . . . . . . . .
checkhealthstatus . . . . . . . . . . .
confirm . . . . . . . . . . . . . .
console . . . . . . . . . . . . . .
continue . . . . . . . . . . . . . .
deldep job . . . . . . . . . . . . .
deldep sched . . . . . . . . . . . .
deployconf . . . . . . . . . . . . .
307
307
309
311
311
311
312
313
313
313
322
322
322
328
329
332
333
335
336
337
337
339
341
341
342
343
344
345
346
display . . . . .
exit . . . . . . .
fence . . . . . .
help . . . . . .
kill . . . . . . .
limit cpu . . . . .
limit sched . . . .
link. . . . . . .
listsym . . . . .
recall . . . . . .
redo . . . . . .
release job . . . .
release sched . . .
reply . . . . . .
rerun . . . . . .
resetFTA . . . . .
resource . . . . .
setsym . . . . .
showcpus . . . .
showdomain . . .
showfiles . . . . .
showjobs . . . . .
showprompts . . .
showresources . . .
showschedules . . .
shutdown . . . .
start . . . . . .
startappserver . . .
starteventprocessor .
startmon . . . . .
status . . . . . .
stop . . . . . .
stop ;progressive . .
stopappserver . . .
stopeventprocessor .
stopmon . . . . .
submit docommand .
submit file . . . .
submit job . . . .
submit sched . . .
switcheventprocessor .
switchmgr . . . .
system command . .
tellop . . . . . .
unlink . . . . . .
version . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
morestdl . . . . . .
parms . . . . . . .
release. . . . . . .
rmstdlist . . . . . .
sendevent . . . . .
showexec . . . . . .
shutdown . . . . .
ShutDownLwa . . . .
StartUp . . . . . .
StartUpLwa . . . . .
tws_inst_pull_info . . .
verso . . . . . . .
Comandos no-suportados
347
350
350
351
352
353
355
355
358
360
361
362
363
365
366
369
370
371
371
378
379
382
397
400
402
407
408
410
411
412
413
413
415
416
418
419
419
423
426
429
433
434
435
436
437
439
comandos
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
441
442
446
448
452
453
455
457
459
462
462
464
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
464
466
468
470
471
472
473
473
474
474
475
475
477
Captulo 12. Obtendo Relatrios e

Estatsticas . . . . . . . . . . . . 479
Captulo 11. Utilizando Comandos

Utilitrios . . . . . . . . . . . . . 441
Descries dos
at e batch.
cpuinfo .
datecalc .
excluir. .
evtdef . .
evtsize. .
jobinfo. .
jobstdl . .
maestro .
makecal .
metronome
.
.
.
.
.
.
.
.
.
.
.
.
.
|
|
Configurao para Utilizar Comandos de Relatrio

Alterando o formato de data . . . . . . .
Descries dos comandos . . . . . . . . .
rep1 - rep4b . . . . . . . . . . . . .
rep7 . . . . . . . . . . . . . . .
rep8 . . . . . . . . . . . . . . .
rep11 . . . . . . . . . . . . . . .
reptr . . . . . . . . . . . . . . .
xref. . . . . . . . . . . . . . . .
Amostra de sadas do relatrio . . . . . . .
Relatrio 01 - Listagem de Detalhes da Tarefa:
Relatrio 02 - Listagem de Avisos: . . . . .
Relatrio 03 - Listagem de Calendrios: . . .
Relatrio 04A - Listagem de Parmetros: . . .
Relatrio 04B - Listagem de Recursos: . . . .
Relatrio 07 - Listagem de Histricos da Tarefa:
Relatrio 08 - Histograma da Tarefa:. . . . .
Relatrio 9B - Detalhes da Produo Planejada:
Relatrio 10B - Detalhes da Produo Real: . .
Relatrio 11 Agendamento de Produo
Planejada: . . . . . . . . . . . . .
Relatrio 12 - Relatrio de Referncias
Cruzadas: . . . . . . . . . . . . .
Programas de Extrao de Relatrio . . . . . .
jbxtract . . . . . . . . . . . . . .
prxtract . . . . . . . . . . . . . .
caxtract . . . . . . . . . . . . . .
paxtract . . . . . . . . . . . . . .
rextract . . . . . . . . . . . . . .
r11xtr . . . . . . . . . . . . . . .
xrxtrct . . . . . . . . . . . . . . .
Executando Relatrios do Dynamic Workload
Console e relatrios em lote . . . . . . . .
Relatrios de Histrico . . . . . . . . .
Relatrios de Produo . . . . . . . . .
Executando relatrios em lote a partir da
Interface de Linha de Comandos . . . . . .
479
480
480
481
482
483
485
486
487
488
488
491
491
492
492
492
493
493
494
495
496
498
499
500
501
502
502
503
504
509
511
515
516
Captulo 13. Gerenciando fusos

horrios. . . . . . . . . . . . . . 523
Ativando o Gerenciamento de Fuso Horrio
Como o Tivoli Workload Scheduler Gerencia
Horrios . . . . . . . . . . . .
Mudando para o Horrio de Vero Ativado
. . . 523
Fusos
. . . 524
. . . 526
ndice
Mudando para o Horrio de Vero Desativado

Regras Gerais . . . . . . . . . . .
Tabela de Fusos Horrios para
Retrocompatibilidade . . . . . . . . .
Tabela completa de fusos horrios com notao
comprimento varivel . . . . . . . .
.
.
. 526
. 526
. . 527
de
. . 529
Captulo 14. Gerenciando Agentes

Estendidos . . . . . . . . . . . . 547
O que so agentes estendidos? . . . . . .
Definio de estao de trabalho . . . . .
Interface do mtodo de acesso. . . . . . .
Sintaxe da linha de comandos do mtodo . .
Mensagens de resposta do mtodo . . . .
Arquivo de opes do mtodo. . . . . .
Executando Mtodos . . . . . . . . . .
Tarefa LJ (Launch Job) . . . . . . . .
Tarefa MJ (Manage Job) . . . . . . . .
Tarefa CF (Check File) . . . . . . . .
Tarefa GS (Get Status) . . . . . . . .
Comando Cpuinfo. . . . . . . . . .
Deteco de problemas . . . . . . . . .
Mensagens de erro da lista padro de tarefas
Mtodo no executvel . . . . . . . .
Mensagens do Gerenciador de Console . . .
Mensagens do composer e do compiler. . .
Mensagens do Jobman . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
548
548
548
548
550
551
552
552
553
553
554
555
555
555
555
555
556
556
| Definindo uma Dependncia Cruzada . . . . .

| Monitorando uma Resoluo de Dependncia
| Cruzada no Plano de Produo . . . . . . .
Como o Status da Tarefa Sombra Muda at uma
|
Conexo Ser Estabelecida . . . . . . . .
|
Como o Status da Tarefa Sombra Muda aps a
|
Conexo Ser Estabelecida . . . . . . . .
|
Como Ver Por que o Status da Tarefa Sombra
|
FAIL . . . . . . . . . . . . . . .
|
Status da Tarefa Sombra durante a Recuperao
|
ou Nova Execuo da Tarefa Remota . . . .
|
Como Transporte se Aplica a Dependncias
|
Cruzadas . . . . . . . . . . . . . .
|
| Gerenciando Tarefas Sombra no Plano de Produo
Captulo 15. Gerenciando

Dependncias de Interligao de
Redes . . . . . . . . . . . . . . 557
Viso Geral das Dependncias da Interligao de
Redes . . . . . . . . . . . . . . . .
Compreendendo Como uma Dependncia entre
Redes Mostrada . . . . . . . . . . .
Configurando um agente de rede. . . . . . .
Uma Amostra da Definio do Agente de Rede
Definindo uma Dependncia de Interligao de
Redes . . . . . . . . . . . . . . . .
Gerenciando Dependncias de Interligao de
Redes no Plano . . . . . . . . . . . . .
Estados de Tarefas Definidas no Fluxo de
Tarefas EXTERNAL . . . . . . . . . .
Trabalhando com Tarefas Definidas no Fluxo de
Tarefas EXTERNAL . . . . . . . . . .
Amostra de Cenrios de Gerenciamento da
Dependncia entre Redes . . . . . . . .
Dependncias de interligao de redes em um
ambiente misto . . . . . . . . . . . . .
|
|
|
|
|
557
558
559
560
572
573
574
579
581
581
581
582
Apndice A. Evento de Automao e

Definies de Ao da Carga de
Trabalho Orientada a Evento . . . . . 583
Provedores e Definies de Eventos . .
Eventos do TWSObjectsMonitor . .
Eventos de FileMonitor . . . . .
Eventos do TWSApplicationMonitor.
Provedores e Definies de Ao . . .
Aes do TECEventForwarder. . .
Aes de MailSender . . . . . .
Aes de MessageLogger . . . .
Aes de TWSAction . . . . . .
Aes de GenericAction . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
583
583
586
595
596
596
596
596
597
597
Apndice B. Referncia do Esquema

Job Submission Description
Language . . . . . . . . . . . . . 599
Elementos JSDL . . . . . .
Recursos na Definio de Tarefa .
.
.
.
.
.
.
.
.
.
.
. 605
. 640
Apndice C. Referncia rpida para

comandos . . . . . . . . . . . . . 643
563
Gerenciando o Plano . . . . . . .
Gerenciando objetos no banco de dados
Comandos de Objetivo Geral . . .
Objetos de Planejamento . . . .
Comandos do Composer . . . .
Gerenciando objetos no plano . . . .
Comandos do Conman . . . . .
Comandos utilitrios . . . . . . .
Comandos de relatrio . . . . . .
565
Apndice D. Acessibilidade . . . . . 663
Captulo 16. Definindo e Gerenciando

Dependncias Cruzadas. . . . . . . 567
Avisos . . . . . . . . . . . . . . 665
Uma Introduo a Dependncias Cruzadas

Fluxo de Processamento no Ambiente de
Planejamento Distribudo . . . . . .
vi
561
562
562
563
. 567
. 569
Marcas registradas.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
643
644
644
645
649
652
652
658
661
. 666
ndice Remissivo . . . . . . . . . . 669
Figuras
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
Rede de Domnio nico . . . . . . . .

Rede de domnios mltiplos . . . . . . .
rvore de Processos no UNIX . . . . . .
rvore de Processos no Windows . . . . .
Comunicao entre os Processos . . . . .
Critrios de Correspondncia do Mesmo Dia
Critrios de Correspondncia Anteriores Mais
Prximos . . . . . . . . . . . . .
Nos Critrios de Correspondncia de um
Intervalo Relativo . . . . . . . . . .
Nos Critrios de Correspondncia de um
Intervalo Absoluto . . . . . . . . . .
Tarefa Predecessora Anterior Mais Prxima
Instncia do Predecessor Pendente . . . . .
Critrios de Correspondncia no Mesmo Dia Etapa 1: no Incio do Dia (SOD) em uma
Quinta-feira . . . . . . . . . . . .
Critrios de Correspondncia no Mesmo Dia Etapa 2: s 9h . . . . . . . . . . . .
Critrios de Correspondncia no Mesmo Dia Etapa 3: s 15h . . . . . . . . . . .
Prximos - Etapa 1: antes da 8h . . . . . .
Prximos - Etapa 2: s 8h em Dias da Semana,
Exceto Quintas-feiras e Sextas-feiras . . . .
Prximos - Etapa 3: s 9h nas Quintas-feiras e
Sextas-feiras . . . . . . . . . . . .
Prximos - Etapa 4: s 15h Todo Dias . . . .
Critrios de Correspondncia de Intervalo
Relativo - no Incio do Dia na Quinta-feira . .
20.
10
11
29
30
34
57
21.
22.
23.
24.
25.
26.
27.
58
58
28.
59
60
60
62
62
63
64
64
64
65
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
29.
30.
31.
32.
33.
34.
35.
36.
37.
Critrios de Correspondncia de Intervalo

Absoluto - no Incio do Dia na Quinta-feira . . 68
Caminho crtico . . . . . . . . . . . 104
Links da Rede . . . . . . . . . . . 357
Rede de Exemplo . . . . . . . . . . 410
Rede de Exemplo . . . . . . . . . . 415
Rede de Exemplo . . . . . . . . . . 416
Estaes de Trabalho de Rede Desvinculadas 438
Exemplo quando a converso de incio do dia
no aplicada . . . . . . . . . . . 525
Exemplo quando a converso de incio do dia
aplicada. . . . . . . . . . . . . 525
Redes local e remota . . . . . . . . . 560
Lgica da Dependncia Cruzada . . . . . 569
Transio de Status da Tarefa Sombra at a
Conexo Ser Estabelecida . . . . . . . 574
Instncia a ser Conectada se o Horrio
Planejado da Tarefa Sombra Estiver Includo
no Intervalo do CP. . . . . . . . . . 577
Instncia a Ser Conectada se a Instncia que
Precede de Forma Mais Prxima o Horrio
Planejado da Tarefa Sombra Existe no LTP,
mas Foi Cancelado no CP . . . . . . . 578
O Horrio Planejado da Tarefa Sombra Est
Includo no CP, mas No Existe Nenhuma
Instncia para Conectar . . . . . . . . 578
A Instncia a Ser Conectada Existe, mas
Ainda No Est Includa no CP . . . . . 579
O Intervalo do LTP Ainda No Contm o
Horrio Planejado da Tarefa Sombra . . . . 579
Cadeia de Transio de Status da Tarefa
Sombra aps a Conexo Ter Sido Estabelecida 580
66
vii
viii
Tabelas
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1. Sintaxe do Comando . . . . . . . . . xiv

2. Iniciando e Parando o Tivoli Workload
Scheduler em uma Estao de Trabalho . . . 31
3. Iniciando e parando o agente dinmico
33
4. Variveis de Ambiente de Job para o Windows 40
5. Variveis de Ambiente de Job para o UNIX
41
6. Variveis Definidas por Padro no Arquivo
jobmanrc . . . . . . . . . . . . . 43
7. Variveis Definidas por Padro no Arquivo
jobmanrc.cmd . . . . . . . . . . . . 48
8. Configuraes das Opes Globais do Saldo
Transportado . . . . . . . . . . . . 69
9. Configuraes Resultantes do Transporte de
Saldo. . . . . . . . . . . . . . . 69
10. Opes Globais de Garantia de Servio de
Carga de Trabalho . . . . . . . . . . 98
11. Opes Locais de Garantia de Servio de
Carga de Trabalho . . . . . . . . . . 101
12. O Relacionamento entre as Tabelas de
Variveis em suas Variveis no Arquivo de
Segurana do Tivoli Workload Scheduler . . 112
13. Comandos conman para Gerenciar
Mecanismos de Monitoramento . . . . . 119
14. Comandos conman para Gerenciar o Servidor
de Processamento de Eventos . . . . . . 120
15. Interfaces e Comandos para Gerenciar a
Automao de Carga de Trabalho Orientada a
Evento . . . . . . . . . . . . . . 121
16. Lista de Palavras-chave de Objetos de
Planejamento Suportadas . . . . . . . 134
17. Lista de Palavras Reservadas ao Definir
Tarefas e Fluxos de Job . . . . . . . . 134
Estaes de Trabalho . . . . . . . . . 135
Usurios . . . . . . . . . . . . . 135
20. Configuraes de Atributos para Tipos de
Estao de Trabalho de Gerenciamento . . . 136
21. Configuraes de Atributos para Tipos de
Estao de Trabalho de Destino . . . . . 137
22. Tipo de Comunicao, Dependendo do Valor
do Nvel de Segurana . . . . . . . . 148
23. Operadores de Comparao. . . . . . . 159
24. Operadores lgicos. . . . . . . . . . 160
25. Opes e Aes de Recuperao . . . . . 161
26. Atributos Obrigatrios e Opcionais para a
Definio de uma Tarefa de Servios da Web. . 166
Definio de uma Tarefa de Transferncia de
Arquivos. . . . . . . . . . . . . . 168
Definio de uma Tarefa J2EE. . . . . . . 170
Definio de uma Tarefa de banco de dados. . 172
Definio de uma Tarefa MSSQL. . . . . . 173
|
|
|
|
|
|
|
|
|
|

Definio de uma Tarefa Java. . . . . . .
Definio de uma Tarefa Executvel. . . . .
Definio de uma Tarefa XA. . . . . . .
34. Atributos necessrios e opcionais para a
definio de uma tarefa JCL. . . . . . .
Definio de uma Tarefa do IBM i. . . . .
36. Como manipular uma barra invertida em
substituio de varivel. . . . . . . . .
37. Palavras-chave que podem utilizar
parmetros locais em comandos submit . . .
38. Palavra-chave de Acesso Necessrias em
Tabela de Varivel o Arquivo de Segurana
(Objeto vartable) e Aes Permitidas. . . .
39. Lista de Palavras-chave de Planejamento
40. Explicao da Notao que Define o Nmero
de Ocorrncias para um Elemento de
Linguagem. . . . . . . . . . . . .
41. Eventos TWSObjectsMonitor.. . . . . . .
42. Eventos TWSApplicationMonitor. . . . . .
43. Eventos FileMonitor. . . . . . . . . .
44. Tipos de Ao por Provedor de Ao.
45. Critrios de Filtragem de Objetos de
Planejamento . . . . . . . . . . .
46. Delimitadores e Caracteres Especiais para o
Composer. . . . . . . . . . . . .
47. Lista de Comandos do Composer . . . . .
48. Identificadores de Objetos para Cada Tipo de
Objeto Definido no Banco de Dados . . . .
49. Atualizao da Definio de Objeto na
Excluso do Objeto Referenciado . . . . .
50. Referential integrity check when deleting an
object from the database . . . . . . . .
51. Formatos de Sada para Exibir Objetos de
Planejamento . . . . . . . . . . .
52. Formatos de Sada para Exibir Objetos de
Planejamento . . . . . . . . . . .
53. Delimitadores e Caracteres Especiais para
conman . . . . . . . . . . . . .
54. Lista de Comandos do Conman . . . . .
55. Alterao de Estado depois do Comando
confirm . . . . . . . . . . . . .
56. Links Abertos . . . . . . . . . . .
57. Estaes de Trabalho Iniciadas . . . . . .
58. Estaes de Trabalho Paradas . . . . . .
59. Estaes de Trabalho Paradas com stop
;progressive . . . . . . . . . . . .
60. Estaes de Trabalho Desvinculadas . . . .
61. Lista de Comandos Utilitrios . . . . . .
62. Formatos de Data . . . . . . . . . .
63. Lista de Comandos de Relatrio . . . . .
64. Programas de Extrao de Relatrio. . . . .
65. Campos de Sada de Jbxtract . . . . . .
174
175
175
176
177
187
187
191
195
235
238
240
240
242
252
255
256
258
258
259
273
283
311
329
342
357
410
415
416
438
441
480
480
498
499
ix
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
78.
79.
80.
81.
82.
83.
84.
85.
86.
87.
Campos de Sada de Prxtract . . . . .

Campos de Sada de Caxtract . . . . .
Campos de Sada de Paxtract . . . . .
Campos de Sada de Rextract . . . . .
Campos de Sada de R11xtr . . . . . .
Campos de Sada de Xdep_job . . . . .
Campos de Sada de Xdep_job (continuao)
Campos de Sada de Xdep_sched . . . .
Campos de Sada de Xfile . . . . . .
Campos de Sada de Xjob . . . . . .
Campos de Sada de Xprompts . . . .
Campos de Sada de Xresource . . . .
Campos de Sada de Xsched . . . . .
Campos de Sada de Xwhen . . . . .
Formatos de Sada de Relatrio Suportados
Resumo dos relatrios de histrico . . .
Resumo dos relatrios de produo . . .
Tabela de Fusos Horrios para
Retrocompatibilidade . . . . . . . .
Lista de Fusos Horrios com Notao de
Comprimento Varivel . . . . . . .
Opes de Tarefas de Comandos do Mtodo
Mensagens da Tarefa LJ (Launch Job)
Mensagens da Tarefa CF (Check File)
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
501
501
502
503
504
505
505
506
507
507
508
508
509
509
511
512
516
|
|
|
|
|
. 528
. 529
549
553
554
88. Mensagens da Tarefa GS (Get Status)

89. Dependncias de interligao de redes em um
ambiente misto . . . . . . . . . . .
90. Transio de Status da Tarefa Sombra
91. Critrios de Correspondncia para Tarefas
Sombra Distribudas . . . . . . . . .
92. Sintaxe da expresso regular. . . . . . .
93. Exemplos de expresso regular. . . . . .
94. Estrutura Hierrquica do Aqruivo JSDL
95. Tipos e Propriedades de Recursos. . . . .
96. Comandos Utilizados Contra o Plano
97. Comandos de Objetivo Geral . . . . . .
98. Comandos do Composer . . . . . . . .
99. Comandos que Podem Ser Executados a
partir de Conman . . . . . . . . . .
100. Comandos Utilitrios Disponveis para o
UNIX e o Windows . . . . . . . . .
101. Comandos Utilitrios Disponveis somente
para o UNIX . . . . . . . . . . . .
102. Comandos Utilitrios Disponveis somente
para o Windows . . . . . . . . . .
103. Comandos de relatrio . . . . . . . .
104. Programas de Extrao de Relatrio . . . .
555
566
570
573
587
589
600
641
643
644
650
653
658
660
660
661
662
Sobre esta publicao

O IBM Tivoli Workload Scheduler simplifica o gerenciamento de sistemas por
meio de ambientes distribudos, integrando as funes de gerenciamento de
sistemas. O Tivoli Workload Scheduler planeja, automatiza e controla o
processamento de toda a carga de trabalho de produo de seu empreendimento.
O Guia do Usurio e Referncia do Tivoli Workload Scheduler fornece informaes
detalhadas sobre a interface de linha de comandos, linguagem de planejamento e
comandos do utilitrio para Tivoli Workload Scheduler.
O que H de Novo Nesse Release?

Para obter informaes sobre as funes novas ou alteradas neste release, consulte
Viso Geral do IBM Tivoli Workload Automation.
para obter informaes sobre APARs que este release aborda, consulte o Tivoli
Workload Scheduler Documento de Download em http://www.ibm.com/support/
docview.wss?rs=672&uid=swg24027501.
O Que H de Novo nesta Publicao

Esta seo descreve o que mudou nesta publicao desde a verso 8.5.1.1
Nota: Em todo o documento, o texto alterado ou includo marcado por uma
barra de reviso na margem esquerda.
Os tpicos a seguir so parte da nova documentao:
Tipos de tarefa com opes avanadas
Eles esto documentados em:
v Entendendo Conceitos Bsicos na pgina 1 para obter uma descrio
bsica.
v Definio de tarefa na pgina 155 para a definio desses tipos de
tarefa no banco de dados.
v showjobs na pgina 382 para informaes de visualizao nos novos
tipos de tarefas no plano.
Novas estaes de trabalho de mecanismo dinmico e remoto
v Entendendo Conceitos Bsicos na pgina 1 para obter uma descrio
bsica.
v Iniciando e Parando Processos em uma Estao de Trabalho na pgina
31 para obter os comandos para iniciar e parar um agente dinmico.
v Definio de estao de trabalho na pgina 135 para obter a definio
desses tipos de estao de trabalho no banco de dados.
v showcpus na pgina 371 e cpuinfo na pgina 446 para obter
informaes de visualizao nas novas estaes de trabalho no plano.
Dependncias cruzadas
xi
v Definindo Dependncias na pgina 16 para obter uma descrio

bsica.
v Captulo 16, Definindo e Gerenciando Dependncias Cruzadas, na
pgina 567 descreve completamente este recurso.
Executando Relatrios em Lote
Executando relatrios em lote a partir da Interface de Linha de
Comandos na pgina 516 descreve como executar relatrios histricos a
partir da linha de comandos.
Alm disso:
v Novos exemplos e informaes em Apndice A, Evento de Automao e
Definies de Ao da Carga de Trabalho Orientada a Evento, na pgina 583.
v Um novo apndice: Apndice B, Referncia do Esquema Job Submission
Description Language, na pgina 599.
Publicaes
Detalhes integrais sobre as publicaes do Tivoli Workload Automation podem ser
localizados em Tivoli Workload Automation: Publicaes. Esse documento tambm
contm informaes sobre as convenes usadas nas publicaes.
Um glossrio de termos usado no produto pode ser localizado em Tivoli Workload
Automation: Glossrio.
Ambos esto no Centro de Informaes como publicaes separadas.
Acessibilidade
Os recursos de acessibilidade ajudam usurios com deficincias fsicas, como
mobilidade restrita ou viso limitada, a usar os produtos de software com xito.
Com este produto, possvel utilizar tecnologias de assistncia para escutar e
navegar na interface. Tambm pode utilizar o teclado em vez do mouse para
operar todos os recursos da GUI (interface grfica com o usurio).
Para obter informaes adicionais, consulte Apndice D, Acessibilidade, na
pgina 663.
Treinamento Tcnico Tivoli

Para obter informaes sobre o treinamento tcnico do Tivoli, consulte o seguinte
Web site do IBM Tivoli Education:
http://www.ibm.com/software/tivoli/education
Informaes sobre suporte

Se voc tem um problema com o seu software IBM, deseja resolv-lo rapidamente.
A IBM oferece as seguintes maneiras para voc obter o suporte necessrio:
v Pesquisar as bases de conhecimento: possvel fazer pesquisa numa extensa
coleo de problemas conhecidos e solues alternativas, Technotes e outras
informaes.
xii
v Obtendo correes: possvel localizar as correes mais recentes que j esto

disponveis para seu produto.
v Entrando em contato com o Suporte de Software IBM: Se ainda no conseguir
resolver seu problema, e precisar trabalhar com algum da IBM, ser possvel
utilizar as vrias maneiras de entrar em contato com o Suporte de Software IBM.
Para obter informaes adicionais sobre estas trs maneiras de resolver problemas,
consulte o apndice sobre informaes de suporte no IBM Tivoli Workload Scheduler:
Guia de Resoluo de Problemas.
Convenes Utilizadas Nesta Publicao

Esta publicao utiliza vrias convenes para termos e aes especiais, comandos
e caminhos dependentes do sistema operacional, sintaxe de comando e grficos de
margem.
Convenes de Fontes
Esta publicao utiliza as seguintes convenes de tipo de caractere:
Negrito
v Comandos em minsculas e comandos que misturem letras minsculas e
maisculas que possam ser difceis de serem distinguidos do texto ao
redor
v Controles de interface (caixas de opes, botes de comando, botes de
opes, botes de giro, campos, pastas, cones, quadros de listagem, itens
dentro de quadros de listagem, listas com vrias colunas, contineres,
opes de menu, nomes de menu, guias, folhas de propriedade), rtulos
(como Dica: e Consideraes sobre o sistema operacional:)
v Palavras-chave e parmetros em um texto
Itlico
v Palavras definidas no texto
v nfase de palavras (palavras como palavras)
v Novos termos no texto (exceto em uma lista de definies)
v Variveis e valores que voc deve fornecer
Espaamento fixo
v Exemplos e exemplos de cdigo
v Nomes de arquivos, palavras-chave de programao e outros elementos
que so difceis de serem distinguidos do texto ao redor
v Texto de mensagem e prompts dirigidos ao usurio
v Texto que o usurio deve digitar
v Valores para argumentos ou opes de comando
variveis e caminhos dependentes do sistema operacional

Esta publicao utiliza a conveno do UNIX para especificar variveis de
ambiente e para notao de diretrios, exceto onde o contexto ou o caminho de
exemplo seja especificamente Windows.
Ao utilizar a linha de comandos do Windows, substitua $variable por % variable%
para as variveis de ambiente e substitua cada barra (/) por uma barra invertida
Sobre esta publicao
xiii
(\) nos caminhos do diretrio. Os nomes das variveis de ambiente nem sempre
so os mesmos nos ambientes do Windows e UNIX. Por exemplo, %TEMP% no
Windows equivalente a $tmp nos ambientes UNIX.
Nota: Se voc estiver utilizando o shell bash em um sistema Windows, ser
possvel utilizar as convenes UNIX.
Sintaxe do Comando
Esta publicao utiliza a seguinte sintaxe em todos os lugares onde os comandos
so descritos:
Tabela 1. Sintaxe do Comando
Conveno Descrio
de sintaxe
Exemplo
Nome do
comando
A primeira palavra ou conjunto de

caracteres consecutivos.
conman
Colchetes
([ ])
As informaes entre colchetes ([ ])

[-file definition_file]
so opcionais. Tudo o que estiver fora
dos colchetes deve ser especificado.
Chaves ({
})
As chaves ({ }) identificam um
conjunto de opes exclusivas
mutuamente, quando uma opo
exigida.
Sublinhado Um sinal de sublinhado ( _ ) conecta

(_)
vrias palavras em uma varivel.
{-prompts | -prompt prompt_name }
prompt_name
Barra
As opes exclusivas mutuamente so {-prompts | -prompt prompt_name }
vertical ( | separadas por uma barra vertical ( | ).
)
possvel digitar uma das opes
separadas por uma barra vertical, mas
no poder digitar vrias opes em
uma nica utilizao do comando.
xiv
Negrito
O texto em Negrito designa

informaes de literal que devem ser
digitadas na linha de comando
exatamente como mostrado. Isso se
aplica aos nomes de comandos e s
opes no-variveis.
composer add file_name
Itlico
O texto em Itlico uma varivel e

deve ser substituda pelo seu valor
real. No exemplo direita, o usurio
substituiria file_name pelo nome do
arquivo especfico.
file_name
Tabela 1. Sintaxe do Comando (continuao)

Conveno Descrio
de sintaxe
Exemplo
Reticncias As reticncias (...) indicam que a

(...)
opo anterior pode ser repetida
vrias vezes com diferentes valores.
Elas podem ser utilizadas dentro ou
fora de parnteses.
[x file_name]...
As reticncias fora de colchetes
indicam que x file_name opcional e
pode ser repetido da seguinte forma:
x file_name1 x file_name2x
file_name3
[x file_name...]
As reticncias dentro de colchetes
indicam que x file_name opcional e
a varivel do arquivo pode ser
repetida da seguinte forma: x
file_name1 file_name2 file_name3
x file_name [x file_name]...
As reticncias utilizadas com esta
sintaxe indicam que necessrio
especificar x file_name pelo menos
uma vez.
Sobre esta publicao
xv
xvi
Captulo 1. Viso Geral do Tivoli Workload Scheduler

O IBMTivoli Workload Scheduler fornece a capacidade de gerenciar seu ambiente
de produo e automatizar diversas atividades do operador. O Tivoli Workload
Scheduler gerencia o processamento de tarefas, resolve interdependncias e ativa e
monitora tarefas. Como as tarefas so iniciadas assim que suas dependncias so
atendidas, o tempo inativo minimizado e o rendimento do processamento
aprimorado de forma significativa. Se uma tarefa falhar, o Tivoli Workload
Scheduler gerencia o processo de recuperao com pouca ou nenhuma interveno
do operador.
Este captulo est dividido nas sees a seguir:
v Entendendo Conceitos Bsicos
v Interfaces com o Usurio do Tivoli Workload Scheduler na pgina 20
v Iniciando a Produo na pgina 21
Entendendo Conceitos Bsicos

Esta seo descreve os conceitos bsicos do Tivoli Workload Scheduler e est
dividido nas seguintes sees:
v Objetos de Banco de Dados do Tivoli Workload Scheduler
v A Rede do Tivoli Workload Scheduler na pgina 13
v Configurando seu Ambiente de Tempo de Execuo do Tivoli Workload
Scheduler na pgina 14
v Definindo Atividades de Planejamento Utilizando Tivoli Workload Scheduler
na pgina 15
v Gerenciando Atividades de Planejamento de Produo com o Tivoli Workload
Scheduler na pgina 19
Objetos de Banco de Dados do Tivoli Workload Scheduler

Esta seo apresenta os objetos de banco de dados do Tivoli Workload Scheduler
com os quais voc trabalha. Os seguintes objetos de banco de dados so descritos:
v Tarefa, consulte Tarefa na pgina 2
v Fluxo de tarefas, consulte Fluxo de Tarefas na pgina 2
v Ciclo de execuo, consulte Ciclo de Execuo na pgina 3
v
v
v
v
v
v
v
v
v
Calendrio, consulte Calendar na pgina 4

Prompt, consulte Aviso na pgina 4
Estao de trabalho, consulte Estao de Trabalho na pgina 5
Classe de estao de trabalho, consulte Classe de Estao de Trabalho na
pgina 8
Domnio, consulte Domnio na pgina 9
Regra de evento, consulte Regra de Evento na pgina 12
Recurso, consulte Recurso na pgina 12
Parmetro, consulte Parmetro na pgina 12
Tabela de variveis, consulte Tabela de Variveis na pgina 13
Tarefa
Uma tarefa uma unidade de trabalho que especifica uma ao, tal como um
backup de dados semanal, a ser desempenhada em estaes de trabalho especficas
na rede do Tivoli Workload Scheduler. Em um ambiente distribudo do Tivoli
Workload Scheduler, as tarefas podem ser definidas independentemente de fluxos
de tarefas ou dentro de uma definio de fluxo de tarefas.
|
|
|
|
|
|
|
Os tipos de tarefas podem ser divididos entre tarefas do Tivoli Workload Scheduler
existentes e tipos de tarefas com opes avanadas. Os tipos de tarefas existentes
so scripts ou comandos genricos que possvel customizar de acordo com suas
necessidades. Os tipos de tarefas com opes avanadas so tarefas designadas
para executar operaes especficas, como operaes de banco de dados, de
transferncia de arquivos, Java e de servio da Web. Esses tipos de tarefas so
planejados somente em agentes dinmicos, conjuntos e conjuntos dinmicos.
|
|
|
|
|
|
Se quiser usar o recurso dinmico ao planejar os tipos de tarefas com opes

avanadas, voc planeja eles em conjuntos e conjuntos dinmicos, que designam a
tarefa dinamicamente ao melhor recurso disponvel. Se estiver interessado somente
na definio dos tipos de tarefas com opes avanadas, sem usar o recurso de
planejamento dinmico, voc planeja essas tarefas em um agente dinmico
especfico, no qual a tarefa executada estaticamente.
|
|
|
|
Independentemente de se o mecanismo do Tivoli Workload Scheduler distribudo

ou baseado no z/OS, possvel definir localmente uma tarefa sombra para mapear
uma instncia de tarefa remota em um mecanismo diferente do Tivoli Workload
Scheduler.
Para obter informaes sobre como definir tarefas, consulte Definio de tarefa
na pgina 155.
Para obter informaes sobre como definir estaes de trabalho, consulte
Definio de estao de trabalho na pgina 135.
Fluxo de Tarefas
Um fluxo de tarefa uma seqncia de tarefas a serem executadas, juntamente com
dependncias de horas, prioridades e outras dependncias que determinam a
ordem de processamento. Cada fluxo de tarefas designado a um horrio para ser
executado, representado pelo ciclo de execuo com tipo calendrio, conjunto de
datas ou taxas de repetio.
Dependncias em um ambiente distribudo:
possvel ter dependncias entre as tarefas e os fluxos de tarefas: Podem
ser:
Dependncias Internas
Essas so as dependncias estabelecidas entre as tarefas que
pertencem ao mesmo fluxo de tarefas.
Dependncias externas
Essas so as dependncias entre os fluxos de tarefas ou entre os
fluxos de tarefas e as tarefas que pertencem a outros fluxos de
tarefas ou entre as tarefas que pertencem a diferentes fluxos de
tarefas.
Dependncias de Interede
Estas so dependncias em tarefas ou fluxos de tarefas que so
executados em outra rede Tivoli Workload Scheduler. As
dependncias de interligao de redes requerem que uma estao

de trabalho do agente de rede se comunique com a rede externa do
Tivoli Workload Scheduler.
As dependncias em recursos so suportadas pelo Tivoli Workload Scheduler,
ambas nos ambientes distribudos e z/OS.
Para obter informaes sobre como definir fluxos de tarefa, consulte Definio de
fluxo de tarefas na pgina 194.
Ciclo de Execuo
Um ciclo de execuo especifica os dias em que um fluxo de tarefas est planejado
para execuo. Um ciclo definido para um fluxo de tarefa especfico e no pode
ser utilizado por vrios fluxos de tarefa. possvel especifcar os seguintes tipos de
ciclo de execuo:
simples
Um conjunto especfico de dias, definidos pelo usurio, que um fluxo de
tarefas executado. Um ciclo de execuo simples definido para um
fluxo de tarefas especfico e no pode ser utilizado por outros fluxos de
tarefas.
dirio Um ciclo de execuo que especifica se o fluxo de tarefas executado de
acordo com uma freqncia em dias e com o tipo que voc definiu. Por
exemplo, ele pode ser dirio, a cada trs dias ou apenas em dias teis.
semanal
Um ciclo de execuo que especifica os dias da semana que um fluxo de
tarefas executado. Por exemplo, um fluxo de tarefas pode ser
especificado para executar toda segunda-feira, quarta-feira e sexta-feira
utilizando um ciclo de execuo semanal.
mensalmente
Um ciclo de execuo que especifica se o fluxo de tarefas executado de
acordo com um dia do ms ou uma data que voc definiu. Por exemplo,
ele pode ser executado todo primeiro e segundo dias do ms, a cada dois
meses, toda primeira segunda-feira e segunda tera-feira do ms, a cada
trs meses.
anualmente
Um ciclo de execuo que especifica se um fluxo de tarefas executado,
por exemplo, anualmente ou cada trs anos.
baseado em deslocamento
Um ciclo de execuo utiliza uma combinao de perodos e deslocamentos
definidos pelo usurio. Por exemplo, um deslocamento de 3 em um
perodo de 15 dias o terceiro dia a partir do incio do perodo. mais
prtico utilizar ciclos de execuo baseados em deslocamento quando o
ciclo baseado em perodos cclicos. O termo s usado como tal no Tivoli
Workload Scheduler for z/OS, mas o conceito se aplica tambm ao produto
distribudo.
baseado em regra
Um ciclo de execuo que utiliza regras baseadas em listas de nmeros
ordinais, tipos de dias e intervalos de calendrio comuns (ou nomes de
perodos no Tivoli Workload Scheduler for z/OS). Por exemplo, a ltima
quinta-feira de cada ms. Os ciclos de execuo baseados em regras so
baseados em perodos convencionais, como meses do calendrio, semanas
do ano e dias da semana. No Tivoli Workload Scheduler for z/OS, os ciclos
de execuo tambm podem ser baseados em perodos que so definidos,
como por exemplo, um semestre. O termo s usado como tal no Tivoli

Workload Scheduler for z/OS, mas o conceito se aplica tambm ao produto
distribudo. Voc tambm pode especificar uma regra que estabelea
quando um fluxo de tarefas ser executado se ele cair em um dia livre.
Qualquer um destes tipos de ciclo de execuo podem ser inclusivos ou exclusivos;
ou seja:
inclusivo
Um ciclo de execuo que especifica os dias e horas que um fluxo de
tarefas planejado para ser executado. Ciclos de execuo inclusivos
fornecem precedncia para ciclos de execuo inclusivos.
exclusivo
O ciclo de execuo que especifica dias e horas em que um fluxo de tarefas
no pode ser executado. Os ciclos de execuo exclusivos tm precedncia
sobre os ciclos de execuo inclusivos.
Calendar
Um calendrio uma lista de datas que definem se e quando um fluxo de tarefas
executado.
Um calendrio tambm pode ser designado para utilizao como um calendrio de
dias livres em um fluxo de tarefas. Um calendrio de dias livres aquele designado
a um fluxo de tarefas para representar os dias quando o fluxo de tarefas e suas
tarefas no so executados. Ele tambm pode ser utilizado para designar sbados
ou domingos, ou ambos, como dias teis. Por conveno, muitos usurios definem
um calendrio de dias livres denominado holidays, em que habitualmente sbado e
domingo so especificados como dias livres.
Para obter informaes sobre como definir calendrios, consulte Definio do
calendrio na pgina 184.
Aviso
Um aviso identifica uma mensagem textual que exibida para o operador e pra o
processamento da tarefa ou do fluxo de tarefas at que uma resposta afirmativa
seja recebida (ou manualmente do operador ou automaticamente por uma ao da
regra de evento). Aps o aviso ser respondido, o processamento continua. Os
prompts podem ser utilizados como dependncias em jobs e fluxos de job. Voc
tambm pode utilizar avisos para alertar um operador de uma tarefa especfica que
foi executada. Nesse caso, a resposta do operador no necessria.
Existem trs tipos de avisos:
global ou nomeado
Um aviso que definido no banco de dados como um objeto de
planejamento. Ele identificado por um nome exclusivo e pode ser
utilizado por qualquer tarefa ou fluxo de tarefas.
local ou ad-hoc
Esse tipo de aviso definido dentro de uma definio de tarefa ou fluxo
de tarefas. Ele no tem nome e no est definido como um objeto de
planejamento no banco de dados; portanto, no pode ser utilizado por
outras tarefas ou fluxos de tarefas.
recuperao ou encerramento de forma anormal
Um tipo especial de aviso que voc define para ser utilizado quando uma
tarefa encerrada de forma anormal. A resposta para esse aviso determina
o resultado da tarefa ou do fluxo de tarefas aos quais ele pertence. Um

aviso de recuperao tambm pode ser associado a uma ao e a um tipo
especial de tarefa chamado tarefa de recuperao.
Para obter informaes sobre como definir prompts, consulte Definio do
Prompt na pgina 191.
|
Estao de Trabalho
|
|
|
|
|
Nota: Esta seo fornece informaes relacionadas ao uso de estaes de trabalho

para o planejamento de tarefas e fluxos de tarefas. Se, em vez disso, voc
desejar aprender sobre estaes de trabalho porque est planejando a sua
rede, encontrar as informaes de que precisa no Guia de Planejamento e
Instalao do Tivoli Workload Scheduler.
|
|
|
|
|
|
|
O sistema de computador no qual voc executa suas tarefas e fluxos de tarefas

chamado de estao de trabalho. Quando uma tarefa ou um fluxo de tarefas
definida no banco de dados do Tivoli Workload Scheduler, voc identifica as
definies de estao de trabalho para os sistemas de computador fsico ou virtual
onde sua tarefa est planejada para execuo. Estaes de trabalho podem ser
agrupadas logicamente em classes da estao de trabalho e organizadas
hierarquicamente em domnios, gerenciadas por gerenciadores de domnio.
|
|
|
Para obter mais informaes sobre classes da estao de trabalho, consulte Classe
de Estao de Trabalho na pgina 8, e para domnios, consulte Domnio na
pgina 9.
|
|
|
|
|
Ao criar uma definio de estao de trabalho para um sistema em sua rede, voc
define um conjunto de caractersticas que identificam exclusivamente o sistema e
afetam a maneira como as tarefas so executadas nele. Por exemplo, o endereo IP
da estao de trabalho, se est atrs do firewall, se as comunicaes com ele so
seguras, em qual fuso horrio est e a identidade de seu gerenciador de domnio.
|
|
|
|
|
|
Estaes de trabalho na rede de planejamento do Tivoli Workload Scheduler no

podem somente executar processamento de tarefa e de fluxo de tarefas, mas
tambm podem ter outras funes. Quando sua rede foi projetada, essas funes
foram designadas a essas estaes de trabalho para atender s necessidades
especficas de seus negcios. A lista completa de funes de estao de trabalho a
seguinte:
|
|
|
|
|
Gerenciador de domnio mestre

Uma estao de trabalhando atuando como hub de gerenciamento para a
rede. Ela gerencia todos os seus objetos de planejamento. O gerenciador de
domnio principal deve ser instalado como tal. Essa estao de trabalho
registrada no banco de dados do Tivoli Workload Scheduler como master.
|
|
|
|
|
|
|
|
|
Backup do Gerenciador de Domnio Principal

Uma estao de trabalho que pode atuar como backup para o gerenciador
de domnio mestre quando ocorrem problemas. Ela efetivamente um
gerenciador de domnio mestre, aguardando para ser ativado. Seu uso
opcional. Saiba mais sobre a comutao para um gerenciador de domnio
mestre de backup no Tivoli Workload Scheduler Administration Guide. O
gerenciador de domnio principal deve ser instalado como tal. Essa estao
de trabalho registrada no banco de dados do Tivoli Workload Scheduler
como fta.
|
|
Gerenciador de domnio
Uma estao de trabalho que controla um domnio e compartilha
|
|
|
|
|
|
responsabilidades de gerenciamento para parte da rede do Tivoli Workload

Scheduler. Ela instalada como um agente e, em seguida, configurada
como uma estao de trabalho do gerenciador de domnio quando voc
define a estao de trabalho no banco de dados. Essa estao de trabalho
registrada no banco de dados do Tivoli Workload Scheduler como
manager.
|
|
|
|
|
|
|
Gerenciador de domnio dinmico

Um componente instalado em uma rede do Tivoli Workload Scheduler
distribuda que o hub de gerenciamento em um domnio. Toda a
comunicao para e a partir de agentes dinmicos no domnio roteada
por meio do gerenciador de domnio dinmico. Ao instalar um gerenciador
de domnio dinmico, os tipos de estaes de trabalho listadas abaixo so
criadas no banco de dados:
|
|
fta
|
|
broker
agent
Componente de agente tolerante a falhas configurado

manualmente como gerenciador de domnio
Componente do servidor de broker
Componente de agente dinmico
Backup gerenciador de domnio dinmico

Uma estao de trabalho que pode atuar como backup para o gerenciador
de domnio dinmico quando ocorrem problemas. Ela efetivamente um
gerenciador de domnio dinmico, aguardando para ser ativado. Seu uso
opcional. Saiba mais sobre a comutao para um gerenciador de domnio
dinmico de backup no Tivoli Workload Scheduler Administration Guide. Ao
instalar um gerenciador de domnio dinmico, os tipos de estaes de
trabalho listadas abaixo so criadas no banco de dados:
|
|
|
|
|
|
|
|
|
fta
|
|
broker
agent
Componente de agente tolerante a falhas.

Componente do servidor de broker
Componente de agente dinmico
|
|
|
|
|
|
|
|
Agente tolerante a falhas

Uma estao de trabalho que recebe e executa tarefas. Se houver algum
problema de comunicao com seu gerenciador de domnio, ela pode
executar tarefas localmente. Ela instalada como um agente e, em seguida,
configurada como uma estao de trabalho do agente tolerante a falhas
quando voc define a estao de trabalho no banco de dados. Essa estao
como fta.
|
|
|
|
|
|
|
Agente padro
Uma estao de trabalho que recebe e executa tarefas apenas sob o controle
de seu gerenciador de domnio. Ela instalada como um agente e, em
seguida, configurada como uma estao de trabalho do agente padro
quando voc define a estao de trabalho no banco de dados. Essa estao
como s-agent.
|
|
|
|
|
Agente Estendido
Uma estao de trabalho na qual o mtodo de acesso de um Tivoli
Workload Scheduler para Aplicativos foi instalado como uma ponte para
que seja possvel planejar tarefas no SAP R/3, no Oracle E-Business Suite,
no PeopleSoft, no z/OS ou em aplicativos customizados. Ela deve ser
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
fisicamente hospedada por um gerenciador de domnio principal, um

gerenciador de domnio, um agente padro ou um agente tolerante a falhas
(at 255 agentes estendidos por agente tolerante a falhas) e, em seguida,
definida como um agente estendido no banco de dados. Para obter
informaes adicionais, consulte Captulo 14, Gerenciando Agentes
Estendidos, na pgina 547 e o Guia do Usurio do Tivoli Workload Scheduler
para Aplicativos. Essa estao de trabalho registrada no banco de dados do
Tivoli Workload Scheduler como x-agent.
Intermedirio da Carga de Trabalho
Uma estao de trabalho que executa tipos de tarefas existentes e tipos de
tarefas com opes avanadas. o servidor do broker instalado com o
gerenciador de domnio principal e o gerenciador de domnio dinmico.
possvel hospedar uma ou mais das estaes de trabalho a seguir:
v agente estendido
v
v
v
v
mecanismo remoto
conjunto
conjunto dinmico
agente. Essa definio inclui os seguintes agentes:
agente dinmico
Agente do Tivoli Workload Scheduler para z/OS
agente para z/OS
Para obter informaes adicionais sobre o agente dinmico e o Agente
do Tivoli Workload Scheduler para z/OS, consulte Planejando Carga de
Trabalho Dinamicamente. Para obter informaes adicionais sobre o agente
para z/OS, consulte Planejando com o Agente para z/OS.
Essa estao de trabalho registrada no banco de dados do Tivoli

Workload Scheduler como broker.
|
|
|
|
|
|
|
|
|
|
|
|
Agente dinmico
U ma estao de trabalho que gerencia vrios tipos de tarefas, por
exemplo, tarefas de banco de dados ou de FTP especficas, alm dos tipos
de tarefas existentes. Essa estao de trabalho criada e registrada
automaticamente no banco de dados do Tivoli Workload Scheduler quando
o agente dinmico instalado. O agente dinmico hospedado pela
workload broker workstation. Como os processos de instalao e registro
so executados automaticamente, ao visualizar o agente dinmico no
Dynamic Workload Console , ele resulta como atualizado no Resource
Advisor Agent. possvel agrupar agentes dinmicos em conjuntos e
conjuntos dinmicos. Essa estao de trabalho registrada no banco de
dados do Tivoli Workload Scheduler como agent.
|
|
|
|
|
|
|
|
|
|
|
|
|
Conjunto
Uma estao de trabalho lgica que agrupa um conjunto de agentes
dinmicos com caractersticas de hardware ou software similares para o
qual as tarefas so enviadas. O Tivoli Workload Scheduler balanceia as
tarefas entre os agentes dinmicos do conjunto e redesigna tarefas
automaticamente a agentes dinmicos disponveis se um agente dinmico
no estiver mais disponvel. Para criar um conjunto de agentes dinmicos
em seu ambiente do Tivoli Workload Scheduler, defina uma estao de
trabalho do tipo pool hospedada pela workload broker workstation, em
seguida, selecione os agentes dinmicos que deseja incluir no conjunto.
possvel definir o conjunto usando o Dynamic Workload Console ou o
comando composer. Essa estao de trabalho registrada no banco de
dados do Tivoli Workload Scheduler como pool.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Conjunto dinmico
Uma estao de trabalho lgica que agrupa um conjunto de agentes
dinmicos, que dinamicamente definida com base nos requisitos de
recurso especificados e especificada pela workload broker workstation. Por
exemplo, se precisar de uma estao de trabalho com um uso de CPU
baixo e o Windows instalado para executar sua tarefa, voc especifica esses
requisitos usando o Dynamic Workload Console ou o comando composer.
Ao salvar o conjunto de requisitos, uma nova estao de trabalho criada
automaticamente no banco de dados do Tivoli Workload Scheduler. Esta
estao de trabalho mapeia todo o agentes dinmicos em seu ambiente que
atende aos requisitos especificados. O conjunto resultante atualizado
dinamicamente sempre que um novo agente dinmico adequado for
disponibilizado. Tarefas planejadas nessa estao de trabalho herdam
automaticamente os requisitos definidos para a estao de trabalho. Essa
estao de trabalho hospedada pela workload broker workstation e
registrada no banco de dados do Tivoli Workload Scheduler como d-pool.
|
|
|
|
|
|
|
|
Mecanismo remoto
Uma estao de trabalho que gerencia a troca de informaes sobre
resoluo de dependncias cruzadas entre seu ambiente e um mecanismo
remoto do Tivoli Workload Scheduler para z/OS (controlador) ou
mecanismo do Tivoli Workload Scheduler (gerenciador de domnio
principal ou gerenciador do domnio principal de backup). Essa estao de
trabalho hospedada pela workload broker workstation e registrada no
banco de dados do Tivoli Workload Scheduler como rem-eng.
|
|
|
|
|
|
|
|
Nota: Se planeja alterar os tipos de estao de trabalho, considere as regras a

seguir:
v possvel alterar estaes de trabalho de agente tolerante a falhas, agente
padro, agente estendido, gerenciador de domnio e dynamic workload
broker para qualquer tipo de estao de trabalho, com a exceo de
agente dinmico, conjunto, conjunto dinmico e mecanismo remoto.
v no possvel alterar o tipo de agente dinmico, conjunto, conjunto
dinmico e mecanismo remoto.
|
|
Para obter informaes sobre como definir estaes de trabalho, consulte

Classe de Estao de Trabalho

Estaes de trabalho podem ser agrupadas em classes. Uma classe de estao um
grupo de estaes de trabalho com caractersticas de planejamento de tarefas
semelhantes. Qualquer nmero de estaes de trabalho pode ser agrupado em uma
classe e uma estao de trabalho pode estar em vrias classes. Tarefas e fluxos de
tarefas podem ser designados para execuo em uma classe de estao de trabalho
especfica, e isso facilita a execuo de tarefas e de fluxos de tarefas em diversas
estaes de trabalho.
Por exemplo, possvel configurar os seguintes tipos de classes de estao de
trabalho:
v Classes de estao de trabalho que agrupam estaes de trabalho de acordo com
sua estrutura departamental interna, para que voc possa definir uma tarefa
para execuo em todas as estaes de trabalho em um departamento
o software instalado nelas, para que voc possa definir uma tarefa para execuo
em todas as estaes de trabalho que possuem um aplicativo especfico instalado

a funo do usurio, para que voc possa definir uma tarefa para execuo em
todas as estaes de trabalho pertencentes a, por exemplo, gerenciadores
Neste exemplo, uma estao de trabalho individual pode estar em uma classe de
estao de trabalho para seu departamento, outra para seu usurio e vrias para o
software instalado nela.
Estaes de trabalho tambm podem ser agrupadas em domnios. Isto feito
quando sua rede configurada. O nome do domnio no um dos critrios de
seleo quando se escolhe onde executar uma tarefa, portanto, talvez voc precise
espelhar a estrutura do domnio com classes da estao de trabalho se quiser
planejar uma tarefa para execuo em todas as estaes de trabalho em um
domnio.
Para obter informaes adicionais sobre domnios, consulte Domnio
Para obter mais informaes sobre como definir classes da estao de trabalho,
consulte Definio de classe de estao de trabalho na pgina 152.
Domnio
Todas as estaes de trabalho em uma rede do Tivoli Workload Scheduler
distribuda so organizadas em um ou mais domnios, sendo que cada um consiste
em um ou mais agentes e um gerenciador de domnio que agem como o hub de
gerenciamento. A maior parte da comunicao para o agente e a partir dele no
domnio encaminhada por meio do gerenciador de domnio. Se o agente tiver
uma designao "atrs do firewall", tudo ser.
Todas as redes tm um domnio principal onde o gerenciador de domnio o
gerenciador de domnio principal. Ele mantm o banco de dados de todos os
objetos de planejamento no domnio e nos arquivos de configurao centrais. O
gerenciador de domnio principal gera o plano e cria e distribui o arquivo
Symphony. Alm disso, os logs e relatrios da rede so mantidos no gerenciador
de domnio principal.
possvel organizar todos os agentes em sua rede em um nico domnio ou em
vrios domnios.
Redes de domnio nico
Uma rede de domnio nico consiste em um gerenciador de domnio
principal e em qualquer nmero de agentes. A seguir temos um exemplo
de uma rede de domnio nico. Uma rede de domnio nico adequada
para empresas que tm poucos locais e funes negcios. Todas as
comunicaes na rede so roteadas atravs do gerenciador de domnio
principal. Como um nico local, voc se preocupa apenas com a
confiabilidade da rede local e com a quantidade de trfego que ela pode
manipular.
Gerenciador
de Domnio
Principal
Agentes
Figura 1. Rede de Domnio nico
Rede de domnios mltiplos

Redes de domnios mltiplos so adequadas especialmente para empresas
que abrangem vrios locais, departamentos ou funes de negcios. Uma
rede de domnios mltiplos consiste em um gerenciador de domnio
principal, em qualquer nmero de gerenciadores de domnio de camada
inferior e qualquer nmero de agentes em cada domnio. Agentes se
comunicam apenas com gerenciadores de domnio, e os gerenciadores de
domnio se comunicam com seus gerenciadores de domnio pais. A
hierarquia de domnios pode ir abaixo de qualquer nmero de nveis.
10
Domnio principal
Atlanta
Gerenciador de Domnio
Principal de Backup
Gerenciador
de Domnio
Principal
Tivoli Dynamic
Workload Console
Agent
Gerenciador
de Domnios
Domnios de
segundo nvel
Gerenciador
de Domnios
Los
Angeles
Denver
Agent
Agent
Domnios de
terceiro nvel
Nova
York
Agent
Agent
Agent
Agent
Gerenciador
de Domnios
Aurora
Gerenciador
de Domnios
Gerenciador
de Domnios
Agent
Agent
Burbank
Agent
Agent
Agent
Figura 2. Rede de domnios mltiplos
Neste exemplo, o gerenciador de domnio principal est localizado em

Atlanta. O gerenciador de domnio principal contm os arquivos de banco
de dados utilizados para documentar os objetos de planejamento e
distribui o arquivo Symphony para seus agentes e gerenciadores de
domnio principal em Denver e Los Angeles. Os gerenciadores de domnio
de Denver e Los Angeles distribuem ento o arquivo Symphony para seus
agentes e gerenciadores de domnio subordinados em Nova Iorque, Aurora
e Burbank. O gerenciador de domnio principal em Atlanta responsvel
pela difuso de informaes entre domnios por toda a rede.
Todas as comunicaes para e do gerenciador de domnio Boulder so
roteadas atravs de seu gerenciador de domnio pai em Denver. Se houver
algum planejamento ou tarefa no domnio Boulder dependente de
11
planejamentos ou tarefas no domnio Aurora, essas dependncias sero

resolvidas pelo gerenciador de domnio de Denver. A maioria das
dependncias interagentes manipulada localmente pelos gerenciadores de
domnio de camada inferior, reduzindo significativamente o trfego na
rede.
possvel alterar a infra-estrutura do domnio dinamicamente, conforme
desenvolve sua rede. Para mover uma estao de trabalho para um domnio
diferente, voc precisa alterar o nome do domnio em sua definio de banco de
dados.
Dica:
No possvel planejar tarefas ou fluxos de tarefas em todas as estaes de

trabalho em um domnio, identificando o domnio na definio da tarefa ou do
fluxo de tarefas. Para conseguir isso, crie uma classe de estao de trabalho que
contenha todas as estaes de trabalho no domnio.
Para obter mais informaes sobre classes de estao de trabalho, consulte Classe
de Estao de Trabalho na pgina 8.
Para obter informaes sobre como definir domnios, consulte Definio de
domnio na pgina 153.
Regra de Evento
Uma regra de evento define um conjunto de aes que so executadas quando
ocorrem condies de evento especficas. Uma definio de regra de evento
correlaciona eventos e aes do acionador.
Para obter informaes sobre como definir regras de eventos, consulte Definindo
Regras de Eventos na pgina 123.
Recurso
Um recurso um recurso do sistema lgico ou fsico que voc utiliza como uma
dependncia para tarefas e fluxos de tarefas. Uma tarefa ou um fluxo de tarefas
com uma dependncia de recurso no podem ser iniciados at que a quantidade
necessria do recurso definido esteja disponvel.
Para obter informaes sobre como definir recursos, consulte Definio do
recurso na pgina 193.
Parmetro
Um parmetro um objeto ao qual voc designa valores diferentes para serem
substitudos em tarefas e fluxos de tarefas, de valores no banco de dados ou no
tempo de execuo. Parmetros so teis quando voc tem valores que mudam
dependendo da tarefa ou do fluxo de tarefas. Definies de tarefa e fluxo de tarefas
que utilizam parmetros so atualizadas automaticamente com o valor no incio do
de produo. Utilize parmetros como substitutos para valores repetitivos ao
definir tarefas e fluxos de tarefas. Por exemplo, o uso de parmetros para logon de
usurio e nome de arquivo de script em definies de tarefa e para dependncias
de arquivo e prompt permite o uso de valores que podem ser mantidos
centralmente no banco de dados no principal.
Para obter mais informaes sobre como definir parmetros, consulte Definio do
parmetro do banco de dados na pgina 185.
12
Tabela de Variveis
Uma tabela de variveis uma tabela que contm diversas variveis e seus valores.
Todos os parmetros globais, agora chamados de variveis, esto contidos em pelo
menos uma tabela de variveis.
No necessrio criar tabelas de variveis para poder utilizar variveis, pois o
planejador fornece uma tabela de varivel padro.
Entretanto, talvez voc queira definir uma varivel com o mesmo nome, mas
valores diferentes, dependendo de quando e onde ela ser utilizada. Isso feito
designando-se valores diferentes para a mesma varivel em tabelas de variveis
diferentes. possvel ento utilizar o mesmo nome de varivel em definies de
tarefa diferentes e ao definir dependncias de arquivos e avisos. Tabelas de
variveis podem ser designadas no ciclo de execuo, fluxo de tarefas e nvel da
estao de trabalho.
As tabelas de variveis podem ser particularmente teis em definies de tarefas
quando uma definio de tarefa utilizada como um modelo para uma tarefa que
pertence a mais de um fluxo de tarefas. Por exemplo, possvel designar valores
diferentes para a mesma varivel e reutilizar a mesma definio de tarefa em
fluxos de tarefas diferentes.
Para obter informaes sobre como definir tabelas de variveis, consulte Definio
da Tabela de Variveis na pgina 189.
A Rede do Tivoli Workload Scheduler

Uma rede do Tivoli Workload Scheduler consiste em um conjunto de estaes de
trabalho vinculadas no qual voc executa processamento de tarefa do batch
utilizando as capacidades de gerenciamento do Tivoli Workload Scheduler.
As estaes de trabalho comunicam-se utilizando links de TCP/IP e uma
tecnologia de armazenamento e redirecionamento para manter a consistncia e a
tolerncia a falhas em toda a rede. Isso significa que se uma estao de trabalho
no estiver vinculada, todas as informaes so armazenadas no arquivo de
mensagens e enviadas somente quando o link for restabelecido.
A rede do Tivoli Workload Scheduler consiste em um ou mais domnios, cada um
tendo uma estao de trabalho de gerenciador de domnio, que age como um hub
de gerenciamento, e uma ou mais estaes de trabalho do agente.
Existem quatro tipos de agente: padro, tolerante a falhas, estendido e do
workload broker. Agentes padro e tolerantes a falhas podem ser definidos nos
computadores UNIX e Windows. Os agentes estendidos so definies lgicas,
cada um hospedado por uma estao de trabalho fsica, e so utilizados para
executar o processamento de tarefa quando um agente no est instalado. Por
exemplo, agentes estendidos esto disponveis para Peoplesoft, SAP R/3, z/OS,
CA-7, JES, OPC, Oracle EBS e VMS, mas tambm possvel instal-los em sistemas
UNIX e Windows. Os agentes do Workload Broker so estaes de trabalho que
gerenciam o ciclo de vida das tarefas de tipo do Tivoli Workload Scheduler
Workload Broker no broker de carga de trabalho dinmica.
|
|
|
|
Outro tipo de estao de trabalho que possvel definir em sua rede uma
estao de trabalho de mecanismo remoto. Esse tipo e estao de trabalho usado
para gerenciar a comunicao com um mecanismo remoto do Tivoli Workload
Scheduler, distribudo ou baseado no z/OS, para gerenciar dependncias para
13
tarefas locais de tarefas definidas no mecanismo remoto. Para obter informaes

adicionais, consulte a Captulo 16, Definindo e Gerenciando Dependncias
Cruzadas, na pgina 567.
|
|
|
Para obter informaes sobre estaes de trabalho, consulte Definio de estao

de trabalho na pgina 135.
Na topologia hierrquica do Tivoli Workload Scheduler, o gerenciador de domnio
mestre o gerenciador de domnios do domnio mais acima. Todas as tarefas de
configurao da produo e a gerao do plano de produo so executadas no
gerenciador de domnio mestre. Um plano de produo contm todas as atividades
de gerenciamento de tarefa a serem executadas na rede do Tivoli Workload
Scheduler durante um espao de tempo especfico. Uma cpia do plano de
produo distribuda do gerenciador de domnio mestre para as outras estaes
de trabalho. Em cada estao de trabalho, o Tivoli Workload Scheduler ativa e
monitora suas prprias tarefas e envia o status de processamento de tarefa para o
gerenciador de domnio mestre.
Para obter informaes adicionais sobre as capacidades de gerenciamento de plano
do Tivoli Workload Scheduler, consulte o Captulo 4, Gerenciando o Ciclo de
Produo, na pgina 53.
Configurando seu Ambiente de Tempo de Execuo do Tivoli

Workload Scheduler
Esta seo fornece uma viso geral de alto nvel de como possvel configurar seu
ambiente de tempo de execuo do Tivoli Workload Scheduler.
Configurando Propriedades
possvel configurar dois tipos de propriedades para configurar seu ambiente de
tempo de execuo do Tivoli Workload Scheduler, propriedades configuradas no
gerenciador de domnio mestre e que afetam o processamento em todas as estaes
de trabalho na rede do Tivoli Workload Scheduler e as propriedades que so
configuradas localmente em uma estao de trabalho e que afetam o
processamento somente nessa estao de trabalho. As primeiras so gerenciadas
utilizando o programa de linha de comandos do Tivoli Workload Scheduler
denominado optman e as demais so definidas localmente na estao de trabalho
customizando os arquivos de configurao useropts, localopts e jobmanrc.
Para obter informaes adicionais sobre como utilizar a linha de comandos optman
para gerenciar opes globais e sobre opes locais definidas no arquivo localopts,
consulte o Guia de Administrao do IBM Tivoli Workload Scheduler.
Para obter informaes adicionais sobre as opes locais definidas no arquivo
useropts, consulte Configurando Opes para Utilizao das Interfaces com o
Usurio na pgina 50.
Configurando a Segurana
Toda vez que voc executar um programa do Tivoli Workload Scheduler ou
chamar um comando do Tivoli Workload Scheduler, as informaes de segurana
so lidas a partir de um arquivo especial, o arquivo de Segurana, para determinar
suas capacidades de usurio. Esse arquivo contm uma ou mais definies de
14
usurio. Uma definio de usurio um grupo de um ou mais usurios que so

permitidos ou rejeitados para desempenhar aes especficas nos tipos de objeto de
planejamento especficos.
O usurio principal do Tivoli Workload Scheduler, TWS_user, definido no tempo
de instalao no arquivo de segurana. Esse ID do usurio pode ser utilizado para
concluir o procedimento de configurao, para configurar propriedades e para
gerenciar definies de usurios no arquivo de segurana. possvel modificar o
arquivo de segurana a qualquer momento para atender os requisitos do sistema.
Para obter informaes adicionais sobre como gerenciar autorizaes do usurio,
consulte Guia de Administrao do Tivoli Workload Scheduler.
Definindo Atividades de Planejamento Utilizando Tivoli

Workload Scheduler
Para executar atividades de planejamento utilizando o Tivoli Workload Scheduler,
necessrio primeiro definir o ambiente que voc deseja gerenciar em termos de
objetos de planejamento e em termos de regras a serem aplicadas ao planejar
operaes para executar nesses objetos. Estas informaes so armazenadas pelo
Tivoli Workload Scheduler em um Banco de Dados DB2 ou Oracle Relacional,
doravante chamado de banco de dados.
Alm das definies dos objetos de planejamento, como as tarefas, os fluxos de
tarefas, os recursos, as estaes de trabalho e assim por diante, o banco de dados
tambm contm estatsticas sobre tarefas processadas e fluxos de tarefas, assim
como informaes sobre o usurio que criou um objeto e quando um objeto foi
modificado pela ltima vez. possvel gerenciar o planejamento de definies de
objetos no banco de dados usando o programa da linha de comandos do Tivoli
Workload Scheduler chamado composer ou as interface grfica com o usurio, o
Dynamic Workload Console. possvel recuperar estatsticas ou informaes de
histrico sobre tarefas e fluxos de tarefas processados no banco de dados,
utilizando:
v Os utilitrios de relatrio do Tivoli Workload Scheduler a partir da linha de
comandos.
v O Dynamic Workload Console .
v As visualizaes de banco de dados.
Para obter mais informaes sobre como definir objetos de planejamento, consulte
Captulo 8, Definindo Objetos no Banco de Dados, na pgina 133.
Para obter informaes adicionais sobre os comandos dos utilitrios, consulte o
Captulo 12, Obtendo Relatrios e Estatsticas, na pgina 479.
Para obter informaes adicionais sobre a Dynamic Workload Console , consulte a
documentao correspondente.
Para obter informaes adicionais sobre as visualizaes de banco de dados,
consulte o IBM Tivoli Workload Scheduler: Database Views.
Controlando a Tarefa e o Processamento do Fluxo de Tarefas

possvel controlar como as tarefas e os fluxos de tarefas so processados
configurando uma ou mais das seguintes regras:
15
Definindo Dependncias
Uma dependncia um pr-requisito que deve ser satisfeito para que o
processamento possa continuar. possvel definir dependncias para tarefas e
fluxos de tarefas para assegurar a ordem correta de processamento. Em seu
ambiente de planejamento distribudo do Tivoli Workload Scheduler, possvel
escolher entre quatro tipos de dependncias:
v Na concluso de tarefas e fluxos de tarefas: uma tarefa ou um fluxo de tarefas,
denominado successor, no deve iniciar o processamento at outras tarefas e
fluxos de tarefas, denominados predecessor, terem sido concludos com sucesso.
Para obter informaes adicionais, consulte a follows na pgina 209.
v Recurso: uma tarefa ou um fluxo de tarefas precisa de um ou mais recursos
disponveis antes de poder comear a execuo. Para obter informaes
adicionais, consulte o needs na pgina 216.
v Arquivo: uma tarefa ou um fluxo de tarefas precisa ter acesso a um ou mais
arquivos antes de poder iniciar a execuo. Para obter informaes adicionais,
consulte o opens na pgina 223.
v Prompt: uma tarefa ou um fluxo de tarefas precisa aguardar uma resposta
afirmativa a um prompt antes de poder iniciar o processamento. Para obter
informaes adicionais, consulte Definio do Prompt na pgina 191 e
prompt na pgina 226.
possvel definir at 40 dependncias para uma tarefa ou um fluxo de tarefas.
|
|
|
|
|
|
|
|
Em uma rede do Tivoli Workload Scheduler, as dependncias podem cruzar limites

da estao de trabalho. Por exemplo, possvel tornar job1, que executada em
seu ambiente local do Tivoli Workload Scheduler site1, dependente da concluso
bem-sucedida de job2, que executada em um ambiente remoto do Tivoli
Workload Scheduler site2. O ambiente de planejamento remoto pode ser
mecanismos do Tivoli Workload Scheduler para z/OS (controlador) ou outros
mecanismos do Tivoli Workload Scheduler (gerenciador de domnio principal).
Dois tipos de dependncias implementam tal requisito:
|
|
|
Dependncia de Interligao de Redes

uma implementao simples e distribuda. Use esse tipo de dependncia
quando:
v O ambiente local do Tivoli Workload Scheduler for distribudo.
|
|
|
|
|
|
|
|
|
|
|
|
|
v Voc quiser procurar uma instncia da tarefa predecessora remota

somente no plano atualmente em execuo (plano de produo) no
ambiente remoto.
v For necessrio corresponder uma instncia predecessora do plano
remoto, no essa instncia predecessora especfica.
v For possvel esperar o intervalo de pesquisa expirar antes de ser
atualizado sobre a transio do status da tarefa remota.
v Voc no se importar de usar diferentes sintaxes e configuraes com
base em se o ambiente remoto do Tivoli Workload Scheduler
distribudo, em vez de z/OS.
v Voc no se importar de usar um protocolo de conexo proprietrio para
se comunicar com o mecanismo remoto.
Para obter informaes adicionais, consulte a Captulo 15, Gerenciando
Dependncias de Interligao de Redes, na pgina 557.
|
|
16
|
|
|
Dependncia cruzada
uma implementao mais abrangente e completa. Use esse tipo de
dependncia quando:
|
|
|
|
|
|
|
|
|
|
|
|
|
v Seu ambiente local do Tivoli Workload Scheduler puder ser distribudo

ou z/OS.
v Voc quiser procurar a instncia predecessora remota tambm entre as
instncias planejadas que ainda no esto includas no plano atualmente
em execuo no mecanismo remoto.
v Voc quiser corresponder a instncia predecessora no plano do
mecanismo remoto. Para fazer isso, possvel usar diferentes critrios de
correspondncia prontos para uso.
v Voc deseja que sua dependncia seja atualizada assim que a instncia
da tarefa remota mude de status. Para fazer isso, o produto usa uma
notificao assncrona do mecanismo remoto para o mecanismo local.
v Voc deseja usar a mesma sintaxe e configurao, independentemente de
se o ambiente local do Tivoli Workload Scheduler distribudo ou z/OS.
|
|
v Voc deseja usar conexes HTTP ou HTTPS para comunicao com o

mecanismo remoto.
|
|
Para obter informaes adicionais, consulte a Captulo 16, Definindo e

Gerenciando Dependncias Cruzadas, na pgina 567.
Configurando Restries de Hora

Restries de hora podem ser especificadas para tarefas e fluxos de tarefas. Para
um ciclo de execuo especfico, possvel especificar a hora na qual o
processamento iniciado, utilizando a palavra-chave at, ou a hora aps a qual o
processamento no mais iniciado, utilizando a palavra-chave until. Especificando
ambas, voc define uma janela de tempo dentro da qual uma tarefa ou um fluxo
de tarefa executado. Ambas, at e until, representam dependncias de hora.
Outra configurao de hora que pode ser especificada schedtime; indica a hora
referida ao calcular dependncias de tarefas e de fluxos de tarefas. Tambm
possvel especificar uma taxa de repetio; por exemplo, possvel fazer com que
o Tivoli Workload Scheduler ative a mesma tarefa a cada 30 minutos entre s 8h30
e s 13h30.
Para obter informaes adicionais, consulte s na pgina 199, prazo final na
pgina 202, a cada na pgina 204, schedtime na pgina 227 e until na pgina
230.
Configurando Prioridade da Tarefa e Limitao da Estao de

Trabalho
O Tivoli Workload Scheduler tem seu prprio sistema de enfileiramento, que
consiste em nveis de prioridade. Designar uma prioridade s tarefas e aos fluxos
de tarefas fornece controle adicional sobre suas precedncias e a ordem de
execuo.
A proteo de tarefa fornece outro tipo de controle sobre o processamento de
tarefa em uma estao de trabalho. Quando configurado para um nvel de
prioridade, ele permite que apenas tarefas e fluxos de tarefas cuja prioridade
exceda o fence da tarefa sejam executados nessa estao de trabalho. Definir o
limitador como 40, por exemplo, evita que os jobs com prioridades de 40 ou menos
sejam ativados.
17
Para obter informaes adicionais, consulte fence na pgina 350 e prioridade

na pgina 225.
Configurando Limites
O limite fornece uma maneira de configurar o nmero mais alto de tarefas que o
Tivoli Workload Scheduler tem permisso para executar. possvel configurar um
limite:
v Na definio do fluxo de tarefas que utiliza o argumento limite de tarefa
v Na definio da estao de trabalho, utilizando o comando limit cpu
Configurar o limite em uma estao de trabalho para 25, por exemplo, permite que
o Tivoli Workload Scheduler no tenha mais de 25 tarefas em execuo
simultaneamente nessa estao de trabalho.
Para obter informaes adicionais, consulte limit cpu na pgina 353 e limit
sched na pgina 355.
Definindo Recursos
possvel definir recursos para apresentar recursos fsicos ou lgicos em seu
sistema. Cada recurso representado por um nome e um nmero de unidades
disponveis. Se voc tiver trs unidades de fita, por exemplo, poder definir um
recurso denominado tapes com trs unidades disponveis. Uma tarefa que utiliza
duas unidades do recurso tapes impediria, ento, que outras tarefas, que requerem
mais do que a unidade restante, fossem ativadas. No entanto, como um recurso
no vinculado estritamente a um recurso, possvel utilizar um recurso fictcio
como uma dependncia para controlar o processamento de tarefas.
Para obter informaes adicionais, consulte o Definio do recurso na pgina
193.
Solicitando Confirmao de Tarefa

Pode haver cenrios em que o status de concluso de uma tarefa no possa ser
determinado at que voc tenha executado algumas tarefas. Voc talvez queira
verificar os resultados impressos em um relatrio, por exemplo. Nesse caso,
possvel configurar na definio de tarefa que a tarefa requer confirmao e o Tivoli
Workload Scheduler aguarda sua resposta antes de marcar a tarefa como
bem-sucedida ou em falha.
Para obter informaes adicionais, consulte o confirm na pgina 341.
Definindo Aes de Recuperao da Tarefa

Ao planejar uma tarefa, possvel especificar o tipo de recuperao que voc
deseja executar pelo Tivoli Workload Scheduler se a tarefa falhar. As opes de
recuperao predefinidas so:
v Continuar com a prxima tarefa.
v Parar e no iniciar o prximo.
v Executar a tarefa que falhou novamente.
Alm disso, possvel especificar outras aes a serem tomadas em termos de
tarefas de recuperao e prompts de recuperao. Por exemplo, se uma tarefa
falhar, possvel que o Tivoli Workload Scheduler execute automaticamente uma
tarefa de recuperao, emita um prompt de recuperao que requer uma resposta
afirmativa e, em seguida, execute a tarefa em falha novamente.
18
Para obter informaes adicionais, consulte o Tarefa na pgina 646.
Gerenciando Atividades de Planejamento de Produo com o

Tivoli Workload Scheduler
Toda vez que um novo plano de produo gerado, o Tivoli Workload Scheduler
seleciona os fluxos de tarefas que so executados na janela de tempo especificada
para o plano e transporta o saldo de fluxos de tarefas incompletos do plano de
produo anterior. Todas as informaes requeridas so gravadas em um arquivo
denominado Symphony, que atualizado de forma contnua durante o
processamento para indicar que o trabalho foi concludo, que o trabalho est em
progresso e o trabalho a ser realizado. O programa de linha de comandos conman
(Console Manager) do Tivoli Workload Scheduler utilizado para gerenciar as
informaes no arquivo Symphony. O programa de linha de comandos conman
pode ser utilizado para:
v Iniciar e parar os processos de controle do Tivoli Workload Scheduler.
v Exibir o status das tarefas e dos fluxos de tarefas.
v
v
v
v
v
v
v
Alterar prioridades e dependncias.

Alterar a proteo de tarefa e os limites de tarefa.
Executar as tarefas novamente.
Cancelar tarefas e fluxos de tarefa.
Enviar novas tarefas e fluxos de tarefa.
Responder a prompts.
Vincular e desvincular estaes de tarefa na rede do Tivoli Workload Scheduler.
v Modificar o nmero de recursos disponveis.
Automatizando a Carga de Trabalho Utilizando Regras de

Eventos
Alm de fazer o planejamento de tarefas baseado em planos, possvel
automatizar a carga de trabalho com base na demanda, com o auxlio de regras de
eventos. O objetivo das regras de eventos executar um conjunto predefinido de
aes em resposta a eventos especficos que afetam objetos Tivoli Workload
Scheduler e no-Tivoli Workload Scheduler.
Com relao aos objetos Tivoli Workload Scheduler, o produto fornece um plug-in
que pode ser utilizado para detectar os seguintes eventos:
v Uma tarefa ou fluxo de tarefas especficos:
Altera o status
Est alm do horrio de incio mais tardio
Foi enviado
Foi cancelado
Foi reiniciado
Torna-se atrasado
v Uma determinada estao de trabalho:
Altera o status
Altera seu status de link a partir da estao de trabalho pai
Altera seu status de link a partir da estao de trabalho filha
v Um aviso especfico exibido ou respondido
v O servidor de aplicativos integrado em uma determinada estao de trabalho
iniciado ou parado
19
Quando ocorrer algum desses eventos, qualquer das seguintes aes poder ser
acionada:
v Enviar um fluxo de tarefas, um job ou uma tarefa
v Responder a um prompt
v Executar comandos no-Tivoli Workload Scheduler
v Registrar uma mensagem do operador
v Notificar usurios por meio de e-mail
v Enviar mensagens ao Tivoli Enterprise Console
Voc tambm pode definir e executar regras de eventos que ajam na deteco da
no-concluso, por um ou mais desses eventos ou por uma seqncia ou conjunto
desses eventos, dentro de um perodo de tempo especfico.
Informaes adicionais esto disponveis no Captulo 7, Automao de Carga de
Trabalho Orientada pelo Evento em Execuo, na pgina 115.
Interfaces com o Usurio do Tivoli Workload Scheduler

Uma combinao de programas de interface grfica, de linha de comandos e de
API fornecida para trabalhar com o Tivoli Workload Scheduler. Na verdade, a
interface de linha de comandos est disponvel para determinados recursos
avanados que no esto disponveis na interface grfica com o usurio. Os
programas de interface com o usurio disponveis do Tivoli Workload Scheduler
so:
Dynamic Workload Console
Uma interface com o usurio baseada na Web disponvel para visualizar e
controlar atividades de planejamento na produo em ambos os ambientes
do Tivoli Workload Scheduler, distribudo e z/OS. Com o Dynamic
Workload Console , possvel utilizar qualquer navegador suportado para
acessar o ambiente do Tivoli Workload Scheduler a partir de qualquer local
em sua rede.
possvel usar o Dynamic Workload Console para:
v Definir os objetos de planejamento no banco de dados do Tivoli
Workload Scheduler
v Procurar e gerenciar objetos de planejamento envolvidos nas atividades
atuais de planejamento
v Criar e controlar conexes com ambientes do Tivoli Workload Scheduler
v Enviar tarefas e fluxos de tarefas em produo
v Configurar preferncias do usurio
v Criar e gerenciar regras de evento
v Definir e gerenciar tarefas crticas para a misso
Dynamic Workload Console deve ser instalado em um servidor que pode
alcanar os ns do Tivoli Workload Scheduler utilizando conexes de rede.
Consulte o guia Tivoli Workload Scheduler Planejamento e Instalao para
obter informaes.
composer
Um programa de linha de comandos utilizado para definir e gerenciar
objetos de planejamento no banco de dados. Esse programa de interface e
sua utilizao so descritos no Captulo 8, Definindo Objetos no Banco de
Dados, na pgina 133 e no Captulo 9, Gerenciando Objetos no Banco de
Dados - Composer, na pgina 247.
20
conman
Um programa de linha de comandos utilizado para monitorar e controlar o
processamento do plano de produo do Tivoli Workload Scheduler. Esse
programa de interface descrito no Captulo 10, Gerenciando Objetos no
Plano - conman, na pgina 307.
API Java e plug-ins
Um conjunto de classes e mtodos disponveis em execuo em um
ambiente JAVA utilizado para criar sua interface customizada para
gerenciar objetos de planejamento no banco de dados e no plano. Esta API
no pode ser utilizada para criar sua interface customizada para configurar
as opes globais. Alm disso, possvel usar e modificar um conjunto de
plug-ins que executam tarefas especficas ou criar seus prprios plug-ins. A
API est disponvel por meio de um Kit de Desenvolvimento de Software,
que faz parte do produto. Para obter informaes adicionais e aprender
como acessar a documentao da API e dos plug-ins, consulte o IBM Tivoli
Workload Scheduler Developer's Guide: Software Development Kit (Integration
Workbench).
optman
Um programa de linha de comandos utilizado para gerenciar as
configuraes que afetam o ambiente inteiro do Tivoli Workload Scheduler.
Essas configuraes, tambm chamadas de opes globais, so
armazenadas no banco de dados. Este programa de interface descrito no
Guia de Administrao do Tivoli Workload Scheduler.
planman
Um programa de linha de comandos utilizado para gerenciar a capacidade
de planejamento do Tivoli Workload Scheduler. Esse programa de interface
descrito no Linha de Comandos Planman na pgina 79.
Interface de Servios da Web
Uma interface que fornece um mecanismo de acesso baseado em Servios
da Web a um subconjunto de funcionalidades utilizadas para gerenciar
tarefas e fluxos de tarefas no plano. No permite gerenciar o plano,
configurar opes globais, gerenciar objetos no banco de dados. Para obter
informaes adicionais, consulte o IBM Tivoli Workload Scheduler Developer's
Guide: Web Services.
Voc deve instalar o recurso Tivoli Workload Scheduler Command Line Client nos
agentes tolerantes a falhas e sistemas fora da rede do Tivoli Workload Scheduler
para utilizar os programas da linha de comandos composer e optman e para
executar os comandos planman showinfo e planman unlock.
Para obter informaes sobre como configurar as opes necessrias para permitir
que um usurio acesse as interfaces de linha de comandos, consulte Configurando
Opes para Utilizao das Interfaces com o Usurio na pgina 50.
Iniciando a Produo
Esta seo fornece um caminho passo a passo de operaes bsicas que podem ser
executadas rapidamente para implementar o Tivoli Workload Scheduler em seu
ambiente, utilizando a interface de linha de comandos. Supe-se que:
v Essas etapas sejam executadas no gerenciador de domnio mestre imediatamente
aps a instalao bem-sucedida do produto nos sistemas onde voc deseja
executar suas atividades de planejamento.
21
v O ID do usurio utilizado para executar as operaes o mesmo que o utilizado

para instalar o produto.
Se voc no estiver familiarizado com o Tivoli Workload Scheduler, poder seguir
as etapas no opcionais para definir um nmero limitado de objetos de
planejamento e incluir mais, medida que se familiarizar com o produto.
possvel iniciar, por exemplo, com dois ou trs de seus aplicativos mais freqentes,
definindo objetos de planejamento para atender somente seus requisitos.
Como alternativa, possvel usar o Dynamic Workload Console para executar
tarefas de modelagem e operacionais. Consulte a documentao do produto
correspondente para obter informaes adicionais.
A primeira atividade que voc deve executar acessar o banco de dados do Tivoli
Workload Scheduler e definir o ambiente no qual deseja executar suas atividades
de planejamento utilizando os tipos de objetos de planejamento do Tivoli Workload
Scheduler. Para fazer isso, execute as seguintes etapas:
1. Configure as variveis de ambiente do Tivoli Workload Scheduler
Execute um dos seguintes scripts:
. ./TWS_home/tws_env.sh para shells Bourne e Korn no UNIX
. ./TWS_home/tws_env.csh para shells C no UNIX
TWS_home\tws_env.cmd no Windows
em um shell de sistema para configurar as variveis PATH e TWS_TISDIR.
2. Conecte ao banco de dados do Tivoli Workload Scheduler
possvel utilizar a seguinte sintaxe para conectar-se ao gerenciador de
domnio mestre como TWS_user:
composer -user <TWS_user> -password <TWS_user_password>
em que usurio_do_TWS o ID do usurio especificado no tempo de

instalao.
Nota: Se quiser executar essa etapa e as seguintes a partir de um sistema
diferente do gerenciador de domnio mestre, voc deve especificar os
parmetros de conexo ao iniciar o composer, conforme descrito em
Configurando Opes para Utilizao das Interfaces com o Usurio
na pgina 50.
3. Como opo, inclua no banco de dados as definies para descrever a
topologia de seu ambiente de planejamento em termos de:
v Domnios
Utilize essa etapa se quiser criar uma rvore hierrquica do caminho atravs
do ambiente. A utilizao de vrios domnios reduz o trfego de rede,
reduzindo as comunicaes entre o gerenciador de domnio mestre e as
outras estaes de trabalho. Para obter informaes adicionais, consulte
Definio de domnio na pgina 153.
v Estaes de trabalho
Defina uma estao de trabalho para cada mquina pertencente ao ambiente
de planejamento, com exceo do gerenciador de domnio mestre, que
definido automaticamente durante a instalao do Tivoli Workload
Scheduler. Para obter informaes adicionais, consulte Definio de estao
de trabalho na pgina 135. O gerenciador de domnio mestre definido
automaticamente no banco de dados na hora da instalao.
22
4. Como opo, defina os usurios que podem executar tarefas nas estaes de
trabalho Windows
Defina qualquer usurio que possa executar tarefas utilizando o Tivoli
Workload Scheduler, especificando o nome do usurio e a senha. Para obter
informaes adicionais, consulte definio de usurio do Windows na
pgina 182.
5. Como opo, defina calendrios
Os calendrios permitem que voc determine se e quando uma tarefa ou um
fluxo de tarefa deve ser executado. possvel utiliz-los para incluir ou
excluir dias e horas para processamento. Os calendrios no so estritamente
necessrios para definir os dias de planejamento para os fluxos de tarefa (os
ciclos de execuo simple ou rule tambm podem ser utilizados); sua
principal meta definir conjuntos de datas globais que podem ser reutilizados
em vrios fluxos de tarefa. Para obter informaes adicionais, consulte
Definio do calendrio na pgina 184.
6. Como opo, defina parmetros, prompts e recursos
Para obter informaes adicionais, consulte Definio do parmetro do banco
de dados na pgina 185, Definio do Prompt na pgina 191 e Definio
do recurso na pgina 193.
7. Definir tarefas e fluxos de tarefa
Para obter informaes adicionais, consulte Tarefa na pgina 646 e
Definio de fluxo de tarefas na pgina 194.
8. Como opo, defina as restries e configuraes para controlar quando as
tarefas e os fluxos de tarefa so executados.
possvel definir dependncias para tarefas e fluxos de tarefas. Pode haver
at 40 dependncias para um fluxo de tarefas. Podem ser:
v
v
v
v
Dependncias
Dependncias
Dependncias
Dependncias
de recursos
de arquivos
follow de tarefa e de fluxo de tarefa
de prompts
possvel definir as configuraes de hora para tarefas e fluxo de tarefas para

execuo em termos de:
v Ciclos de Execuo
v Restries de hora
possvel ajustar a maneira como as tarefas so executadas simultaneamente
em uma estao de trabalho ou em um fluxo de tarefa, configurando:
v Limite
v Prioridade
9. Automatizar a extenso do plano no final do prazo de produo atual
Inclua o fluxo de tarefa final no banco de dados para desempenhar a
extenso do plano de produo automtica no final de cada prazo de
produo atual executando o seguinte comando:
add Sfinal
Para obter informaes adicionais, consulte Automatizando o processamento

do plano de produo na pgina 95.
10. Gere o plano
Execute o comando JnextPlan para gerar o plano de produo. Esse comando
inicia o processamento das informaes de planejamento armazenadas no
banco de dados e cria o plano de produo para o espao de tempo
23
especificado no comando JnextPlan. O espao de tempo padro 24 horas. Se

voc tiver automatizado a gerao de plano conforme descrito na etapa
anterior, necessrio executar somente o comando JnextPlan na primeira vez.
Ao concluir esse processo passo a passo, seu ambiente de planejamento estar
ativado e em execuo, com o processamento de batch de uma seqncia ordenada
de tarefas e fluxos de tarefas sendo executado com recursos definidos em um
conjunto de estaes de trabalho, se definido. Por padro, na primeira vez que o
comando JnextPlan for executado, o nmero de tarefas que podero ser executadas
simultaneamente em uma estao de trabalho ser zero, portanto, certifique-se de
aumentar esse valor alterando limit cpu para permitir a execuo da tarefa nessa
estao de trabalho. Consulte a seo limit cpu na pgina 353 para obter detalhes
adicionais.
Se quiser modificar algo enquanto o plano de produo j est em processo, utilize
o programa conman. Enquanto o plano de produo est processando na rede,
ainda possvel continuar a definir ou modificar tarefas e fluxos de tarefas no
banco de dados. Considere, no entanto, que essas modificaes sero utilizadas
somente se voc enviar as tarefas modificadas ou os fluxos de tarefas utilizando o
comando sbj para tarefas ou sbs para fluxos de tarefas, em uma estao de
trabalho que j recebeu o plano ou aps um novo plano de produo ser gerado,
utilizando JnextPlan. Consulte o Captulo 10, Gerenciando Objetos no Plano conman, na pgina 307 para obter detalhes sobre o programa conman e as
operaes que possvel executar no plano de produo em processo.
24
Captulo 2. Entendendo Processos Bsicos da Estao de

Trabalho
Em uma rede multicamada do Tivoli Workload Scheduler, localmente, em cada
estao de trabalho, um grupo de processos de planejamento especializados
executa o gerenciamento de tarefa e envia as informaes de volta sobre o
processamento de tarefa em toda a rvore hierrquica at o gerenciador de
domnio mestre ser alcanado. Usando as informaes recebidas das estaes de
trabalho, o gerenciador de domnio mestre ento atualiza sua cpia do arquivo
Symphony, que contm os registros que descrevem as atividades de processamento
da tarefa a serem executadas na rede do Tivoli Workload Scheduler durante o
plano de produo atual, e envia as atualizaes sobre as atividades a serem
executadas para as estaes de trabalho envolvidas.
Este captulo descreve o processamento da tarefa executado em cada estao de
trabalho e a comunicao de rede estabelecida em toda a rvore hierrquica. Ele
composto das seguintes sees:
v Processos da Estao de Trabalho do Tivoli Workload Scheduler
v Iniciando e Parando Processos em uma Estao de Trabalho na pgina 31
v Comunicao Interprocesso de Estao de Trabalho na pgina 33
v Comunicao da Rede do Tivoli Workload Scheduler na pgina 34
Processos da Estao de Trabalho do Tivoli Workload Scheduler

O gerenciamento de comunicao entre estaes de trabalho e processamento de
tarefa local, juntamente com a notificao de atualizaes de estado, so executados
em cada estao de trabalho do Tivoli Workload Scheduler por uma srie de
processos de gerenciamento que esto ativos enquanto o mecanismo est em
execuo. Nos agente tolerante a falhass e gerenciadores de domnio, esses
processos so baseados na infraestrutura do WebSphere Application Server. Essa
infra-estrutura instalada automaticamente com a estao de trabalho e permite
que o Tivoli Workload Scheduler:
v Comunique-se atravs da rede do Tivoli Workload Scheduler.
v Gerencie os mecanismos de autenticao de clientes remotos, como programas
de linha de comandos, conectando-se ao gerenciador de domnio mestre usando
protocolos HTTP ou HTTPS.
Para obter informaes sobre como iniciar e parar a infraestrutura do WebSphere
Application Server e os processos do Tivoli Workload Scheduler, em uma estao
de trabalho consulte Iniciando e Parando Processos em uma Estao de Trabalho
na pgina 31. Exceto para iniciar e parar manualmente o WebSphere Application
Server e gerenciar os parmetros de conexo ao se comunicar na rede do Tivoli
Workload Scheduler, a infraestrutura do WebSphere Application Server
transparente ao usar o Tivoli Workload Scheduler.
Neste guia, processos do Tivoli Workload Scheduler ou processos da estao de trabalho
so utilizados para identificar os seguintes processos:
netman
monman
writer
25
mailman
batchman
jobman
Com exceo dos agentes padro, esses processos so iniciados na seguinte ordem
nas estaes de trabalho do Tivoli Workload Scheduler:
netman
Netman o processo de Gerenciamento de Redes. iniciado pelo
comando Startup e comporta-se como um programa listener que recebe
pedidos para iniciar, parar, vincular ou desvincular a rede. Netman
examina cada pedido recebido e gera um processo local do Tivoli
Workload Scheduler.
monman
Monman um processo iniciado por netman e usado em gerenciamento
de eventos. Ele inicia servios ssmagent e de monitoramento que tm a
tarefa de detectar os eventos definidos nas regras de eventos
implementadas e ativadas na estao de trabalho especfica. Quando esses
servios capturam quaisquer desses eventos, aps uma ao de filtragem
preliminar, eles os enviam para o servidor de processamento de eventos
que normalmente executado no gerenciador de domnio principal. Se
nenhuma configurao de regra de evento for transferida por download
para a estao de trabalho, os servios de monitoramento permanecem
inativos.
O processo de comunicao entre os agentes de monitoramento e o
servidor de processamento de eventos independente da topologia de rede
do Tivoli Workload Scheduler. Ele se baseia diretamente no nmero da
porta EIF do processador de eventos e as informaes de evento fluem
diretamente dos agentes de monitoramento sem passar pelos gerenciadores
de domnio intermedirios. Um grau de tolerncia a falhas garantido
pelas memrias cache locais, que armazenam temporariamente as
ocorrncias de evento nos agentes caso a comunicao com o processador
de eventos esteja inativa.
writer Writer um processo iniciado por netman para transmitir mensagens que
chegam para o processo mailman local. Os processos writer (pode existir
mais de um em uma estao de trabalho de gerenciador de domnio) so
iniciados por pedidos para vincular (consulte link na pgina 355) e so
parados por pedidos para desvincular (consulte unlink na pgina 437)
(ou quando o mailman de comunicao encerrado).
mailman
Mailman o processo de Gerenciamento de Correio. Ele roteia mensagens
para estaes de trabalho local ou remota. Em um gerenciador de domnio,
processos mailman adicionais podem ser criados para dividir o
carregamento do mailman devido inicializao dos agentes e para
aprimorar a convenincia das mensagens. Quando o gerenciador de
domnio inicializado, ele cria uma instncia de processo mailman
separada para cada ServerID especificado nas definies da estao de
trabalho dos agente tolerante a falhass e dos agentes padro gerenciados.
Cada estao de trabalho contatada por seu prprio ServerID no
gerenciador de domnio. Para obter informaes adicionais, consulte
batchman
Batchman o processo de Controle de Produo. Ele interage diretamente
26
com a cpia do arquivo Symphony distribuda para as estaes de trabalho

no incio do perodo de produo e a atualiza. Batchman executa vrias
funes:
v
v
v
v
Gerencia localmente o processamento e a atualizao de planos.

Resolve dependncias de tarefas e de fluxos de tarefas.
Seleciona tarefas a serem executadas.
Atualiza o plano com os resultados de processamento de tarefa.
Batchman o nico processo que pode atualizar o arquivo Symphony.

jobman
Jobman o processo de Gerenciamento de Job. Ativa tarefas sob a direo
de batchman e relata o status da tarefa de volta ao mailman. responsvel
por controlar os estados da tarefa e pela configurao do ambiente
conforme definido nos scripts jobmanrc e .jobmanrc quando solicitada a
ativao de tarefas. Para obter informaes sobre esses scripts, consulte
Captulo 3, Configurando o Ambiente de Tarefa, na pgina 39. Quando o
processo jobman recebe uma mensagem de tarefa de ativao do
batchman, ele gera um processo de monitoramento de tarefa. O nmero
mximo de processos de monitoramento de job que podem ser gerados em
uma estao de trabalho definido pelo comando limit cpu a partir do
prompt de linha de comandos do conman (consulte limit cpu na pgina
353).
job monitor (jobman em UNIX, JOBMON.exe e joblnch.exe no sistema
operacional Windows)
O processo de monitoramento de tarefa executa primeiramente um
conjunto de aes que definem o ambiente antes que a tarefa seja
ativada e, em seguida, ativa a tarefa executando o arquivo de script
ou o comando especificado na definio de tarefa. Para obter
detalhes adicionais sobre como especificar o arquivo de script ou o
comando ativado com o job, consulte Tarefa na pgina 646.
As atividades de configurao consistem na ativao do arquivo de
configurao padro (TWS_home/jobmanrc no UNIX e
TWS_home/jobmanrc.cmd no Windows) que contm configuraes
que se aplicam a todas as tarefas em execuo na estao de
trabalho. Alm disso, nas estaes de trabalho UNIX, um script de
configurao local TWS_user/.jobmanrc ativado, se ele existir no
diretrio inicial do usurio que est ativando a tarefa. Esse arquivo
de configurao local contm configuraes que se aplicam
somente a jobs ativados pelo usurio especfico. Se qualquer uma
dessas etapas falhar, a tarefa termina no estado FAIL.
Ateno: Se, em sistemas Windows, existir uma varivel do
sistema chamada TEMP, o usurio TWS_user deve estar autorizado
para criar arquivos no diretrio no qual a varivel configurada.
Se esse requisito no for atendido, o arquivo binrio JOBMON.exe
falha em ser iniciado com sucesso.
Todos os processos, exceto jobman, so executados como TWS_user. Jobman
executado como raiz.
Em estaes de trabalho de agente padro, o processo batchman no ativado
porque esse tipo de estao de trabalho no gerencia o planejamento de job. Essas
estaes de trabalho somente ativam jobs na direo de seu gerenciador de
domnio. Localmente, na estao de trabalho, os processos de gerenciamento
Captulo 2. Entendendo Processos Bsicos da Estao de Trabalho
27
aguardam um pedido para ativar um job no gerenciador de domnio no modo

LISTEN. Quando o pedido recebido, o job ativado localmente e o resultado
retornado para o gerenciador de domnio. Para obter informaes adicionais sobre
estaes de trabalho de agente padro, consulte o IBM Tivoli Workload Scheduler:
Guia de Planejamento e Instalao.
O Figura 3 na pgina 29 mostra a rvore de processo nas estaes de trabalho do
Tivoli Workload Scheduler, diferente dos agentes padro, instalados no UNIX:
28
netman
monman
mailman
writer
ssmagent
batchman
serverA
(mailman)
jobman
monitor de tarefa
(jobman)
monitor de tarefa
(jobman)
monitor de tarefa
(jobman)
jobmanrc
jobmanrc
jobmanrc
.jobmanrc
.jobmanrc
.jobmanrc
arquivo de tarefa
arquivo de tarefa
arquivo de tarefa
Figura 3. rvore de Processos no UNIX
Figura 4 na pgina 30 mostra a rvore de processo nas estaes de trabalho Tivoli

Workload Scheduler, diferente dos agentes padro, instalados no Windows:
29
netman.exe
monman.exe
mailman.exe
ssmagent.exe
batchman.exe
writer.exe
serverA
(mailman.exe)
jobman.exe
jobmon.exe
joblnch.exe
joblnch.exe
joblnch.exe
Jobmanrc.cmd
Jobmanrc.cmd
Jobmanrc.cmd
arquivo
de tarefa
arquivo
de tarefa
arquivo
de tarefa
Figura 4. rvore de Processos no Windows
Em plataformas Windows, h um servio adicional, o Tivoli Token Service, que

permite que os processos Tivoli Workload Scheduler sejam ativados como se
fossem emitidos pelo usurio Tivoli Workload Scheduler.
30
Iniciando e Parando Processos em uma Estao de Trabalho

O tipo do sistema operacional instalado na estao de trabalho determina como os
processos do Tivoli Workload Scheduler podem ser iniciados a partir da linha de
comandos. A Tabela 2 explica como possvel iniciar e parar a infra-estrutura do
WebSphere Application Server e os processos do Tivoli Workload Scheduler em
uma estao de trabalho com base no sistema operacional instalado.
Tabela 2. Iniciando e Parando o Tivoli Workload Scheduler em uma Estao de Trabalho
Aes
Comandos utilizados na
plataforma UNIX
Iniciar todos os processos do

Tivoli Workload Scheduler,
conman start
incluindo WebSphere
conman startappserver
Application Server e o
conman startmon
mecanismo de monitoramento
de eventos.
Iniciar o netman e o
WebSphere Application
Server. No Windows, inicia
tambm o Tivoli Token
Service
Parar todos os processos do
Tivoli Workload Scheduler e
do WebSphere Application
Server.
com a exceo do WebSphere
Application Server.
plataforma Windows
conman start
conman startmon
./StartUp.sh
StartUp
conman shutdown
./stopWas.sh
conman shutdown -appsrv

shutdown -appsrv
conman shutdown
conman shutdown
shutdown
Iniciar todos os processos do conman start

com a exceo do WebSphere
Application Server e do
mecanismo de monitoramento
de eventos.
conman start

Tivoli Workload Scheduler,
exceto netman.
parada do conman
parada do conman
conman shutdown
conman shutdown
shutdown
./startWas.sh
ou
startWas
ou
./stopWas.sh
ou
conman stopappserver
stopWas
ou
conman stopappserver
Iniciar o mecanismo de
monitoramento de eventos
conman startmon
conman startmon
Parar o mecanismo de
monitoramento de eventos
conman stopmon
conman stopmon

(incluindo netman).
Iniciar o WebSphere
Application Server.
Parar o WebSphere
Application Server.
31
Tabela 2. Iniciando e Parando o Tivoli Workload Scheduler em uma Estao de

Trabalho (continuao)
Aes
plataforma UNIX
plataforma Windows
Iniciar o agente dinmico

localmente
./StartUpLwa.sh
Nota: pode ser
executado somente por
TWS_user ou pelo
usurio root.
startuplwa
Nota: No Windows 2008, deve
ser executado como
Administrador.
Parar o agente dinmico

localmente
./ShutDownLwa.sh
Nota: pode ser
TWS_user ou pelo
usurio root.
shutdownlwa
ser executado como
Administrador.
Nota: Nos sistema Windows, no utilize os servios do Windows para parar o

WebSphere Application Server. Em vez disso, utilize um dos comandos
listados nesta tabela. Se voc utilizar esses servios do Windows para parar
o WebSphere Application Server, o processo appserverman, que continua
sendo executado, o iniciar novamente.
Consulte StartUp na pgina 474 para obter informaes adicionais sobre o
comando utilitrio StartUp.
Consulte shutdown na pgina 473 para obter informaes adicionais sobre o
comando utilitrio shutdown.
Consulte o Guia de Administrao do IBM Tivoli Workload Manager para obter
informaes adicionais sobre os comandos startWas e stopWas.
Consulte start na pgina 408 para obter informaes adicionais sobre o comando
conman start.
Consulte stop na pgina 413 para obter informaes adicionais sobre o comando
conman stop.
Consulte shutdown na pgina 407 para obter informaes adicionais sobre o
comando conman shutdown.
Consulte startappserver na pgina 410 para obter informaes adicionais sobre o
comando conman startappserver.
Consulte stopappserver na pgina 416 para obter informaes adicionais sobre o
comando conman stopappserver.
Consulte startmon na pgina 412 para obter informaes adicionais sobre o
comando conman startmon.
Consulte stopmon na pgina 419 para obter informaes adicionais sobre o
comando conman stopmon.
Se o agente estiver instalado em um sistema Windows, o WebSphere Application
Server e os processos netman sero iniciados automaticamente no horrio de incio
dos servios juntamente com o Tivoli Token Service. Se o agente estiver instalado
em um sistema UNIX, o WebSphere Application Server e os processos netman
32
podero ser iniciados automaticamente no horrio de incio incluindo uma

instruo que chama Startup no arquivo /etc/inittab.
|
Iniciando e parando o agente dinmico
|
|
O tipo de sistema operacional instalado na estao de trabalho determina como os

agentes dinmicos podem ser iniciados a partir da linha de comandos.
Tabela 3. Iniciando e parando o agente dinmico
|
|
Aes
plataforma UNIX
plataforma Windows
|
|
|
|
|
Iniciar o agente dinmico

localmente
./StartUpLwa.sh
Nota: pode ser
TWS_user ou pelo
usurio root.
startuplwa
ser executado como
Administrador.
|
|
|
|
|
|
Parar o agente dinmico

localmente
./ShutDownLwa.sh
Nota: pode ser
TWS_user ou pelo
usurio root.
shutdownlwa
ser executado como
Administrador.
|
|
Para obter informaes adicionais sobre como parar e iniciar o agente dinmico,
consulte ShutDownLwa e StartUpLwa.
Comunicao Interprocesso de Estao de Trabalho

O Tivoli Workload Scheduler utiliza filas de mensagens para a comunicao local
entre os processos. H quatro arquivos de mensagens que residem no diretrio
TWS_home:
NetReq.msg
Esse arquivo de mensagens lido pelo processo netman para comandos
locais. Ele recebe mensagens como START, STOP, LINK e UNLINK.
Mailbox.msg
Esse arquivo de mensagens lido pelo processo mailman. Recebe
mensagens, por meio da interface grfica com o usurio (Dynamic
Workload Console ) ou do gerenciador de console (conman), recebidas dos
processos batchman e jobman locais e de outras estaes de trabalho do
Tivoli Workload Scheduler na rede.
Intercom.msg
Esse arquivo de mensagens lido pelo processo batchman e contm
instrues enviadas pelo processo local mailman.
Courier.msg
Esse arquivo de mensagens gravado pelo processo batchman e lido pelo
processo jobman.
|
|
|
PlanBox.msg
mecanismo.
|
|
|
Server.msg
mecanismo.
33
Entrada do operador
parada, incio ou
encerramento do
conman
Tivoli Dynamic
Workload Console
ou conman
NetReq.msg
Mailbox.msg
netman
netman efetua
spawn do escritor
para cada conexo
de entrada
writer
Do
mailman
remoto
mailman
Para
mailman
remoto
PlanBox.msg
Intercom.msg
batchman
Server.msg
Courier.msg
jobman
Figura 5. Comunicao entre os Processos
Esses arquivos possuem um tamanho mximo padro de 10 MB. O tamanho

mximo pode ser alterado usando o utilitrio evtsize (consulte evtsize na pgina
455).
Comunicao da Rede do Tivoli Workload Scheduler

O Tivoli Workload Scheduler utiliza o protocolo TCP/IP para comunicao de
rede. O nome de n e o nmero da porta usados para estabelecer a conexo
TCP/IP so configurados para cada estao de trabalho em sua definio da
estao de trabalho. Consulte o Definio de estao de trabalho na pgina 135
para obter detalhes adicionais.
Uma tecnologia armazenar e encaminhar usada pelo Tivoli Workload Scheduler
para manter consistncia e tolerncia a falhas a todo tempo pela rede, enfileirando
mensagens nos arquivos de mensagens enquanto a conexo no est ativa. Quando
a comunicao TCP/IP estabelecida entre sistemas, o Tivoli Workload Scheduler
34
fornece comunicao bidirecional entre estaes de trabalho usando links. Os links

so controlados pelo sinalizador autolink configurado em Definio de estao de
trabalho na pgina 135 e pelos comandos link na pgina 355 e unlink na
pgina 437 emitidos a partir do programa de linha de comandos conman.
Quando um link aberto, as mensagens so transmitidas entre duas estaes de
trabalho. Quando um link fechado, a estao de trabalho de envio armazena
mensagens em um arquivo de mensagens local e os envia para a estao de
trabalho de destino quando o link reaberto.
Existem basicamente dois tipos de comunicao que ocorrem no ambiente do
Tivoli Workload Scheduler, inicializao de conexo e entrega de eventos de
planejamento na forma de mensagens de alterao de estado durante o perodo de
processamento. Esses dois tipos de comunicao so explicados agora em detalhes.
Configurao de Inicializao de Conexo e de Comunicao Bidirecional
Estas so as etapas envolvidas no estabelecimento de um link bidirecional
do Tivoli Workload Scheduler entre um gerenciador de domnio e um
agente tolerante a falhas remoto:
1. No gerenciador de domnio, o processo mailman l o nome do host,
endereo TCP/IP e nmero de porta do agente tolerante a falhas a
partir do arquivo Symphony.
2. O processo mailman no gerenciador de domnio estabelece uma
conexo TCP/IP ao processo netman no agente tolerante a falhas
usando as informaes obtidas do arquivo Symphony.
3. O processo netman no agente tolerante a falhas determina que o
pedido recebido do processo mailman no gerenciador de domnio e
gera um novo processo writer para tratar da conexo recebida.
4. O processo mailman no gerenciador de domnio agora est conectado
ao processo writer no agente tolerante a falhas. O processo writer no
agente tolerante a falhas comunica o nmero de execuo atual de sua
cpia do arquivo Symphony para o processo mailman no gerenciador de
domnio. Esse nmero de execuo o identificador utilizado pelo
Tivoli Workload Scheduler para reconhecer cada arquivo Symphony
gerado pelo JnextPlan. Essa etapa necessria para o gerenciador de
domnio verificar se o plano atual j foi enviado ao agente tolerante a
falhas.
5. O processo mailman no gerenciador de domnio compara o nmero de
execuo de seu arquivo Symphony com o nmero de execuo do
arquivo Symphony no agente tolerante a falhas. Se os nmeros de
execuo forem diferentes, o processo mailman no gerenciador de
domnio envia ao processo writer no agente tolerante a falhas a cpia
mais recente do arquivo Symphony.
6. Quando o arquivo Symphony atual est no local no agente tolerante a
falhas, o processo mailman no gerenciador de domnio envia um
comando start ao agente tolerante a falhas.
7. O processo netman no agente tolerante a falhas inicia o processo
mailman local. Nesse ponto, um link de comunicao unidirecional
estabelecido a partir do gerenciador de domnio com o agente tolerante
a falhas.
8. O processo mailman no agente tolerante a falhas l o nome do host,
endereo TCP/IP e nmero da porta do gerenciador de domnio a
partir do arquivo Symphony e os utiliza para estabelecer o uplink de
volta para o processo netman no gerenciador de domnio.
35
9. O processo netman no gerenciador de domnio determina que o pedido

est vindo do processo mailman no agente tolerante a falhas, e gera um
novo processo writer para tratar da conexo recebida. O processo
mailman no agente tolerante a falhas agora conectado ao writer no
gerenciador de domnio e um link de comunicao bidirecional
estabelecido. Consequentemente, o processo writer no gerenciador de
domnio grava mensagens recebidas do agente tolerante a falhas no
arquivo Mailbox.msg no gerenciador de domnio, e o processo writer no
agente tolerante a falhas grava as mensagens do gerenciador de
domnio no arquivo Mailbox.msg no agente tolerante a falhas.
O evento de processamento e planejamento de tarefa so fornecidos em forma
de mensagens de mudana de estado durante o dia de processamento executado
localmente pelo agente tolerante a falhas
Durante o perodo de produo, o arquivo Symphony presente no agente
tolerante a falhas lido e atualizado com informaes de mudana de
estado sobre tarefas que so executadas localmente pelos processos da
estao de trabalho do Tivoli Workload Scheduler. Essas so as etapas
executadas localmente no agente tolerante a falhas para leitura e
atualizao do arquivo Symphony e para processar tarefas:
1. O processo batchman l um registro no arquivo Symphony que afirma
que job1 deve ser ativado na estao de trabalho.
2. O processo batchman grava no arquivo Courier.msg que job1 precisa
ser iniciado.
3. O processo jobman l essas informaes no arquivo Courier.msg,
inicia job1 e grava no arquivo Mailbox.msg que job1 foi iniciado com
seu process_id e timestamp.
4. O processo mailman l essas informaes em seu arquivo Mailbox.msg
e envia uma mensagem que o job1 foi iniciado com seu process_id e
timestamp para ambos, o arquivo Mailbox.msg no gerenciador de
domnio e o arquivo Intercom.msg local no agente tolerante a falhas.
5. O processo batchman no agente tolerante a falhas l a mensagem no
arquivo Intercom.msg e atualiza a cpia local do arquivo Symphony.
6. Quando o job job1 conclui o processamento, o processo jobman
atualiza o arquivo Mailbox.msg com as informaes de que job1 foi
concludo.
7. O processo mailman l as informaes no arquivo Mailbox.msg e envia
uma mensagem que o job1 concluiu para o arquivo Mailbox.msg no
gerenciador de domnio e o arquivo Intercom.msg local no agente
tolerante a falhas.
8. O processo batchman no agente tolerante a falhas l a mensagem no
arquivo Intercom.msg, atualiza a cpia local no arquivo Symphony e
determina a prxima tarefa a ser executada.
Para obter informaes sobre como ajustar o processamento de tarefa em uma
estao de trabalho, consulte o IBM Tivoli Workload Scheduler: Guia de Administrao.
Suporte para o Protocolo da Internet Verso 6

O Tivoli Workload Scheduler suporta o Protocolo da Internet verso 6 (IPv6) alm
do IPv4 legado. Para ajudar os clientes no estgio da transio de um ambiente
IPv4 para um ambiente IPv6 completo, o Tivoli Workload Scheduler fornece
suporte de pilha dupla IP. Em outros termos, o produto foi projetado para
comunicao utilizando endereos IPv4 e IPv6 simultaneamente com outros
aplicativos utilizando IPv4 ou IPv6.
36
Para este fim, as funes gethostbyname e gethostbyaddr foram eliminadas do

Tivoli Workload Scheduler j que elas suportam exclusivamente o IPv4. Elas foram
substitudas pela nova API getaddrinfo que torna o mecanismo cliente-servidor
inteiramente independente de protocolo.
A funo getaddrinfo manipula a converso de nome-para-endereo e de
servio-para-porta e retorna as estruturas sockaddr em vez de uma lista de
endereos. Estas estruturas sockaddr podem, ento, ser utilizadas pelas funes de
soquete diretamente. Desta maneira, getaddrinfo oculta todas as dependncias de
protocolo na funo de biblioteca, qual elas pertencem. O aplicativo lida somente
com as estruturas de endereo de soquete que so preenchidas por getaddrinfo.
37
38
Captulo 3. Configurando o Ambiente de Tarefa

Este captulo descreve como customizar a maneira que o gerenciamento de tarefa
executado em uma estao de trabalho. Esta customizao feita designando-se
localmente em cada estao de trabalho valores a variveis que tm um impacto no
processamento de jobman. Este captulo inclui as seguintes sees:
v Viso Geral do Ambiente de Tarefa
v Variveis de Ambiente Exportadas por jobman na pgina 40
v Customizando o Processamento da Tarefa em uma Estao de Trabalho UNIX jobmanrc na pgina 43
v Customizando o Processamento de Tarefas para um Usurio nas Estaes de
Trabalho UNIX - .jobmanrc na pgina 46
v Customizando o Processamento de Tarefa em uma Estao de Trabalho
Windows - jobmanrc.cmd na pgina 47
v Customizando Processamento de Tarefa em uma Estao de Trabalho com o
Windows - djobmanrc.cmd na pgina 49
Viso Geral do Ambiente de Tarefa

Em cada estao de trabalho, as tarefas so ativadas pelo processo de controle de
produo batchman. O processo batchman resolve todas as dependncias de
tarefas para assegurar a ordem correta do processamento da tarefa e, em seguida,
enfileira uma mensagem de ativao da tarefa para o processo jobman.
Cada um dos processos ativados por jobman, incluindo os scripts e as tarefas de
configurao, retm o nome do usurio registrado com o logon da tarefa. Tarefas
enviadas (tarefas, arquivos ou comandos enviados no atravs de um planejado,
mas manualmente por um usurio) mantm o nome do usurio que enviou.
O processo jobman inicia um processo de monitor de tarefa que comea
configurando um grupo de variveis de ambiente e, em seguida, executa um script
de configurao padro denominado TWS_home/jobmanrc, que pode ser
customizado. O script jobmanrc configura variveis que so usadas para configurar
localmente na estao de trabalho a maneira como as tarefas so ativadas,
independentemente do usurio.
Nas estaes de trabalho UNIX, se o usurio tiver permisso para utilizar um
script de configurao local e o script USER_HOME/.jobmanrc existir, o script de
configurao local .jobmanrc ser tambm executado. Em seguida, o job executado
pelo script de configurao padro ou pelo local. Os resultados do processamento
da tarefa so relatados para jobman, que, por sua vez, atualiza o arquivo
Mailbox.msg com as informaes sobre o status de concluso. Para que os jobs
sejam executados com o ambiente do usurio, inclua a seguinte instruo no script
de configurao local:
. $USER_home/.profile
Nota: Antes de incluir o .profile no arquivo .jobmanrc, certifique-se de que ele

no contenha nenhuma configurao stty ou nenhuma etapa que precise da
interveno manual do usurio. Caso haja, inclua no arquivo .jobmanrc
somente as etapas necessrias contidas no .profile.
39
Em estaes de trabalho com o Windows, o script de configurao local

djobmanrc.cmd executado se existir no diretrio Documentos e Configuraes do
usurio, que representado pela varivel de ambiente %USERPROFILE% e
depende da instalao do idioma do Windows. O script djobmanrc.cmd ser
executado pelo script jobmanrc.cmd.
|
|
|
|
|
Variveis de Ambiente Exportadas por jobman

As variveis listadas na Tabela 4 so configuradas localmente na estao de
trabalho e exportadas por jobman nos sistemas operacionais Windows:
Tabela 4. Variveis de Ambiente de Job para o Windows
40
Nome da Varivel
Valor
COMPUTERNAME
O valor de COMPUTERNAME definido no ambiente

do usurio.
HOME
O caminho onde a instncia do Tivoli Workload

Scheduler foi instalada.
HOMEDRIVE
O valor de HOMEDRIVE definido no ambiente do

usurio.
HOMEPATH
O valor de HOMEPATH definido no ambiente do

usurio.
LANG
O valor de LANG definido no ambiente do usurio.

Se no estiver definido, seu valor ser definido
como C.
LOGNAME
O nome do usurio de login.
MAESTRO_OUTPUT_STYLE
A configurao para o estilo de sada para nomes

longos de objetos.
SystemDrive
O valor de SYSTEMDRIVE definido no ambiente do

usurio.
SystemRoot
O valor de SYSTEMROOT definido no ambiente do

usurio.
TEMP
O valor de TEMP definido no ambiente do usurio.

Se no for especificado, seu valor ser definido
como c:\temp.
TIVOLI_JOB_DATE
A data planejada para um job.
TMPTEMP
O valor de TMP definido no ambiente do usurio.

Se no for especificado, seu valor ser definido
como c:\temp.
TMPDIR
O valor de TMPDIR definido no ambiente do

usurio. Se no for especificado, seu valor ser
definido como c:\temp.
TWS_PROMOTED_JOB
Aplica-se s funes de Garantia de Servio da

Carga de Trabalho. Pode ser YES ou No. Quando o
valor YES, significa que a tarefa (uma tarefa crtica
ou uma de suas predecessoras) foi promovida.
TZ
O fuso horrio, se ele foi configurado no ambiente

do sistema operacional.
UNISON_CPU
O nome desta estao de trabalho.
UNISON_DIR
O valor de UNISON_DIR definido no ambiente do

usurio.
UNISON_EXEC_PATH
O caminho completo de jobmanrc.
Tabela 4. Variveis de Ambiente de Job para o Windows (continuao)

Nome da Varivel
Valor
UNISONHOME
O caminho onde a instncia do Tivoli Workload

Scheduler foi instalada.
UNISON_HOST
O nome da CPU do host.
UNISON_JOB
O identificador de tarefa absoluto:

worktation#sched_id.job .
UNISON_JOBNUM
O nmero do job.
UNISON_MASTER
O nome da estao de trabalho principal.
UNISON_RUN
O nmero de execuo da produo atual do Tivoli

Workload Scheduler.
UNISON_SCHED
O nome do fluxo de tarefas.
UNISON_SCHED_DATE
A data de produo (aammdd) do Tivoli Workload

Scheduler relatada no cabealho do arquivo
Symphony.
UNISON_SCHED_ID
O jobstreamID do fluxo de tarefas que contm a

tarefa no processo.
UNISON_SCHED_IA
O StartTime do fluxo de tarefas que contm a tarefa

no processo.
UNISON_SCHED_EPOCH
A data de produo do Tivoli Workload Scheduler

expressa no formato de poca.
UNISON_SHELL
O shell de login do usurio executando a tarefa.
UNISON_STDLIST
O nome do caminho do arquivo de lista padro do

job.
UNISON_SYM
O nmero do registro Symphony da tarefa ativada.
USERDOMAIN
O valor de USERDOMAIN definido no ambiente do

usurio.
USERNAME
O valor de USERNAME definido no ambiente do

usurio.
USERPROFILE
O valor de USERPROFILE definido no ambiente do

usurio.
As variveis listadas na Tabela 5 so configuradas localmente na estao de

trabalho e exportadas por jobman nos sistemas operacionais UNIX:
Tabela 5. Variveis de Ambiente de Job para o UNIX
Nome da Varivel
Valor
HOME
O diretrio home do usurio.
LANG
O valor de LANG definido no ambiente do

usurio.
LD_LIBRARY_PATH
O valor de LD_LIBRARY_PATH definido no

ambiente do usurio.
LD_RUN_PATH
O valor de LD_LIBRARY_PATH definido no

ambiente do usurio.
LOGNAME
A configurao para o estilo de sada para

nomes longos de objetos.
PATH
/bin:/usr/bin
41
Tabela 5. Variveis de Ambiente de Job para o UNIX (continuao)

Nome da Varivel
Valor
TIVOLI_JOB_DATE
A data planejada para um job.
TWS_PROMOTED_JOB
Aplica-se s funes de Garantia de Servio

da Carga de Trabalho. Pode ser YES ou No.
Quando o valor YES, significa que a tarefa
(uma tarefa crtica ou uma de suas
predecessoras) foi promovida.
TWS_TISDIR
O valor de TWS_TISDIR definido no

ambiente do usurio.
TZ
O fuso horrio definido.
UNISON_CPU
O nome desta estao de trabalho.
UNISON_DIR
O valor de UNISON_DIR definido no

ambiente do usurio.
UNISON_EXEC_PATH
O caminho completo de .jobmanrc.
UNISONHOME
O caminho onde a instncia do Tivoli

Workload Scheduler foi instalada.
UNISON_HOST
O nome da CPU do host.
UNISON_JOB
O identificador de tarefa absoluto:

worktation#sched_id.job .
UNISON_JOBNUM
O nmero do job.
UNISON_MASTER
O nome da estao de trabalho principal.
UNISON_RUN
O nmero de execuo da produo atual

do Tivoli Workload Scheduler.
UNISON_SCHED
O nome do fluxo de tarefas.
UNISON_SCHED_DATE
A data de produo (aammdd) do Tivoli

Workload Scheduler relatada no cabealho
do arquivo Symphony.
UNISON_SCHED_ID
O jobstreamID do fluxo de tarefas que

contm a tarefa no processo.
UNISON_SCHED_IA
O StartTime do fluxo de tarefas que contm a

tarefa no processo.
UNISON_SCHED_EPOCH
A data de produo do Tivoli Workload

Scheduler expressa no formato de poca.
UNISON_SHELL
O shell de login do usurio executando a

tarefa.
UNISON_STDLIST
O nome do caminho do arquivo de lista

padro do job.
UNISON_SYM
O nmero do registro Symphony da tarefa

ativada.
Customizando Formatao de Dados no stdlist

possvel utilizar uma varivel de ambiente denominada
UNISON_DATE_FORMAT para especificar o formato de data que utilizada para
a data no cabealho e no rodap do arquivo stdlist. Essa varivel pode ser
configurada em estaes de trabalho UNIX e Windows e deve ser configurado
antes de iniciar processos do Tivoli Workload Scheduler na estao de trabalho
para tornar-se efetiva. Para configurar essa varivel, siga estas etapas:
42
Nas estaes de trabalho UNIX

1. Inclua a instruo para exportar a varivel UNISON_DATE_FORMAT
no arquivo .profile raiz.
2. Execute o arquivo .profile.
3. Execute conman shutdown e, em seguida, ./StartUp.sh.
Nas estaes de trabalho Windows
1. Em Propriedades do Sistema, configure UNISON_DATE_FORMAT na
Varvel do Sistema.
2. Execute conman shutdown e, em seguida, StartUp.
Esses so alguns exemplos das configuraes utilizadas para exibir o formato de
ano no campo de data no cabealho e no rodap do arquivo stdlist. A
configurao:
UNISON_DATE_FORMAT = "%a %x %X %Z %Y"
a sada produzida ter o seguinte formato:

Fri 15/10/04 11:05:24 AM GMT 2004
A configurao:
UNISON_DATE_FORMAT = "%a %x %X %Z"
a sada produzida ter o seguinte formato:

Fri 15/10/04 11:05:24 AM GMT
Defina essa varivel localmente em cada estao de trabalho para a qual voc
deseja exibir o formato de ano de 4 dgitos. Se omitido, utilizado o formato
padro de 2 dgitos.
Customizando o Processamento da Tarefa em uma Estao de

Trabalho UNIX - jobmanrc
Um gabarito de script de configurao padro chamado TWS_home/config/jobmanrc
fornecido com o Tivoli Workload Scheduler. Ele instalado automaticamente
como TWS_home/jobmanrc. Esse script pode ser utilizado pelo administrador do
sistema para configurar o ambiente desejado antes de cada tarefa ser executada.
Para alterar o script, faa as modificaes na cpia de job (TWS_home/jobmanrc),
deixando o arquivo de gabarito inalterado. O arquivo contm variveis que podem
ser configuradas e comentrios para ajud-lo a entender a metodologia. A Tabela 6
descreve as variveis de jobmanrc.
Tabela 6. Variveis Definidas por Padro no Arquivo jobmanrc
Nome da Varivel
Valor
UNISON_JCL
O nome do caminho do arquivo de script do

job.
UNISON_STDLIST
O nome do caminho do arquivo de lista

padro do job.
43
Tabela 6. Variveis Definidas por Padro no Arquivo jobmanrc (continuao)

Nome da Varivel
Valor
UNISON_EXIT
yes | no
Se definida como yes, o job ser finalizado
imediatamente se algum comando retornar
um cdigo de sada diferente de zero. Se
definida como no, o job continuar a ser
executado se um comando retornar um
cdigo de sada diferente de zero. Qualquer
outra definio ser interpretada como no.
LOCAL_RC_OK
yes | no
Se configurada como yes, o script de
configurao local do usurio ser executado
(se existir), transmitindo $UNISON_JCL
como o primeiro argumento. Essa opo
pode ser permitida ou negada ao usurio.
Consulte Customizando o Processamento
de Tarefas para um Usurio nas Estaes de
Trabalho UNIX - .jobmanrc na pgina 46
para obter informaes adicionais. Se
configurada como no, a presena de um
script de configurao local ser ignorada e
$UNISON_JCLser executado. Qualquer
outra definio ser interpretada como no.
MAIL_ON_ABEND
yes | no
Para os sistemas operacionais UNIX: Se
configurada como yes, ser enviada uma
mensagem para a caixa postal do usurio de
login se a tarefa for finalizada com um
cdigo de sada diferente de zero. Isso
tambm pode ser definido para um ou mais
nomes de usurio, separados por espaos,
para que uma mensagem seja enviada para
cada um deles. Por exemplo, "root mis sam
mary". Se definida como no, nenhuma
mensagem ser enviada se o job abortar. As
mensagens de aborto possuem o seguinte
formato:
cpu#sched.job
jcl-file falhou com exit-code
Please review standard-list-filename
possvel alterar o texto da mensagem ou
traduzir a mensagem para um outro idioma.
Para obter uma explicao de como fazer
isso, consulte Customizando a Seo
MAIL_ON_ABEND de jobmanrc na pgina
45.
44
Tabela 6. Variveis Definidas por Padro no Arquivo jobmanrc (continuao)

Nome da Varivel
Valor
SHELL_TYPE
standard|user|script
Se definida como standard, a primeira linha
do arquivo JCL ser lida para determinar
qual shell ser utilizado para executar o job.
Se a primeira linha no iniciar com #!,
/bin/sh ser utilizado para executar o script
de configurao local ou $UNISON_JCL. Os
comandos so ecoados para o arquivo de
lista padro do job. Se definida como user, o
script de configurao local ou
$UNISON_JCL ser executado pelo shell de
login do usurio ($UNISON_SHELL). Os
comandos so ecoados para o arquivo de
lista padro do job. Se configurada como
script, o script de configurao local ou
$UNISON_JCL ser executado diretamente e
os comandos no sero ecoados, a menos
que o script de configurao local ou
$UNISON_JCL contenha um comando set -x.
Qualquer outra definio ser interpretada
como standard.
USE_EXEC
yes | no
Se definida como yes, o job, ou o script de
configurao local do usurio ser executado
utilizando o comando exec eliminando,
assim, um processo extra. Essa opo ser
substituda se MAIL_ON_ABEND tambm
estiver configurada como yes. Qualquer
outra definio ser interpretada como no e,
nesse caso, o job ou script de configurao
local ser executado por outro processo de
shell.
Customizando a Seo MAIL_ON_ABEND de jobmanrc

possvel modificar o texto utilizado na mensagem enviada para os usurios
especificados no campo MAIL_ON_ABEND do arquivo de configurao
TWS_home/jobmanrc acessando esse arquivo e alterando o texto nas partes realadas
em negrito:
# Mail a message to user or to root if the job fails.
if [ "$MAIL_ON_ABEND" = "YES" ]
then
if [ $UNISON_RETURN -ne 0 ]
then
mail $LOGNAME <<-!
$UNISON_JOB
\$UNISON_JCL\ failed with $UNISON_RETURN
Please review $UNISON_STDLIST
!
fi
elif [ "$MAIL_ON_ABEND" = "ROOT" ]
then
then
45
mail root <<-!

$UNISON_JOB
!
fi
elif [ "$MAIL_ON_ABEND" != "NO" ]
then
then
mail $MAIL_ON_ABEND <<-!
$UNISON_JOB
!
fi
fi
Customizando o Processamento de Tarefas para um Usurio nas

Estaes de Trabalho UNIX - .jobmanrc
Nas estaes de trabalho UNIX, o script de configurao local .jobmanrc permite
que os usurios estabeleam um ambiente desejado ao processar suas prprias
tarefas. Diferentemente do script jobmanrc, o script .jobmanrc pode ser
personalizado para executar aes diferentes para usurios diferentes. Cada
usurio definido como tws_user pode customizar no diretrio inicial o script
.jobmanrc para executar aes de pr e ps-processamento. O script .jobmanrc
uma etapa extra que ocorre antes que o job seja realmente ativado.
O script .jobmanrc executado somente sob as seguintes condies:
v O script de configurao padro jobmanrc instalado e a varivel de ambiente
LOCAL_RC_OK configurada para yes (consulte a Tabela 6 na pgina 43).
v Se o arquivo TWS_home/localrc.allow existir, o nome do usurio dever aparecer
no arquivo. Se o arquivo TWS_home/localrc.allow no existir, o nome do usurio
no deve aparecer no arquivo TWS_home/localrc.deny. Se nenhum desses
arquivos existir, o usurio ter permisso para utilizar um script de configurao
local.
v O script de configurao local instalado no diretrio home do usurio
(USER_home/.jobmanrc) e possui permisso de execuo.
Os jobs no so executados automaticamente; o comando ou o script devem ser
ativados de dentro do .jobmanrc. Dependendo do tipo de atividade de processo
que voc deseja executar, o comando ou o script ativado de forma diferente. Siga
estas regras gerais ao ativar scripts a partir do .jobmanrc:
v Utilize eval se quiser ativar um comando.
v Utilize eval ou exec se quiser ativar um script que no precise de atividades
ps-processamento.
v Utilize eval se quiser ativar um script que precise de atividades
ps-processamento.
Se voc planeja utilizar um script de configurao local, ele dever, no mnimo,
executar o arquivo de script do job ($UNISON_JCL). O Tivoli Workload Scheduler
fornece um script de configurao padro, jobmanrc, que executa seu script de
configurao local da seguinte forma:
$EXECIT $USE_SHELL $USER_home/.jobmanrc "$UNISON_JCL" $IS_COMMAND
46
onde:
v O valor de USE_SHELL definido para o valor da varivel jobmanrc
SHELL_TYPE (consulte a Tabela 6 na pgina 43).
v IS_COMMAND configurado para yes se a tarefa tiver sido planejada ou
enviada na produo utilizando submit docommand.
v EXECIT ser configurado como exec se a varivel USE_EXEC estiver
configurada como yes (consulte a Tabela 6 na pgina 43), caso contrrio ele ser
nulo.
Todas as variveis exportadas no jobmanrc esto disponveis no shell .jobmanrc;
entretanto, as variveis que esto definidas, mas no exportadas, no esto
disponveis.
O seguinte exemplo mostra como executar o arquivo de script ou o comando de
um job, no script de configurao local:
#!/bin/ksh
PATH=TWS_home:TWS_home/bin:$PATH
export PATH
/bin/sh -c "$UNISON_JCL"
A seguir, o exemplo de um .jobmanrc que realiza o processamento com base no

cdigo de sada do job do usurio:
#!/bin/sh
#
PATH=TWS_home:TWS_home/bin:$PATH
export PATH
/bin/sh -c "$UNISON_JCL"
#or use eval "$UNISON_JCL" and the quotes are required
RETVAL=$?
if [ $RETVAL -eq 1 ]
then
echo "Cdigo de sada 1 - Erro No Fatal"
exit 0
elif [ $RETVAL -gt 1 -a $RETVAL -lt 100 ]
then
conman "tellop Este um erro de banco de dados - pagine o dba"
elif [ $RETVAL -ge 100 ]
then
conman "Tarefa tellop interrompida. Pagine o admin"
fi
Customizando o Processamento de Tarefa em uma Estao de

Trabalho Windows - jobmanrc.cmd
Um modelo de script de configurao padro denominado TWS_home\config\
jobmanrc.cmd fornecido com o Tivoli Workload Scheduler. Ele instalado
automaticamente como TWS_home\jobmanrc.cmd. Este arquivo de comando pode ser
utilizado para configurar o ambiente desejado antes de cada tarefa ser executada.
Para alterar o arquivo, faa suas modificaes na cpia de trabalho
(TWS_home\jobmanrc.cmd), deixando o arquivo de modelo inalterado. O arquivo
47
contm variveis que podem ser configuradas e comentrios para ajud-lo a

entender a metodologia. Tabela 7 descreve as variveis de jobmanrc.cmd.
|
Tabela 7. Variveis Definidas por Padro no Arquivo jobmanrc.cmd
Nome da Varivel
Valor
HOME
O caminho para o diretrio TWS_home
|
|
POSIXHOME
O caminho para o diretrio TWS_home em

um formato de reclamao de POSIX
||
|
|
|
|
|
|
LOCAL_RC_OK
v Se configurada para yes, o script de

configurao local do usurio executado,
se existente.
||
|
|
|
|
|
|
|
|
|
|
|
MAIL_ON_ABEND
v Se configurada para no, a presena de um

script de configurao local ignorada.
Qualquer outra definio ser interpretada
como no.
v Se for configurado como YES, um e-mail
ser enviado ao ID de e-mail definido na
varivel email_ID, se a tarefa terminar com
erro.
v Se for configurado com outro valor
diferente de YES ou NO, um e-mail ser
enviado ao ID de e-mail especificado
nesta varivel se a tarefa terminar com
erro.
v Se configurada para NO, nenhuma
mensagem enviada se a tarefa terminar
em erro.
|
|
|
|
Para obter detalhes adicionais, consulte

Customizando a Seo MAIL_ON_ABEND
de jobmanrc.cmd.
Customizando a Seo MAIL_ON_ABEND de jobmanrc.cmd
possvel modificar o texto usado na mensagem enviada para os usurios

especificados no campo MAIL_ON_ABEND do arquivo de configurao
TWS_home/jobmanrc.cmd acessando esse arquivo e alterando o texto nas partes
destacadas em negrito. Para esclarecer como gerar a mensagem de e-mail, usado
um programa de correio de amostra com o nome bmail.exe.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
if /I "%MAIL_ON_ABEND%"=="NO" (goto :out) else (goto :mail_on_abend)

:mail_on_abend
REM ******email, task or other action inserted here *******************
if /I "%MAIL_ON_ABEND%"=="YES" (goto :email) else (goto :email_spec)
:email
c:\"Program Files"\utils\bmail.exe -s smtp.yourcompany.com -t %EMAIL_ID%
-f %COMPUTERNAME%@yourcompany.com -h -a "Subject: Job %UNISON_JOB% abended"
-b "Job %UNISON_JOB% Job Number %UNISON_JOBNUM% abended"
goto :out
:email_spec
REM set > c:\tmp\abended_jobs\%UNISON_JOB%.j%UNISON_JOBNUM%
c:\"Program Files"\utils\bmail.exe -s smtp.yourcompany.com -t %MAIL_ON_ABEND%
-f %COMPUTERNAME%@yourcompany.com -h -a "Subject: Job %UNISON_JOB% abended"
-b "Job %UNISON_JOB% Job Number %UNISON_JOBNUM% abended
48
|
|
|
Customizando Processamento de Tarefa em uma Estao de Trabalho

com o Windows - djobmanrc.cmd
|
|
|
|
|
Nas estaes de trabalho com o Windows, possvel usar o script de configurao

local djobmanrc.cmd para estabelecer um ambiente especfico ao processar suas
tarefas customizadas. Diferentemente do script jobmanrc.cmd, possvel
customizar o script djobmanrc.cmd para executar diferentes aes para diferentes
usurios.
|
|
|
As condies a seguir se aplicam:

v O script deve conter todas as variveis de aplicativos de ambiente ou caminhos
necessrios para que o Tivoli Workload Scheduler seja ativado corretamente.
v O script deve existir se um ambiente especfico do usurio para execuo da
tarefa for necessrio ou se um e-mail deve ser enviado ao usurio de logon da
tarefa quando a tarefa Tivoli Workload Scheduler terminar com erro.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Para criar um script djobmanrc.cmd customizado, execute as etapas a seguir:

1. Efetue logon como o usurio que define variveis de ambiente para ativar
tarefas do Tivoli Workload Scheduler.
2. Abra um prompt de comandos do DOS.
3. Digite o comando set redirecionando a sada padro para um arquivo simples
denominado user_env.
4. Crie um arquivo denominado djobmanrc.cmd no diretrio Documentos e
Configuraes do usurio com o texto padro a seguir no incio:
@ECHO OFF
echo Invoking %USERNAME% DJOBMANRC.CMD V.1
set USERPROFILE=%USERPROFILE%
::Setup User Environment Phase
5. Edite o arquivo user_env criando na etapa 3.

6. Insira o comando set em cada linha antes de cada varivel de ambiente.
7. Inclua as mudanas na varivel PATH no final de djobmanrc.cmd em uma
sequncia semelhante seguinte:
set PATH=<TWSHOME>;<TWSHOME>\bin;%PATH%
8. Inclua o texto a seguir no final do arquivo user_env e substitua a sequncia ID

do e-mail do usurio com o ID de e-mail do usurio que recebe a notificao por
e-mail se a tarefa terminar com erro.
set EMAIL_ID=<user email id>
::Launch Operation Phase
%ARGS%
::Post Operations Phase
:out
9. Inclua o arquivo user_env atualizado no final do arquivo djobmanrc.cmd. O

arquivo djobmanrc.cmd editado deve ter a aparncia do exemplo a seguir:
@ECHO OFF
echo Invoking %USERNAME% DJOBMANRC.CMD V.1
set USERPROFILE=%USERPROFILE%
::Setup User Environment Phase
set ALLUSERSPROFILE=C:\Documents and Settings\All Users
set APPDATA=C:\Documents and Settings\petes\Application Data
set CommonProgramFiles=C:\Program Files\Common Files
set COMPUTERNAME=PSOTOJ
set ComSpec=C:\WINDOWS\system32\cmd.exe
set CURDRIVE=C
set FP_NO_HOST_CHECK=NOset
set HOMEDRIVE=c:
set HOMEPATH=\docs
set LOGONSERVER=\\PSOTOJ
set NEWVAR=c:\tmp\tmp\mlist1
set NUMBER_OF_PROCESSORS=1
49
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
set OPC_CLIENT_ROOT=C:\opc\Client
set OS=Windows_NT
set Path=C:\Program Files\utils;C:\PROGRAM
FILES\THINKPAD\UTILITIES;C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\Program
Files\IBM\Infoprint Select;C:\Utilities;C:\Notes;C:\Program Files\IBM\Trace Facility\;C:\Program
Files\IBM\Personal Communications\;C:\Program Files\XLView\;C:\lotus\compnent\;C:\WINDOWS\Downloaded
Program Files;C:\Program Files\Symantec\pcAnywhere\;"C:\Program Files\Symantec\Norton Ghost
2003\";C:\Infoprint;
set PATHEXT=.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH
set PCOMM_Root=C:\Program Files\IBM\Personal Communications\
set PDBASE=C:\Program Files\IBM\Infoprint Select
set PDHOST=
set PD_SOCKET=6874
set PROCESSOR_ARCHITECTURE=x86
set PROCESSOR_IDENTIFIER=x86 Family 6 Model 9 Stepping 5, GenuineIntel
set PROCESSOR_LEVEL=6
set PROCESSOR_REVISION=0905
set ProgramFiles=C:\Program Files
set PROMPT=$P$G
set SESSIONNAME=Console
set SystemDrive=C:
set SystemRoot=C:\WINDOWS
set TEMP=C:\DOCUME1\petes\LOCALS1\Temp
set TMP=C:\DOCUME1\petes\LOCALS1\Temp
set tvdebugflags=0x260
set tvlogsessioncount=5000
set TWS4APPS_JDKHOME=c:\win32app\TWS\pete\methods\_tools
set USERDOMAIN=PSOTOJ
set USERNAME=petes
set USERPROFILE=C:\Documents and Settings\petes
set windir=C:\WINDOWSPATH=c:\win32app\tws\twsuser:c:\win32app\tws\twsuser\bin:%PATH%
set PATH=c:\win32app\TWS\twsuser;c:\win32app\TWS\twsuser\bin;%PATH%
set EMAIL_ID=johndoe@yourcompany.com
%ARGS%
:out
|
|
A Launch Operations Phase no script onde o script, binrio ou comando definido

para a tarefa concludo. O texto %ARGS% obrigatrio.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
A Post Operations Phase no script onde um cdigo de sada da tarefa pode ser
reajustado do estado ABEND para o SUCC, alterando um cdigo de sada diferente
de zero para um cdigo de sada zero. Alguns aplicativos podem ter cdigos de
sada que podem ser avisos. O Tivoli Workload Scheduler avalia os cdigos de
sada como zero ou diferente de zero. Cdigos de sada zero indicam uma tarefa
no estado SUCC. Todos os outros cdigos indicam uma tarefa no estado ABEND.
Especifique que cdigos de sada diferentes de zero podem ser ajustados, se
necessrio. O exemplo a seguir mostra o que pode ser includo na Post Operations
Phase. O exemplo recupera o cdigo de sada da tarefa definida para determinar
como tratar itbased nas instrues If:
set EMAIL_ID=johndoe@yourcompany.com
%ARGS%
set RETVAL=%ERRORLEVEL%
if %RETVAL%==0 goto out
if %RETVAL%==1 set RETVAL=0
if %RETVAL%==6 set RETVAL=0
:out
exit %RETVAL%
Configurando Opes para Utilizao das Interfaces com o Usurio

Para usar o Dynamic Workload Console , os parmetros de conexo so fornecidos
no console e salvos como parte de sua configurao.
Para usar o Tivoli Workload Scheduler cliente da linha de comandos, necessrio
fornecer as informaes de configurao a seguir (chamadas de
connection_parameters) para conectar o gerenciador de domnio mestre por meio
de HTTP/HTTPS usando a infraestrutura do WebSphere Application Server:
50
hostname
O nome do host do gerenciador de domnio mestre.
nmero de porta
O nmero da porta usado ao estabelecer a conexo com o gerenciador de
domnio mestre.
username, password
As credenciais, nome de usurio e senha do TWS_user.
proxy hostname
O nome do host do proxy utilizado na conexo com o protocolo HTTP.
proxy port number
O nmero da porta do proxy utilizado na conexo com o protocolo HTTP.
protocol
O protocolo utilizado durante a comunicao. Pode ser HTTP com
autenticao bsica ou HTTPS com autenticao de certificado.
timeout
O tempo limite que indica o tempo mximo que o programa da interface
com o usurio que est conectando pode esperar pela resposta do
gerenciador de domnio mestre antes de considerar a solicitao de
comunicao como com falha.
default workstation
O nome da estao de trabalho do gerenciador de domnio mestre qual
deseja conectar.
SSL parameters
Se tiver configurado sua rede para usar SSL para se comunicar entre as
interfaces e o gerenciador de domnio mestre, tambm necessrio
fornecer o conjunto apropriado de parmetros SSL (que depende de como
seu SSL configurado).
No caso do cliente da linha de comandos instalado no gerenciador de domnio
mestre, essa configurao executada automaticamente na instalao.
Para o cliente da linha de comandos instalado em outras estaes de trabalho,
essas informaes podem ser fornecidas armazenando-as em arquivos de
propriedades nessas estaes de trabalho ou fornecendo as informaes como parte
da sequncia de caracteres de comando dos comandos usados.
Os arquivos de propriedades referidos so os arquivos localopts e useropts:
localopts
Isso contm um conjunto de parmetros aplicvel estao de trabalho
local para uma instncia especfica do produto instalado.
useropts
Isso contm um subconjunto dos parmetros localopts que tm valores
customizados para um usurio especfico. O caminho desse arquivo est
dentro do diretrio inicial do usurio, que mantm a privacidade dessas
informaes.
Como o Tivoli Workload Scheduler suporta diversas instncias de produtos
instaladas na mesma mquina, pode haver mais e uma instncia do
arquivo useropts de cada usurio. A possibilidade de ter mais arquivos
useropts, cada um com um nome diferente, fornece a capacidade de
51
especificar diferentes conjuntos de configuraes de conexo para usurios

definidos em mais de uma instncia do produto instalada na mesma
mquina.
No arquivo localopts de cada instncia do produto instalado, a opo
denominada useropts identifica o nome do arquivo useropts que precisa
ser acessado para conectar a essa instncia de instalao.
Isso significa que, se duas instncias do Tivoli Workload Scheduler forem
instaladas em uma mquina e um usurio do sistema denominado
operator for definido como usurio em ambas as instncias, ento no
arquivo localopts da primeira instncia, a opo local useropts =
useropts1 identifica o arquivo useropts1 que contm as configuraes de
parmetros de conexo que o usurio operator precisa para usar para
conectar a essa instncia do Tivoli Workload Scheduler. Por outro lado, no
arquivo localopts da segunda instncia do Tivoli Workload Scheduler, a
opo local useropts = useropts2 identifica o arquivo useropts2 que
contm as configuraes de parmetros de conexo que o usurio operator
precisa para usar para conectar a essa instncia do Tivoli Workload
Scheduler.
Detalhes completos sobre como configurar esse acesso so fornecidos no Tivoli
Workload Scheduler: Administration Guide, no tpico intitulado "Configurando
Autenticao de Acesso ao Cliente de Linha de Comandos"
52
Captulo 4. Gerenciando o Ciclo de Produo

A parte principal de uma soluo de gerenciamento e planejamento de tarefas a
criao e o gerenciamento do plano de produo. O plano de produo a lista de
afazeres que contm as aes a serem executadas em um intervalo de tempo
determinado nas estaes de trabalho da rede de planejamento utilizando os
recursos disponveis e preservando os relacionamentos e restries definidas.
Este captulo descreve como o Tivoli Workload Scheduler gerencia planos.
v Conceitos Bsicos de Gerenciamento de Planos
v Customizando o Gerenciamento de Planos Utilizando Opes Globais na
pgina 72
v
v
v
v
Criando e estendendo o plano de produo na pgina 76

Linha de Comandos Planman na pgina 79
Iniciando o Processamento do Plano de Produo na pgina 94
Automatizando o processamento do plano de produo na pgina 95
Conceitos Bsicos de Gerenciamento de Planos

O plano de produo contm informaes sobre as tarefas a serem executadas, em
qual agente tolerante a falhas e quais dependncias devem ser atendidas antes de
cada tarefa ser ativada. O Tivoli Workload Scheduler cria o plano de produo a
partir dos dados de modelagem do banco de dados e de um plano intermedirio
chamado plano de pr-produo. O plano de pr-produo criado e gerenciado
automaticamente pelo produto. Para evitar problemas, o banco de dados
bloqueado durante a gerao do plano e desbloqueado quando a gerao
concluda ou se ocorrer uma condio de erro. O plano de pr-produo
utilizado para identificar antecipadamente as instncias de fluxo de tarefas e as
dependncias de fluxo de tarefas follows externas envolvidas em um janela de
tempo especificada.
Voc utiliza o script JnextPlan no gerenciador de domnio mestre para gerar o
plano de produo e distribu-lo pela rede do Tivoli Workload Scheduler. Para
obter informaes adicionais sobre o script JnextPlan, consulte Criando e
estendendo o plano de produo na pgina 76.
Para gerar e iniciar um novo plano de produo, o Tivoli Workload Scheduler
executa as seguintes etapas:
1. Atualiza o plano de pr-produo com os objetos definidos no banco de dados
que foram includos ou atualizados desde a ltima vez que o plano foi criado
ou estendido.
2. Recupera do plano de pr-produo as informaes sobre o fluxo de tarefas a
ser executado no perodo de tempo especificado e salva o mesmo em um plano
de produo intermedirio.
3. Inclui no novo plano de produo os fluxos de tarefas incompletos do plano de
produo anterior.
4. Cria o novo plano de produo e armazena o mesmo em um arquivo
denominado Symphony.
53
5. Distribui uma cpia do arquivo Symphony para as estaes de trabalho

envolvidas no processamento do novo plano de produto.
6. Registra todas as estatsticas do plano de produo anterior em um archive
7. Atualiza os estados de fluxo de tarefas no plano pr-produo.
A cpia do novo arquivo Symphony gerado implementada a partir dos agente
tolerante a falhas do domnio inicial e dos gerenciadores de domnio dos domnios
filhos at todos os domnios subordinados abaixo na rvore.
Cada agente tolerante a falhas que recebe o plano de produo pode continuar o
processamento mesmo se a conexo de rede com seu gerenciador de domnio ficar
inativa.
Em cada agente tolerante a falhas de destino, os processos do Tivoli Workload
Scheduler executam as seguintes aes para gerenciar o processamento de tarefa:
1. Acessar a cpia do arquivo Symphony e ler as instrues sobre quais tarefas
executar.
2. Fazer chamadas ao sistema operacional para ativar tarefas conforme requeridas.
3. Atualizar sua cpia do arquivo Symphony com os resultados do processamento
de tarefa e enviar a notificao de volta ao gerenciador de domnio mestre e a
todos os agente tolerante a falhass com status completo. A cpia original do
arquivo Symphony armazenada no gerenciador de domnio mestre e as cpias
armazenadas nos gerenciador de domnio mestres de backup, se definidas, so
atualizadas conforme necessrio.
Isto significa que, durante o processamento de tarefa, cada agente tolerante a falhas
possui sua prpria cpia do arquivo Symphony atualizado com as informaes sobre
as tarefas que est executando (ou que esto em execuo em seu domnio e
domnios-filhos se o agente tolerante a falhas tiver o status completo ou um
gerenciador de domnio). Alm disso, o gerenciador de domnio mestre (e o
gerenciador de domnio mestre de backup, se definido) possui a cpia do arquivo
Symphony que contm todas as atualizaes provenientes de todos os agente
tolerante a falhass. Desta maneira, o arquivo Symphony no gerenciador de domnio
mestre mantido atualizado com as tarefas que devem ser executadas, as que
esto em execuo e as que foram concludas.
O processamento que ocorre em cada estao de trabalho envolvida nas atividades
do plano de produo atual descrito mais detalhadamente em Processos da
Estao de Trabalho do Tivoli Workload Scheduler na pgina 25.
Nota: Enquanto o plano de produo atual est em processo, qualquer alteraes
feitas no plano utilizando conman no afeta as definies no banco de
dados. Alteraes feitas nos objetos no banco de dados no afetam o plano
at o plano de produo ser estendido ou criado novamente utilizando o
script JnextPlan ou a interface de linha de comandos planman. As
atualizaes dos objetos no banco de dados no afetam instncias desses
objetos que j se encontram no plano de produo.
Plano de Pr-Produo
O plano de pr-produo utilizado para identificar antecipadamente as instncias
do fluxo de tarefas e as dependncias do fluxo de tarefas envolvidas em um
perodo de tempo especificado.
54
Isso aprimora o desempenho ao gerar o plano de produo preparando

antecipadamente um planejamento de alto nvel da carga de trabalho de produo
antecipada.
O plano de pr-produo contm:
v As instncias do fluxo de tarefas a serem executadas durante o intervalo de
tempo coberto.
v As dependncias follows externas que existem entre os fluxos de tarefa e as
tarefas includas nos fluxos de tarefa diferentes.
Uma tarefa ou fluxo de tarefas que no pode ser iniciado antes de outra tarefa ou
fluxo de tarefas externo especfico ser concludo com xito denominado sucessor.
Uma tarefa ou fluxo de tarefas externo que deve ser concludo com xito antes da
tarefa ou fluxo de tarefas sucessor poder ser iniciado denominado predecessor.
O Tivoli Workload Scheduler gera, expande e atualiza automaticamente, se
necessrio, o plano de pr-produo, executando as seguintes etapas:
v Remove as instncias do fluxo de tarefas nos estados COMPLETE e CANCEL.
v Seleciona todos os fluxos de tarefas planejados aps o final do plano de
produo atual e gera suas instncias.
v Resolve todas as dependncias de tarefa e de fluxo de tarefas, incluindo
dependncias follows externas de acordo com os critrios de correspondncia
definidos.
Para evitar conflitos, o banco de dados bloqueado durante a gerao do plano de
pr-produo e desbloqueado quando a gerao concluda ou se ocorrer uma
condio de erro.
Nesse estgio, somente os fluxos de tarefas com a hora na qual esto planejados
para iniciar e suas dependncias so destacados. Todas as demais informaes
sobre os fluxos de tarefas e os outros objetos de planejamento (calendrios,
prompts, domnios, estaes de trabalho, recursos, arquivos e usurios do
Windows) que estaro envolvidos no plano de produo para o perodo de tempo
no so includos, mas so recuperados do banco de dados assim que o plano de
produo for gerado.
Quando o plano de produo for estendido, as instncias de fluxo de tarefa antigas
so removidas automaticamente. Os critrios utilizados na remoo dessas
instncias levam em considerao estas informaes:
v A primeira instncia do fluxo de tarefas que no est no estado COMPLETE na
hora que o novo plano gerado (FNCJSI). Essa instncia do fluxo de tarefas
pode ser uma instncia planejada, que uma instncia includa no plano quando
o plano de produo gerado, e uma instncia do fluxo de tarefas, enviada da
linha de comandos durante a produo utilizando o comando conman sbs.
v O perodo de tempo entre a hora que FNCJSI est planejado para iniciar e o
horrio de encerramento do plano de produo antigo.
Supondo que T seja esse perodo de tempo, o algoritmo utilizado para calcular
quais instncias do fluxo de tarefas so removidas do plano de pr-produo o
seguinte:
if T < 7
Todas as instncias do fluxo de tarefas mais antigas do que 7 dias do
horrio de incio do novo plano de produo so removidas do plano de
55
pr-produo; todas as instncias do fluxo de tarefas mais prxima do que

7 dias do horrio de incio do novo plano de produo so mantidas
independentemente de seus estados.
if T > 7
Todas as instncias do fluxo de tarefas mais antigas do que FNCJSI so
removidas do plano de pr-produo; todas as instncias do fluxo de
tarefas mais recentes do que FNCJSI so mantidas.
Esse algoritmo utilizado para assegurar que o tamanho do plano de
pr-produo no aumente de forma contnua e, ao mesmo tempo, para assegurar
que nenhuma instncia do fluxo de tarefas que seja um predecessor em potencial
de um novo fluxo de tarefas includo no novo plano de pr-produo seja excluda.
Nota: Na terminologia do Tivoli Workload Scheduler para z/OS, o conceito que
corresponde ao plano de pr-produo LTP (Long Term Plan).
Identificando Instncias do Fluxo de Tarefas no Plano

Em verses anteriores 8.3, o plano tinha uma durao fixa de um dia. Desde a
verso 8.3, o plano pode cobrir um perodo que dura vrios dias ou menos de um
dia. Esta alterao incluiu a possibilidade de ter no mesmo plano mais de uma
instncia do mesmo fluxo de tarefas com o mesmo nome e tambm a necessidade
para definir uma nova conveno para identificar exclusivamente cada instncia do
fluxo de tarefas no plano. Cada instncia do fluxo de tarefas identificada no
plano pelos valores a seguir:
estao de trabalho
Especifica o nome da estao de trabalho na qual o fluxo de tarefas est
planejado para execuo.
jobstreamname
Corresponde ao nome do fluxo de tarefas utilizado nas verses anteriores
scheddateandtime
Representa quando a instncia do fluxo de tarefas est planejada para
iniciar no plano de pr-produo. Corresponde ao dia especificado no ciclo
de execuo configurado na definio do fluxo de tarefas por uma clusula
on e a hora configurada na definio do fluxo de tarefas por uma
palavra-chave at ou schedtime. Se configurada, a palavra-chave schedtime
utilizada somente para ordenar cronologicamente as instncias do fluxo
de tarefas no plano de pr-produo, enquanto que, se configurada, a
palavra-chave at tambm representa uma dependncia para o fluxo de
tarefas. Para obter informaes adicionais sobre essas palavras-chave,
consulte em na pgina 217, s na pgina 199 e schedtime na pgina
227.
Juntamente com esses dois valores que podem ser configurados na definio do
fluxo de tarefas, o Tivoli Workload Scheduler gera e designa um identificador
alfanumrico exclusivo para cada instncia do fluxo de tarefas, o jobstream_id,
para seu processamento interno. Para obter informaes adicionais sobre o formato
do jobstream_id, consulte showjobs na pgina 382.
possvel utilizar qualquer um dos dois tipos de identificadores,
workstation#jobstreamname e scheddateandtime, em vez de workstation#jobstream_id,
para identificar de forma exclusiva uma instncia do fluxo de tarefas ao gerenciar
fluxos de tarefas no plano, utilizando o programa de linha de comandos conman.
56
A conveno padro utilizada para identificar uma instncia do fluxo de tarefas,

neste guia e nas interfaces de linha de comandos do produto, a que utiliza
workstation#jobstreamname e scheddateandtime. Para obter informaes adicionais
sobre como especificar uma instncia de fluxo de tarefa em um comando
utilizando conman, consulte Selecionando Fluxos de Tarefas em Comandos na
pgina 322.
Gerenciando Dependncias de Acompanhamentos Externos

para Tarefas e Fluxos de Tarefas
Durante a criao do plano de pr-produo, todas as dependncias follows
externas para fluxos de tarefas e tarefas so resolvidas utilizando-se quatro critrios
de correspondncia diferentes possveis:
Mesmo dia
Considerando as instncias da tarefa ou do fluxo de tarefas planejadas para
execuo no mesmo dia. Neste caso, configure a clusula
follows...sameday na definio de objeto. Figura 6 mostra um fluxo de
tarefa denominado Js1 que possui uma dependncia follows externa na
instncia do fluxo de tarefa Js2 que est planejada para iniciar no mesmo
dia.
Js2
startOfDay
Js1
1 minuto antes
do prximo
startOfDay
Figura 6. Critrios de Correspondncia do Mesmo Dia
Abaixo h um exemplo de como definir os fluxos de tarefa envolvidos.

schedule Js2
on everyday
at 0700
:job2
fim
schedule Js1
on everyday
at 1000
follows wk1#Js2 sameday
:job1
fim
O fluxo de tarefa Js1 no ativado at que a instncia do fluxo de tarefas

de Js2 na estao de trabalho wk1 seja concluda com xito.
Closest preceding
Usando a tarefa mais prxima ou a instncia do fluxo de tarefas
(anteriormente ou mesmo horrio). A instncia da tarefa ou do fluxo de
tarefas que o Tivoli Workload Scheduler utiliza para resolver a
dependncia a mais prxima em tempo antes da instncia que inclui a
dependncia. Neste caso, voc configura a clusula follows ... previous na
definio de objeto. Figura 7 na pgina 58 mostra um fluxo de tarefa
denominado Js1 que possui uma dependncia follows externa na instncia
mais antiga mais prxima do fluxo de tarefa Js2. O perodo de tempo em
que o predecessor procurado esmaecido na figura.
57
Js2
Js1
Figura 7. Critrios de Correspondncia Anteriores Mais Prximos

schedule Js2
em Th
at 0700
:job2
fim
schedule Js1
em Fr
at 1000
follows wk1#Js2 previous
:job1
fim

precedente mais prxima de Js2 na estao de trabalho wk1 seja concluda
com xito.
Dentro de um intervalo relativo
Considerando as instncias da tarefa ou fluxo de tarefa definidas em um
intervalo com um deslocamento relativo ao horrio de incio da tarefa ou
fluxo de tarefa dependente. Por exemplo, de 25 horas antes do horrio de
incio do fluxo de tarefas dependente at 5 horas aps o horrio de incio
do fluxo de tarefas dependente. Neste caso, configure a clusula follows ...
relative from ... to ... na definio de objeto. A Figura 8 mostra um fluxo de
tarefas denominado Js1 que possui uma dependncia follows externa na
instncia do fluxo de tarefas de Js2 que inicia com um deslocamento de 2
horas em relao a Js1. A instncia a tarefa ou do fluxo de tarefas que o
Tivoli Workload Scheduler considera para resolver a dependncia a mais
prxima no intervalo de tempo relativo escolhido.
Js2
-2h
Js1
+2h
Figura 8. Nos Critrios de Correspondncia de um Intervalo Relativo

schedule Js2
on everyday
s 0900
:job2
fim
schedule Js1
on everyday
at 1000
follows wk1#Js2 relative from 0200 to
0200
:job1
fim

de Js2 na estao de trabalho wk1 que executada no intervalo de tempo
08h00 a 12h00 seja concluda com xito.
Dentro de um intervalo absoluto
Utilizando apenas as instncias de tarefa ou do fluxo de tarefas definidas
em um intervalo. Por exemplo, de hoje s 6h00 at o dia depois de amanh
58
s 5h59. Neste caso, voc configura a clusula follows ... from ... to ... na
definio de objeto. Figura 9 mostra um fluxo de tarefa denominado Js1
que possui uma dependncia follows externa na instncia do fluxo de
tarefa Js2 que est posicionado no plano de pr-produo entre 7h e 9h. A
instncia da tarefa e do fluxo de tarefas que o Tivoli Workload Scheduler
considera para resolver a dependncia a mais prxima no intervalo de
tempo absoluto escolhido. O intervalo de tempo especifica a hora do dia
na qual o intervalo comea e termina, no mesmo dia que a instncia que
inclui a dependncia ou em um dia definido como relativo para esse dia.
Js2
Js1
7a.m.
9a.m.
Figura 9. Nos Critrios de Correspondncia de um Intervalo Absoluto

schedule Js1
on everyday
at 0800
:job2
fim
schedule Js2
on everyday
at 1000
follows wk1#Js1 from 0700 to 0900
:job1
fim

de Js2 na estao de trabalho wk1 que executada no intervalo de tempo
das 7h s 9h no mesmo dia seja concluda com xito.
Independentemente de quais critrios correspondentes so utilizados, se vrias
instncias de fluxos de tarefas do predecessor em potencial existirem no intervalo
de tempo especificado, a regra utilizada pelo produto para identificar a instncia
do predecessor correta ser a seguinte:
1. Tivoli Workload Scheduler procura a instncia mais prxima que precede o
horrio de incio da tarefa ou do fluxo de tarefas dependente. Se uma instncia
desse tipo existir, esta ser a instncia do predecessor.
2. Se no houver instncia precedente, o Tivoli Workload Scheduler considerar a
instncia do predecessor correta como a instncia mais prxima iniciada aps o
horrio de incio da tarefa ou do fluxo de tarefas dependente.
Esse comportamento aplica-se s dependncias follows externas entre fluxos de
tarefas. Para dependncias follows externas de um fluxo de tarefas ou tarefa a
partir de outra tarefa, os critrios so correspondidos pela considerao do horrio
de incio do fluxo de tarefas que faz o hosting da tarefa predecessora em vez do
horrio de incio da prpria tarefa predecessora. A Figura 10 na pgina 60 mostra
em negrito as instncias job1 das quais a tarefa ou o fluxo de tarefas sucessor
depende.
59
Js1
job1
Js1
job1
Tarefa do sucessor ou
fluxo de tarefas
Figura 10. Tarefa Predecessora Anterior Mais Prxima
As dependncias follows externas so identificadas entre tarefas e fluxos de tarefas

armazenados no banco de dados cujas instncias so includas no plano de
pr-produo quando o plano de pr-produo criado ou estendido
automaticamente. As instncias da tarefa e do fluxo de tarefas enviadas na
produo a partir da linha de comandos conman so gravadas no plano de
pr-produo mas elas no so utilizadas para recalcular os predecessores de
dependncias follows externas j resolvidas no plano de pr-produo.
O planejador classifica dependncias follows como internas quando so
especificadas apenas por seu nome da tarefa dentro do fluxo de tarefas. Ele
classifica-as como externas quando so especificadas no formato
jobStreamName.workstationName.jobName.
Quando um fluxo de tarefas inclui uma tarefa com uma dependncia de sequncia
que compartilha o mesmo nome de fluxo de tarefas (por exemplo, o fluxo de
tarefas schedA inclui uma tarefa denominada job6 que tem uma dependncia de
sequncia em schedA.job2), a dependncia includa no plano como uma
dependncia de sequncia externa. Desde a Verso 8.3, ao contrrio das verses
anteriores, porque o planejador usa os critrios de correspondncia mesmo dia para
resolver dependncias externas, dependncias originadas dessa maneira nunca so
includas da primeira vez que o objeto enviado.
Uma tarefa ou um fluxo de tarefas ainda no includo no plano de produo, mas
que pode ser um predecessor em potencial de instncias de tarefas e de fluxos de
tarefas, includo no plano de produo medida que o plano de produo
estendido, chamado de predecessor pendente. Um predecessor pendente como
uma ocorrncia simulada criada pelo processo de planejamento para honrar uma
dependncia que foi resolvida no plano de pr-produo, mas isso no pode ser
resolvido no plano de produo, pois o horrio de incio do predecessor no est
dentro do horrio de encerramento do plano de produo atual. A Figura 11
mostra como um predecessor pendente e seu sucessor so posicionados no plano
de pr-produo.
Predecessor
pendente
Sucessor
Fim do
Plano de Produo
Figura 11. Instncia do Predecessor Pendente
60
A maneira como os predecessores pendentes so gerenciados est estritamente

vinculada a se a tarefa ou o fluxo de tarefas sucessor teve ou no o saldo
transportado:
v Se o sucessor tiver o saldo transportado quando o plano de produo for
estendido, o predecessor includo no novo plano de produo e a dependncia
torna-se atual. Uma tarefa ou um fluxo de tarefas de predecessor pendente
marcado com [P] na coluna Dependncias, na sada dos comandos conman
showjobs e conman showschedules.
v Se o sucessor no tiver o saldo transportado adiante quando o plano de
produo for estendido, o predecessor includo no novo plano de produo,
mas a dependncia torna-se rf. Isso pode ocorrer, por exemplo, se, ao estender
o plano de produo, o sucessor tiver o saldo transportado e o predecessor
pendente no for includo no plano, pois foi sinalizado como rascunho no banco
de dados. As dependncias rfs so marcadas com [O] na coluna Dependncias,
na sada do comando conman showjobs. Ao lidar com uma dependncia rf,
voc deve verificar se pode ser liberada e, nesse caso, cancel-la.
Observe que quando uma rede do Tivoli Workload Scheduler inclui agentes que
esto executando verses mais antigas que 8.3 e a opo enLegacyId est
configurada para yes no gerenciador de domnio principal, ter vrias instncias de
um fluxo de tarefas como predecessores pendentes produz os erros causados por
problemas de identificao no momento do envio.
Exemplos de Resoluo de Dependncia de Sequncia Externa e

de Transio de Status
Esta seo inclui exemplos para cada um dos quatro critrios de correspondncia
descritos nos pargrafos anteriores. Em todos os exemplos, o horrio de incio do
dia (SOD) est configurado para 6h.
Mesmo dia
A instncia da tarefa ou do fluxo de tarefas a ser considerada na resoluo
da dependncia a mais prxima no mesmo dia em que a instncia que
inclui a dependncia est programada para execuo. Neste exemplo, dois
fluxos de tarefas, Js1 e Js2, tm, cada um, uma tarefa. O fluxo de tarefas
Js1 est planejado para execuo todo dia s 8h e nas quintas-feiras
tambm s 7h. Js1.Job1 executada s 9h. O fluxo de tarefas Js2 no tem
nenhuma restrio de tempo e esta planejado por padro no horrio de
incio do dia definido. A Js2.Job2 est planejada para execuo s 15h e
tem uma dependncia de sequncia externa na instncia anterior mais
prxima do fluxo de tarefas Js1 em execuo no mesmo dia. Os dois fluxos
de tarefas so definidos desta maneira:
SCHEDULE MY_MASTER#JS1
ON RUNCYCLE RULE1 "FREQ=WEEKLY;BYDAY=TH"
(AT 0700)
ON RUNCYCLE RULE2 "FREQ=DAILY"
(AT 0800)
:
MY_MASTER#JOB1
AT 0900
END
ON RUNCYCLE RULE2 "FREQ=DAILY;"
FOLLOWS MY_MASTER#JS1.@ SAMEDAY
61
:
MY_MASTER#JOB2
AT 1500
END
Quando os planejamentos so includos no plano, a sequncia de grficos

ilustra como a dependncia resolvida:
1. Nas quintas-feiras, a instncia de Js2 planejada s 6h depende da
instncia de Js1 planejada para execuo s 7h. Em qualquer outro dia
da semana, Js2 tem uma dependncia da instncia de Js1 planejada s
8h. A Figura 12 mostra o status dos fluxos de tarefas no plano s 6h
(SOD) na quinta-feira:
05:59
SOD = 06:00
Suspender
Ready
Ready
Js1
Js2
(06:00)
Js1.job1
Js1
(08:00)
(07:00)
Suspender
(09:00)
Suspender
Js2.job2
(15:00)
Figura 12. Critrios de Correspondncia no Mesmo Dia - Etapa 1: no Incio do Dia (SOD) em
uma Quinta-feira
2. s 9h, Js1.job1 inicia e Js1 altera o status. Js2.job2 retida at seu

horrio planejado. A Figura 13 mostra o status dos fluxos de tarefas no
plano s 9h.
05:59
SOD = 06:00
Suspender
Js2
(06:00)
Iniciado
Js1
(07:00)
Iniciado
Js1
(08:00)
Iniciado
Suspender
Js1.job1
Js2.job2
(09:00)
(15:00)
Figura 13. Critrios de Correspondncia no Mesmo Dia - Etapa 2: s 9h
3. Nas quintas-feiras s 15h, Js2 altera para o status pronto e Js2.job2

inicia. A Figura 14 na pgina 63 mostra o status dos dois fluxos de
tarefas no plano s 15h.
62
05:59
SOD = 06:00
Ready
Js2
(06:00)
Iniciado
Suspender
Succ
Iniciado
Js1
Js1.job1
Js1.job1
Js2.job2
(08:00)
(09:00)
(15:00)
(07:00)
Figura 14. Critrios de Correspondncia no Mesmo Dia - Etapa 3: s 15h
Closest preceding
v Neste exemplo, dois fluxos de tarefas, Js1 e Js2, tm, cada um, uma
tarefa. A tarefa em Js2 tem uma dependncia de sequncia externa na
instncia anterior mais prxima da tarefa em Js1. Os dois fluxos de
tarefas so definidos desta maneira:
(AT 0800)
ON RUNCYCLE RULE2 "FREQ=WEEKLY;BYDAY=TH,FR"
(AT 0900)
:
MY_MASTER#JOB1
END
(AT 1200)
FOLLOWS MY_MASTER#JS1.@ PREVIOUS
:
MY_MASTER#JOB2
AT 1500
END
O fluxo de tarefas Js1 executado todo dia s 8h e quintas-feiras e

sextas-feiras s 9h. O fluxo de tarefas Js2 executado todo dia s 12h e
tem uma dependncia externa na instncia anterior mais prxima Js1.
Quando os fluxos de tarefas so includos no plano, a sequncia de
grficos ilustra como a dependncia resolvida:
1. Antes das 12h nas quintas-feiras e sextas-feiras, h duas instncias de
Js1.Job1. O fluxo de tarefas Js2 tem uma dependncia na instncia
Js1.Job1 que est planejada para execuo s 9h, pois a anterior
mais prxima em termos de horrio. A Figura 15 na pgina 64 mostra
o status dos dois fluxos de tarefas no plano em quintas-feiras e
sextas-feiras.
63
05:59
SOD = 06:00
Ready
Ready
Suspender
Js1.job1
Js1.job1
Js2
(08:00)
(09:00)
(12:00)
Suspender
Js2.job2
(15:00)
Figura 15. Critrios de Correspondncia Anteriores Mais Prximos - Etapa 1: antes da 8h
2. Em qualquer outro dia da semana, a nica instncia de Js1.Job1 no

plano a planejada para execuo s 8h. Nesse caso, Js2 tem uma
dependncia dessa instncia. Quando Job1 for concluda com
sucesso, o status de Js2 torna-se Pronto. A Figura 16 mostra o status
dos dois fluxos de tarefas no plano em qualquer outro dia da
semana, exceto quintas-feiras e sextas-feiras.
05:59
SOD = 06:00
Ready
Succ
Js1.job1
Js2
(08:00)
(12:00)
Suspender
Js2.job2
(15:00)
Figura 16. Critrios de Correspondncia Anteriores Mais Prximos - Etapa 2: s 8h em Dias

da Semana, Exceto Quintas-feiras e Sextas-feiras
3. Nas quintas-feiras e sextas-feiras s 9h, a segunda instncia de

Js1.Job1 concluda com sucesso. O fluxo de tarefas Js2 alterado
para Pronto. Js2.Job2 retida at seu horrio de incio planejado. A
Figura 17 mostra o status dos dois fluxos de tarefas no plano.
05:59
SOD = 06:00
Succ
Succ
Ready
Js1.job1
Js1.job1
Js2
(08:00)
(09:00)
(12:00)
Suspender
Js2.job2
(15:00)
Figura 17. Critrios de Correspondncia Anteriores Mais Prximos - Etapa 3: s 9h nas

Quintas-feiras e Sextas-feiras
4. s 15h, a dependncia de horrio de Js2.Job2 satisfeita e Job2

iniciada. A Figura 18 na pgina 65 mostra o status dos dois fluxos de
tarefas no plano s 15h.
64
05:59
SOD = 06:00
Succ
Succ
Iniciado
Js1.job1
Js1.job1
Js2
(08:00)
(09:00)
(12:00)
Iniciado
Js2.job2
(15:00)
Figura 18. Critrios de Correspondncia Anteriores Mais Prximos - Etapa 4: s 15h Todo
Dias
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Na definio de fluxo de tarefas, o ciclo de execuo Rule1 pode ser

substitudo pelas palavras-chave ON EVERYDAY.
v Neste segundo exemplo, descrita a diferena entre o uso dos critrios
de correspondncia sameday e closest preceding em um plano. O fluxo
de tarefas Js1 executado todas as Sextas-feiras s 0900, enquanto que
os fluxos de tarefas Js2 e Js3 executam todos os Sbados s 0900. Os
trs fluxos de tarefas so definidos desta forma:
SCHEDULE
ACCOUNTING#JS1
ON RUNCYCLE RULE1 "FREQ=WEEKLY;BYDAY=FR"
:
ACCOUNTING#JOB1
AT 0900
END
SCHEDULE ACCOUNTING#JS2
ON RUNCYCLE RULE2 "FREQ=WEEKLY;BYDAY=SA"
FOLLOWS ACCOUNTING#JS1.@ PREVIOUS
:
ACCOUNTING#JOB1
AT 0900
END
SCHEDULE ACCOUNTING#JS3
ON RUNCYCLE RULE2 "FREQ=WEEKLY;BYDAY=SA"
FOLLOWS ACCOUNTING#JS1.@
:
ACCOUNTING#JOB1
AT 0900
END
O fluxo de tarefas Js2 possui uma dependncia externa na instncia de

precedncia mais prxima de Js1, o que resolvido como descrito no
exemplo anterior. O fluxo de tarefas Js3 est definido com critrios de
correspondncia sameday, assim ele no possui nenhuma dependncia no
fluxo de tarefas Js1, pois Js1 no est configurado para ser executado no
mesmo dia que Js2.
Neste exemplo, a instncia da tarefa ou do fluxo de tarefas considerada
para resolver a dependncia a mais prxima em um intervalo de tempo
de sua opo, que definido com relao ao ao horrio em que a instncia
que inclui a dependncia est planejada para execuo. O fluxo de tarefas
Js1 est planejado para execuo todo dia s 15h e nas quintas-feiras
tambm s 8h. Js2 est planejado para execuo todo dia s 13h em nas
quintas-feiras s 6h, como nenhum horrio especfico est definido no ciclo
65
de execuo, ele planejado para o horrio de incio do dia. Js2 usa os

critrios de intervalo relativos (-04:00 to +04:00) para determinar qual
instncia usada para resolver a dependncia. O intervalo baseado no
horrio em que o fluxo de tarefas entra no plano. Os fluxos de tarefas so
definidos da seguinte forma:
(AT 0800)
(AT 1500)
:
MY_MASTER#JOB1
END
(AT 1300)
FOLLOWS MY_MASTER#JS1.@
RELATIVE FROM -0400 TO 0400
:
MY_MASTER#JOB2
AT 1300
END
No horrio de criao do plano, conman showjobs produz a seguinte

sada:
%sj @#@
(Est) (Est)
CPU
Schedule SchedTime Job State Pr Start Elapse RetCode Deps
MY_MASTER#JS1
0800 11/13 ******** READY 10
(00:06)
JOB1
HOLD 10
(00:06)
MY_MASTER#JS1
1500 11/13 ******** READY 10
(00:06)
JOB1
HOLD 10
(00:06)
MY_MASTER#JS2
0600 11/13 ******** HOLD 10
JS1(0800 11/13/09).@
JOB2
HOLD 10(13:00)
MY_MASTER#JS2
1300 11/13 ******** HOLD 10(13:00)
JS1(1500 11/13/09).@
JOB2
HOLD 10(13:00)
A Figura 19 mostra o status dos fluxos de tarefas no plano no incio do dia

na quinta-feira.
- 0400
SOD = 06:00
Suspender
Js2
(06:00)
- 0400
Ready
Js1.job1
(08:00)
+ 0400
+ 0400
Suspender
Js2.job2
(13:00)
05:59
Ready
Js1.job1
(15:00)
Figura 19. Critrios de Correspondncia de Intervalo Relativo - no Incio do Dia na

Quinta-feira
A instncia de Js2 planejada s 6h tem uma dependncia de Js1.job1 que

est planejada s 8h, dentro do intervalo relativo com base no horrio
planejado (6h). Js2.job2 depende da instncia de Js1.job1 dentro do
intervalo relativo com base no horrio planejado (13h). Quando a instncia
66
de Js1.job1 inicia s 8h, o status de Js2 alterado para Pronto. A partir

desse ponto, a sequncia na qual os fluxos de tarefas e tarefas so
executados segue o processo tpico.
Neste exemplo, a instncia da tarefa ou do fluxo de tarefas considerada
para resolver a dependncia a mais prxima em um intervalo de tempo
fixo de sua opo. O intervalo de tempo especifica o horrio do dia no
qual o intervalo comea e o horrio do dia no qual termina, no mesmo dia
que a instncia que inclui a dependncia ou em um dia definido com
relao a essa data. Js1 est planejado para execuo todo dia s 8h e nas
quintas-feiras tambm s 7h. A tarefa Js1.job1 est planejada para
execuo s 9h. O fluxo de tarefas Js2 est planejado todo dias s 10h e
nas quintas-feiras tambm no incio do dia (6h) e tem uma dependncia de
Js1 com base no intervalo absoluto que ocorre no mesmo dia entre 6h e
11h. Os fluxos de tarefas so definidos da seguinte forma:
(AT 0700)
(AT 0800)
:
MY_MASTER#JOB1
AT 0900
END
(AT 1000)
FOLLOWS MY_MASTER#JS1.@ FROM 0600 TO 1100
:
MY_MASTER#JOB2
AT 1300
END
No horrio de criao do plano, conman showjobs produz a seguinte

sada:
%sj @#@
(Est) (Est)
CPU
Schedule SchedTime Job State Pr Start Elapse RetCode Deps
MY_MASTER#JS1
0700 11/13******** READY 10
(00:06)
JOB1
HOLD 10(09:00)(00:06)
MY_MASTER#JS1
0800 11/13 ******** READY 10
(00:06)
JOB1
HOLD 10(09:00)(00:06)
MY_MASTER#JS2
0600 11/13 ******** HOLD 10
JS1(0700 11/13/09).@
JOB2
HOLD 10(15:00)
MY_MASTER#JS2
1000 11/13 ******** HOLD 10(10:00)
JS1(0800 11/1309).@
JOB2
HOLD 10(15:00)
A Figura 20 na pgina 68 mostra o status dos fluxos de tarefas no plano no

incio do dia na quinta-feira.
67
05:59
SOD = 06:00
06:00 AM
Hold
Js2
(06:00)
11:00 AM
Ready
Js1
(07:00)
Ready
Js1
(08:00)
Hold
Hold
Hold
Js1.job1
Js2
Js2.job2
(09:00)
(10:00)
(15:00)
Figura 20. Critrios de Correspondncia de Intervalo Absoluto - no Incio do Dia na

Quinta-feira
s 9h, Js1.job1 iniciado, e s 10h, a dependncia liberada e Js2 fica

pronto. A partir desse ponto, a sequncia a mesma que a descrita nos
critrios de correspondncia anteriores.
Plano de Produo
Aps ter criado ou atualizado o plano de pr-produo, o Tivoli Workload
Scheduler conclui as informaes armazenadas no plano de pr-produo com as
informaes armazenadas no banco de dados sobre as operaes a serem
desempenhadas no perodo de tempo selecionado e os outros objetos de
planejamento envolvidos ao processar o plano e copia-o em um novo arquivo
Symphony. Tambm inclui nesse arquivo as dependncias entre planos, como fluxos
de tarefas com saldo transportado do plano de produo j processado e arquiva o
arquivo Symphony antigo no diretrio schedlog.
No final desse processo, o novo arquivo Symphony contm todas as informaes que
implementam o novo plano de produo.
Uma cpia do novo arquivo Symphony distribuda a todas as estaes de trabalho
envolvidas na execuo de tarefas ou fluxos de tarefas para esse plano de
produo.
No arquivo de segurana, a autorizao do usurio necessria para gerar o plano
de produo a palavra-chave de acesso build nos arquivos prodsked e Symphony.
Nota: Para evitar a execuo com falta de espao em disco, lembre-se que cada
instncia da tarefa ou do fluxo de tarefas aumenta o tamanho do arquivo
Symphony em 512 bytes.
Para obter informaes sobre como gerar o plano de produo, consulte Criando e
estendendo o plano de produo na pgina 76.
Entendendo as Opes de Transporte de Saldo

Os fluxos de tarefas tm o saldo transportado quando o plano de produo
gerado. Como o fluxo de tarefas tem o saldo transportado depende de:
v A palavra-chave carryforward no fluxo de tarefas. Consulte carryforward na
pgina 200.
v A opo global enCarryForward. Consulte o Guia de Administrao do IBM Tivoli
Workload Scheduler.
68
v A palavra-chave da linha de comandos stageman -carryforward. Consulte O

comando stageman na pgina 89.
v A opo global carryStates. Consulte o Guia de Administrao do IBM Tivoli
Workload Scheduler.
A Tabela 8 mostra como as opes globais de transporte de saldo funcionam juntas.
Tabela 8. Configuraes das Opes Globais do Saldo Transportado
Opes Globais
Operao de transporte
enCarryForward=all
carryStates=()
Os fluxos de tarefas tm o saldo transportado somente

se no tiverem sido concludos. Todos os jobs so
transportados com os fluxos de job. Essa a
configurao padro.
enCarryForward=no
Nenhum fluxo de job transportado. Se esta opo

estiver configurada como no, a execuo de tarefas
transferida para o fluxo de tarefas USERJOBS.
enCarryForward=yes
carryStates=(states)
Os fluxos de tarefa tem o saldo transportado somente se

tiverem ambas tarefas nos estados especificados e a
palavra-chave carryforward configurada na definio do
fluxo de tarefa. Apenas os jobs nos estados especificados
so transportados com os fluxos de jobs.
enCarryForward=yes
carryStates=()
Os fluxos de tarefas tm o saldo transportado somente

se eles no tiverem sido concludos e tiverem a
palavra-chave carryforward configurada na definio do
fluxo de tarefas. Todos os jobs so transportados com os
fluxos de job.
enCarryForward=all
carryStates=(states)
Os fluxos de job so transportados apenas se tiverem

jobs nos estados especificados. Apenas os jobs nos
estados especificados so transportados com os fluxos
de job.
A Tabela 9 mostra o resultado da configurao do saldo transportado com base em

como a opo global enCarryForward e as palavras-chave stageman -carryforward
so configuradas.
Tabela 9. Configuraes Resultantes do Transporte de Saldo
enCarryForward
stageman -carryforward
Configurao resultante do
transporte de saldo
NO
SIM
NO
NO
ALL
NO
SIM
NO
NO
ALL
NO
NO
ALL
SIM
ALL
SIM
ALL
ALL
SIM
SIM
SIM
A opo transportar saldo configurada na definio do fluxo de trabalho

persistente. Isso significa que um fluxo de tarefas malsucedido que estiver marcado
como carryforward, continua a ter o saldo transportado at que ocorra uma das
seguintes situaes:
v Ele seja finalizado em um estado SUCC
69
v Sua hora UNTIL seja alcanada

v Ele seja cancelado.
A conveno de nomenclatura do fluxo de tarefas redirecionado afetada pelo
valor designado opo global enLegacyId. Para obter informaes adicionais
sobre as diferentes configuraes para esta opo, consulte Customizando o
Gerenciamento de Planos Utilizando Opes Globais na pgina 72.
Nota: Independentemente de como as opes de transporte de saldo so
configuradas, os fluxos de tarefas que no contm tarefas no tm o saldo
transportado.
Se voc configurar carryStates=(succ) e enCarryForward=all ou
enCarryForward=yes , a prxima vez que voc executar JnextPlan haver uma
falta de alinhamento entre o plano de pr-produo e o novo arquivo Symphony.
Isso ocorre porque o plano de pr-produo no contm as instncias dos fluxos de
tarefas que foram encerrados com xito, mas o novo arquivo Symphony contm. O
resultado dessa falta de alinhamento que as dependncias no so resolvidas de
acordo com as instncias do fluxo de tarefas que tiveram o saldo transportado com
xito, pois no existem mais no plano de pr-produo.
A deciso de transportar uma tarefa repetitiva, que uma tarefa que contm uma
configurao de tempo every em sua definio, ou uma cadeia de tarefas
reexecutadas baseia-se no estado de sua execuo mais recente. Apenas a primeira
e a ltima tarefas da cadeia so transportadas.
Plano Trial
Um plano trial uma projeo do que seria um plano de produo se cobrisse um
perodo de tempo mais longo. Por exemplo, se voc gerar um plano de produo
com cobertura de dois dias, mas deseja saber qual seria o plano se cobrisse trs
dias, ser possvel gerar um plano de experincia.
Estas so as caractersticas de um plano trial:
v Sua data de incio corresponde:
data de incio do plano de pr-produo.
data de encerramento do plano de produo.
v baseado nas informaes estticas armazenadas no plano de pr-produo
atual.
v No pode ser executado para gerenciar produo.
v Pode ser gerenciado por usurios com acesso build no tipo de objeto do arquivo
trialsked configurado no arquivo de segurana no gerenciador de domnio
mestre.
v Produz um arquivo armazenado no diretrio schedlog com estas propriedades:
O mesmo formato que o arquivo Symphony.
O nome do arquivo iniciado com um T.
As geraes de plano de experincia podem resultar na extenso do horrio de
encerramento do plano de pr-produo. Isto depende das configuraes das
opes globais minLen e maxLen. Quando isto acontece, o banco de dados
bloqueado e desbloqueado somente quando a operao concluda.
70
No h nenhuma restrio sobre o perodo de tempo selecionado para um plano

trial, mas o tamanho do arquivo resultante que contm todas as informaes do
plano trial deve ser levado em considerao.
Como o plano trial baseado nas informaes estticas armazenadas no plano de
pr-produo, no leva em considerao quaisquer atualizaes dinmicas feitas no
arquivo Symphony enquanto o plano de produo est sendo processado, de forma
que todos os fluxos de tarefas contidos estejam em um destes dois estados:
HOLD
Se dependerem de outros fluxos de tarefas ou se o horrio de incio for
posterior ao incio do horrio do plano.
READY
Se estiverem livres das dependncias e sua hora de incio tiver passado.
As operaes que podem ser executadas em um plano trial no gerenciador de
domnio mestre so:
creation
Utilizada para criar um plano trial para ter uma viso geral da produo
quando um plano de produo ainda no existir.
extenso
Utilizada para criar um plano trial da extenso do plano de produo atual
para ter uma viso geral de como a produo evolui no futuro.
Para obter informaes sobre como criar ou estender um plano trial, consulte
Linha de Comandos Planman na pgina 79.
Plano de Previso
O plano de previso uma projeo do que seria o plano de produo em um
espao de tempo escolhido. Por exemplo, se voc tiver gerado um plano de
produo que cubra dois dias e quiser saber como o plano seria na prxima
semana, possvel gerar um plano de previso.
Estas so as caractersticas de um plano de previso:
v Cobre qualquer espao de tempo, futuro, passado ou at parcialmente
sobrepondo o perodo de tempo coberto pelo plano de produo atual.
v baseado em um plano de pr-produo de amostra que cobre o mesmo
perodo de tempo selecionado para o plano de previso. Esse plano de
pr-produo de amostra excludo aps o plano de previso ser criado.
v No pode ser executado para gerenciar produo.
v Pode ser gerenciado por usurios com acesso build no tipo de objeto do arquivo
trialsked configurado no arquivo de segurana no gerenciador de domnio
mestre.
v Produz um arquivo armazenado no diretrio schedlog com estas propriedades:
O mesmo formato que o arquivo Symphony.
|
|
|
|
O nome do arquivo iniciado com um F.

v Quando o garantia de servio de carga de trabalho est ativado, ele pode
calcular o horrio de incio previsto de cada tarefa do fluxo de tarefas. possvel
ativar e desativar este recurso usando a opo global enForecastStartTime. O
Tivoli Workload Scheduler calcula a durao de execuo mdia para cada tarefa
71
com base em todas as execues anteriores. Para planos complexos, ativar esse
recurso poderia afetar de forma negativa o tempo que leva para gerar o plano
de previso.
|
|
|
Ao criar um plano de previso, o banco de dados bloqueado e somente

desbloqueado quando a operao concluda.
No h nenhuma restrio sobre o perodo de tempo selecionado para gerar um
plano de previso, mas o tamanho do arquivo resultante que contm todas as
informaes do plano de previso deve ser levado em considerao.
Como o plano de previso baseado nas informaes estticas armazenadas no
banco de dados, no leva em considerao quaisquer atualizaes dinmicas feitas
no arquivo Symphony enquanto o plano de produo ou o plano de pr-produo
est sendo processado, de forma que todos os fluxos de tarefas contidos estejam
em um destes dois estados:
HOLD
Se dependerem de outros fluxos de tarefas ou se o horrio de incio for
posterior ao incio do horrio do plano.
READY
Se estiverem livres das dependncias e sua hora de incio tiver passado.
A operao que pode ser executada em um plano de previso no gerenciador de
domnio mestre :
creation
utilizada para criar um plano de previso para ter uma viso geral da
produo em um espao de tempo escolhido.
Para obter informaes sobre como criar um plano de previso, consulte Linha de
Comandos Planman na pgina 79.
Customizando o Gerenciamento de Planos Utilizando Opes Globais

possvel customizar alguns critrios para o Tivoli Workload Scheduler utilizar ao
gerenciar planos configurando opes especficas no gerenciador de domnio
mestre utilizando o programa de linha de comandos optman. necessrio gerar o
plano novamente para ativar as novas configuraes. As opes que podem ser
customizadas so:
Propriedades que afetam a gerao do plano de pr-produo:
minLen
a durao mnima, calculada em dias, do plano de pr-produo,
que deixada como um buffer aps o final do novo plano de
produo gerado. O valor designado a essa opo utilizado
quando o script UpdateStats executado a partir do JnextPlan. O
valor pode ser de 7 a 365 dias. O padro 8 dias.
maxLen
a durao mxima, calculada em dias, do plano de pr-produo,
que deixada como um buffer aps o final do novo plano de
produo gerado. O valor pode ser de 8 a 365 dias. O padro 8
dias.
Se os valores de minLen e maxLen forem iguais, o plano de
pr-produo atualizado durante a fase MakePlan. Em geral, o
72
valor de maxLen deve exceder o valor de minLen em pelo menos 1

dia, de forma que o plano de pr-produo possa ser atualizado
durante a fase UpdateStats.
Propriedades que afetam a gerao ou a extenso do plano de produo:
startOfDay
Representa o horrio de incio do dia de processamento do Tivoli
Workload Scheduler no formato de 24 horas: hhmm (0000-2359). a
configurao padro 0000.
enCarryForward
Essa uma opo que afeta como o comando stageman transporta
o saldo de fluxos de tarefas. Sua configurao determina se os
fluxos de tarefa que no foram concludos tm ou no o saldo
transportado do antigo plano de produo para o novo. As
configuraes disponveis para enCarryForward so yes, no e all. A
configurao padro all.
carryStates
Essa uma opo que afeta como o comando stageman gerencia
tarefas nos fluxos de tarefas com saldo transportado. Sua
configurao determina, com base em seu estado, as tarefas a
serem includas nos fluxos de tarefa que tm o saldo transportado.
Por exemplo, se:
carryStates=abend exec hold
ento, todas as tarefas que esto no estado abend, exec ou hold so

includas nos fluxos de tarefa com saldo transportado. A
configurao padro :
carryStates=null
isso significa que todas as tarefas so includas, independentemente

de seus estados.
enCFInterNetworkDeps
dependncias de interligao de redes. Digite yes para que todos
os fluxos de tarefa EXTERNAL tenham o saldo transportado. Digite
no para desativar completamente a funo transportar saldo para
as dependncias de interligao de redes. A configurao padro
yes.
enCFResourceQuantity
recursos. Quando o plano de produo estendido, ocorre uma
das seguintes situaes:
v Um recurso no utilizado por nenhum dos fluxos de tarefa com
saldo transportado do plano de produo anterior referido por
novas instncias de tarefa ou de fluxo de tarefa includas no
novo plano de produo. Nesse caso, a quantidade do recurso
obtida da definio do recurso armazenada no banco de dados.
v Um recurso utilizado para um ou mais fluxos de tarefa com
saldo transportado do plano de produo anterior no referido
por instncias de tarefa ou de fluxo de tarefa includas no novo
plano de produo. Nesse caso, a quantidade do recurso obtida
do antigo arquivo Symphony.
73
v Um recurso utilizado por um ou mais fluxos de tarefa com saldo

transportado do plano de produo anterior referido por
instncias de tarefa ou de fluxo de tarefa includas no novo
plano de produo. Nesse caso, a quantidade do recurso que
levada em considerao baseada no valor designado opo
enCFResourceQuantity:
Se enCFResourceQuantity estiver configurada para YES
A quantidade do recurso obtida do antigo arquivo
Symphony.
Se enCFResourceQuantity estiver configurada para NO
A quantidade do recurso obtida da definio do
recurso armazenada no banco de dados.
A configurao padro yes.
enEmptySchedsAreSucc
Essa opo rege o comportamento dos fluxos de tarefas que no
contm tarefas. As configuraes disponveis so:
sim
Os fluxos de tarefas que no contm tarefas so marcados

como SUCC medida que suas dependncias so
resolvidas.
no
Os fluxos de tarefas que no contm tarefas permanecem

no estado READY.
enPreventStart
Essa uma opo para gerenciar, para um plano de produo de
vrios dias, quaisquer fluxos de tarefas sem uma restrio de
tempo at configurada. utilizada para evitar que as instncias do
fluxo de tarefas que no so dependentes de tempo sejam iniciadas
todas ao mesmo tempo medida que o plano de produo
criado ou estendido. As configuraes disponveis so:
sim
Um fluxo de tarefas no pode ser iniciado antes de

startOfDay do dia especificado em seu horrio planejado
mesmo que livre de dependncias.
no
Um fluxo de tarefas pode ser iniciado imediatamente

quando o plano de produo iniciado se todas as suas
dependncias estiverem resolvidas.
enLegacyId
Essa uma opo que afeta como os fluxos de tarefas so
denominados no plano. Sua funo manter a consistncia ao
identificar fluxos de tarefas no plano em ambientes combinados
com verses do Tivoli Workload Scheduler anteriores 8.3
gerenciadas pelos gerenciador de domnio mestres verso 8.4. O
valor designado a esta opo lido quando o plano de produo
criado ou estendido ou ao enviar fluxos de tarefas na produo
utilizando conman. As configuraes disponveis so:
sim
74
O jobstream_id do fluxo de tarefas denominado

jobstream_name configurado para jobstream_nameN, e em
que N um nmero incremental designado por um
contador interno; ele ser configurado para null se apenas
uma instncia desse fluxo de tarefas existir no plano.
Se o fluxo de tarefas denominado jobstream_name for

transportado, seu identificador ser configurado para
CFjobstream_nameN.
Essa configurao ser til para manter a consistncia ao
gerenciar fluxos de tarefas, mesmo aquelas transportadas,
utilizando conman quando efetuado logon em um agente
do Tivoli Workload Scheduler 8.2.x em uma rede do Tivoli
Workload Scheduler com um gerenciador de domnio
mestre 8.4.Especificamente, se o perodo de produo for
um dia e no forem submetidas vrias instncias do
mesmo fluxo de tarefas, a compatibilidade com verses
anteriores, ao gerenciar fluxos de tarefas na produo de
um agente do Tivoli Workload Scheduler verso 8.2.x, est
concluda.
no
O identificador do fluxo de tarefas jobstream_id gerado

conforme descrito em showjobs na pgina 382. Os fluxos
de tarefas transportados mantm seus nomes e
identificadores originais e relatam entre chaves {} a data de
quando tiveram o saldo transportado.
logmanSmoothPolicy
Essa uma opo que afeta como o comando logman manipula as
estatsticas e o histrico. Configura o fator de peso que favorece a
tarefa mais recente ao calcular o tempo de execuo normal
(mdio) para uma tarefa. Isso expresso como porcentagem. A
configurao padro -1, o que significa que essa propriedade no
est ativada.
logmanMinMaxPolicy
Essa opo define como os tempos de execuo mnimo e mximo
da tarefa so registrados e relatados por logman. As configuraes
disponveis para a opo logmanMinMaxPolicy so:
elapsedtime
Os tempos de execuo e as datas mximo e mnimo que
so registrados so baseados somente no tempo decorrido
de uma tarefa. O tempo passado, expresso em minutos,
bastante afetado pela atividade do sistema. Inclui o perodo
de tempo de CPU utilizado por uma tarefa e o tempo que
a tarefa precisou aguardar por outros processos para
liberar a CPU. Em perodos de alta atividade do sistema,
por exemplo, um job pode ter um longo tempo decorrido e
no utilizar mais tempo de CPU do que em perodos de
baixa atividade do sistema. Os valores so atualizados
apenas se a execuo de job mais recente tiver um tempo
decorrido maior que o mximo existente, ou menor que o
mnimo existente.
cputime
Os tempos de execuo e as datas mximo e mnimo que
so registrados so baseados somente no tempo de CPU de
uma tarefa. O tempo de CPU uma medida, expressa em
segundos, do tempo real que uma tarefa utilizou a CPU e
no inclui os intervalos em que a tarefa estava aguardando.
Os valores so atualizados apenas se a execuo de job
mais recente tiver um tempo de CPU maior que o mximo
existente, ou menor que o mnimo existente.
75
both
Os valores de tempo decorrido e de tempo de CPU so

atualizados de forma independente para indicar seus
extremos mximo e mnimo, mas as datas de execuo
correspondem somente aos valores de tempo decorridos.
Nenhum registro mantido, neste caso, das datas de
execuo para os tempos de CPU mximo e mnimo.
A configurao padro both.

enTimeZone
Ao configurar a opo, voc ativa ou desativa o gerenciamento de
fusos horrios na rede do Tivoli Workload Scheduler. As
configuraes disponveis para a opo enTimeZone so:
no
Desativar o gerenciamento de fuso horrio. Isso significa

que os valores designados a todas as palavras-chave
timezone nas definies so ignorados.
sim
Ativar o gerenciamento de fuso horrio. Isso significa que

os valores designados s configuraes de timezone so
utilizados para calcular a hora em que os fluxos de tarefas
e as tarefas sero executados nas estaes de trabalho de
destino.
Consulte Ativando o Gerenciamento de Fuso Horrio na pgina

523 para obter informaes adicionais sobre a varivel enTimeZone.
enLegacyStartOfDayEvaluation
Essa opo afeta a maneira que a varivel startOfDay gerenciada
na rede do Tivoli Workload Scheduler. Essa opo requer que a
varivel enTimeZone configurada para yes se torne operacional. As
configuraes disponveis para a opo
enLegacyStartOfDayEvaluation so:
no
O valor designado para a opo startOfDay no gerenciador

de domnio mestre no convertido no fuso horrio local
configurado em cada estao de trabalho na rede.
sim
O valor designado para a opo startOfDay no gerenciador

de domnio mestre convertido no fuso horrio local
configurado em cada estao de trabalho na rede.
Consulte Como o Tivoli Workload Scheduler Gerencia Fusos

Horrios na pgina 524 para obter informaes adicionais sobre a
varivel enLegacyStartOfDayEvaluation.
Para obter informaes sobre como configurar opes utilizando o programa da
linha de comandos optman, consulte o Guia de Administrao do IBM Tivoli Workload
Scheduler.
Criando e estendendo o plano de produo

Todo o processo de movimentao de um plano de produo antigo para um novo,
incluindo sua ativao na rede do Tivoli Workload Scheduler, gerenciada pelo
script JnextPlan. possvel executar JnextPlan a qualquer momento durante o dia
de processamento. O novo plano de produo que gerado ativado
imediatamente nas estaes de trabalho de destino independentemente da hora
configurada na varivel startOfDay.
76
Nota:
1. Ao executar o script JnextPlan, os processos da estao de trabalho so
parados e reiniciados em todas as estaes de trabalho na rede do Tivoli
Workload Scheduler. Para obter informaes adicionais sobre os
processos da estao de trabalho, consulte o Captulo 2, Entendendo
Processos Bsicos da Estao de Trabalho, na pgina 25.
2. Verifique o Guia de Administrao do IBM Tivoli Workload Scheduler para
obter informaes sobre os cenrios especficos que podem requerer a
customizao de JnextPlan.
Autorizao
O comando JnextPlan emitido a partir de um shell de prompt de comandos no
gerenciador de domnio mestre e pode ser chamado por um dos seguintes
usurios:
v O usurio TWS_user que instalou o produto nessa mquina, se no estiver
desativado pelas configuraes definidas no arquivo de segurana.
v Root ou Administrador, dependendo do sistema operacional instalado na
mquina, se no estiver desativado pelas configuraes definidas no arquivo de
segurana.
v Qualquer usurio do Tivoli Workload Scheduler autorizado no arquivo de
segurana no gerenciador de domnio mestre da seguinte forma:
file name=prodsked,Symphony access=build
JnextPlan pode ser executado a qualquer momento enquanto o plano de produo

est no processo de atualizao no plano de produo da topologia da rede do
Tivoli Workload Scheduler em termos de estao de trabalho, classe de estao de
trabalho e definies de objetos de domnio. Por exemplo, se voc tiver criado uma
nova definio de estao de trabalho no banco de dados e quiser incluir essa
definio de estao de trabalho no plano para enviar tarefas ou fluxos de tarefas
posteriormente nessa estao de trabalho, execute o comando:
JnextPlan -for 0000
Nota:
v Certifique-se de que a opo enCarryForward seja configurada para ALL
antes da execuo:
JnextPlan -for 0000
v Quando o comando JnextPlan for executado, a varivel $MANAGER

gerenciada da seguinte forma:
A varivel resolvida se a estao de trabalho for um agente tolerante
a falha de um verso anterior 8.6.
A varivel deixada sem ser resolvida para estaes de trabalho do
agente tolerante a falhas verso 8.6.
|
|
|
|
|
|
Sintaxe
JnextPlan
[-from mm/dd/[yy]yy[hhmm[tz | timezone tzname]]]
{-to mm/dd/[yy]yy[hhmm[tz | timezone tzname]] |
-for [h]hhmm [-days n] | -days n}
Argumentos
-from
Configura a hora de incio do plano de produo. O formato da data

77
especificado no arquivo localopts; onde hhmm identifica as horas e os

minutos e tz o fuso horrio. Esse sinalizador utilizado somente se um
plano de produo ainda no existir. Se o argumento -from no for
especificado, o valor padro ser "today +startOfDay".
Se nenhum fuso horrio for especificado, o fuso horrio GMT ser
utilizado por padro.
-to
o horrio de encerramento do plano de produo. O formato para a data

o mesmo que o utilizado para o argumento -from. O argumento -to
mutuamente exclusivo com os argumentos -for and -days.
Se nenhum fuso horrio for especificado, o fuso horrio GMT ser
utilizado por padro.
-for
a extenso do plano expressa em tempo. O formato hhhmm, em que hhh

so as horas e mm so os minutos. O argumento -for mutuamente
exclusivo com -to.
-days n
o nmero de dias pelo qual voc deseja criar ou estender o plano de
produo. O parmetro -days mutuamente exclusivo com o parmetro
-to.
Se nenhum argumento -to, -for ou -days for especificado, a durao do plano de
produo padro ser de um dia.
Nota: Supondo que o valor designado para startOfDay seja 0h e que o formato de
data configurado no arquivo localopts seja mm/dd/yyyy, se os valores
configurados forem -from 07/05/2011 e -to 07/07/2011, ento, o plano ser
criado para se estender pelo perodo de tempo de 05/07/2011 s 0h a
06/07/2011 s 23h59 e no at 07/07/2011 s 23h59.
Comentrios
O script JnextPlan pode ser executado somente a partir do gerenciador de domnio
principal. Ele usar os parmetros de conexo padro definidos nos arquivos
localopts ou useropts (consulte Configurando Opes para Utilizao das
Interfaces com o Usurio na pgina 50). Se quiser executar JnextPlan usando
diferentes configuraes de parmetros de conexo, possvel editar o script
MakePlan e modificar a chamada para a instruo planman, conforme descrito em
O script JnextPlan composto pela seguinte seqncia de comandos e scripts
especializados, cada uma gerenciando um aspecto especfico da gerao do plano
de produo:
Este comando chamado para iniciar o WebSphere Application Server se
ele ainda no estiver em execuo.
MakePlan
Esse script herda os sinalizadores e os valores designados a eles de
JnextPlan. Sua sintaxe :
MakePlan [-from mm/dd/[yy]yy[hhmm[tz | timezone tzname]]] {-to
mm/dd/[yy]yy[hhmm[tz | timezone tzname]] | -for [h]hhmm [-days n] |
-days n}
78
|
|
|
MakePlan chama internamente a linha de comandos planman. MakePlan

executa as seguintes aes:
1. Cria um novo plano e estende o plano atual e armazena as informaes
em um plano de produo intermedirio que contm:
v Todos os objetos de planejamento (tarefas, fluxos de tarefas,
calendrios, prompts, recursos, estaes de trabalho, domnios,
arquivos, usurios do Windows, dependncias) definidos no perodo
de tempo selecionado.
v Todas as dependncias entre novas instncias de tarefas e de fluxos
de tarefa e as tarefas e os fluxos de tarefa existentes no plano de
produo anterior.
v Todas as solicitaes de ligao cujo tempo planejado est includo
no perodo de tempo selecionado.
2. Exclui todas as solicitaes de ligao no estado final.
3. Imprime relatrios de pr-produo.
SwitchPlan
Esse script chama o comando stageman internamente. Para obter mais
informaes, consulte O comando stageman na pgina 89. SwitchPlan
1. Pra os processos do Tivoli Workload Scheduler.
2. Gera o novo arquivo Symphony iniciando no plano de produo
intermedirio criado pelo MakePlan.
3. Arquiva o arquivo de plano antigo com a data e hora atuais no
diretrio schedlog.
4. Cria uma cpia do arquivo Symphony para distribuir para as estaes de
trabalho.
5. Reinicia os processos do Tivoli Workload Scheduler que distribuem a
cpia do arquivo Symphony para os destinos de estao de trabalho para
execuo das tarefas do plano.
Nota: Certifique-se de que nenhum comando conman start seja executado
enquanto o plano de produo est sendo processado.
CreatePostReports
Esse script imprime os relatrios de ps-produo.
UpdateStats
Esse script chama o comando logman internamente. Para obter mais
informaes, consulte O comando stageman na pgina 89. UpdateStats
1. Registra estatsticas de tarefas.
2. Verifica as polticas e, se necessrio, estende o plano de pr-produo.
3. Atualiza o plano de pr-produo relatando os estados de instncia do
fluxo de tarefas.
Linha de Comandos Planman

A linha de comandos planman utilizada para gerenciar planos de produo
intermedirios, planos de experincia e planos de previso. Ela tambm utilizada
para obter informaes sobre o plano de produo atualmente ativo, para
desbloquear as entradas do banco de dados bloqueadas pelos processos de
79
gerenciamento do plano e para implementar as regras de eventos de planejamento.

O comando executado no gerenciador de domnio mestre. Utilize a seguinte
sintaxe ao executar o planman:
planman -U
planman -V
planman [connection_parameters] command
onde:
-U
Exibe informaes de uso do comando e sai.
-V
Exibe a verso do comando e sai.
connection_parameters
Se estiver usando planman a partir de gerenciador de domnio principal,
os parmetros de conexo foram configurados na instalao e no precisam
ser fornecidos, a menos que voc no queira usar os valores padro.
Se estiver usando planman a partir de cliente da linha de comandos em
outra estao de trabalho, os parmetros de conexo podem ser fornecidos
por meio de um ou mais dos mtodos a seguir:
v Armazenados no arquivo localopts
v Armazenados no arquivo useropts
v Fornecidos ao comando em um arquivo de parmetro
v Fornecidos ao comando como parte da sequncia de caracteres de
comando
Para obter uma viso geral dessas opes, consulte Configurando Opes
para Utilizao das Interfaces com o Usurio na pgina 50. Para obter
detalhes integrais dos parmetros de configurao, consulte o tpico sobre
como configurar o acesso do cliente de linha de comandos no Tivoli
Workload Scheduler: Administration Guide.
comando
Representa o comando executado contra os planos utilizando a interface
planman. Estas so as aes que podem ser executadas contra os planos:
v Criando um Plano de Produo Intermedirio na pgina 81
v Criando um Plano Intermedirio para uma Extenso de Plano na
pgina 82
v Recuperando informaes sobre o plano de produo na pgina 83
v Criando um Plano Trial na pgina 84
v Criando um Plano Trial de uma Extenso de Plano de Produo na
pgina 85
v Criando um Plano de Previso na pgina 86
v Desbloqueando o Plano de Produo na pgina 88
v Reconfigurando o plano de produo na pgina 88
Voc tambm pode utilizar planman para implementar as regras de
eventos de planejamento. O comando explicado em:
Regras de Implementao na pgina 87.
Consulte as subsees relacionadas para obter detalhes adicionais sobre
esses comandos.
80
Criando um Plano de Produo Intermedirio

O planman com a opo crt chamado a partir do comando JnextPlan em uma
destas duas situaes:
v A primeira vez que o comando JnextPlan executado aps ter instalado o
produto.
v Ao gerar um plano de produo aps ter reconfigurado o plano de produo
utilizando o comando ResetPlan.
O resultado da execuo desse comando a criao de um novo plano de
produo intermedirio, denominado Symnew, que cobre todo o tempo que o novo
plano de produo que est sendo gerado cobrir. A seguinte sintaxe utilizada:
planman [connection_parameters] crt
[-from mm/dd/[yy]yy [hhmm [tz | timezone tzname]] ]
-for [h]hhmm [-days n] |
-days n}
onde:
Define as configuraes a serem utilizadas ao estabelecer a conexo
utilizando HTTP ou HTTPS atravs do WebSphere Application Server com
o gerenciador de domnio mestre. Para obter mais informaes, consulte
Configura a hora de incio do novo plano de produo.
-from
Se o argumento -from for omitido, ento:

v A data padro today.
v A hora padro o valor configurado na opo global startOfDay
utilizando optman no gerenciador de domnio mestre.
-to
o novo horrio de encerramento do plano de produo. O formato para

a data o mesmo que o utilizado para o argumento -from. O argumento
-to mutuamente exclusivo com os argumentos -for and -days.
-for
a extenso do plano expressa em tempo. O formato hhhmm, em que hhh

so as horas e mm so os minutos. O argumento -for mutuamente
exclusivo com o argumento -to.
-days n
o nmero de dias para o qual voc deseja criar o plano de produo. O
argumento -days mutuamente exclusivo com o argumento -to.
Nota:
1. Certifique-se de executar o comando planman a partir do comando
JnextPlan.
2. O formato utilizado para a data depende do valor designado para a
varivel date format especificada no arquivo localopts.
produo padro ser de um dia.
81
Estes so alguns exemplos de utilizao do comando planman, supondo que o

formato de data configurado no arquivo localopts seja dd/mm/aaaa:
1. Este comando cria o plano de produo de 21/03/2011 s 23h07 at 22/03/2011
s 23h06 no fuso horrio local:
planman crt from 21/03/05 2307
2. Este comando cria o plano de produo de 21/03/2011 s 9h at 21/03/2011 s

15h:
planman crt from 03/21/2011 0900 for 0600
3. Se hoje for 21/03/05 e o valor configurado para a varivel startOfDay

armazenada no banco de dados for 0600, este comando cria o plano de
produo de 21/03/2011 s 6h pat 25/03/2011 s 5h59:
planman crt to 03/25/2011
4. Este comando cria um plano de produo de 21/03/2011 s 18h05 at

24/03/2011 s 23h no fuso horrio Europe\Paris:
planman crt from 03/21/2011 1805 tz Europe\Rome
to 03/24/2011 2300 tz Europe\Rome
Criando um Plano Intermedirio para uma Extenso de Plano

O comando planman com a opo ext chamado a partir do comando JnextPlan
quando:
v JnextPlan chamado.
v Um plano de produo, representado pelo arquivo Symphony no gerenciador de
domnio mestre, j existe.
O resultado da execuo deste comando a criao de um novo plano de
produo intermedirio, denominado Symnew, cobrindo o tempo extra pelo qual o
novo plano de produo que est sendo gerado se estender. A seguinte sintaxe
utilizada:
planman [connection_parameters] ext
-days n}
onde:
82
-to
Configura o horrio de encerramento do plano de produo estendido. O

argumento -to mutuamente exclusivo com os argumentos -for and -days.
-for
Configura a durao da extenso do plano de produo. O formato

hhhmm, em que hhh so as horas e mm so os minutos. O argumento -for
mutuamente exclusivo com o argumento -to.
-days n
Configura o nmero de dias para o qual voc deseja estender o plano de
produo. O argumento -days mutuamente exclusivo com o argumento
-to.
Nota:
1. Certifique-se de executar o comando planman a partir do comando
JnextPlan.
2. O formato utilizado para a data depende do valor designado para a
3. Quando um plano de produo estendido, os nmeros associados a
prompts j presentes no plano so modificados.
Se nenhum argumento -to, -for ou -days for especificado, o plano de produo ser
estendido por um dia.
Recuperando informaes sobre o plano de produo

A sintaxe a seguir utilizada para mostrar as informaes sobre o plano de
produo atual:
planman [connection_parameters] showinfo
onde:
Nota: possvel instalar o recurso Cliente da Linha de Comando do Tivoli
Workload Scheduler nos agentes tolerantes a falhas e sistemas fora da rede
do Tivoli Workload Scheduler para emitir, a partir desses sistemas, o
comando planman showinfo.
A sada deste comando mostra:
v O caminho da instalao.
v O horrio de incio do plano de produo.
v O horrio de encerramento do plano de produo.
v A durao do plano de produo, aps a ltima extenso do plano, se estendido.
v A data e hora da ltima atualizao do plano, feita utilizando JnextPlan ou
planman.
v O horrio de encerramento do plano de pr-produo.
v O horrio de incio da primeira instncia de fluxo de tarefas no concluda.
v O nmero de execues, que o nmero total de vezes que o plano foi gerado.
v O nmero de execues confirmadas, que o nmero o vezes que o plano foi
gerado com xito.
Os horrios de incio e de encerramento dos planos de produo e pr-produo
so exibidos utilizando o formato especificado na varivel date format configurada
no arquivo localopts e o fuso horrio da mquina local.
Uma sada de amostra desse comando a seguinte:
83
# planman showinfo
Tivoli Workload Scheduler (UNIX)/PLANMAN 8.6 (20100715)
Licensed Materials - Property of IBM*
5698-WSH
(C) Copyright IBM Corp. 1998, 2011 All rights reserved.
* Marca Registrada da International Business Machines
Installed for user "aix61usr".
LANG do cdigo do idioma configurado para o seguinte: "en"
Plan creation start time: 07/21/2010 06:00 TZ CEST
Production plan start time of last extension: 07/21/2010 06:00 TZ CEST
Production plan end time: 07/22/2010 05:59 TZ CEST
Production plan time extention: 024:00
Plan last update: 07/21/2010 10:05 TZ CEST
Preproduction plan end time: 08/05/2010 06:00 TZ CEST
Start time of first not complete preproduction plan job stream instance:
07/21/2010 10:30 TZ CEST
Run number: 1
Confirm run number: 1
Criando um Plano Trial

A sintaxe a seguir utilizada para criar um plano trial:
planman [connection_parameters] crttrial file_name
-days n}
onde:
file_name
Designa um nome para o arquivo a ser criado sob o diretrio
TWS_home/schedTrial e que contm o plano trial. O nome do arquivo que
contm o plano trial Tfilename. Isso significa que o valor designado para
file_name myfile, ento, o nome do arquivo que contm o plano trial
gerado Tmyfile.
-from
Configura a hora de incio do plano trial.

84
-to
Configura o horrio de encerramento do plano trial. O argumento -to

-for
Configura a durao do plano de experincia. O formato hhhmm, em que

hhh so as horas e mm so os minutos. O argumento -for mutuamente
-days n
Configura o nmero de dias pelo qual voc deseja que o plano de
experincia dure. O argumento -days mutuamente exclusivo com o
argumento -to.
Nota: O formato utilizado para a data depende do valor designado para a varivel
date format especificada no arquivo localopts.
experincia padro ser de um dia.
Consulte tambm
No Tivoli Dynamic Workload Console:
1. Clique em Tivoli Workload SchedulerCarga de TrabalhoPrevisoGerar
Plano de Experincia
2. Escolha um nome de mecanismo e grave as informaes solicitadas na pgina
Gerar Plano de Experincia
3. Clique em Gerar Plano.
Criando um Plano Trial de uma Extenso de Plano de

Produo
A sintaxe a seguir utilizada para criar um plano trial com a extenso do plano de
produo atual:
planman [connection_parameters] exttrial file_name
-days n}
onde:
file_name
TWS_home/schedTrial e que contm o plano trial. O nome do arquivo que
contm o plano trial Tfilename. Isso significa que o valor designado para
file_name myfile, ento, o nome do arquivo que contm o plano trial
gerado Tmyfile.
-to
Configura o horrio de encerramento do plano de experincia que contm

a extenso do plano de produo. O argumento -to mutuamente
exclusivo com os argumentos -for and -days.
-for
Configura a durao do plano trial que contm a extenso do plano de

produo. O formato hhhmm, em que hhh so as horas e mm so os
minutos. O argumento -for mutuamente exclusivo com o argumento -to.
85
-days n
Configura o nmero de dias pelo qual voc deseja que o plano de
experincia que contm a extenso do plano de produo dure. O
argumento -days mutuamente exclusivo com o argumento -to.
Se nenhum argumento -to, -for ou -days for especificado, a extenso do plano de
produo padro contida no plano de experincia ser de um dia.
Criando um Plano de Previso

A sintaxe a seguir utilizada para criar um plano de previso:
planman [connection_parameters] crtfc file_name
-days n}
onde:
file_name
TWS_home/schedForecast e que contm o plano de previso. O nome do
arquivo que contm o plano de previso Ffilename. Isso significa que o
valor designado para file_name myfile, ento, o nome do arquivo que
contm o plano de previso gerado Fmyfile.
O comprimento mximo de file_name pode ter 148 caracteres.
-from
Configura a hora de incio do plano de previso.

-to
Configura o horrio de encerramento do plano previso. O argumento -to

-for
Configura a durao do plano de previso. O formato hhhmm, em que

hhh so as horas e mm so os minutos. O argumento -for mutuamente
-days n
Configura o nmero de dias pelo qual voc deseja que o plano de previso
dure. O argumento -days mutuamente exclusivo com o argumento -to.
86
previso padro ser de um dia.
Consulte tambm
1. Clique em Tivoli Workload SchedulerCarga de TrabalhoPrevisoGerar
Plano de Previso
2. Escolha um nome de mecanismo e grave as informaes solicitadas na pgina
Gerar Plano de Previso
3. Clique em Gerar Plano.
Regras de Implementao
O comando planman deploy utilizado no gerenciamento de eventos. possvel
utiliz-lo para implementar manualmente todas as regras que no esto no estado
de rascunho (a propriedade isDraft configurada como NO em suas definies). O
comando opera da seguinte maneira:
1. Seleciona todas as definies de regras de eventos que no esto no estado de
rascunho a partir do banco de dados do Tivoli Workload Scheduler.
2. Constri arquivos de configurao de regra de evento.
3. Implementa os arquivos de configurao nos mecanismos de monitoramento
em execuo nos agentes do Tivoli Workload Scheduler.
Os novos arquivos de configurao atualizam as regras de eventos em execuo
em cada mecanismo de monitoramento em termos de:
v Novas regras
v Regras alteradas
v Regras excludas ou configuradas de volta para o estado draft
possvel utilizar este comando alm da, ou em substituio , opo de
configurao deploymentFrequency (df) optman, que verifica periodicamente
definies de regra de evento para alteraes na implementao (consulte o Guia de
Administrao para obter detalhes sobre esta opo).
As alteraes aplicadas s definies de regras de eventos no banco de dados so
efetivadas somente depois que a implementao tiver ocorrido.
A sintaxe de comando :
planman [connection_parameters] deploy [-scratch]
onde:
-scratch
Sem esta opo, o comando afeta apenas as regras que foram includas,
alteradas, excludas ou configuradas de volta para o estado rascunho.
87
Com esta opo, o comando implementa todas as regras de no-rascunho

existentes no banco de dados, incluindo aquelas que j esto na
implementao e no foram alteradas.
A utilizao desta opo resulta em uma reconfigurao completa do
processador de eventos e deve ser utilizada com cuidado. O comando pode
causar a perda de quaisquer instncias da regra em progresso no momento
em que voc o emite. O caso tpico uma regra seqencial que foi
acionada e que est aguardando que eventos adicionais ocorram: se voc
utilizar a opo neste momento, o ambiente da regra de evento ser
reconfigurado e os eventos rastreados sero perdidos.
Para executar este comando, necessrio o acesso build no arquivo prodsked.
Desbloqueando o Plano de Produo

Quando o Tivoli Workload Scheduler comea a criar o plano de produo, ele
bloqueia as definies dos objetos de planejamento no banco de dados e, em
seguida, desbloqueia as mesmas quando a criao do plano de produo
concluda ou se ocorrer uma condio de erro. O bloqueio aplicado para evitar
que definies de objetos sejam modificadas quando o plano de produo gerado
ou estendido. Se o processamento terminar de formal inesperada, as entradas do
banco de dados podem permanecer bloqueadas. Somente usurios com acesso
build no tipo de objeto do arquivo prodsked especificados no arquivo de
segurana no gerenciador de domnio mestre tm permisso para desbloquear o
banco de dados. O comando utilizado para executar essa ao :
planman [connection_parameters] unlock
onde:
Nota: possvel instalar o recurso Cliente da Linha de Comando do Tivoli
Workload Scheduler nos agentes tolerantes a falhas e sistemas fora da rede
do Tivoli Workload Scheduler para emitir, a partir desses sistemas, o
comando planman unlock.
Reconfigurando o plano de produo

O script a seguir utilizado para reconfigurar ou riscar o plano de produo:
ResetPlan [connection_parameters] [-scratch]
onde:
A diferena entre reconfigurar e riscar o plano de produo a seguinte:
88
v Se voc reconfigurar o plano de produo, o plano de pr-produo mantido,

ele atualizado com as estatsticas de tarefas e utilizado posteriormente para
gerar um novo plano de produo. Isso significa que ao criar um novo plano de
produo, ele conter todas as instncias do fluxo de tarefas que no estavam no
estado COMPLETE quando voc executou ResetPlan. As etapas executadas pelo
produto ao reconfigurar o plano de produo so as seguintes:
1. Todos os processos do Tivoli Workload Scheduler so parados no gerenciador
de domnio mestre.
2. O arquivo Symphony arquivado.
3. As estatsticas de tarefa so atualizadas.
v Se voc riscar o plano de produo, o plano de pr-produo tambm riscado.
O plano de pr-produo ser criado novamente com base nas informaes de
modelagem armazenadas no banco de dados quando voc gerar posteriormente
um novo plano de produo. Isso significa que o novo plano de produo
conter todas as instncias do fluxo de tarefas planejadas para execuo no
espao de tempo coberto pelo plano, independentemente do fato de j estarem
no estado COMPLETE ou no quando o plano foi riscado. As etapas executadas
pelo produto ao riscar o plano de produo so as seguintes:
1. Todos os processos do Tivoli Workload Scheduler so parados no gerenciador
de domnio mestre.
2. O arquivo Symphony arquivado.
3. As estatsticas de tarefa so atualizadas.
4. O plano de pr-produo riscado.
Nota: Se voc utilizar a opo -scratch, certifique-se de executar dbrunstats
antes do script JnextPlan. Consulte o Guia de Administrao para obter
detalhes sobre dbrunstats.
O comando stageman
O comando stageman transporta o saldo de fluxos de tarefa incompletos, arquiva o
plano de produo antigo e instala o novo plano de produo. Uma cpia de
Symphony enviada para os gerenciadores de domnio e agentes como parte do
processo de inicializao do novo plano de produo. Ao executar JnextPlan,
stageman chamado a partir do script SwitchPlan.
Voc deve ter acesso build para o arquivo Symphony para executar stageman.
Sintaxe
stageman -V | -U
stageman
[-carryforward{yes|no|all}]
[-log log_file| -nolog]
[symnew]
Argumentos
-V
-U
Exibe informaes de utilizao do comando e sai.
89
-carryforward
Define como os fluxos de tarefas incompletos so gerenciados ao mover
para um novo plano de produo. As configuraes disponveis so:
no
No transporta o saldo de nenhum fluxo de tarefa.
sim
Transporta o saldo somente dos fluxos de tarefas incompletos cuja

definio contm a palavra-chave carryforward.
all
Transporta o saldo de todos os fluxos de tarefas incompletos,

independentemente de conterem ou no a palavra-chave
carryforward na definio do fluxo de tarefas.
Se voc omitir essa palavra-chave, por padro, ela ser configurada para o
valor especificado globalmente utilizando optman para a opo
enCarryForward . Consulte Entendendo as Opes de Transporte de Saldo
na pgina 68 para obter informaes sobre a configurao de transporte de
saldo quando a opo global enCarryForward e as palavras-chave
-carryforward forem configuradas.
-log
Arquiva o plano de produo antigo no diretrio TWS_home/schedlog com o

nome de arquivo log_file. Os planos de produo arquivados podero,
ento, ser listados e selecionados utilizando os comandos listsym na
pgina 358 e setsym na pgina 371. Se as palavras-chave -log e -nolog
no forem especificadas, o Tivoli Workload Scheduler arquiva o plano de
produo antigo, utilizando a seguinte conveno de nomenclatura:
Myyyymmddhhtt
em que yyyymmddhhtt corresponde ao ano, ms, dia, hora, minutos em que

o plano de produo antigo est arquivado. Se voc gerar o plano de
produo utilizando JnextPlan, poder customizar essa conveno de
nomenclatura no script SwitchPlan.
Nota: Certifique-se de monitorar o espao em disco no diretrio schedlog
e remover os arquivos de log mais antigos regularmente.
-nolog No arquiva o antigo plano de produo.
symnew
O nome designado para o arquivo do plano de produo intermedirio
criado por planman. Se no especificado, stageman utiliza o nome de
arquivo Symnew.
Comentrios
Para permitir que os procedimentos de transporte de saldo funcionem
corretamente em uma rede, o arquivo do plano de produo, Symphony, do
gerenciador de domnio mestre deve ser atualizado com o status mais recente do
fluxo de tarefas de seus agentes e gerenciadores de domnio subordinados. Execute
o seguinte comando:
conman "link @"
antes de executar stageman. Esse comando vincula quaisquer estaes de trabalho

no vinculadas de forma que mensagens sobre o status de processamento da tarefa
enfileiradas no arquivo Mailbox.msg sejam enviadas de volta ao gerenciador de
domnio mestre para atualizar o arquivo Symphony.
Nota: Somente no UNIX, stageman determina tambm quais arquivos executveis
associados a tarefas enviadas utilizando os comandos utilitrios at e batch
90
podem ser excludos quando o Tivoli Workload Scheduler for iniciado para
o novo perodo de produo. Essas tarefas no tm o saldo transportado.
Exemplos
Transporte todos os fluxos de tarefas no concludos (independentemente do status
da opo Carry Forward), registre o arquivo Symphony antigo e crie o novo arquivo
Symphony:
DATE=datecalc today pic YYYYMMDDHHTT
stageman -carryforward all -log schedlog/M$DATE
Transporte o saldo dos fluxos de tarefa no concludos conforme definido pela

opo global carryforward, no registre o arquivo Symphony antigo e crie um plano
de produo intermedirio denominado mysym:
stageman -nolog mysym
Gerenciando Acessos Simultneos ao Arquivo Symphony

Esta seo contm dois cenrios de amostra que descrevem como o Tivoli
Workload Scheduler gerencia possveis acessos simultneos ao arquivo Symphony ao
executar stageman.
Cenrio 1: Acesso ao Arquivo Symphony Bloqueado por

Outros Processos do Tivoli Workload Scheduler
Se os processos do Tivoli Workload Scheduler ainda estiverem ativos e acessando o
arquivo Symphony quando stageman for executado, a mensagem a seguir exibida:
Impossvel obter acesso exclusivo para o Symphony.
Encerre o batchman e o mailman.
Para continuar, pare o Tivoli Workload Scheduler e execute o stageman novamente.

Se o stageman abortar por qualquer razo, voc deve executar novamente o
planman e o stageman.
Cenrio 2: Acesso ao Arquivo Symphony Bloqueado pelo

stageman
Se voc tentar acessar o plano utilizando a interface de linha de comandos
enquanto o Symphony est sendo comutado, receber a seguinte mensagem:
Arquivo Symphony atual antigo. Mudando para novo Symphony.
Planejar mm/dd/aaaa (nnnn) na cpu, Symphony comutado.
Gerenciando Dependncias Follows Utilizando Prompt de Transporte

de Saldo
Para manter a continuidade ao transportar saldo de fluxos de tarefa, o stageman
gera prompts para cada fluxo de tarefas que tiver o saldo transportado e tiver uma
dependncia follows em outro fluxo de tarefas que no ter o saldo transportado.
Esses prompts so emitidos depois do incio do novo perodo de processamento,
quando o Tivoli Workload Scheduler verifica se a tarefa ou o fluxo de tarefas est
pronto para ser ativado, e so respondidos como prompts padro. Segue um
exemplo de um prompt para transportar saldo:
91
INACT 1(SYS2#SKED2[(0600 01/11/06),(0AAAAAAAAAAAAA2Y)]) follows SYS1#SKED1, satisfied?

SYS1#SKED1, satisfied?
Esse prompt indica que um fluxo de tarefas, que tem o saldo transportado do
plano de produo anterior, (SYS2#SKED2[(0600 01/11/06),(0AAAAAAAAAAAAA2Y)]),
tem uma dependncia follows de um fluxo de tarefas denominado SYS1#SKED1 que
no teve o saldo transportado. Para obter informaes sobre a sintaxe utilizada
para indicar o fluxo de tarefa com saldo transportado, consulte Selecionando
Fluxos de Tarefas em Comandos na pgina 322.
O estado do prompt, INACT, nesse caso, define o estado da dependncia follows
correspondente. Os estados possveis so:
INACT
O prompt no foi emitido e a dependncia no satisfeita.
PERGUNTADO
O prompt foi emitido e est aguardando uma resposta. A dependncia no
satisfeita.
NO
Uma resposta "no" foi recebida ou determinou-se antes de transportar

saldo ter ocorrido que o fluxo de tarefa seguido (SKED3) no tinha sido
concludo com xito. A dependncia no satisfeita.
SIM
Uma resposta "yes" foi recebida ou determinou-se antes de transportar

saldo ter ocorrido que o fluxo de tarefa seguido (SKED3) tinha sido
concludo com xito. A dependncia satisfeita.
O comando logman
O comando logman registra as estatsticas do job de um arquivo de log do plano
de produo.
Sintaxe
logman -V|-U
logman
[connection_parameters]
[-prod symphony-file]
[-minmax setting]
[-smooth weighting]
Argumentos
-U
-V
Representa o conjunto de parmetros que controlam a interao entre a
interface do produto, logman em execuo no gerenciador de domnio
mestre neste caso, e a infra-estrutura do WebSphere Application Server
utilizando HTTP ou HTTPS. Utilize essa sintaxe para especificar as
configuraes para os parmetros de conexo:
[-host hostname] [-port port_number] [-protocol protocol_name] [-proxy
proxy_name] [-proxyport proxy_port_number] [-password user_password]
[-timeout timeout] [-username username]
92
onde:
hostname
o nome do host do gerenciador de domnio mestre.
port_number
o nmero da porta utilizado ao estabelecer a conexo com o
gerenciador de domnio mestre.
protocol_name
o protocolo utilizado durante a comunicao. Pode ser HTTP
com autenticao bsica ou HTTPS com autenticao de certificado.
proxy_name
o nome do host do proxy utilizado na conexo.
proxy_port_number
o nmero da porta do proxy utilizado na conexo.
user_password
a senha do usurio que utilizada para executar o logman.
Nota: Em estaes de trabalho Windows, quando voc especificar
uma senha que contm aspas duplas (") ou outros caracteres
especiais, certifique-se de que o caractere seja codificado
com a funo escape. Por exemplo, se a sua senha for
tws11"tws, grave-a assim: "tws11\"tws".
timeout
o tempo mximo, expresso em segundos, que o programa de
linha de comandos que est conectando pode aguardar pela
resposta do gerenciador de domnio mestre antes de considerar o
pedido de comunicao como com falha.
username
o nome do usurio que est executando o logman.
Se qualquer um desses parmetros for omitido, ao chamar logman, o Tivoli
Workload Scheduler procura um valor primeiro no arquivo useropts e, em
seguida, no arquivo localopts. Se uma configurao para o parmetro no
for localizada, um erro exibido. Consulte Configurando Opes para
Utilizao das Interfaces com o Usurio na pgina 50 para obter
informaes sobre os arquivos useropts e localopts.
-prod
Atualiza o plano de pr-produo com as informaes sobre os fluxos de

tarefas no estado COMPLETE na produo. Fazendo isso o plano de
pr-produo mantido atualizado com as informaes de processamento
mais recentes. Isto evita a possibilidade do novo plano de produo ser
executado novamente, fluxos de tarefas j concludos no perodo de
produo anterior.
-minmax setting
Define como os tempos de execuo mnimo e mximo do job so
registrados e relatados. As configuraes disponveis so:
elapsed
Basear os tempos de execuo mnimo e mximo no tempo
decorrido.
cpu
Basear os tempos de execuo mnimo e mximo no tempo de

CPU.
93
Esta configurao utilizada quando o comando logman executado a

partir da linha de comandos e no pelo script JnextPlan. Quando o
comando logman executado por JnextPlan, a configurao utilizada
aquela especificada na opo global logmanMinMaxPolicy.
-smooth weighting
Utiliza um fator de pesagem que favorece a execuo do job mais recente
ao calcular o tempo de execuo normal (mdia) de um job. Isso expresso
como porcentagem. Por exemplo, -smooth 40 aplica um fator de peso de
40% na execuo da tarefa mais recente e 60% na mdia existente. O
padro 0%. Esta configurao utilizada quando o comando logman
executado a partir da linha de comandos e no pelo script JnextPlan.
Quando o comando logman executado pelo JnextPlan, a configurao
utilizada aquela especificada na opo global logmanSmoothPolicy.
symphony-file
O nome de um arquivo symphony arquivado a partir do qual as
estatsticas de tarefa so extradas.
Comentrios
Os jobs que j foram registrados no podem ser registrados novamente. A tentativa
de fazer isso gera uma mensagem de erro 0 jobs logged.
Exemplos
Registrar estatsticas do job do arquivo de log M199903170935:
logman schedlog/M199903170935
Como a Mdia dos Tempos de Execuo Calculada

A durao estimada de uma execuo da tarefa fornecida por logman como parte
do ciclo de planejamento dirio. A durao estimada de uma execuo da tarefa
baseada na mdia de suas execues precedentes. Para calcular o tempo de
execuo mdio para uma tarefa, logman divide o tempo de execuo total para
todas as execues bem-sucedidas pelo nmero de execues bem-sucedidas. Se
um grande nmero de execues for utilizado para calcular a mdia, uma alterao
repentina em um tempo de execuo da tarefa no ser refletida imediatamente na
mdia. Para responder mais rapidamente a tais alteraes, possvel utilizar a
opo smooth para que a mdia possa ser ponderada em favor das execues da
tarefa mais recentes. Utilize a opo -smooth para inserir um fator de ponderao,
como uma porcentagem, para execues da tarefa atuais. Por exemplo, o comando
logman -smooth 40 far com que logman utilize um fator de ponderao de 40 por
cento para as execues mais recentes da tarefa e 60 por cento para a mdia
existente. O comando logman -smooth 100 far com que as execues mais recentes
da tarefa substituam a mdia existente.
Logman retm os dados de estatstica de execues de tarefa no banco de dados do
Tivoli Workload Scheduler. No h limite para o nmero de instncias da tarefa
retidas no histrico da tarefa.
Iniciando o Processamento do Plano de Produo

Para iniciar um ciclo de produo, siga estas etapas:
1. Efetue login como TWS_user no gerenciador de domnio principal.
94
2. Em um prompt de comandos, execute o comando script . ./TWS_home/

tws_env.sh no UNIX ou TWS_home\tws_env.cmd no Windows para configurar o
ambiente e, em seguida, execute a tarefa JnextPlan, digitando, por exemplo, em
uma estao de trabalho UNIX, o seguinte comando:
JnextPlan.sh -from 05/03/06 0400 -to 06/06/06
Isso cria um novo plano de produo que comea em 3 de maio de 2006 s 4h

e pra em 6 de junho de 2006 s 3h59. O dia de processamento ser iniciado na
hora especificada no gerenciador de domnio mestre na varivel startOfDay.
3. Quando o job JnextPlan for concludo, verifique o status do Tivoli Workload
Scheduler:
conman status
Se o Tivoli Workload Scheduler foi iniciado corretamente, o status ser

Batchman=LIVES
Se o mailman ainda estiver executando um processo na estao de trabalho

remota, voc ver que ela no inicializada imediatamente. Isso acontece
porque a estao de trabalho precisa concluir quaisquer atividades contnuas
que envolvem o processo mailman antes de reinicializar. Depois do intervalo
definido no parmetro mm retry link configurado no arquivo de configurao
TWS_home/localopts decorrer, o gerenciador de domnio tenta inicializar a
estao de trabalho novamente. Assim que as atividades contnuas so
concludas, as atividades do dia seguinte so inicializadas. Para obter
informaes sobre o arquivo de configurao localopts, consulte o Guia de
Administrao do IBM Tivoli Workload Scheduler.
4. Aumente o limite para permitir a execuo das tarefas. O limite de job padro
aps a instalao zero. Isso significa que nenhum job ser executado.
conman "limit;10"
Automatizando o processamento do plano de produo

Se voc desejar estender seu plano de produo em um intervalo de tempo fixado,
por exemplo, a cada semana, voc ter a opo de automatizar a extenso. Esta
seo explica como fazer isso.
Tivoli Workload Scheduler inclui um fluxo de tarefas de amostra denominado
final que o ajuda a automatizar o gerenciamento do plano. Uma cpia deste fluxo
de tarefas est no arquivo Sfinal no diretrio TWS_home/config/Sfinal. Uma cpia
para o script de tarefa est no diretrio TWS_home/JnextPlan.
possvel utilizar esse arquivo Sfinal ou criar e customizar um novo.
Importante: Em qualquer caso, para que seja possvel executar esse fluxo de
tarefas com xito, o TWS_user deve ter acesso Write ao diretrio
temporrio padro tmp.
O fluxo de tarefas final executa a seqncia de arquivos de script descritos no
JnextPlan para gerar o novo plano de produo. Consulte Criando e estendendo
o plano de produo na pgina 76 para obter referncia.
Por padro, o fluxo de tarefa final configurado para executar uma vez por dia.
possvel modificar a hora da execuo modificando duas configuraes na
definio do fluxo de tarefas final. Estes so os detalhes das duas etapas que
precisam ser seguidas para fazer isso, por exemplo, fazer com que o fluxo de
tarefas final seja executado a cada trs dias:
95
v Modifique o ciclo de execuo configurando na definio do fluxo de tarefas

final para planejar o fluxo de tarefas para execuo a cada trs dias.
v Na instruo que chama MakePlan no fluxo de tarefas final, configure o plano
de produo para durar trs dias, especificando -for 72.
Em seguida, ser necessrio incluir o fluxo de tarefas final no banco de dados,
executando as seguintes etapas:
1. Efetue login como TWS_user.
2. Execute o script tws_env para definir o ambiente do Tivoli Workload Scheduler
como a seguir:
v UNIX: on C shells launch . ./TWS_home/tws_env.csh
v UNIX: em shells Korn, ative . ./TWS_home/tws_env.sh
v Em uma linha de comandos do Windows: ative TWS_home\tws_env.cmd
em que TWS_home representa o diretrio de instalao do produto.
3. Execute o comando composer.
4. Adicione a definio de fluxo de tarefa final ao banco de dados, executando o
seguinte comando:
composer add Sfinal
Se voc no utilizou o arquivo Sfinal fornecido com o produto, mas criou um

novo, utilize seu nome no lugar de Sfinal.
5. Inicie o ciclo de produo executando o script JnextPlan. Dessa forma, o fluxo
de tarefa final ser includo no plano de produo atual.
Nota: Mesmo se tiver decidido automatizar a extenso do plano de produo, voc
ainda pode executar JnextPlan a qualquer momento.
96
Captulo 5. Utilizando Garantia do Servio de Carga de

Trabalho
A garantia de servio de carga de trabalho um recurso opcional que fornece um
meio de sinalizar tarefas como essenciais para seu negcio e garantir que elas
sejam processadas em tempo hbil. O uso desta funo beneficia sua equipe de
operaes de planejamento aprimorando sua capacidade de atender nveis de
servio definidos.
Quando o recurso de garantia de servio de carga de trabalho est ativado,
possvel sinalizar tarefas como crticas para a misso e garantir que elas tenham
um prazo final de concluso associado especificado em suas definies ou no
envio. Dois encadeamentos adicionais de execuo, Planejador de Tempo e Monitor
do Plano, que so executados no WebSphere Application Server, so,
posteriormente, includos para garantir que as tarefas crticas sejam concludas no
prazo.
A definio de uma tarefa crtica e de um prazo final aciona o clculo dos horrios
de incio de todas as outras tarefas que so predecessoras da tarefa crtica. O
conjunto de predecessoras de uma tarefa crtica formam sua rede crtica. Isto pode
incluir tarefas de outros fluxos de tarefas. Comeando pelo prazo final e durao
da tarefa crtica, o Planejador de Tempo calcula seu horrio de incio crtico, que o
horrio de incio mais recente para a tarefa se adaptar ao prazo final
correspondente. Retornando do horrio de incio crtico, ele calcula o ltimo
horrio no qual cada predecessor na rede crtica pode iniciar para que a tarefa
crtica no final da cadeia possa concluir no prazo.
Enquanto o plano executado, o Monitor de Planos verifica constantemente a rede
crtica para garantir que o prazo final da tarefa crtica possa ser atendido. Quando
alteraes que tm um impacto no tempo so feitas na rede crtica, por exemplo, a
incluso ou a remoo de tarefas ou dependncias que as seguem, o Monitor de
Planos solicita que o Planejador de Tempo recalcule os horrios de incio crticos.
Alm disso, quando uma tarefa da rede crtica concluda, o tempos das tarefas
que a seguem so recalculados para levar em considerao a durao real da
tarefa.
Em uma rede crtica, o conjunto de predecessores que arriscam mais diretamente a
atrasar o horrio de incio crtico chamado de caminho crtico. O caminho crtico
dinamicamente atualizado medida que as predecessoras so concludas ou que se
arriscam a concluir as alteraes atrasadas.
O planejador (batchman) age automaticamente para remediar atrasos, priorizando
tarefas que esto realmente ou possivelmente colocando o prazo final de destino
em risco. Uma srie de visualizaes de tarefas crticas especializadas, disponveis
no Tivoli Dynamic Workload Console, permite que os operadores procurem tarefas
crtica, exibam seus predecessores e os caminhos crticos associados a eles,
identifiquem tarefas que esto causando problemas e faam pesquisas detalhadas
para identificar e resolver problemas.
Para obter informaes detalhadas, consulte:
v Ativando e Configurando a Garantia do Servio de Carga de Trabalho na
pgina 98
97
v Planejando Tarefas Crticas na pgina 102

v Processando e Monitorando Tarefas Crticas na pgina 103
v Cenrio de Garantia de Servio de Carga de Trabalho na pgina 106
Para obter informaes sobre resoluo de problemas e problemas comuns com a
garantia do servio da carga de trabalho, consulte o captulo Garantia de Servio
de Carga de Trabalho no Tivoli Workload Scheduler: Resoluo de Problemas.
Ativando e Configurando a Garantia do Servio de Carga de Trabalho

Uma grande quantidade de opes globais e locais controlam o gerenciamento de
tarefas crticas. O arquivo de segurana do Tivoli Workload Scheduler tambm
deve autorizar usurios com acesso adequado a todas as tarefas, fluxos de tarefas e
estaes de trabalho associados s tarefas crticas.
Opes Globais
O recurso de garantir do servio de carga de trabalho ativado e desativado pela
opo global enWorkloadServiceAssurance. Ele ativado por padro. Outras
opes globais e locais so utilizadas para controlar diferentes aspectos do
processamento de tarefas crticas e suas predecessoras.
A Tabela 10 mostra as opes globais que so utilizadas pela garantia do servio de
carga de trabalho. Se voc desejar customizar os valores, modifique as opes
globais no gerenciador de domnio principal utilizando a linha de comandos
optman. Na maioria dos casos, as alteraes tomam efeito depois que a prxima
JnextPlan executada.
Tabela 10. Opes Globais de Garantia de Servio de Carga de Trabalho
Opo
Descrio
enWorkloadServiceAssurance | wa
Ativa ou desativa o processamento

privilegiado de tarefas crticas para a misso
e seus predecessores. O valor padro YES.
Especifique NO para desativar.
promotionOffset | po
A garantia do servio de carga de trabalho

calcula um horrio de incio crtico para a
prpria tarefa crtica e cada uma de suas
predecessoras. Esse o ltimo horrio que a
tarefa pode ser iniciada sem colocar a
concluso atual da tarefa crtica em risco.
Quando a hora de incio crtica de uma
tarefa est se aproximando e a tarefa ainda
no comeou, o mecanismo de promoo
utilizado. Uma tarefa promovida recebe
recursos de sistema operacional adicionais e
seu envio tem prioridade. A opo global
promotionoffset determina a durao do
tempo antes do horrio de incio crtico que
uma tarefa se torna elegvel para promoo.
A configurao padro 120 segundos.
98
Tabela 10. Opes Globais de Garantia de Servio de Carga de Trabalho (continuao)

Opo
Descrio
longDurationThreshold | ld
O clculo de horrios de incio crticos para

as tarefas que formam uma rede crtica
baseado no prazo final definido para a tarefa
crtica e nas duraes estimadas da tarefa
crtica e de cada uma de suas predecessoras.
Se uma tarefa levar mais tempo do que o
esperado para que seja concluda, ela poder
fazer com que as tarefas que vm em
seguida percam seus horrios de incio
crticos e, dessa forma, coloque a concluso
adequada da tarefa crtica em risco.
A opo global longDurationThreshold um
valor em porcentagem. O padro 150.
Utilizando o valor padro, se a durao real
de uma tarefa for superior a 150% da
durao estimada ou mais, a tarefa ser
considerada uma tarefa de longa durao e
ser includa na lista crtica que pode ser
visualizada no Tivoli Dynamic Workload
Console.
approachingLateOffset | al
O horrio de incio crtico de uma tarefa na

rede crtica o horrio mais recente em que
a tarefa pode ser iniciada sem fazer com que
a tarefa crtica termine aps o prazo final.
Na maioria dos casos, uma tarefa iniciar
bem antes do horrio de incio crtico, de
forma que se sua execuo levar mais tempo
que a durao estimada, a situao no se
tornar imediatamente crtica. Portanto, se
uma tarefa no for iniciada e o horrio de
incio crtico estiver apenas alguns minutos
atrasado, a concluso adequada da tarefa
crtica ser considerada possivelmente um
risco.
A opo approachingLateOffset permite
determinar o perodo de tempo antes do
horrio de incio crtico de uma tarefa na
rede crtica em que voc alertado para esse
possvel risco. Se uma tarefa ainda no tiver
iniciado o nmero de segundos especificado
antes do horrio de incio crtico, a tarefa
ser includa na lista de favoritos que pode
ser visualizada no Dynamic Workload
Console. O padro 120 segundos.
Nota: O valor desse parmetro verificado
regularmente. No necessrio executar a
JnextPlan para que as alteraes sejam
efetivadas.
Captulo 5. Utilizando Garantia do Servio de Carga de Trabalho
99
Tabela 10. Opes Globais de Garantia de Servio de Carga de Trabalho (continuao)

Opo
Descrio
deadlineOffset | do
Em geral, um prazo final deve ser

especificado para uma tarefa sinalizada
como critical. Se no for, o planejador
utilizar o prazo final definido para o fluxo
de tarefas.
A opo deadlineOffset fornece um
deslocamento utilizado para calcular o
horrio de incio crtico no caso do prazo
final no existir para uma tarefa crtica e seu
fluxo de tarefas. O fim do plano mais esse
deslocamento so assumidos como o prazo
final da tarefa crtica. O deslocamento
expresso em minutos. O padro 2 minutos.
Importante: Quando o plano estendido, o
horrio de incio de tarefas crticas com um
prazo final calculado com esse mecanismo
alterado automaticamente como
conseqncia do fato que ele deve agora
corresponder ao horrio de encerramento do
novo plano.
Para obter informaes adicionais sobre opes globais, consulte Guia de

Opes locais
A garantia do servio de carga de trabalho utiliza opes locais para controlar a
alocao de prioridade de recursos do sistema para tarefas na rede crtica que
devem ser promovidas para manter o prazo final crtico. A Tabela 11 na pgina 101
mostra as opes locais utilizadas pelo recurso de garantia de servio de carga de
trabalho. Para configurar opes locais, edite o arquivo twshome\localopts em cada
estao de trabalho em que as tarefas crticas estaro em execuo. Execute
JnextPlan ou reinicie o agente para que as alteraes feitas nas opes locais
tomem efeito.
100
Tabela 11. Opes Locais de Garantia de Servio de Carga de Trabalho

Opo
Descrio
jm promoted nice
Configura o valor nice para ser designado a

tarefas crticas ou predecessores de tarefas
crticas que precisam ser promovidos nos
sistemas operacionais UNIX e Linux, para
que sejam designados mais recursos para
eles e eles sejam processados antes das
outras tarefas.
Valores especficos variam para as diferentes
plataformas, mas, no geral, a configurao
deve ser um nmero inteiro negativo. O
padro -1 e nmeros mais baixos
representam prioridades mais altas. Se voc
especificar um nmero inteiro positivo, o
valor padro ser utilizado.
A opo local jm nice tem uma funo
similar na priorizao de tarefas que foram
enviadas pelo usurio root. Uma tarefa
crtica que foi enviada pelo usurio root
poder ser elegvel para os dois mecanismos
de priorizao. Nesse caso, os valores sero
includos juntos. Por exemplo, se jm
promoted nice for configurado para -4 e jm
nice for -2, a tarefa crtica enviada pelo
usurio root ter uma prioridade -6.
jm promoted priority
Configura o valor de prioridade para tarefas

crticas ou predecessores de tarefas crticas
que precisam ser promovidos para que
sistemas operacionais Windows designem
mais recursos para ele e os processem antes
das outras tarefas.
Os valores possveis so:
v Alto
v AboveNormal
v Normal
v BelowNormal
v Low ou Idle
O padro AboveNormal.
Observe que, se voc configurar um valor de
prioridade menor que um que pode ser
designado para tarefas no-crticas, nenhum
aviso ser fornecido e nenhum mecanismo
como aquele disponvel para jm promoted
nice dever ser configurado novamente
como o padro.
Requisitos do Arquivo de Segurana

obrigatrio que os usurios que possuem as instncias do Tivoli Workload
Scheduler que executam tarefas crticas sejam autorizados para trabalhar com todas
as tarefas, fluxos de tarefa e estaes de trabalho associados a estas tarefas. Estes
101
usurios devem, portanto, ter os direitos DISPLAY, MODIFY e LIST no arquivo de

segurana para todos os objeto associados a JOB, SCHEDULE e CPU.
Consulte o Guia de Administrao do Tivoli Workload Scheduler para obter detalhes
sobre o arquivo de segurana.
Planejando Tarefas Crticas

A garantia de servio de carga de trabalho fornece um meio de identificar tarefas
crticas, definir prazos finais e calcular horas para todas as tarefas que devem
preceder a tarefa crtica.
Se for imprescindvel que uma tarefa seja concluda antes de um horrio especfico,
voc poder sinaliz-la como crtica ao inclu-la em um fluxo de tarefas utilizando
as funes do Workload Designer no Dynamic Workload Console . possvel
definir o prazo final no nvel da tarefa ou do fluxo de tarefas.
As tarefas tambm podem ser sinalizadas como crticas pela incluso da
palavra-chave critical na instruo de tarefa quando um fluxo de tarefas criado
ou modificado usando a linha de comandos do composer.
Quando o comando JnextPlan executado para incluir a nova tarefa no plano de
produo, todas as tarefas que so predecessoras diretas ou indiretas da tarefa
crtica so identificadas. Estas tarefas, juntamente com a tarefa crtica em si,
formam uma rede crtica.
Como a sincronizao de tarefas na rede crtica deve ser rigidamente controlada, o
Planejador de Tempo calcula as seguintes avaliaes de desempenho para cada
tarefa da rede crtica:
Incio Crtico
Ele aplica-se apenas a sistemas distribudos e representa a hora mais
recente em que a tarefa pode ser iniciada sem fazer com que a tarefa crtica
perca seu prazo final.
Os horrios de incio crticos so calculados iniciando com o prazo final
configurado para a tarefa crtica e trabalhando para trs utilizando a
durao estimada de cada tarefa para determinar seu horrio de incio
crtico. Por exemplo, se o prazo final da tarefa crtica for 19h e a durao
estimada da tarefa crtica for 30 minutos, a tarefa crtica no ser concluda
dentro do prazo final, a menos que tenha comeado s 18h. Se o
predecessor imediato da tarefa crtica tiver uma durao estimada de 20
minutos, ele dever comear no mximo s 18h10.
Nota: Apenas o prazo final da tarefa crtica considerado quando se
calcula horrios de incio crticos para as tarefas na rede crtica. Se
outras tarefas tiverem prazos finais definidos, suas horas de incio
crticas devero ser posteriores aos seus prazos finais.
Incio Antecipado
Representa a hora mais antiga em que uma tarefa na rede crtica poderia
comear, levando em considerao todos os requisitos de dependncias e
de recursos.
Horrios de incio e de encerramento estimados
As horas de incio estimadas so calculadas comeando com a hora mais
antiga em que a primeira tarefa ou tarefas na rede crtica poderiam
102
comear, e trabalhando na dianteira utilizando a durao estimada de cada

tarefa para estimar a hora de incio da tarefa que segue.
Horrios de incio e de encerramento planejados
Para os clculos iniciais, estes valores so configurados nos horrios de
incio e de encerramento estimados. Eles so recalculados
subseqentemente para levar em considerao cada alterao ou atraso no
plano.
Durao prevista
A durao estimada de uma tarefa baseada nas estatsticas coletadas de
execues anteriores da tarefa. Se a tarefa nunca foi executada antes,
utilizado um valor padro de um minuto. Leve-o em conta ao considerar a
exatido das horas calculadas para as redes de tarefas crticas que incluem
tarefas sendo executadas pela primeira vez. NO caso de uma tarefa
sombra, a durao estimada sempre configurada com o valor padro de
um minuto. Isso se aplica s tarefas sombra sendo executadas pela
primeira vez, assim como qualquer execuo subsequente da tarefa
sombra.
As horas de cada tarefa na rede crtica so includas no arquivo Symphony que
inclui todas as informaes do plano e que distribudo para todas as estaes de
trabalho onde as tarefas devem ser executadas.
Conforme o plano executado, o Monitor do Plano monitora todas as redes
crticas: alteraes subseqentes na rede crtica que afetam a sincronizao das
tarefas acionaro o reclculo dos horrios de incio crticos e estimados. As
mudanas podem incluir mudanas manuais, por exemplo, liberar dependncias
ou reexecutar tarefas, e mudanas feitas automaticamente pelo sistema em resposta
a um risco potencial ou real para a concluso em tempo hbil da tarefa crtica.
Visualizaes especficas para tarefas crticas e seus predecessores, disponveis no
Dynamic Workload Console , permitem que voc monitore o processamento da
rede crtica. As visualizaes podem identificar problemas imediatamente no
planejamento da tarefa crtica. Por exemplo, se a hora de incio estimada de uma
tarefa na rede crtica for posterior hora de incio crtica, isso ser imediatamente
sinalizado como um possvel risco para a tarefa crtica.
Processando e Monitorando Tarefas Crticas

A garantia de servio de carga de trabalho fornece rastreamento automtico e
priorizao de tarefas de rede crticas e funes on-line que voc utiliza para
monitorar e intervir no processamento de tarefas de rede crticas.
Rastreamento e Priorizao Automticas

Para garantir que prazos finais crticos possam ser cumpridos, a garantia de
servio de carga de trabalho fornece os seguintes servios automatizados para
tarefas crticas e tarefas predecessoras que formam suas redes crticas:
Promoo
Quando a hora de incio crtica de uma tarefa est se aproximando e a
tarefa ainda no comeou, o mecanismo de promoo utilizado. Uma
tarefa promovida recebe recursos de sistema operacional adicionais e seu
envio tem prioridade.
O tempo das promoes controlado pela opo global promotionoffset.
Tarefas promovidas so selecionadas para envio aps as tarefas que tm
103
prioridades "alta" e "ir", mas antes de todas as outras tarefas. A priorizao

de recursos do sistema operacional controlada pelas opes locais jm
promoted nice (UNIX e Linux) e jm promoted priority (Windows).
Clculo do caminho crtico
O caminho crtico a cadeia de dependncias, levando tarefa crtica, que
tem o maior risco de perder o prazo final em qualquer momento fornecido.
O caminho crtico calculado utilizando horrios de encerramento
estimados dos predecessores de tarefa crtica. Voltando a partir da tarefa
crtica, o caminho construdo selecionando o predecessor com o horrio
de encerramento estimado mais recente. Se o horrio de encerramento real
for substancialmente diferente do horrio de encerramento estimado, o
caminho crtico ser automaticamente recalculado.
Figura 21 mostra o caminho crtico atravs de uma rede crtica em um
momento especfico durante o processamento do plano.
Job_x
Est End
15.00
Job_y
Est End
16.20
Job1a
Est end
15.19
Job1b
Est End
15.30
Job2a
Est End
16.32
Job2b
Est End
16.20
Job3a
Eest End
17.58
Job3b
Est End
17.46
Job4
Prazo Final
19.00
Figura 21. Caminho crtico
Neste momento, o caminho crtico inclui Job3a, Job2a e Job1a. Job3a e

Job3b so os predecessores imediatos da tarefa crtica, Job4 e Job3a tm a
104
data de encerramento estimada mais recente. Job3a tem dois predecessores

imediatos, Job2a e Job_y. Job2a tem o horrio de encerramento mais
recente, e assim por diante.
Incluso de tarefas na lista crtica
Tarefas que fazem parte da rede crtica so includas em uma lista crtica
que associada tarefa crtica em si. A lista crtica inclui quaisquer tarefas
de rede crticas que tm um impacto real ou potencial na concluso em
tempo hbil da tarefa crtica. Tarefas so includas na lista crtica por uma
ou mais das razes listadas a seguir. Observe que apenas as tarefas que
comeam a rede crtica atual, para a qual no h um predecessor, podem
ser includas na lista crtica.
v A tarefa parou com um erro. A durao do tempo antes do horrio de
incio crtico determinada pela opo global approachingLateOffset.
v A tarefa ficou em execuo mais tempo do que o estimado por um fator
definido na opo global longDurationThreshold.
v A tarefa ainda no foi iniciada, embora todas as suas dependncias de
seqncias tenham sido resolvidas ou liberadas, e pelo menos uma das
condies a seguir verdadeira:
A hora de incio crtica foi quase atingida.
A tarefa planejada para execuo em uma estao de trabalho onde
o limite configurado como zero.
A tarefa pertence a um fluxo de tarefas para o qual o limite est
configurado como zero.
A tarefa ou seu fluxo de tarefas foram suprimidos.
A tarefa ou seu fluxo de tarefas tm atualmente uma prioridade
inferior fence ou esto configurados como zero.
Configurao de status de risco alto ou potencial para a tarefa crtica
Um status de risco pode ser configurado para a tarefa crtica da seguinte
forma:
Risco Alto
Os tempos calculados mostram que a tarefa crtica ser concluda
antes de seu prazo final.
Risco Potencial
Tarefas predecessoras crticas foram includas na lista crtica.
Rastreamento On-line de Tarefas Crticas

O Tivoli Dynamic Workload Console fornece visualizaes especializadas para
rastrear o progresso de tarefas crticas e seus predecessores. possvel acessar as
visualizaes a partir do Painel ou criando tarefas Procurar Tarefas Crticas.
A visualizao inicial lista todas as tarefas crticas para o mecanismo, mostrando o
status: normal, risco potencial ou risco alto. Nesta visualizao, possvel navegar
para ver:
v A lista especial de tarefas que colocam o prazo final crtico em risco.
v O caminho crtico.
v Detalhes de todos os predecessores crticos.
v Detalhes dos predecessores crticos concludos.
v Logs de tarefas que j foram executadas.
105
Utilizando as visualizaes, possvel monitorar o progresso da rede crtica,

descobrir problemas atuais e potenciais, liberar dependncias e reexecutar tarefas.
Cenrio de Garantia de Servio de Carga de Trabalho

Este cenrio ilustra o uso do Workload Service Assurance para garantir que prazos
finais de produo importantes possam ser atendidos.
A Fine Cola utiliza o Tivoli Workload Scheduler para gerenciar a sincronizao e as
interdependncias de seu processo de produo e fornecimento.
A Fine Cola possui acordos de nvel de servio com vrios clientes que suportam a
reestocagem "sob demanda". Isto significa que incios postergados em qualquer
uma das rotas de entrega certamente resultaro na falta de produtos da Fine Cola
nas prateleiras.
A tarefa que produz os pedidos de carregamento para caminhes deve ser
concluda no mximo s 5h30. Esta tarefa depende da concluso bem-sucedida de
outras tarefas. Por exemplo, embora pedidos sejam processados antes da hora,
mudanas de ltima hora acontecem quando os caminhes retornam aps concluir
uma rota de entrega. A Fine Cola tambm fornece faturas com notas de entrega,
portanto as mudanas nos pedidos tambm devem ser refletidas nos preos e
podem acionar ajustes de oferta especial nos preos.
Planejando a Tarefa Crtica

Usando o Workload Designer no Dynamic Workload Console, o planejador Fine
Cola sinaliza a tarefa de ordem de carregamento como crtica e configura o prazo
final para 5 horas das manh.
Quando JnextPlan executado, as datas de incio crticas para esta tarefa e todas
as tarefas identificadas como predecessoras da tarefa crtica so calculadas.
Rastreando a Tarefa Crtica

1. O operador do Tivoli Workload Scheduler verifica os painis e v que existem
tarefas crticas planeadas em um dos mecanismos.
2. Ele v que h uma tarefa crtica em risco potencial. Ele clica no link de risco
potencial para obter a lista de tarefas crticas nesse estado.
A tarefa de pedidos de carregamento mostra um status de "possvel risco".
3. Ele seleciona a tarefa e clica em Lista de Favoritos para a ver a tarefa ou tarefas
que esto colocando a tarefa crtica em risco.
A tarefa de ajuste de pedidos listada como estando com erro.
4. Ele seleciona a tarefa e clica em Log de Tarefa.
O log mostra que a tarefa falhou devido a credenciais incorretas para o banco
de dados de pedidos.
5. Aps descobrir que a senha do banco de dados foi alterada nesse dia, ele altera
a definio de tarefa no arquivo symphony e reexecuta a tarefa.
6. Quando ele retorna ao painel, v que no h mais nenhuma tarefa em risco
potencial. Alm disso, a lista de tarefas crticas que foi aberta ao clicar no link
de risco potencial no mostra mais a tarefa crtica aps a tarefa ser reexecutada.
7. A tarefa est agora em execuo e foi promovida automaticamente de forma a
receber uma prioridade mais alta para envio e recursos do sistema.
106
8. Nenhum problema adicional precisa de correo e a tarefa crtica finalmente

concluda s 4h45.
107
108
Captulo 6. Customizando a Carga de Trabalho Utilizando

Tabelas de Variveis
Este captulo introduz o conceito de tabelas de variveis para agrupar parmetros
globais, daqui em diante chamadas de variveis, para customizar sua carga de
trabalho.
A partir do Tivoli Workload Scheduler verso 8.5, o que era chamado de
parmetros globais nas verses anteriores, agora so chamados de variveis. As
definies das variveis esto contidas nas tabelas de variveis. Uma tabela de
varivel um objeto que agrupa vrias variveis. Utilizando tabelas de variveis,
possvel designar diferentes valores para a mesma varivel para utilizar nas
definies de tarefa e de fluxo de tarefas na JCL, logon, dependncias de avisos,
dependncias de arquivos e prompts de recuperao. Isto particularmente til
quando uma definio de tarefa utilizada como modelo para uma tarefa que
pertence a mais de um fluxo de tarefa. Por exemplo, possveld designar valores
fluxos de tarefas diferentes, economizando tempo e dinheiro.
Quando voc define uma varivel, voc a designa a uma tabela de varivel porque
a mesma varivel pode ser definida em diferentes tabelas de variveis com
diferentes valores. Ou uma melhor abordagem criar uma ou mais tabelas de
variveis, especificando uma lista de nomes de variveis e valores para cada
tabela. Ao fazer isto, possvel incluir o mesmo nome de varivel com diferentes
valores em diferentes tabelas. Ao solicitar uma lista de variveis, voc obtm pares
variabletable.variablename para identificar facilmente a que tabela de variveis a
varivel pertence.
Por exemplo, a varivel VAR1 definida na tabela de variveis REP1_TABLE1
mostrada como:
REP1_TABLE1.VAR1
possvel designar tabelas de variveis para ciclos de execuo, fluxos de tarefas e

estaes de trabalho.
Com tarefas de variveis, voc altera o comportamento da carga de trabalho de
acordo com quando, porque e onde deseja executar seu planejamento, dando a
voc uma maior flexibilidade para customizar sua carga de trabalho e para
cumprir os acordos de nvel de servio. Em detalhe:
Quando
Para alterar o comportamento de tarefas e fluxos de tarefas com base em
quando elas esto planejadas para executar, isto , em quais dias elas so
executadas. Utilizando tabelas de variveis com ciclos de execuo.
Finalidade
Para alterar o comportamento de tarefas e fluxos de tarefas com base na
finalidade de elas serem planejadas para executar, por exemplo, para criar
uma tarefa que executa comandos diferentes. Utilizando tabelas de
variveis com fluxos de tarefas.
Onde
Para alterar o comportamento de tarefas e fluxos de tarefas com base no

local onde elas so executadas, por exemplo, em estaes de trabalho
diferentes. Utilizando tabelas de variveis com estaes de trabalho.
109
Migrando Parmetros Globais de Verses Anteriores

Ao atualizar a partir de verses anteriores para a 8.5, as definies de parmetros
globais, daqui em diante chamadas de definies de variveis, que voc possui no
banco de dados, so migradas automaticamente para a tabela de varivel padro
chamada MAIN_TABLE. Aps a atualizao:
v Todas as variveis so precedidas pelo nome de tabela padro. Por exemplo,
aps a migrao, a varivel REP_PATH receber o seguinte nome:
MAIN_TABLE.REP_PATH
Ao solicitar uma lista de variveis, voc obtm pares variabletable.variablename

para identificar facilmente a que tabela de variveis a varivel pertence.
v Sua carga de trabalho determinada como antes da migrao, desde que
qualquer objeto do Tivoli Workload Scheduler que contenha variveis se refira
MAIN_TABLE para resoluo da varivel.
v Para cada seo do usurio que inclui a palavra-chave parameter, a seguinte
linha includa no arquivo de segurana:
vartable name=@ access=add,delete,display,modify,list,use,unlock
Consulte o manual Tivoli Workload Scheduler: Planejamento e Instalao para obter

detalhes sobre o processo de upgrade.
Ao atualizar a partir das verses 8.3 ou posteriores, no modifique as variveis at
que voc migre o gerenciador de domnio principal e todos os seus principais de
backup porque nesta fase de transio voc possui duas verses diferentes do
banco de dados. Se voc precisar incluir ou modificar variveis durante esta fase
de transio, certifique-se de fazer a alterao em ambos os principais, da verso
8.3 ou 8.4 e da verso 8.5.
Os parmetros locais que foram criados e gerenciados com o comando do utilitrio
parms no banco de dados de parmetro local nas estaes de trabalho funcionam
como anteriormente.
A Tabela de Variveis Padro

Este tpico descreve a tabela de variveis padro e como ela funciona.
A tabela de variveis padro a tabela que contm todas as variveis que voc
definiu sem especificar nenhum nome de tabela de variveis. O nome padro da
tabela de variveis padro MAIN_TABLE. possvel modificar esse nome a
qualquer momento ou configurar outra tabela de variveis como a tabela de
variveis padro. No possvel excluir a tabela de variveis padro. Quando voc
configura outra tabela de variveis como o padro, a tabela de variveis padro
original no mais marcada como padro. possvel trabalhar com a tabela de
variveis padro da mesma maneira que com qualquer outra tabela de variveis.
possvel identificar facilmente a tabela de variveis padro na interface com o
usurio, pois ela marcada com um Y no campo default.
Exemplo
Este exemplo mostra uma lista de tabelas de variveis
Variable Table Name
---------------------------------------MAIN_TABLE
VT_1
110
Default Updated On Locked By

------- ---------- ---------------Y
05/07/2008 05/07/2008 -
VT_2
VARTABLE3
V4
VT5
05/07/2008 05/07/2008 05/07/2008 05/07/2008 -
AWSBIA291I Total objects: 6
Integridade de Dados para Tabelas de Variveis

Este tpico explica como a integridade de dados garantida utilizando as tabelas
de variveis.
Assim como ocorre com os outros objetos, o Tivoli Workload Scheduler mantm a
integridade de dados da tabela de variveis sempre que voc executa comandos
que criam, modificam, renomeiam ou excluem a definio de uma tabela de
variveis.
Ao fazer referncia a uma tabela de variveis de qualquer ciclo de execuo, fluxo
de tarefas ou estao de trabalho, o Tivoli Workload Scheduler verifica se a tabela
de variveis existe e preserva o link entre ela e o ciclo de execuo, o fluxo de
tarefas e a estao de trabalho. Isto significa que voc no pode excluir uma
definio de tabela de varivel enquanto uma referncia de um ciclo de execuo,
um fluxo de tarefa ou uma estao de trabalho ainda existe.
A integridade das referncias garantida no nvel da tabela de variveis e no no
nvel de varivel, isto , quando um ciclo de execuo, um fluxo de tarefas e uma
estao de trabalho faz referncia a uma tabela de variveis, o Tivoli Workload
Scheduler verifica se essa tabela existe, no se a varivel mencionada existe.
Mecanismo de Bloqueio para Tabelas de Variveis

Este tpico descreve como o mecanismo de bloqueio funciona para tabelas de
variveis.
O bloqueio configurado no nvel de tabela de variveis para assegurar que as
definies no banco de dados no sejam sobrescritas por diferentes usurios que
esto acessando simultaneamente a mesma tabela de variveis. Isto significa que
voc obtm permisses exclusivas para todas as variveis nessa tabela tanto
quando bloqueia uma tabela de variveis como quando bloqueia uma varivel. Isto
, possvel executar quaisquer comandos na tabela de variveis bloqueada e em
todas as variveis contidas nela. Qualquer outro usurio tem apenas acesso de
leitura a essa tabela de variveis e s variveis contidas nela.
Isto impede que qualquer outro usurio altere a mesma tabela de varivel que
voc est alterando. Se outro usurio tentar bloquear uma tabela de variveis ou
uma varivel que voc j tenha bloqueado, uma mensagem de erro ser retornada.
Segurana da Tabela de Varivel

Este tpico descreve como definir configuraes de segurana para tabelas de
variveis.
O acesso do usurio a tabelas de variveis deve ser autorizado no arquivo de
segurana do Tivoli Workload Scheduler. Assim como para outros objetos, o
conector verifica a existncia de autorizao apropriada antes de executar uma
ao que requeira acesso a uma tabela de varivel. A nova palavra-chave a seguir
est disponvel no arquivo de segurana para esta finalidade:
Captulo 6. Customizando a Carga de Trabalho Utilizando Tabelas de Variveis
111
vartable name=@ access=add,delete,display,modify,list,use,unlock
necessrio o acesso use para poder referenciar uma tabela de varivel de outros
objetos (fluxos de tarefa, ciclos de execuo e estaes de trabalho). Os filtros de
segurana so baseados apenas no atributo name, mas seu administrador do Tivoli
Workload Scheduler tem a opo de utilizar a palavra-chave $default para
especificar permisses de segurana na tabela padro, independentemente de seu
nome.
A permisso para trabalhar em uma varivel no mais baseada na varivel
individual mas na tabela que a contm. O acesso a uma varivel concedido
apenas se a ao correspondente na tabela de varivel que a inclui for permitida. A
tabela a seguir mostra as permisses correspondentes para variveis e tabelas de
variveis:
Tabela 12. O Relacionamento entre as Tabelas de Variveis em suas Variveis no Arquivo
de Segurana do Tivoli Workload Scheduler
Acesso definido tabela de varivel
Ao permitida nas variveis contidas

add
modify
excluir
modify
display
display
destravar
destravar
A partir da verso 8.5, a palavra-chave parameter no arquivo de segurana se

aplica apenas a parmetros locais.
Consulte o Guia de Administrao do Tivoli Workload Scheduler para obter detalhes
sobre o arquivo de segurana.
Resoluo de Varivel
Este tpico descreve como as variveis so determinadas quando voc gera um
plano e quando envia uma tarefa ou um fluxo de tarefas.
Quando voc gera um plano, o Tivoli Workload Scheduler analisa as tabelas de
variveis na ordem mostrada a seguir para resoluo da varivel:
1. No ciclo de execuo.
2. No fluxo de tarefas.
3. Na estao de trabalho. Consulte Estao de Trabalho Considerada para
Resoluo de Variveis na pgina 113.
4. Na tabela de variveis padro.
No momento de resoluo do plano, cada nvel analisado na ordem descrita
acima. Se voc especificar uma varivel que no esteja contida em nenhuma tabela
de variveis, incluindo a padro, uma mensagem de aviso contendo o nome da
varivel no resolvida ser gravada no arquivo de log TWS_home\eWAS\profiles\
TIPProfile\logs\twaserver\SystemOut.log e o nome da varivel ser deixado no
plano.
Quando voc envia um fluxo de tarefas, o Tivoli Workload Scheduler determina
variveis analisando as tabelas de variveis na ordem mostrada a seguir:
1. Especificada durante a operao de envio.
112
2. No fluxo de tarefas.
Resoluo de Variveis.
Quando voc envia uma tarefa, o Tivoli Workload Scheduler determina variveis
analisando as tabelas de variveis na ordem mostrada a seguir:
1. Especificada durante a operao de envio.
Resoluo de Variveis.
Estao de Trabalho Considerada para Resoluo de Variveis

Quando a varivel determinada pela tabela de variveis especificada na estao
de trabalho, a estao de trabalho levada em considerao :
Para varivel na dependncia de arquivo
A estao de trabalho em que o arquivo reside.
Para varivel na tarefa
A estao de trabalho onde a tarefa definida.
Para varivel na dependncia de aviso
Prompt Global
Nenhuma estao de trabalho levada em considerao. As
variveis em prompts globais so determinadas sempre utilizando
a tabela de variveis padro. Isso ocorre porque o prompt global
utilizado por todas as tarefas e fluxos de tarefas, portanto, apenas
um valor deve ser utilizado para a resoluo da varivel.
Prompt ad hoc
A estao de trabalho na qual a tarefa ou o fluxo de tarefas que
depende da dependncia de aviso definida.
Captulo 6. Customizando a Carga de Trabalho Utilizando Tabelas de Variveis
113
114
Captulo 7. Automao de Carga de Trabalho Orientada pelo

Evento em Execuo
A automao de carga de trabalho orientada por evento inclui a capacidade de
executar a automao de carga de trabalho On Demand, alm do planejamento de
tarefa baseado em plano. Fornece a capacidade de definir regras que podem
acionar a automao de carga de trabalho On Demand.
O objeto da automao de carga de trabalho orientada por evento no Tivoli
Workload Scheduler executar um conjunto predefinido de aes em resposta a
eventos que ocorrem nos ns em que o Tivoli Workload Scheduler executado
(mas tambm em ns no-Tivoli Workload Scheduler, quando a linha de comandos
sendevt utilizada). Isso implica na capacidade de enviar a carga de trabalho e
executar comandos on the fly, notificar usurios por meio de e-mail ou enviar
mensagens ao Tivoli Enterprise Console.
As principais tarefas da automao de carga de trabalho orientada por evento so:
v Acionar a execuo de tarefas em lote e fluxos de tarefas com base na recepo
ou combinao de eventos em tempo real.
v Responder a avisos
v Notificar os usurios quando condies anormais ocorrem no ambiente de
planejamento do Tivoli Workload Scheduler ou na atividade de planejamento em
lote.
v Chamar um produto externo quando uma condio de evento especfica ocorre.
A automao de carga de trabalho orientada por evento baseada no conceito de
regra de evento. No Tivoli Workload Scheduler, uma regra de evento um objeto
de planejamento que inclui os seguintes itens:
v Eventos
v Condies de correlao de eventos
v Aes
Quando voc definir uma regra de evento, especifique um ou mais eventos, uma
regra de correlao e uma ou mais aes que sejam acionadas por esses eventos.
Alm disso, possvel especificar datas de validades, um intervalo de tempo dirio
da atividade e um fuso horrio comum para todas as restries de tempo
configuradas.
Os eventos que o Tivoli Workload Scheduler pode detectar para o acionamento da
ao podem ser:
Eventos Internos
Eles so eventos que envolvem o status do aplicativo interno do Tivoli
Workload Scheduler e alteraes no status dos objetos do Tivoli Workload
Scheduler. Eventos desta categoria podem ser alteraes de status de
tarefas ou fluxos de tarefas, tarefas ou fluxos de tarefas crticos sofrendo
atrasos ou cancelamentos e alteraes de status de estaes de trabalho.
Eventos Externos
Eles so eventos que no envolvem diretamente o Tivoli Workload
Scheduler que podem impactar, entretanto, o envio de carga de trabalho.
115
Eventos desta categoria podem ser mensagens gravadas em arquivos de

log, eventos enviados por aplicativos de terceiros ou um arquivo sendo
criado, atualizado ou excludo.
Em uma regra, dois ou mais eventos podem ser correlacionados por meio de
atributos de correlao, tais como uma estao de trabalho ou tarefa comum. Os
atributos de correlao fornecem uma maneira de direcionar a regra para criar uma
regra separada (ou cpia de si mesma) para cada grupo de eventos que
compartilham caractersticas comuns. Em geral, cada regra ativa possui uma cpia
em execuo no servidor de processamento de eventos. Entretanto, s vezes, a
mesma regra necessria para diferentes grupos de eventos, que geralmente esto
relacionados a diferentes grupos de recursos. Utilizar um ou mais atributos de
correlao um mtodo de direcionar uma regra para criar uma cpia da regra
separada para cada grupo de eventos com caractersticas comuns.
As aes que o Tivoli Workload Scheduler pode executar quando detecta qualquer
um destes eventos podem ser:
Aes Operacionais
Elas so aes que causam a alterao no status dos objetos do
planejamento. Aes desta categoria so enviar uma tarefa, fluxo de tarefas
ou comando, ou responder a um aviso.
Aes de Notificao
Elas so aes que no possuem impacto no status dos objetos de
planejamento. As aes pertencentes a esta categoria esto enviando um
e-mail, registrando o evento em um banco de dados de auditoria interna,
encaminhando o evento ao Tivoli Enterprise Console ou executando um
comando que no seja do Tivoli Workload Scheduler.
Esta classificao de eventos e aes conceitual. Ela no influencia na maneira
que eles so tratados pelo mecanismo acionado por eventos.
Cenrios Simples de Regras de Eventos

Esta seo lista alguns cenrios simples que envolvem o uso de regras de eventos.
A codificao XML correspondente mostrada na Exemplos de Regras de
Eventos na pgina 125.
Cenrio 1: Envia notificao por e-mail
1. O administrador define a seguinte regra de evento:
v Quando alguma das tarefas job123 finaliza com erro e gera a
seguinte mensagem de erro:
AWSBHT001E The
job "MYWORKSTATION#JOBS.JOB1234" in file "ls" has
failed with the error: AWSBDW009E The following operating system
error occurred retrieving the password structure for either the
logon user...
enviar um e-mail ao operador john.smith@mycorp.com. O assunto do

e-mail inclui os nomes da instncia da tarefa e da estao de trabalho
associada.
A regra de evento vlida de 1 de Dezembro a 31 de Dezembro no
espao de tempo 12h-16h, horrio do leste.
2. O administrador salva a regra como um no-rascunho no banco de
dados e ela implementada prontamente pelo Tivoli Workload
Scheduler.
116
3. O planejador inicia o monitoramento das tarefas e toda vez que uma

delas termina com erro, John Smith recebe um e-mail para que ele
possa verificar a tarefa e tome uma ao corretiva.
Cenrio 2: Monitor que a estao de trabalho vincula de volta
v Se o link da estao de trabalho CPU1 for removido e o link no for
reestabelecido dentro do perodo de 10 minutos, envia uma
notificao por e-mail para chuck.derry@mycorp.com.
Scheduler.
3. O planejador inicia o monitoramento de CPU1.
Se o status da estao de trabalho se tornar desvinculado, o Tivoli
Workload Scheduler ser iniciado dentro do tempo limite de 10
minutos. Se o evento CPU1 linked no for recebido dentro de 10
minutos, o planejador envia a notificao por e-mail a Chuck Derry.
4. Chuck Derry recebe o e-mail, consulta as aes/regras que foram
acionadas nos ltimos 10 minutos, e a partir da navega at a instncia
CPU1 e executa uma primeira anlise de problema.
Cenrio 3: Enviar o fluxo de tarefas quando o FTP tiver sido concludo
v Quando o arquivo daytransac* for criado no diretrio SFoperation
na estao de trabalho system1 e as modificaes no arquivo forem
finalizadas, envie o fluxo de tarefas calmonthlyrev.
A regra de evento vlida durante o ano no espao de tempo das
18h s 22h no horrio do leste.
Scheduler.
3. O planejador inicia o monitoramento do diretrio SFoperation. Assim
que o arquivo daytransac* criado e no est mais em utilizao, ele
envia o fluxo de tarefas calmonthlyrev.
4. O operador pode verificar os logs para localizar se a regra de evento ou
o fluxo de tarefas foi executado.
Cenrio 4: Iniciar tarefas de longa durao com base no tempo limite
v Quando o evento job-x=exec e o evento job-x=succ/abend so
recebidos em 5 minutos, o planejador dever responder com Sim ao
prompt-1 e iniciar o fluxo de tarefas jobstream-z, caso contrrio ele
dever enviar um e-mail para twsoper@mycompany.com alertando que
a tarefa est atrasada.
2. O administrador salva a regra de evento no status de rascunho. Aps
alguns dias, ele edita a regra, muda o destinatrio de e-mail e a salva
como no-rascunho. A regra implementada.
3. Toda vez que o status de job-x se torna exec, o Tivoli Workload
Scheduler inicia o tempo limite de 5 minutos.
Se o estado interno job-x no alterar para succ ou abend dentro de 5
minutos e o evento correspondente no for recebido, o Tivoli Workload
Scheduler envia o e-mail, caso contrrio ele reaplica Sim ao prompt e
envia jobstream-z.
Captulo 7. Automao de Carga de Trabalho Orientada pelo Evento em Execuo
117
Cenrio 5: Integrao com o SAP R/3 (em combinao com o Tivoli Workload
Scheduler para Aplicativos)
v Quando um evento chamado ID3965 gerado no servidor SAP R/3
Billing, o Tivoli Workload Scheduler deve:
a. Executar o comando:
/usr/apps/helpDesk openTicket text
'Processing error $parameter
on SAP system $wsname
para abrir um ticket do service desk

b. Enviar um evento ao Tivoli Enterprise Console.
2. O administrador salva a regra como no-rascunho e ela
implementada prontamente.
3. O Tivoli Workload Scheduler inicia o monitoramento do status de
eventos do SAP R/3 ativados no sistema Billing.
Quando o evento ID3965 detectado, o Tivoli Workload Scheduler
executa o comando do help desk especificado e envia um evento ao
TEC.
4. Aps algum tempo, o administrador configura a regra de evento no
status de rascunho. A regra desativada automaticamente. Ela pode ser
implementada novamente quando necessrio.
Cenrio 5: Monitorando o status do processo e executando um script em lote
O administrador cria uma regra para monitorar o status de processos do
Tivoli Workload Scheduler e executa um script em lote.
|
|
|
O Processo de Gerenciamento de Regras de Eventos

A automao da carga de trabalho orientada por evento um processo contnuo e
pode ser reduzida s seguintes etapas:
1. Uma definio de regra de evento criada ou modificada com o Tivoli
Dynamic Workload Console ou com a linha de comandos do composer e salva
no banco de dados de objetos. As definies de regra podem ser salvas como
rascunho ou no-rascunho.
2. Todas as regras no-rascunho novas e modificadas salvas no banco de dados
so periodicamente (por padro, a cada cinco minutos) localizadas, construdas
e implementadas por um processo interno denominado construtor de regras.
Nesse momento, elas se tornam ativas. Entretanto, um servidor de
processamento de eventos, que normalmente est localizado no gerenciador de
domnio principal, recebe todos os eventos dos agentes e os processa.
3. As configuraes de monitoramento atualizadas so transferidas por download
para os agentes do Tivoli Workload Scheduler e ativadas. Cada agente do Tivoli
Workload Scheduler executa um componente denominado monman que gerencia
dois servios denominados mecanismo de monitoramento e ssmagent, os quais
devem capturar os eventos que ocorrem no agente e executar neles uma ao
de filtragem preliminar.
4. Cada monman detecta e envia seus eventos para o servidor de processamento de
eventos.
5. O servidor de processamento de eventos recebe os eventos e verifica se eles
correspondem a qualquer regra de evento implementada.
6. Se uma regra de evento for correspondida, o servidor de processamento de
eventos chamar um auxiliar de aes para executar as aes.
118
7. O auxiliar de aes cria uma instncia de regra de evento e registra o resultado

da ao no banco de dados.
8. O administrador ou o operador revisa o status das instncias de regras de
eventos e aes no banco de dados e logs.
O recurso de automao de carga de trabalho orientada por evento
automaticamente instalado com o produto. Ser possvel alterar o valor da opo
global enEventDrivenWorkloadAutomation a qualquer momento, caso no deseje
utiliz-la na rede do Tivoli Workload Scheduler.
A automao da carga de trabalho orientada a evento baseada em vrios
servios, subsistemas e mecanismos internos. Os seguintes so significativos
porque podem ser gerenciados:
monman
instalado em cada agente do Tivoli Workload Scheduler no qual ele
verifica todos os eventos locais. Todos os eventos detectados so
redirecionados ao servidor de processamento de eventos. Os seguintes
comandos conman esto disponveis para gerenciar o monman:
Tabela 13. Comandos conman para Gerenciar Mecanismos de Monitoramento
Comando
Finalidade
deployconf
Atualiza o arquivo de configurao de monitoramento

do mecanismo de monitoramento de eventos em um
agente. um comando opcional, uma vez que a
configurao normalmente implementada
automaticamente.
showcpus getmon
Retorna a lista de regras de eventos definidas para o

monitor em execuo em um agente. Esse comando
pode ser utilizado remotamente a fim de obter as
informaes do arquivo de configurao em outro
agente da rede.
startmon
Inicia o monman em um agente. Pode ser emitido a

partir de um agente diferente.
stopmon
Pra o monman em um agente. Pode ser emitido a partir

de um agente diferente.
monman inicializado automaticamente toda vez que um novo Symphony

for ativado. Isso determinado pela opo local autostart monman que
configurada como yes por padro (e que ser possvel desativar, se no
desejar monitorar eventos em um determinado agente).
Aps cada ciclo de implementao de regra, configuraes de
monitoramento atualizadas so automaticamente distribudas aos agentes
que hospedam as regras alteradas desde a ltima implementao. Observe
que pode haver algumas situaes transitrias enquanto a implementao
est em curso. Por exemplo, se uma regra est pendente de desativao, os
agentes podem estar enviando eventos na frao de tempo em que os
arquivos de configurao novos ainda no esto implementados, mas o
processador de eventos j os descarta.
|
|
|
Se um agente no puder enviar eventos ao servidor de processamento de

eventos por um perodo de tempo especificado, o status de monitoramento
do agente automaticamente desligado. O perodo de tempo pode ser
119
|
|
|
customizado (em segundos) com o parmetro edwa connection timeout no

arquivo localopts. Por padro, ele definido como 300 segundos (5
minutos).
|
|
|
|
|
|
|
|
|
|
Os eventos a seguir podem ser configurados no arquivo BMEvents.conf

para postar o status de monitoramento de um agente:
v TWS_Stop_Monitoring (261) : enviado quando o status de
monitoramento de um agente configurado como off (para o comando
stopmon ou porque o agente no pode enviar os eventos ao servidor de
processamento de eventos).
v TWS_Start_Monitoring (262): enviado quando o status de monitoramento
de um agente configurado como on (para o comando startmon ou
porque o agente reinicializou o envio de eventos ao servidor de
processamento de eventos).
Esses eventos possuem os seguintes campos posicionais:
|
|
1. Nmero do Evento
2. Estao de trabalho afetada
3. Reservado, atualmente sempre configurado como 1

Servidor de processamento de eventos
Pode ser instalado no gerenciador de domnio principal, principal de
backup ou em qualquer agente tolerante a falhas instalado como principal
de backup. executado no servidor de aplicativos integrado. Pode estar
ativo em apenas um n na rede. Ele constri as regras, cria arquivos de
configurao para os agentes e notifica os agentes para fazerem o
download das novas configuraes. Recebe e correlaciona os eventos
enviados pelos mecanismos de monitoramento e executa as aes. Os
seguintes comandos conman esto disponveis para gerenciar o servidor de
processamento de eventos:
Tabela 14. Comandos conman para Gerenciar o Servidor de Processamento de Eventos
Comando
Finalidade
starteventprocessor
Inicia o servidor de processamento de eventos
stopeventprocessor
Pra o servidor de processamento de eventos
switcheventprocessor
Comuta o servidor de processamento de eventos do

gerenciador de domnio principal para o backup
principal ou o agente tolerante a falhas instalado como
um backup principal, ou vice-versa.
O servidor de processamento de eventos inicializado automaticamente

com o gerenciador de domnio principal. Somente um processador de
eventos pode ser executado na rede a qualquer momento. Se voc desejar
executar o processador de eventos instalado em uma estao de trabalho
que no seja a principal (isto , no backup principal ou em qualquer agente
tolerante a falhas instalado como o backup principal), primeiro utilize o
comando switcheventprocessor para torn-lo o servidor de processamento
de eventos ativo.
Nota: Se voc configurar a palavra-chave ignore na definio de estao
de trabalho do agente (instalado como backup principal) que no
momento hospeda o processador de eventos ativo, a primeira
ocorrncia de JnextPlan a seguir reconhece que esse agente
especfico esteja fora do plano. Como conseqncia, no ser
possvel reiniciar o processador de eventos hospedado nesse agente.
120
Por esta razo, o planejador gera uma mensagem de aviso e inicia o

processador de eventos hospedado pelo gerenciador de domnio
principal.
Utilizando as Interfaces e Comandos Envolvidos

A execuo e o gerenciamento da automao da carga de trabalho orientada a
evento chamam as seguintes tarefas:
v Editar as definies de configurao
v Modelar regras de eventos
v Implementar ou desimplementar regras de eventos manualmente
v Gerenciar dispositivos de monitoramento e de processamento de eventos
v Monitorar e gerenciar instncias de regras de eventos
Voc deve estar pronto para utilizar vrias interfaces e comandos do Tivoli
Workload Scheduler para realiz-las. A Tabela 15 resume os necessrios:
Tabela 15. Interfaces e Comandos para Gerenciar a Automao de Carga de Trabalho
Orientada a Evento
Interface ou Comando
optman
Utilizar para...
Alterar os valores padro das opes globais associadas
ao gerenciamento de eventos. As opes globais so
utilizadas para configurar:
v A freqncia com que as definies de regras so
verificadas quanto existncia de atualizaes
(deploymentFrequency). As definies modificadas so
implementadas no domnio do Tivoli Workload
Scheduler
v O nmero de porta EIF em que o servidor de
processamento de eventos recebe eventos
(eventProcessorEIFPort ou eventProcessorEIFSSLPort
quando protegido com SSL).
v O gerenciamento das polticas de limpeza de instncia
de regra, execuo de ao e dados do log de
mensagens (logCleanupFrequency).
v As propriedades de servidor SMTP se forem
implementadas regras com aes que enviam e-mails
por meio de um servidor SMTP (smtpServerName,
smtpServerPort, smtpUseAuthentication, smtpUserName,
smtpUserPassword, smtpUseSSL, smtpUseTLS).
v As propriedades do servidor Tivoli Enterprise Console,
se voc implementar regras que implementem aes
que redirecionam eventos ao TEC (TECServerName,
TECServerPort ).
v A possibilidade de desativar o mecanismo de
gerenciamento de regras de eventos
( enEventDrivenWorkloadAutomation) que instalado
por padro com o produto.
Consulte o Guia de Administrao para obter uma lista de
opes globais.
121

Orientada a Evento (continuao)
composer
Utilizar para...
Executar a modelagem e o gerenciamento de tarefas das
definies de regras de eventos como incluir, criar, excluir,
exibir, extrair, listar, bloquear, modificar, novo, imprimir,
desbloquear, validar. As regras de eventos so definidas
em XML.
Consultar o banco de dados relacional do Tivoli Workload
Scheduler para:
v definies de regras de eventos filtradas por:
regra, evento e propriedades da ao
tarefas e fluxos de tarefas envolvidos com a ao da
regra
v instncias de regras de eventos, execuo de aes e
registros de log de mensagens
Consulte Definio da Regra de Evento na pgina 234
para saber como definir regras de eventos. Consulte
Captulo 9, Gerenciando Objetos no Banco de Dados Composer, na pgina 247 para obter a referncia de
comando.
Dynamic Workload Console
Possuir uma interface grfica com o usurio para:

v Modelar e gerenciar definies de regras de eventos
(procurar, criar, excluir, modificar, consultar,
desbloquear)
v Consultar o banco de dados relacional do Tivoli
Workload Scheduler para:
definies de regras de eventos filtradas por:
- regra, evento e propriedades da ao
- tarefas e fluxos de tarefas envolvidos com a ao
da regra
instncias de regras de eventos, execuo de aes e
registros de log de mensagens
v Gerenciar o servidor de processamento de eventos e
mecanismos de monitoramento, conforme descrito nas
tabelas Tabela 13 na pgina 119 e Tabela 14 na pgina
120
Consulte a documentao on-line do Dynamic Workload
Console .
conman
Gerenciar os dispositivos de monitoramento, isto , o

servidor de processamento de eventos e os mecanismos
de monitoramento, conforme descrito nas tabelas
Tabela 13 na pgina 119 e Tabela 14 na pgina 120.
Consulte Captulo 10, Gerenciando Objetos no Plano conman, na pgina 307 para obter a referncia de
comando.
comandos utilitrios
122
Criar definies de evento customizado e enviar

manualmente eventos customizados para o servidor de
processamento de eventos. Consulte evtdef na pgina
453 e sendevent na pgina 471 para obter detalhes
sobre esses comandos.

Orientada a Evento (continuao)
planman
Utilizar para...
Implementar manualmente regras novas e alteradas.
Consulte Regras de Implementao na pgina 87 para
obter detalhes.
Arquivo de Segurana
Configurar autorizaes de segurana para gerenciar

regras de eventos, eventos, aes e suas respectivas
instncias.
Consulte o Guia de Administrao do Tivoli Workload
Scheduler para referncia sobre como configurar o arquivo
de segurana do Tivoli Workload Scheduler.
Importante: Se usar um firewall de segurana, certifique-se de que as portas

definidas na opo global eventProcessorEIFPort e na opo local nm
port em cada agente estejam abertas para conexes de entrada e de
sada.
Definindo Regras de Eventos

Quando voc definir uma regra de evento, especifique um ou mais eventos, uma
regra de correlao e uma ou mais aes. Para definir as regras de eventos,
possvel utilizar:
v A linha de comandos do composer
v O Dynamic Workload Console
v Um conjunto de APIs descritas em um documento separado
No composer, edite as regras com um editor XML da sua escolha (de preferncia,
mas no obrigatoriamente), j que as definies de regra de evento so feitas
utilizando a sintaxe XML.
A explicao de como utilizar o composer para definir as regras de eventos est em
Definio da Regra de Evento na pgina 234, enquanto a explicao de como
utilizar o Dynamic Workload Console pode ser localizada em sua ajuda on-line.
As definies de regras de eventos so salvas no banco de dados do Tivoli
Workload Scheduler como todos os outros objetos de planejamento. possvel
salv-las como:
Rascunho
A regra salva no banco de dados, mas ainda no est pronta para ser
implementada e ativada.
Este estado determinado pelo atributo isDraft=yes.
No-rascunho
Esta regra est sendo implementada ou est pronta para ser implementada
no ambiente de planejamento.
Este estado determinado pelo atributo isDraft=no.
As regras no-rascunho esto prontas para ser ativadas. O construtor de
regras calcula o status de cada regra. O status pode ser:
v ativo
v no ativo
123
v
v
v
v
v
v
atualizao pendente
erro de atualizao
ativao pendente
erro de ativao
desativao pendente
erro de desativao
O planejador varre periodicamente (a cada cinco minutos ou de acordo com um

tempo configurado na opo de configurao global deploymentFrequency) o banco
de dados em busca de regras no-rascunho e cria arquivos de configurao de
regra para implementao. As novas configuraes de monitoramento so
transferidas por download para os agentes (cada agente obtm seu prprio arquivo
de configurao contendo estritamente as regras que deve executar) somente se
tiver havido alteraes desde os arquivos de configurao anteriores.
Como recurso adicional, um comando planman deploy est disponvel para
implementar regras manualmente a qualquer momento.
possvel implementar e desimplementar regras conforme necessrio configurando
o atributo isDraft para no ou para yes com o composer ou com o Dynamic
Workload Console .
Com base em suas caractersticas, as regras so classificadas como:
filter
A regra ativada na deteco de um nico evento especfico.
sequence
A regra ativada quando um grupo ordenado de eventos detectado ou
falha em concluir em um intervalo de tempo especfico.
set
A regra ativada quando um grupo desordenado de eventos detectado

ou falha em concluir em um intervalo de tempo especfico.
As regras de filtragem so baseadas na deteco de um evento como uma tarefa

em atraso, uma estao de trabalho do Tivoli Workload Scheduler sendo
desativada, um arquivo sendo modificado, um fluxo de tarefas concluindo sua
execuo com xito e assim por diante.
As regras set and sequence so baseadas na deteco de mais eventos.
Opcionalmente, podem ser baseadas em uma condio de tempo limite. Uma regra
expira quando o(s) primeiro(s) evento(s) de uma seqncia ou parte dos eventos de
um conjunto so recebidos, mas nem todos os eventos so recebidos dentro de um
intervalo de tempo especificado, contado a partir do recebimento do primeiro
evento.
As definies de regras podem incluir atributos que especificam um perodo de
validade e um espao de tempo de atividade dentro de cada dia da validade. Se
voc no especificar estes atributos, a regra ser ativa perpetuamente o tempo
todo, quando ela implementada e at ela ser alterada de volta para o status de
rascunho ou excluda do banco de dados.
possvel utilizar a substituio de varivel. Isso significa que, ao definir
parmetros de ao, possvel utilizar atributos de ocorrncia de eventos que
acionam a regra de evento em um destes dois formatos:
v ${event.property}
124
Substitui o valor no estado em que se encontra. Isso til para transmitir as

informaes para uma ao que funciona programaticamente com elas, por
exemplo, o schedTime de um fluxo de tarefas.
v %{event.property}
Substitui o valor formatado em formato legvel a humanos. Isso til para
passar as informaes para uma ao que encaminha essas informaes a um
usurio, por exemplo para formatar o schedTime de um fluxo de tarefas no
corpo de um e-mail.
Onde:
evento
o nome configurado para o acionamento de eventCondition.
propriedade
o nome de attributeFilter no predicado de filtragem da condio do
evento de acionamento. O valor obtido pelo filtro do atributo quando a
regra acionada substitudo como um valor de parmetro na definio
da ao antes que ela seja executada.
Observe que voc tambm pode utilizar a substituio de varivel quando
nenhum attributeFilter foi especificado para um atributo e quando o
atributo for de leitura.
possvel ver o uso da substituio de varivel em algumas das seguintes
amostras, em que os valores do filtro de atributos so substitudos no assunto e no
corpo do e-mail.
|
Exemplos de Regras de Eventos
|
|
Seguem exemplos de definies de regras de eventos que se aplicam aos cenrios

descritos em Cenrios Simples de Regras de Eventos na pgina 116.
Definio de Regra de Evento para Cenrio No. 1
|
|
|
|
|
|
|
Quando alguma das tarefas job123 finaliza com erro e gera a seguinte mensagem
de erro:
|
|
enviar um e-mail ao operador john.smith@mycorp.com. O assunto do e-mail inclui

os nomes da instncia da tarefa e da estao de trabalho associada.
|
|
|
|
|
|
|
|
|
|
|
|
|
A regra de evento vlida de 1 de Dezembro a 31 de Dezembro no espao de

tempo 12h-16h, horrio do leste.
AWSBHT001E The job

"MYWORKSTATION#JOBS.JOB1234" in file "ls" has failed with
the error: AWSBDW009E The following operating system error occurred
retrieving
the password structure for either the logon user...
<?xml version="1.0"?>
<eventRuleSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.ibm.com/xmlns/prod/tws/1.0/event-management/rules"
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/tws/1.0/
event-management/rules/EventRules.xsd">
<eventRule name="scenario1_rule" ruleType="filter"
isDraft="no">
<description>This is the definition for
scenario1</description>
<timeZone>America/Indianapolis</timeZone>
<validity from="2010-12-01" to="2010-12-31" />
125
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<activeTime start="12:00:00" end="16:00:00" />

<eventCondition name="event1"
eventProvider="TWSObjectsMonitor"
eventType="JobStatusChanged">
<filteringPredicate>
<attributeFilter name="JobStreamWorkstation" operator="eq">
<value>*</value>
</attributeFilter>
<attributeFilter name="JobStreamName" operator="eq">
<value>*</value>
</attributeFilter>
<attributeFilter name="JobName" operator="eq">
<value>job123*</value>
</attributeFilter>
<attributeFilter name="Status" operator="eq">
<value>Error</value>
</attributeFilter>
<attributeFilter name="ErrorMessage" operator="eq">
<value>*AWSBDW009E*</value>
</attributeFilter>
</filteringPredicate>
</eventCondition>
<action actionProvider="MailSender"
actionType="SendMail"
responseType="onDetection">
<description>Send email to John Smith including names of job
and associated workstation</description>
<parameter name="To">
<value>john.smith@mycorp.com</value>
</parameter>
<parameter name="Subject">
<value>Job %{event1.JobName} on agent %{event1.Workstation}
ended in error</value>
</parameter>
</action>
</eventRule>
</eventRuleSet>
|
|
|
|
|
|
|
|
|
|
Importante: A mensagem de erro que explica porque uma tarefa finaliza com erro
pode ser localizada no arquivo de log TWSMERGE. Nesse cenrio, o
arquivo de log TWSMERGE contm a seguinte instruo:
BATCHMAN:+
BATCHMAN:+ AWSBHT001E The job "MYWORKSTATION#JOBS.JOB1234" in file
"ls"
has failed with the error: AWSBDW009E The following operating system
error occurred retrieving the password structure for either the logon
user, or the user who owns a file or external dependency
BATCHMAN:+
em que a mensagem de erro tudo o que segue na sequncia:
|
|
has failed with the error:
|
|
|
|
|
|
|
|
|
|
Se a estao de trabalho CPU1 for desconectada e no se conectar novamente dentro

de 1 hora, envia um e-mail de notificao para chuck.derry@mycorp.com.
<eventRule name="scenario2_rule" ruleType="filter" isDraft="no">
<description>This is the definition for scenario2</description>
<timeZone>America/Anchorage</timeZone>
126
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<timeInterval amount="1" unit="hours" />

<eventCondition name="WSevent"
eventType="ChildWorkstationLinkChanged">
<attributeFilter name="Workstation" operator="eq">
<value>CPU1</value>
</attributeFilter>
<attributeFilter name="LinkStatus" operator="eq">
<value>Unlinked</value>
</attributeFilter>
</eventCondition>
<description>Send email to Chuck Derry with name of
unlinked workstation</description>
<value>chuck.derry@mycorp.com</value>
</parameter>
<value>Agent CPU1 has been unlinked for at least 10 minutes</value>
</parameter>
<parameter name="Body">
<value>The cause seems to be: %{WSevent.UnlinkReason}</value>
</parameter>
</action>
</eventRule>
</eventRuleSet>
|
|
|
Quando o arquivo daytransac for criado no diretrio SFoperation na estao de

trabalho system1 e as modificaes no arquivo forem finalizadas, envie o fluxo de
tarefas calmonthlyrev.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
A regra de evento vlida durante o ano no espao de tempo das 18h s 22h no
horrio do leste.
<eventRule name="scenario3_rule" ruleType="filter" isDraft="no">
<description>This is the definition for scenario3</description>
<timeZone>America/Louisville</timeZone>
<validity from="2007-01-01" to="2007-12-31" />
<eventCondition eventProvider="FileMonitor" eventType="ModificationCompleted">
<attributeFilter name="FileName" operator="eq">
<value>daytransac</value>
</attributeFilter>
<value>EVIAN1</value>
</attributeFilter>
</eventCondition>
<action actionProvider="TWSAction"
actionType="sbs"
<description>Submit the calmonthlyrev job stream.</description>
<parameter name="JobStreamName">
<value>calmonthlyrev</value>
127
|
|
|
|
|
|
|
</parameter>
<parameter name="JobStreamWorkstationName">
<value>act5cpu</value>
</parameter>
</action>
</eventRule>
</eventRuleSet>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Quando o evento job-x=exec e o evento job-x=succ/abend forem recebidos em 500

segundos, o planejador deve responder Sim ao prompt-1 e inicia o fluxo de tarefas
jobstream-z, caso contrrio ele deve enviar um e-mail para twsoper@mycompany.com
alertando que a tarefa est atrasada.
<eventRule name="scenario4_rule" ruleType="sequence" isDraft="yes">
<description>This is the definition for
scenario4</description>
<timeZone>America/Buenos_Aires</timeZone>
<timeInterval amount="500" unit="seconds" />
<eventCondition eventProvider="TWSObjectsMonitor"
<value>job-x</value>
</attributeFilter>
<attributeFilter name="InternalStatus" operator="eq">
<value>EXEC</value>
</attributeFilter>
</eventCondition>
<eventCondition eventProvider="TWSObjectsMonitor"
<value>job-x</value>
</attributeFilter>
<attributeFilter name="InternalStatus" operator="eq">
<value>ABEND</value>
<value>SUCC</value>
</attributeFilter>
</eventCondition>
responseType="onTimeOut">
<description>Send email to operator saying that job-x is late</description>
<value>twsoper@mycorp.com</value>
</parameter>
<value>Job-x is late by at least 5 minutes</value>
</parameter>
</action>
actionType="Reply"
<description>Reply Yes to prompt-1</description>
<parameter name="PromptName">
<value>prompt-1</value>
</parameter>
128
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<parameter name="PromptAnswer">
<value>Yes</value>
</parameter>
</action>
actionType="sbs"
<description>Submit jobstream-z</description>
<value>jobstream-z</value>
</parameter>
<value>act23cpu</value>
</parameter>
</action>
</eventRule>
</eventRuleSet>
Definio de Regra de Evento para o Cenrio N 5
|
|
|
Monitora o status de processos do Tivoli Workload Scheduler listados em

ProcessName e executa o script em lote RUNCMDFM.BAT localizado em
E:\production\eventRules.
|
|
A palavra-chave TWSPATH indica o caminho completo em que a instncia do

Tivoli Workload Scheduler monitorada est instalada, incluindo o sufixo /TWS.
|
|
|
|
|
Em sistemas operacionais Windows, a regra de evento acionada toda vez que o

agente interrompido usando o comando ShutDownLwa e toda vez que o agente
parado manualmente. Em sistemas operacionais UNIX, a regra de evento
acionada quando o processo interrompido manualmente, embora ela no seja
acionada pelo comando ShutDownLwa.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Se ProcessName=agent for especificado, o componente do agente monitorado,

embora o processo JobManager do TWS no seja monitorado.
<eventRule name="scenario5rule" ruleType="filter"
isDraft="no">
<eventCondition name="twsProcMonEvt1"
eventProvider="TWSApplicationMonitor"
eventType="TWSProcessMonitor">
<scope>
AGENT, NETMAN DOWN ON WIN86MAS
</scope>
<attributeFilter name="ProcessName"
operator="eq">
<value>agent</value>
<value>appservman</value>
<value>batchman</value>
<value>jobman</value>
<value>mailman</value>
<value>monman</value>
<value>netman</value>
</attributeFilter>
<attributeFilter name="TWSPath" operator="eq">
<value>E:\Program
Files\IBM\TWA\TWS</value>
</attributeFilter>
129
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|

<value>win86mas</value>
</attributeFilter>
<attributeFilter name="SampleInterval" operator="eq">
<value>5</value>
</attributeFilter>
</eventCondition>
<action actionProvider="GenericActionPlugin"
actionType="RunCommand"
<scope>
RUNCMDFM.BAT
</scope>
<parameter name="Command">
<value>runCmdFM.bat</value>
</parameter>
<parameter name="WorkingDir">
<value>E:\production\eventRules</value>
</parameter>
</action>
</eventRule>
</eventRuleSet>
Notas sobre a operao de regras
|
|
|
Seguem informaes crticas sobre o comportamento da regra de evento que

podem ajud-lo a entender a razo de resultados inesperados:
|
|
|
|
|
|
|
|
|
|
Notas sobre status da regra

v Dependendo das datas de validade from e to correspondentes, o status
de qualquer regra alterado da seguinte forma na implementao:
Se voc criar uma regra com as datas de validade from e to j
expiradas, a regra ser salva no estado activation pending. Quando a
regra implementada, ela permanece no status activation pending.
Se voc configurar o campo de validade to para uma data futura, a
regra ser implementada no estado active. Se voc reconfigur-la
para uma data no passado, a regra ser reimplementada no estado no
active.
v Os horrios de atividade da regra (start e end) no afetam o seu status.
Enquanto uma regra est dentro das datas de validade corretas, a regra
permanece no estado active, independentemente de ela estar ou no
dentro de seus horrios de atividade definidos. Se o planejador receber
os eventos definidos de uma regra fora de seu horrio de atividade, os
eventos sero descartados, mas a regra permanecer no status active.
|
|
|
|
|
|
|
|
|
Falta de persistncia no status da instncia de regra

Se o processador de eventos for parado ou travar, o status das instncias
de regra apenas parcialmente correspondidas perdido.
|
|
|
|
|
|
|
Regras set and sequence repetitivas

Em geral, cada regra ativa possui uma, e apenas uma, cpia executada no
servidor de processamento de eventos. As regras Set e sequence utilizam o
mecanismo explicado no seguinte exemplo:
1. Voc define uma regra sequence com dois eventos, A e B.
2. Quando o primeiro evento que corresponde seqncia ocorre (evento
A), ele ativa a regra e aguarda o segundo evento (evento B).
130
|
|
|
|
|
|
Quando a regra estiver ativa, qualquer evento adicional do evento A

que possa chegar ser ignorado. Nenhuma regra adicional ser criada
para quaisquer eventos do evento A recm-detectado, uma vez que a
regra est aguardando pelo evento B.
3. Quando o evento B ocorrer, a regra ser concluda e reconfigurada,
aguardando que o evento A ocorra novamente.
|
|
|
O mecanismo das regras set e sequence ocorre de forma que qualquer

ocorrncia adicional de um evento j detectado seja ignorada e descartada
se os outros eventos definidos no tiverem chegado.
|
|
|
possvel evitar esse problema utilizando atributos de correlao. Utilizar

um ou mais atributos de correlao um mtodo de direcionar uma regra
para criar uma cpia da regra separada quando outro evento A chega.
|
|
Tipos de regras set e sequence com perodos de tempo de atividade com menos
de 24 horas
|
|
|
|
|
Ocorrncias de regras set ou sequence que foram definidas para estarem

ativas por algumas poucas horas de cada dia no so limpas quando o
perodo de atividade em cada dia expira, se apenas parte dos eventos
chega. Elas permanecem em um estado inativo, aguardando para receber
os eventos restantes nos dias seguintes.
|
|
|
Por exemplo, voc define uma regra set que inclui dois eventos. A regra
vlida de 1 de Janeiro a 10 de Janeiro e est ativa diariamente das 6h s
10h.
|
|
|
Se em 1 de Janeiro o primeiro evento for recebido s 8h, a regra aguardar

que o segundo evento ocorra e permanecer ativa alm das 10h se o evento
no for detectado.
|
|
|
|
Se o segundo evento for recebido s 11h (que est fora do espao de tempo
da atividade), ele ser descartado, mas a regra se manter ativa. Se o
segundo evento for recebido novamente s 7h de 2 de Janeiro, a regra ser
acionada e as aes sero implementadas.
|
|
Se no desejar que a regra seja adiada para o dia seguinte, voc deve
limp-la.
|
|
Elementos de Regra Acionados
|
|
|
|
|
|
|
|
Toda vez que as condies de evento listadas em uma regra de evento

implementada so correspondidas, ou expiram, uma instncia da regra de evento
criada. Uma instncia de regra de evento inclui informaes como o nome da regra
de evento, a data e hora em que ela foi correspondida e a lista de instncias de
ao, com os respectivos status, que foram executadas como resultado das
condies de evento correspondentes. O objeto RuleInstance utilizado para
coletar informaes sobre as regras acionadas em um log histrico de instncias da
regra.
|
|
|
|
|
|
|
|
As aes executadas por uma regra acionada so coletadas em um log de histrico

de execues da ao. As informaes fornecidas incluem execues de ao que
foram concludas com erros ou avisos, em oposio s bem-sucedidas. Se pelo
menos uma ao encerrar com erro, toda a instncia de regra ser relatada com
erro. Como parte das informaes rastreadas nas execues de ao, os campos de
regra tambm so mantidos e as consultas podem ser executadas para procurar
execues de ao com base nestes campos (o identificador da instncia da regra
tambm est disponvel).
131
|
|
Definindo Eventos Customizados
|
|
|
|
|
|
Alm dos tipos e classes de eventos j definidos (conhecidos como provedores)

listados em detalhes em Provedores e Definies de Eventos na pgina 583, o
Tivoli Workload Scheduler fornece o modelo de um provedor de eventos genricos
denominado GenericEventPlugIn que os programadores com habilidades
especficas de programao de aplicativos e XML podem modificar a fim de definir
tipos de eventos customizados que podem ser teis para a organizao.
|
|
|
|
|
|
|
|
|
|
|
|
As ferramentas fornecidas para definir tipos de eventos customizados so:

v O provedor de eventos GenericEventPlugIn em XML
v O comando utilitrio evtdef com o qual um programador pode fazer o
download do provedor de eventos GenericEventPlugIn como um arquivo local a
fim de definir os eventos customizados
v Os arquivos XSD (XML Schema Definition) necessrios para validar o provedor
de eventos genricos modificado. Eles tambm contm orientaes on-line para
auxiliar na tarefa de programao.
v O comando utilitrio sendevent com o qual os eventos customizados podem ser
enviados ao servidor de processamento de eventos para acionar regras a partir
de qualquer agente ou qualquer estao de trabalho, simplesmente executando o
cliente da linha de comandos remoto do Tivoli Workload Scheduler.
|
|
|
|
|
|
|
|
|
|
|
|
Este o fluxo para definir e utilizar eventos customizados:

1. Com o comando evtdef, o programador:
a. Faz download do provedor de eventos genricos como um arquivo local.
b. Segue as definies do esquema para incluir tipos de evento customizado e
para definir suas propriedades e atributos no arquivo com um editor XML.
c. Faz upload do arquivo local como o provedor de eventos genricos
modificado contendo as novas definies de tipo de evento customizado. O
provedor de eventos genricos modificado salvo em um arquivo XML no
gerenciador de domnio principal.
2. O construtor de regras, ou o administrador, define, com o criador ou o
Dynamic Workload Console , as regras de eventos que devem ser acionadas
por esses eventos customizados, especificando:
v O provedor de eventos genricos como o provedor de eventos
|
|
v Os tipos de evento customizado como os tipos de evento

v As propriedades do tipo de evento customizado (ou atributos) definidas para
os eventos customizados no provedor de eventos genricos com os valores
especficos que iro acionar as regras.
|
|
|
|
|
|
|
|
|
|
|
|
3. Implementar as regras.
4. Quando a ocorrncia de um evento customizado acontece, ela pode ser enviada
ao servidor de processamento de eventos de uma das seguintes maneiras:
v Por meio do comando sendevent, executado a partir de um script ou da
linha de comandos
v Por meio de outro aplicativo, como o Tivoli Enterprise Console ou o Tivoli
Monitoring
Assim que o evento recebido pelo servidor de processamento de eventos, ele
aciona a regra.
132
Captulo 8. Definindo Objetos no Banco de Dados
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O Tivoli Workload Scheduler baseado em um conjunto de definies de objetos

que so utilizadas para mapear seu ambiente de planejamento no banco de dados.
Os objetos de planejamento so:
v calendrios
v domnios
v regras de eventos
v tarefas
v fluxos de tarefas
v prompts
v parmetros
v recursos
v tabelas de variveis
v estaes de trabalho
v classes de estaes de trabalho
Este captulo contm a seguinte seo:
v Definir objetos de planejamento
|
|
Definir objetos de planejamento
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Os objetos de planejamento so gerenciados com o programa da linha de

comandos composer e so armazenados no banco de dados do Tivoli Workload
Scheduler. O programa de linha de comandos composer pode ser instalado e
utilizado em qualquer mquina conectada atravs de TCP/IP ao sistema onde o
gerenciador de domnio mestre est instalado. No requer a instalao de uma
estao de trabalho do Tivoli Workload Scheduler como um pr-requisito.
Comunica-se atravs de HTTP/HTTPS com o gerenciador de domnio mestre onde
o banco de dados DB2 est instalado. A configurao da comunicao
HTTP/HTTPS e a verificao de autenticao so gerenciadas pela infra-estrutura
do WebSphere Application Server. O programa composer utiliza arquivos de
edio para atualizar o banco de dados de planejamento. O formato do arquivo de
edio utilizado para definir um objeto especfico descrito posteriormente neste
captulo. Por exemplo, para criar um novo objeto, digite sua definio em um
arquivo de edio e, em seguida, utilize o composer para inclu-la no banco de
dados especificando o arquivo de edio que contm a definio. O programa da
linha de comandos composer verifica se a sintaxe est correta dentro do arquivo
de edio e, se correta, transforma a definio de objeto em linguagem XML e, em
seguida, envia o pedido atravs de HTTP/HTTPS para o gerenciador de domnio
mestre.
|
|
|
No gerenciador de domnio mestre, a definio XML analisada. So realizadas

verificaes de semntica e de integridade e, em seguida, a atualizao
armazenada no banco de dados.
|
|
|
|
|
Com esta verso do produto, todas as entradas so gerenciadas individualmente.

Outro recurso introduzido com esta nova verso o mecanismo de bloqueio de
objetos. Os objetos de planejamento definidos no banco de dados so bloqueados
enquanto so acessados por um usurio para evitar acessos simultneos. Isto
significa que somente o usurio que bloqueia o objeto possui permisso de
133
|
|
|
gravao para esse objeto e outros usurios possuem acesso de leitura para esse
objeto. Para obter informaes adicionais, consulte lock na pgina 286 e unlock
na pgina 301.
|
|
|
|
|
|
possvel utilizar palavras-chave curtas e longas ao emitir comandos a partir do

composer, conforme Tabela 16 mostra. As primeiras duas colunas na lista
esquerda so os formatos de palavra-chave longa e curta suportados atualmente
pelo Tivoli Workload Scheduler. A coluna mais direita lista os formatos
compatveis com verses anteriores que voc utilizar se sua rede incluir
instalaes pr-verso 8.3.
Tabela 16. Lista de Palavras-chave de Objetos de Planejamento Suportadas
|
|
|
Palavras-chave Longas
Palavras-chave Curtas
Palavras-chave compatveis
com instalaes pr-verso
8.3
calendrio
cal
calendrios
domnio
dom
cpu
eventrule
erule | er
jobdefinition
jd
tarefas
jobstream
js
sched
parmetro
parm
parms
prompt
prom
prompts
resource
res
recursos
usurio
usurio
usurio
variabletable
vt
estao de trabalho
ws
cpu
|
|
workstationclass
wscl
cpu
|
|
|
Nota: A palavra-chave cpu mantida para representar domnios, estaes de

trabalho e classes de estao de trabalho para compatibilidade com verses
anteriores.
|
|
|
|
|
O programa composer no emite avisos especficos se as palavras-chave de

linguagem de planejamento forem utilizadas como nomes de objetos de
planejamento. No entanto, a utilizao dessas palavras-chave pode resultar em
erros, portanto, evite a utilizao das palavras-chave listadas na Tabela 17 ao
definir tarefas e fluxos de tarefas:
Tabela 17. Lista de Palavras Reservadas ao Definir Tarefas e Fluxos de Job
|
|
|
|
|
|
|
|
|
|
|
|
abendprompt
autodocon
dateval
docommand
except
nome do arquivo
hi
isuserjob
limite
notempty
opens
qualifier
134
after
canc
day(s)
draft
extraneous
follows
i18n_id
jobfilename
matching
nmero
order
rccondsucc
as
carryforward
day_of_week
fim
fdignore
dias livres
i18n_priority
tarefas
members
em
previous
recovery
s
confirmed
prazo final
a cada
fdnext
from
interativo
keyjob
needs
onuntil
prioridade
relative
autodocoff
continue
description
everyday
fdprev
ir
isdefault
keysched
nextjob
op
prompt
request
Tabela 17. Lista de Palavras Reservadas ao Definir Tarefas e Fluxos de Job (continuao)
|
|
|
|
|
|
reexecutar
planejamento
tasktype
validfrom
workday(s)
|
|
Evite utilizar as palavras-chave listadas em Tabela 18 ao definir estaes de

trabalho, classes de estao de trabalho e domnios:
Tabela 18. Lista de Palavras Reservadas ao Definir Estaes de Trabalho
|
|
|
|
|
|
|
|
|
|
|
|
access
comando
ativado
fta
ignorar
principal
mpix
os
secureaddr
tz
wnt
runcycle
scriptname
fuso horrio
validto
sa
parar
to
vartable
AIX
cpuclass
fim
fullstatus
isdefault
members
n
other
securitylevel
tzid
agent_type
cpuname
extraneous
host
linkto
mpeix
nmero
parent
tcpaddr
UNIX
sameday
streamlogon
token_in
vt
autolink
description
for
hpux
maestro
mpev
off
posix
fuso horrio
utilizando
schedtime
su
until
weekday(s)
behindfirewall
domnio
forar
ibm i
manager
mpexl
em
servidor
tipo
vartable
Evite utilizar as palavras-chave listadas em Tabela 19 ao definir usurios do

Windows:
Tabela 19. Lista de Palavras Reservadas ao Definir Usurios
username
password
fim
Utilizando Modelos de Definio de Objeto

Os modelos de definio de objeto de planejamento esto disponveis para uso no
diretrio TWS_home\templates. possvel utilizar os modelos como um ponto
inicial quando voc define objetos de planejamento.
Observe que as datas nos modelos esto no formato expresso na opo local date
format.
Definio de estao de trabalho

Em uma rede do Tivoli Workload Scheduler, uma estao de trabalho um objeto
de planejamento que executa tarefas. Voc cria e gerencia a estao de trabalho de
objeto de planejamento no banco de dados do Tivoli Workload Scheduler por meio
de uma definio da estao de trabalho. Uma definio da estao de trabalho
necessria para cada objeto que executa tarefas. Geralmente, uma definio de
estao de trabalho usada para representar uma estao de trabalho fsica, mas,
no caso de agentes estendidos, por exemplo, representa uma definio lgica que
deve ser hospedada por uma estao de trabalho fsica.
possvel incluir diversas definies de estao de trabalho no mesmo arquivo de
texto juntamente com as definies de classe da estao de trabalho e as definies
de domnio. Uma definio de estao de trabalho tem a seguinte sintaxe:
135
Sintaxe
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
cpuname workstation [description

"description"]
[vartable table_name]
os os-type
[node hostname] [tcpaddr port]
[secureaddr port][timezone|tz tzname]
[domain domainname]
[for maestro
[host host-workstation
[access method | agentID agentID ]]
[type fta | s-agent | x-agent | manager | broker | agent | rem-eng |
pool | d-pool]
[ignore]
[autolink on | off]
[behindfirewall on | off]
[securitylevel enabled | on | force]
[fullstatus on | off]
[server serverid]]
[protocol http | htpps]
[members [workstation] [...]]
[requirements jsdl_definition]]
end
[cpuname ...]
[cpuclass ...]
[domain ...]
Argumentos
|
|
|
possvel incluir diversas definies de estao de trabalho no mesmo arquivo de

texto juntamente com as definies de classe da estao de trabalho e as definies
de domnio. Uma definio de estao de trabalho tem a seguinte sintaxe:
Tabela 20. Configuraes de Atributos para Tipos de Estao de Trabalho de Gerenciamento
|
|
Attributes
mestre
cpuname
O nome da estao de trabalho.
|
|
description
Uma descrio para a estao de trabalho entre aspas duplas. Este atributo
opcional.
|
|
vartable
O nome de uma tabela de varivel associada estao de trabalho. Variveis usadas

com a estao de trabalho so definidas nesta tabela. Este atributo opcional.
os
O sistema operacional instalado no sistema. Especifique um dos seguintes valores:
|
|
|
|
de Backup
UNIX
WNT
OTHER
IBM_i
O nome do host ou o endereo IP do sistema.
|
|
|
tcpaddr
O valor designado a nm port no arquivo localopts. Para diversas estaes de

trabalho em um sistema, insira um nmero de porta no usado. O valor padro
31111.
136
Tabela 20. Configuraes de Atributos para Tipos de Estao de Trabalho de Gerenciamento (continuao)
|
|
Attributes
mestre
|
|
secureaddr
O valor designado a nm ssl port no arquivo localopts. Especifique-o se

securitylevel estiver configurado para on, force ou enabled.
|
|
timezone | tz
O fuso horrio no qual o sistema est localizado. recomendvel que o valor

corresponda ao valor configurado no sistema operacional.
domnio
MASTERDM
host
No aplicvel
access
No aplicvel
type
manager
|
|
ignorar
Use esse atributo se no quiser que essa estao de trabalho aparea no prximo
plano de produo.
|
|
autolink
Indica se um link entre estaes de trabalho aberto automaticamente na

inicializao. Especifique um dos seguintes valores:
O nome do domnio gerenciado.
fta
|
|
ON
OFF
Esse um atributo opcional. O valor padro ON.
|
|
|
behindfirewall
Essa configurao
ignorada.
Indica se h um firewall entre a estao de trabalho e o

gerenciador de domnio principal. Especifique um dos
seguintes valores:
|
|
ON
OFF
O valor padro OFF.
securitylevel
|
|
|
O tipo de autenticao SSL a usar:

enabled
on
forar
fullstatus
ON
|
|
servidor
No aplicvel
protocol
No aplicvel
members
No aplicvel
|
|
requisitos
No aplicvel
Essa configurao
ignorada.
A Tabela 21 descreve os valores configurados para cada atributo para tipos de

estao de trabalho de destino. Aps a tabela, h detalhes adicionais sobre cada
atributo.
|
|
|
|
|
|
|
|
|
|
de Backup
Tabela 21. Configuraes de Atributos para Tipos de Estao de Trabalho de Destino

Estao de
trabalho do
Workload
Broker
Agente
Estendido
Agent
Estao de
trabalho de
mecanismo
remoto
Atributo
Agente tolerante a
falhas e agente
padro
cpuname
description
Uma descrio para a estao de trabalho entre aspas duplas. Este atributo opcional.
Conjunto Conjunto
dinmico
137
|
|
|
|
|
|
|
|
|
|
|
|
||
||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Tabela 21. Configuraes de Atributos para Tipos de Estao de Trabalho de Destino (continuao)
Estao de
trabalho do
Workload
Broker
Agente
Estendido
Agent
Estao de
trabalho de
mecanismo
remoto
Conjunto Conjunto
dinmico
Atributo
Agente tolerante a
falhas e agente
padro
vartable
O nome de uma tabela de varivel associada estao de trabalho. Variveis usadas com a estao de trabalho
so definidas nesta tabela. Este atributo opcional.
os
OTHER
O sistema
operacional
instalado no sistema.
Especifique um dos
seguintes valores:
UNIX
WNT
OTHER
IBM_i
A configurao
desse valor
descoberta no
sistema.
O nome do host ou o endereo IP do

sistema.
tcpaddr
O valor designado a
nm port no arquivo
localopts. Ao
definir diversas
estaes de trabalho
em um sistema,
insira um nmero
de porta no usado.
O valor padro
31111.
secureaddr
O valor designado a No Aplicvel

nm ssl port no
arquivo localopts.
Especifique-o se
securitylevel estiver
configurado para on,
force ou enabled.
O valor
designado a
nm port no
arquivo
localopts. Ao
definir
diversas
estaes de
trabalho em
um sistema,
insira um
nmero de
porta no
usado. O valor
padro 41114.
O sistema
operacional
instalado na
mquina.
Especifique um
dos seguintes
valores:
UNIX
WNT
ZOS
UNIX
WNT
OTHER
IBM_i
Especifique OTHER
para sistemas IBM i
executando como
agentes tolerantes a
falhas limitados.
138
O sistema
operacional
instalado na
mquina.
Especifique um
dos seguintes
valores:
O sistema operacional
instalado na mquina.
Especifique um dos
seguintes valores:
UNIX
WNT
OTHER
IBM_i
O nome do
host ou o
endereo IP do
sistema.
Especifique
NULL quando
host for
configurado
para $MASTER
ou ao definir
um agente
estendido para
PeopleSoft,
SAP ou Oracle.
O nome do
O nome do
host ou o
host ou o
endereo IP do endereo IP do
agente.
mecanismo
remoto.
Consulte as
especificaes
do mtodo de
acesso
selecionado.
O nmero da
porta para se
comunicar com
o agente
quando o
protocolo
http.
No aplicvel
O nmero da
porta para se
comunicar com
o mecanismo
remoto quando
o protocolo
http.
No Aplicvel
O nmero da
porta para se
comunicar com
o agente
quando o
protocolo
https.
No aplicvel
O nmero da
porta para se
comunicar com
o mecanismo
remoto quando
o protocolo
https.
No aplicvel
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Estao de
trabalho do
Workload
Broker
Atributo
Agente tolerante a
falhas e agente
padro
timezone | tz
O fuso horrio no qual o sistema est

localizado. recomendvel que o
valor corresponda ao valor
configurado no sistema operacional.
domnio
Especifique um
domnio existente. O
valor padro para
falhas MASTERDM.
Essa configurao
obrigatrio para
agentes padro.
host
No Aplicvel
access
No Aplicvel
Especifique um
domnio
existente. Essa
configurao
obrigatria.
Agente
Estendido
O fuso horrio O fuso horrio

configurado na configurado no
agente.
estao de
trabalho
especificada no
atributo host.
Estao de
trabalho de
mecanismo
remoto
Conjunto Conjunto
dinmico
O fuso horrio
configurado no
mecanismo
remoto.
O fuso
O fuso
horrio
horrio
configuradoconfigurado
nos
nos
agentes do
agentes
conjunto
do
conjunto. dinmico.
No aplicvel
Essa
configurao
necessria
somente se o
valor
designado para
host for
$MANAGER.
A estao de
trabalho host.
Pode ser
configurada
para $MASTER
ou $MANAGER.
A estao de trabalho de broker.
Selecione o
nome do
arquivo do
mtodo de
acesso
apropriado.
No Aplicvel
O identificador
exclusivo do
agente
dinmico
agentID
type
Agent
fta
s-agent
|
|
O valor padro
fta.
|
|
|
|
|
|
|
|
|
|
Especifique fta para

sistemas IBM i
executando como
falhas limitados.
broker
agente X
agent
rem-eng
conjunto
ignorar
Use esse atributo se no quiser que essa estao de trabalho aparea no prximo plano de produo.
autolink
OFF
Indica se um link entre estaes de
trabalho aberto automaticamente na
inicializao. Especifique um dos
seguintes valores:
|
|
ON
OFF
|
|
Esse um atributo opcional. O valor

padro ON.
d-pool
No aplicvel
139
|
|
|
|
|
|
|
|
|
Estao de
trabalho do
Workload
Broker
Agente
Estendido
Atributo
Agente tolerante a
falhas e agente
padro
behindfirewall
Indica se h um firewall entre a

OFF
estao de trabalho e o gerenciador
de domnio principal. Especifique um
dos seguintes valores:
|
|
ON
OFF
|
|
|
|
O valor padro OFF.

securitylevel
O tipo de
autenticao SSL a
usar:
|
|
|
enabled
on
forar
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
No aplicvel para
sistemas IBM i
executando como
falhas limitados.
fullstatus
Indica se a estao
de trabalho
atualizada com
relao ao status de
processamento de
tarefa em seu
domnio ou
subdomnios.
Especifique um dos
seguintes valores:
|
|
ON
OFF
|
|
|
|
|
|
|
|
Especifique OFF para

agentes padro.
Agent
Estao de
trabalho de
mecanismo
remoto
No aplicvel
No Aplicvel
OFF
servidor
0-9, A-Z. Quando especificado, requer No Aplicvel

a criao de processos de um
mailman dedicado na estao de
trabalho pai.
protocol
No aplicvel
No aplicvel
Especifique um dos seguintes

valores:
|
|
http
https
|
|
|
|
|
|
|
|
|
|
Este atributo opcional.

Quando no especificado,
determinado automaticamente
das configuraes especificadas
para tcpaddr e secureaddr.
members
No aplicvel
requisitos
No aplicvel
140
Conjunto Conjunto
dinmico
No aplicvel
Valor
No
obrigatrio aplicvel
Valor
obrigatrio
|
|
A seguir esto detalhes adicionais dos atributos de definio da estao de

trabalho:
|
|
|
|
cpuname workstation
Especifica o nome da estao de trabalho. Os nomes de estaes de
trabalho devem ser exclusivos e no podem ser os mesmos das classes de
estaes de trabalho.
|
|
O nome deve iniciar com uma letra e pode conter caracteres alfanumricos,
traos e sublinhados. Ele pode conter at 16 caracteres.
|
|
No use neste campo nenhuma das palavras reservadas na Tabela 17 na

pgina 134
|
|
|
description description
Fornece uma descrio da estao de trabalho. O texto deve ser colocado
entre aspas duplas.
|
|
|
|
vartable table_name
Especifica o nome da tabela de variveis que voc deseja para a estao de
trabalho. Variveis usadas com a estao de trabalho so definidas nesta
tabela.
|
|
O nome deve iniciar com uma letra e pode conter caracteres alfanumricos,
traos e sublinhados. Ela pode conter at 80 caracteres.
|
|
|
|
os os_type
Especifica o sistema operacional da estao de trabalho. Quando usado em
definies de estao de trabalho de mecanismo remoto, representa o
sistema operacional do mecanismo remoto do Tivoli Workload Scheduler.
Os valores vlidos so:
|
|
UNIX Para sistemas operacionais suportados em execuo em sistemas

baseados em UNIX, incluir sistemas LINUX.
WNT
|
|
|
|
|
OTHER
Valor obrigatrio para: estaes de trabalho do broker de carga de
trabalho dinmica e sistemas IBM i executando como agentes
tolerantes a falhas limitados. Valor opcional para outros tipos de
estaes de trabalho.
|
|
|
ZOS
IBM_i Para sistemas operacionais IBM i suportados.
|
|
|
Nota: Consulte o Documento de Requisitos do Sistema do IBM Tivoli Workload

Scheduler para obter uma lista atualizada de sistemas operacionais
suportados.
|
|
|
node hostname
Especifique o nome do host ou o endereo TCP/IP da estao de trabalho.
Os nomes completos de domnio so aceitos.
Para sistemas operacionais Windows suportados.
Usado com estaes de trabalho de mecanismo remoto definidas

para comunicao com o mecanismo remoto do Tivoli Workload
Scheduler para z/OS.
|
|
Para nomes de host, os caracteres vlidos so alfanumricos, incluindo

hfen (-). O comprimento mximo de 51 caracteres.
|
|
Especifique NULL quando:

v definir um agente estendido para PeopleSoft, SAP ou Oracle.
141
v host for configurado para $MASTER
|
|
|
Se estiver definindo uma estao de trabalho de mecanismo remoto,

especifique o nome do host do sistema onde o mecanismo remoto est
instalado.
tcpaddr port
Especifica o nmero da porta TCP/IP netman que o Tivoli Workload
Scheduler utiliza para comunicao entre as estaes de trabalho.
|
|
|
|
|
|
Para estaes de trabalho do Workload Broker

Especifique o valor da propriedade TWS.Agent.Port do arquivo
TWSAgentConfig.properties.
|
|
|
Para estaes de trabalho de mecanismo remoto usando o protocolo

HTTP para se comunicar com o mecanismo remoto
Especifique o nmero da porta HTTP do mecanismo remoto.
|
|
|
Para outros tipos de estaes de trabalho

Especifique o valor designado no arquivo localopts para a
varivel nm port.
|
|
O valor padro para esse campo 31111. Especifique um valor no

intervalo de 1 a 65535.
|
|
|
secureaddr
Define a porta utilizada para atender conexes SSL recebidas. Esse valor
lido quando o atributo securitylevel for configurado.
|
|
Para estaes de trabalho do Workload Broker

Ignore esse atributo.
|
|
|
Para estaes de trabalho de mecanismo remoto usando o protocolo

HTTPS para se comunicar com o mecanismo remoto
Especifique o nmero da porta HTTPS do mecanismo remoto.
|
|
|
|
Para outros tipos de estaes de trabalho

Especifique o valor designado no arquivo localopts para a
varivel nm ssl port. O valor deve ser diferente do valor designado
varivel nm port no arquivo localopts.
|
|
|
|
|
Se securitylevel for especificado, mas esse atributo estiver ausente, o valor

padro para esse campo 31113. Especifique um valor no intervalo de 1 a
65535.Consulte o IBM Tivoli Workload Scheduler Administration and
Installation Guide para obter informaes sobre autenticao SSL e opes
locais configuradas no arquivo de configurao TWS_home/localopts.
|
|
|
|
timezone|tz tzname
Especifica o fuso horrio da estao de trabalho. Para assegurar a preciso
dos horrios de planejamento, esse fuso horrio deve ser o mesmo contido
no sistema operacional do computador.
|
|
|
Quando usado em definies de estao de trabalho de mecanismo remoto,

representa o fuso horrio configurado no mecanismo remoto do Tivoli
Workload Scheduler.
|
|
Consulte Captulo 13, Gerenciando fusos horrios, na pgina 523 para

obter os nomes dos fusos horrios vlidos.
domain domainname
Especifica o nome do domnio do Tivoli Workload Scheduler ao qual a
estao de trabalho pertence. O valor padro para estao de trabalho
tolerante a falhas MASTERDM.
|
|
|
|
142
|
|
|
O Tivoli Workload Scheduler ignora a configurao do domnio quando

definido para agentes estendidos, exceto quando o atributo host for
configurado para $MASTER.
|
|
Essa configurao obrigatria para estaes de trabalho de agente padro

e do dynamic workload broker.
|
|
|
host host-workstation
Esse atributo obrigatrio para agentes estendidos e estaes de trabalho
de mecanismo remoto e especifica:
|
|
|
|
|
Para estaes de trabalho de mecanismo remoto, agentes, conjuntos e

conjuntos dinmicos:
A estao de trabalho de broker hosting a estao de trabalho. Esse
campo no pode ser atualizado aps a criao da estao de
trabalho de mecanismo remoto.
|
|
|
|
Para agentes estendidos

A estao de trabalho com a qual o agente estendido se comunica e
onde seu mtodo de acesso est instalado. A estao de trabalho
hosting no pode ser outro agente estendido.
|
|
|
|
Se a estao de trabalho hosting for um gerenciador de domnio

para o qual definiu um backup, possvel especificar um dos
valores a seguir para assegurar que o agente estendido no seja
isolado se a estao de trabalho hosting ficar indisponvel.
|
|
|
$MASTER
Para indicar que a estao de trabalho host para o agente
estendido o gerenciador de domnio mestre.
|
|
|
|
$MANAGER
Para indicar que a estao de trabalho host para o agente
estendido o gerenciador de domnio. Nesse caso, voc
deve especificar o domnio onde o agente est localizado.
|
|
|
|
Nesse caso, certifique-se de que os mtodos do agente estendido

estejam instalados tambm na estao de trabalho de backup.
possvel ativar e desativar a resoluo automtica da chave $MASTER
usando a opo mm resolve master no arquivo localopts.
Para obter informaes adicionais sobre as opes disponveis no arquivo
localopts, consulte o Guia de Administrao do IBM Tivoli Workload
Scheduler.
|
|
|
|
|
|
|
access method
Especifica um mtodo de acesso para agentes estendidos e agentes de rede.
Corresponde ao nome de um arquivo que est localizado no diretrio
TWS_home/methods na estao de trabalho hosting.
Especifique NULL ao definir um agente estendido para PeopleSoft, SAP ou
Oracle.
|
|
|
|
agentID agentID
O identificador exclusivo do agente dinmico.
tipo
|
|
Especifica o tipo da estao de trabalho.

Nota: Se planeja alterar os tipos de estao de trabalho, considere as regras
a seguir:
143
v possvel alterar estaes de trabalho de agente tolerante a falhas,

agente padro, agente estendido, gerenciador de domnio e
dynamic workload broker para qualquer tipo de estao de
trabalho, com a exceo de agente dinmico, conjunto, conjunto
dinmico e mecanismo remoto.
v no possvel alterar o tipo de agente dinmico, conjunto,
conjunto dinmico e mecanismo remoto.
|
|
|
|
|
|
|
|
Insira um dos valores a seguir:
|
|
|
|
fta
Se voc definir um agente tolerante a falhas, ou seja uma estao de

trabalho do agente que ativa tarefas e resolva dependncias locais
sem um gerenciador de domnio. Esse o valor padro para esse
atributo.
|
|
|
Voc deve especificar fta se quiser designar estao de trabalho a

funo de gerenciador do domnio principal de backup ou de
gerenciador de domnio principal de backup.
|
|
Especifique fta para sistemas IBM i executando como agentes

tolerantes a falhas limitados.
|
|
|
|
s-agent
|
|
|
|
|
|
agente x
Se definir um agente estendido, ou seja uma estao de trabalho do
agente que ative tarefas somente sob a direo de sua estao de
trabalho hosting. Os agentes estendidos podem ser utilizados para
fazer interface do Tivoli Workload Scheduler com sistemas e
aplicativos no-Tivoli.
Se definir um agente padro, ou seja uma estao de trabalho do

agente que ative tarefas somente sob a direo de seu gerenciador
de domnio.
Para obter informaes adicionais, consulte IBM Tivoli Workload

Scheduler for Applications.
|
|
manager
Se voc definir um gerenciador de domnio, ou seja uma estao de
trabalho que gerencia um domnio. Ao definir esse tipo de estao
de trabalho, especifique:
|
|
|
|
|
|
Servidor
NULL
|
|
|
Domnio
Onome do domnio que a estao de trabalho gerencia, se
diferente do domnio MASTERDM.
|
|
|
|
Voc especifica que uma estao de trabalho um gerenciador

tambm no campo manager da Definio de domnio na pgina
153. O Tivoli Workload Scheduler verifica automaticamente se os
valores especificados nesses campos esto consistentes.
broker
|
|
|
|
|
|
|
Se voc definir uma estao de trabalho dynamic workload broker, ou

seja uma estao de trabalho que execute ambos os tipos e tarefas
existentes e tipos de tarefas com opes avanadas. o servidor do
broker instalado com o gerenciador de domnio principal e o
gerenciador de domnio dinmico. Hospeda as seguintes estaes
de trabalho:
144
|
|
|
|
|
v
v
v
v
v
agente estendido
mecanismo remoto
conjunto
conjunto dinmico
agente. Essa definio inclui os seguintes agentes:
agente dinmico
Agente do Tivoli Workload Scheduler para z/OS
agente para z/OS
Para obter informaes adicionais sobre o agente dinmico e o
Agente do Tivoli Workload Scheduler para z/OS, consulte
Planejando Carga de Trabalho Dinamicamente. Para obter
informaes adicionais sobre o agente para z/OS, consulte
Planejando com o Agente para z/OS.
|
|
|
|
|
|
|
|
Se voc definir um agente dinmico, ou seja uma estao de trabalho

que gerencia uma ampla variedade de tipos de tarefas, por
exemplo, tarefas especificas de transferncia de banco de dados ou
de arquivo, alm de tipos de tarefas tradicionais. Ele hospedado
pela workload broker workstation. A definio da estao de
trabalho criada e registrada automaticamente ao instalar o
componente do agente dinmico. Em sua definio, possvel
editar somente o atributo a seguir:
v description
v vartable
|
|
|
|
|
|
|
|
|
|
agent
|
|
|
|
|
|
|
|
|
|
|
rem-eng
Se voc definir uma estao de trabalho de mecanismo remoto, ou seja
uma estao de trabalho usada para se comunicar com um
mecanismo remoto ao conectar uma tarefa definida localmente,
denominada tarefa sombra, a uma tarefa especfica em execuo no
mecanismo remoto, denominada tarefa remota. Quando as duas
tarefas so conectadas, a transio do status da tarefa sombra
mapeia a transio do status da tarefa remota. Esse mapeamento
til tambm para definir e monitorar dependncias de tarefas
locais em tarefas em execuo no mecanismo remoto; essas
dependncias so chamadas dependncias cruzadas.
|
|
|
Para obter informaes adicionais sobre tarefas sombra e

dependncias cruzadas, consulte Captulo 16, Definindo e
Gerenciando Dependncias Cruzadas, na pgina 567.
Ao definir esse tipo de estao de trabalho, especifique:
os
O sistema operacional do mecanismo remoto.
host
O nome da estao de trabalho do broker hosting.
O nome do host ou o endereo IP do mecanismo remoto.
|
|
|
|
|
Ao especificar o nmero da porta a ser usado para comunicao

com o mecanismo remoto, use secureaddr se o protocolo usado for
HTTPS, tcpaddr se o protocolo usado for HTTP. Recomenda-se
especificar no campo timezone o fuso horrio configurado no
mecanismo remoto.
|
|
conjunto
Se voc definir um conjunto, ou seja um conjunto de agentes
145
|
|
|
|
|
|
|
dinmicos com caractersticas de hardware ou de software

semelhantes para o qual enviar tarefas. Essa estao de trabalho
hospedada pela workload broker workstation. Em sua definio,
possvel editar somente os atributos a seguir:
v description
v vartable
v members
|
|
|
|
|
|
|
d-pool Se voc definir um conjunto dinmico, ou seja um conjunto de

agentes dinmicos definidos dinamicamente com base nos
requisitos listados no arquivo JSDL especificados no atributo
resources. Essa estao de trabalho hospedada pela workload
broker workstation. Em sua definio, possvel editar somente os
atributos a seguir:
v description
v vartable
v requisitos
|
|
|
|
|
|
|
ignorar
|
|
|
|
autolink
Especifica se o link deve ser aberto entre as estaes de trabalho na
inicializao. Dependendo do tipo da estao de trabalho, ao configurar
seu valor para on:
Especifica que a definio da estao de trabalho no deve ser includa no

plano de produo. Se voc especificar essa configurao, as tarefas e os
fluxos de tarefas planejados para execuo nessas estaes de trabalho no
so includos no plano de produo.
|
|
|
Em um agente tolerante a falhas ou em um agente padro

Significa que o gerenciador de domnio abre o link para o agente
quando o gerenciador de domnio for iniciado.
|
|
|
Em um gerenciador de domnio
Significa que seus agentes abrem links para o gerenciador de
domnio quando eles forem iniciados.
|
|
|
|
|
|
|
|
Essa configurao especialmente til quando um novo plano de

produo for criado no gerenciador de domnio principal: Como parte da
gerao do plano de produo, todas as estaes de trabalho so paradas e,
em seguida, iniciadas. Para cada agente com autolink ativado, o
gerenciador de domnio envia automaticamente uma cpia do novo plano
de produo e, em seguida, inicia o agente. Se o autolink estiver ativado
tambm para o gerenciador de domnio, o agente abre um link de volta
para o gerenciador de domnio.
|
|
|
Se o valor do autolink for off para o agente, possvel abrir o link de seu
gerenciador de domnio executando o comando conman link no
gerenciador de domnio do agente ou no gerenciador de domnio principal.
behindfirewall
Se configurado para on, significa que h um firewall entre a estao de
trabalho e o gerenciador de domnio principal. Nesse caso, somente uma
conexo direta entre a estao de trabalho e seu gerenciador de domnio
permitia e os comandos start workstation, stop workstation e showjobs so
enviados seguindo a hierarquia do domnio, em vez de fazer com que o
gerenciador de domnio mestre ou o gerenciador de domnio abra uma
conexo direta com a estao de trabalho.
|
|
|
|
|
|
|
|
146
|
|
|
|
|
|
Configure esse atributo para off se estiver definindo uma estao de

trabalho com o tipo broker.
fullstatus
Especifique essa configurao ao definir uma estao de trabalho de agente
tolerante a falhas. Para gerenciadores de domnios, essa palavra-chave
configurada automaticamente para on. Especifique:
|
|
|
|
|
|
|
|
em
Se quiser que a estao de trabalho do agente tolerante a falhas

opere no modo full status, isso significa que a estao de trabalho
atualizada com o status das tarefas e fluxos de tarefas em execuo
em toas as outras estaes de trabalho de seu domnio e em
domnios subordinados, mas no nos domnios peers ou pais.
Nesse caso, a cpia do plano de produo no agente mantida no
mesmo nvel de detalhe que a cpia do plano de produo em seu
gerenciador de domnio.
|
|
|
|
|
off
Se quiser que a estao de trabalho do agente tolerante a falhas

seja informada somente sobre o status de tarefas e fluxos de tarefas
em outras estaes de trabalho que afetem suas prprias tarefas e
fluxos de tarefas. Isto pode melhorar o desempenho reduzindo a
atividade da rede.
|
|
Essa configurao define automaticamente a opo de dependncias de

resoluo conforme necessrio.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
securitylevel
Especifica o tipo de autenticao SSL para a estao de trabalho. No
especifique esse atributo para uma estao de trabalho com tipo broker.
Pode ter um dos seguintes valores:
ativado
A estao de trabalho utiliza a autenticao SSL apenas se
requerido por sua estao de trabalho do gerenciador de domnio
ou por outro agente tolerante a falhas abaixo dele na hierarquia de
domnio.
em
A estao de trabalho utiliza a autenticao SSL quando se conecta
com seu gerenciador de domnio. O gerenciador de domnio utiliza
a autenticao SSL quando se conecta a seu gerenciador de
domnio pai. O agente tolerante a falhas recusa qualquer conexo
recebida de seu gerenciador de domnio se no for uma conexo
SSL.
forar A estao de trabalho utiliza a autenticao SSL para todas as suas
conexes e aceita conexes dos seus gerenciadores de domnio pai
e subordinados. A estao de trabalho recusa qualquer conexo
recebida que no seja uma conexo SSL.
|
|
|
|
|
|
Se esse atributo for omitido, a estao de trabalho no configurada para

conexes SSL e qualquer valor para secureaddr ignorado. Certifique-se,
nesse caso, de que a opo local nm ssl port esteja configurada para 0 para
assegurar que o processo netman no tente abrir a porta especificada em
secureaddr. Consulte o IBM Tivoli Workload Scheduler Administration and
Installation Guide para obter informaes sobre autenticao SSL.
|
|
A seguinte tabela descreve o tipo de comunicao utilizada para cada tipo

de definio securitylevel.
147
Tabela 22. Tipo de Comunicao, Dependendo do Valor do Nvel de Segurana
|
|
|
|
Valor configurado no
Agente Tolerante a Falhas
(ou no Gerenciador de
Domnio)
Valor configurado em seu

Gerenciador de Domnio (ou
em seu Gerenciador de
Domnio Pai)
Tipo de conexo estabelecida
No especificado
No especificado
TCP/IP
Ativado
No especificado
TCP/IP
Em
No especificado
Sem conexo
Force
No especificado
Sem conexo
No especificado
Em
TCP/IP
Ativado
Em
TCP/IP
Em
Em
SSL
Force
Em
SSL
No especificado
Ativado
TCP/IP
Ativado
Ativado
TCP/IP
Em
Ativado
SSL
Force
Ativado
SSL
No especificado
Force
Sem conexo
Ativado
Force
SSL
Em
Force
SSL
|
|
|
|
|
Force
Force
SSL
|
|
|
|
|
|
|
|
|
server ServerID
Use o atributo server na definio da estao de trabalho do agente
tolerante a falhas para reduzir o tempo necessrio para inicializar agentes e
para melhorar o tempo das mensagens. Por padro, comunicaes com os
agente tolerante a falhass so tratadas por um processo do mailman em
execuo no gerenciador de domnio. O atributo server permite iniciar um
processo do mailman no gerenciador de domnio para tratar de
comunicaes somente com essa estao de trabalho do agente tolerante a
falhas.
|
|
|
|
|
Se estiver definindo um agente tolerante a falhas que possa trabalhar como

um gerenciador do domnio de backup, o ServerID usado somente
quando a estao de trabalho funciona como um agente tolerante a falhas;
a configurao ignorada quando a estao de trabalho funciona como um
gerenciador do domnio de backup.
|
|
|
|
|
No ServerID, o ID uma nica letra ou um nmero (A-Z e 0-9). Os IDs so

exclusivos para cada gerenciador de domnio, de forma que voc pode
utilizar os mesmos IDs em outros domnios sem conflito. Um ServerID
especfico pode ser dedicado a mais de uma estao de trabalho do agente
tolerante a falhas.
|
|
|
|
Como boas prticas:

v Se mais de 36 IDs de servidores forem necessrios em um domnio,
considere a possibilidade de dividir o domnio em dois ou mais
domnios.
Os valores para securitylevel no so especificados para estaes de

trabalho dodynamic workload broker com um agente do Tivoli Workload
Scheduler verso 8.2 ou anterior.
148
|
|
|
v Se o mesmo ID for utilizado para vrios agentes, um nico servidor ser

criado para manipular suas comunicaes. Defina servidores extras para
evitar que um nico servidor no manipule mais de oito agentes.
|
|
Se um ServerID no for especificado, as comunicaes com o agente sero

manipuladas pelo processo mailman principal no gerenciador de domnio.
|
|
protocol http | https

Especifica o protocolo a usar para se comunicar com:
|
|
A estao de trabalho do broker

Se a estao de trabalho for uma estao de trabalho do agente.
|
|
|
O mecanismo remoto
Se a estao de trabalho for uma estao de trabalho de mecanismo
remoto.
|
|
|
members [workstation] [...]

Use esse valor para uma estao de trabalho de conjunto para especificar
os agentes dinmicos que deseja incluir no conjunto.
|
|
|
|
|
|
|
|
|
requirements jsdl_definition
Use esse valor para uma estao de trabalho de conjunto dinmico para
especificar os requisitos, no formato .JSDL, que os agentes devem
especificar para pertencerem automaticamente ao conjunto dinmico. A
sintaxe a seguir usada:
jsdl_definition:
<jsdl:resources>
<jsdl:logicalResource subType="MyResourceType"/>
</jsdl:resources>
|
|
Para obter informaes adicionais sobre a sintaxe JSDL, consulte Planejando

Carga de Trabalho Dinamicamente.
|
|
|
|
|
Nota: possvel incluir definies da estao de trabalho no banco de dados em

qualquer momento, mas voc deve executar JnextPlan -for 0000 novamente
para poder executar tarefas nas novas estaes de trabalho criadas. Toda vez
que JnextPlan executada, todas as estaes de trabalho so paradas e
interrompidas.
Exemplos
O exemplo a seguir cria um gerenciador de domnio principal denominado hdq-1 e
um agente tolerante a falhas denominado hdq-2 no domnio principal. Observe que
um argumento domain opcional neste exemplo, porque o domnio principal
padronizado como masterdm.
cpuname hdq-1 description Headquarters master DM
os unix
tz America/Los_Angeles
node sultan.ibm.com
domain masterdm
for maestro type manager
autolink on
fullstatus on
fim
cpuname hdq-2
os wnt
tz America/Los_Angeles
node opera.ibm.com
149
domain masterdm
for maestro type fta
autolink on
fim
O exemplo a seguir cria um domnio chamado distr-a com um gerenciador de

domnio chamado distr-a1 e um agente padro chamado distr-a2:
domain distr-a
manager distr-a1
parent masterdm
fim
cpuname distr-a1 description District A domain mgr
os wnt
tz America/New_York
node pewter.ibm.com
domain distr-a
for maestro type manager
autolink on
fullstatus on
fim
cpuname distr-a2
os wnt
node quatro.ibm.com
tz America/New_York
domain distr-a
for maestro type s-agent
fim
O exemplo a seguir cria uma estao de trabalho tolerante a falhas com

autenticao SSL. A definio de segurana securitylevel especifica que a conexo
entre a estao de trabalho e seu gerenciador de domnio pode ser somente do tipo
SSL. A porta 32222 reservada para atender conexes SSL de entrada.
cpuname ENNETI3
os WNT
node apollo
tcpaddr 30112
secureaddr 32222
for maestro
autolink off
fullstatus on
securitylevel on
fim
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir cria uma estao de trabalho de intermedirio. Esta estao de

trabalho gerencia o ciclo de vida das tarefas do tipo do Tivoli Workload workload
broker Broker no Tivoli Dynamic Workload Broker.
|
|
|
O exemplo a seguir cria uma estao de trabalho de mecanismo remoto a ser

usada para gerenciar dependncias cruzadas e se comunicar com um mecanismo
remoto instalado em um sistema com nome do host London-hdq usando a porta
cpuname ITDWBAGENT
vartable TABLE1
os OTHER
node itdwbtst11.ibm.com TCPADDR 41114
timezone Europe/Rome
domain MASTERDM
for MAESTRO
type BROKER
autolink OFF
behindfirewall OFF
fullstatus OFF
fim
150
|
|
|
|
|
|
|
|
|
|
|
HTTPS padro 31116. A estao de trabalho do mecanismo remoto hospedada

pela estao de trabalho do broker ITDWBAGENT
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir mostra como criar um conjunto dinmico de agentes

dinmicos. Todos os agentes dinmicos do conjunto dinmico devem ter os
sistemas operacionais HP-UX ou Linux instalados:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir mostra como criar um conjunto dinmico de agentes

dinmicos. Todos os agentes dinmicos do conjunto dinmico devem ter o sistema
operacional Windows 2000 instalado:
|
|
|
|
|
|
|
O exemplo a seguir mostra como criar um conjunto de agentes dinmicos

denominado POOLUNIX e que contm dois agentes dinmicos: NC121105 e
NC117248:
cpuname REW_London
description "Remote engine workstation to communicate with London-hdq"
os WNT
node London-hdq secureaddr 31116
timezone Europe/London
for maestro host ITDWBAGENT
type rem-eng
protocol HTTPS
fim
CPUNAME DPOOLUNIX
DESCRIPTION "Sample Dynamic Pool Workstation"
VARTABLE table1
OS OTHER
TIMEZONE Europe/Rome
FOR MAESTRO HOST MAS86MAS_DWB
TYPE D-POOL
REQUIREMENTS
<?xml version="1.0" encoding="UTF-8"?>
<jsdl:resourceRequirements
xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl">
<jsdl:resources>
<jsdl:candidateOperatingSystems>
<jsdl:operatingSystem type="HPUX"/>
<jsdl:operatingSystem type="LINUX"/>
</jsdl:candidateOperatingSystems>
</jsdl:resources>
</jsdl:resourceRequirements>
END
CPUNAME DPOOLWIN
DESCRIPTION "Sample Dynamic Pool Workstation"
OS WNT
TYPE D-POOL
REQUIREMENTS
<jsdl:resourceRequirements
xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl">
<jsdl:resources>
<jsdl:candidateOperatingSystems>
<jsdl:operatingSystem type="Windows 2000"/>
</jsdl:candidateOperatingSystems>
</jsdl:resources>
</jsdl:resourceRequirements>
END
CPUNAME POOLUNIX
DESCRIPTION "Sample Pool Workstation"
OS OTHER
151
|
|
|
|
|
|

TYPE POOL
MEMBERS
NC121105
NC117248
END
Consulte tambm
Para criar uma definio de estao de trabalho no Dynamic Workload Console :
1. Clique em Tivoli Workload SchedulerAmbiente de
PlanejamentoDesignCriar Estaes de Trabalho
2. Selecione um nome de mecanismo e clique em Ir
3. Isso exibe a tarefa no painel Propriedades - Definio de Tarefa.
Definio de classe de estao de trabalho

Uma classe de estao de trabalho um grupo de estaes de trabalho para o qual
tarefas comuns e fluxos de tarefa podem ser gravados. possvel incluir vrias
definies de classes de estao de trabalho no mesmo arquivo de texto, junto com
definies de estao de trabalho e definies de domnio.
Ao definir classes de estao de trabalho, assegure-se de que as estaes de
trabalho na classe suportem os tipos de tarefas que planeja executar nelas. As
seguintes regras se aplicam:
v Os tipos de tarefas com opes avanadas executam apenas em agentes
dinmicos, conjuntos e conjuntos dinmicos.
v Tarefas sombra so executadas apenas em mecanismos remotos.
|
|
|
|
|
|
Cada definio de classe de estao de trabalho tem o seguinte formato e

argumentos:
Sintaxe
cpuclass workstationclass
[description "description"]
[ignore]
members [workstation | @] [...]
end
[cpuname ...]
[cpuclass ...]
[domain ...]
Argumentos
cpuclass workstationclass
Especifica o nome da classe de estao de trabalho. O nome deve iniciar
com uma letra e pode conter caracteres alfanumricos, traos e
sublinhados. Ele pode conter at 16 caracteres.
Nota: No possvel utilizar nomes iguais para estaes de trabalho,
classes de estao de trabalho e domnios.
152
Fornece uma descrio da classe da estao de trabalho. O texto deve ser
colocado entre aspas duplas.
ignorar
Especifica que o Tivoli Workload Scheduler deve ignorar todas as estaes
de trabalho includas nesta classe de estao de trabalho ao gerar o plano
de produo.
members workstation
Especifica uma lista de nomes de estaes de trabalho, separadas por
espaos, que so membros da classe. O caractere curinga @ significa que a
classe da estao de trabalho inclui todas as estaes de trabalho.
Exemplos
O exemplo a seguir define uma classe de estao de trabalho chamada backup:
cpuclass backup
members
main
site1
site2
fim
O exemplo a seguir define uma classe de estao de trabalho chamada allcpus que
contm todas as estaes de trabalho:
cpuclass allcpus
members
@
fim
Consulte tambm
Para criar uma definio de classe de estao de trabalho no Dynamic Workload
Console :
1. Clique em Tivoli Workload SchedulerCarga de TrabalhoDesignCriar
Definies de Carga de Trabalho
3. Na barra de ferramentas Lista de Trabalho da janela pop-up que se abre, clique
em NovoClasse de Estao de Trabalho
4. Especifique suas opes no painel Propriedades - Classe de Estao de
Trabalho.
Definio de domnio
Um domnio um grupo de estaes de trabalho que consiste em um ou mais
agentes e em um gerenciador de domnio. O gerenciador de domnio age como um
hub de gerenciamento para os agentes no domnio. possvel incluir vrias
definies de domnio no mesmo arquivo de texto, junto com definies de estao
de trabalho e definies de classes de estao de trabalho. Cada definio de
domnio tem o seguinte formato e argumentos:
153
Sintaxe
domain domainname[description description]
* manager workstation
[parent domainname | ismaster]
end
[cpuname ...]
[cpuclass ...]
[domain ...]
Argumentos
domain domainname
O nome do domnio. Deve iniciar com uma letra e pode conter caracteres
alfanumricos, traos e sublinhados. Ele pode conter at 16 caracteres. No
possvel utilizar nomes iguais para estaes de trabalho, classes de
estao de trabalho e domnios.
Fornece uma descrio do domnio. O texto deve ser colocado entre aspas
duplas.
Esse um campo comentado utilizado somente para mostrar, ao exibir a
definio do domnio, o nome da estao de trabalho que tem a funo do
gerenciador de domnio para esse domnio. Certifique-se de que esse
campo permanea como comentrio. Foi mantido para
retrocompatibilidade. Com o Tivoli Workload Scheduler verso 8.3, as
informaes sobre se uma estao de trabalho um gerenciador de
domnio so configuradas no campo type em Definio de estao de
trabalho na pgina 135.
parent domainname
O nome do domnio pai ao qual o gerenciador de domnio est ligado. O
padro o domnio principal, que no requer uma definio de domnio.
O domnio principal definido pelas opes globais master e master
domain.
ismaster
Se especificado, indica que o domnio o domnio principal da rede do
Tivoli Workload Scheduler. Se configurado, no pode ser removido
posteriormente.
Exemplos
O exemplo a seguir define um domnio chamado east, com o domnio principal
como seu pai e dois domnios subordinados chamados northeast e southeast:
domain east
description O domnio Oriental
* manager cyclops
fim
domain northeast
description O domnio no Nordeste
* manager boxcar
parent east
fim
domain southeast
154
description O domnio no Sudeste

* manager sedan
parent east
fim
Consulte tambm
No Dynamic Workload Console , para criar uma definio de domnio, voc deve
passar pelo processo de definio da estao de trabalho conforme a seguir:
3. No painel Propriedades da Estao de Trabalho, clique em Designar ao
Domnio.
4. No painel Selecionar Domnio, clique em Novo.
5. Especifique suas opes no painel Propriedades do Domnio.
Definio de tarefa
Um job um arquivo, programa ou comando executvel que planejado e ativado
pelo Tivoli Workload Scheduler. possvel gravar definies de tarefas em
arquivos de edio e, em seguida, nclu-las no banco de dados do Tivoli Workload
Scheduler com o programa composer. possvel incluir vrias definies de job em
um nico arquivo de edio.
Cada definio de tarefa tem o seguinte formato e argumentos:
Sintaxe
|
|
|
|
|
|
|
|
|
|
|
|
|
$jobs
[workstation#]jobname
{scriptname filename streamlogon username |
docommand command streamlogon username |
task job_definition [streamlogon username]}
[description description]
[tasktype tasktype]
[interactive]
[rccondsucc "Success Condition"]
[recovery
{stop | continue | rerun}
[after [workstation#]jobname]
[abendprompt text] ]
Uma tarefa em si no possui configuraes para dependncias, elas devem ser
adicionadas a uma tarefa quando includa em uma definio de fluxo de tarefas.
possvel incluir ou modificar definies de tarefas a partir de definies de fluxos
de tarefas. Modificaes em definies de tarefas feitas nas definies dos fluxos de
tarefas so refletidas nas definies de tarefas armazenadas no banco de dados.
Isso significa que se voc modificar a definio de tarefa de job1 na definio de
fluxo de tarefas js1 e job1 tambm for utilizado no fluxo de tarefa js2, a definio
de job1 na definio js2 tambm modificada conforme necessrio.
Nota: Palavras-chave incorretamente digitadas utilizadas em definies de tarefa
levam a definies de tarefa truncada armazenadas no banco de dados. De
155
fato, a palavra-chave incorreta considerada estranha para a definio de

tarefa e, portanto, interpretada como o nome de tarefa de uma definio
de tarefa adicional. Geralmente, essa interpretao incorreta tambm causa
um erro de sintaxe ou um erro de definio de tarefa inexistente para a
definio de tarefa adicional.
Consulte a seo Definio de fluxo de tarefas na pgina 194 para obter
informaes sobre como gravar definies de fluxos de tarefas.
Argumentos
workstation#
Especifica o nome da estao de trabalho ou classe de trabalho na qual o
job executado. O padro a estao de trabalho especificada para
defaultws ao iniciar a sesso do composer.
Para obter informaes adicionais sobre como iniciar uma sesso do
composer, consulte Executando o Programa composer na pgina 249. O
sinal de sustenido (#) um delimitador necessrio. Se voc especificar uma
classe de estao de trabalho, ela dever corresponder classe de estao
de trabalho de qualquer fluxo de tarefa no qual a tarefa foi includa.
Se estiver definindo uma tarefa que gerencia uma tarefa de broker da carga
de trabalho, especifique o nome da estao de trabalho onde a estao de
trabalho do broker da carga de trabalho est instalada. Utilizando a estao
de trabalho do broker da carga de trabalho, o Tivoli Workload Scheduler
pode submeter a tarefa no ambiente broker de carga de trabalho dinmica
usando o envio de tarefa dinmico.
jobname
Especifica o nome do job. O nome deve iniciar com uma letra e pode
conter caracteres alfanumricos, traos e sublinhados. Ele pode conter at
40 caracteres.
scriptname filename
Especifique o nome do arquivo no qual o job executado. Utilize
scriptname para jobs do UNIX e do Windows. Para um arquivo
executvel, digite o nome do arquivo e todas as opes e argumentos. O
filename mais a Success Condition (da palavra-chave rccondsucc) no devem
exceder 4095 caracteres. Os parmetros do Tivoli Workload Scheduler
tambm podem ser utilizados.
Consulte Utilizando Variveis e Parmetros nas Definies de Tarefa na
pgina 177 para obter informaes adicionais.
Para jobs do Windows, inclua as extenses do arquivo. Nomes UNC
(Universal Naming Convention) so permitidos. No especifique arquivos
em unidades mapeadas.
Se estiver definindo uma tarefa que gerencia uma tarefa do broker de carga
de trabalho, especifique o nome do host da tarefa do broker da carga de
trabalho. Alm disso, possvel especificar variveis e o tipo de afinidade
que existem entre a tarefa Tivoli Workload Scheduler e a tarefa do broker
de carga de trabalho usando a sintaxe descrita na lista a seguir. Para
identificar uma tarefa relacionada utilizando o:
Nome da Tarefa do Tivoli Workload Scheduler
jobName [-var var1Name=var1Value,...,varNName=varNValue]
[-twsAffinity jobname=twsJobName]
156
broker de carga de trabalho dinmica job ID

[-affinity jobid=jobid]
broker de carga de trabalho dinmica job alias
[-affinity alias=alias]
Consulte o IBM Tivoli Workload Scheduler: Scheduling Workload Dynamically
para obter informaes detalhadas.
Se o caminho do arquivo ou o nome do arquivo do argumento scriptname
contiver espaos, a cadeia inteira deve ser inserida entre "\" e \" ", como
mostrado abaixo:
scriptname "\"C:\Program
Files\tws\myscript.cmd\""
Se caracteres especiais forem includos, diferentes de barras (/) e barras

invertidas (\), a cadeia inteira dever ser colocada entre aspas (").
A tarefa falha se o script especificado na opo scriptname no for
localizado ou no tiver permisso de execuo. Ela encerrada de forma
anormal se o script que no for localizado ou no tiver permisso de
execuo incluir parmetros.
docommand command
Especifica um comando executado pelo job. Digite um comando vlido, as
opes e os argumentos entre aspas duplas ("). O command mais a Success
Condition (da palavra-chave rccondsucc) no devem exceder 4095
caracteres. Os parmetros do Tivoli Workload Scheduler tambm podem
ser digitados.
A tarefa encerrada de forma anormal se o arquivo especificado com a
opo docommand no for localizado ou no tiver permisso de execuo.
|
|
|
|
|
|
|
|
|
tarefa job_definition
Especifica a sintaxe do XML para tipos de tarefas com opes avanadas e
tarefas sombra. Para definir tipos de tarefas existentes, use a palavra-chave
docommand. Essa palavra-chave se aplica somente a estaes de trabalho
dos seguintes tipos:
v agent
v conjunto
v d-pool
v rem-eng
A sintaxe da tarefa depende do tipo de tarefa definido.
|
|
|
|
|
|
|
|
possvel definir os seguintes tipos de tarefas:

v Tarefas sombra que so ligadas a outras tarefas em redes Tivoli
Workload Scheduler para z/OS ou Tivoli Workload Scheduler remotas.
Para obter informaes adicionais, consulte a Definio de Tarefa Tarefas Sombra na pgina 164.
v Tarefas que executam comandos de servios da Web. Para obter
informaes adicionais, consulte a Definio de Tarefa - Tarefas de
Servios da Web na pgina 166.
157
|
|
|
v Tarefas que executam tarefas de transferncia de arquivos. Para obter

Transferncia de Arquivos na pgina 168.
|
|
|
|
|
|
v Tarefas que usam J2EE para enviar e receber mensagens entre aplicativos
Java na mesma rede. Para obter informaes adicionais, consulte a
Definio de Tarefa - Tarefas J2EE na pgina 170.
v Tarefas que executam operaes do banco de dados. Para obter
Banco de Dados na pgina 172.
|
|
|
|
|
|
|
|
|
|
|
v Tarefas que executam operaes Java. Para obter informaes adicionais,

consulte a Definio de Tarefa - Tarefas Java na pgina 174.
v Tarefas que executam scripts ou comandos com opes avanadas. Para
obter informaes adicionais, consulte a Definio de Tarefa - Tarefas
Executveis na pgina 174.
v Tarefas que estendem os recursos do Tivoli Workload Scheduler para
outros aplicativos, como SAP ou PeopleSoft. Para obter informaes
adicionais, consulte a Definio de Tarefa - Tarefas XA na pgina 175.
v Tarefas que executam comandos em sistemas IBM i. Para obter
informaes adicionais, consulte a Definio de Tarefa - Tarefas do IBM
i na pgina 177.
streamlogon username
O nome do usurio sob o qual o job executado. Esse atributo
obrigatrio quando scriptname ou docommand so especificados. O nome
pode conter at 47 caracteres. Se o nome contiver caracteres especiais, ele
dever ser colocado entre aspas duplas ("). Especifique um usurio que
pode efetuar logon na estao de trabalho na qual o job executado. Os
parmetros do Tivoli Workload Scheduler tambm podem ser digitados.
|
|
|
|
|
|

Para jobs do Windows, o usurio tambm deve ter uma definio de
usurio.
Consulte definio de usurio do Windows na pgina 182 para obter
requisitos do usurio.
Se estiver definindo uma tarefa que gerencia uma tarefa do dynamic
workload broker, especifique o nome do usurio utilizado para instalar o
broker de carga de trabalho dinmica.
A tarefa falha se o usurio especificado na opo streamologon no existir.
Fornece uma descrio do job. O texto deve ser colocado entre aspas
duplas.O nmero mximo de caracteres permitidos 120.
tasktype tasktype
Especifica o tipo de tarefa. Pode ter um dos seguintes valores:
UNIX Para tarefas executadas nas plataformas UNIX.
WINDOWS
Para tarefas executadas nas plataformas Windows.
OTHER
Para tarefas executadas em agentes estendidos. Consulte o IBM
158
Tivoli Workload Scheduler for Applications: User's Guide para obter

informaes sobre tipos de tarefas customizadas para aplicativos de
terceiros suportados.
BROKER
Este painel descreve as propriedades de uma tarefa. Consulte IBM
Tivoli Workload Scheduler: Scheduling Workload Dynamically para
obter informaes sobre como usar o broker de carga de trabalho
dinmica.
interativo
If you are defining a workload broker job, ignore this host argument or the
TCP/IP address of the workstation where you installed the Tivoli
Workload Scheduler job. Especifica que a tarefa executada
interativamente no desktop do usurio. Este recurso est disponvel
somente nos ambientes Windows.
rccondsucc "Success Condition"
Uma expresso que determina o cdigo de retorno (RC) requerido para
considerar um job bem-sucedido. A condio de xito pode ter no mximo
256 caracteres. Essa expresso pode ser uma das seguintes:
COMPLETE_IF_BIND_FAILS
Essa configurao se aplica somente a tarefas sombra. Quando
especificada, o status da tarefa sombra configurado
automaticamente para SUCC se a ligao com a tarefa remota
falhar.
|
|
|
|
|
Expresso de comparao
Especifica os cdigos de retorno do job. A sintaxe :
(RC operator operand)
RC
A palavra-chave RC.
operator
Operador de comparao. Ele pode ter os seguintes
valores:
Tabela 23. Operadores de Comparao
Exemplo
RC<a
RC<=a
RC>a
RC>=a
Operator
Descrio
<
Menor que
<=
Menor ou igual a que
>
Maior que
>=
Maior ou igual a que
RC=a
Igual a
RC!=a
!=
Diferente de
RC<>a
<>
Diferente de
operand
Um inteiro entre -2147483647 e 2147483647.
Por exemplo, possvel definir um job bem sucedido como um job
que finaliza com um cdigo de retorno menor ou igual a 3, como
segue:
rccondsucc "(RC <= 3)"
159
Expresso booleana
Especifica uma combinao lgica de expresses de comparao. A
sintaxe :
comparison_expression operator comparison_expression
comparison_expression
A expresso avaliada da esquerda para a direita.
possvel utilizar parnteses para atribuir um prioridade
avaliao da expresso.
operator
Operador lgico. Ele pode ter os seguintes valores:
Tabela 24. Operadores lgicos
Exemplo
Operator
Resultado
expr_a e expr_b
And
TRUE se expr_a e expr_b forem TRUE.
expr_a ou expr_b
Ou
TRUE se expr_a ou expr_b for TRUE.
Not expr_a
Not
TRUE se expr_a no for TRUE.
Por exemplo, possvel definir um job bem sucedido como um job

que finaliza com um cdigo de retorno menor ou igual a 3 ou com
um cdigo de retorno diferente de 5 e menor que 10, como segue:
rccondsucc "(RC3) OR ((RC5) AND (RC<10))"
recovery
Recupera opes para o job. O padro stop sem job de recuperao e sem
prompt de recuperao. Digite uma das opes de recuperao, stop,
continue ou rerun. Elas podem vir seguidas de um job de recuperao, um
prompt de recuperao ou de ambos.
parar
Se a tarefa terminar com erro, no continue com a prxima tarefa.
|
|
|
|
|
continue
Se a tarefa terminar com erro, no continue com a prxima tarefa.
A tarefa no listada como encerrada de forma anormal nas
propriedades do fluxo de tarefas. Se nenhum outro problema
ocorrer, o fluxo de tarefas concludo com sucesso.
|
|
reexecutar
Se a tarefa terminar com erro, execute-a novamente.
after [workstation#]jobname
Especifica o nome de uma tarefa de recuperao para execuo se a
tarefa pai finalizar anormalmente. Os jobs de recuperao so
executados somente uma vez para cada instncia terminada de
forma anormal do job pai.
possvel especificar a estao de trabalho de tarefa de
recuperao se ela for diferente da estao de trabalho da
tarefa-pai. O padro a estao de trabalho da tarefa-pai. Nem
todos os jobs so elegveis para executarem os jobs de recuperao
em uma estao de trabalho diferente. Siga estas instrues:
v Se uma das estaes de trabalho for um agente estendido, ela
dever ser alojada por um gerenciador de domnio ou por um
agente de tolerncia a falhas com um valor de on para
fullstatus.
160
v A estao de trabalho da tarefa de recuperao pode estar no

mesmo domnio que a estao de trabalho da tarefa-pai ou em
um domnio mais alto.
v Se a estao de trabalho do job de recuperao for um agente
tolerante a falhas, ela dever ter um valor de on para fullstatus.
abendprompt text
Especifica o texto de um prompt de recuperao, colocado entre
aspas duplas, a ser exibido se a tarefa finalizar anormalmente. O
texto pode conter at 64 caracteres. Se o texto comear com dois
pontos (:), o prompt ser exibido, mas no ser necessria
nenhuma resposta para continuar o processamento. Se o texto
comear com um ponto de exclamao (!), o prompt ser exibido,
mas no ser gravado no arquivo de log. Os parmetros do Tivoli
Workload Scheduler tambm podem ser utilizados.
Consulte Utilizando Variveis e Parmetros nas Definies de
Tarefa na pgina 177 para obter informaes adicionais.
A Tabela 25 resume todas as combinaes possveis de aes e opes de
recuperao.
A tabela baseia-se nos seguintes critrios de um fluxo de job chamado
sked1:
v O fluxo de tarefas sked1 possui duas tarefas, job1 e job2.
v Se for selecionada para job1, a tarefa de recuperao ser jobr.
v job2 dependente de job1 e no iniciada at job1 ter sido concluda.
Tabela 25. Opes e Aes de Recuperao
Parar
Prompt de recuperao: A interveno
No Job de
requerida.
recuperao: No
Continuar
Executar Novamente
Execute o job2.
Execute novamente o
job1. Se job1 for
abortada, emita um
prompt. Se a resposta
for sim, repita a
instruo anterior. Se o
job1 for bem-sucedido,
execute o job2.
Prompt de recuperao: Emita o prompt de Emita o prompt de

Sim Job de
recuperao. A
recuperao. Se a
recuperao: No
interveno
resposta for sim,
requerida.
execute o job2.
Emita o prompt de
recuperao. Se a
resposta for sim, execute
novamente o job1. Se
ocorrer abend do job1,
repita a instruo
anterior. Se o job1 for
bem-sucedido, execute o
job2.
161
Tabela 25. Opes e Aes de Recuperao (continuao)

Parar
Continuar
Prompt de recuperao: Execute o jobr. Se Execute o jobr.

No Job de
finalizar
Execute o job2.
recuperao: Sim
anormalmente,
necessria
interveno. Se for
bem-sucedido,
execute o job2.
Prompt de recuperao: Emita o prompt de

Sim Job de
recuperao. Se a
recuperao: Sim
resposta for sim,
execute o jobr. Se
finalizar
anormalmente,
necessria
interveno. Se for
bem-sucedido,
execute o job2.
Emita o prompt de
recuperao. Se a
resposta for sim,
execute o jobr.
Execute o job2.
Executar Novamente
Execute o jobr. Se jobr
finalizar anormalmente,
necessria
interveno. Se o jobr
for bem-sucedido,
execute novamente o
job1. Se job1 for
abortada, emita um
prompt. Se a resposta
for sim, repita a
instruo anterior. Se o
job1 for bem-sucedido,
execute o job2.
Emita o prompt de
recuperao. Se a
resposta for sim, execute
o jobr. Se jobr finalizar
anormalmente,
necessria interveno.
Se o jobr for
bem-sucedido, execute
novamente o job1. Se
ocorrer abend do job1,
repita a instruo
anterior. Se o job1 for
bem-sucedido, execute o
job2.
Notas:
1. "Interveno requerida" significa que o job2 no liberado de
sua dependncia do job1 e, portanto, deve ser liberado pelo
operador.
2. A opo de recuperao continue substitui o estado de
finalizao anormal, que pode fazer com que o fluxo de tarefa
que contm a tarefa finalizada anormalmente seja marcada
como bem-sucedida. Isso evita que o fluxo de tarefas seja
transportado para o prximo plano de produo.
3. Se voc selecionar a opo rerun sem fornecer um prompt de
recuperao, o Tivoli Workload Scheduler gera seu prprio
prompt.
4. Para fazer referncia a um job de recuperao no conman,
utilize o nome do job original (job1 no cenrio anterior, no
jobr). executado somente um job de recuperao para cada
abnormal.
Exemplos
A seguir, um exemplo de arquivo contendo duas definies de job:
$jobs
cpu1#gl1
scriptname "/usr/acct/scripts/gl1"
streamlogon acct
description "general ledger job1"
162
bkup
scriptname "/usr/mis/scripts/bkup"
streamlogon "^mis^"
recovery continue after recjob1
O exemplo a seguir mostra como definir a tarefa Tivoli Workload Scheduler

TWSJOB que gerencia a tarefa broker_1 do Tivoli Dynamic Workload Broker:
ITDWBAGENT#TWSJOB
SCRIPTNAME "broker_1 -var var1=name,var2=address
-twsaffinity jobname=TWSJOB2"
STREAMLOGON brkuser
DESCRIPTION "Added by composer."
TASKTYPE BROKER
RECOVERY STOP
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir mostra como definir uma tarefa designada a um conjunto

dinmico de agentes dinmicos do Windows e executa o script df:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir mostra como definir uma tarefa designada a um conjunto

dinmico de agentes dinmicos do Windows e executa o script dir:
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir mostra como definir uma tarefa que designada ao agente
dinmico NC115084 e executa o script dir:
DPOOLUNIX#JOBDEF7
TASK
<jsdl:jobDefinition
xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl"
xmlns:jsdle="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdle">
<jsdl:application name="executable">
<jsdle:executable interactive="false">
<jsdle:script>df</jsdle:script>
</jsdle:executable>
</jsdl:application>
</jsdl:jobDefinition>
RECOVERY STOP
DPOOLWIN#JOBDEF6
TASK
<jsdl:jobDefinition
<jsdle:script>dir</jsdle:script>
</jsdle:executable>
</jsdl:application>
RECOVERY STOP
NC115084#JOBDEF3
TASK
<jsdl:jobDefinition
<jsdle:script>dir</jsdle:script>
</jsdle:executable>
163
|
|
|
|
</jsdl:application>
RECOVERY STOP
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir mostra como definir uma tarefa designada a um conjunto de

agentes dinmicos do UNIX e executa o script definido na tag script:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir mostra como definir uma tarefa designada a um conjunto de

agentes dinmicos do Windows e executa o script definido na tag script:
Consulte tambm
POOLUNIX#JOBDEF5
TASK
<jsdl:jobDefinition
<jsdle:script>#!/bin/sh
sleep 60
dir</jsdle:script>
</jsdle:executable>
</jsdl:application>
RECOVERY STOP
POOLWIN#JOBDEF4
TASK
<jsdl:jobDefinition
<jsdle:script>ping -n 120 localhost</jsdle:script>
</jsdle:executable>
</jsdl:application>
RECOVERY STOP
possvel escrever definies de tarefas usando o Dynamic Workload Console ,

que cria a tarefa com a sintaxe adequada:
3. Na barra de ferramentas Lista de Trabalho da janela pop-up exibida, clique em
NovoDefinio da Tarefa
4. Clique em um tipo de definio de tarefa e especifique suas opes no painel
de propriedades resultante.
O Dynamic Workload Console escreve .
|
Definio de Tarefa - Tarefas Sombra
|
|
Tarefas sombra so definidas usando a sintaxe XML. Os atributos-chave para

identificar a instncia da tarefa remota e os critrios de correspondncia dependem
164
|
|
|
do tipo de mecanismo remoto em que a instncia de tarefa remota definida.

Campos destacados em negrito so aqueles usados para identificar a instncia da
tarefa remota.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
z/OS
Como os mecanismos do z/OS suportam somente os critrios e
correspondncia anteriores mais prximos, o modelo XML para definir uma tarefa
sombra do z/OS o seguinte:
|
|
Nota: Certifique-se de que tenha inserido configuraes vlidas nos campos

JobStream e JobNumber.
|
|
|
|
Distribudo
Tarefas sombra distribudas, no entanto, suportam os quatro critrios de
correspondncia disponveis para dependncias de sequncias externas. A seguir
so mostrados modelos XML que possvel usar para definir tarefas sombra
distribudas:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Critrios de correspondncia: Mais prximo anterior

Amostra de XML:
|
|
|
|
|
|
|
|
|
|
Critrios de correspondncia: Dentro de um intervalo absoluto

Amostra de XML:
$JOBS
WORKSTATION#ZSHADOW_CLOS_PRES
TASK
<jsdl:jobDefinition
xmlns:zshadow="http://www.ibm.com/xmlns/prod/scheduling/1.0/zshadow">
<jsdl:application name="zShadowJob">
<zshadow:ZShadowJob>
<zshadow:JobStream>JobStream</zshadow:JobStream>
<zshadow:JobNumber>JobNumber</zshadow:JobNumber>
<zshadow:matching>
<zshadow:previous/>
</zshadow:matching>
</zshadow:ZShadowJob>
</jsdl:application>
DESCRIPTION "Sample Job Definition"
RECOVERY STOP
$JOBS
WORKSTATION#DSHADOW_CLOS_PRES
TASK
<jsdl:jobDefinition
xmlns:dshadow="http://www.ibm.com/xmlns/prod/scheduling/1.0/dshadow">
<jsdl:application name="distributedShadowJob">
<dshadow:DistributedShadowJob>
<dshadow:JobStream>JobStream</dshadow:JobStream>
<dshadow:Workstation>Workstation</dshadow:Workstation>
<dshadow:Job>Job</dshadow:Job>
<dshadow:matching>
<dshadow:previous/>
</dshadow:matching>
</dshadow:DistributedShadowJob>
</jsdl:application>
RECOVERY STOP
$JOBS
WORKSTATION#DSHADOW_ABSOLUTE
TASK
<jsdl:jobDefinition
165
|
|
|
|
|
|
|
|
|
|
|
|
<dshadow:matching>
<dshadow:absolute from="0600 -4" to="1100 +3"/>
</dshadow:matching>
</jsdl:application>
RECOVERY STOP
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Critrios de correspondncia: Dentro de um intervalo relativo
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Critrio de correspondncia: Mesma data planejada

Amostra de XML:
|
|
|
Para obter informaes adicionais sobre os critrios de correspondncia, consulte

Gerenciando Dependncias de Acompanhamentos Externos para Tarefas e Fluxos
de Tarefas na pgina 57.
Definio de Tarefa - Tarefas de Servios da Web
|
|
Esta seo descreve os atributos necessrios e opcionais para tarefas de servios da

Web. Cada definio de tarefa tem o seguinte formato e argumentos:
|
|
Tabela 26. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa de Servios
da Web.
$JOBS
WORKSTATION#DSHADOW_RELATIVE
TASK
<jsdl:jobDefinition
<dshadow:matching>
<dshadow:relative from="-400" to="+500" />
</dshadow:matching>
</jsdl:application>
RECOVERY STOP
$JOBS
WORKSTATION#DSHADOW_SAMEDAY
TASK
<jsdl:jobDefinition
<dshadow:matching>
<dshadow:sameDay/>
</dshadow:matching>
</jsdl:application>
RECOVERY STOP
Atributo
nome do aplicativo
166
Descrio/valor
ws
Exigido
U
|
|
Tabela 26. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa de Servios
da Web. (continuao)
Atributo
Descrio/valor
Exigido
|
|
operao
O nome do comando de servio da Web que

voc est chamando.
wsdlURL
O nome da URL de servio da Web.
|
|
|
argumentos
Os parmetros necessrios para o comando

de servio da Web que voc est chamando
(o nmero de valores depende do comando).
|
|
credenciais
O nome e a senha do usurio que est

executando essa tarefa.
|
|
|
|
|
|
Se voc usar uma conexo HTTPS, assegure

que os certificados de segurana sejam
configurados para o Gerenciador de Tarefa
na estao de trabalho onde a tarefa deve ser
executada.
A sada do comando registrada no log da tarefa.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir mostra uma tarefa que executa o comando de servios da Web
getSum. A definio da tarefa fornece na seo arguments os dois valores que
devem ser includos.
$JOBS
AGENT#WEB_SERVICE
TASK
<jsdl:jobDefinition xmlns:jsdl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl"
xmlns:jsdlws="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdlws" description="Calls a web
service to perform a sum of two numbers" name="SumNumber">
<jsdl:annotation>annotation</jsdl:annotation>
<jsdl:variables>
<jsdl:stringVariable description="URL of Web Service"
name="wsdlURL">http://np515516.cyber.com:9080/
Sum/services/Sum/wsdl/Sum.wsdl</jsdl:stringVariable>
<jsdl:stringVariable description="Operation to Invoke"
name="Operation">getSum</jsdl:stringVariable>
</jsdl:variables>
<jsdl:application name="ws">
<jsdlws:ws>
<jsdlws:wsToInvoke operation="${Operation}" wsdlURL="${wsdlURL}">
<jsdlws:arguments>
<jsdlws:value>1</jsdlws:value>
<jsdlws:value>2</jsdlws:value>
</jsdlws:arguments>
<jsdlws:credentials>
<jsdl:userName>administrator</jsdl:userName>
<jsdl:password>password</jsdl:password>
</jsdlws:credentials>
</jsdlws:wsToInvoke>
</jsdlws:ws>
</jsdl:application>
<jsdl:resources>
<jsdl:candidateHosts>
<jsdl:hostName>${host}</jsdl:hostName>
</jsdl:candidateHosts>
</jsdl:resources>
|
|
|
|
O exemplo a seguir se aplica se voc usar uma conexo HTTPS com o agente que
executa a tarefa de servios da Web. Mostra como configurar a chave JVMOptions
no arquivo jobManager.ini do agente para apontar para os certificados de
segurana.
167
|
|
|
|
|
JVMOptions=-Djavax.net.ssl.keyStore=/images/ITAuser/TWA/TWS/JavaExt/cfg/agentKeystore.jks
-Djavax.net.ssl.keyStorePassword=tdwb8nxt
-Djavax.net.ssl.trustStore=/images/ITAuser/TWA/TWS/JavaExt/cfg/agentKeystore.jks
-Djavax.net.ssl.trustStorePassword=tdwb8nxt
-Djavax.net.ssl.trustStoreType=JKS
Definio de Tarefa - Tarefas de Transferncia de Arquivos
|
|

|
|
Tabela 27. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa de

Transferncia de Arquivos.
Atributo
Descrio/valor
Exigido
|
|
nome do
aplicativo
filetransfer
|
|
|
|
Tipo de
transferncia de
arquivos (upload
ou download)
Coloque todos os atributos de transferncia de

arquivos entre as tags jsdlfiletransfer:uploadInfo
ou jsdlfiletransfer:downloadInfo, conforme
mostrado no exemplo.
|
|
|
servidor
O endereo do servidor de transferncia de arquivos

(e o nmero da porta, se diferente da porta padro,
ao escolher FTP como o protocolo).
||
||
|
|
|
|
|
|
|
|
localfile e
remotefile
v Se estiver fazendo upload, localfile o caminho

completo e o nome do arquivo a ser transferido
por upload, enquanto que remotefile o caminho
completo e o nome do arquivo a ser criado no
destino remoto.
|
|
localcredentials e Os nomes e senhas dos usurios autorizados nos

remotecredentials sistemas local e remoto.
v Se estiver fazendo download, localfile o

caminho completo e o nome do arquivo a ser
criado no destino local, enquanto que remotefile
o caminho completo e o nome do arquivo a ser
transferido por download.
168
|
|
|
|
Tabela 27. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa de

Transferncia de Arquivos. (continuao)
Atributo
protocol
|
|
|
|
|
|
|
|
|
|
|
Descrio/valor
Exigido
Pode ser:
WINDOWS
O protocolo de compartilhamento de
arquivo da Microsoft. Se voc no especificar
um protocolo e SSH no funcionar,
WINDOWS assumido. Especifique o
diretrio compartilhado na palavra-chave
remotefile, sem especificar quaisquer
caminhos em que o diretrio compartilhado
est aninhado. Especifique o endereo da
estao de trabalho hosting o diretrio
compartilhado na palavra-chave server.
|
|
O diretrio ativo padro : C:\Program

Files\IBM\TWA\TWS\ITA.
|
|
|
|
|
|
SSH
Um protocolo de rede que fornece funes

de acesso a arquivo, transferncia de
arquivos e gerenciamento de arquivos sobre
qualquer fluxo de dados confivel. Se voc
no especificar um protocolo, SSH
assumido como padro.
|
|
|
FTP
Um protocolo de rede padro usado para

trocar arquivos em uma rede baseada em
TCP/IP, como a Internet.
transferMode
Pode ser binary (o padro) ou ascii.
|
|
|
remoteCodepage
A pgina de cdigos usada na estao de trabalho

remota.
Necessrio se
voc especificar
localCodepage
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
localCodepage
A pgina de cdigos usada na estao de trabalho

local.
Necessrio se
voc especificar
remoteCodepage
O exemplo a seguir mostra uma tarefa generalizada que faz download de um

arquivo de uma estao de trabalho remota com endereo 10.0.0.8:
$JOBS
AGENT#FILE_TRANSFER
TASK
xmlns:jsdlfiletransfer="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdlfiletransfer"
name="FILETRANSFER">
<jsdl:application name="filetransfer">
<jsdlfiletransfer:filetransfer>
<jsdlfiletransfer:downloadInfo>
<jsdlfiletransfer:server>10.0.0.8</jsdlfiletransfer:server>
<jsdlfiletransfer:localfile>c:\MyTextFile.txt</jsdlfiletransfer:localfile>
<jsdlfiletransfer:remotefile>./MyRemoteFile.txt</jsdlfiletransfer:remotefile>
<jsdlfiletransfer:localCredentials>
<jsdl:userName>user</jsdl:userName>
</jsdlfiletransfer:localCredentials>
<jsdlfiletransfer:remoteCredentials>
<jsdl:userName>user</jsdl:userName>
</jsdlfiletransfer:remoteCredentials>
<jsdlfiletransfer:protocol>FTP</jsdlfiletransfer:protocol>
<jsdlfiletransfer:transferMode>ascii</jsdlfiletransfer:transferMode>
<jsdlfiletransfer:codepageConversion>
<jsdlfiletransfer:remoteCodepage>IBM-280</jsdlfiletransfer:remoteCodepage>
<jsdlfiletransfer:localCodepage>ISO8859-1</jsdlfiletransfer:localCodepage>
169
|
|
|
|
|
</jsdlfiletransfer:codepageConversion>
</jsdlfiletransfer:downloadInfo>
</jsdlfiletransfer:filetransfer>
</jsdl:application>
Definio de Tarefa - Tarefas J2EE
|
|

Tabela 28. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa J2EE.
Atributo
nome do aplicativo
j2ee
|
|
|
|
|
|
jms operation
A operao a ser executada. Os valores

suportados so:
|
|
|
|
|
timeout
O tempo limite, expressado em segundos,

dentro dos quais a tarefa deve ser
concluda. Se voc no especificar um
tempo limite ou configur-lo para 0, a tarefa
continua indefinidamente.
connectionURL
A URL do WebSphere Application Server.
|
|
|
|
|
|
|
connFactory
Um objeto administrado que um cliente usa

para criar uma conexo com o provedor
JMS. Para especificar o connection factory,
possvel usar uma expresso de varivel que
pode conter uma ou mais referncias de
variveis, como ${var}, qualquer caractere e
qualquer sequncia.
|
|
|
|
|
|
|
|
destino
Um objeto administrado que encapsula a

identidade de um destino de mensagem,
que onde as mensagens so entregues e
consumidas. Para especificar o destino,
possvel usar uma expresso de varivel que
pode conter uma ou mais referncias de
variveis, como ${var}, qualquer caractere e
qualquer sequncia.
|
|
|
|
|
|
|
message
A mensagem a ser enviada.
Descrio/valor
Exigido
U
v send. Este o valor padro.

v receive. Se voc especificar receive,
possvel definir como opo um valor
para o atributo timeout.
170
U
Nota: Esse
atributo
necessrio
somente para
a tarefa de
envio.
|
|
Tabela 28. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa

J2EE. (continuao)
Atributo
Descrio/valor
Exigido
|
|
|
|
|
|
|
|
|
|
|
userName
Especifique o nome de usurio a ser usado

ao executar o aplicativo J2EE. Use esse
campo se a segurana global estiver
ativadas no WebSphere Application Server.
Esse usurio deve existir no WebSphere
Application Server. Para especificar o nome
de usurio, possvel usar uma expresso
de varivel que pode conter uma ou mais
referncias de variveis, como ${var},
opcionalmente em associao com qualquer
caractere ou com uma sequncia simples.
|
|
|
|
|
|
|
|
|
|
password
Especifique a senha a ser utilizada quando o

aplicativo J2EE for executado. Use esse
campo se a segurana global estiver
ativadas no WebSphere Application Server.
Para especificar a senha, possvel usar
uma expresso de varivel que pode conter
uma ou mais referncias de variveis, como
${var}, qualquer caractere e qualquer
sequncia.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir mostra uma tarefa de envio que envia uma mensagem fila
MyQueue:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
$JOBS
AGENT#JOB_NAME_JMS_SEND
TASK
xmlns:jsdlj="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdlj" name="JMS_JOB_SEND">
<jsdl:application name="j2ee">
<jsdlj:j2ee>
<jsdlj:jms operation="send">
<jsdlj:connectionURL>corbaloc:iiop:washost.mydomain.com:2809</jsdlj:connectionURL>
<jsdlj:connFactory>jms/MyCF</jsdlj:connFactory>
<jsdlj:destination>jms/MyQueue</jsdlj:destination>
<jsdlj:message>Submission of jms job: SEND MESSAGE</jsdlj:message>
</jsdlj:jms>
<jsdlj:credential>
<jsdlj:userName>userName</jsdlj:userName>
<jsdlj:password>password</jsdlj:password>
</jsdlj:credential>
</jsdlj:j2ee>
</jsdl:application>
O exemplo a seguir mostra uma tarefa que l mensagens da fila MyQueue:

$JOBS
AGENT#JOB_NAME_JMS_RECEIVE
TASK
xmlns:jsdlj="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdlj" name="JMS_JOB_RECEIVE">
<jsdl:application name="j2ee">
<jsdlj:j2ee>
<jsdlj:jms operation="receive" timeout="180">
<jsdlj:connFactory>jms/MyCF</jsdlj:connFactory>
<jsdlj:destination>jms/MyQueue</jsdlj:destination>
</jsdlj:jms>
<jsdlj:credential>
<jsdlj:userName>userName</jsdlj:userName>
<jsdlj:password>password</jsdlj:password>
171
|
|
|
|
</jsdlj:credential>
</jsdlj:j2ee>
</jsdl:application>
Definio de Tarefa - Tarefas de Banco de Dados
|
|
Esta seo descreve os atributos necessrios e opcionais para tarefas de banco de

dados. Cada definio de tarefa tem o seguinte formato e argumentos:
|
|
Tabela 29. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa de banco de
dados.
Atributo
Descrio/valor
Exigido
|
|
nome do
aplicativo
banco de dados
|
|
dbms
O tipo de banco de dados onde voc deseja que a

tarefa seja executada. Os valores suportados so:
db2
Para os bancos de dados DB2
|
|
mssql
Para os bancos de dados Microsoft SQL

Server
oracle
Para os bancos de dados Oracle
|
|
servidor
O nome do host do servidor onde o banco de dados

est localizado.
porta
O nmero da porta para a tarefa de banco de dados.
banco de dados
O nome do banco de dados do .
|
|
|
|
|
JDBC driver class O nome da classe do driver JDBC

name
Necessrio se
voc especificar
um banco de
dados
customizado.
|
|
|
|
|
JDBC connection
string
A sequncia que usada para conectar ao banco de

dados, contendo a URL do banco de dados, o nome
de usurio e a senha
Necessrio se
voc especificar
um banco de
dados
customizado.
|
|
|
|
|
|
JDBC jar class

path
Caminho para os arquivos jar do cliente de banco de

dados. Esse valor substitui o valor especificado no
arquivo de configurao
DatabaseJobExecutor.properties, se houver algum. Se
voc selecionar o banco de dados Microsoft SQL
Server, a verso 4 dos drivers JDBC necessria.
dbStatement
O nome da tarefa de banco de dados a ser executada.
|
|
userName
O nome de usurio para acessar o banco de dados.

Usurios do domnio no so suportados.
|
|
|
|
|
|
|
|
|
|
|
|
password
A senha para acessar o banco de dados. A senha

criptografada.
O exemplo a seguir mostra uma tarefa que executa uma consulta em um banco de
dados DB2:
$JOBS
AGENT#DATABASE
TASK
xmlns:jsdldatabase="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdldatabase" name="database">
<jsdl:application name="database">
172
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<jsdldatabase:database>
<jsdldatabase:sqlActionInfo>
<jsdldatabase:dbms>db2</jsdldatabase:dbms>
<jsdldatabase:server>localhost</jsdldatabase:server>
<jsdldatabase:port>50000</jsdldatabase:port>
<jsdldatabase:database>TWS32</jsdldatabase:database>
<jsdldatabase:statements>
<jsdldatabase:dbStatement>SELECT * FROM DWB.ARE_ABSTRACT_
RESOURCES</jsdldatabase:dbStatement>
</jsdldatabase:statements>
<jsdldatabase:credentials>
<jsdl:userName>userName</jsdl:userName>
</jsdldatabase:credentials>
</jsdldatabase:sqlActionInfo>
</jsdldatabase:database>
</jsdl:application>
DESCRIPTION "Definida usando o composer."
RECOVERY STOP
Definio de Tarefa - Tarefas MSSQL
|
|
Esta seo descreve os atributos necessrios e opcionais para tarefas MSSQL. Cada
definio de tarefa tem o seguinte formato e argumentos:
Tabela 30. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa MSSQL.
Atributo
Descrio/valor
Exigido
|
|
nome do
aplicativo
banco de dados
|
|
|
|
dbms
O tipo de banco de dados onde voc deseja que a

tarefa seja executada. Como essa tarefa especfica
do banco de dados Microsoft SQL Server, o nco
valor suportado mssql.
|
|
|
|
|
JDBC jar class

path
Caminho para os arquivos jar do cliente de banco de

dados. Esse valor substitui o valor especificado no
arquivo de configurao
DatabaseJobExecutor.properties, se houver algum. A
verso 4 dos drivers JDBC necessria.
|
|
servidor
O nome do host do servidor onde o banco de dados

est localizado.
porta
O nmero da porta para a tarefa de banco de dados.
banco de dados
O nome do banco de dados do .
|
|
dbStatement
A instruo SQL. Para separar instrues, use uma

linha vazia.
|
|
userName
O nome de usurio para acessar o banco de dados.

Usurios do domnio no so suportados.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
password
A senha para acessar o banco de dados. A senha

criptografada.
O exemplo a seguir mostra uma tarefa que executa uma tarefa em um banco de
dados MSSQL:
$JOBS
AGENT#MSSQLJOB
TASK
xmlns:jsdldatabase="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdldatabase" name="database">
<jsdl:application name="mssqljob">
<jsdldatabase:database>
<jsdldatabase:sqlActionInfo>
<jsdldatabase:dbms>mssql</jsdldatabase:dbms>
<jsdldatabase:server>localhost</jsdldatabase:server>
173
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<jsdldatabase:port>111</jsdldatabase:port>
<jsdldatabase:database>MYDATABASE</jsdldatabase:database>
<jsdldatabase:statements>
<jsdldatabase:dbStatement type="job">sada</jsdldatabase:dbStatement>
</jsdldatabase:statements>
<jsdldatabase:credentials>
<jsdl:userName>userName</jsdl:userName>
</jsdldatabase:credentials>
</jsdldatabase:sqlActionInfo>
</jsdldatabase:database>
</jsdl:application>
RECOVERY STOP
Definio de Tarefa - Tarefas Java
|
|
Esta seo descreve os atributos necessrios e opcionais para tarefas Java. Cada
Tabela 31. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa Java.
Atributo
Descrio/valor
|
|
nome do
aplicativo
java
|
|
|
|
jarPath
O diretrio no qual os arquivos jar esto

armazenados. Isso inclui todos os arquivos jar
armazenados no diretrio especificado e todos os
subdiretrios.
className
O nome da classe que a tarefa deve executar.
|
|
|
|
|
|
chave de
parmetro
Os parmetros a serem usados ao executar a classe

Java.
Exigido
U
Para obter informaes adicionais sobre como desenvolver uma tarefa Java,
consulte Tivoli Workload Automation: Developer's Guide: Extending Tivoli Workload
Automation.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir mostra uma tarefa que executa uma classe com nome
com.ibm.test.Test e parmetro failExecution:
Definio de Tarefa - Tarefas Executveis
|
|
Esta seo descreve os atributos necessrios e opcionais para tarefas executveis.

Cada definio de tarefa tem o seguinte formato e argumentos:
$JOBS
AGENT#JAVA
TASK
xmlns:jsdljava="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdljava" name="java">
<jsdl:application name="java">
<jsdljava:java>
<jsdljava:javaParms>
<jsdljava:jarPath>C:\JavaExecutors</jsdljava:jarPath>
<jsdljava:className>com.ibm.test.Test</jsdljava:className>
<jsdljava:parameters>
<jsdljava:parameter key="input">failExecution</jsdljava:parameter>
</jsdljava:parameters>
</jsdljava:javaParms>
</jsdljava:java>
</jsdl:application>
</jsdl:jobDefinition> DESCRIPTION "Definida usando o composer."
RECOVERY STOP
174
|
|
Tabela 32. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa Executvel.
Atributo
Descrio/valor
Exigido
|
|
nome do
aplicativo
executvel
|
|
|
interativo
Especifique se a tarefa requer interveno do usurio.

Essa opo se aplica somente a tarefas em execuo
em sistemas operacionais Windows.
|
|
valor
Especifique o nome e o valor de um ou mais

argumentos.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
script
Digite um script para ser executado pela tarefa. O

script criado e executado quando tarefa
executada. possvel especificar os argumentps nessa
tag ou possvel digit-los na tag value e cham-los
no script.
O exemplo a seguir mostra uma tarefa que efetua ping em dois Web sites. O
endereo dos Web sites definido na tag value e chamado na tag script. Essa
tarefa tem um relacionamento de afinidade com a tarefa affine_test, o que
significa que essa tarefa ser executada na mesma estao de trabalho que
affine_test:
$JOBS
AGENT#EXECUTABLE
TASK
xmlns:jsdle="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdle" name="executable">
<jsdle:executable interactive="false" workingDirectory="c:\">
<jsdle:arguments>
<jsdle:value>www.mysite.com</jsdle:value>
<jsdle:value>www.yoursite.com</jsdle:value>
</jsdle:arguments>
<jsdle:script>ping %1 ping %2</jsdle:script>
</jsdle:executable>
</jsdl:application>
TWSAFFINITY "affine_test"
RECOVERY STOP
Definio de Tarefa - Tarefas XA
|
|
Esta seo descreve os atributos necessrios e opcionais para tarefas XA. Cada
Tabela 33. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa XA.
Atributo
Descrio/valor
Exigido
|
|
nome do
aplicativo
xajob
|
|
|
accessMethod
O nome do mtodo de acesso usado para

comunicar-se com o sistema externo para iniciar a
tarefa e retornar o status da tarefa.
target
O nome de um arquivo de opes.
|
|
taskString
Comando a ser interpretado pelo mtodo

selecionado. The maximum line length is 8 KB.
175
|
|
Tabela 33. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa

XA. (continuao)
Atributo
step
Descrio/valor
Exigido
Os seguintes casos so aplicveis:
|
|
|
|
Para tarefas do SAP

O nome do processo uma cadeia do
processo da qual possvel realizar uma
execuo novamente.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Para outros tipos de tarefas

O nome de alias de tarefa fornecido ao
comando do criador para iniciar uma tarefa.
O exemplo a seguir mostra uma tarefa que cria um arquivo na pasta /methods
usando uma tarefa XA padro:
$JOBS
AGENT#XA_JOB
TASK
<jsdl:jobDefinition
xmlns:jsdlxa=
"http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdlxa"
name="xajob">
<jsdl:application name="xajob">
<jsdlxa:xajob accessMethod="unixlocl" target="optionFile">
<jsdlxa:taskString>touch file</jsdlxa:taskString>
<jsdlxa:credential>
<jsdlxa:userName>TestUser</jsdlxa:userName>
<jsdlxa:password>{aes}IEr/DES8wRzQEij1ySQBfUR587QBxM0iwfQ1EWJaDds=</jsdlxa:password>
</jsdlxa:credential>
</jsdlxa:xajob>
</jsdl:application>
RECOVERY STOP
Definio de tarefa - Tarefas JCL
|
|
|
|
|
Esta seo descreve os atributos necessrios e opcionais para tarefas JCL. Uma
tarefa JCL executa o comando especificado na tarefa JCL em um sistema JCL
(anteriormente conhecido como sistema operacional AS/400 e i5). Esse tipo de
tarefa executada apenas no Tivoli Workload Scheduler distribudo - Agente para
z/OS. Cada definio de tarefa tem o seguinte formato e argumentos:
Tabela 34. Atributos necessrios e opcionais para a definio de uma tarefa JCL.
Atributo
Descrio/valor
|
|
nome do
aplicativo
jcl
|
|
byDefinition
O tipo de envio de tarefa. Esta o nico tipo de

envio suportado.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
jclDefinition
A operao a ser executada no sistema JCL.
Exigido
U
O exemplo a seguir mostra uma tarefa que retorna o status do sistema JCL:
ZOSAGENT#JCLDEF
TASK
<jsdl:jobDefinition
xmlns:jsdl=="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdl"
xmlnss:jsdljcl="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdljcl">
<jsdl:application name="jcl">
<jsdljcl:jcl>
<jsdljcl:JCLParameters>
<jsdljcl:jcl>
<jsdljcl:byRefOrByDef>
176
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<jsdljcl:byDefinition>
<jsdljcl:jclDefinition>//NORMAL JOB ,TWS
JOB,CLASS=A,MSGCLASS=A,>
// MSGLEVEL=(1,1)
//*
//STEP1 EXEC PGM=IEFBR14</jsdljcl:jclDefinition>
</jsdljcl:byDefinition>
</jsdljcl:byRefOrByDef>
</jsdljcl:jcl>
</jsdljcl:JCLParameters>
<jsdljcl:JOBParameters>
<jsdljcl:jobStreamName>${tws.jobstream.name}jsdljcl:jobStreamName>${tws.jobstream.name}>
<jsdljcl:inputArrival>${tws.job.ia}jsdljcl:inputArrival>${tws.job.ia}>
</jsdljcl:JOBParameters>
</jsdljcl:jcl>
</jsdl:application>
DESCRIPTION "Sample JCL Job Definition"
Definio de Tarefa - Tarefas do IBM i
|
|
|
|
Esta seo descreve os atributos necessrios e opcionais para tarefas do IBM i. Uma
tarefa IBM i executa o comando especificado na guia IBM i em um sistema IBM i
(anteriormente conhecido como sistema operacional AS/400 e i5). Cada definio
de tarefa tem o seguinte formato e argumentos:
Tabela 35. Atributos Obrigatrios e Opcionais para a Definio de uma Tarefa do IBM i.
Atributo
Descrio/valor
Exigido
|
|
nome do
aplicativo
ibmi
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
comando
O comando a ser executado no sistema IBM i.
O exemplo a seguir mostra uma tarefa que retorna o status do sistema IBM i:
$JOBS
AGENT#IBM_I
TASK
xmlns:jsdlibmi="http://www.ibm.com/xmlns/prod/scheduling/1.0/jsdlibmi"
name="ibmi">
<jsdl:application name="ibmi">
<jsdlibmi:ibmi>
<jsdlibmi:IBMIParameters>
<jsdlibmi:Task>
<jsdlibmi:command>wrksyssts</jsdlibmi:command>
</jsdlibmi:Task>
</jsdlibmi:IBMIParameters>
</jsdlibmi:ibmi>
</jsdl:application>
RECOVERY STOP
Utilizando Variveis e Parmetros nas Definies de Tarefa

Uma varivel um objeto de planejamento que faz parte de uma tabela de
varivel e definido no banco de dados Tivoli Workload Scheduler. Ela pode ser
utilizada por todos os agentes no domnio contanto que os usurios tenham
autorizao apropriada no arquivo de segurana.
Um parmetro definido e utilizado localmente em um agente (com o comando
do utilitrio parms).
Variveis e parmetros possuem os seguintes usos e limitaes nas definies de
tarefa:
v Variveis e parmetros tm permisso nos valores para as palavras-chave
streamlogon, scriptname, docommand e abendprompt.
177
v Uma varivel ou parmetro pode ser utilizado como uma cadeia inteira ou como
parte dela.
v Vrias variveis e parmetros tm permisso em um nico campo.
v Coloque os nomes de variveis entre sinais de intercalao (^) e coloque a cadeia
inteira entre aspas. Assegure-se de que os caracteres de acento circunflexo no
sejam precedidos por uma barra invertida na cadeia. Se necessrio, inclua a
barra invertida na definio da varivel ou parmetro.
v Coloque os nomes de parmetros entre aspas simples (') no UNIX e coloque a
cadeia inteira entre aspas.
v Consulte Definio do parmetro do banco de dados na pgina 185 para obter
informaes adicionais e exemplos.
No exemplo a seguir, uma varivel denominada mis utilizada no valor
streamlogon:
$jobs
cpu1#bkup
scriptname "/usr/mis/scripts/bkup"
streamlogon "^mis^"
recovery continue after recjob1
Para obter outros exemplos, consulte Definio do parmetro do banco de dados

na pgina 185.
|
Planejamento em IBM i
|
|
Durante o planejamento de tarefas no IBM i, observe que o comando nativo pode:

v Ser um sistema ou um comando de usurio.
v Consistir em um comando de sistema SBMJOB, que ativa uma tarefa em lote.
|
|
|
v Iniciar uma ou mais tarefas em lote. O Monitor do Agente pode monitorar um

mximo de 130 tarefas em lote.
|
|
|
As tarefas em lote podem ser monitoradas apenas se elas forem iniciadas pelo
comando nativo, e o nmero mximo de tarefas que o agente IBM i pode
monitorar 130.
O log da tarefa do agente e a varivel de ambiente TWSASPOOLS:
|
|
|
|
|
Por padro, todas as informaes sobre a execuo de tarefas so armazenadas no

log da tarefa do agente. A maioria dessas informaes normalmente consiste em
arquivos de spool. Para selecionar os tipos de arquivo de spool que deseja incluir
no log da tarefa do agente, use a varivel de sistema TWSASPOOLS que funciona
no nvel do agente no IBM i para qualquer tarefa a ser enviada.
|
|
Esta opo fora o agente IBM i a ignorar todos os arquivos de spool ou incluir um
ou mais deles.
|
|
|
No agente IBM i, crie uma nova varivel de ambiente de nvel de sistema chamada
TWSASPOOLS e configure-a para uma lista de tipos de arquivos de spool que
devem ser includos. A lista deve iniciar com o token SPOOLS:.
|
|
|
Por exemplo, para forar o agente IBM i a ignorar todos os arquivos de spool, crie
a varivel TWSASPOOLS da seguinte forma.
|
|
em que a lista aps o token SPOOL: est vazia. Nesse caso, qualquer relatrio do
log da tarefa do agente para o agente IBM i limitado ao relatrio de atividade
ADDENVVAR ENVVAR(TWSASPOOLS) VALUE(SPOOLS:) LEVEL(*SYS)
178
|
|
|
que o Agent Monitor produz para rastrear sua ao de envio e monitoramento, e

ao log da tarefa do IBM i do Agent Monitor, que sempre includo no final do log
da tarefa do agente.
|
|
|
|
|
|
Para permitir que o agente IBM i inclua apenas os tipos de arquivos de spool
QPRINT e QPJOBLOG, ou seja, todos os arquivos de spool produzidos pelas
instrues printf dentro de qualquer programa ILE-C e todos os logs de tarefa
produzidos, crie a TWSASPOOLS da seguinte forma:
|
|
|
Se a varivel TWSASPOOLS j existir, altere-a da seguinte forma:
|
|
|
|
Se qualquer parmetro VALUE for configurado para uma sequncia incorreta, o

agente IBM i ignora a opo da varivel de ambiente TWSASPOOLS. possvel
criar e alterar a varivel de ambiente TWSASPOOLS com o agente IBM i ativo,
mas nenhuma atividade de carga de trabalho deve estar em execuo.
A recuperao do cdigo de retorno do agente:
|
|
|
|
|
|
O modelo de programao IBM i foi originalmente baseado em um modelo de

orientao de objeto anterior no qual os programas se comunicavam atravs da
passagem de mensagens, em vez de usar cdigos de retorno. A introduo do
modelo Integrated Language Programming (ILE) leva a definies de reas comuns
para dados de troca como cdigos de retorno no mesmo ambiente de tarefa: os
cdigos de retorno do usurio e os cdigos finais do sistema.
|
|
Para obter informaes sobre os cdigos de retorno do usurio, consulte

Controlando o Ambiente de Tarefa com o Cdigo de Retorno do Usurio.
|
|
|
|
|
|
|
|
|
|
|
Quando o agente IBM i verifica se um comando foi enviado ou uma tarefa foi
concluda, ele designa um cdigo de retorno tarefa com base no status de tarefa
da tarefa concluda. O cdigo de retorno configurado dependendo da mensagem
de concluso do comando ou da tarefa. Se o comando ou a tarefa for concludo(a)
com xito, o cdigo de retorno ser configurado como zero. Se o comando ou a
tarefa no for concludo(a) com xito, o cdigo de retorno ser configurado com o
valor da gravidade da mensagem relacionada exceo que causou o trmino
anormal da tarefa. O agente IBM i tambm pode configurar o cdigo de retorno
com o valor do cdigo de retorno do usurio quando ele for retornado pelo
comando enviado. Se for recuperado, o cdigo de retorno do usurio ser usado
como o valor para configurar o cdigo de retorno.
|
|
|
|
|
O valor de cdigo de retorno designado tarefa includo no log de tarefas do

agente IBM i para a tarefa e enviado de volta interface com o usurio do
respectivo planejador (interface com o usurio da WEB ou painis ISPF z/OS)
como cdigo de retorno, por motivo de compatibilidade com agentes em outros
sistemas operacionais.
Controlando o Ambiente de Tarefa com o Cdigo de Retorno do Usurio:
|
|
Com a introduo do modelo IBM i ILE, possvel recuperar um valor retornado

por um programa chamado dentro da mesma tarefa.
ADDENVVAR ENVVAR(TWSASPOOLS) VALUE('SPOOLS: QPRINT QPJOBLOG')

LEVEL(*SYS)
CHGENVVAR ENVVAR(TWSASPOOLS)
VALUE('SPOOLS: QPRINT QPJOBLOG') LEVEL(*SYS)
179
|
|
|
Quando o Agent Monitor verifica se um comando enviado foi concludo, ele

recupera os seguintes cdigos de trmino da tarefa usando uma interface de
programao de aplicativos do Sistema IBM i:
|
|
|
|
|
O cdigo de status de trmino ou <Status> (0 se for bem-sucedido)

Ele indica se o sistema emitiu um cancelamento controlado da tarefa. Os
valores possveis so 1 (o subsistema ou a prpria tarefa foi cancelado(a)),
0 (o subsistema ou a prpria tarefa no foi cancelado(a)), em branco (a
tarefa no est em execuo).
|
|
|
|
|
Cdigo de retorno do programa ou <Prc> (0000 se for bem-sucedido)

Ele especifica o cdigo de concluso do ltimo programa (como um
programa utilitrio de arquivo de dados ou um programa RPG ou COBOL,
chamado pela tarefa). Se a tarefa no incluir programa, o cdigo de retorno
do programa ser 0.
|
|
|
|
|
|
Cdigo de retorno do usurio ou <Urc> (0000 se for bem-sucedido)

Ele especifica o cdigo de retorno definido pelo usurio configurado por
construes de linguagem de alto nvel ILE. Por exemplo, o cdigo de
retorno de um programa escrito em linguagem C. Ele representa o cdigo
de retorno mais recente configurado por algum encadeamento dentro da
tarefa.
|
|
|
Se o comando enviado for uma chamada para um programa ILE do usurio

retornando um valor na sada, este valor est localizado no cdigo de trmino da
tarefa Urc.
|
|
|
|
|
|
|
|
possvel decidir como controlar o ambiente da tarefa de suas tarefas enviadas

preparando os comandos para serem enviados como CALLs para seus programas
ILE, em que o fluxo interno controlado e o status de trmino decidido por meio
de valores de sada adequados. Se um programa do usurio terminar com erro
para um controle de fluxo incorreto, sem retornar um valor, o Agent Monitor no
configura o Cdigo de Retorno como cdigo de retorno do usurio (Urc), mas
segue os critrios descritos em A recuperao do cdigo de retorno do agente na
pgina 179.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir mostra um programa do usurio C ILE em que duas tarefas

em lote so ativadas e um valor igual a 10 retornado ao responsvel pela
chamada, independentemente do status de concluso das tarefas em lote.
Mtodo Alternativo para Configurar o Cdigo de Retorno do Usurio:
|
|
|
Em alguns ambientes IBM i, a interface de programao de aplicativos do sistema

recuperando o cdigo de retorno do usurio (Urc) do cdigo do Agent Monitor
no recupera o valor correto para Urc. Assim no recomendado o uso das APIs
=========================================================================
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
void main(int argc, char *argv[])
{
int
EnvVarRC=0;
printf("issuing SBMJOB CMD(CALL MYLIB/DIVBY0)...\n");
system("SBMJOB CMD(CALL MYLIB/DIVBY0)");
printf("issuing SBMJOB CMD(WRKACTJOB OUTPUT(*PRINT))...\n");
system("SBMJOB CMD(WRKACTJOB OUTPUT(*PRINT)) LOG(4 0 *SECLVL)");
exit(10);
return;
}
=========================================================================
180
|
|
|
do sistema IBM i para recuperar o cdigo de retorno do usurio. Para receber um

valor retornado por um programa chamado, melhor fornecer, em vez disso, um
parmetro para receber o valor.
|
|
|
|
|
|
|
|
|
|
|
Mesmo que o Agent Monitor possa recuperar o cdigo de retorno do usurio

usando a interface de programao de aplicativos do sistema, um mtodo de
recuperao alternativo do cdigo de retorno do usurio foi implementado no
cdigo do Agent Monitor, com a seguinte lgica: uma varivel de ambiente da
tarefa criada, chamada USERRC, e configurada com o valor INI antes de enviar o
comando de usurio. Quando o comando termina, ele recupera seu cdigo de
retorno do usurio usando as APIs do sistema, como usual, mas tambm verifica
se a varivel de ambiente da tarefa USERRC foi atualizada no nvel do programa
do usurio. Se um valor diferente de INI for localizado, isso considerado como o
cdigo de retorno do usurio e o valor recuperado usando as APIs do sistema
ignorado. Isso significa que o programa do usurio modificou o valor de USERRC.
|
|
|
|
A modificao de USERRC no nvel do programa do usurio simplesmente exige a

mudana do valor de USERRC antes da sada do cdigo do usurio do aplicativo.
No caso do C ILE possvel fazer isso com uma instruo putenv, em que o cdigo
de retorno do usurio configurado para ser retornado.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
O exemplo a seguir mostra como o cdigo do usurio retorna o cdigo de retorno

do usurio usando a varivel de ambiente USERRC do ambiente da tarefa
reservada do agente IBM i. Esse cdigo foi obtido do cdigo do exemplo em
Controlando o Ambiente de Tarefa com o Cdigo de Retorno do Usurio na
pgina 179 pela substituio de exit com a instruo putenv.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cdigos de Retorno
=========================================================================
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
void main(int argc, char *argv[])
{
int
EnvVarRC=0;
printf("issuing SBMJOB CMD(CALL MYLIB/DIVBY0)...\n");
system("SBMJOB CMD(CALL MYLIB/DIVBY0)");
printf("issuing SBMJOB CMD(WRKACTJOB OUTPUT(*PRINT))...\n");
system("SBMJOB CMD(WRKACTJOB OUTPUT(*PRINT)) LOG(4 0 *SECLVL)");
EnvVarRC = putenv("USERRC=10");
return;
}
=========================================================================
A seguir h uma lista dos cdigos de retorno para tarefas de banco de dados,
tarefas Java, tarefas de servios da Web e tarefas IBM i.
Tarefas de Banco de Dados:
RC = 0 -> A tarefa foi concluda com sucesso
RC = -1 -> Uma instruo SQL foi executada com um cdigo de sada
diferente de 1
RC = -2 -> Erro de Tarefa MSSQL
RC = -3 -> Uma instruo SQL no foi executada por causa de um
erro na instruo
Tarefas Java:
RC = -1 -> O aplicativo Java ativado pela tarefa falhou devido a
uma exceo
181
|
|
|
|
|
|
|
|
|
Tarefas de servios da Web:

RC = -1 -> O nome do host do servidor contido na URL de Servio da
Web desconhecido
RC = -2 -> Erro de inovao de Servio da Web
|
|
Quando o cdigo de retorno do usurio recuperado, o IBM i Agent Monitor

designa uma prioridade a ele.
Tarefas IBM i:
Cdigo de retorno = cdigo de retorno do usurio quando recuperado
Cdigo de retorno = 0 -> tarefa concluda com xito
Cdigo de retorno > 0 -> tarefa concluda com xito
definio de usurio do Windows

Os nomes de usurio utilizados como o valor streamlogon para as definies de
job do Windows devem ter definies de usurio. Isto no necessrio para
usurios que executam jobs em outros sistemas operacionais. Cada definio de
usurio tem o seguinte formato e argumentos:
Sintaxe
username[workstation#][domain\]username
password passwordend
[username ...]
Argumentos
username [workstation#]username
Especifica o nome de um usurio Windows.
estao de trabalho
Especifica a estao de trabalho na qual o usurio tem permisso
para lanar jobs. O sinal de libra necessrio. O padro em
branco, significando todas as estaes de trabalho.
[domain\]username
Especifica o domnio do Windows do usurio e o nome do usurio.
Nota: Os nomes de usurios Windows fazem distino entre
maisculas e minsculas. Alm disso, o usurio deve poder
efetuar logon logon na estao de trabalho na qual o Tivoli
Workload Scheduler ativa tarefas e ter permisso para
Efetuar Logon como Batch.
O nome do domnio pode conter at 16 caracteres (incluindo a
barra invertida) e o nome do usurio pode conter at 31 caracteres.
Se o nome no for exclusivo no Windows, ele ser considerado um
usurio local, um usurio de domnio ou um usurio de domnio
confivel, nessa ordem.
password
Especifica a senha do usurio. A senha pode conter at 31 caracteres e deve
estar entre aspas. Para indicar uma senha nula, utilize duas aspas duplas
consecutivas sem espaos em branco entre elas, . Quando uma definio
de usurio tiver sido compilada, no possvel ler a senha. Usurios com
privilgios de segurana apropriados podem modificar ou excluir um
usurio, mas as informaes de senha nunca so exibidas.
182
Exemplos
O exemplo a seguir define quatro usurios:
username joe
password "okidoki"
fim
#
username server#jane
password "okitay"
fim
#
username dom1\jane
password "righto"
fim
#
username jack
password ""
fim
Consulte tambm
Para criar uma definio de usurio do Windows no Tivoli Dynamic Workload
Console:
em NovoUsurio do Windows
4. Especifique suas opes no painel Propriedades - Usurio do Windows.
Utilizando as Definies user e streamlogon do Tivoli Workload

Scheduler
No Windows, as definies de usurio so especificadas utilizando o composer no
formato [workstation#]username. A instncia [workstation#]username identifica
exclusivamente o usurio Windows no ambiente Tivoli Workload Scheduler. O
nome da estao de trabalho opcional; sua ausncia indica que o usurio
denominado username est definido em todas as estaes de trabalho com o
Windows na rede do Tivoli Workload Scheduler. Se o usurio denominado
username estiver definido somente em algumas estaes de trabalho Windows na
rede do Tivoli Workload Scheduler, para evitar inconsistncias, voc deve criar
uma definio de usurio [workstation#]username para cada estao de trabalho em
execuo no Windows onde o usurio username est definido.
|
|
|
|
|
Se voc planejar uma tarefa em um agente dinmico, em um conjunto ou um

conjunto dinmico, a tarefa executada com o usurio definido no conjunto ou
conjunto dinmico. No entanto, o usurio do Windows deve existir em todas as
estaes de trabalho no conjunto ou no conjunto dinmico onde voc planeja
executar a tarefa.
Ao definir uma tarefa usando o composer, voc deve especificar uma estao de
trabalho e um logon de usurio vlido para a estao de trabalho. O logon
apenas um nome de usurio vlido para o Windows, sem o nome da estao de
trabalho. Por exemplo, na seguinte definio de tarefa:
$JOB
workstation#job01 docommand "dir"
183
o valor para streamlogon username e no workstation#username.

Entretanto, quando voc utilizar o comando altpass, utilize a definio de usurio
no formato
workstation#username
Para esse comando, possvel omitir o nome da estao de trabalho apenas

quando alterar a senha da estao de trabalho a partir da qual o comando est
sendo executado.
Usurio de Domnio Confivel

Se o Tivoli Workload Scheduler for ativar tarefas para um usurio de domnio
confivel, siga as orientaes ao definir as contas de usurio. Pressupondo que o
Tivoli Workload Scheduler esteja instalado em Domain1 para a conta de usurio
maestro e a conta de usurio sue em Domain2 precise ativar uma tarefa, o seguinte
deve ser verdadeiro:
v Deve haver confiana mtua entre Domain1 e Domain2.
v No Domain1 nos computadores onde os jobs so lanados, sue deve ter o direito
para efetuar logon como batch.
v No Domain1, maestro deve ser um usurio de domnio.
v Nos controladores de domnio no Domain2, maestro deve ter o direito para
Acessar este computador a partir da rede.
Definio do calendrio
Um calendrio uma lista de datas que definem se e quando um fluxo de tarefas
executado. Cada definio de calendrio tem o seguinte formato e argumentos:
Sintaxe
$calendar
calendarname [description]
date [...]
[calendarname ...]
Argumentos
calendarname
Especifica o nome do calendrio. O nome pode conter at oito caracteres
alfanumricos, incluindo traos (-) e sublinhados (_) e deve iniciar com
uma letra.
description
Fornece uma descrio do calendrio. Ela deve ser colocada entre aspas
duplas. Pode conter caracteres alfanumricos, contanto que inicie com uma
letra. E pode conter os seguintes caracteres: vrgula (,), ponto (.), trao (-),
mais (+), aspas simples (') e igual (=). Ela no pode conter aspas duplas (")
que no sejam as de fechamento, dois-pontos (:), ponto-e-vrgula (;) e e
comercial (&).
date [...]
Especifica uma ou mais datas, separadas por espaos. O formato
mm/dd/aa.
184
Exemplos
O exemplo a seguir define trs calendrios chamados monthend, paydays e
holidays:
$calendar
monthend "Month
01/31/2005
paydays
01/15/2005
03/15/2005
05/14/2005
feriados
01/01/2005
end dates 1st half 2005"

02/28/2005 03/31/2005 04/30/2005 05/31/2005 06/30/2005
02/15/2005
04/15/2005
06/15/2005
02/15/2005 05/31/2005
Consulte tambm
Para criar uma definio de calendrio no Tivoli Dynamic Workload Console:
em NovoCalendrio
4. Especifique suas opes no painel Propriedades - Calendrio.
Definio do parmetro do banco de dados

Parmetros so objetos aos quais voc designa valores diferentes.
Parmetros so teis quando voc tem valores que mudam dependendo dos seus
fluxos de tarefas e tarefas. Definies de tarefa e fluxos de tarefas que utilizam
parmetros so atualizadas automaticamente no incio do ciclo de produo.
Utilize parmetros como substitutos para valores repetitivos ao definir tarefas e
fluxos de tarefas. Por exemplo, o uso de parmetros para logon de usurio e
nomes de arquivo de script em definies de tarefa e para dependncias de
arquivo e aviso permite o uso de valores que podem ser mantidos centralmente no
banco de dados no principal.
While variables are scheduling objects that are defined in the Tivoli Workload
Scheduler database and can be used by any authorized users in the domain,
parameters are defined and used locally on individual agents.
As sees a seguir descrevem os procedimentos de migrao.
Variveis
Esses so os parmetros definidos como objetos de planejamento no banco de
dados. Variables utilizando o seguinte comando:
$parm
[tablename.]variablename variablevalue
...
onde:
185
tablename
O nome da tabela de variveis para conter a nova varivel. A tabela de
variveis j deve estar definida. Se voc no especificar um nome de tabela
de variveis, a varivel ser includa na tabela padro.
variablename
O nome da varivel. O nome pode conter at 16 caracteres alfanumricos,
incluindo traos (-) e sublinhados (_), e deve iniciar com uma letra.
valor
Especifica o valor atribudo ao parmetro. No inclua os nomes de outras

variveis.
However, the recommended way to define variables is to use a Definio da

Tabela de Variveis na pgina 189. Em qualquer caso, todas as variveis so
inseridas em uma tabela de variveis. Se voc definir uma varivel e no
especificar o nome de uma tabela de variveis, esse nome ser includo na tabela
de variveis padro.
As variveis podem ser utilizadas nas definies de tarefas e de fluxos de tarefas
para especificar as palavras-chave scriptname, docommand, opens, streamlogon,
prompt e abendprompt. Tambm so resolvidas, ou seja, substitudas por seu valor
designado, quando o plano de produo gerado ou estendido, ou quando voc
enviar uma tarefa ou fluxo de tarefas. Quando voc utilizar essas variveis,
especifique-as no formato variablename e coloque-as entre acentos circunflexos ^^.
Para obter detalhes sobre a resoluo de variveis, consulte Resoluo de
Varivel na pgina 112.
Com esse comando, possvel utilizar a substituio de variveis para as seguintes
palavras-chave:
v abendprompt
v opens
v prompt
The variable names specified in these definitions are first resolved against variable
table definitions and then on local parameters if the variables are not found.
Ao utilizar uma varivel, coloque-a entre acentos circunflexos (^) e a cadeia
completa entre aspas.
Se a varivel contiver uma parte de um caminho, certifique-se de que os caracteres
acento circunflexo no sejam imediatamente precedidos por uma barra invertida
(\), pois nesse caso, a seqncia \^ poderia ser interpretada erroneamente como
uma seqncia de escape e resolvida pelo analisador como caractere acento
circunflexo. Se necessrio, mova a barra invertida para a definio da varivel
entre carets para evitar uma interpretao incorreta da barra invertida. Por
exemplo, a tabela a seguir mostra a maneira certa para definir e utilizar uma
varivel chamada MYDIR na tabela de variveis padro:
186
Tabela 36. Como manipular uma barra invertida em substituio de varivel.

Errado
Certo
1. Defina a varivel MYDIR como:
1. Defina a varivel MYDIR como:
$PARM
MYDIR "scripts"
$PARM
MYDIR "\scripts"
2. Utilize-a desta maneira:
2. Utilize-a desta maneira:
job01 scriptname
"c:\operid\^MYDIR^\test.cmd"
job01 scriptname
"c:\operid^MYDIR^\test.cmd"
Isso verdadeiro para todos os comandos de linha de comandos, interfaces

grficas com o usurio e APIs por meio das quais voc utiliza substituio de
varivel.
Executar Como
Os parmetros locais so definidos em um banco de dados local na estao de
trabalho em que as tarefas que os utilizam sero executadas. Para defini-los, voc
no utiliza esse comando composer mas o comando do utilitrio parms na
pgina 466.
Parmetros locais podem ser utilizados em:
v JCL
v Logon
v Dependncias de avisos
v Dependncias de arquivos
v Prompts de recuperao
Um parmetro local definido nessas palavras-chave ou a partir do script de tarefa
chamado utilizando a seguinte sintaxe:
bin\parms PARAMETERNAME
Os parmetros locais so resolvidos utilizando as definies armazenadas no banco

de dados PARMS local da seguinte forma:
v No tempo de execuo, na estao de trabalho onde ocorre o processamento da
tarefa.
v No tempo de envio, na estao de trabalho na qual a tarefa ou o fluxo de tarefas
enviado a partir da linha de comandos conman. A Tabela 37 resume em que
palavra-chave do comando submit possvel utilizar parmetros.
Tabela 37. Palavras-chave que podem utilizar parmetros locais em comandos submit
Palavra-chave
abendprompt
submit
docommand
(comando sbd)
submit file
(comando sbf)
submit job
(comando sbj)
scriptname
submit job
stream (sbs
command)
docommand
logon
opens
prompt
187
Para obter informaes adicionais sobre como enviar tarefas e fluxos de tarefas
na produo a partir da linha de comandos conman, consulte o Captulo 10,
Gerenciando Objetos no Plano - conman, na pgina 307.
Ao definir uma tarefa ou fluxo de tarefas no banco de dados, voc deve delimitar a
cadeia
path/parms parametername
entre caracteres ' ' para garantir que o parmetro resolvido em tempo de
execuo na estao de trabalho mesmo se um parmetro com o mesmo nome
estiver definido como um parmetro global no banco de dados Tivoli Workload
Scheduler. Por exemplo, se voc incluir no banco de dados a seguinte definio de
tarefa:
$jobs
myjob
docommand "ls ^MYDIR^"
streamlogon "^MYUSER^"
e dois parmetros denominados MYDIR e MYUSER so definidos no banco de dados;

em seguida, medida que o plano de produo criado ou estendido, os dois
parmetros so resolvidos utilizando as definies contidas no banco de dados e
seus valores correspondentes so transportados com o arquivo Symphony. Se voc
definir myjob no banco de dados da seguinte forma:
$jobs
myjob
docommand "ls bin/parms MYDIR"
streamlogon "bin/parms MYUSER"
ento, medida que o plano de produo criado ou estendido, a nica ao que

executada nos dois parmetros na definio de myjob a remoo dos caracteres '
', os parmetros so transmitidos no arquivo Symphony no resolvidos e, em
seguida, so resolvidos no tempo de execuo localmente na estao de trabalho de
destino, utilizando o valor armazenado no banco de dados PARMS.
Exemplos
Dois paramentros, glpah and gllogon, so definidos como a seguir:
$parm
glpath
gllogon
"/glfiles/daily"
"gluser"
Os parmetros glpath e gllogon so utilizados no job gljob2 do fluxo de job

glsched:
schedule glsched on weekdays
:
gljob2
scriptname "/usr/gl^glpath^"
streamlogon "^gllogon^"
opens "^glpath^/datafile"
prompt ":^glpath^ started by ^gllogon^"
fim
Um exemplo de uma varivel utilizada com a palavra-chave docommand :

docommand "ls ^MY_HOME^"
188
Criando uma Definio de Varivel Usando o Dynamic Workload

Console
Para criar uma definio de varivel no Dynamic Workload Console , voc deve
inclu-la em uma definio de tabela de varivel:
3. Abra no modo de edio uma tabela de varivel existente a partir da rea de
janela Abertura Rpida ou crie uma nova tabela de varivel, conforme descrito
em Criando uma Definio de Tabela de Varivel Usando o Dynamic
Workload Console na pgina 191
4. No painel Propriedades - Tabela de Varivel, clique na guia Variveis e inclua
novas definies de variveis clicando no cone "+" (Incluir) e especificando
nomes e valores de variveis
Definio da Tabela de Variveis

Uma tabela de variveis um objeto que agrupa vrias variveis. Todos os
parmetros globais (agora denominados variveis) que voc utiliza no planejamento
da carga de trabalho esto contidos em pelo menos uma tabela de variveis. As
seguintes opes esto disponveis:
v Defini-las quando definir uma tabela de variveis da maneira descrita aqui. Este
o valor padro.
v Defini-las individualmente com o comando composer $parm no formato
[tablename.]variablename variablevalue . Se voc no especificar um nome de
tabela, a nova varivel ser colocada na tabela de variveis padro.
Voc no forado a criar tabelas de variveis para poder criar e utilizar variveis.
possvel nunca criar uma tabela e nunca utilizar uma explicitamente. Mas o
planejador vem com uma padro e sempre que voc cria ou gerencia uma varivel
sem denominar a tabela, ele a armazena ou procura por ela l.
Porm, possvel definir mais de uma varivel com o mesmo nome, mas valor
diferente, e coloc-las em tabelas diferentes. Utilizando as tabelas de variveis,
voc designa valores diferentes para a mesma varivel e, dessa forma, reutiliza a
mesma varivel em definies de tarefas e ao definir dependncias de aviso e de
arquivo. Tabelas de variveis podem ser designadas no ciclo de execuo, fluxo de
tarefas e nvel da estao de trabalho.
As tabelas de variveis podem ser particularmente teis em definies de tarefas
quando uma definio de tarefa utilizada como um modelo para uma tarefa que
pertence a mais de um fluxo de tarefas. Por exemplo, possvel designar valores
fluxos de tarefas diferentes.
Sintaxe
vartable tablename
[isdefault]
members
[variablename variablevalue]
189
...
end
Argumentos
vartable tablename
O nome da tabela de varivel. O nome deve iniciar com uma letra e pode
conter caracteres alfanumricos, traos e sublinhados. Ela pode conter at 80
caracteres.
description tabledescription
A descrio da tabela de variveis. O texto deve ser colocado entre aspas
duplas. A descrio pode conter at 120 caracteres alfanumricos. Ela no pode
conter aspas duplas (") que no sejam as de fechamento, dois-pontos (:),
ponto-e-vrgula (;) e e comercial (&).
isdefault
Quando especificada, a tabela a tabela padro. Voc no pode marcar mais
de uma tabela como tabela padro. Quando voc marca uma tabela de
variveis como a tabela padro, a tabela de variveis atual no mais a tabela
padro. Ao migrar o banco de dados de uma verso anterior, o produto cria a
tabela de variveis padro com todas as variveis j definidas.
members variablename variablevalue
A lista de variveis e seus valores separados por espaos. Os valores devem
estar entre aspas duplas.
Exemplo
O exemplo a seguir mostra uma tabela de variveis e seu contedo.
VARTABLE TEST1
MEMBERS
DEVBATCH "DOMD\IMSBATCH\SAME"
PARAM_01 "date"
PARAM_02 "root"
PARM_01 "PARM_001"
PRPT_02 "PARM_002"
PRPT_03 "PARM_003"
PRPT_04 "PARM_004"
PRPT_05 "PARM_005"
SAME17 "test/for/variable with samename > variable/table"
SLAV10 "/nfsdir/billingprod/crmb/MAESTRO_JOB/AG82STGGDWHSCART"
SLAV11 "/nfsdir/billingprod/crmb/MAESTRO_JOB/AG82CDMGALLBCV"
SLAV12 "/nfsdir/billingprod/crmb/MAESTRO_JOB/AG82CDMGRISCTRAF"
SLAV13 "/opt/crm/DWH_OK/Businness_Copy_ok"
SLAV14 "/opt/crm/DWH_OK/DW_Canc_Cust_Gior_ok_"
TRIGGER "/usr/local/samejobtriggers"
VFILE2 "testforvarwithsamename2.sh"
VUSER2 "same_user2"
WRAPPER "/usr/local/sbin/same/phi_job.ksh"
END
Consideraes do Arquivo de Segurana

Do ponto de vista das autorizaes do arquivo de segurana, a permisso para agir
nas entradas de varivel contidas em uma tabela depende da permisso geral
concedida na tabela, como mostrado a seguir.
190
Tabela 38. Palavra-chave de Acesso Necessrias em Tabela de Varivel o Arquivo de

Segurana (Objeto vartable) e Aes Permitidas.
Palavra-chave obrigatria de acesso ao arquivo
de segurana na tabela de variveis includa
Ao permitida nas entradas de

varivel listadas
Incluir
Modificar
Excluir
Modificar
Renomear
Exibir
Exibir
Desbloquear
Desbloquear
Criando uma Definio de Tabela de Varivel Usando o Dynamic

Workload Console
Para criar uma nova definio de tabela de variveis, execute:
3. In the Working List toolbar of the pop-up window that opens, click
NewVariable Table
4. Isso exibe a tarefa no painel Propriedades - Definio de Tarefa.
Definio do Prompt
Um aviso identifica uma mensagem textual que exibida para o operador e pra o
processamento da tarefa ou do fluxo de tarefas at que uma resposta afirmativa
seja recebida (manualmente do operador ou automaticamente por uma ao da
regra de evento). Aps o aviso ser respondido, o processamento continua. Os
prompts podem ser utilizados como dependncias em jobs e fluxos de job.
possvel utilizar variveis em prompts.
Existem dois tipos de prompts:
prompts locais ou no denominados
Um prompt no denominado um prompt definido em uma definio de
tarefa ou de fluxo de tarefas utilizando a apalavra-chave prompt, no tem
nenhum nome designado e no est definido como um objeto de
planejamento no banco de dados, portanto, no pode ser utilizado por
outras tarefas ou fluxos de tarefas.
prompts globais ou denominados
Um prompt global definido no banco de dados como um objeto de
planejamento, ele identificado por um nome exclusivo e pode ser
utilizado por qualquer tarefa ou fluxo de tarefa. As variveis em prompts
globais so determinadas sempre utilizando a tabela de variveis padro.
Isso ocorre porque o prompt global utilizado por todas as tarefas e fluxos
de tarefas, portanto, apenas um valor deve ser utilizado para a resoluo
da varivel.
Esta seo descreve prompts globais. Para obter informaes adicionais sobre
prompts locais, consulte Tarefa na pgina 646 e Definio de fluxo de tarefas
na pgina 194.
191
Nota: As definies de prompt predefinido ou global so reconfiguradas toda vez

que a tarefa JnextPlan executada.
Sintaxe
$prompt
promptname [: | !]text
[promptname ...]
Argumentos
promptname
Especifica o nome do prompt. O nome pode conter at oito caracteres
uma letra.
text
Fornece o texto do prompt. Baseado no caractere que antecede o texto, o
prompt pode se comportar de maneira diferente.
v Se o texto comear com dois pontos (:), o prompt ser exibido, mas no
ser necessria nenhuma resposta para continuar o processamento.
v Se o texto comear com um ponto de exclamao (!), o prompt ser
exibido, mas no ser gravado no arquivo de log.
possvel utilizar um ou mais parmetros como toda a cadeia de texto ou
parte dela para um prompt. No caso de utilizar um parmetro, a cadeia de
parmetros dever ser colocada entre acentos circunflexos (^). Consulte
Definio do parmetro do banco de dados na pgina 185 para obter um
exemplo.
Nota: Em prompts locais, os circunflexos (^) que no identificam um
parmetro devem ser precedidos por uma barra invertida (\) para
evitar que causem erros no prompt. Em avisos globais, os acentos
circunflexos no precisam ser precedidos por uma barra invertida.
possvel incluir uma barra invertida n (\n) no texto para criar uma nova
linha.
Exemplos
O exemplo a seguir define trs prompts:
$prompt
prmt1 "ready for job4? (y/n)"
prmt2 ":job4 launched"
prmt3 "!continue?"
Consulte tambm
Para criar uma definio de prompt no Tivoli Dynamic Workload Console:
3. Na barra de ferramentas Lista de Trabalho da janela pop-up resultante, clique
em NovoPrompt
4. Especifique suas opes no painel Propriedades - Prompt.
192
Definio do recurso
Representam recursos de planejamento fsicos ou lgicos que podem ser utilizados
como dependncias para jobs e fluxos de job.
Sintaxe
$resource
workstation#resourcename units [description ]
[workstation#resourcename ...]
Argumentos
estao de trabalho
Especifica o nome da estao de trabalho ou classe da estao de trabalho
na qual o recurso utilizado.
resourcename
Especifica o nome do recurso. O nome pode conter at oito caracteres
uma letra.
units
Especifica o nmero de unidades de recurso disponveis. Os valores podem

ser de 0 a 1024.
description
Fornece uma descrio do recurso. Ela deve ser colocada entre aspas
duplas.
As unidades de recursos envolvidas nas dependncias de necessidades para uma
tarefa ou para um fluxo de tarefa permanecem ocupadas at a tarefa ou o fluxo de
tarefa ser concludo (com xito ou no). As unidades de recurso so liberadas
assim que a tarefa ou o fluxo de tarefa for concludo.
Quando vrias tarefas e fluxos de tarefas dependem do mesmo recurso, se no
houver unidades de recursos suficientes disponveis para todos eles, elas sero
designadas de acordo com a prioridade da tarefa ou do fluxo de tarefas. O status
de uma tarefa ou fluxo de tarefas torna-se READY assim que todas as suas
dependncias so resolvidas. Se a CPU limite configurada na estao de trabalho
no permitir a execuo no momento, aguarda no estado READY. A nica exceo
para este comportamento quando a tarefa ou fluxo de tarefa GO ou HI, nesse
caso, ela inicia independentemente do valor configurado para CPU limite.
Exemplos
O exemplo a seguir define quatro recursos:
$resource
ux1#tapes 3 "tape units"
ux1#jobslots 24 "job slots"
ux2#tapes 2 "tape units"
ux2#jobslots 16 "job slots"
Consulte tambm
Para criar uma definio de recurso no Tivoli Dynamic Workload Console:
193

3. Na barra de ferramentas Lista de Trabalho da janela pop-up resultante, clique
em NovoRecurso
4. Especifique suas opes no painel Propriedades - Recurso.
Definio de fluxo de tarefas

Um fluxo de tarefa consiste em uma seqncia de tarefas a serem executadas,
juntamente com as dependncias de horas, prioridades e outras dependncias que
determinam a ordem do processamento.
Um fluxo de tarefas comea com uma palavra-chave schedule seguida de atributos
e dependncias. O delimitador de dois pontos introduz as tarefas chamadas pelo
fluxo de tarefas. Cada job possui seus prprios atributos e dependncias.
Sintaxe
schedule [workstation#]jobstreamname
# comment
[validfrom date]
[timezone|tz tzname]
[description text]
[draft]
[freedays calendarname [-sa] [-su]]
[on [runcycle name]
[validfrom date] [validto date]
[description text]
{date|day|calendar|request|icalendar} [,...]
[fdignore|fdnext|fdprev]
[({at time [+n day[s]] |
schedtime time [+n day[s]]}
[until time [+n day[s]] [onuntil action]]
[deadline time [+n day[s]]])]]
[,...]
[except [runcycle name]
[description text]
[{(at time [+n day[s]])] |
(schedtime time [+n day[s]])}]
[,...]
[{at time [timezone|tz tzname] [+n day[s]] |
schedtime time [timezone|tz tzname] [+n day[s]]}]
[until time [timezone|tz tzname] [+n day[s]] [onuntil action]]
[deadline time [timezone|tz tzname] [+n day[s]]]
[carryforward]
[matching {previous|sameday|relative from [+ | -] time to [+ | -] time|
from time [+ | -n day[s]] to time [+ n day[s]] [,...]}]
[follows {[netagent::][workstation#]jobstreamname[.jobname |@] [previous|
sameday|relative from [+|-] time to [+|-] time|
194
from time [+|-n day[s]] to time [+|-n day[s]]

]} ] [,...]] [...]
[keysched]
[limit joblimit]
[needs { [n] [workstation#]resourcename } [,...] ] [...]
[opens { [workstation#]"filename" [ (qualifier) ] [,...] }]
[priority number | hi | go]
[prompt {promptname|"[:|!]text"} [,...] ] [...]
[...]
:
job-statement
# comment
schedtime time [timezone|tz tzname] [+n day[s]]}][,...]
[until time [timezone|tz tzname] [+n day[s]] [onuntil action]
[deadline time [timezone|tz tzname] [+n day[s]]] [,...]
[every rate]
[follows {[netagent::][workstation#]jobstreamname{.jobname @} [previous|
sameday|relative from [+|-] time to [+|-] time |
]} ] [,...]] [...]
[confirmed]
[critical]
[keyjob]
[opens { [workstation#]"filename" [ (qualifier) ] [,...] }] [...]
[job-statement...]
end
Argumentos
A Tabela 39 contm uma descrio resumida das palavras-chave de definio do
fluxo de tarefas. Uma descrio detalhada de cada palavra-chave de planejamento
fornecida nas subsees a seguir.
Tabela 39. Lista de Palavras-chave de Planejamento
Palavra-chave
Descrio
Pgina
at
Define a primeira hora em que a execuo s na pgina 199

de um fluxo de tarefa ou uma tarefa pode
ser ativada. Quando definida em um ciclo
de execuo, especifica a primeira hora
que uma tarefa ou um fluxo de tarefa
pode ser ativado para esse ciclo de
execuo especfico.
carryforward
Transportar o fluxo de tarefas se ele no

estiver concludo.
comentrio
Inclui comentrios na definio de um

comentrio na pgina
fluxo de tarefas ou em uma tarefa contida 201
no fluxo de tarefas.
confirmed
Especifica que a concluso deste job

requer confirmao.
confirmed na pgina 201
critical
Especifica que a tarefa essencial e deve

ser gerenciada de forma adequada.
critical na pgina 202
carryforward na pgina
200
195
Tabela 39. Lista de Palavras-chave de Planejamento (continuao)
196
Palavra-chave
Descrio
Pgina
prazo final
Especifica o tempo no qual uma tarefa ou

fluxo de tarefas deve ser concludo.
Quando definido em um ciclo, especifica
o tempo dentro do qual uma tarefa ou
um fluxo de tarefa deve ser concludo
nesse especfico ciclo de execuo.
prazo final na pgina

202
description
Contm uma descrio do fluxo de tarefa. description na pgina

O comprimento mximo desse campo
203
de 120 caracteres.
draft
Especifica que o processo de gerao de

plano deve ignorar esse fluxo de tarefas.
draft na pgina 204
end
Marca o final de um fluxo de tarefas.
fim na pgina 204
every
Lana o job repetidamente a uma taxa

especificada.
a cada na pgina 204
except
Especifica datas que so excees para as

datas on em que o fluxo de tarefa est
selecionado para execuo.
except na pgina 208
fdignore | fdnext
| fdprev
Especifica uma regra que deve ser

aplicada quando a data selecionada para
excluso cai em um dia livre.
except na pgina 208
follows
Especifica tarefas e fluxos de tarefa que

devem ser concludos com xito antes da
tarefa ou o fluxo de tarefa que est sendo
definido ser ativado.
follows na pgina 209
dias livres
Especifica um calendrio de dias livres

para calcular os dias teis para o fluxo de
tarefas. Ele tambm pode definir sbados
e domingos como dias teis.
dias livres na pgina 211
job statement
Define um job e suas dependncias.
job statement na pgina

213
keyjob
Marca uma tarefa como chave no banco

de dados e no plano para monitoramento
por aplicativos, como o IBM Tivoli
Business Systems Manager ou o IBM
Tivoli Enterprise Console.
keyjob na pgina 214
keysched
Marca um fluxo de tarefas como chave no keysched na pgina 215

banco de dados e no plano para
monitoramento por aplicativos, como o
IBM Tivoli Business Systems Manager ou
o IBM Tivoli Enterprise Console.
limite
Define um limite no nmero de tarefas

limite na pgina 215
que podem ser lanadas simultaneamente
a partir do fluxo de tarefas.
matching
Define os critrios de correspondncia

matching na pgina 216
utilizados quando um critrio de
correspondncia no especificado nas
especificaes follows na definio do
fluxo de tarefas ou na definio de tarefas
Tabela 39. Lista de Palavras-chave de Planejamento (continuao)

Palavra-chave
Descrio
Pgina
needs
Define o nmero de unidades de um

recurso requerido pela tarefa ou fluxo de
tarefas antes de poder ser lanado. O
nmero mais alto de recursos do qual o
fluxo de tarefas pode ser dependente
1024.
needs na pgina 216
em
Define as datas em que o fluxo de tarefas

selecionado para execuo.
em na pgina 217
opens
Define os arquivos que devem estar

acessveis antes da tarefa ou fluxo de
tarefas ser lanado.
opens na pgina 223
onuntil
Especifica a ao a ser realizada em uma

tarefa ou fluxo de tarefa cuja hora until
foi atingida.
until na pgina 230
priority
Define a prioridade de uma tarefa ou

fluxo de tarefas.
prioridade na pgina 225
prompt
Define os prompts que devem ser

respondidos antes da tarefa ou fluxo de
tarefas ser lanado.
prompt na pgina 226
runcycle
Especifica uma etiqueta com um nome de v except na pgina 208

fcil compreenso para o ciclo de
v em na pgina 217
execuo.
schedule
Atribui um nome ao fluxo de tarefas.
planejamento na pgina
229
schedtime
Especifica o tempo utilizado para

configurar o fluxo de tarefas na linha de
tempo do plano para determinar
sucessores e predecessores.
schedtime na pgina 227
timezone | tz
Especifica o fuso horrio a ser utilizado

ao calcular a hora de incio.
fuso horrio na pgina

230
until
Define a ltima hora que uma tarefa ou

um fluxo de tarefa pode ser ativado.
Quando definido em um ciclo de
execuo especifica a ltima hora que
uma tarefa ou um fluxo de tarefa pode
ser ativado para o ciclo de execuo
especfico.
until na pgina 230
validfrom
Define a data a partir da qual a instncia

do fluxo de tarefa iniciado.
validfrom/validto na
pgina 233
validto
Indica a data na qual a instncia do fluxo

de tarefas termina.
validfrom/validto na
pgina 233
vartable
vartable na pgina 234

Define a tabela de variveis a ser
utilizada pelo fluxo de tarefas e pelo ciclo
de execuo.
Nota:
1. Os fluxos de tarefas planejados para execuo em estaes de trabalho
marcados como ignored no so includos no plano de produo quando
o plano criado ou estendido.
197
2. Palavras-chave incorretamente digitadas utilizadas em definies de

tarefa levam a definies de tarefa truncada armazenadas no banco de
dados. De fato, a palavra-chave incorreta considerada estranha para a
definio de tarefa e, portanto, interpretada como o nome de tarefa de
uma definio de tarefa adicional. Geralmente, essa interpretao
incorreta tambm causa um erro de sintaxe ou um erro de definio de
tarefa inexistente para a definio de tarefa adicional.
Regras de Especificao de Fuso Horrio

possvel especificar um fuso horrio em vrios nveis de palavra-chave em uma
definio de fluxo de tarefas; isto :
v Para todo o fluxo de tarefas (inclusive de todas as suas especificaes de
palavras-chave)
v No nvel de restrio de tempo (com as palavras-chave at, deadline, schedtime e
until)
v Para cada instruo de tarefa includa
As seguintes regras se aplicam ao resolver os fusos horrios especificados em uma
definio de fluxo de tarefas:
v Quando voc especificar o fuso horrio no nvel do fluxo de tarefas, isto se
aplicar s definies de tempo do ciclo de execuo (definido com a
palavra-chave on), bem como s definies nas restries de tempo.
v Se voc especificar um fuso horrio tanto no nvel de fluxo de tarefas quanto no
nvel de restrio de tempo, eles devero ser os mesmos. Se voc no especificar
nenhum fuso horrio, seja no nvel de fluxo de tarefas seja no nvel de restrio
de tempo, o fuso horrio especificado na estao de trabalho ser utilizado.
v O fuso horrio especificado no nvel de tarefa pode diferir daquele especificado
no nvel de fluxo de tarefas e substitu-lo. Se voc no especificar nenhum fuso
horrio, seja no nvel de fluxo de tarefas seja no nvel de tarefa, o fuso horrio
especificado na estao de trabalho que est executando a tarefa ser utilizado.
Regras de Especificao de Restrio de Tempo

Em uma definio de fluxo de tarefas, possvel especificar restries de tempo
(com as palavras-chave at, deadline, schedtime e until) nos nveis de fluxo de
tarefas e de ciclo de execuo. Quando os dois nveis so especificados, as
restries de tempo especificadas no nvel de ciclo de execuo substituem aquelas
especificadas no nvel de fluxo de tarefas.
Exemplos
Este um exemplo de uma definio de fluxo de tarefas:
SCHEDULE M235062_99#SCHED_FIRST1 VALIDFROM 06/30/2005
ON RUNCYCLE SCHED1_PREDSIMPLE VALIDFROM 07/18/2005 "FREQ=DAILY;INTERVAL=1"
( AT 1010 )
ON RUNCYCLE SCHED1_PRED_SIMPLE VALIDFROM 07/18/2005 "FREQ=DAILY;INTERVAL=1"
CARRYFORWARD
PROMPT "parto o no?"
PRIORITY 55
:
M235062_99#JOBMDM
PRIORITY 30
NEEDS 16 M235062_99#JOBSLOTS
PROMPT PRMT3
198
B236153_00#JOB_FTA
FOLLOWS JOBMDM
END
Consulte tambm
Para criar uma definio de fluxo de tarefa no Dynamic Workload Console :
em NovoFluxo de Tarefa
4. Especifique suas opes no painel Propriedades - Fluxo de Tarefa.
Detalhes da Palavra-chave de Definio do Fluxo de Tarefas

Esta seo descreve as palavras-chave de definio do fluxo de tarefas listadas na
tabela Tabela 39 na pgina 195.
s
Especifica a dependncia de hora. Se a palavra-chave at for utilizada, a tarefa ou o
fluxo de tarefas no poder iniciar antes da hora configurada nessa palavra-chave.
Sintaxe
at time [timezone|tz tzname][+n day[s]] [absolute|abs]
Argumentos
time
Especifica um perodo do dia. Os valores possveis variam de 0000 a 2359.
tzname Especifica o fuso horrio a ser utilizado ao calcular a hora de incio.

obter os nomes dos fusos horrios. O padro o fuso horrio da estao
de trabalho em que a tarefa ou fluxo de tarefas lanado.
Nota: Se uma hora at e uma hora until ou deadline forem especificadas,
os fuso horrios devem ser iguais.
n
Especifica um deslocamento em dias da data e hora de incio planejadas.
absolute
Especifica se a data de incio baseada no dia do calendrio, e no no dia
de produo.
Comentrios
Se uma hora at no for especificada para uma tarefa ou um fluxo de tarefas, a hora
de ativao determinada por suas dependncias e prioridade e sua posio no
plano de pr-produo determinada pelo valor designado para a palavra-chave
schedtime. Para obter informaes adicionais sobre a palavra-chave schedtime,
consulte schedtime na pgina 227.
Se os horrios de incio do ciclo de execuo e do fluxo de tarefas forem definidos,
o horrio de incio do ciclo de execuo ter precedncia quando o fluxo de tarefas
199
for planejado com JNextPlan. Quando o fluxo de tarefas for ativado com o
comando submit, o horrio de incio do ciclo de execuo no ser utilizado.
O valor de tempo na opo at considerado da seguinte forma:
v Se o valor de hora for inferior ao valor configurado na opo global startOfDay,
considerado como para o dia seguinte.
v Se o valor de hora for superior ao valor configurado na opo global
startOfDay, considerado como para o dia atual.
Se o gerenciador de domnio principal da rede executar com as opes
enLegacyStartOfDayEvaluation e enTimeZone configuradas parayes para converter
o horrio startOfDay configurado no gerenciador de domnio principal para o fuso
horrio local configurado em cada estao de trabalho na rede, voc dever incluir
a palavra-chave absolute para que funcione quando uma tarefa ou um fluxo de
tarefas for submetido.
Se as palavras-chave at e schedtime no forem especificadas na definio do fluxo
de tarefas, por padro, a instncia da tarefa ou do fluxo de tarefas ser posicionada
no plano na hora especificada na opo global startOfDay.
Exemplos
Os exemplos a seguir assumem que o dia de processamento do Tivoli Workload
Scheduler comea s 6h.
v O fluxo de tarefas a seguir, selecionado s teras-feiras, no ativado antes das
3h da manh de quarta-feira. Seus dois jobs so lanados o mais breve possvel
aps essa hora.
schedule sked7 on tu at 0300:
job1
job2
fim
v O fuso horrio da estao de trabalho sfran est definido como

America/Los_Angeles e o fuso horrio da estao de trabalho nycity est
definido como America/New_York. O fluxo de tarefas a seguir selecionado
para execuo s sextas-feiras. Ele ativado na estao de trabalho sfran s 10h
do sbado de America/Los_Angeles. O job1 lanado na sfran o mais breve
possvel aps essa hora. O job2 ativado na sfran s 14h de sbado de
America/New_York (11h de America/Los_Angeles). O job3 ativado na estao
de trabalho nycity s 16h de sbado de America/New_York (13h de
America/Los_Angeles).
sfran#schedule sked8 on fr at 1000 + 1 day :
job1
job2 at 1400 tz America/New_York
nycity#job3 at 1600
fim
carryforward
Torna um fluxo de tarefas elegvel para ser transportado para o prximo plano de
produo se no for concludo antes do final do plano de produo atual.
Sintaxe
carryforward
200
Exemplos
O fluxo de tarefa a seguir tem o saldo transportado se suas tarefas no tiverem
sido concludas antes do processamento de pr-produo comear para um novo
espao de tempo de produo.
schedule sked43 on th
carryforward
:
job12
job13
job13a
fim
comentrio
Inclui comentrios em uma definio de fluxo de tarefas e as tarefas contidas em
um fluxo de tarefas.
Sintaxe
# text
Comentrios
Insere uma linha de comentrio. O primeiro caractere da linha deve ser um sinal
de sustenido #.
possvel incluir comentrios em uma definio de fluxo de tarefas imediatamente
aps a linha com a palavra-chave schedule ou em uma tarefa contida em uma
definio de fluxo de tarefas imediatamente aps a linha job statement.
Exemplos
O exemplo a seguir inclui os dois tipos de comentrios:
schedule wkend on fr at 1830
##########################
# The weekly cleanup jobs
##########################
#
carryforward
:
job1
# final totals and reports
job2
# update database
fim
confirmed
Especifica que a concluso de uma tarefa deve ser confirmada executando um
comando conman confirm. Consulte confirm na pgina 341 para obter
informaes adicionais.
Sintaxe
confirmed
201
Exemplos
No fluxo de tarefas a seguir, a confirmao da concluso do job1 deve ser recebida
antes do job2 e job3 serem lanados.
schedule test1 on fr:
job1 confirmed
job2 follows job1
job3 follows job1
fim
critical
Especifica que a tarefa crtica para a misso e deve ser processada de acordo.
Uma tarefa crtica para a misso tem tratamento privilegiado. Considerando seu
prazo final e a durao estimada, o planejador:
v Durante a construo do plano ou sempre que ele executa o comando submit,
calcula o horrio de incio mais recente em que cada um de seus predecessores
pode ser iniciado para que a tarefa cumpra com xito seu prazo final. Isto
chamado de horrio de incio crtico. Um horrio de incio crtico atribudo
tarefa crtica e a cada um de seus predecessores.
O conjunto completo de predecessores para a tarefa crtica chamado de rede
crtica da tarefa.
v Ao executar o plano, recalcula dinamicamente os horrios de incio crticos
dentro da rede crtica.
Quando um predecessor ameaa comprometer a concluso oportuna da tarefa
crtica, ele promovido; ou seja, utilizando diferentes mecanismos do sistema
operacional, como a implementao do comando nice no UNIX ou a alterao
do nvel de prioridade no Windows, ele recebe recursos adicionais e seu envio
priorizado em relao a outras tarefas que esto fora da rede crtica. Esta ao
executada de forma recorrente em qualquer predecessor na rede crtica e, se
necessrio, na tarefa crtica, uma vez que h um risco dessa tarefa se tornar
atrasada.
Importante: As tarefas crticas devem ter um prazo final especificado no nvel da
tarefa, do fluxo de tarefa ou do ciclo de execuo.
Sintaxe
critical
prazo final
Especifica o tempo no qual uma tarefa ou fluxo de tarefas deve ser concludo. As
tarefas ou os fluxos de tarefas que ainda no foram iniciados ou que estavam em
execuo quando o prazo final expirou, so considerados atrasados no plano.
Quando um job (ou fluxo de job) est atrasado, so executadas as seguintes aes:
v A tarefa mostrada como atrasada em conman.
v Um evento enviado para o Tivoli Enterprise Console e para o IBM Tivoli
Business Systems Manager.
v Uma mensagem emitida para os logs stdlist e console.
Quando uma tarefa no concluda antes de seu prazo final, uma mensagem de
aviso exibida. Se essa tarefa no fizer parte de um fluxo de tarefas transportado e
voc executar JnextPlan enquanto ainda est em execuo, a tarefa inserida em
202
USERJOBS. Nesse caso, outra mensagem de aviso sobre o prazo final expirado
includa no arquivo TWS_home/stdlist/logs/yyyymmdd_TWSMERGE.log.
|
|
|
|
|
|
|
|
|
|
Nota: Ao usar a palavra-chave prazo final, certifique-se de que a opo bm check

deadline esteja configurada para um valor maior que 0 no arquivo de
configurao localopts na estao de trabalho em que voc estiver
trabalhando. possvel definir a opo bm check deadline em cada estao
de trabalho na qual voc deseja estar ciente sobre a expirao do prazo final,
ou, se voc desejar obter informaes atualizadas sobre o ambiente todo,
defina a opo no gerenciador de domnio principal. Prazos finais para
tarefas crticas so avaliadas automaticamente, independentemente da opo
bm check deadline. Para obter mais informaes sobre a opo bm check
deadline, consulte Detalhes das Opes Locais.
Sintaxe
deadline time [timezone|tz tzname][+nday[s] [,...]
Argumentos
time
tzname Especifica o fuso horrio a ser utilizado ao calcular o prazo final. Consulte
Captulo 13, Gerenciando fusos horrios, na pgina 523 para obter os
nomes dos fusos horrios. O padro o fuso horrio da estao de
trabalho em que a tarefa ou fluxo de tarefas lanado.
n
Especifica um deslocamento em dias da hora do prazo final planejada.
Nota: Se uma hora deadline e uma hora until ou at forem especificadas, os fuso
horrios devem ser os mesmos.
Exemplos
O exemplo a seguir ativa um fluxo de tarefas sked7 todos os dias e uma tarefa
jobc para iniciar a execuo s 14h30 e ser concludo s 16h.
schedule sked7 on everyday :
jobc at 1430 deadline 1600
fim
description
Inclui uma descrio para o fluxo de tarefas.
Sintaxe
description text
Comentrios
O comprimento mximo desse campo de 120 caracteres.
Exemplos
schedule test1
description Revenue at the end of the month
on monthend
:
203
job1
job2
job3
fim
draft
Marca um fluxo de tarefas como rascunho. Um fluxo de tarefas de rascunho no
includo no plano de pr-produo.
Sintaxe
draft
Comentrios
Um fluxo de tarefa de rascunho no considerado ao determinar dependncias e
no includo no plano de produo. Aps remover a palavra-chave draft de um
fluxo de tarefas, necessrio executar o comando JnextPlan para incluir o fluxo de
tarefas no plano de produo e, portanto, no plano de produo.
Exemplos
schedule test1 on monthend
draft
:
job1
job2
job3
fim
fim
Marca o final da definio de um fluxo de tarefas.
Sintaxe
end
Exemplos
schedule test1 on monthend
:
job1
job2
job3
end << end of job stream >>
a cada
Define a taxa de repetio de um job. O job lanado repetidamente na taxa
especificada. Se a tarefa tiver uma dependncia que no esteja satisfeita, a iterao
ser iniciada somente depois que a dependncia for satisfeita.
Sintaxe
every rate
204
Argumentos
rate
A taxa de repetio expressa em horas e minutos, no formato hhmm. A taxa

pode ser maior que 24 horas.
Comentrios
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
v A iterao every de uma tarefa no parar mesmo se uma das repeties da

tarefa for encerrada de forma anormal.
v Se a opo every for utilizada sem a dependncia at, as tarefas reexecutadas
sero planejadas respeitando a taxa every especificada, comeando da hora
quando a tarefa realmente iniciou.
v No caso especfico que a opo every utilizada com a dependncia at e uma
nova execuo retardada (por uma dependncia ou por qualquer outra razo),
enquanto o Tivoli Workload Scheduler realinha com a hora at, pode haver uma
ou duas iteraes que no respeitam a taxa every. Para todos os outros casos, a
taxa every sempre respeitada.
O exemplo 2 explica como o Tivoli Workload Scheduler realinha com a hora at
se a tarefa inicia depois da hora at definida e algumas iteraes so perdidas.
v Se uma instncia every de uma tarefa no iniciar em seu horrio de incio
esperado, use a opo bm late every para configurar o nmero mximo de
minutos que devem decorrer antes do Tivoli Workload Scheduler ignorar a
tarefa. O valor da opo deve ser definido no arquivo <TWSHOME>/localopts:
bm late every = xx
Em que xx o nmero de minutos.
Esta opo local para cada agente e, dessa forma, ela deve ser definida em
cada agente tolerante a falhas que tiver tarefas every com a opo bm late every
definida.
A opo bm late every se aplica apenas a tarefas tanto com a opo every
quanto a dependncia de horrio at definidas, e ela no causa impacto nas
tarefas que possuem apenas a opo every definida. Apenas tarefas cuja taxa
every seja maior que o valor bm late every sofreram impacto.
O exemplo 4 na pgina 207 mostra o comportamento de Tivoli Workload
Scheduler quando o atraso de uma instncia every no excede o valor da opo
bm late every.
Scheduler quando o atraso de uma instncia every excede o valor da opo bm
late every.
Scheduler quando a primeira instncia de uma tarefa no executa em seu
horrio de incio esperado e excede o valor da opo bm late every.
Exemplos
1. O exemplo a seguir executa a tarefa testjob a cada hora:
testjob every 100
2. O exemplo a seguir mostra a tarefa testjob1 definida para execuo a cada 15

minutos, entre s 18h e 20h:
testjob1 at 1800 every 15 until 2000
A tarefa deve ser executada s 18h, 18h15, 18h30 e assim por diante, a cada 15
minutos.
Se a tarefa for submetida adhoc s 18h33, as reexecues ocorrero s 18h33,
18h34, 18h45, etc. A razo disso explicada a seguir.
205
Primeiro, observe que em uma tarefa, h dois valores de hora a considerar:

v O start_time; que a hora quando se espera que a tarefa seja executada. Esse
valor est configurado para a hora at especificada para a tarefa ou para a
hora quando a nova execuo deve ser ativada. Esse valor pode ser
visualizado utilizando conman showjobs antes do incio da iterao da tarefa.
v O time_started; que a hora quando a tarefa realmente inicia, por exemplo
18h33. Esse valor pode ser visualizado utilizando-se conman showjobs aps o
incio da iterao da tarefa.
Como a tarefa testjob1 foi enviada adhoc s 1833, estas so as informaes que
voc ver imediatamente aps o envio:
com conman showjobs
TESTJOB1 HOLD 1800
no arquivo Symphony
start_time=1800 (porque espera-se que a tarefa seja executada s 18h)
time_started=NULL (porque a tarefa ainda no foi iniciada)
Como o start_time (1800) menor do que o horrio de incio (1833), testjob1
inicia imediatamente e as informaes atualizadas se tornam:
com conman showjobs
TESTJOB1 SUCC 1833
no arquivo Symphony
start_time=1800 (porque esperava-se que a tarefa fosse executada s
18h)
time_started=1833 (porque a tarefa foi iniciada s 18h33)
Quando batchman calcula a hora para a prxima iterao, utiliza os seguintes
dados:
start_time=1800
rate=0015
current_time=1833
Como a prxima hora de iterao (1800+0015=1815) ainda seria anterior ao
valor current_time (1833), batchman identifica a ltima iterao planejada que
no foi executada somando ao start_time quantos every_rate possvel sem
exceder o current_time
1800 + 0015 + 0015 = 18h30 < 1833
e, em seguida, emite o comando para executar essa iterao. Supondo que essa
iterao seja executada s 1834, as informaes, aps o incio da tarefa,
tornam-se as seguintes:
com conman showjobs
TESTJOB1 SUCC 1834
no arquivo Symphony
start_time=1830 (porque esperava-se que essa iterao de tarefa fosse
executada s 1830)
time_started=1834 (porque essa iterao de tarefa foi iniciada s 18h34)
Aps essa iterao de tarefa ser concluda, batchman calcula novamente a hora
que a prxima iterao precisa iniciar utilizando estes valores atualizados:
206
start_time=1830
rate=0015
current_time=1834
O fato de que a hora da prxima iterao (1830+0015=1845) seja posterior ao
valor current_time (1834), indica a batchman que a iterao recuperada. A
hora de iterao, que comea a partir de 1845, pode ser realinhada com as
horas de iterao planejadas configuradas na definio de tarefa pelas
palavras-chave at e every.
3. O exemplo a seguir no inicia a iterao da tarefa testjob2 at que a tarefa
testjob1 tenha sido concluda com xito:
testjob2 every 15 follows testjob1
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
4. No exemplo a seguir, o atraso de uma instncia de uma tarefa every no

excede o valor da opo bm late every:
bm late every = 10
JOB AT 1400 EVERY 0030
Esta tarefa deveria ser executada s 1400, 1430, 1500 e assim por diante, a cada
trinta minutos.
Se o servidor estiver inativo das 1435 s 1605, as instncias s 1500, 1530 e 1600
no sero executadas. s 1605, Tivoli Workload Scheduler reinicializa. Quando
ele analisa o arquivo Symphony, determina que o melhor horrio em potencial
para a prxima instncia da tarefa every 1600. Tivoli Workload Scheduler
verifica se o melhor horrio em potencial (1600) excede o atraso mximo
permitido para uma tarefa every (10 minutos).
Neste caso, o atraso no excede a opo bm late every, assim o Tivoli
Workload Scheduler se comporta como de costume e cria a instncia da tarefa
every com horrio de incio configurado como 1600. As instncias subsequentes
esto configuradas s 1630, 1700 e assim por diante, a cada trinta minutos.
5. No exemplo a seguir, o atraso da instncia de uma tarefa every excede o valor
da opo bm late every:
bm late every = 10
trinta minutos.
Se o servidor estiver inativo das 1435 s 1620, as instncias s 1500, 1530 e 1600
no sero executadas. s 1620, Tivoli Workload Scheduler reinicializa. Quando
ele analisa o arquivo Symphony, determina que o melhor horrio em potencial
para a prxima instncia da tarefa every 1600. Tivoli Workload Scheduler
verifica se o melhor horrio em potencial (1600) excede o atraso mximo
permitido para uma instncia de uma tarefa every (10 minutos).
Neste caso, o atraso maior que a opo bm late every, assim o Tivoli
Workload Scheduler aplica o novo comportamento, ele no ativa a instncia da
tarefa every s 1600 e cria a instncia da tarefa every com horrio de incio
configurado como 1630.
6. O exemplo a seguir mostra o comportamento de Tivoli Workload Scheduler
quando a primeira instncia de uma tarefa no executa em seu horrio de
incio esperado e excede o valor da opo bm late every:
bm late every = 10
trinta minutos.
Se o servidor estiver inativo das 1000 s 1415, a primeira instncia da tarefa no
ser executada. s 1415, Tivoli Workload Scheduler reinicializa. Quando ele
207
analisa o arquivo Symphony, determina que a primeira instncia desta tarefa

every no foi executada. Nesse caso, Tivoli Workload Scheduler ativa a tarefa
s 1415.
|
|
|
except
Define as datas que so excees para as datas on de um fluxo de tarefas. Consulte
em na pgina 217 para obter informaes adicionais.
Sintaxe
except [runcycle name]
[description text]
{date|day|calendar|request|icalendar}
[,...]
Argumentos
fdignore|fdnext|fdprev
Especifica uma regra que deve ser aplicada quando a data selecionada para
excluso cai em um dia livre. Pode ser um dos seguintes:
fdignore
No excluir a data.
fdnext Exclua o dia til mais prximo aps o dia livre.
fdprev
Exclua o dia til mais prximo antes do dia livre.
Para obter uma explicao sobre as palavras-chave remanescentes contidas na
sintaxe de except, consulte em na pgina 217.
Comentrios
possvel definir vrias ocorrncias da palavra-chave except para o mesmo fluxo
de tarefas. Cada ocorrncia equivale a um ciclo de execuo ao qual se pode
associar uma regra para dia livre.
Vrias ocorrncias except devem ser consecutivas dentro da definio de fluxo de
tarefas.
Cada ocorrncia da palavra-chave pode conter qualquer um dos valores permitidos
pela sintaxe except.
Exemplos
O exemplo a seguir seleciona o fluxo de tarefas testskd2 para ser executado todos
os dias da semana, exceto naqueles cujas datas aparecem nos calendrios
chamados monthend e holidays:
schedule testskd2 on weekdays
except monthend,holidays
O seguinte exemplo seleciona o fluxo de tarefas testskd3 para executar todos os

dias da semana, exceto 15 de Maio de 2005 e 23 de Maio de 2005:
208

except 05/15/2005,05/23/2005
O exemplo a seguir seleciona o fluxo de tarefas testskd4 para ser executado todos
os dias, exceto dois dias da semana (menos sbado e domingo), anteriores a
qualquer data que aparea em um calendrio chamado monthend:
schedule testskd4 on everyday
except monthend-2 weekdays
Selecione o fluxo de tarefas sked4 para ser executado s segundas-feiras,

teras-feiras e em 2 dias da semana anteriores a cada data listada no calendrio
monthend. Se a data de execuo for um dia livre, execute o fluxo de tarefa no dia
til seguinte mais prximo. No execute o fluxo de tarefas s quartas-feiras.
schedule sked4
on mo
on tu, MONTHEND -2 weekdays fdnext
except we
Selecione o fluxo de tarefas testskd2 para ser executado todos os dias da semana,
exceto nos dias listados em monthend. Se uma data em monthend cair em um dia
livre, exclua o dia til mais prximo antes dele. Neste exemplo, os dias livres so
sbados, domingos e todas as datas listadas no calendrio holidays padro.
schedule testskd2
on weekdays
except MONTHEND fdprev
follows
Define as outras tarefas e fluxos de tarefas que devem ser concludos com xito
antes de uma tarefa ou fluxo de tarefas ser lanado.
Comentrios
Utilize a seguinte sintaxe para fluxos de job:
[follows {[netagent::][workstation#]jobstreamname[.jobname |@]
[previous|sameday|relative from [+/-] time to [+/-] time|from time [+/-n day[s]] to
time [+/-n day[s]]
Utilize a seguinte sintaxe para jobs:
[follows {[netagent::][workstation#]jobstreamname{.jobname | @}
[previous|sameday|relative from [+/-] time to [+/-] time | from time [+/-n day[s]]
to time [+/-n day[s]]
Argumentos
netagent
O nome do agente de rede em que a dependncia de interligao de redes
est definida.
estao de trabalho
A estao de trabalho na qual a tarefa ou fluxo de tarefas deve ter
concludo a execuo. O padro a mesma estao de trabalho da tarefa
ou fluxo de tarefas dependente.
209
Se uma workstation no for especificada com netagent, o padro a estao

de trabalho qual o agente de rede est conectado.
jobstreamname
O nome do fluxo de tarefas que deve ter sido concludo. Para uma tarefa, o
padro o mesmo fluxo de tarefas da tarefa dependente.
time
jobname
O nome da tarefa que deve ter sido concluda. Um sinal at (@) pode ser
utilizado para indicar que todas as tarefas no fluxo de tarefas devem ser
concludas com xito.
Comentrios
Os critrios de resoluo de dependncia definem como o fluxo de tarefas ou uma
tarefa referida por uma dependncia de seqncia correspondem a um fluxo de
tarefas especfico ou instncia de tarefa no plano. Como o plano permite a incluso
de vrias instncias da mesma tarefa ou fluxo de tarefas, possvel identificar a
instncia que resolve a dependncia follows externa com base nos seguintes
critrios de resoluo:
Precedente mais Prximo
A tarefa ou a instncia do fluxo de tarefas que resolve a dependncia a
mais prxima que precede a instncia que inclui a dependncia.
Mesmo Dia
mais prxima no tempo planejado para iniciar no dia em que a instncia
que inclui a dependncia est planejada para execuo.
Dentro de um Intervalo Relativo
mais prxima em um intervalo de tempo de sua escolha, que est definida
relativamente no horrio de incio planejado da instncia dependente.
Dentro de um Intervalo Absoluto
mais prxima em um intervalo de tempo de sua escolha. O intervalo de
tempo no relacionado ao horrio de incio planejado da instncia
dependente.
Independentemente de quais critrios correspondentes so utilizados, se vrias
instncias de fluxos de tarefas do predecessor em potencial existirem no intervalo
de tempo especificado, a regra utilizada pelo produto para identificar a instncia
do predecessor correta ser a seguinte:
1. Tivoli Workload Scheduler procura a instncia mais prxima que precede o
horrio de incio da tarefa ou do fluxo de tarefas dependente. Se uma instncia
desse tipo existir, esta ser a instncia do predecessor.
2. Se no houver instncia precedente, o Tivoli Workload Scheduler considerar a
instncia do predecessor correta como a instncia mais prxima iniciada aps o
horrio de incio da tarefa ou do fluxo de tarefas dependente.
210
Quando um fluxo de tarefas inclui uma tarefa com uma dependncia de sequncia
que compartilha o mesmo nome de fluxo de tarefas (por exemplo, o fluxo de
tarefas schedA inclui uma tarefa denominada job6 que tem uma dependncia de
sequncia em schedA.job2), a dependncia includa no plano como uma
Para obter informaes e exemplos adicionais sobre como as dependncias follows
externas so resolvidas no plano, consulte Gerenciando Dependncias de
Acompanhamentos Externos para Tarefas e Fluxos de Tarefas na pgina 57.
Exemplos
O exemplo a seguir especifica que o fluxo de tarefa skedc no deve ser ativado at
a instncia de fluxo de tarefa anterior mais prxima sked4 na estao de trabalho
site1 ter sido concluda com xito:
schedule skedc
on fr
follows site1#sked4 previous
O exemplo a seguir especifica que o fluxo de tarefa skedc no deve ser ativado at
a instncia de fluxo de tarefa sked4 na estao de trabalho site1 que executada
entre 12h00 de 3 dias antes e 15h00 do dia aps a concluso bem-sucedida:
schedule skedc
on fr
follows site1#sked4
from 1200 3 days to 0300 1 day
O exemplo a seguir especifica para no ativar o fluxo de tarefas skedc at que o

fluxo de tarefas sked4 na estao de trabalho site1 e a tarefa joba no fluxo de
tarefas sked5 na estao de trabalho site2 tenham sido concludos com xito:
schedule skedc on fr
follows site1#sked4,site2#sked5.joba
No ative sked6 at jobx do fluxo de tarefa skedx no agente de rede cluster4 ter
sido concludo com xito:
sked6 follows cluster4::site4#skedx.jobx
O exemplo a seguir especifica para no ativar o jobd at que o joba no mesmo

fluxo de tarefas e o job3 no fluxo de tarefas skeda tenham sido concludos com
xito:
jobd follows joba,skeda.job3
dias livres
Utilize dias livres para especificar o nome de um calendrio de dias livres que
lista os dias livres para sua empresa. Se e como um fluxo de tarefa executado
nestes dias especficos definido em uma regra freedays durante a configurao do
ciclo de execuo. O Tivoli Workload Scheduler utiliza esse calendrio como base
para calcular os dias teis do fluxo de tarefas.
A palavra-chave afeta somente o planejamento dos fluxos de job para os quais
especificada.
Sintaxe
freedays Calendar_Name [-sa] [-su]
211
Argumentos
Calendar_Name
O nome do calendrio que deve ser utilizado como o calendrio de dias
livres para o fluxo de tarefa. Se Calendar_Name no estiver no banco de
dados, o Tivoli Workload Scheduler emitir uma mensagem de aviso
quando voc salvar o fluxo de tarefas. Se Calendar_Name no estiver no
banco de dados quando o comando schedulr for executado, o Tivoli
Workload Scheduler emitir uma mensagem de erro e utilizar o
calendrio padro holidays no lugar. No utilize os nomes de dias da
semana para nomes de calendrio.
-sa
Sbados so dias teis.
-su
Domingos so dias teis.
Comentrios
Se voc especificar um calendrio de dias de folga na definio de fluxo de tarefa,
ento o conceito de workdays ter o seguinte valor: workdays = todos os dias excluindo
sbado e domingo (a menos que voc tenha especificado -sa ou -su juntamente com dias
livres) e excluindo todas as datas de Calendar_Name
Se voc no especificar freedays na definio do fluxo de tarefas, ento: workdays =
todos os dias excluindo sbado e domingo e todas as datas do calendrio de feriados.
Por padro, sbado e domingo so considerados como dias livres, a menos que voc
especifique o contrrio incluindo -sa, -su ou ambos aps Calendar_Name.
Exemplos
Selecione o fluxo de tarefa sked2 para execuo em 01/01/2005 e em todos os dias
teis desde que eles no estejam listados no calendrio de dias livres denominado
GERMHOL.
schedule sked2
freedays GERMHOL
on 01/01/2005, workdays
Selecione o fluxo de tarefas sked3 para ser executado dois dias teis anteriores a
cada data do calendrio PAYCAL. Dias teis so todos os dias de segunda a sbado
desde que eles no estejam listados no calendrio de dias livres denominado
USAHOL.
schedule sked3
freedays USAHOL -sa
on PAYCAL -2 workdays
Selecione o fluxo de tarefas sked3 nas datas listadas no calendrio APDATES. Se a

data selecionada for um dia livre, no execute o fluxo de tarefa. Neste exemplo,
domingos e todas as datas listadas no calendrio GERMHOL devem ser considerados
como dias livres. Todos os dias, de segunda a sbado, exceto as datas listadas em
GERMHOL, so dias teis.
schedule sked3
freedays GERMHOL -sa
on APDATES fdignore
Selecione o fluxo de tarefas testsked3 para ser executado todos os dias da semana,
exceto 15/5/2005 e 23/5/2006. Se 23/5/2006 for um dia livre, no o exclua. Neste
212
exemplo, sbados, domingos e todas as datas listadas em GERMHOL devem ser

considerados como dias livres. Todos os dias, de segunda sexta-feira, exceto as
datas listadas em GERMHOL, so dias teis.
schedule testskd3
freedays GERMHOL
on weekdays
except 5/15/2005 fdignore
except 5/23/2006
Selecione o fluxo de tarefas testsked4 para ser executado todos os dias, exceto dois
dias da semana anteriores a cada data listada no calendrio MONTHEND. Se a data a
ser excluda for um dia livre, no o exclua, mas exclua o dia til seguinte mais
prximo. Neste exemplo, dias livres so todas as datas listadas em USAHOL,
enquanto dias teis so todos os dias de segunda a domingo que no so listados
em USAHOL.
schedule testskd4
freedays USAHOL -sa -su
on everyday
except MONTHEND -2 weekdays fdnext
job statement
As tarefas podem ser definidas no banco de dados de forma independente (ou
conforme descrito em Tarefa na pgina 646) ou como parte de fluxos de tarefa.
Em qualquer um dos casos, as alteraes so feitas no banco de dados e no
afetam o plano de produo at o incio de um novo plano de produo.
Sintaxe
Para definir uma tarefa como parte de um fluxo de tarefas, utilize a seguinte
sintaxe na definio do fluxo de tarefas:
[workstation#]jobname [as newname]
{scriptname filename | docommand command}
[tasktype tasktype]
[interactive]
[recovery
Para utilizar uma tarefa j definida no banco de dados na definio do fluxo de
tarefas, defina job statement utilizando a seguinte sintaxe:
[as newname]
Argumentos
as
O nome que voc deseja utilizar para referir-se instncia da tarefa nesse
fluxo de tarefa.
Para obter outras palavras-chave, consulte Tarefa na pgina 646.
213
Comentrios
Ao definir uma tarefa como parte de um fluxo de tarefa, quando a definio do
fluxo de tarefa includa no banco de dados, a nova definio de tarefa tambm
includa e pode ser referida, a partir de ento, tambm de outros fluxos de tarefa.
Nota: Palavras-chave incorretamente digitadas utilizadas em definies de tarefa
levam a definies de tarefa truncada armazenadas no banco de dados. De
fato, a palavra-chave incorreta considerada estranha para a definio de
tarefa e, portanto, interpretada como o nome de tarefa de uma definio
de tarefa adicional. Geralmente, essa interpretao incorreta tambm causa
um erro de sintaxe ou um erro de definio de tarefa inexistente para a
definio de tarefa adicional.
Quando um fluxo de tarefas adicionado ou modificado, os atributos ou opes
de recuperao de suas tarefas tambm so adicionados ou modificados. Lembre-se
de que, quando voc inclui ou substitui um fluxo de tarefas, qualquer modificao
tarefa afetar todos os outros fluxos de tarefas que utilizarem as tarefas. Observe
que o relatrio de referncia cruzada, xref, pode ser utilizado para determinar os
nomes dos fluxos de tarefa, incluindo uma tarefa especfica. Para obter informaes
adicionais sobre o relatrio de referncia cruzada, consulte xref na pgina 487.
Nota: Tarefas planejadas para execuo nas estaes de trabalho marcadas como
ignored e que pertencem a fluxos de tarefas planejados para execuo em
estaes de trabalho ativas so includas no plano apesar de no serem
processadas.
Exemplos
O exemplo a seguir define um fluxo de tarefas com trs tarefas definidas
anteriormente:
schedule bkup on fr at 20:00 :
cpu1#jbk1
cpu2#jbk2
needs 1 tape
cpu3#jbk3
follows jbk1
fim
A definio de fluxo de tarefas a seguir contm instrues de tarefa que adicionam

ou modificam as definies de duas tarefas no banco de dados:
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
fim
keyjob
A palavra-chave keyjob utilizada para marcar uma tarefa como chave no banco
de dados e no plano e para monitorar por aplicativos, como o Tivoli Business
Systems Manager ou o Tivoli Enterprise Console. Consulte o guia Integrao do IBM
Tivoli Workload Scheduler com Outros Produtos para obter informaes sobre como
ativar o mecanismo do mecanismo de chave.
214
Sintaxe
keyjob
Exemplos
O seguinte exemplo
SCHEDULE cpu1#sched1
ON everyday
KEYSCHED
AT 0100
cpu1#myjob1 KEYJOB
END
keysched
A palavra-chave keysched utilizada para marcar um fluxo de tarefas como chave
no banco de dados e no plano e para monitoramento por aplicativos, como o Tivoli
Business Systems Manager. Consulte o guia Integrao do IBM Tivoli Workload
Scheduler com Outros Produtos para obter informaes sobre como ativar o
mecanismo do mecanismo de chave.
Sintaxe
keysched
Exemplos
O seguinte exemplo:
SCHEDULE cpu1#sched1
ON everyday
KEYSCHED
AT 0100
cpu1#myjob1 KEYJOB
END
limite
A palavra-chave limit limita o nmero de tarefas que podem ser executadas
simultaneamente em um fluxo de tarefas na mesma CPU.
Sintaxe
limit joblimit
Argumentos
joblimit
Especifica o nmero de tarefas que podem ser executadas ao mesmo tempo
no fluxo de tarefas. Os valores possveis so 0 a 1024. Se voc especificar 0,
impedir que todas as tarefas sejam ativadas, incluindo aquela com
prioridade configurada como GO ou HI.
Exemplos
O exemplo a seguir limita a cinco o nmero de tarefas que podem ser executadas
simultaneamente no fluxo de tarefas sked2:
215
schedule sked2 on fr
limit 5 :
matching
Configura um padro para os critrios de correspondncia a serem utilizados em
todas as dependncias follows nas quais um critrio de correspondncia no
configurado na definio do fluxo de tarefas ou nas tarefas contidas no fluxo de
tarefas.
Sintaxe
matching {previous |sameday | relative from [+/-] time to [+/-] time
Argumentos
Para obter informaes sobre a palavra-chave utilizada com matching, consulte a
palavra-chave follows na pgina 209.
Exemplos
O exemplo a seguir mostra a definio do fluxo de tarefas SCHED2 que:
v Contm uma job1 que pode ser executada somente hoje se tiver sido executada
ontem.
v Precisa que a instncia do fluxo de tarefas SCHED1 executada no mesmo dia seja
concluda antes da execuo.
SCHEDULE PDIVITA1#SCHED2
ON RUNCYCLE CALENDAR2 CAL1
MATCHING PREVIOUS
FOLLOWS PDIVITA1#SCHED1.@ SAMEDAY
FOLLOWS PDIVITA1#SCHED2.JOB1
:
PDIVITA1#JOB1
PDIVITA1#JOB2
END
Nesta amostra, a dependncia follows externa de PDIVITA1#SCHED2.JOB1 herda os

critrios de correspondncia especificados na palavra-chave matching.
needs
A palavra-chave needs define os recursos que devem estar disponveis antes de
uma tarefa ou fluxo de tarefas ser ativado. possvel utilizar a palavra-chave
needs em uma definio do fluxo de tarefas ou na definio das tarefas contidas,
no em ambas.
Sintaxe
needs [n] [workstation#]resourcename [,...]
Argumentos
n
Especifica o nmero de unidades de recurso necessrias. Valores possveis

so 1 a 1024 para cada instruo needs. O padro 1.
workstation
Especifica o nome da estao de trabalho na qual o recurso foi definido
216
localmente. Se no for especificada, o padro a estao de trabalho na

qual a tarefa ou o fluxo de tarefas dependente executado. Os recursos
podem ser utilizados como dependncias somente por tarefas e fluxos de
tarefas que so executados na estao de trabalho onde o recurso est
definido.
Devido ao mecanismo de resoluo de dependncias de recursos, uma
dependncia de recurso no nvel do fluxo de tarefas pode ser considerado
'local' (e, ento, seu uso suportado) em vez de 'global', quando o fluxo de
tarefas e todas as suas tarefas forem definidos na mesma estao de
trabalho que o recurso.
No entanto, um agente padro e seu host podem fazer referncia aos
mesmos recursos.
resourcename
Especifica o nome do recurso.
Comentrios
Uma tarefa ou um fluxo de tarefas pode solicitar no mximo 1024 unidades de um
recurso em uma instruo needs. No tempo de execuo, cada instruo needs
convertida em holders , cada um contendo no mximo 32 unidades de um recurso
especfico. Independentemente da quantidade de unidades disponveis do recurso,
para um nico recurso, pode haver no mximo 32 portadores. Se 32 portadores j
estiverem definidos para um recurso, a prxima tarefa ou fluxo de tarefa que est
aguardando esse recurso espera at um portador atual ser encerrado E a
quantidade necessria de recursos tornar-se disponvel.
Exemplos
O exemplo a seguir impede que o fluxo de tarefas sked3 seja lanado at que trs
unidades de cputime e duas de tapes se tornem disponveis:
needs 3 cputime,2 tapes :
O recurso jlimit foi definido com duas unidades disponveis. O exemplo a seguir
permite que no mais de duas tarefas sejam executadas simultaneamente no fluxo
de tarefas sked4:
schedule sked4
joba needs 1
jobb needs 1
jobc needs 2
jobd needs 1
fim
on mo,we,fr :
jlimit
jlimit
jlimit
<<executado sozinho>>
jlimit
em
Essa uma palavra-chave de fluxo de tarefas que define quando e com que
freqncia um fluxo de tarefas ser selecionado para execuo. Se omitido, o fluxo
de tarefas no includo no plano de pr-produo. A palavra-chave on deve vir
depois da palavra-chave schedule. Consulte except na pgina 208 para obter
217
Sintaxe
on [runcycle name]
[valid from date] [valid to date]
[description text]
Argumentos
runcycle name
Especifica uma etiqueta com um nome amigvel para o ciclo de execuo
especificado nas linhas a seguir.
valid from date ... valid to date
Delimita o espao de tempo durante o qual o fluxo de tarefas est ativo, ou
seja, o fluxo de tarefas includo no plano de produo. Observe que a
data especificada como o valor valid to no est includa no ciclo de
execuo; portanto, nessa data o fluxo de tarefas no est ativo.
description text
Contm uma descrio do ciclo de execuo.
vartable
Especifica o nome da tabela de variveis a ser utilizada pelo ciclo de
execuo.
date
Especifica um ciclo de execuo que executado em datas especficas. A

sintaxe utilizada para esse tipo :
yyyymmdd [,yyyymmdd][,...]Por exemplo, para um fluxo de tarefas que
planejado para execuo em 25 de maio de 2009 e em 12 de junho de 2009,
o valor :
em
20090525,20090612
day
Especifica um ciclo de execuo que executado em dias especficos. A

sintaxe utilizada para esse tipo :
{mo|tu|we|th|fr|sa|su}Por exemplo, para um fluxo de tarefas que est
planejado para execuo toda segunda-feira, o valor :
em
mo
calendrio
As datas especificadas com este nome em um calendrio. O nome do
calendrio pode vir seguido de um deslocamento no seguinte formato:
{+ | -}n {day[s] | weekday[s] | workday[s]}
Onde:
218
O nmero de dias, dias da semana (menos sbado e domingo) ou

dias teis.
days
Todos os dias da semana.
weekdays
Todos os dias da semana, exceto sbado e domingo.
dias teis
Todos os dias da semana, exceto para Sbados e Domingos (a
menos que seja especificado de outra forma com a palavra-chave
freedays) e para as datas marcadas em um calendrio de dias
livres designado ou no calendrio holidays.
request Seleciona o fluxo de tarefas somente quando solicitado. Isto utilizado
para fluxos de job que so selecionados por nome em vez de data. Para
evitar que um fluxo de tarefa planejado seja selecionado para JnextPlan,
altere sua definio para ON REQUEST.
Nota: Ao tentar executar um fluxo de tarefas que contenha horrios "on
request", considere que:
v "On request" sempre antecede "at".
v "On request" nunca antecede "on".
icalendar
Representa um padro utilizado para especificar uma regra recorrente que
descreve quando um fluxo de tarefa executado.
A sintaxe utilizada para o ciclo de execuo com tipo icalendar o seguinte:
FREQ={DAYLY|WEEKLY|MONTHLY|YEARLY}
[;INTERVAL=[-]n]
[;{BYFREEDAY|BYWORKDAY|BYDAY=weekday_list|
BYMONTHDAY=monthday_list}]
em que o valor padro para a palavra-chave INTERVAL 1.
Utilizando icalendar possvel especificar que um fluxo de tarefa seja
executado:
a cada n dias
utilizando o seguinte formato:
FREQ=DAILY[;INTERVAL=n]
em que o valor configurado para valid from o primeiro dia das
datas resultantes.
Por exemplo, para um fluxo de tarefas que est planejado para
execuo diariamente, o valor :
FREQ=DAILY
Para um fluxo de tarefa que est planejado para execuo a cada

dois dias, o valor :
FREQ=DAILY;INTERVAL=2
todo dia livre ou til

FREQ=DAILY[;INTERVAL=n]
;BYFREEDAY|BYWORKDAY
Por exemplo, para um fluxo de tarefa que est planejado para
executar todo dia livre o valor :
FREQ=DAILY;BYFREEDAY
219

dois dias teis, o valor :
FREQ=DAILY;INTERVAL=2;BYWORKDAY
a cada n semanas em weekdays especficos

FREQ=WEEKLY[;INTERVAL=n]
;BYDAY=weekday_list
em que o valor configurado para weekday_list
[SU][,MO][,TU][,WE][,TH][,FR][,SA]

execuo toda semana na sexta-feira e no sbado, o valor :
FREQ=WEEKLY;BYDAY=FR,SA

trs semanas na sexta-feira, o valor :
FREQ=WEEKLY;INTERVAL=3;BYDAY=FR
a cada n meses em datas especficas do ms

FREQ=MONTHLY[;INTERVAL=n]
;BYMONTHDAY=monthday_list
em que o valor configurado para monthday_list representado por
uma lista de
[+number_of_day_from_beginning_of_month]
[-number_of_day_from_end_of_month]
[number_of_day_of_the_month]

execuo mensal no 27 dia, o valor :
FREQ=MONTHLY;BYMONTHDAY=27

seis meses no 15 e no ltimo dia do ms, o valor :
FREQ=MONTHLY;INTERVAL=6;BYMONTHDAY=15,-1
a cada n meses em dias especficos de semanas especficas

FREQ=MONTHLY[;INTERVAL=n]
;BYDAY=day_of_m_week_list
em que o valor configurado para day_of_m_week_list representado
por uma lista de
[+number_of_week_from_beginning_of_month]
[-number_of_week_from_end_of_month]
[weekday]

execuo mensal na primeira segunda-feira e na ltima sexta-feira,
o valor :
FREQ=MONTHLY;BYDAY=1MO,-1FR

seis meses na 2 sexta-feira, o valor :
220
FREQ=MONTHLY;INTERVAL=6;BYDAY=2TU
a cada n anos
FREQ=YEARLY[;INTERVAL=n]
em que o valor configurado para valid from o primeiro dia das
datas resultantes.
execuo anualmente, o valor :
FREQ=YEARLY
Para um fluxo de tarefas planejado para execuo a cada dois anos,

o valor :
FREQ=YEARLY;INTERVAL=2
fdignore|fdnext|fdprev
Indica a regra a ser aplicada se a data selecionada para executar a tarefa ou
fluxo de tarefa cair em um dia livre. As configuraes disponveis so:
fdignore
No incluir a data.
fdnext Inclua o dia til mais prximo aps o dia livre.
fdprev
Inclua o dia til mais prximo antes do dia livre.
Comentrios
possvel definir vrias ocorrncias da palavra-chave on para o mesmo fluxo de
tarefas. Vrias ocorrncias on devem ser consecutivas dentro da definio de fluxo
de tarefas. Cada ocorrncia equivale a um ciclo de execuo ao qual se pode
associar uma regra para dia livre.
Cada ocorrncia da palavra-chave pode conter qualquer um dos valores permitidos
pela sintaxe on.
Se os horrios de incio do ciclo de execuo e do fluxo de tarefas forem definidos,
o horrio de incio do ciclo de execuo ter precedncia quando o fluxo de tarefas
for planejado com JNextPlan. Quando o fluxo de tarefas for ativado com o
comando submit, o horrio de incio do ciclo de execuo no ser utilizado.
Exemplos
O exemplo a seguir seleciona o fluxo de tarefas sked1 s segundas e quartas-feiras:
schedule sked1 on mo,we
O exemplo a seguir seleciona o fluxo de tarefas sked3 em 15 de junho de 2008 e

nas datas listadas no calendrio apdates:
schedule sked3 on 6/15/08,apdates
O exemplo a seguir seleciona o fluxo de tarefas sked4 em dois dias da semana

antes de cada data que aparece no calendrio monthend:
schedule sked4 on monthend -2 weekdays
221
O exemplo a seguir seleciona o fluxo de tarefas testskd1 todos os dias da semana,

exceto s quartas-feiras:
except we
O exemplo a seguir seleciona o fluxo de tarefas testskd3 todos os dias da semana,

exceto em 15 de maio de 2008 e em 24 de maio de 2008:
except 05/16/2008,05/24/2008
O exemplo a seguir seleciona o fluxo de tarefas testskd4 todos os dias, exceto em

dois dias da semana antes de qualquer data que aparea em um calendrio
chamado monthend:
schedule testskd4 on everyday
except monthend -2 weekdays
Selecione o fluxo de tarefas sked1 para ser executado todas as segundas e

sextas-feiras e em 29/12/2009. Se segundas-feiras e 29/12/2009 forem dias livres,
execute o fluxo de tarefa no dia til seguinte mais prximo. Se sextas-feiras forem
dias livres, execute o fluxo de tarefa no dia precedente mais prximo. Neste
exemplo, os dias livres so sbados, domingos e todas as datas listadas no
calendrio HOLIDAYS padro. Os dias teis so todos os dias, de segunda
sexta-feira, que no estiverem listados no calendrio HOLIDAYS.
schedule sked1
on mo, 12/29/2009 fdnext
on fr fdprev
Este exemplo mostra a sada do comando de exibio do fluxo de tarefa testcli

definido para execuo em diferentes ciclos de execuo na estao de trabalho
site2:
display js=site2#testcli
obtido em formato de 120 colunas, configurando MAESTROCOLUMNS=120 antes

de acessar a linha de comandos composer:
JobstreamName Workstation Draft Valid From Valid To UpdatedBy UpdatedOn LockedBy
------------- ----------- ----- -------- ------- --------- --------- -------TESTCLI
SITE2
Y
08/25/2008 mdmDBE4
08/25/2008 mdmDBE4
SCHEDULE W5#TESTCLI VALID FROM 08/25/2008 TIMEZONE ACT
DESCRIPTION "Job stream with several run cycle settings."
DRAFT
ON RUNCYCLE M5 VALID FROM 08/25/2008
DESCRIPTION "monthly"
"FREQ=MONTHLY;INTERVAL=5;BYMONTHDAY=-3,1"
( AT 0000 )
ON RUNCYCLE W4 VALID FROM 08/25/2008
DESCRIPTION "weekly"
"FREQ=WEEKLY;INTERVAL=5;BYDAY=MO,WE"
FDNEXT ( AT 0000 )
ON RUNCYCLE D3 VALID FROM 08/25/2008
DESCRIPTION "daily"
"FREQ=DAILY;INTERVAL=2"
FDPREV ( AT 0000 )
ON RUNCYCLE C2 VALID FROM 08/25/2008
DESCRIPTION "calendar"
ITALY +2 DAYS
( AT 0000 )
ON RUNCYCLE M6 VALID FROM 08/25/2008
DESCRIPTION "monthly"
"FREQ=MONTHLY;INTERVAL=2;BYDAY=1MO,1TH,2WE"
222
( AT 0000 +2 DAYS )
ON RUNCYCLE Y7 VALID FROM 08/25/2008
DESCRIPTION "yearly"
"FREQ=YEARLY;INTERVAL=7"
( AT 0100 )
ON RUNCYCLE SS1 VALID FROM 08/25/2008
08/10/2008,08/18/2008,08/20/2008,08/25/2008
( AT 0000 UNTIL 0000 +1 DAYS ONUNTIL SUPPR DEADLINE 0000 +2 DAYS )
EXCEPT RUNCYCLE S1 VALID FROM 08/25/2008
DESCRIPTION "simple"
08/26/2008,08/28/2008,08/30/2008,09/13/2008
( AT 0000 )
CARRYFORWARD
MATCHING SAMEDAY
FOLLOWS LAB235004#SROBY2.@
FOLLOWS X8#COPYOFJS2.RR
FOLLOWS XA15::TPA
KEYSCHED
LIMIT 22
PRIORITY 15
:
X8#PIPPO AS JOBTC
CONFIRMED
PRIORITY 13
KEYJOB
FOLLOWS W5#POPO.@
FOLLOWS X8#JS2.F3
END
AWSBIA291I Total objects: 1
O calendrio ITALY um calendrio customizado definido no banco de dados que

configura os dias teis e os feriados do calendrio em utilizao na Itlia.
opens
Especifica os arquivos que devem estar disponveis antes de uma tarefa ou fluxo
de tarefas ser lanado.
Sintaxe
opens [workstation#]"filename" [(qualifier)] [,...]
Argumentos
estao de trabalho
na qual o arquivo existe. O padro a estao de trabalho ou classe de
estao de trabalho da tarefa ou fluxo de tarefas dependente. Se voc
utilizar uma classe de estao de trabalho, ela dever ser a mesma daquela
do fluxo de tarefas que inclui esta instruo.
nome do arquivo
Especifica o nome do arquivo, entre aspas. possvel utilizar os
parmetros do Tivoli Workload Scheduler como toda a cadeia de nome de
arquivo ou parte dela. Se utilizar um parmetro, ele dever ser colocado
entre acentos circunflexos (^). Consulte Definio do parmetro do banco
de dados na pgina 185 para obter informaes adicionais e exemplos.
qualifier
Especifica uma condio de teste vlida. No UNIX, o qualificador
transmitido a um comando test, que executado como root em bin/sh.
223
No Windows, a funo de teste executada como o usurio do Tivoli

Workload Scheduler.
Os qualificadores vlidos so:
-d %p Verdadeiro se o arquivo existir e for um diretrio.
-e %p Verdadeiro se o arquivo existir.
-f %p
Verdadeiro se o arquivo existir e for um arquivo regular.
-r %p
Verdadeiro se o arquivo existir e for legvel.
-s %p Verdadeiro se o arquivo existir e seu tamanho for maior que zero.

-w %p Verdadeiro se o arquivo existir e for gravvel.
-a
Operador booleano AND.
-o
Operador booleano OR.
No UNIX e no Windows, a expresso %p utilizada para transmitir o

valor designado para filename para a funo de teste.
Digitar (notempty) o mesmo que digitar (-s %p). Se nenhum qualificador
for especificado, o padro ser -f %p.
Comentrios
A combinao do caminho do arquivo e dos qualificadores no pode exceder 120
caracteres e o nome do arquivo no pode exceder 28 caracteres.
Exemplos
O exemplo a seguir verifica se o arquivo c:\users\fred\datafiles\file88 na
estao de trabalho nt5 est disponvel para acesso leitura antes de lanar
ux2#sked6:
schedule ux2#sked6 on tu opens nt5#"c:\users\fred\datafiles\file88"
O exemplo a seguir verifica se trs diretrios, /john, /mary e /roger, existem sob
/users antes de ativar a tarefa jobr2:
jobr2
opens "/users"(-d %p/john -a -d %p/mary -a -d %p/roger)
O exemplo a seguir verifica se cron criou seu arquivo FIFO antes de lanar o job
job6:
job6
opens "/usr/lib/cron/FIFO"(-p %p)
O exemplo a seguir verifica se o arquivo d:\work\john\execit1 na estao de

trabalho dev3 existe e no est vazio, antes de executar o job jobt2:
jobt2
opens dev3#"d:\work\john\execit1"(notempty)
O exemplo a seguir verifica se o arquivo c:\tech\checker\startf na estao de

trabalho nyc existe, se no est vazio e se gravvel, antes de executar o job job77:
job77
opens nyc#"C:\tech\checker\startf"(-s %p -a -w %p)
Segurana para Comandos test(1):

No UNIX, um recurso de segurana especial evita a utilizao no autorizado de
outros comandos no qualificador. Por exemplo, o arquivo a seguir contm um
comando no qualificador:
/users/xpr/hp3000/send2(-n "`ls /users/xpr/hp3000/m*`" -o -r %p)
224
Se o qualificador contiver outro comando, as seguintes verificaes sero feitas:

v A opo local jm no root deve ser configurada para no.
v No arquivo de segurana, o usurio que documenta o planejamento ou que
inclui a dependncia Open Files com um comando conman adddep, deve ter
acesso submit a um job com os seguintes atributos:
name=cmdstest.fileeq
logon=root
jcl=o caminho dos arquivos abertos
cpu=a CPU na qual os arquivos abertos residem
Observe que cmdstest e fileeq no existem.
prioridade
Define a prioridade de uma tarefa ou fluxo de tarefas. A designao de uma
prioridade diferente s tarefas ou fluxos de tarefas permite determinar qual ser
iniciado primeiro, se as dependncias forem resolvidas.
Assumindo que as tarefas e os fluxos de tarefas estejam prontos para ativao, se
voc definir uma prioridade para os fluxos de tarefas e para as tarefas nos fluxos
de tarefas:
v O fluxo de tarefas que for iniciado primeiro ser aquele com a prioridade mais
alta.
v Entre as tarefas no fluxo de tarefas com a prioridade mais alta, a tarefa que for
iniciada primeiro ser aquela com a prioridade mais alta.
Sintaxe
priority number | hi | go
Argumentos
nmero
Especifica a prioridade. Os valores possveis so de 0 a 99. Uma prioridade
0 evita que a tarefa ou o fluxo de tarefas seja ativado.
hi
Representa um valor maior do que qualquer valor que possa ser

especificado com um nmero. Quando configurado, a tarefa ou fluxo de
tarefa ativado imediatamente assim que ele esteja livre de todas as
dependncias.
ir
Representa a prioridade mais alta que pode ser configurada. Quando

configurado, a tarefa ou fluxo de tarefa ativado imediatamente assim que
ele esteja livre de todas as dependncias.
Comentrios
Tarefas e fluxos de tarefa com nveis de prioridade hi ou go so ativados assim
que todas as suas dependncias sejam resolvidas. Neste caso:
v Os fluxos de tarefa sunstituem o limite de tarefa da cpu.
v As tarefas substituem o limite de tarefa de cpu, mas elas no substituem o limite
de tarefas planejadas nem o fence de tarefa de cpu.
225
Exemplos
O exemplo a seguir mostra o relacionamento entre as prioridades do fluxo de
tarefas e as prioridades de tarefa. Os dois fluxos de tarefa, sked1 e sked2, tm as
seguintes definies no banco de dados:
schedule sked1 on tu
priority 50
:
job1 priority 15
job2 priority 10
fim
schedule sked2 on tu
priority 10
:
joba priority 60
jobb priority 50
fim
Como o fluxo de tarefas sked1 tem a prioridade mais alta, ento, as tarefas so
ativadas na seguinte ordem: job1, job2, joba, jobb.
Se, em vez disso, as prioridades do fluxo de tarefas forem as mesmas, as tarefas
sero ativadas na seguinte ordem: joba, jobb, job1, job2.
Se o job2 tiver uma dependncia A e o job1 tiver uma dependncia B e a
dependncia A for resolvida (enquanto que a B permanece sem soluo), o job2
ser iniciado antes de job1, embora o job2 tenha uma prioridade inferior do que a
definida para o job1.
prompt
Especifica os prompts que devem ser respondidos afirmativamente antes de uma
tarefa ou fluxo de tarefas ser lanado.
Sintaxe
prompt promptname [,...]
prompt "[: | !]text" [,...]
Argumentos
promptname
Especifica o nome de um prompt no banco de dados. possvel especificar
mais de um promptname separado por vrgulas, mas no pode misturar sob
a mesma palavra-chave prompt prompts definidos no banco de dados com
prompts literais.
text
Especifica um prompt literal como uma cadeia de texto entre aspas (").
Mltiplas cadeias separadas por barra invertida n (\n) podem ser
utilizadas para mensagens longas. Se a cadeia comear com dois pontos (:),
a mensagem ser exibida, mas no ser necessria nenhuma resposta. Se a
cadeia comear com um ponto de exclamao (!), a mensagem ser exibida,
mas no ser gravada no arquivo de log. possvel incluir barra invertida
n (\n) dentro do texto para obter novas linhas.
possvel utilizar um ou mais parmetros como toda a cadeia de texto ou
parte dela. Para utilizar um parmetro, coloque seu nome entre sinais de
226
interpolao (^). Consulte Definio do parmetro do banco de dados na

pgina 185 para obter informaes adicionais e exemplos.
Nota: Quando um aviso local no estiver especificando um parmetro, o
acento circunflexo (^) dever ser precedido por uma barra invertida
(\) ou ocorrero erros no aviso. Em avisos globais, os acentos
circunflexos no precisam ser precedidos por uma barra invertida.
Exemplos
O exemplo a seguir mostra os avisos literal e nomeado. O primeiro um prompt
literal que utiliza um parmetro chamado sys1. Quando uma nica resposta
afirmativa recebida para o aviso nomeado apmsg, as dependncias de job1 e job2
so atendias.
schedule sked3 on tu,th
prompt "All ap users logged out of ^sys1^? (y/n)"
:
job1 prompt apmsg
job2 prompt apmsg
fim
O exemplo a seguir define um aviso literal que aparecer em mais de uma linha.
Ele definido com barra invertida n (\n) no final de cada linha:
prompt "The jobs in this job stream consume \n
an enormous amount of cpu time.\n
Do you want to launch it now? (y/n)"
:
j1
j2 follows j1
fim
schedtime
Representa a hora em que o fluxo de tarefas posicionado no plano. Um valor
designado para schedtime no representa uma dependncia para o fluxo de
tarefas. Enquanto o plano de produo est em progresso, a instncia da tarefa ou
do fluxo de tarefas pode iniciar processamento antes da hora configurada na
palavra-chave schedtime se todas as suas dependncias forem resolvidas e se sua
prioridade permitir que seja iniciada.
Sintaxe
schedtime time [timezone|tz tzname][+nday[s]] [,...]
Argumentos
|
|
time
Especifica um horrio do dia no formato: HHHHmm. Valores possveis vo

de 0000 a 320000.
tzname Especifica o fuso horrio a ser utilizado ao calcular o horrio de incio.

obter os nomes dos fusos horrios. O padro o fuso horrio da estao
de trabalho em que a tarefa ou fluxo de tarefas lanado.
n
Especifica um deslocamento em dias da data e hora de incio planejadas.
227
Comentrios
Diferentemente da chave at, a chave schedtime no representa uma dependncia
de hora, ou seja, no indica uma hora antes da qual uma tarefa ou um fluxo de
tarefas no pode ser iniciado. Em vez disso, o valor especificado na palavra-chave
schedtime utilizado somente para posicionar a tarefa ou instncia do fluxo de
tarefas especfica no plano de pr-produo. Enquanto o plano de produo est
em progresso, a instncia da tarefa ou do fluxo de tarefas pode iniciar
processamento antes da hora configurada na palavra-chave schedtime se todas as
suas dependncias forem resolvidas e se sua prioridade permitir que seja iniciada.
Para obter uma explicao sobre como a palavra-chave schedtime utilizada para
identificar predecessores no plano de pr-produo, consulte Gerenciando
Dependncias de Acompanhamentos Externos para Tarefas e Fluxos de Tarefas na
pgina 57.
As palavras-chave at e schedtime so mutuamente exclusivas. Se schedtime no
for especificada e a palavra-chave at for especificada na tarefa ou fluxo de tarefas,
seu valor ser utilizado para posicionar a instncia no plano de pr-produo.
Se nem a palavra-chave at nem schedtime forem especificadas na definio da
tarefa ou do fluxo de tarefas, supe-se, por padro, ser o valor designado para a
opo global startOfDay configurada no gerenciador de domnio mestre.
Para fluxos de tarefas com uma definio schedtime, o valor do campo Horrio de
Incio exibido na Tivoli Dynamic Workload Console depende da configurao da
opo global enPreventStart (que determina se os fluxos de tarefas sem uma
dependncia at podem ser iniciados imediatamente, sem esperarem pelo ciclo de
execuo especificado no fluxo de tarefas):
v Se enPreventStart estiver configurado como yes, o horrio de incio ser 00h00
convertido para o fuso horrio especificado na interface grfica com o usurio.
v Se enPreventStart estiver configurado como no, o campo de horrio de incio
estar vazio.
Exemplos
Os exemplos a seguir assumem que o dia de processamento do Tivoli Workload
Scheduler comea s 6h.
v O fluxo de tarefas a seguir, selecionado s Teras-feiras, foi planejado para iniciar
s 3h na manh de Quarta-feira. Suas duas tarefas so ativadas assim que
possvel aps o fluxo de tarefas comear a ser processado.
schedule sked7 on tu schedtime 0300:
job1
job2
fim
v O fuso horrio da estao de trabalho sfran est definido como

America/Los_Angeles e o fuso horrio da estao de trabalho nycity est
definido como America/New_York. O fluxo de tarefas sked8 foi selecionado
para execuo na Sexta-feira. Ele foi planejado para iniciar na estao de
trabalho sfran s 10h no horrio de America/Los_Angeles no Sbado (conforme
especificado pelo deslocamento + 1 dia). A tarefa job1 ativada no sfran assim
que possvel aps o incio do processamento do fluxo de tarefas. A tarefa job2
ativada em sfran s 14h do sbado no horrio de America/New_York (11h no
horrio de America/Los_Angeles). O job3 ativado na estao de trabalho
nycity s 16h de sbado de America/New_York (13h de America/Los_Angeles).
228
sfran#schedule sked8 on fr schedtime 1000 + 1 day:

job1
job2 at 1400 tz America/New_York
nycity#job3 at 1600
fim
planejamento
Especifica o nome do fluxo de tarefas. Com exceo dos comentrios, essa deve ser
a primeira palavra-chave em um fluxo de tarefas e deve vir seguida da
palavra-chave on.
Sintaxe
schedule [workstation#]jstreamname
Argumentos
workstation
Especifica o nome da estao de trabalho na qual o fluxo de tarefas
lanado. O padro a estao de trabalho na qual o composer executado
para incluir o fluxo de tarefas.
jstreamname
Especifica o nome do fluxo de tarefas. O nome deve iniciar com uma letra
e pode conter caracteres alfanumricos, traos e sublinhados. Ele pode
conter at 16 caracteres.
timezone|tz tzname
Especifica o fuso horrio a ser utilizado ao gerenciar o fluxo de tarefas.
Essa configurao ser ignorada se a opo global enTimeZone estiver
configurada para no no gerenciador de domnio mestre. Para obter
informaes sobre as configuraes do fuso horrio, consulte Captulo 13,
Gerenciando fusos horrios, na pgina 523.
Comentrios
Em uma definio de fluxo de tarefas, possvel configurar um fuso horrio para
todo o fluxo de tarefas, utilizando a palavra-chave timezone no intervalo de
validade ou ao especificar as restries de hora, utilizando at, until ou deadline.
Voc tambm pode configurar um fuso horrio para uma tarefa contida em um
fluxo de tarefas, configurando as palavras-chave at, until ou deadline para essa
tarefa.
Independente de se voc est definindo uma tarefa ou um fluxo de tarefas, se voc
utilizar um fuso horrio em uma restrio de hora, por exemplo, at, ento, deve
utilizar o mesmo fuso horrio ao especificar as outras restries de hora, como
deadline e until.
Em uma definio de fluxo de tarefas, possvel configurar um fuso horrio para
todo o fluxo de tarefas e para as tarefas contidas. Esses fuso horrios podem diferir
uns dos outros, nesse caso, o fuso horrio configurado para a tarefa convertido
no fuso horrio configurado para o fluxo de tarefas.
229
Para gerenciar todas as configuraes possveis de fuso horrio, a converso do

fuso horrio que executada ao processar as tarefas e ou fluxos de tarefas na rede
do Tivoli Workload Scheduler realizada respeitando os seguintes critrios:
1. Se um fuso horrio no for configurado para uma tarefa de um fluxo de tarefa,
ento, essa tarefa herda o fuso horrio configurado na estao de trabalho onde
a tarefa est planejada para execuo.
2. Se um fuso horrio no for configurado para um fluxo de tarefas, ento, o fuso
horrio configurado o configurado na estao de trabalho onde est planejada
a execuo do fluxo de tarefas.
3. Se nenhum dos fusos horrios mencionados for configurado, ento, o fuso
horrio utilizado o configurado para o gerenciador de domnio mestre.
Exemplos
Essa a definio do fuso horrio da estao de trabalho sfran definido na estao
de trabalho sfran na qual est configurado o fuso horrio America/New_York. O
fuso horrio configurado para job2 para executar da estao de trabalho LA est
definido como America/Los_Angeles.
schedule sfran#sked8
tz America/New_York
on fr at 1000 + 1 day:
job1
LA#job2 at 1400 tz America/Los_Angeles
fim
fuso horrio
Especifica, no nvel de fluxo de tarefas, o fuso horrio utilizado para calcular o
tempo quando o fluxo de tarefas deve iniciar o processamento.
Sintaxe
timezone|tz tzname
Argumentos
tzname Especifica o nome do fuso horrio. Consulte Captulo 13, Gerenciando
fusos horrios, na pgina 523 para obter os nomes dos fusos horrios.
Comentrios
O fuso horrio especificado no nvel de fluxo de tarefas aplica-se s definies de
tempo para os ciclos de execuo e as restries de tempo (definidas pelas
palavras-chave at, deadline, schedtime e until).
Se voc especificar um fuso horrio para o fluxo de tarefas e um para uma
palavra-chave de restrio de tempo, eles devero ser os mesmos.
Se voc no especificar nenhum fuso horrio, seja no nvel de fluxo de tarefas seja
no nvel de restrio de tempo, o fuso horrio especificado para a estao de
trabalho ser utilizado.
until
Dependendo da definio de objeto, a palavra-chave until pertence a, especifica a
ltima hora em que um fluxo de tarefas deve ser concludo ou a ltima hora em
que uma tarefa pode ser ativada.
230
Sintaxe
until time [timezone|tz tzname][+nday[s]][absolute|abs][onuntil action]
Argumentos
time
Especifica o perodo do dia. Os valores possveis vo de 0000 a 2359.
tzname Especifica o fuso horrio a ser utilizado ao calcular a hora. Consulte

Captulo 13, Gerenciando fusos horrios, na pgina 523 para obter os
nomes dos fusos horrios. O padro o fuso horrio da estao de
trabalho em que a tarefa ou fluxo de tarefas lanado.
Nota: Se uma hora until e uma hora at ou deadline forem especificadas,
os fuso horrios devem ser iguais.
n
Especifica um deslocamento, em dias, da data e hora planejadas.
absolute
Especifica se a data until baseada no dia do calendrio, e no no dia de
produo.
onuntil action
Dependendo da definio de objeto, a palavra-chave until pertence a,
especifica:
v A ao a ser realizada em uma tarefa cuja hora until expirou, mas a
tarefa ainda no foi iniciada.
v A ao a ser realizada em um fluxo de tarefas cuja hora until expirou,
mas o fluxo de tarefas ainda no foi concludo no estado SUCC.
A seguir esto os valores possveis do parmetro action:
suppr A tarefa ou fluxo de tarefas e todas as tarefas ou fluxos de tarefas
dependentes no so executados. Esse o comportamento padro.
Depois que a hora until expira em um fluxo de tarefas, o status do
fluxo de tarefas calculado com as regras usuais; as tarefas
suprimidas no so consideradas no clculo. No caso do fluxo de
tarefas conter pelo menos uma tarefa every, seu status ser HOLD.
Quando a hora until de uma tarefa expirar, a tarefa ser movida
para o status HOLD ou manter qualquer status anterior que for
um status final.
Se a hora until for transmitida juntamente com as opes onuntil
suppr e carryforward, o fluxo de tarefas ser transferido por
JnextPlan somente se a data until for igual nova data do fluxo
de tarefas. Se a data until e a nova data do fluxo de tarefas no
forem iguais, o fluxo de tarefas no ser transferido.
cont
O job ou o fluxo de job executado quando todas as condies

necessrias so atendidas e uma mensagem de notificao
gravada no log quando a hora until decorre.
cont e carryforward, o fluxo de tarefas ser sempre transferido por
JnextPlan.
canc
Uma tarefa ou um fluxo de tarefas cancelado quando a hora

until especificada expira. Ao utilizar onuntil canc nas tarefas, a
operao de cancelamento na tarefa ser emitida pelo FTA no qual
a tarefa executada. Todas as tarefas ou fluxos de tarefas
231
dependentes da concluso de uma tarefa ou um fluxo de tarefa que

foi cancelado, sero executados porque a dependncia no existe
mais.
canc e carryforward, o fluxo de tarefas no ser transferido por
JnextPlan, pois ele j est cancelado.
Nota: Ao utilizar onuntil canc no nvel do fluxo de tarefas, defina
como proprietrio do fluxo de tarefas a estao de trabalho
superior na hierarquia do ambiente de planejamento, entre
todas as estaes de trabalho que possurem tarefas contidas
Nota: As palavras-chave until e deadline podem ser utilizadas na mesma
definio, mas devem ser expressas com a mesma definio de fuso horrio.
Exemplos
O exemplo a seguir evita que sked1 seja ativado depois das 17h s teras-feiras:
schedule sked1
on tu
until 1700 :
O exemplo a seguir ativa sked1 s 17h, quando sua hora until alcanada:
schedule sked1 until 1700 onuntil cont
O exemplo a seguir ativa o job1 entre as 13h e as 17h nos dias de semana:
schedule sked2 on weekdays :
job1 at 1300 until 1700
fim
O exemplo a seguir ativa o joba a cada 15 minutos entre as 22h30 e as 23h30 s

segundas-feiras:
schedule sked3 on mo :
joba at 2230 every 0015
fim
until 2330
O exemplo a seguir ativa o fluxo de tarefas sked4 aos domingos entre as 8h e as

13h. As tarefas devem ser ativadas dentro deste intervalo:
schedule sked4 on fr at 0800 + 2 days
until 1300 + 2 days
:
job1
job2 at 0900 <<lanado no domingo>>
job3 follows job2 at 1200 <<lanado no domingo>>
fim
O exemplo a seguir ativa o fluxo de tarefas sked8 em dias da semana s 16h e a

execuo deve ser concluda s 17h. Se o fluxo de tarefas no for concludo s 17h,
ele ser considerado atrasado. Os jobs so ativados da seguinte maneira: o job1
executado s 16h ou o mais tardar, s 16h20, e se o job1 ainda no tiver sido
iniciado nessa hora, ser gravada uma mensagem de notificao no log e a
execuo ser iniciada. O job2 executado s 16h30, ou o mais tardar s 16h50, e
se o job2 no for iniciado nessa hora, ele ser cancelado.
schedule sked8 on weekdays at 1600 deadline 1700 :
job1 at 1600 until 1620 onuntil cont
job2 at 1630 until 1650 onuntil canc
fim
232
O exemplo a seguir ativa o fluxo de job sked01. Quando o evento until ocorre, o
fluxo de job sked02 executado porque o fluxo de job sked01 est colocado no
estado SUCC. O fluxo de job sked03, por sua vez, no executado porque tinha
uma dependncia de tempo exata no job job01 que no foi liberada.
SCHEDULE sked01 on everyday:
job01 until
2035 onuntil suppr
fim
SCHEDULE sked02 on everyday follows sked01.@
:
job02
fim
SCHEDULE sked03 on everyday follows
:
job03
END
sked01.job01
validfrom/validto
possvel configurar uma hora de validade para um fluxo de tarefas, que o
espao de tempo no qual o fluxo de tarefas est includo no plano de
pr-produo. A hora de validade configurada utilizando a chave validfrom na
definio do fluxo de tarefas.
Sintaxe
validfrom date
Argumentos
validfrom date
Define a partir de qual data o fluxo de tarefas est ativo, ou seja, ele deve
ser includo em um plano de produo se a durao do plano de produo
incluir essa data.
Comentrios
Diferentes verses do mesmo fluxo de tarefa podem ser definidas criando-se fluxos
de tarefa diferentes com o mesmo nome e estao de trabalho, mas tendo
diferentes intervalos de validade. O conceito de verses do mesmo fluxo de tarefas
compartilhando o mesmo jobstreamname e o mesmo workstationname chave ao
gerenciar dependncia desse fluxo de tarefas. Na verdade, ao definir dependncias
follows externas em um fluxo de tarefas, voc identifica o fluxo de tarefas
predecessor, utilizando seu jobstreamname e workstationname. O fluxo de tarefas
identificado como a dependncia aquele cujo intervalo de validade durante o
perodo em que a dependncia est ativa.
Se voc alterar o jobstreamname ou o workstationname em uma verso do fluxo de
tarefas, a alterao propagada em todas as suas verses.
Se voc bloquear uma verso do fluxo de tarefas, todas as verses desse fluxo de
tarefas so bloqueadas.
Se voc alterar o nome de uma tarefa definida em uma verso do fluxo de tarefas,
ento, o novo nome de tarefa propagado em todas as verses do fluxo de tarefas.
Isso significa que, se voc modificar algo diferente do jobstreamname ou do
workstationname, as associaes internas e externas do fluxo de tarefas permanecem
consistentes.
233
Ao definir uma verso do fluxo de tarefas, solicitado somente digitar a data

validfrom, e a data validto configurada automaticamente para o valor da data
validfrom da prxima verso. A data validto mostrada ao emitir os comandos
list e display quando MAESTROCOLUMNS est configurado para 120. Diferentes
verses do mesmo fluxo de tarefas continuam a compartilhar os campos do nome
e da estao de trabalho aps sua criao. Se voc modificar o nome de uma
verso ou alterar a estao de trabalho na qual foi definida, a alterao aplicada
em todas as verses desse fluxo de tarefas.
Nota: Se as palavras-chave usadas na definio de fluxo de tarefas forem
validfrom e validto, as palavras-chave de filtragem correspondente usadas
na emisso de comandos contra definies de objetos armazenadas no banco
de dados so validfrom e validto. Para obter informaes adicionais,
consulte Captulo 9, Gerenciando Objetos no Banco de Dados - Composer,
na pgina 247.
A data especificada como o valor validto no foi includa no ciclo de execuo,
assim o fluxo de tarefas no est ativo nesta data.
vartable
Utilizando as tabelas de variveis, voc designa valores diferentes para a mesma
varivel e, dessa forma, reutiliza a mesma varivel em definies de tarefas e ao
definir dependncias de aviso e de arquivo.
Sintaxe
vartable tablename
Argumentos
vartable tablename
O nome da tabela de varivel. O nome pode conter at 80 caracteres
alfanumricos, incluindo hifens (-) e sublinhados (_), e deve iniciar com uma
letra.
Definio da Regra de Evento

Uma regra de evento de planejamento define um conjunto de aes que devem ser
executadas na ocorrncia de condies de evento especficas. A definio de uma
regra de evento correlaciona eventos e aciona aes.
Uma definio de regra de evento identificada por um nome da regra e por um
conjunto de atributos que especificam se a regra est no estado de rascunho ou
no, o intervalo de tempo em que ela est ativa, o perodo de tempo de sua
validade e outras informaes necessrias para decidir quando as aes so
acionadas. Ela inclui informaes relacionadas aos eventos especficos
(eventCondition) que a regra deve detectar e as aes especficas que ela deve
acionar em sua (ao) de deteco ou tempo limite. As regras complexas podem
incluir vrios eventos e vrias aes.
Consulte Captulo 7, Automao de Carga de Trabalho Orientada pelo Evento em
Execuo, na pgina 115 para obter uma viso geral do planejamento de regras de
eventos.
234
Sintaxe
Diferente de todas as outras definies de objeto de planejamento, voc define as
regras de eventos diretamente na linguagem XML com a utilizao de qualquer
editor XML. possvel configurar uma varivel de ambiente em seu computador
para abrir automaticamente um editor XML de sua escolha para trabalhar com
definies de regras de eventos. Consulte O Editor do Composer na pgina 248
para obter detalhes. O XML que descreve a regra de evento deve corresponder aos
esquemas de linguagem de regra definidos em EventRules.xsd e em
FilteringPredicate.xsd.
Os esquemas de linguagem de regra definidos em eventRules.xsd e em
FilteringPredicate.xsd so utilizados para validar suas definies de regra e,
dependendo do editor de XML que voc possua, para fornecer ajuda de sintaxe. Os
arquivos esto localizados no subdiretrio schemas do diretrio de instalao do
A seguir est uma lista de todos os elementos de linguagem utilizados para definir
uma regra de evento. O Tabela 40 explica o significado da notao que segue cada
elemento de linguagem. n representa um nmero solto.
Tabela 40. Explicao da Notao que Define o Nmero de Ocorrncias para um Elemento
de Linguagem.
Notao
Significado
(0, 1)
0 indica que o elemento de linguagem opcional. 1

indica que, se codificado, somente 1 ocorrncia
permitida.
(0, n)
0 indica que o elemento de linguagem opcional. n

indica que, se codificado, vrias ocorrncias so
permitidas.
(1, 1)
O primeiro 1 indica que o elemento de linguagem

necessrio. O segundo 1 indica que somente 1
ocorrncia permitida.
(1, 2)
1 indica que o elemento de linguagem necessrio. 2

indica que 2 ocorrncias so necessrias.
(1, n)
1 indica que o elemento de linguagem necessrio. n

indica que vrias ocorrncias so permitidas.
v eventRule name=" " ruleType=" " isDraft=" " (1, 1)

description (0, 1)
timeZone (0, 1)
validity from=" " to=" " (0, 1)
activeTime start=" " end=" " (0, 1)
timeInterval amount=" " unit=" " (0, 1)
eventCondition eventProvider=" " eventType=" " (1, n)
- scope (0, 1)
- filteringPredicate (0, 1)
v attributeFilter name=" " operator="eq" (0, n)
value (1, n)
v attributeFilter name=" " operator="ne" (0, n)
value (1, n)
v attributeFilter name=" " operator="le" (0, n)
value (1, 1)
v attributeFilter name=" " operator="ge" (0, n)
value (1, 1)
235
v attributeFilter name=" " operator="range" (0, 1)

value (1, 2)
correlationAttributes (0, 1)
- attribute name=" " (1, n)
action actionProvider=" " actionType=" " responseType=" " (0, n)
- description (0, 1)
- scope (0, 1)
- parameter name=" "(1, n)
- value (1, 1)
As definies de regras de eventos so agrupadas nos conjuntos de regras de
eventos.
v eventRuleSet (1, 1)
eventRule (1, n)
Utilize o elemento de linguegem eventRuleSet tambm se voc precisar incluir
uma nica definio de regra.
Observe que nenhum dos comentrios que voc possa gravar no XML, no formato
, ser salvo no banco de dados. Na prxima vez que voc abrir uma
definio de regra, os comentrios gravados pela primeira vez sero desfeitos.
Utilize o atributo description para gravar qualquer informao adicional em
substituio.
Argumentos
As palavras-chave que descrevem uma regra de evento so as seguintes tags XML:
eventRule
O objeto de planejamento que inclui a definio de vrias condies de
eventos e vrias aes de regras alm de um conjunto de atributos que
definem quando a regra ativada. Um elemento eventRule geralmente
inclui:
v Um nmero de atributos de regras necessrios e opcionais
v Uma ou mais condies de eventos
v Uma ou mais aes de regras, embora as regras sem aes tambm
sejam permitidas
Os atributos de regras so:
v Atributos necessrios:
name
O nome da regra de evento. Pode ter at 40 caracteres

alfanumricos de comprimento, deve iniciar com uma letra e no
pode conter espaos em branco. Caracteres de sublinhado (_) e
trao (-) so permitidos.
ruleType
O tipo de regra baseado no nmero de eventos - e em suas
correlaes - que a regra est definida para detectar. Pode ser
um dos seguintes:
filter
A regra ativada na deteco de um nico evento

especfico.
sequence
A regra ativada quando uma seqncia ordenada de
eventos chega em um intervalo de tempo especfico.
236
set
A regra ativada quando uma seqncia no ordenada

de eventos chega em um intervalo de tempo especfico.
Regras do tipo set e sequence tambm podem ser ativadas no

timeout, quando um ou mais eventos chegam mas a seqncia
completa no chega dentro do espao de tempo especificado.
isDraft
Especifica se a definio da regra est ativada atualmente. Os
valores podem ser yes ou no. O padro no.
v Atributos opcionais:
description
Uma descrio da regra. Pode ter at 120 caracteres.
Lembre-se de gravar quaisquer caracteres XML especiais que
voc possa utilizar na notao de XML especial, tal como:
& para &
> para >
< para <
" para "
e assim por diante.
timeZone
Especifica um fuso horrio diferente para a execuo da regra. O
fuso horrio padro o fuso horrio definido na estao de
trabalho na qual o servidor de processamento de eventos reside.
A aplicao do DST (Horrio de Vero) tem impacto no intervalo
activeTime (descrito a seguir) das regras de evento:
No dia em que o DST ativado (o relgio adiantado em
uma hora), os tempos de operao da regra previstos para a
hora absorvida pela aplicao do DST so adiantados em uma
hora. Por exemplo, 2h10 torna-se 3h10.
No dia em que o DST desativado (o relgio atrasado em
uma hora), os tempos de operao da regra previstos para a
hora duplicada pela aplicao do DST so observados sem o
DST.
validity
Especifica o perodo de validade da regra em termos de:
de yyyy-mm-dd
O perodo de validade inicia meia-noite (do fuso
horrio da regra) do dia especificado.
at yyyy-mm-dd
O perodo de validade termina meia-noite (do fuso
horrio da regra) do dia especificado.
activeTime
Especifica o espao de tempo da atividade da regra em cada dia
da validade em termos de:
start hh:mm:ss
O incio do espao de tempo em que a regra est ativa
em horas, minutos e segundos.
end hh:mm:ss
O fim do espao de tempo em que a regra est ativa em
237
horas, minutos e segundos. Se a hora for anterior de

incio s hh:mm:ss, ela se refere ao dia seguinte.
timeInterval
Se aplica s regras que incluem aes de tempo limite. Especifica
o intervalo de tempo dentro do qual todos os eventos
especificados na regra devem ter sido recebidos antes de uma
ao corretiva de tempo limite ser iniciada. O intervalo de tempo
se inicia a partir do momento que o primeiro evento especificado
na regra detectado. Especifique o intervalo de tempo em
termos de:
quantidade
A durao do intervalo de tempo em unidades de
tempo.
unidade
A unidade de tempo em um dos seguintes formatos:
horas
segundos
milissegundos
|
|
|
|
|
Este atributo obrigatrio quando h aes de tempo

limite na definio de regra de evento.
|
|
eventCondition
A condio de evento formada pelos seguintes atributos:
v Atributos necessrios:
eventProvider
Identifica o provedor de monitoramento de eventos que pode
capturar um tipo de evento. Os provedores de eventos
fornecidos no momento da instalao so:
TWSObjectsMonitor
Monitora o status dos objetos de planejamento do Tivoli
Workload Scheduler. Este provedor de evento
executado em cada agente do Tivoli Workload Scheduler
e envia os eventos ao servidor de processamento de
eventos.
TWSApplicationMonitor
Monitora os processos, o sistema de arquivos e as caixas
de mensagens do Tivoli Workload Scheduler.
FileMonitor
Monitora os eventos que afetam os arquivos.
eventType
Especifica o tipo de evento que deve ser monitorado. Cada
evento pode ser referido como um provedor de evento. As
tabelas a seguir listam os tipos de eventos por provedor de
evento. Clique nos tipos de eventos para ver suas propriedades.
A tabela Tabela 41 lista os eventos de TWSObjectsMonitor .
Tabela 41. Eventos TWSObjectsMonitor.
Tipo de evento
238
Este evento enviado quando...
JobStatusChanged
o status de uma tarefa alterado
JobUntil
a ltima hora de incio de uma tarefa passou
Tabela 41. Eventos TWSObjectsMonitor. (continuao)

Tipo de evento
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
JobSubmit
uma tarefa enviada
JobCancel
uma tarefa cancelada
JobRestart
uma tarefa reiniciada
JobLate
uma tarefa se torna atrasada
JobStreamStatusChanged
o status de um fluxo de tarefas alterado
JobStreamCompleted
um fluxo de tarefas foi concludo
JobStreamUntil
a ltima hora de incio de um fluxo de tarefas passou
JobStreamSubmit
um fluxo de tarefas enviado
JobStreamCancel
um fluxo de tarefas cancelado
JobStreamLate
um fluxo de tarefas se torna atrasado
WorkstationStatusChanged
uma estao de trabalho iniciada ou parada
ApplicationServerStatusChanged
o WebSphere Application Server integrado parou ou

est reiniciando
ChildWorkstationLinkChanged
a estao de trabalho definida na regra de evento

vincula ou desvincula-se de sua estao de trabalho pai
(a estao de trabalho pai envia o evento)
ParentWorkstationLinkChanged
a estao de trabalho pai vincula ou desvincula-se da

estao de trabalho definida na regra de evento (a
estao de trabalho filha envia o evento)
PromptStatusChanged
um prompt solicitado ou respondido
Nota: Uma regra com tipo de evento

ParentWorkstationLinkChanged no aplicvel quando a
Estao de Trabalho de Filtros est configurada como
agente, conjunto, conjunto dinmico ou mecanismo
remoto, e o atributo ParentWorkstation est configurado
como broker. Para monitorar uma mudana de status do
link entre o servidor do broker de carga de trabalho e
uma estao de trabalho gerenciada pelo servidor do
broker de carga de trabalho, defina uma regra com tipo
de evento igual a ChildWorkstationLinkChanged.
Uma regra com tipo de evento igual a
ChildWorkstationLinkChanged funciona apenas quando a
estao de trabalho do broker est vinculada, com link
removido, parada ou iniciada. Se a mudana no status do
link for devido a uma operao de parada ou incio na
estao de trabalho do agente com os comandos
StartupLwa e ShutdownLwa, nenhuma ao iniciada. Para
monitorar operaes de parada ou incio nas estaes de
trabalho do agente, defina uma regra com um tipo de
evento igual a WorkstationStatusChanged.
A tabela Tabela 42 na pgina 240 lista os eventos
TWSApplicationMonitor.
239
Tabela 42. Eventos TWSApplicationMonitor.

Tipo de evento
MessageQueuesFilling
uma caixa de correio especificada

excede o valor integral de porcentagem.
TivoliWorkloadSchedulerFileSystemFilling
o sistema de arquivos em que a

instncia de Tivoli Workload Scheduler
est instalada excede o valor integral de
porcentagem.
TivoliWorkloadSchedulerProcessNotRunning
um processo especificado no est em

execuo.
A tabela Tabela 43 lista os eventos de FileMonitor.

Tabela 43. Eventos FileMonitor.
Tipo de evento
FileCreated
um arquivo criado
FileDeleted
um arquivo excludo
ModificationCompleted
um arquivo modificado (o evento enviado somente

se dois ciclos de monitoramento consecutivos tiverem
ocorrido desde que o arquivo foi criado ou modificado
sem alteraes adicionais sendo detectadas)
LoggedMessageWritten
uma cadeia especfica localizada em um arquivo (este

evento pode ser utilizado para monitorar aplicativo ou
os logs do sistema)
v Atributos opcionais:
scope
Um ou mais atributo de qualificao que descrevem o evento.

Pode ter at 120 caracteres. O escopo gerado automaticamente
a partir do que definido no XML. Ele no pode ser
especificado pelos usurios.
filteringPredicate
O predicado de filtragem configura as condies de eventos que
devem ser monitoradas para cada tipo de evento. Ele formado
por:
attributeFilter
O filtro do atributo um atributo especfico do tipo de
evento que deve ser monitorado:
definido pelos seguintes elementos:
name
O atributo, ou nome da propriedade, do tipo

de evento que deve ser monitorado. Consulte
Provedores e Definies de Eventos na
pgina 583 para obter uma lista de nomes de
propriedades para cada tipo de evento.
operator
Pode ser:
- eq (igual)
- ne (no igual)
- ge (igual ou maior que)
- le (igual ou menor que)
- range (intervalo)
Inclui um ou mais:
240
valor
O valor no qual o operador deve ser

correspondido.
Observe que cada tipo de evento possui um nmero de atributos

ou nomes de propriedades obrigatrios. Nem todos os nomes de
propriedades obrigatrios possuem valores padro. Todos os
nomes de propriedades obrigatrios sem um valor padro
devem ter um predicado de filtragem definido.
correlationAttributes
Os atributos de correlao fornecem uma maneira de direcionar a regra
para criar uma cpia da regra separada para cada grupo de eventos que
compartilham caractersticas comuns. Em geral, cada regra ativa possui
uma cpia da regra, que executada no servidor de processamento de
eventos. Entretanto, s vezes, a mesma regra necessria para diferentes
grupos de eventos, que geralmente esto relacionados a diferentes grupos
de recursos. Utilizar um ou mais atributos de correlao um mtodo de
direcionar uma regra para criar uma cpia da regra separada para cada
grupo de eventos com caractersticas comuns. Utilize com os tipos de regra
set e sequence.
possvel especificar um ou mais atributos. Cada um definido por:
attribute name=" "
O atributo do objeto que voc est correlacionando.
action A ao que deve ser acionada se o evento for detectado. As definies de
regras de eventos com eventos mas sem aes so aceitas sintaticamente,
embora elas possam no ter significncia prtica. possvel salvar tais
regras como rascunho e incluir aes posteriormente antes delas serem
implementadas.
v Isto definido pelos seguintes atributos necessrios:
actionProvider
O nome do provedor de ao que pode implementar uma ou
mais aes configurveis. Os provedores de ao disponveis no
momento da instalao so:
TECEventForwarder
Redirecionar o evento para um servidor TEC (Tivoli
Enterprise Console) externo (ou qualquer outro
aplicativo capaz de atender os eventos no formato do
TEC).
MailSender
Conecta a um servidor SMTP para enviar um e-mail.
MessageLogger
Registra a ocorrncia de uma situao em um banco de
dados de auditoria interno.
TWSAction
Executa um dos seguintes comandos de conman:
submit job (sbj)
submit job stream (sbs)
submit command (sbd)
reply to prompt (reply)
GenericAction
Executar comandos no-Tivoli Workload Scheduler. Os
comandos so executados no mesmo computador em
que o processador de eventos executado.
actionType
Especifica o tipo de ao que deve ser acionada quando um
241
evento especificado detectado. Cada ao pode ser referida

como um provedor de ao. A tabela a seguir lista os tipos de
ao por provedor de ao. Clique nos tipos de ao para ver
suas propriedades.
Tabela 44. Tipos de Ao por Provedor de Ao.
Provedor de Ao
Tipos de Ao
TECEventForwarder
TECFWD
MailSender
SendMail
MessageLogger
PostOperatorMessage
sbs (SubmitJobStream)
TWSAction
sbj (SubmitJob)
sbd (SubmitAdHocJob)
reply (ReplyPrompt)
GenericAction
RunCommand
responseType
Especifica quando a ao deve ser executada. Os valores podem
ser:
onDetection
A ao iniciada assim que todos os eventos definidos
na regra tiverem sido detectados. Aplica-se a todos os
tipos de regra. Consulte tambm Notas sobre a
operao de regras na pgina 130.
onTimeOut
A ao iniciada aps o tempo especificado em
timeInterval ter expirado mas nem todos os eventos
definidos na regra terem sido recebidos. Aplica-se
somente s regras set e sequence.
Observe que as aes de tempo limite no sero
executadas se voc no especificar um intervalo de
tempo. O planejador, entretanto, permitir que voc
salve as regras de eventos nas quais as aes de tempo
limite foram definidas sem a especificao de um
intervalo de tempo, pois ser possvel configurar o
intervalo de tempo posteriormente. At l, somente as
aes com o tipo de resposta onDetection sero
processadas.
As aes de tempo limite para as quais um intervalo de
tempo no foi definido so executadas apenas quando as
regras so desativadas. Uma regra de evento
desativada em um dos dois casos:
O comando planman deploy -scratch emitido
A regra modificada (em seguida, desativada assim
que o comando planman deploy executado)
Em qualquer um dos casos, a regra primeiro
desativada e depois reativada. Nesse momento, todas as
aes pendentes so executadas.
v Inclui os seguintes atributos opcionais:
description
Uma descrio da ao. Pode ter at 120 caracteres.
242
Lembre-se de gravar quaisquer caracteres XML especiais que

voc possa utilizar na notao de XML especial, tal como:
& para &
> para >
< para <
" para "
e assim por diante.
Um ou mais atributos de qualificao que descrevem a ao.
Pode ter at 120 caracteres. O escopo gerado automaticamente
a partir do que definido no XML. Ele no pode ser
especificado pelos usurios.
v Inclui uma lista de um ou mais parmetros ou nomes de propriedades.
Todos os tipos de ao possuem pelo menos um parmetro obrigatrio.
Cada parmetro definido por:
parameter name=" "
Consulte Provedores e Definies de Ao na pgina 596 para
obter uma lista de parmetros, ou nomes de propriedades,
disponveis para cada tipo de ao.
valor Consulte Provedores e Definies de Ao na pgina 596 para
obter uma lista dos possveis valores ou tipos de valores.
scope
possvel utilizar a substituio de varivel. Isto significa que, quando

voc definir os parmetros de ao, poder utilizar os nomes de
propriedades dos eventos que acionam a regra de evento para substituir
o valor do nome da propriedade da ao. Para fazer isso, grave o valor
do parmetro da ao que pretende substituir de uma das duas
seguintes maneiras:
${event.property}
Substitui o valor no estado em que se encontra. Isso til para
transmitir as informaes para uma ao que funciona
programaticamente com elas, por exemplo, o schedTime de um fluxo
de tarefas.
%{event.property}
Substitui o valor formatado em formato legvel a humanos. Isso til
para passar as informaes para uma ao que encaminha essas
informaes a um usurio, por exemplo para formatar o schedTime de
um fluxo de tarefas no corpo de um e-mail.
Onde:
evento
o nome configurado para o acionamento de eventCondition.
propriedade
o nome de attributeFilter no predicado de filtragem da
condio do evento de acionamento. O valor obtido pelo filtro
do atributo quando a regra acionada substitudo como um
valor de parmetro na definio da ao antes que ela seja
executada.
Observe que voc tambm pode utilizar a substituio de
varivel quando nenhum attributeFilter foi especificado para
um atributo e quando o atributo for de leitura.
Por exemplo, a tarefa de uma regra de evento detectar quando
qualquer uma das tarefas que possuem um nome que comea com job15
finalizada com erro e, quando isso acontece, enviar essa tarefa
novamente. A seo eventCondition da regra codificada conforme a
seguir:
243
<eventCondition
name=event1
eventProvider=TWSObjectsMonitor
eventType=JobStatusChanged>
<attributeFilter name=JobName operator=eq>
<value>job15*</value>
</attributeFilter>
<attributeFilter name=Workstation operator=eq>
<value>*</value>
</attributeFilter>
<attributeFilter name=Status operator=eq>
<value>Error</value>
</attributeFilter>
</eventCondition>
Caracteres curingas (* para diversos caracteres ou ? para caracteres

nicos) so usados para generalizar a condio de evento desejada para
todas as instncias da tarefa cujo nome inicia com job15 e para sua
estao de trabalho associada. A substituio da varivel utilizada na
seo action para enviar novamente a tarefa especfica que finalizou
com erro na mesma estao de trabalho. A seo action :
<action actionProvider=TWSAction actionType=sbj
responseType=onDetection>
<description>Submit again the job that ended in error</description>
<parameter name=JobDefinitionName>
<value>${event1.JobName}</value>
</parameter>
<parameter name=JobDefinitionWorkstationName>
<value>${event1.Workstation}</value>
</parameter>
</action>
Exemplos
JOB7 possui uma dependncia de arquivo em DAILYOPS.XLS. Assim que o arquivo
recebido, JOB7 deve iniciar o processamento do arquivo. Os seguintes controles de
regras que JOB7 inicia dentro de um minuto aps a transferncia de DAILYOPS.XLS
so concludos. Se isso no acontecer, um e-mail ser enviado ao operador evening.
Isto realizado pela definio de duas condies de eventos seqenciais que
precisam monitorar:
1. O primeiro evento que aciona a regra a criao do arquivo DAILYOPS.XLS na
estao de trabalho qual ele deve ser transferido. Assim que este evento for
detectado, uma instncia da regra ser criada e uma contagem com intervalo de
um minuto ser iniciada para detectar a prxima condio de evento.
2. O segundo evento o envio de JOB7. Se este evento falhar em ser detectado no
intervalo de tempo especificado, a regra ter o tempo limite excedido e a ao
SendMail ser iniciada.
a?xml version=1.0?>
aeventRuleSet xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns=http://www.ibm.com/xmlns/prod/tws/1.0/event-management/rules
xsi:schemaLocation=http://www.ibm.com/xmlns/prod/tws/1.0/event-management/rules
EventRules.xsd>
<eventRule
name=sample_rule
ruleType=sequence
isDraft=no>
<description>An email is sent if job JOB7 does not start
within
a minute after file DAILYOPS.XLS is created</description>
<timeZone>America/Indianapolis</timeZone>
244
<validity from=2007-01-01 to=2007-12-31 />

<activeTime start=20:00:00 end=22:00:00 />
<timeInterval amount=60 unit=seconds />
<eventCondition
name=DAILYOPS_FTPed_event
eventProvider=FileMonitor
eventType=FileCreated>
<attributeFilter name=FileName operator=eq>
<value>c:/dailybus/DAILYOPS.XLS</value>
</attributeFilter>
<value>ACCREC03</value>
</attributeFilter>
<attributeFilter name=SampleInterval operator=eq>
<value>300</value>
</attributeFilter>
</eventCondition>
<eventCondition
name=job_JOB7_problem_event
eventProvider=TWSObjectsMonitor
eventType=JobSubmit>
<attributeFilter name=JobStreamWorkstation operator=eq>
</attributeFilter>
</attributeFilter>
<attributeFilter name=JobStreamName operator=eq>
<value>JSDAILY</value>
</attributeFilter>
<attributeFilter name=JobName operator=eq>
<value>JOB7</value>
</attributeFilter>
</eventCondition>
<action actionProvider=MailSender actionType=SendMail responseType=onTimeOut>
<description>Send email to evening operator stating job did not start
</description>
<parameter name=To>
<value>eveoper@bigcorp.com</value>
</parameter>
<parameter name=Subject>
<value>Job JOB7 failed to start within scheduled time on
workstation ACCREC03.</value>
</parameter>
</action>
</eventRule>
</eventRuleSet>
Observe que o escopo no mostra a primeira vez que a regra definida.

V para Exemplos de Regras de Eventos na pgina 125 para localizar mais
exemplos de regras de eventos.
Consulte tambm
Para criar uma definio de regra de evento no Dynamic Workload Console :
Regras de Evento
3. Especifique suas opes no painel Editor de Regras de Eventos.
245
246
Captulo 9. Gerenciando Objetos no Banco de Dados Composer

Este captulo descreve como utilizar o programa de linha de comandos composer
para gerenciar os objetos de planejamento no banco de dados do Tivoli Workload
Scheduler. Ela est dividida nas seguintes sees:
v Configurando o Programa fe Linha de Comandos composer
v Executando Comandos a partir do Composer na pgina 251
v Composer commands na pgina 256
Configurando o Programa fe Linha de Comandos composer

O programa de linha de comandos composer gerencia objetos de planejamento no
banco de dados.
Voc deve instalar o recurso do Cliente da Linha de Comando do Tivoli Workload
Scheduler nos agentes tolerantes a falhas e sistemas fora da rede do Tivoli
Workload Scheduler para utilizar o programa da linha de comandos composer.
Configurando o Ambiente do Composer

Esta seo descreve como configurar o ambiente do composer.
Sada do Terminal
As variveis de shell denominadas MAESTROLINES e MAESTROCOLUMNS
determinam a sada para seu computador. Se uma delas no estiver definida, as
variveis shell padro, LINES e COLUMNS, sero utilizadas. No final de cada
pagina de tela, o composer solicita para continuar. Se MAESTROLINES (ou LINES)
estiver definido como zero ou um nmero negativo, o composer no ser pausado
no final de uma pgina.
Dependendo do valor configurado na varivel local MAESTROCOLUMNS, dois
conjuntos diferentes de informaes so exibidos sobre o objeto selecionado. H
duas possibilidades:
v
v
|
|
MAESTROCOLUMNS < 120 caracteres

MAESTROCOLUMNS > 120 caracteres
O valor configurado na varivel local MAESTROCOLUMNS no pode ser mais

alto que 1024.
Consulte a Tabela 51 na pgina 273 e a Tabela 52 na pgina 283 para saber os
diferentes formatos de sada.
Sada Off-line
A opo ;off-line nos comandos do composer utilizada para imprimir a sada de
um comando. Ao inclu-la, as seguintes variveis controlam a sada:
Variveis do Windows:
247
MAESTROLP
Especifica o arquivo no qual a sada de um comando gravada. O padro
stdout.
MAESTROLPLINES
Especifica o nmero de linhas por pgina. O padro 60.
MAESTROLPCOLUMNS
Especifica o nmero de caracteres por linha. O padro 132.
Variveis do UNIX:
A opo ;off-line nos comandos do composer utilizada para imprimir a sada de
um comando. Ao inclu-la, as seguintes variveis shell controlam a sada:
MAESTROLP
Especifica o destino da sada de um comando. Defina-o como um dos
seguintes:
> file
Redireciona a sada para um arquivo, sobrescrevendo seu

contedo. Se o arquivo no existir, ele ser criado.
>> file Redireciona a sada para um arquivo, anexando-a ao final do

arquivo. Se o arquivo no existir, ele ser criado.
| command
Canaliza a sada para um comando do sistema ou processo. O
comando do sistema executado independentemente da gerao
da sada.
|| command
comando do sistema no ser executado, se no houver sada.
O valor padro para MAESTROLP | lp -tCONLIST, que direciona a
sada do comando para a impressora e coloca o ttulo CONLIST na
pgina de banner da impresso.
MAESTROLPLINES
MAESTROLPCOLUMNS
As variveis devem ser exportadas antes da execuo do composer.
O Editor do Composer
Vrios comandos do composer abrem automaticamente um editor de texto.
possvel selecionar qual editor deseja que o composer utilize.
Alm disso, no Windows e no UNIX, possvel configurar a varivel de ambiente
XMLEDIT para apontar para um editor XML de sua escolha para editar definies de
regra de evento. O editor XML aberto automaticamente toda vez que voc
executa os comandos composer add, new ou modify em uma regra de evento.
Windows:
No Windows, o Notepad utilizado como o editor padro. Para alterar o editor,
configure a varivel de ambiente EDITOR com o caminho e nome do novo editor
antes de executar o composer.
248
UNIX:
Vrios comandos que podem ser emitidos a partir do composer abrem
automaticamente um editor de texto. O tipo de editor determinado pelo valor de
duas variveis shell. Se a varivel VISUAL estiver definida, ela definir o editor,
caso contrrio, a varivel EDITOR definir o editor. Se nenhuma das duas estiver
definida, um editor vi ser aberto.
Selecionando o Prompt do composer no UNIX

O prompt de comandos do composer definido no arquivo TWS_home/localopts. O
prompt de comandos padro um trao (-). Para selecionar um prompt diferente,
edite a opo composer prompt no arquivo localopts e altere o trao. O prompt
pode ter at dez caracteres, no incluindo o sinal de sustenido (#) final necessrio.
#---------------------------------------------------------------------------# Atributos de formato customizado
#
date format =
1
# The possible values are 0-ymd, 1-mdy,
2-dmy, 3-NLS.
composer prompt =
conman prompt =
%
switch sym prompt =
<n>%
#----------------------------------------------------------------------------
Para obter informaes adicionais sobre o arquivo de configurao localopts,

consulte o Guia de Administrao do IBM Tivoli Workload Scheduler.
Executando o Programa composer

Para configurar seu ambiente para utilizar o composer, configure as variveis
PATH e TWS_TISDIR executando um dos seguintes scripts:
No UNIX:
v . ./TWS_home/tws_env.sh para shells Bourne e Korn
v . ./TWS_home/tws_env.csh para shells C
No Windows:
v TWS_home\tws_env.cmd
Em seguida, utilize a sintaxe a seguir para executar comandos a partir da interface
com o usurio composer:
composer [-file filename][connection_parameters] ["command[&[command]][...]"]
onde:
-file filename
Indica um arquivo de propriedades customizado alternativo que contm as
configuraes para os parmetros de conexo, utilizado no lugar dos
arquivos useropts e localopts.
Se estiver usando composer a partir do gerenciador de domnio principal,
os parmetros de conexo foram configurados na instalao e no precisam
ser fornecidos, a menos que voc no deseje usar os valores padro.
Se estiver usando composer a partir do cliente da linha de comandos em
por um ou mais destes mtodos:
Captulo 9. Gerenciando Objetos no Banco de Dados - Composer
249
v
v
v
v
Armazenados no arquivo localopts

Armazenados no arquivo useropts
Fornecidos ao comando em um arquivo de parmetro
Fornecidos ao comando como parte da sequncia de caracteres de
comando
O programa de linha de comandos composer instalado automaticamente ao
instalar o gerenciador de domnio mestre. Ele deve ser instalado separadamente
sobre uma estao de trabalho de agente do Tivoli Workload Scheduler ou de
forma independente em um n fora da rede do Tivoli Workload Scheduler. O
recurso que instala o programa de linha de comandos composer denominado
Cliente da Linha de Comandos. Para obter informaes sobre como instalar o recurso
Cliente da Linha de Comandos, consulte o IBM Tivoli Workload Scheduler: Planning and
Installation Guide.
Depois de instalado, possvel utilizar a linha de comandos composer no modo de
lote e interativo.
Ao executar o composer no modo interativo , voc primeiro ativa o programa de
linha de comandos composer e, em seguida, a partir do prompt da linha de
comandos composer, voc executa comandos um por vez, por exemplo:
composer username admin2 password
add myjobs.txt
create myjobs.txt from jobs=@
admin2pwd
Ao executar composer no modo em lote, voc ativa o programa de linha de

comandos composer especificando como parmetro de entrada o comando a ser
emitido. Quando o comando processado, o programa de linha de comandos
composer sai, por exemplo:
composer f c:\TWS\network\mylocalopts add myjobs.txt
Nota: Se utilizar o modo de batch para emitir mais de um comando a partir do

composer, certifique-se de gerenciar o caractere ; de uma das seguintes
formas:
v Utilizando aspas duplas, por exemplo:
composer "delete dom=old_domain; noask"
v Utilizando um caractere de espao, por exemplo:

composer delete dom=old_domain noask
v Fazendo escape do caractere ;, por exemplo:

composer delete dom=old_domain \; noask
Outros exemplos de como utilizar o comando, supondo que os parmetros de

conexo estejam configurados nos scripts de configurao local, so os seguintes:
v Executa os comandos print e version e sai:
composer "p parms&v"
v Executa os comandos print e version e, em seguida, solicita um comando:

composer "p parms&v&"
250
v L comandos do cmdfile:
composer < cmdfile
v Canaliza comandos do cmdfile para o composer:

cat cmdfile | composer
Caracteres de Controle
possvel digitar os seguintes caracteres de controle no modo conversacional para
interromper o composer se as definies de stty estiverem configuradas para isso.
Ctrl+c O composer pra a execuo do comando atual na prxima etapa que
puder ser interrompida e retorna um prompt de comandos.
Ctrl+d O composer sai aps a execuo do comando atual.
Executando Comandos a partir do Composer

Os comandos do Composer consistem nos seguintes elementos:
commandname selection arguments
onde:
commandname
Especifica o nome do comando.
selection
Especifica o objeto ou conjunto de objetos sobre os quais a ao ser
tomada.
argumentos
Especifica os argumentos do comando.
Filtros e Curingas
No composer do Tivoli Workload Scheduler, possvel utilizar curingas e filtros ao
emitir alguns comandos especficos para filtrar os objetos de planejamento
definidos no banco de dados. Os curingas que podem ser utilizados a partir do
composer so:
@
Substitui um ou mais caracteres alfanumricos.
Substitui um caractere alfanumrico.
Para procurar ocorrncias com nomes que contm @ ou ?, certifique-se de utilizar o

caractere barra invertida \ antes de @ ou ? para fazer escape deles para que no
sejam interpretados como curingas. De forma semelhante, o caractere barra
invertida deve ter como prefixo outro caractere barra invertida para ser
interpretado como uma ocorrncia a ser localizada. Os exemplos a seguir
esclarecem essas regras, que tambm se aplicam ao especificar as cadeias de
procura utilizando a palavra-chave filter.
S@E
Procurar todas as cadeias iniciadas por S e terminadas por E,

independentemente de seu comprimento.
S?E
Procurar todas as cadeias iniciadas por S e terminadas por E, cujo

comprimento trs caracteres.
S\@E
Procurar uma correspondncia exata com a cadeia S@E.

251
S\?E
Procurar uma correspondncia exata com a cadeia S?E.
S\\E
Procurar uma correspondncia exata com a cadeia S\E.
Os comandos que podem ser emitidos a partir do composer e que suportam

filtragem so:
v display
v criar
v excluir
v listar
v lock
v modify
v print
v destravar
A sintaxe utilizada para filtrar objetos ao emitir um desses comandos a seguinte:
command_name type_of_object=selection; [option;] [filter filter_keyword=selection [...]]
A Tabela 45 mostra os objetos de planejamento que possvel filtrar ao emitir os
comandos listados acima e para cada objeto, cujos campos podem ser filtrados (em
itlico) ou cuja chave (em negrito) utilizada para filtrar seus campos:
Tabela 45. Critrios de Filtragem de Objetos de Planejamento
Objeto de
planejamento
Palavras-chave e
campos de filtro
que podem ser
filtrados
Descrio
estao de
trabalho
workstationname
Aplica o comando s
list ws=p@
estaes de trabalho cujo
nome satisfaz os critrios.
domnio
Aplica o comando s
mod ws=@; filter
estaes de trabalho que domain=dom1
pertencem a um domnio.
vartable
Aplica o comando s
estaes de trabalho que
se referem tabela de
variveis especificada.
mod ws=@; filter

vartable=table2
domainname
Aplica o comando aos

domnios cujo nome
satisfaz os critrios.
display dom=dom?
parent

domnios cujo domnio
pai satisfaz os critrios.
list dom=@; filter

parent=rome
prompt
promptname

lock prompt=p@
prompts globais cujo
Usurio do
Windows
workstationname#
username

usurios cujo
identificador satisfaz os
critrios.
domnio
252
Exemplo
list users=cpu1#operator?
Tabela 45. Critrios de Filtragem de Objetos de Planejamento (continuao)

Objeto de
planejamento
Palavras-chave e
campos de filtro
que podem ser
filtrados
Descrio
Exemplo
resource
workstationname#
resourcename

recursos cujo
identificador satisfaz os
critrios.
print res=cpu?#operator?
varivel
variablename

parmetros cujo nome
satisfaz os critrios.
delete
vb=mytable.myparm@
definio de
tarefa
jobname
mod jd=mycpu#myjob@
Aplica o comando s
definies de tarefas cujo
RecoveryJob
Aplica o comando s
tarefas cuja definio
contm a definio da
tarefa de recuperao
especificada.
list jobdefinition=@; filter

RecoveryJob=CPUA#job01
253

Objeto de
planejamento
Palavras-chave e
campos de filtro
que podem ser
filtrados
Descrio
fluxo de job
workstationname#
jobstreamname
Aplica o comando s
mod js=mycpu#myjs@
definies de tarefas cujo
Calendar ou
FreeCalendar

fluxos de tarefa que
contm o calendrio ou
calendrio de dias livres
especificado no filtro.
list js=@#@; filter

Calendar=cal1
Jobdefinition

fluxos de tarefas que
contm a definio de
tarefa especificada no
filtro.
list js=@#@; filter

jobdefinition=CPUA#job01
Resource

fluxos de tarefas que se
referem ao recurso
list js=@#@; filter

Resource=cpu1#disk1
Prompt

referem ao prompt
list js=@#@; filter

Prompt=myprompt
Vartable

referem tabela de
variveis especificada no
filtro. A tabela de
variveis pode ser
especificada no ciclo de
execuo ou na seo de
fluxo de tarefas.
list js=@#@; filter

Vartable=table1
Rcvartable

ciclos de execuo nos
referem tabela de
filtro.
list js=@#@; filter

Rcvartable=table1
Jsvartable
list js=@#@; filter

Jsvartable=table1
referem tabela de
filtro, independentemente
do que seja especificado
no ciclo de execuo.
eventrulename
Aplica o comando s
regras de eventos que
incluem uma ao em
uma tarefa ou fluxo de
tarefas especficos.
regra de
evento
254
Exemplo
list er=@; filter js=accrecjs5

Objeto de
planejamento
Palavras-chave e
campos de filtro
que podem ser
filtrados
Descrio
Exemplo
vartable
vartablename
Aplica o comando s
list vartable=A@
tabelas de variveis cujo
isdefault
Aplica o comando
tabela de variveis
padro.
list vartable=A@; filter

isdefault
possvel combinar mais de um filtro para o mesmo tipo de objeto, conforme

mostrado no exemplo a seguir:
list js=@#@; filter Calendar=cal1 FreeCalendar=VACATIONS jobdefinition=CPUA#job01
A sada do comando uma lista de fluxos de tarefas que utilizam o calendrio

cal1, calendrio de dias livres VACATIONS e contm uma tarefa com a definio de
tarefa CPUA#job01.
Delimitadores e caracteres especiais

A Tabela 46 lista caracteres que tm significados especiais nos comandos composer.
Tabela 46. Delimitadores e Caracteres Especiais para o Composer
Caractere
Descrio
&
Delimitador de comando. Consulte Executando o Programa composer na

pgina 249.
Delimitador de argumento. Por exemplo:

;info;off-line
Delimitador de valor. Por exemplo:

sched=sked5
:!
Prefixos de comandos que transmitem o comando para o sistema. Esses

prefixos so opcionais; se o composer no reconhecer o comando, ele ser
transmitido automaticamente para o sistema. Por exemplo:
!ls ou :ls
<< >>
Colchetes de comentrios. Os comentrios podem ser colocados em uma

nica linha em qualquer lugar do fluxo de tarefas. Por exemplo:
schedule foo <<comment>> on everyday
Prefixo do comentrio. Quando este prefixo for o primeiro caractere de

uma linha, toda a linha ser um comentrio. Quando o prefixo vier depois
de um comando, o restante da linha ser um comentrio. Por exemplo:
*comment
ou
print& *comment
>
Redireciona a sada do comando para um arquivo, sobrescrevendo seu

contedo. Se o arquivo no existir, ele ser criado. Por exemplo:
display parms > parmlist
>>
Redireciona a sada de comando para um arquivo e anexa a sada no final

do arquivo. Se o arquivo no existir, ele ser criado. Por exemplo:
display parms >> parmlist
255
Tabela 46. Delimitadores e Caracteres Especiais para o Composer (continuao)

Caractere
Descrio
Canaliza a sada de comando para um comando do sistema ou processo. O

comando do sistema executado independentemente da gerao da sada.
Por exemplo:
display parms | grep alparm
comando do sistema no ser executado, se no houver sada. Por
exemplo:
||
display parms || grep alparm
Composer commands
A Tabela 47 lista os comandos composer.
Nota: Os nomes e as palavras-chave dos comandos podem ser digitados em
caracteres maisculos ou minsculos e podem ser abreviados com o mnimo
de caracteres iniciais, o necessrio para distingui-los exclusivamente uns dos
outros. Alguns dos nomes de comandos tambm possuem formas
abreviadas.
No entanto, h algumas abreviaes, como v, que apontam para um
comando especfico, version neste caso, apesar de no identificarem
exclusivamente esse comando na lista. Isso ocorre quando a abreviao
cdigo permanente no produto e, portanto, incompatibilidades em chamar o
comando errado so automaticamente ignoradas.
Tabela 47. Lista de Comandos do Composer
256
Comando
Nome
Descrio
Abreviado
incluir
Consulte a pgina
Adiciona objetos de planejamento.
add na pgina
262
authenticate au
Altera as credenciais do usurio que est

executando o composer.
authenticate na
pgina 264
continue
Ignora o prximo erro.
continue na
pgina 265
create
cr
Sinnimo para o comando extract.
extract na pgina
275
delete
de
Exclui objetos de planejamento.
delete na pgina
265
display
di
Exibe os detalhes do objeto de planejamento display na

especificado.
pgina 269
editar
ed
Edita um arquivo.
edit na pgina
274
exit
Sai do composer.
exit na pgina
275
extract
ex
Extrai uma definio de objeto do banco de

dados e grava a mesma em um arquivo de
texto.
extract na pgina
275
help
Chama a ajuda on-line para um comando.
help na pgina
279
Tabela 47. Lista de Comandos do Composer (continuao)

Comando
Nome
Descrio
Abreviado
Consulte a pgina
list
Lista objetos de planejamento.
list na pgina 280
lock
lo
Bloqueia o acesso aos objetos de banco de

dados.
lock na pgina
286
modify
Modifica objetos de planejamento.
modify na pgina
290
Cria objetos de planejamento utilizando um new na pgina

arquivo de texto onde a definio de objeto 294
inserida on-line.
new
print
Imprime objetos de planejamento.
display na
pgina 269
redo
red
Edita e executa o comando anterior

novamente.
redo na pgina
296
rename
rn
Altera o nome do objeto.
rename na
pgina 297
replace
rep
Substitui objetos de planejamento.
replace na pgina
300
Chama um comando de sistema

operacional.
system command
na pgina 301
unlock na pgina
301
system
command
unlock
Libera o bloqueio do objeto de

planejamento definido no banco de dados.
validate
val
validate na
Valida a integridade da sintaxe, da
semntica e dos dados de uma definio de pgina 305
objeto.
verso
Exibe o banner do programa de linha de

comandos composer.
version na
pgina 306
Verificao de Integridade Referencial

O Tivoli Workload Scheduler executa automaticamente as verificaes referenciais
para evitar falta de integridade nas definies de objetos no banco de dados toda
vez que voc executar comandos que criam, modificam ou excluem a definio de
um objeto referenciado. Estas so as verificaes executadas pelo produto:
v Toda vez que voc utiliza um comando que cria um novo objeto no banco de
dados, o Tivoli Workload Scheduler verifica se:
Um objeto do mesmo tipo e com o mesmo identificador j existe.
Os objetos referidos por esse objeto j existem no banco de dados.
v Toda vez que voc executar um comando que modifica uma definio de objeto
no banco de dados, o Tivoli Workload Scheduler verifica se:
A definio do objeto a ser modificada existe no banco de dados.
Os objetos referidos por esse objeto existem no banco de dados.
Para evitar inconsistncias de integridade, a definio de objeto no aparece
na definio de um objeto que pertence cadeia de seus ascendentes.
v Toda vez que voc executar um comando que exclui uma definio de objeto no
banco de dados, o Tivoli Workload Scheduler verifica se:
A definio de objeto a ser excluda existe no banco de dados.
A definio de objeto a ser excluda no referida por outros objetos
definidos no banco de dados.
257
Observe que no h qualquer verificao de integridade referencial para regras de

evento.
A Tabela 48 mostra, para cada tipo de objeto, os identificadores que so utilizados
para identificar exclusivamente o objeto no banco de dados ao criar ou modificar
definies de objetos:
Tabela 48. Identificadores de Objetos para Cada Tipo de Objeto Definido no Banco de
Dados
Tipo de Objeto
Identificadores de Objetos
domnio
domainname
estao de trabalho
workstationname (verificado em estaes de trabalho e

classes de estao de trabalho)
classe da estao de trabalho
workstationclassname (verificado em estaes de trabalho

e classes de estao de trabalho)
calendrio
calendarname
definio de tarefa
workstationname e jobname
Usurio do Windows
workstationname e username
fluxo de job
workstationname e jobstreamname e, se definido, validfrom
tarefa em um fluxo de tarefa
workstationname e jobstreamname, jobname e, se definido,

validfrom
resource
workstationname e resourcename
prompt
promptname
tabela de varivel
variabletablename
varivel
variabletablename.variablename
regra de evento
eventrulename
Em geral, a integridade referencial evita a excluso de objetos quando eles so

referenciados por outros objetos do banco de dados. No entanto, em alguns casos,
em que a excluso de um objeto (por exemplo, uma estao de trabalho) sugere
somente a atualizao de um objeto referido (por exemplo, uma classe de estao
de trabalho que o inclui), a excluso pode ser permitida. A Tabela 49 mostra todos
os casos em que um objeto referido pode ser excludo mesmo se outros objetos
fizerem referncia a ele:
Tabela 49. Atualizao da Definio de Objeto na Excluso do Objeto Referenciado
Objeto
Referncias
Dependncia de
Estao de
Interligao de Redes Trabalho
Dependncia Follows
Externa
258
Na Excluso do Objeto Referenciado...

... remova a dependncia da tarefa ou do fluxo de
tarefas
Fluxo de Tarefas ... remova a dependncia da tarefa ou do fluxo de

tarefas
Tarefa

tarefas
Dependncia Interna
Tarefa

tarefas
Classe de Estao de
Trabalho
Estao de
Trabalho
... remova a estao de trabalho da classe de

estao de trabalho
A Tabela 50 descreve como o produto se comporta quando solicitado que exclua

um objeto referido por outro objeto com a utilizao de um relacionamento
especfico:
Tabela 50. Referential integrity check when deleting an object from the database
Objeto a
Ser
Excludo
Referenciado Relacionamento
pelo Objeto
Regra de Excluso
domnio A
domnio B
domnio A pai do
domnio B
Um erro especificando o
relacionamento existente
exibido.
estao de
trabalho B
estao de trabalho b
pertence estao de
trabalho A
exibido.
259
Tabela 50. Referential integrity check when deleting an object from the
database (continuao)
260
Objeto a
Ser
Excludo
pelo Objeto
estao de
trabalho A
estao de
trabalho B
estao de trabalho A host Um erro especificando o

da estao de trabalho B
exibido.
tarefa B
tarefa B est definida na

estao de trabalho A
exibido.
fluxo de
tarefa B
fluxo de tarefa B est

definido na estao de
trabalho A
exibido.
usurio do
Windows B
usurio do Windows B est

definido na estao de
trabalho A
exibido.
fluxo de
tarefa B
estao de trabalho A
funciona como agente de
rede para dependncias de
interligao de redes
configuradas no fluxo de
tarefa B
A estao de trabalho A e a
dependncia de interligao de
redes so excludas
fluxo de
tarefa B
fluxo de tarefa B tem uma

dependncia de arquivo de
um arquivo definido na
estao de trabalho A
dependncia de arquivo so
excludas
tarefa B no
fluxo de
tarefa B
estao de trabalho A
funciona como agente de
rede para dependncias de
interligao de redes
configuradas na tarefa B
redes so excludas
tarefa B no
fluxo de
tarefa B
tarefa B tem uma

dependncia de arquivo de
um arquivo definido na
estao de trabalho A
dependncia de arquivo so
excludas
recurso B
recurso B est definido na

estao de trabalho A
exibido.
arquivo B
arquivo B est definido na

estao de trabalho A
exibido.
classe de
estao de
trabalho B
estao de trabalho A
pertence classe de estao
de trabalho B
A estao de trabalho A e sua

entrada na classe de estao de
trabalho B so excludas.
tarefa B no
fluxo de
tarefa B
tarefa B contida no fluxo de Um erro especificando o

estao de trabalho A
exibido.
Regra de Excluso
Objeto a
Ser
Excludo
pelo Objeto
Regra de Excluso
tarefa A
tarefa B
tarefa A a tarefa de
recuperao para a tarefa B
exibido.
fluxo de
tarefa B
tarefa A est contida no

fluxo de tarefa B
exibido.
fluxo de
tarefa B
fluxo de tarefa B segue a

tarefa A
A tarefa A e a dependncia
follows no fluxo de tarefa B so
excludas.
tarefa B no
fluxo de
tarefa B
tarefa B segue a tarefa A
A tarefa A e a dependncia
follows na tarefa B so excludas.
regra de
evento B
tarefa A est na definio de Um erro especificando o

ao da regra de evento B
exibido.
(e no utiliza substituio
de variveis)
calendrio
A
fluxo de
tarefa B
fluxo de tarefa B utiliza o

calendrio A
exibido.
classe de
estao de
trabalho A
tarefa B

classe de estao de
trabalho A
exibido.
fluxo de
tarefa B
fluxo de tarefa B est

definido na classe de
estao de trabalho A
exibido.
recurso B
recurso B est definido na

classe de estao de
trabalho A
exibido.
arquivo B
arquivo B est definido na

classe de estao de
trabalho A
exibido.
fluxo de
tarefa B
dependncia needs definida Um erro especificando o

no fluxo de tarefa B
exibido.
tarefa B no
fluxo de
tarefa B
dependncia needs definida Um erro especificando o

na tarefa B
exibido.
fluxo de
tarefa B
dependncia prompt
definida no fluxo de tarefa
B
exibido.
tarefa B no
fluxo de
tarefa B
dependncia prompt
definida na tarefa B
exibido.
recurso A
prompt A
261
Objeto a
Ser
Excludo
pelo Objeto
Regra de Excluso
varivel A
fluxo de
tarefa B
varivel A excluda sem

verificao
varivel A utilizada no
fluxo de tarefa B em:
v no texto de um prompt
ad hoc
v ou no nome de arquivo
especificado em uma
dependncia de arquivo
tarefa B
fluxo de tarefa B em:

verificao
v no texto de um prompt
ad hoc
v ou no nome de arquivo
especificado em uma
dependncia de arquivo
v ou no valor especificado
para streamlogon
v ou no valor especificado
para scriptname
tabela da
varivel A
fluxo de
tarefa A
prompt B
texto do prompt B

verificao
fluxo de
tarefa B
tabela de varivel A
referenciada no fluxo de
tarefa B
tabela de varivel A no
excluda
tarefa B
tabela de varivel A
referenciada na tarefa B
excluda
prompt B
tabela de varivel A
referenciada no texto do
prompt B
excluda
fluxo de
tarefa B
fluxo de tarefa B segue o

fluxo de tarefa A
O fluxo de tarefa A e a
dependncia follows no fluxo de
tarefa B so excludos.
tarefa B em
um fluxo de
tarefa B
tarefa B segue o fluxo de

tarefa A
O fluxo de tarefa A e a
dependncia follows na tarefa B
so excludos.
regra de
evento B
fluxo de tarefas A est na

definio de ao da regra
de evento B (e no utiliza
substituio de variveis)
exibido.
add
Inclui ou atualiza objetos de planejamento no banco de dados.
Autorizao
Voc deve ter o acesso add para incluir um novo objeto de planejamento. Se o
objeto j existir no banco de dados, voc deve ter:
262
v acesso modify para o objeto se o objeto no estiver bloqueado.

v acesso modify e unlock para o objeto se o objeto estiver bloqueado por outro
usurio.
Sintaxe
{add | a} filename [;unlock]
Argumentos
nome do arquivo
Especifica o nome do arquivo de texto que contm as definies de objetos.
Para regras de eventos, filename especifica o nome do arquivo XML que
contm as definies das regras de eventos que voc deseja incluir
(consulte Definio da Regra de Evento na pgina 234 para referncia de
XML e consulte O Editor do Composer na pgina 248 para obter
detalhes sobre como configurar um editor de XML).
;unlock
Indica que as definies de objetos devem ser desbloqueadas se foram
bloqueadas pelo mesmo usurio na mesma sesso. Se voc no tiver
bloqueado o objeto e utilizar a opo ;unlock, quando emitir o comando
voc receber uma mensagem de erro e o objeto ser substitudo.
Comentrios
O arquivo de texto validado no cliente e, se correto, os objetos so inseridos no
banco de dados no gerenciador de domnio mestre. O composer transforma as
definies de objetos em uma definio XML utilizada no servidor; caso contrrio,
o comando interrompido e uma mensagem de erro exibida. Isto no se aplica
s definies de regras de eventos pois elas so fornecidas diretamente no formato
XML.
Com o comando add, se um objeto j existir, ser perguntado se voc deseja ou
no substitu-lo. Esse comportamento no afeta as definies de tarefas nos fluxos
de tarefas e as definies de tarefas so atualizadas automaticamente sem solicitar
qualquer mensagem. possvel utilizar a opo unlock para atualizar os objetos
existentes anteriormente bloqueados utilizando somente um comando. Para todos
os novos objetos inseridos, a opo ignorada. Se voc alterar o nome de um
objeto, ele interpretado pelo composer como o novo objeto e ser inserido. Um
comando rename recomendado neste caso.
O comando add verifica as dependncias de loop dentro dos fluxos de tarefas. Por
exemplo, se job1 seguir job2 e job2 seguir job1, haver uma dependncia de loop.
Quando for localizada uma dependncia de loop dentro de um fluxo de tarefas,
um erro ser exibido. O comando add no verifica as dependncias de loop entre
os fluxos de tarefas por que, dependendo da complexidade das atividades de
planejamento, esta verificao poder ser muito demorada e consumir muita CPU.
Exemplos
Para incluir os jobs a partir do arquivo myjobs, execute o seguinte comando:
add myjobs
Para incluir os fluxos de job a partir do arquivo mysked, execute o seguinte

comando:
263
a mysked
Para incluir as estaes de trabalho, as classes de estaes de trabalho e os

domnios a partir do arquivo cpus.src, execute o seguinte comando:
a cpus.src
Para incluir as definies de usurio a partir do arquivo users_nt, execute o

seguinte comando:
a users_nt
Para incluir as definies de regras de eventos editadas em um arquivo

denominado newrules.xml, execute:
a newrules.xml
Consulte tambm
1. Clique em Tivoli Workload Scheduler
2. Escolha um dos seguintes:
v Para incluir estaes de trabalho, clique em Ambiente de
v Para incluir regras de eventos, clique em Carga de TrabalhoDesignCriar
Regras de Eventos
v Para incluir todos os outros objetos, clique em Carga de
TrabalhoDesignCriar Definies de Carga de Trabalho
4. Especifique um dos seguintes:
v Para estaes de trabalho, especifique suas opes no painel de propriedades
v Para regras de eventos, especifique suas opes no painel Editor de Regras
de Eventos
v Para todos os outros objetos:
a. Clique em Novo na barra de ferramentas Lista de Trabalho da janela
pop-up resultante
b. Selecione o tipo de objeto que deseja incluir
c. Especifique suas opes no painel de propriedades
authenticate
Alterna para as credenciais de outro usurio durante a execuo do composer.
Autorizao
Qualquer usurio autorizado a executar o composer est autorizado a emitir esse
comando.
Sintaxe
{authenticate | au} [username=username password=password]
264
Argumentos
username=username
O nome do usurio para o qual deseja alternar.
password=password
A senha do usurio para a qual deseja alternar.
Comentrios
Uma mensagem exibida comunicando a falha ou o sucesso da autenticao. Esse
comando utilizado somente no modo interativo.
Exemplos
Para alternar para o usurio tws_user1 com a senha mypasswd1 a partir do
programa de linha de comandos composer, execute o seguinte comando:
au username=tws_user1 password=mypasswd1
continue
Especifica que o prximo erro do comando ser ignorado.
Autorizao
comando.
Sintaxe
{continue | c}
Comentrios
Esse comando til quando vrios comandos so digitados na linha de comandos
ou redirecionados a partir de um arquivo. Ele orienta o composer a continuar a
execuo de comandos, mesmo que o prximo comando, depois de continue,
resulte em erro. Esse comando no necessrio quando voc digita comandos
interativamente porque o composer no sair com erro.
Exemplos
Para que o composer continue com o comando print se o comando delete resultar
em erro, execute o seguinte comando:
composer "c&delete cpu=site4&print cpu=@"
delete
Exclui definies de objetos do banco de dados.
Autorizao
Voc deve ter acesso delete aos objetos que esto sendo excludos.
265
Sintaxe
{delete | de}
{[calendars | calendar | cal=calname] |
[eventrule | erule | er=eventrulename] |
[parms | parm | vb=[tablename.]variablename] |
[vartable | vt=tablename] |
[prompts | prom=promptname] |
[resources | resource | res=[workstationame#]resourcename] |
[cpu={workstationame [;force]
| workstationclassname [;force]|
domainame}]
[workstation | ws=workstationame] [;force] |
[workstationclass | wscl=workstationclassname] [;force] |
[domain | dom=domainame] |
[jobs | jobdefinition | jd=[workstationame#]jobname] |
[sched | jobstream | js= [workstationame#]jstreamname
[valid from date|valid to date |valid in date date]
] |
[users | user=[workstationame#]username]}
[;noask]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Argumentos
calendars | calendar | cal
Se nenhum argumento vier em seguida, esse comando excluir todas as
definies de calendrio.
Se o argumento calname vier em seguida, ele excluir o calendrio calname.
Caracteres curinga so permitidos.
parms|parm|vb
definies de variveis globais localizadas na tabela de variveis padro.
Se o argumento tablename.variablename vier em seguida, esse comando
excluir a varivel variablename da tabela tablename. Se tablename for
omitido, composer procurar a definio da varivel na tabela de variveis
padro. Caracteres curinga so permitidos em tablename e variablename. Por
exemplo:
delete parms=@.@
Exclui todas as variveis de todas as tabelas.

delete parms=@
Exclui todas as variveis da tabela padro.

delete parms=@.acct@
Exclui todas as variveis cujo nome inicia com acct a partir de todas as
tabelas existentes.
Lembre-se: Enquanto voc exclui uma varivel, a tabela de variveis em
que ela est contida bloqueada. Isso indica que, enquanto a
tabela est bloqueada, nenhum outro usurio pode executar
nenhum outro comando de bloqueio nela ou nas variveis que
ela contm.
266
vartable | vt
definies de tabela de variveis.
Se a tabela de variveis tablename do argumento vier em seguida, esse
comando excluir a tabela de variveis tablename. Caracteres curinga so
permitidos.
prompts | prom
definies de prompt.
Se o argumento promptname vier em seguida, ele excluir o prompt
promptname. Caracteres curinga so permitidos.
resources | resource | res
definies de recurso.
Se o argumento workstationame#resourcename vier em seguida, esse comando
excluir o recurso resourcename da estao de trabalho workstationame em
que o recurso est definido. Se workstationame for omitido, o padro ser a
estao de trabalho em que o composer est em execuo. Caracteres
curinga so permitidos para workstationame e resourcename.
|
cpu
Exclui estaes de trabalho, classes de estao de trabalho ou domnios.
|
|
|
|
estao de trabalho
O nome da estao de trabalho. Caracteres curinga so permitidos.
Se o argumento force for especificado, a definio da estao de
trabalho removida do banco de dados Tivoli Workload Scheduler.
|
|
|
|
|
workstationclass
O nome da classe de estao de trabalho. Caracteres curinga so
permitidos. Se o argumento force for especificado, a definio de
classe da estao de trabalho removida do banco de dados Tivoli
Workload Scheduler.
|
|
domnio
|
|
|
|
|
|
|
O nome do domnio. Caracteres curinga so permitidos.

workstation | ws
definies de estao de trabalho.
Se o argumento workstationname vier em seguida, ele excluir a estao de
trabalho workstationname. Caracteres curinga so permitidos. Se o
argumento force for especificado, a definio da estao de trabalho
removida do banco de dados Tivoli Workload Scheduler.
domain | dom
definies de domnio.
Se o argumento domainname vier em seguida, ele excluir o domnio
domainname. Caracteres curinga so permitidos.
|
|
|
|
|
workstationclass | wscl
definies de classe da estao de trabalho.
Se o argumento workstationclassname vier em seguida, ele excluir a classe
da estao de trabalho workstationclassname. Caracteres curinga so
267
permitidos. Se o argumento force for especificado, a definio de classe da

estao de trabalho removida do banco de dados Tivoli Workload
Scheduler.
|
|
|
jobs | jobdefinition | jd
definies de tarefa.
Se o argumento workstationame#jobname vier em seguida, ele excluir a
tarefa jobname da estao de trabalho workstationame em que a tarefa
executada. Se workstationame for omitido, o padro ser a estao de
trabalho em que o composer est em execuo. Caracteres curinga so
permitidos para workstationame e jobname.
sched | jobstream | js
definies de fluxo de tarefas.
Se o argumento workstationame#jstreamname vier em seguida, ele excluir o
fluxo de tarefas jstreamname da estao de trabalho workstationame em que o
fluxo de tarefas est definido. Se workstationame for omitido, o padro ser
a estao de trabalho em que o composer est em execuo. Caracteres
curinga so permitidos para workstationame e jstreamname.
vlido a partir de
date Restringe a seleo de fluxos de tarefas que possuem uma
data valid from igual ao valor indicado. O formato mm/dd/aaaa.
vlido at
data valid to igual ao valor indicado. O formato mm/dd/aaaa.
valid in
date date O espao de tempo durante o qual o fluxo de tarefa pode
ser executado. O formato mm/dd/aaaa - mm/dd/aaaa. Uma das duas
datas pode ser representada por @.
users | user
definies de usurio.
Se o argumento workstationame#username vier em seguida, ele excluir o
usurio username da estao de trabalho workstationame em que o usurio
est definido. Se workstationame for omitido, o padro ser a estao de
permitidos para workstationame e username. O campo de senha no
copiado por motivos de segurana.
eventrule | erule | er
definies de regra de evento.
Se o argumento eventrulename vier em seguida, ele excluir a regra de
evento eventrulename. Caracteres curinga so permitidos.
;noask Especifica para no solicitar confirmao antes da tomada de ao em cada
objeto qualificado.
268
Comentrios
Se voc utilizar caracteres curinga para especificar um conjunto de definies, o
composer requerer confirmao antes de excluir cada definio correspondente.
Uma confirmao ser requerida antes de excluir cada definio correspondente se
a opo noask no for especificada.
Para excluir um objeto, ele no deve estar bloqueado. Se alguns objetos
correspondentes estiverem bloqueados durante o processamento de comando, uma
mensagem de erro com a lista desses objetos ser mostrada para o usurio.
Exemplos
Para excluir o job3 ativado na estao de trabalho site3, execute o seguinte
comando:
delete jobs=site3#job3
Para excluir todas as estaes de trabalho com nomes comeando por ux, execute o
seguinte comando:
de cpu=ux@
Para excluir todos os fluxos de job com nomes comeando por test em todas as
estaes de trabalho, execute o seguinte comando:
de sched=@#test@
Para excluir todas as regras de eventos denominadas de rulejs320 a rulejs329,

execute o seguinte comando:
de erule=rulejs32?
Consulte tambm
v Para excluir estaes de trabalho, clique em Ambiente de
PlanejamentoDesignListar Estaes de Trabalho
v Para excluir regras de eventos, clique em Carga de TrabalhoDesignListar
Regras de Eventos
v Para excluir todos os outros objetos, clique em Carga de
TrabalhoDesignListar Definies de Carga de Trabalho
3. Selecione um nome de mecanismo
4. Liste os objetos que deseja excluir utilizando os filtros fornecidos e clique ou
selecione Excluir.
display
Exibe os detalhes de uma ou mais definies de objetos do mesmo tipo
armazenados no banco de dados. Toda a definio do objeto exibida.
269
Autorizao
Voc deve ter acesso display ao objeto que est sendo exibido. Se quiser utilizar a
palavra-chave full, deve ter tambm o acesso display para as tarefas contidas na
definio do fluxo de tarefa.
Sintaxe
{display | di}
[parms | parm | vb=variablename.]variablename] |
[cpu={workstationame | workstationclassname | domainame}]
[workstation | ws=workstationame] |
[workstationclass | wscl=workstationclassname] |
[;full]] |
[;offline]
Argumentos
Se nenhum argumento vier em seguida, esse comando exibir todas as
Se o argumento calname vier em seguida, ele exibir o calendrio calname.
Se o argumento eventrulename vier em seguida, ele exibir a regra de
parms | parm | vb
exibir a varivel variablename da tabela especificada. Se a tabela de
variveis tablename for omitida, composer procurar a definio da varivel
na tabela de variveis padro. Caracteres curinga podem ser utilizados na
tabela de variveis tablename e na tabela variablename. Por exemplo:
display parms=@.@
Exibe todas as variveis em todas as tabelas.

display parms=@
Exibe todas as variveis da tabela padro.

display parms=@.acct@
270
Exibe todas as variveis cujo nome inicia com acct em todas as tabelas
existentes.
vartable | vt
comando exibir a tabela de variveis tablename. Caracteres curinga so
permitidos.
prompts | prom
definies de prompt.
Se o argumento promptname vier em seguida, ele exibir o prompt
exibir o recurso resourcename da estao de trabalho workstationame em que
o recurso est definido. Se workstationame for omitido, o padro ser a
cpu
Exibe estaes de trabalho, classes de estao de trabalho ou domnios.

estao de trabalho
workstationclass
permitidos.
domnio
workstation | ws
Se o argumento workstationname vier em seguida, ele exibir a estao de
trabalho workstationname. Caracteres curinga so permitidos.
domain | dom
definies de domnio.
Se o argumento domainname vier em seguida, ele exibir o domnio
Se o argumento workstationclassname vier em seguida, ele exibir a classe da
estao de trabalho workstationclassname. Caracteres curinga so permitidos.
definies de tarefa.
271
Se o argumento workstationame#jobname vier em seguida, exibir a tarefa

jobname da estao de trabalho workstationame em que a tarefa executada.
Se workstationame for omitido, o padro ser a estao de trabalho em que
o composer est em execuo. Caracteres curinga so permitidos para
workstationame e jobname.
Se o argumento workstationame#jstreamname vier em seguida, ele exibir o
fluxo de tarefas est definido. Se workstationame for omitido, o padro ser
a estao de trabalho em que o composer est em execuo. Caracteres
curinga so permitidos para workstationame e jstreamname.
vlido a partir de
vlido at
valid in
full
Exibe tambm todas as definies de tarefas contidas no fluxo de

tarefas.
users | user
definies de usurio.
Se o argumento workstationame#username vier em seguida, exibir o usurio
username da estao de trabalho workstationame em que o usurio est
definido. Se workstationame for omitido, o padro ser a estao de trabalho
em que o composer est em execuo. Caracteres curinga so permitidos
para workstationame e username.
;offline
Envia a sada do comando para o dispositivo de sada do composer. Para
obter informaes sobre esse dispositivo, consulte Variveis do UNIX na
pgina 248.
Resultados
O comando display retorna as seguintes informaes sobre o objeto a ser exibido:
v uma linha de resumo contendo informaes sobre o objeto selecionado
v a definio do objeto selecionado
Dependendo do valor configurado na varivel local MAESTROCOLUMNS, a linha
de resumo mostra diferentes conjuntos de informaes sobre o objeto selecionado.
A Tabela 51 na pgina 273 mostra um exemplo da sada produzida com base no
valor configurado para a varivel MAESTROCOLUMNS.
272
Tabela 51. Formatos de Sada para Exibir Objetos de Planejamento

Tipo do
Objeto
Formato de sada se
MAESTROCOLUMNS<120
Formato de Sada Se
MAESTROCOLUMNS 120
Calendar
"CalendarName : UpdatedOn :
UpdatedBy : LockedBy"
"CalendarName : UpdatedBy :
UpdatedOn : LockedBy : LockedOn"
Domnio
"DomainName : ParentDomain :
Master : UpdatedOn : LockedBy"
Master : UpdatedBy : UpdatedOn :
LockedBy : LockedOn"
Regra de
Evento
"EventRuleName : Type : Draft :

Status : UpdatedOn : LockedBy"

Status : UpdatedOn : LockedBy :
LockedOn"
Tarefa
"Workstation : JobDefinitionName :
UpdatedOn : LockedBy"
TaskType : UpdatedBy : LockedBy :
LockedOn"
Fluxo de
Tarefas
"Workstation : JobstreamName :
"Workstation : JobstreamName : Draft
Validfrom : UpdatedOn : LockedBy" : ValidFrom : ValidTo : UpdatedBy :
Parmetro
"VariableTableName : VariableName "VariableTableName : VariableName :

: UpdatedOn : LockedBy"
UpdatedBy : UpdatedOn : LockedBy
: LockedOn"
Aviso
Recurso
Tabela de
Variveis
"PromptName : UpdatedOn :
LockedBy "
"PromptName : UpdatedBy :
"Workstation : ResourceName :
Quantity : UpdatedOn : LockedBy " Quantity : UpdatedBy : UpdatedOn :
"VariableTableName : Default :
UpdatedOn : LockedBy "
: LockedOn"
Usurio do
Windows
"Workstation : UserName :
"UserName : Workstation :
: LockedOn"
Estao de
Trabalho
"WorkstationName : Type : Domain

: Ignored : UpdatedOn : LockedBy"
"WorkstationName : Type : Domain :

OsType : Ignored : UpdatedBy :
Classe de
Estao de
Trabalho
"WorkstationClassName : Ignored :
: LockedOn"
Consulte Sada Off-line na pgina 247 para obter informaes adicionais sobre
como configurar MAESTROCOLUMNS.
Exemplos
Para exibir todos os calendrios, execute o seguinte comando:
display calendars=@
esta uma sada de amostra:

Calendar Name
Updated On Locked By
---------------- ---------- --------------------HOLIDAYS
12/31/2005 tws83
HOLIDAYS
01/01/2006 02/15/2006 05/31/2006
273
Calendar Name
---------------- ---------- --------------------MONTHEND
01/01/2006 MONTHEND
"Month end dates 1st half 2006"
01/31/2006 02/28/2006 03/31/2006 04/30/2006 05/31/2006 06/30/2006
Calendar Name
---------------- ---------- --------------------PAYDAYS
01/02/2006 PAYDAYS
01/15/2006 02/15/2006 03/15/2006 04/15/2006 05/14/2006 06/15/2006
Para imprimir a sada do comando display de todos os fluxos de tarefa ativados na

estao de trabalho site2, execute o seguinte comando:
di sched=site2#@;off-line
Consulte tambm
v Para exibir estaes de trabalho, clique em Ambiente de
v Para exibir regras de eventos, clique em Carga de TrabalhoDesignListar
Regras de Eventos e ative ou crie uma tarefa para recuperar definies de
regras de eventos
v Para exibir todos os outros objetos, clique em Carga de
4. Liste os objetos que deseja exibir usando os filtros fornecidos e clique em
Exibir.
edit
Edita um arquivo.
Autorizao
comando.
Sintaxe
{edit | ed} filename
Argumentos
nome do arquivo
O nome do arquivo a ser editado.
274
Comentrios
Um editor iniciado e o arquivo especificado aberto para edio. Consulte O
Editor do Composer na pgina 248 para obter informaes adicionais.
Exemplos
Para abrir o arquivo mytemp para edio, execute o seguinte comando:
edit mytemp
Para abrir o arquivo resfile para edio, execute o seguinte comando:

ed resfile
exit
Sai do programa de linha de comandos do composer.
Autorizao
comando.
Sintaxe
{exit | e}
Comentrios
Quando o programa de linha de comandos do composer est sendo executado no
modo de ajuda, esse comando retorna o composer para o modo de entrada do
comando.
Exemplos
Para sair do programa de linha de comandos do composer, execute o seguinte
comando:
exit
ou:
e
extract
Cria um arquivo de texto que contm definies de objetos extradas do banco de
dados.
Autorizao
Voc deve ter o acesso display para os objetos que esto sendo copiados e, se
quiser utilizar a palavra-chave ;lock, tambm o acesso modify.
Sintaxe
{create | cr | extract | ex} filename from
275

[cpu={workstationame | workstationclassname | domainame}] |
[;full]] |
[;lock]
Argumentos
nome do arquivo
Especifica o nome do arquivo que contm as definies de objetos.
Se nenhum argumento vier em seguida, esse comando copiar todas as
definies do calendrio no arquivo.
Se o argumento calname vier em seguida, ele copiar o calendrio calname
no arquivo. Caracteres curinga so permitidos.
definies de regra de evento no arquivo XML.
Se o argumento eventrulename vier em seguida, ele copiar a regra de
evento eventrulename no arquivo. Caracteres curinga so permitidos.
parms | parm | vb
definies de variveis globais localizadas na tabela de varivel padro no
arquivo.
copiar a varivel variablename da tabela de variveis tablename especificada
para o arquivo. Se a tabela de variveis tablename for omitida, composer
procurar a definio da varivel na tabela de variveis padro. Caracteres
curinga so permitidos na tabela de variveis tablename e na varivel
variablename.
Por exemplo:
create parmfile from parms=@.@
Copia todas as variveis de todas as tabelas.

create parmfile from parms=@
Copia todas as variveis da tabela padro.

create parmfile
from parms=@.acct@
Copia todas as variveis cujo nome inicia com acct a partir de todas as
tabelas existentes.
276
Lembre-se: Utilizar a opo ;lock em uma varivel bloqueia a tabela de

variveis que ela contm. Isso indica que, enquanto a tabela
est bloqueada, nenhum outro usurio pode executar nenhum
outro comando de bloqueio nela ou nas variveis que ela
contm.
vartable | vt
definies da tabela de variveis no arquivo.
comando copiar a tabela de variveis tablename no arquivo. Caracteres
curinga so permitidos.
prompts | prom
definies de prompt no arquivo.
Se o argumento promptname vier em seguida, ele copiar o prompt
promptname no arquivo. Caracteres curinga so permitidos.
definies de recurso no arquivo.
Se o argumento workstationame#resourcename vier em seguida, copiar o
recurso resourcename da estao de trabalho workstationame em que o
recurso est definido no arquivo. Se workstationame for omitido, o padro
ser a estao de trabalho em que o composer est em execuo.
Caracteres curinga so permitidos para workstationame e resourcename.
cpu
Copia estaes de trabalho, classes de estao de trabalho ou domnios

para o arquivo.
estao de trabalho
workstationclass
permitidos.
domnio
workstation | ws
Se nenhum argumento vier em seguida, todas as definies de estao de
trabalho sero copiadas no arquivo.
Se o argumento workstationname vier em seguida, copiar a estao de
trabalho workstationname no arquivo. Caracteres curinga so permitidos.
domain | dom
Se nenhum argumento vier em seguida, todas as definies de domnio
sero copiadas no arquivo.
Se o argumento domainname vier em seguida, o domnio domainname ser
copiado no arquivo. Caracteres curinga so permitidos.
Se nenhum argumento vier em seguida, todas as definies de classe de
estao de trabalho sero copiadas no arquivo.
277
Se o argumento workstationclassname vier em seguida, copiar a classe da

estao de trabalho workstationclassname no arquivo. Caracteres curinga so
permitidos.
Se nenhum argumento vier em seguida, todas as definies de tarefa sero
copiadas no arquivo.
Se o argumento workstationame#jobname vier em seguida, copiar a tarefa
jobname da estao de trabalho workstationame em que a tarefa executada
no arquivo. Se workstationame for omitido, o padro ser a estao de
Se nenhum argumento vier em seguida, todas as definies de fluxo de
tarefas sero copiadas no arquivo.
Se o argumento workstationame#jstreamname vier em seguida, copiar o
fluxo de tarefas est definido no arquivo. Se workstationame for omitido, o
padro ser a estao de trabalho em que o composer est em execuo.
Caracteres curinga so permitidos para workstationame e jstreamname.
vlido a partir de
vlido at
valid in
full
Copia tambm todas as definies de tarefas contidas no fluxo de

tarefas.
users | user
Se nenhum argumento vier em seguida, todas as definies de usurio
sero copiadas no arquivo.
Se o argumento workstationame#username vier em seguida, copiar o usurio
username da estao de trabalho workstationame em que o usurio est
definido no arquivo. Se workstationame for omitido, o padro ser a estao
de trabalho em que o composer est em execuo. Caracteres curinga so
permitidos para workstationame e username. O campo de senha no
copiado por motivos de segurana.
;lock
Especifica que o objeto selecionado deve ser mantido bloqueado.
Comentrios
possvel utilizar este comando para criar um arquivo que contm definies de
parmetros a serem importadas no banco de dados de parmetros definido
localmente em uma estao de trabalho. Para obter informaes adicionais sobre
como importar definies de parmetros localmente, consulte parms na pgina
466.
278
possvel chamar o comando com o nome antigo create ou o novo nome

extract. Sem a opo lock, o bloqueio de banco de dados no verificado e
todos os objetos correspondentes so extrados para o arquivo. Aps criar um
arquivo, possvel utilizar o comando edit para fazer alteraes no arquivo e o
comando add ou replace para incluir ou atualizar o banco de dados.
possvel especificar com a opo lock se os objetos que respondem aos critrios
selecionados precisam permanecer bloqueados pelo usurio no banco de dados. Se
o composer, durante a extrao, localizar algum desses objetos j bloqueados por
outra pessoa, esses objetos no sero inseridos no arquivo e uma mensagem para
stdout ser apresentada para cada objeto bloqueado.
Exemplos
Para criar um arquivo denominado caltemp contendo todos os calendrios, execute
o seguinte comando:
create caltemp from calendars=@
Para criar um arquivo denominado stemp que contenha todos os fluxos de tarefa
definidos na estao de trabalho em que o composer executado, execute o
seguinte comando:
cr stemp from jobstream=@
Para criar um arquivo denominado alljobs.txt contendo todas as definies de

tarefa, execute o seguinte comando:
extract alljobs.txt from jd=@#@
Para criar um arquivo denominado allrules.xml contendo todas as definies de

regras de eventos, execute o seguinte comando:
ex allrules.xml from erule=@
help
Exibe a ajuda on-line para um comando ou exibe a lista de comandos que podem
ser emitidos a partir do composer. No disponvel no Windows.
Autorizao
comando.
Sintaxe
{help | h} {command|keyword}
Argumentos
comando
Especifica o nome de um comando do composer ou do sistema. Para
comandos do composer, digite o nome completo do comando; abreviaes
e formas curtas no so suportadas.
keyword
Voc tambm pode digitar as seguintes palavras-chave:
COMMANDS
Lista todos os comandos do composer.
279
RUNCONPOSER
Como executar o composer.
SETUPCOMPOSER
Descreve como configurar para usar o composer.
SPECIALCHAR
Descreve curingas, delimitadores e outros caracteres especiais que
possvel usar.
Exemplos
Para exibir uma lista de todos os comandos do composer, execute o comando a
seguir:
help commands
Para exibir informaes sobre o comando add, execute o comando a seguir:

help add
Para exibir informaes sobre caracteres especiais que possvel usar, execute o
comando a seguir:
h specialchar
list
Lista ou imprime informaes de resumo sobre os objetos definidos no banco de
dados do Tivoli Workload Scheduler. List fornece a lista de nomes de objetos com
seus atributos. Print envia a lista de nomes de objetos com seus atributos para o
dispositivo ou o arquivo especificado na varivel local MAESTROLP. O comando
print pode ser utilizado para enviar a sada para uma impressora local, se a
varivel MAESTROLP estiver definida adequadamente.
Autorizao
Voc deve ter acesso display para o objeto que est sendo listado ou impresso se a
opo enListSecChk est configurada para yes no gerenciador de domnio mestre.
Sintaxe
{list | l}
[valid from date|
valid to date |valid in date date] |
[;offline]
280
Argumentos
Se nenhum argumento vier em seguida, esse comando listar ou imprimir
todas as definies de calendrio.
Se o argumento calname vier em seguida, ele listar ou imprimir o
calendrio calname. Caracteres curinga so permitidos.
todas as definies de regra de evento.
Se o argumento eventrulename vier em seguida, ele listar ou imprimir a
regra de evento eventrulename. Caracteres curinga so permitidos.
parms | parm | vb
todas as definies de variveis globais localizadas na tabela de variveis
padro.
listar ou imprimir a varivel variablename da tabela tablename. Se
tablename for omitido, composer procurar a definio da varivel na tabela
de variveis padro. Caracteres curinga podem ser utilizados em tablename
e variablename. Por exemplo:
list parms=@.@
Lista todas as variveis contidas em todas as tabelas.

list parms=@
Lista todas as variveis da tabela padro.

list parms=@.acct@
Lista todas as variveis cujo nome inicia com acct em todas as tabelas
existentes.
vartable | vt
todas as definies de tabela de variveis.
comando listar ou imprimir a tabela de variveis tablename. Caracteres
prompts | prom
todas as definies de prompt.
Se o argumento promptname vier em seguida, ele listar ou imprimir o
prompt promptname. Caracteres curinga so permitidos.
todas as definies de recurso.
listar ou imprimir o recurso resourcename da estao de trabalho
workstationame em que o recurso est definido. Se workstationame for
281
omitido, o padro ser a estao de trabalho em que o composer est em

execuo. Caracteres curinga so permitidos para workstationame e
resourcename.
cpu
Lista ou imprime estaes de trabalho, classes de estao de trabalho ou

domnios.
estao de trabalho
workstationclass
permitidos.
domnio
workstation | ws
todas as definies de estao de trabalho.
Se o argumento workstationname vier em seguida, ele listar ou imprimir a
estao de trabalho workstationname. Caracteres curinga so permitidos.
domain | dom
todas as definies de domnio.
Se o argumento domainname vier em seguida, ele listar ou imprimir o
domnio domainname. Caracteres curinga so permitidos.
todas as definies de classe de estao de trabalho.
Se o argumento workstationclassname vier em seguida, ele listar ou
imprimir a classe da estao de trabalho workstationclassname. Caracteres
todas as definies de tarefa.
Se o argumento workstationame#jobname vier em seguida, ele listar ou
imprimir a tarefa jobname da estao de trabalho workstationame em que a
tarefa executada. Se workstationame for omitido, o padro ser a estao
de trabalho em que o composer est em execuo. Caracteres curinga so
todas as definies de fluxo de tarefas.
Se o argumento workstationame#jstreamname vier em seguida, ele listar ou
imprimir o fluxo de tarefas jstreamname da estao de trabalho
workstationame em que o fluxo de tarefas est definido. Se workstationame
for omitido, o padro ser a estao de trabalho em que o composer est
em execuo. Caracteres curinga so permitidos para workstationame e
jstreamname.
vlido a partir de
date Restringe a seleo de fluxos de tarefas que possuem uma data
valid from igual ao valor indicado. O formato mm/dd/aaaa.
282
vlido at
date Restringe a seleo de fluxos de tarefas que possuem uma data
valid to igual ao valor indicado. O formato mm/dd/aaaa.
valid in
users | user
todas as definies de usurio.
Se o argumento workstationame#username vier em seguida, ele listar ou
imprimir o usurio username da estao de trabalho workstationame em que
o usurio est definido. Se workstationame for omitido, o padro ser a
curinga so permitidos para workstationame e username.
;offline
Envia a sada do comando para o dispositivo de sada do composer. Para
obter informaes sobre esse dispositivo, consulte Variveis do UNIX na
pgina 248. O comando list ..... ;offline equivalente ao comando print.
Resultados
List fornece a lista de nomes de objetos com seus atributos. Print envia a lista de
nomes de objetos com seus atributos para o dispositivo ou o arquivo definido na
varivel local MAESTROLP. O comando print poder ser utilizado para enviar a
sada para uma impressora local, se a varivel MAESTROLP estiver definida
adequadamente. Certifique-se de que MAESTROLP configurado em seu ambiente
antes de executar o comando de impresso.
Dependendo do valor configurado na varivel local MAESTROCOLUMNS, os
diferentes conjuntos de informaes sobre o objeto selecionado podem ser
mostrados.
A Tabela 52 mostra um exemplo da sada produzida para o valor configurado para
a varivel MAESTROCOLUMNS.
Tabela 52. Formatos de Sada para Exibir Objetos de Planejamento
Tipo do
Objeto
Formato de sada se
MAESTROCOLUMNS<120
Formato de Sada Se
MAESTROCOLUMNS 120
Calendar
"CalendarName : UpdatedOn :
UpdatedBy : LockedBy"
"CalendarName : UpdatedBy :
Domnio
Master : UpdatedOn : LockedBy"
Master : UpdatedBy : UpdatedOn :
Regra de
Evento

Status : UpdatedOn : LockedBy"

Status : UpdatedOn : LockedBy :
LockedOn"
Tarefa
TaskType : UpdatedBy : LockedBy :
LockedOn"
Fluxo de
Tarefas
"Workstation : JobstreamName :
"Workstation : JobstreamName : Draft
Validfrom : UpdatedOn : LockedBy" : ValidFrom : ValidTo : UpdatedBy :
283
Tabela 52. Formatos de Sada para Exibir Objetos de Planejamento (continuao)

Tipo do
Objeto
Parmetro
Formato de sada se
MAESTROCOLUMNS<120
"VariableTableName : VariableName "VariableTableName : VariableName :

: UpdatedOn : LockedBy"
: LockedOn"
Aviso
Recurso
Tabela de
Variveis
Formato de Sada Se
MAESTROCOLUMNS 120
"PromptName : UpdatedOn :
LockedBy "
"PromptName : UpdatedBy :
Quantity : UpdatedOn : LockedBy " Quantity : UpdatedBy : UpdatedOn :
UpdatedOn : LockedBy "
: LockedOn"
Usurio do
Windows
"Workstation : UserName :
"UserName : Workstation :
: LockedOn"
Estao de
Trabalho
"WorkstationName : Type : Domain

: Ignored : UpdatedOn : LockedBy"
"WorkstationName : Type : Domain :

OsType : Ignored : UpdatedBy :
Classe de
Estao de
Trabalho
: LockedOn"
Consulte Sada Off-line na pgina 247 para obter informaes adicionais sobre
como configurar MAESTROLP.
Exemplos
v Para listar todos os calendrios, execute o seguinte comando:
list calendars=@
esta uma sada de amostra:

Calendar Name
---------------- ---------- --------------------HOLIDAYS
03/02/2010
PAYDAYS
03/02/2010
HOLIDAYS
03/02/2010
01/01/2010 02/15/2010 05/31/2010
Calendar Name
---------------- ---------- --------------------MONTHEND
01/01/2010 MONTHEND
"Month end dates 1st half 2010"
01/31/2010 02/28/2010 03/31/2010 04/30/2010 05/31/2010 06/30/2010
Calendar Name
---------------- ---------- --------------------PAYDAYS
01/02/2010 PAYDAYS
01/15/2010 02/15/2010 03/15/2010 04/15/2010 05/14/2010 06/15/2010
v Para listar todas as suas regras de eventos definidas, execute o seguinte

comando:
284
list er=@
Se MAESTROCOLUMNS=80, a sada ser semelhante a isto:

Event Rule Name
---------------EVENT-MULTIPLE1
EVENT-MULTIPLE2
EVENT-MULTIPLE3
M_SUCC_12_S
M_SUCC_12_S_A
M_SUCC_12_S_B
NEWEVENTRULE
Type
Draft
--------- ----filter
filter
filter
sequence
Y
filter
filter
Y
filter
Status
--------active
active
active
inactive
active
inactive
active
Updated On
---------06/06/2009
06/06/2009
06/06/2009
06/07/2009
06/07/2009
06/07/2009
06/01/2009
Locked By
------------administrator
Se MAESTROCOLUMNS120, a sada ser semelhante a isto:

Event Rule Name
--------------------EVENT-MULTIPLE1
EVENT-MULTIPLE2
EVENT-MULTIPLE3
M_SUCC_12_S
M_SUCC_12_S_A
M_SUCC_12_S_B
NEWEVENTRULE
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Type
Draft Status
--------- ----- -------filter
active
filter
active
filter
active
sequence
Y
inactive
filter
active
filter
Y
inactive
filter
active
---------- --------06/06/2009 06/06/2009 06/06/2009 06/07/2009 06/07/2009 06/07/2009 06/01/2009 administrator
v Para visualizar as propriedades da estao de trabalho de agente dinmico

NC11500691, execute o comando a seguir:
list ws=NC1150691
Uma sada semelhante seguinte exibida:

Workstation Name Type
Domain
---------------- ------- ---------------NC1150691
agent
-
Ignored Updated On Locked By

------- ---------- ---------03/31/2010 -
CPUNAME NC1150691
DESCRIPTION "This workstation was automatically created at agent
installation time."
OS WNT
NODE nc115069.romelab.it.ibm.com SECUREADDR 22114
TIMEZONE GMT+1
FOR MAESTRO HOST NC115069_DWB
TYPE AGENT
PROTOCOL HTTPS
END
v Para visualizar as propriedades da estaes de trabalho do conjunto POOL_A,

incluindo todos seus membros, execute o comando a seguir:
list ws=POOL_A
Uma sada semelhante seguinte exibida:

Domain
Ignored Updated On Locked By
---------------- ------- ---------------- ------- ---------- ---------------POOL_A
pool
03/31/2010 CPUNAME POOL_A
DESCRIPTION "This is a manually created pool"
VARTABLE TABLE1
OS OTHER
TIMEZONE America/Argentina/Buenos_Aires
TYPE POOL
MEMBERS
NC1150691
NC1150692
END
285
Consulte tambm
No Dynamic Workload Console :
v Para listar estaes de trabalho, clique em Ambiente de
v Para listar regras de eventos, clique em Carga de TrabalhoDesignListar
Regras de Eventos
v Para listar todos os outros objetos, clique em Carga de
4. Liste os objetos que voc deseja ver utilizando os filtros fornecidos.
lock
Bloqueia o acesso s definies dos objetos de planejamento no banco de dados.
Autorizao
Voc deve ter acesso modify para o objeto.
Sintaxe
{lock | lo}
[eventrule | erule | er=eventrulename]
[sched|jobstream|js= [workstationame#]jstreamname
[valid from date|valid to date |valid in date date]] |
Argumentos
calendrios
Bloqueia todas as definies de calendrio.
Se nenhum argumento vier em seguida, esse comando bloquear todas as
Se o argumento calname vier em seguida, ele bloquear o calendrio
calname. Caracteres curinga so permitidos.
286
Se o argumento eventrulename vier em seguida, ele bloquear a regra de

parms | parm | vb
Se nenhum argumento vier em seguida, esse comando bloquear a tabela
de variveis padro inteira.
bloquear a tabela inteira que contm a varivel variablename. Se tablename
for omitido, composer bloquear a tabela de variveis padro inteira.
Nota: Quando voc bloqueia uma varivel, a tabela de variveis inteira em
que ela est contida bloqueada. Isso indica que, enquanto a tabela
est bloqueada, nenhum outro usurio pode executar nenhum outro
comando de bloqueio nela.
Caracteres curinga podem ser utilizados em tablename e variablename. Por
exemplo:
lock parms=@.@
Bloqueia todas as variveis em todas as tabelas. Como resultado, todas as

tabelas de variveis so bloqueadas.
lock parms=@
Bloqueia todas as variveis na tabela padro. Como resultado, a tabela de

variveis bloqueada.
lock parms=@.acct@
Bloqueia todas as variveis cujo nome inicia com acct em todas as tabelas
existentes. Como resultado, todas as tabelas de variveis que contm pelo
menos uma varivel denominada dessa forma so bloqueadas.
vartable | vt
comando bloquear a tabela de variveis tablename. Caracteres curinga so
permitidos.
prompts | prom
definies de prompt.
Se o argumento promptname vier em seguida, ele bloquear o prompt
bloquear o recurso resourcename da estao de trabalho workstationame em
cpu
Bloqueia estaes de trabalho, classes de estao de trabalho ou domnios.

estao de trabalho
287
workstationclass
permitidos.
domnio
workstation | ws
Se o argumento workstationname vier em seguida, ele bloquear a estao
de trabalho workstationname. Caracteres curinga so permitidos.
domain | dom
definies de domnio.
Se o argumento domainname vier em seguida, ele bloquear o domnio
Se o argumento workstationclassname vier em seguida, ele bloquear a classe
da estao de trabalho workstationclassname. Caracteres curinga so
permitidos.
definies de tarefa.
Se o argumento workstationame#jobname vier em seguida, ele bloquear a
Se o argumento workstationame#jstreamname vier em seguida, ele bloquear
o fluxo de tarefas jstreamname da estao de trabalho workstationame em que
o fluxo de tarefas est definido. Se workstationame for omitido, o padro
vlido a partir de
vlido at
valid in
288
users | user
definies de usurio.
Se o argumento workstationame#username vier em seguida, ele bloquear o
permitidos para workstationame e username.
Comentrios
Objetos so bloqueados para assegurar que as definies no banco de dados no
sejam sobrescritas por diferentes usurios que esto acessando simultaneamente os
mesmos objetos.
Com esse comando, o usurio adquire bloqueios de objetos de banco de dados
explicitamente. Quando um usurio tiver um objeto bloqueado, qualquer outro
usurio ter acesso de leitura at o objeto ser liberado ou explicitamente
desbloqueado pelo administrador. Se um usurio tentar bloquear um objeto que j
est bloqueado por outra pessoa (outro usurio), uma mensagem de erro
retornada.
Bloqueios em objetos de banco de dados so adquiridos pelo usurio utilizando
username e session, em que session uma cadeia que pode ser configurada na
varivel de ambiente TWS_SESSION que identifica essa sesso de trabalho do
usurio especfica.
Isto significa que, em uma mquina, o identificador TWS_SESSION diferente
para:
v um usurio conectado em dois shells diferentes ao programa de linha de
comandos composer.
v um usurio conectado, desconectado e, em seguida, conectado novamente
linha de comandos composer a partir do mesmo shell.
Se nenhum valor for designado a TWS_SESSION, o valor padro que identifica a
sesso ser configurado conforme a seguir:
v Se estiver utilizando composer no modo em lote, o valor padro ser o username
utilizado pelo usurio ao se conectar ao gerenciador de domnio mestre.
v Se estiver utilizando o composer no modo interativo, o valor padro
corresponder a uma cadeia alfanumrica criada automaticamente pelo produto.
Nota: No banco de dados, o username do usurio que est bloqueando uma
definio de objeto salvo em maisculas.
Exemplos
Para bloquear o calendrio denominado Holidays, execute o comando:
lock calendar=HOLIDAYS
Consulte tambm
No Tivoli Dynamic Workload Console, os objetos so bloqueados automaticamente
contanto que voc ou outro usurio os tenha aberto utilizando o boto Editar. Os
objetos no sero bloqueados se voc ou outro usurio os abriu com Visualizar.
289
modify
Modifica ou adiciona objetos de planejamento. Ao modificar os objetos, o comando
modify extrair somente os objetos que podero ser bloqueados pelo usurio atual.
Autorizao
Voc deve ter o acesso add se incluir um novo objeto de planejamento. Se o objeto
j existir no banco de dados, voc dever ter o acesso modify ao objeto.
Sintaxe
{modify | m}
[;full]] |
Argumentos
Se nenhum argumento vier em seguida, esse comando modificar todas as
Se o argumento calname vier em seguida, ele modificar o calendrio
Se o argumento eventrulename vier em seguida, ele modificar a regra de
parms|parm|vb
modificar a varivel especificada da tabela tablename. Se tablename for
omitido, composer procurar a definio da varivel variablename na tabela
de variveis padro. Caracteres curinga podem ser utilizados em tablename
e variablename. Por exemplo:
modify parms=@.@
Modifica todas as variveis contidas em todas as tabelas.

modify parms=@
290
Modifica todas as variveis da tabela padro.

modify parms=@.acct@
Modifica todas as variveis cujo nome inicia com acct em todas as tabelas
existentes.
Lembre-se: A ao de modificar ou incluir uma varivel bloqueia a tabela
de variveis que ela contm. Isso indica que, enquanto a tabela
est bloqueada, nenhum outro usurio pode executar nenhum
outro comando de bloqueio nela ou nas variveis que ela
contm.
vartable | vt
comando modificar a tabela de variveis tablename. Caracteres curinga so
permitidos.
prompts | prom
definies de prompt.
Se o argumento promptname vier em seguida, ele modificar o prompt
modificar o recurso resourcename da estao de trabalho workstationame em
cpu
Modifica estaes de trabalho, classes de estao de trabalho ou domnios.

estao de trabalho
workstationclass
permitidos.
domnio
workstation | ws
Se o argumento workstationname vier em seguida, ele modificar a estao
de trabalho workstationname. Caracteres curinga so permitidos.
domain | dom
definies de domnio.
Se o argumento domainname vier em seguida, ele modificar o domnio
291
Se o argumento workstationclassname vier em seguida, ele modificar a
classe da estao de trabalho workstationclassname. Caracteres curinga so
permitidos.
definies de tarefa.
Se o argumento workstationame#jobname vier em seguida, ele modificar a
Se o argumento workstationame#jstreamname vier em seguida, ele modificar
vlido a partir de
vlido at
valid in
full
Modifica todas as definies de tarefas contidas no fluxo de tarefas.
users | user
definies de usurio.
Se o argumento workstationame#username vier em seguida, modificar o
Comentrios
O comando modify executa a seguinte seqncia de aes:
1. Bloqueia os objetos no banco de dados.
2. Copia a definio de objetos para um arquivo temporrio.
3. Edita o arquivo.
4. Modifica a definio contida no arquivo temporrio no banco de dados.
292
5. Se o comando modify falhar em um subconjunto dos objetos selecionados, o

composer perguntar "deseja editar novamente?" e o arquivo salvo antes
reaberto para edio e as prximas etapas da seqncia so repetidas.
6. Desbloqueia os objetos no banco de dados.
Definies de regras de eventos so abertas com um editor de XML (consulte
Definio da Regra de Evento na pgina 234 para referncia XML e consulte O
Editor do Composer na pgina 248 para obter detalhes sobre como configurar um
editor de XML).
Se voc modificar com o mesmo comando modify dois ou mais objetos vinculados
por qualquer relacionamento, por exemplo, uma tarefa sucessora e sua tarefa
predecessora, ento, pode ser relevante para o resultado bem-sucedido do
comando modify a ordem na qual os objetos so listados no arquivo temporrio.
Isto acontece porque o comando modify l em seqncia os objetos contidos no
arquivo temporrio; portanto, se o objeto de referncia for exibido antes do objeto
que est sendo referenciado, o comando modify poder falhar no objeto de
referncia.
Por exemplo, se o comando:
modify FTA1#@PROVA
produzir o seguinte arquivo temporrio:

SCHEDULE FTA1#PROVA VALIDFROM 08/31/2005
MATCHING SAMEDAY
:
FTA2#MY-JOB
FOLLOWS FTA1#COPYOFPROVA.MY-JOB06
END
SCHEDULE FTA1#COPYOFPROVA VALIDFROM 08/31/2005
MATCHING SAMEDAY
:
FTA1#MY-JOBO6
END
e voc alterar o nome da tarefa do predecessor de FTA1#MY-JOB06 para

FTA1#MY-JOB05 em ambos os fluxos de tarefas, FTA1#PROVA e FTA1#COPYOFPROVA, o
comando modify:
1. Primeiro tentar alterar a definio do fluxo de tarefas FTA1#PROVA e falhar
porque ele localizar uma dependncia follows de uma tarefa FTA1#MY-JOB05
que ainda desconhecida.
2. Em seguida, tentar alterar a definio de FTA1#COPYOFPROVA e ser
bem-sucedido.
Na segunda vez, execute modify para alterar a tarefa do predecessor de
FTA1#MY-JOB06 para FTA1#MY-JOB05 no fluxo de tarefas FTA1#PROVA, o comando ser
desempenhado com xito pois a tarefa do predecessor FTA1#MY-JOB05 agora existir
no banco de dados.
Se o fluxo de tarefa FTA1#COPYOFPROVA tivesse sido listado no arquivo temporrio
antes de FTA1#PROVA, o comando modify teria sido executado com xito na
primeira vez porque o nome da tarefa do predecessor teria sido modificado antes
de alterar a definio de dependncia na tarefa sucessora.
293
Para definies do usurio, se o campo de senha mantiver o valor "*******"

quando voc sair do editor, a senha antiga ser retida. Para especificar uma senha
nula, utilize duas aspas duplas consecutivas ().
O comando modify verifica as dependncias de loop dentro dos fluxos de tarefas.
Por exemplo, se job1 seguir job2 e job2 seguir job1, haver uma dependncia de
loop. Quando for localizada uma dependncia de loop dentro de um fluxo de
tarefas, um erro ser exibido. O comando modify no verifica dependncias de
loop entre fluxos de tarefas porque, dependendo da complexidade das atividades
de planejamento, esta verificao poder ser muito demorada e consumir muita
CPU.
Exemplos
Para modificar todos os calendrios, execute o seguinte comando:
modify calendars=@
Para modificar o fluxo de tarefas sked9 ativado na estao de trabalho site1,

m sched=site1#sked9
Para modificar todas as regras de eventos que incluem uma ao com a tarefa
DPJOB10, execute:
mod er=@;filter job=DPJOB10
Consulte tambm
v Para modificar estaes de trabalho, clique em Ambiente de
v Para modificar regras de eventos, clique em Carga de
TrabalhoDesignListar Regras de Eventos
v Para modificar todos os outros objetos, clique em Carga de
4. Liste os objetos que voc deseja modificar utilizando os filtros fornecidos,
selecione-os e clique em Editar.
new
Inclui uma nova definio de objeto de planejamento no banco de dados.
Autorizao
j existir no banco de dados, voc deve ter o acesso modify para o objeto.
Sintaxe
new
[calendar |
294
domain |
eventrule |
job |
jobstream |
parameter |
prompt |
resource |
user |
vartable |
workstation |
workstation_class]
Argumentos
O objeto que voc deseja definir: um calendrio, um domnio, uma regra de
evento, uma tarefa, um fluxo de tarefas, uma varivel, um prompt, um recurso, um
usurio, uma tabela de variveis, uma estao de trabalho ou uma classe de
estao de trabalho.
Comentrios
O comando abre um modelo predefinido que ajuda a editar a definio de objeto e
a inclui no banco de dados quando voc a salva.
Os modelos de objetos esto localizados na subpasta templates no diretrio de
instalao do Tivoli Workload Scheduler. Eles podem ser customizados para se
ajustarem s suas preferncias.
Definies de regras de eventos so abertas com um editor de XML (consulte
Definio da Regra de Evento na pgina 234 para referncia XML e consulte O
Editor do Composer na pgina 248 para obter detalhes sobre como configurar um
editor de XML).
Enquanto voc cria uma varivel, a tabela de variveis de destino bloqueada.
Isso indica que, enquanto a tabela est bloqueada, nenhum outro usurio pode
executar nenhum outro comando de bloqueio nela.
Exemplos
Para criar uma nova definio de usurio, execute:
new user
Para criar uma nova definio de prompt, execute:

new prompt
Para criar uma nova definio de regra de evento, execute:

new erule
Para criar uma nova definio de tabela de variveis, execute:

new vartable
Para criar uma nova definio de varivel, execute:

new parameter
295
Consulte tambm
v Para incluir estaes de trabalho, clique em Ambiente de
v Para incluir regras de eventos, clique em Carga de TrabalhoDesignCriar
Regras de Eventos
v Para incluir todos os outros objetos, clique em Carga de
TrabalhoDesignCriar Definies de Carga de Trabalho
4. Execute um dos seguintes itens:
v Para estaes de trabalho, especifique suas opes no painel de propriedades
v Para regras de eventos, especifique suas opes no painel Editor de Regras
de Eventos
v Para todos os outros objetos:
a. Clique em Novo na barra de ferramentas Lista de Trabalho da janela
pop-up resultante
b. Selecione o tipo de objeto que deseja incluir
c. Especifique suas opes no painel de propriedades
print
Esse um sinnimo do comando list. Consulte list na pgina 280 para obter
detalhes.
redo
Edita e executa o comando anterior novamente.
Nota: Se o comando anterior for authenticate, redo no exibe a senha especificada.
Autorizao
comando.
Sintaxe
{redo | red}
Contexto
Quando voc executa o comando redo, o composer exibe o comando anterior para
que possa ser editado e executado novamente. Utilize a barra de espaos para
mover o cursor sob o caractere a ser modificado e digite as diretrizes a seguir.
Diretrizes
296
d[dir]
Exclui o caractere acima de d. Pode vir seguido por outras

diretrizes.
itext
Insere texto antes do caractere acima de i.
rtext
Substitui um ou mais caracteres por texto, comeando com o

caractere acima de r. A substituio estar implcita se nenhuma
outra diretriz for digitada.
>text
Anexa texto no final da linha.
>d[dir | text]
Exclui caracteres no final da linha. Pode vir seguido por outra
diretriz ou texto.
>rtext
Substitui caracteres no final da linha por texto.
Exemplos de Diretrizes
ddd
Exclui os trs caracteres acima de ds.
iabc
Insere abc antes do caractere acima de i.
rabc
Substitui os trs caracteres, comeando pelo caractere acima de r,

por abc.
abc
Substitui os trs caracteres acima de abc por abc.
d diabc
Exclui o caractere acima do primeiro d, pula um caractere, exclui o
caractere acima do segundo d e insere abc em seu lugar.
>abc
Anexa abc no final da linha.
>ddabc
Exclui os dois ltimos caracteres na linha e insere abc em seu
lugar.
>rabc
Substitui os trs ltimos caracteres na linha por abc.
Exemplos
Para inserir um caractere, execute o seguinte comando:
redo
dislay site1#sa@
ip
display site1#sa@
Para substituir trs caracteres, por exemplo, alterar site para serv substituindo ite
por erv, execute o seguinte comando:
redo
display site1#sa@
rerv
display serv1#sa@
rename
Renomeia um objeto de planejamento j existente no banco de dados. O novo
nome no deve identificar um objeto j definido no banco de dados.
Autorizao
Voc deve ter o acesso delete para o objeto com o antigo nome e o acesso add para
o objeto com o novo nome.
297
Sintaxe
{rename | rn}
{calendars|calendar|cal |
parms|parm|vb |
vartable|vt |
prompts|prom |
resorces|resource|res |
workstation|ws |
workstationclass|wscl |
domain|dom |
jobs|jobdefinition|jd |
jobsched|jb |
eventrule|erule|er
sched|jobstream|js
|
users|user }
old_object_identifier new_object_identifier
Argumentos
old_object_identifier
Especifica a chave externa antiga que identifica o objeto de planejamento,
por exemplo, o nome do calendrio cal1 como identificador para um
objeto calendrio definido para ser renomeado.
new_object_identifier
Especifica a nova chave externa para identificar o objeto de planejamento,
por exemplo, o nome do calendrio cal2 como novo identificador a ser
designado para o objeto calendrio anteriormente denominado cal1.
Ao que se refere tarefas, fluxos de tarefas e usurios do Windows, tanto
old_object_identifier quanto new_object_identifier tm os seguintes formatos:
[workstationame#]jobname
O comando aplica-se a essa definio de tarefa. Esse formato utilizado
com a chave jobs|jobdefinition|jd.
[workstationame#]jstreamname
O comando aplica-se a todas as verses desse fluxo de tarefas. Esse
formato utilizado com a chave sched|jobstream|js.
[workstationame#]jstreamname+valid from date
O comando aplica-se somente a essa verso desse fluxo de tarefas. Esse
formato utilizado com a chave sched|jobstream|js.
[workstationame#]jstreamname.jobname
O comando aplica-se a essa instncia de tarefa definida nesse fluxo de
tarefas. Consulte a palavra-chave js na sintaxe de Definio de fluxo de
tarefas na pgina 194 para obter detalhes adicionais. Esse formato
utilizado com a chave jobsched|jb.
[workstationame#]resourcename
O comando aplica-se a essa definio de recurso. Esse formato utilizado
como a chave resources|resource|res.
[workstationame#][domain\]username
O comando aplica-se essa definio de usurio do Windows. Esse
formato utilizado com a chave users|user.
298
Para o que envolve as variveis (parmetros globais):

old_object_identifier
Deve ser especificado no formato tablename.variablename. Se tablename for
omitido, composer procurar a varivel na tabela de variveis padro.
new_object_identifier
Deve ser especificado no formato variablename. A incluso do nome da
tabela aqui gera um erro.
Comentrios
Para ser renomeado, o objeto deve ser desbloqueado ou bloqueado pelo usurio
que emite o comando rename.
A tabela de variveis que contm a varivel bloqueada, enquanto a varivel
renomeada. Isso indica que, enquanto a tabela est bloqueada, nenhum outro
usurio pode executar nenhum outro comando de bloqueio nela.
Se um objeto denominado conforme especificado no campo old_object_identifier no
existir no banco de dados, uma mensagem de erro exibida.
A utilizao de curingas no permitida com este comando.
Quando workstationame no for especificado para os objetos que possuem o nome
da estao de trabalho como parte de seus identificadores de objetos (por exemplo,
definies de tarefas ou de fluxos de tarefas), o planejador utilizar um dos
seguintes para workstationame :
v A estao de trabalho padro especificada no arquivo localopts
v O gerenciador de domnio mestre se o programa da linha de comandos
composer estiver em execuo em um n fora da rede do Tivoli Workload
Scheduler. Nesse caso, na verdade, a estao de trabalho padro configurada no
arquivo localopts o gerenciador de domnio mestre.
O comando rename utilizado para designar novos nomes aos objetos j existentes
no banco de dados. O novo nome designado a um objeto se torna imediatamente
efetivo no banco de dados, enquanto ele se torna efetivo no plano aps o script
JnextPlan ser executado novamente. Isso pode levar a incongruncias ao enviar
tarefas ad hoc antes de gerar novamente o plano de produo.
Exemplos
Para renomear o objeto domnio DOMAIN1 para DOMAIN2, execute o seguinte
comando:
rename dom=DOMAIN1 DOMAIN2
Para renomear o fluxo de tarefas LABJST1 para LABJST2 na estao de trabalho

CPU1, execute o seguinte comando:
rename js=CPU1#LABJST1 CPU1#LABJST2
Para renomear a varivel ACCTOLD (definida na tabela ACCTAB) para ACCTNEW, execute
o seguinte comando:
rename
parm=ACCTAB.ACCTOLD ACCTNEW
299
Consulte tambm
v Para renomear estaes de trabalho, clique em Ambiente de
v Para renomear regras de eventos, clique em Carga de
TrabalhoDesignListar de Regras de Eventos
v Para renomear todos os outros objetos, clique em Carga de
TrabalhoDesignLista de Definies de Carga de Trabalho
4. Liste os objetos que deseja renomear utilizando os filtros fornecidos,
selecione-os e clique em Criar Como (estaes de trabalho ou definies de
carga de trabalho), ou Duplicar (regras de eventos).
5. Salve-os com o novo nome e exclua as definies com o nome mais antigo.
replace
Substitui as definies de objetos de planejamento no banco de dados.
Autorizao
j existir no banco de dados, voc deve ter:
v acesso modify para o objeto se o objeto no estiver bloqueado.
v acessos modify e unlock para o objeto se quiser utilizar a opo ;unlock com
objetos bloqueados por outros usurios.
Sintaxe
{replace | rep} filename [;unlock]
Argumentos
nome do arquivo
Especifica o nome de um arquivo que contm as definies de objeto a
serem substitudas. O arquivo pode conter todos os tipos de definio de
objetos de planejamento.
destravar
Atualiza objetos existentes anteriormente bloqueados e desbloqueia-os. Um
erro exibido se os objetos no estiverem anteriormente bloqueados. Para
todos os novos objetos inseridos, essa opo, se especificada, ignorada.
Comentrios
O comando replace semelhante ao comando add, exceto por no haver nenhum
prompt de confirmao para substituir objetos existentes. Para obter informaes
adicionais, consulte add na pgina 262.
O comando replace verifica as dependncias de loop dentro dos fluxos de tarefas.
Por exemplo, se job1 seguir job2 e job2 seguir job1, haver uma dependncia de
loop. Quando for localizada uma dependncia de loop dentro de um fluxo de
300
tarefas, um erro ser exibido. O comando replace no verifica as dependncias de

loop entre os fluxos de tarefas porque, dependendo da complexidade das
atividades de planejamento, esta verificao pode ser muito demorada e consumir
muita CPU.
Exemplos
Para substituir os jobs a partir do arquivo myjobs, execute o seguinte comando:
replace myjobs
Para substituir todos os recursos por aqueles contidos no arquivo myres, execute o
seguinte comando:
rep myres
Voc deseja alterar algumas definies de regras de eventos existentes no banco de

dados. Voc tambm deseja incluir algumas definies novas. Utilize este comando
da seguinte maneira:
1. Voc grava as definies inteiras em um arquivo XML nomeado como
2Q07rules.xml .
2. Voc executa:
rep 2Q07rules.xml
system command
Executa um comando do sistema.
Sintaxe
[: | !] system-command
Argumentos
system-command
Especifica qualquer comando de sistema vlido. O prefixo de dois-pontos
(:) ou ponto de exclamao (!) necessrio apenas quando o comando
grafado da mesma forma que um comando do composer.
Exemplos
Para executar um comando ps no UNIX, execute o seguinte comando:
ps -ef
Para executar um comando dir no Windows, execute o seguinte comando:

dir \bin
unlock
Libere os bloqueios de acesso nos objetos de planejamento definidos no banco de
dados. Por padro, para desbloquear um objeto, o objeto deve ter sido bloqueado
utilizando-se o mesmo usurio e sesso.
Autorizao
Voc deve ter o acesso unlock para desbloquear objetos bloqueados por outros
usurios.
301
Sintaxe
{unlock | u}
[;forced]
Argumentos
Se nenhum argumento vier em seguida, esse comando desbloquear todas
as definies de calendrio.
Se o argumento calname vier em seguida, ele desbloquear o calendrio
as definies de regra de evento.
Se o argumento eventrulename vier em seguida, ele desbloquear a regra de
parms|parm|vb
Se nenhum argumento vier em seguida, esse comando desbloquear a
tabela de variveis padro.
desbloquear a tabela inteira que contm a varivel variablename. Se
tablename for omitido, ele desbloquear a tabela de variveis padro.
Caracteres curinga podem ser utilizados em tablename e variablename. Por
exemplo:
unlock parms=@.@
Desbloqueia todas as tabelas.

unlock parms=@
Desbloqueia a tabela padro.

unlock parms=@.acct@
Desbloqueia todas as tabelas que contm as variveis cujo nome inicia com
acct.
unlock parms=acct@
Desbloqueia a tabela padro.
302
Lembre-se: A ao em uma varivel nica desbloqueia a tabela de

variveis que ela contm.
vartable | vt
as definies de tabela de variveis.
comando desbloquear a tabela de variveis tablename. Caracteres curinga
so permitidos.
prompts | prom
as definies de prompt.
Se o argumento promptname vier em seguida, ele desbloquear o prompt
as definies de recurso.
desbloquear o recurso resourcename da estao de trabalho workstationame
em que o recurso est definido. Se workstationame for omitido, o padro
Caracteres curinga so permitidos para workstationame e resourcename.
cpu
Desbloqueia estaes de trabalho, classes de estao de trabalho ou

domnios.
estao de trabalho
workstationclass
permitidos.
domnio
workstation | ws
as definies de estao de trabalho.
Se o argumento workstationname vier em seguida, ele desbloquear a
estao de trabalho workstationname. Caracteres curinga so permitidos.
domain | dom
as definies de domnio.
Se o argumento domainname vier em seguida, ele desbloquear o domnio
as definies de classe da estao de trabalho.
Se o argumento workstationclassname vier em seguida, ele desbloquear a
classe da estao de trabalho workstationclassname. Caracteres curinga so
permitidos.
303
as definies de tarefa.
Se o argumento workstationame#jobname vier em seguida, desbloquear a
as definies de fluxo de tarefas.
Se o argumento workstationame#jstreamname vier em seguida, desbloquear
vlido a partir de
vlido at
valid in
users | user
as definies de usurio.
Se o argumento workstationame#username vier em seguida, desbloquear o
forced Se especificado, permite ao usurio que bloqueou o objeto desbloque-lo,
independentemente da sesso.
Se esta opo for utilizada pelo superuser , o comando unlock poder
operar independentemente do usurio e da sesso utilizada para bloquear
o objeto.
Comentrios
Se um usurio, diferente do superuser, tentar desbloquear um objeto que est
bloqueado por outro usurio, uma mensagem de erro retornada.
Exemplos
Par desbloquear a definio de tarefa JOBDEF1, execute o seguinte comando:
unlock jd=@#JOBDEF1
304
Para desbloquear a definio da regra de evento ERJS21, execute o seguinte

comando:
unlock erule=ERJS21
Consulte tambm
v Para desbloquear as estaes de trabalho, clique em Ambiente de
v Para desbloquear regras de eventos, clique em Carga de
TrabalhoDesignListar Regras de Eventos
v Para desbloquear todos os outros objetos, clique em Carga de
4. Liste os objetos que voc deseja desbloquear utilizando os filtros fornecidos,
selecione-os e clique em Desbloquear.
validate
Desempenha a validao das definies de objetos contidas em um arquivo do
usurio.
Autorizao
Voc no precisa de nenhuma autorizao especfica para objetos para executar
esse comando.
Sintaxe
{validate | val} filename [;syntax]
Argumentos
nome do arquivo
Especifica o nome de um arquivo que contm calendrios, estaes de
trabalho, classes de estao de trabalho, domnios, tarefas, parmetros,
prompts, recursos, fluxos de tarefas, regras de eventos ou tabelas de
variveis. Para definies de regras de eventos, o arquivo deve estar na
linguagem XML. Consulte Definio da Regra de Evento na pgina 234
para obter detalhes sobre como gravar definies de regras de eventos.
sintaxe
Verifica se h erros de sintaxe no arquivo.
Comentrios
A sada do comando validate pode ser redirecionada para um arquivo como o
seguinte:
composer "validate filename" > outfile
Para incluir mensagens de erro no arquivo de sada, utilize o seguinte:

composer "validate filename" > outfile 2>&1
305
Exemplos
Para verificar a sintaxe de um arquivo contendo definies de estao de trabalho,
validate mycpus;syntax
version
Exibe o banner do programa de linha de comandos do composer.
Autorizao
comando.
Sintaxe
{version | v}
Exemplos
Para exibir o banner do programa de linha de comandos composer, execute o
seguinte comando:
verso
ou:
v
306
Captulo 10. Gerenciando Objetos no Plano - conman

O ambiente do plano de produo do Tivoli Workload Scheduler gerenciado
utilizando o programa de linha de comandos conman. O programa conman
utilizado para iniciar e parar o processamento, alterar e exibir o plano de produo
Symphony e controlar a vinculao da estao de trabalho em uma rede. Pode ser
utilizado a partir do gerenciador de domnio mestre e de qualquer agente tolerante
a falhas na rede do Tivoli Workload Scheduler. Este captulo est dividido nas
sees a seguir:
v Configurando o Programa de linha de Comandos conman
Executando comandos a partir do conman na pgina 311
Selecionando Tarefas em Comandos na pgina 313
Selecionando Fluxos de Tarefas em Comandos na pgina 322
Gerenciando Tarefas e Fluxos de Tarefas a partir de Agentes de Nvel Anterior
na pgina 328
v Conman commands na pgina 329
v
v
v
v
Configurando o Programa de linha de Comandos conman

O programa de linha de comandos conman gerencia o ambiente do plano de
produo.
possvel utilizar o programa conman a partir do gerenciador de domnio mestre
e a partir de qualquer estao de trabalho do agente tolerante a falhas na rede do
Configurando o Ambiente do conman

Esta seo fornece informaes sobre a configurao que pode ser escolhida para o
ambiente conman.
Nota: Nos sistemas Windows, antes de executar conman, assegure que a pgina de
cdigos e as fontes estejam configuradas corretamente no shell DOS para
evitar converso de caracteres invlida. Para obter informaes adicionais
sobre as configuraes requeridas, consulte a seo Internationalization notes
de IBM Tivoli Workload Scheduler: Release Notes.
Sada do Terminal
A sada para seu computador determinada pelas variveis shell chamadas
MAESTROLINES e MAESTROCOLUMNS. Se ainda no estiverem definidas, as
variveis shell padro, LINES e COLUMNS, sero utilizadas. As variveis podem
ser definidas como a seguir:
MAESTROLINES
Especifica o nmero de linhas por tela. O padro 24. No final de cada
pagina de tela, o conman solicita para continuar. Se MAESTROLINES (ou
LINES) estiver definido como zero ou um nmero negativo, o conman no
ser pausado no final de uma pgina.
307
MAESTROCOLUMNS
Especifica o nmero de caracteres por linha. As seguintes opes esto
disponveis:
v Menos que 120
v Igual ou mais que 120
Especifica como ser feita a exibio dos nomes de objetos. Se definidos
como LONG, sero exibidos nomes completos. Se no definidos ou
definidos com qualquer valor diferente de LONG, os nomes longos sero
truncados com oito caracteres seguidos de um sinal de mais (+).
Sada Off-line
A opo ;off-line nos comandos do conman utilizada, geralmente, para imprimir
a sada de um comando. Ao inclu-la, as seguintes variveis shell controlam a
sada:
MAESTROLP
Especifica o destino da sada de um comando. Defina-o como um dos
seguintes:
> file
Redireciona a sada para um arquivo e sobrescreve seu contedo.

Se o arquivo no existir, ele ser criado.
>> file Redireciona a sada para um arquivo, anexando-a ao final desse

arquivo. Se o arquivo no existir, ele ser criado.
| command
comando do sistema executado independentemente da gerao
da sada.
|| command
comando do sistema no ser executado, se no houver sada.
O valor padro para MAESTROLP | lp -tCONLIST, o que canaliza a
sada do comando para a impressora e coloca o ttulo CONLIST na
pgina do banner da impresso.
MAESTROLPLINES
MAESTROLPCOLUMNS
As variveis devem ser exportadas antes da execuo do conman.
Selecionando o Prompt do conman no UNIX

O prompt de comandos do conman , por padro, um sinal de porcentagem (%).
Isso est definido no arquivo TWS_home/localopts. O prompt de comandos padro
um trao (-). Para selecionar um prompt diferente, edite a opo conman prompt
no arquivo localopts e altere o trao. O prompt pode ter at 10 caracteres de
comprimento, sem incluir o sinal de sustenido (#) final requerido.
#---------------------------------------------------------------------------# Atributos de formato customizado
#
date format =
1
# The possible values are 0-ymd, 1-mdy,
2-dmy, 3-NLS.
308
composer prompt =
conman prompt =
%
switch sym prompt =
<n>%
#----------------------------------------------------------------------------
Executando conman
Para configurar o ambiente para utilizar conman, configure as variveis PATH e
TWS_TISDIR executando um dos seguintes scripts:
No UNIX:
v . ./TWS_home/tws_env.sh para shells Bourne e Korn
v . ./TWS_home/tws_env.csh para shells C
No Windows:
v TWS_home\tws_env.cmd
Em seguida, utilize a sintaxe a seguir para executar comandos a partir da interface
com o usurio conman:
conman [connection_parameters] ["command[&[command]...] [&]"]
onde:
Se estiver usando conman a partir do gerenciador de domnio principal, os
parmetros de conexo foram configurados na instalao e no precisam
Se estiver usando conman a partir do cliente da linha de comandos em
comando
possvel chamar a linha de comandos conman no modo em lote e interativo.
Ao executar conman no modo interativo, voc, primeiramente, ativa o programa de
linha de comandos conman e, em seguida, a partir do prompt da linha de
comandos conman, executa comandos um por vez, por exemplo:
conman username admin2 password
ss @+state=hold;deps
dds sked5;needs=2 tapes
admin2pwd
Ao executar conman no modo em lote, voc primeiro ativa o programa de linha de

comandos conman especificando como parmetro de entrada o comando a ser
emitido. Depois de o comando ser processado, o programa de linha de comandos
conman sai, por exemplo
309
conman"sj&sp"
Ao emitir comandos a partir de conman no modo de batch, certifique-se de que

voc coloque os comandos entre aspas duplas. Seguem exemplos de como utilizar
o modo de batch para emitir mais de um comando a partir de conman:
v O conman executa os comandos sj e sp e, em seguida, sai:
conman"sj&sp"
v O conman executa os comandos sj e sp e, em seguida, solicita um comando:

conman "sj&sp&"
v O conman l os comandos a partir do arquivo cfile:

conman < cfile
v Os comandos do arquivo cfile so canalizados para o conman:

cat cfile | conman
Caracteres de Controle
possvel digitar os seguintes caracteres de controle para interromper o conman.
Control+c
O conman pra a execuo do comando atual na prxima etapa que puder
ser interrompida e retorna um prompt de comandos.
Control+d
conman encerrado aps executar o comando atual somente em estaes
de trabalho UNIX.
Executando Comandos do Sistema

Ao inserir um comando do sistema utilizando um canal ou um prefixo de
comando do sistema (: ou !), ele executado por um processo-filho. O ID do
usurio efetivo do processo-filho configurado para o ID do usurio que est
executando conman para evitar as violaes de segurana.
Prompt do Usurio
Quando voc utiliza caracteres curinga para selecionar os objetos sobre os quais a
ao ser executada por um comando, o conman solicita confirmao depois de
localizar cada objeto correspondente. Responder sim permite que a ao seja
tomada e no pula o objeto sem qualquer ao.
Ao executar conman de forma interativa, os prompts de confirmao so emitidos
em seu computador. Pressionar a tecla Return em resposta a um prompt
interpretado como no. As solicitaes atravs de prompt podem ser desativadas,
incluindo-se a opo ;noask em um comando.
Embora nenhum aviso de confirmao seja emitido quando o conman no est
sendo executado no modo interativo, ele age como se a resposta tivesse sido no
em cada caso, e nenhum objeto recebe ao. importante, portanto, incluir a opo
;noask nos comandos quando o conman no for executado no modo interativo.
310
Executando comandos a partir do conman

Os comandos do conman consistem nos seguintes elementos:
commandname selection arguments
onde:
commandname
Especifica o nome do comando.
selection
Especifica o objeto ou conjunto de objetos sobre os quais a ao ser
tomada.
argumentos
Especifica os argumentos do comando.
A seguir, um exemplo de comando do conman:
sj sked1(1100 03/05/2006).@+state=hold~priority=0;info;offline
onde:
sj
A forma abreviada do comando showjobs.
sked1(1100 03/05/2006).@+state=hold~priority=0
Seleciona todas as tarefas do fluxo de tarefas sked1(1100 03/05/2006) que
esto no estado HOLD com uma prioridade diferente de zero.
;info;off-line
Argumentos do comando showjobs.
Curingas
Os seguintes caracteres curinga so permitidos:
@
Substitui um ou mais caracteres alfanumricos.
Substitui um caractere alfanumrico.
Substitui um caractere numrico.
Delimitadores e caracteres especiais

A Tabela 53 lista os caracteres que tm significados especiais em comandos
conman:
Tabela 53. Delimitadores e Caracteres Especiais para conman
Caractere
Descrio
&
Delimitador de comando. Consulte Configurando o Programa de linha de

Comandos conman na pgina 307.
Um delimitador utilizado para selecionar objetos para comandos. Ele adiciona

um atributo que o objeto deve ter. Por exemplo:
sked1(1100 03/05/2006).@~priority=0
Um delimitador utilizado para selecionar objetos para comandos. Ele adiciona

um atributo que o objeto no deve ter. Por exemplo:
sked1(1100 03/05/2006).@~priority=0
311
Tabela 53. Delimitadores e Caracteres Especiais para conman (continuao)

Caractere
Descrio
Delimitador de argumento. Por exemplo:

;info;off-line
Delimitador de repetio e de faixa. Por exemplo:

state=hold,sked,pend
Delimitador de valor. Por exemplo:

state=hold
:!
Prefixos de comandos que transmitem o comando para o sistema. Esses

prefixos so opcionais; se o conman no reconhecer o comando, ele ser
transmitido automaticamente para o sistema. Por exemplo:
!ls ou :ls
Prefixo do comentrio. O prefixo deve ser o primeiro caractere em uma linha

de comandos ou aps um delimitador de comandos. Por exemplo:
*comment
ou
sj& *comment
>
Redireciona a sada de comando para um arquivo e sobrescreve seu contedo.

Se o arquivo no existir, ele ser criado. Por exemplo:
sj> joblist
>>
Redireciona a sada de comando para um arquivo, anexando-a ao final desse

arquivo. Se o arquivo no existir, ele ser criado. Por exemplo:
sj >> joblist

comando do sistema executado independentemente da gerao da sada.
Por exemplo:
sj| grep ABEND
||

comando do sistema no ser executado, se no houver sada. Por exemplo:
sj || grep ABEND
Processamento de comandos do conman

O programa conman executa os comandos que alteram os status dos objetos, como
start ou stop para uma estao de trabalho, e os comandos que modificam objetos
no plano de maneira assncrona. Isso significa que ser possvel observar um
retardo entre o tempo de envio do comando e o tempo que as informaes
armazenadas no arquivo Symphony so atualizadas com o resultado do comando.
Isso ocorre porque o programa conman no atualiza as informaes armazenadas
no arquivo Symphony; o conman submete os comandos ao batchman, que o nico
processo que pode acessar e atualizar as informaes contidas no arquivo
Symphony. Por isso, necessrio aguardar que o batchman processe o pedido de
modificao do objeto emitido pelo conman e, em seguida, atualizar as
informaes sobre o objeto armazenado no arquivo Symphony antes de ver as
informaes atualizadas na sada do comando showobj.
Por exemplo, se voc pedir para excluir uma dependncia utilizando o comando
conman deldep, conman envia o comando deldep postando um evento na caixa
de correio Mailman.msg. O processo mailman obtm as informaes sobre o pedido
312
de excluso de Mailman.msg e as coloca na caixa de correio Intercom.msg na estao

de trabalho que possui o recurso do qual voc exclui a dependncia. Em cada
estao de trabalho, o batchman recebe os eventos em sua caixa postal
Intercom.msg e os processa na mesma ordem em que foram recebidos. Se
batchman estiver ocupado por qualquer motivo, os eventos que transportam
pedidos para executar os comandos conman continuam a ser enfileirados no
arquivo Intercom.msg aguardando para serem lidos e processados pelo batchman.
Alm disso, quando o batchman processa o evento, o operador no notificado.
Como resultado, uma dependncia poderia ter sido excluda, embora parecesse que
no, porque o batchman estava muito ocupado para executar a operao solicitada
imediatamente. Se voc executar o comando novamente, a excluso j poder ter
sido bem-sucedida, apesar da exibio de uma mensagem informando que o
comando foi encaminhado com xito para o batchman no prompt do conman.
Selecionando Tarefas em Comandos

Para comandos que operam em tarefas, os jobs de destino selecionados por
intermdio de atributos e qualificadores. A sintaxe de seleo do job mostrada
abaixo e descrita nas pginas a seguir.
Sintaxe
[workstation#] {jobstreamname(hhmm[ date]) job | jobnumber} [{+ | ~}jobqualifier[...]]
ou
[workstation#]jobstream_id.job [{+ | ~]jobqualifier[...]];schedid
ou:
netagent::[workstation#] {jobstream(hhmm[date]).job | jobstream_id.job;schedid}
Argumentos
estao de trabalho
Quando utilizado com jobstream.job, especifica o nome da estao de
trabalho na qual o fluxo de job executado. Quando utilizado com
jobnumber, especifica a estao de trabalho na qual o job executado.
Exceto quando tambm utilizar schedid, caracteres curingas so
permitidos. Esse argumento pode ser necessrio dependendo da estao de
trabalho onde o comando ativado, da seguinte forma:
v Se voc ativar o comando na estao de trabalho onde as tarefas de
destino foram executadas, o argumento workstation opcional.
v Se voc ativar o comando em uma estao de trabalho hospedada, o
argumento workstation obrigatrio. Estaes de trabalho hospedadas
so:
agentes estendidos
agentes dinmicos
conjuntos
conjuntos dinmicos
313
jobstreamname
Especifica o nome do fluxo de tarefas no qual a tarefa executada.
(hhmm [date])
Indica a hora e a data que a instncia do fluxo de tarefas localizada no
plano de pr-produo. O valor hhmm corresponde ao valor designado
palavra-chave schedtime na definio do fluxo de tarefas se nenhuma
restrio de tempo at tiver sido configurada. Aps a instncia do fluxo de
tarefas ter iniciado o processamento, o valor de hhmm [date] configurado
para a hora de incio do fluxo de tarefas. A utilizao de curingas nesse
campo no permitida. Ao emitir comandos conman seqenciais a partir
do prompt de shell, coloque o comando conman entre aspas duplas ". Por
exemplo, execute esse comando da seguinte forma:
conman "sj my_workstation#my_js(2101 02/23).@"
jobstream_id
Especifica o identificador do fluxo de tarefa exclusivo. Consulte
Argumentos na pgina 322 para obter informaes adicionais sobre
identificadores de fluxo de tarefas.
schedid Indica que o identificador do fluxo de tarefa utilizado na seleo do fluxo
de tarefa.
jobname
Especifica o nome do job. Caracteres curinga so permitidos.
jobnumber
Especifica o nmero do job.
jobqualifier
Consulte a seo a seguir .
netagent
Especifica o nome do agente de rede do Tivoli Workload Scheduler que faz
a interface com a rede remota do Tivoli Workload Scheduler que contm a
tarefa de destino. Os dois-pontos (::) so requeridos como delimitador.
Caracteres curinga so permitidos. Para obter informaes adicionais,
consulte Captulo 15, Gerenciando Dependncias de Interligao de
Redes, na pgina 557.
Nota: O Tivoli Workload Scheduler ajuda a identificar a instncia correta do fluxo
de tarefas quando a seleo de fluxo de tarefas fornece um resultado
ambguo se mais de uma instncia atender seus critrios de seleo. Por
exemplo, quando mais de uma instncia de WK1#J1 includa no plano de
produo e, portanto, a seleo do fluxo de tarefas fornece um resultado
ambguo, o prompt a seguir gerado automaticamente para permitir que
voc escolha a instncia correta:
Process WK1#J1[(0600 03/04/06),(0AAAAAAAAAAAABTB)]
(enter "y" for yes, "n" for no)?y
Command forwarded to batchman for WK1#J1[(0600 03/04/06),(0AAAAAAAAAAAABTB)]
Process WK1#J1[(1010 03/04/06),(0AAAAAAAAAAAABTC)]
(enter "y" for yes, "n" for no)?n
Na sada, somente a instncia do fluxo de tarefas planejada em (0600

03/04/06) e com o identificador 0AAAAAAAAAAAABTB selecionada para
executar o comando.
314
Qualificadores de Job
Os qualificadores de job especificam os atributos de jobs nos quais os comandos
atuaro. Eles podem ter como prefixo + ou ~. Se um qualificador de job for
precedido por +, os jobs contendo esse atributo especfico sero selecionados para
execuo do comando. Se um qualificador de job for precedido por ~, os jobs
contendo esse atributo especfico sero excludos da execuo do comando.
As palavras-chave do qualificador de job podem ser abreviadas com o mnimo de
caracteres iniciais, o necessrio para distingui-las exclusivamente umas das outras.
at[=time | lowtime, | ,hightime | lowtime,hightime ]
Seleciona ou exclui tarefas com base na hora especificada na dependncia
at.
time
Especifica a hora da seguinte forma:
hhmm[+n days | date] [timezone|tz tzname]
onde:
hhmm
A hora e minuto.
+n dias
A prxima ocorrncia de hhmm em n nmero de dias.
date
A prxima ocorrncia de hhmm em date, expressa como

mm/dd[/yy].
timezone|tz tzname
O nome do fuso horrio do job. Consulte Captulo 13,
Gerenciando fusos horrios, na pgina 523 para obter
nomes vlidos.
time obedece as seguintes regras:
v Quando hhmm anterior hora atual, a hora de incio amanh;
quando hhmm posterior hora atual, a hora de incio hoje.
v Quando hhmm maior que 2400, ele dividido por 2400. Do
resultado, a parte total representa o nmero de + dias e a parte
decimal representa a hora.
lowtime
Especifica o limite inferior de um intervalo de tempo, expresso no
mesmo formato de time. So selecionadas tarefas que esto
planejadas para iniciar aps essa hora.
hightime
Especifica o limite superior de um intervalo de tempo, expresso no
mesmo formato de time. So selecionadas tarefas que esto
planejadas para iniciar antes dessa hora.
Se at for utilizado sozinho e for precedido por +, ento, as tarefas
selecionadas so aquelas que contm uma dependncia at.
Se at for utilizado sozinho e for precedido por ~, ento, as tarefas
selecionadas so aquelas que no contm uma dependncia at.
confirmed
Seleciona ou exclui tarefas que foram planejadas utilizando-se a
palavra-chave confirm.
315
critical
Seleciona ou exclui tarefas que foram sinalizadas com a palavra-chave
critical em uma definio de fluxo de tarefas.
critnet Seleciona ou exclui tarefas que so sinalizadas como critical ou so
predecessoras de tarefas crticas. Portanto, aplica-se a todas as tarefas que
tm um horrio de incio crtico configurado.
O horrio de incio crtico de uma tarefa crtica calculado subtraindo sua
durao estimada do respectivo prazo final. O horrio de incio crtico de
um predecessor calculado subtraindo sua durao estimada do horrio
de incio crtico de seu sucessor. Em uma rede crtica, os horrios de incio
crticos so calculados comeando pela tarefa crtica e trabalhando de
modo retroativo ao longo da linha dos respectivos predecessores.
deadline[=time | lowtime, | ,hightime | lowtime,hightime]
Especifica o tempo no qual um job deve ser concludo.
hhmm
A hora e minuto.
+n dias
Um deslocamento em dias da hora do prazo final planejada.
date
A prxima ocorrncia de hhmm em date, expressa como mm/dd[/yy].
timezone|tz tzname
Especifica o fuso horrio a ser utilizado ao calcular o prazo final.
Consulte Captulo 13, Gerenciando fusos horrios, na pgina 523
para obter nomes de fuso horrios. O padro o fuso horrio da
estao de trabalho em que a tarefa ou fluxo de tarefas lanado.
lowtime
mesmo formato de time. As tarefas selecionadas tm um prazo final
planejado no anterior a essa hora.
hightime
mesmo formato de time. As tarefas selecionadas tm um prazo final
planejado no posterior a essa hora.
every[=rate | lowrate, | ,highrate | lowrate,highrate]
Seleciona ou exclui jobs se tiverem ou no uma taxa de repetio.
rate
Especifica a taxa de execuo planejada, expressa como horas e

minutos (hhmm).
lowrate Especifica o limite inferior de uma faixa de taxas, expressa no

mesmo formato de rate. So selecionados jobs que tm taxas de
repetio iguais ou maiores que essa taxa.
highrate
Especifica o limite superior de uma faixa de taxas, expressa no
mesmo formato de rate. So selecionados jobs que tm taxas de
repetio menores ou iguais a essa taxa.
Se every for utilizado sozinho e estiver precedido por +, os jobs
selecionados sero aqueles que contm qualquer taxa de repetio.
Se every for utilizado sozinho e estiver precedido por ~, os jobs
selecionados sero aqueles que no contm nenhuma taxa de repetio.
316
finished[=time | lowtime, | ,hightime | lowtime,hightime]

Seleciona ou exclui jobs se tiverem terminado ou no.
time
Especifica a hora exata em que o job terminou, expressa como a

seguir:
hhmm [date] [timezone|tz tzname]
hhmm
A hora e minuto.
date
A prxima ocorrncia de hhmm na data, expressa como

mm/dd[/yy].
timezone|tz tzname
nomes vlidos.
lowtime
mesmo formato de time. So selecionados jobs que terminaram
nesta hora ou aps ela.
hightime
mesmo formato de time. So selecionados jobs que terminaram
nesta hora ou antes dela.
Se finished for utilizado sozinho e estiver precedido por +, os jobs
selecionados sero aqueles cuja execuo terminou.
Se finished for utilizado sozinho e estiver precedido por ~, os jobs
selecionados sero aqueles cuja execuo no terminou.
follows=[netagent::][workstation#]{jobstreamname(hhmm [mm/dd[/yy]])[.job | @] |
jobstream_id.job;schedid}| job[;nocheck][,...]
Seleciona ou exclui as tarefas se tiverem ou no uma dependncia follows.
netagent
Especifica o nome do agente de rede do Tivoli Workload Scheduler
que faz a interface com a rede remota do Tivoli Workload
Scheduler que contm a tarefa pr-requisita. Caracteres curinga so
permitidos. Para obter informaes adicionais, consulte Captulo 15,
Gerenciando Dependncias de Interligao de Redes, na pgina
557.
estao de trabalho
Especifica o nome da estao de trabalho na qual o job de
pr-requisito executado. Caracteres curinga so permitidos.
jobstreamname
Especifica o nome do fluxo de tarefas no qual a tarefa de
pr-requisito executada. Caracteres curinga so permitidos. Se
voc digitar jobstreamname.@, voc especifica que a tarefa de
destino segue todas as tarefas do fluxo de tarefa.
jobname
Especifica o nome do job de pr-requisito. Quando digitado sem
um jobstreamname, significa que a tarefa de pr-requisito est no
mesmo fluxo de tarefa que a tarefa de destino. No especifique o
nome do job utilizando caracteres curinga para uma dependncia
follows.
317
jobstream_id
Argumentos na pgina 322 para obter informaes adicionais
sobre identificadores de fluxo de tarefas.
schedid
Essa palavra-chave, se presente, aplica-se a todos os identificadores
de fluxos de tarefas especificados na clusula e indica que, para
todos os fluxos de tarefas especificados, voc est utilizando os
jobstream_ids, no os jobstreamnames. Se quiser selecionar alguns
fluxos de tarefas utilizando o jobstream_id e alguns fluxos de tarefas
utilizando o jobstreamname, voc dever utilizar duas clusulas
follows diferentes, uma contendo os fluxos de tarefas identificados
pelas palavras-chave jobstreamname sem as palavras-chave schedid
e a outra contendo os fluxos de tarefas identificados pelo
jobstream_id com a palavra-chave schedid.
nocheck
vlido somente para comandos de envio e utilizado em conjunto
com a palavra-chave schedid. A palavra-chave nocheck indica que
conman no precisa verificar a existncia da tarefa pr-requisito
jobstream_id.job no arquivo Symphony. Supe-se que jobstream_id.job
exista. Caso no exista, batchman imprimir uma mensagem de
aviso em stdlist.
Se follows for utilizado sozinho e estiver precedido por +, os jobs sero
selecionados se contiverem dependncias follows.
Se follows for utilizado sozinho e estiver precedido por ~, os jobs sero
selecionados se no contiverem dependncias follows.
logon=username
Seleciona jobs com base nos nomes de usurio sob os quais so executados.
Se username contiver caracteres especiais, ele dever ser colocado entre
aspas ("). Caracteres curinga so permitidos.
needs[=[workstation#]resourcename]
Seleciona ou exclui jobs se tiverem ou no uma dependncia de recurso.
estao de trabalho
Especifica o nome da estao de trabalho na qual o recurso foi
definido. Caracteres curinga so permitidos.
resourcename
Especifica o nome do recurso. Caracteres curinga so permitidos.
Se needs for utilizado sozinho e estiver precedido por +, os jobs sero
selecionados se contiverem dependncias resource.
Se needs for utilizado sozinho e estiver precedido por ~, os jobs sero
selecionados se no contiverem dependncias resource.
opens[=[workstation#]filename[(qualifier)]]
Seleciona jobs se tiverem ou no uma dependncia file. Uma dependncia
file ocorre quando um job ou fluxo de job depende da existncia de um
ou mais arquivos para poder comear a execuo.
estao de trabalho
Especifica o nome da estao de trabalho na qual o arquivo existe.
318
nome do arquivo
Especifica o nome do arquivo. O nome dever ser colocado entre
aspas (") se contiver caracteres especiais diferentes do seguinte:
alfanumricos, traos (-), barras (/), barras invertidas (\) e
sublinhados (_). Caracteres curinga so permitidos.
qualifier
Uma condio de teste vlida. Se omitido, os jobs sero
selecionados ou excludos independente de um qualificador.
Se opens for utilizado sozinho e estiver precedido por +, os jobs sero
selecionados se contiverem dependncias file.
Se opens for utilizado sozinho e estiver precedido por ~, os jobs sero
selecionados se no contiverem dependncias file.
priority=pri | lowpri, | ,highpri | lowpri,highpri
Seleciona ou exclui jobs com base em suas prioridades.
pri
Especifica o valor de prioridade. possvel digitar de 0 a 99, hi ou

go.
lowpri Especifica o limite inferior de uma faixa de prioridades. Os jobs

so selecionados com prioridades iguais ou maiores que esse valor.
highpri Especifica o limite superior de uma faixa de prioridades. Os jobs
so selecionados com prioridades menores ou iguais a esse valor.
prompt[=promptname | msgnum]
Seleciona ou exclui jobs se tiverem ou no uma dependncia prompt.
promptname
Especifica o nome de um prompt global. Caracteres curinga so
permitidos.
msgnum
Especifica o nmero de mensagem de um prompt local.
Se prompt for utilizado sozinho e estiver precedido por +, os jobs sero
selecionados se contiverem dependncias prompt.
Se prompt for utilizado sozinho e estiver precedido por ~, os jobs sero
selecionados se no contiverem dependncias prompt.
recovery=recv-option
Seleciona ou exclui jobs com base em suas opes de recuperao.
recv-option
Especifica a opo de recuperao do job como parar, continuar ou
reexecutar.
scriptname=filename
Seleciona ou exclui jobs com base nos nomes de seus arquivos executveis.
nome do arquivo
Especifica o nome de um arquivo executvel. O nome dever ser
colocado entre aspas (") se contiver caracteres especiais diferentes
do seguinte: alfanumricos, traos (-), barras (/), barras invertidas
(\) e sublinhados (_). Caracteres curinga so permitidos.
started[=time | lowtime, | ,hightime | lowtime,hightime]
Seleciona ou exclui jobs se tiverem ou no sido iniciados.
time
Especifica a hora exata em que o job foi iniciado, expressa como a

seguir:
319

hhmm
A hora e minuto.
date

mm/dd[/aa].
timezone|tz tzname
nomes vlidos.
lowtime
mesmo formato de time. So selecionadas apenas as tarefas que
iniciaram nesta hora ou aps ela.
hightime
mesmo formato de time. So selecionadas apenas as tarefas que
iniciaram nesta hora ou antes dela.
Se started for usado sozinho e for precedido por +, ento apenas as tarefas
que comearam a ser executadas nessa hora sero selecionadas.
Se started for usado sozinho e for precedido por ~, ento apenas as tarefas
que comearam a executar nesse hora ou aps ela e que continuam em
execuo sero selecionadas.
state=state[,...]
Seleciona ou exclui jobs com base em seus estados.
state
Especifica o estado atual do job. Os estados de job vlidos so os

seguintes:
ABEND
O job terminou com um cdigo de sada diferente de zero.
ABENP
Uma confirmao abend foi recebida, mas o job no est
concludo.
ADD
A tarefa est sendo submetida.
DONE
O job foi concludo em um estado desconhecido.
ERROR
Para dependncias entre redes apenas, ocorreu um erro
durante a verificao do status remoto.
EXEC A tarefa est em execuo. O sinalizador + ao lado do
status EXEC significa que a tarefa gerenciada pelo
processo do batchman local.
EXTRN
Somente para dependncias de interligao de redes, o
status desconhecido. Ocorreu um erro, uma ao
reexecutar acabou de ser realizada na tarefa do fluxo de
tarefas EXTERNAL ou a tarefa ou o fluxo de tarefas remoto
no existe.
FAIL
320
Impossvel lanar a tarefa.
FENCE
O valor de prioridade do job est abaixo da cerca.
HOLD
A tarefa est aguardando a resoluo da dependncia.
INTRO
O job apresentado para ser lanado pelo sistema. O
sinalizador + ao lado do status INTRO significa que a
tarefa gerenciada pelo processo do batchman local.
PEND A tarefa foi concluda e est aguardando confirmao.
READY
A tarefa est pronta para ser lanada e todas as
dependncias foram resolvidas.
SCHED
A hora at da tarefa no chegou.
SUCC A tarefa foi concluda com um cdigo de sada zero.
SUCCP
Uma confirmao succ foi recebida, mas o job no est
concludo.
WAIT A tarefa est no estado WAIT (somente para o agente
estendido).
until[=time | lowtime, | ,hightime | lowtime,hightime ]
Seleciona ou exclui jobs com base em sua hora de trmino planejada.
time
Especifica a hora de trmino planejada, expressa como a seguir:

hhmm
A hora e minuto.
+n dias
date

mm/dd[/yy].
timezone|tz tzname
nomes vlidos.
lowtime
mesmo formato de time. So selecionados jobs que planejaram as
horas de trmino nesta hora ou aps ela.
hightime
mesmo formato de time. So selecionados jobs que planejaram as
horas de trmino nesta hora ou antes dela.
Se until for utilizado sozinho e for precedido por +, ento, as tarefas so
selecionadas se tiverem uma hora until especificada.
Se until for utilizado sozinho e for precedido por ~, ento, as tarefas so
selecionadas se no tiverem uma hora until especificada.
321
Selecionando Fluxos de Tarefas em Comandos

Para comandos que operam em fluxos de job, os fluxos de job de destino so
selecionados pela especificao de atributos e qualificadores.
Como scheddateandtime especificado em minutos, a combinao do horrio
jobstreamname e do scheddateandtime pode no ser exclusiva. Por essa razo, o
jobstream_id foi disponibilizado ao usurio, para finalidades de exibio ou para
executar aes contra uma instncia especfica de um fluxo de tarefas.
A sintaxe de seleo do fluxo de tarefas mostrada abaixo e descrita nas pginas a
seguir. possvel escolher uma das duas sintaxes descritas.
Sintaxe
[workstation#]jobstreamname(hhmm[ date]) [{+ | ~}jobstreamqualifier[...]]
[workstation#]jobstream_id ;schedid
Argumentos
estao de trabalho
Especifica o nome da estao de trabalho na qual o fluxo de job
executado. Exceto quando tambm utilizar schedid, caracteres curingas so
permitidos.
jobstreamname
Especifica o nome do fluxo de tarefas. Caracteres curinga so permitidos.
(hhmm [date])
Indica a hora e a data que a instncia do fluxo de tarefas localizada no
plano de pr-produo. Esse valor corresponde ao valor designado
palavra-chave schedtime na definio do fluxo de tarefas se nenhuma
restrio de tempo at tiver sido configurada. Aps a instncia do fluxo de
tarefas ter iniciado o processamento, o valor de hhmm [date] configurado
para a hora de incio do fluxo de tarefas. A utilizao de curingas nesse
campo no permitida. Ao emitir comandos conman em seqncia a partir
do prompt de shell, coloque o comando conman entre aspas duplas " ".
Por exemplo, execute esse comando da seguinte forma:
conman "ss my_workstation#my_js(2101 02/23)"
jobstreamqualifier
Consulte Qualificadores do Fluxo de Job abaixo.
jobstream_id
Especifica o identificador do fluxo de tarefa alfanumrico exclusivo gerado
automaticamente pelo planejador e designado para o fluxo de tarefa.
utilizado principalmente por processos internos para identificar essa
instncia do fluxo de tarefas no plano de produo, mas pode
freqentemente ser utilizado tambm ao gerenciar o fluxo de tarefas a
partir do programa de linha de comandos conman especificando a opo
;schedid.
schedid
Indica que o identificador do fluxo de tarefa utilizado na seleo do fluxo
de tarefa.
322
Nota: O Tivoli Workload Scheduler ajuda a identificar a instncia correta do fluxo

de tarefas quando a seleo de fluxo de tarefas fornece um resultado
ambguo se mais de uma instncia atender seus critrios de seleo. Por
exemplo, quando mais de uma instncia de WK1#J1 includa no plano de
produo e, portanto, a seleo do fluxo de tarefas fornece um resultado
ambguo, o prompt a seguir gerado automaticamente para permitir que
voc escolha a instncia correta:
Process WK1#J1[(0600 03/04/06),(0AAAAAAAAAAAABTB)]
(enter "y" for yes, "n" for no)?y
Command forwarded to batchman for WK1#J1[(0600 03/04/06),(0AAAAAAAAAAAABTB)]
Process WK1#J1[(1010 03/04/06),(0AAAAAAAAAAAABTC)]
(enter "y" for yes, "n" for no)?n
Na sada, somente a instncia do fluxo de tarefas planejada em (0600

03/04/06) e com o identificador 0AAAAAAAAAAAABTB selecionada para
executar o comando.
Qualificadores de Fluxo de Tarefas

at[=time | lowtime, | ,hightime | lowtime,hightime ]
Seleciona ou exclui fluxos de job com base na hora de incio planejada.
time
Especifica a hora de incio planejada, expressa como a seguir:

hhmm
A hora e minuto.
+n dias
date

mm/dd[/yy].
timezone|tz tzname
O nome do fuso horrio do fluxo de job. Consulte
Captulo 13, Gerenciando fusos horrios, na pgina 523
para obter nomes vlidos.
lowtime
mesmo formato de time. So selecionados fluxos de job que
planejaram horas de incio nesta hora ou aps ela.
hightime
planejaram horas de incio nesta hora ou antes dela.
Se at for utilizado sozinho e for precedido por +, ento, os fluxos de tarefa
selecionados so aqueles que contm uma dependncia at.
Se at for utilizado sozinho e for precedido por ~, ento, os fluxos de tarefa
selecionados so aqueles que no contm uma dependncia at.
carriedforward
Seleciona os fluxos de job que foram transportados se precedidos por +,
exclui os fluxos de job que foram transportados se precedidos por ~.
carryforward
Se precedidos por +, seleciona os fluxos de job que foram planejados
323
utilizando a palavra-chave carryforward; se precedidos por ~, exclui os

fluxos de job que foram planejados utilizando a palavra-chave
carryforward.
finished[=time | lowtime, | ,hightime | lowtime,hightime]
Seleciona ou exclui fluxos de job se tiverem terminado ou no.
time
Especifica a hora exata em que os fluxos de job terminaram,

expressa como a seguir:
hhmm
A hora e minuto.
date

mm/dd[/aa].
timezone|tz tzname
lowtime
terminaram nessa hora ou aps ela.
hightime
terminaram nessa hora ou antes dela.
Se finished for utilizado sozinho e estiver precedido por +, os fluxos de
job selecionados sero os jobs cuja execuo terminou.
Se finished for utilizado sozinho e estiver precedido por ~, os fluxos de
job selecionados sero os jobs cuja execuo no terminou.
follows=[netagent::][workstation#]{jobstreamname(hhmm [mm/dd[/yy]])[.job | @] |
jobstream_id.job;schedid}| job[;nocheck] [,...]
Seleciona ou exclui fluxos de tarefas se tiverem ou no uma dependncia
follows.
netagent
Especifica o nome do agente de rede que faz a interface com a rede
remota do Tivoli Workload Scheduler que contm a tarefa ou o
fluxo de tarefas pr-requisito. Caracteres curinga so permitidos.
Para obter informaes adicionais sobre agentes de rede, consulte
Captulo 15, Gerenciando Dependncias de Interligao de Redes,
na pgina 557.
estao de trabalho
Especifica o nome da estao de trabalho na qual o job ou fluxo de
job de pr-requisito executado. Caracteres curinga so permitidos.
jobstreamname
Especifica o nome do fluxo de tarefas de pr-requisito. Caracteres
jobname
Especifica o nome do job de pr-requisito. Caracteres curinga so
permitidos.
324
jobstream_id
Argumentos na pgina 322 para obter informaes adicionais
sobre identificadores de fluxo de tarefas.
schedid
Essa palavra-chave, se presente, aplica-se a todos os identificadores
de fluxos de tarefas especificados na clusula e indica que, para
todos os fluxos de tarefas especificados, voc est utilizando os
jobstream_ids, no os jobstreamnames. Se quiser selecionar alguns
fluxos de tarefas utilizando o jobstream_id e alguns fluxos de tarefas
utilizando o jobstreamname, voc dever utilizar duas clusulas
follows diferentes, uma contendo os fluxos de tarefas identificados
pelas palavras-chave jobstreamname sem as palavras-chave schedid
e a outra contendo os fluxos de tarefas identificados pelo
jobstream_id com a palavra-chave schedid.
nocheck
vlido somente para comandos de envio e utilizado em conjunto
com a palavra-chave schedid. A palavra-chave nocheck indica que
conman no precisa verificar a existncia da tarefa pr-requisito
jobstream_id.job no arquivo Symphony. Supe-se que jobstream_id.job
exista. Caso no exista, batchman imprimir uma mensagem de
aviso em stdlist.
Se follows for utilizado sozinho e estiver precedido por +, os fluxos de job
sero selecionados se contiverem dependncias follows.
Se follows for utilizado sozinho e estiver precedido por ~, os fluxos de job
sero selecionados se no contiverem dependncias follows.
limit[=limit | lowlimit, | ,highlimit | lowlimit,highlimit]
Seleciona ou exclui fluxos de job se tiverem ou no um limite de job.
limite
Especifica o valor exato do limite de job.
lowlimit
Especifica o limite inferior de faixa. So selecionados fluxos de job
que possuem limites de job iguais ou maiores que esse limite.
highlimit
Especifica o limite superior de uma faixa. So selecionados fluxos
de job que possuem limites de job menores ou iguais a esse limite.
Se limit for utilizado sozinho e estiver precedido por +, os fluxos de job
sero selecionados se tiverem qualquer limite de job.
Se limit for utilizado sozinho e estiver precedido por ~, os fluxos de job
sero selecionados se no tiverem nenhum limite de job.
needs[=[workstation#]resourcename]
Seleciona ou exclui fluxos de job se tiverem ou no uma dependncia de
recurso.
estao de trabalho
Especifica o nome da estao de trabalho na qual o recurso foi
definido. Caracteres curinga so permitidos.
resourcename
Se needs for utilizado sozinho e estiver precedido por +, os fluxos de job
sero selecionados se contiverem dependncias resource.
325
Se needs for utilizado sozinho e estiver precedido por ~, os fluxos de job

sero selecionados se no contiverem dependncias resource.
opens[=[workstation#]filename[(qualifier)]]
arquivo. Uma dependncia file ocorre quando um job ou fluxo de job
depende da existncia de um ou mais arquivos para poder comear a
execuo.
estao de trabalho
Especifica o nome da estao de trabalho na qual o arquivo existe.
nome do arquivo
Especifica o nome do arquivo. O nome dever ser colocado entre
aspas (") se contiver caracteres especiais diferentes do seguinte:
alfanumricos, traos (-), barras (/), barras invertidas (\) e
qualifier
Uma condio de teste vlida. Se omitido, os fluxos de job sero
selecionados ou excludos independente de um qualificador.
Se opens for utilizado sozinho e estiver precedido por +, os fluxos de job
sero selecionados se contiverem dependncias file.
Se opens for utilizado sozinho e estiver precedido por ~, os fluxos de job
sero selecionados se no contiverem dependncias file.
priority=pri | lowpri, | ,highpri | lowpri,highpri
Seleciona ou exclui fluxos de job com base em suas prioridades.
pri
Especifica o valor de prioridade. possvel digitar de 0 a 99, hi ou

go.
lowpri Especifica o limite inferior de uma faixa de prioridades. Os fluxos

de job so selecionados com prioridades iguais ou maiores que
esse valor.
highpri Especifica o limite superior de uma faixa de prioridades. Os fluxos
de job so selecionados com prioridades menores ou iguais a esse
valor.
prompt[=promptname | msgnum]
prompt.
promptname
permitidos.
msgnum
Especifica o nmero de mensagem de um prompt local.
Se prompt for utilizado sozinho e estiver precedido por +, os fluxos de job
sero selecionados se contiverem dependncias prompt.
Se prompt for utilizado sozinho e estiver precedido por ~, os fluxos de job
sero selecionados se no contiverem dependncias prompt.
started[=time | lowtime, | ,hightime | lowtime,hightime]
Seleciona ou exclui fluxos de job se tiverem ou no sido iniciados.
326
time
Especifica a hora exata em que o fluxo de job foi iniciado, expressa

como a seguir:
hhmm
A hora e minuto.
date

mm/dd[/aa].
timezone|tz tzname
lowtime
iniciaram nessa hora ou aps ela.
hightime
iniciaram nessa hora ou antes dela.
Se started for utilizado sozinho e estiver precedido por +, os fluxos de job
selecionados sero os jobs cuja execuo foi iniciada.
Se started for utilizado sozinho e estiver precedido por ~, os fluxos de job
selecionados sero os jobs cuja execuo no foi iniciada.
state=state[,...]
Seleciona ou exclui fluxos de job com base em seus estados.
state
Especifica o estado atual do fluxo de job. Os estados vlidos dos

fluxos de job so os seguintes:
ABEND
O fluxo de job terminou de forma anormal.
ADD
O fluxo de tarefas acaba de ser enviado.
EXEC O fluxo de tarefas est em execuo.

HOLD
O fluxo de tarefa est aguardando a resoluo de
dependncias.
READY
O fluxo de job est pronto para ser ativado e todas as
STUCK
A execuo foi interrompida. Nenhum job ser lanado
sem a interveno do operador.
SUCC O fluxo de job foi concludo com xito.
until[=time | lowtime, | ,hightime | lowtime,hightime ]
Seleciona ou exclui fluxos de job com base no horrio de encerramento
planejado.
time
Especifica a hora de trmino planejada, expressa como a seguir:

327
hhmm
A hora e minuto.
+n dias
date

mm/dd[/yy].
timezone|tz tzname
lowtime
planejaram horas de trmino nessa hora ou aps ela.
hightime
planejaram horas de trmino nessa hora ou antes dela.
Se until for utilizado sozinho e estiver precedido por +, os fluxos de job
selecionados sero aqueles que contm o horrio de encerramento
planejado.
Se until for utilizado sozinho e estiver precedido por ~, os fluxos de job
selecionados sero aqueles que no contm o horrio de encerramento
planejado.
Gerenciando Tarefas e Fluxos de Tarefas a partir de Agentes de Nvel

Anterior
A alterao na conveno de nomenclatura da instncia do fluxo de tarefas
introduzida com o Tivoli Workload Scheduler verso 8.3 requer que voc aplique a
seguinte soluo alternativa ao emitir comandos da linha de comandos em um
plano gerado em um gerenciador de domnio principal do Tivoli Workload
Scheduler verso 8.3 (ou posterior) a partir dos agentes do Tivoli Workload
Scheduler verso 8.1, 8.2 ou 8.2.1:
v Voc deve utilizar o smbolo @ como o primeiro caractere para o identificador da
instncia do fluxo de tarefas. Por exemplo, o fluxo de tarefas em execuo na
estao de trabalho CPU1 com o identificador 0AAAAAAAAAAAAY3 deve ser
identificado na linha de comandos conman conforme a seguir:
CPU1#@AAAAAAAAAAAAY3
v Voc no pode utilizar a palavra-chave follows ao incluir uma dependncia em

uma tarefa ou em um fluxo de tarefas ou ao enviar como uma tarefa um
comando ou um arquivo.
v Voc no pode utilizar a palavra-chave into para especificar o fluxo de tarefa no
qual a tarefa deve ser includa ao enviar como uma tarefa um comando ou um
arquivo.
Por exemplo, para exibir as informaes sobre a tarefa job2 contida na instncia do
fluxo de tarefas com o identificador 0AAAAAAAAAAAAT1 em execuo na estao de
trabalho CPU1, execute o seguinte comando nos agentes do Tivoli Workload
Scheduler verso 8.1, 8.2 ou 8.2.1:
sj CPU1#@AAAAAAAAAAAAT1.job2
328
Estas alteraes tambm sero vistas nos relatrios e logs e em qualquer outro
local no qual os nomes do fluxo de tarefas forem impressos ou exibidos.
Conman commands
A Tabela 54 lista os comandos conman. Os nomes e as palavras-chave dos
comandos podem ser digitados em caracteres maisculos ou minsculos e podem
ser abreviados com o mnimo de caracteres iniciais, o necessrio para distingui-los
exclusivamente uns dos outros. Alguns dos nomes dos comandos tambm tm
formas curtas especficas.
Nota: Os tipos de estaes de trabalho na tabela a seguir tem estes significados:
v M - gerenciadores de domnios principais e principais de backup
v F - gerenciadores de domnios e agentes tolerantes a falhas
v T - para agentes tolerantes a falha
v S - agentes padro ( possvel exibir arquivos somente em um agente
padro)
s
Tabela 54. Lista de Comandos do Conman
Comando
adddep { job | sched
}
Forma
Abreviada
adj | ads
altpass
Descrio
Tipo
Pgina
Adiciona dependncias de job

ou fluxo de job.
adddep job na pgina 332

adddep sched na pgina 333
Altera a senha de uma definio F

de objeto do usurio.
altpass na pgina 335
altpri
ap
Altera prioridades de job ou

fluxo de job.
altpri na pgina 336
bulk_discovery
bulk
Desempenha uma descoberta

em massa. Para utilizar com o
IBM Tivoli Monitoring 6.1
(Tivoli Enterprise Portal).
bulk_discovery na pgina 337
cancel { job | sched }
cj | cs
Cancela um job ou fluxo de job.
cancel job na pgina 337

cancel sched na pgina 339
checkhealthstatus
chs
Chama o servio chkhltst para

verificar se a caixa de correio
pode ser lida com sucesso por
mailman ou se h erros no
cabealho da caixa de correio.
MFS
checkhealthstatus na pgina 341
confirmar
conf
Confirma concluso do job.
confirm na pgina 341
console
cons
Atribui o console do Tivoli

Workload Scheduler.
FS
console na pgina 342
continue
cont
Ignora o prximo erro.
FS
continue na pgina 343
deldep { job | sched } ddj | dds
Elimina dependncias de job ou

fluxo de job.
deldep job na pgina 344

deldep sched na pgina 345
deployconf
Obtm a configurao de
monitoramento mais recente
para o mecanismo de
monitoramento de eventos na
estao de trabalho.
FS
deployconf na pgina 346
deploy
329
Tabela 54. Lista de Comandos do Conman (continuao)
|
|
|
|
Comando
Forma
Abreviada
display { file | job |

sched }
df | dj | ds Exibe arquivos, jobs e fluxos de

job.
exit
fence
Tipo
Pgina
FS
display na pgina 347
Sai do conman.
FS
exit na pgina 350
Define o limitador de job do

fence na pgina 350
help(1)
Exibe informaes sobre o

comando.
FS
help na pgina 351
kill
Pra um job em execuo.
kill na pgina 352
limit { cpu | sched }
lc | ls
Altera o limite de job de uma

estao de trabalho ou fluxo de
job.
limit cpu na pgina 353

limit sched na pgina 355
link
lk
Abre links da estao de

trabalho.
FS
link na pgina 355
listsym
lis
Exibe uma lista de arquivos de

log do Symphony.
listsym na pgina 358
recall
rc
Exibe mensagens de prompt.
recall na pgina 360
redo
red
Edita o comando anterior.
FS
redo na pgina 361
release { job | sched } rj | rs
Libera dependncias de job ou

de fluxo de job.
release job na pgina 362

release sched na pgina 363
reply
rep
Responde mensagens de
prompts.
reply na pgina 365
rerun
rr
Reexecuta um job.
rerun na pgina 366
resetFTA
N/D
Recupera ujm arquivo

Symphony corrompido no
agente tolerante a falhas
especificado
resetFTA na pgina 369
resource
res
Altera o nmero de unidades de F

recurso.
resource na pgina 370
setsym
set
Seleciona um arquivo de log do

Symphony.
setsym na pgina 371
showcpus
sc
Exibe informaes de links e de

estao de trabalho.
FS
showcpus na pgina 371
showdomain
showd
Exibe informaes sobre o

domnio.
FS
showdomain na pgina 378
showfiles
sf
Exibe informaes sobre

arquivos.
showfiles na pgina 379
showjobs
sj
Exibe informaes sobre tarefas.
showjobs na pgina 382
showprompts
sp

prompts.
showprompts na pgina 397
showresources
sr

recursos.
showresources na pgina 400
showschedules
ss
Exibe informaes sobre fluxos

de tarefas.
showschedules na pgina 402
shutdown
shut
Pra os processos de produo

FS
shutdown na pgina 407
330
Descrio
Tabela 54. Lista de Comandos do Conman (continuao)

Comando
Forma
Abreviada
Descrio
Tipo
Pgina
start
Inicia os processos de produo

FS
start na pgina 408
startappserver
Inicia o processo integrado do

WebSphere Application Server
FS
startappserver na pgina 410
starteventprocessor
startevtp
Inicia o servidor de
processamento de eventos.
M(2)
starteventprocessor na pgina 411
startmon
startm
Inicia o processo monman que

ativa o mecanismo de
monitoramento de eventos no
agente.
FS
startmon na pgina 412
status
stat
Exibe o status de produo do

FS
status na pgina 413
parar

FS
stop na pgina 413
stop ;progressive

do Tivoli Workload Scheduler
hierarquicamente.
stop ;progressive na pgina 415
stopappserver
stopapps
Pra o processo integrado do

FS
stopappserver na pgina 416
stopeventprocessor
stopevtp
Pra o servidor de
M(2)
stopeventprocessor na pgina 418
stopmon
stopm
Pra o mecanismo de
monitoramento de eventos no
agente.
FS
stopmon na pgina 419
Submete um comando, arquivo,

job ou fluxo de job.
FS(3)
submit
submit
submit
submit
submit { docommand
| file | job | sched }
sbd |
sbf |
sbj |
sbs
docommand na pgina 419

file na pgina 423
job na pgina 426
sched na pgina 429
switchevtp
Comuta o servidor de
processamento de eventos de
gerenciadores de domnio
principal para principais de
backup ou vice-versa.
switcheventprocessor na pgina
433
switchmgr
switchm
Alterna o gerenciador de
domnio.
switchmgr na pgina 434
Envia um comando ao sistema.
FS
system command na pgina 435
Envia uma mensagem ao

console.
FS
tellop na pgina 436
Fecha links da estao de

trabalho.
FS
unlink na pgina 437
Exibe o banner d programa de

linha de comandos de conman.
FS
version na pgina 439
system-command
tellop
to
unlink
verso
1. No disponvel no sistema operacional Windows suportado.

2. Inclui estaes de trabalho instaladas como principais de backup mas utilizadas
como agente tolerante a falhass comuns.
331
3. possvel utilizar submit job (sbj) e submit sched (sbs) em um agente padro,
utilizando os parmetros de conexo ou especificando as configuraes no
arquivo useropts ao chamar a linha de comandos conman.
Nota: Nos comandos, os termos sched e schedule referem-se a fluxos de job e o termo
CPU refere-se a estaes de trabalho.
adddep job
Adiciona dependncias a um job.
Voc deve ter acesso adddep ao job. Para incluir dependncias needs e prompt, voc
deve ter acesso use aos recursos e prompts globais.
Sintaxe
{adddep job | adj} jobselect
[;dependency[;...]]
[;noask]
Argumentos
jobselect
Consulte Selecionando Tarefas em Comandos na pgina 313.
dependncia
O tipo de dependncia. Especifique uma das seguintes. Caracteres curinga
no so permitidos.
at=hhmm[timezone | tz tzname][+n days | mm/dd[/yy]] | [absolute | abs]
confirmed
deadline=time [timezone|tz tzname][+n day[s | mm/dd[/yy]]
every=rate
follows=[netagent::][workstation#]{jobstreamname[hhmm [mm/dd[/yy]]][.job |
@] | jobstream_id.job;schedid}| job[,...]
needs=[num] [workstation#]resource[,...]
opens=[workstation#]"filename"[(qualifier)][,...] priority[=pri | hi | go]
prompt="[: | !]text" | promptname[,...]
until time [timezone|tz tzname][+n day[s]] | [absolute | abs] [;onuntil
action]
noask Especifica para no solicitar confirmao antes da tomada de ao em cada
job qualificado.
Nota:
1. Se voc incluir uma dependncia duas vezes em um fluxo de tarefa para
uma tarefa, ambas as dependncias sero tratadas.
2. Ao usar a palavra-chave prazo final, certifique-se de que a opo bm
check deadline esteja configurada para um valor maior que 0 no arquivo
de configurao localopts na estao de trabalho em que voc estiver
trabalhando. possvel definir a opo bm check deadline em cada
estao de trabalho na qual voc deseja estar ciente sobre a expirao do
prazo final, ou, se voc desejar obter informaes atualizadas sobre o
|
|
|
|
|
|
332
ambiente todo, defina a opo no gerenciador de domnio principal.

Prazos finais para tarefas crticas so avaliadas automaticamente,
independentemente da opo bm check deadline. Para obter mais
informaes sobre a opo bm check deadline, consulte Detalhes das
Opes Locais.
|
|
|
|
|
Comentrios
Se voc no especificar um valor para priority, o job reverter para sua
prioridade planejada original. Se voc no especificar uma estao de trabalho em
follows, needs ou opens, o padro ser a estao de trabalho na qual o job
executado.
No possvel utilizar esse comando para incluir resource ou prompt como
dependncia, a no ser que j estejam referenciadas por uma tarefa ou um fluxo de
tarefas no arquivo Symphony.
Exemplos
Para incluir uma dependncia de recurso na tarefa job3 no fluxo de tarefas
sked9(0900 02/19/06), execute o seguinte comando:
adj sked9(0900 02/19/06).job3 ; needs=2 tapes
Para incluir uma dependncia follows externa a partir da tarefa JOB022 no fluxo de
tarefas MLN#SCHED_02(0600 02/24) em JOBA no fluxo de tarefas MLN#NEW_TEST(0900
02/19/06), execute o seguinte comando:
adj MLN#NEW_TEST(0900 02/19/06).JOBA ; follows MLN#SCHED_02(0600 02/24/06).JOB022
Para incluir uma dependncia de arquivo e uma hora until na tarefa j6 no fluxo
de tarefas JS2(0900 02/19/06), execute o seguinte comando:
adj WK1#JS2(0900 02/19/06).j6 ; opens="/usr/lib/prdata/file5"(-s %p) ; until=2330
Consulte tambm
1. Clique em Tivoli Workload SchedulerCarga de TrabalhoMonitorTarefas do
Monitor
2. Selecione Todas as Tarefas no Plano ou outro nome de tarefa predefinido
3. Escolha um nome de mecanismo ou especifique as propriedades da conexo e
clique em OK
4. Selecione uma tarefa e clique na guia Dependncias....
adddep sched
Adiciona dependncias a um fluxo de job.
Voc deve ter acesso adddep ao fluxo de job. Para incluir dependncias needs e
prompt, voc deve ter acesso use aos recursos e prompts globais.
Sintaxe
{adddep sched | ads} jstreamselect
[;dependency[;...]]
[;noask]
333
Argumentos
jstreamselect
Consulte Selecionando Fluxos de Tarefas em Comandos na pgina 322.
dependncia
O tipo de dependncia. Especifique uma das seguintes. Caracteres curinga
no so permitidos.
at=hhmm[timezone | tz tzname][+n days | mm/dd[/yy]] | [absolute | abs]
carryforward
deadline=time [timezone|tz tzname][+n day[s | mm/dd[/yy]]
limit=limit
opens=[workstation#]"filename"[(qualifier)][,...] priority[=pri | hi | go]
until time [timezone|tz tzname][+n day[s] | [absolute | abs]] [;onuntil
action]
fluxo de job qualificado.
Nota:
1. Se voc incluir duas vezes uma dependncia em um fluxo de tarefas
para outro fluxo de tarefas, somente uma dependncia ser considerada.
2. Ao usar a palavra-chave prazo final, certifique-se de que a opo bm
check deadline esteja configurada para um valor maior que 0 no arquivo
de configurao localopts na estao de trabalho em que voc estiver
trabalhando. possvel definir a opo bm check deadline em cada
estao de trabalho na qual voc deseja estar ciente sobre a expirao do
prazo final, ou, se voc desejar obter informaes atualizadas sobre o
ambiente todo, defina a opo no gerenciador de domnio principal.
Prazos finais para tarefas crticas so avaliadas automaticamente,
independentemente da opo bm check deadline. Para obter mais
informaes sobre a opo bm check deadline, consulte Detalhes das
Opes Locais.
|
|
|
|
|
|
|
|
|
|
|
Comentrios
v Se voc no especificar um valor para priority, o fluxo de job reverter para
sua prioridade planejada original.
v Se voc no especificar um valor para limit, o valor assumir o padro de 0.
v Se voc no especificar uma estao de trabalho em follows, needs ou opens, o
padro ser a estao de trabalho na qual o fluxo de job executado.
v No possvel utilizar esse comando para incluir um resource ou um prompt
como dependncias, a menos que j existam no plano de produo. Para ver
qual recurso e prompts existem no plano, consulte showresources na pgina
400 e showprompts na pgina 397.
334
Exemplos
Para incluir uma dependncia de prompt no fluxo de tarefas sked9(0900
ads sked9(0900 02/19/06) ; prompt=msg103
Para incluir uma dependncia follows externa a partir da tarefa JOBB no fluxo de
tarefas CPUA#SCHED_02(0600 02/24/06) e um limite de tarefa no fluxo de tarefas
CPUA#TEST(0900 02/19/06), execute o seguinte comando:
ads CPUA#TEST(0900 02/19/06) ; follows CPUA#SCHED_02(0600 02/24/06).JOBB; limit=2
Consulte tambm
1. Clique em Tivoli Workload SchedulerCarga de TrabalhoMonitorFluxos de
Tarefa do Monitor
2. Selecione Todos os Fluxos de Tarefa no Plano ou outro nome de tarefa
predefinido
clique em OK
4. Selecione um fluxo de tarefa e clique na guia Dependncias....
altpass
Altera a senha de um objeto de usurio no plano de produo atual.
Voc deve ter acesso altpass ao objeto do usurio.
Sintaxe
altpass
[workstation#]
username
[;"password"]
Argumentos
estao de trabalho
Especifica a estao de trabalho na qual o usurio est definido. Utilize
maisculas para esse campo mesmo que tenha utilizado maisculas e
minsculas ao especificar workstation na definio do usurio do Windows.
Para obter informaes adicionais, consulte definio de usurio do
Windows na pgina 182. No especifique este campo se o usurio
pertencer a um domnio do Windows gerenciado pelo diretrio ativo. O
padro a estao de trabalho na qual o conmanest sendo executado.
username
Especifica o nome de um usurio. Utilize maisculas para esse campo
mesmo que tenha utilizado maisculas e minsculas ao especificar
[domain\]username na definio do usurio do Windows. Para obter
informaes adicionais, consulte definio de usurio do Windows na
pgina 182.
335
password
Especifica a nova senha. Ela deve ser colocada entre aspas duplas. Para
indicar ausncia de senha para o usurio, utilize duas aspas duplas
consecutivas ("").
Comentrios
Se voc no especificar uma senha, o conman solicitar uma e uma confirmao. A
senha no ser exibida durante a digitao e no dever ser colocada entre aspas.
Observe que a alterao feita somente no plano de produo atual, sendo, desse
modo, temporria. Para fazer uma mudana permanente, consulte definio de
usurio do Windows na pgina 182.
Exemplos
Para alterar a senha do usurio Jim na estao de trabalho mis5 para mynewpw,
altpass MIS5#JIM;mynewpw
Para alterar a senha do usurio jim na estao de trabalho Mis5 para mynewpw sem
exibir a senha, execute o seguinte comando:
altpass MIS5#JIM
password: xxxxxxxx
confirm: xxxxxxxx
Para alterar a senha do usurio Jim, definida em um domnio do Windows

gerenciador por diretrio ativo denominado twsDom, para mynewpw, execute o
seguinte comando:
altpass TWSDOM\JIM;mynewpw
altpri
Altera a prioridade de um job ou fluxo de job.
Voc deve ter acesso altpri ao job ou fluxo de job.
Sintaxe
{altpri | ap} jobselect | jstreamselect
[;pri]
[;noask]
Argumentos
jobselect
jstreamselect
pri
Especifica o nvel de prioridade. possvel digitar um valor de 0 a 99, hi

ou go.

job ou fluxo de job qualificado.
336
Exemplos
Para alterar a prioridade da tarefa balance no fluxo de tarefas glmonth(0900
ap glmonth(0900 02/19/06).balance;55
Para alterar a prioridade do fluxo de tarefas glmonth(0900 02/19/06), execute o

seguinte comando:
ap glmonth(0900 02/19/06);10
Consulte tambm
1. Clique em Tivoli Workload SchedulerCarga de TrabalhoMonitor
2. Selecione Tarefas do Monitor ou Fluxos de Tarefas do Monitor
3. Para tarefas, selecione Todas as Tarefas no Plano ou outro nome de tarefa
predefinido; para fluxos de tarefa, selecione Todos os Fluxos de Tarefa no
Plano ou outro nome de tarefa predefinido
clique em OK
5. Selecione uma tarefa ou um fluxo de tarefas e clique em Mais
AesPrioridade.
bulk_discovery
Solicita uma descoberta em massa para atualizar o status atual dos objetos
monitorados. Ele utilizado para a integrao com o IBM Tivoli Monitoring 6.1
(Tivoli Enterprise Portal).
Voc deve ter o acesso display para o objeto do arquivo.
Sintaxe
{bulk_discovery | bulk}
Comentrios
Quando a integrao com o IBM Tivoli Monitoring 6.1 est ativada, o comando
bulk_discovery verifica o status de todas as tarefas monitoradas e fluxos de tarefas
no plano e grava os eventos correspondentes no arquivo do log de eventos.
Por padro, os eventos so gravados no arquivo event.log.
As mensagens que indicam o incio e o encerramento da atividade de descoberta
em massa so registradas no arquivo twsmerge.log.
cancel job
Cancela um job.
Voc deve ter acesso cancel ao job.
337
Sintaxe
{cancel job | cj} jobselect
[;pend]
[;noask]
Argumentos
jobselect
pend
Cancela o job somente aps a resoluo de suas dependncias.

job qualificado.
Comentrios
Se voc cancelar um job antes de ser ativado, ele no ser ativado. Se voc cancelar
um job depois de ser ativado, sua execuo continuar. Se voc cancelar um job
que estiver em execuo e ele for concludo no estado ABEND, no sero tentadas
etapas automticas de recuperao do job.
Se voc no utilizar a opo ;pend, os jobs e fluxos de job dependentes do job
cancelado sero liberados imediatamente da dependncia.
Se voc incluir a opo ;pend e o job no tiver sido lanado, o cancelamento ser
deferido at que todas as dependncias, incluindo uma hora at, sejam resolvidas.
Depois de todas as dependncias terem sido resolvidas, o job ser cancelado e
todos os jobs ou fluxos de job dependentes do job cancelado sero liberados da
dependncia. Durante o perodo em que o cancelamento deferido, a notao
[Cancel Pend] listada na coluna Dependncias do job em uma tela showjobs.
Se voc incluir a opo ;pend e o job j tiver sido lanado, a opo ser ignorada e
todos os jobs ou fluxos de job dependentes do job cancelado sero liberados
imediatamente da dependncia.
possvel utilizar o comando rerun para executar novamente os jobs que foram
cancelados ou que estiverem marcados com [Cancel Pend]. Tambm pode
adicionar e excluir dependncias de jobs que estiverem marcados com [Cancel
Pend].
Para cancelar imediatamente um job marcado com [Cancel Pend], possvel
digitar um comando release para o job ou digitar outro comando cancel sem a
opo ;pend.
Para jobs com horas until expiradas, a notao [Until] listada na coluna
Dependncias em uma tela showjobs e suas dependncias no so mais avaliadas.
Se esse job tambm estiver marcado com [Cancel Pend], ele no ser cancelado at
que voc libere ou exclua a hora until, ou digite outro comando cancel sem a
opo ;pend.
Para parar de avaliar as dependncias, defina a prioridade de um job como zero
com o comando altpri. Para continuar a avali-las, defina a prioridade com um
valor maior que zero.
338
Nota: No caso de dependncias entre redes, cancelar uma tarefa no fluxo de

tarefas EXTERNAL liberar todas as tarefas e fluxos de tarefas locais da
dependncia. As tarefas do fluxo de tarefas EXTERNAL representam tarefas e
fluxos de tarefas que foram especificados como dependncias entre redes. O
status de uma dependncia entre redes no verificado aps um comando
cancel ser executado. Para obter informaes adicionais, consulte
Gerenciando Dependncias de Interligao de Redes no Plano na pgina
562.
Exemplos
Para cancelar a tarefa report no fluxo de tarefas apwkly(0900 02/19/06) na estao
de trabalho site3, execute o seguinte comando:
cj site3#apwkly(0900 02/19/06).report
Para cancelar a tarefa setup no fluxo de tarefas mis5(1100 02/10/06), se no

estiver no estado ABEND, execute o seguinte comando:
cj mis5(1100 02/10/06).setup~state=abend
Para cancelar a tarefa job3 no fluxo de tarefas sked3(0900 02/19/03) somente aps
a resoluo de suas dependncias, execute o seguinte comando:
cj sked3(0900 02/19/06).job3;pend
Consulte tambm
Monitor
clique em OK
4. Selecione uma tarefa e clique em Mais AesCancelar.
cancel sched
Cancela um fluxo de job.
Voc deve ter acesso cancel ao fluxo de job.
Sintaxe
{cancel sched | cs} jstreamselect
[;pend]
[;noask]
Argumentos
jstreamselect
pend
Cancela o fluxo de job somente aps a resoluo de suas dependncias.

339
Comentrios
Se voc cancelar um fluxo de job antes de ele ser ativado, ele no ser ativado. Se
voc cancelar um fluxo de job depois de ele ser ativado, os jobs iniciados sero
concludos, mas nenhum outro ser ativado.
Se voc no utilizar a opo ;pend, os jobs e fluxos de job dependentes do fluxo de
job cancelado sero liberados imediatamente da dependncia.
Se voc utilizar a opo ;pend e o fluxo de job no tiver sido lanado, o
cancelamento ser deferido at que todas suas dependncias, incluindo uma hora
at, sejam resolvidas. Depois de todas as dependncias terem sido resolvidas, o
fluxo de job ser cancelado e todos os jobs ou fluxos de job dependentes sero
liberados da dependncia. Durante o perodo em que cancel deferido, a notao
[Cancel Pend] listada na coluna Dependncias de uma tela showschedules.
Se voc incluir a opo ;pend e o fluxo de job j tiver sido lanado, os jobs
restantes do fluxo de job sero cancelados e todos os jobs e fluxos de job
dependentes sero liberados da dependncia.
Para cancelar imediatamente um fluxo de job marcado com [Cancel Pend], digite
um comando release para o fluxo de job ou digite outro comando cancel sem a
opo ;pend.
Para parar a avaliao das dependncias, configure a prioridade do fluxo de job
como zero com o comando altpri. Para continuar a avali-las, defina a prioridade
com um valor maior que zero.
Se o fluxo de tarefas cancelado contiver as tarefas definidas com a opo every,
apenas a ltima instncia dessas tarefas ser listada como cancelada em uma
exibio showjobs.
Exemplos
Para cancelar o fluxo de tarefas sked1(1200 02/17/06) na estao de trabalho
site2, execute o seguinte comando:
cs site2#sked1(1200 02/17)
Para cancelar o fluxo de tarefas mis2 (0900 02/19/06) se estiver no estado STUCK,
cs mis2(0900 02/19)+state=stuck
Consulte tambm
Tarefa do Monitor
predefinido
clique em OK
4. Selecione um fluxo de tarefa e clique em Mais AesCancelar.
340
checkhealthstatus
Chame o servio chkhltst para verificar a conectividade entre o gerenciador de
domnio e as estaes de trabalho. Verifica se o arquivo Symphony no est
corrompido, se os arquivos da caixa de correio podem ser lidos com sucesso pelo
mailman, sem erros no cabealho do caixa de correio, e se a caixa de correio no
est cheia. Esse comando pode ser til para diagnosticar a razo para uma estao
de trabalho desconectada e para obter sugestes sobre como recuperar o problema.
Sintaxe
{checkhealthstatus | chs} [workstation]
Comentrios
Se workstation no for especificado, o servio ativado localmente.
Exemplos
Para verificar o status de funcionamento da estao de trabalho site1, ative o
comando a seguir:
checkhealthstatus site1
confirm
Confirma a concluso de um job que foi planejado com a palavra-chave confirmed.
Voc deve ter acesso confirm ao job.
Sintaxe
{confirm | conf} jobselect
;{succ | abend}
[;noask]
Argumentos
jobselect
succ
Confirma que o job terminou com xito.
abend
Confirma que o job terminou sem xito.
job qualificado.
Comentrios
Alterar o estado de um job de ABEND para SUCC no requer que a palavra-chave
confirmed seja utilizada para planejar o job. Para obter informaes adicionais
sobre confirmao da tarefa, consulte confirmed na pgina 201. Para obter
informaes adicionais sobre tarefas EXTERNAL, consulte Gerenciando
Dependncias de Interligao de Redes no Plano na pgina 562.
Tabela 55 na pgina 342 mostra o efeito do comando confirm nos vrios estados de
tarefas:
341
Tabela 55. Alterao de Estado depois do Comando confirm

Estado Inicial do Job
Estado aps confirm ;succ
Estado aps confirm ;abend
READY
nenhum efeito
nenhum efeito
HOLD
nenhum efeito
nenhum efeito
EXEC
SUCCP
ABENP
ABENP
SUCCP
nenhum efeito
SUCCP
nenhum efeito
nenhum efeito
PEND
SUCC
ABEND
DONE
SUCC
ABEND
SUCC
nenhum efeito
nenhum efeito
ABEND
SUCC
nenhum efeito
FAIL
nenhum efeito
nenhum efeito
SCHED
nenhum efeito
nenhum efeito
ERROR (somente para

tarefas sombra)
SUCC
ABEND
qualquer tarefa no fluxo de

tarefas EXTERNAL
SUCC
ABEND
Exemplos
Para emitir uma confirmao succ para a tarefa job3 no fluxo de tarefas
misdly(1200 02/17/06), execute o seguinte comando:
confirm misdly(1200 02/17/06).job3;succ
Para emitir uma confirmao abend para o job nmero 234, execute o seguinte
comando:
confirm 234;abend
console
Designa o console do Tivoli Workload Scheduler e configura o nvel de mensagem.
Voc deve ter acesso console estao de trabalho.
Sintaxe
{console | cons}
[sess | sys]
[;level=msglevel]
Argumentos
342
sess
Envia mensagens e prompts do console do Tivoli Workload Scheduler para

sada padro.
sys
Pra de enviar mensagens e prompts do console do Tivoli Workload

Scheduler para sada padro. Isso ocorre automaticamente quando voc sai
do conman.
msglevel
O nvel das mensagens do Tivoli Workload Scheduler que so enviadas ao
console. Especifique um dos seguintes nveis:
|
|
|
|
|
-1
Este o valor que o produto automaticamente designa se voc

modificar qualquer dos argumentos para o console e nenhum valor
for redesignado a msglevel. Com esse valor, o produto envia todas
as mensagens geradas por todos os agentes e para todas as
operaes ao console.
Sem mensagens. Esse o padro em agente tolerante a falhas.
Mensagens de exceo, tais como prompts do operador e abends

de job.
Nvel 1, mais as mensagens de xito do fluxo de job.
Nvel 2, mais as mensagens de xito do job. Esse o padro no

gerenciador de domnio principal.
Nvel 3, mais as mensagens de jobs lanados.
Comentrios
Se voc digitar um comando console sem opes, o estado atual do console ser
exibido.
Por padro, os processos de controle do Tivoli Workload Scheduler gravam
mensagens e prompts do console em arquivos de lista padro. No UNIX, voc
tambm pode envi-los para o daemon syslog.
Exemplos
Para comear a gravar mensagens e avisos do console na sada padro e alterar o
nvel de mensagem para 1, execute o seguinte comando:
console sess;level=1
Para parar a gravao de mensagens do console e prompts na sada padro e

alterar o nvel de mensagem para 4, execute o seguinte comando:
cons sys;l=4
Para exibir o estado atual do console, execute o seguinte comando:

cons
Console is #J675, level 2, session
675 o ID de processo da shell do usurio.
continue
Ignora o prximo erro de comando.
Sintaxe
{continue | cont}
Comentrios
Esse comando til quando os comandos so digitados de forma no interativa.
Ele orienta o conman a continuar a execuo de comandos, mesmo que o prximo
343
comando, depois de continue, resulte em erro.
Exemplos
Para que o conman continue com o comando rerun mesmo que o comando cancel
falhe, execute o seguinte comando:
conman "cont&cancel=176&rerun job=sked5(1200 02/17/06).job3"
deldep job
Exclui dependncias de um job.
Voc deve ter acesso deldep ao job.
Sintaxe
{deldep job | ddj} jobselect
;dependency[;...]
[;noask]
Argumentos
jobselect
dependncia
O tipo de dependncia. Especifique pelo menos uma das seguintes.
possvel utilizar caracteres curingas em workstation, jstream, job, resource,
filename e promptname.
at[=time | lowtime | hightime | lowtime,hightime]
confirmed
deadline[=time[timezone | tz tzname][+n days | mm/dd[/yy]]]
every
follows=[netagent::][workstation#]{jobstreamname(hhmm [mm/dd[/yy]]) [.job |
needs[=[num] [workstation#]resource[,...]]
opens[=[workstation#]"filename"[(qualifier)][,...]]
priority
prompt[="[: | !]text" | promptname[,...]]
until[=time [timezone|tz tzname][+n day[s]] [;onuntil action]]
job qualificado.
Comentrios
Se voc excluir priority, o job reverter para sua prioridade planejada original. Ao
excluir uma dependncia opens, possvel incluir apenas o nome de arquivo base
e o conman executar uma procura sem distino de maisculas/minsculas para
correspondncia de arquivos, ignorando os nomes de diretrios. As dependncias
de todos os arquivos correspondentes so excludas.
344
As dependncias excludas no esto mais em efeito na execuo do comando

rerun.
Para excluir todas as dependncias follows das tarefas contidas em um fluxo de
tarefa especfico, especifique a palavra-chave follows como:
follows=job_stream_name
No utilize um curinga neste caso (tal como follows=job_stream_name.@ porque o

comando ser rejeitado.
Exemplos
Para excluir uma dependncia de recurso da tarefa job3 no fluxo de tarefas
sked9(0900 02/19/06), execute o seguinte comando:
ddj sked9(0900 02/19/06).job3 ; needs=2 tapes
Para excluir todas as dependncias follows externas do fluxo de tarefas

CPUA#TEST(0900 02/19/06), execute o seguinte comando:
ddj CPUA#TEST(0900 02/19/06).JOBA ; follows
Consulte tambm
Monitor
clique em OK
4. Selecione uma tarefa e clique na guia Dependncias....
deldep sched
Exclui dependncias de um fluxo de job.
Voc deve ter acesso deldep ao fluxo de job.
Sintaxe
{deldep sched | dds} jstreamselect
;dependency[;...]
[;noask]
Argumentos
jstreamselect
dependncia
O tipo de dependncia. Especifique pelo menos uma das seguintes.
possvel utilizar caracteres curinga em workstation, jstreamname, jobname,
resource, filename e promptname.
carryforward
345
limite
priority
Comentrios
Se voc excluir priority, o job reverter para sua prioridade planejada original. Ao
excluir uma dependncia opens, possvel incluir apenas o nome de arquivo base
e o conman executar uma procura sem distino de maisculas/minsculas para
correspondncia de arquivos, ignorando os nomes de diretrios. As dependncias
de todos os arquivos correspondentes so excludas.
As dependncias excludas no esto mais em efeito na execuo do comando
rerun.
Exemplos
Para excluir uma dependncia resource do fluxo de tarefas sked5(0900 02/19/06),
dds sked5(0900 02/19/06);needs=2 tapes
Para excluir todas as dependncias follows do fluxo de tarefas sked3(1000

dds sked3(1000 04/19/06);follows
Consulte tambm
Tarefa do Monitor
predefinido
clique em OK
4. Selecione um fluxo de tarefa e clique na guia Dependncias....
deployconf
Obtm a configurao de monitoramento mais recente para o mecanismo de
monitoramento de eventos na estao de trabalho.
Sintaxe
{deployconf | deploy} [domain!]workstation
346
Argumentos
domnio
Especifica o nome do domnio de destino para a operao. Caracteres
Este argumento til ao implementar mais de uma estao de trabalho em
um domnio. Por exemplo, para implementar a configurao de
monitoramento mais recente para todos os agentes no domnio AURORABU,
utilize o seguinte comando:
deploy
AURORABU!@
O domnio no necessrio se voc no incluir caracteres curingas em

workstation .
Se voc no incluir domain e incluir caracteres curinga em workstation , o
domnio padro ser aquele no qual o conman est sendo executado.
estao de trabalho
Especifica o nome da estao de trabalho na qual o mecanismo de
monitoramento executado. Caracteres curinga no so permitidos.
Comentrios
Se a configurao existente j estiver atualizada, o comando no ter efeito.
A permisso para aes start nos objetos cpu deve ser ativada no arquivo de
segurana para executar este comando.
display
Exibe um arquivo de job ou uma definio de fluxo de job.
Se voc especificar um arquivo pelo nome, dever ter acesso read ao arquivo. Para
arquivos de job e definies de fluxo de job, voc deve ter acesso display ao job ou
fluxo de job.
Sintaxe
{display file | df} filename [;offline]
{display job | dj} jobselect [;offline]
{display sched | ds} jstreamselect
[valid {at date | in date date}
[;offline]
Argumentos
nome do arquivo
Especifica o nome do arquivo, geralmente, um arquivo de script de job. O
nome dever ser colocado entre aspas (") se contiver caracteres diferentes
dos seguintes: alfanumricos, traos (-), barras (/), barras invertidas (\) e
sublinhados (_). Caracteres curinga so permitidos. O arquivo deve ser
acessvel da estao de trabalho de logon. Utilize essa opo se quiser
mostrar somente o contedo do arquivo de script da tarefa.
347
jobselect
O job cujo arquivo de job exibido. Consulte Selecionando Tarefas em
Comandos na pgina 313. O arquivo de job deve ser acessvel da estao
de trabalho de logon. Essa palavra-chave aplica-se somente ao caminho e
ao nome de arquivo do arquivo de script de tarefas definidas com a opo
scriptname.
jstreamselect
O fluxo de job cuja definio exibida. Consulte Selecionando Fluxos de
Tarefas em Comandos na pgina 322.
valid
Especifica o dia ou o intervalo de dias durante os quais as instncias do

fluxo de tarefa a serem exibidas devem estar ativas. Isso significa que o
intervalo de validade dessas instncias do fluxo de tarefa deve conter o
espao de tempo especificado no argumento valid. O formato utilizado
para date depende do valor designado para a varivel date format
especificada no arquivo localopts. Se no for especificado, a instncia
selecionada a nica vlida hoje.
off-line
Envia a sada do comando para o dispositivo de sada do conman. Para
obter informaes sobre esse dispositivo, consulte Sada Off-line na
pgina 308.
Exemplos
Para exibir o arquivo c:\maestro\jclfiles\arjob3, execute o seguinte comando:
df c:\apps\maestro\jclfiles\arjob3
Para exibir o arquivo de script para o tarefa createpostreports no fluxo de tarefas

final off-line, execute o seguinte comando:
dj FINAL(0559 03/06/06).CREATEPOSTREPORTS
Esta uma amostra de sada desse comando:

M235062_99#FINAL(0559 03/06/06).CREATEPOSTREPORTS /home/tws83/CreatePostReports
#!/bin/sh
####################################################################
# Materiais Licenciados - Propriedade da IBM
# ?Materiais Restritos da IBM?
# 5698-WSH
# (C) Direitos Autorais da IBM Corp. 1998, 2006 Todos os Direitos Reservados.
# Direitos Restritos para Usurios do Governo dos Estados Unidos - Uso, duplicao e
# divulgao restritos pelo GSA ADP Schedule Contract com a IBM Corp.
###################################################################
#@(#) $Id: CreatePostReports.sh,v 1.0
##
## Definies do catlogo de mensagens CreatePostReports.
##
##
## ID do conjunto de mensagens
##
MAE_CREATEPOSTREPORTS_SET=226
MAE_COPYRIGHT_SET=234
##
....
...
348
....
#
# Fim
#
Para exibir a definio de fluxo de tarefas para o fluxo de tarefas mod, execute o
seguinte comando:
ds mod
Esta uma amostra de sada desse comando:

Job Stream Name
Workstation
Valid From Updated On Locked By
---------------- ---------------- ---------- ---------- ---------------MOD
M235062_99
06/30/2007 03/04/2006 SCHEDULE M235062_99#MOD VALIDFROM 06/30/2007
ON RUNCYCLE SCHED1_PREDSIMPLE VALIDFROM 07/18/2007
"FREQ=DAILY;INTERVAL=1"
( AT 1111 )
CARRYFORWARD
FOLLOWS M235062_99#SCHED_FIRST1.@
FOLLOWS M235062_99#SCHED_FIRST.JOB_FTA
PRIORITY 66
:
M235062_99#JOBMDM
SCRIPTNAME "/usr/acct/scripts/gl1" STREAMLOGON root
DESCRIPTION "general ledger job1"
TASKTYPE UNIX
RECOVERY STOP
PRIORITY 30
PROMPT PRMT3
B236153_00#JOB_FTA
FOLLOWS M235062_99#SCHED_FIRST1.@
FOLLOWS M235062_99#SCHED_FIRST.JOB_FTA
PRIORITY 66
:
M235062_99#JOBMDM
SCRIPTNAME "/usr/acct/scripts/gl1" STREAMLOGON root
TASKTYPE UNIX
RECOVERY STOP
PRIORITY 30
PROMPT PRMT3
B236153_00#JOB_FTA
DOCOMMAND "echo pippo" STREAMLOGON root
TASKTYPE UNIX
RECOVERY STOP
FOLLOWS JOBMDM
END
Consulte tambm
2. Selecione um nome de mecanismo e clique em OK
3. No painel Abertura Rpida da janela pop-up resultante, clique no boto
Definio de Tarefa ou Fluxo de Tarefa
349
4. Insira o nome da tarefa ou o nome do fluxo de tarefas ou utilize filtros para

localiz-lo
5. Clique em Visualizar.
exit
Sai do programa de linha de comandos do conman.
Sintaxe
{exit | e}
Comentrios
Quando voc est no modo de ajuda no UNIX, esse comando retorna o conman
para o modo de entrada de comandos.
Exemplos
Para sair do programa de linha de comandos conman, execute o seguinte
comando:
exit
ou
e
fence
Altera o limitador de job em uma estao de trabalho. Os jobs no sero lanados
na estao de trabalho se suas prioridades forem menores ou iguais ao limitador
de job.
Voc deve ter acesso fence estao de trabalho.
Sintaxe
{fence | f} workstation
;pri
[;noask]
Argumentos
estao de trabalho
Especifica o nome da estao de trabalho. O padro sua estao de
trabalho de logon.
pri
Especifica o nvel de prioridade. possvel digitar de 0 a 99, hi, go ou

system. Digitar system define o limitador de job como zero.

estao de trabalho qualificada.
Comentrios
O limitador de job evita o lanamento de jobs de baixa prioridade, independente
das prioridades de seus fluxos de job. possvel, portanto, manter jobs de baixa
350
prioridade em alta prioridade, enquanto se permite que jobs de alta prioridade em

fluxos de job de baixa prioridade sejam lanados.
Quando voc inicia o Tivoli Workload Scheduler pela primeira vez aps a
instalao, o limitador de job definido como zero. Ao alterar a fence da tarefa,
transportado durante o processamento de pr-produo no plano de produo do
prximo dia.
Para exibir a definio atual do limitador de job, utilize o comando status.
Exemplos
Para alterar a cerca de job na estao de trabalho site4, execute o seguinte
comando:
fence site4;20
Para alterar a cerca de job na estao de trabalho na qual o conman est sendo
executado, execute o seguinte comando:
f ;40
Para impedir que todas as tarefas sejam ativadas pelo Tivoli Workload Scheduler
na estao de trabalho tx3, execute o seguinte comando:
f tx3;go
Para alterar a cerca de job para zero na estao de trabalho na qual o conman est
sendo executado, execute o seguinte comando:
f ;system
Consulte tambm
PlanejamentoMonitorEstaes de Trabalho do Monitor
2. Selecione Todas as Estaes de Trabalho no Plano ou um outro nome de tarefa
predefinido
clique em OK
4. Selecione uma estao de trabalho e clique em Mais AesFence....
help
Exibe informaes de auxlio sobre comandos. No disponvel no Windows.
Sintaxe
Argumentos
comando
Especifica o nome de um comando do conman ou do sistema. Para
comandos do conman, digite o nome completo do comando, pois
abreviaes e formas simplificadas no so suportadas. Para comandos que
consistem em duas palavras, digite a primeira palavra e ser exibida ajuda
351
para todas as verses do comando. Por exemplo, digitar help display exibe
informaes sobre os comandos display file, display job e display sched.
keyword
Voc tambm pode digitar as seguintes palavras-chave:
COMMANDS
Lista todos os comandos do conman.
SETUPCONMAN
Descreve como configurar para usar o conman.
RUNCONMAN
Como executar conman.
SPECIALCHAR
Descreve curingas, delimitadores e outros caracteres especiais que
possvel usar.
JOBSELECT
Lista informaes sobre a seleo de jobs para comandos.
JOBSTATES
Lista informaes sobre os estados do job.
JSSELECT
Lista informaes sobre a seleo de fluxos de job para comandos.
JSSTATES
Lista informaes sobre os estados do fluxo de job.
MANAGEBACKLEVEL
Gerenciando tarefas e fluxos de tarefas a partir de agentes de nvel
anterior.
Exemplos
Para exibir uma lista de todos os comandos do conman, execute o seguinte
comando:
help commands
Para exibir informaes sobre o comando fence, execute o seguinte comando:

help fence
Para exibir informaes sobre os comandos altpri job e altpri sched, execute o
seguinte comando:
h altpri
Para exibir informaes sobre caracteres especiais que possvel usar, execute o
comando a seguir:
h specialchar
kill
Pra um job que est em execuo. No UNIX, isso realizado com um comando
UNIX kill. Voc deve ter acesso kill ao job.
352
Sintaxe
{kill | k} jobselect
[;noask]
Argumentos
jobselect
job qualificado.
Comentrios
A operao kill no executada pelo conman e sim por um processo de produo
do Tivoli Worload Scheduler, portanto, pode haver um pequeno retardo.
Os jobs eliminados terminam no estado ABEND. Todos os jobs ou fluxos de job
dependentes de um job eliminado no so liberados. Jobs eliminados podem ser
executados novamente.
Exemplos
Para eliminar a tarefa report no fluxo de tarefas apwkly(0600 03/05/06) na estao
de trabalho site3, execute o seguinte comando:
kill site3#apwkly(0600 03/05/06).report
|
|
|
Para efetuar kill da tarefa nmero 124 em execuo na estao de trabalho geneva,
execute o comando a seguir:
Consulte tambm
kill geneva#124

Monitor
clique em OK
4. Selecione uma tarefa e clique em Mais AesEliminar.
limit cpu
Altera o limite de jobs que podem ser executados simultaneamente em uma
estao de trabalho. Voc deve ter acesso limit estao de trabalho.
Sintaxe
{limit cpu | lc } workstation
;limit
[;noask]
353
Argumentos
estao de trabalho
Especifica o nome da estao de trabalho. Caracteres curinga so
permitidos. O padro sua estao de trabalho de logon.
limite
Especifica quantas tarefas podem ser executadas simultaneamente na

estao de trabalho. Valores suportados vo de 0 a 1024 ed system.
Se voc configurar limit cpu para 0:
v Para um fluxo de tarefas no estado READY, apenas as tarefas com
valores de prioridade hi e go podem ser ativadas na estao de trabalho.
v Para um fluxo de tarefas com um valor de prioridade hi ou go, todas as
tarefas com um valor de prioridade diferente de 0 podem ser ativadas
na estao de trabalho.
Se voc configurar limit cpu para system, no h nenhum limite para o
nmero de tarefas simultneas na estao de trabalho.
|
|

Comentrios
Para exibir o limite atual do job na estao de trabalho de logon, utilize o comando
status.
Quando voc inicia o Tivoli Workload Scheduler pela primeira vez aps a
instalao, o limite de job da estao de trabalho definido como zero e deve ser
elevado antes da ativao dos jobs. Ao alterar o limite, ele transportado durante
o processamento de pr-produo no plano de produo do prximo dia.
O Tivoli Workload Scheduler tenta lanar o mximo de tarefas possvel dentro do
limite de tarefas. H um limite prtico para o nmero de processos que podem ser
iniciados em uma estao de trabalho. Se esse limite for alcanado, o sistema
responder com uma mensagem indicando que os recursos do sistema no esto
disponveis. Quando um job no pode ser lanado por este motivo, ele entra no
estado fail. Abaixar o limite do job pode evitar que isso ocorra.
Exemplos
Para alterar o limite de job na estao de trabalho na qual o conman est sendo
lc ;12
Para alterar o limite de job na estao de trabalho rx12, execute o seguinte

comando:
lc rx12;6
Para configurar como 10 o limite de tarefas em todas as estaes de trabalho

pertencentes ao domnio e aos domnios filhos, execute o seguinte comando:
lc @!@;10
Consulte tambm
354

predefinido
clique em OK
4. Selecione uma estao de trabalho e clique em Mais AesLimitar....
limit sched
Altera o limit definido na definio de um fluxo de job. Para obter informaes
adicionais sobre como configurar um limite em uma definio de fluxo de tarefas,
consulte limite na pgina 215. Voc deve ter acesso limit ao fluxo de tarefa.
Sintaxe
{limit sched | ls } jstreamselect
;limit
[;noask]
Argumentos
jstreamselect
limite
Especifica o limite do job. possvel digitar de 0 a 1024.

Exemplos
Para alterar o limite de job em todos os fluxos de job que incluem sales no nome,
ls sales@;4
Para alterar o limite de tarefa no fluxo de tarefas CPUA#Job1, execute o seguinte

comando:
ls CPUA#apwkly;6
Consulte tambm
Tarefa do Monitor
predefinido
clique em OK
4. Selecione um fluxo de tarefa e clique em Mais AesLimitar....
link
Abre links de comunicao entre estaes de trabalho. Em uma rede do Tivoli
Workload Scheduler, os agentes tolerantes a falhas e padro so ligados a seus
355
gerenciadores de domnio e os gerenciadores de domnio so ligados a seus

gerenciadores de domnio pai. Agentes estendidos no so ligados; sua
comunicao feita atravs de um host.
Voc deve ter acesso link estao de trabalho de destino.
Sintaxe
{link | lk} [domain!]workstation
[;noask]
Argumentos
domnio
Especifica o nome do domnio no qual os links so abertos. Caracteres
Este argumento til quando se est ligando mais de uma estao de
trabalho em um domnio. Por exemplo, para ligar todos os agentes no
domnio stlouis, utilize o seguinte comando:
lk stlouis!@
O domnio no necessrio se voc no incluir caracteres curingas em

workstation .
Se voc no incluir domain e incluir caracteres curinga em workstation , o
estao de trabalho
Especifica o nome da estao de trabalho a ser ligada. Caracteres curinga
so permitidos.
Esse comando no suportado em estaes de trabalho de mecanismo
remoto.
|
|

Comentrios
Se a opo autolink for definida como on em uma definio de estao de
trabalho, seu link ser aberto automaticamente sempre que o Tivoli Workload
Scheduler for iniciado. Se autolink for definido como off, voc dever utilizar os
comandos link e unlink para controlar a ligao. Para obter informaes sobre
autolink, consulte Definio de estao de trabalho na pgina 135.
Supondo-se que um usurio tenha o acesso link a estaes de trabalho sendo
ligadas, as seguintes regras sero aplicadas:
v Um usurio executando o conman no gerenciador de domnio principal pode
vincular qualquer estao de trabalho na rede.
v Um usurio executando o conman em um gerenciador de domnio diferente do
principal pode vincular qualquer estao de trabalho em seu prprio domnio e
em domnios subordinados. O usurio no pode ligar estaes de trabalho em
domnios ponto a ponto.
v Um usurio executando o conman em um agente pode vincular qualquer
estao de trabalho em seu domnio local, contanto que a estao de trabalho
seja um gerenciador de domnio ou um host. Um agente de perodo no domnio
local no pode ser vinculado.
356
v Para vincular um domnio subordinado durante a execuo do conman em um

domnio superior, no necessrio que os links intervenientes estejam abertos.
Exemplos
A Figura 22 e a Tabela 56 mostram os links abertos pelos comandos link
executados pelos usurios em vrios locais da rede.
DMn so gerenciadores de domnio e Ann so agentes.
A11
A12
DM1
Domain1
User1
User3
User2
DM2
A21
DM3
A31
A22
A32
Domain3
Domain2
DM4
Domain4
A41
A42
Figura 22. Links da Rede

Tabela 56. Links Abertos
Comando
link @!@
Links Abertos pelo Links Abertos pelo Links Abertos pelo

Usurio1
Usurio2
Usurio3
Todos os links so
abertos.
DM1-DM2
DM2-A21
DM2-A22
DM2-DM4
DM4-A41
DM4-A42
DM2-A21
DM1-DM2
DM2-A21
DM2-A22
DM2-DM4
DM2-A21
No permitido.
No permitido.
link @
DM1-A11
DM1-A12
DM1-DM2
DM1-DM3
link DOMAIN3!@
DM3-A31
DM3-A32
357
Tabela 56. Links Abertos (continuao)

Comando
Links Abertos pelo Links Abertos pelo Links Abertos pelo

Usurio1
Usurio2
Usurio3
No permitido.
link DOMAIN4!@
DM4-A41
DM4-A42
DM4-A41
DM4-A42
link DM2
DM1-DM2
No aplicvel.
DM2-A21
link A42
DM4-A42
DM4-A42
No permitido.
link A31
DM3-A31
No permitido.
No permitido.
Consulte tambm
predefinido
clique em OK
4. Selecione uma estao de trabalho e clique em Vincular.
listsym
Lista o plano de produo (arquivos Symphony) j processado.
Sintaxe
{listsym | lis} [trial | forecast]
[;offline]
Argumentos
experimental
Lista planos trial.
previso
Lista planos de previso.
off-line
pgina 308.
Resultados
Programar Data
A data utilizada para selecionar os fluxos de tarefa a serem executados.
Data Real
A data em que batchman comeou a executar o arquivo Symphony.
Hora de Incio
A hora em que batchman comeou a executar o arquivo Symphony.
358
Data de Registro
A data em que o plano (arquivo Symphony) foi registrado pelo comando
stageman.
Nm. de Execuo
O nmero de execuo designado ao plano (arquivo Symphony). utilizado
internamente para sincronizao da rede do Tivoli Workload Scheduler.
Tamanho
O nmero de registros contidos no arquivo Symphony.
Nm. de Log
O nmero de log que indica a ordem cronolgica dos arquivos de log. Esse
nmero pode ser utilizado em um comando setsym para mudar para um
arquivo de log especfico.
Nome do Arquivo
O nome do arquivo de log atribudo pelo comando stageman.
Exemplos
Para listar os arquivos do plano de produo, execute o seguinte comando:
listsym
esta uma sada de amostra para o comando:

Job Stream
Date
03/05/06
03/04/06
03/04/06
03/04/06
03/04/06
03/04/06
03/04/06
03/04/06
03/04/06
Actual
Date
03/05/06
03/04/06
03/04/06
03/04/06
03/04/06
03/04/06
03/04/06
03/04/06
03/04/06
Start
Time
21:06
15:59
15:51
14:31
14:26
14:24
14:19
14:17
14:17
Log
Date
03/05/06
03/05/06
03/04/06
03/04/06
03/04/06
03/04/06
03/04/06
03/04/06
03/04/06
Run
Num
42
41
40
39
38
37
36
35
34
Size
534
463
362
460
436
436
436
436
364
Log
Num
1
2
3
4
5
6
7
8
9
Filename
M200603052111
M200603052106
M200603041559
M200603041551
M200603041431
M200603041426
M200603041424
M200603041419
M200603041417
Exp
Exp
Exp
Exp
Exp
Exp
Exp
Exp
Exp
Para listar arquivos que contm planos trial, execute o seguinte comando:
listsym trial
esta uma sada de amostra para o comando:

Job Stream
Date
03/03/06
03/03/06
03/03/06
Actual Start
Date Time
Log
Date
03/03/06
03/03/06
03/03/06
Run
Num
0
0
0
Size
126
1850
1838
Log
Num
Filename
1 Tpippo
2 Tangelo2
3 Tangelo1
Exp
Exp
Exp
Para listar os arquivos que contm os planos de previso, execute o seguinte

comando:
listsym forecast
Esta uma sada de amostra para o comando:

Job Stream
Date
03/03/06
Actual Start
Date Time
Log
Date
03/03/06
Run
Num
0
Size
62
Log
Num
Filename
1 Fpluto
Exp
Consulte tambm
359
1. Clique em Tivoli Workload SchedulerCarga de TrabalhoPrevisoListar

Planos Disponveis
2. Selecione um nome de mecanismo e clique em um tipo de plano ou grave um
nome de arquivos de plano
3. Clique em Exibir Lista de Planos.
recall
Exibe prompts que esto aguardando uma resposta.
Voc deve ter acesso display aos prompts.
Sintaxe
{recall | rc} [workstation]
[;offline]
Argumentos
estao de trabalho
Especifica o nome da estao de trabalho na qual o prompt foi emitido. Se
voc no especificar uma estao de trabalho, somente os prompts da
estao de trabalho de logon e os prompts globais sero exibidos.
off-line
pgina 308.
Resultados
Estado
O estado do prompt. O estado de avisos pendentes sempre ASKED.
Mensagem ou Prompt
Para prompts nomeados, o nmero da mensagem, o nome do prompt e o
texto da mensagem. Para prompts no-nomeados, o nmero da mensagem,
o nome do job ou fluxo de job e o texto da mensagem.
Exemplos
Para exibir prompts pendentes emitidos na estao de trabalho na qual o conman
est sendo executado, execute o seguinte comando:
recall
ou:
rc
Para exibir prompts pendentes na estao de trabalho site3, execute o seguinte

comando:
rc site3
Para exibir prompts pendentes em todas as estaes de trabalho e fazer com que a
sada seja enviada para o dispositivo off-line de conman, execute o comando a
seguir:
rc @;off-line
360
Consulte tambm
1. Clique em Tivoli Workload SchedulerCarga de
TrabalhoMonitorDependncias da Carga de Trabalho
2. Selecione Prompts do Monitor
3. possvel selecionar Todos os Prompts np Plano, o que listar todos os
prompts independentemente de seus status, ou criar e selecionar outra tarefa
predefinida que lista apenas prompts no status ASKED
4. Escolha um nome de mecanismo, ou especifique propriedades da conexo, e
clique em OK.
redo
Edita e executa o comando anterior novamente.
Sintaxe
{redo | red}
Contexto
Quando voc executa o comando redo, o conman exibe o comando anterior para
que possa ser editado e executado novamente. Utilize a barra de espaos para
mover o cursor sob o caractere a ser modificado e digite as diretrizes a seguir.
Diretrizes
d[dir]
Exclui o caractere acima de d. Pode vir seguido por outras

diretrizes.
itext
Insere texto antes do caractere acima de i.
rtext
Substitui um ou mais caracteres por texto, comeando com o

caractere acima de r. A substituio estar implcita se nenhuma
outra diretriz for digitada.
>text
Anexa texto no final da linha.
>d[dir | text]
Exclui caracteres no final da linha. Pode vir seguido por outra
diretriz ou texto.
>rtext
Substitui caracteres no final da linha por texto.
Exemplos de Diretrizes
ddd
Exclui os trs caracteres acima de ds.
iabc
Insere abc antes do caractere acima de i.
rabc
Substitui os trs caracteres, comeando pelo caractere acima de r,

por abc.
abc
Substitui os trs caracteres acima de abc por abc.
d diabc
Exclui o caractere acima do primeiro d, pula um caractere, exclui o
caractere acima do segundo d e insere abc em seu lugar.
>abc
Anexa abc no final da linha.
361
>ddabc
Exclui os dois ltimos caracteres na linha e insere abc em seu
lugar.
>rabc
Substitui os trs ltimos caracteres na linha por abc.
Exemplos
Para inserir um caractere, execute o seguinte comando:
redo
setsm 4
iy
setsym 4
Para substituir um caractere, execute o seguinte comando:

redo
setsym 4
5
setsym 5
release job
Libera jobs das dependncias.
Voc deve ter acesso release ao job.
Sintaxe
{release job | rj} jobselect
[;dependency[;...]]
[;noask]
Argumentos
jobselect
Especifica o job ou jobs a serem liberados. Consulte Selecionando Tarefas
em Comandos na pgina 313.
dependncia
O tipo de dependncia. possvel especificar uma das seguintes.
possvel utilizar caracteres curinga em workstation, jstreamname, jobname,
resource, filename e promptname.
confirmed
every
priority
362

job qualificado.
Comentrios
Ao liberar uma dependncia opens, possvel incluir apenas o nome de arquivo
base e o conman executar uma procura sem distino de maisculas/minsculas
para correspondncia de arquivos, ignorando os nomes de diretrios. As
dependncias de todos os arquivos correspondentes so liberadas.
Para dependncias needs, o job liberado recebe o nmero requerido de unidades
do recurso, apesar de poderem no estar disponveis. Isso pode fazer com que as
unidades disponveis em um showresources exibam um nmero negativo.
Quando voc libera um job de uma dependncia priority, o job revertido para
sua prioridade planejada original.
As dependncias liberadas permanecem em efeito ao executar o comando rerun.
Exemplos
Para liberar a tarefa job3 no fluxo de tarefas ap(1000 03/05/06) de todas suas
dependncias, execute o seguinte comando:
rj ap(1000 03/05/06).job3
Para liberar todos os jobs na estao de trabalho site4 de suas dependncias em

um aviso chamado glprmt, execute o seguinte comando:
rj site4#@.@;prompt=glprmt
Consulte tambm
Monitor
clique em OK
4. Selecione uma tarefa e clique em Mais AesLiberar.
release sched
Libera fluxos de job das dependncias.
Voc deve ter acesso release ao fluxo de job.
Sintaxe
{release sched | rs} jstreamselect
[;dependency[;...]]
[;noask]
Argumentos
jstreamselect
363
dependncia
O tipo de dependncia. Especifique uma das seguintes. possvel utilizar
caracteres curinga em workstation, jstream, job, resource, filename e
promptname.
carryforward
limite
priority
Comentrios
Ao excluir uma dependncia opens, possvel incluir apenas o nome de arquivo
base e o conman executar uma procura sem distino de maisculas/minsculas
para correspondncia de arquivos, ignorando os nomes de diretrios. As
dependncias de todos os arquivos correspondentes so liberadas.
Para dependncias needs, o fluxo de job liberado recebe o nmero requerido de
unidades do recurso, apesar de poderem no estar disponveis. Isso pode fazer
com que as unidades disponveis em um showresources exibam um nmero
negativo.
Ao liberar um fluxo de tarefas uma dependncia priority, o fluxo de tarefas
revertido para sua prioridade original.
Em determinadas circunstncias, quando voc submete um comando deldep, ele
pode ter sido bem-sucedido, embora seja novamente redirecionado para o
batchman. Para obter informaes adicionais, consulte Processamento de
comandos do conman na pgina 312.
Exemplos
Para liberar a instncia do fluxo de tarefas com jobstream_id 0AAAAAAAAAAAABSE de
todas as suas dependncias, execute o seguinte comando:
rs 0AAAAAAAAAAAABSE; schedid
Para liberar o fluxo de tarefas sked5(1105 03/07/06) de todas suas dependncias

opens, execute o seguinte comando:
rs sked5(1105 03/07/06);opens
Para liberar todos os fluxos de job na estao de trabalho site3 de suas

dependncias no fluxo de job main#sked23, execute o seguinte comando:
364
rs site3#@;follows=main#sked23
Consulte tambm
Tarefa do Monitor
predefinido
clique em OK
4. Selecione um fluxo de tarefa e clique em Mais AesLiberar.
reply
Responde a um prompt de job ou fluxo de job.
Voc deve ter acesso reply ao prompt nomeado ou global. Para responder a um
prompt no-nomeado, voc deve ter acesso reply aos prompts e acesso reply ao job
ou fluxo de job associado.
Sintaxe
{reply | rep}
{ promptname | [workstation#]msgnum}
;responder
[;noask]
Argumentos
promptname
permitidos.
estao de trabalho
Especifica o nome da estao de trabalho na qual um prompt no-nomeado
foi emitido.
msgnum
Especifica o nmero de mensagem de um prompt no-nomeado. possvel
exibir nmeros de mensagens com os comandos recall e showprompts.
reply
Especifica a resposta, Y para sim ou N para no.

prompt qualificado.
Comentrios
Se a resposta for Y, as dependncias no prompt sero satisfeitas. Se a resposta for
N, as dependncias no so atendidas e o prompt no emitido novamente.
Os prompts podem ser respondidos antes de serem emitidos. possvel utilizar o
comando showprompts para exibir todos os prompts, se tiverem ou no sido
emitidos.
365
Exemplos
Para responder S ao aviso global arpmt, execute o seguinte comando:
reply arprmt;y
Para responder N ao nmero da mensagem 24 na estao de trabalho site4,

rep site4#24;n
Consulte tambm
TrabalhoMonitorDependncias da Carga de TrabalhoPrompts do Monitor
2. Selecione Todos os Prompts no Plano ou outro nome de tarefa predefinido
clique em OK
4. Selecione um prompt e clique em Responder Sim ou Responder No.
rerun
Reexecuta um job.
Voc deve ter acesso rerun ao job.
Sintaxe
{rerun | rr} jobselect
[;from=[wkstat#]job[
;at=time]
[;pri=pri]]
[;noask]
[;step=step]
[;noask]
Argumentos
jobselect
Especifica o nome de um ou mais jobs. Caracteres curinga so permitidos.
from=[wkstat#]job
Especifica o nome de uma tarefa definida no banco de dados cujo arquivo
de tarefa ou comando ser executado no lugar da tarefa especificada por
jobselect.
wkstat#
Especifica o nome da estao de trabalho na qual o job from
executado. O padro a estao de trabalho na qual o conman est
sendo executado.
tarefa
366
Especifica o nome da definio de tarefa from. Os seguintes tipos

de nomes de job no so permitidos:
v Os nomes de jobs submetidos com o uso dos comandos submit
file e submit docommand.
v Os nomes alias de jobs submetidos com o uso do comando

submit job.
Para utilizar o argumento from, voc deve ter acesso ao banco de dados a
partir do computador no qual o conman est sendo executado
at=time
Especifica o horrio de incio da tarefa rerun, expressado da seguinte
forma:
hhmm [timezone|tz tzname] [+n days | date]
onde:
hhmm
A hora e minuto.
+n dias
date
A prxima ocorrncia de hhmm em date, expressa como mm/dd[/yy].
timezone|tz tzname
Gerenciando fusos horrios, na pgina 523 para obter nomes
vlidos.
pri=pri
Especifica a prioridade a ser atribuda ao job de reexecuo. Se voc no
especificar uma prioridade, o job receber a mesma prioridade do job
original.
step=step
Especifica que o job reexecutado utilizando esse nome no lugar do nome
de job original. Consulte Notas de Uso para obter informaes
adicionais.
job qualificado.
Comentrios
possvel reexecutar jobs que esto no estado SUCC, FAIL ou ABEND. Um job de
reexecuo colocado no mesmo fluxo de job do job original e herda as
dependncias do job original. Se voc reexecutar um job repetitivo (every), o job de
reexecuo ser planejado para ser executado com a mesma taxa do job original.
Nota: possvel emitir o comando rerun para tarefas no fluxo de tarefas EXTERNAL
que estejam no estado ERROR. As tarefas do fluxo de tarefas EXTERNAL
representam tarefas e fluxos de tarefas que foram especificados como
dependncias entre redes. O estado do job definido inicialmente como
extrn imediatamente aps a execuo de um comando rerun e o conman
comea a verificar o estado.
Quando ;from utilizado, o nome do job de reexecuo depende do valor da
Opo Global reter nomes de jobs de reexecuo. Se a opo for definida como Y,
os jobs de reexecuo retero os nomes de job originais. Se a opo for definida
como N, os jobs de reexecuo recebero os nomes de job from. Para obter
informaes adicionais, consulte o Guia de Administrao do Tivoli Workload
Scheduler.
367
Em exibies do conman, os jobs reexecutados so exibidos com a notao >>rerun

as. Para referir-se a um job reexecutado em outro comando, tal como altpri, voc
deve utilizar o nome de job original.
Quando uma tarefa reexecutada com a opo ;step, a tarefa executada com step
no lugar de seu nome original. Em um script de job, possvel utilizar o comando
jobinfo para retornar o nome do job e executar o script de forma diferente para
cada iterao. Por exemplo, no script UNIX a seguir, o comando jobinfo
utilizado para definir uma varivel chamada STEP com o nome utilizado para
executar o job. A varivel STEP ento utilizada para determinar como o script
ser executado.
...
MPATH=`maestro`
STEP=`$MPATH/bin/jobinfo job_name`
if [$STEP = JOB3]
then
...
STEP=JSTEP1
fi
if [$STEP = JSTEP1]
then
...
STEP=JSTEP2
fi
if [$STEP = JSTEP2]
then
...
fi
...
Em exibies do conman, os jobs reexecutados com a opo ;step so exibidos com

a notao >>rerun step.
Para obter informaes sobre jobinfo, consulte jobinfo na pgina 457.
Exemplos
Para reexecutar o job job4 no fluxo de job sked1 na estao de trabalho main,
rr main#sked1.job4
Para executar novamente a tarefa job5 no fluxo de tarefas sked2 usando a

definio de tarefa para a tarefa jobx, em que a hora at da tarefa est configurada
para 18h30 e sua prioridade est configurada para 25, execute o comando a seguir:
rr sked2.job5;from=jobx;at=1830;pri=25
Para reexecutar o job job3 no fluxo de job sked4 utilizando o nome de job jstep2,
rr sked4.job3;step=jstep2
Consulte tambm
Monitor
368

clique em OK
4. Selecione uma tarefa e clique em Reexecutar....
|
resetFTA
|
|
Gera um arquivo Sinfonia atualizado e envia o mesmo a um agente tolerante a

falhas no qual o arquivo Symphony foi corrompido.
|
|
|
|
|
|
|
|
Nota: A remoo completa e a substituio do arquivo Symphony causa alguma

perda de dados como, por exemplo, os eventos sobre o status da tarefa ou o
contedo das filas de mensagens Mailbox.msg e tomaster.msg. Se as
informaes de estado sobre uma tarefa estavam contidas nessas filas, essa
tarefa ser executada novamente. recomendada a aplicao deste comando
com cuidado.
No processo, os arquivos a seguir so movidos para o diretrio
TWA_home/TWS/tmp:
v Appserverbox.msg
v clbox.msg
|
|
|
|
|
|
|
v Courier.msg
v Intercom.msg
Mailbox.msg
Monbox.msg
Moncmd.msg
Symphony
Sinfonia
|
|
v
v
v
v
v
|
|
|
|
|
Antes do comando ser executado, uma mensagem de informao exibida para

solicitar confirmao e assegurar que o comando no seja emitido por engano. Se
um dos arquivos de destino no puder ser movido por estar sendo usado por
outro processo (por exemplo, o processo mailman ainda est em execuo), a
operao no executada e uma mensagem de erro exibida.
Autorizao
|
|
Voc deve ter acesso RESETFTA ao agente tolerante a falhas que deseja
reconfigurar.
Sintaxe
resetFTA
Argumentos
cpu
Esse comando no est disponvel no Dynamic Workload Console .
Exemplos
|
|
|
Para reconfigurar o agente tolerante a falhas denominado omaha, execute o

comando a seguir:
cpu
o agente tolerante a falhas a ser reconfigurado.
resetFTA omaha
369
Consulte tambm
|
|
|
Para obter informaes sobre o procedimento de recuperao do agente tolerante a

falhas, consulte a seo sobre o procedimento de recuperao de um agente
tolerante a falhas em Tivoli Workload Scheduler: Guia de Resoluo de Problemas..
resource
Altera o nmero de unidades totais de um recurso.
Voc deve ter acesso resource ao recurso.
Sintaxe
{resource | res} [workstation#]
resource;num
[;noask]
Argumentos
estao de trabalho
Especifica o nome da estao de trabalho na qual o recurso foi definido. O
padro a estao de trabalho na qual o conman est sendo executado.
resource
Especifica o nome do recurso.
num
Especifica o nmero total de unidades de recurso. Os valores vlidos so 0

a 1024.

recurso qualificado.
Exemplos
Para alterar o nmero de unidades do recurso tapes para 5, execute o seguinte
comando:
resource tapes;5
Para alterar o nmero de unidades do recurso jobslots na estao de trabalho

site2 para 23, execute o seguinte comando:
res site2#jobslots;23
Consulte tambm
TrabalhoMonitorDependncias da Carga de TrabalhoRecursos do Monitor
2. Selecione Todos os Recursos no Plano ou outro nome de tarefa predefinido
clique em OK
4. Selecione um recurso e clique em Alterar Unidades....
370
setsym
Seleciona um arquivo archive do plano de produo. Comandos de exibio
subseqentes mostram o contedo do plano de produo arquivado. Voc no
pode modificar as informaes de um arquivo archive do plano de produo.
Sintaxe
{setsym | set} [trial | forecast] [filenum]
Argumentos
experimental
Lista planos trial.
previso
Lista planos de previso.
filenum
Especifica o nmero do arquivo archive do plano de produo. Se voc no
especificar um nmero de arquivo de log, o ponteiro retornar para zero, o
plano de produo atual (Symphony). Utilize o comando listsym para listar
nmeros do arquivo archive.
Exemplos
Para selecionar o arquivo archive do plano de produo 5, execute o seguinte
comando:
setsym 5
Para selecionar o plano de produo atual (arquivo Symphony), execute o seguinte

comando:
set
Consulte tambm
1. Clique em Tivoli Workload SchedulerCarga de TrabalhoPrevisoListar
Planos Disponveis
2. Selecione um nome de mecanismo e clique em Planos Arquivados ou fornea
um nome de arquivo do plano
3. Clique em Exibir Lista de Planos.
showcpus
Exibe informaes sobre estaes de trabalho e links.
As informaes exibidas so atualizadas apenas enquanto o Tivoli Workload
Scheduler (batchman) est em execuo nas estaes de trabalho. Se batchman est
ativo ou inativo confirmado na tela pela mensagem Batchman LIVES ou Batchman
down quando voc emite o comando conman start.
Voc deve ter acesso de lista ao objeto sendo mostrado se a opo enListSecChk
tiver sido configurada como yes no gerenciador de domnio mestre quando o
plano de produo foi criado ou estendido.
371
Sintaxe
{showcpus | sc} [[domain!]workstation]
[;info|;link]
[;offline]
{showcpus | sc} [[domain!]workstation] [;getmon]
Argumentos
domnio
Especifica o nome de um domnio. O padro o domnio no qual o
comando executado.
estao de trabalho
Especifica o nome de uma estao de trabalho. O padro a estao de
trabalho na qual o comando executado. Quando no h especificao do
domnio e da estao de trabalho, a sada pode ser a seguinte:
v O seguinte comando exibe todas as estaes de trabalho que esto no
domnio da estao de trabalho na qual o comando foi executado, alm
de todos os gerenciadores de domnio conectados se a estao de
trabalho for um gerenciador de domnio.
conman "sc"
v O seguinte comando exibe todas as estaes de trabalho que esto no

domnio da estao de trabalho na qual o comando foi executado, sem
os gerenciadores de domnio conectados.
conman "sc @"
info
Exibe informaes no formato info.
link
Exibe informaes no formato link.
off-line
pgina 308.
getmon
Retorna a lista de regras de eventos definidas para o monitor em execuo
na estao de trabalho especificada no seguinte formato:
<rule_name>::<eventProvider>#<eventType>:<scope>
O escopo da regra so informaes geradas automaticamente sobre

atributos da regra, tais como as estaes de trabalho em que ela utilizada,
um nome de tarefa ou arquivo, etc.
O cabealho da sada tambm contm o registro de data e hora de quando
o pacote de configurao da regra foi gerado pela ltima vez.
Nota: Esta opo no vlida em estaes de trabalho broker de carga de
trabalho dinmica (ou gerenciadores de domnio dinmicos). Nesse
caso, possvel recuperar as informaes sobre as regras ativas
definidas nessas estaes de trabalho no arquivo
TWA_home\TWS\monconf\TWSObjectsMonitor.cfg no gerenciador de
domnio principal.
|
|
|
|
|
|
372
Resultados
|
|
|
Quando o parmetro getmon no utilizado, a sada do comando produzida nos

trs formatos, standard, info e link. O valor padro standard. O significado dos
caracteres exibidos depende do tipo de formato selecionado.
Ao executar em uma estao de trabalho com uma verso do Tivoli Workload
Scheduler anterior verso 8.6, o comando sc mostra como FTA os tipos de
estaes de trabalho introduzidos com o Tivoli Workload Scheduler verso 8.6,
conjunto, conjunto dinmico, agente e mecanismo remoto.
Quando o parmetro getmon utilizado, a lista de regras fornecida como uma
sada separada.
Exemplos
1. Para exibir informaes sobre a estao de trabalho na qual o conman est
sendo executado no formato info, execute o seguinte comando:
showcpus ;info
Uma sada de amostra para este comando :

|
|
|
|
CPUID
MASTER
FTA1
FTA2
VERSION
TIME ZONE
8.6.0.0 US/Pacific
8.6.0.0
8.6.0.0
INFO
Linux 2.6.5-7.191-s390 #1 SM
Linux 2.4.9-e.24 #1 Tue May
HP-UX B.11.11 U 9000/785
2. Para exibir as informaes de link para todas as estaes de trabalho, execute o

seguinte comando:
sc @!@;link
Uma sada de amostra a seguinte:

CPUID
MASTER
FTA1
FTA2
BROKER1
HOST
MASTER
FTA1
FTA2
MASTER
FLAGS
AF T
AF T
AF T
A T
ADDR NODE
51099 9.132.239.65
51000 CPU235019
51000 9.132.235.42
51111 9.132.237.17
3. Para exibir informaes sobre a estao de trabalho, execute o seguinte

comando:
showcpus
Se voc executar este comando em um ambiente quando a conexo primria da

estao de trabalho com seu gerenciador de domnio ou superior no estiver
ativa, receber a seguinte sada:
CPUID
MASTER
FTA1
FTA2
FTA3
FTA4
FTA5
SA1
XA_FTA4
FTA6
FTA7
FTA7
BROKER
RUN
360 *WNT
360 WNT
360 WNT
360 WNT
360 WNT
360 WNT
360 WNT
360 OTHR
360 WNT
360 WNT
360 WNT
360 OTHR
NODE
MASTER
FTA
FTA
MANAGER
FTA
FTA
S-AGENT
X-AGENT
MANAGER
FTA
FTA
BROKER
LIMIT FENCE
DATE
10
0 03/05/2010 1348
10
0 03/05/2010 1348
10
0 03/05/2010 1348
10
0 03/05/2010 1348
10
0 03/05/2010 1348
10
0 03/05/2010 1348
10
0 03/05/2010 1348
10
0 03/05/2010 1348
10
0 03/05/2010 1348
10
0 03/05/2010 1349
10
0 03/05/2010 1349
10
0 03/05/2010 1349
TIME STATE
I J
E
FTI JW M
FTI JW M
LTI JW M
F I J M
I J M
F I J M
L I J M
F I J M
F I J M
F I J M
LTI JW
METHOD DOMAIN
MASTERDM
MASTERDM
MASTERDM
DOMAIN1
DOMAIN1
DOMAIN1
DOMAIN1
DOMAIN1
DOMAIN2
DOMAIN2
DOMAIN2
MASTERDM

estao de trabalho com seu gerenciador de domnio ou superior estiver ativo e
pelo menos uma conexo secundria no estiver ativa, receber a seguinte
sada:
373
CPUID
MASTER
FTA1
FTA2
FTA3
FTA4
FTA5
SA1
XA_FTA4
FTA6
FTA7
RUN
360 *WNT
360 WNT
360 WNT
360 WNT
360 WNT
360 WNT
360 WNT
360 OTHR
360 WNT
360 WNT
NODE
LIMIT FENCE
DATE
TIME
MASTER
10
0 03/05/2010 1348
I
FTA
10
0 03/05/2010 1348 FTI
FTA
10
0 03/05/2010 1348 FTI
MANAGER 10
0 03/05/2010 1348 FTI
FTA
10
0 03/05/2010 1348 F I
FTA
10
0 03/05/2010 1348 L I
S-AGENT 10
0 03/05/2010 1348 F I
X-AGENT 10
0 03/05/2010 1348 L I
MANAGER 10
0 03/05/2010 1348 F I
FTA
10
0 03/05/2010 1349 F I
STATE
J
E
JW M
JW M
JW M
J M
M
J M
J M
J M
J M
METHOD
DOMAIN
MASTERDM
MASTERDM
MASTERDM
DOMAIN1
DOMAIN1
DOMAIN1
DOMAIN1
DOMAIN1
DOMAIN2
DOMAIN2

estao de trabalho com seu gerenciador de domnio ou superior e todas as
conexes secundrias estiverem ativas, receber a seguinte sada:
CPUID
MASTER
FTA1
FTA2
FTA3
FTA4
FTA5
SA1
XA_FTA4
FTA6
FTA7
RUN
360 *WNT
360 WNT
360 WNT
360 WNT
360 WNT
360 WNT
360 WNT
360 OTHR
360 WNT
360 WNT
NODE
LIMIT FENCE
DATE
TIME
MASTER
10
0 03/05/2010 1348
I
FTA
10
0 03/05/2010 1348 FTI
FTA
10
0 03/05/2010 1348 FTI
MANAGER 10
0 03/05/2010 1348 FTI
FTA
10
0 03/05/2010 1348 F I
FTA
10
0 03/05/2010 1348 F I
S-AGENT 10
0 03/05/2010 1348 F I
X-AGENT 10
0 03/05/2010 1348 L I
MANAGER 10
0 03/05/2010 1348 F I
FTA
10
0 03/05/2010 1349 F I
STATE
METHOD
DOMAIN
J
E
MASTERDM
JW M
MASTERDM
JW M
MASTERDM
JW M
DOMAIN1
J M
DOMAIN1
M
DOMAIN1
J M
DOMAIN1
J M
DOMAIN1
J M
DOMAIN2
J M
DOMAIN2
4. Obtenha uma lista de monitores de regras ativas na estao de trabalho

denominada CPU1, execute este comando:
sc CPU1 getmon
Voc obter a seguinte sada:

Monitoring configuration for CPU1:
*******************************************
*** Package Date : 04/22/2009 12:00 GMT ***
*******************************************
Rule1::FileMonitor#FileCreated:Workstation=CPU1,CPU2;File=\tmp\filename
Rule2::FileMonitor#ModificationCompleted:Workstation=CPU1,CPU3;File=\staging\orders
Rule3::TWSObjectsMonitor#JobSubmit:JobKey=CPU1#JS1.Job1
Rule5::TWSObjectsMonitor#JobLate:JobKey=CPU1#JS1.Job1
Consulte tambm
predefinido
clique em OK
Formato Padro
CPUID
O nome da estao de trabalho na qual essa informao se aplica.
RUN
O nmero de execues do arquivo Symphony.
NODE
O tipo de n e o tipo de estao de trabalho. Os tipos de ns so os
seguintes:
v UNIX
v WNT
374
|
|
v OTHER
v ZOS
v IBM i
|
|
|
|
|
|
|
|
|
|
Os tipos de estao de trabalho so os seguintes:

v MASTER
v MANAGER
v FTA
v S-AGENT
v X-AGENT
v AGENT
v POOL
v D-POOL
v REM-ENG
LIMIT
O limite de tarefas do Tivoli Workload Scheduler.
FENCE
O limitador de tarefas do Tivoli Workload Scheduler.
DATE TIME
A data e hora em que o Tivoli Workload Scheduler comeou a executar o
plano de produo atual (arquivo Symphony).
STATE
|
|
|
|
|
|
|
|
Exibe as seguintes informaes:

v O estado dos links e processos da estao de trabalho. So exibidos at
cinco caracteres da seguinte forma: A explicao dos caracteres
dividida com base no escopo do caractere:
[L|F] [T|H|X|B] [I] [J] [W|H|X] [M] [E|e] [D] [A|R]
onde:
L
O link principal aberto (vinculado) a seu domnio ou

gerenciador superior.
|
|
|
Se a estao de trabalho for do tipo agente dinmico ou

mecanismo remoto, esse sinalizador indica que a estao de
trabalho est conectada ao servidor do Workload Broker.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Se a estao de trabalho for do tipo conjunto ou conjunto

dinmico, esse sinalizador indica que a estao de trabalho do
Workload Broker na qual o conjunto ou conjunto dinmico est
registrado est vinculada a seu domnio ou gerenciador superior.
A estao de trabalho est totalmente vinculada por meio de
conexes principais e de todas as secundrias. Esse sinalizador
aparecer somente se a opo global enSwfaultTol estiver
configurada para YES utilizando a linha de comandos optman
no gerenciador de domnio mestre e indica que a estao de
trabalho est diretamente vinculada a seu gerenciador de
domnio e a todos os seus gerenciadores de domnio de backup
completo. Para obter informaes sobre como utilizar a linha de
comandos optman, consulte o Guia de Administrao do IBM
Esse sinalizador ser exibido se o agente tolerante a falhas
estiver vinculado diretamente ao gerenciador de domnio a
partir do qual o comando foi executado.
A estao de trabalho est ligada atravs de seu host.
375
|
|
|
|
|
|
|
B
I
A estao de trabalho est ligada como um agente estendido

(x-agent).
A estao de trabalho se comunica por meio do servidor do
Workload Broker.
Se a estao de trabalho for do tipo agente MASTER,
MANAGER, FTA, S-AGENT, X-AGENT, esse sinalizador indica
que o programa jobman concluiu a inicializao.
|
|
|
Se a estao de trabalho for do tipo agente dinmico, conjunto

ou conjunto dinmico, esse sinalizador indica que o agente est
inicializado corretamente.
|
|
|
|
|
|
|
Se a estao de trabalho for do tipo mecanismo remoto, esse

sinalizador indica que a comunicao entre a estao de trabalho
do mecanismo remoto e a mecanismo remoto est inicializada
corretamente.
Se a estao de trabalho for do tipo agente MASTER,
MANAGER, FTA, S-AGENT, X-AGENT, esse sinalizador indica
que o programa jobman est em execuo.
|
|
|
|
|
Se a estao de trabalho for do tipo agente dinmico, esse

sinalizador indica que JobManager est em execuo. Como
nenhum monitoramento executado nas estaes de trabalho de
conjunto dinmico, para esse tipo de estao de trabalho, o
caractere J sempre mostrado.
|
|
|
Se a estao de trabalho for do tipo conjunto, esse sinalizador

indica que o processo JobManager est em execuo em pelo
menos um agente registrado no conjunto.
|
|
|
|
Se a estao de trabalho for do tipo mecanismo remoto, esse

sinalizador indica que o comando ping para o mecanismo
remoto foi bem-sucedido.
O processo writer est ativo na estao de trabalho.
|
|
|
Nota: Se a estao de trabalho que est executando conman for o host

do agente estendido, o estado do agente estendido
|
|
|
|
|
|
Se a estao de trabalho que est executando conman no for o

host do agente estendido, o estado do agente estendido
LXI JX
LHI JH
v O estado do agente de monitoramento. At trs caracteres so exibidos,

conforme a seguir:
[M] [E|e] [D]
onde:
S
|
|
|
|
|
|
|
|
|
|
|
|
E
e
376
O processo monman est em execuo. Esse sinalizador exibido

para todas as estaes de trabalho da rede quando o recurso de
automao de carga de trabalho orientado por evento est
ativado (a opo global enEventDrivenWorkloadAutomation est
configurada para yes), com a exceo das estaes de trabalho
em que monman foi parado manualmente (usando conman ou
Tivoli Dynamic Workload Console).
O servidor de processamento de eventos est instalado e em
execuo na estao de trabalho.
O servidor de processamento de eventos est instalado na
estao de trabalho mas no est em execuo.
|
|
|
|
|
|
A estao de trabalho est utilizando uma configurao de

monitoramento de pacotes atualizada. Esse sinalizador exibido
para as estaes de trabalho nas quais o pacote mais recente de
regras de eventos foi implementado (manualmente com o
comando planman deploy ou automaticamente com a frequncia
especificada pela opo global deploymentFrequency).
v O estado do WebSphere Application Server. Um sinalizador de um

caractere exibido, se o servidor de aplicativos estiver instalado:
|
|
|
[A|R]
onde:
|
|
|
R
O WebSphere Application Server est reiniciando.
O sinalizador estar em branco se o servidor de aplicativos estiver
inativo ou se ele no foi instalado.
O WebSphere Application Server foi iniciado.
METHOD
O nome do mtodo de acesso especificado na definio de estao de
trabalho. Apenas para agentes estendidos.
DOMAIN
O nome do domnio do qual a estao de trabalho um membro.
Formato Info
CPUID
VERSION
A verso do agente do Tivoli Workload Scheduler instalada na estao de
trabalho.
|
|
|
|
|
TIMEZONE
O fuso horrio da estao de trabalho. o mesmo valor da varivel de
ambiente TZ. Para um agente estendido, esse o fuso horrio de seu host.
Para uma estao de trabalho de mecanismo remoto, esse o fuso horrio
do mecanimso remoto.
|
|
|
|
|
|
INFO Um campo informativo. Para todos os tipos de estao de trabalho, exceto

o agente estendido e as estaes de trabalho do intermedirio, ele contm a
verso do sistema operacional e o modelo de hardware. Para agentes
estendidos e estaes de trabalho de mecanismo remoto, nenhuma
informao est listada. Para a estao de trabalho de mecanismo remoto,
mostra Mecanismo Remoto.
Formato Link
CPUID
HOST O nome da estao de trabalho atuando como o host para um agente
padro ou agente estendido. Para gerenciadores de domnio e agente
tolerante a falhas, o mesmo de CPUID. Para as estaes de trabalho do
agente padro e do intermedirio, o nome do gerenciador de domnio.
Para agentes estendidos, o nome do estao de trabalho host.
FLAGS
O estado das propriedades da estao de trabalho. So exibidos at cinco
caracteres, como a seguir:
377
[A] [B] [F] [s] [T]
x
B
F
s
P
O link automtico est ativado na definio de estao de trabalho.

Esse sinalizador ser utilizado somente em ambientes de ponta a
ponta e isso indica se o sinalizador desativar ativao de job est
desativado.
O modo Status Completo est ativado na definio de estao de
trabalho.
O ID do servidor mailman da estao de trabalho.
O link est definido como TCP/IP.
ADDR
O nmero da porta TCP/IP da estao de trabalho.
NODE
O nome do n da estao de trabalho.
showdomain
Exibe informaes sobre o domnio.
As informaes exibidas so atualizadas somente se o Tivoli Workload Scheduler
(batchman) estiver em execuo. A confirmao da atividade ou inatividade do
batchman aparece na tela atravs da mensagem Batchman LIVES ou Batchman down
quando voc emite o comando conman start.
Sintaxe
{showdomain | showd} [domain]
[;info]
[;offline]
Argumentos
domnio
Especifica o nome do domnio. O padro o domnio no qual o conman
est sendo executado. Caracteres curinga so permitidos.
info
off-line
pgina 308.
Resultados
A sada do comando produzida em dois formatos: padro e info.
Exemplos
Para exibir informaes sobre o domnio masterdm, execute o seguinte comando:
showdomain masterdm
378
DOMAIN
*MASTERDM
MANAGER
*MASTER
PARENT
Para exibir as estaes de trabalho membros em todos os domnios no formato

info, execute o seguinte comando:
showdomain @;info
uma sada de amostra a seguinte:

DOMAIN
MASTERDM
DOM1
DOM2
MEMBER-CPUs
*MASTER
FTA1
FTA2
CPU-Type
MASTER
MANAGER
MANAGER
Consulte tambm
PlanejamentoMonitorDomnios do Monitor
2. Selecione Todos os Domnios no Plano ou outro nome de tarefa predefinido
clique em OK
Formato Padro
DOMAIN
O nome do domnio no qual essa informao se aplica.
MANAGER
O nome do gerenciador de domnio.
PARENT
O nome do domnio pai.
Formato Info
DOMAIN
O nome do domnio no qual essa informao se aplica.
MEMBER-CPUS
Os nomes das estaes de trabalho do domnio.
CPU-TYPE
O tipo de cada estao de trabalho: MASTER, MANAGER, FTA, S-AGENT,
X-AGENT ou BROKER.
showfiles
Exibe informaes sobre dependncias de arquivos. Uma dependncia file ocorre
quando um job ou fluxo de job depende da existncia de um ou mais arquivos
para poder comear a execuo.
379
Sintaxe
{showfiles | sf} [[workstation#]file]
[;state[;...]]
[;keys]
[;offline]
[;state[;...]]
[;deps[;keys | info | logon]]
[;offline]
Argumentos
estao de trabalho
Especifica o nome da estao de trabalho na qual o arquivo existe. O
file
Especifica o nome do arquivo. O nome dever ser colocado entre aspas (")
se contiver caracteres diferentes do seguinte: alfanumricos, traos (-),
barras (/), barras invertidas (\) e sublinhados (_). O padro exibir todas
as dependncias de arquivos. Caracteres curinga so permitidos.
state
Especifica o estado das dependncias de arquivos a serem exibidas. O

padro exibir dependncias de arquivos em todos os estados. Os estados
so os seguintes:
sim
O arquivo existe e est disponvel.
no
O arquivo no est disponvel ou no existe.
A disponibilidade est sendo verificada.
<blank>
O arquivo ainda no foi verificado ou estava disponvel e sendo
utilizado para satisfazer uma dependncia de job ou de fluxo de
job.
keys
Exibe uma nica coluna de lista dos objetos selecionados pelo comando.
deps
Exibe informaes no formato deps. Utilize keys, info ou logon para

modificar a exibio.
off-line
pgina 308.
Resultados
A sada do comando produzida em trs formatos: padro, keys e deps. Os
argumentos keys, info e logon modificam a exibio de deps.
Exemplos
Para exibir o status de uma dependncia de arquivo para d:\apps\mis\lib\data4,
showfiles d:\apps\mis\lib\data4
380
Para exibir o status off-line de todas as dependncias de arquivo em todas as

estaes de trabalho no formato deps, execute o seguinte comando:
sf @#@;deps;off-line
Para exibir o status de todas as dependncias de arquivos em todas as estaes de

trabalho no formato deps, execute o seguinte comando:
sf @#@;deps

Workstation
Job Stream
SchedTime
Job
(Est) (Est)
State Pr Start Elapse
MASTER#/test/^LFILEJOB^ Dependencies are:

MASTER
#LFILEJOB 0600 11/26 ******** READY 10
LFILEJOB
HOLD 10 (11/26)
ReturnCode
Dependencies
^LFILEJOB^
MASTER#/usr/home/me10_99/`/usr/home/me10_99/bin/parms FILE_JS1` Dependencies are:

MASTER
#FILE_JS1 0600 11/26 ******** HOLD 10 (11/26)
parms FILE_JS1`
FILE_JS1 HOLD 10 (11/26)
MASTER#/usr/home/me10_99/`/usr/home/me10_99/bin/parms FILE_JOB1` Dependencies are:
MASTER
#FILE_JOB1 0600 11/26 ******** READY 10
FILE_JB1 HOLD 10 (11/26)
parms FILE_JB1`
Consulte tambm
TrabalhoMonitorDependncias da Carga de TrabalhoArquivos do Monitor
2. Selecione Todos os Arquivos no Plano ou outro nome de tarefa predefinido
clique em OK
Formato Padro
Existe O estado da dependncia de arquivo.
Nome do Arquivo
O nome do arquivo.
Formato Keys
Os arquivos so listados um em cada linha. Os nomes dos diretrios no so
includos. Cada arquivo listado no seguinte formato:
workstation#file
Formato Deps
Os arquivos so listados seguidos dos jobs e fluxos de job dependentes. Os jobs
so listados no formato showjobs. Os fluxos de job so listados no formato
showschedules padro.
Formato Deps;keys
Os jobs e os fluxos de job que possuem dependncias file so listados um em
cada linha, no seguinte formato:
workstation#jstream[.job]
381
Formato Deps;info
so listados no formato showjobs;info. Os fluxos de job so listados no formato
Formato Deps;logon
so listados no formato showjobs;logon. Os fluxos de job so listados no formato
showjobs
Exibe informaes sobre tarefas.
Sintaxe
{showjobs | sj} [jobselect]
[;keys | info | step | logon | crit | keys retcod]
[;short | single]
[;offline]
[;showid]

[;short | single]
[;offline]
[;showid]
[;props]
{showjobs | sj} [jobselect |

[workstation#]jobnumber.hhmm]
[;stdlist[;keys]]
[;short | single]
[;offline]
[;showid]
[;props]
Argumentos
382
crit
Exibe informaes no formato crit.
deps
Exibe informaes no formato deps; ou seja, as tarefas usadoa em

dependncias de sequncias so listadas seguidas pelas tarefas e fluxos de
tarefas dependentes. As tarefas so listadas no formato showjobs bsico. Os
fluxos de tarefas so listados no formato showschedules bsico. Use "keys",
"info" ou "logon" para modificar a exibio de "deps".
hhmm
A hora em que o job foi iniciado. Utilize essa opo junto com os
argumentos stdlist e single, para exibir uma determinada ocorrncia do
job.
info
jobnumber
O nmero do job.
jobselect
keys
logon Exibe informaes no formato logon.

off-line
pgina 308.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
props Exibe as informaes a seguir sobre a instncia da tarefa especificada. Voc

deve ter acesso de exibio s propriedades da instncia da tarefa
especificada que estiver sendo mostrada:
Informaes Gerais
v Tarefa
v Estao de Trabalho
v Tarefa
v Tipo de Tarefa
v Fluxo de Tarefas
v Estao de Trabalho do Fluxo de Tarefas
v Tempo Planejado
v Prioridade
v Efetuar Login
v Monitorado
v Requer Confirmao
v Interactive (Interativo)
v Crtico
Informaes sobre o Tempo de Execuo
v Status
v Status Interno
v Dependncias No Satisfeitas
v
v
v
v
v
v
Nmero da Tarefa
Opes para Executar Novamente
Informaes
Promovido
Cdigo de Retorno
Expresso de Mapeamento de Cdigo de Retorno
Informaes de Tempo
v Incio Real
v Incio Mais Antecipado
v Ao de Incio mais Recente
383
|
|
|
|
|
v
v
v
v
v
ltimo Incio Crtico

Prazo final
Repetir Intervalo
Durao Real
Durao Estimada
|
|
|
|
Informaes de Recuperao
v Aes
v Mensagem
v Definio da Tarefa
v Estao de Trabalho
Extra Information
Esta seo mostra propriedades adicionais especficas para tarefas
sombra e tarefas definidas por JSDL. Para tarefas sombra, contm
as seguintes informaes:
|
|
|
|
Para tarefas sombra distribudas:

v Horrio Plaejado da Tarefa Remota
v Tarefa Remota
v Fluxo de Tarefas Remoto
|
|
|
|
v Estao de Trabalho do Fluxo de Tarefas Remoto
Para tarefas sombra do z/OS:

v Horrio Plaejado da Tarefa Remota
|
|
v Tarefa Remota
v Estao de Trabalho de Tarefa Remota
v Cdigo de Erro da Tarefa Remota
|
|
|
|
|
|
Para obter informaes adicionais, consulte a Como o Status da

Tarefa Sombra Muda aps a Conexo Ser Estabelecida na pgina
579.
|
|
Nota: Informaes sobre tarefas arquivadas no podem ser

recuperadas usando a opo props.
retcod Exibe o cdigo de retorno do job. Esse argumento deve ser utilizado em
conjunto com o argumento keys, por exemplo:
%sj @; keys retcod
short
Reduz a exibio dos jobs every e de rerun para incluir apenas o seguinte:
v A primeira iterao
v Jobs em estados diferentes
v Jobs exatamente correspondidos
Nota: Esse campo mostra as propriedades especficas se a tarefa for uma
tarefa sombra ou uma tarefa definida por JSDL.
showid
Exibe para cada fluxo de tarefa o identificador do fluxo de tarefa.
nico
Seleciona apenas o job pai em uma cadeia que pode incluir jobs de
reexecuo, de repetio e de recuperao. O job deve ser identificado pelo
nmero de job em jobselect. Isso til com a opo stdlist.
stdlist Exibe informaes no formato stdlist. Utilize o argumento keys para

modificar a exibio.
384
Nota: Informaes sobre tarefas arquivadas no podem ser recuperadas

usando a opo stdlist.
step
Exibe informaes no formato step.
estao de trabalho
O nome da estao de trabalho em que a tarefa executada. Caracteres
Resultados
A sada do comando showjobs produzida em oito formatos: padro, keys, info,
step, logon , deps, crit e stdlist. Os argumentos keys, info, crit e logon modificam
as exibies.
Exemplos
Para exibir o status de todas as tarefas no fluxo de tarefas acctg na estao de
trabalho site3, ser possvel executar o comando showjobs em um destes dois
formatos:
showjobs site3#acctg.@
ou:
showjobs site3#acctg
Para exibir o status da tarefa JBA que pertence ao fluxo de tarefas TEST1_DOCOM na
estao de trabalho CPUA, na qual est executando conman, e solicitar a exibio do
identificador do fluxo de tarefas para o fluxo de tarefas, execute o seguinte
comando:
sj CPUA#TEST1(0900 02/19/06).JBA
Uma sada de amostra para este comando a seguinte:

Workstation
CPUA
Job Stream
#TEST1
SchedTime
Job
State Pr Start
Elapse
0900 02/19 *** HOLD

0(02/19)
JBA HOLD 66(14:30)
ReturnCode
Dependencies
{02/20/06}; -TESTJ2(0600 02/24/06).JB1
A dependncia at mostrada como (14:30) na coluna Iniciar e a dependncia

follows a partir da tarefa J2(0600 02/24/06).JB1 para a tarefa JOBA mostrada na
coluna Dependncias.
Na coluna Dependncias, a data colocada entre colchetes, {02/20/06}, indica que a
instncia do fluxo de tarefas foi transportado adiante e a data indica o dia quando
a instncia do fluxo de tarefas foi includo no plano de produo pela primeira
vez.
Para exibir o status das tarefas que pertencem ao fluxo de tarefas JSDOC na estao
de trabalho site3, na qual est executando conman, e solicitar a exibio do
identificador do fluxo de tarefas para o fluxo de tarefas, execute o seguinte
comando:
%sj JSDOC.@;showid

Workstation
Job Stream
SchedTime
Job
State Pr Start
site3
#JSDOCOM 0600 11/26 *** SUCC 10 11/26 00:01

JDOC SUCC 10 11/26 00:01
Elapse
0
ReturnCode
Dependencies
{0AAAAAAAAAAAACRZ}
#J25565
385
O identificador do fluxo de tarefas 0AAAAAAAAAAAACRZ para o fluxo de tarefas

JDOCOM mostrado na coluna Dependncias.
Nota: A hora ou data exibida na coluna Incio convertida para o fuso horrio
configurado na estao de trabalho onde o fluxo de tarefa deve ser
executado.
Para exibir o status das tarefas pertencentes ao fluxo de tarefas JSDOCOM na estao
de trabalho site3 e pedir para mostrar as informaes sobre o ID do usurio sob o
qual a tarefa executada, execute o seguinte comando:
sj site3#JSDOCOM.@;logon

Workstation Job Stream
SchedTime Job
site3
#JSDOCOM 0600 11/26
JDOCOM SUCC
State
Job#
#J25565 me10_99
Logon
ReturnCode
Para exibir o status de todos os jobs no estado HOLD em todas as estaes de

trabalho no formato deps, execute o seguinte comando:
sj @#@.@+state=hold;deps
uma sada de amostra a seguinte:

Workstation Job Stream SchedTime Job
State Pr Start Elapse RetCode Dependencies
CPUA#JS2.JOBB Dependencies are:

CPUA
#JS21
0900 02/19 ***** HOLD
0(02/19)
{02/20/06}; -TESTJS22(0600 02/24/06).JOBB
CPUA#JS25.JOBC Dependencies are:

CPUA
#JS25
0600 02/24 ***** HOLD 10(02/24)

jobaa HOLD 10(02/24)(00:01)
{02/20/06}
TEST1; JOBC
JS18(0600 02/24/06).@
CPUA#JS25.JOB1 Dependencies are:

CPUA
#JS25
0600 02/24 ***** HOLD 10(02/24)

JOBC HOLD 10(02/24)(00:01)
jobaa HOLD 10(02/24)(00:01)
{02/20/06}
JOB1
TEST1; JOBC
JS18(0600 02/24/06).@
Para exibir o registro dos arquivos de lista padro para a tarefa J25 no fluxo de
tarefas JS25(0600 02/19/06) na estao de trabalho CPUA, em execuo em um
ambiente UNIX, execute o seguinte comando:
sj CPUA#JS25(0600 02/19/06).J25;stdlist
A sada a seguinte:
===============================================================
= JOB
: CPUA#JS25[(0600 02/19/06),(0AAAAAAAAAAAABQM)].J25
= USER
: tme10_99
= JCLFILE
: ls
= Job Number: 28630
= Mon 02/20/06 07:57:37 PST
===============================================================
Tivoli Workload Scheduler (UNIX)/JOBMANRC
AWSBIS307I Starting /usr/home/tme10_99/jobmanrc ls
386
JOBA
HOLD 66(14:30)
Tivoli Workload Scheduler (UNIX)/JOBINFO 8.4 (9.5)

Installed for user "tme10_99".
...
... <stdout, stderr, and echoed commands>
...
AWSBIS308I End of job
===============================================================
= Exit Status : 0
= System Time (Seconds) : 0 Elapsed Time (Minutes) : 0
= User Time (Seconds) : 0
= Mon 02/20/06 07:57:38 PST
===============================================================
onde:
Exit Status
o status do job ao ser concludo.
Tempo Decorrido
o tempo decorrido para o job.
System Time
o tempo que o sistema kernel gastou para a tarefa.
User Time
o tempo que o usurio do sistema gastou para a tarefa.
Nota: Os campos System Time e User Time sero utilizados somente no UNIX.
Seus valores no Windows so sempre definidos como 0. Isso porque, no
Windows, o processo joblnch.exe executado em um tempo muito curto,
que pode ser considerado nulo.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Para exibir as propriedades da tarefa sombra com o nmero de tarefa 546863237,

execute o comando a seguir:
sj 546863237;props

Informaes Gerais
Job = D_SHADOW_JOB
Workstation = REMENG1
Task =
<jsdl:jobDefinition
xmlns:dshadow="http://www.ibm.com/xmlns/prod/scheduling/1.0/dshadow"
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/scheduling/1.0/dshadow">
<dshadow:JobStream>JS1</dshadow:JobStream>
<dshadow:Workstation>MYWKST</dshadow:Workstation>
<dshadow:Job>JOBDEF1</dshadow:Job>
<dshadow:matching>
<dshadow:previous/>
</dshadow:matching>
</jsdl:application>
Task Type = distributedShadowJob
Job Stream = JSDIST
Job Stream Workstation = MYWKST
Scheduled Time = 2010/08/11 06:00 TZ CEST
Priority = 10
Login =
387
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Monitored = No
Requires Confirmation = No
Interactive = No
Critical = No
Informaes sobre o Tempo de Execuo
Status = Undecided
Internal Status = DONE
Not Satisfied Dependencies = 0
Job Number = 546863237
Rerun Options =
Information =
Promoted = No
Return Code =
Return Code Mapping Expression =
Informaes de Tempo
Actual Start = 2010/08/11 12:00 TZ CEST
Earliest Start =
Latest Start Action =
Critical Latest Start =
Deadline =
Repeat Range =
Actual Duration =
Estimated Duration = 00:02 (hh:mm)
Informaes de Recuperao
Action =
Mensagem =
Job Definition =
Workstation =
Extra Information
Remote Job Scheduled Time = 08/11/2010 06:00 TZ CEST
Remote Job = JOBDEF1
Remote Job Stream = JS1
Remote Job Stream Workstation = MYWKST
O exemplo a seguir exibe o status do job dbseload com um cdigo de retorno de 7

e um estado de SUCCESSFUL:
$ conman sj workstation#DAILY_DB_LOAD
Tivoli Workload Scheduler (UNIX)/CONMAN 8.4 (1.36.2.22) Materiais Licenciados Propriedade da IBM(R)
5698-WSH
(C) Copyright IBM Corp 1998, 2007 Todos os Direitos Reservados.
Direitos Restritos para Usurios do Governo dos Estados Unidos
Uso, duplicao e divulgao restritos pelo documento
GSA ADP Schedule Contract com a IBM Corp.
IBM uma marca registrada da International Business Machines
Corporation nos Estados Unidos e/ou em outros pases.
Planejado para (Exp) 20/02/06 (#35) em CPUA.
Batchman LIVES. Limit:50,Fence:0,Audit Level:0
Batchman ATIVO. Limit:50,Fence:0,Audit Level:0
sj workstation#DAILY_DB_LOAD
(Est) (Est)
CPU Schedule Job State Pr Start
Cdigo de Retorno de Dependncias Decorridas
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
388
00:01 #J18704
DBSELOAD SUCC
00:01 #J18706
DATAREPT SUCC
00:01 #J18712
DATARTRN SUCC
00:01 #J18714
$
0
10 22:13
7
10 22:13
0
10 22:14
0
O exemplo a seguir exibe o cdigo de retorno para um job especfico chamado

workstation#daily_db_load.dbseload:
$ conman sj workstation#daily_db_load.dbseload\;keys\;retcod
Tivoli Workload Scheduler (UNIX)/CONMAN 8.4 (1.36.2.22) Materiais Licenciados Propriedade da IBM(R)
5698-WSH
(C) Copyright IBM Corp 1998, 2007 Todos os Direitos Reservados.
Planejado para (Exp) 20/02/06 (#35) em CPUA.
Batchman LIVES. Limit:50,Fence:0,Audit Level:0
Batchman ATIVO. Limit:50,Fence:0,Audit Level:0
sj workstation#daily_db_load.dbseload;keys;retcod 8
$
O recurso retcod quando integrado a um script pode tornar-se bem eficaz.
Consulte tambm
Monitor
clique em OK
Formato Padro
CPU
A estao de trabalho em que o job executado.
Planejamento
O nome do fluxo de tarefa.
SchedTime
A hora e data em que a tarefa foi planejada para execuo.
Tarefa O nome da tarefa. A seguinte notao pode preceder um nome de job:
>> rerun as
Um job que foi reexecutado com o comando rerun, ou como
resultado de recuperao automtica.
>> rerun step
Um job que foi reexecutado com o comando rerun ;step.
>> every run
A segunda e subseqentes execues de um job every.
389
>>recovery
A execuo de um job de recuperao.
Estado
O estado do job ou fluxo de job. Os estados do job so os seguintes:
ABEND
O job terminou com um cdigo de sada diferente de zero.
ABENP
Uma confirmao de abend foi recebida, mas o job no est
concludo.
ADD
A tarefa est sendo submetida.
DONE
O job foi concludo em um estado desconhecido.
ERROR
Para dependncias entre redes apenas, ocorreu um erro durante a
verificao do status remoto.
EXEC A tarefa est em execuo.
EXTRN
Somente para dependncias de interligao de redes, o status
desconhecido. Ocorreu um erro, uma ao reexecutar acabou de ser
realizada na tarefa do fluxo de tarefas EXTERNAL ou a tarefa ou o
fluxo de tarefas remoto no existe.
FAIL
Impossvel lanar a tarefa.
FENCE
A prioridade do job est abaixo da cerca.
HOLD
A tarefa est aguardando a resoluo da dependncia.
INTRO
O job apresentado para ser lanado pelo sistema.
PEND A tarefa foi concluda e est aguardando confirmao.
READY
A tarefa est pronta para ser lanada e todas as dependncias
foram resolvidas.
SCHED
A hora at definida para o job no foi alcanada.
SUCC A tarefa foi concluda com um cdigo de sada zero.
SUCCP
Uma confirmao SUCC foi recebida, mas a tarefa no foi
concluda.
WAIT A tarefa est no estado WAIT (agente estendido).
Os estados dos fluxos de job so os seguintes:
ABEND
O fluxo de job terminou com um cdigo de sada diferente de zero.
ADD
O fluxo de tarefas foi adicionado com interveno do operador.
CANCL
O fluxo de tarefas foi cancelado.
390
CANCELP
O cancelamento do fluxo de tarefas est pendente. O cancelamento
ser adiado at que todas as dependncias, incluindo uma hora at,
sejam resolvidas.
ERROR
EXTRN
Apenas para dependncias da interligao de redes, o fluxo de
tarefas est em uma rede remota do Tivoli Workload Scheduler e
seu estado desconhecido. Ocorreu um erro, uma ao de
reexecuo acaba de ser realizada no fluxo de tarefas EXTERNAL ou a
tarefa ou o fluxo de tarefas INET no existe.
HOLD
O fluxo de tarefa est aguardando a resoluo de dependncias.
READY
O fluxo de job est pronto para ser lanado e todas as
STUCK
A execuo do fluxo de job foi interrompida. Nenhum job ser
lanado sem a interveno do operador.
Pr
A prioridade do fluxo de job ou job. Um sinal de mais (+) antes da

prioridade significa que o job foi lanado.
(Est)Start
A hora de incio do fluxo de job ou job. Parnteses indicam uma estimativa
da hora de incio. Se o comando for executado no mesmo dia em que a
tarefa for planejada para execuo, o parmetro Start exibe um horrio
como (Est)Start. Se o comando for executado em um dia diferente do dia
em que a tarefa for planejada para execuo, o parmetro Start exibe uma
data como (Est)Start. Por exemplo, se voc tiver a tarefa a seguir cujo
horrio de incio ocorre no mesmo dia em que a tarefa est planejada para
execuo:
SCHEDULE MASTERB1#JS_B
AT 1700
:
MASTERB1#JOB1
AT 1800
END
Voc recebe a seguinte sada:

%sj @#@
(Est) (Est)
CPU
Schedule SchedTime Job
State Pr Start Elapse RetCode Deps
MASTERB1#JS_B
1700 08/18 ***** HOLD 10(17:00)
JOB1 HOLD 10(18:00)
Por exemplo, se voc tiver a tarefa a seguir cujo horrio de incio ocorre
em um dia diferente do dia em que a tarefa est planejada para execuo:
391
SCHEDULE MASTERB1#JS_A
AT 0400
:
MASTERB1#JOB_A
AT 0500
END

%sj @#@
(Est) (Est)
CPU
MASTERB1#JS_A
0400 08/19 ***** HOLD 10(08/19)
JOB_A HOLD 10(08/19)
(Est)Elapse
O tempo de execuo do fluxo de job ou job. Parnteses indicam uma
estimativa com base em estatsticas registradas.
dependncias
Uma lista de dependncias de job e comentrios. Qualquer combinao das
seguintes pode ser listada:
v Para uma dependncia follows, exibido um nome de fluxo de job ou
de job.
Se a tarefa ou o fluxo de tarefas for um predecessor pendente, seu nome
ser seguido por um [P].
No caso de uma dependncia rf, um [O] exibido.
Para obter informaes adicionais sobre predecessores pendentes e
dependncias rfs, consulte Gerenciando Dependncias de
Acompanhamentos Externos para Tarefas e Fluxos de Tarefas na pgina
57.
v Para uma dependncia opens, exibido o nome do arquivo. Se o arquivo
residir em um agente estendido e seu nome tiver mais que 25 caracteres,
apenas os ltimos 25 sero exibidos.
v Para uma dependncia needs, exibido um nome de recurso colocado
entre hifens (-). Se o nmero de unidades solicitadas for maior que um,
o nmero ser exibido antes do primeiro hfen.
v Para uma hora deadline, exibida a hora antecedida por um sinal de
menor (<).
v Para uma taxa every, exibida a taxa de repetio antecedida de um e
comercial (&).
v Para uma hora until, exibida a hora antecedida por um sinal de menor
(<).
v Para uma dependncia prompt, o nmero do prompt exibido no
formato #num. Para prompts globais, o nome do prompt segue entre
parnteses.
v Para a execuo de tarefas, o PID (Process Identification Number)
exibido no formato #Jnnnnn.
v As tarefas enviadas no UNIX utilizando os comandos Tivoli Workload
Scheduler at e batch so etiquetadas como [Userjcl].
v Ao relatar as dependncias de hora, o comando showjobs mostra na
coluna Incio:
Somente a hora hh:mm, se o dia de configurao de dependncias de
tempo corresponde ao dia da execuo do comando showjobs.
392
v
v
v
v
v
|
|
Somente a data MM/DD se o dia de configurao das dependncias

de hora no corresponder ao dia de execuo do comando showjobs.
Jobs cancelados so rotulados como [Cancelled].
Jobs cancelados com a opo ;pend so rotulados como [Cancel Pend].
Jobs com horas until expiradas, incluindo jobs cancelados com a opo
;pend so rotulados como [Until].
[Recovery] significa que a operao requer interveno.
[Confirmed] significa que confirmao necessria, pois a foi planejada
usando a palavra-chave confirm.
[Script] aplica-se apenas a redes de ponta a ponta; isso significa que esse
job tem um script centralizado e que o Tivoli Workload Scheduler para
z/OS ainda no o transferiu por download para o agente.
Formato Keys
Os nomes de job so listados um em cada linha no seguinte formato:
workstation#jstream hhmm mm/dd.job
por exemplo:
CPU
Schedule SchedTime
Job
MYCPU+#SCHED_F+ 0600 03/04 ******* HOLD 55(03/04)

(M235062+#)JOBMDM HOLD 30(03/04)
[03/04/06]; #33
#1(PRMT3);-16 JOBSLOTS-
MYCPU+#SCHED_F+ 1010 03/04 ******* HOLD 55(03/04)

(M235062+#)JOBMDM HOLD 30(03/04)
[03/04/06]; #34
Formato Info
CPU
Planejamento
SchedTime
>> rerun as
>> rerun step
Um job que foi reexecutado com o comando rerun ;step.
>> every run
>>recovery
A execuo de um job de recuperao.
Arquivo de Tarefa
O nome do script ou do arquivo executvel do job. Nomes longos de
arquivos podem causar reincio cclico, causando paginao incorreta. Para
evitar isso, direcione a sada para more.
Opt
A opo de recuperao do job, se houver. As opes de recuperao so

RE para reexecuo, CO para continuar e ST para parar.
Tarefa O nome do job de recuperao, se houver.

393
Aviso
O nmero do prompt de recuperao, se houver.
Por exemplo:
conman "sj;info | more
produz uma sada de amostra como a seguinte:

--------Restart--------CPU
M235062+#SCHED_22 1010 03/06
JOBMDM
(B236153+#)JOB_FTA
M235062+#SCHED_22 0600 03/07
JOBMDM
(B236153+#)JOB_FTA
M235062+#FINAL
0559 03/07
MAKEPLAN
SWITCHP+
CREATEP+
UPDATES+
M235062+#SCHED12 1010 03/06
JOBMDM
(B236153+#)JOB_FTA
JobFile
Opt
Job Prompt
/usr/acct/scripts/gl1
echo job12
echo job12
/home/tws84/MakePlan TWSRCMAP:(RC=0) OR (RC=4)
/home/tws84/SwitchPlan
/home/tws84/CreatePostReports
/home/tws84/UpdateStats
echo job12
Formato Step
Esse formato no suportado no Windows.
CPU
Planejamento
SchedTime
>> rerun as
>> repeated as
Estado
O estado do job ou fluxo de job. Consulte Formato Padro para obter
informaes sobre estado.
Cdigo de retorno
O cdigo de retorno da tarefa.
Job#
O nmero de identificao do processo exibido como #Jnnnnn.
Etapa
Uma lista de processos descendentes associados ao job. Para jobs do agente

estendido, so listados apenas os processos do host.
Formato Logon
CPU
Planejamento
SchedTime
394

>> rerun as
>> repeated as
Estado
Cdigo de retorno
O cdigo de retorno da tarefa.
Job#
O nmero de identificao do processo exibido como #Jnnnnn.
Incio de Sesso
O nome do usurio sob o qual o job executado.
Formato Stdlist
Um arquivo de lista padro criado automaticamente pelo jobmon no Windows
ou no jobman no UNIX, para cada job que o jobmon e o jobman ativar. possvel
exibir o contedo dos arquivos de lista padro utilizando o conman. Um arquivo
de lista padro contm:
v
v
v
v
Banners de cabealho e de encerramento.

Comandos de eco.
A sada stdout do job.
A sada stderr do job.
Para especificar um determinado formato de data a ser utilizado nos arquivos de

lista padro, altere o formato de data do IBM Tivoli Workload Scheduler antes de
criar os arquivos de lista padro. Isso feito modificando-se o formato do cdigo
de idioma da data.
Dependendo do ambiente, altere o formato do cdigo de idioma da data
executando as etapas listadas a seguir:
v No UNIX, defina a varivel LANG no ambiente quando o netman for iniciado.
Se a varivel LANG no for definida, o cdigo de idioma do sistema operacional
ser definido, por padro, como "C".
v No Windows, execute as etapas a seguir:
1. V para Painel de ControleOpes Regionais e defina seu cdigo de idioma
(local.
2. Clique com o boto direito do mouse em "Meu Computador", v para
Propriedades, clique em "Avanado", v para Variveis de Ambiente e defina
a varivel LANG como uma varivel do sistema.
3. Encerre e reinicie o sistema.
So exibidos os arquivos de lista padro dos jobs selecionados.
Formato Stdlist;keys
Os nomes dos arquivos de lista padro dos jobs selecionados so listados, um em
cada linha.
395
Formato Crit
CPU
Planejamento
SchedTime
>> rerun as
>> repeated as
Estado
Pr
A prioridade do fluxo de job ou job. Um sinal de mais (+) antes da

prioridade significa que o job foi lanado.
(Est)Start
da hora de incio. Se a hora de incio ultrapassar 24 horas anteriores ou
posteriores, a data ser listada no lugar da hora.
(Est)Elapse
O tempo de execuo do fluxo de job ou job. Parnteses indicam uma
estimativa com base em estatsticas registradas.
CP
Indica se a tarefa est sinalizada como crtica (C) e/ou promovida (P).
CritStart
A hora mais recente que a tarefa pode ser iniciada sem influenciar nos
prazos finais de sucessores imprescindveis.
Por exemplo, o resultado do seguinte comando genrico:
%sj @#@;crit
:
CPU
Schedule SchedTime
MYCPU_F+#JSA
Job
1600 03/05 ********

JOBA1
JOBA2
JOBA3
JOBA4
(Est) (Est)
HOLD
HOLD
HOLD
HOLD
HOLD
10
10
10
10
10
CP
CP
C
Crit
Start
1759
1758
1757
1659
03/05
03/05
03/05
03/05
Observe que :
v O sinalizador C aplica-se a todas as tarefas definidas como crticas na definio
de fluxo de tarefas. configurado no plano ou horrio de submit.
v O sinalizador P aplica-se a tarefas crticas e a seus predecessores (que so tarefas
que no so definidas como crticas, mas que no devem impactar na concluso
em tempo hbil de uma tarefa crtica do sucessor). Ele configurado em tempo
de execuo se a tarefa foi promovida.
396
v Tanto as tarefas crticas quanto os predecessores crticos tm um horrio de

incio crtico.
O planejador calcula o horrio de incio crtico de uma tarefa crtica subtraindo
sua durao estimada do respectivo prazo final. O planejador calcula o horrio
de incio crtico de um predecessor crtico subtraindo sua durao estimada do
horrio de incio crtico de seu prximo sucessor. Em uma rede crtica, o
planejador calcula o horrio de incio crtico da tarefa crtica primeiro e, em
seguida, trabalha de modo inverso ao longo da cadeia de predecessores. Esses
clculos so reiterados quantas vezes forem necessrias at a execuo da tarefa
crtica.
Formato Deps
Jobs utilizados em dependncias follows so listados, seguidos pelos jobs e fluxos
de job dependentes. Os jobs so listados no formato showjobs. Os fluxos de job
so listados no formato showschedules padro.
Formato Deps;keys
Os jobs e fluxos de job que possuem dependncias follows so listados, um em
cada linha.
Formato Deps;info
Os jobs utilizados em dependncias follows so listados, seguidos pelos jobs e
fluxos de job dependentes. Os jobs so listados no formato showjobs;info. Os
fluxos de job so listados no formato showschedules padro.
Formato Deps;logon
Os jobs utilizados em dependncias follows so listados, seguidos pelos jobs e
fluxos de job dependentes. Os jobs so listados no formato showjobs;logon. Os
showprompts
Exibe informaes sobre prompts.
Sintaxe
{showprompts | sp} [promptselect]
[;keys]
[;offline]
[;deps[;keys | info | logon]][;offline]
397
Argumentos
promptselect
[promptname | [workstation#]msgnum][;state[;...]]
promptname
permitidos.
estao de trabalho
Especifica o nome da estao de trabalho na qual um prompt
no-nomeado foi emitido. O padro a estao de trabalho na qual
o conman est sendo executado.
msgnum
Especifica o nmero de mensagem de um prompt no-nomeado.
state
Especifica o estado dos prompts a serem exibidas. Os estados so

os seguintes:
SIM
O prompt recebeu a resposta y.
NO
O prompt recebeu a resposta n.
PERGUNTADO
O prompt foi emitido, mas no recebeu resposta.
INACT
O prompt no foi emitido.
keys
deps

modificar a exibio.
info

off-line
pgina 308.
Nota: Nmeros de prompt designados para prompts globais e locais so alterados
quando o plano de produo estendido.
Resultados
Exemplos
Para exibir o status de todos os prompts emitidos na estao de trabalho na qual o
conman est sendo executado, execute o seguinte comando:
showprompts
segue uma amostra:

State
ASKED
INACT
Are
398
Message or Prompt
1(PRMT3) !continue?
3(CPUA#SCHED_12[(0600 03/12/06),(0AAAAAAAAAAAABST)])
you ready to process job1?
INACT 3(CPUA#SCHED_12[(0600 03/12/06),(0AAAAAAAAAAAABST)])

Are you ready to process job1?
INACT 5(CPUA#SCHED_12[(1010 03/12/06),(0AAAAAAAAAAAABSU)])
INACT 7(CPUA#SCHED_22[(0600 03/12/06),(0AAAAAAAAAAAABTR)])
Para exibir o status de todos os mis prompts emitidos no formato deps, execute o
seguinte comando:
sp mis@;asked;deps
Para exibir o status do prompt nmero 7 na estao de trabalho CPUA, execute o

seguinte comando:
sp CPUA#7
A sada do comando :
INACT 7(CPUA#SCHED_22[(0600 03/12/06),(0AAAAAAAAAAAABTR)])
Consulte tambm
TrabalhoMonitorDependncias da Carga de TrabalhoPrompts do Monitor
2. Selecione Todos os Prompts no Plano ou outro nome de tarefa predefinido
clique em OK
Formato Padro
Estado
O estado do prompt.
Mensagem ou Prompt
Para prompts nomeados, o nmero da mensagem, o nome e o texto do
prompt. Para prompts no-nomeados, o nmero da mensagem, o nome do
job ou fluxo de job e o texto do prompt.
Formato Keys
Os prompts so listados um em cada linha. Prompts nomeados so listados com
seus nomes e nmeros de mensagens. Prompts no-nomeados so listados com
seus nmeros de mensagens e os nomes dos jobs ou fluxos de job nos quais
aparecem como dependncias.
Formato Deps
Os prompts utilizados como dependncias so listados, seguidos pelos jobs e
fluxos de job dependentes. Os jobs so listados no formato showjobs. Os fluxos de
job so listados no formato showschedules padro.
399
Formato Deps;keys
Os jobs e os fluxos de job que possuem dependncias prompt so listados um em
cada linha.
Formato Deps;info
Formato Deps;logon
showresources
Exibe informaes sobre recursos.
Sintaxe
{showresources | sr} [[workstation#]resourcename]
[;keys]
[;offline]
[;offline]
Argumentos
estao de trabalho
Especifica o nome da estao de trabalho na qual o recurso foi definido. O
resourcename
keys
deps

modificar a exibio.
info
400
off-line
pgina 308.
Resultados
Exemplos
Para exibir informaes sobre todos os recursos na estao de trabalho na qual o
conman est sendo executado, execute o seguinte comando:
showresources
Uma sada de amostra :

CPU#Resource
CPUA #JOBSLOTS
Total Available
16
16
Qty UsedBy
No holders of this resource
Para exibir informaes sobre o recurso jobslots na estao de trabalho CPUA no

formato deps, execute o seguinte comando:
sr CPUA#JOBSLOTS;deps

Workstation Job Stream SchedTime Job
CPUA
(Est) (Est)
State Pr Start Elapse RetCode Dependencies
#JOBSLOTS Dependencies are:
FTAA
#SCHED_F+ 0600 03/04 ****** HOLD 55(03/04)

(CPUA#)JOBMDM HOLD 30(03/04)
[03/04/06];#33
FTAA
#SCHED_F+ 1010 03/04 ****** HOLD 55(03/04)

[03/04/06];#34
FTAA
#SCHED_F+ 0600 03/05 ****** HOLD 55(03/05)

[03/04/06];#35
Consulte tambm
TrabalhoMonitorDependncias da Carga de TrabalhoRecursos do Monitor
2. Selecione Todos os Recursos no Plano ou outro nome de tarefa predefinido
clique em OK
Formato Padro
CPU
A estao de trabalho na qual o recurso foi definido.
Recurso
O nome do recurso.
Total
O nmero total de unidades de recurso definidas.
401
Disponvel
O nmero de unidades de recurso que no foram alocadas.
Qty
O nmero de unidades de recurso alocadas a um job ou fluxo de job.
Used By
O nome do job ou fluxo de job.
Formato Keys
Os recursos so listados um em cada linha.
Formato Deps
Os recursos utilizados como dependncias so listados, seguidos pelos jobs e fluxos
de job dependentes. Os jobs so listados no formato showjobs. Os fluxos de job
so listados no formato showschedules padro.
Formato Deps;keys
Os jobs e os fluxos de job que possuem dependncias resource so listados um em
cada linha.
Formato Deps;info
de job dependentes. Os jobs so listados no formato showjobs;info. Os fluxos de
Formato Deps;logon
de job dependentes. Os jobs so listados no formato showjobs;logon. Os fluxos de
showschedules
Exibe informaes sobre fluxos de tarefas.
Sintaxe
{showscheds | ss} [jstreamselect]
[;keys]
[;offline]
[;showid]
402

[;offline]
[;showid]
Argumentos
jstreamselect
keys
deps
Exibe informaes no formato deps; ou seja, os fluxos de tarefas usados em

dependncias de sequncias so listados seguidos pelas tarefas e fluxos de
tarefas dependentes. As tarefas so listadas no formato showjobs bsico. Os
fluxos de tarefas so listados no formato showschedules bsico. Use "keys",
"info" ou "logon" para modificar a exibio de "deps".
info

off-line
pgina 308.
showid
Exibe para cada fluxo de tarefa o identificador do fluxo de tarefa.
Resultados
argumentos keys, info e logon modificam a exibio de deps. A lista exibida na
sada do comando no inclui tarefas que foram executadas novamente nos
processos de planejamento anteriores, mas o total mostrado no final inclui.
Exemplos
Para exibir o status do fluxo de tarefa CLEM_DOCOM na estao de trabalho site3 e
solicitar o identificador do fluxo de tarefa, execute o seguinte comando:
%ss @#JS_DOCOM ;showid
Uma sada de amostra desse comando a seguinte:

(Est) (Est)
Jobs
Sch
SchedTime
# OK Lim
site3
#JS_DOCOM 0600 11/26 SUCC 10 11/26 00:01 1
1
{0AAAAAAAAAAAACRZ}
Para exibir o status de todos os fluxos de job no estado HOLD na estao de

trabalho na qual o conman est sendo executado, execute o seguinte comando:
showschedules @+state=hold

(Est) (Est)
SchedTime
State Pr Start
site3
#FILE_JS1
0600 11/26 HOLD 10 (11/26)
Jobs
Sch
Elapse
# OK Lim
1
0
parms FILE_JS1`
Para exibir o status de todos os fluxos de tarefas com o nome iniciado por sched
na estao de trabalho CPUA no formato deps;info, execute o seguinte comando:
403
ss CPUA#sched@;deps;info

--------Restart--------CPU
Schedule SchedTime
Job
JobFile
Opt
Job Prompt
CPUA #JS_FIRST1[(0600 03/10/06),(0AAAAAAAAAAAABVY)] Dependencies are:

CPUA#MOD 0212 03/10
JOBMDM /usr/scripts/gl1(B236153+#)JOB_FTA1 echo Start gl1?
CPUA#MOD 0251 03/10
JOBMDM /usr/scripts/gl2(B236153+#)JOB_FTA2 echo Start gl2?
Para exibir o status off-line de todos os fluxos de job no estado ABEND em todas
as estaes de trabalho, execute o seguinte comando:
ss @#@+state=abend;off
Para exibir o status de todos os fluxos de job em todas as estaes de trabalho,

%ss @#@
Esta uma sada de amostra para o comando:

Workstation
site3
site3
site2
site3
site3
site1
site3
site3
Job Stream
#JS_DOCOM
#JS_SCRIPT
#JS_PRED1
#JS_SCRIPT1
#LFILEJOB
#RES_100
#FILE_JS1
#FILE_JOB
0600
0600
1000
0600
0600
0600
SchedTime
11/26 SUCC
11/26 SUCC
11/26 SUCC
11/26 ABEND
0600 11/26
0600 11/26
11/26 HOLD
11/26 SUCC
(Est) (Est)
Jobs
Sch
# OK Lim
10 11/26 00:01
1
1
10 11/26 00:03
1
1
10 11/26 00:01
1
1
10 11/26 00:01
1
0
READY 10
1
0
SUCC 10 11/26 00:09
1
1
10 (11/26)
1
0
parms FILE_JS1`
10 11/26 00:01
1
1
Consulte tambm
Tarefa do Monitor
predefinido
clique em OK
Formato Padro
CPU
A estao de trabalho na qual o fluxo de job executado.
Planejamento
SchedTime
A hora e data em que o fluxo de tarefas foi planejado para execuo.
Estado
O estado do fluxo de job. Os estados so os seguintes:
ADD
O fluxo de tarefas foi adicionado com interveno do operador.
ABEND
O fluxo de job terminou com um cdigo de sada diferente de zero.
404
CANCL
O fluxo de tarefas foi cancelado.
CANCELP
O cancelamento do fluxo de tarefas est pendente. O cancelamento
ser adiado at que todas as dependncias, incluindo uma hora at,
sejam resolvidas.
ERROR
EXTRN
Apenas para dependncias da interligao de redes, o fluxo de
tarefas est em uma rede remota do Tivoli Workload Scheduler e
seu status desconhecido. Ocorreu um erro, uma ao de
reexecuo acaba de ser realizada no fluxo de tarefas EXTERNAL ou a
tarefa ou o fluxo de tarefas INET no existe.
HOLD
O fluxo de tarefa est aguardando a resoluo da dependncia.
READY
O fluxo de job est pronto para ser lanado e todas as
STUCK
A execuo do fluxo de job foi interrompida. Nenhum job ser
lanado sem a interveno do operador.
Pr
A prioridade do fluxo de job.
(Est)Start
da hora de incio. Se o comando for executado no mesmo dia em que o
fluxo de tarefas for planejado para execuo, o parmetro Start exibe um
horrio como (Est)Start. Se o comando for executado em um dia diferente
do dia em que o fluxo de tarefas for planejado para execuo, o parmetro
Start exibe uma data como (Est)Start. Por exemplo, se voc tiver o fluxo de
tarefas a seguir cujo horrio de incio ocorre no mesmo dia em que o fluxo
de tarefas est planejado para execuo:
SCHEDULE MASTERB1#JS_B
AT 1800
:
MASTERB1#JOB1
END

%ss @#@
(Est) (Est)
CPU
Schedule SchedTime State Pr Start Elapse
MASTERB1#JS_B
1800 08/18 HOLD 10(18:00)
Jobs
Sch
# OK Lim
1
0
Por exemplo, se voc tiver o fluxo de tarefas a seguir cujo horrio de incio
ocorre em um dia diferente do dia em que o fluxo de tarefas est planejado
para execuo:
405
SCHEDULE MASTERB1#JS_A
AT 0500
:
MASTERB1#JOB1
END

%ss @#@
(Est) (Est)
Jobs
Sch
CPU
Schedule SchedTime State Pr Start Elapse
# OK Lim
MASTERB1#JS_A
0500 08/19 HOLD 10(08/19)
1
0
(Est)Elapse
O tempo de execuo do fluxo de job. Parnteses indicam uma estimativa
com base em estatsticas registradas.
Jobs # O nmero de jobs do fluxo de job.
Jobs OK
O nmero de jobs que foram concludos com xito.
Sch Lim
O limite de job do fluxo de job. Se no houver um listado, o limite no
estar em vigor.
dependncias
Uma lista de dependncias de fluxo de job e comentrios. Qualquer
combinao das seguintes pode ser listada:
v Para uma dependncia follows, exibido um nome de fluxo de job ou
de job. Se a tarefa ou o fluxo de tarefas for um predecessor pendente,
seu nome ser seguido por um [P].
v Para uma dependncia opens, exibido o nome do arquivo. Se o arquivo
residir em um agente estendido e seu nome tiver mais que 25 caracteres,
apenas os ltimos 25 sero exibidos.
v Para uma dependncia needs, exibido um nome de recurso colocado
entre hifens (-). Se o nmero de unidades solicitadas for maior que um,
o nmero ser exibido antes do primeiro hfen.
v Para uma hora until, a hora antecedida por um sinal de menor (<).
v Para uma dependncia prompt, o nmero do prompt exibido como #num.
Para prompts globais, o nome do prompt segue entre parnteses.
v Fluxos de job cancelados so rotulados como [Cancelled].
v Fluxos de job cancelados com a opo ;pend so rotulados como [Cancel
Pend].
v Para uma hora deadline, exibida a hora antecedida por um sinal de
menor (<).
v Fluxos de job que contm a palavra-chave carryforward so rotulados
como [Carry].
v Para fluxos de tarefas que foram transportados do plano de produo
anterior, o nome e data originais so exibidos entre colchetes.
v Ao relatar as dependncias de hora, o comando showschedules mostra
na coluna Incio:
Somente a hora hh:mm, se o dia de configurao de dependncias de
tempo corresponde ao dia da execuo do comando showschedules.
406
Somente a data mm/dd se o dia de configurao das dependncias de

hora no corresponder ao dia de execuo do comando
showschedules.
Nota: A hora ou data exibida na coluna Incio convertida para o fuso
horrio configurado na estao de trabalho onde o fluxo de tarefa
deve ser executado.
Formato Keys
Os fluxos de job so listados um em cada linha.
Formato Deps
Os fluxos de job utilizados como dependncias so listados, seguidos pelos jobs e
fluxos de job dependentes. Os jobs so listados no formato showjobs. Os fluxos de
Formato Deps;keys
Os fluxos de job que possuem dependncias follows so listados, um em cada
linha.
Formato Deps;info
Formato Deps;logon
shutdown
Para de forma incondicional todos os processos e servios de produo do Tivoli
Workload Scheduler, inclusive batchman, jobman, netman, mailman, appservman,
todos os servidores mailman e todos os processos writer.
|
|
|
|
Apesar de esse comando parar o servio appservman, ele no para os servios do

WebSphere Application Server. Para parar os servios do WebSphere Application
Server, execute o comando stopappserver. Para obter informaes adicionais,
consulte a stopappserver na pgina 416.
|
|
Nas estaes de trabalho do Windows, o comando shutdown no para o servio

tokensrv.
|
|
Nota: Esse comando no suportado em estaes de trabalho de mecanismo

remoto.
Voc deve ter acesso shutdown estao de trabalho.
Sintaxe
{shutdown | shut} [;wait]
407
Argumentos
wait
Aguarda at que todos os processos tenham parado antes de solicitar outro

comando.
Comentrios
O comando shutdown pra os processos somente na estao de trabalho em que o
conman est sendo executado. Para reiniciar apenas o netman, execute o comando
StartUp. Para obter informaes sobre o comando StartUp, consulte StartUp na
pgina 474. Para reiniciar a rvore do processo inteira, execute os seguintes
comandos conman:
incio
startappserver
startmon
Voc deve executar um comando unlink @ do conman antes de executar um

comando shutdown.
Exemplos
Para encerrar a produo na estao de trabalho na qual o conman est sendo
unlink @
shutdown
Para encerrar a produo na estao de trabalho na qual o conman est sendo

executado e aguardar a parada de todos os processos, execute o seguinte comando:
unlink@;noask
shut ;wait
start
Inicia os processos de produo do Tivoli Workload Scheduler, exceto o mecanismo
de monitoramento de eventos e o WebSphere Application Server (consulte
startappserver na pgina 410 e startmon na pgina 412 para aprender sobre os
comandos que iniciam esses processos).
Nota: Certifique-se de que conman start no seja emitido enquanto JnextPlan ou
stageman for executado.
Voc deve ter acesso start para a estao de trabalho.
Sintaxe
start [domain!]workstation
[;mgr]
[;noask]
[;demgr]
Argumentos
domnio
Especifica o nome do domnio no qual as estaes de trabalho foram
iniciadas. Caracteres curinga so permitidos.
408
Este argumento til quando se est iniciando mais de uma estao de

trabalho em um domnio. Por exemplo, para iniciar todos os agentes no
start stlouis!@
Se domain for omitido e workstation contiver caracteres curinga, o domnio

padro ser aquele no qual o conman est sendo executado.
estao de trabalho
Especifica o nome da estao de trabalho a ser iniciada. Caracteres curinga
so permitidos.
remoto.
|
|
mgr
Pode ser digitado apenas na estao de trabalho na qual o conman est

sendo executado. Ele inicia a estao de trabalho local como o gerenciador
de domnio. A estao de trabalho torna-se o novo gerenciador de domnio
e o gerenciador de domnio atual torna-se um agente tolerante a falhas.
Essa forma do comando segue, geralmente, um comando stop.
Nota: O mtodo preferido de se comutar um gerenciador de domnio
utilizar um comando switchmgr. Consulte switchmgr na pgina
434 para obter informaes adicionais.

demgr A opo evita a abertura de conexes externas durante o tempo de
transio quando o agente iniciado como um gerenciador de domnio
antigo e quando o comando switchmgr executado, impedindo a funo
do agente do gerenciador de domnio. Essa opo executada
automaticamente, mas at que o gerenciador de domnio antigo tenha
processado o evento switchmgr (no caso, por exemplo, do reincio
retardado ou do reincio aps o reparo de um agente danificado), a opo
demgr dever ser utilizada para iniciar o gerenciador de domnio antigo a
partir da linha de comandos local. Para obter mais detalhes sobre esta
opo, consulte o Guia de Administrao do Tivoli Workload Scheduler.
Comentrios
O comando start utilizado no incio de cada perodo de produo para reiniciar o
Tivoli Workload Scheduler depois do processamento de pr-produo. Nessa hora,
faz com que os agente tolerante a falhas e os agentes padro vinculados
automaticamente sejam inicializados e iniciados automaticamente. Os agentes que
no so vinculados automaticamente so inicializados e iniciados quando voc
executa um comando link.
Supondo-se que um usurio tenha acesso start a estaes de trabalho sendo
iniciadas, as seguintes regras sero aplicadas:
iniciar qualquer estao de trabalho na rede.
principal pode iniciar qualquer estao de trabalho nesse domnio e em
domnios subordinados. O usurio no pode iniciar estaes de trabalho em
domnios ponto a ponto.
v Um usurio executando o conman em um agente pode iniciar estaes de
trabalho hospedadas por esse agente.
409
Exemplos
A Figura 23 e a Tabela 57 abaixo mostram as estaes de trabalho iniciadas pelos
comandos start executados por usurios em vrios locais da rede.
A11
A12
DM1
Domain1
User1
User3
User2
DM2
A21
DM3
A31
A22
A32
Domain3
Domain2
DM4
Domain4
A41
A42
Figura 23. Rede de Exemplo

Tabela 57. Estaes de Trabalho Iniciadas
Comando
start @!@
Iniciado pelo
Usurio1
Todas as estaes
de trabalho so
iniciadas
Iniciado pelo
Usurio2
Iniciado pelo
Usurio3
DM2
A21
A22
DM4
A41
A42
A21
DM2
A21
A22
A21
No permitido
No permitido
start @
DM1
A11
A12
start DOMAIN3!@
DM3
A31
A32
No permitido
start DOMAIN4!@
DM4
A41
A42
DM4
A41
A42
start DM2
DM2
DM2
No permitido
start A42
A42
A42
No permitido
start A31
A31
No permitido
No permitido
startappserver
Inicia o WebSphere Application Server integrado na estao de trabalho.
410
Sintaxe
startappserver[domain!]workstation
[;wait]
Argumentos
domnio
Especifica o nome do domnio da estao de trabalho. Como as estaes de
trabalho possuem nomes exclusivos, o domnio no necessrio ao iniciar
o WebSphere Application Server em uma estao de trabalho especfica.
estao de trabalho
Especifica o nome da estao de trabalho na qual voc deseja iniciar o
mecanismo de monitoramento. Caracteres curinga so permitidos. Se
nenhum domnio e estao de trabalho estiverem especificados, a ao ser
na estao de trabalho local.
wait
Aguarda at que o WebSphere Application Server tenha sido iniciado antes

de solicitar outro comando.
Comentrios
O WebSphere Application Server tambm pode ser iniciado com o comando
utilitrio StartUp.
starteventprocessor
Inicia o servidor de processamento de eventos no gerenciador de domnio
principal, principal de backup ou em uma estao de trabalho instalada como um
principal de backup que funciona como um agente tolerante a falhas simples.
Sintaxe
{starteventprocessor | startevtp} [domain!]workstation
Argumentos
domnio
Especifica o nome do domnio da estao de trabalho.
estao de trabalho
servidor de processamento de eventos. Caracteres curinga no so
permitidos.
Comentrios
possvel omitir o nome da estao de trabalho se executar o comando
localmente.
411
Consulte tambm
predefinido
clique em OK
4. Selecione uma estao de trabalho e clique em Mais AesIniciar Processador
de Eventos.
startmon
Inicia o processo monman que ativa o mecanismo de monitoramento de eventos na
estao de trabalho.
Sintaxe
{startmon | startm} [domain!]workstation
[;noask]
Argumentos
domnio
trabalho possuem nomes exclusivos, o domnio no necessrio ao iniciar
o mecanismo de monitoramento em uma estao de trabalho especfica.
estao de trabalho
mecanismo de monitoramento. Caracteres curinga so permitidos.
Comentrios
Consulte tambm
predefinido
clique em OK
412
4. Selecione uma estao de trabalho e clique em Mais AesIniciar

Monitoramento de Eventos.
status
Exibe o banner do conman e o status de produo do Tivoli Workload Scheduler.
Sintaxe
{status | stat}
Resultados
Depois da palavra schedule na segunda linha de sada, o modo de plano de
produo (arquivo Symphony) mostrado entre parnteses. As informaes Def ou
Exp podem aparecer. Def significa que o plano de produo est no modo
no-expandido, e Exp significa que est no modo expandido. O modo do plano de
produo determinado pela definio da opo global verso expandida. Com o
Tivoli Workload Scheduler Verso 8.2, os bancos de dados e os planos so sempre
expandidos, mas essas informaes aparecem para retrocompatibilidade com
verses anteriores.
Exemplos
O exemplo a seguir exibe o status do plano de produo atual.
%status
TWS for UNIX/CONMAN 8.4 (1.36.2.22)
Materiais Licenciados Propriedade da IBM
5698-WKB
(C) Copyright IBM Corp 1998, 2007
Job stream (Exp) 11/26/06 (#34) on site3.
Batchman ATIVO. Limit:19, Fence:0, Audit Level:0
stop
Pra os processos de produo do Tivoli Workload Scheduler. Para parar o
processo netman, utilize o comando shutdown. Voc deve ter acesso stop estao
de trabalho.
Sintaxe
stop [domain!]workstation
[;wait]
[;noask]
Argumentos
domnio
Especifica o nome do domnio no qual as estaes de trabalho pararam.
Como as estaes de trabalho possuem nomes exclusivos, o domnio no
necessrio quando uma determinada estao de trabalho est sendo
parada. Caracteres curinga so permitidos.
413
Este argumento til quando se est parando mais de uma estao de

trabalho em um domnio. Por exemplo, para parar todos os agentes no
stop stlouis!@

estao de trabalho
Especifica o nome da estao de trabalho a ser parada. Caracteres curinga
so permitidos.
remoto.
|
|
wait
Especifica para no aceitar outro comando at que todos os processos

tenham parado.

Comentrios
Se o comando stop no puder ser aplicado a uma estao de trabalho distante (por
exemplo, se o caminho TCP/IP no estiver disponvel), o comando ser
armazenado localmente em um arquivo pobox e ser enviado para a estao de
trabalho quando ela for vinculada.
Supondo-se que um usurio tenha acesso stop a estaes de trabalho sendo
paradas, as seguintes regras sero aplicadas:
parar qualquer estao de trabalho na rede.
principal pode parar qualquer estao de trabalho nesse domnio e em domnios
subordinados. O usurio no pode parar estaes de trabalho em domnios
ponto a ponto.
v Um usurio executando o conman em um agente pode parar qualquer estao
de trabalho no domnio local.
Quando voc emite um comando stop @ em um gerenciador de domnio, um
comando conman stop local executado nas CPUs remotas. O comando inicia a
execuo nas estaes mais baixas na hierarquia da rede e, finalmente, executado
no gerenciador de domnio. No entanto, o arquivo Symphony no atualizado antes
das CPUs serem desativadas. Portanto, se voc emitir um comando conman sc@!@
a partir de qualquer CPU, as informaes resultantes podero ser uma figura
atualizada dos estados das CPUs, at mesmo do gerenciador de domnio.
Exemplos
A Figura 24 na pgina 415 e a Tabela 58 na pgina 415 abaixo mostram a estao
de trabalho parada por diferentes comandos stop executados por usurios em
locais diferentes da rede.
414
A11
A12
DM1
Domain1
User1
User3
User2
DM2
A21
DM3
A31
A22
A32
Domain3
Domain2
DM4
Domain4
A41
A42

Tabela 58. Estaes de Trabalho Paradas
Comando
stop @!@
Parado pelo:
Usurio1
Todas as estaes
de trabalho so
paradas
Parado pelo
Usurio2
Parado pelo
Usurio3
DM2
A21
A22
DM4
A41
A42
DM2
A21
A22
DM2
A21
A22
DM2
A21
A22
No permitido
No permitido
stop @
DM1
A11
A12
stop DOMAIN3!@
DM3
A31
A32
No permitido
stop DOMAIN4!@
DM4
A41
A42
DM4
A41
A42
stop DM2
DM2
DM2
DM2
stop A42
A42
A42
No permitido
stop A31
A31
No permitido
No permitido
stop ;progressive
Pra os processos de produo do Tivoli Workload Scheduler hierarquicamente
quando voc tiver definido pelo menos uma estao de trabalho como
BEHINDFIREWALL em uma rede do Tivoli Workload Scheduler. Semelhante ao
comando stop @!@, mas mais efetivo no aprimoramento do desempenho do plano.
O comando no executado a partir do domnio em que foi inicialmente emitido
para cada domnio subordinado, mas em cada nvel hierrquico.
|
|
Nota: Esse comando no suportado em estaes de trabalho de mecanismo

remoto.
415
Voc deve ter acesso stop estao de trabalho.
Sintaxe
stop ;progressive
Comentrios
Quando voc emite o comando em um gerenciador de domnio, todas as estaes
de trabalho nesse domnio so paradas e, em seguida, o prprio gerenciador de
domnio parado e o comando continua a ser executado em todos os domnios
subordinados. A execuo do comando continua dessa forma hierrquica, o
gerenciador de domnio pra as estaes de trabalho no mesmo domnio, ele
prprio parado e, em seguida, a execuo continua nos domnios subordinados.
Exemplos
A Figura 25 e a Tabela 59 mostram as estaes de trabalho paradas emitindo-se o
comando stop ;progressive em DM2 e DM4.
A11
A12
DM1
Domain1
User1
User3
User2
DM2
A21
DM3
A31
A22
Domain2
A32
Domain3
DM4
Domain4
A41
A42

Tabela 59. Estaes de Trabalho Paradas com stop ;progressive
Comando
Parado pelo DM2
Parado pelo DM4
A21
A22
DM2
A41
A42
DM4
stop ;progressive
stopappserver
Pra o WebSphere Application Server integrado na estao de trabalho.
Sintaxe
{stopappserver | stopapps}
[;wait]
416
[domain!]workstation
Argumentos
domnio
trabalho possuem nomes exclusivos, o domnio no necessrio ao parar o
WebSphere Application Server em uma estao de trabalho especfica.
estao de trabalho
Especifica o nome da estao de trabalho na qual voc deseja parar o
mecanismo de monitoramento. Caracteres curinga so permitidos. Se
nenhum domnio e estao de trabalho estiverem especificados, a ao ser
na estao de trabalho local.
wait
Aguarda at que o WebSphere Application Server tenha parado antes de

solicitar outro comando.
Comentrios
A permisso para as aes stop nos objetos cpu deve estar ativada no arquivo de
Nos sistema Windows, no utilize os servios do Windows para parar o
WebSphere Application Server. Se voc utilizar esses servios, o processo
appserverman, que continua sendo executado, iniciar o WebSphere Application
Server novamente. Em vez disso, utilize esse comando ou o comando stopWas (sem
a opo -direct).
Ao executar o comando, o processo appserverman primeiro verifica se o WebSphere
Application Server pode recuperar as credenciais do usurio (nome de usurio e
senha) do arquivo soap.client.props localizado no perfil do WebSphere
Application Server. Se a verificao for negativa, appserverman l as mesmas do
arquivo useropts do usurio e executa o script stopServer.sh (bat) para pass-las
ao WebSphere Application Server.
Para poder executar o comando, voc deve, portanto, executar um dos dois
procedimentos de customizao a seguir para fornecer as credenciais do usurio ao
WebSphere Application Server:
v Customize as propriedade de nome de usurio (com.ibm.SOAP.loginUserid) e de
senha (com.ibm.SOAP.loginPassword) no arquivo soap.client.props localizado
em:
TWS_home/appserver/profiles/twsprofile/properties/
(Version 8.4 and earlier master)
TWS_home/appserver/profiles/twsconnprofile/properties/ (Version 8.4 and earlier agents)
TWA_home/eWAS/profiles/TIPProfile/properties/
(Verso
8.5 e at master e agentes)
Voc tambm deve:

1. Configurar a propriedade com.ibm.SOAP.securityEnabled para true no
mesmo arquivo para ativar a segurana do cliente SOAP
2. Executar o script encryptProfileProperties.sh para criptografar a senha.
Consulte o Guia de Administrao do Tivoli Workload Scheduler para obter
informaes adicionais sobre essa ferramenta de servidor de aplicativos.
v Customize a seo Attributes for conman (CLI in version 8.4) connections
no arquivo localopts, especificando os detalhes do conector ou do gerenciador
de domnio mestre.
417
Voc tambm deve:

1. Criar (ou customizar se j estiver presente) o arquivo useropts manualmente,
incluindo os atributos USERNAME e PASSWORD para o usurio que ir executar
stopappserver. Certifique-se de que o nome do arquivo useropts seja
inserido na chave USEROPTS na seo Attributes for conman (CLI)
connections. Consulte o Guia de Administrao para obter detalhes adicionais.
2. Criptografe a senha no arquivo useropts simplesmente executando conman.
stopeventprocessor
Pra o servidor de processamento de eventos.
Sintaxe
{stopeventprocessor | stopevtp} [domain!][workstation]
Argumentos
domnio
Especifica o nome do domnio da estao de trabalho.
estao de trabalho
Especifica o nome do gerenciador de domnio principal, principal de
backup ou estao de trabalho instalada como um principal de backup que
funciona como um agente tolerante a falhas simples no qual voc deseja
parar o servidor de processamento de eventos. Caracteres curinga no so
permitidos.
possvel omitir o nome da estao de trabalho se executar o comando
localmente.
Comentrios
Este comando no pode ser emitido de uma maneira assncrona.
Se voc emitir o comando de uma estao de trabalho diferente daquela onde o
processador de eventos est configurado, o comando utilizar o cliente da linha de
comandos e, dessa forma, as credenciais de usurios para o cliente de linha de
comandos devem estar configuradas corretamente.
Consulte tambm
predefinido
clique em OK
4. Selecione uma estao de trabalho e clique em Mais AesParar Processador
de Eventos.
418
stopmon
Pra o mecanismo de monitoramento de eventos na estao de trabalho.
Sintaxe
{stopmon | stopm} [domain!]workstation
[;wait]
[;noask]
Argumentos
domnio
trabalho possuem nomes exclusivos, o domnio no necessrio ao parar o
mecanismo de monitoramento em uma estao de trabalho especfica.
estao de trabalho
Especifica o nome da estao de trabalho na qual voc deseja parar o
mecanismo de monitoramento. Caracteres curinga so permitidos.
wait
Especifica para no aceitar outro comando at que o mecanismo de

monitoramento seja parado.

Comentrios
O mecanismo de monitoramento reiniciado automaticamente quando o prximo
plano de produo ativado (no Windows tambm quando o Tivoli Workload
Scheduler reiniciado) a menos que voc desative a opo local autostart monman.
O comando assncrono, a menos que voc especifique a palavra-chave wait.
Consulte tambm
predefinido
clique em OK
4. Selecione uma estao de trabalho e clique em Mais AesParar
Monitoramento de Eventos.
submit docommand
Envia um comando a ser ativado como uma tarefa.
419
Para executar este comando, no arquivo de segurana voc deve ter acesso de
envio para a tarefa com o nome especificado em sua definio de banco de dados
e, se voc utilizar a palavra-chave alias, tambm com o nome especificado com
esta palavra-chave. Alm disso, se voc utilizar a palavra-chave recoveryjob,
dever ter acesso de envio para a tarefa especificada com essa palavra-chave.
Para incluir dependncias needs e prompt, voc deve ter acesso use aos recursos e
prompts globais.
Se voc enviar a tarefa de uma estao de trabalho diferente do gerenciador de
domnio mestre, dever estar conectando como um usurio que:
v tenha credenciais adequadas definidas no arquivo useropts para conectar ao
gerenciador de domnio mestre por meio do WebSphere Application Server
v seja autorizado a executar comandos de envio no arquivo de segurana
armazenado no gerenciador de domnio mestre
Sintaxe
{submit docommand | sbd} [workstation#]"cmd"
[;alias[=name]]
[;into=[workstation#]
{jobstream_id;schedid |jobstreamname (hhmm[ date])}]
[;joboption[;...]]
Argumentos
estao de trabalho
Especifica o nome da estao de trabalho na qual o job ser lanado.
Caracteres curinga so permitidos e, nesse caso, o job lanado em todas
as estaes de trabalho qualificadas. O padro a estao de trabalho na
qual o conman est sendo executado. Voc no pode especificar um
domnio ou classe de estao de trabalho.
Nota: Em razo de uma limitao na maneira com que o Windows
gerencia o sinal de igual (=) no ambiente shell, necessrio mascarar
o sinal de igual (=) desta forma '\='\ ao enviar comandos do
Windows utilizando submit docommand. Por exemplo, para
configurar a varivel local var1 como hello, necessrio emitir o
seguinte comando:
%sbd "set var1\"=\"hello"
cmd
Especifica um comando de sistema vlido de at 255 caracteres. Todo o

comando deve ser colocado entre aspas ("). O comando ser tratado como
um job e todas as regras de job sero aplicadas.
alias=name
Especifica um nome exclusivo a ser atribudo ao job. Se voc inserir a
palavra-chave alias sem especificar um nome, um nome ser construdo
utilizando at os seis primeiros caracteres alfanumricos (em letras
maisculas) do comando, dependendo do nmero de caracteres no
comando, seguido de um nmero aleatrio de dez dgitos. Se houver
espaos em branco no comando, o nome ser construdo utilizando at os
seis primeiros caracteres alfanumricos antes do espao em branco. Por
exemplo, se o comando for "rm apfile", o nome gerado ser semelhante a
RM0123456789. Se o comando for mais longo do que seis caracteres
alfanumricos como, "wlsinst", o nome gerado ser wlsins0396578515.
420
Se voc no incluir um alias na primeira vez que submeter o comando, um

nome de job ser construdo utilizando at 255 caracteres do nome do
comando. Se voc submeter um comando uma segunda vez a partir da
mesma estao de trabalho, a palavra-chave alias ser obrigatria e dever
ser exclusiva para cada submisso do comando.
into=jobstream_instance
Identifica a instncia do fluxo de tarefas na qual a tarefa ser colocada para
ativao. Selecione a instncia do fluxo de tarefas da seguinte forma:
[workstation#]jobstreamname[hhmm[ date]]
ou
[workstation#]jobstream_id ;schedidSe into no for utilizado, o job ser
adicionado a um fluxo de job chamado JOBS.
joboption
Especifique qualquer um dos seguintes:
at=hhmm [timezone|tz tzname] [+n days | mm/dd[/yy]] | [absolute | abs]
confirmed
critical
deadline=time [timezone|tz tzname][+nday[s | mm/dd[/yy]]
every=rate
@] | jobstream_id.job;schedid}| job[;nocheck][;wait=time][,...]
Nota: O argumento ;nocheck no suportado nas dependncias de
interligao de redes.
interactive
Nota: Esta palavra-chave pode ser utilizada somente nos ambientes
Windows.
logon=user.
opens=[workstation#]"filename"[(qualifier)][,...]
priority[=pri | hi | go]
rccondsucc"Success Condition"
recovery=stop | continue | rerun
recoveryjob=o nome de uma tarefa de recuperao diferente daquele (se presente)
especificado na definio de tarefa no banco de dados
abendprompt text
action]
O valor padro para joboption o usurio na estao de trabalho a partir
da qual o comando est sendo executado.
421
Utilizando Parmetros Locais
v
v
v
possvel utilizar parmetros locais como valores com as seguintes palavras-chave:

cmd
opens
logon
v prompt
v abendprompt
Parmetros locais so definidos e gerenciados com o comando de utilitrio parms
em um banco de dados local na estao de trabalho na qual a tarefa executada.
Os parmetros so resolvidos na estao de trabalho enquanto o comando submit
est em execuo.
Comentrios
Tarefas enviadas na produo a partir da linha de comandos conman no so
includas no plano de pr-produo e, portanto, no podem ser levadas em
considerao durante a identificao de predecessores de dependncias de
seqncias externas.
Se voc no especificar uma estao de trabalho com follows, needs , opens ou into,
o padro ser a estao de trabalho da tarefa.
Ao enviar o objeto em um fluxo de tarefas e incluir uma dependncia de sequncia
que compartilhe o mesmo nome de fluxo de tarefas (por exemplo, voc envia o
objeto no fluxo de tarefas schedA e define uma dependncia de sequncia em
schedA.job2), a dependncia tratada como uma dependncia de sequncia
externa. Desde a Verso 8.3, ao contrrio das verses anteriores, porque o
planejador usa os critrios de correspondncia mesmo dia para resolver
dependncias externas, dependncias originadas dessa maneira nunca so includas
da primeira vez que o objeto enviado.
Exemplos
Para submeter um comando rm ao fluxo de job JOBS com uma dependncia
follows, execute o seguinte comando:
submit docommand="rm apfile";follows sked3
Para submeter um comando sort com o alias sortit e colocar o job no fluxo de job
reports com uma hora at de 17h30, execute o seguinte comando:
sbd "sort < file1 > file2";alias=sortit;into=reports;at=1730
Para submeter comandos chmod em todas as estaes de trabalho com nomes

comeando com site, execute o seguinte comando:
sbd site@#"chmod 444 file2";alias
422
Consulte tambm
1. Clique em Tivoli Workload SchedulerCarga de TrabalhoEnviarEnviar
Tarefas Ad Hoc
3. Preencha os dados solicitados nas telas Enviar Tarefa Ad Hoc no Plano e clique
em OK.
submit file
Envia um arquivo a ser ativado como uma tarefa.
Para executar este comando, no arquivo de segurana voc deve ter acesso de
envio para a tarefa com o nome especificado em sua definio de banco de dados
e, se voc utilizar a palavra-chave alias, tambm com o nome especificado com
prompts globais.
Sintaxe
{submit file | sbf} "filename"
[;alias[=name]]
[;into=[workstation#]{jobstream_id ;schedid |jobstreamname
(hhmm[ date])}]
[;joboption[;...]]
[;noask]
Argumentos
nome do arquivo
Especifica o nome do arquivo, at 255 caracteres. Caracteres curinga so
permitidos. O nome dever ser colocado entre aspas (") se contiver
caracteres diferentes de caracteres alfanumricos, traos (-), barras (/) e
sublinhados (_). Consulte os exemplos.
alias=name
Especifica um nome exclusivo a ser atribudo ao job. Se voc inserir a
palavra-chave alias sem especificar um nome, um nome ser construdo
utilizando at os seis primeiros caracteres alfanumricos (em letras
maisculas) do nome do arquivo, dependendo do nmero de caracteres no
nome do arquivo, seguido de um nmero aleatrio de dez dgitos. Por
exemplo, se o nome do arquivo for jclttx5, o nome gerado ser
semelhante a JCLTTX0123456789.
423
Se voc no incluir alias, um nome de arquivo construdo usando at 255

caracteres alfanumricos do nome base do arquivo em maiscula.
Em qualquer um dos casos acima, se o nome do arquivo no iniciar com
uma letra, voc ser solicitado a utilizar alias= name.
Se voc submeter um arquivo uma segunda vez a partir da mesma estao
de trabalho, a palavra-chave alias ser obrigatria e dever ser exclusiva
para cada submisso do arquivo.
ou
joboption
Especifique um dos seguintes:
confirmed
critical
deadline=time[timezone | tz tzname][+n days | mm/dd[/yy]]
every=rate
follows=[netagent::][workstation#]{jobstreamname(hhmm [mm/dd[/yy]])[.job |
interactive
Nota: Esta palavra-chave pode ser utilizada somente nos ambientes
Windows.
logon=user
abendprompt text
action]
424

arquivo qualificado.
Utilizando Parmetros Locais
v
v
v
v
possvel utilizar parmetros locais como valores com as seguintes palavras-chave:

nome do arquivo
opens
logon
prompt
v abendprompt
Parmetros locais so definidos e gerenciados com o comando de utilitrio parms
em um banco de dados local na estao de trabalho na qual a tarefa executada.
Os parmetros so resolvidos na estao de trabalho enquanto o comando submit
est em execuo.
Comentrios
seqncias externas.
Se voc no especificar uma estao de trabalho com follows, needs , opens ou
into, o padro ser a estao de trabalho em que conman est em execuo.
Exemplos
Para submeter um arquivo ao fluxo de job jobs (o nome do job myjcl), execute o
seguinte comando:
submit file=d:\jobs\lib\daily\myjcl
em que a seqncia ;into foi omitida.

Para submeter um arquivo com um nome de job de misjob4 ao fluxo de job
missked, execute o seguinte comando:
sbf /usr/lib/mis/jcl4;alias=misjob4;into=missked ;needs=2 slots
O job precisa de duas unidades do recurso slots.

425
Para submeter todos os arquivos com nomes comeando com back ao fluxo de job
bkup, execute o seguinte comando:
sbf "/usr/lib/backup/back@";into=bkup
Para enviar o arquivo tws_env.cmd, cujo caminho contm um espao vazio, em

uma estao de trabalho do Windows, execute:
v No modo interativo:
sbf "\"C:\Program Files\IBM\TWS\lucaMDM\tws_env.cmd\"";alias=MYJOB
Estando no Windows, as aspas duplas (") devem ser codificadas com a seqncia
de caracteres "\.
v No modo de linha de comandos:
conman sbf "\"\\\"C:\Program Files\IBM\TWS\lucaMDM\tws_env.cmd\\\"\"";alias=MYJOB
Estando no Windows e executando o comando externamente a partir do

ambiente do conman, a seqncia da funo escape torna-se mais longa.
em que "\" o caractere de escape para o espao em branco no caminho de
arquivo.
submit job
Envia uma tarefa para ser ativada.
Para executar esse comando, no arquivo de segurana voc deve ter acesso de
envio (submitdb) para a tarefa com o nome especificado em sua definio de banco
de dados e, se usar a palavra-chave alias, tambm com o nome especificado com
Observe que se voc tiver somente direitos de segurana submitdb, voc est
limitado a enviar tarefas definidas no banco de dados. No possvel enviar
tarefas ad hoc.
prompts globais.
Se uma tarefa sombra for enviada, consulte Captulo 16, Definindo e Gerenciando
Dependncias Cruzadas, na pgina 567 para obter detalhes adicionais.
Sintaxe
{submit job | sbj} [workstation#]jobname
[;alias[=name]]
[;into=[workstation#]{jobstream_id ;schedid |
jobstreamname(hhmm[ date])}]
426
[;joboption[;...]]
[;vartable=tablename]
[;noask]
Argumentos
estao de trabalho
Especifica o nome da estao de trabalho na qual o job ser lanado.
Caracteres curinga so permitidos e, nesse caso, o job lanado em todas
as estaes de trabalho qualificadas. O padro a estao de trabalho na
qual o conman est sendo executado. Voc no pode especificar um domnio
ou classe de estao de trabalho.
jobname
Especifica o nome do job. Caracteres curinga so permitidos e, nesse caso,
todos os jobs qualificados so submetidos. Se o job j estiver no plano de
produo e estiver sendo submetido ao mesmo fluxo de job, voc dever
utilizar o argumento alias para atribuir um nome exclusivo.
alias=name
Especifica um nome exclusivo a ser atribudo ao job no lugar de jobname.
Se voc digitar a palavra-chave alias sem especificar um nome, um nome
ser construdo utilizando os dois primeiros caracteres alfanumricos de
jobname, seguido de um nmero aleatrio de seis dgitos. O nome sempre
organizado em ordem crescente. Por exemplo, se jobname for jcrttx5, o
nome gerado ser semelhante a JC123456.
ou
joboption
confirmed
critical
deadline=time[timezone | tz tzname][+n days | mm/dd[/yy]]
every=rate
follows=[netagent::][workstation#]{jobstreamname(hhmm [mm/dd[/yy]])[.job |
427
abendprompt text
action]
vartable=tablename
Especifica o nome da tabela de varivel, se for diferente do padro, em que
as variveis que deseja usar so definidas.
Lembre-se:
v Com esse comando, possvel utilizar a substituio de
variveis para as seguintes palavras-chave:
opens
prompt
abendprompt
v Coloque a varivel entre acentos circunflexos (^) e a cadeia
completa entre aspas. Se a varivel contiver uma parte de
um caminho, certifique-se de que os caracteres acento
circunflexo no sejam imediatamente precedidos por uma
barra invertida (\), pois nesse caso, a seqncia \^ poderia
ser interpretada erroneamente como uma seqncia de
escape e resolvida pelo analisador como caractere acento
circunflexo. Se necessrio, mova a barra invertida para a
definio da varivel entre acentos circunflexos.
job qualificado. Essa opo pode ser utilizada somente com ;schedid.
Comentrios
seqncias externas.
Se voc no especificar uma estao de trabalho com follows, needs , opens ou
into, o padro ser a estao de trabalho da tarefa.
at especifica em que horrio a tarefa pode ser enviada. Se a palavra-chave at for
utilizada, a tarefa no poder iniciar antes do horrio configurado nessa
palavra-chave. Observe que se o gerenciador de domnio principal da rede
executar com as opes enLegacyStartOfDayEvaluation e enTimeZone configuradas
para yes para converter o horrio startOfDay configurado no gerenciador de
domnio principal para o fuso horrio local configurado em cada estao de
trabalho na rede, voc dever incluir a palavra-chave absolute para que funcione.
428

Exemplos
Para submeter os jobs test ao fluxo de job JOBS, execute o seguinte comando:
sbj test
Para submeter um job com um alias de rptx4 e colocar o job no fluxo de job
reports com uma hora at de 5h30, execute o seguinte comando:
sbj rjob4;alias=rptx4;into=reports;at=1730
Para submeter o job txjob3 a todas as estaes de trabalho cujos nomes comecem
com site, execute o seguinte comando:
sbj site@#txjob3;alias
Consulte tambm
Tarefas Predefinidas
3. Preencha os dados solicitados na tela Enviar Tarefa no Plano e clique em OK.
submit sched
Envia um fluxo de tarefa para processamento.
Para executar este comando, no arquivo de segurana, voc deve ter acesso de
envio para o fluxo de tarefa com o nome especificado em sua definio de banco
de dados e, se voc utilizar a palavra-chave alias, tambm com o nome
especificado com esta palavra-chave. Para incluir dependncias needs e prompt,
voc deve ter acesso use aos recursos e prompts globais.
O comando submit schedule utiliza as credenciais configuradas no arquivo
useropts que pertencem ao TWS_user que instalou essa estao de trabalho.
Se voc enviar o fluxo de tarefas de uma estao de trabalho diferente de
gerenciador de domnio mestre, dever estar conectando como um usurio que:
429
Sintaxe
{submit sched | sbs} [workstation#]jstreamname
[;alias[=name]]
[;jstreamoption[;...]]
[;noask]
Argumentos
estao de trabalho
Especifica o nome da estao de trabalho na qual fluxo de job ser lanado.
Caracteres curinga so permitidos e, nesse caso, o fluxo de job lanado
em todas as estaes de trabalho qualificadas. O padro a estao de
trabalho na qual o conman est sendo executado. Voc no pode
especificar um domnio ou classe de estao de trabalho.
jstreamname
Especifica o nome do fluxo de tarefas. Caracteres curinga so permitidos e,
nesse caso, todos os fluxos de job qualificados so submetidos. Se o fluxo
de job j estiver no plano de produo, voc dever utilizar o argumento
alias para atribuir um nome exclusivo.
alias=name
Especifica um nome exclusivo a ser atribudo ao fluxo de job no lugar de
jstreamname. Se configurado, esse valor tambm corresponde ao
jobstream_id. Se voc digitar a palavra-chave alias sem especificar um
nome, um nome ser construdo utilizando os primeiros caracteres
alfanumricos de jstreamname seguido por um nmero aleatrio de seis
dgitos. O nome sempre organizado em ordem crescente. Por exemplo, se
jstreamname for sttrom, o nome gerado ser semelhante a ST123456.
A autorizao para enviar o planejamento marcada no arquivo de
Segurana usando o nome original, no o nome alternativo.
jstreamoption
Insira qualquer um dos seguintes (consulte Detalhes da Palavra-chave de
Definio do Fluxo de Tarefas na pgina 199 para localizar quais opes
so mutuamente exclusivas):
[at=hhmm [timezone|tz tzname] [+n days | date] [absolute | abs]] |
[schedtime=[hhmm [date] | [+n days]]
onde:
at especifica em que horrio o fluxo de tarefas pode ser enviado. Se
a palavra-chave at for usada, ento o fluxo de tarefas no pode ser
iniciado antes do horrio configurado com essa palavra-chave
(consulte o tpico sobre as palavras-chave de definio de fluxo de
tarefas no captulo "Definindo Objetos no Banco de Dados" em
"Guia do Usurio e Referncia" para obter informaes adicionais
sobre a palavra-chave "at"). Observe que se o gerenciador de
domnio principal da rede executar com as opes
enLegacyStartOfDayEvaluation e enTimeZone configuradas para yes
para converter o horrio startOfDay configurado no gerenciador de
domnio principal para o fuso horrio local configurado em cada
estao de trabalho na rede, voc dever incluir a palavra-chave
absolute para que funcione.
schedtime representa o dia e o horrio em que o fluxo de tarefas
posicionado no plano. Se, neste horrio, o fluxo de tarefas estiver
430
livre de dependncias e no tiver restries de tempo at definidas,

ele ser ativado. Um valor designado para schedtime no
representa uma dependncia para o fluxo de tarefas. Seu valor ,
ento, exibido nas colunas SchedTime na sada dos comandos show.
Se uma restrio at for definida, o valor designado para schedtime
ser sobrescrito pelo valor at. Quando o fluxo de tarefas realmente
inicia, o valor designado para schedtime sobrescrito pelo horrio
de incio real do fluxo de tarefas.
O formato utilizado para date depende do valor designado para a
Se nenhum fuso horrio adicional for especificado, o fuso horrio
configurado na estao de trabalho que executa o comando ser
assumido.
carryforward
deadline=time[timezone | tz tzname][+n days | date]
Se nenhum fuso horrio adicional for especificado, o fuso horrio
assumido.
follows=[netagent::][workstation#]{jobstreamname[hhmm [mm/dd[/yy]]][.job | @]
| jobstream_id.job;schedid}| job[;nocheck][;wait=time][,...]
Os critrios de correspondncia utilizados ao enviar fluxos de
tarefa na produo so diferentes da maneira como as
dependncias follows so resolvidas no plano de pr-produo.
Quando um fluxo de tarefas, por exemplo, JS_A, contendo uma
dependncia follows de uma tarefa ou um fluxo de tarefa, por
exemplo, JS_B, enviado a partir de um programa de linha de
comandos conman, a instncia predecessora de JS_B definida
seguindo estes critrios:
1. A instncia mais prxima de JS_B antes de JS_A.
2. Se no existir nenhuma instncia anterior a JS_B, a instncia
predecessora ser a instncia mais prxima de JS_B depois de
JS_A.
3. Caso contrrio, um erro ser exibido e o comando falhar se a
palavra-chave ;nocheck no for utilizada.
A instncia do fluxo de tarefas do predecessor procurada entre as
instncias includas no plano de produo quando JnextPlan foi
executado e as instncias foram enviadas em produo com o
comando sbs, incluindo as enviadas com um alias.
Ateno: O argumento ;nocheck no suportado nas
dependncias de interligao de redes.
limit=joblimit
431

action] Se nenhum fuso horrio adicional for especificado, o fuso horrio
assumido.
vartable=tablename
Especifica o nome da tabela de varivel, se for diferente do padro, em que
as variveis que deseja usar so definidas.
Lembre-se:
v Com esse comando, possvel utilizar a substituio de
variveis para as seguintes palavras-chave:
opens
prompt
v Coloque a varivel entre acentos circunflexos (^) e a cadeia
completa entre aspas. Se a varivel contiver uma parte de
um caminho, certifique-se de que os caracteres acento
circunflexo no sejam imediatamente precedidos por uma
barra invertida (\), pois nesse caso, a seqncia \^ poderia
ser interpretada erroneamente como uma seqncia de
escape e resolvida pelo analisador como caractere acento
circunflexo. Se necessrio, mova a barra invertida para a
definio da varivel entre acentos circunflexos.
fluxo de job qualificado. Essa opo pode ser utilizada somente com
;schedid.
Comentrios
Os fluxos de tarefas enviados na produo a partir da linha de comandos conman
no so includos no plano de pr-produo e, portanto, no podem ser levados
em considerao durante a identificao de predecessores de dependncias follows
externas.
Se voc no especificar uma estao de trabalho com follows, needs ou opens, o
padro ser a estao de trabalho do fluxo de job.
Ao enviar um fluxo de tarefas que inclui uma tarefa com uma dependncia de
sequncia que compartilha o mesmo nome de fluxo de tarefas (por exemplo, o
fluxo de tarefas schedA inclui uma tarefa denominada job6 que tem uma
dependncia de sequncia em schedA.job2), a dependncia includa como uma
Exemplos
Para submeter o fluxo de job adhoc estao de trabalho site1 e sinaliz-la como
um fluxo de job carryforward, execute o seguinte comando:
432
submit sched=site1#adhoc;carryforward
Para submeter o fluxo de job fox4 com um limite de job de 2, uma prioridade de
23 e uma hora until de meia-noite, execute o seguinte comando:
sbs fox4;limit=2;pri=23;until=0000
Para submeter o fluxo de job sched3 a todas as estaes de trabalho com nomes
iniciados com site, execute o seguinte comando:
sbs site@#sched3
Consulte tambm
|
|
|
|
|
|

Fluxos de Tarefas Predefinidos
3. Preencha os dados solicitados na tela Enviar Fluxo de Tarefas no Plano e clique
em OK.
Comuta o servidor de processamento de eventos do gerenciador de domnio
principal para o principal de backup ou vice-versa.
Observe que possvel executar o servidor de processamento de eventos tambm
em uma estao de trabalho instalada como um principal de backup que
executado como um agente tolerante a falhas simples.
Sintaxe
{switcheventprocessor | switchevtp} workstation
Argumentos
estao de trabalho
Especifica o nome do gerenciador de domnio principal ou do principal de
backup no qual voc deseja comutar o servidor de processamento de
eventos. Caracteres curinga no so permitidos.
Comentrios
Se voc emitir o comando de uma estao de trabalho diferente daquela onde o
processador de eventos est configurado, o comando utilizar o cliente da linha de
comandos e, dessa forma, as credenciais de usurios para o cliente de linha de
comandos devem estar configuradas corretamente.
No caso de principais de backup, a estao de trabalho deve ter o atributo
full-status configurado como on.
A permisso para as aes start e stop nos objetos cpu deve estar ativada no
arquivo de segurana para executar este comando.
O estado de correlao das instncias da regra de correlao pendentes perdido
sempre que o servidor desativado ou migrado. Se o armazenamento em cache
433
dos eventos recebidos estiver ativado no arquivo de configurao do listener EIF,

os eventos armazenados em cache sero perdidos aps o processador de eventos
ser comutado.
Importante:
v Antes de executar esse comando, execute planman deploy por
precauo. Faa isso para se certificar que as alteraes ou incluses
mais recentes nas regras de evento ativas foram implementadas
antes do processador de evento ser comutado e, dessa forma, evitar
o risco que, por causa de uma incompatibilidade de tempo, as
atualizaes mais recentes (enviadas automaticamente com base na
configurao da opo global deploymentFrequency) sejam recebidas
pelo processador de eventos antigo, em vez do novo.
v O principal e os backups principais designados para executar o
processador de eventos devem ter seus relgios sempre
sincronizados para evitar inconsistncias no clculo do intervalo de
tempo de execuo das regras de evento. Na realidade, se o
processador de eventos for comutado para um computador
no-sincronizado, as aes de tempo limite no processo de
acionamento podero sofrer atrasos inesperados. Utilize um
servidor Network Time Protocol (NTP) para manter todos os
relgios sincronizados.
Consulte tambm
predefinido
clique em OK
4. Selecione uma estao de trabalho e clique em Mais AesTornar-se
Processador de Eventos.
switchmgr
Alterna o gerenciamento de domnio do gerenciador de domnio atual para um
gerenciador de domnio de backup.
Voc deve ter acesso start e stop ao gerenciador de domnio de backup.
O comando switchmgr deve ser utilizado somente como parte de procedimentos
especficos para comutar recursos de gerenciamento de domnio de um gerenciador
de domnio para seu gerenciador de domnio de backup permanente ou
temporariamente. Para obter informaes sobre estes procedimentos, consulte o
IBMTivoli Workload Scheduler: Guia de Administrao.
Sintaxe
{switchmgr | switchm} domain;newmgr
434
Argumentos
domnio
Especifica o domnio no qual voc deseja alternar gerenciadores.
newmgr
Especifica o nome do novo gerenciador de domnio. Deve ser uma estao
de trabalho no mesmo domnio e deve ser definida antecipadamente como
um agente tolerante a falhas com Resolver Dependncias e Status
Completo ativado.
Comentrios
O comando pra uma determinada estao de trabalho e a reinicia como o
gerenciador de domnio. Todas as estaes de trabalho membros do domnio so
informadas da comutao e o gerenciador de domnio antigo convertido em um
agente tolerante a falhas no domnio.
Na prxima vez que JnextPlan for executado no gerenciador de domnio antigo, o
domnio age como se outro comando switchmgr tivesse sido executado e o antigo
gerenciador de domnio retoma automaticamente as responsabilidades do
gerenciamento do domnio.
Agentes tolerantes a falhas definidos com securitylevel = on podem falhar em
usar a porta SSL para conectar ao novo gerenciador de domnio principal aps o
comando switchmgr ser executado. Nesse caso, execute um dos seguintes para
permitir que o agente seja iniciado corretamente:
v Desconecte e, em seguida, conecte o agente ao novo gerenciador de domnio
principal.
v Use a opo securitylevel = force no agente.
Exemplos
Para alternar o gerenciador de domnio para a estao de trabalho orca no
domnio masterdm, execute o seguinte comando:
switchmgr masterdm;orca
Para alternar o gerenciador de domnio para a estao de trabalho ruby no

domnio bldg2, execute o seguinte comando:
switchmgr bldg2;ruby
Consulte tambm
predefinido
clique em OK
4. Selecione uma estao de trabalho e clique em Mais AesTornar-se
Gerenciador de Domnio Principal.
system command
Executa um comando do sistema.
435
Sintaxe
Argumentos
system-command
Especifica qualquer comando de sistema vlido. O prefixo (: ou !) ser
necessrio apenas quando um nome de comando for grafado da mesma
forma que um comando do conman.
Exemplos
Para executar um comando ps no UNIX, execute o seguinte comando:
ps -ef
Para executar um comando dir no Windows, execute o seguinte comando:

dir \bin
tellop
Envia uma mensagem ao console Tivoli Workload Scheduler.
Sintaxe
{tellop | to} [text]
Argumentos
text
Especifica o texto da mensagem. A mensagem pode conter at 900

caracteres.
Comentrios
Se tellop for emitido no gerenciador de domnio principal, a mensagem ser
enviada a todas as estaes de trabalho ligadas. Se emitido em um gerenciador de
domnio, a mensagem ser enviada a todos os agentes ligados em seu domnio e
domnios subordinados. Se emitido em uma estao de trabalho diferente de um
gerenciador de domnio, a mensagem ser enviada somente a seu gerenciador de
domnio, se este estiver ligado. A mensagem ser exibida somente se o nvel da
mensagem de console for maior que zero. Consulte console na pgina 342.
Se tellop for digitado sozinho, ele solicitar o texto da mensagem. No prompt,
digite cada linha e pressione a tecla Return. No final da mensagem, digite duas
barras (//) ou um ponto (.)e pressione a tecla Return. possvel utilizar a
seqncia de mudana de linha (\n) para formatar as mensagens. Digitar
Control+c a qualquer momento, sair do comando tellop sem enviar a mensagem.
Exemplos
Para enviar uma mensagem, execute o seguinte comando:
tellop TWS will be stopped at\n4:30 for 15 minutes.
Para solicitar texto antes de enviar uma mensagem, execute o seguinte comando:
436
to
TELLOP>*********************************
TELLOP>* TWS will be stopped at
*
TELLOP>* 4:30 for 15 minutes.
*
TELLOP>*********************************
TELLOP>//
unlink
Fecha links de comunicao entre estaes de trabalho.
Voc deve ter acesso unlink estao de trabalho de destino.
Sintaxe
unlink [domain!]workstation
[;noask]
Argumentos
domnio
Especifica o nome do domnio no qual os links devem ser fechados. No
necessrio especificar o nome de domnio de uma estao de trabalho no
domnio mestre. Caracteres curinga so permitidos.
Nota: Especifique sempre o nome de domnio quando desvincular uma
estao de trabalho que no esteja no domnio mestre.
Este argumento til quando se est desligando mais de uma estao de
trabalho em um domnio. Por exemplo, para desligar todos os agentes no
unlink stlouis!@
Se voc no especificar domain e workstation incluir caracteres curinga, o

estao de trabalho
Especifica o nome da estao de trabalho a ser desligada. Caracteres
|
|

remoto.
Comentrios
Supondo-se que um usurio tenha acesso unlink a estaes de trabalho sendo
desligadas, as seguintes regras sero aplicadas:
desvincular qualquer estao de trabalho na rede.
principal pode desvincular qualquer estao de trabalho em seu prprio
domnio e em domnios subordinados. O usurio no pode desligar estaes de
trabalho em domnios ponto a ponto.
437
v Um usurio executando o conman em um agente pode desvincular qualquer

estao de trabalho em seu domnio local, contanto que a estao de trabalho
seja um gerenciador de domnio ou um host. Um agente de perodo no mesmo
domnio no pode ser desvinculado.
Para obter informaes adicionais, consulte link na pgina 355.
Exemplos
A Figura 26 e a Tabela 60 mostram os links fechados pelos comandos unlink
executados pelos usurios em vrios locais da rede.
A11
A12
DM1
Domain1
User1
User3
User2
DM2
A21
DM3
A31
A22
A32
Domain3
Domain2
DM4
Domain4
A41
A42
Figura 26. Estaes de Trabalho de Rede Desvinculadas

Tabela 60. Estaes de Trabalho Desvinculadas
Comando
unlink @!@
Fechado pelo
Usurio1
Todos os links so
fechados
Fechado pelo
Usurio2
Fechado pelo
Usurio3
DM1-DM2
DM2-A21
DM2-A22
DM2-DM4
DM4-A41
DM4-A42
DM2-A21
DM1-DM2
DM2-A21
DM2-A22
DM2-DM4
DM2-A21
No permitido
No permitido
unlink @
DM1-A11
DM1-A12
DM1-DM2
DM1-DM3
unlink DOMAIN3!@
DM3-A31
DM3-A32
438
Tabela 60. Estaes de Trabalho Desvinculadas (continuao)

Fechado pelo
Usurio1
Fechado pelo
Usurio2
DM4-A41
DM4-A42
DM4-A41
DM4-A42
unlink DM2
DM1-DM2
No aplicvel
DM2-A21
unlink A42
DM4-A42
DM4-A42
No permitido
unlink A31
DM3-A31
No permitido
No permitido
Comando
Fechado pelo
Usurio3
No permitido
unlink DOMAIN4!@
Consulte tambm
predefinido
clique em OK
4. Selecione uma estao de trabalho e clique em Desvincular.
version
Exibe o banner do programa conman, inclusive da verso at o nvel de fix pack
instalado.
Sintaxe
{version | v}
Exemplos
Para exibir o banner do programa conman, execute o seguinte comando:
%version
A sada semelhante a esta:

TWS for UNIX/CONMAN 8.4 (1.36.2.22)
Materiais Licenciados Propriedade da IBM
5698-WKB
(C) Copyright IBM Corp 1998, 2007
Job stream (Exp) 11/26/06 (#34) on site3.
Batchman LIVES.Limit:19,Fence:0,Audit Level:0
439
440
Captulo 11. Utilizando Comandos Utilitrios

Este captulo descreve os comandos utilitrios do Tivoli Workload Scheduler. Esses
comandos, com exceo de StartUp e version, so instalados no diretrio
TWS_home/bin. StartUp instalado no diretrio TWS_home e version instalado no
diretrio TWS_home/version. Os comandos utilitrios so executados a partir do
prompt de comandos do sistema operacional.
|
|
Comandos utilitrios no so suportados em agentes dinmicos, conjuntos e

conjuntos dinmicos.
Descries dos comandos

A Tabela 61 contm a lista dos comandos utilitrios e, para cada um, sua descrio
e os sistemas operacionais suportados.
Tabela 61. Lista de Comandos Utilitrios
Sistema
Operacional
Comando
Descrio
at
Envia uma tarefa para ser executada em um

perodo especfico.
UNIX
batch
Envia uma tarefa para ser executada o mais

breve possvel.
UNIX
cpuinfo
Retorna informaes de uma definio de

estao de trabalho.
UNIX,
Windows
datecalc
Converte data e hora em um formato desejado
UNIX,
Windows
delete
Remove os arquivos de script e arquivos de lista UNIX,

padro por nome.
Windows
evtdef
Importa/exporta definies de evento

customizado.
UNIX,
Windows
evtsize
Define o tamanho mximo dos arquivos de

mensagens de eventos.
UNIX,
Windows
jobinfo
Retorna informaes sobre uma tarefa.
UNIX,
Windows
jobstdl
Retorna os nomes de caminhos de arquivos de

lista padro.
UNIX,
Windows
listproc
Lista processos. Esse comando no suportado.
Windows
killproc
Elimina processos. Esse comando no

suportado.
Windows
maestro
Retorna o diretrio home do Tivoli Workload

Scheduler.
UNIX,
Windows
makecal
Cria calendrios personalizados.
UNIX,
Windows
metronome.pl
substitudo por tws_inst_pull_info.
UNIX,
Windows
morestdl
Exibe o contedo de arquivos de lista padro.
UNIX,
Windows
441
Tabela 61. Lista de Comandos Utilitrios (continuao)

Sistema
Operacional
Comando
Descrio
parms
Exibe, altera e adiciona parmetros.
UNIX,
Windows
release
Libera unidades de um recurso.
UNIX,
Windows
rmstdlist
Remove arquivos de lista padro com base no

tempo.
UNIX,
Windows
sendevent
Envia os eventos genricos ao servidor do

processador de eventos atualmente ativo.
UNIX,
Windows
showexec
Exibe informaes sobre as tarefas em execuo.
UNIX
shutdown
Para o processo netman e, opcionalmente,

WebSphere Application Server.
UNIX,
Windows
ShutDownLwa
Para o agente dinmico localmente
UNIX,
Windows
Nota: Em
sistemas
UNIX, ele
pode ser
executado
apenas por
TWS_user ou
pelo usurio
root.
StartUp
Inicia o processo netman e, como opo, o

WebSphere Application Server.
UNIX,
Windows
StartUpLwa
Inicia o agente dinmico localmente
UNIX,
Windows
Nota: Em
sistemas
UNIX, ele
pode ser
executado
apenas por
TWS_user ou
pelo usurio
root.
tws_inst_pull_info
Coleta dados na instncia e estao de trabalho

local do Tivoli Workload Scheduler, no
WebSphere Application Server e no DB2 para
propsitos de diagnstico. Est documentado no
Tivoli Workload Scheduler: Guia de Resoluo de
Problemas.
UNIX,
Windows
verso
Exibe informaes sobre a verso.
UNIX
at e batch
Enviam comandos e tarefas ad hoc para serem ativados pelo Tivoli Workload
Scheduler.
Esses comandos so executados somente no UNIX.
442
Consulte at.allow e at.deny a seguir para obter informaes sobre a

disponibilidade aos usurios.
Sintaxe
at -V | -U
at {-s jstream | -q queue} time-spec
batch -V | -U
batch [-s jstream]
Argumentos
-V
-U
-s jstream
Especifica o jobstream_id da instncia do fluxo de tarefas na qual a tarefa
enviada. Se uma instncia de fluxo de tarefas com esse jobstream_id no
existir, criada uma nova instncia de tarefa tendo jstream como alias e
como jobstream_id. O nome deve iniciar com uma letra e pode conter
caracteres alfanumricos e traos. Ele pode conter at 16 caracteres.
Se os argumentos -s e -q forem omitidos, um nome de fluxo de tarefas ser
selecionado com base no valor da varivel de ambiente ATSCRIPT. Se
ATSCRIPT contiver a palavra maestro, o alias do fluxo de tarefas ser os
oito primeiros caracteres do nome do grupo do usurio. Se ATSCRIPT no
for configurado ou for configurado com um valor diferente de maestro, o
alias do fluxo de tarefas ser at (para tarefas enviadas com at) ou batch
(para tarefas enviadas com batch).
Consulte Outras Consideraes na pgina 445 para obter informaes
adicionais sobre fluxos de tarefas.
As palavras-chave a seguir aplicam-se somente s tarefas at:
-qqueue
Especifica para enviar a tarefa a um fluxo de tarefas com o nome queue,
que pode ser uma nica letra (a-z). Consulte Outras Consideraes na
pgina 445 para obter informaes adicionais sobre fluxos de tarefas.
time-spec
Especifica a hora em que a tarefa ser ativada. A sintaxe a mesma
utilizada com o comando UNIX at.
Comentrios
Aps digitar at ou batch, digite os comandos que constituem a tarefa. Termine
cada linha de entrada pressionando a tecla Return. A seqncia inteira termina
com fim-de-linha (geralmente, Control+d), ou digitando uma linha com um ponto
(.). Alternativamente, utilize um sinal de menor (<) para ler os comandos de um
arquivo. Consulte o Exemplos na pgina 444.
443
So enviadas informaes sobre as tarefas at e batch ao gerenciador de domnio

principal no qual as tarefas so includas nos fluxos de tarefas no plano de
produo, arquivo Symphony. As tarefas so ativadas com base nas dependncias
includas nos fluxos de tarefas.
O shell UNIX utilizado para tarefas enviadas com os comandos at e batch
determinado pela varivel SHELL_TYPE no script de configurao jobmanrc. No
utilize o shell C. Para obter informaes adicionais, consulte a Customizando o
Processamento da Tarefa em uma Estao de Trabalho UNIX - jobmanrc na pgina
43.
Depois de enviadas, as tarefas so ativadas da mesma maneira que as outras
tarefas planejadas. Cada tarefa executada no ambiente do usurio que est
enviando. Para assegurar que o ambiente esteja completo, so inseridos comandos
set no script para corresponder s definies de variveis no ambiente do usurio.
Exemplos
Para enviar uma tarefa em um fluxo de tarefas com jobstream_id sched8 para ser
ativada assim que possvel, execute o seguinte comando:
batch -s sched8
command <Return>
...
<Control d>
Para enviar uma tarefa para ser ativada duas horas depois da hora em que o
comando foi digitado, execute o seguinte comando:
at now + 2 hours
command <Return>
...
<Control d>
Se a varivel ATSCRIPT for nula, a tarefa enviada em um fluxo de tarefas com o

mesmo nome que o grupo do usurio. Caso contrrio, ele ser submetido a um
fluxo de job chamado at.
Para enviar uma tarefa em uma instncia de fluxo de tarefas com jobstream_id
sked-mis para ser ativada s 17h30, execute o seguinte comando:
at -s sked-mis 17h30
command <Return>
...
<Control d>
O comando a seguir o mesmo do comando anterior, exceto que os comandos da

tarefa so lidos em um arquivo:
at -s sked-mis 17h30 < ./myjob
O fato dos comandos serem lidos de um arquivo no altera seu modo de

processamento. Isto , os comandos so copiados do arquivo ./myjob para um
arquivo de script.
Substituindo os Comandos do UNIX

Os comandos at e batch padro do UNIX podem ser substitudos pelos comandos
do Tivoli Workload Scheduler. Os comandos a seguir mostram como substituir os
comandos at e batch do UNIX:
444
$
$
$
$
mv
mv
ln
ln
/usr/bin/at /usr/bin/uat
/usr/bin/batch /usr/bin/ubatch
-s TWShome/bin/at /usr/bin/at
-s TWShome/bin/batch /usr/bin/batch
Os Arquivos at.allow e at.deny

Os comandos at e batch utilizam os arquivos /usr/lib/cron/at.allow e
/usr/lib/cron/at.deny para restringir o uso. Se o arquivo at.allow existir,
somente os usurios listados no arquivo tero permisso para utilizar at e batch.
Se o arquivo no existir, at.deny ser verificado para saber se o usurio teve a
permisso negada explicitamente. Se nenhum dos arquivos existir, apenas o
usurio root ter permisso para utilizar os comandos.
Arquivos de Script
Os comandos digitados com at ou batch so armazenados em arquivos de script.
Os arquivos so criados pelo Tivoli Workload Scheduler utilizando a seguinte
conveno de nomenclatura:
TWS_home/atjobs/epoch.sss
onde:
epoch
O nmero de segundos desde 00:00, 1/1/70.
sss
Os trs primeiros caracteres do nome do fluxo de tarefas.
Nota: O Tivoli Workload Scheduler remove os arquivos de script para tarefas que
no tm o saldo transportado. No entanto, recomendvel monitorar o
espao em disco no diretrio atjobs e remover os arquivos antigos, se
necessrio.
Nomes de Tarefas
Todas as tarefas at e batch recebem nomes exclusivos do Tivoli Workload
Scheduler quando so enviadas. Os nomes consistem no ID do processo (PID) do
usurio precedido pelo nome do usurio truncado de forma que no exceda oito
caracteres. O nome resultante organizado em ordem crescente.
Outras Consideraes
v Os fluxos de tarefas aos quais as tarefas at e batch so enviadas devem ser
criados antecipadamente com o composer. Os fluxos de tarefas podem conter
dependncias que determinam quando as tarefas sero ativadas. No mnimo, os
fluxos de job devem conter a palavra-chave carryforward. Isso assegura que as
tarefas que no so concludas ou no so ativadas enquanto o plano de
produo atual est em processo tenham o saldo transportado para o prximo
plano de produo.
v Inclua a expresso on everyday para que os fluxos de tarefas sejam selecionados
todos os dias.
v Utilize a palavra-chave limit para limitar o nmero de tarefas enviadas que
podem ser executadas simultaneamente.
v Utilize a palavra-chave priority para definir a prioridade de tarefas enviadas em
relao a outras tarefas.
Se o valor de tempo for menor do que a hora atual, ele ser considerado como
para o dia seguinte. Se o valor de tempo for maior do que a hora atual, ele ser
considerado como para o dia atual.
445
cpuinfo
Retorna informaes de uma definio de estao de trabalho.
Sintaxe
cpuinfo -V | -U
cpuinfo workstation [infotype] [...]
|
Argumentos
-V
-U
estao de trabalho
|
infotype
|
|
O tipo de informao a ser exibida. Especifica um ou mais dos seguintes:
|
|
|
|
|
os_type
|
|
|
|
|
|
|
Retorna o valor do campo node. Para um servidor do Workload

Broker, o nome do host ou o endereo TCP/IP da estao de
trabalho onde o Tivoli Workload Scheduler Bridge foi instalado.
Para uma estao de trabalho do mecanismo remoto, o nome do
host da estao de trabalho onde o mecanismo remoto est
instalado. Em qualquer outro caso, especifique o nome do host ou
o endereo TCP/IP da estao de trabalho.
|
|
|
|
|
|
|
porta
Retorna o valor do campo tcpaddr. Se voc estiver definindo uma

estao de trabalho do workload broker, especifique o valor da
propriedade TWS.Agent.Port do arquivo
TWSAgentConfig.properties. Para estaes de trabalho de
mecanismo remoto, o valor desse campo ;e o nmero da porta
HTTP usado pelo mecanismo remoto. Se o protocolo HTTPS for
usado, o valor desse campo 31111.
|
|
|
|
|
|
sslport
|
|
|
engineaddr
Para qualquer tipo de estaes de trabalho, o valor desse campo
0.
|
|
|
|
|
protocol
Retorna o valor do campo protocol: HTTP ou HTTPS. Quando o
tipo de estao de trabalho mecanismo remoto, esse valor indica
o protocolo usado para se comunicar entre o servidor broker e o
mecanismo remoto.
Retorna o valor do campo os: UNIX, WNT, ZOS, OTHER e IBM i.

O valor ZOS aplica-se somente a estaes de trabalho de
mecanismo remoto usadas para se comunicarem com um
controlador do Tivoli Workload Scheduler para z/OS.
Retorna o valor do campo secureaddr. a porta usada para

atender conexes SSL recebidas. Para estaes de trabalho de
mecanismo remoto, o valor desse campo ;e o nmero da porta
HTTPS usado pelo mecanismo remoto. Se o protocolo HTTP for
usado, o valor desse campo 31113.
446
|
|
|
sec_level
Retorna o valor do campo securitylevel: ENABLED, ON ou
FORCE.
|
|
autolink
Retorna o valor do campo autolink: ON ou OFF.
|
|
fullstatus
Retorna o valor do campo fullstatus: ON ou OFF.
|
|
resolvedep
Retorma ON ou OFF. No mais usado na verso 8.6.
|
|
behindfirewall
Retorna o valor do campo behindfirewall: ON ou OFF.
|
|
host
|
|
domnio
Retorna o valor do campo domain.
|
|
|
ID
|
|
|
mtodo
|
|
servidor
Retorna o valor do campo server.
|
|
|
tipo
|
|
|
|
|
time_zone
Retorna o valor do ccampo timezone. Mostra o fuso horrio da
estao de trabalho. Para um agente estendido, o campo fica em
branco. Para uma estao de trabalho de mecanismo remoto, esse
o fuso horrio do mecanimso remoto.
|
|
|
verso Retorna a verso do Tivoli Workload Scheduler que est em

execuo na estao de trabalho. Para um agente estendido, o
campo fica em branco.
|
|
|
|
info
Retorna o valor do campo host. o nome da estao de trabalho

hosting o agente.
Retorna o identificador do agente usado pela estao de trabalho

ao conectar ao servidor broker. Para estao de trabalho com tipo:
AGENT, REM-ENG, POOL, D-POOL.
Somente para agentes estendidos e de rede. Retorna o valor do
campo access.
Retorna o valor do campo type. Mostra o tipo de estao de

trabalho: MASTER, MANAGER, FTA, S-AGENT, REM-ENG,
AGENT, POOL, D-POOL e X-AGENT.
Retorna a verso do sistema operacional e o modelo de estao de

trabalho. Para agentes estendidos, o campo est em branco. Para
estaes de trabalho do mecanismo remoto, esse campo exibe
Mecanismo Remoto.
Comentrios
Os valores so retornados, um em cada linha, na mesma ordem em que os
argumentos foram digitados na linha de comandos. Se nenhum argumento for
especificado, todas as informaes aplicveis sero retornadas com etiquetas, uma
em cada linha.
Exemplos
Os exemplos a seguir baseiam-se na seguinte definio de estao de trabalho:
447

Domain
---------------- ------- ---------------RE-ZOS
REM-ENG -
---------- -----------------09/06/2010 -
CPUNAME RE-ZOS
OS ZOS
NODE 9.168.119.189 TCPADDR 635
TYPE REM-ENG
PROTOCOL HTTP
END
Para imprimir tipo e protocolo para a estao de trabalho RE-ZOS, execute o

comando a seguir:
>cpuinfo RE-ZOS type protocol
REM-ENG
HTTP
Para imprimir todas as informaes para a estao de trabalho RE-ZOS, execute o

comando a seguir:
>cpuinfo RE-ZOS
OS_TYPE: ZOS
NODE: 9.168.119.189
PORT: 635
SSLPORT: 31113
ENGINEADDR: 0
PROTOCOL: HTTP
AUTOLINK: OFF
FULLSTATUS: OFF
RESOLVEDEP: OFF
BEHINDFIREWALL: OFF
HOST: NC123162_DWB
DOMAIN: MASTERDM
ID: D795263CBCD2365CA7B5C5BC0C3DD363
SERVER:
TYPE: REM-ENG
TIME_ZONE: Europe/Rome
VERSION: 8.6
INFO: Remote Engine
datecalc
Resolve expresses de datas e retorna datas nos formatos escolhidos.
Sintaxe
datecalc -V | -U
datecalc base-date
[offset]
[pic format]
[freedays Calendar_Name [-sa] [-su]]
datecalc -t time
[base-date]
[offset]
[pic format]
datecalc yyyymmddhhtt
[offset]
[pic format]
448
Argumentos
-V
-U
base-date
day | date | today | tomorrow | scheddate
onde:
day
Especifica um dia da semana. Os valores vlidos so: su, mo, tu,

we, th, fr ou sa.
date
Especifica uma data, no formato element/element[/element], em que

element : d[d], m[m] e yy[yy]. Qualquer formato diferente de data
no vlido.
Se forem utilizados dois dgitos para o ano (yy), um nmero
superior a 70 ser uma data do sculo 20 e um nmero inferior a
70 ser uma data do sculo 21.
O parmetro se refere data real, no ao comando date do UNIX.
O exemplo a seguir mostra uma opo de usar a sada do
comando date do UNIX como entrada para o parmetro date do
|
|
|
|
|
|
|
hdate=udate +"%m/%d/%y"u
echo $hdate
datecalc $hdate pic mm/dd/yyyy
Os valores vlidos para o ms (m[m]) so jan, feb, mar, apr, may,

jun, jul, aug, sep, oct, nov ou dec.
As barras (/) podem ser substitudas por traos (-), pontos (.),
vrgulas (,) ou espaos. Por exemplo, qualquer um dos seguintes
pode ser digitado para 28 de maro de 2005:
03/28/05
3-28-2005
28.mar.05
05,28,3
mar 28 2005
28 3 05
Se forem utilizados nmeros, possvel que a data digitada seja
ambgua, por exemplo, 2,7,04. Neste caso, datecalc utiliza o
formato de data definido no catlogo de mensagens do Tivoli
Worload Scheduler para interpret-la. Se a data no corresponder
ao formato, uma mensagem de erro ser gerada por datecalc.
today
Especifica a data atual do sistema.
tomorrow
Especifica a data atual do sistema mais um dia, ou, no caso de
clculos de horas, mais 24 horas.
scheddate
Especifica a data do plano de produo. Pode no ser a mesma
data do sistema. Quando utilizado dentro de tarefas em um fluxo
de tarefas que no um fluxo de tarefas transportado, retorna a
449
data de quando a tarefa deve ser executada, que poderia ser

diferente da data de produo do fluxo de tarefas se a tarefa tiver
uma dependncia at especificada.
Quando utilizado dentro de tarefas em um fluxo de tarefas
transportado, retorna a data de quando a tarefa deveria ter sido
executada, que poderia ser diferente da data de produo do fluxo
de tarefas transportado se a tarefa tiver uma dependncia at
especificada. Se a dependncia at for utilizada com a seguinte
sintaxe: at=hhmm + n days, n days no sero includos na varivel
TIVOLI_JOB_DATE e, portanto, o comando datecalc no relatar
esses dias.
-t time [base-date]
Especifique time em um dos seguintes formatos:
now | noon | midnight | [h[h][[:]mm] [am | pm] [zulu]
onde:
now
Especifica a data e hora atuais do sistema.
noon
Especifica 12h (ou 1200).
midnight
Especifica 24h (ou 2400).
h[h][[:]mm]
Especifica a hora e os minutos em 12 horas (se am ou pm for
utilizado), ou 24 horas. O delimitador opcional de dois-pontos (:)
pode ser substitudo por um ponto (.), uma vrgula (,), um
apstrofo ('), pela letra h, ou por um espao. Por exemplo,
qualquer um dos seguintes pode ser digitado para 20h:
8:00pm
20:00
0800pm
2000
8pm
20
8,00pm
20.00
8\'00pm
20 00
zulu
Especifica que a hora digitada a hora de Greenwich (Hora

Coordenada Universal). datecalc a converte na hora local.
yyyymmddhhtt
Especifica o ano, ms, dia, hora e minuto expresso em exatamente doze
dgitos. Por exemplo, para 2005, 7 de maio, 9h15, digite o seguinte:
200505070915
deslocamento
Especifica um deslocamento de base-date no seguinte formato:
{[+ | > | - | < number | nearest] |
next} day[s] | weekday[s] |
workday[s] | week[s] | month[s] | year[s] | hour[s] | minute[s] |
day | calendar
450
onde:
+|>
Especifica um deslocamento para uma data ou hora posterior.

Utilize + (Mais) no Windows; utilize > (maior que) no UNIX.
Certifique-se de incluir uma barra invertida (\) antes do sinal de
maior (>).
-|<
Especifica um deslocamento para uma data ou hora anterior.

Utilize - (Menos) no Windows; utilize < (menor que) no UNIX.
Certifique-se de incluir uma barra invertida (\) antes do sinal de
maior (>).
nmero
O nmero de unidades do tipo especificado.
nearest
Especifica um deslocamento para a ocorrncia mais prxima do
tipo de unidade (anterior ou posterior).
next
Especifica a prxima ocorrncia do tipo de unidade.
day[s] Especifica todos os dias.

weekday[s]
Especifica todos os dias, exceto sbado e domingo.
workday[s]
O mesmo de weekday[s], mas tambm exclui as datas do
calendrio holidays.
week[s]
Especifica sete dias.
month[s]
Especifica os meses do calendrio.
year[s]
Especifica os anos do calendrio.
hour[s]
Especifica as horas do relgio.
minute[s]
Especifica os minutos do relgio.
day
Especifica um dia da semana. Os valores vlidos so: su, mo, tu,

we, th, fr ou sa.
calendrio
Especifica as entradas em um calendrio com este nome.
pic format
Especifica o formato em que a data e hora so retornados. Os caracteres de
format so os seguintes:
m
Nmero do ms.
Nmero do dia.
Nmero do ano.
Nmero do dia Juliano.
Nmero da hora.
Nmero do minuto.
451
^|/
Um espao. Utilize / (barra) no Windows; utilize ^ (acento

circunflexo) no UNIX (inclua uma barra invertida (\) antes do
acento circunflexo (^) se estiver no shell Bourne).
Caracteres de pontuao tambm podem ser includos. Eles funcionam da

mesma forma que os delimitadores utilizados em date e time.
Se um formato no for definido, datecalc retornar a data e hora no
formato definido pelas variveis de ambiente NLS (Native Language
Support). Se as variveis NLS no forem definidas, o idioma nativo ser
padronizado como C.
dias livres
Especifica o nome de um calendrio de dias livres Nome_do_Calendrio que
deve substituir feriados na avaliao de dias teis.
Nesse caso, dias teis avaliado como todos os dias excluindo sbado,
domingo e todas as datas listadas em Nome_do_Calendrio.
Por padro, sbado e domingo no so considerados dias teis, a no ser que
seja explicitamente especificado de outra forma incluindo-se -sa e -su
depois de Calendar_Name.
Tambm possvel especificar feriados como o nome do calendrio de dias
livres.
Exemplos
Para retornar a prxima data, a partir de hoje, no calendrio monthend, execute o
seguinte comando:
>datecalc today next monthend
Nos exemplos a seguir, a data atual do sistema sexta-feira, 16 de abril de 2006.

>datecalc today +2 days pic mm/dd/yyyy
04/16/2006
>datecalc today next tu pic yyyy\^mm\^dd
2006 04 16
>LANG=american;export LANG
>datecalc -t 14:30 tomorrow
Sat, Apr 17, 2006 02:30:00 PM
>LANG=french;datecalc -t 14:30 tomorrow
Samedi 17 avril 2006 14:30:00
No exemplo a seguir, a hora atual do sistema 10:24h.

>datecalc -t now \> 4 hours pic hh:tt
14:24
excluir
Remove arquivos. Embora o objetivo desse arquivo seja remover arquivos de lista
padro, sugerimos a utilizao do comando rmstdlist no lugar. Os usurios
maestro e root no UNIX e Administrator no Windows podem remover qualquer
arquivo. Outros usurios podem remover somente os arquivos associados a seus
prprios jobs.
452
Sintaxe
delete -V | -U
delete filename
Argumentos
-V
-U
nome do arquivo
Especifica o nome do arquivo ou grupo de arquivos a serem removidos. O
nome dever ser colocado entre aspas (") se contiver caracteres diferentes
do seguinte: alfanumricos, traos (-), barras (/), barras invertidas (\) e
Nota: Utilize esse comando com cuidado. O uso inadequado de caracteres curinga
poder resultar na remoo acidental de arquivos.
Exemplos
Para remover todos os arquivos de lista padro em 4/11/04:
delete d:\win32app\maestro\stdlist\2004.4.11\@
O script a seguir, includo em uma tarefa planejada no UNIX, remove o arquivo de

lista padro da tarefa se no houver nenhum erro:
...
#Remover a stdlist deste job:
if grep -i error $UNISON_STDLIST
then
exit 1
else
`maestro`/bin/delete $UNISON_STDLIST
fi
...
O script de configurao padro, jobmanrc, define a varivel UNISON_STDLIST

com o nome do arquivo de lista padro do job. Para obter informaes adicionais
sobre jobmanrc, consulte Customizando o Processamento da Tarefa em uma
Estao de Trabalho UNIX - jobmanrc na pgina 43.
evtdef
Importa/exporta um arquivo de definio XML do provedor de eventos genricos
em que possvel incluir e modificar tipos de evento customizado. possvel,
ento, utilizar o comando sendevent para enviar esses eventos para o servidor de
Sintaxe
evtdef -U | -V
evtdef [connection parameters] dumpdef file-path
evtdef [connection parameters] loaddef file-path
453
Argumentos
-U
-V
parmetros de conexo
Se estiver usando evtdef a partir do gerenciador de domnio principal, os
parmetros de conexo foram configurados na instalao e no precisam
Se estiver usando evtdef a partir do cliente da linha de comandos em
comando
dumpdef file-path
Transfere por download o arquivo XML do provedor de eventos genricos.
O arquivo transferido por download com o nome o caminho de arquivo
fornecidos por voc em file-path. possvel editar o arquivo para incluir
seus prprios tipos de evento customizado.
o nome do provedor de eventos genricos fornecido com o produto
GenericEventPlugIn. possvel alterar seu nome pela tag name da
palavra-chave eventPlugin.
Importante: Voc deve utilizar esse nome como o valor:
v Da palavra-chave source do comando sendevent na
pgina 471
v Da palavra-chave eventProvider na definio das regras de
eventos emitidas por esses eventos customizados.
loaddef file-path
Transfere por upload o arquivo XML modificado do provedor de eventos
genricos a partir do arquivo e caminho fornecidos por voc em file-path.
Comentrios
Os esquemas de linguagem de regra a seguir so utilizados para validar suas
definies de evento customizado e, dependendo do editor XML que voc possua,
para fornecer ajuda de sintaxe:
v eventDefinitions.xsd
v common.xsd
Os arquivos esto localizados no subdiretrio schemas do diretrio de instalao do
454
Exemplos
Neste exemplo, voc:
1. Transfere por download o arquivo XML do provedor de eventos genricos
como o arquivo c:\custom\myevents.xml
evtdef dumpdef c:\custom\myevents.xml
2. Edita o arquivo para incluir suas prprias definies de tipo de evento. A

primeira vez em que voc fizer o download do arquivo do provedor de eventos
genricos, ele ter a seguinte aparncia:
<eventDefinitions
xmlns="http://www.ibm.com/xmlns/prod/tws/1.0/event-management/plugins/events"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.ibm.com/xmlns/prod/tws/1.0/event-management/
plugins/events/eventDefinitions.xsd" >
<eventPlugin>
<complexName displayName="Custom event" name="GenericEventPlugIn" />
<scopes>
<scope name="Generic">
<scopedef text="{Param1} on {Workstation}" />
</scope>
</scopes>

<event baseAliasName="genericEvt" scope="Generic">
<complexName displayName="Generic event" name="Event1" />
<displayDescription>The event is sent when the specified expression is
matched.</displayDescription>
<property type="string" required="true" wildcardAllowed="true"
multipleFilters="true" minlength="1">
<complexName displayName="Parameter 1" name="Param1" />
<displayDescription>The value of parameter 1</displayDescription>
</property>
<property type="string" required="true" wildcardAllowed="false"
multipleFilters="false" minlength="1>
<complexName displayName="Workstation" name="Workstation" />
<displayDescription>The workstation for which the event is
generated.</displayDescription>
</property>
</event>
</eventPlugin>
</eventDefinitions>
3. Ao concluir, transfira por upload o arquivo XML do provedor de eventos

genricos a partir do arquivo c:\custom\myevents.xmll
evtdef loaddef c:\custom\myevents.xml
evtsize
Define o tamanho dos arquivos de mensagens do Tivoli Workload Scheduler. Esse
comando utilizado pelo administrador do Tivoli Workload Scheduler para
aumentar o tamanho de um arquivo de mensagem aps o recebimento da
mensagem Fim do arquivo de eventos. ou para monitorar o tamanho da fila de
mensagens contida no arquivo de mensagens. Voc deve ser maestro ou root no
UNIX ou Administrator no Windows para executar evtsize. Pare o mecanismo do
IBM Tivoli Workload Scheduler antes de executar esse comando.
Sintaxe
evtsize -V | -U
evtsize filename size
455
evtsize -compact filename [size]

evtsize -info filename
evtsize -show filename
evtsize -info | -show pobox
Argumentos
-V
-U
-compact filename [size]

Reduz o tamanho do arquivo de mensagens especificado para o tamanho
ocupado pelas mensagens presentes no momento que o comando
executado. possvel usar como opo essa palavra-chave para tambm
especificar um novo tamanho de arquivo.
-info filename
Exibe o uso da porcentagem da fila de mensagens contida no no arquivo
de mensagens.
-show filename
Exibe o tamanho da fila de mensagens contida no arquivo de mensagem
nome do arquivo
O nome do arquivo de evento. Especifique um dos seguintes:
|
|
|
|
|
Courier.msg
Intercom.msg
Mailbox.msg
Planbox.msg
pobox/workstation.msg
tamanho
O tamanho mximo do arquivo de evento em bytes. No deve ser menos
que 1048576 bytes (1 MB).
Quando construdo pela primeira vez pelo Tivoli Workload Scheduler, o
tamanho mximo definido para 10 MB.
Nota: O tamanho do arquivo de mensagens igual ou maior do que o
tamanho real da fila de mensagens contida e aumenta
progressivamente at que a fila de mensagens fique vazia; quando
isso ocorre, o arquivo de mensagens esvaziado.
-info | -show pobox
Exibe o nome do arquivo de mensagens no diretrio pobox, com o maior
tamanho de fila calculado como uma porcentagem do tamanho total do
arquivo. O nome do arquivo e a porcentagem usados so retornados. -info
e -show retornam os mesmos resultados.
Exemplos
Para definir o tamanho mximo do arquivo Intercom.msg para 20 MB, execute o
seguinte comando:
evtsize Intercom.msg 20000000
456
Para definir o tamanho mximo do arquivo pobox da estao de trabalho chicago

para 15 MB, execute o seguinte comando:
evtsize pobox\chicago.msg 15000000
O seguinte comando:
evtsize -show Intercom.msg
retorna a seguinte sada:

Tivoli Workload Scheduler (UNIX)/EVTSIZE 8.3 (1.2.2.4) Materiais Licenciados Propriedade da IBM(R)
5698-WSH
(C) Direitos Autorais da IBM Corp 1998, 2006 Todos os direitos reservados.
AWSDEK703I Tamanho da fila atual 240, nmero mximo de bytes 10000000
(leitura 48, gravao 288)
onde:
880
10000000
read 48
write 928
o tamanho da fila atual do arquivo Intercom.msg

o tamanho mximo do arquivo Intercom.msg
posio do ponteiro para ler registros.
posio do ponteiro para gravar registros.
Se o comando a seguir:
evtsize -info Mailbox.msg
retornar:
25
significa que 25 por centro do arquivo foi usado.
jobinfo
|
|
|
Utilizado em um script de job para retornar informaes sobre o job. Este comando
no suportado em agentes dinmicos, conjuntos, conjuntos dinmicos e Tipos de
tarefas com opes avanadas.
Sintaxe
jobinfo -V | -U
jobinfo job-option [...]
Argumentos
-V
-U
job-option
A opo de job. Especifica um ou mais dos seguintes:
457
confirm_job
Retornar YES se o job requerer confirmao.
is_command
Retornar YES se o job tiver sido planejado ou submetido com a
construo docommand.
job_name
Retorna o nome do job sem os nomes da estao de trabalho e do
fluxo de job.
job_pri
Retorna o nvel de prioridade do job.
programmatic_job
Retorna YES se a tarefa tiver sido enviada com a utilizao do
comando at ou batch. Somente para o UNIX.
re_job Retornar YES se a tarefa estiver sendo reexecutada como
resultado de um comando rerun do conman, ou da opo de
recuperao de reexecuo.
re_type
Retornar a opo de recuperao do job (stop, continue ou rerun).
rstrt_flag
Retornar YES se o job estiver sendo executado como o job de
recuperao.
rstrt_retcode
Se o job atual for um job de recuperao, retornar o cdigo de
retorno do job pai.
planejamento
Retorna o nome do fluxo de tarefas no qual a tarefa enviada.
schedule_ia
Retorna a hora e data que o fluxo de tarefas est planejado para
iniciar.
schedule_id
Retorna o jobstream_ID do fluxo de tarefas no qual a tarefa
enviada.
time_started
Retorna a hora em que o job iniciou sua execuo.
Comentrios
Os valores de opo do job so retornados, um em cada linha, na mesma ordem
em que foram solicitados.
Exemplos
1. O arquivo de script /jcl/backup referenciado duas vezes, fornecendo-lhe os
nomes de job partback e fullback. Se o job for executado como partback, ele
executar um backup parcial. Se for executado como fullback, executar um
backup completo. No script, os comandos como os seguintes so utilizados
para fazer a distino:
#Determinar parcial (1) ou completo (2):
if [ "`\`maestro\`/bin/jobinfo job_name`" = "PARTBACK" ]
then
bkup=1
458
else
bkup=2
fi
...
2. Para exibir o cdigo de retorno do job pai, se o job atual for um job de
recuperao, execute o seguinte comando:
$ jobinfo rstrt_retcode
O primeiro job (job pai) foi definido no script recovery.sh, enquanto que o
segundo (job de recuperao) ser ativado apenas se o primeiro terminar de
forma anormal.
Quando combinados com uma condio de cdigo de retorno, jobinfo
rstrt_retcode pode ser utilizado para direcionar o job de recuperao para
executar aes diferentes, dependendo do cdigo de retorno do job pai. O
exemplo a seguir mostra um job de recuperao:
$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))"
Nota: A tarefa definida com a ao de recuperao RERUN. Isso permite que

o job de recuperao execute aes corretivas antes que o job pai tente
executar novamente.
O prprio job de recuperao definido conforme mostrado no exemplo a
seguir:
$ JOBS
MASTER#RECOVERY DOCOMMAND "^TWSHOME^/scripts/recovery.sh"
STREAMLOGON "^TWSUSER^"
DESCRIPTION "populate database recovery manual"
RECOVERY STOP
jobstdl
Retorna os nomes de arquivos de lista padro. Esse comando deve ser executado
pelo usurio para o qual o Tivoli Workload Scheduler foi instalado. Se voc utilizar
esse comando sem parmetros, assegure-se de ter feito logon como usurio do
Sintaxe
jobstdl -V | -U
jobstdl
[-day num]
[{-first | -last | -num n | -all}]
[-twslog]
[{-name ["jobstreamname [(hhmm date),(jobstream_id)].]jobname"
| jobnum |
-schedid jobstream_id.jobname}]
Argumentos
-V
-U
459
-day num
Retorna os nomes de arquivos de lista padro que so os nmeros
especificados de dias anteriores (1 para ontem, 2 para anteontem, e assim
por diante). O padro zero (hoje).
-first
Retorna o nome do primeiro arquivo de lista padro qualificado.
-last
Retorna o nome do ltimo arquivo de lista padro qualificado.
-num n
Retorna o nome do arquivo de lista padro da execuo especificada de
um job.
-all
Retorna o nome de todos os arquivos de lista padro qualificados.
-twslog
Retorna o caminho do arquivo stdlist do dia atual.
-name ["jobstreamname[(hhmm date), (jobstream_id)].]jobname" | jobnum
Especifica a instncia do fluxo de tarefas e o nome da tarefa para os quais
nomes de arquivos de lista padro so retornados.
jobnum
Especifica o nmero do job para o qual os nomes do arquivo de lista
padro so retornados.
-schedid jobstream_id.jobname
Especifica o ID do fluxo de tarefas e o nome da tarefa para a qual os
nomes de arquivo da lista padro so retornados.
Comentrios
Os nomes de arquivos so retornados em um formato adequado para entrada de
outros comandos. So retornados vrios nomes separados por um espao.
Ao usar a sintaxe integral do argumento -name, os colchetes na expresso [(hhmm
date), (jobstream_id)] fazem parte do comando, no so indicadores de sintaxe.
Alm disso, toda a sequncia de identificao da tarefa deve ser colocada entre
aspas duplas se a parte que identifica a instncia do fluxo de tarefas contiver
espaos em branco. Por exemplo, como o schedtime, representado por hhmm date,
possui um espao, voc deve colocar a identificao da tarefa inteira entre aspas
duplas.
Tambm possvel executar verses abreviadas do argumento -name usando uma
sintaxe mais simples. Se quiser sadas menos especficas do comando, possvel
especificar apenas schedtime (a data no necessria se for para o mesmo dia) ou
jobstream_id juntamente com jobname. Desde que no haja espaos em branco nos
argumentos, possvel omitir as aspas duplas. Tambm possvel omitir os
colchetes se voc no especificar schedtime e jobstream_id.
Os exemplos a seguir mostram a sintaxe que voc deve usar com o argumento
-name para os diferentes tipos de informaes que espera em retorno, desde as
mais especficas at as mais gerais. No exemplo, job_stream1 o nome do fluxo de
tarefas, 0600 04/05/06 a hora planejada, 0AAAAAAAAAAAAAB5 o ID do fluxo de
tarefas e job1 o nome da tarefa. O nmero de tarefa de job1 310. possvel
executar jobstdl para job1 da seguinte forma:
jobstdl -name "job_stream1[(0600 04/05/10),(0AAAAAAAAAAAAAB5)].job1"
Retorna o nome do arquivo de lista padro job1 para a instncia especfica

job_stream1 com schedtime e jobstream_id especificados.
460
jobstdl -name job_stream1(0AAAAAAAAAAAAAB5).job1
Retorna o nome do arquivo de lista padro para job1 para a instncia job_stream1
com ID 0AAAAAAAAAAAAAB5.
jobstdl -name "job_stream1(0600 04/05/10).job1"
Retorna os nomes de arquivos de lista padro para job1 para todas as instncias
possveis de job_stream1 programadas para execuo s 6h de 05/04/10.
jobstdl -name job_stream1(0600).job1
Retorna os nomes de arquivos de lista padro para job1 para todas as instncias
possveis de job_stream1 programadas para execuo s 6h do dia atual.
jobstdl -name 310
Retorna os nomes de arquivos da lista padro para job1 para todas as instncias
que tinham nmero de tarefa 310.
Exemplos
Para retornar os nomes de caminhos de todos os arquivos de lista padro do dia
atual, execute o seguinte comando:
jobstdl
Para retornar o nome do caminho da lista padro para a primeira execuo da

tarefa MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR no dia atual, execute
o seguinte comando:
jobstdl -first -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
Para retornar o nome do caminho da lista padro para a primeira execuo da

tarefa 0AAAAAAAAAAAAAEE.DIR no dia atual, execute o seguinte comando:
jobstdl -first -schedid 0AAAAAAAAAAAAAEE.DIR
Para retornar o nome do caminho da lista padro para a segunda execuo da

tarefa MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR no dia atual, execute
o seguinte comando:
jobstdl -num 2 -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
Para retornar os nomes de caminho dos arquivos de lista padro para todas as
execues da tarefa MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR de trs
dias atrs, execute o seguinte comando:
jobstdl -day 3 -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
Para retornar o nome do caminho da lista padro para a ltima execuo da tarefa
MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR de quatro dias atrs,
jobstdl -day 4 -last -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
Para retornar o nome do caminho da lista padro do job nmero 455, execute o
seguinte comando:
jobstdl 455
Para imprimir o contedo do arquivo de lista padro do job nmero 455, execute o
seguinte comando:
461
cd `maestro`/bin
lp -p 6 `jobstdl 455`
maestro
Retorna o nome do caminho do diretrio home do Tivoli Worload Scheduler,
referido como TWS_home.
Sintaxe
maestro [-V | -U]
Argumentos
-V
-U
Exemplos
Para exibir o diretrio home do Tivoli Workload Scheduler, execute o seguinte
comando:
$ maestro
/usr/lib/maestro
Para alterar o diretrio para o diretrio home do Tivoli Workload Scheduler,

$ cd `maestro`
makecal
Cria um calendrio personalizado. No UNIX, o shell Korn necessrio para
executar esse comando.
Sintaxe
makecal [-V | -U]
makecal
[-c name]
-d n
| -e
| {-f 1 | 2 | 3 -s date}
| -l
| -m
| -p n
| {-r n -s date}
| -w n
[-i n]
[-x | -z]
[-freedays Calendar_Name [-sa] [-su]]
Argumentos
-V
-U
-c name
Especifica um nome para o calendrio. Palavras-chave do Tivoli Workload
462
Scheduler (como Freedays ou Schedule) no podem ser utilizadas como

nomes de calendrio. O nome pode conter at oito caracteres alfanumricos
e deve iniciar com uma letra. No utilize os nomes de dias da semana para
nomes de calendrio. O nome padro : Chhmm, em que hhmm a hora e
minutos atuais.
-d n
Especifica o ensimo dia de cada ms.
-e
Especifica o ltimo dia de cada ms.
-f 1 | 2 | 3
Cria um calendrio fiscal de final de ms contendo o ltimo dia do ms
fiscal. Especifique um dos seguintes formatos:
1
formato de semana 4-4-5
Esse argumento requer o argumento -s.

-i n
Especifica para inserir n datas no calendrio.
-l
Especifica o ltimo dia til de cada ms. Para esse argumento funcionar
adequadamente, o plano de produo (arquivo Symphony) e o calendrio
holidays j devero existir.
Nota: O uso desse argumento resulta na incluso pelo novo calendrio do
ltimo dia til do ms anterior data de criao do calendrio.
-m
Especifica o primeiro e o dcimo quinto dias de cada ms.
-p n
Especifica o dia til antes do ensimo dia de cada ms. Para esse
argumento funcionar adequadamente, o plano de produo (arquivo
Symphony) e o calendrio holidays j devero existir
-r n
Especifica todo ensimo dia. Esse argumento requer o argumento -s.
-s date Especifica a data de incio para os argumentos -f e -r. A data deve ser
colocada entre aspas e deve ser vlida e no-ambgua, por exemplo, utilize
JAN 10 2005, no 1/10/05. Consulte base-date para datecalc na pgina 449
para obter mais informaes sobre os formatos de datas.
-w n
Especifica o dia til aps o ensimo dia do ms. Para esse argumento
funcionar adequadamente, o plano de produo (arquivo Symphony) e o
calendrio holidays j devero existir.
-x
Envia a sada do calendrio para stdout em vez de inclui-la no banco de

dados.
-z
Inclui o calendrio no banco de dados e compila o plano de produo

(arquivo Symphony).
Nota: Esse argumento reenvia tarefas e fluxos de tarefas do plano de
produo do dia atual. Talvez seja necessrio cancelar fluxos de job e
jobs.
-freedays
Especifica o nome de um calendrio de dias livres Nome_do_Calendrio que
deve substituir feriados na avaliao de dias teis.
Nesse caso, dias teis avaliado como todos os dias excluindo sbado,
domingo e todas as datas listadas em Nome_do_Calendrio.
463
Por padro, sbado e domingo no so considerados dias teis, a no ser que

seja explicitamente especificado de outra forma incluindo-se -sa e/ou -su
depois de Calendar_Name .
Tambm possvel especificar feriados como o nome do calendrio de dias
livres.
Essa palavra-chave afeta o processamento de makecal com as opes -l, -p
e -w.
Exemplos
Para criar um calendrio de dois anos com o ltimo dia de cada ms selecionado,
makecal -e -i 24
Para criar um calendrio com 30 dias que comea em 30 de maio de 2005 e com
cada terceiro dia selecionado, execute o seguinte comando:
makecal -r 3 -s "30 MAY 2005" -i 30
metronome
Metronome substitudo por tws_inst_pull_info. Consulte o Guia de Resoluo de
Problemas do IBM Tivoli Workload Scheduler para obter informaes sobre esse
comando.
morestdl
Exibe o contedo de arquivos de lista padro. Esse comando deve ser executado
pelo usurio para o qual o Tivoli Workload Scheduler foi instalado. Se voc utilizar
esse comando sem parmetros, assegure-se de ter feito logon como usurio do
Tivoli Workload Scheduler. Este comando suportado para agentes tolerantes a
falha e agentes padro.
|
|
|
|
|
Sintaxe
morestdl -V | -U
morestdl
[-day num]
[-first | -last | -num n | -all]
[-twslog]
[{-name ["jobstreamname [(hhmm date),(jobstream_id)].]jobname"
| jobnum |
Argumentos
-V
-U
-day num
Exibe arquivos de lista padro que so os nmeros especificados de dias
anteriores (1 para ontem, 2 para anteontem, e assim por diante). O padro
zero (hoje).
464
-first
Exibe o primeiro arquivo de lista padro qualificado.
-last
Exibe o ltimo arquivo de lista padro qualificado.
-num n
Exibe o arquivo de lista padro da execuo especificada de um job.
-all
Exibe todos os arquivos de lista padro qualificados.
-twslog
Exibe o contedo do arquivo stdlist do dia atual.
-name ["jobstreamname [(hhmm date),(jobstream_id)].]jobname"|jobnum
Especifica a instncia do fluxo de tarefas e o nome da tarefa para os quais
o arquivo de lista padro exibido.
jobnum
Especifica o nmero do job para o qual o arquivo de lista padro exibido.
-schedid jobstream_id.jobname
Especifica o ID do fluxo de tarefas e o nome da tarefa para a qual os
nomes de arquivo da lista padro so retornados.
Comentrios
Os colchetes na expresso [(hhmm date), (jobstream_id)] fazem parte do
comando, no so indicadores de sintaxe. Isto significa que possvel fornecer
qualquer um dos seguintes para o argumento -name:
morestdl -name ["jobstreamname[(hhmm date),(jobstream_id)].jobname"
morestdl -name jobnum
A cadeia inteira de identificao da tarefa deve ser colocada entre aspas duplas se
a parte que identifica a instncia do fluxo de tarefas contiver espaos em branco.
Por exemplo, como o schedtime, representado por hhmm date, possui um espao
nele, necessrio colocar a identificao da tarefa inteira entre aspas duplas.
Se voc apenas desejar identificar um nome de tarefa, no precisar das aspas
duplas.
A seguir est um exemplo da sintaxe para utilizao ao identificar uma tarefa com
e sem seu fluxo de tarefas. No exemplo, job_stream1 o nome do fluxo de tarefas,
0600 04/05/06 a hora planejada, 0AAAAAAAAAAAAAB5 o ID do fluxo de tarefas e
job1 o nome da tarefa. possvel executar o comando morestdl em job1
utilizando um destes dois formatos:
morestdl -name "job_stream1[(0600 04/05/06),(0AAAAAAAAAAAAAB5)].job1"
morestdl -name job1
Exemplos
Para exibir o arquivo de lista padro para a primeira execuo da tarefa
MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR no dia atual, execute o
seguinte comando:
morestdl -first -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
Para exibir o arquivo da lista padro para a primeira execuo da tarefa

0AAAAAAAAAAAAAEE.DIR no dia atual, execute o seguinte comando:
morestdl -first -schedid 0AAAAAAAAAAAAAEE.DIR
Para exibir o arquivo de lista padro para a segunda execuo da tarefa

MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR no dia atual, execute o
seguinte comando:
morestdl -num 2 -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
465
Para exibir os arquivos de lista padro para todas as execues da tarefa

MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR de trs dias atrs, execute
o seguinte comando:
morestdl -day 3 -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
Para exibir o arquivo de lista padro para a ltima execuo da tarefa

MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR de quatro dias atrs,
morestdl -day 4 -last -name "MY_CPU#ELI[(1824 03/09/06),(0AAAAAAAAAAAAAEE)].DIR"
Para imprimir o arquivo de lista padro do job nmero 455, execute o seguinte
comando:
morestdl 455 | lp -p 6
parms
Gerencia parmetros definidos localmente nas estaes de trabalho. Os parmetros
gerenciados por parms podem ser utilizados somente em definies de tarefas ou
de fluxos de tarefas com as palavras-chave scriptname ou opens ou em um
arquivo de script de tarefa.
Esses parmetros so resolvidos no momento do envio na estao de trabalho em
que a tarefa ou o fluxo de tarefas enviado. Se no houver correspondncia entre
o parametername especificado e o nome dos parmetros definidos no banco de
dados local na estao de trabalho, um valor null ser retornado.
Autorizao
Voc deve ter acesso display para o banco de dados de parmetros definido
localmente. Alm disso, voc deve estar autorizado com o seguinte acesso:
build on object file
Se voc utilizar a opo -b para criar ou reconstruir o banco de dados de
parmetros local.
excluir
Se voc utilizar a opo -d para excluir as definies de parmetros.
modify on object file
Se voc utilizar a opo -replace para incluir ou modificar as definies de
parmetros.
Sintaxe
parms {[-V | -u] | -build}
parms {-replace | -extract} filename
parms [-d]parametername
parms -c parametername value
Argumentos
466
-V
-u
-build Cria o banco de dados de parmetros na estao de trabalho se ele no

existir. Reconstri o banco de dados de parmetros, removendo os registros
no utilizados e evitando a fragmentao de vrias incluses e excluses,
se ele j existir.
-extract
Extrai todas as definies de parmetros do banco de dados local e as
armazena no arquivo com o nome filename. Utilize esta opo se desejar
exportar definies de parmetros locais para import-las como definies
de parmetros globais no banco de dados de objetos de planejamento
utilizando os comandos add na pgina 262 ou replace na pgina 300.
-replace
Incluir no banco de dados local novas definies de parmetros
armazenadas em um arquivo denominado filename ou substituir as j
existentes. Utilize esta opo se voc desejar importar, como definies de
parmetros locais, as definies de parmetros globais contidas no arquivo
denominado filename e extradas do banco de dados de objetos de
planejamento utilizando o comando extract na pgina 275.
-d
Exclui os parmetros com nome parametername do banco de dados local na

estao de trabalho.
parametername
Especifica o nome do parmetro cujo valor exibido. Quando utilizado
com o argumento -d, representa o nome do parmetro a ser excludo.
-c name value
Especifica o nome e o valor de um parmetro. O nome pode conter at 16
caracteres alfanumricos, incluindo traos (-) e sublinhados (_), e deve
iniciar com uma letra. O valor pode conter at 72 caracteres. Coloque o
valor entre aspas duplas se contiver caracteres especiais. Se o parmetro
no existir, ele ser adicionado ao banco de dados. Se o parmetro j
existir, seu valor ser alterado.
Comentrios
Quando parms for executado na linha de comandos sem argumentos, ele solicitar
nomes e valores de parmetros.
A utilizao de parms em definies de tarefa e em arquivos de script de tarefa
requer que o parmetro j exista localmente no banco de dados de parmetros na
estao de trabalho.
Este um uso de amostra de um parmetro local, MYFILE, em uma clusula de
dependncia de arquivo:
schedule test_js
on everyday
opens "/usr/home/tws_99//usr/home/tws_99/bin/parms MYFILE"
:
test_job
fim
O exemplo a seguir explica como a varivel var colocada entre circunflexos (^)
substituda enquanto a tarefa est em processo. Se a tarefa for enviada como uma
tarefa ad hoc, o parmetro var expandido, ou seja, substitudo pelo valor
designado a var no banco de dados local, no tempo de envio e no quando a
tarefa ativada.
467
Exemplo de definio de tarefa do UNIX:

DATA#UX_P_TEST DOCOMMAND "ls ^var^"
STREAMLOGON "mae82"
DESCRIPTION "Test parms in job definition on UNIX."
RECOVERY STOP
Exemplo de definio de tarefa do Windows:

BORG#WIN_P_TEST DOCOMMAND "dir ^var^"
STREAMLOGON "mae82"
DESCRIPTION "Test parms in job definition on Windows."
RECOVERY STOP
Quando utilizado em um arquivo de script da tarefa, o parmetro no expandido

at o script ser ativado. No expandido quando o fluxo de tarefa que contm a
tarefa processado por JnextPlan. Esses so exemplos de como utilizar o
parmetro var nos arquivos de script da tarefa.
Exemplo de script do UNIX:
#!/bin/sh
TWS_HOME="/opt./tws/mae82/maestro"
export TWS_HOME
MDIR=$TWS_HOME/bin/parms var
export MDIR
ls -l $MDIR
Exemplo de script do Windows:

set TWS_HOME=d:\win32app\TWS\mae82\maestro
echo %TWS_HOME%
FOR /F "Tokens=*" %%a in (%TWS_HOME%\bin\parms var) do set MDIR=%%a
echo %MDIR%
dir %MDIR%
Exemplos
Para retornar o valor de myparm, execute o seguinte comando:
parms myparm
Para alterar o valor de myparm, execute o seguinte comando:

parms -c myparm "item 123"
Para criar um novo parmetro chamado hisparm, execute o seguinte comando:

parms -c hisparm "item 789"
Para alterar o valor de myparm e incluir herparm, execute o seguinte comando:

parms
Name of parameter ?
Value of parameter?
Name of parameter ?
Value of parameter?
Name of parameter ?
myparm < Return>

"item 456" < Return>
herparm < Return>
"item 123" < Return>
< Return>
release
Libera tarefas e fluxos de tarefas das dependncias needs em um recurso. Este
comando deve ser emitido somente de dentro do arquivo de script da tarefa.
468
Sintaxe
release -V | -U
release
[-s]
[workstation#]
resourcename
[count]
Argumentos
-V
-U
-s
Libera a dependncia needs do recurso especificado somente no nvel do

fluxo de tarefas.
Se -s no for utilizado, a dependncia needs do recurso especificado
liberada no nvel da tarefa ou no nvel do fluxo de tarefas se a
dependncia needs desse recurso no for localizada no nvel da tarefa.
workstation #
na qual o recurso est definido. O padro a estao de trabalho local.
resourcename
Especifica o nome do recurso envolvido na dependncia needs.
count
Especifica o nmero de unidades do recurso a ser liberado.
Comentrios
Unidades de um recurso so adquiridas por um job ou fluxo de job na hora em
que lanado e so liberadas automaticamente quando o job ou fluxo de job
concludo. O comando release pode ser utilizado em um script de tarefa para
liberar recursos antes da concluso da tarefa ou do fluxo de tarefas ou para liberar
manualmente tarefas e fluxos de tarefas das dependncias needs nas situaes de
emergncia.
Exemplos
No fluxo de tarefas a seguir, duas unidades do recurso dbase so requeridas pelo
fluxo de tarefas sked5:
schedule ux1#sked5 on tu
needs 2 dbase :
job1
jobrel follows job1
job2 follows jobrel
fim
Para liberar o recurso dbase antes de job2 ser iniciado, o arquivo de script para
jobrel contm o seguinte comando:
`maestro`/bin/release -s dbase
Nota: O argumento -s pode ser omitido, porque no foram reservados recursos no

nvel do job.
469
rmstdlist
Remove ou exibe arquivos de lista padro com base no tempo do arquivo. Esse
utilitrio deve ser utilizado pelo administrador do Tivoli Workload Scheduler para
manter o ambiente de planejamento.
Sintaxe
rmstdlist -V | -U
rmstdlist [-p] [age]
Argumentos
-V
-U
-p
Exibe os nomes dos diretrios de arquivos de lista padro qualificados.

Nenhum diretrio ou arquivo removido. Se voc no especificar -p, os
arquivos de lista padro qualificados sero removidos.
age
O tempo mnimo, em dias, para os diretrios de arquivos de lista padro

serem exibidos ou removidos. O padro 10 dias.
Nota: Como a lista de diretrios e arquivos mostrados ou excludos utilizando

rmstdlist produzida com base na ltima vez em que foram acessados, as
datas mostradas na lista de diretrios poderia ser diferente das datas
exibidas na lista de arquivos.
Sintaxe
Como regra, voc deve remover regularmente os arquivos da lista padro de
algum lugar a cada 10-20 dias. As listas no processadas maiores podem ser
difceis de gerenciar e, se o nmero de arquivos se tornar excessivamente grande,
poder ser necessrio apagar alguns deles manualmente antes de poder utilizar
rmstdlist novamente.
Este problema pode ocorrer nos sistemas AIX, particularmente devido a uma
limitao atualmente no resolvida com o comando rm -rf. Quando rmstdlist
falhar devido a esta limitao, ele no exibir nenhum erro diferente do cdigo de
sada 126. Se voc, em vez disso, tiver o erro rm -rf exibido, poder editar o script
rmstdlist da seguinte maneira:
1. Localize o script no diretrio TWS_home/bin
2. Localize a linha:
rm -rf `cat /tmp/rm$$` 2> /dev/null
3. Remova a redireo para /dev/null para que a linha se torne:

rm -rf `cat /tmp/rm$$`
Exemplos
Para exibir os nomes dos diretrios do arquivo de lista padro com mais de 14
dias, execute o seguinte comando:
rmstdlist -p 14
Para remover todos os arquivos de lista padro (e seus diretrios) com mais de
sete dias, execute o seguinte comando:
470
rmstdlist 7
sendevent
O comando envia os eventos customizados definidos com o comando evtdef para
o servidor do processador de eventos atualmente ativo no plano de produo.
medida que os eventos so recebidos pelo processador de eventos, acionam as
regras de eventos nas quais foram especificados.
Os usurios podem substituir o servidor de destino padro (definido pelas opes
globais) especificando o host e a porta de um novo servidor.
Sintaxe
sendevent -V | ? | -help | -u | -usage
sendevent [-hostname hostname][-port port] eventType source [[attribute=value]...]
Argumentos
-V
? | -help | -u | -usage
-hostname hostname
Especifica o nome do host de um servidor do processador de evento
alternativo diferente do atualmente ativo. Esse parmetro necessrio se o
comando for ativado a partir de um cliente de linha de comandos.
-port port
Especifica o nmero da porta de um servidor do processador de eventos
alternativo diferente do atualmente ativo. Esse parmetro necessrio se o
comando for ativado a partir de um cliente de linha de comandos.
eventType
Um dos tipos de evento customizado, definido com o comando evtdef no
provedor de eventos genricos e especificado como o evento acionador em
uma definio de regra de evento.
origem O nome do provedor de eventos que voc customizou com evtdef. Esse
tambm o nome que voc deve especificar como o argumento para a
palavra-chave eventProvider na definio das regras de evento acionadas
por esses eventos customizados.
O nome padro GenericEventPlugIn.
attribute=value
Um ou mais dos atributos qualificadores do tipo de evento customizado
que esto especificados como atributos do evento acionador para a regra
de evento.
Comentrios
Este comando tambm pode ser executado em sistemas nos quais apenas o cliente
da linha de comando remoto do Tivoli Workload Scheduler est instalado.
471
Exemplos
Neste exemplo, um aplicativo envia o tipo de evento customizado
BusProcCompleted para um servidor do processador de eventos alternativo
denominado master3. O evento que o processamento do arquivo calcweek foi
concludo.
sendevent -hostname master3 -port 4294 BusProcCompleted GenericEventPlugIn
TransacName=calcweek Workstation=ab5supp
O nome do arquivo e a estao de trabalho associada so os dois atributos do

evento BusProcCompleted que foram especificados como atributos de evento
acionadores em uma regra de evento associada.
showexec
Exibe os status dos jobs em execuo. Este comando se aplica somente ao UNIX.
Esse comando serve para os agentes padro. Nos gerenciadores de domnio e nos
agente tolerante a falhas utilize o comando conman showjobs.
Sintaxe
showexec [-V | -U | INFO]
Argumentos
-V
-U
INFO Exibe o nome do arquivo de tarefa em vez do usurio, data e hora.
Resultados
A sada do comando est disponvel em dois formatos: padro e INFO.
Exemplos
Para exibir jobs em execuo no formato padro, execute o seguinte comando:
showexec
Para exibir tarefas em execuo no formato INFO, execute o seguinte comando:

showexec INFO
Formato Padro
CPU
Planejamento
O nome do fluxo de job no qual o job executado.
Tarefa O nome do job.
Job#
O nmero do job.
Usurio
O nome de usurio do job.
Data de Incio
A data em que o job iniciou a execuo.
472
Hora de Incio
A hora em que o job iniciou a execuo.
Tempo Decorrido (Estimado)
O tempo estimado, em minutos, no qual o job ser executado.
Formato Info
CPU
Planejamento
O nome do fluxo de job no qual o job executado.
Tarefa O nome do job.
Job#
O nmero do job.
JCL
O nome do arquivo do job.
shutdown
Pra os processos do Tivoli Workload Scheduler e, opcionalmente, tambm pra o
servidor de aplicativos integrado. Aplica-se apenas a estaes de trabalho do
Windows. Voc deve ter acesso shutdown estao de trabalho.
Sintaxe
shutdown [-V | -U] [-appsrv]
Argumentos
-V
-U
-appsrv
Tambm pra o WebSphere Application Server.
Comentrios
Certifique-se de que o TWS_user que voc est utilizando pertena ao grupo
Administradores definido na estao de trabalho do Windows.
Exemplos
Para exibir o nome e a verso do comando, execute o seguinte comando:
shutdown -V
Para parar os processos do Tivoli Workload Scheduler e o WebSphere Application

Server, execute o seguinte comando:
shutdown -appsrv
ShutDownLwa
Pare o agente dinmico. No necessrio nenhum acesso especfico estao de
trabalho. Execute este comando localmente no agente dinmico que deseja parar.
Sintaxe
ShutDownLwa
473
Argumentos
Nenhum argumento necessrio.
Exemplos
Para parar o agente dinmico, execute o seguinte comando:
ShutDownLwa
StartUp
Inicia netman, o processo de gerenciamento de rede do Tivoli Workload Scheduler.
Voc deve ter acesso start para a estao de trabalho.
Sintaxe
StartUp [-V | -U]
Argumentos
-V
-U
Comentrios
No Windows, o servio netman iniciado automaticamente quando um
computador reiniciado. StartUp pode ser utilizado para reiniciar o servio se ele
for parado por algum motivo.
No UNIX, o comando StartUp pode ser executado automaticamente, sendo
chamado a partir do arquivo /etc/inittab, de forma que a infra-estrutura do
WebSphere Application Server e netman sejam iniciados toda vez que um
computador for reinicializado. O comando StartUp poder ser utilizado para
reiniciar o netman se ele for parado por algum motivo.
O restante da rvore de processo pode ser reiniciado com os comandos
conman start
conman startmon
. Consulte conman start na pgina 408 para obter informaes adicionais.
Exemplos
Para exibir o nome e a verso do comando, execute o seguinte comando:
StartUp -V
Para iniciar o processo netman, execute o seguinte comando:

StartUp
StartUpLwa
Inicia o agente dinmico.
474
No necessrio nenhum acesso especfico estao de trabalho. Execute este

comando localmente no agente dinmico que deseja iniciar.
Sintaxe
StartUpLwa
Argumentos
Nenhum argumento necessrio.
Exemplos
Para iniciar o agente dinmico, execute o seguinte comando:
StartUpLwa
tws_inst_pull_info
Esse um script que produz informaes sobre seu ambiente do Tivoli Workload
Scheduler e sua estao de trabalho local e pode fazer uma captura instantnea dos
dados do DB2 e do WebSphere Application Server no gerenciador de domnio
principal, salvando-os como um pacote datado.
Ele tambm pode gerar um relatrio contendo no apenas os resultados da captura
instantnea, mas tambm vrios parmetros de configurao e de ambiente. A
ferramenta til para descrever um problema ao Suporte de Software IBM. Para
melhores resultados, deve ser executada assim que o problema for descoberto.
Comentrios
Consulte o Guia de Resoluo de Problemas do IBM Tivoli Workload Scheduler para
obter informaes adicionais sobre esse comando.
verso
Exibe informaes sobre o release atual do Tivoli Workload Scheduler instalado no
sistema. Este comando se aplica somente ao UNIX. As informaes so extradas
de um arquivo de verso.
A shell Korn necessria para executar este comando.
Sintaxe
version -V | -u | -h
version [-a] [-f vfile] [file [...]]
Argumentos
-V
-u
-h
Exibe informaes de auxlio do comando e sai.
-a
Exibe informaes sobre todos os arquivos de produtos. O padro exibir

informaes apenas sobre os arquivos especificados.
475
-f vfile Especifica o caminho e o nome do arquivo de verso se for diferente da

configurao padro. O padro um arquivo chamado version.info no
diretrio de job atual.
file
Especifica os nomes de arquivos de produtos, separados por espaos, para

os quais as informaes sobre a verso so exibidas. O padro no exibir
informaes sobre os arquivos, ou, se -a for utilizado, exibir todas as
informaes sobre os arquivos.
Resultados
O cabealho da sada contm o nome do produto, a verso, o sistema operacional,
o nvel de correo e a data de instalao. O restante da tela lista informaes
sobre o arquivo ou arquivos especificados. Os arquivos so listados no seguinte
formato:
File
O nome do arquivo.
Reviso
O nmero de reviso do arquivo.
Correo
O nvel de correo do arquivo, se houver.
Tamanho (bytes)
O tamanho do arquivo em bytes.
Checksum
O checksum do arquivo. Checksum calculado utilizando o comando do
UNIX sum. No AIX, sum utilizado com o argumento -o.
Comentrios
As informaes de arquivo do Tivoli Workload Scheduler esto contidas no
arquivo version.info. Esse arquivo colocado no diretrio TWS_home/version
durante a instalao. O arquivo version.info est em um formato especfico e no
deve ser alterado.
possvel mover o arquivo version.info para outro diretrio. No entanto, dever
incluir, em seguida, o argumento -f para localizar o arquivo.
Exemplos
Para exibir informaes sobre o release do Tivoli Workload Scheduler instalado,
./version
Uma sada de amostra desse comando :

IBM Tivoli Workload Scheduler/VERSO 8.3 (9.9) (C) Direitos Autorais IBM Corp 1998, 2006
IBM Tivoli Workload Scheduler 8.3 UNIX linux-ix86
CORREO Fevereiro de 2006
Para exibir informaes sobre todos os arquivos, execute o seguinte comando:

version/version -a -f version/version.info
Para exibir informaes sobre o arquivo customize, execute o seguinte comando:

cd version
./version customize
476
Para exibir informaes sobre o arquivo customize, quando version.info estiver

localizado em /apps/maestro, execute o seguinte comando:
cd version
./version -f /apps/maestro/version.info customize
Comandos no-suportados
Os seguintes comandos utilitrios no-suportados fornecem funes no Windows
que so semelhantes aos comandos UNIX ps e kill. Eles podero ser utilizados se
utilitrios semelhantes do Windows no estiverem disponveis.
Sintaxe
listproc
killproc pid
Comentrios
listproc
Exibe uma listagem tabular de processos no sistema.
killproc
Elimina o processo com o ID de processo pid.
Nota: Quando executado pelo Administrador, killproc capaz de eliminar
processos de sistema.
477
478
Captulo 12. Obtendo Relatrios e Estatsticas

Este captulo descreve os comandos de relatrio que voc utiliza para obter um
resumo ou informaes detalhadas sobre o plano de produo anterior ou seguinte.
Esses comandos so executados a partir do prompt de comandos do sistema
operacional no gerenciador de domnio mestre. Este captulo est dividido nas
sees a seguir:
v Configurao para Utilizar Comandos de Relatrio
v Descries dos comandos na pgina 480
v Amostra de sadas do relatrio na pgina 488
v Programas de Extrao de Relatrio na pgina 498
v Executando Relatrios do Dynamic Workload Console e relatrios em lote na
pgina 509
v Executando relatrios em lote a partir da Interface de Linha de Comandos na
pgina 516
Configurao para Utilizar Comandos de Relatrio

Para configurar o ambiente para utilizar os comandos de relatrio, configure as
variveis PATH e TWS_TISDIR executando um dos seguintes scripts:
v . ./TWS_home/tws_env.sh para shells de Bourne e Korn no UNIX
v . ./TWS_home/tws_env.csh para shells C no UNIX
v TWS_home\tws_env.cmd no Windows
Os comandos de relatrio devem ser executados a partir do diretrio TWS_home.
A sada dos comandos de relatrio controlada pelas seguintes variveis de
ambiente:
MAESTROLP
Especifica o destino da sada de um comando. O padro stdout.
possvel defini-lo como qualquer um dos seguintes itens:
nome do arquivo
Grava a sada em um arquivo.
> nome do arquivo
Somente para o UNIX. Redireciona a sada para um arquivo,
sobrescrevendo o contedo do arquivo. Se o arquivo no existir, ele
ser criado.
>> nome do arquivo
Somente para o UNIX. Redireciona a sada para um arquivo,
anexando-a ao final do arquivo. Se o arquivo no existir, ele ser
criado.
| command
Somente para o UNIX. Canaliza a sada para um comando do
sistema ou processo. O comando do sistema sempre executado.
479
|| command
Somente para o UNIX. Canaliza a sada para um comando do
sistema ou processo. O comando do sistema no ser executado, se
no houver sada.
Especifica o estilo de sada para nomes de objetos longos. Defina a varivel
como LONG para utilizar os campos de comprimento completos (longos)
para nomes de objetos.
Se no estiver configurada ou estiver configurada para qualquer coisa
diferente de LONG, os nomes longos so truncados para oito caracteres e
um sinal de mais. Por exemplo: A1234567+.
Sugere-se que seja utilizado um tamanho de fonte fixo para gerenciar corretamente
a formatao da sada de relatrios.
Alterando o formato de data

No Tivoli Workload Scheduler, o formato de data afeta todos os comandos que
aceitam uma data como opo de entrada (exceto o comando datecalc) e os
cabealhos em todos os relatrios. O formato de data padro mm/dd/aa. Para
selecionar um formato diferente, edite a opo local date format armazenada no
arquivo localopts. Os valores so:
Tabela 62. Formatos de Data
Valor do formato de data
Sada de formato de data correspondente
aa/mm/dd
mm/dd/aa
dd/mm/aa
Variveis de suporte do idioma nativo.
Consulte o Guia de Administrao do IBM Tivoli Workload Scheduler para obter

detalhes sobre como modificar variveis locais no arquivo localopts.
Descries dos comandos

Os comandos de relatrio do Tivoli Workload Scheduler esto listados na
Tabela 63:
Tabela 63. Lista de Comandos de Relatrio
480
Comando
Descrio
rep1
Relatrio 01 - Listagem de Detalhes do Job
rep2
Relatrio 02 - Listagem do Prompt
rep3
Relatrio 03 - Listagem de Calendrio
rep4a
Relatrio 04A - Listagem de Parmetro
rep4b
Relatrio 04B - Listagem de Recurso
rep7
Relatrio 07 - Listagem do Histrico do Job
rep8
Relatrio 08 - Histograma do Job
rep11
Relatrio 11 - Agendamento de Produo Planejada
Tabela 63. Lista de Comandos de Relatrio (continuao)

Comando
Descrio
reptr
Relatrio
Relatrio
Relatrio
Relatrio
Relatrio
09A
09B
09D
10A
10B
Resumo de Produo Planejada

Detalhe de Produo Planejada
Detalhe de Produo Planejada (Nomes Longos)
Resumo de Produo Real
Detalhe de Produo Real
Relatrio 12 - Relatrio de Referncia Cruzada
xref
rep1 - rep4b
Estes comandos imprimem os seguintes relatrios:
Relatrio 01
Listagem de Detalhes do Job
Relatrio 02
Listagem de Prompts
Relatrio 03
Listagem de Calendrios
Relatrio 04A
Listagem de Parmetros
Relatrio 04B
Listagem de Recursos
Sintaxe
rep[x] [-V|-U]
Execute o comando no diretrio TWS_home.
Para rep3, execute o comando a partir de um diretrio ao qual voc tem acesso
write.
|
|
Ao imprimir relatrios para Tipos de tarefas com opes avanadas, o campo de

arquivo JCL retorna o nome do aplicativo.
Argumentos
x
Um nmero correspondente ao relatrio. Os nmeros so: 1, 2, 3, 4a ou 4b.
-U
Exibe as informaes de uso do comando e sai.
-V
Comentrios
A Listagem de Detalhes da Tarefa (relatrio 01) no pode incluir tarefas que
tenham sido enviadas com a utilizao de um nome de alias.
|
|
O tempo decorrido exibido para uma tarefa sombra o tempo decorrido da tarefa
remota ao qual ele limitado.
481
Exemplos
Relatrio de Impresso 03, Listagem do Calendrio do Usurio:
rep3
Exibe informaes sobre utilizao do comando rep2:

rep2 -U
No UNIX, imprima duas cpias do relatrio 04A, Listagem de Parmetros do

Usurio, na impressora lp2:
MAESTROLP="| lp -dlp2 -n2"
export MAESTROLP
rep4a
Este um relatrio de amostra para a tarefa WAGES2_1:
Tarefa: WAGES2_1
#FTP
Descrio:
JCL File
: filetransfer
Logon
:
tws86
Job de Recuperao:
Tipo de Recuperao
: STOP
Aviso de Recuperao :
Composer Autodoc
: Sim
Total de Execues
:
0 Total
Normal
ltima Execuo
Mximo
Mnimo
Decorrido(segs)
0
0
0
0
0
Creator:
Bem-sucedidas
0 Interrompidas
CPU(segs)
0
0 (On
0 (On
0 (On
0 em
0)
0)>
0)
rep7
Este comando imprime o Relatrio 07-Listagem de Histricos do Job.
Sintaxe
rep7 -V|-U
rep7
[-c wkstat]
[-s jstream_name]
[-j job]
[-f date ]
[-t date]
[-l]
Argumentos
482
-U
-V
-c wkstat
Especifica o nome da estao de trabalho na qual os jobs so executados. O
padro todas as estaes de trabalho.
-s jstream_name
Especifica o nome do fluxo de tarefas no qual as tarefas so executadas. O
padro so todos os fluxos de tarefas.
-j job
Especifica o nome do job. O padro so todos os jobs.
-f date Especifica que o histrico do job deve ser impresso desta data em diante.
Digite a data como aaaammdd. O padro a data disponvel mais antiga.
-t date Especifica que o histrico do job deve ser impresso at esta data. Digite a
data como aaaammdd. O padro a data mais recente.
-l
Limita as informaes da linha de resumo aos jobs que caem no intervalo

de data especificado pelas opes -f ou -t. A utilizao dessa opo faz com
que a ordem de sada seja invertida: a linha de resumo do job ser
impressa depois das linhas de execuo de job individuais. Essa opo ser
vlida somente se voc tambm especificar pelo menos uma das opes -f
ou -t.
Comentrios
O relatrio no inclui tarefas que tenham sido enviadas com a utilizao de um
nome de alias.
O tempo decorrido exibido para uma tarefa sombra o tempo decorrido da tarefa
remota ao qual ele limitado.
|
|
A qualquer momento que voc executar rep7, a sada do comando contm as

informaes armazenadas at a ltima execuo de JnextPlan, as informaes
relacionadas execuo do plano de produo atual estaro contidas na sada rep7
da prxima vez que voc executar JnextPlan. Por essa razo, se voc executar rep7
aps ter gerado o plano de produo pela primeira vez ou aps um comando
ResetPlan, a sada do comando no contm nenhuma informao de estatstica.
Exemplos
Imprima todo o histrico do job para a estao de trabalho ux3:
rep7 -c ux3
Imprima todo o histrico do job para todos os jobs no fluxo de job sked25:
rep7 -s sked25
Imprima o histrico de job de todos os jobs no fluxo de job mysked na estao de

trabalho x15 entre 21/1/2005 e 25/1/2005:
rep7 -c x15 -s mysked -f 20050121 -t 20050125
rep8
Este comando imprime o Relatrio 08-Histograma do Job.
Sintaxe
rep8 -V|-U
483
rep8
[-f date -b time -t date -e time]
[-i file]
[-p ]
rep8
[-b time -e time]
[-i file]
[-p ]
Argumentos
-U
-V
-f date Especifica que o histrico do job deve ser impresso desta data em diante.
Digite a data como aaaammdd. O padro a data de hoje.
-b time
Especifica que o histrico do job deve ser impresso desta data em diante.
Digite a hora como hhmm. O padro o startOfDay do Tivoli Workload
Scheduler.
-t date Especifica que o histrico do job deve ser impresso at esta data. Digite a
data como aaaammdd. O padro a data mais recente.
-e time Especifica que o histrico do job deve ser impresso at esta hora. Digite a
hora como hhmm. O padro o incio da hora do dia do Tivoli Workload
Scheduler.
-i file
Especifica o nome do arquivo de log a partir do qual o histrico extrado.

Observe que os arquivos so armazenados no diretrio schedlog. O padro
o arquivo Symphony atual.
Nota: Assegure que o intervalo de tempo especificado pelos argumentos
[-f date -b time -t date -e time] esteja dentro do intervalo de data e
hora definido no nome do arquivo de registro -i file.
-p
Especifica para inserir uma quebra de pgina aps cada data de execuo.
Comentrios
O relatrio no inclui tarefas que tenham sido enviadas com a utilizao de um
nome de alias.
A qualquer momento que voc executar rep8, a sada do comando contm as
informaes armazenadas at a ltima execuo de JnextPlan, as informaes
relacionadas execuo do plano de produo atual estaro contidas na sada rep8
da prxima vez que voc executar JnextPlan. Por essa razo, se voc executar rep8
aps ter gerado o plano de produo pela primeira vez ou aps um comando
ResetPlan, a sada do comando no contm nenhuma informao de estatstica.
Exemplos
Imprima um histograma do job que inclua todas as informaes no plano atual
(arquivo Symphony):
rep8
484
Imprima um histograma do job que comece s 6h em 25/1/2005 e termine s 5h59

em 26/1/2005:
rep8 -f 20050125 -b 0600 -t 20050126 -e 0559 -i schedlog/M199801260601
Imprima um histograma do job a partir do plano atual (arquivo Symphony), que

comece s 6h e termine s 22h:
rep8 -b 0600 -e 2200
rep11
Este comando imprime o Relatrio 11-Agendamento de Produo Planejada.
Sintaxe
rep11 -V|-U
rep11
[-mmm[yy] [...]]
[-c wkstat [...]]
[-s jstream_name]
[-o output]
Argumentos
-U
-V
-m mm[yy]
Especifica os meses a serem relatados. Digite o nmero do ms como mm.
O padro o ms atual.
Voc tambm pode digitar um ano como yy. O padro ser o ano atual ou
o prximo ano, se voc especificar um ms anterior ao ms atual.
-c wkstat
Especifica as estaes de trabalho a serem relatadas. O padro todas as
estaes de trabalho.
-s jstream_name
-o output
Especifica o arquivo de sada. O padro o arquivo definido pela varivel
MAESTROLP. Se MAESTROLP no for definido, o padro ser stdout.
Exemplos
Relate em junho, julho e agosto de 2004 para as estaes de trabalho main, site1 e
sagent1:
rep11 -m 062004 072004 082004 -c main site1 sagent1
Relate em Junho, Julho e Agosto deste ano para todas as estaes de trabalho e
direcione a sada para o arquivo r11out:
rep11 -m 06 07 08 -o r11out
485
Relate neste ms e ano para a estao de trabalho site2:

rep11 -c site2
reptr
Este comando imprime os seguintes relatrios:
Relatrio 09A
Resumo da Produo Planejada
Relatrio 09B
Detalhe da Produo Planejada
Relatrio 10A
Resumo da Produo Real
Relatrio 10B
Detalhe da Produo Real
Relatrio 09A e Relatrio 09B referem-se a processamento de produo futuro,
enquanto que Relatrio 10A e relatrio 10B mostram os resultados e o status de
cada tarefa nica de produo j processada.
Sintaxe
reptr [-V|-U]
reptr -pre
[-{summary | detail}]
[symfile]
reptr -post
[-{summary | detail}]
[logfile]
Execute o comando a partir de um diretrio ao qual voc tem acesso write.
Argumentos
-U
-V
-pre
Especifica que os relatrios de pr-produo devem ser impressos (09A e

09B).
-post
Especifica que os relatrios de ps-produo devem ser impressos (10A e

10B).
-summary
Especifica que os relatrios de resumo devem ser impressos (09A e 10A).
Se -summary e -detail forem omitidos, ambas as definies de relatrios
sero impressas.
-detail Especifica que os relatrios de detalhes devem ser impressos (09B e 10B).
Se -summary e -detail forem omitidos, ambas as definies de relatrios
sero impressas.
symfile Especifica o nome do arquivo de plano a partir do qual os relatrios sero
486
impressos. O padro Symnew no diretrio atual. Se o arquivo no estiver

no diretrio atualmente em funcionamento, voc deve incluir o caminho
absoluto para o nome do arquivo.
logfile
Especifica o nome completo do arquivo de log a partir do qual os

relatrios sero impressos. Observe que os arquivos de log de plano so
armazenados no diretrio schedlog. O padro plano atual (arquivo
Symphony).
Se o comando for executado sem opes, os dois relatrios pr (09A e 09B) sero
impressos e as informaes sero extradas do arquivo Symphony.
Exemplos
Imprima o relatrio de detalhe de produo anterior a partir do arquivo Symnew:
reptr -pre -detail
Imprima o relatrio de resumo de produo anterior a partir do arquivo mysym:

reptr -pre -summary mysym
Imprima o relatrio de resumo de produo posterior a partir do arquivo de log

M199903170935:
reptr -post -summary schedlog/M199903170935
Imprima os relatrios pr-produo lendo a partir do arquivo Symphony.

reptr
Quando os argumentos forem especificados, os relatrios pr-produo sero

baseados nas informaes lidas a partir do arquivo Symnew enquanto os relatrios
ps-produo sero baseados nas informaes lidas a partir do arquivo Symphony.
xref
Este comando imprime o Relatrio 12-Relatrio de Referncia Cruzada.
Sintaxe
xref [-V|-U]
xref
[-cpu wkstat]
[-depends|-files|-jobs|-prompts|-resource|-schedules|-when[...]]
Argumentos
-U
-V
-cpu wkstat
Especifica que o relatrio para a estao de trabalho nomeado deve ser
impresso. O caractere curinga @ permitido, neste caso, as informaes de
todas as estaes de trabalho qualificadas so includas. O padro todas
as estaes de trabalho.
487
-depends
Especifica que um relatrio mostrando os fluxos de job e jobs que so
sucessores de cada job deve ser impresso.
-files

dependentes de cada arquivo deve ser impresso.
-jobs
Especifica que um relatrio mostrando os fluxos de job nos quais cada job
executado deve ser impresso.
-prompts
dependentes em cada prompt deve ser impresso.
-resource
dependentes em cada recurso deve ser impresso.
-schedules
sucessores de cada fluxo de job deve ser impresso.
-when Especifica que um relatrio mostrando as datas de Incluso e Excluso do
fluxo de job deve ser impresso.
Se o comando for executado sem nenhuma opo, todas as estaes de trabalho e
todas as opes sero selecionadas.
Exemplos
Imprima um relatrio para todas as estaes de trabalho, mostrando todas as
informaes sobre referncia cruzada:
xref
Imprima um relatrio para todas as estaes de trabalho. Inclua informaes de

referncia cruzada sobre todas as dependncias do sucessor:
xref -cpu @ -depends -schedules
Amostra de sadas do relatrio

Relatrio 01 - Listagem de Detalhes da Tarefa:
TWS para UNIX (AIX)/REPORT1 8.3 (1.7)
ibm
Relatrio 01
Listagem de Detalhes de Tarefas
Job
: FTAWIN8+
#SCHEDDDD
Descrio
:
Arquivo JCL
: dir
Logon
: maestro_adm
Criador
: raiz
Job de Recuperao:
Tipo de Recuperao
: STOP
Aviso de Recuperao
:
composer Autodoc
: Sim
Total de Execues
:
0 0
Bem-sucedidas
Total
Normal
ltima Execuo
Mximo
Mnimo
488
Decorrido(min)
00:00:00
00:00:00
00:00:00
00:00:00
00:00:00
0 Interrompidas
CPU(seg)
0
0 (Em
0 (Em
0 (Em
s 00:00)
)
)
Pgina
06/03/06
Job
: MASTER8+
#JnextPlan
Descrio
: INCLUDO pelo composer PARA PLANEJAMENTO MASTER821#FINAL.
Arquivo JCL
: /test/maestro_adm/tws/JnextPlan
Logon
: maestro_adm
Criador
: maestro_adm
Job de Recuperao:
Tipo de Recuperao
: STOP
Aviso de Recuperao
:
composer Autodoc
: Sim
Total de Execues
:
11 11
Bem-sucedidas
0 Interrompidas
Total
Normal
ltima Execuo
Mximo
Mnimo
Decorrido(min)
00:00:14
00:00:01
00:00:01
00:00:02
00:00:01
CPU(seg)
44
4 (Em 05/03/06 s 23:16)
4 (Em 04/03/06)
4 (Em 04/03/06)
Job
: MASTER8+
#JOB1
Descrio
: INCLUDO pelo composer.
Arquivo JCL
: pwd
Logon
: ÂCCLOGIN^
Criador
: raiz
Job de Recuperao:
Tipo de Recuperao
: STOP
Aviso de Recuperao
:
composer Autodoc
: Sim
Total de Execues
:
1 1
Bem-sucedidas
Total
Normal
ltima Execuo
Mximo
Mnimo
Decorrido(min)
00:00:01
00:00:01
00:00:01
00:00:01
00:00:01
CPU(seg)
0
* * * *
F i m d o
0 Interrompidas
0 (Em 05/03/06 s 22:22)

0 (Em 05/03/06)
0 (Em 05/03/06)
R e l a t r i o
* * * *
Na sada, voc v os valores definidos em Tarefa na pgina 646 da seguinte

forma:
composer Autodoc
Informa se a instruo do job foi descrita na definio do fluxo de job
utilizando a interface de linha de comandos.
CPU (seg)
o tempo real da CPU, expresso em segundos, utilizado para a execuo
do job.
Total
a soma do tempo de CPU gravada para o 'Total de Execues'.
Normal
o valor mdio de tempo da CPU gravado durante o 'Total de
Execues'.
ltima Execuo
o tempo de CPU gravado durante a ltima execuo do job.
Mximo
o mximo entre os valores coletados para o tempo de CPU
durante o 'Total de Execues' (calculado apenas para tarefas
concludas com xito).
489
Mnimo
o mnimo entre os valores coletados para o tempo de CPU
Criador
o nome do usurio que criou a definio do job.
Descrio
a descrio de texto do job definida no campo Descrio da instruo de
definio do job.
Decorrido
o perodo de tempo, expresso em minutos, que inclui o tempo durante o
qual o job utilizou a CPU e o tempo que o job teve que aguardar por
outros processos para liberar a CPU.
Total
a soma do tempo Decorrido gravada para o 'Total de Execues'.
Normal
o valor mdio de tempo Decorrido gravado durante o 'Total de
Execues'.
ltima Execuo
o tempo Decorrido gravado durante a ltima execuo do job.
Mximo
o mximo entre os valores coletados para o Tempo Decorrido
Mnimo
o mnimo entre os valores coletados para o Tempo Decorrido
Nota: O tempo decorrido exibido para uma tarefa sombra o tempo
decorrido da tarefa remota ao qual ele limitado.
|
|
Arquivo JCL
o nome do arquivo definido no campo scriptname que contm o script a
ser executado ou o comando especificado no campo docommand a ser
chamado ao executar o job.
Tarefa o identificador da tarefa, [workstation#]jobname.
Incio de Sesso
o nome do usurio, especificado no campo streamlogon, com o qual o
job executado.
Tarefa de Recuperao
a tarefa, especificada como after [workstation#]jobname, que executada se
a tarefa pai for encerrada de forma anormal.
Prompt de Recuperao
o texto do aviso, especificado no campo abendprompt, que ser exibido
se esse job terminar de forma anormal.
Tipo de Recuperao
a opo de recuperao definida na definio do job. Pode ser definida
como stop, continue ou rerun.
490
Relatrio 02 - Listagem de Avisos:

ibm
Relatrio 02
Listagem de Mensagens de Prompts
Aviso
Pgina 1
06/03/06
Mensagem
PROMPT1
Responder SIM quando estiver pronto para executar acc103 e acc104.
PROMPT2
Todos os usurios efetuaram logout?
CALLNO
555-0911
CALLOPER
Chamar ^PERSON2CALL^ en ^CALLNO^ para assegurar
que todas as placas de tempo tenham sido processadas.
PERSON2CALL Lou Armstrong
Nmero total de avisos no arquivo:
* * * *
5
F i m
d o
R e l a t r i o
* * * *
A sada do Relatrio 02 lista o nome e o texto dos avisos definidos no ambiente.
Relatrio 03 - Listagem de Calendrios:

ibm
Relatrio 03
Lista de Calendrios do Usurio
Pgina 1
06/03/06
Tipo de calendrio: MONTHEND

Descrio: Final do ms at o final de 2006.
Jan 2006
Dom Seg Ter Qua Qui Sex Sb
.
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. 31
Abr 2006
Dom Seg Ter Qua Qui Sex
.
. . . . . .
. . . . . .
. . . . . .
. . . . . .
Jul 2006
Dom Seg Ter Qua Qui Sex
.
. . . . . .
. . . . . .
. . . . . .
. . . . . .
31
Fev 2006
Dom Seg Ter Qua Qui
. .
.
. . . .
.
. . . .
.
. . . .
.
. 28
Sex
.
.
.
.
Sb
.
.
.
.
Mar 2006
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 31
Sb
.
.
.
.
30
Dom
.
.
.
.
.
Seg
.
.
.
.
.
Mai 2006
Ter Qua Qui
.
.
.
. .
.
. .
.
. .
.
31
Sex
.
.
.
.
Sb
.
.
.
.
Jun 2006
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 30
Sb
.
.
.
.
.
Dom Seg
.
. .
. .
. .
. .
Ago 2006
Ter Qua Qui
.
.
.
. .
.
. .
.
. .
.
. 31
Sex
.
.
.
.
Sb
.
.
.
.
Set 2006
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 30
Nov 2006
Dom Seg Ter Qua Qui
. .
.
. . . .
.
. . . .
.
. . . .
.
. . . 30
Sex
.
.
.
.
Sb
.
.
.
.
Dez 2006
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 31
Out 2006
.
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. 31
491
* * * *
F i m
d o
R e l a t r i o
* * * *
Na sada, voc v destacado o final dos dias do ms selecionados no calendrio

MONTHEND.
Relatrio 04A - Listagem de Parmetros:

TWS para UNIX (AIX)/REPORT4A 8.3 (1.7)
Relatrio 4A
ibm
Listagem de Parmetros do Usurio
Nome do Parmetro
Contedo
ACCHOME
ACCLOGIN
BADEXIT
GOODEXIT
SCRPATH
/usr/local/Tivoli/maestro_adm
maestro_adm
99
0
/usr/local/Tivoli/maestro_adm/scripts
Nmero de Parmetros no arquivo:

* * * *
Pgina
1
06/03/06
5
F i m
d o
R e l a t r i o
* * * *
A sada do Relatrio 04A lista o nome e o contedo dos parmetros definidos no

ambiente.
Relatrio 04B - Listagem de Recursos:

TWS para UNIX (AIX)/REPORT4B 8.3 (1.7)
Relatrio 4B
Recurso
Nome
CPU
ibm
Listagem de Recursos do TWS
Nmero
Disponib.
Pgina 1
06/03/06
Descrio
FTAHP
#DATTAPES
Unidades de fita DAT
FTAWIN8+
#QUKTAPES
Unidades de fita Quick
MASTER8+
#TAPES
Unidades de fita
MASTER8+
#JOBSLOTS
1024
Slots de tarefas
Nmero de Recursos no arquivo:

* * * *
4
F i m d o
R e l a t r i o
* * * *
A sada do Relatrio 04B lista o nome, o nmero de recursos disponveis definidos

no ambiente e sua descrio.
Relatrio 07 - Listagem de Histricos da Tarefa:

ibm
Relatrio 07
Listagem de Histricos da Tarefa
Data
Hora
Nome do Fluxo de Tarefas
Tarefa:MASTER8+#MyJS Execues: Interrompidas 0

03/03/06
03/03/06
03/03/06
492
01:46
19:08
19:33
MASTER8+#JS1
MASTER8+#JS2
MASTER8+#JS3
1
1
1
Decorrido
CPU
Status
Bem-sucedidas 11
4
4
4
Pgina
1
08/03/06
Tempo Decorrido: Normal 1 Mn. 1 Mx. 2

SU
SU
SU
03/03/06
03/03/06
03/03/06
03/05/06
03/06/06
03/06/06
03/06/06
19:37
23:08
05:59
05:59
05:59
21:57
23:16
MASTER8+#JS4
MASTER8+#JS5
MASTER8+#JS_A
MASTER8+#JS_G
MASTER8+#JS_H
MASTER8+#TIMEJ
MASTER8+#SLEEPJ
1
2
1
1
1
2
1
4
4
4
4
4
4
4
Job:MASTER8+#JOB1
Execues: Interrompidas 0
03/06/06
MASTER8+#JOBS
22:22
* * * *
Bem-sucedidas 1
1
F i m d o
SU
SU
SU
SU
SU
SU
SU
Tempo Decorrido: Normal 1 Mn. 1 Mx. 1
SU
R e l a t r i o
* * * *
O Relatrio 7 l as informaes sobre a execuo da tarefa armazenada no banco

de dados e as exibe. Os possveis estados para uma tarefa so:
AB
para tarefas em falha
SU
para tarefas concludas com xito
DN
para tarefas enviadas cujo estado desconhecido porque nem uma

mensagem bem-sucedida nem uma em falha ainda foi recebida.
Relatrio 08 - Histograma da Tarefa:

ibm
Pgina
Relatrio 08
Histograma da Tarefa 05/03/06 14:05 - 06/03/06 14:04
1
06/03/05
Intervalo Por Coluna: 15 minutos

1
4
0
5
Nome do Job
06/03/06
1
5
3
5
1
7
0
5
1
8
3
5
2
0
0
5
2
1
3
5
2
3
0
5
0
0
3
5
0
2
0
5
0
3
3
5
0
5
0
5
0
6
3
5
0
8
0
5
0
9
3
5
1
1
0
5
1
2
3
5
1
4
0
4
Stat
CF05066+.JnextPlan
SU
.*.
* * * *
F i m
d o
R e l a t r i o
* * * *
A sada do Relatrio 8 mostra os perodos de tempo durante os quais os jobs so

executados. Os nmeros no incio do histograma do job so horrios, escritos de
cima para baixo, por exemplo, a primeira coluna 1405 significa 14h05. Os perodos
de tempo quando o job executado so marcados por asteriscos quando a posio
do marcador alinhada com um horrio escrito de cima para baixo e pontos.
Relatrio 9B - Detalhes da Produo Planejada:

TWS para UNIX (AIX)/REPORT 8.3 (1.7)
ibm
Relatrio 09B
Symnew
Detalhe da Produo Planejada para 06/03/06
Tempo de Exec.
Nome do Trab.
Estimado
Planejamento NETAG #EXTERNAL
E0000000
Total
00:00
Total
00:00
Planejamento MYFTA #IWDSKE
Pri
Hora de Incio
At
Pgina
1
06/03/06
Todas as Dep. de Limite
0
0
10
NETAG#EXTERNAL.E0000000
493
JOBIWD
Total
10
23:00(03/06/06) 01:00
00:00
Planejamento MYMST #TESTSKE

00:29 10
TESTCRO+
00:01 10
NEWTEST
00:29 10 08:30(06/03/06)
Total
00:29
TESTCROME
Planejamento MYMST #FINAL

00:00 10 05:59(07/03/06)
JnextPlan
00:01 10
Total
00:01
Total
00:34
* * * *
F i m
d o
R e l a t r i o
* * * *
A sada do Relatrio 9B mostra o que est planejado para ser executado na data
selecionada no ambiente do Tivoli Workload Scheduler. As informaes exibidas
so retiradas das definies armazenadas no banco de dados do Tivoli Workload
Scheduler. A sada mostra os fluxos de tarefas cuja execuo est planejada para o
dia 6 de maro de 2006 com sua descrio, a lista de tarefas contidas, as
dependncias de tempo, a taxa de repetio e o limite de tarefa, se configurado, e a
dependncia de outras tarefas ou fluxos de tarefas. Por exemplo, o fluxo de job
chamado iwdske, planejado para ser executado em MYFTA, tem uma dependncia
follows no job NETAG#EXTERNAL.E0000000, planejado para ser executado no agente
de rede chamado NETAG.
O campo Hora de Incio na sada dos relatrios gerados pelo comando reptr
mostra:
Uma restrio de tempo configurada na definio do fluxo de tarefas utilizando
a palavra-chave at.
Se a data estiver colocada entre parnteses (), por exemplo:
Hora de Incio
06:00(20/03/06)
A hora em que o fluxo de tarefa est planejado para execuo configurada na

definio do fluxo de tarefa utilizando a palavra-chave schedtime.
Se a data estiver colocada entre chaves {}, por exemplo:
Hora de Incio
06:00{03/20/06}
A hora em que o fluxo de tarefa realmente iniciou a execuo.

Se a data no estiver entre chaves ou entre parnteses, por exemplo:
Hora de Incio
06:00 20/03/06
Relatrio 10B - Detalhes da Produo Real:

TWS para UNIX (AIX)/REPORT 8.3 (1.7)
ibm
Relatrio 10B
Symphony
Detalhe da Produo Real para 06/03/06
Tempo de Exec.
Nome do Job
Estimado
Planejamento NETAG #EXTERNAL
E0000000
Total
00:00
CPU Status do
Nm. de Seg. Job
EXTRN
ERROR
00:00
10
1
07/03/06
Tempo de Exec.
Hora de Incio
Real
Planejamento MYMST #MONTHSKE

00:02
GETLOGS
00:02
10
Total
00:02
494
Prioridade
Pgina
06:01(06/03/06) 00:03
06:01(06/03/06) 00:03
00:03
0
SUCC
#J11612
SUCC
Planejamento MYFTA #IWSKE

JOBIWD
Total
10
Total
HOLD
00:00
00:00
Planejamento MYMST #TESTSKE

00:29
TESTCRO+
00:01
10
NEWTEST
00:29
10
Total
00:30
Planejamento MYMST #FINAL
JnextPlan
Total
HOLD
10
10
06:01(06/03/06) 00:02
06:01(06/03/06) 00:02
00:02
00:01
10
00:01
10
00:01
#J11613
F i m
d o
STUCK
ABEND
HOLD
05:59(07/03/06)
01:38
* * * *
HOLD
HOLD
00:00
00:09
R e l a t r i o
* * * *
A sada do Relatrio 10B mostra os estados das atividades de planejamento

atualmente em execuo na rede do Tivoli Workload Scheduler. As informaes
exibidas so retiradas da cpia do arquivo Symphony utilizado atualmente e
atualizado no ambiente de planejamento. Isso significa que a qualquer momento
que esse comando de relatrio for executado durante o processamento, as
informaes exibidas refletiro o status real da atividade planejada.
Se voc comparar essa sada com a sada do Relatrio 9B, ver que o fluxo de
tarefas MONTHSKE foi executado durante o dia de produo atual, 6 de maro, mas
sua execuo no est planejada para o dia seguinte, 7 de maro. O fluxo de job
EXTERNAL, por sua vez, falhou no agente de rede NETAG e, assim, o fluxo de job
IWSKE, que tem uma dependncia follows do fluxo de job EXTERNAL, permanece no
estado HOLD.
O fluxo de job TESTSKE, por sua vez, est no estado STUCK, que significa que
necessria a interveno do operador porque, dentro do tempo de execuo do
fluxo de job, o job TESTCROME, depois de ter sido iniciado com o ID de job J11613,
falhou no estado ABEND, fazendo com que o job dependente NEWTEST mudasse
para o estado HOLD.
Relatrio 11 Agendamento de Produo Planejada:

Relatrio 11
Agendamento de Produo Planejada para FEV 2006
Pgina
1
08/03/06
CPU: FTAWIN8+
Nm
Tempo
Planej. Trab. Est.Cpu
SCHED1
1
1
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
Te Qu Qu Se S Do Se Te Qu Qu Se S Do Se Te Qu Qu Se S So Se Te Qu Qu Se S Do Se
*
Um * entre o Nome do Planejamento e o Nmero de Jobs indica que o

planejamento possui jobs em execuo em outras cpus.
---------------------------------------------------------------------------------------------------Tempo Estimado de Cpu por Dia em Segundos
Seg
Ter
Qua
Qui
Sex
Sb
Dom
1
0
2
0
3
0
4
0
5
0
6
0
7
0
8
0
9
0
10
0
11
1
12
0
13
0
14
0
15
0
16
0
17
0
18
0
19
0
20
0
495
21
0
22
0
23
0
24
0
25
0
26
0
27
0
28
0
Relatrio 11
Agendamento de Produo Planejada para FEV 2006
Pgina
2
08/03/06
CPU: MASTER8+
Nm Tempo
Planej. Trab. Est.Cpu
FINAL
1
4
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
Te Qu Qu Se S Do Se Te Qu Qu Se S Do Se Te Qu Qu Se S So Se Te Qu Qu Se S Do Se
* * * * * * * * * * * * * * * * * * * * * * * * * * * *
Um * entre o Nome do Planejamento e o Nmero de Jobs indica que o

planejamento possui jobs em execuo em outras cpus.
---------------------------------------------------------------------------------------------------Tempo Estimado de Cpu por Dia em Segundos
Seg
Ter
Qua
Qui
Sex
Sb
Dom
1
4
2
4
3
4
4
4
5
4
6
4
7
4
8
4
9
4
10
4
11
4
12
4
13
4
14
4
15
4
16
4
17
4
18
4
19
4
20
4
21
4
22
4
23
4
24
4
25
4
26
4
27
4
28
4
* * * *
F i m
d o
R e l a t r i o
* * * *
A sada do Relatrio 11 mostra quando os fluxos de job so planejados para

execuo durante o ms selecionado. Na primeira linha exibido o nmero de jobs
que o fluxo de job contm, o tempo estimado de CPU utilizado pela execuo do
fluxo de job e para quando a execuo do fluxo de job foi planejada. Na matriz,
exibido para cada dia do ms selecionado o tempo estimado de CPU utilizado para
a execuo desse fluxo de job.
Relatrio 12 - Relatrio de Referncias Cruzadas:

A sada do Relatrio 12 mostra informaes diferentes de acordo com o sinalizador
utilizado ao emitir o comando xref. Nesta seo, voc localiza algumas amostras
de sada. Para cada uma delas, o sinalizador correspondente utilizado com o
comando xref realado.
xref -when
TWS para UNIX (AIX)/CROSSREF 8.3 (1.7)
ibm
Pgina 1
Relatrio 12 Relatrio de Referncia Cruzada para as opes ON, EXCEPT(*) e FREEDAYS(f). 03/08/06
CPU: FTAHP
WHEN
REQUEST
496
Utilizado pelos seguintes planejamentos:

TRFINAL

ibm
Pgina 2
CPU: FTAWIN8+
WHEN
MONTHEND
REQUEST

SCHED1
SCHED1 , SCHEDDAA

ibm
Pgina 3
CPU: MASTER8+
WHEN
EVERYDAY
REQUEST

FINAL
TMP
* * * *
F i m d o
R e l a t r i o
* * * *
xref -jobs
ibm
Pgina 4
Relatrio 12
Relatrio de Referncia Cruzada para Nomes de Tarefas.
08/03/06
CPU: FTAWIN8+
Nome do Job
SCHEDDDD
Existe em Planejamentos
SCHED1

ibm
Pgina 5
Relatrio 12
Relatrio de Referncia Cruzada para Nomes de Tarefas.
08/03/06
CPU: MASTER8+
Nome do Job
JnextPlan
JOB1
Existe em Planejamentos
FINAL
TMP
* * * *
F i m d o
R e l a t r i o
* * * *
xref -resource
ibm
Pgina 8
Relatrio 12
Relatrio de Referncia Cruzada para Usurios de Recursos.
08/03/06
CPU: FTAWIN8+
Recurso
QUKTAPES(N/F)
Utilizado pelo seguinte:

SCHED1

ibm
Pgina 9
Relatrio 12
Relatrio de Referncia Cruzada para Usurios de Recursos.
08/03/06
CPU: MASTER8+
Recurso

497
TAPES(N/F)
TMP
* * * *
F i m
d o
R e l a t r i o
* * * *
xref -prompts
ibm
Pgina 6
Relatrio 12
Relatrio de Referncia Cruzada para Dependncias de Prompts.
CPU: FTAWIN8+
Aviso
08/03/06
Texto definido pelo usurio
SCHED1

ibm
Pgina 7
Relatrio 12
Relatrio de Referncia Cruzada para Dependncias de Prompts.
08/03/06
CPU: MASTER8+
Aviso
BADEXIT
GOODEXIT

FTAWIN8+#SCHED1
FTAWIN8+#SCHED1 , TMP
Texto definido pelo usurio
TMP
* * * *
F i m
d o
R e l a t r i o
* * * *
xref -files
ibm
Pgina 10
Relatrio 12
Relatrio de Referncia Cruzada para Dependncias de Arquivo.
08/03/06
CPU: MASTER8+
Nome do Arquivo
/root/MY_FILE.sh

FTAWIN8+#SCHED1 , TMP
* * * *
F i m
d o
R e l a t r i o
* * * *
Programas de Extrao de Relatrio

Os programas de extrao de relatrio so utilizados para gerar vrios relatrios
do Tivoli Workload Scheduler. Os programas so listados na Tabela 64:
Tabela 64. Programas de Extrao de Relatrio.
Programa de extrao
de relatrio
498
Descrio
jbxtract
Utilizado para gerar o Relatrio 01 - Listagem de Detalhes da

Tarefa e para o Relatrio 07 - Listagem de Histricos da Tarefa
prxtract
Utilizado para gerar o Relatrio 02 - Listagem de Prompts
caxtract
Utilizado para gerar o Relatrio 03 - Listagem de Calendrios
paxtract
Utilizado para gerar o Relatrio 04A - Listagem de Parmetros
rextract
Utilizado para gerar o Relatrio 04B - Listagem de Recursos
r11xtr
Utilizado para gerar o Relatrio 11 - Agendamento de Produo

Planejada
Tabela 64. Programas de Extrao de Relatrio. (continuao)

Programa de extrao
de relatrio
Descrio
Utilizado para gerar o Relatrio 12 - Relatrio de Referncia
Cruzada
xrxtrct
A sada dos programas de extrao controlada pela varivel

MAESTRO_OUTPUT_STYLE, que define por quanto tempo os nomes de objetos
sero manipulados. Para obter informaes adicionais sobre a varivel
MAESTRO_OUTPUT_STYLE, consulte Descries dos comandos na pgina 480.
jbxtract
Extrai informaes sobre tarefas do banco de dados.
Sintaxe
jbxtract [-V | -U]
[-j job]
[-c wkstat]
[-o output]
Argumentos
-V
-U
-j job
Especifica o job para o qual a extrao executada. O padro so todos os

jobs.
-c wkstat
Especifica a estao de trabalho de jobs para a qual a extrao executada.
O padro todas as estaes de trabalho.
-o output
Especifica o arquivo de sada. O padro stdout.
Resultados
A varivel MAESTRO_OUTPUT_STYLE especifica o estilo de sada para nomes
longos de objetos. Defina a varivel como LONG para utilizar os campos de
comprimento completos (longos) para nomes de objetos. Se a varivel no estiver
definida ou estiver definida como algo diferente de LONG, os nomes longos sero
truncados para oito caracteres e um sinal de mais. Por exemplo: A1234567+.
Cada registro de job contm campos de comprimento varivel, delimitados por
tabulao. Os campos so descritos na Tabela 65.
Tabela 65. Campos de Sada de Jbxtract
Campo
Descrio
Comprimento
Mximo (bytes)
nome da estao de trabalho
16
nome do job
16
nome do arquivo de script do job
4096
descrio do job
65
499
Tabela 65. Campos de Sada de Jbxtract (continuao)

Campo
Descrio
Comprimento
Mximo (bytes)
nome da tarefa de recuperao
16
opo de recuperao (0=stop, 1=rerun, 2=continue)
texto do prompt de recuperao
64
sinalizador de documentao automtica (0=desativado,

1=ativado)
nome do usurio de logon do job
36
10
nome de usurio do criador do job
36
11
nmero de execues bem sucedidas
12
nmero de execues terminadas de forma anormal
13
tempo total decorrido de todas as execues do job
14
tempo total de cpu de todas as execues do job
15
tempo decorrido mdio
16
ltima data de execuo (ddmmyy)
17
ltima hora de execuo (hhmm)
18
ltimos segundos da cpu
19
ltimo tempo decorrido
20
segundos mximos de cpu
21
tempo mximo decorrido
22
data mxima de execuo (ddmmyy)
23
segundos mnimos de cpu
24
tempo mnimo decorrido
25
data mnima de execuo (ddmmyy)
Nota: O tempo decorrido exibido para uma tarefa sombra o tempo decorrido da
tarefa remota ao qual ele limitado.
|
|
Exemplos
Para extrair informaes sobre o job myjob na estao de trabalho main e direcionar
a sada para o arquivo jinfo, execute o seguinte comando:
jbxtract -j myjob -c main -o jinfo
prxtract
Extrai informaes sobre prompts do banco de dados.
Sintaxe
prxtract
[-V | -U] [-o output]
Argumentos
500
-V
-U
-o output
Resultados
Cada registro de prompt contm campos de comprimento varivel, delimitados por
Tabela 66. Campos de Sada de Prxtract
Campo
Descrio
Comprimento
Mximo (bytes)
nome do prompt
valor do prompt
200
Exemplos
Para extrair informaes sobre todas as definies de aviso e direcionar a sada
para o arquivo prinfo, execute o seguinte comando:
prxtract -o prinfo
caxtract
Extrai informaes sobre calendrios do banco de dados.
Sintaxe
caxtract [-V | -U] [-o output]
Argumentos
-V
-U
-o output
Resultados
Cada registro de calendrio contm campos de comprimento varivel, delimitados
por tabulao. Os campos so descritos na Tabela 67.
Tabela 67. Campos de Sada de Caxtract
Campo
Descrio
Comprimento
Mximo (bytes)
nome do calendrio
descrio do calendrio
64
Exemplos
Para extrair informaes sobre todas as definies de calendrio e direcionar a
sada para o arquivo cainfo, execute o seguinte comando:
caxtract -o cainfo
501
paxtract
Extrai informaes sobre parmetros globais (variveis) do banco de dados.
Sintaxe
paxtract [-V | -U] [-o output] [-a]
Argumentos
-V
-U
-o output
-a
Exibe todas as variveis definidas em todas as tabelas de variveis. Se no

for especificado, apenas as variveis definidas na tabela de variveis
padro sero exibidas.
Resultados
Cada registro de varivel contm campos de comprimento varivel, delimitados
por tabulao. Os campos so descritos na Tabela 68.
Tabela 68. Campos de Sada de Paxtract
Campo
Descrio
Comprimento
Mximo (bytes)
nome da tabela
80
nome da varivel
16
valor da varivel
72
Lembre-se: Se voc no especificar a opo -a (todos) no comando, apenas os

campos 2 e 3 sero exibidos e as variveis listadas sero aquelas
contidas na tabela de varivel padro apenas.
Exemplos
Para extrair informaes sobre todas as definies de variveis e direcionar a sada
para o arquivo allvarinfo, execute o seguinte comando:
paxtract -a -o allvarinfo
rextract
Extrai informaes sobre recursos do banco de dados.
Sintaxe
rextract [-V | -U] [-o output]
Argumentos
502
-V
-U
-o output
Resultados
Cada registro de recurso contm campos de comprimento varivel, delimitados por
Tabela 69. Campos de Sada de Rextract
Campo
Descrio
Comprimento
Mximo (bytes)
8/16
nome do recurso
unidades de recurso totais
descrio do recurso
72
Exemplos
Para extrair informaes sobre todas as definies de recurso e direcionar a sada
para o arquivo reinfo, execute o seguinte comando:
rextract -o reinfo
r11xtr
Extrai informaes sobre fluxos de tarefa do banco de dados.
Sintaxe
r11xtr [-V | -U]
[-m mm[yyyy]]
[-c wkstat]
[-o output]
[-s jstream_name]
Argumentos
-V
Exibe a verso do programa e sai.
-U
Exibe as informaes de uso do programa e sai.
-m mm[yy]
Especifica o ms (mm) e, opcionalmente, o ano (yy) dos fluxos de job. O
padro o ms e ano atuais.
-c wkstat
Especifica a estao de trabalho a ser relatada. O padro todas as
estaes de trabalho.
-s jstream_name
-o output
503
Resultados
Cada registro de fluxo de job contm campos de comprimento varivel,
delimitados por tabulao. Os campos so descritos na Tabela 70.
Tabela 70. Campos de Sada de R11xtr
Campo
Descrio
Comprimento
Mximo (bytes)
16
nome do fluxo de job
16
data do fluxo de job (ddmmyy)
segundos estimados de cpu
sinalizador mltiplo de estao de trabalho (* significa

que alguns jobs so executados em outras estaes de
trabalho)
nmero de jobs
dia da semana (Su, Mo, Tu, We, Th, Fr, Sa)
Exemplos
Para extrair informaes sobre os fluxos de job em junho de 2004 para a estao de
trabalho main, execute o seguinte comando:
r11xtr -m 0604 -c main
Para extrair informaes sobre os fluxos de job em junho deste ano para todas as
estaes de trabalho e direcionar a sada para o arquivo r11out, execute o seguinte
comando:
r11xtr -m 06 -o r11out
xrxtrct
Extrai informaes sobre referncias cruzadas do banco de dados.
Sintaxe
xrxtrct [-V | -U]
Argumentos
-V
-U
Resultados
504

A sada do comando gravada em oito arquivos: xdep_job, xdep_sched, xfile,
xjob, xprompt, xresources, xsched e xwhen. Esses arquivos so gravados no
diretrio atualmente em funcionamento. Voc deve ter direitos de gravao e
execuo nesse diretrio para executar o comando.
Exemplos
Para extrair informaes sobre todas as referncias cruzadas, execute o seguinte
comando:
xrxtrct
Arquivo xdep_job
O arquivo xdep_job contm dois tipos de registros. O primeiro contm
informaes sobre jobs e fluxos de job que so dependentes de um job. Cada
registro de job e fluxo de job dependente contm campos de comprimento fixo,
sem delimitadores. Os campos so descritos na Tabela 71.
Tabela 71. Campos de Sada de Xdep_job
Campo
Descrio
Comprimento
(bytes)
03
16
nome do job
40
16
no utilizado
240
nome da estao de trabalho do fluxo de job

dependente
16
nome do fluxo de job dependente
16
nome da estao de trabalho do job dependente
16
nome da tarefa dependente
40
10
no utilizado
11
no utilizado
12
no utilizado
13
fim do registro (nulo)
O segundo tipo de registro contm informaes sobre jobs e fluxos de job que so
dependentes de uma dependncia entre redes. Cada registro de job e fluxo de job
dependente contm campos de comprimento fixo, sem delimitadores. Os campos
so descritos na Tabela 72.
Tabela 72. Campos de Sada de Xdep_job (continuao)
Campo
Descrio
Comprimento
(bytes)
08
16
505
Tabela 72. Campos de Sada de Xdep_job (continuao) (continuao)

Campo
Descrio
Comprimento
(bytes)
nome do job
120
no utilizado
128

dependente
16
16
16
40
no utilizado
10
no utilizado
11
no utilizado
12
Arquivo xdep_sched
O arquivo xdep_sched contm informaes sobre tarefas e fluxos de tarefas que
so dependentes de um fluxo de tarefa. Cada registro de tarefa ou de fluxo de
tarefa dependente contm campos de comprimento fixo, sem delimitadores. Os
campos so descritos na Tabela 73.
Tabela 73. Campos de Sada de Xdep_sched
Campo
Descrio
Comprimento
(bytes)
02
16
16
no utilizado
248

dependente
16
16
16
40
no utilizado
10
no utilizado
11
no utilizado
12
Arquivo xfile
O arquivo xfile contm informaes sobre jobs e fluxos de job que so
dependentes de um arquivo. Cada registro contm campos de comprimento fixo,
sem delimitadores. Os campos so descritos na Tabela 74 na pgina 507.
506
Tabela 74. Campos de Sada de Xfile

Campo
Descrio
Comprimento
(bytes)
07
16
nome do arquivo
256

dependente
16
16
16
40
no utilizado
no utilizado
10
no utilizado
11
Arquivo xjob
O arquivo xjob contm informaes sobre os fluxos de job nos quais cada job
aparece. Cada registro de job contm campos de comprimento fixo, sem
delimitadores. Os campos so descritos na Tabela 75.
Tabela 75. Campos de Sada de Xjob
Campo
Descrio
Comprimento (bytes)
04
16
nome do job
40
no utilizado
248
nome da estao de trabalho do fluxo de tarefa
16
16
no utilizado
no utilizado
no utilizado
10
no utilizado
11
no utilizado
12
Arquivo xprompt
O arquivo xprompt contm informaes sobre jobs e fluxos de job que so
dependentes de um prompt. Cada registro de prompt contm campos de
comprimento fixo, sem delimitadores. Os campos so descritos na Tabela 76 na
pgina 508.
507
Tabela 76. Campos de Sada de Xprompts

Campo
Descrio
Comprimento
(bytes)
05
16
nome ou texto do prompt
20
no utilizado
236

dependente
16
16
16
40
no utilizado
10
no utilizado
11
no utilizado
12
Arquivo xresource
O arquivo xresource contm informaes sobre jobs e fluxos de job que so
dependentes de um recurso. Cada registro de recurso contm campos de
comprimento fixo, sem delimitadores. Os campos so descritos na Tabela 77.
Tabela 77. Campos de Sada de Xresource
Campo
Descrio
Comprimento
(bytes)
06
16
nome do recurso
no utilizado
248

dependente
16
16
16
40
unidades alocadas
10
no utilizado
11
no utilizado
12
Arquivo xsched
O arquivo xsched contm informaes sobre fluxos de job. Cada registro de fluxo
de job contm campos de comprimento fixo, sem delimitadores. Os campos so
descritos na Tabela 78 na pgina 509.
508
Tabela 78. Campos de Sada de Xsched

Campo
Descrio
Comprimento
(bytes)
00
16
16
no utilizado
248
nome da estao de trabalho (o mesmo de 2 acima)
16
nome do fluxo de job (o mesmo de 3 acima)
16
no utilizado
no utilizado
no utilizado
10
no utilizado
11
no utilizado
12
Arquivo xwhen
O arquivo xwhen contm informaes sobre quando os fluxos de job sero
executados. Cada registro de fluxo de job contm os campos de comprimento fixo,
sem delimitadores, a seguir. Os campos so descritos na Tabela 79.
Tabela 79. Campos de Sada de Xwhen
Campo
Descrio
Comprimento
(bytes)
01
16
nome ou data ON/EXCEPT
sinalizador de exceo (*=EXCEPT)
no utilizado
128
16
16
no utilizado
no utilizado
10
no utilizado
11
nm. de deslocamento
12
unidade de deslocamento
13
Executando Relatrios do Dynamic Workload Console e relatrios em

lote
possvel executar os relatrios a seguir a partir do Dynamic Workload Console :
509
Relatrio de Histrico de Execuo da Tarefa

Um relatrio que coleta os dados de histrico de execuo da tarefa
durante um intervalo de tempo especificado. til detectar quais tarefas
terminaram em erro ou estavam atrasadas. Ele tambm mostra tarefas que
perderam seu prazo final, tarefas de longa durao e indicadores de
reexecuo para reexecues.
Relatrio de Estatsticas de Execuo da Tarefa
UM relatrio que coleta as estatsticas de execuo da tarefa. til detectar
taxas de sucesso e de erros; durao mnima, mxima e mdia; estatsticas
de atraso e de longa durao.
Relatrio de Resumo de Carga de Trabalho da Estao de Trabalho
Um relatrio que mostra a carga de trabalho nas estaes de trabalho
especificadas. A carga de trabalho expressa em termos de nmero de
tarefas que so executadas nelas. til para ajustes de planejamento da
capacidade (modelagem de carga de trabalho e ajuste de estao de
trabalho).
Relatrio de Tempos de Execuo de Carga de Trabalho da Estao de Trabalho
Um relatrio mostrando os tempos de execuo e durao das tarefas nas
estaes de trabalho especificadas. til para ajustes de planejamento da
capacidade (modelagem de carga de trabalho e ajuste de estao de
trabalho).
Relatrio Detalhes de Produo Planejada
Um relatrio baseado nas informaes armazenadas em um plano de
experincia ou de previso. As informaes contidas nesses planos so
recuperadas do banco de dados do Tivoli Workload Scheduler. Um
Relatrio de Detalhes de Produo Planejada pode ser executado em
mecanismos distribudos (gerenciador de domnio principal e gerenciador
de domnio principal de backup). Um relatrio de produo real extrado
de um agente tolerante a falhas pode conter informaes diferentes com
relao a um plano extrado de um gerenciador de domnio principal. Por
exemplo, o nmero de tarefas e fluxos de tarefas o mesmo, mas o status
pode alterar, pois uma tarefa bem-sucedida no principal pode estar
suspensa ou pronta no agente. A taxa do status de atualizao a mesma
somente no agente de status integral que executado no principal do
domnio.
Relatrio Detalhes Reais de Produo
Um relatrio baseado nas informaes armazenadas no plano atual ou em
um plano arquivado. As informaes contidas nesses planos so
recuperadas dos arquivos Symphony. O Relatrio de Detalhes de Produo
Real pode ser executado em mecanismos distribudos (gerenciador de
domnio principal, gerenciador de domnio de backup, gerenciador de
domnio com conector e agente tolerante a falhas com conector).
Relatrio SQL Customizado
Permite criar relatrios executando suas prprias consultas SQL. Os
relatrios exibiro uma tabela com o nome de coluna, conforme
especificado na parte SELECT da instruo SQL. Os dados para relatrio
so armazenados em um banco de dados relacional DB2 e residem do lado
distribudo. O Tivoli Workload Scheduler para z/OS conecta ao banco de
dados por meio da interface Java Database Connectivity (JDBC). Um driver
JDBC tipo 4 usado para conectar ao DB2 para LUW verso 8.2 ou
posterior remoto.
|
|
|
|
|
|
|
|
|
510
Alguns desses relatrios tambm esto disponveis como relatrios em lote e podem
ser executados a partir de uma linha de comandos. Para obter informaes
adicionais sobre como executar relatrios em lote, consulte Executando relatrios
em lote a partir da Interface de Linha de Comandos na pgina 516.
|
|
Dependendo da interface a partir da qual o relatrio executado ou do sistema

operacional do mecanismo, os formatos de sada a seguir esto disponveis:
Tabela 80. Formatos de Sada de Relatrio Suportados
|
|
|
Nome do relatrio
Formatos de sada
suportados pelo Dynamic
Workload Console
Formatos de sada
suportados pelos relatrios
em lote
|
|
Relatrio de Histrico de
Execuo da Tarefa
HTML, CSV
Apenas formato de tabela
HTML, CSV, PDF

|
|
Relatrio de Estatsticas de
Execuo da Tarefa
HTML, CSV
HTML, CSV, PDF
Formatos de tabela e grfico Formatos de tabela e grfico
|
|
|
Relatrio de Resumo de
Carga de Trabalho da
Estao de Trabalho
HTML, CSV
HTML, CSV, PDF
|
|
|
|
Relatrio de Tempos de
Execuo de Carga de
Trabalho da Estao de
Trabalho
HTML, CSV
HTML, CSV, PDF
|
|
Relatrio Detalhes de
Produo Planejada
XML, CSV
N/D
|
|
Relatrio Detalhes Reais de

Produo
XML, CSV
N/D
|
|
Relatrio SQL Customizado
HTML, CSV
HTML, CSV, PDF

|
|
Relatrio geral de auditoria
N/D
HTML, CSV, PDF

|
|
|
Relatrio detalhado de
auditoria
N/D
HTML, CSV, PDF

Voc deve ter as autorizaes apropriadas do arquivo de segurana para objetos de

relatrios para executar estes relatrios (concedidas por padro no tws_user nas
novas instalaes). Consulte Administration Guide para obter informaes sobre o
arquivo de segurana.
Consulte tambm o Administration Guide para aprender como configurar o
Dynamic Workload Console para visualizar relatrios.
Relatrios de Histrico
A tabela a seguir resume os relatrios de histrico em termos de:
v Funcionalidade
v Critrios de Seleo
v Opes de Contedo de Sada
511
Tabela 81. Resumo dos relatrios de histrico

Nome do Relatrio
Descrio
Critrios de Seleo
v Nome da tarefa,
nome do fluxo de
tarefas, nome da
estao de trabalho
Coleta dados
e nome da estao
histricos de
de trabalho (fluxo
execuo da tarefa
de tarefas). Cada
durante um intervalo
campo pode ser
de tempo. Ajuda
especificado
voc a localizar:
usando um
v Tarefas encerradas
curinga.
com erro
v Status (Sucesso,
v Tarefas atrasadas
Erro,
v Prazos finais
Desconhecido)
ultrapassados
v Indicadores de
v Longa durao
atraso
v Indicadores de
v Intervalo de
reexecuo para
execuo da tarefa
reexecues
v Incluir/Excluir
v Outras
iteraes de
informaes de
reexecuo
histrico.
Histrico de execuo
Corresponde ao
da tarefa
Relatrio 07.
Nota: O relatrio no
inclui tarefas que
tenham sido enviadas
com a utilizao de
um nome de alias.
512
Opes de Contedo
de Sada
possvel selecionar
entre os seguintes:
v Horrio de incio
real
v Durao prevista
v Durao real
v Nmero da tarefa
v Iniciado com
atraso (atraso)
v Encerrado com
atraso (atraso)
v Status
v Longa durao
v Nome da definio
de tarefa
v Consumo de CPU
(no disponvel em
estaes de
trabalho do
Windows)
v Usurio de logon
v Tipo de reexecuo
v Nmero de
Iterao
v Cdigo de retorno
A sada est na
visualizao de
tabela.
Tabela 81. Resumo dos relatrios de histrico (continuao)

Nome do Relatrio
Estatsticas de
execuo da tarefa
Descrio
Critrios de Seleo
v Nome da tarefa,
nome da estao
de trabalho e login
do usurio. Cada
Coleta estatsticas de
campo pode ser
execuo da tarefa.
especificado
Ajuda voc a
usando um
localizar:
curinga.
v Taxas de xito/erro v Percentual de
v Tempos mnimo e
tarefas em xito,
mximo decorridos
Erro, Iniciado com
e tempo de CPU
Atraso, Encerrado
v Durao mdia
com Atraso e
v Estatsticas de
Longa Durao.
atraso e longa
v Total de execues
durao
e total de
reexecues
Nota: O relatrio no
inclui tarefas que
com a utilizao de
um nome de alias.
Corresponde ao
Relatrio 01.
Opes de Contedo
de Sada
possvel selecionar
entre os seguintes:
v Detalhes da tarefa:
Usurio de
logon
Criador da
tarefa
Descrio
Script
Informaes de
Recuperao
v Estatsticas da
tarefa:
Total de
execues
(divididas em
xito e Erro)
Total de
excees de
tempo de
execuo
(Iniciado com
Atraso,
Encerrado com
Atraso, Longa
Durao)
Durao
mnima,
mxima e mdia
e tempos de
CPU (somente
para execues
bem-sucedidas)
Consumo de
CPU (no
disponvel em
estaes de
trabalho do
Windows)
v Formato do
relatrio:
Visualizao de
grficos
Visualizao de
Tabela
Incluir ndice
por tarefa ou
por estao de
trabalho
513

Nome do Relatrio
Resumo de carga de
trabalho da estao
de trabalho
514
Descrio
Critrios de Seleo
Fornece dados sobre v Nomes da estao

a carga de trabalho
de trabalho. Cada
em termos do
campo pode ser
nmero de tarefas
especificado
executadas em cada
usando um
estao de trabalho.
curinga.
Ajuda a fazer os
v Intervalos de datas
ajustes necessrios no
ou dias especficos
planejamento da
para filtragem de
capacidade
cargas de trabalho.
(modelagem da carga v Intervalos de
de trabalho e ajuste
tempo relativos
da estao de
(permite a
trabalho).
reutilizao da
mesma tarefa de
relatrio para
execuo diria e
obteno do
relatrio da
produo do dia
anterior)
Opes de Contedo
de Sada
possvel selecionar
entre os seguintes:
v Granularidade de
informaes da
estao de trabalho
organizada por:
Horas
Dia
Dia de
produo
v Opes de
agregao de
informaes:
Fornecer
informaes
resumidas
acumulativas e
agregadas da
estao de
trabalho para
todas ou para
um subconjunto
desejado de
estaes de
trabalho
v Formato do
relatrio:
Visualizao de
grficos
Visualizao de
Tabela
Incluir ndice
por data ou por
estao de
trabalho

Nome do Relatrio
Descrio
Critrios de Seleo
v Nomes da tarefa e
Tempos de execuo
da carga de trabalho Corresponde ao
da estao de
Relatrio 08.
da estao de
trabalho. Cada
trabalho
campo pode ser
Fornece dados sobre
especificado
execues de tarefas
usando um
(tempo e durao)
curinga.
nas estaes de
v Perodo de
trabalho. Ajuda a
execuo da carga
fazer os ajustes
de trabalho
necessrios no
v Intervalos de
planejamento da
tempo dirios
capacidade
(modelagem da carga
de trabalho e ajuste
da estao de
trabalho).
Nota: O relatrio no
inclui tarefas que
com a utilizao de
um nome de alias.
SQL Customizada
Um assistente ajuda
voc a definir sua
consulta SQL
customizada
(somente nas
visualizaes de
banco de dados para
as quais voc possui
autorizao de
acesso).
Os critrios
especificados na
consulta SQL
customizada.
Opes de Contedo
de Sada
possvel selecionar
entre os seguintes:
v Informaes
agrupadas por:
Estao de
Trabalho
Data da
execuo
Podem ser
ordenadas por
iterao de
reexecuo
v Dia de produo
v Informaes da
tarefa:
Durao real
Status
Iterao de
reexecuo
Nome da
definio de
tarefa
v Formato do
relatrio:
Visualizao de
grficos
Visualizao de
Tabela
O relatrio resultante
possui uma tabela
com o nome de
coluna conforme
especificado na parte
SELECT da instruo
SQL.
Relatrios de Produo
A tabela a seguir resume os relatrios de produo no que se refere a:
v Funcionalidade
v Critrios de Seleo
v Opes de Contedo de Sada
515
Tabela 82. Resumo dos relatrios de produo

Nome do Relatrio
Descrio
Detalhes de produo
Corresponde ao
real
Relatrio 10B.
Fornece dados sobre
os planos atuais e
arquivados.
Detalhes de produo
Corresponde ao
planejada
Relatrio 9B.
Fornece dados sobre
os planos de
experincia e
previso.
Critrios de Seleo
Opes de Contedo
de Sada
possvel selecionar
v Nome da tarefa
entre os seguintes:
v Nome da estao
de trabalho (tarefa) v Formato do
relatrio:
v Nome do Fluxo de
Simples
Job
CSV
v Nome da estao
Microsoft
de trabalho (fluxo
Project
de tarefas)
v Incluir:
Predecessor de
primeiro nvel
Log da tarefa
possvel selecionar
v Nome da tarefa
entre os seguintes:
v Nome da estao
de trabalho (tarefa) v Formato do
relatrio:
v Nome do Fluxo de
Simples
Job
CSV
v Nome da estao
Microsoft
de trabalho (fluxo
Project
de tarefas)
v Incluir:
Predecessor de
primeiro nvel
Log da tarefa
Executando relatrios em lote a partir da Interface de Linha

de Comandos
|
|
Esta seo descreve como possvel executar a partir da linha de comandos os

relatrios listados em Relatrios de Histrico na pgina 511.
|
|
Usando uma interface da linha de comandos possvel planejar a execuo desses

relatrios periodicamente.
|
|
|
|
|
Um Cenrio de Negcios de Amostra
|
|
Para satisfazer essa solicitao, o TWSWEBUIDeveloper cria Workload Workstation

Summary Reports (WWS) e Workload Workstation Runtimes Reports (WWR).
|
|
|
|
Para realizar essa tarefa, ele executa as seguintes etapas:

1. Ele customiza os arquivos de propriedades relacionados aos relatrios
Workload Workstation Summary e Workload Workstation Runtimes,
especificando o formato e o contedo da sada de relatrio.
|
|
|
|
2. Ele planeja tarefas para obter relatrios WWS e WWR:

v A primeira tarefa gera um relatrio WWS para ser salvo localmente.
v A segunda tarefa executa um relatrio WWR durante a noite sobre perodos
de tempo de picos de carga de trabalho esperados. A sada de relatrio
Para evitar uma desacelerao inesperada no processamento de carga de trabalho,

o analista de uma empresa grande precisa de relatrios semanais que coletem
informaes de histrico sobre a carga de trabalho processada para determinar e
analisar quaisquer picos de carga de trabalho que possam ocorrer.
516
|
|
|
|
enviada usando um e-mail para ao analista. As informaes coletadas so

usadas para otimizar o o balanceamento de carga de trabalho nos sistemas.
3. Ele inclui as duas tarefas em um fluxo de tarefas planejado para execuo
semanal e gera o plano.
Configurando para Relatrio de Linha de Comandos
|
|
|
|
|
|
|
|
|
|
Antes de executar relatrios em lote, voc deve executar algumas etapas de

configurao:
1. O software necessrio para executar o relatrios em lote est contido em um
pacote chamado TWSBatchReportCli, includo na imagem de instalao do
Tivoli Workload Scheduler, no diretrio TWSBatchReportCli. Se planeja executar
relatrios em lote a partir de uma tarefa planejada, extraia o arquivo do pacote
em uma das plataformas listadas em http://www.ibm.com/support/
docview.wss?rs=672&uid=swg27020800
Aps extrair o pacote, voc ter a seguinte estrutura de diretrio:
|
|
|
|
|
Como o utilitrio tar nativo UNIX no suporta nomes de arquivos longos, se

voc estiver extraindo os arquivos em sistemas AIX, Solaris ou HP-UX,
assegure-se de que a verso GNU mais recente de tar (gtar) esteja instalada
para extrair os arquivos com xito.
Nota:
|
|
a. Certifique de que os comandos a seguir sejam executados no

diretrio onde os arquivos foram extrados:
|
|
|
No UNIX
|
|
|
No Windows
Assegure que o Tivoli Workload Scheduler esteja instalado.
|
|
|
|
|
|
|
|
|
chmod -R +x *
chown -R nome de usurio *
setown -u username *
em que username o usurio do Tivoli Workload Scheduler que

executar os relatrios.
b. Se voc planeja programar tarefas que executam relatrios em lote, o
sistema onde o pacote extrado deve estar acessvel como sistema
de arquivos de rede a partir de um agente tolerante a falhas definido
no ambiente de planejamento local.
2. Configure o arquivo de modelo .\config\common.properties especificando as
informaes para:
a. Conecte ao banco de dados onde os dados histricos esto armazenados.
517
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
b. Configure o formato de data e hora, incluindo o fuso horrio. O arquivo

.\config\timezone.txt contm uma lista de fuso horrios suportados pelo
Tivoli Workload Scheduler e as informaes sobre como configur-los. Os
nomes de fuso horrio fazem distino entre maisculas e minsculas.
c. Disponibilize a sada de relatrio na URL especificada no campo
ContextRootUrl. Este um exemplo de definies de configurao:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Nesse caso, certifique-se de que o output_report_dir especificado ao executar

o comando relatrios em lote aponte para o mesmo diretrio especificado
no campo ContextRootUrl.
######################################################################
# HTTP Server information
######################################################################
#Specify the context root where the report will be available
#To leverage this possibility it needs to specify in the report output dir
#the directory that is referred by your HTTP Server with this contect root
ContextRootUrl=http://myserver/reportoutput
d. Envie a sada de relatrio usando um e-mail. Este um exemplo de

definies de configurao:
######################################################################
# Email Server configuration
######################################################################
PARAM_SendReportByEmail=true
#SMTP server
mail.smtp.host=myhost.mydomain.com
#IMAP provider
mail.imap.socketFactory.fallback=false
mail.imap.port=993
mail.imap.socketFactory.port=993
#POP3 provider
mail.pop3.socketFactory.fallback=false
mail.pop3.port=995
mail.pop3.socketFactory.port=995
######################################################################
# Email properties
######################################################################
PARAM_EmailFrom=user1@your_company.com
PARAM_EmailTo=user2@your_company.com,user3@your_company.com
PARAM_EmailCC=user4@your_company.com
PARAM_EmailBCC=user5@your_company.com
PARAM_EmailSubject=Test send report by email
PARAM_EmailBody=This is the report attached
Uma explicao de todos os campos customizveis est contida no arquivo de

modelo.
|
|
|
|
|
|
|
Nota: Se voc planeja executar relatrios do Workstation Workload Runtime,

assegure que o sistema de arquivos onde o banco de dados est instalado
tenha espao livre suficiente. Se ocorrer falta de espao em disco, uma
exceo SQL como a seguinte acionada:
Executando relatrios em lote
|
|
O diretrio \reports\templates contm um arquivo de modelo de amostra para

cada tipo de relatrio.
DB2 SQL error: SQLCODE: -968, SQLSTATE: 57011
518
|
|
Antes de executar qualquer um desses relatrios, certifique-se de customizar o

arquivo de modelo correspondente.
|
|
|
|
Nesse arquivo, denominado report_name.properties, possvel especificar:

v As informaes a exibir no cabealho de relatrio.
v Como filtrar as informaes para exibir o resultado esperado.
v O formato e o contedo da sada de relatrio.
|
|
Para obter informaes sobre as configuraes especficas, consulte a explicao

fornecida no arquivo de modelo ao lado de cada campo.
|
|
Se estiver usando caracteres DBCS para especificar os parmetros nos arquivos

.properties de modelo, assegure-se de salvar o arquivo na codificao UTF-8.
|
|
|
Aps configurar o ambiente como descrito em Configurando para Relatrio de

Linha de Comandos na pgina 517 e configurar o arquivo de modelo de relatrio,
use a sintaxe a seguir para executar o relatrio:
|
|
|
|
|
|
reportcli -p report_name.property
[-o output_report_dir]
[-r report_output_name]
[-k key=value ]
[-k key=value ]
.......
onde:
|
|
-p report_name.property
Especifica o nome do caminho para o arquivo de modelo de relatrio.
|
|
-o output_report_dir
Especifica o diretrio de sada para a sada de relatrio.
|
|
-r report_output_name
Especifica o nome da sada de relatrio.
|
|
|
|
-k key=value
Especifica o valor das configuraes. Esse valor substitui o valor
correspondente, se definido, no arquivo common.properties ou no arquivo
report_name.properties.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Exemplos
1. Neste exemplo, reportcli.cmd executado com o parmetro padro e produz o
relatrio jrh1:
reportcli.cmd -p D:\ReportCLI\TWSReportCli\reports\templates\jrh.properties
-r jrh1
2. Neste exemplo, reportcli.cmd executado usando o parmetro -k para

substituir os valores configurados para PARAM_DateFormat no arquivo
.\config\common.properties produz o relatrio jrh1:
reportcli.cmd -p D:\ReportCLI\TWSReportCli\reports\templates\jrh.properties
-r jrh2 -k PARAM_DateFormat=short
3. Neste exemplo, reportcli.cmd executado usando o parmetro -k para

substituir o formato especificado para a sada de relatrio no arquivo
PROPERTIES produz o relatrio jrh1:
./reportcli.sh -p /TWSReportCli/REPCLI/reports/templates/wwr.properties
-r wwr3 -k REPORT_OUTPUT_FORMAT=html -k OutputView=charts
519
4. Faa o seguinte se quiser executar um relatrio SQL Customizado e

disponibilizar a sada do relatrio na URL a seguir como http://myserver/
reportoutput/report1.html:
|
|
|
a. Configure o parmetro ContextRootUrl nos arquivos common.properties da

seguinte forma:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
######################################################################
# HTTP Server information
######################################################################
#Specify the context root where the report will be available
#To leverage this possibility it needs to specify in the report output dir
#the directory that is referred by your HTTP Server with this contect root
ContextRootUrl=http://myserver/reportoutput
b. Ao executar um comando relatrios em lote, especifique como

output_report_dir, um diretrio que aponte para o mesmo diretrio HTTP
especificado em ContextRootUrl. Por exemplo, se tiver mapeado localmente
o http://myserver/ como driver R:, possvel executar o seguinte:
reportclibat
-p REPORT_CLI_DIR\reports\TWS\historical\templates\sql.properties
-r report1
-o R:\reportoutput
c. Como uma confirmao para a execuo bem-sucedida do relatrio, a

mensagem a seguir exibida:
AWSBRC0106I Report available on: http://myserver/reportoutput/report1.html
Essa URL mostra onde a sada de relatrio est disponvel.
|
|
|
Nota: Se o relatrio for executado por meio de uma tarefa do Tivoli Workload
Scheduler, a sada do comando exibida na sada de tarefa.
|
|
|
Logs e Rastreios para relatrios em lote

O arquivo ./common_logging.properties contm os parmetros que possvel
usar para configurar rastreio e criao de log.
O arquivo contm as configuraes a seguir:
|
|
|
|
|
logFileName=reportcli.log
traceFileName=trace.log
trace=off
birt_trace=off
onde:
|
|
|
|
logFileName
Especifica o nome do arquivo contendo informaes genricas, avisando
sobre problemas em potencial e informaes sobre erros. Esse arquivo
armazenado sob ./log.
|
|
|
traceFileName
Especifica o nome do arquivo que contm rastreios. Se voc configurar
trace=on, o arquivo de rastreio armazenado sob ./log.
|
|
|
rastreio
|
|
|
birt_trace
Especifica se rastreios devem ser ativados ou no para diagnosticar erros
no mecanismo BIRT. Se voc configurar birt_trace=on, um arquivo que
Especifica se rastreios devem ser ativados ou no. Ative os rastreios

configurando trace=on se quiser investigar mais sobre um erro.
520
|
|
contm o rastreio e denominado ReportEngine_aaaa_mm_dd_hh_mm_ss.log

armazenado na pasta /ReportEngine/logs
521
522
Captulo 13. Gerenciando fusos horrios

O Tivoli Workload Scheduler suporta diferentes fusos horrios. Se voc ativar os
fusos horrios, poder gerenciar sua carga de trabalho em um ambiente de vrios
fusos horrios.
As anotaes de 3 caracteres e de comprimento varivel so suportadas.
A anotao de 3 caracteres suportada para retrocompatibilidade com verses
anteriores do Tivoli Workload Scheduler.
O formato da notao de tamanho varivel rea/cidade, por exemplo,
Europa/Paris como equivalente a ECT (Hora Central Europia).
No final deste captulo h duas sees, cada uma contendo uma tabela de listagem
de fusos horrios. A primeira mostra para cada formato de 3 caracteres o nome do
fuso horrio que j estava em utilizao e a anotao do nome longo padro
correspondente designada. A segunda contm o conjunto completo de fuso horrio
com anotao de nome longo.
O captulo est dividido nas seguintes sees:
v Ativando o Gerenciamento de Fuso Horrio
v Como o Tivoli Workload Scheduler Gerencia Fusos Horrios na pgina 524
v Mudando para o Horrio de Vero Ativado na pgina 526
v Mudando para o Horrio de Vero Desativado na pgina 526
v Regras Gerais na pgina 526
v Tabela de Fusos Horrios para Retrocompatibilidade na pgina 527
v Tabela completa de fusos horrios com notao de comprimento varivel na
pgina 529
Ativando o Gerenciamento de Fuso Horrio

possvel ativar ou desativar o gerenciamento de fuso horrios modificando a
configurao designada opo global enTimeZone no gerenciador de domnio
mestre utilizando a linha de comandos optman. A configurao efetivada depois
que o JnextPlan seguinte executado. Estas so as configuraes disponveis:
no
Desativar o gerenciamento de fuso horrio. Isso significa que os valores

designados a todas as palavras-chave timezone nas definies so
ignorados. Todas as restries de tempo at, until e deadline so
gerenciadas individualmente por cada agente tolerante a falhas, incluindo
os gerenciadores principal e de domnio, ignorando, assim, o fuso horrio
do agente que est planejando a tarefa ou fluxo de tarefas. Em
conseqncia, quando fusos horrios diferentes estiverem envolvidos:
v Para tarefas, informaes incorretas so exibidas sobre essas
dependncias de tempo quando observadas a partir de um agente
diferente do proprietrio da tarefa. Isso no afeta, entretanto, o processo
de planejamento da tarefa.
v Para fluxos de tarefas, o impacto que cada agente processa as
dependncias de tempo de acordo com seu prprio fuso horrio, e,
523
portanto, em horrios diferentes, fazendo com que tarefas do mesmo

fluxo de tarefas, mas definidas em agentes diferentes, sejam executadas
em horrios diferentes.
sim
Ativar o gerenciamento de fuso horrio. Isto significa que os valores

designados s configuraes de timezone so utilizados para calcular a
hora em que as tarefas e fluxos de tarefas so executados nas estaes de
trabalho de destino.
Por padro, a opo enTimeZone configurada para yes.

Para obter mais detalhes sobre como utilizar a linha de comandos optman para
gerenciar opes globais no gerenciador de domnio mestre, consulte o Guia de
Como o Tivoli Workload Scheduler Gerencia Fusos Horrios

Quando o fuso horrio est ativado, possvel utilizar configuraes de fuso
horrio nas definies de estao de trabalho, tarefa e fluxo de tarefa.
Ao desempenhar atividades de gerenciamento de planejamento, o Tivoli Workload
Scheduler converte o conjunto de valores para os fusos horrios nas definies de
objetos. As converses so aplicadas nesta ordem:
1. Quando as instncias do fluxo de tarefas so includas no plano pr-produo,
o conjunto de fusos horrios nas definies de fluxo de tarefa convertido no
fuso horrio GMT e, em seguida, as dependncias de fluxo externas so
resolvidas.
2. Quando o plano de produo criado ou estendido, as instncias do fluxo de
tarefas so designadas s estaes de trabalho nas quais a instncia planejada
para executar e o fuso horrio convertido de GMT no fuso horrio
configurado na definio da estao de trabalho de destino.
Este o motivo pelo qual, se voc utilizar os comandos conman showsched ou
conman showjobs para ver as informaes sobre as tarefas planejadas e os fluxos
de tarefas, ver os valores de fuso horrio expressos utilizando o fuso horrio
configurado na estao de trabalho na qual a tarefa ou fluxo de tarefas est
planejado para executar. Com base na configurao da opo global
enLegacyStartOfDayEvaluation, possvel decidir como o produto gerencia fusos
horrios durante o processamento e, precisamente:
Se voc configurar o valor de enLegacyStartOfDayEvaluation para no
O valor designado opo startOfDay no gerenciador de domnio mestre
no convertido no fuso horrio local configurado em cada estao de
trabalho na rede. Isto significa que, se a opo startOfDay estiver
configurada como 0600 no gerenciador de domnio mestre, ser 0600 no
fuso horrio local configurado em cada estao de trabalho na rede. Isto
tambm significa que o dia do processamento comea no mesmo horrio,
mas no no mesmo momento, em todas as estaes de trabalho.
Figura 27 na pgina 525 mostra como o incio do dia, configurado como
0600 no gerenciador de domnio mestre, aplicado em diferentes fusos
horrios nos dois agentes tolerantes a falhas. A mesma converso de tempo
aplicada nas trs instncias do emprego de tarefas JS1 planejado para
executar nas trs mquinas e que contm uma dependncia de tempo at no
fuso horrio 0745 US/Central. O perodo de tempo que identifica o novo
dia de processamento esmaecido em Figura 27 na pgina 525.
524
incio do dia
6h Lado leste dos EUA
+ 2h
Agente tolerante
a falhas 2
Fuso horrio do lado leste dos EUA (GMT-5)

JS1
JS1
Gerenciador de
Domnio Principal
Agente tolerante
a falhas 1
Fuso horrio do centro dos EUA (GMT-7)

7h45
JS1
Fuso horrio dos EUS/Samoa (GMT-11)
JS1
- 4h
incio do dia
6h hora do
centro dos EUA
incio do dia
6h EUA/Samoa
Figura 27. Exemplo quando a converso de incio do dia no aplicada
Se voc configurar o valor de enLegacyStartOfDayEvaluation para yes.

O valor designado opo startOfDay no gerenciador de domnio mestre
convertido no fuso horrio local configurado em cada estao de trabalho
na rede. Isto significa que, se a opo startOfDay for configurada como
0600 no gerenciador de domnio mestre, ela ser convertida em cada
estao de trabalho no horrio correspondente de acordo com o fuso
horrio local configurado nessa estao de trabalho. Tambm significa que
o dia do planejamento comea no mesmo momento, mas no
necessariamente na mesma hora, em todas as estaes de trabalho na rede.
Figura 28 mostra como o incio do dia, configurado como 0600 no
gerenciador de domnio mestre, aplicado em diferentes fusos horrios
nos dois agentes tolerantes a falhas. Tambm mostra como a
cronometragem das trs instncias de fluxo de tarefas JS1 planejadas para
executar nas trs mquinas e que contm uma dependncia de tempo at no
fuso horrio 0745 US/Central no modificada devido converso
startOfDay. O perodo de tempo que identifica o novo dia de
processamento esmaecido em Figura 28.
+ 2h
Agente tolerante
a falhas 2
Fuso horrio do lado leste dos EUA (GMT-5)

JS1
JS1
Gerenciador de
Domnio Principal
Agente tolerante
a falhas 1
Fuso horrio do centro dos EUA (GMT-7)

7h45
JS1
Fuso horrio dos EUS/Samoa (GMT-11)
JS1
- 4h
incio do dia
8h Lado leste dos EUA
incio do dia
6h hora do centro dos EUA
incio do dia
2h EUA/Samoa
Figura 28. Exemplo quando a converso de incio do dia aplicada
Nota: A partir da verso 8.3, no h nenhuma vinculao entre o horrio

configurado para startOfDay e o momento em que JnextPlan executado.
525
JnextPlan pode ser executado a qualquer momento e startOfDay indica

somente o momento em que o novo dia de processamento iniciado.
Por padro, a opo global enLegacyStartOfDayEvaluation configurada para no.
Para obter mais detalhes sobre como utilizar a linha de comandos optman para
gerenciar opes globais no gerenciador de domnio mestre, consulte o Guia de
Mudando para o Horrio de Vero Ativado

Tivoli Workload Scheduler gerencia a mudana para o Horrio de Vero (DST) ao
gerar o plano de produo. Isto significa que a data e hora para execuo
designadas s tarefas e fluxos de tarefas no plano j foram convertidas na data e
hora correspondentes ao DST ativado.
O exemplo a seguir explica como o Tivoli Workload Scheduler aplica a converso
de tempo quando o JnextPlan executado para gerar ou estender o plano de
produo enquanto a hora muda para DST.
Se DST estiver ativado s 15h, todos fluxos de tarefas planejados para iniciar entre
s 14h e 14h59 sero configurados para iniciar s 15h. A razo para fazer isto que
s 14h a hora do relgio movida uma hora frente porque o DST est ativado e,
portanto, todos os fluxos de tarefas planejados para iniciar entre 14h e 14h59, se
livres de dependncias, iniciaro imediatamente porque 15h posterior aos seus
horrios de incio planejados.
Mudando para o Horrio de Vero Desativado

Mudando para o Horrio de Vero (DST) desativado, a hora do relgio
configurada para uma hora anterior em relao ao horrio de DST. Para manter a
consistncia com os critrios de planejamento de produo, o Tivoli Workload
Scheduler assegura que as instncias do fluxo de tarefas planejadas para executar
durante a hora anterior ao retrocesso do deslocamento de tempo sejam executadas
somente uma vez. Como a converso de tempo aplicada ao gerar ou estender o
plano de produo, a data e hora para execuo designadas s tarefas e fluxos de
tarefas no plano j estaro convertidas na data e hora correspondentes com o DST
desativado.
Regras Gerais
Quando o fuso horrio ativado no ambiente do Tivoli Workload Scheduler,
independentemente de qual valor est configurado para a opo
enLegacyStartOfDayEvaluation, algumas regras gerais so aplicadas. Estas regras
agora so descritas divididas por tpico:
Identificando as configuraes de fuso horrio padro para tarefas e fluxos de
tarefas:
Em uma definio de fluxo de tarefa, possvel configurar um fuso horrio
para o fluxo de tarefas inteiro e para as tarefas contidas no fluxo de tarefas.
Esses fusos horrios podem diferir uns dos outros. Para gerenciar todas as
configuraes de fuso horrio possveis, a converso de fuso horrio feita
respeitando os seguintes critrios:
526
v Se um fuso horrio no for configurado para uma tarefa de um fluxo de

tarefa, ento, essa tarefa herda o fuso horrio configurado na estao de
trabalho onde a tarefa est planejada para execuo.
v Se um fuso horrio no for configurado para um fluxo de tarefas, ento,
o fuso horrio configurado o configurado na estao de trabalho onde
est planejada a execuo do fluxo de tarefas.
v Se nenhum dos fusos horrios mencionados for configurado, ento, o
fuso horrio utilizado o configurado para o gerenciador de domnio
mestre.
Escolhendo o fuso horrio correto para as estaes de trabalho:
Para evitar inconsistncias, antes de ativar o recurso de gerenciamento de
fuso horrio na rede do Tivoli Workload Scheduler, certifique-se de que, se
um fuso horrio estiver configurado na definio de estao de trabalho,
ele ser o mesmo que o fuso horrio configurado no sistema no qual a
estao de trabalho est instalada.
Configurao do fuso horrio padro para o gerenciador de domnio mestre:
Se um fuso horrio no estiver configurado na definio do gerenciador de
domnio mestre, ele herdar o fuso horrio configurado no sistema no qual
o gerenciador de domnio mestre est instalado. Para ver qual fuso horrio
est configurado no gerenciador de domnio mestre, possvel executar o
seguinte comando:
conman showcpu;info
Utilizando o fuso horrio nos agentes estendidos:

Os agentes estendidos herdam o fuso horrio do gerenciador de domnio
mestre.
Exibindo a configurao do fuso horrio na produo para uma dependncia de
tempo AT:
Se voc utilizar comandos conman sj ou ss para exibir uma tarefa ou um
fluxo de tarefa que possui uma dependncia de tempo at com um fuso
horrio configurado, a hora especificada para a dependncia at ser exibida
aplincando-se o fuso horrio definido na estao de trabalho em que a
tarefa ou fluxo de tarefa est definido para execuo.
Aplicando um deslocamento em um fuso horrio ao planejar um fluxo de
tarefas:
Se voc enviar na produo um fluxo de tarefas especificando uma
dependncia at com um deslocamento de +n dias, o Tivoli Workload
Scheduler primeiro incluir o deslocamento na data e, em seguida,
converter o fuso horrio configurado na dependncia at. Isto importante
especialmente ao fazer referncia ao horrio em que a mudana de Horrio
de Vero ocorre.
Como uma boa prtica, se voc ativar o gerenciamento de fuso horrio, configure
um fuso horrio em cada estao de trabalho de sua rede do Tivoli Workload
Scheduler.
Tabela de Fusos Horrios para Retrocompatibilidade

A Tabela 83 na pgina 528 mostra para cada fuso horrio com formato de 3
caracteres que estava em uso com as verses anteriores do produto, a anotao de
nome longo padro designada.
O nome do fuso horrio faz distino entre maisculas e minsculas.
527
Tabela 83. Tabela de Fusos Horrios para Retrocompatibilidade
528
Nome Longo
Nome
Abreviado Descrio
Relativo ao
GMT
GMT
GMT
Horrio de Greenwich
GMT
UTC
UTC
Hora Coordenada Universal
GMT
Europe/Paris
ECT
Hora Central Europia
GMT+1:00
Europe/Istanbul
EET
Hora do Leste Europeu
GMT+2:00
Africa/Cairo
ART
(rabe) Hora Local Egpcia
GMT+2:00
Asia/Riyadh
EAT
Hora do Leste Africano
GMT+3:00
Europe/Paris
MET
Hora da Europa Mdia
GMT+1:00
Asia/Yerevan
NET
Hora do Oriente Prximo
GMT+4:00
Asia/Karachi
PLT
Hora Lahore Paquistanesa
GMT+5:00
Asia/Calcutta
IST
Hora Local da ndia
GMT+5:30
Asia/Dacca
BST
Hora Local de Bangladesh
GMT+6:00
Asia/Bangkok
VST
Hora Local do Vietn
GMT+7:00
Asia/Shanghai
CTT
Hora de Taiwan da China
GMT+8:00
Asia/Tokyo
JST
Hora Local do Japo
GMT+9:00
Australia/Darwin
ACT
Hora Central da Austrlia
GMT+9:30
Australia/Sydney
AET
Hora Oriental da Austrlia
GMT+10:00
Pacific/Guadalcanal
SST
Hora Local de Salomo
GMT+11:00
Pacific/Fiji
NST
Hora Local de Nova Zelndia
GMT+12:00
Pacific/Apia
MIT
Hora das Ilhas Midway
GMT-11:00
Pacific/Honolulu
HST
Hora Local do Hava
GMT-10:00
America/Anchorage
AST
Hora Local do Alasca
GMT-9:00
America/Los_Angeles
PST
Horrio Padro do Pacfico
GMT-8:00
America/Phoenix
PNT
Hora Local de Fnix
GMT-7:00
America/Denver
MST
Horrio das Regies

Montanhosas
GMT-7:00
America/Chicago
CST
Horrio da Regio Central
GMT-6:00
America/New_York
EST
Horrio do Oriente
GMT-5:00
America/Indianapolis
IET
Hora Local do Leste de Indiana
GMT-5:00
America/Caracas
PRT
Hora de Porto Rico e Ilhas

Virgens dos EUA
GMT-4:00
America/St_Johns
CNT
Hora de Terra Nova do Canad
GMT-3:30
America/Buenos_Aires
AGT
Hora Local da Argentina
GMT-3:00
America/Sao_Paulo
BET
Hora do Leste do Brasil
GMT-3:00
Atlantic/Cape_Verde
CAT
Hora da frica Central
GMT-1:00
Tabela completa de fusos horrios com notao de comprimento

varivel
A Tabela 84 mostra todos os fusos horrios suportados expressos com notao de
comprimento varivel, suas descries e seus deslocamentos com relao ao GMT.
Os novos rtulos de fuso horrio que podem ser utilizados com esta verso do
produto so mostrados com barras de reviso. Observe que :
v Os nomes de fusos horrios fazem distino entre maisculas e minsculas.
v Os fusos horrios SystemV j no so mais suportados.
v Os novos nomes no so suportados pelas verses de Tivoli Workload Scheduler
anteriores a 8.4.
Tabela 84. Lista de Fusos Horrios com Notao de Comprimento Varivel
Descrio
Curta
Relativo ao
GMT
Hora Local Central

(Territrio do Norte)
CST
GMT+9:30
AET
Hora Local do Leste (Nova

Gales do Sul)
EST
GMT+10:00
Africa/Abidjan
Horrio de Greenwich
GMT
GMT+00:00
Africa/Accra
Horrio de Gana
GMT
GMT+00:00
Africa/Addis_Ababa
EAT
GMT+3:00
Africa/Algiers
Hora da Europa Central
CET
GMT+1:00
Africa/Asmara
EAT
GMT+3:00
Africa/Asmera
EAT
GMT+3:00
Africa/Bamako
Horrio de Greenwich
GMT
GMT+00:00
Africa/Bangui
Hora da frica Ocidental
WAT
GMT+1:00
Africa/Banjul
Horrio de Greenwich
GMT
GMT+00:00
Africa/Bissau
Horrio de Greenwich
GMT
GMT+00:00
Africa/Blantyre
CAT
GMT+2:00
Africa/Brazzaville
WAT
GMT+1:00
Africa/Bujumbura
CAT
GMT+2:00
Africa/Cairo
EET
GMT+2:00
Africa/Casablanca
Hora do Oeste Europeu
WET
GMT+00:00
Africa/Ceuta
CET
GMT+1:00
Africa/Conakry
Horrio de Greenwich
GMT
GMT+00:00
Africa/Dakar
Horrio de Greenwich
GMT
GMT+00:00
Africa/Dar_es_Salaam
EAT
GMT+3:00
Africa/Djibouti
EAT
GMT+3:00
Africa/Douala
WAT
GMT+1:00
Africa/El_Aaiun
WET
GMT+00:00
Africa/Freetown
Horrio de Greenwich
GMT
GMT+00:00
Africa/Gaborone
CAT
GMT+2:00
Africa/Harare
CAT
GMT+2:00
Nome Longo
Descrio
ACT
529
Tabela 84. Lista de Fusos Horrios com Notao de Comprimento Varivel (continuao)
530
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
Africa/Johannesburg
Hora Local da frica do Sul
SAST
GMT+2:00
Africa/Kampala
EAT
GMT+3:00
Africa/Khartoum
EAT
GMT+3:00
Africa/Kigali
CAT
GMT+2:00
Africa/Kinshasa
WAT
GMT+1:00
Africa/Lagos
WAT
GMT+1:00
Africa/Libreville
WAT
GMT+1:00
Africa/Lome
Horrio de Greenwich
GMT
GMT+00:00
Africa/Luanda
WAT
GMT+1:00
Africa/Lubumbashi
CAT
GMT+2:00
Africa/Lusaka
CAT
GMT+2:00
Africa/Malabo
WAT
GMT+1:00
Africa/Maputo
CAT
GMT+2:00
Africa/Maseru
SAST
GMT+2:00
Africa/Mbabane
SAST
GMT+2:00
Africa/Mogadishu
EAT
GMT+3:00
Africa/Monrovia
Horrio de Greenwich
GMT
GMT+00:00
Africa/Nairobi
EAT
GMT+3:00
Africa/Ndjamena
WAT
GMT+1:00
Africa/Niamey
WAT
GMT+1:00
Africa/Nouakchott
Horrio de Greenwich
GMT
GMT+00:00
Africa/Ouagadougou
Horrio de Greenwich
GMT
GMT+00:00
Africa/Porto-Novo
WAT
GMT+1:00
Africa/Sao_Tome
Horrio de Greenwich
GMT
GMT+00:00
Africa/Timbuktu
Horrio de Greenwich
GMT
GMT+00:00
Africa/Tripoli
EET
GMT+2:00
Africa/Tunis
CET
GMT+1:00
Africa/Windhoek
WAT
GMT+1:00
AGT
Hora da Argentina
ART
GMT-3:00
America/Adak
Hora Local do Hava-Aleutas HAST
GMT-10:00
America/Anchorage
AKST
GMT-9:00
America/Anguilla
Hora Local do Atlntico
AST
GMT-4:00
America/Antigua
AST
GMT-4:00
America/Araguaina
Horrio de Braslia
BRT
GMT-3:00
America/Argentina/
Buenos_Aires
Hora da Argentina
ART
GMT-3:00
America/Argentina/
Catamarca
Hora da Argentina
ART
GMT-3:00
America/Argentina/
ComodRivadavia
Hora da Argentina
ART
GMT-3:00
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
America/Argentina/
Cordoba
Hora da Argentina
ART
GMT-3:00
America/Argentina/Jujuy
Hora da Argentina
ART
GMT-3:00
America/Argentina/
La_Rioja
Hora da Argentina
ART
GMT-3:00
America/Argentina/
Mendoza
Hora da Argentina
ART
GMT-3:00
America/Argentina/
Rio_Gallegos
Hora da Argentina
ART
GMT-3:00
America/Argentina/Salta
Hora da Argentina
ART
GMT-3:00
America/Argentina/
San_Juan
Hora da Argentina
ART
GMT-3:00
America/Argentina/
San_Luis
Horrio da Argentina
Ocidental
WART
GMT-4:00
America/Argentina/
Tucuman
Hora da Argentina
ART
GMT-3:00
America/Argentina/
Ushuaia
Hora da Argentina
ART
GMT-3:00
America/Aruba
AST
GMT-4:00
America/Asuncion
Hora do Paraguai
PYT
GMT-4:00
America/Atikokan
Horrio do Oriente
EST
GMT-5:00
America/Atka
GMT-10:00
America/Bahia
Horrio de Braslia
BRT
GMT-3:00
America/Barbados
AST
GMT-4:00
America/Belem
Horrio de Braslia
BRT
GMT-3:00
America/Belize
CST
GMT-6:00
America/Blanc-Sablon
AST
GMT-4:00
America/Boa_Vista
Horrio do Amazonas
AMT
GMT-4:00
America/Bogota
Hora da Colmbia
COT
GMT-5:00
America/Boise
Horrio das Regies

Montanhosas
MST
GMT-7:00
America/Buenos_Aires
Hora da Argentina
ART
GMT-3:00
America/Cambridge_Bay
Horrio das Regies

Montanhosas
MST
GMT-7:00
America/Campo_Grande
Horrio do Amazonas
AMT
GMT-4:00
America/Cancun
CST
GMT-6:00
America/Caracas
Hora da Venezuela
VET
GMT-4:30
America/Catamarca
Hora da Argentina
ART
GMT-3:00
America/Cayenne
Hora da Guiana Francesa
GFT
GMT-3:00
America/Cayman
Horrio do Oriente
EST
GMT-5:00
America/Chicago
CST
GMT-6:00
531
532
Descrio
Curta
Relativo ao
GMT
Horrio das Regies

Montanhosas
MST
GMT-7:00
America/Coral_Harbour
Horrio do Oriente
EST
GMT-5:00
America/Cordoba
Hora da Argentina
ART
GMT-3:00
America/Costa_Rica
CST
GMT-6:00
America/Cuiaba
Horrio do Amazonas
AMT
GMT-4:00
America/Curacao
AST
GMT-4:00
America/Danmarkshavn
Horrio de Greenwich
GMT
GMT+00:00
America/Dawson
PST
GMT-8:00
America/Dawson_Creek
Horrio das Regies

Montanhosas
MST
GMT-7:00
America/Denver
Horrio das Regies

Montanhosas
MST
GMT-7:00
America/Detroit
Horrio do Oriente
EST
GMT-5:00
America/Dominica
AST
GMT-4:00
America/Edmonton
Horrio das Regies

Montanhosas
MST
GMT-7:00
America/Eirunepe
Horrio do Amazonas
AMT
GMT-4:00
America/El_Salvador
CST
GMT-6:00
America/Ensenada
PST
GMT-8:00
America/Fort_Wayne
Horrio do Oriente
EST
GMT-5:00
America/Fortaleza
Horrio de Braslia
BRT
GMT-3:00
America/Glace_Bay
AST
GMT-4:00
America/Godthab
Hora da Groenlndia
Ocidental
WGT
GMT-3:00
America/Goose_Bay
AST
GMT-4:00
America/Grand_Turk
Horrio do Oriente
EST
GMT-5:00
America/Grenada
AST
GMT-4:00
America/Guadeloupe
AST
GMT-4:00
America/Guatemala
CST
GMT-6:00
America/Guayaquil
Hora do Equador
ECT
GMT-5:00
America/Guyana
Hora da Guiana
GYT
GMT-4:00
America/Halifax
AST
GMT-4:00
America/Havana
Hora Local de Cuba
CST
GMT-5:00
America/Hermosillo
Horrio das Regies

Montanhosas
MST
GMT-7:00
America/Indiana/
Indianapolis
Horrio do Oriente
EST
GMT-5:00
America/Indiana/Knox
CST
GMT-6:00
America/Indiana/Marengo Horrio do Oriente
EST
GMT-5:00
America/Indiana/
Petersburg
EST
GMT-5:00
Nome Longo
Descrio
America/Chihuahua
Horrio do Oriente
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
America/Indiana/Tell_City
CST
GMT-6:00
America/Indiana/Vevay
Horrio do Oriente
EST
GMT-5:00
America/Indiana/
Vincennes
Horrio do Oriente
EST
GMT-5:00
America/Indiana/Winamac Horrio do Oriente
EST
GMT-5:00
America/Indianapolis
Horrio do Oriente
EST
GMT-5:00
America/Inuvik
Horrio das Regies

Montanhosas
MST
GMT-7:00
America/Iqaluit
Horrio do Oriente
EST
GMT-5:00
America/Jamaica
Horrio do Oriente
EST
GMT-5:00
America/Jujuy
Hora da Argentina
ART
GMT-3:00
America/Juneau
AKST
GMT-9:00
America/Kentucky/
Louisville
Horrio do Oriente
EST
GMT-5:00
America/Kentucky/
Monticello
Horrio do Oriente
EST
GMT-5:00
America/Knox_IN
CST
GMT-6:00
America/La_Paz
Hora da Bolvia
BOT
GMT-4:00
America/Lima
Hora do Peru
PET
GMT-5:00
America/Los_Angeles
PST
GMT-8:00
America/Louisville
Horrio do Oriente
EST
GMT-5:00
America/Maceio
Horrio de Braslia
BRT
GMT-3:00
America/Managua
CST
GMT-6:00
America/Manaus
Horrio do Amazonas
AMT
GMT-4:00
America/Marigot
AST
GMT-4:00
America/Martinique
AST
GMT-4:00
America/Mazatlan
Horrio das Regies

Montanhosas
MST
GMT-7:00
America/Mendoza
Hora da Argentina
ART
GMT-3:00
America/Menominee
CST
GMT-6:00
America/Merida
CST
GMT-6:00
America/Mexico_City
CST
GMT-6:00
America/Miquelon
Hora Local de Pierre &

Miquelon
PMST
GMT-3:00
America/Moncton
AST
GMT-4:00
America/Monterrey
CST
GMT-6:00
America/Montevideo
Hora do Uruguai
UYT
GMT-3:00
America/Montreal
Horrio do Oriente
EST
GMT-5:00
America/Montserrat
AST
GMT-4:00
America/Nassau
Horrio do Oriente
EST
GMT-5:00
America/New_York
Horrio do Oriente
EST
GMT-5:00
533
534
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
America/Nipigon
Horrio do Oriente
EST
GMT-5:00
America/Nome
AKST
GMT-9:00
America/Noronha
Hora de Fernando de
Noronha
FNT
GMT-2:00
America/North_Dakota/
Center
CST
GMT-6:00
America/North_Dakota/
New_Salem
CST
GMT-6:00
America/Panama
Horrio do Oriente
EST
GMT-5:00
America/Pangnirtung
Horrio do Oriente
EST
GMT-5:00
America/Paramaribo
Hora de Suriname
SRT
GMT-3:00
America/Phoenix
Horrio das Regies

Montanhosas
MST
GMT-7:00
America/Port_of_Spain
AST
GMT-4:00
America/Port-au-Prince
Horrio do Oriente
EST
GMT-5:00
America/Porto_Acre
Horrio do Amazonas
AMT
GMT-4:00
America/Porto_Velho
Horrio do Amazonas
AMT
GMT-4:00
America/Puerto_Rico
AST
GMT-4:00
America/Rainy_River
CST
GMT-6:00
America/Rankin_Inlet
CST
GMT-6:00
America/Recife
Horrio de Braslia
BRT
GMT-3:00
America/Regina
CST
GMT-6:00
America/Resolute
Horrio do Oriente
EST
GMT-5:00
America/Rio_Branco
Horrio do Amazonas
AMT
GMT-4:00
America/Rosario
Hora da Argentina
ART
GMT-3:00
America/Santarem
Horrio de Braslia
BRT
GMT-3:00
America/Santiago
Hora do Chile
CLT
GMT-4:00
America/Santo_Domingo
AST
GMT-4:00
America/Sao_Paulo
Horrio de Braslia
BRT
GMT-3:00
America/Scoresbysund
Hora da Groenlndia
Oriental
EGT
GMT-1:00
America/Shiprock
Horrio das Regies

Montanhosas
MST
GMT-7:00
America/St_Barthelemy
AST
GMT-4:00
America/St_Johns
Hora Local de Terra Nova
NST
GMT-3:30
America/St_Kitts
AST
GMT-4:00
America/St_Lucia
AST
GMT-4:00
America/St_Thomas
AST
GMT-4:00
America/St_Vincent
AST
GMT-4:00
America/Swift_Current
CST
GMT-6:00
America/Tegucigalpa
CST
GMT-6:00
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
America/Thule
AST
GMT-4:00
America/Thunder_Bay
Horrio do Oriente
EST
GMT-5:00
America/Tijuana
PST
GMT-8:00
America/Toronto
Horrio do Oriente
EST
GMT-5:00
America/Tortola
AST
GMT-4:00
America/Vancouver
PST
GMT-8:00
America/Virgin
AST
GMT-4:00
America/Whitehorse
PST
GMT-8:00
America/Winnipeg
CST
GMT-6:00
America/Yakutat
AKST
GMT-9:00
America/Yellowknife
Horrio das Regies

Montanhosas
MST
GMT-7:00
Antarctica/Casey
Hora Local Ocidental

(Austrlia)
WST
GMT+8:00
Antarctica/Davis
Hora de Davis
DAVT
GMT+7:00
Antarctica/
DumontDUrville
Hora de Dumont-d'Urville
DDUT
GMT+10:00
Antarctica/Mawson
Hora de Mawson
MAWT
GMT+6:00
Antarctica/McMurdo
Hora Local de Nova

Zelndia
NZST
GMT+12:00
Antarctica/Palmer
Hora do Chile
CLT
GMT-4:00
Antarctica/Rothera
Hora de Rothera
ROTT
GMT-3:00
Antarctica/South_Pole
Hora Local de Nova

Zelndia
NZST
GMT+12:00
Antarctica/Syowa
Hora de Syowa
SYOT
GMT+3:00
Antarctica/Vostok
Hora de Vostok
VOST
GMT+6:00
Arctic/Longyearbyen
CET
GMT+1:00
ART
EET
GMT+2:00
Asia/Aden
Hora Local da Arbia
AST
GMT+3:00
Asia/Almaty
Hora de Alma-Ata
ALMT
GMT+6:00
Asia/Amman
EET
GMT+2:00
Asia/Anadyr
Hora de Anadyr
ANAT
GMT+12:00
Asia/Aqtau
Hora de Aqtau
AQTT
GMT+5:00
Asia/Aqtobe
Hora de Aqtobe
AQTT
GMT+5:00
Asia/Ashgabat
Hora do Turcomenisto
TMT
GMT+5:00
Asia/Ashkhabad
Hora do Turcomenisto
TMT
GMT+5:00
Asia/Baghdad
Hora Local da Arbia
AST
GMT+3:00
Asia/Bahrain
Hora Local da Arbia
AST
GMT+3:00
Asia/Baku
Hora do Azerbaijo
AZT
GMT+4:00
Asia/Bangkok
Hora da Indochina
ICT
GMT+7:00
Asia/Beirut
EET
GMT+2:00
535
536
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
Asia/Bishkek
Hora da Quirguzia
KGT
GMT+6:00
Asia/Brunei
Hora de Brunei
BNT
GMT+8:00
Asia/Calcutta
Hora Local da ndia
IST
GMT+5:30
Asia/Choibalsan
Hora de Choibalsan
CHOT
GMT+8:00
Asia/Chongqing
Hora Local da China
CST
GMT+8:00
Asia/Chungking
Hora Local da China
CST
GMT+8:00
Asia/Colombo
Hora Local da ndia
IST
GMT+5:30
Asia/Dacca
Hora de Bangladesh
BDT
GMT+6:00
Asia/Damascus
EET
GMT+2:00
Asia/Dhaka
Hora de Bangladesh
BDT
GMT+6:00
Asia/Dili
Horrio do Timor-Leste
TLT
GMT+9:00
Asia/Dubai
Hora Local do Golfo
GST
GMT+4:00
Asia/Dushanbe
Hora de Tadjiquisto
TJT
GMT+5:00
Asia/Gaza
EET
GMT+2:00
Asia/Harbin
Hora Local da China
CST
GMT+8:00
Asia/Ho_Chi_Minh
Hora da Indochina
ICT
GMT+7:00
Asia/Hong_Kong
Hora de Hong Kong
HKT
GMT+8:00
Asia/Hovd
Hora de Hovd
HOVT
GMT+7:00
Asia/Irkutsk
Hora de Irkutsk
IRKT
GMT+8:00
Asia/Istanbul
EET
GMT+2:00
Asia/Jakarta
Hora da Indonsia do Oeste
WIT
GMT+7:00
Asia/Jayapura
Hora da Indonsia do Leste
EIT
GMT+9:00
Asia/Jerusalem
Hora Local de Israel
IST
GMT+2:00
Asia/Kabul
Hora do Afeganisto
AFT
GMT+4:30
Asia/Kamchatka
Hora de
Petropavlovsk-Kamchatski
PETT
GMT+12:00
Asia/Karachi
Hora do Paquisto
PKT
GMT+5:00
Asia/Kashgar
Hora Local da China
CST
GMT+8:00
Asia/Kathmandu
Hora do Nepal
NPT
GMT+5:45
Asia/Katmandu
Hora do Nepal
NPT
GMT+5:45
Asia/Kolkata
Hora Local da ndia
IST
GMT+5:30
Asia/Krasnoyarsk
Hora de Krasnoyarsk
KRAT
GMT+7:00
Asia/Kuala_Lumpur
Hora da Malsia
MYT
GMT+8:00
Asia/Kuching
Hora da Malsia
MYT
GMT+8:00
Asia/Kuwait
Hora Local da Arbia
AST
GMT+3:00
Asia/Macao
Hora Local da China
CST
GMT+8:00
Asia/Macau
Hora Local da China
CST
GMT+8:00
Asia/Magadan
Hora de Magad
MAGT
GMT+11:00
Asia/Makassar
Hora da Indonsia Central
CIT
GMT+8:00
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
Asia/Manila
Hora das Filipinas
PHT
GMT+8:00
Asia/Muscat
Hora Local do Golfo
GST
GMT+4:00
Asia/Nicosia
EET
GMT+2:00
Asia/Novosibirsk
Hora de Novosibirsk
NOVT
GMT+6:00
Asia/Omsk
Hora de Omsk
OMST
GMT+6:00
Asia/Oral
Hora de Oral
ORAT
GMT+5:00
Asia/Phnom_Penh
Hora da Indochina
ICT
GMT+7:00
Asia/Pontianak
Hora da Indonsia do Oeste
WIT
GMT+7:00
Asia/Pyongyang
Hora Local da Coria
KST
GMT+9:00
Asia/Qatar
Hora Local da Arbia
AST
GMT+3:00
Asia/Qyzylorda
Hora de Qyzylorda
QYZT
GMT+6:00
Asia/Rangoon
Hora de Myanmar
MMT
GMT+6:30
Asia/Riyadh
Hora Local da Arbia
AST
GMT+3:00
Asia/Riyadh87
GMT+3:07
GMT+3:07
Asia/Riyadh88
GMT+3:07
GMT+3:07
Asia/Riyadh89
GMT+3:07
GMT+3:07
Asia/Saigon
Hora da Indochina
ICT
GMT+7:00
Asia/Sakhalin
Hora de Sakhalin
SAKT
GMT+10:00
Asia/Samarkand
Hora de Uzbequisto
UZT
GMT+5:00
Asia/Seoul
Hora Local da Coria
KST
GMT+9:00
Asia/Shanghai
Hora Local da China
CST
GMT+8:00
Asia/Singapore
Hora de Cingapura
SGT
GMT+8:00
Asia/Taipei
Hora Local da China
CST
GMT+8:00
Asia/Tashkent
Hora de Uzbequisto
UZT
GMT+5:00
Asia/Tbilisi
Hora da Gergia
GET
GMT+4:00
Asia/Tehran
Hora Local do Ir
IRST
GMT+3:30
Asia/Tel_Aviv
IST
GMT+2:00
Asia/Thimbu
Hora de Buto
BTT
GMT+6:00
Asia/Thimphu
Hora de Buto
BTT
GMT+6:00
Asia/Tokyo
Hora Local do Japo
JST
GMT+9:00
Asia/Ujung_Pandang
Hora da Indonsia Central
CIT
GMT+8:00
Asia/Ulaanbaatar
Hora de Ulaanbaatar
ULAT
GMT+8:00
Asia/Ulan_Bator
Hora de Ulaanbaatar
ULAT
GMT+8:00
Asia/Urumqi
Hora Local da China
CST
GMT+8:00
Asia/Vientiane
Hora da Indochina
ICT
GMT+7:00
Asia/Vladivostok
Hora de Vladivostok
VLAT
GMT+10:00
Asia/Yakutsk
Hora de Yakutsk
YAKT
GMT+9:00
Asia/Yekaterinburg
Hora de Yekaterinburg
YEKT
GMT+5:00
Asia/Yerevan
Hora da Armnia
AMT
GMT+4:00
537
538
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
AST
AKST
GMT-9:00
Atlantic/Azores
Hora de Aores
AZOT
GMT-1:00
Atlantic/Bermuda
AST
GMT-4:00
Atlantic/Canary
WET
GMT+00:00
Atlantic/Cape_Verde
Hora de Cabo Verde
CVT
GMT-1:00
Atlantic/Faeroe
WET
GMT+00:00
Atlantic/Faroe
WET
GMT+00:00
Atlantic/Jan_Mayen
CET
GMT+1:00
Atlantic/Madeira
WET
GMT+00:00
Atlantic/Reykjavik
Horrio de Greenwich
GMT
GMT+00:00
Atlantic/South_Georgia
Hora Local da Gergia do

Sul
GST
GMT-2:00
Atlantic/St_Helena
Horrio de Greenwich
GMT
GMT+00:00
Atlantic/Stanley
Hora das Ilhas Cook
FKT
GMT-4:00
Australia/ACT

Gales do Sul)
EST
GMT+10:00
Australia/Adelaide
Hora Local Central

(Austrlia do Sul)
CST
GMT+9:30
Australia/Brisbane
Hora Local do Leste

(Queensland)
EST
GMT+10:00
Australia/Broken_Hill
Hora Local Central

(Austrlia do Sul/Nova
Gales do Sul)
CST
GMT+9:30
Australia/Canberra

Gales do Sul)
EST
GMT+10:00
Australia/Currie

Gales do Sul)
EST
GMT+10:00
Australia/Darwin
Hora Local Central

CST
GMT+9:30
Australia/Eucla
Hora Local Ocidental Central CWST

(Austrlia)
GMT+8:45
Australia/Hobart
Hora Local do Leste

(Tasmnia)
EST
GMT+10:00
Australia/LHI
Hora Local de Lord Howe
LHST
GMT+10:30
Australia/Lindeman
Hora Local do Leste

(Queensland)
EST
GMT+10:00
Australia/Lord_Howe
Hora Local de Lord Howe
LHST
GMT+10:30
Australia/Melbourne
Hora Local do Leste (Vitria) EST
GMT+10:00
Australia/North
Hora Local Central

CST
GMT+9:30
Australia/NSW

Gales do Sul)
EST
GMT+10:00
Australia/Perth

(Austrlia)
WST
GMT+8:00
Descrio
Curta
Relativo ao
GMT
Hora Local do Leste

(Queensland)
EST
GMT+10:00
Australia/South
Hora Local Central

(Austrlia do Sul)
CST
GMT+9:30
Australia/Sydney

Gales do Sul)
EST
GMT+10:00
Australia/Tasmania
Hora Local do Leste

(Tasmnia)
EST
GMT+10:00
Australia/Victoria
Hora Local do Leste (Vitria) EST
GMT+10:00
Australia/West

(Austrlia)
WST
GMT+8:00
Australia/Yancowinna
Hora Local Central

(Austrlia do Sul/Nova
Gales do Sul)
CST
GMT+9:30
BET
Horrio de Braslia
BRT
GMT-3:00
Brazil/Acre
Horrio do Amazonas
AMT
GMT-4:00
Brazil/DeNoronha
Hora de Fernando de
Noronha
FNT
GMT-2:00
Brazil/East
Horrio de Braslia
BRT
GMT-3:00
Brazil/West
Horrio do Amazonas
AMT
GMT-4:00
BST
Hora de Bangladesh
BDT
GMT+6:00
Canada/Atlantic
AST
GMT-4:00
Canada/Central
CST
GMT-6:00
Canada/Eastern
Horrio do Oriente
EST
GMT-5:00
Canada/East-Saskatchewan Horrio da Regio Central
CST
GMT-6:00
Canada/Mountain
Horrio das Regies

Montanhosas
MST
GMT-7:00
Canada/Newfoundland
NST
GMT-3:30
Canada/Pacific
PST
GMT-8:00
Canada/Saskatchewan
CST
GMT-6:00
Canada/Yukon
PST
GMT-8:00
CAT
CAT
GMT+2:00
CET
CET
GMT+1:00
Chile/Continental
Hora do Chile
CLT
GMT-4:00
Chile/EasterIsland
Hora das Ilhas de Cook
EAST
GMT-6:00
CNT
NST
GMT-3:30
CST
CST
GMT-6:00
CST6CDT
CST
GMT-6:00
CTT
Hora Local da China
CST
GMT+8:00
Cuba
Hora Local de Cuba
CST
GMT-5:00
EAT
EAT
GMT+3:00
ECT
CET
GMT+1:00
Nome Longo
Descrio
Australia/Queensland
539
540
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
EET
EET
GMT+2:00
Egypt
EET
GMT+2:00
Eire
Horrio de Greenwich
GMT
GMT+00:00
EST
Horrio do Oriente
EST
GMT-5:00
EST5EDT
Horrio do Oriente
EST
GMT-5:00
Etc/GMT
GMT+00:00
GMT+00:00
Etc/GMT-0
GMT+00:00
GMT+00:00
Etc/GMT-1
GMT+01:00
GMT+1:00
Etc/GMT-10
GMT+10:00
GMT+10:00
Etc/GMT-11
GMT+11:00
GMT+11:00
Etc/GMT-12
GMT+12:00
GMT+12:00
Etc/GMT-13
GMT+13:00
GMT+13:00
Etc/GMT-14
GMT+14:00
GMT+14:00
Etc/GMT-2
GMT+02:00
GMT+2:00
Etc/GMT-3
GMT+03:00
GMT+3:00
Etc/GMT-4
GMT+04:00
GMT+4:00
Etc/GMT-5
GMT+05:00
GMT+5:00
Etc/GMT-6
GMT+06:00
GMT+6:00
Etc/GMT-7
GMT+07:00
GMT+7:00
Etc/GMT-8
GMT+08:00
GMT+8:00
Etc/GMT-9
GMT+09:00
GMT+9:00
Etc/GMT+0
GMT+00:00
GMT+00:00
Etc/GMT+1
GMT-01:00
GMT-1:00
Etc/GMT+10
GMT-10:00
GMT-10:00
Etc/GMT+11
GMT-11:00
GMT-11:00
Etc/GMT+12
GMT-12:00
GMT-12:00
Etc/GMT+2
GMT-02:00
GMT-2:00
Etc/GMT+3
GMT-03:00
GMT-3:00
Etc/GMT+4
GMT-04:00
GMT-4:00
Etc/GMT+5
GMT-05:00
GMT-5:00
Etc/GMT+6
GMT-06:00
GMT-6:00
Etc/GMT+7
GMT-07:00
GMT-7:00
Etc/GMT+8
GMT-08:00
GMT-8:00
Etc/GMT+9
GMT-09:00
GMT-9:00
Etc/GMT0
GMT+00:00
GMT+00:00
Etc/Greenwich
Horrio de Greenwich
GMT
GMT+00:00
Etc/UCT
UTC
GMT+00:00
Etc/Universal
UTC
GMT+00:00
Etc/UTC
UTC
GMT+00:00
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
Etc/Zulu
UTC
GMT+00:00
Europe/Amsterdam
CET
GMT+1:00
Europe/Andorra
CET
GMT+1:00
Europe/Athens
EET
GMT+2:00
Europe/Belfast
Horrio de Greenwich
GMT
GMT+00:00
Europe/Belgrade
CET
GMT+1:00
Europe/Berlin
CET
GMT+1:00
Europe/Bratislava
CET
GMT+1:00
Europe/Brussels
CET
GMT+1:00
Europe/Bucharest
EET
GMT+2:00
Europe/Budapest
CET
GMT+1:00
Europe/Chisinau
EET
GMT+2:00
Europe/Copenhagen
CET
GMT+1:00
Europe/Dublin
Horrio de Greenwich
GMT
GMT+00:00
Europe/Gibraltar
CET
GMT+1:00
Europe/Guernsey
Horrio de Greenwich
GMT
GMT+00:00
Europe/Helsinki
EET
GMT+2:00
Europe/Isle_of_Man
Horrio de Greenwich
GMT
GMT+00:00
Europe/Istanbul
EET
GMT+2:00
Europe/Jersey
Horrio de Greenwich
GMT
GMT+00:00
Europe/Kaliningrad
EET
GMT+2:00
Europe/Kiev
EET
GMT+2:00
Europe/Lisbon
WET
GMT+00:00
Europe/Ljubljana
CET
GMT+1:00
Europe/London
Horrio de Greenwich
GMT
GMT+00:00
Europe/Luxembourg
CET
GMT+1:00
Europe/Madrid
CET
GMT+1:00
Europe/Malta
CET
GMT+1:00
Europe/Mariehamn
EET
GMT+2:00
Europe/Minsk
EET
GMT+2:00
Europe/Monaco
CET
GMT+1:00
Europe/Moscow
Hora Local de Moscou
MSK
GMT+3:00
Europe/Nicosia
EET
GMT+2:00
Europe/Oslo
CET
GMT+1:00
Europe/Paris
CET
GMT+1:00
Europe/Podgorica
CET
GMT+1:00
Europe/Prague
CET
GMT+1:00
Europe/Riga
EET
GMT+2:00
Europe/Rome
CET
GMT+1:00
541
542
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
Europe/Samara
Hora de Samara
SAMT
GMT+4:00
Europe/San_Marino
CET
GMT+1:00
Europe/Sarajevo
CET
GMT+1:00
Europe/Simferopol
EET
GMT+2:00
Europe/Skopje
CET
GMT+1:00
Europe/Sofia
EET
GMT+2:00
Europe/Stockholm
CET
GMT+1:00
Europe/Tallinn
EET
GMT+2:00
Europe/Tirane
CET
GMT+1:00
Europe/Tiraspol
EET
GMT+2:00
Europe/Uzhgorod
EET
GMT+2:00
Europe/Vaduz
CET
GMT+1:00
Europe/Vatican
CET
GMT+1:00
Europe/Vienna
CET
GMT+1:00
Europe/Vilnius
EET
GMT+2:00
Europe/Volgograd
Hora de Volgograd
VOLT
GMT+3:00
Europe/Warsaw
CET
GMT+1:00
Europe/Zagreb
CET
GMT+1:00
Europe/Zaporozhye
EET
GMT+2:00
Europe/Zurich
CET
GMT+1:00
GB
Horrio de Greenwich
GMT
GMT+00:00
GB-Eire
Horrio de Greenwich
GMT
GMT+00:00
GMT
Horrio de Greenwich
GMT
GMT+00:00
GMT0
GMT+00:00
GMT
GMT+00:00
Greenwich
Horrio de Greenwich
GMT
GMT+00:00
Hongkong
Hora de Hong Kong
HKT
GMT+8:00
HST
Hora Local do Hava
HST
GMT-10:00
Iceland
Horrio de Greenwich
GMT
GMT+00:00
IET
Horrio do Oriente
EST
GMT-5:00
Indian/Antananarivo
EAT
GMT+3:00
Indian/Chagos
Hora do Territrio do
Oceano ndico
IOT
GMT+6:00
Indian/Christmas
Hora das Ilhas Christmas
CXT
GMT+7:00
Indian/Cocos
Hora das Ilhas Cocos
CCT
GMT+6:30
Indian/Comoro
EAT
GMT+3:00
Indian/Kerguelen
Hora do Sul da Frana e das

Terras da Antrtida
TFT
GMT+5:00
Indian/Mahe
Hora de Seychelles
SCT
GMT+4:00
Indian/Maldives
Hora das Maldivas
MVT
GMT+5:00
Indian/Mauritius
Hora de Maurcio
MUT
GMT+4:00
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
Indian/Mayotte
EAT
GMT+3:00
Indian/Reunion
Hora de Reunio
RET
GMT+4:00
Iran
Hora Local do Ir
IRST
GMT+3:30
Israel
IST
GMT+2:00
IST
Hora Local da ndia
IST
GMT+5:30
Jamaica
Horrio do Oriente
EST
GMT-5:00
Japan
Hora Local do Japo
JST
GMT+9:00
JST
Hora Local do Japo
JST
GMT+9:00
Kwajalein
Hora das Ilhas Marshall
MHT
GMT+12:00
Libya
EET
GMT+2:00
MET
Hora da Europa Mdia
MET
GMT+1:00
Mexico/BajaNorte
PST
GMT-8:00
Mexico/BajaSur
Horrio das Regies

Montanhosas
MST
GMT-7:00
Mexico/General
CST
GMT-6:00
Mideast/Riyadh87
GMT+3:07
GMT+3:07
Mideast/Riyadh88
GMT+3:07
GMT+3:07
Mideast/Riyadh89
GMT+3:07
GMT+3:07
MIT
Hora de Samoa Ocidental
WST
GMT-11:00
MST
Horrio das Regies

Montanhosas
MST
GMT-7:00
MST7MDT
Horrio das Regies

Montanhosas
MST
GMT-7:00
Navajo
Horrio das Regies

Montanhosas
MST
GMT-7:00
NET
Hora da Armnia
AMT
GMT+4:00
NST
Hora Local de Nova

Zelndia
NZST
GMT+12:00
NZ
Hora Local de Nova

Zelndia
NZST
GMT+12:00
NZ-CHAT
Hora Local de Chatham
CHAST
GMT+12:45
Pacific/Apia
Hora de Samoa Ocidental
WST
GMT-11:00
Pacific/Auckland
Hora Local de Nova

Zelndia
NZST
GMT+12:00
Pacific/Chatham
Hora Local de Chatham
CHAST
GMT+12:45
Pacific/Easter
EAST
GMT-6:00
Pacific/Efate
Hora de Vanuatu
VUT
GMT+11:00
Pacific/Enderbury
PHOT
GMT+13:00
Pacific/Fakaofo
Hora de Tokelau
TKT
GMT-10:00
Pacific/Fiji
Hora de Fiji
FJT
GMT+12:00
Pacific/Funafuti
Hora de Tuvalu
TVT
GMT+12:00
543
544
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
Pacific/Galapagos
Hora de Galapagos
GALT
GMT-6:00
Pacific/Gambier
Hora de Gambier
GAMT
GMT-9:00
Pacific/Guadalcanal
Hora das Ilhas Cook
SBT
GMT+11:00
Pacific/Guam
Hora Local de Chamorro
ChST
GMT+10:00
Pacific/Honolulu
Hora Local do Hava
HST
GMT-10:00
Pacific/Johnston
Hora Local do Hava
HST
GMT-10:00
Pacific/Kiritimati
Hora das Ilhas da Cook
LINT
GMT+14:00
Pacific/Kosrae
Hora de Kosrae
KOST
GMT+11:00
Pacific/Kwajalein
MHT
GMT+12:00
Pacific/Majuro
MHT
GMT+12:00
Pacific/Marquesas
Hora de Marquesas
MART
GMT-9:30
Pacific/Midway
Hora Local de Samoa
SST
GMT-11:00
Pacific/Nauru
Hora de Nauru
NRT
GMT+12:00
Pacific/Niue
Hora de Niue
NUT
GMT-11:00
Pacific/Norfolk
Hora de Norfolk
NFT
GMT+11:30
Pacific/Noumea
Hora da Nova Calednia
NCT
GMT+11:00
Pacific/Pago_Pago
Hora Local de Samoa
SST
GMT-11:00
Pacific/Palau
Hora de Palau
PWT
GMT+9:00
Pacific/Pitcairn
Hora Local de Pitcairn
PST
GMT-8:00
Pacific/Ponape
Hora de Ponape
PONT
GMT+11:00
Pacific/Port_Moresby
Hora de Papua-Nova Guin
PGT
GMT+10:00
Pacific/Rarotonga
Hora das Ilhas Cook
CKT
GMT-10:00
Pacific/Saipan
Hora Local de Chamorro
ChST
GMT+10:00
Pacific/Samoa
Hora Local de Samoa
SST
GMT-11:00
Pacific/Tahiti
Hora do Tahiti
TAHT
GMT-10:00
Pacific/Tarawa
Hora das Ilhas Cook
GILT
GMT+12:00
Pacific/Tongatapu
Hora de Tonga
TOT
GMT+13:00
Pacific/Truk
Hora de Truk
TRUT
GMT+10:00
Pacific/Wake
Hora de Wake
WAKT
GMT+12:00
Pacific/Wallis
Hora de Wallis e Futuna
WFT
GMT+12:00
Pacific/Yap
Hora de Truk
TRUT
GMT+10:00
PLT
Hora do Paquisto
PKT
GMT+5:00
PNT
Horrio das Regies

Montanhosas
MST
GMT-7:00
Poland
CET
GMT+1:00
Portugal
WET
GMT+00:00
PRC
Hora Local da China
CST
GMT+8:00
PRT
AST
GMT-4:00
PST
PST
GMT-8:00
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
PST8PDT
PST
GMT-8:00
ROK
Hora Local da Coria
KST
GMT+9:00
Singapore
Hora de Cingapura
SGT
GMT+8:00
SST
Hora das Ilhas Cook
SBT
GMT+11:00
SystemV/AST4
AST
GMT-4:00
SystemV/AST4ADT
AST
GMT-4:00
SystemV/CST6
CST
GMT-6:00
SystemV/CST6CDT
CST
GMT-6:00
SystemV/EST5
Horrio do Oriente
EST
GMT-5:00
SystemV/EST5EDT
Horrio do Oriente
EST
GMT-5:00
SystemV/HST10
Hora Local do Hava
HST
GMT-10:00
SystemV/MST7
Horrio das Regies

Montanhosas
MST
GMT-7:00
SystemV/MST7MDT
Horrio das Regies

Montanhosas
MST
GMT-7:00
SystemV/PST8
PST
GMT-8:00
SystemV/PST8PDT
PST
GMT-8:00
SystemV/YST9
AKST
GMT-9:00
SystemV/YST9YDT
AKST
GMT-9:00
Turkey
EET
GMT+2:00
UCT
UTC
GMT+00:00
Universal
UTC
GMT+00:00
US/Alaska
AKST
GMT-9:00
US/Aleutian
GMT-10:00
US/Arizona
Horrio das Regies

Montanhosas
MST
GMT-7:00
US/Central
CST
GMT-6:00
US/Eastern
Horrio do Oriente
EST
GMT-5:00
US/East-Indiana
Horrio do Oriente
EST
GMT-5:00
US/Hawaii
Hora Local do Hava
HST
GMT-10:00
US/Indiana-Starke
CST
GMT-6:00
US/Michigan
Horrio do Oriente
EST
GMT-5:00
US/Mountain
Horrio das Regies

Montanhosas
MST
GMT-7:00
US/Pacific
PST
GMT-8:00
US/Pacific-New
PST
GMT-8:00
US/Samoa
Hora Local de Samoa
SST
GMT-11:00
UTC
UTC
GMT+00:00
VST
Hora da Indochina
ICT
GMT+7:00
W-SU
Hora Local de Moscou
MSK
GMT+3:00
545
546
Nome Longo
Descrio
Descrio
Curta
Relativo ao
GMT
WET
WET
GMT+00:00
Zulu
UTC
GMT+00:00
Captulo 14. Gerenciando Agentes Estendidos

As estaes de trabalho so geralmente recursos fsicos (ou seja, computadores),
mas tambm podem ser definies lgicas, hospedadas por uma estao de
trabalho fsica, que representam sistemas operacionais ou aplicativos onde voc
deseja executar tarefas ou fluxos de tarefas. Nesse caso, so definidas como agentes
estendidos.
Este captulo descreve os agentes estendidos, suas interfaces e fornece informaes
para programadores que desejam criar mtodos de acesso customizados. Agentes
Estendidos so usados para estender as funes de planejamento de tarefa do IBM
Tivoli Workload Scheduler para outros sistemas e aplicativos, como: sistemas
operacionais UNIX locais ou remotos, Peoplesoft, SAP R/3, z/OS, JES, OPC, Oracle
EBS e VMS.
v O que so agentes estendidos? na pgina 548
v Interface do mtodo de acesso na pgina 548
v Executando Mtodos na pgina 552
v Deteco de problemas na pgina 555
O exemplo a seguir mostra uma definio para uma estao de trabalho de agente
estendido do z/OS chamada MVSCPU que utiliza o mtodo de acesso mvsjes.
cpuname MVSCPU description "zOS extended agent"
os other
node mvsesa36.rome.tivoli.com
tcpaddr 5000
domain masterdm
for maestro
type x-agent
host ROCIOUS
access mvsjes
fim
O exemplo a seguir descreve uma tarefa do Tivoli Workload Scheduler

denominada orajob2 que executada em uma estao de trabalho de agente
estendido de Aplicativos Oracle denominada ora002. Efetua logon no UNIX como
orajobs e ativa uma tarefa sob Aplicativos Oracle. A tarefa de Aplicativos Oracle
denominada poxacr e seu proprietrio global. Se a recuperao for necessria, o
Tivoli Workload Scheduler executar a tarefa recov2 e, em seguida, continuar o
processamento.
ora002#orajob2
streamlogon orajobs
scriptname "-user global -job fnd application developer po poxacr -prn ps4 2 -v1 abc"
descrio "oracle apps job #2"
recuperao continua aps recov2
Os argumentos de scriptname so diferentes de acordo com o aplicativo. Para

obter informaes adicionais, consulte o IBM Tivoli Workload Scheduler for
Applications: User's Guide
547
O que so agentes estendidos?

Agentes estendidos so utilizado para estender as funes de planejamento de job
do Tivoli Workload Scheduler para outros sistemas e aplicativos.
Um agente estendido definido como uma estao de trabalho que tem um host e
um mtodo de acesso. O host qualquer outra estao de trabalho, exceto outro
agente estendido. O mtodo de acesso um script ou programa fornecido pela
IBM ou pelo usurio e executado pelo host sempre que o agente estendido
referido no plano de produo. Por exemplo, para ativar uma tarefa em um agente
estendido, o host executa o mtodo de acesso, transmitindo a ele detalhes da tarefa
como opes da linha de comandos. O mtodo de acesso comunica-se com o
sistema externo ou aplicativo para lanar o job e retornar o status do job.
Definio de estao de trabalho

Cada agente estendido deve ter uma definio de estao de trabalho lgica. Essa
estao de trabalho lgica deve ser hospedada pela estao de trabalho fsica do
Tivoli Workload Scheduler, um gerenciador de domnio mestre, o gerenciador de
domnio, o agente padro ou um agente tolerante a falhas. A definio de estao
de trabalho do agente estendido faz referncia ao nome do mtodo de acesso e da
estao de trabalho do host. Quando jobs so lanados na estao de trabalho do
agente estendido, o mtodo de acesso chamado e transmite as informaes do job
ao sistema externo.
Uma estao de trabalho fsica pode hospedar no mximo 255 agentes estendidos.
Interface do mtodo de acesso

A interface entre o Tivoli Workload Scheduler e um mtodo de acesso consiste em
informaes transmitidas ao mtodo da linha de comandos e de mensagens
retornadas ao Tivoli Workload Scheduler no stdout.
Sintaxe da linha de comandos do mtodo

O host do Tivoli Workload Scheduler executa um mtodo de acesso utilizando a
seguinte sintaxe de linha de comandos:
methodname -t task options -- taskstring
onde:
methodname
Especifica o nome do arquivo do mtodo de acesso. Todos os mtodos de
acesso devem ser armazenados no diretrio: TWS_home/methods
-t task Especifica a tarefa a ser executada, em que task uma das seguintes:
548
LJ
Lana um job.
MJ
Gerencia um job lanado anteriormente. Utilize essa opo para

ressincronizar se uma tarefa LJ anterior tiver terminado
inesperadamente.
CF
Verifica a disponibilidade de um arquivo. Utilize essa opo para

verificar as dependncias opens.
GS
Obtm o status de um job. Utilize essa opo para verificar as

dependncias follows do job.
Opes Especifica as opes associadas tarefa. Consulte Opes de Tarefas para

obter informaes adicionais.
taskstring
Uma cadeia de at 255 caracteres associada tarefa. Consulte o Opes de
Tarefas.
Opes de Tarefas
As opes de tarefas so listadas em Tabela 85. Um X significa que a opo
vlida para a tarefa.
Tabela 85. Opes de Tarefas de Comandos do Mtodo
Tarefa
-c
-n
-p
-r
-s
-d
-l
-o
-j
LJ
MJ
CF
GS
-q
-w
Cadeia
da Tarefa
ljstring
mjstring
X
X
-S
cfstring
X
gsstring
-c xagent,host,master
Especifica os nomes do agente estendido, do host e do gerenciador de
domnio mestre separados por vrgulas.
-n nodename
Especifica o nome de n do computador associado ao agente estendido, se
houver. Isso definido no campo N da definio da estao de trabalho
do agente estendido.
-p portnumber
Especifica o nmero da porta TCP/IP associada ao agente estendido, se
houver. Isso definido no campo Endereo TCP da definio da estao
de trabalho do agente estendido.
-r currentrun,specificrun
Especifica o nmero de execues atual do Tivoli Workload Scheduler e o
nmero de execues especfico associado tarefa, separados por uma
vrgula. Os nmeros de execuo atual e especfico podero ser diferentes
se o job tiver sido transportado de uma execuo anterior.
-s jstream
Especifica o nome do fluxo de tarefas da tarefa.
-d scheddate,epoch
Especifica a data do fluxo de job (yymmdd) e o perodo equivalente,
separados por uma vrgula.
-l user Especifica o nome de usurio da tarefa. Isso definido no campo Logon da
definio de tarefa.
-o stdlist
Especifica o nome do caminho completo do arquivo de lista padro da
tarefa. Qualquer sada do job dever ser gravada nesse arquivo.
-j jobname,id
Especifica o nome da tarefa e o identificador exclusivo designado pelo
Tivoli Workload Scheduler, separados por uma vrgula. O nome definido
no campo Nome da Tarefa da definio de tarefa.
549
-q qualifier
Especifica o qualificador a ser utilizado em um comando de teste emitido
pelo mtodo junto ao arquivo.
-w timeout
Especifica a quantidade de tempo, em segundos, que o Tivoli Workload
Scheduler aguarda para obter uma resposta de uma tarefa externa antes de
enviar um sinal SIGTERM ao mtodo de acesso. O padro 300.
-S new name
Especifica que o job reexecutado utilizando esse nome no lugar do nome
de job original. Em um script de job, possvel utilizar o comando jobinfo
para retornar o nome do job e executar o script de forma diferente para
cada iterao.
-- ljstring
Utilizado com a tarefa LJ. A cadeia do campo Arquivo de Script ou
Comando da definio de tarefa.
-- mjstring
Utilizado com a tarefa MJ. As informaes fornecidas ao Tivoli Workload
Scheduler pelo mtodo em uma mensagem indicando um alterao de
estado de tarefa %CJ (consulte Mensagens de resposta do mtodo para
obter detalhes adicionais sobre mensagens que indicam a alterao do
estado da tarefa) aps uma tarefa LJ. Em geral, isso identifica o job que foi
lanado. Por exemplo, um mtodo UNIX pode fornecer o PID (Process
Identification) da tarefa que foi ativada, que ento enviado pelo Tivoli
Workload Scheduler como parte de uma tarefa MJ.
-- cfstring
Utilizado com a tarefa CF. Para a dependncia opens de um arquivo, a
cadeia do campo Opens Files da definio do fluxo de job.
-- gsstring
Utilizado com a tarefa GS. Especifica o job cujo status foi verificado. O
formato o seguinte:
followsjob[,jobid]
onde:
followsjob
A cadeia da lista Follows Sched/Job da definio do fluxo de job.
jobid
Um identificador de tarefa opcional recebido pelo Tivoli Workload

Scheduler em uma resposta %CJ a uma tarefa GS anterior.
Mensagens de resposta do mtodo

Os mtodos retornam informaes ao Tivoli Workload Scheduler em mensagens
gravadas no stdout. Toda linha comeando com um sinal de porcentagem (%) e
terminando com uma nova linha, interpretada como uma mensagem. As
mensagens possuem o seguinte formato:
%CJ state [mjstring | jobid]
%JS [cputime]
%RC rc
550
%UT [errormessage]
onde:
CJ
Altera o estado da tarefa.

state
O estado para o qual o job alterado. Todos os estados de tarefa

do Tivoli Workload Scheduler so vlidos, exceto HOLD e READY.
Para a tarefa GS, os seguintes estados tambm so vlidos:
ERROR
Ocorreu um erro.
EXTRN
Status desconhecido.
mjstring
Uma cadeia de at 255 caracteres que o Tivoli Workload Scheduler
incluir em qualquer tarefa MJ associada tarefa.
jobid
Uma cadeia de at 64 caracteres que o Tivoli Workload Scheduler

incluir em qualquer tarefa GS associada tarefa.
JS [cputime]
Indica a concluso bem-sucedida de um job e fornece seu tempo de
execuo decorrido em segundos.
RC rc
rc um nmero interpretado pelo Tivoli Workload Scheduler como o

cdigo de retorno do job de agente estendido. O cdigo de retorno ser
considerado somente se uma condio de cdigo de retorno for
especificada na definio do job de agente estendido. Caso contrrio, ele
ser ignorado e a concluso bem-sucedida do job de agente estendido ser
indicada pela presena da mensagem %JS [cputime]. Da mesma forma, se o
mtodo no enviar a mensagem %RC, a concluso bem-sucedida do job de
agente estendido ser indicada pela presena da mensagem %JS [cputime].
UT [errormessage]
Indica que a tarefa solicitada no suportada pelo mtodo. Exibe uma
cadeia de at 255 caracteres que o Tivoli Workload Scheduler incluir em
sua mensagem de erro.
Arquivo de opes do mtodo

possvel utilizar um arquivo de opes do mtodo para especificar informaes
especiais de logon e outras opes. O Tivoli Workload Scheduler l o arquivo, se
existir, antes de executar um mtodo. Se o arquivo for modificado depois que o
Tivoli Workload Scheduler for iniciado, as alteraes sero efetivadas somente
quando ele for parado e reiniciado.
O arquivo pode conter opes do Tivoli Workload Scheduler e qualquer outra
informao sobre o mtodo. As opes reconhecidas pelo Tivoli Workload
Scheduler so as seguintes:
LJuser=username
CFuser=username
GSuser=username
GStimeout=seconds
551
onde:
LJuser=username
Especifica o logon a ser utilizado para as tarefas LJ e MJ. O padro o
logon da definio de tarefa.
CFuser=username
Especifica o logon a ser utilizado para a tarefa CF. O padro para o UNIX
root e para o Windows o nome do usurio da conta na qual o Tivoli
Workload Scheduler foi instalado.
GSuser=username
Especifica o logon a ser utilizado para as tarefas GS. O padro para o
UNIX root e para o Windows o nome do usurio da conta na qual o
Tivoli Workload Scheduler foi instalado.
GStimeout=seconds
Especifica o perodo de tempo, em segundos, que o Tivoli Workload
Scheduler aguarda por uma resposta antes de eliminar o mtodo de acesso.
O padro 300 segundos.
Nota: Se o host do agente estendido for um computador com o Windows, esses
usurios devem ser definidos como objetos de usurio do Tivoli Workload
Scheduler.
O arquivo de opes deve ter o mesmo nome de caminho de seu mtodo de
acesso, com uma extenso de arquivo .opts. Por exemplo, o nome do caminho do
Windows de um arquivo de opes para um mtodo denominado netmeth
TWS_home\methods\netmth.opts
Executando Mtodos
As subsees a seguir descrevem o intercmbio entre o Tivoli Workload Scheduler
e um mtodo de acesso.
Tarefa LJ (Launch Job)

A tarefa LJ orienta o mtodo do agente estendido para lanar um job em um
sistema ou aplicativo externo. Antes de executar o mtodo, o Tivoli Workload
Scheduler estabelece um ambiente de execuo. O parmetro LJuser lido a partir
do arquivo de opes do mtodo para determinar a conta do usurio com a qual
executar o mtodo. Se o parmetro no estiver presente ou se o arquivo de opes
no existir, a conta do usurio especificada no campo Logon da definio da tarefa
usada. Alm disso, as seguintes variveis de ambiente so definidas:
HOME
O diretrio inicial do usurio de login.
LOGNAME
PATH No UNIX, definido como /bin:/usr/bin. No Windows, definido
como %SYSTEM%\SYSTEM32.
TWS_PROMOTED_JOB
Configure como YES, quando a tarefa (uma tarefa crtica para a misso ou
uma de suas predecessoras) for promovida.
TZ
552
O fuso horrio.
Se o mtodo no puder ser executado, o job ser colocado no estado FAIL.

Depois de um mtodo ser executado, ele grava mensagens em seu stdout que
indica o estado do job no sistema externo. A mensagens so resumidas na
Tabela 86.
Tabela 86. Mensagens da Tarefa LJ (Launch Job)
Tarefa
Resposta do Mtodo
Ao do Tivoli Workload Scheduler
LJ e MJ
%CJ state [mjstring]
Define o estado do job como state. Inclui

mjstring em qualquer tarefa MJ
subseqente.
%JS [cputime]
Define o estado do job como SUCC.
Cdigo de sada=diferente de Define o estado do job como ABEND.

zero
%UT [errormessage] e Cdigo
de sada=2
Define o estado do job como ABEND e

exibe errormessage.
Uma seqncia comum consiste em uma ou mais mensagens %CJ indicando

alteraes no estado do job e, em seguida, uma mensagem %JS antes do mtodo
sair para indicar que o job terminou com xito. Se o job no for bem-sucedido, o
mtodo dever sair sem gravar a mensagem %JS. Um mtodo que no suporta a
tarefa LJ grava uma mensagem %UT no stdout e sai com um cdigo de sada 2.
Tarefa MJ (Manage Job)

A tarefa MJ ser utilizada para sincronizao com uma tarefa ativada
anteriormente se o Tivoli Workload Scheduler determinar que a tarefa LJ terminou
inesperadamente. O Tivoli Workload Scheduler configura o ambiente da mesma
maneira que para a tarefa LJ e transmite para ela mjstring. Consulte Tarefa LJ
(Launch Job) na pgina 552 para obter informaes adicionais.
Se o mtodo localizar o job especificado, ele responder com as mesmas
mensagens de uma tarefa LJ. Se o mtodo no conseguir localizar a tarefa, ele sair
com um cdigo de sada diferente de zero, fazendo com que o Tivoli Workload
Scheduler coloque a tarefa no estado ABEND.
Eliminando um Job
Enquanto uma tarefa LJ ou MJ est sendo executada, o mtodo deve detectar um
sinal SIGTERM (sinal 15). O sinal enviado quando um operador emite um
comando kill a partir do gerenciador de console do Tivoli Workload Scheduler. No
recebimento do sinal, o mtodo deve tentar parar (kill) o job e sair sem gravar
uma mensagem %JS.
Tarefa CF (Check File)

A tarefa CF solicita o mtodo do agente estendido para verificar a disponibilidade
de um arquivo no sistema externo. Antes de executar o mtodo, o Tivoli Workload
Scheduler estabelece um ambiente de execuo. O parmetro CFuser lido a partir
do arquivo de opes do mtodo para determinar a conta do usurio com a qual
executar o mtodo. Se o parmetro no estiver presente ou o arquivo de opes
no existir, no UNIX, o usurio root utilizado e, no Windows, o nome do usurio
da conta na qual o Tivoli Workload Scheduler foi instalado utilizado. Se o
mtodo no puder ser executado, a dependncia opens do arquivo ser marcada
553
como falha, isto , o status do arquivo ser definido como NO e qualquer job ou
fluxo de job dependente no ter permisso para execuo.
Durante a execuo, o mtodo executa um comando de teste, ou equivalente, no
arquivo que est utilizando o qualificador transmitido a ele na opo -q da linha
de comandos. Se o teste do arquivo for verdadeiro, o mtodo sair com um cdigo
de sada zero. Se o teste do arquivo for falso, o mtodo sair com um cdigo de
sada diferente de zero. Isso est resumido na Tabela 87.
Tabela 87. Mensagens da Tarefa CF (Check File)
Tarefa
Resposta do Mtodo
CF
Cdigo de sada=0
Define o estado do arquivo como SIM.
Cdigo de sada=diferente
de zero
Define o estado do arquivo como NO.
%UT [errormessage] e Cdigo Define o estado do arquivo como NO.

de sada=2
Um mtodo que no suporta a tarefa CF grava uma mensagem %UT no stdout e

sai com um cdigo de sada 2.
Tarefa GS (Get Status)

A tarefa GS informa o mtodo do agente estendido para verificar o status de uma
tarefa. Isso necessrio quando outro job depende da concluso bem-sucedida de
um job externo. Antes de executar o mtodo, o parmetro GSuser lido a partir
do arquivo de opes do mtodo para determinar a conta de usurio com a qual
executar o mtodo. Se o parmetro no estiver presente ou o arquivo de opes
no existir, no UNIX, o usurio root ser utilizado e, no Windows, o nome de
usurio da conta na qual o Tivoli Workload Scheduler foi instalado ser utilizado.
Se o mtodo no puder ser executado, o job ou o fluxo de job dependente no ter
permisso para execuo. Se um jobid estiver disponvel a partir de uma tarefa GS
anterior, ele ser transmitido para o mtodo.
O mtodo verifica o estado do job especificado e o retorna em uma mensagem
%CJ gravada no stdout. Em seguida, sai com um cdigo de sada zero. Com uma
taxa definida pela opo local status de verificao de bm, o mtodo ser
executado novamente com uma tarefa GS at que um dos seguintes estados de job
seja retornado:
abend O job terminou de forma anormal.
succ
O job foi concludo com xito.
cancl
O job foi cancelado.
done
O job terminou, mas seu xito ou falha no conhecido.
fail
O job no pde ser executado.
erro
Ocorreu um erro no mtodo durante a verificao do status do job.
extrn
A verificao do job falhou ou o status do job no pde ser determinado.
Observe que GStimeout no arquivo de opes do mtodo especifica quanto tempo

o Tivoli Workload Scheduler aguardar por uma resposta antes de eliminar o
mtodo. Consulte Arquivo de opes do mtodo na pgina 551 para obter
554
As respostas dos mtodos esto resumidas na Tabela 88:

Tabela 88. Mensagens da Tarefa GS (Get Status)
Tarefa
Resposta do Mtodo
GS
%CJ state [jobid]
Configura o estado da tarefa como state e

inclui jobid em qualquer tarefa GS
subseqente.
%UT [errormessage] e Cdigo O estado do job fica inalterado.

de sada=2
Um mtodo que no suporta a tarefa GS grava uma mensagem %UT no stdout e

sai com um cdigo de sada 2.
Comando Cpuinfo
O comando cpuinfo pode ser utilizado em um mtodo de acesso para retornar
informaes de uma definio de estao de trabalho. Consulte Comando
Cpuinfo para obter informaes completas sobre o comando.
Deteco de problemas
Os tpicos a seguir so fornecidos para ajud-lo a detectar e depurar problemas do
agente estendido e do mtodo de acesso.
Mensagens de erro da lista padro de tarefas

Todas as mensagens de sada de um mtodo de acesso, exceto aquelas iniciadas
com um sinal de porcentagem (%), so gravadas no arquivo de lista padro
(stdlist) da tarefa. Para as tarefas GS e CF no associadas a tarefas do Tivoli
Workload Scheduler, as mensagens so gravadas no arquivo de lista padro do
Tivoli Workload Scheduler. Para obter informaes sobre problemas de qualquer
tipo, verifique esses arquivos.
Mtodo no executvel
Se um mtodo de acesso no puder ser executado, ocorrer o seguinte:
v Para as tarefas LJ e MJ, o job ser colocado no estado FAIL.
v Para a tarefa CF, a dependncia de arquivo ficar sem soluo e o job
dependente permanecer no estado HOLD.
v Para a tarefa GS, a dependncia de job ficar sem soluo e o job dependente
permanecer no estado HOLD.
Para obter informaes adicionais, reveja os arquivos de lista padro (stdlist) da
tarefa e do Tivoli Workload Scheduler.
Mensagens do Gerenciador de Console

Essa mensagem de erro ser exibida se voc emitir um comando start, stop, link
ou unlink para um agente estendido:
AWSBHU058E O comando emitido para a estao de trabalho: workstation_name,
no pode ser desempenhado porque a estao de trabalho um agente estendido,
no qual o comando no suportado.
555
Mensagens do composer e do compiler

As mensagens de erro a seguir so geradas quando o composer encontra sintaxe
invlida em uma definio de estao de trabalho:
AWSDEM045E Existe um erro na definio da estao de trabalho. A palavra-chave ACCESS
no foi seguida por um mtodo vlido. Os mtodos vlidos correspondem ao
nome de um arquivo no diretrio TWS_home/methods
(o arquivo necessrio no est presente quando o mtodo de acesso definido).
foi especificada mais de uma vez.
no foi seguida por um mtodo vlido. Os mtodos vlidos correspondem ao
nome de um arquivo no diretrio TWS_home/methods
(o arquivo necessrio no est presente quando o mtodo de acesso definido).
Se um agente estendido for definido com um mtodo de acesso, mas sem um host,
a seguinte mensagem ser exibida:
AWSBIA140E Para um agente estendido, voc deve especificar o host e o mtodo de acesso.
Mensagens do Jobman
Para agentes estendidos, mensagens de erro, de aviso e de informao so
gravadas no arquivo stdlist de jobman.
O lanamento bem-sucedido de um job gera a seguinte mensagem:
AWSBDW019I Tarefa ativada job_name, #Jrun_number para o usurio user_ID.
O lanamento mal sucedido de um job gera a seguinte mensagem:

AWSBDW057E A tarefa job_name no foi ativada por esta razo:
error_message
Falha em uma tarefa de verificao de arquivo gera a seguinte mensagem:

AWSBDW062E Jobman no conseguiu chamar o seguinte arquivo do mtodo method_name
para o agente estendido. O erro do sistema operacional :
system_error
Falha em uma tarefa de gerenciamento de job gera a seguinte mensagem:

AWSBDW066E Planman solicitou que jobman executasse uma tarefa que no suportada no
agente de destino. O seguinte arquivo de opes do mtodo foi utilizado:
method_options_file. O identificador da tarefa e o PID do monitor so os
seguintes: job, #Jmonitor_pid
Quando um mtodo envia uma mensagem para jobman, mas no reconhecida,

gerada a seguinte mensagem:
AWSBDW064E Uma tarefa que jobman est monitorando retornou a seguinte
mensagem irreconhecvel: incorrect_message. O identificador da tarefa,
PID do monitor e arquivo do mtodo so os seguintes: job_name, #Jmonitor_pid
utilizando method file.
556
Captulo 15. Gerenciando Dependncias de Interligao de

Redes
As dependncias de interligao de redes do Tivoli Workload Scheduler permitem
que tarefas e fluxos de tarefas da rede local utilizem tarefas e fluxos de tarefa em
uma rede remota como dependncias follows. Este captulo descreve como
customizar seu ambiente para poder definir dependncias de interligao de rede e
como gerenciar as dependncias de interligao de rede.
v Viso Geral das Dependncias da Interligao de Redes
v Configurando um agente de rede na pgina 559
v Definindo uma Dependncia de Interligao de Redes na pgina 561
v Gerenciando Dependncias de Interligao de Redes no Plano na pgina 562
v Dependncias de interligao de redes em um ambiente misto na pgina 565
Nota: Dependendo de suas necessidades e requisitos, possvel escolher entre
dependncias de interligao de redes e dependncias cruzadas para
estabelecer uma dependncia entre uma tarefa em execuo no mecanismo
local e uma tarefa em execuo em um mecanismo remoto do Tivoli
Workload Scheduler. Consulte Definindo Dependncias na pgina 16 para
obter uma descrio sobre as diferenas entre esses dois tipos de
dependncias.
Viso Geral das Dependncias da Interligao de Redes

Antes de especificar uma dependncia de interligao de redes, voc deve criar
uma definio de estao de trabalho para o agente de rede. Um agente de rede
uma estao de trabalho do Tivoli Workload Scheduler que manipula dependncias
follows entre sua rede local e uma rede remota do Tivoli Workload Scheduler.
Na rede local do Tivoli Workload Scheduler pode haver mais de um agente de
rede, cada um representando uma rede remota especfica do Tivoli Workload
Scheduler na qual tarefas e fluxos de tarefas que referem-se a dependncias de
interligao de redes definidas localmente so definidos. Dependncias de
interligao de redes so designadas a tarefas e fluxos de tarefas da mesma
maneira que dependncias de sequncias, com a exceo de que o nome do agente
de rede est includo para identificar a tarefa ou fluxo de tarefas seguido.
Um fluxo de tarefa especial denominado EXTERNAL criado automaticamente
pelo Tivoli Workload Scheduler para cada agente de rede na rede local. Contm
tarefas sinalizadoras de substituio para representar cada dependncia de
Uma tarefa EXTERNAL criada para cada dependncia interede que pertence a
fluxos de tarefa planejados para iniciar em diferentes dias com diferentes datas de
planejamento. isso significa que uma tarefa EXTERNAL difere de outras por:
v Nome do arquivos de script, que identifica a tarefa ou o fluxo de tarefas remoto
do qual a tarefa ou o fluxo de tarefas local depende.
557
v A data em que o fluxo de tarefa local que contm a dependncia de interligao

de redes est planejada para iniciar. Se a dependncia for definida em uma
tarefa no fluxo de tarefas, a data na qual o fluxo de tarefas est planejada para
iniciar levada em considerao.
A verificao da dependncia da interligao de redes no iniciada at o fluxo de
tarefas corresponder sua dependncia de tempo ou ser liberado.
No caso de duas tarefas pertencerem a diferentes fluxos de tarefa e referirem a
mesma dependncia de interligao de redes, enquanto um de seus fluxos de
tarefa liberado e a tarefa inicia, a dependncia de interligao de redes
verificada e possivelmente liberada. Nesse caso, quando a segunda tarefa comea a
verificar sua dependncia de interligao de redes, encontra a dependncia j
solucionada, mas no necessariamente no dia esperado. Se quiser evitar que essa
situao ocorra, voc deve executar novamente a tarefa que representa a
dependncia de interligao de redes aps ser solucionada pela primeira vez.
O Tivoli Workload Scheduler verifica o status das tarefas e fluxos de tarefas
referidos na rede remota e mapeia seu status nas tarefas que representam as
dependncias de interligao de redes no fluxo de tarefa EXTERNAL. O status dessas
tarefas e dos fluxos de tarefas verificado em um intervalo de tempo fixo at a
tarefa ou o fluxo de tarefas remoto atingir o estado SUCC, CANCL ou ERROR.
Compreendendo Como uma Dependncia entre Redes

Mostrada
Esta seo descreve um cenrio de amostra sobre as dependncia de interligao
de redes e como vincular a tarefa que representa a dependncia de interligao de
redes ao fluxo de tarefas no qual a dependncia definida. Suponhamos que:
v Voc tenha definido um fluxo de tarefas denominado ELISCHED em execuo na
estao de trabalho TWS206 que contm uma tarefa denominada ELI com uma
dependncia interede a partir de um fluxo de tarefa TWS207#FINAL.MAKEPLAN em
execuo em uma rede diferente do Tivoli Workload Scheduler.
v XA_MAST o agente de rede definido na rede local para gerenciar dependncias
de interligao de redes de tarefas e fluxos de tarefas definidos nessa rede
remota.
Utilize o comando conman sj para ver a dependncia de interligao de redes
configurada:
CPU
Schedule SchedTime
Job
(Est) (Est)
TWS206#ELISCHE 0600 03/31 **** HOLD 10 (03/31)

ELI HOLD 10
XA-MAST::"TWS207#MYJS.JOB1"
onde (03/31) representa a restrio de tempo at configurada em TWS206#ELISCHE. A

partir de (31/03) o status de TWS207#MYJS.JOB1 verificado na rede remota para
ver se a dependncia de interligao de redes XA-MAST::"TWS207#MYJS.JOB1"
atendida.
Se voc executar o comando:
%sj XA-MAST#EXTERNAL;info
558
ver a lista de tarefas que representa as dependncias de interligao de redes

definidas em tarefas e fluxos de tarefas em execuo na rede local a partir de
tarefas e fluxos de tarefas definidos na rede remota que pode ser alcanada atravs
do agente de rede XA-MAST:
CPU
Schedule SchedTime
Aviso
XA-MAST #EXTERNAL
Job
JobFile
Opt
Job
E8802332 TWS207#MYJS.JOB1
possvel ver os detalhes da tarefa ou do fluxo de tarefas dependendo de

TWS207#MYJS.JOB1 na dependncia de interligao de redes representada pela tarefa
E8802332 no fluxo de tarefas EXTERNAL, executando o seguinte comando:
%sj @#EXTERNAL.E8802332;deps
A sada mostra o link entre a tarefa dependente e a dependncia de interligao de

redes:
CPU
Schedule SchedTime
Job
(Est) (Est)
XA-MAST#EXTERNAL.E8802332 Dependencies are:

TWS206#ELISCHE 0600 03/31 **** HOLD 10 (03/31)
ELI HOLD 10
XA-MAST::"TWS207#MYJS.JOB1"
A verificao da dependncia de interligao de redes no iniciada at o fluxo de

tarefas TWS206#ELISCHE corresponder sua dependncia de tempo, (03/31), ou ser
liberado.
Se houver outra tarefa definida em outro fluxo de tarefas na rede local que tem
uma dependncia de TWS2007#MYJS.JOB1 e o fluxo de tarefas local estiver planejado
para iniciar no mesmo dia, 31/03/06, ento, tambm a dependncia dessa outra
tarefa de TWS2007#MYJS.JOB1 ser listada na tarefa E8802332 no fluxo de tarefas
XA-MAST#EXTERNAL.
Configurando um agente de rede

As estaes de trabalho do agente de rede so definidas como agentes estendidos e
requerem uma estao de trabalho fsica hosting e um mtodo de acesso. O
mtodo de acesso para os agentes de rede denominado netmth.
O processo batchman no gerenciador de domnio mestre consulta o netmth no
agente de rede em intervalos de tempo fixos para obter o status da tarefa ou do
fluxo de tarefas predecessor remoto. possvel customizar o intervalo de tempo
entre duas verificaes consecutivas, configurando a opo global bm check status
no arquivo localopts no gerenciador de domnio mestre. O Tivoli Workload
Scheduler continua a verificar at a tarefa ou o fluxo de tarefa remoto alcanar o
estado SUCC, CANCL ou ERROR.
Um arquivo de opes denominado netmth.opts criado na estao de trabalho
onde o agente de rede executado. Nesse arquivo, so definidos o usurio sob o
qual o mtodo de acesso executado e o tempo a ser aguardado para obter uma
resposta do mtodo de acesso antes de encerr-lo. Esse arquivo de opes deve ter
o mesmo caminho que o mtodo de acesso:
TWS_home/methods/netmth.opts
Captulo 15. Gerenciando Dependncias de Interligao de Redes
559
O contedo do arquivo netmth.opts tem a seguinte estrutura:

GSuser=login_name
GStimeout=seconds
onde:
login_name
o login utilizado para executar o mtodo. Se o host do agente de rede for
um computador com o Windows, esse usurio deve ser definido no Tivoli
Workload Scheduler.
segundos
o nmero de segundos que o Tivoli Workload Scheduler aguarda por
uma resposta antes de encerrar o mtodo de acesso. A configurao padro
300 segundos. A prxima vez que o batchman precisar verificar o status
da tarefa ou do fluxo de tarefas predecessor, o mtodo de acesso iniciado
automaticamente.
As alteraes nesse arquivo no tm efeito at voc parar e reiniciar o Tivoli
Workload Scheduler.
Uma Amostra da Definio do Agente de Rede

O exemplo a seguir mostra como definir uma estao de trabalho do agente de
rede para uma rede remota, Rede A, que permite que a rede local, Rede B, utilize
tarefas e fluxos de tarefa na rede remota como dependncias de interligao de
redes.
Rede
Remota A
Rede
Local B
MasterA
MasterB
Agente de Rede
Figura 29. Redes local e remota
Suponhamos que:
v MasterA o gerenciador de domnio mestre da rede remota, Rede A, e que:
tws_masterA o TWS_user definido no MasterA.
O nmero da porta TCP para MasterA como 12345.
O n no qual MasterA definido MasterA.rome.tivoli.com.
v MasterB o gerenciador de domnio mestre da rede local, Rede B, e que:
560
tws_masterB o TWS_user definido no MasterB.

O n no qual MasterB definido MasterB.rome.tivoli.com.
Uma estao de trabalho de agente de rede denominada NetAgt, definida no
MasterB para gerenciar as dependncias de interligao de redes de tarefas ou
fluxos de tarefas definidos na Rede A pode ser a seguinte:
CPUNAME NETAGT
DESCRIPTION "NETWORK AGENT"
OS OTHER
NODE MASTERA.ROME.TIVOLI.COM
TCPADDR 12345
FOR maestro
HOST MASTERB
ACCESS netmth
END
Importante: Grave o nome de acesso rede netmth em letras minsculas nos

sistemas operacionais que fazem distino entre maisculas e
minsculas.
O arquivo de opes, netmth.opts definido em MasterB pode ser:
GSuser=tws_masterB
GStimeout=600
Nota: O agente de rede pode ser definido no gerenciador de domnio mestre ou

em um agente tolerante a falhas.
Definindo uma Dependncia de Interligao de Redes

A sintaxe utilizada para especificar uma dependncia de interligao de redes em
uma definio de fluxo de tarefa a seguinte:
follows
Network_agent_name::remote_workstation#jobstreamname(time
[date]).jobname
em que (time [date]) so especficos do fuso horrio utilizado na estao de

trabalho da rede remota qual o agente de rede est conectado; em nossa amostra,
o fuso horrio da MasterA. Se (time [date]) no for especificado nessa sintaxe ou
se houver mais de um fluxo de tarefas com o mesmo (time [date]), o primeiro
fluxo de tarefas levado em considerao.
Suponhamos que:
v schedA seja um fluxo de tarefa definido no banco de dados MasterA.
v jobA uma tarefa definida no banco de dados MasterA.
v schedB um fluxo de tarefa definido no banco de dados MasterB.
v jobB uma tarefa definida no banco de dados MasterB.
possvel definir dependncias de interligao de redes utilizando as seguintes
instrues follows:
Para definir uma dependncia de interligao de redes schedB da instncia do
fluxo de tarefas schedA(1100)
Utilize a instruo a seguir:
561
schedule schedB
on everyday
follows NetAgt::MasterA#schedA(1100)
:
fim
Para definir uma dependncia de interligao de redes jobB da jobA contida na

instncia do fluxo de tarefas schedA(1100)
Utilize a instruo a seguir:
schedule schedB
on everyday
:
jobB
:
follows NetAgt::MasterA#schedA(1100).jobA
:
fim
:
fim
Tambm possvel definir dependncias de interligao de redes de uma tarefa em

um fluxo de tarefas ou de um fluxo de tarefas em uma tarefa.
Gerenciando Dependncias de Interligao de Redes no Plano

As dependncias de interligao de redes so gerenciadas no plano a partir da
linha de comandos conman, gerenciando o fluxo de tarefa EXTERNAL. No fluxo de
tarefa EXTERNAL, as dependncias interede so listadas como tarefas,
independentemente se esto definidas para tarefas ou fluxos de tarefa. H um
fluxo de job EXTERNAL para cada agente de rede no plano.
No fluxo de tarefa EXTERNAL, nomes de tarefas exclusivos que representam as
dependncias de interligao de redes so gerados da seguinte forma:
Ennnmmss
onde:
nnn
um nmero aleatrio.
mm
So os minutos atuais.
ss
So os segundos atuais.
O nome real da tarefa ou fluxo de tarefa armazenado na especificao dos

arquivos de script do registro de tarefa.
Nota: As tarefas e fluxos de tarefa remotos so definidos e executados em sua rede
local de maneira padro. Seu uso como dependncias entre redes no causa
efeito em seu procedimento local.
Estados de Tarefas Definidas no Fluxo de Tarefas EXTERNAL

O status das tarefas definidas no fluxo de tarefa EXTERNAL determinado pelo
mtodo de acesso e listado no campo Status do Release do fluxo de tarefa
EXTERNAL. O status relatado refere-se ltima vez que a rede remota foi verificada.
Pode parecer que as tarefas ignoram estados quando os estados mudam entre duas
verificaes diferentes.
562
Todos os estados para tarefas e fluxos de tarefas, exceto FENCE, so listados. Alm
desses, h dois estados que so especficos das tarefas EXTERNAL, so eles:
ERROR
Ocorreu um erro durante a verificao do status remoto.
EXTRN
O estado inicial. Se a tarefa no for localizada na rede remota, o estado de
tarefa EXTERNAL permanece EXTRN. Se for uma tarefa EXTERNAL, retorna ao
estado EXTRN.
Nota: Se voc cancelar na rede local as instncias de tarefas ou fluxos de tarefas
dependentes da mesma instncia de uma tarefa ou fluxo de tarefas definido
em uma rede remota, certifique-se de cancelar tambm manualmente a
tarefa, que representa essa dependncia de interligao de redes no fluxo de
tarefas EXTERNAL, para evitar que o fluxo de tarefas EXTERNAL tenha
continuamente o saldo transportado.A mesma considerao aplica-se quando
o fluxo de tarefas local dependente da tarefa ou do fluxo de tarefas definido
na rede remota no tiver o saldo transportado para o novo plano.
Trabalhando com Tarefas Definidas no Fluxo de Tarefas

EXTERNAL
Essas so as aes disponveis que podem ser executadas contra tarefas em um
fluxo de tarefa EXTERNAL:
Cancelar
Cancela a tarefa EXTERNAL, liberando a dependncia de interligao de
redes para todas as tarefas e fluxos de tarefas locais. O status da
dependncia no mais verificado.
Executar Novamente
Orienta o conman a reiniciar a verificao do estado do job EXTERNAL. O
estado da tarefa configurado para EXTRN imediatamente aps uma ao
rerun ser executada.
Rerun til para as tarefas EXTERNAL no estado ERROR. Por exemplo, se uma
tarefa EXTERNAL no puder ser ativada porque o mtodo de acesso rede
no concede permisso de execuo, a tarefa entra no estado ERROR e seu
status pra de ser verificado. Depois que voc corrigir as permisses, o
mtodo poder ser iniciado, mas o conman no iniciar a verificao do
estado do job EXTERNAL at que rerun seja executado.
Confirm SUCC / ABEND
Configura o status da tarefa EXTERNAL para SUCC ou ABEND, liberando a
dependncia para todas as tarefas e fluxos de tarefa locais dependentes. O
status da dependncia no ser mais verificado.
Nota: Nenhum desses comandos afeta a tarefa ou o fluxo de tarefas remoto na
rede remota. Eles simplesmente manipulam a dependncia para a rede local.
Amostra de Cenrios de Gerenciamento da Dependncia entre

Redes
Esta seo fornece cenrios de amostra que descrevem como gerenciar a
dependncia de interligao de redes na produo, utilizando os comandos de
linha de comandos conman.
563
Supondo que voc j tenha definido o seguinte:

v Uma estao de trabalho local chamada local1
v Um fluxo de tarefa definido para a estao de trabalho local local1 chamada
sched1
v Uma tarefa definida em local1#sched1 chamada job1
v Um agente de rede chamado netagt definido na rede local para gerenciar a
dependncia interede de tarefas e fluxos de tarefa definidos na rede remota.
v Uma estao de trabalho na rede remota chamada remote1
v Um fluxo de tarefa definido para a estao de trabalho remota remote1 chamada
rcshed
v Uma tarefa definida em remote1#rsched chamada rjob
As seguintes aes podem ser executadas a partir da linha de comandos conman
na rede local:
Incluir uma dependncia interede de uma tarefa remota para uma tarefa local.
Por exemplo, para incluir a tarefa remota rjob como uma dependncia de
interligao de redes para job1, execute o seguinte comando:
adj local1#sched1.job1;follows=netagt::remote1#rsched.rjob
Incluir uma dependncia interede de um fluxo de tarefa remoto para um fluxo

de tarefa local.
Por exemplo, para incluir o fluxo de tarefas remoto rsched como uma
dependncia de interligao de redes para o fluxo de tarefas sched1,
ads local1#sched1;follows=netagt::remote1#rsched
Cancelando dependncias de interligao de redes gerenciadas por um agente de

rede. Por exemplo, para cancelar todas as tarefas EXTERNAL para um agente de
rede netagt, execute um dos dois comandos a seguir:
cj netagt#EXTERNAL.@
cj netagt::@
Confirmando a concluso bem-sucedida de uma dependncia de interligao de

redes. Por exemplo, para confirmar que a tarefa remota remote1#rsched.rjob
tenha sido concluda com xito e liberar dessa forma a dependncia de
interligao de redes correspondente, execute o seguinte comando:
confirm netagt::remote1#rsched.rjob;succ
Excluir uma dependncia de interligao de redes de uma tarefa para uma

tarefa. Por exemplo, para excluir a dependncia de interligao de redes da tarefa
remota remote1#rsched.rjob para a tarefa local local1#sched1.job1,
ddj local1#sched1.job1;follows=netagt::remote1#rsched.rjob
Excluindo uma dependncia de interligao de redes a partir de uma tarefa para

um fluxo de tarefas.
Por exemplo, para excluir a dependncia de de interligao de redes da
tarefa remota remote1#rsched.rjob para o fluxo de tarefa local
local1#sched1, execute o seguinte comando:
dds local1#sched1;follows=netagt::remote1#rsched.rjob
Liberar uma tarefa local de uma dependncia interede de uma tarefa remota.
Por exemplo, para liberar uma tarefa de uma dependncia de de
interligao de redes de uma tarefa remota, execute o seguinte comando:
rj local1#sched1.job1;follows=netagt::remote1#rsched.rjob
564
Liberar um fluxo de tarefa local de uma dependncia interede de uma tarefa

remota.
Por exemplo, para liberar um fluxo de tarefas de uma dependncia de de
interligao de redes de uma tarefa remota, execute o seguinte comando:
rs local1#sched1;follows=netagt::remote1#rsched.rjob
Executar novamente uma tarefa no fluxo de tarefa EXTERNAL para reiniciar a

verificao de uma dependncia.
Por exemplo, para executar uma tarefa novamente pertencente ao fluxo de
tarefa EXTERNAL para reiniciar a verificao da dependncia de interligao
de redes a partir da tarefa remota remote1#rsched.rjob, execute um dos
dois comandos a seguir:
rr netagt#EXTERNAL.rjob
rr netagt::remote1#rsched.rjob
Exibir dependncias interede de tarefas e fluxos de tarefa definidos em uma

rede remota.
Por exemplo, para exibir todas as dependncias de de interligao de redes
definidas para um agente de rede com seus nomes originais e seus nomes
de tarefas gerados, execute o seguinte comando:
sj netagt#EXTERNAL.@;info
Enviar uma tarefa com uma dependncia interede de um fluxo de tarefa definido
em uma rede remota
Por exemplo, para enviar um comando rm para o fluxo de tarefas JOBS com
uma dependncia de de interligao de redes de um fluxo de tarefas
remoto, execute o seguinte comando:
sbd "rm apfile";follows=netagt::remote1#rsched
Dependncias de interligao de redes em um ambiente misto

Tabela 89 na pgina 566 mostra a configurao suportada para dependncias de
interligao de redes definidas em um ambiente da verso 8.3 misto. A chave para
a tabela a seguinte:
Net_A O agente de rede definido na rede local.
Wks_B
A estao de trabalho na rede remota qual o agente de rede Net_A est
conectado. Wks_B a estao de trabalho que identifica e verifica o estado
da tarefa remota ou fluxo de tarefas especificado na dependncia de
Sym_A
O arquivo Symphony processado na rede local.
Sym_B
O arquivo Symphony processado na rede remota.
back-level
Verso 8.1, 8.2 ou 8.2.1
565
Tabela 89. Dependncias de interligao de redes em um ambiente misto

Net_A back-level
Sym_A back-level
Net_A 8.3
Sym_A back-level
Net_A back-level
Sym_A 8.3
Net_A 8.3
Sym_A 8.3
Wks_B back-level
Sym_B back-level
Este no um
ambiente da verso
8.3 misto.
Net_A envia as
informaes para
Wks_B como se ele
tivesse a mesma
verso de Wks_B.
Net_A envia as
informaes para
Wks_B no formato 8.1,
8.2 ou 8.2.1. A
utilizao da
palavra-chave
schedtime na definio
de tarefa no
suportada.
Net_A envia as
informaes para Wks_B
como se ele tivesse a
mesma verso que
Wks_B. Se definido, a
palavra-chave schedtime
na definio de tarefa
ser removida
automaticamente por
Net_A.
Wks_B 8.3
Sym_B back-level
Wks_B funciona como

se tivesse a mesma
verso que Net_A.
Net_A envia as
informaes para
palavrachaveschedtime na
definio de tarefa
ser removida
automaticamente por
Wks_B.
Net_A envia as
informaes para
palavrachaveschedtime na
definio de tarefa
ser removida
automaticamente por
Wks_B.
Net_A envia as
informaes para
palavra-chaveschedtime
na definio de tarefa
ser removida
automaticamente por
Wks_B.
No suportado.
No suportado.
No suportado.
No suportado.
No suportado.
No suportado.
Net_A envia as
informaes para
palavrachaveschedtime
analisada por Wks_B.
Este um ambiente da
verso 8.3.
Wks_B back-level
Sym_B 8.3
Wks_B 8.3
Sym_B 8.3
566
Captulo 16. Definindo e Gerenciando Dependncias Cruzadas
|
|
|
|
|
|
|
|
|
As dependncias cruzadas do Tivoli Workload Scheduler ajudam a integrar e

automatizar o processamento de tarefa quando:
v A carga de trabalho distribuda por diferentes ambientes de planejamento, pois
algumas das atividades so executadas em diferentes sites ou envolvem
diferentes unidades organizacionais ou requerem diferentes qualificaes para
serem executadas.
v Mesmo se maior parte da carga de trabalho em lote for gerenciada localmente,
nenhum desses ambientes est completamente isolado dos outros, pois
frequentemente interoperam para trocarem ou sincronizarem dados e atividades.
|
|
|
Mais especificamente, o recurso de dependncia cruzada chave quando for

necessrio sincronizar atividades entre diferentes ambientes de planejamento de
maneira fcil para que seja possvel:
|
|
|
|
v Definir em um ambiente de planejamento dependncias nas atividades em lote

que so gerenciadas por outro ambiente de planejamento.
v Monitorar o status das tarefas predecessoras remotas como se estivessem em
execuo em seu ambiente local.
|
|
Alm disso, possvel controlar o status dessas dependncias navegando da

interface com o usurio exclusiva para os diferentes ambientes de planejamento.
Este captulo descreve como definir e usar dependncias cruzadas.
Ele contm as seguintes sees:
|
|
|
|
v Uma Introduo a Dependncias Cruzadas

v Fluxo de Processamento no Ambiente de Planejamento Distribudo na pgina
569
v Definindo uma Dependncia Cruzada na pgina 572
v Como o Status da Tarefa Sombra Muda at uma Conexo Ser Estabelecida na
pgina 574
v Como uma Tarefa Sombra do z/OS Conectada na pgina 576
|
|
|
|
|
|
|
|
|
|
|
|
|
v Como o Status da Tarefa Sombra Muda aps a Conexo Ser Estabelecida na

pgina 579
Nota: Dependendo de suas necessidades e requisitos, possvel escolher entre
dependncias de interligao de redes e dependncias cruzadas para
estabelecer uma dependncia entre uma tarefa em execuo no mecanismo
local e uma tarefa em execuo em um mecanismo remoto do Tivoli
Workload Scheduler. Consulte Definindo Dependncias na pgina 16 para
obter uma descrio das diferenas entre esses dois tipos de dependncias.
Uma Introduo a Dependncias Cruzadas
|
|
|
Uma dependncia cruzada , de um ponto de vista lgico, uma dependncia que

uma tarefa local tem de uma instncia da tarefa que est planejada para execuo
em um mecanismo remoto.
|
|
Use dependncias cruzadas para integrar a carga de trabalho em execuo em

diferentes mecanismos, que podem ser mecanismos do Tivoli Workload Scheduler
567
|
|
para z/OS (controlador) ou mecanismos do Tivoli Workload Scheduler

(gerenciador de domnio principal e gerenciador do domnio principal de backup).
|
|
Os objetos e termos a seguir so usados para descrever e implementar

dependncias cruzadas:
|
|
|
|
|
|
Estao de trabalho de mecanismo remoto

Um novo tipo de estao de trabalho que representa localmente um
mecanismo remoto do Tivoli Workload Scheduler, distribudo ou z/OS.
Esse tipo de estao de trabalho usa uma conexo baseada no protocolo
HTTP ou HTTPS pare permitir que o ambiente local se comunique com o
ambiente remoto.
|
|
|
Tarefa remota
Uma tarefa planejada para execuo em um mecanismo remoto do Tivoli
Workload Scheduler.
|
|
|
|
|
Tarefa sombra
Uma tarefa definida localmente, em uma estao de trabalho e mecanismo
remoto, que usada para mapear uma tarefa remota. A definio da tarefa
sombra contm todas as informaes necessrias para corresponder
corretamente, no plano do mecanismo remoto, a instncia da tarefa remota.
|
|
|
|
Conectar
O processo para associar uma tarefa sombra a uma instncia de tarefa
remota planejada no plano do mecanismo remoto do Tivoli Workload
Scheduler.
|
|
|
|
|
|
De um ponto e vista lgico no ambiente local:

v A estao de trabalho do mecanismo remoto usada para mapear o mecanismo
remoto do Tivoli Workload Scheduler.
v A tarefa sombra, definida nessa estao de trabalho de mecanismo remoto,
usada para mapear uma instncia da tarefa remota planejada para execuo
nesse mecanismo remoto do Tivoli Workload Scheduler.
|
|
|
Uma dependncia cruzada definida quando desejar que uma tarefa local
(executando em seu mecanismo local) dependa de um uma tarefa remota
(executando em um mecanismo remoto).
|
|
|
|
Para faz-lo, voc deve fazer o seguinte:

1. Crie uma tarefa sombra que executada em seu mecanismo local.
2. Defina uma dependncia normal que torna sua tarefa local dependente da tarefa
sombra.
Quando a sombra for criada, considere que:
|
|
|
|
|
v Ela deve ser definida em uma estao de trabalho de tipo de mecanismo remoto,
que aponta para o mecanismo remoto (ou seja, o mecanismo em que a tarefa
remota est planejada para executar).
v Voc deve faz-lo apontar para a tarefa remota com a qual est criando a
dependncia cruzada.
|
|
|
|
A Figura 30 na pgina 569 mostra o fluxo lgico que implementa dependncias

cruzadas:
1. No processo de ligao, a tarefa sombra est associada instncia da tarefa
remota.
568
|
|
|
|
|
|
|
2. Aps a conexo ser estabelecida, o status da tarefa shadow atualizado de

acordo com a transio do status da tarefa remota.
3. Quando o status da tarefa sombra torna-se SUCC, a dependncia normal da
tarefa local liberada e assim tambm a dependncia cruzada da tarefa local na
tarefa remota tambm liberada.
Mecanismo local do Tivoli Workload Scheduler
predecessor local
liberar
dependncia
normal (3)
tarefa
sombra
Mecanismo remoto do Tivoli Workload Scheduler
notificaes sobre transio de

status da tarefa remota
(2)
conexo (1)
tarefa
remota
tarefa
local
predecessor remoto
successor
|
|
|
|
|
Figura 30. Lgica da Dependncia Cruzada
Fluxo de Processamento no Ambiente de Planejamento Distribudo
|
|
|
|
Dependendo de se o mecanismo local emite ou recebe uma solicitao de conexo,

o fluxo de processamento e os componentes envolvidos so alterados. Em ambos
os casos, a estao de trabalho do broker no ambiente local deve estar ativada e em
execuo para permitir o gerenciamento de solicitaes de conexo.
|
|
Fluxo de processamento quando o mecanismo local envia uma solicitao de

conexo a um mecanismo remoto
|
|
|
ao definir uma tarefa sombra, voc especifica as informaes necessrias

para estabelecer uma conexo com uma tarefa no plano de mecanismo
remoto.
|
|
|
Quando o horrio planejado da tarefa sombra chegar, se a tarefa sombra

estiver livre de dependncias, ela selecionada pelo batchman local para
envio e seu status configurado para INTRO.
|
|
A solicitao de conexo enviada ao mecanismo remoto. O status da

tarefa sombra configurado para WAIT.
|
|
|
Assim que o processamento de conexo for concludo, o mecanismo

remoto envia de volta ao mecanismo local uma notificao com o resultado
da conexo.
|
|
|
|
A Tabela 90 na pgina 570 mostra como o status da tarefa sombra muda

com base em:
v Se a instncia a conectar existe ou no no plano do mecanismo remoto.
v O status da tarefa remota conectada.
569
Tabela 90. Transio de Status da Tarefa Sombra
|
|
Status da tarefa sombra no plano de

produo:
|
|
|
|
|
BOUND
|
|
|
|
|
Quando o mecanismo remoto:
z/OS
A instncia do fluxo de tarefas

remoto para a conexo foi
localizada no plano de longo prazo
ou no plano atual.
Distribuda
A instncia do fluxo de tarefas
localizada no plano de
pr-produo.
|
|
|
|
|
|
|
|
|
|
|
|
ERROR
z/OS
Uma das situaes a seguir ocorreu:

v A instncia do fluxo de tarefas
remoto para a conexo no existe
no plano de longo prazo nem no
plano atual.
localizada no plano de longo
prazo, mas, quando includa no
plano atual, no contm a
instncia de tarefa solicitada.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Distribuda
Uma das situaes a seguir ocorreu:
remoto para conexo no existe
no plano de pr-produo.
localizada no plano de
pr-produo, mas, quando
includa no plano de produo,
no contm a instncia de tarefa
solicitada.
v O usurio de ligao remota no
autorizado a acessar a instncia
da tarefa solicitada no plano de
produo.
|
|
EXEC
O status da tarefa remota EXEC.
SUCC
O status da tarefa remota SUCC.
FAIL
O status da tarefa remota FAIL.
ABEND
O status da tarefa remota ABEND.
|
|
SUCC
O status da tarefa remota CANCELED.
Nota: O status da tarefa sombra FAIL tambm quando seu envio falha.
Para obter detalhes adicionais sobre a transio de status da tarefa sombra,
consulte Como o Status da Tarefa Sombra Muda at uma Conexo Ser
Estabelecida na pgina 574 e Como o Status da Tarefa Sombra Muda
aps a Conexo Ser Estabelecida na pgina 579.
|
|
|
|
|
570
|
|
Fluxo de processamento quando o mecanismo remoto recebe uma solicitao de

conexo do mecanismo local.
|
|
|
Quando o mecanismo remoto recebe uma solicitao de conexo do

mecanismo local, as informaes contidas na solicitao so usadas para
executar a conexo no plano de pr-produo.
|
|
|
|
|
A solicitao de ligao tambm contm uma lista ordenada de URLs que

o mecanismo remoto usa para enviar notificaes ao mecanismo local. Se o
mecanismo local for distribudo, a lista composta da URL especificada na
propriedade JDURL do arquivo chamado TDWB_HOME/config/
JobDispatcherConfig.properties.
|
|
|
|
|
|
|
|
|
|
|
|
|
Nota: Por padro, o Tivoli Workload Scheduler usa o TWSUser para

executar a conexo no plano de produo. Se quiser limitar e
controlar quais tarefas podem ser conectadas, possvel especificar
um usurio diferente usando a opo global bindUser. O usurio
especificado no precisa ser definido como um usurio no sistema
operacional, ou mesmo ter uma senha, mas deve existir como
entrada no arquivo de segurana com os seguintes privilgios de
acesso:
v Acesso DISPLAY aos objetos job e schedule que podem ser
localizados
v Acesso LIST aos objetos job que podem ser localizados. Esse
acesso necessrio apenas se a opo global enListSecChk estiver
configurada como yes.
|
|
|
|
Se os privilgios de acesso necessrios no forem especificados, uma

notificao com um erro enviada de volta ao mecanismo que
solicitou a ligao.
O mecanismo remoto envia de volta o mecanismo local:
|
|
|
|
Uma notificao com o status BOUND

Se o plano de pr-produo contiver pelo menos uma instncia do
fluxo de tarefas especificado na solicitao de conexo e a definio
desse fluxo de tarefas contiver a tarefa a conectar.
|
|
|
Uma notificao com o status da instncia da tarefa conectada

Se a instncia da tarefa a conectar for localizada no plano de
produo e sempre que seu status mudar.
|
|
|
Uma notificao com um erro

Se a instncia da tarefa para ligao no for localizada ou se o
usurio da ligao no estiver autorizado.
|
|
O processo remoto do batchman grava uma entrada na fila do PlanBox.msg

sempre que o status de uma tarefa remota mudar.
|
|
|
|
|
A cada 30 segundos, a fila do PlanBox.msg verificada para novas entradas

que documentem uma mudana no status das tarefas remotas que foram
conectadas. Sempre que uma mudana de status for localizada, uma
notificao contendo o status da tarefa remota conectada enviado de
volta ao mecanismo que solicitou a conexo.
|
|
|
|
|
Nota: Para alterar o intervalo de pesquisa, especifique um valor, em

segundos, para com.ibm.tws.planner.monitor.checkPlanboxInterval
no arquivo WAS_HOME/profiles/profile_name/properties/
TWSConfig.properties e, em seguida, reinicie o WebSphere
Application Server.
571
|
|
Definindo uma Dependncia Cruzada

Execute estas etapas para definir uma dependncia cruzada entre uma execuo de
tarefa em seu ambiente e outra tarefa em execuo em um mecanismo diferente do
Tivoli Workload Scheduler:
|
|
|
|
1. Criar uma estao de trabalho de mecanismo remoto

Crie uma estao de trabalho e mecanismo remoto ara um mecanismo
especfico quando precisar definir dependncias sobre instncias de tarefas em
execuo nesse mecanismo remoto. Em uma estao de trabalho de mecanismo
remoto, possvel executar somente tarefas sombra.
Como uma melhor prtica, se o mecanismo do Tivoli Workload Scheduler
remoto for distribudo, possvel definir um conjunto dinmico contendo uma
lista ordenada de estaes de trabalho do mecanismo remoto apontando para o
principal remoto e para seus principais de backup, para assegurar que as
capacidades de failover e do gerenciador de comutao sejam aplicadas. Para
obter informaes adicionais sobre o conjunto de estaes de trabalho, consulte
Estao de Trabalho na pgina 5.
|
|
|
|
|
|
|
|
|
|
|
Nota: Recomenda-se que:

v Todos os ambientes distribudos envolvidos tenham o recurso de fuso
horrio ativado. Para obter informaes adicionais, consulte a
Ativando o Gerenciamento de Fuso Horrio na pgina 523.
|
|
|
|
|
|
|
|
|
|
|
|
v Voc especifique como propriedade TIMEZONE das estaes de

trabalho de mecanismo remoto o fuso horrio configurado no sistema
operacional dos Gerenciadores de Domnios Principais ou
Gerenciadores de Domnios Principais de Backup remotos para os
quais apontam.
Para obter informaes adicionais sobre as configuraes especficas a serem
usadas ao definir uma estao de trabalho de mecanismo remoto, consulte
2. Definir uma tarefa sombra na estao de trabalho do mecanismo remoto
Crie uma tarefa sombra que aponte para uma instncia de tarefa definida em
um mecanismo remoto quando quiser controlar em seu ambiente local o status
da tarefa remota e definir dependncias cruzadas nessa tarefa remota.
|
|
|
|
|
|
|
|
|
|
|
Em ambientes distribudos do Tivoli Workload Scheduler, possvel usar alias

para nomes de fluxos de tarefa e nomes de tarefas. Se voc estiver definindo
uma tarefa sobra definida, certifique-se de que:
v O nome do fluxo de tarefas remoto especificado contenha o nome do fluxo
de tarefas definido no banco de dados.
v O nome da tarefa remota especificado contenha o alias, se definido, da tarefa
remota a conectar.
Se voc no seguir essas diretrizes, a conexo falha e o status da tarefa sombra
torna-se ERROR.
Na definio de tarefa sombra, configure COMPLETE_IF_BIND_FAILS no
campo rccondsucc para especificar se o status da tarefa sombra deve ser forado
para SUCC ou ERROR se a conexo no plano do mecanismo remoto falhar.
Para obter informaes adicionais sobre as configuraes especficas a serem
usadas ao definir uma tarefa sombra, consulte Definio de tarefa na pgina
155.
Dependendo de se o mecanismo remoto z/OS ou distribudo, possvel usar
diferentes critrios de correspondncia:
|
|
|
|
|
|
|
|
|
|
572
|
|
Se o mecanismo remoto for distribudo

possvel escolher qualquer um destes critrios de correspondncia:
Tabela 91. Critrios de Correspondncia para Tarefas Sombra Distribudas
|
|
No Dynamic Workload Console
Palavra-chave correspondente usada no

composer
Closest preceding
previous
|
|
relative from=time_before_scheduled_time
to=time_after_scheduled_time
absolute from=interval_start to=interval_end
|
|
|
|
|
|
Mesma data de planejamento
sameDay
Para obter informaes adicionais sobre esses critrios de

correspondncia, consulte Gerenciando Dependncias de
Acompanhamentos Externos para Tarefas e Fluxos de Tarefas na
pgina 57.
|
|
|
Se o mecanismo remoto for baseado no z/OS

Anterior mais prximo o nico critrio de correspondncia suportado
pelo Tivoli Workload Scheduler para z/OS.
|
|
O horrio planejado da instncia do fluxo de tarefas que contm a tarefa

sombra usado para a correspondncia no plano do mecanismo remoto.
A transio do status da tarefa sombra mapeado para a transio do status da
instncia da tarefa remota.
3. Incluir uma dependncia na tarefa sombra
possvel incluir dependncia cruzada para uma tarefa local na tarefa remota
definindo uma dependncia para a tarefa local em uma tarefa sombra que:
|
|
|
|
|
|
|
|
|
|
|
|
|
v Aponte para a instncia da tarefa remota.

v Esteja definida em uma estao de trabalho local que aponte para o
mecanismo remoto no qual a tarefa remota est definida.
A dependncia cruzada na instncia da tarefa remota liberada quando a
dependncia local na tarefa sombra liberada.
Monitorando uma Resoluo de Dependncia Cruzada no Plano de

Produo
|
|
|
|
|
Tarefas sombra so includas no plano da seguinte forma:

v No tempo de execuo, se uma das situaes a seguir ocorrer:
|
|
|
|
|
Nota: Ao enviar uma tarefa sombra, especifique um fluxo de tarefas de

destino com um tempo planejado conhecido para controlar melhor a
instncia da tarefa remota que ser localizada.
v Quando o plano de pr-produo estendido ou criado e seu perodo de tempo
inclui o horrio planejado da tarefa sombra.
|
|
Quando uma instncia da tarefa sombra includa no plano, possvel iniciar

monitoramento de seu status.
Uma definio de tarefa sombra enviada usando o comando sbj.

Um fluxo de tarefas contendo uma definio de tarefa sombra enviado
usando o comando sbs.
573
Como o Status da Tarefa Sombra Muda at uma Conexo Ser

Estabelecida
|
|
A Figura 31 resume como o status de uma tarefa sombra muda at a conexo ser
estabelecida.
|
|
|
|
A tarefa sombra est includa

no plano de produo, mas
no est livre de dependncias.
HOLD
A tarefa sombra est livre de

dependncias e est pronta
para iniciar.
READY
A tarefa sombra enviada

ao broker.
O broker processa a tarefa

sombra e envia uma solicitao
de HTTP para conect-la ao
mecanismo remoto.
Uma correspondncia com

uma instncia do fluxo de
tarefas foi localizada no plano
de longo prazo ou no plano de
pr-produo do mecanismo
remoto.
INTRO
A tarefa sombra permanece em pronto

se a estao de trabalho do mecanismo
remoto no for iniciado.
FAIL
A ligao falhou por causa do broker no poder entrar
em contato com o mecanismo remoto (ou mecanismos
remotos de backup) ou o contato com banco de dados
de mecanismo remoto no pode ser estabelecido.
WAIT
BOUND
A ligao falhou porque: - uma correspondncia com a instncia do

fluxo de tarefas no foi localizada no plano de longo prazo do
mecanismo remoto ou plano de pr-produo.
- uma correspondncia com a instncia do fluxo de tarefas no foi
localizada no plano de pr-produo ou o usurio especificado em
binduser no est autorizado a acessar a tarefa solicitada no plano
de produo.
O status da tarefa sombra torna-se:
Se voc configurar a tarefa sombra para
ERROR Complete if bind fails=N.
SUCC
|
|
|
|
|
|
Se voc configurar a tarefa sombra para

Complete if bind fails=Y.
Figura 31. Transio de Status da Tarefa Sombra at a Conexo Ser Estabelecida
Como para qualquer outra tarefa, o status inicial da tarefa sombra HOLD e muda
para READY quando a tarefa for liberada de dependncias e estiver pronta para
iniciar.
|
|
|
|
|
|
O planejador envia ento uma solicitao HTTP para o mecanismo remoto que
contm as informaes para identificar a tarefa sombra no plano de produo local
e as informaes para identificar de forma exclusiva a instncia da tarefa remota
para conectar ao plano do mecanismo remoto, incluindo os critrios de
correspondncia. O planejador tambm deve ser notificado sobre o status da
instncia da tarefa remota conectada.
|
|
|
|
|
|
|
O planejador tenta entrar em contato com o mecanismo remoto, em intervalos

regulares, at que um tempo limite especfico expire. Se, at l, o mecanismo
remoto no puder ter sido atingido, o status da tarefa sombra configurado para
FAIL. Para alterar o tempo limite e o intervalo, especifique um valor, em segundos,
tanto para MaxWaitingTime quanto StatusCheckInterval no arquivo
TDWB_HOME/config/ResourceAdvisorConfig.properties e, em seguida, reinicie o
broker.
|
|
|
Se o plano de pr-produo no existir no mecanismo remoto quando a solicitao

de conexo for recebida, o status da tarefa sombra distribuda permanece WAIT at
a gerao do plano de pr-produo ser concluda e a solicitao de conexo ser
574
|
|
processada. Isso pode ocorrer, por exemplo,quando o plano de pr-produo for

criado novamente desde o incio no mecanismo remoto.
|
|
|
Para obter informaes adicionais sobre a razo de o status da tarefa sombra ser
FAIL, consulte Como Ver Por que o Status da Tarefa Sombra FAIL na pgina
581.
|
|
|
|
|
Quando o mecanismo remoto receber a solicitao HTTP, ele tenta identificar a

instncia do fluxo de tarefas a ser usado para a conexo em seu plano; o plano de
pr-produo, se o mecanismo remoto for distribudo, ou o plano de longo prazo,
se o mecanismo remoto for z/OS. A definio do fluxo de tarefa deve conter a
definio da tarefa remota a conectar.
|
|
|
Para obter informaes adicionais sobre como a correspondncia feita em um

plano de mecanismo remoto distribudo, consulte Como uma Tarefa Sombra
Distribuda Conectada.
|
|
|
Para obter informaes adicionais sobre como a correspondncia feita em um

plano de mecanismo remoto z/OS, consulte Como uma Tarefa Sombra do z/OS
Conectada na pgina 576.
|
|
|
|
|
|
|
|
Como uma Tarefa Sombra Distribuda Conectada
|
|
|
|
O intervalo de correspondncia, exceto para os critrios de correspondncia

anteriores mais prximos que no requerem clculo de intervalo, calculado no
mecanismo remoto usando as configuraes especificadas na definio de tarefa
sombra distribuda.
|
|
|
Por exemplo, quando os critrios de correspondncia sameDay so especificados, o

dia que referido o dia especificado no mecanismo remoto em termos de
[startOfDay, startOfDay+23:59].
|
|
|
Ao usar um critrio de correspondncia baseado em intervalo, a solicitao HTTP

enviada ao mecanismo remoto contm as informaes a seguir para permitir que o
mecanismo remoto calcule o intervalo de correspondncia:
|
|
|
|
|
Para critrios de correspondncia do intervalo absoluto:

Os valores hhmm, HHMM e, opcionalmente, d e D, especificados na clusula:
Se o mecanismo remoto for um gerenciador de domnio principal ou um

gerenciador do domnio principal de backup do Tivoli Workload Scheduler, a
procura pela instncia da tarefa remota para conectar feita no plano de
pr-produo. Instncias de tarefas remotas distribudas, pertencentes aos fluxos de
tarefas JOBS ou USERJOBS, no esto envolvidas no processo de conexo. Todavia,
as tarefas remotas que foram movidas para USERJOBS aps a ligao continuam a
enviar notificaes de mudana de status.
<dshadow:matching>
<dshadow:absolute from="hhmm [+/-d day[s]]" to="HHMM [+/-D day[s]]"/>
</dshadow:matching>
Valores limites so hhmm -6 days e HHMM +6 days.
|
|
O fuso horrio usado para os critrios de correspondncia o fuso horrio

da tarefa sombra.
|
|
|
Para critrios de correspondncia relativos:

O horrio planejado da tarefa sombra e os valores [hh]hmm e [HH]HMM
especificados na clusula:
575
|
|
|
<dshadow:matching>
<dshadow:relative from="+/-[hh]hmm" to="+/-[HH]HMM"/>
</dshadow:matching>
Valores limites so +/-167:59 horas.

Por exemplo, para criar uma tarefa sombra que corresponda a uma instncia da
tarefa remota cujo Primeiro incio 17 de novembro s 2h, possvel especificar
um dos dois critrios de correspondncia a seguir:
v Mesma data planejada
v Dentro de um intervalo absoluto especificando como um deslocamento: 1 dia
Antes do primeiro horrio de incio.
|
|
|
|
|
|
|
Dia do processamento do
plano local: das 6hs s 6h
Tarefa Sombra executada
Incio antecipado
17 de novembro s 3h
Mecanismo local
17 de novembro
3:00
06:00
06:00
Tarefa Remota
Incio antecipado
17 de novembro s 2h
Mecanismo Remoto
2:00
17 de novembro
00:00
00:00
Dia do processamento do
plano remoto: das 0h s 0h
|
|
|
|
|
|
A instncia da tarefa remota a corresponder identificada no mecanismo remoto

de acordo com as regras determinadas para dependncias de sequncias externas.
Para obter detalhes adicionais sobre critrios de resoluo de dependncias de
sequncias externas, consulte Gerenciando Dependncias de Acompanhamentos
Externos para Tarefas e Fluxos de Tarefas na pgina 57.
|
|
Para obter informaes adicionais sobre como definir tarefas sombra, consulte
Definio de tarefa na pgina 155.
|
|
|
Como uma Tarefa Sombra do z/OS Conectada

Se o mecanismo remoto for um controlador do Tivoli Workload Scheduler para
z/OS, a procura para a instncia remota a conectar feita da seguinte forma:
v Primeiro, a instncia procurada no Long Term Plan (LTP) na parte do intervalo
de conexo que segue o horrio de encerramento do Current Plan (CP) e
precede o horrio planejado da tarefa sombra.
|
|
|
|
|
v Se nenhuma instncia for localizada, a instncia procurada no CP na parte do

intervalo de conexo que precede o fim do plano atual.
|
|
|
|
Nota: Se o controlador remoto receber uma solicitao de conexo com uma URI
de notificao de cliente que no est definida entre os destinos HTTP, a
solicitao de conexo descartada e a mensagem EQQHT62W registrada
em log em MLOG.
|
|
|
|
|
|
As sees a seguir descrevem os cenrios que podem ocorrer ao conectar uma

tarefa sombra do z/OS que tem:
Nas figuras:
v Horrio planejado: 18h

v Informaes de tarefa remota:
ID do aplicativo: JS2
Nmero da operao: OP2
576
|
|
|
|
|
|
v A caixa branca indica o intervalo de tempo coberto pelo LTP.

v A caixa cinza clara indica o intervalo de tempo coberto pelo CP.
v A caixa cinza escura indica o intervalo no plano do mecanismo remoto durante
o qual a instncia da tarefa a conectar deve ser procurada.
v A ocorrncia de JS2 destacada em negrito a instncia selecionada para a
conexo.
|
|
|
|
Cenrio 1: O intervalo do CP contm o horrio planejado da tarefa sombra e

existem ocorrncias de J2S.
Figura 32mostra, destacada em negrito, a instncia JS2 que precede de
JS2
16h
JS2
17h
JS2
19h
Intervalo de conexo
18:00
Intervalo do plano atual

Intervalo do plano de longo prazo
|
|
|
Figura 32. Instncia a ser Conectada se o Horrio Planejado da Tarefa Sombra Estiver
Includo no Intervalo do CP
|
|
|
|
|
|
|
forma mais prxima o horrio planejado da tarefa sombra. Essa instncia

selecionada para a conexo, pois o horrio planejado est contido no CP. A
tarefa sombra e a instncia da tarefa remota so associadas. Se,
posteriormente, uma nova instncia de JS2 que precede de forma mais
prxima o horrio planejado da tarefa sombra enviada ad hoc no plano
do mecanismo remoto, a correspondncia com a instncia JS2 selecionada
para a conexo no modificada.
Neste momento, uma das situaes a seguir pode ocorrer:
|
|
|
|
|
|
A instncia JS2 selecionada contm OP2.

A conexo com OP2 pertencente a JS2 estabelecida e uma
notificao contendo:
v As informaes de tarefa remota que identificam a instncia OP2
no plano de mecanismo remoto
v O status atual dessa instncia OP2
|
|
|
enviado de volta, a instncia da tarefa sombra atualizada com

as informaes da tarefa remota e seu status atualizado conforme
necessrio.
|
|
|
|
|
|
A instncia JS2 selecionada no contm mais OP2, pois foi excludo e um

plano dirio o remover do CP ou nunca esteve contido em J2S.
A conexo falha. Uma notificao informando que a conexo
falhou enviada de volta e o status da tarefa sombra atualizado
de acordo com o que voc configurar no campo Complete if bind
fails.
|
|
|
A instncia JS2 selecionada contm OP2 que foi excludo, mas que ainda
no foi removido do CP.
A conexo estabelecida e uma notificao informando sobre o
577
status de execuo bem-sucedido enviado de volta. A instncia

da tarefa sombra marcada como SUCC. Suas sucessoras podem
iniciar.
|
|
|
Cenrio 2: O intervalo do plano atual contm o horrio planejado da tarefa

sombra, a instncia JS2 que precede de forma mais prxima o horrio planejado
da tarefa sombra existe no LTP, mas foi cancelado no CP.
|
|
|
|
|
JS2
16h
JS2
17h
JS2
19h
Intervalo de conexo
18:00

|
|
|
Figura 33. Instncia a Ser Conectada se a Instncia que Precede de Forma Mais Prxima o
Horrio Planejado da Tarefa Sombra Existe no LTP, mas Foi Cancelado no CP
|
|
A Figura 33 mostra, destacado em negrito, a instncia JS2 selecionada para

a conexo, pois a ocorrncia que melhor correspondia foi excluda.
|
|
|
|
|
A conexo com OP2 pertencente a JS2 estabelecida e uma notificao

contendo:
v O status atual dessa instncia OP2
|
|
|
enviado de volta, a instncia da tarefa sombra atualizada com as

informaes da tarefa remota e seu status atualizado conforme
necessrio.
v As informaes de tarefa remota que identificam a instncia OP2 no

plano de mecanismo remoto
Cenrio 3: O intervalo do CP contm o horrio planejado da tarefa sombra, mas

no existe nenhuma ocorrncia de J2S.
|
|
|
|
JS2
19h
Intervalo de conexo
18:00

|
|
|
Figura 34. O Horrio Planejado da Tarefa Sombra Est Includo no CP, mas No Existe
Nenhuma Instncia para Conectar
A Figura 34 mostra que uma instncia JS2 que precede de forma prxima o
horrio planejado da tarefa sombra no existe.
|
|
578
|
|
|
|
|
|
|
A conexo falha. Uma notificao informando que a conexo falhou

enviada de volta e o status da tarefa sombra atualizado de acordo com o
que voc configurar no campo Complete if bind fails.
Cenrio 4: O intervalo do LTP contm o horrio planejado da tarefa sombra e o
CP ainda no inclui a instncia JS2 que precede de forma mais prxima.
JS2
17h
JS2
16h
JS2
19h
Intervalo de conexo
Intervalo do
plano atual
18:00

|
|
|
|
|
|
|
|
|
|
|
Figura 35. A Instncia a Ser Conectada Existe, mas Ainda No Est Includa no CP
A Figura 35 mostra a instncia JS2 que pode ser associada tarefa sombra,
apesar de a tarefa JOB2 ainda no estar no CP.
Uma notificao informando de que a conexo est estabelecida enviada
de volta e o status da tarefa sombra configurado para BOUND.
Cenrio 5: O intervalo do LTP ainda no contm o horrio planejado da tarefa
sombra.
JS2
16h
JS2
17h
Intervalo de conexo
18:00
Intervalo do plano de
longo prazo
|
|
|
|
|
|
|
Figura 36. O Intervalo do LTP Ainda No Contm o Horrio Planejado da Tarefa Sombra
A Figura 36 mostra que nenhuma instncia JS2 pode ser associada tarefa
sombra, pois at o LTP incluir o horrio planejado da tarefa sombra,
instncias JS2 que precedem de forma mais prxima ainda podem ser
includas.
|
|
|
Nesse caso, a solicitao de conexo colocada em espera at o LTP ser

estendido para incluir o horrio planejado da tarefa sombra. At l, o
status da tarefa sombra permanece WAIT.
Como o Status da Tarefa Sombra Muda aps a Conexo Ser

Estabelecida
|
|
|
Quando uma conexo estabelecida, o mecanismo remoto envia de volta uma

notificao HTTP que contm o status da conexo e, se a conexo tiver sido
579
|
|
|
bem-sucedida, as informaes para identificar a instncia da tarefa remota

conectada. Essas informaes so mostradas nos detalhes da instncia da tarefa
sombra.
|
|
Dependendo do tipo de um mecanismo remoto, as informaes a seguir sobre a

instncia da tarefa remota so mostradas nas propriedades da tarefa sombra:
|
|
O tipo de mecanismo remoto distribudo

v Nome do Fluxo de Job
v Horrio planejado
v Estao de trabalho do fluxo de tarefas
|
|
|
v Nome da tarefa
O tipo de mecanismo remoto z/OS
|
|
|
|
|
v ID da Aplicao
v Horrio planejado
v Nmero da operao
v Estao de Trabalho
v Nome da tarefa, se tiver sido definido no mecanismo remoto.
Quando a instncia da tarefa sombra for mapeada para uma instncia da tarefa
remota existente, notificaes sobre mudanas de status da tarefa so enviadas de
forma assncrona do mecanismo remoto. Essas notificaes so usadas para mapear
a transio de status da tarefa remota para a transio de status da tarefa sombra.
O mecanismo de armazenamento e encaminhamento assegura a entrega das
mensagens e a recuperao em caso de falhas. A Figura 37 mostra como o status de
uma tarefa sombra distribuda muda, de quando uma conexo estabelecida at o
status da tarefa sombra se tornar SUCC ou ERROR. Somente o status SUCC e
ERROR so considerados como o status final pata uma tarefa sombra.
|
|
|
|
|
|
|
|
|
|
|
Uma correspondncia com uma instncia do fluxo de

tarefas foi localizada no plano do mecanismo remoto.
Conectado
Falha na
tarefa
remota.
Falha de envio
da tarefa
remota.
Se a tarefa remota j est
concluda com sucesso ou
se foi cancelada.
Exec
Falhar
A tarefa remota
executada novamente.
Falha de envio de
nova execuo da
tarefa remota.
Encerrar de
Forma Anormal A tarefa remota
Succ
A ligao falhou por causa da

ocorrncia de uma das seguintes
situaes: -a instncia da tarefa
remota a qual se ligar no existe
no plano atual.
-a instncia da tarefa remota a
qual se ligar no existe no plano
de produo ou o usurio
especificado em bindUser no
est autorizado a acessar a i
nstncia da tarefa solicitada no
plano de produo.
Se voc configurar a tarefa

sombra para
Complete if bind fails=Y
A tarefa remota
foi concluda com
xito ou foi
cancelada.
Erro
Se voc configurar a tarefa

sombra para
Complete if bind fails=N
executada
novamente.
Falha na tarefa remota.
A tarefa remota foi cancelada.
|
|
|
Figura 37. Cadeia de Transio de Status da Tarefa Sombra aps a Conexo Ter Sido
Estabelecida
|
|
Se a instncia da tarefa remota j estiver concluda quando a correspondncia

estiver pronta, o status da tarefa sobra se torna SUCC imediatamente.
580
|
|
Para obter informaes adicionais sobre a razo de o status da tarefa sombra ser
FAIL, consulte Como Ver Por que o Status da Tarefa Sombra FAIL.
|
|
|
Quando o status da tarefa sombra satisfazer a regra de dependncia, a

dependncia da tarefa local na tarefa sombra resolvida e a dependncia cruzada
para a tarefa local na tarefa remota tambm resolvida.
Como Ver Por que o Status da Tarefa Sombra FAIL
|
|
|
O status da tarefa sombra pode ser FAIL em uma das seguintes situaes:
v O envio da tarefa sombra falhou.
v O envio da tarefa remota falhou.
|
|
|
|
Para determinar por que o status da tarefa sombra FAIL, consulte o log da tarefa
sombra executando o comando showjobs com a opo ;stdlist, ou clicando em
Log da Tarefa... para a instncia da tarefa sombra na visualizao Tarefas de
monitoramento no Tivoli Dynamic Workload Console.
|
|
Status da Tarefa Sombra durante a Recuperao ou Nova

Execuo da Tarefa Remota
|
|
|
|
Aps a conexo ser estabelecida, pode ocorrer que a tarefa remota conectada seja
executada novamente; nesse caso, o status da tarefa sombra reflete o status da
tarefa reexecutada. O status da tarefa sombra permanece EXEC enquanto a
recuperao da tarefa remota est em andamento.
|
|
O status da tarefa sombra atualizado somente quando a tarefa remota atinge um

dos estados a seguir:
|
|
ABEND
Quando a tarefa remota falha em executar.
SUCC Quando a tarefa remota falha bem-sucedida.
FAIL
|
|
|
|
possvel ver detalhes adicionais sobre a tarefa remota nas propriedades da tarefa
sombra. Para ver esses detalhes:
v Execute o comando conman showjobs com a opo props com relao tarefa
sombra.
v Acesse o painel de propriedades da tarefa sombra no Tivoli Dynamic Workload
Console.
|
|
|
Quando o envio da tarefa remota falha.
Como Transporte se Aplica a Dependncias Cruzadas
|
|
|
|
Transporte funciona da mesma forma que as tarefas sombra fazem com outros
tipos de tarefas. As tarefas sombra no status WAIT e BOUND so tratadas como
tarefas no status EXEC. As tarefas sombra ERROR so tratadas como tarefas no
status FAIL ou ABEND.
|
|
|
O status de uma tarefa sombra, conectada a uma tarefa remota que no

transportada, configurado para ERROR quando o plano de produo remoto for
estendido.
|
|
|
Nota: Como um melhor prtica, use dependncias cruzadas com fluxo de tarefas
de transporte em ambos os ambientes de planejamento distribudos local e
remoto.
581
Para obter informaes adicionais sobre a opo global carryStates, consulte o

Administration Guide.
|
|
|
|
Gerenciando Tarefas Sombra no Plano de Produo
Dependendo do status da tarefa sombra, possvel executar os comandos a seguir:
|
|
|
|
|
Eliminar
possvel efetuar kill de uma tarefa sombra com status BOUND, EXEC ou
WAIT. A associao estabelecida por meio da conexo com a tarefa remota
cancelada automaticamente e o status da tarefa sombra configurado
para ABEND com cdigo de retorno 0.
|
|
|
|
Executar Novamente
possvel executar novamente uma tarefa sombra com status ABEND,
ERROR, SUCC ou FAIL. Ao executar novamente uma tarefa sombra, uma
nova solicitao de conexo acionada.
582
Apndice A. Evento de Automao e Definies de Ao da

Carga de Trabalho Orientada a Evento
Este apndice documenta os provedores de eventos e ao que podem ser
utilizados para a automao da carga de trabalho orientada a evento e fornece
detalhes sobre as definies de eventos e aes.
Provedores e Definies de Eventos

Esta seo fornece detalhes sobre os tipos de evento dos seguintes provedores de
eventos:
v TWSObjectsMonitor
v FileMonitor
v TWSApplicationMonitor
Data/hora
Contm a data e o horrio. possvel especificar um ou ambos os valores
no filtro.
Vrios predicados de filtro permitidos
possvel especificar vrios predicados de filtro para esta propriedade. O
evento corresponder condio de evento se todos os predicados forem
satisfeitos.
Vrios valores permitidos
possvel especificar vrios valores para esta propriedade em um nico
predicado de filtro. O filtro ser satisfeito quando um dos valores for
correspondido.
Caractere curinga permitido
Os curingas suportados so o asterisco (*) e o ponto de interrogao (?).
Eventos do TWSObjectsMonitor
Os eventos do TWSObjectsMonitor so:
v JobStatusChanged
v JobUntil
v JobSubmit
v JobCancel
v JobRestart
v JobLate
v JobStreamStatusChanged
v JobStreamCompleted
v JobStreamUntil
v JobStreamSubmit
v JobStreamCancel
v JobStreamLate
v WorkstationStatusChanged
v ApplicationServerStatusChanged
v ChildWorkstationLinkChanged
v ParentWorkstationLinkChanged
v PromptStatusChanged
583
Estes eventos so gerados pelo batchman (ou mailman para as estaes de trabalho)
e gravados em um arquivo de caixa postal denominado monbox.msg. Os objetos de
planejamento so monitorados conforme a seguir:
v As tarefas so monitoradas pela estao de trabalho na qual elas so executadas
v Os fluxos de tarefas so monitorados pelo gerenciador de domnio principal
v As estaes de trabalho monitoram a si mesmas
v Os prompts locais so monitorados pela estao de trabalho que est executando
a tarefa ou o fluxo de tarefas que possui uma dependncia no prompt
v Os prompts globais so monitorados pelo gerenciador de domnio principal
Clique aqui para ver os parmetros de cada tipo de evento.
Nota: Usurios de PDF, as tabelas de parmetros acima so um arquivo de HTML
referenciado pelo PDF. Ele no est salvo localmente com o PDF do centro
de informaes. Voc deve primeiro visualiz-lo no centro de informaes
antes de salv-lo e imprimi-lo.
|
Trabalhando com eventos WorkstationStatusChanged
|
|
|
|
|
O evento enviado quando uma estao de trabalho iniciada ou interrompida.

Mas existem as seguintes diferenas operacionais dependendo do tipo de estao
de trabalho que monitorada:
v Para uma agente tolerante a falhas, o evento enviado quando a estao de
trabalho iniciada ou interrompida.
v Para uma estao de trabalho broker de carga de trabalho dinmica, o evento
tambm enviado quando ela vinculada ou quando o seu link removido
(pois esses comandos tambm iniciam ou param a estao de trabalho).
|
|
|
|
|
|
v Para uma estao de trabalho de conjunto dinmico, o evento nunca enviado

(mesmo se o hosting broker de carga de trabalho dinmica for interrompido)
porque no h monitoramento neste tipo de estao de trabalho.
Exemplos
A regra no exemplo a seguir envia o fluxo de tarefas RJS_102739750 na estao de
trabalho NC125102 assim que todas as tarefas do fluxo de tarefas RCF_307577430 da
estao de trabalho NA022502 estiverem com o status RUNNING ou SUCCESSFUL.
<eventRule name="TWS_PLAN_EVENTS_JOB_STATUS_CHANGED"
ruleType="filter" isDraft="no">
<description>Event: Job Status Changed; Action: Submit
job stream</description>
<timeZone>Europe/Rome</timeZone>
<validity from="2011-04-24" to="2012-04-24" />
<eventCondition name="jobStatChgEvt1"
<scope>* # JOBSTREAMVALUE . * [RUNNING,
SUCCESSFUL]</scope>
<value>NA022502</value>
</attributeFilter>
<value>RCF_307577430</value>
</attributeFilter>
584

<value>*</value>
</attributeFilter>
<attributeFilter name="Priority" operator="ge">
<value>10</value>
</attributeFilter>
<attributeFilter name="Monitored" operator="eq">
<value>true</value>
</attributeFilter>
<attributeFilter name="Status" operator="eq">
<value>Running</value>
<value>Successful</value>
</attributeFilter>
<attributeFilter name="Login" operator="eq">
<value>TWS_user</value>
</attributeFilter>
</eventCondition>
<action actionProvider="TWSAction" actionType="sbs"
<description>Launch an existing TWS job
stream</description>
<scope>SBS NC125102#RJS_102739750</scope>
<value>NC125102</value>
</parameter>
<value>RJS_102739750</value>
</parameter>
</action>
</eventRule>
</eventRuleSet>
A regra no exemplo a seguir envia a tarefa RJR_30411 na estao de trabalho

NC122160 assim que o fluxo de tarefas RJS_102739750 da estao de trabalho
NC125102 for enviado.
<eventRule name="TWS_PLAN_EVENTS_JOB_STREAM_SUBMITTED"
<description>Event: Job Stream Submitted; Action: Submit
job</description>
<eventCondition name="jsSubEvt1"
eventType="JobStreamSubmit">
<scope>WORKSTATIONVALUE # JOBSTREAMVALUE</scope>
</attributeFilter>
<value>RJS_102739750</value>
</attributeFilter>
<attributeFilter name="Priority" operator="range">
<value>15</value>
<value>30</value>
</attributeFilter>
<attributeFilter name="LatestStart" operator="le">
<value>2011-04-26</value>
</attributeFilter>
</eventCondition>
<action actionProvider="TWSAction" actionType="sbj"
<description>Launch an existing TWS job
stream</description>
<scope>SBJ NC122160#RJR_30411 INTO
Apndice A. Evento de Automao e Definies de Ao da Carga de Trabalho Orientada a Evento
585
NC122160#JOBS</scope>
<parameter name="JobUseUniqueAlias">
<value>true</value>
</parameter>
<parameter name="JobDefinitionName">
<value>RJR_30411</value>
</parameter>
<parameter name="JobDefinitionWorkstationName">
</parameter>
</action>
</eventRule>
</eventRuleSet>
Eventos de FileMonitor
Os eventos de FileMonitor so:
v FileCreated
v FileDeleted
v ModificationCompleted
v LogMessageWritten
|
|
|
|
|
|
|
Quando os arquivos so monitorados usando os eventos FileCreated, FileDeleted

e LogMessageWritten, a memria consumida pelos processos ssmagent.bin e
ssmagent.exe aumentam a linearidade com o nmero de arquivos monitorados e
com o nmero de eventos criados. Assim, tenha em mente que o uso mais intenso
de caracteres curingas feito dentro desses tipos de eventos, e o nmero
consequentemente mais alto de arquivos monitorados, resultar em um consumo
de memria mais intenso pelos processos ssmagent.bin e ssmagent.exe.
|
|
Eventos de FileMonitor no so suportados para agentes dinmicos, conjuntos,

conjuntos dinmicos e estaes de trabalho de mecanismo remoto.
Clique aqui para visualizar os parmetros para cada tipo de evento.
|
|
Usando a propriedade MatchExpression da regra de evento

LogMessageWritten
|
|
|
|
|
|
O plug-in de evento LogMessageWritten usa a expresso regular especificada na

propriedade MatchExpression para executar correspondncias de subsequncia em
entradas nos arquivos de log que esto sendo monitorados. O valor de
MatchExpression deve ser uma expresso regular vlida de acordo com as regras
de sintaxe de expresso regular do agente Netcool/SSM que o plug-in de eventos
usa.
|
|
|
|
|
|
A tabela a seguir descreve a sintaxe dos tokens de expresso regular suportada

pelo Netcool/SSM. Observe que para escrever uma expresso regular vlida para a
propriedade MatchExpression voc deve escrever o caractere de escape \ (barra
invertida) antes de cada token usado na sintaxe da expresso regular (por exemplo,
\^ ou \$). Quando o token j especificar um caractere de barra invertida, voc
deve escrever os caracteres de barra invertida (por exemplo, \\< ou \\b).
586
Tabela 92. Sintaxe da expresso regular.
Token
Qualquer caractere.
O incio de uma linha (uma sequncia de comprimento zero).
|
|
O final de uma linha. Uma nova linha ou o final do buffer de

procura.
|
|
\<
O incio de uma palavra (no qual uma palavra uma sequncia de

caracteres alfanumricos).
|
|
\>
O final de uma palavra (a sequncia de comprimento zero entre um

caractere alfanumrico e um caractere no alfanumrico).
\b
Qualquer limite de palavra (isto equivalente a (\<\>) ).
\d
Um caractere de dgito.
\D
Qualquer caractere que no seja um dgito.
\w
Um caractere de palavra (alfanumrico ou sublinhado).
|
|
\W
Qualquer caractere que no seja um caractere de palavra

(alfanumrico ou sublinhado).
\s
Um caractere de espao em branco.
\S
Qualquer caractere que no seja um espao em branco.
|
|
|
|
\c
Caracteres especiais ou de escape. Os caracteres a seguir so

interpretados de acordo com as convenes da linguagem C: \0, \a,
\f, \n, \r, \t, \v. Para especificar um caractere em hexadecimal, use a
sintaxe \xNN. Por exemplo, \x41 o caracter ASCII A.
|
|
|
|
Todos os caracteres separados desses descritos acima podem ser

codificados com a funo escape usando o prefixo de barra invertida.
Por exemplo, para especificar o uso de um colchete esquerdo simples
\[.
Corresponde
587
Tabela 92. Sintaxe da expresso regular. (continuao)
Token
Corresponde
|
|
|
|
|
|
|
[]
Qualquer um dos caracteres especificados em um conjunto. Um

conjunto explcito de caracteres pode ser especificado como em
[aeiou] assim como intervalos de caracteres como [0-9A-Fa-f], que
correspondem a qualquer dgito hexadecimal. O trao (-) perde seu
significado especial quando codificado com a funo escape, como em
[A\-Z] ou quando ele for o primeiro ou o ltimo caractere em um
conjunto, como em [-xyz0-9].
|
|
|
|
|
Todas as regras de escape acima com a barra invertida podem ser

usadas entre []. Por exemplo, a expresso [\x41-\x45] equivalente a
[A-D] em ASCII. Para usar um colchete de fechamento em um
conjunto, codifique-o com a funo escape usando [\]] ou utilize-o
como o primeiro caractere no conjunto, como []xyz].
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Classes de caractere estilo POSIX tambm so permitidas em um

conjunto de caracteres. A sintaxe para classes de caractere [:class:].
As classes de caractere suportadas so:
v [:alnum:] - caracteres alfanumricos.
v [:alpha:] - caracteres alfabticos.
v [:blank:] - caracteres de espao e de tabulao.
v [:cntrl:] - caracteres de controle.
v [:digit:] - caracteres numricos.
v [:graph:] - caracteres que so tanto para impresso quanto
visualizao.
v [:lower:] - caracteres alfabticos em minsculas.
v [:print:] - caracteres para impresso (caracteres que no so
caracteres de controle).
v [:punct:] - caracteres de pontuao (caracteres que no so letras,
dgitos, caracteres de controle ou espaos).
v [:space:] - caracteres de espao (como caracteres de espao, de
tabulao e de feed de formulrio).
v [:upper:] - caracteres alfabticos maisculos.
v [:xdigit:] - caracteres que so dgitos hexadecimais.
|
|
|
Os colchetes so permitidos dentro dos colchetes do conjunto. Por

exemplo, [a-z0-9!] equivalente a [[:lower:][:digit:]!] no cdigo de
idioma C.
|
|
|
|
|
[^]
Inverte o comportamento de um conjunto de caracteres [] como

descrito acima. Por exemplo, [^[:alpha:]] corresponde a qualquer
caractere que no seja alfabtico. O smbolo de circunflexo ^ apenas
possui este significado especial quando for o primeiro caractere em
um conjunto de colchetes.
|
|
{n}
Exatamente n ocorrncias da expresso anterior, em que 0 <= n <=

255. Por exemplo, a{3} corresponde a aaa.
|
|
|
{n,m}
Entre n e m ocorrncias da expresso anterior, em que 0 <= n <= m

<= 255. Por exemplo, um nmero hexadecimal de 32 bits pode ser
descrito como 0x[[:xdigit:]]{1,8}.
|
|
{n,}
Nenhuma expresso anterior ou mais de uma expresso anterior.
Uma expresso anterior ou mais expresses anteriores.
Nenhuma ou uma expresso anterior.
588
No mnimo n ou mais (at o infinito) ocorrncias da expresso

anterior.
Tabela 92. Sintaxe da expresso regular. (continuao)
Token
Corresponde
|
|
|
|
|
(exp)
Agrupamento; qualquer srie de expresses pode ser agrupada entre

parnteses para aplicao de um postfix ou um operador de barra ()
para um grupo de expresses sucessivas. Por exemplo:
|
|
|
|
|
v ab+ corresponde a todos os abbb

v (ab)+ corresponde a todos os ababab
Expresses alternativas (OR lgico). A barra vertical () tem
precedncia inferior a todos os tokens na linguagem da expresso
regular. Isso significa que abcd corresponde a todos os cd mas no
corresponde a abd (neste caso use a(bc)d ).
|
|
|
Dica: Ao definir expresses regulares para corresponderem a caracteres com

diversos bytes, envolva cada caractere com diversos bytes entre parnteses
().
|
|
|
O Tabela 93 fornece um conjunto de exemplos de expresses regulares, junto com

as sequncias de amostra assim como os resultados de aplicao da expresso
regular para essas sequncias.
|
|
|
|
|
|
|
|
|
H dois casos importantes em expresses regulares com sequncias. Uma

expresso regular pode corresponder a uma sequncia inteira (um caso conhecido
como uma correspondncia de sequncia) ou apenas a uma parte dessa sequncia (um
caso conhecido como uma correspondncia de subsequncia). Por exemplo, a
expresso regular \<int\> ir gerar uma correspondncia de sequncia para a
sequncia int x mas no ir gera uma correspondncia de sequncia. Essa
distino importante porque alguns subagentes no suportam correspondncia de
subsequncia. Onde for aplicvel, os resultados listados nos exemplos diferenciam
entre correspondncias de sequncia e subsequncia.
Tabela 93. Exemplos de expresso regular.
|
|
Esta expresso...
Aplicada a esta
sequncia...
Correspondncia de sequncia
abcdef
sequncia vazia
Resulta em...
Correspondncia de subsequncia em a
Sem correspondncia
MINCOUNT
|
|
MXXCOUNTY
Correspondncia de subsequncia em
MXXCOUNT
NONCOUNT
Sem correspondncia
M..COUNT
.*
|
|
|
.+
|
|
|
|
|
sequncia vazia
Animal
Qualquer sequncia no
vazia
sequncia vazia
Sem correspondncia
sequncia vazia
hello
A correspondncia de subsequncia de
comprimento 0 na posio 0 (posio 0 =
primeiro caractere na sequncia)
589
Tabela 93. Exemplos de expresso regular. (continuao)
|
|
Esta expresso...
Aplicada a esta
sequncia...
sequncia vazia
|
|
|
hello
^$
sequncia vazia
Resulta em...
Correspondncia de subsequncia de
comprimento 0 na posio 5 (a posio 0 =
hello
Sem correspondncia
tee
Sem correspondncia
Paid fee
Sem correspondncia
feel
Sem correspondncia
eel
Correspondncia de subsequncia em ee
\bee
.*thing.*
The thing is in here
there is a thing
it isnt here
Sem correspondncia
thinxxx
Sem correspondncia
sequncia vazia
aaaaaaaaa
aardvark
esta sequncia
Correspondncia de subsequncia
sequncia vazia
ccccccccc
ccccabcccabc
a*
((ab)*c)*
a+
sequncia vazia
Correspondncia de subsequncia em aa
Sem correspondncia
aaaaaaaaa
aardvark
esta sequncia
Sem correspondncia
sequncia vazia
ababababcabc
abab
(ab)+c)*
|
|
(ab){2}
cdabababab
[0-9]{4,}
123
a1234
a{0}
sequncia vazia
|
|
|
hello
[0-9]{1,8}
isto no um nmero
a=4238, b=4392876
590
Correspondncia de subsequncia em aa
Correspondncia de subsequncia em abab

Sem correspondncia
Correspondncia de subsequncia em 1234
Sem correspondncia
A correspondncia de subsequncia de
comprimento 0 na posio 0 (posio 0 =
Sem correspondncia
|
|
Esta expresso...
Aplicada a esta
sequncia...
([aeiou][âeiou])+
Hello
|
|
|
!!! Supacalafraglistic
Correspondncia de subsequncia em el
upacalaf
+1
-1
.1
value+1
Correspondncia de subsequncia em +1
[+-]?1
Resulta em...
Sem correspondncia
Daniel
ab
Correspondncia de subsequncia em a
abcd
efgh
abcdfgh
Correspondncia de subsequncia em abcd
BAADF00D
baadF00D
Sem correspondncia
Sem correspondncia
Sem correspondncia
abcdefgh
[0-9A-F]+
x = 1234
x = 0
|
|
x = 1234a
x = y
Sem correspondncia
|
|
x^=^ onde ^ representa

um caractere de espao
Sem correspondncia
x = \d+
Correspondncia de subsequncia em F00D
\D\d
Correspondncia de subsequncia em x =
1234
a1
a11
Correspondncia de subsequncia em a1
-9
Sem correspondncia
Sem correspondncia
aa
Sem correspondncia
4t
Sem correspondncia
591
|
|
Esta expresso...
Aplicada a esta
sequncia...
\s+
Hello_w0rld
Resulta em...
Sem correspondncia
|
|
|
Hello^^^world onde ^
representa um caractere
de espao
Correspondncia de subsequncia em ^^^

em que ^ representa um caractere de espao
|
|
|
Widget^ em que ^
de espao
Correspondncia de subsequncia em ^ em
que ^ representa um caractere de espao
|
|
^^^^^ onde ^ representa

|
|
\S+
Hello_w0rld
comprimento 11 em Hello_w0rld
|
|
|
Hello^^^world em que ^
de espao
Correspondncia de subsequncia em Hello
|
|
|
Widget^ em que ^
de espao
Widget
|
|
|
^^^^^ em que ^
de espao
Sem correspondncia
|
|
\w+
D4n_v4n Vugt
D4n_v4n
|
|
|
^^^hello em que ^
de espao
blah
x#1
Sem correspondncia
foo bar
Sem correspondncia
|
|
|
\W
Hello there
Correspondncia de subsequncia em hello
comprimento 1 na separao do caractere
de espao
aa
Sem correspondncia
Sem correspondncia
Sem correspondncia
|
|
|
^^^^444 == 5 em que ^
de espao
\w+\s*=\s*\d+
comprimento 1 no primeiro ^ em que ^
representa um caractere de espao
x = 123
count0=555
my_var=66
0101010=0
xyz = e
Sem correspondncia
delta=
Sem correspondncia
==8
Sem correspondncia
592
|
|
Esta expresso...
Aplicada a esta
sequncia...
[[:alnum:]]+
1234
|
|
|
...D4N13L
[[:alpha:]]+
Bubble
...DANI3L
69
|
|
|
[:blank:]]+
alpha^^^ând beta em
que ^ representa um
caractere de espao
Resulta em...
D4N13L
Correspondncia de subsequncia em DANI
Sem correspondncia
Correspondncia de subsequncia em ^^^^
Animal
Sem correspondncia
sequncia vazia
Sem correspondncia
|
|
|
[[:space:]]+
alpha^^^ând beta em
que ^ representa um
caractere de espao
Correspondncia de subsequncia em ^^^^

Animal
Sem correspondncia
sequncia vazia
Sem correspondncia
...Hello W0rld!
Sem correspondncia
sequncia vazia
Sem correspondncia
[[:cntrl:]]+
|
|
[[:graph:]]+
hello world
Correspondncia de subsequncia em hello
|
|

Sem correspondncia
|
|
|
^^^!? em que ^
de espao
Correspondncia de subsequncia em !?
[:lower:]]+
Animal
Correspondncia de subsequncia em nimal
ABC
Sem correspondncia
0123
Sem correspondncia
foobar
|
|
|
^^^0blaH! em que ^
de espao
[_[:lower:]]+
|
|
foo_bar
this_thinG!!!
[[:upper:]]+
SIM
#define MAX 100
f00 b4r
[[:print:]]+
|
|
|
|
[[:punct:]]+
Correspondncia de subsequncia em bla
Correspondncia de subsequncia em _thin
Correspondncia de subsequncia em MAX
Sem correspondncia
hello world

didnt
Animal
Sem correspondncia
593
|
|
Esta expresso...
Aplicada a esta
sequncia...
[[:xdigit:]]+
43298742432392187ffe
Resulta em...
|
|
x = bAAdF00d
bAAdF00d
|
|
4327afeffegokpoj
4327afeffe
|
|
c:\\temp
c:\temp
Exemplo
A regra no exemplo a seguir envia um e-mail a uma lista de destinatrios assim

que o arquivo /home/book.txt for criado na estao de trabalho editor_wrkstn.
<eventRule name="FILE_MONITOR_FILE_CREATED" ruleType="filter"
isDraft="no">
<description>Event: File Created; Action: Send
mail</description>
<validity to="2012-04-22" />
<eventCondition name="fileCrtEvt1"
eventProvider="FileMonitor" eventType="FileCreated">
<scope>/HOME/BOOK.TXT ON EDITOR_WRKSTN</scope>
<attributeFilter name="FileName" operator="eq">
<value>/home/book.txt</value>
</attributeFilter>
<value>60</value>
</attributeFilter>
<value>editor_wrkstn</value>
</attributeFilter>
<attributeFilter name="Hostname" operator="eq">
<value>ceditor</value>
</attributeFilter>
</eventCondition>
<action actionProvider="MailSender" actionType="SendMail" responseType="onDetection">
<description>Send an eMail</description>
<scope>SAUL.FELLOW@US.IBM.COM, ISAAC.LINGER@US.IBM.COM
: THE EXPECTED FILE
HAS BEEN CREATED!</scope>
<parameter name="Cc">
<value>william.waulkner@us.ibm.com</value>
</parameter>
<parameter name="Bcc">
<value>ernest.demingway@us.ibm.com</value>
</parameter>
<parameter name="Body">
<value>The expected file was created!
The book is ready to be published.</value>
</parameter>
<value>saul.fellow@us.ibm.com,
isaac.linger@us.ibm.com</value>
</parameter>
<value>The expected file was created!</value>
</parameter>
</action>
</eventRule>
</eventRuleSet>
594
Eventos do TWSApplicationMonitor
Eventos do TWSApplicationMonitor referem-se a processos, sistema de arquivos e
caixa de mensagens do Tivoli Workload Scheduler. So eles:
v MessageQueuesFilling
v TivoliWorkloadSchedulerFileSystemFilling
v TivoliWorkloadSchedulerProcessNotRunning
Clique aqui para ver os parmetros de cada tipo de evento.
Exemplo
A regra no exemplo a seguir faz o log da mensagem de aviso LOGMSG01W assim que
os arquivos de fila de mensagens intercom ou mailbox na estao de trabalho
NC122160 atingirem 70 por cento de seu tamanho.
<eventRule name="TWS_APPL_MONITOR_MESSAGE_QUEUES_FILLING"
<description>Event: Message queues filling; Action:
Message logger</description>
<timeZone>America/Los_Angeles</timeZone>
<validity from="2011-04-25"/>
<activeTime end="17:00:00"/>
<eventCondition name="twsMesQueEvt1"
eventProvider="TWSApplicationMonitor"
eventType="TWSMessageQueues">
<scope>INTERCOM, MAILBOX FILLED UP 70% ON
NC122160</scope>
<attributeFilter name="MailboxName" operator="eq">
<value>intercom</value>
<value>mailbox</value>
</attributeFilter>
<attributeFilter name="FillingPercentage"
operator="ge">
<value>70</value>
</attributeFilter>
</attributeFilter>
<value>60</value>
</attributeFilter>
</eventCondition>
<action actionProvider="MessageLogger" actionType="MSGLOG"
<description>Escreve um log de mensagens de
aviso</description>
<scope>OBJECT=LOGMSG01W MESSAGE=MAILBOX AND/OR
INTERCOM QUEUE
HAS REACHED 70% OF FILLING</scope>
<parameter name="ObjectKey">
<value>LOGMSG01W</value>
</parameter>
<parameter name="Message">
<value>Caixa de correio e/ou fila de
Intercomunicao atingiu 70% de preenchimento</value>
<parameter name="Severity">
595
<value>Aviso</value>
</action>
</eventRule>
</eventRuleSet>
Provedores e Definies de Ao
Esta seo fornece detalhes sobre os tipos de ao dos seguintes provedores de
ao:
v TECEventForwarder
v MailSender
v MessageLogger
v TWSAction
v GenericAction
Aes do TECEventForwarder
Este provedor implementa uma nica ao denominada TECFWD que redireciona o
evento para um servidor TEC (Tivoli Enterprise Console) externo (ou qualquer
outro aplicativo capaz de atender os eventos no formato do TEC). O provedor
utiliza um servidor TEC padro cujo nome do host e porta podem ser definidos
com o optman. O TEC utilizado como destinatrio pode ser substitudo pelas
configuraes de ao.
Clique aqui para ver os parmetros de TECFWD.
Nota: Usurios de PDF, a tabela de parmetros acima um arquivo de HTML
Aes de MailSender
Este provedor implementa uma nica ao chamada SendMail que se conecta a um
servidor SMTP para enviar um e-mail. possvel utilizar optman para customizar
os seguintes atributos relacionados:
v Emissor de correio
v Servidor SMTP
v Nmero da porta SMTP
v Nome do usurio de correio
v Senha do usurio de correio
v SSL
Clique aqui para enviar os parmetros de SendMail.
Aes de MessageLogger
Este provedor implementa uma nica ao denominada MSGLOG que registra a
ocorrncia de uma situao em um banco de dados de auditoria interno. O nmero
596
de entrada no banco de dados de auditoria configurvel. Existe uma limpeza

automtica baseada em uma poltica FIFO.
Clique aqui para ver os parmetros de MSGLOG.
Aes de TWSAction
As aes de TWSAction so:
v SubmitJobStream
v SubmitJob
v SubmitAdHocJob
v ReplyPrompt
Clique aqui para ver os parmetros de cada tipo de ao.
|
|
Usando a propriedade SchedTimeResolutionCriteria da ao

SubmitJob
|
|
|
|
Esta propriedade usada para corresponder a tarefa na questo com uma instncia
especfica do fluxo de tarefas que a contm (definida com a propriedade
JobStreamName) com base no tempo planejado no fluxo de tarefas. Os valores
possveis que podem ser configurados so:
|
|
|
Anterior
A tarefa enviada com a instncia do fluxo de tarefas anterior mais
prximo no plano.
|
|
|
Prxima
A tarefa enviada com a instncia do fluxo de tarefas seguinte mais
prximo no plano.
|
|
|
Qualquer
A tarefa enviada com qualquer das instncias do fluxo de tarefas anterior
mais prximo ou seguinte mais prximo no plano.
Aes de GenericAction
Este provedor implementa uma nica ao denominada RunCommand que executa
comandos no-Tivoli Workload Scheduler. Os comandos so executados no mesmo
computador em que o processador de eventos executado.
Somente TWS_user est autorizado a executar o comando.
Importante: Quando o comando inclui redirecionamento de sada (embora o uso
de um ou dois sinais de >), insira o comando em um arquivo
executvel e configure o nome do arquivo como o argumento da
propriedade Command.
597
Clique aqui para ver os parmetros de RunCommand.

Exemplo
A regra no seguinte exemplo executa o comando ps -ef para listar todos os
processos em execuo no momento em uma estao de trabalho UNIX quando
um parmetro invlido for encontrado nessa estao de trabalho. Observe que a
regra baseada em um evento customizado desenvolvido usando o provedor de
eventos GenericEventPlugIn. Para obter informaes adicionais sobre tipos de
eventos customizados de desenvolvimento, consulte Definindo Eventos
Customizados na pgina 132.
<eventRule name="CUSTOM_EVENT_GENERIC_EVENT" ruleType="filter"
isDraft="yes">
<description>Event: Generic Event; Action: Run
Command</description>
<activeTime start="08:30:00" end="17:30:00"/>
<eventCondition name="genericEvt3"
eventProvider="GenericEventPlugIn"
eventType="Event1">
<scope>INVALID PARAMETER ON
WORKSTATIONVALUE</scope>
<attributeFilter name="Param1" operator="ne">
<value>Invalid Parameter</value>
</attributeFilter>
<value>WorkstationValue</value>
</attributeFilter>
</eventCondition>
<action actionProvider="GenericActionPlugin"
actionType="RunCommand"
<description>Run a command</description>
<scope>PS -EF</scope>
<parameter name="Command">
<value>ps -ef</value>
</parameter>
<parameter name="WorkingDir">
<value>/home</value>
</parameter>
</action>
</eventRule>
</eventRuleSet>
598
Apndice B. Referncia do Esquema Job Submission

Description Language
Essa seo de referncia especifica a semntica e estrutura de Job Submission
Description Language (JSDL) que se aplicam especificamente para uso com o
Dynamic Workload Broker. O esquema JSDL usado para descrever vos requisitos
de tarefa para envio para recursos. O Dynamic Workload Broker analisa o
ambiente de TI e designa o melhor recurso disponvel para executar a tarefa, com
base nos requisitos especificados.
Introduo
Job Submission Description Language (JSDL) uma linguagem para descrever os
requisitos de tarefa para envio para recursos. A linguagem JSDL contm um
vocabulrio e esquema XML normativo que facilita a expresso desses requisitos
como um conjunto de elementos XML.
Arquivos JSDL seguem a sintaxe e semntica XML, conforme definido no esquema
JSDL.
Estrutura do Documento Job Submission Description Language

Um arquivo JSDL descrito usando a sintaxe XML e segue a sintaxe e semntica
XML. A sintaxe XML um padro de mercado e no e explicado neste manual. O
arquivo JSDL tambm segue regras de sintaxe JSL especficas, conforme explicado
em Tipos de Elementos Job Submission Description Language na pgina 602 e
em Elementos JSDL na pgina 605.
O arquivo JSDL consiste em elementos (complexos ou simples) e tipos. Elementos
complexos contm outros elementos enquanto que elementos simples no contm
nenhum outro elemento. Uma especificao de tipo executa uma verificao de
sintaxe no valor especificado para o elemento ao qual se refere. Por exemplo, o
elemento physicalMemory segue o tipo jsdl:NumericRangeType. O tipo
jsdl:NumericRangeType especifica que possvel designar a esse elemento um
valor numrico especfico ou um valor de intervalo numrico. Nenhum outro tipo
de valor suportado para o elemento physicalMemory.
O arquivo JSDL organizado em uma estrutura hierrquica, em que o elemento
jobDefinition o elemento-raiz. O elemento jobDefinition contm todos os
elementos que descrevem a tarefa e seus atributos.
A definio de pseudo esquema tem a seguinte aparncia:
< jobDefinition >
<annotation ... />?
<category>... />*
<variables ... />?
<application ... />
<resources ... />?
<relatedResources ... />*
<optimization ... >?
<scheduling ...>?
</jobDefinition>
599
A Tabela 94 fornece uma visualizao de tabela do arquivo JSDL indicando os

relacionamentos hierrquicos entre os elementos contidos no elemento
jobDefinition.
Tabela 94. Estrutura Hierrquica do Aqruivo JSDL
Primeiro nvel
Segundo nvel
Terceiro nvel
Quarto nvel
annotation
category
variables
stringVariable
uintVariable
doubleVariable
aplicativo
script
argumentos
valor
environment
nome da varivel
credencial
username
groupname
password
j2ee
invoker
tipo
jms
connFactory
destino
message
ejb
jndiHome
credencial
userName
password
JAASalias
600
Tabela 94. Estrutura Hierrquica do Aqruivo JSDL (continuao)

Primeiro nvel
Segundo nvel
Terceiro nvel
recursos
candidateHosts
hostName
candidateCPUs
cpu
Quarto nvel
speed
physicalMemory
virtualMemory
candidateOperating
Systems
operatingsystems
fileSystem
logicalResource
grupo
propriedades
e
ou
requirement
ou
e
ou
requirement
requirement
e
ou
requirement
allocation
relacionamento
candidateResources
(reservado para uso
interno)
relatedResources
endpointReference
(reservado para uso
interno)
logicalResource
grupo
propriedades
e
ou
requirement
ou
e
ou
requirement
requirement
e
ou
requirement
allocation
relacionamento
candidateResources
(reservado para uso
interno)
optimization
endpointReference
(reservado para uso
interno)
objective
ewlm
Apndice B. Referncia do Esquema Job Submission Description Language
601
Tabela 94. Estrutura Hierrquica do Aqruivo JSDL (continuao)

Primeiro nvel
Segundo nvel
programando
maximumResource
WaitingTime
Terceiro nvel
Quarto nvel
action
parmetros
estimatedDuration
prioridade
recoveryActions
credencial
tpmaddress
workflow
A sintaxe JSDL usa convenes de estilo BNF para elementos e atributos:

?
Indica que o elemento ou o atributo opcional e pode ser especificado

uma vez.
Indica que o elemento ou o atributo opcional e pode ser especificado

zero ou mais vezes.
Indica que o elemento ou o atributo necessrio e pode ser especificado

uma ou mais vezes.
[...]
Indica que os elementos ou atributos contidos entre colchetes formam um

grupo.
Indica que dois ou mais elementos ou atributos so mutuamente

exclusivos.
Tipos de Elementos Job Submission Description Language

A especificao JSDL usa diversos tipos de Esquemas XML padro. Tambm usa
diversos tipos especficos na descrio de requisitos de tarefas.
Ambos os tipos executam uma verificao de sintaxe no valor que pode ser
designado a cada elemento no arquivo JSDL. Por exemplo, o elemento
physicalMemory segue o tipo jsdl:NumericRangeType. O tipo
jsdl:NumericRangeType especifica que possvel designar a esse elemento um
valor numrico especfico ou um valor de intervalo numrico. Nenhum outro tipo
de valor suportado para o elemento physicalMemory.
Tipos de esquemas XML normativos
A especificao JSDL adota os tipos de esquemas XML (xsd) normativos listados
abaixo. A sintaxe XML um padro de mercado e no e explicado neste manual.
v xsd:any
v xsd:anyURI
v xsd:boolean
v xsd:double
v xsd:DoubleVariableType
v xsd:duration
v xsd:IDREF
v xsd:NCName
v xsd:PriorityType
602
v
v
v
v
xsd:QName
xsd:string
xsd:unsignedInt
xsd:UnsignedIntVariableType
Tipos de JSDL
Os tipos a seguir so especficos da sintaxe JSDL:
StringVariableExpressionType
Um tipo de expresso de varivel de sequncia um tipo simples no qual
possvel especificar uma expresso varivel que pode conter uma ou
mais referncias variveis, como ${var}, qualquer caractere e qualquer
sequncia. Segue o esquema de sintaxe para esse tipo:
<...>
<xsd:simpleType name="StringVariableExpressionType">
<xsd:union>
<xsd:simpleType>
<xsd:restriction base=xsd:string />
</xsd:simpleType>
<xsd:simpleType>
<xsd:restriction base=xsd:string>
<xsd:pattern
value=".*\t*\r*\n*((\$\{[a-zA-Z_]+
[0-9a-zA-Z_\.\-]*\})+[^\{]*[.\n]*)+" />
</xsd:restriction>
</xsd:simpleType>
</xsd:union>
</xsd:simpleType>
</...>
DoubleVariableExpressionType
Um tipo de expresso de varivel dupla um tipo simples no qual
possvel especificar uma expresso varivel que pode conter uma
referncia varivel, como ${var}, ou um valor duplo. Segue o esquema de
sintaxe para esse tipo:
<...>
<xsd:simpleType name="DoubleVariableExpressionType">
<xsd:union>
<xsd:simpleType>
<xsd:restriction base=xsd:double />
</xsd:simpleType>
<xsd:simpleType>
<xsd:pattern value="[\n\r\t ]*($\{[a-zA-Z_]+
[0-9a-zA-Z_\.\-]*\})[\n\r\t ]*" />
</xsd:restriction>
</xsd:simpleType>
</xsd:union>
</xsd:simpleType>
</...>
UnsignedIntVariableExpressionType
Um tipo de expresso de varivel no assinada um tipo simples no qual
possvel especificar uma expresso varivel que pode conter uma
referncia varivel, como ${var}, ou um valor de nmero inteiro no
assinado. Segue o esquema de sintaxe para esse tipo:
<...>
<xsd:simpleType name="UnsignedIntVariableExpressionType">
<xsd:union>
<xsd:simpleType>
603
<xsd:restriction base=xsd:unsignedInt />

</xsd:simpleType>
<xsd:simpleType>
<xsd:pattern value="[\n\r\t ]*($\{[a-zA-Z_]+
[0-9a-zA-Z_\.\-]*\})[\n\r\t ]*" />
</xsd:restriction>
</xsd:simpleType>
</xsd:union>
</xsd:simpleType>
</...>
NotEmptyStringVariableExpressionType
Um tipo de expresso de varivel de sequncia um tipo simples que
permite a especificao de uma expresso de varivel que pode conter uma
ou mais referncias de varivel, como ${var}, opcionalmente em associao
com qualquer caractere ou com uma sequncia simples. Essa expresso de
varivel no pode estar vazia. Segue o esquema de sintaxe para esse tipo:
<xsd:simpleType name="NotEmptyStringVariableExpressionType">
<xsd:union>
<xsd:simpleType>
<xsd:minLength value="1"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType>
<xsd:pattern
value=".*\t*\r*\n*((\$\{[a-zA-Z_]+
[0-9a-zA-Z_\.\-]*\})+[^\{]*[.\n]*)+" />
</xsd:restriction>
</xsd:simpleType>
</xsd:union>
</xsd:simpleType>
NumericRangeOnlyType
Um valor de intervalo numrico um tipo complexo que permite a
definio de intervalos e faixas maiores, menores ou contidos dentro do
valor especificado. Todos os nmeros fornecidos so expresses de
variveis duplas. Segue o esquema de sintaxe para esse tipo:
<...>
<minimum>jsdl:DoubleVariableExpressionType</minimum> ?
<maximum> jsdl:DoubleVariableExpressionType</maximum> ?
</...>
NumericRangeType
Um valor de intervalo numrico um tipo complexo que permite a
definio de valores ou intervalos exatos. Todos os nmeros fornecidos so
expresses de variveis duplas. Segue o esquema de sintaxe para esse tipo:
<...>
<exact>jsdl:DoubleVariableExpressionType</exact> |
<range>jsdl:NumericRangeOnlyType</range>
</...>
StringRangeOnlyType
Um valor de intervalo de sequncia um tipo complexo que permite a
definio de intervalos e faixas maiores, menores ou contidos dentro do
valor especificado. Todos os nmeros e sequncias fornecidos so
expresses de variveis de sequncia. Segue o esquema de sintaxe para
esse tipo:
604
<...>
<minimum>jsdl:StringVariableExpressionType</minimum> ?
<maximum>jsdl:StringVariableExpressionType</maximum> ?
</...>
StringRangeType
Um valor de intervalo de sequncia um tipo complexo que permite a
definio de valores exatos como expresses de variveis de sequncia ou
intervalos que podem ser aplicados a tipos de nmero inteiro ou
sequncia. Segue o esquema de sintaxe para esse tipo:
<...>
<exact>jsdl:StringVariableExpressionType</exact> |
<range>jsdl:StringRangeOnlyType</range>
</...>
Elementos JSDL
O elemento principal JSDL configurado contm a semntica para elementos
definidos por JSDL.
O arquivo JSDL consiste em elementos (complexos ou simples) e tipos. Elementos
complexos contm outros elementos enquanto que elementos simples no contm
nenhum outro elemento. Uma especificao de tipo executa uma verificao de
sintaxe no valor especificado para o elemento ao qual se refere.
Segue uma lista dos elementos contidos na sintaxe JSDL:
Elemento jobDefinition
Definio
Esse elemento descreve a tarefa e seus requisitos. o elemento-raiz do
documento JSDL. Este atributo requerido.
Tipo
O tipo desse elemento jsdl:JobDefinitionType. Ele pode conter os

elementos a seguir:
v annotation
v category
v variables
v aplicativo
v recursos
v relatedResources
v optimization
v programando
Attributes
name
O nome da tarefa especificado pelo usurio. O tipo desse atributo

xsd:NCName. O nome deve comear com um caractere alfabtico e
pode conter sublinhados ( _ ), sinais de menos (-) e pontos (.).
Espaos, caracteres especiais, caracteres acentuados e nmeros no
so suportados. Este atributo requerido. O nome definido para
esse campo identifica exclusivamente a definio de tarefa ao ser
salva no banco de dados do Repositrio de Tarefas. Aps salvar a
definio de tarefa no banco de dados, possvel enviar a
definio de tarefa usando o Dynamic Workload Console ou a
linha de comandos.
605
description
Uma sequncia especificando uma descrio curta da definio de
tarefa. O tipo desse atributo xsd:string. Este atributo opcional.
targetNamespace
Uma URI especificando o namespace de destino da definio de
tarefa. O tipo desse atributo xsd:anyURI. Este atributo
requerido.
Pseudo Esquema
<jobDefinition
name="xsd:NCName"
description="xsd:string"?
xsd:anyAttribute##other>
<annotation ... />?
<category>.../>*
<variables ... />?
<application ... />
<resources ... />?
<relatedResources .../>*
<optimization ...>?
<scheduling ...>?
<xsd:any##other/>*
</jobDefinition>
Elemento annotation
Definio
Esse elemento fornece informaes descritivas legveis para o ser humano
sobre a definio de tarefa. Esse elemento opcional e pode ser
especificado uma vez.
Tipo
O tipo desse elemento xsd:string.
Attributes
Nenhum atributo definido.
Pseudo Esquema
<annotation
xsd:string
<xsd:any##other/>*
</application>
Elemento category
Definio
Esse elemento descreve a categoria da tarefa que ajuda a categorizar a
tarefa. Uma tarefa pode ter diversas categorias, por exemplo:
Education_DB, Financial_Dept, Asset_Management. O valor pode ser
qualquer valor de sequncia. Esse elemento opcional e pode ser
especificado nenhuma ou mais vezes.
Tipo
Attributes
Pseudo Esquema
<category>
xsd:string
</category>
606
Elemento variables
Definio
Esse elemento descreve a lista de variveis definidas no arquivo JSDL. Os
trs tipos de variveis a seguir so suportados:
v Cadeia
v Dupla
v Inteiro
Um valor de varivel pode ser referido em outras partes do documento
JSDL especificando-se: ${nome da varivel}. Uma varivel referida pode ser
uma definida no arquivo JSDL com o elemento variable ou pode ser
definida ao enviar a tarefa. A substituio pode ser executada pelo servidor
do Dynamic Workload Broker em diferentes fases do processamento de
tarefa. Em cada fase, o servidor do Dynamic Workload Broker tenta
corresponder todas as referncias de variveis ainda no substitudas com
variveis definidas. Esse elemento opcional e pode ser especificado uma
vez.
Tipo
O tipo desse elemento jsdl:VariablesType. Ele pode conter os elementos a

seguir:
v stringVariable
v uintVariable
v doubleVariable
Attributes
Pseudo Esquema
<variables
<stringVariable ...>*
<uintVariable ...>*
<doubleVariable ...>*
<xsd:any##other/>*
</variables>?
Elemento stringVariable
Definio
Esse elemento descreve uma varivel especificando o nome da varivel e o
valor de sequncia padro designado. Esse elemento opcional e pode ser
Tipo
O tipo desse elemento jsdl:StringVariableType.
Attributes
Os atributos a seguir so definidos:
name
Esse atributo especifica o nome da varivel. O tipo desse atributo

xsd:NCName. Este atributo requerido.
description
Esse atributo especifica a descrio da varivel. O tipo desse
atributo xsd:string. Este atributo opcional.
Pseudo Esquema
<stringVariable
name="xsd:NCName"
607
xsd:string
<xsd:any##other/>*
</stringVariable>
Elemento doubleVariable
Definio
valor duplo padro designado. Esse elemento opcional e pode ser
Tipo
O tipo desse elemento xsd:DoubleVariableType.
Attributes
name

description
Esse atributo especifica a descrio da varivel. O tipo desse
atributo xsd:string. Este atributo opcional.
Pseudo Esquema
<doubleVariable
name="xsd:NCName"
xsd:double
<xsd:any##other/>*
</doubleVariable>
Elemento uintVariable
Definio
valor de nmero inteiro no assinado padro designado. Esse elemento
opcional e pode ser especificado nenhuma ou mais vezes.
Tipo
O tipo desse elemento xsd:UnsignedIntVariableType.
Attributes
name

description
xsd:string. Este atributo opcional.
Pseudo Esquema
<uintVariable
name="xsd:NCName"
xsd:unsignedInt
<xsd:any##other/>*
</uintVariable>
608
Elemento application
Definio
Esse elemento descreve o aplicativo a ser executado e os parmetros
relacionados. Esse elemento necessrio e pode ser especificado uma vez.
Tipo
O tipo desse elemento jsdl:ApplicationType.
Attributes
name
Especifica o tipo do aplicativo. Os valores para os quais existe

suporte so os seguintes:
Executvel
Um arquivo que utilizado para desempenhar vrias
funes ou operaes em um computador.
J2EE
Um aplicativo baseado em Java 2 Platform Enterprise

Edition (J2EE).
Esse atributo obrigatrio e pode ser especificado uma vez.

description
Especifica o nome do aplicativo. O tipo desse atributo xsd:string.
verso Especifica a verso do aplicativo. O tipo desse atributo xsd:string.
Pseudo Esquema
<application
name="xsd:NCName"
version="xsd:string"?
<xsd:any##other/>*
</application>
Elemento resources
Definio
Esse elemento contm os requisitos de recursos a tarefa que devem ser
correspondidos no sistema de computador de destino para que uma tarefa
seja designada a esse sistema. Os elementos de requisitos de recursos
contidos so combinados em uma relacionamento AND. Isso significa que
cada requisito soma aos outros para refinar o requisito do recurso de
correspondncia e todos os requisitos devem ser atendidos para que a
alocao seja bem-sucedida. Esse elemento opcional e pode ser
especificado uma vez. Se esse elemento no estiver presente, o servidor do
Dynamic Workload Broker pode escolher qualquer conjunto de recursos
para executar a tarefa.
Tipo
O tipo desse elemento jsdl:ResourceType. Os tipos suportados para esse

elemento esto listados na Tabela 95 na pgina 641. Ele pode conter os
elementos a seguir:
v candidateHosts
v candidateCPUs
v physicalMemory
v virtualMemory
v candidateOperatingSystems
609
v
v
v
v
v
fileSystem
logicalResource
grupo
propriedades
allocation
v relacionamento
v candidateResources
Attributes
Pseudo Esquema
<resources
<candidateHosts .../>?
<candidateCPUs .../>?
<physicalMemory .../>?
<virtualMemory .../>?
<candidateOperatingSystems .../>?
<fileSystem .../>*
<logicalResource ...>*
<group ...>*
<properties ...>
<allocation ...>*
<relationship ...>*
<candidateResources ...>?
<xsd:any##other>*
</resources>
Elemento relatedResources
Definio
Esse elemento um identificador exclusivo para o requisito do recurso que
deve ser exclusivo no documento. Os requisitos definidos nesse elemento
se aplicam a recursos lgico e sistemas de computador. Ele pode ser
referido por elementos relationship. Os elementos de requisitos de
recursos contidos so combinados em uma relacionamento AND. Isso
significa que cada requisito soma aos outros para refinar o requisito do
recurso de correspondncia e todos os requisitos devem ser atendidos para
que a alocao seja bem-sucedida. Esse elemento opcional e pode ser
Tipo
O tipo desse elemento jsdl:RelatedResourceType. Ele pode conter os

elementos a seguir:
v logicalResource
v grupo
v propriedades
v allocation
v relacionamento
v candidateResources
Attributes
id
610
Especifica o ID interno do recurso que voc deseja associar os

elemento resources. Esse ID usado somente para referncia
interna dentro do arquivo JSDL. O tipo para esse atributo xsd:ID.
Este atributo requerido.
tipo
Especifica o tipo do recurso necessrio. Tipos suportados so

ComputerSystem e Logical Resource. Se esse atributo no estiver
presente, o tipo de recurso ComputerSystem assumido. Um tipo
de recurso identificado por um nome de tipo exclusivo e
descreve as propriedades que cada instncia de recurso fornece.
Para obter informaes adicionais sobre as propriedades de
recursos disponveis, consulte Tabela 95 na pgina 641. O tipo
desse atributo xsd:NCName. Este atributo opcional.
Pseudo Esquema
<relatedResources
id="xsd:ID"
type="xsd:NCName"?
<logicalResource ...>*
<group ...>*
<properties ...>
<allocation ...>*
<relationship ...>*
<candidateResources ...>?
<xsd:any##other>*
</relatedResources>
Consulte Tambm
Elemento resources na pgina 609
Elemento candidateHosts
Definio
Esse elemento especifica o conjunto de hosts denominados que devem ser
selecionados para execuo da tarefa. O Dynamic Workload Broker designa
a tarefa a um dos hosts dessa lista. Os hosts especificados esto em OR, ou
seja pelo menos um deles deve ser correspondido pelo recurso Operating
System contido no recurso de destino. Se nenhum dos hosts especificado
estiver disponvel quando a tarefa enviada, a tarefa aguarda at que um
deles esteja disponvel. Se nenhum host ficar disponvel antes da expirao
do tempo limite, a tarefa falha. Este atributo opcional.
Tipo
O tipo desse elemento jsdl:CandidateHostsRequirementType. Ele pode

conter o elemento a seguir:
v hostName
Attributes
Pseudo Esquema
<candidateHosts
<hostName>jsdl:StringVariableExpressionType<hostName/>+
<xsd:any##other>*
</candidateHosts>
Elemento orderedCandidatedWorkstations
|
|
|
|
|
Definio
Esse elemento especifica a lista ordenada de estaes de trabalho que so
candidatas para seleo com base nas informaes especificadas no campo
requirements da definio do conjunto dinmico. A primeira estao de
trabalho que corresponde aos requisitos selecionada para processamento.
611
O tipo desse elemento jsdl:OrderedCandidatedWorkstationsType. Ele

pode conter o elemento a seguir:
v estao de trabalho
|
|
|
Tipo
|
|
Attributes
|
|
|
|
|
|
Pseudo Esquema
Elemento hostName
<orderedCandidatedWorkstations
<workstation>jsdl:StringVariableExpressionType<workstation/>+
<xsd:any##other>*
</orderedCandidatedWorkstations>
Definio
Esse elemento especifica uma expresso de varivel de sequncia que
contm o nome de um nico host que pode ser selecionado para execuo
da tarefa. Se nenhum dos hosts especificado estiver disponvel quando a
tarefa for enviada, a tarefa aguarda at que um deles esteja disponvel. Se
nenhum host ficar disponvel antes da expirao do tempo limite, a tarefa
falha. Para especificar o nome do host, possvel usar uma expresso de
varivel que pode conter uma ou mais referncias de variveis, como
${var}, qualquer caractere e qualquer sequncia. Curingas so suportados.
Esse atributo necessrio e pode ser especificado uma ou mais vezes.
Tipo
O tipo desse atributo jsdl:StringVariableExpressionType.
Attributes
Pseudo Esquema
<hostName>jsdl:StringVariableExpressionType<hostName/>
<hostName>lab145674.example.com<hostName/>
<hostName>${my_preferred_host}<hostName/>
Elemento candidateCPUs
Definio
Esse elemento especifica o conjunto de caractersticas da CPU que devem
ser satisfeitas por hosts que podem ser selecionadas para execuo da
tarefa. As combinaes de caractersticas especificadas esto em OR, ou seja
pelo menos uma delas deve ser correspondida pelo recurso de destino. Se
nenhuma das caractersticas da CPU especificadas estiver disponvel
quando a tarefa for enviada, a tarefa aguardar que uma delas fique
disponvel. Se nenhuma CPU ficar disponvel antes do tempo limite vencer,
a tarefa falha. Esse elemento opcional e pode ser especificado nenhuma
ou mais vezes.
Tipo
O tipo desse elemento jsdl:CandidateCPUsRequirementType. Ele pode

v cpu
Attributes
612
Pseudo Esquema
<candidateCPUs
<cpu ...>*
<xsd:any##other/>*
</candidateCPUs >?
Elemento cpu
Definio
Esse elemento especifica as caractersticas da CPU que devem ser satisfeitas
por hosts que podem ser selecionadas para execuo da tarefa. As
combinaes de caractersticas especificadas esto em OR, ou seja pelo
menos uma delas deve ser correspondida pelo recurso de destino. Pelo
menos uma das CPUs com as caractersticas especificadas deve estar
disponvel para que a tarefa seja executada. Se nenhuma das CPUs
especificadas estiver disponvel quando a tarefa for enviada, a tarefa
aguarda at que uma delas esteja disponvel. Se nenhuma CPU ficar
disponvel antes do tempo limite vencer, a tarefa falha. Esse elemento
necessrio e pode ser especificado uma ou mais vezes.
Tipo
O tipo desse elemento CPURequirementType.
Attributes
arquitetura
Especifica a arquitetura da CPU necessria para executar a tarefa.
Este atributo opcional. Os valores para os quais existe suporte
so os seguintes:
v
v
v
v
v
parisc
powerpc
powerpc_64
s390
s390x
v sparc
v x86
v x86_64
quantidade
Especifique o nmero de processadores que deve estar disponvel
no computador. Definir a Quantidade para 0 indica que o requisito
atendido por computadores com qualquer nmero de
processadores. O tipo desse atributo xsd:unsignedInt. Este
atributo opcional.
Pseudo Esquema
<cpu>
architecture="xsd:string"?
speed="jsdl:NumericRangeType"?
quantity="xsd:unsignedInt"?
<xsd:any##other>*
</cpu>
Elemento speed
Definio
Esse elemento especifica a faixa de velocidade da CPU em MHz necessria
613
para executar a tarefa. A unidade de medida megahertz. Esse elemento

opcional e pode ser especificado uma vez.
Tipo
O tipo desse elemento jsdl:NumericRangeType.
Attributes
Pseudo Esquema
<speed>
<jsdl:NumericRangeType>*
<speed>
Elemento physicalMemory
Definio
Esse elemento especifica uma faixa ou um valor exato que indica a quantia
de memria fsica livre necessria para a tarefa. A quantia expressada em
bytes. Este atributo opcional.
Tipo
Attributes
Pseudo Esquema
<physicalMemory
jsdl:NumericRangeType
<xsd:any##other>*
</physicalMemory>
Elemento virtualMemory
Definio
Esse elemento especifica uma faixa ou um valor exato que indica a quantia
de memria virtual livre necessria para a tarefa. A quantia expressada
em bytes. Este atributo opcional.
Tipo
Attributes
Pseudo Esquema
<virtualMemory
jsdl:NumericRangeType
<xsd:any##other>*
</virtualMemory>
Elemento candidateOperatingSystems
Definio
Esse elemento especifica o conjunto de caractersticas do sistema
operacional que devem ser satisfeitas por hosts que podem ser
selecionadas para execuo da tarefa. As combinaes de caractersticas so
correspondidas em OR, ou seja pelo menos uma delas deve ser
correspondida pelo recurso Operating System contido no recurso de
destino. Pelo menos um dos sistemas operacionais listado deve estar
disponvel para a execuo da tarefa. Se nenhum dos sistemas operacionais
especificados estiver disponvel quando a tarefa for enviada, a tarefa
614
aguardar que um deles fique disponvel. Se nenhum ficar disponvel antes

da expirao do tempo limite, a tarefa falhar. Este atributo opcional.
Tipo
O tipo desse elemento jsdl:OperatingSystemsRequirementType. Ele pode

v operatingSystem
Attributes
Pseudo Esquema
<candidateOperatingSystems
<xsd:anyAttribute##other>
<operatingSystem...>*
<xsd:any##other/>*
</ candidatOperatingSystems>?
Elemento operatingSystem
Definio
Esse elemento especifica as caractersticas do sistema operacional que so
necessrias para execuo da tarefa. Esse atributo necessrio e pode ser
especificado uma ou mais vezes.
Tipo
O tipo desse elemento OperatingSystemRequirementType
Attributes
tipo
Esse atributo define o nome do sistema operacional necessrio para

execuo da tarefa. O tipo desse atributo xsd:string. Este atributo
requerido. Os valores para os quais existe suporte so os
seguintes:
v AIX
v
v
v
v
v
v
Linux
Windows
Windows
Windows
Windows
HPUX
2000
2003
XP
Vista
v Solaris
verso Especifique a verso do sistema operacional. possvel especificar
a verso ou sub-verso exata do sistema operacional, por exemplo,
5.2 ou 5.2.3.30, ou pode especificar uma parte da verso, por
exemplo, 5.2.3. Nesse caso, o requisito se aplica a todos os sistemas
operacionais que tenham a verso 5.2.3 e quaisquer sub-verses,
como fix packs e nveis de manuteno. O tipo desse atributo
xsd:string. Este atributo opcional.
Pseudo Esquema
<operatingSystem
type="xsd:string"
version="xsd:string"?
<xsd:any##other>*
</operatingSystem>
615
Elemento fileSystem
Definio
Esse elemento descreve o conjunto de caractersticas do sistema de
arquivos que podem ser selecionadas para execuo da tarefa. Cada
conjunto de caractersticas especifica o local onde o sistema de arquivos
est disponvel, a quantia de espao em disco necessria e o tipo do
sistema de arquivos. O sistema de arquivos pode ser local com relao ao
recurso, por exemplo, em um disco local, ou pode ser remoto, por
exemplo, em um formato NFS. O requisito satisfeito se para um
determinado destino todas as caractersticas do sistema de arquivos
listadas forem satisfeitas. As combinaes de caractersticas so
correspondidas em AND, ou seja todas devem ser correspondidas pelos
recursos File System contidos no recurso de destino. Todos os sistemas de
arquivos listados devem estar presentes para que a tarefa seja executada.
Se qualquer um dos sistemas de arquivos especificados no estiver
disponvel quando a tarefa for enviada, a tarefa espera at que seja
disponibilizado. Se no ficar disponvel antes do tempo limite vencer, a
tarefa falha. Esse elemento opcional e pode ser especificado nenhuma ou
mais vezes.
Tipo
O tipo para esse elemento e jsdl:FileSystemRequirementType. Ele contm o

elemento diskSpace.
Attributes
tipo
um token que especifica o tipo de sistema de arquivos do

elemento fileSystem que contm. O tipo desse atributo
jsdl:FileSystemTypeEnumeration. Este atributo opcional. Os
valores para os quais existe suporte so os seguintes:
Desconhecido
O sistema de arquivos no est especificado.
Sem Diretrio Raiz
um sistema de arquivos local diferente do diretrio raiz.
Disco Removvel
um sistema de arquivos montado em um disco rgido
que pode ser removido.
Disco Local
um sistema de arquivos montado em um disco local.
Unidade Remota
um sistema de arquivos montado em uma unidade
remota.
CD-ROM
um sistema de arquivos montado em uma unidade de
CD ROM.
Disco Virtual
um sistema de arquivos montado em um disco RAM.
mountPoint
uma expresso de varivel de sequncia que especifica o
mapeamento local no qual o sistema de arquivos est disponvel
para a tarefa. O tipo desse atributo
jsdl:StringVariableExpressionType. Para especificar o ponto de
montagem, possvel usar uma expresso de varivel que pode
616
conter uma ou mais referncias de variveis, como ${var}, qualquer

caractere e qualquer sequncia. Curingas so suportados. Este
atributo opcional.
Pseudo Esquema
<fileSystem
type="jsdl:FileSystemTypeEnumeration"?
mountPoint="jsdl:StringVariableExpressionType"?
<diskSpace>jsdl:NumericRangeType</diskSpace>?
<xsd:any##other/>*
</fileSystem>
Elemento diskSpace
Definio
Esse elemento especifica a quantia de espao em disco necessria no
elemento do sistema de arquivos que contm para execuo da tarefa. A
quantia de espao em disco fornecida em kilobytes. Esse elemento
Tipo
Attributes
Pseudo Esquema
<fileSystem
type="jsdl:FileSystemTypeEnumeration"?
mountPoint="jsdl:StringVariableExpressionType"?
<diskSpace>jsdl:NumericRangeType</diskSpace>?
<xsd:any##other/>*
</fileSystem>
Elemento logicalResource
Definio
Esse elemento especifica um ou mais recursos lgicos que so necessrios
para execuo da tarefa. As combinaes de caractersticas so
correspondidas em AND, ou seja todas devem ser correspondidas pelos
Logical Resources associado ao recurso de destino. Todos os recursos
lgicos listados devem estar disponveis para que a tarefa seja executada.
Se um dos recursos lgicos especificados estiver indisponvel quando a
tarefa for enviada, a tarefa espera at que seja disponibilizado. Se no ficar
opcional e pode ser especificado nenhuma ou mais vezes.
Tipo
O tipo desse elemento LogicalResourceRequirementType.
Attributes
name
uma expresso de varivel de sequncia que especifica o nome

do recurso lgico solicitado. Para especificar o nome do recurso
lgico, possvel usar uma expresso de varivel que pode conter
uma ou mais referncias de variveis, como ${var}, qualquer
caractere e qualquer sequncia. O nome deve comear com um
caractere alfabtico e pode conter sublinhados ( _ ), sinais de
menos (-) e pontos (.). Espaos, caracteres especiais e caracteres
acentuados no so suportados. Este atributo opcional.
617
subType
uma expresso de varivel de sequncia que especifica o tipo do
recurso lgico solicitado. Para especificar o tipo do recurso lgico,
possvel usar uma expresso de varivel que pode conter uma ou
mais referncias de variveis, como ${var}, qualquer caractere e
qualquer sequncia. Este atributo opcional.
quantidade
O valor de nmero inteiro que especifica a quantidade necessria
do recurso lgico. A quantidade especificada alocada
exclusivamente para a tarefa enquanto ele executada. Para
especificar a quantia do recurso, possvel usar uma expresso de
varivel que pode conter uma referncia de varivel, como ${var},
ou um valor de nmero inteiro no assinado. Este atributo
opcional.
Pseudo Esquema
<logicalResource
name="jsdl:StringVariableExpressionType"?
subType="jsdl:StringVariableExpressionType"?
quantity="jsdl:UnsignedIntVariableExpressionType"?
<xsd:any##other/>*
</logicalResource>
Elemento group
Definio
Esse elemento especifica que os recursos necessrios para executar a tarefa
precisam pertencer ao grupo de recursos especificado. Os grupos so
correspondidos em AND, ou seja o recurso de destino deve estar em todos
os grupos especificados. Esse elemento opcional e pode ser especificado
nenhuma ou mais vezes.
Tipo
O tipo desse elemento jsdl:GroupRequirementType.
Attributes
O atributo a seguir definido:
name
Especifica o nome do grupo como uma expresso de varivel de

sequncia. Para especificar o grupo de recursos, possvel usar
uma expresso de varivel que pode conter uma ou mais
referncias de variveis, como ${var}, qualquer caractere e qualquer
sequncia. Esse atributo necessrio e pode ser especificado uma
vez.
Pseudo Esquema
<group
name="jsdl:StringVariableExpressionType"
<xsd:any##other/>*
</group>
Elemento properties
Definio
Esse elemento especifica as propriedades do recurso necessrias para
execuo da tarefa. O requisito expressado como um conjunto de
condies em propriedades de recursos combinadas com operadores
AND/OR. Isso baseado no modelo de recurso que descreve os recursos
disponveis no ambiente como instncias de tipos de recursos. Um tipo de
recurso identificado por um nome de tipo exclusivo e descreve as
618
propriedades que cada instncia de recurso fornece. Use esse elemento

para especificar requisitos avanados. Para obter informaes adicionais
sobre tipos e propriedades e recursos disponveis, consulte Tabela 95 na
pgina 641. Esse elemento opcional e pode ser especificado uma vez.
Tipo
O tipo desse elemento jsdl:RequirementCompositorType. Ele pode conter

os elementos a seguir:
v e
v ou
v requirement
Attributes
Pseudo Esquema
<properties
<and .../>?
<or .../>?
<requirement .../>?
<xsd:any##other/>*
</properties>
Elemento and
Definio
Esse elemento especifica uma condio AND nas especificaes do
requisito que contm. Esse elemento opcional e pode ser especificado
uma vez.
Tipo

v e
v ou
v requirement
Attributes
Pseudo Esquema
<and
<and .../>?
<or .../>?
<requirement .../>?
<xsd:any##other/>*
</and>
Elemento or
Definio
Esse elemento especifica uma condio OR nas especificaes do requisito
que contm. Esse elemento opcional e pode ser especificado uma vez.
Tipo

v e
v ou
v requirement
619
Attributes
Pseudo Esquema
<or
<and .../>?
<or .../>?
<requirement .../>?
<xsd:any##other/>*
</or>
Elemento requirement
Definio
Esse elemento um valor de intervalo que especifica um requisito sobre os
recursos de um recurso para executar a tarefa. Esse elemento opcional e
pode ser especificado uma vez.
Tipo
O tipo desse elemento jsdl:RequirementType.
Attributes
propertyName
uma sequncia que especifica a propriedade do recurso qual o
requisito se aplica. As propriedades disponveis variam
dependendo dos recursos selecionados no elemento recursos. Para
obter informaes adicionais sobre tipos e propriedades e recursos,
consulte Tabela 95 na pgina 641. O tipo desse atributo
Pseudo Esquema
<requirement
propertyName="xsd:NCName"
jsdl.StringRangeType
<xsd:any##other/>*
</and>
Elemento allocation
Definio
Esse elemento especifica um requisito de alocao exclusiva em uma
determinada propriedade de um recurso. possvel definir um requisito
de alocao nos atributos de consumo de recursos. Para obter informaes
adicionais sobre atributos de consumo, consulte Tabela 95 na pgina 641. A
tarefa pode ser executada no recurso se o valor necessrio estiver
disponvel. Enquanto a tarefa executada, ele usa exclusivamente o valor
necessrio da propriedade do recurso. Quando a tarefa concluda, ela
libera o valor da propriedade. Esse elemento opcional e pode ser
especificado uma vez.
Tipo
O tipo desse elemento jsdl:AllocationRequirementType.
Attributes
propertyName
uma sequncia que especifica a propriedade do recurso qual o
requisito se aplica. O tipo desse atributo xsd:QName. Este
atributo requerido.
620
Quantidade
Especifique a quantidade da propriedade que ser alocada
exclusivamente para a tarefa. Para especificar a quantidade da
propriedade que deve ser alocada, possvel usar uma expresso
de varivel que pode conter uma referncia de varivel, como
${var}, ou um valor duplo.
Pseudo Esquema
<allocation
propertyName="xsd:QName"
jsdl:DoubleVariableExpressionType
<xsd:any##other/>*
</and>
Elemento relationship
Definio
Esse elemento especifica um requisito de que o recurso selecionado para
executar a tarefa tem um relacionamento com outros recursos que
correspondem a determinados critrios adicionais. Um relacionamento
uma associao direta entre um recurso de origem e um de destino. Esse
elemento opcional e pode ser especificado uma vez.
Tipo
O tipo desse elemento jsdl:RelationshipRequirementType.
Attributes
tipo
uma sequncia que especifica o tipo de relacionamento

necessrio. O tipo desse atributo xsd:NCName. Este atributo
opcional.
origem
uma sequncia que especifica o ID de um elemento
relatedResources. Se esse atributo for especificado, o requisito do
relacionamento especifica que o recurso deve ter pelo menos um
relacionamento direcionado de um ou mais recursos
correspondidos pelo elemento relatedResources para ele mesmo.
Se esse atributo no for especificado, ento um atributo de destino
deve estar presente. O tipo desse atributo xsd:IDREF. Este
atributo opcional.
target uma sequncia que especifica o ID de um elemento
relatedResources. Se esse atributo for especificado, o requisito do
relacionamento especifica que o recurso deve ter pelo menos um
relacionamento direcionado dele mesmo para um ou mais recursos
correspondidos pelo elemento relatedResources. Se esse atributo
no for especificado, ento um atributo de origem deve estar
presente. O tipo desse atributo xsd:IDREF. Este atributo
opcional.
Pseudo Esquema
<relationship
type="xsd:NCName"
source="xsd:IDREF"?
target="xsd:IDREF"?
<xsd:any##other/>*
</relationship>
621
Elemento candidateResources
Esse elemento reservado para uso interno.
Definio
Esse elemento especifica o conjunto de recursos que povem ser
selecionados para execuo da tarefa. Se esse elemento for especificado, um
ou mais recursos do conjunto devem ser escolhido para execuo da tarefa.
Os recursos so identificados usando o endereo de Referncia de Terminal
(WS-Addressing EPR) do servio Job Factory que est gerenciando o
recurso. As combinaes de requisitos so correspondidas em OR, ou seja
pelo menos um deles deve ser correspondido pelo recurso contido no
recurso de destino. Pelo menos um dos recursos listados deve estar
disponvel para a execuo da tarefa. Se nenhum dos recursos
especificados estiver disponvel quando a tarefa for enviada, a tarefa
aguarda at que um deles esteja disponvel. Se nenhum rescurso ficar
Tipo
O tipo desse elemento jsdl:CandidateResourcesRequirementType. Ele

contm o elemento endpointReference.
Attributes
Pseudo Esquema
<candidateResources
<endpointReference>wsa:EndpointReferenceType<endpointReference/>+
<xsd:any##other>*
</candidateResources>
Elemento endpointReference
Esse elemento reservado para uso interno.
Definio
Esse elemento especifica a referncia de terminal de Web Services
Addressing do servio Job Factory que est gerenciando o recurso. Esse
elemento necessrio e pode ser especificado uma ou mais vezes. Esse
elemento reservado para uso interno.
Tipo
O tipo desse elemento wsa:EndpointReferenceType.
Attributes
Pseudo Esquema
<candidateResources
<endpointReference>wsa:EndpointReferenceType<endpointReference/>+
<xsd:any##other>*
</candidateResources>
Elemento optimization
Definio
Esse elemento especifica as polticas de otimizao a serem aplicadas
tarefa. Dependendo de se voc selecionar o elemento objective ou ewlm, a
poltica de seleo de recurso muda. Esse elemento opcional e pode ser
622
especificado uma vez. Se nenhum valor for especificado, ento a poltica de

balanceamento de carga padro para igualar o nmero de tarefas em
execuo em cada recurso aplicada.
Tipo
O tipo para esse elemento e jsdl:OptimizationType. Pode conter somente

um dos seguintes elementos:
v objective
v ewlm
Attributes
name
Especifica o nome da poltica de otimizao. Os valores para os

quais existe suporte so os seguintes:
JPT_JSDLOptimizationPolicyType
Se usar essa opo, voc deve especificar o elemento
objective. Usando o elemento objective, possvel
especificar propriedades de recursos para serem
maximizadas ou minimizadas. Ao definir o elemento
objective, o Dynamic Workload Broker executa a tarefa no
recurso que corresponde ao requisito de otimizao. Para
obter informaes adicionais sobre o elemento objective,
consulte Elemento objective. Este o valor padro.
Consulte Recursos na Definio de Tarefa na pgina 640
para obter informaes adicionais.
JPT_BestResource
Use essa opo para que o conjunto de recursos para a
tarefa seja formado somente dos melhores recursos entre o
conjunto de recursos que atendem poltica especificada.
Se usar essa opo, voc deve especificar o elemento
objective. Usando o elemento objective, possvel
especificar propriedades de recursos para serem
maximizadas ou minimizadas. Ao definir o elemento
objective, o Dynamic Workload Broker executa a tarefa no
recurso que corresponde ao requisito de otimizao. Para
obter informaes adicionais sobre o elemento objective,
consulte Elemento objective. Este o valor padro.
Consulte Recursos na Definio de Tarefa na pgina 640
para obter informaes adicionais.
JPT_EWLM
Se usar essa opo, o elemento ewlm inserido
automaticamente. Para obter informaes adicionais sobre
o elemento ewlm, consulte Elemento ewlm na pgina
625.
Pseudo Esquema
<optimization
name="xsd:NCName"
<objective .../> |
<ewlm .../>
<xsd:any##other>*
</optimization>
Elemento objective
Definio
Esse elemento especifica o objetivo a ser atingido ao executar otimizao
623
para a tarefa. Por exemplo, se voc selecionar resourcePropertyName CPU

Utilization for resourceType Computer System with propertyObjective
minimize, o Dynamic Workload Broker tentar executar a tarefa no recurso
onde a utilizao de CPU for mais baixa. Esse elemento mutuamente
exclusivo com o elemento ewlm.
Tipo
O tipo desse elemento PropertyObjectiveType.
Attributes
propertyObjective
uma sequncia que especifica o tipo de objetivo. Este atributo
requerido. Os valores para os quais existe suporte so os seguintes:
minimize
Os recursos so atribudos tarefa com o objetivo de
minimizar o valor da propriedade do tipo do recurso
especificado. Por exemplo, possvel escolher este objetivo
para atribuir a tarefa ao recurso no qual a utilizao da
CPU seja a mais baixa.
maximize
maximizar o valor da propriedade do tipo do recurso
especificado. Por exemplo, possvel escolher este objetivo
para atribuir a tarefa ao recurso no qual a velocidade de
processamento seja a mais alta.
minimize.utilization
minimizar a utilizao da propriedade do tipo do recurso
especificado. Esse atributo est disponvel somente para
propriedades consumveis. Para obter uma lista de todas as
propriedades de consumo, consulte Tabela 95 na pgina
641. Se voc optar por minimizar a utilizao do consumo
de propriedades, a tarefa ser atribuda a um recurso em
que seja utilizada uma quantidade menor da propriedade.
maximize.utilization
maximizar a utilizao da propriedade do tipo do recurso
especificado. Esse atributo est disponvel somente para
propriedades consumveis. Para obter uma lista de todas as
propriedades de consumo, consulte Tabela 95 na pgina
641. Por exemplo, talvez voc queira executar um teste de
sobrecarga em uma estao de trabalho criando tarefas em
que a propriedade de recurso Utilizao da CPU para o
tipo de recurso Sistema de Computador esteja definida
como Maximizar Utilizao. Isso faria com que todas as
tarefas com essa configurao fossem designadas estao
de trabalho em que a utilizao da CPU fosse maior,
gerando um loop.
resourceType
uma sequncia que especifica o tipo do recurso ao qual a poltica
se aplica. Se esse elemento no for especificado, o tipo de recurso
ComputerSystem assumido. O tipo desse atributo xsd:QName.
624
resourcePropertyName
uma sequncia que especifica a propriedade do recurso qual a
poltica se aplica. O tipo desse atributo xsd:QName. Este atributo
requerido.
Nota: Ao especificar um requisito de otimizao em qualquer propriedade
de um tipo de recurso, voc deve ter definido anteriormente um
requisito nesse tipo de recurso. Por exemplo, se voc quiser otimizar
a memria fsica total em um sistema operacional, deve definir
previamente um requisito sobre o tipo de recurso Sistema
Operacional. Esse procedimento no se aplica ao tipo de recurso
Sistema de Computador, porque Sistema de Computador o tipo de
recurso padro.
Pseudo Esquema
<objective
propertyObjective="minimize" | "maximize"
resourceType="xsd:QName"?
resourcePropertyName="xsd:QName"
<xsd:any##other>*
</objective>
Elemento ewlm
Definio
Esse elemento especifica a otimizao com base no clculo do peso do
recurso do Enterprise Workload Manager. O Dynamic Workload Broker
executar a tarefa nos melhores recursos disponveis, conforme indicado
pelo Enterprise Workload Manager. Esse elemento opcional e pode ser
especificado uma vez. Esse elemento mutuamente exclusivo com o
elemento objective.
Tipo
O tipo desse elemento jsdl:PropertyObjectiveType
Attributes
Pseudo Esquema
<ewlm>
<xsd:any##other>*
</ewlm>
Elemento scheduling
Definio
Esse elemento especifica os parmetros de planejamento a serem aplicados
na execuo da tarefa. Esse elemento opcional e pode ser especificado
uma vez.
No Dynamic Workload Broker, esse elemento corresponde pgina
Planejamento. Para obter informaes adicionais sobre a pgina
Planejamento, consulte a documentao da ajuda on-line.
Tipo
O tipo desse elemento jsdl:SchedulingType. Ele pode conter os elementos

a seguir:
v maximumResourceWaitingTime
v estimatedDuration
v prioridade
625
Attributes
Pseudo Esquema
<scheduling
<maximumResourceWaitingTime>xsd:duration<maximumResourceWaitingTime>?
<estimatedDuration>xsd:duration<estimatedDuration>?
<priority>xsd:unsignedint<priority>?
<xsd:any##other>*
</objective>
Elemento maximumResourceWaitingTime
Definio
Esse elemento especifica quanto tempo o servidor do Dynamic Workload
Broker deve esperar desde o envio da tarefa antes de decidir que no h
nenhum recurso que corresponde aos requisitos. Esse elemento opcional
e pode ser especificado uma vez.
Tipo
O tipo desse elemento xsd:duration.
Attributes
Pseudo Esquema
<maximumResourceWaitingTime>?
<xsd:duration>*
<maximumResourceWaitingTime>
Elemento estimatedDuration
Definio
Esse elemento especifica a durao estimada da execuo da tarefa. Isso
pode ser usado pelo servidor do Dynamic Workload Broker para planejar a
designao de recurso. Esse elemento opcional e pode ser especificado
uma vez.
Tipo
O tipo desse elemento xsd:duration.
Attributes
Pseudo Esquema
<estimatedDuration>?
<xsd:anyAttribute##other>
<xsd:duration>*
<estimatedDuration>
Elemento priority
Definio
Esse elemento especifica a prioridade da tarefa como um nmero inteiro
entre 0 e 100. Valores mais altos significam prioridade mais alta. Esse
elemento opcional e pode ser especificado uma vez.
Tipo
626
O tipo desse elemento xsd:PriorityType. Ele pode conter os elementos a

seguir:
v maximumResourceWaitingTime
v estimatedDuration
v prioridade
Attributes
Pseudo Esquema
<scheduling
<maximumResourceWaitingTime>xsd:duration<maximumResourceWaitingTime>?
<estimatedDuration>xsd:duration<estimatedDuration>?
<priority>xsd:unsignedint<priority>?
<xsd:any##other>*
</objective>
recoveryActions
Definio
Esse elemento descreve a lista de aes de recuperao que o Dynamic
Workload Broker deve executar se o intervalo de tempo especificado no
elemento maximumResourceWaitingTime vencer e nenhum recurso que
corresponda aos requisitos tiver sido localizado. Esse elemento opcional e
pode ser especificado uma vez. As aes de recuperao definidas nesse
elemento so executadas iniciando um fluxo de trabalho do Tivoli
Provisioning Manager. Para obter informaes adicionais sobre o elemento
maximumResourceWaitingTime, consulte Elemento
maximumResourceWaitingTime na pgina 626.
Tipo
O tipo desse elemento jsdl:RecoveryActionList. Ele pode conter o

elemento de ao.
Attributes
Pseudo Esquema
<recoveryActions
<action...>+
<xsd:any##other/>*
</recoveryActions >
action
Definio
Esse elemento especifica a(s) ao(es) a ser(em) executada(s). O Dynamic
Workload Broker executa as aes listadas sequencialmente com base na
ordem na qual foram especificadas. Qualquer ao de recuperao
subsequente executada somente se a ao anterior tiver sido concluda
com sucesso. Se o elemento recoveryActions for especificado, pelo menos
um elemento action deve ser especificado.
Tipo
O tipo desse elemento jsdl:RecoveryActionType.
Attributes
name
Especifica o nome da ao de recuperao a ser executada. Este

atributo opcional.
additionalTimeOnCompletion
Especifica o intervalo de tempo que o Dynamic Workload Broker
deve esperar at a ao de recuperao se tornar efetiva aps a
concluso. Se esse atributo for especificado para uma ao de
recuperao, a ao de recuperao subsequente executada
somente aps o intervalo de tempo especificado vencer. Se o
627
recurso necessrio ficar disponvel antes do intervalo vencer, o

Dynamic Workload Broker pode decidir executar a tarefa antes da
ao ser concluda.
maximumExecutionTime
Especifica o perodo de tempo esperado que o Dynamic Workload
Broker espera at a ao de recuperao ser concluda. Se a ao de
recuperao no estiver concluda quando o tempo limite vencer, o
procedimento de recuperao falha e a sequncia de recuperao
parada.
Pseudo Esquema
< action>
name="xsd:NCName"
additionalTimeOnCompletion ="xsd:duration"?
maximumExecutionTime ="xsd:duration"?
<xsd:any##other/>*
</ action >
Elemento tpmaction
Definio
Esse elemento especifica os parmetros necessrios para executar uma ao
de recuperao do Tivoli Provisioning Manager. Esse atributo opcional e
Tipo
O tipo desse atributo jsdltpm:TPMActionType. Ele pode conter os

elementos a seguir:
v parmetros
v credencial
v tpmaddress
v workFlow
Attributes
Pseudo Esquema
<tpmaction
<parameters... />?
<credential.../>?
<tpmaddress.../>?
workFlow="jsdl:StringVariableExpressionType"
</tpmaction>
Elemento parameters
Definio
Esse elemento especifica os argumentos a serem usados ao executar o fluxo
de trabalho Tivoli Provisioning Manager. Esse elemento opcional e pode
ser especificado uma vez.
Tipo
O tipo desse atributo jsdltpm:ParametersType.
Attributes
Os atributos a seguir so suportados:
name
628
Especifica o nome do atributo a ser usado ao executar o fluxo de

trabalho do Tivoli Provisioning Manager. Esse atributo necessrio
e pode ser especificado uma ou mais vezes.
Pseudo Esquema
<parameters
<parameter... />+
</parameters>
Elemento credential
Definio
Esse elemento especifica as credenciais necessrias para executar o fluxo de
trabalho do Tivoli Provisioning Manager. Esse elemento opcional e pode
Tipo
O tipo desse elemento jsdl:CredentialType. Ele pode conter os elementos

a seguir:
v userName
v password
Attributes
Pseudo Esquema
<credential
<userName> jsdl:NotEmptyStringVariableExpressionType</userName>
<password> jsdl:StringVariableExpressionType </password>
</credential>
Elemento userName
Definio
Esse elemento especifica um nome de usurio definido no sistema de
destino que usado para executar o fluxo de trabalho do Tivoli
Provisioning Manager. Esse elemento necessrio se voc usar o elemento
credential e pode ser especificado uma vez.
Tipo
O tipo desse elemento jsdl:NotEmptyStringVariableExpressionType.
Attributes
Pseudo Esquema
<userName>
<jsdl:NotEmptyStringVariableExpressionType*
<userName>
Elemento password
Definio
Esse elemento especifica a senha do usurio especificado que usado para
executar o fluxo de trabalho do Tivoli Provisioning Manager no sistema de
destino. Esse elemento necessrio se voc usar o elemento credential e
Tipo
O tipo desse elemento jsdl:StringVariableExpressionType.
Attributes
Pseudo Esquema
<password>?
<jsdl:StringVariableExpressionType
<password>
629
Elemento tpmaddress
Definio
Esse elemento especifica o endereo do Tivoli Provisioning Manager que
deve ser usado para chamar o servio da Web do Tivoli Provisioning
Manager necessrio para executar o fluxo de trabalho. Esse elemento
Tipo
O tipo desse elemento jsdltpm:TPMAddressType.
Attributes
host
Especifica o nome do host do servidor do Tivoli Provisioning

Manager a ser usado ao executar a ao de recuperao.
porta
Especifica o nmero da porta do servidor do Tivoli Provisioning

Manager a ser usado ao executar a ao de recuperao.
Pseudo Esquema
< tpmaddress
<host... />
<port... />
</ tpmaddress >
Elemento workflow
Definio
Esse elemento especifica o nome do fluxo de trabalho do Tivoli
Provisioning Manager a ser executado. Para especificar o nome do fluxo de
trabalho, possvel usar uma expresso de varivel que pode conter uma
ou mais referncias de variveis, como ${var}, qualquer caractere e
qualquer sequncia. Esse elemento necessrio.
Tipo
Attributes
Pseudo Esquema
<workflow>?
<workflow>
Elemento executable
Definio
Esse elemento especifica os parmetros para executar um comando do
sistema nativo, ou seja arquivos executveis e scripts. Tambm possvel
integrar scripts nesse elemento. Esse elemento necessrio.
Nota: As seguintes restries se aplicam:
v Nos sistemas Windows, possvel executar scripts que contm
comandos em lote. Os formatos suportados para scripts so:
.cmd
.bat
v Nos sistemas UNIX e Linux, somente scripts shell so suportados.
No incio do script da shell, especifique o interpretador de
comandos.
630
v Em sistemas UNIX e Linux, comandos contidos em scripts devem

ser executado em primeiro plano. Isto significa que voc no pode
utilizar o parmetro "&" em conjunto com o comando.
v Em todas as plataformas suportadas, voc no pode incluir nas
tarefas qualquer comando iniciando com uma interface grfica.
Tipo
O tipo desse elemento jsdle:ExecutableType. Ele pode conter os elementos

a seguir:
v
v
v
v
script
argumentos
environment
credencial
Attributes
path
uma expresso de varivel de sequncia que especifica o nome

do caminho do arquivo executvel a ser executado. Se o elemento
script no estiver presente, o atributo path deve ser especificado.
Se o elemento script estiver presente, o atributo path no pode ser
especificado. Para especificar o caminho, possvel usar uma
expresso de varivel que pode conter uma ou mais referncias de
variveis, como ${var}, qualquer caractere e qualquer sequncia.
necessrio especificar a extenso do arquivo. Se desejar executar
um arquivo executvel sem especificar sua extenso, possvel
especificar o nome do arquivo executvel no elemento script, de
forma que o arquivo seja executado sem o shell.
input
uma expresso de varivel de sequncia que especifica a entrada

padro para o comando. Esse atributo um nome absoluto do
caminho ou um nome do caminho relativo ao diretrio ativo. Para
especificar o caminho, possvel usar uma expresso de varivel
que pode conter uma ou mais referncias de variveis, como
${var}, qualquer caractere e qualquer sequncia. Este atributo
opcional.
output
uma expresso de varivel de sequncia que especifica a sada
opcional.
erro
uma expresso de varivel de sequncia que especifica o erro

opcional.
workingDirectory
uma expresso de varivel de sequncia que especifica o
diretrio ativo necessrio para a tarefa a ser executada. Para
especificar o diretrio, possvel usar uma expresso de varivel
631

opcional. Se esse atributo no do especificado, a tarefa executada
nos diretrios a seguir, dependendo do sistema operacional:
Em sistemas UNIX
Os seguintes casos so aplicveis:
v A tarefa executada em $HOME_DIRECTORY do
usurio que envia a tarefa, se existir.
v Se este diretrio no existir, ele executado em /root, se
o usurio que envia a tarefa tiver os direitos necessrios.
v Se o usurio no tiver os direitos necessrios, a tarefa
executada no diretrio ativo do Agente do Tivoli
Workload Scheduler.
Em sistemas Windows
A tarefa executada no diretrio ativo do Agente do Tivoli
Workload Scheduler.
script
Especifica o cdigo de script a ser executado. Para especificar

caracteres especiais necessrios para linguagens de script, o
contedo do elemento de script pode ser especificado com uma
seo CDATA
Pseudo Esquema
<executable
path="jsdl:StringVariableExpressionType"
input="jsdl:StringVariableExpressionType"?
output="jsdl:StringVariableExpressionType"?
error="jsdl:StringVariableExpressionType"?
workingDirectory="jsdl:StringVariableExpressionType"?
<script ... />?
<arguments .../>?
<environment .../>?
<credential .../>?
<xsd:any##other>*
</executable>
Elemento de script
Definio
Esse elemento especifica o cdigo de script a ser executado. Esse elemento
Tipo
Attributes
Pseudo Esquema
<script>?
<xsd:string
<script>
Elemento arguments
Definio
Esse elemento especifica a lista de argumentos como expresses de
variveis de sequncia que so concatenadas para produzir a sequncia de
argumentos a ser passada ao comando. Esse elemento opcional e pode
632
Tipo
O tipo desse elemento jsdle:ArgumentsType. Ele pode conter o elemento

a seguir:
v valor
Attributes
Pseudo Esquema
<arguments
<value>jsdl:StringVariableExpressionType</value>+
<xsd:any##other>*
</arguments>
Elemento value
Definio
Esse elemento especifica o valor do elemento arguments. Para especificar o
valor, possvel usar uma expresso de varivel que pode conter uma ou
mais referncias de variveis, como ${var}, qualquer caractere e qualquer
sequncia. Esse elemento necessrio e pode ser especificado uma ou mais
vezes.
Tipo
Attributes
Pseudo Esquema
<arguments
<value>jsdl:StringVariableExpressionType</value>+
<xsd:any##other>*
</arguments>
Nota: Se for necessrio especificar que um valor consiste em um espao em

branco, voc deve coloc-lo entre aspas duplas.
Elemento environment
Definio
Esse elemento especifica uma expresso de varivel de sequncia de
variveis de ambiente que sero definidas para a tarefa no ambiente de
execuo. Esse elemento opcional e pode ser especificado uma vez.
Tipo
O tipo desse elemento jsdl:jsdle:EnvironmentType. Ele pode conter o

elemento a seguir:
v varivel
Attributes
Nenhum atributo definido
Pseudo Esquema
<environment
<variable name="xsd:string">jsdl:StringVariableExpressionType</variable>+
<xsd:any##other>*
</environment>
Nota: Se for necessrio especificar que um valor consiste em um espao em

branco, voc deve coloc-lo entre aspas duplas.
633
Elemento variable
Definio
Esse elemento especifica uma expresso de varivel de sequncia de
variveis de ambiente que sero definidas para a tarefa no ambiente de
execuo. Esse elemento opcional e pode ser especificado uma vez.
Tipo
Attributes
name
Especifica o nome da varivel.
valor
Especifica o valor da varivel. Para especificar o valor da varivel,

possvel usar uma expresso de varivel que pode conter uma ou
mais referncias de variveis, como ${var}, qualquer caractere e
qualquer sequncia.
Elemento credential
Definio
Esse elemento especifica a credencial de segurana para executar o
comando. Inclua esse elemento quando quiser especificar um usurio ou
nome do grupo sob o qual o executvel ou o script executado no sistema
de destino que diferente do usurio ou nome do grupo sob o qual o
agente de carga de trabalho executado. Esse elemento opcional e pode
Tipo
O tipo desse elemento jsdle:CredentialType. Ele pode conter os elementos

a seguir:
v userName
v groupName
v password
Attributes
Pseudo Esquema
<credential
<userName> jsdl:StringVariableExpressionType </userName>
<groupName> jsdl:StringVariableExpressionType </groupName>
<xsd:any##other>*
</credential>
Elemento userName
Definio
uma expresso de varivel de sequncia que especifica o nome de
usurio de um usurio definido no sistema de destino. O comando executa
utilizando este nome de usurio. Esse elemento necessrio se voc usar o
elemento credential e pode ser especificado uma vez. Pode ser um ID do
usurio do UNIX ou do Windows. Para especificar o nome de usurio,
possvel usar uma expresso de varivel que pode conter uma ou mais
referncias de variveis, como ${var}, opcionalmente, em associao com
qualquer caractere ou com uma sequncia simples. Se o aplicativo for
executado em um sistema Windows como um usurio do domnio do
Windows, especifique o nome de usurio conforme a seguir:
domain_name\user_name
634
Se o aplicativo executar como um usurio local, possvel utilizar o

seguinte formato:
user_name
Tipo
Attributes
Pseudo Esquema
<credential
<xsd:any##other>*
</credential>
Elemento groupName
Definio
uma expresso de varivel de sequncia que especifica o nome do grupo
ao qual o usurio pertence que est definido no sistema de destino onde o
comando executado. Esse elemento opcional e pode ser especificado
uma vez. Esse elemento ignorado em sistemas de destino do Windows.
Para especificar o nome do grupo, possvel usar uma expresso de
varivel que pode conter uma ou mais referncias de variveis, como
${var}, qualquer caractere e qualquer sequncia.
Tipo
Attributes
Pseudo Esquema
<credential
<xsd:any##other>*
</credential>
Elemento password
Definio
uma expresso de varivel de sequncia que define a senha do nome de
usurio especificado que usado para executar o comando no sistema de
destino. Esse elemento opcional e pode ser especificado uma vez. Esse
elemento ignorado em sistemas de destino do UNIX. Para especificar a
senha, possvel usar uma expresso de varivel que pode conter uma ou
mais referncias de variveis, como ${var}, qualquer caractere e qualquer
sequncia.
Tipo
Attributes
Pseudo Esquema
<credential
635

<xsd:any##other>*
</credential>
Elemento j2ee
Definio
Esse elemento especifica as informaes do aplicativo J2EE necessrias para
a tarefa. Esse elemento opcional e pode ser especificado uma vez. As
operaes J2EE que possvel executar variam conforme o tipo de
planejador (direto ou indireto) selecionado e se a segurana do WebSphere
Application Server ou J2EE ativada ou no.
Tipo
O tipo desse elemento jsdlj:J2EEType. Ele pode conter os elementos a

seguir:
v invoker
v jsm
v ejb
v credencial
Attributes
Pseudo Esquema
<j2ee>?
<jsdlj:J2EEType
<j2ee>
Elemento invoker
Definio
Esse elemento especifica se o invocador indireto ou direto deve ser usado
para o aplicativo J2EE. Esse elemento necessrio e pode ser especificado
uma vez. Selecionar um invocador direto significa que o Agente do Tivoli
Workload Scheduler encaminha a tarefa imediatamente para os
componentes da instncia do WebSphere Application Server (EJB ou JMS).
Selecionar um invocador indireto significa que o Agente do Tivoli
Workload Scheduler usa uma infraestrutura de planejamento do
WebSphere existente j configurada no WebSphere Application Server de
destino.
Tipo
O tipo desse elemento jsdlj:InvokerType.
Attributes
Pseudo Esquema
<invoker>?
<jsdlj:InvokerType
<invoker>
Elemento jms
Definio
Esse elemento especifica a fila de destino do Java Message System (JMS) e
a mensagem a ser enviada. Esse elemento opcional e pode ser
especificado uma vez. mutuamente exclusivo com o elemento ejb.
Tipo
636
O tipo desse elemento jsdlj:JMSActionType.
Attributes
Pseudo Esquema
<jms>?
<jsdlj:JMSActionType
<jms>
Elemento ejb
Definio
Esse elemento especifica as caractersticas do incio de JNDI do EJB a ser
chamado. mutuamente exclusivo com o elemento jms. O EJB j deve
estar instalado no WAS de destino e deve implementar a interface
TaskHandler.
Tipo
O tipo desse elemento jsdlj:EJBActionType. Ele pode conter os elementos

a seguir:
v jndiHome
v credencial
Attributes
Pseudo Esquema
<ejb>?
<jsdlj:EJBActionType
<ejb>
Elemento jndiHome
Definio
Esse elemento especifica o diretrio inicial da interface de programao de
aplicativos Java Naming and Directory Interface (JNDI). Esse elemento
necessrio e pode ser especificado uma vez.
Tipo
Attributes
Pseudo Esquema
<jndiHome>?
<jndiHome>
Elemento ejb
Definio
Esse elemento especifica as caractersticas da ao EJB.
Tipo
O tipo desse elemento jsdlj:JMSActionType. Ele pode conter os elementos

a seguir:
v connFactory
v destino
v message
v credencial
637
Attributes
Pseudo Esquema
<jms>?
<jsdl:JMSActionType
<jms>
Elemento connFactory
Definio
Esse elemento especifica um objeto administrado que um cliente usa para
criar uma conexo com o provedor JMS. Esse elemento necessrio e pode
Tipo
Attributes
Pseudo Esquema
<connFactory>
<connFactory>
Elemento destination
Definio
Esse elemento especifica um objeto administrado que encapsula a
identidade de um destino de mensagem, que onde as mensagens so
entregues e consumidas. Esse elemento necessrio e pode ser especificado
uma vez.
Multiplicidade
Tipo
Attributes
Pseudo Esquema
Elemento message
Definio
Esse elemento especifica um objeto que enviado de um aplicativo para
outro. Esse elemento necessrio e pode ser especificado uma vez.
Tipo
Attributes
Pseudo Esquema
<message>
<message>
Elemento credential
Definio
Esse elemento especifica as credenciais necessrias para executar o
638
aplicativo J2EE. Inclua esse elemento quando quiser especificar um nome

de usurio sob o qual o aplicativo executado no sistema de destino que
diferente do nome de usurio sob o qual o agente de carga de trabalho
executado. Esse elemento opcional e pode ser especificado uma vez.
Tipo
O tipo desse elemento jsdl:CredentialType. Ele pode conter os elementos

a seguir:
v userName
v password
v JAASAuthenticationAlias
Attributes
Pseudo Esquema
<credential>?
<jsdl:CredentialType
<credential>
Elemento userName
Definio
Esse elemento especifica o nome de usurio de um usurio definido no
sistema de destino. O aplicativo J2EE executado usando esse nome de
usurio. Esse elemento necessrio se voc usar o elemento credential e
pode ser especificado uma vez. Para especificar o nome de usurio,
referncias de variveis, como ${var}, opcionalmente em associao com
qualquer caractere ou com uma sequncia simples. Se voc escolher um
invocador indireto, use esse elemento para especificar o nome de usurio
necessrio para conectar ao planejador do WebSphere Application Server.
Tipo
Attributes
Pseudo Esquema
<userName>
<jsdl:NotEmptyStringVariableExpressionType
<userName>
Elemento password
Definio
Esse elemento especifica a senha do nome de usurio especificado que
usado para executar o aplicativo J2EE no sistema de destino. Esse elemento
opcional e pode ser especificado uma vez. Para especificar a senha,
referncias de variveis, como ${var}, qualquer caractere e qualquer
sequncia. Se voc escolher um invocador indireto, use esse elemento para
especificar a senha necessria para conectar ao planejador do WebSphere
Application Server.
Tipo
Attributes
639
Pseudo Esquema
<password>
<password>
Elemento JAASAuthenticationAlias
Definio
Esse elemento especifica o alias de autenticao de JAAS. Esse elemento
opcional e pode ser especificado uma vez. necessrio somente ao usar
um invocador indireto. Para especificar o alias, possvel usar uma
expresso de varivel que pode conter uma ou mais referncias de
variveis, como ${var}, opcionalmente em associao com qualquer
caractere ou com uma sequncia simples.
Tipo
Attributes
Pseudo Esquema
<JAASAuthenticationAlias>
<jsdl:NotEmptyStringVariableExpressionType
<JAASAuthenticationAlias>
Recursos na Definio de Tarefa

Este tpico fornece uma viso geral de como os recursos e suas propriedades so
utilizados na definio de tarefa para identificar os possveis destinos, para
reservar as alocaes de recursos consumveis e para otimizar o balanceamento de
carga entre os recursos disponveis.
Um entendimento dos recursos fsicos e lgicos e suas propriedades a chave para
criar uma definio de tarefa que focaliza exatamente os recursos adequados para
executar a tarefa, determina o requisito de alocao de recursos e contribui para o
balanceamento da carga entre os recursos disponveis. Cada recurso possui uma ou
mais propriedades associadas a ele. As propriedades podem ter as seguintes
caractersticas:
consumvel
As propriedades de recursos que so consumveis possuem uma
quantidade finita associada a eles que podem ser consumidas pelas tarefas
que so alocadas para o recurso. Por exemplo, um sistema de computador
possui um nmero finito de processadores.
Pode ser otimizado
Algumas propriedades podem ser usadas para definir a otimizao de
objetivos, que determina como a carga deve ser equilibrada quando as
tarefas forem alocadas para um grupo de recursos. Por exemplo, possvel
escolher alocar uma tarefa para o recurso correspondente que possua uso
de CPU mais baixo.
Suporta Caracteres Curinga
Algumas propriedades podem ser especificadas na definio de tarefa
usando curingas. Por exemplo, um requisito para uma determinada srie
de modelos de computadores pode ser definido ao especificar o modelo
usando curingas.
640
A Tabela 95 mostra os diferentes tipos de recursos que podem ser includos em

uma definio de tarefa e suas propriedades disponveis.
Tabela 95. Tipos e Propriedades de Recursos
Tipo de Recurso
Propriedades
Disponveis
consumvel
Pode ser otimizado
Suporta Caracteres
Curinga
ComputerSystem
CPUUtilization
No
Sim
No
HostName
No
No
Sim
Fabricante
No
No
Sim
Modelo
No
No
Sim
NumOfProcessors
Sim
Sim
No
ProcessingSpeed
No
Sim
No
ProcessorType
No
No
No
DisplayName
No
No
Sim
SubType
No
No
Sim
Quantidade
Sim
Sim
No
DisplayName
No
No
Sim
FreePhysicalMemory
No
Sim
No
FreeSwapSpace
No
Sim
No
FreeVirtualMemory
No
Sim
No
OperatingSystemType No
No
No
OperatingSystem
Verso
No
No
No
TotalPhysicalMemory Sim
Sim
No
TotalSwapSpace
Sim
Sim
No
TotalVirtualMemory
Sim
Sim
No
DisplayName
No
No
Sim
FileSystemRoot
No
No
Sim
FileSystemType
No
No
No
FreeStorageCapacity
No
Sim
No
TotalStorageCapacity
Sim
Sim
No
NetworkAddress
No
No
No
NetworkSystem
HostName
No
No
Sim
LogicalResource
OperatingSystem
FileSystem
NetworkSystem
641
642
Apndice C. Referncia rpida para comandos

Este apndice est dividido em quatro sees:
v Gerenciando o Plano
v Gerenciando objetos no banco de dados na pgina 644
v Gerenciando objetos no plano na pgina 652
v Comandos utilitrios na pgina 658
v Comandos de relatrio na pgina 661
Gerenciando o Plano
Esta seo descreve as operaes que podem ser executadas contra o plano
utilizando o script JnextPlan e a linha de comandos planman:
Tabela 96. Comandos Utilizados Contra o Plano
Sintaxe do Comando ou do Script
Ao Executada
JnextPlan [-from mm/dd/[yy]yy[hhmm[tz | timezone tzname]]]
Cria ou estende o plano de

produo.

planman [connection_parameters] crt
Cria um plano de produo

intermedirio.

planman [connection_parameters] deploy [-scratch]
Implementa todas as regras

que no estejam no estado
de rascunho.
planman [connection_parameters] ext
Cria um plano
intermedirio para uma
extenso de plano.

planman [connection_parameters] showinfo
planman [connection_parameters] crttrial file_name
Recupera as informaes do
plano de produo.
Cria um plano trial.

643
Tabela 96. Comandos Utilizados Contra o Plano (continuao)

Sintaxe do Comando ou do Script
Ao Executada
planman [connection_parameters] exttrial file_name
Cria um plano trial de uma

extenso de plano de
produo.

planman [connection_parameters] crtfc file_name
Cria um plano de previso.

planman [connection_parameters] unlock
Desbloqueia o plano de
produo.
ResetPlan [connection_parameters] [-scratch]
Reconfigura o plano de
produo.
em que connection_parameters so o seguinte:

[-file filename]
[-host hostname]
[-port port_name]
[-protocol protocol_name][-proxy proxy_name]
[-proxyport proxy_port_number]
[-password user_password]
[-timeout seconds]
[-username user_name]
Para obter informaes adicionais, consulte a Criando e estendendo o plano de

produo na pgina 76.
Gerenciando objetos no banco de dados

A seo est dividida nas seguintes subsees:
v Comandos de Objetivo Geral
v Objetos de Planejamento na pgina 645
v Comandos do Composer na pgina 649
Comandos de Objetivo Geral

Esta seo descreve os nomes, a sintaxe dos comandos de objetivo geral que so
executados a partir do programa composer e a autorizao do usurio, quando
necessria, para sua execuo.
Tabela 97. Comandos de Objetivo Geral
644
Comando
Sintaxe
Autorizao do
Usurio
continue
continue&command argument&command argument
Autorizao para
utilizar o
composer
Tabela 97. Comandos de Objetivo Geral (continuao)

Comando
Sintaxe
Autorizao do
Usurio
editar
edit filename
Autorizao para
utilizar o
composer
exit
exit
Autorizao para
utilizar o
composer
help
help commandname
Autorizao para
utilizar o
composer
redo
redo directives
Autorizao para
utilizar o
composer
validate
validate filename [;syntax]
Autorizao para
utilizar o
composer
verso
verso
Autorizao para
utilizar o
composer
Objetos de Planejamento
Esta seo contm a sintaxe de definio de todos os objetos de planejamento.
Na tabela que exibe a lista de comandos que podem ser utilizados com o objeto de
planejamento, filename indica um arquivo existente quando utilizado na sintaxe
para os comandos add e replace, indica um arquivo no existente quando utilizado
na sintaxe para o comando create/extract.
Calendar
Sintaxe de definio do arquivo:
$calendar
calendarname [description]
date [...]
Domnio
domain domainname[description description]
[parent domainname | ismaster]
end
Regra de Evento
Sintaxe de definio XML:
v eventRule name=" " ruleType=" " isDraft=" " (1, 1)
description (0, 1)
timeZone (0, 1)
validity from=" " to=" " (0, 1)
activeTime start=" " end=" " (0, 1)
645
timeInterval amount=" " unit=" " (0, 1)

eventCondition eventProvider=" " eventType=" " (1, n)
- scope (0, 1)
- filteringPredicate (0, 1)
v attributeFilter name=" " operator="eq" (0, n)
value (1, n)
v attributeFilter name=" " operator="ne" (0, n)
value (1, n)
v attributeFilter name=" " operator="le" (0, n)
value (1, 1)
v attributeFilter name=" " operator="ge" (0, n)
value (1, 1)
v attributeFilter name=" " operator="range" (0, 1)
value (1, 2)
correlationAttributes (0, 1)
- attribute name=" " (1, n)
action actionProvider=" " actionType=" " responseType=" " (0, n)
- description (0, 1)
- scope (0, 1)
- parameter name=" "(1, n)
- value (1, 1)
Tarefa
$jobs
{scriptname filename | docommand command | task job_definition}
[tasktype tasktype]
[interactive]1
[recovery
|
|
|
|
|
|
|
|
|
|
|
|
Nota:
1. Esta palavra-chave est disponvel somente na plataforma
Windows.
Fluxo de Tarefas
schedule [workstation#]jobstreamname
# comment
[validfrom date]
[description text]
[draft]
[freedays calendarname [-sa] [-su]]
[on [runcycle name]
646
[description text]
[({at time [+n day[s]] |
schedtime time [+n day[s]]}
[until time [+n day[s]] [onuntil action]]
[deadline time [+n day[s]]])]]
[,...]
[except [runcycle name]
[description text]
[{(at time [+n day[s]])] |
(schedtime time [+n day[s]])}]
[,...]
[{at time [timezone|tz tzname] [+n day[s][absolute|abs]] |
schedtime time [timezone|tz tzname] [+n day[s]]}]
[until time [timezone|tz tzname] [+n day[s]] [onuntil action][absolute|abs]]
[deadline time [timezone|tz tzname] [+n day[s]]]
[carryforward]
[matching {previous|sameday|relative from [+ | -] time to [+ | -] time|
from time [+ | -n day[s]] to time [+ n day[s]] [,...]}]
[follows {[netagent::][workstation#]jobstreamname[.jobname |@] [previous|
sameday|relative from [+|-] time to [+|-] time|
]} ] [,...]] [...]
[keysched]
[limit joblimit]
:
job-statement
# comment
schedtime time [timezone|tz tzname] [+n day[s]]}][,...]
[until time [timezone|tz tzname] [+n day[s]] [onuntil action]
[deadline time [timezone|tz tzname] [+n day[s]]] [,...]
[every rate]
[follows {[netagent::][workstation#]jobstreamname{.jobname @} [previous|
sameday|relative from [+|-] time to [+|-] time |
]} ] [,...]] [...]
[confirmed]
[critical]
[keyjob]
[job-statement...]
end
647
Parmetro
$parm
[tablename.]variablename variablevalue
Aviso
$prompt
promptname [: | !]text
Recurso
$resource
workstation#resourcename units [description ]
Tabela de Variveis
vartable tablename
[isdefault]
members
...
end
Estao de Trabalho
"description"]
os os-type
[node hostname] [tcpaddr port]
[domain domainname]
[for maestro
[host host-workstation [access method]]
[type fta | s-agent | x-agent | manager | broker | agent |
pool | d-pool |
rem-engine]
[ignore]
[autolink on | off]
[server serverid]]
[protocol http | htpps]
[members [workstation] [...]]
[requirements jsdl_definition]]
end
648

description]
os os-type
node hostname [tcpaddr port]
[domain domainname]
[for maestro
[host host-workstation [access method]]
[type fta | s-agent | x-agent | manager]
[ignore]
[autolink on | off]
[server serverid]]
end
Classe de Estao de Trabalho

cpuclass workstationclass [description "description"]
[ignore]
members [workstation | @] [...]
end
Definio do Usurio
username[workstation#][domain\]username
password passwordend
Comandos do Composer
Esta seo descreve as operaes que podem ser executadas no banco de dados
utilizando o programa de interface de linha de comandos composer com a sintaxe:
composer [connection_parameters] [-defaultws twscpu]
["command[&[command]][...]"]
em que connection_parameters, se no forem fornecidos nos arquivos localopts ou

useropts, so os seguintes:
[-file filename]|
[-host hostname]
[-port port_name]
[-protocol protocol_name]
[-proxy proxy_name]
[-timeout seconds]
Consulte Configurando Opes para Utilizao das Interfaces com o Usurio na

pgina 50 para obter detalhes adicionais.
Essas operaes podem ser executadas somente a partir da linha de comandos do
cliente composer instalado.
649
Na Tabela 98 que exibe a lista de comandos que podem ser utilizados com o objeto
de planejamento, filename indica um arquivo existente quando utilizado na sintaxe
para os comandos add e replace, indica um arquivo no existente quando utilizado
na sintaxe para o comando create/extract.
Tabela 98. Comandos do Composer
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
650
Comando
Sintaxe
Autorizao do
Usurio
add
{add | a} filename [;unlock]
add ou modify
authenticate
{authenticate | au} [username=username password=password]
continue
{continue | c}
create extract
{create | cr | extract | ex} filename from

[cpu={workstationame | workstationclassname | domainame}] |
[;full]] |
[;lock]
display
excluir
{delete | de}
[cpu={workstationame [;force]
| workstationclassname [;force]|
domainame}]
[workstation | ws=workstationame] [;force] |
[workstationclass | wscl=workstationclassname] [;force] |
] |
[;noask]
delete
display
{display | di}
[parms | parm | vb=variablename.]variablename] |
[;full]] |
[;offline]
display
editar
{edit | ed} filename
exit
{exit | e}
Tabela 98. Comandos do Composer (continuao)

Autorizao do
Usurio
Comando
Sintaxe
list print
{list | l}
[valid from date|
valid to date |valid in date date] |
[;offline]
display
lock
{lock | lo}
[eventrule | erule | er=eventrulename]
modify
modify
{modify | m}
[;full]] |
modify ou add
novo
new
[calendar |
domain |
eventrule |
job |
jobstream |
parameter |
prompt |
resource |
user |
vartable |
workstation |
workstation_class]
add ou modify
651
Tabela 98. Comandos do Composer (continuao)

Autorizao do
Usurio
Comando
Sintaxe
renomear
{rename | rn}
{calendars|calendar|cal |
parms|parm|vb |
vartable|vt |
prompts|prom |
resorces|resource|res |
workstation|ws |
workstationclass|wscl |
domain|dom |
jobs|jobdefinition|jd |
jobsched|jb |
eventrule|erule|er
sched|jobstream|js
|
users|user }
old_object_identifier new_object_identifier
add e delete
replace
{replace | rep} filename [;unlock]
modify ou add
destravar
{unlock | u}
[;forced]
modify e unlock
validate
{validate | val} filename [;syntax]
Gerenciando objetos no plano

Esta seo descreve as operaes que podem ser executadas no plano utilizando o
programa de interface de linha de comandos do conman com a sintaxe:
conman ["command[&[command]...] [&]"]
Comandos do Conman
Esta seo lista os comandos que podem ser executados a partir do programa
conman.
Essa a forma como voc acessa a linha de comandos conman:
conman
[connection_parameters] ["command[&[command]...]
[&]"]
em que connection_parameters, se no forem fornecidos nos arquivos localopts ou

useropts, so os seguintes:
[-file filename]
[-host hostname]
[-port port_name]
[-protocol protocol_name]
[-proxy proxy_name]
652
[-timeout seconds]
Consulte Configurando Opes para Utilizao das Interfaces com o Usurio na

pgina 50 para obter detalhes adicionais.
Esse a forma como voc seleciona tarefas em comandos:
[workstation#]
{jobstreamname(hhmm[date]) job|jobnumber}
[{+|~}jobqualifier[...]]
ou:
[workstation#]
jobstream_id.
tarefa
[{+|~]jobqualifier[...]]
;schedid
Essa a forma como voc seleciona fluxos de tarefas em comandos:

[workstation#]
jobstreamname(hhmm[date])
[{+|~}jobstreamqualifier[...]]
ou:
[workstation#]
jobstream_id
;schedid
possvel executar esses comandos a partir de diferentes tipos de estaes de

trabalho. Nesta tabela:
F
significa gerenciadores de domnios e agentes tolerantes a falhas.
significa agentes padro.
Para cada comando voc localiza o nome, a sintaxe, o tipo de estao de trabalho a
partir de onde possvel emitir o comando e a autorizao necessria, se houver.
Tabela 99. Comandos que Podem Ser Executados a partir de Conman
Comando
Sintaxe
Tipos de
estao de
trabalho
Autorizao do
Usurio
adddep job
{adddep job | adj} jobselect

[;dependency[;...]]
[;noask]
adddep - (use ao
utilizar prompts e
needs)
adddep sched
{adddep sched | ads} jstreamselect

[;dependency[;...]]
[;noask]
adddep - (use ao
utilizar prompts e
needs)
altpass
altpass
[workstation#]
username
[;"password"]
altpass
altpri
{altpri | ap} jobselect | jstreamselect

[;pri]
[;noask]
altpri
653
Tabela 99. Comandos que Podem Ser Executados a partir de Conman (continuao)
Comando
Sintaxe
Tipos de
estao de
trabalho
Autorizao do
Usurio
bulk_discovery
{bulk_discovery | bulk}
display
cancel job
{cancel job | cj} jobselect

[;pend]
[;noask]
cancel
cancel sched
{cancel sched | cs} jstreamselect

[;pend]
[;noask]
cancel
checkhealthstatus {checkhealthstatus | chs} [workstation]
M,F,S
confirmar
{confirm | conf} jobselect

;{succ | abend}
[;noask]
confirmar
console
{console | cons}
[sess | sys]
[;level=msglevel]
F-S
console
continue
{continue | cont}
F-S
deldep job
{deldep job | ddj} jobselect

;dependency[;...]
[;noask]
deldep
deldep sched
{deldep sched | dds} jstreamselect

;dependency[;...]
[;noask]
deldep
deployconf
{deployconf | deploy} [domain!]workstation
F,S
Permisso para
aes start nos
objetos cpu
display
{display file | df} filename [;offline]
F-S1
display
{display job | dj} jobselect [;offline]

{display sched | ds} jstreamselect
[valid {at date | in date date}
[;offline]
exit
{exit | e}
F-S
limite
{fence | f} workstation
;pri
[;noask]
help (somente
para UNIX)
F-S
kill
{kill | k} jobselect
[;noask]
kill
limit cpu
{limit cpu | lc } workstation

;limit
[;noask]
limite
limit sched
{limit sched | ls } jstreamselect

;limit
[;noask]
limite
link
{link | lk} [domain!]workstation

[;noask]
F-S
link
654
fence
Comando
Sintaxe
Tipos de
estao de
trabalho
Autorizao do
Usurio
listsym
{listsym | lis} [trial | forecast]

[;offline]
recall
{recall | rc} [workstation]

[;offline]
redo
{redo | red}
F-S
release job
{release job | rj} jobselect

[;dependency[;...]]
[;noask]
release
release sched
{release sched | rs} jstreamselect

[;dependency[;...]]
[;noask]
release
reply
{reply | rep}
{ promptname | [workstation#]msgnum}
;responder
[;noask]
reply
reexecutar

[;from=[wkstat#]job[
;at=time]
[;pri=pri]]
[;noask]
[;step=step]
[;noask]
rerun
resource
{resource | res} [workstation#]

resource;num
[;noask]
resource
setsym
{setsym | set} [trial | forecast] [filenum]
showcpus
{showcpus | sc} [[domain!]workstation]

[;info|;link]
[;offline]
F-S
list2
showdomain
{showdomain | showd} [domain]

[;info]
[;offline]
F-S
list2
showfiles

[;state[;...]]
[;keys]
[;offline]
[;state[;...]]
[;offline]
display
655
Comando
Sintaxe
Tipos de
estao de
trabalho
Autorizao do
Usurio
showjobs

[;short | single]
[;offline]
[;showid]
[;props]
{showjobs | sj} [jobselect |
[workstation#]jobnumber.hhmm]
[;stdlist[;keys]]
[;short | single]
[;offline]
[;showid]
[;props]
list2
showprompts

[;keys]
[;offline]
[;deps[;keys | info | logon]][;offline]
list2
showresources

[;keys]
[;offline]
[;offline]
list2
showschedules

[;keys]
[;offline]
[;showid]
[;offline]
[;showid]
list2
shutdown
{shutdown | shut} [;wait]
F-S
shutdown
incio
start [domain!]workstation
[;mgr]
[;noask]
[;demgr]
F-S
start
startappserver
startappserver[domain!]workstation
[;wait]
F-S
Permisso para
aes start nos
objetos cpu
startevtp
{starteventprocessor | startevtp} [domain!]workstation
M4
Permisso para
aes start nos
objetos cpu
startmon
{startmon | startm} [domain!]workstation

[;noask]
F-S
Permisso para
aes start nos
objetos cpu
status
{status | stat}
F-S
appserver
parar
stop [domain!]workstation
[;wait]
[;noask]
F-S
parar
stop ;progressive
stop ;progressive
656
parar
Comando
Sintaxe
Tipos de
estao de
trabalho
Autorizao do
Usurio
stopappserver
{stopappserver | stopapps} [domain!]workstation

[;wait]
F-S
Permisso para
aes stop nos
objetos cpu
stopevtp
{stopeventprocessor | stopevtp} [domain!][workstation]
M4
Permisso para
aes stop nos
objetos cpu
stopmon
{stopmon | stopm} [domain!]workstation

[;wait]
[;noask]
F-S
Permisso para
aes stop nos
objetos cpu
submit
docommand
{submit docommand | sbd} [workstation#]"cmd"

[;alias[=name]]
[;into=[workstation#]
{jobstream_id;schedid |jobstreamname (hhmm[ date])}]
[;joboption[;...]]
F-S
submit - (use ao
utilizar prompts e
needs)
submit file
{submit file | sbf} "filename"

F-S
[;alias[=name]]
[;into=[workstation#]{jobstream_id ;schedid |jobstreamname
(hhmm[ date])}]
[;joboption[;...]]
[;noask]
submit - (use ao
utilizar prompts e
needs)
submit job
{submit job | sbj} [workstation#]jobname

[;alias[=name]]
[;into=[workstation#]{jobstream_id ;schedid |
jobstreamname(hhmm[ date])}]
[;joboption[;...]]
[;noask]
F-S3
submit - (use ao
utilizar prompts e
needs)
submit sched
{submit sched | sbs} [workstation#]jstreamname

[;alias[=name]]
[;jstreamoption[;...]]
[;noask]
F-S3
submit - (use ao
utilizar prompts e
needs)
switchevtp
{switcheventprocessor | switchevtp} workstation
M4
Permisso para
aes start e stop
nos objetos cpu
switchmgr
{switchmgr | switchm} domain;newmgr
start stop
system
F-S
tellop
{tellop | to} [text]
F-S
unlink
unlink [domain!]workstation
[;noask]
F-S
verso
{version | v}
F-S
unlink
onde:
(1)
Indica que s possvel exibir arquivos em um agente padro.
(2)
Voc deve ter acesso list para o objeto que est sendo mostrado se a opo
enListSecChk tiver sido configurada para yes no gerenciador de domnios
principal quando o plano de produo tiver sido criado ou estendido.
(3)
Indica que possvel utilizar subimt job (sbj) e submit sched (sbs) em um
657
agente padro, utilizando os parmetros de conexo ou especificando as

configuraes no arquivo useropts ao chamar a linha de comandos
conman.
(4)
possvel utilizar este comando em gerenciadores de domnio principais e

principais de backup bem como em estaes de trabalho instaladas como
principais de backup mas utilizadas como agente tolerante a falhass
comuns.
Comandos utilitrios
Esta seo contm a lista dos comandos utilitrios que podem ser executados a
partir do prompt de comandos do sistema operacional. Os comandos utilitrios so
divididos em trs grupos, aqueles que podem ser executados nos sistemas
operacionais UNIX e Windows, aqueles que podem ser executados somente no
UNIX e aqueles que podem ser executados no Windows.
Comandos utilitrios disponveis para os sistemas operacionais UNIX e
Windows
Tabela 100. Comandos Utilitrios Disponveis para o UNIX e o Windows
Comando
s
Sintaxe
at -V | -U
at -s jstream | -q queue time-spec
batch
batch -V | -U
batch [-s jstream]
cpuinfo
cpuinfo -V | -U
cpuinfo workstation [infotype] [...]
datecalc
datecalc -V | -U
datecalc base-date [offset] [pic format][freedays Calendar_Name [-sa]
[-su]]
datecalc -t time [base-date] [offset] [pic format]
datecalc yyyymmddhhtt [offset] [pic format]
excluir
delete -V | -U
delete filename
evtdef
evtdef -U | -V
evtdef [connection parameters] dumpdef file-path
evtdef [connection parameters] loaddef file-path
658
Tabela 100. Comandos Utilitrios Disponveis para o UNIX e o Windows (continuao)

Comando
evtsize
Sintaxe
evtsize -V | -U
evtsize filename size
evtsize -compact filename [size]
evtsize -info filename
evtsize -show filename
evtsize -info | -show pobox
jobinfo
jobinfo -V | -U
jobinfo job-option [...]
jobstdl
jobstdl -V | -U
jobstdl [-day
num] [{-first | -last | -num n | -all}] [-twslog]
[{-name ["jobstreamname [(hhmm
date),(jobstream_id)].]jobname"|jobnum
|
maestro
makecal
maestro [-V | -U]

makecal [-c name] -d n | -e | {-f 1 | 2 | 3 -s date} | -l | -m | -p n |
{-r n -s date} | -w n [-i n] [-x | -z][-freedays Calendar_Name [-sa] [-su]]
morestdl
morestdl -V | -U
morestdl [-day
num] [-first | -last | -num n | -all] [-twslog]
[{-name ["jobstreamname [(hhmm
date),(jobstream_id)].]jobname"|jobnum
|
parms
parms {[-V | -U] | -build}

parms {-replace |
-extract} filename
parms [-d]parameternameparms -c
release
parametername value
release -V | -U
release [-s] [workstation#]resourcename [count]
rmstdlist
rmstdlist -V | -U
rmstdlist [-p] [age]
659
Tabela 100. Comandos Utilitrios Disponveis para o UNIX e o Windows (continuao)

Comando
sendevent
Sintaxe
sendevent -V | ? | -help | -U | -usage
sendevent [-hostname hostname][-port port] eventType source
[[attribute=value]...]
showexec
showexec [-V | -U | INFO]
ShutDownLwa
ShutDownLwa
StartUp
StartUp [-V | -U]
StartUpLwa
StartUpLwa
tws_inst_pull_info
tws_inst_pull_info -twsuser userid -log_dir_base path [-u |

[-run_db2_module [y|n] | -extract_db_defs [y|n] | -date yyyymmdd]
Comandos utilitrios disponveis somente para o sistema operacional UNIX

Tabela 101. Comandos Utilitrios Disponveis somente para o UNIX
Comando
s
Sintaxe
at -V | -U
at -sjstream | -qqueuetime-spec
batch
batch -V | -U
batch [-s jstream]
showexec
verso
showexec [-V | -U | -info]

version -V | -U | -h
version [-a] [-f vfile] [file [...]]
Comandos utilitrios disponveis somente para o sistema operacional Windows

Tabela 102. Comandos Utilitrios Disponveis somente para o Windows
Comando
Sintaxe
listproc
listproc
(NO
SUPORTADO)
killproc
killproc pid
(NO
SUPORTADO)
shutdown
660
shutdown [-V | -U] [-appsrv]
Comandos de relatrio
Esta seo contm uma lista e a sintaxe de comandos de relatrio e de programas
de extrao de relatrios. Esses comandos so executados a partir do prompt de
comandos do sistema operacional.
Comandos de relatrio
Tabela 103. Comandos de relatrio
Per.
rep1
rep2
rep3
rep4a
rep4b
rep7
rep8
sada produzida
Relatrio 01 - Listagem
de Detalhes do Job
do Prompt
de Calendrio
Relatrio 04A Listagem de Parmetro
Relatrio 04B Listagem de Recurso
do Histrico do Job
Relatrio 08 Histograma do Job
Sintaxe
rep[x] [-V|-U]
rep[x] [-V|-U]
rep[x] [-V|-U]
rep[x] [-V|-U]
rep[x] [-V|-U]
rep7 -V|-U
rep7 [-c wkstat] [-s jstream_name] [-j job] [-f date -t date]
[-l]
rep8 -V|-U
rep8 [-f date -b time -t date -e time] [-i file] [-p ]
rep8 [-b time -e time] [-i file] [-p ]
rep11
reptr
Relatrio 11 Agendamento de
Produo Planejada
rep11 -V|-U
rep11 [-mmm[yy] [...]] [-c wkstat [...]] [-s jstream_name] [-o
output]
Relatrio 09A - Resumo reptr [-V|-U]

de Produo Planejada
reptr -pre [-{summary| detail}] [symfile]
Relatrio 09B - Detalhe
de Produo Planejada reptr -post [-{summary |detail}] [logfile]
Relatrio 10A - Resumo
de Produo Real
Relatrio 10B - Detalhe
de Produo Real
xref
Relatrio 12 - Relatrio
de Referncia Cruzada
xref [-V|-U]
xref [-cpu wkstat] [-s jstream_name] [-depends|-files|jobs|-prompts|-resource|-schedules|-when [...]]
661
Programas de Extrao de Relatrio

Tabela 104. Programas de Extrao de Relatrio
Programa
Utilizado Sintaxe
de Extrao para gerar
jbxtract
Relatrio
01
jbxtract [-V | -U] [-j job] [-c wkstat] [-o output]
Relatrio
07
prxtract
Relatrio
02
prxtract [-V | -U] [-o output]

prxtract[-V | -U] [-m mm[yyyy]] [-c wkstat] [-o output]
662
caxtract
Relatrio
03
caxtract [-V | -U] [-o output]
paxtract
Relatrio
04A
paxtract [-V | -U] [-o output]
rextract
Relatrio
04B
rextract [-V | -U] [-o output]
r11xtr
Relatrio
11
xrxtrct
Relatrio
12
r11xtr [-V | -U] [-m mm[yyyy]] [-c wkstat] [-o output] [-s
jstream_name]
xrxtrct [-V | -U]
Apndice D. Acessibilidade
Os recursos de acessibilidade ajudam usurios com deficincias fsicas, como
mobilidade restrita ou viso limitada, a usar os produtos de software com xito. Os
principais recursos de acessibilidade neste produto permitem que os usurios
faam o seguinte:
v Utilizem tecnologias assistidas, como software de leitor de tela e sintetizador de
voz digital, para ouvir os itens que so exibidos na tela. Consulte a
documentao do produto de tecnologia assistida para obter detalhes sobre
como utilizar essas tecnologias com este produto.
v Operem recursos especficos ou equivalentes usando apenas o teclado.
v Ampliem os itens que so exibidos na tela.
Alm disso, a documentao do produto foi modificada para incluir recursos que
auxiliam na acessibilidade:
v Toda a documentao est disponvel nos formatos HTML e PDF que podem ser
convertidos para permitir que os usurios apliquem o software de leitor de tela.
v Todas as imagens na documentao so fornecidas com texto alternativo para
que os usurios com problemas visuais possam entender o contedo das
imagens.
Navegando na Interface Utilizando o Teclado

O atalho padro e as teclas aceleradoras so usados pelo produto e documentados
pelo sistema operacional. Consulte a documentao fornecida pelo sistema
operacional para obter informaes adicionais.
O painel Editor de Regra de Evento o nico que no permite operaes apenas
pelo teclado e o CSS no pode ser desativado. No entanto, como alternativa,
possvel desempenhar todas as operaes disponveis nesse painel, ativando o
comando composer a partir da interface da linha de comandos.
Ampliando o Que Est Exibido na Tela

possvel ampliar as informaes nas janelas do produto usando os recursos
fornecidos pelos sistemas operacionais nos quais o produto est sendo executado.
Por exemplo, em um ambiente Microsoft Windows, possvel diminuir a resoluo
da tela para ampliar os tamanhos das fontes do texto na tela. Consulte a
documentao fornecida pelo sistema operacional para obter informaes
adicionais.
663
664
Avisos
Estas informaes foram desenvolvidas para produtos e servios oferecidos nos
Estados Unidos. possvel que a IBM no oferea os produtos, servios ou
recursos discutidos nesta publicao em outros pases. Consulte um representante
IBM local para obter informaes sobre produtos e servios disponveis atualmente
em sua rea. Qualquer referncia a produtos, programas ou servios IBM no
significa que apenas produtos, programas ou servios IBM possam ser utilizados.
Qualquer produto, programa ou servio funcionalmente equivalente que no
infrinja nenhum direito de propriedade intelectual da IBM poder ser utilizado.
Entretanto, a avaliao e verificao da operao de qualquer produto, programa
ou servio no-IBM so de inteira responsabilidade do Cliente.
A IBM pode ter patentes ou solicitaes de patentes pendentes relativas a assuntos
tratados nesta publicao. O fornecimento desta publicao no lhe garante direito
algum sobre tais patente. Pedidos de licena devem ser enviados, por escrito, para:
Gerncia de Relaes Comerciais e Industriais da IBM Brasil
Av. Pasteur, 138-146
Botafogo
Rio de Janeiro, RJ
CEP: 22290-240
Para pedidos de licena relacionados a informaes de DBCS (Conjunto de
Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade
Intelectual da IBM em seu pas ou envie pedidos de licena, por escrito, para:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106
Japan
O pargrafo a seguir no se aplica a nenhum pas em que tais disposies no
estejam de acordo com a legislao local:
A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA
PUBLICAO NO ESTADO EM QUE SE ENCONTRA, SEM GARANTIA DE
NENHUM TIPO, SEJA EXPRESSA OU IMPLCITA, INCLUINDO, MAS A ELAS
NO SE LIMITANDO, AS GARANTIAS IMPLCITAS (OU CONDIES) DE
NO INFRAO, COMERCIALIZAO OU ADEQUAO A UM
DETERMINADO PROPSITO.
Alguns pases no permitem a excluso de garantias expressas ou implcitas em
certas transaes; portanto, esta disposio pode no se aplicar ao Cliente.
Essas informaes podem conter imprecises tcnicas ou erros tipogrficos.
Periodicamente, so feitas alteraes nas informaes aqui contidas; tais alteraes
sero incorporadas em novas edies da publicao. A IBM pode, a qualquer
momento, aperfeioar e/ou alterar os produtos e/ou programas descritos nesta
publicao, sem aviso prvio.
665
Referncias nestas informaes a Web sites no-IBM so fornecidas apenas por

convenincia e no representam de forma alguma um endosso a estes Web sites.
Os materiais contidos nesses Web sites no fazem parte dos materiais desse
produto IBM e a utilizao desses Web sites de inteira responsabilidade do
Cliente.
A IBM pode utilizar ou distribuir as informaes fornecidas da forma que julgar
apropriada sem incorrer em qualquer obrigao para com o Cliente.
Licenciados deste programa que desejam obter informaes sobre este assunto com
objetivo de permitir: (i) a troca de informaes entre programas criados
independentemente e outros programas (incluindo este) e (ii) a utilizao mtua
das informaes trocadas, devem entrar em contato com:
Botafogo
Rio de Janeiro, RJ
CEP 22290-240
Tais informaes podem estar disponveis, sujeitas a termos e condies
apropriadas, incluindo em alguns casos o pagamento de uma taxa.
O programa licenciado descrito nesta publicao e todo o material licenciado
disponvel so fornecidos pela IBM sob os termos do Contrato com o Cliente IBM,
Contrato de Licena do Programa Internacional IBM ou qualquer outro contrato
equivalente.
As informaes relativas a produtos no IBM foram obtidas junto aos fornecedores
dos respectivos produtos, de seus anncios publicados ou de outras fontes
disponveis publicamente. A IBM no testou estes produtos e no pode confirmar a
preciso de seu desempenho, compatibilidade nem qualquer outra reivindicao
relacionada a produtos no IBM. Dvidas sobre os recursos dos produtos no-IBM
devem ser encaminhadas diretamente a seus fornecedores.
Essas informaes contm exemplos de dados e relatrios utilizados nas operaes
dirias de negcios. Para ilustr-los da forma mais completa possvel, os exemplos
podem incluir nomes de indivduos, empresas, marcas e produtos. Todos estes
nomes so fictcios e qualquer semelhana com nomes e endereos utilizados por
uma empresa real mera coincidncia.
As informaes relativas a produtos no IBM foram obtidas junto aos fornecedores
dos respectivos produtos, de seus anncios publicados ou de outras fontes
disponveis publicamente. A IBM no testou estes produtos e no pode confirmar a
preciso de seu desempenho, compatibilidade nem qualquer outra reivindicao
relacionada a produtos no IBM. Dvidas sobre os recursos dos produtos no-IBM
devem ser encaminhadas diretamente a seus fornecedores.
Marcas registradas
IBM, o logotipo IBM e ibm.com so marcas registradas da International Business
Machines Corporation nos Estados Unidos e/ou em outros pases. Se estes e outros
termos com marca registrada IBM forem marcados em suas primeiras ocorrncias
nestas informaes com um smbolo de marca registrada ( ou ), estes smbolos
indicam marcas registradas ou de direito consuetudinrio nos EUA pertencentes
666
IBM no momento em que essas informaes foram publicadas. Tais marcas

registradas podem, tambm, ser registradas ou marcas registradas de direito
consuetudinrio em outros pases. Uma lista atual de marcas registradas da IBM
est disponvel na Web em "Informaes de Copyright e Marca Registrada" em
http://www.ibm.com/legal/copytrade.shtml.
Adobe e todas as marcas baseadas no Adobe so marcas ou marcas registradas da
Adobe Systems Incorporated nos Estados Unidos e/ou em outros pases.
Intel e Itanium so marcas ou marcas registradas da Intel Corporation ou de suas
subsidirias nos Estados Unidos e/ou outros pases.
Microsoft e Windows so marcas registradas da Microsoft Corporation nos Estados
Unidos e/ou em outros pases.
Java e todas as marcas registradas e logotipos com base em Java so marcas
registradas do Oracle e/ou seus afiliados.
Linux uma marca registrada da Linus Torvalds nos Estados Unidos e/ou em
outros pases.
UNIX uma marca registrada da The Open Group nos Estados Unidos e em
outros pases.
Outros nomes de empresas, produtos e servios podem ser marcas registradas ou
marcas de servio de terceiros.
Avisos
667
668
ndice Remissivo
A
abend
estado do fluxo de job 327
estado do job 320
abenp
estado do job 320
ao do acionador 12
access
agentes estendido e de rede 143
definio de estao de trabalho 143
acessibilidade xii, 663
action
elemento 627
add
estado do job 320
agent
agente da rede
amostra de cenrio 560
definio 559
redes 557
criar 561
gerenciando utilizando o
conman 562
estado EXTERNAL
ERROR 563
EXTRN 563
EXTERNAL 562
mtodo de acesso
arquivo de opes 559
mtodo de acesso netmth 559
referncia 557
viso geral 557
agente dinmico 5, 7
definindo usurio do Windows 183
iniciando 31
parando 31
agente estendido
definio 548
mtodo de acesso 548
arquivo de opes 551
executando 552
mensagens de resposta 550
resoluo de problemas 555
sintaxe 548
referncia 547
viso geral 548
agente padro
agente tolerante a falhas 5
allocation
elemento 620
alternando agentes estendidos
palavra-chave $MANAGER 143
palavra-chave $MASTER 143
ambiente de tarefa no AS/400 179
ambiente de tarefa no i5/OS 179
ambiente de tarefa no IBM i 179

annotation
elemento 606
API Java 21
aplicativo
elemento 609
appservman
parando 407
argumentos
elemento 632
arquitetura 25
arquivo Symphony
JnextPlan 76
plano de produo 68, 76
arquivos
at.allow 445
at.deny 445
Courier.msg 33
Intercom.msg 33
Mailbox.msg 33
NetReq.msg 33
PlanBox.msg 33
Server.msg 33
arquivos da caixa postal
Courier.msg 33
definindo o tamanho 455
Intercom.msg 33
Mailbox.msg 33
NetReq.msg 33
PlanBox.msg 33
Server.msg 33
ativao de horrio de incio da
previso 71
ativando
Comunicao SSL 147
fuso horrio 523
autolink
automatizando o processamento
plano de produo 95
automatizando o processamento do plano
fluxo de tarefa final 95
autostart monman 419
B
behindfirewall
definio de estao de trabalho
broker
C
calendrio
ciclo de execuo 4, 218
dias livres 4
feriados 4
cancel command 337
candidateCPUs
elemento 612
146
144
candidateHosts
elemento 611
candidateOperatingSystems
elemento 614
candidateResources
elemento 622
carryforward
palavras-chave do fluxo de tarefas 68
Personalizando 68
stageman 68
varivel 90
carryStates
varivel 68, 73
category
elemento 606
ciclo de execuo
anualmente 3
baseado em deslocamento 3
baseado em regra 3
calendrio 218
data 218
dia 218
dirio 3
dias livres 3
em 217
exclusivo 3, 4
icalendar 219
inclusivo 3, 4
semanal 3
simples 3
ciclo de execuo anual 3
ciclo de execuo baseado na regra 3
ciclo de execuo com base em
deslocamento 3
ciclo de execuo de dias livres 3
ciclo de execuo dirio 3
ciclo de execuo exclusivo 3
ciclo de execuo inclusivo 3
ciclo de execuo semanal 3
ciclo de execuo simples 3
ciclo de produo 53
gerenciando 53
identificando instncias do fluxo de
trabalho 56
linha de comandos planman 79
classe
estao de trabalho 8
classe da estao de trabalho 8
cdigo de retorno do usurio no
AS/400 179, 180
cdigo de retorno do usurio no
i5/OS 179, 180
cdigo de retorno do usurio no IBM
i 179, 180
cdigo de retorno no AS/400 179
cdigo de retorno no i5/OS 179
cdigo de retorno no IBM i 179
cdigos de retorno
executor de tarefa 181
tarefa com opes avanadas 181
tarefa de servios da Web 181
669
cdigos de retorno (continuao)

tarefa do banco de dados 181
tarefa Java 181
comando
logman 92
stageman 89
comando add 262
comando adddep job 332
comando adddep sched 333
comando altpass 335
comando altpri 336
comando at 442
varivel ATSCRIPT 443
comando authenticate 264
comando batch 442
comando bulk_discovery 337
comando cancel sched 339
comando caxtract 501
comando checkhealthstatus 341
comando confirm 341
comando console 342
comando continue (composer) 265
comando continue (conman) 343
comando cpuinfo 446
comando create 275
comando datecalc 448
comando deldep job 344
comando deldep sched 345
comando delete 265, 452
comando deployconf 346
comando display 269, 347
comando edit 274
comando evtdef 453
comando evtsize 455
comando exit 275, 350
comando extract 275
comando fence 350
comando help 279, 351
comando jbxtract 499
comando jobinfo 457
comando jobstdl 459, 464
comando kill 352
comando limit cpu 353
comando limit sched 355
comando link 355
comando list 280
comando listsym 358
comando lock 286
comando maestro 462
comando makecal 462
comando metronome 464, 475
comando modify 290
comando new 294
comando parms 466
comando paxtract 502
comando print 280
comando prxtract 500
comando r11xtract 503
comando recall 360
comando redo 296, 361
comando release 468
comando release job 362, 365
comando release sched 363
comando rename 297
comando rep1 481
comando rep11 485
comando rep2 481
670
comando rep3 481

comando rep4a 481
comando rep4b 481
comando rep7 482
comando rep8 483
comando replace 300
comando reptr 486
comando rerun 366
comando resetFTA 369
comando resource 370
comando rextract 502
comando rmstdlist 470
comando sendevent 471
comando setsym 371
comando showcpus 371
comando showdomain 378
comando showexec 472
comando showfiles 379
comando showjobs 382
comando showprompts 397
comando showresources 400
comando showschedules 402
comando shutdown 407
comando start 408
comando startappserver 410
comando starteventprocessor 411
comando startmon 412
comando StartUp 474
Comando StartUpLwa 474
comando status 413
comando stop 413
comando stop; progressive 415
comando stopappserver 416
comando stopeventprocessor 418
comando stopmon 419
comando submit docommand 419
comando submit file 423
comando submit job 426
comando submit sched 429
comando switcheventprocessor 433
comando switchmgr 434
comando tellop 436
comando unlink 437
comando unlock 301
comando validate 305
comando version 306, 439, 475
comando xref 487
comando xrxtrct 504
comandos
adddep job 332
adddep sched 333
altpass 335
altpri 336
s 442
batch 442
bulk_discovery 337
cancel job 337
cancel sched 339
caxtract 501
checkhealthstatus 341
confirmar 341
console 342
continue (composer) 265
continue (conman) 343
cpuinfo 446
datecalc 448
deldep job 344
comandos (continuao)
deldep sched 345
deployconf 346
display 347
evtdef 453
evtsize 455
excluir 452
exit 350
getmon 371
help 351
incio 408
jbxtract 499
jobinfo 457
jobstdl 459
kill 352
limit cpu 353
limit sched 355
limite 350
link 355
listsym 358
maestro 462
makecal 462
metronome 464, 475
morestdl 464
parar 413
parms 466
paxtract 502
prxtract 500
r11xtr 503
recall 360
redo 361
reexecutar 366
release 468
release job 362
release sched 363
rep1 481
rep11 485
rep2 481
rep3 481
rep4a 481
rep4b1 481
rep7 482
rep8 483
reply 365
reptr 486
resource 370
rextract 502
rmstdlist 470
sendevent 471
setsym 371
showcpus 371
showdomain 378
showexec 472
showfiles 379
showjobs 382
showprompts 397
showresources 400
showschedules 402
shutdown 407
startappserver 410
starteventprocessor 411
startmon 412
StartUp 474
StartUpLwa 474
status 413
stop ;progressive 415
stopappserver 416
comandos (continuao)
stopeventprocessor 418
stopmon 419
submit docommand 419
submit file 423
submit job 426
submit sched 429
switcheventprocessor 433
switchmgr 434
tellop 436
unlink 437
verso 439, 475
xref 487
xrxtrct 504
comandos de relatrio 479
Agendamento de Produo
Planejada 485
amostra da sada 495
alterando o formato de data 480
amostra da sadas 488
configurao 479
Detalhe da Produo Planejada
amostra da sada 493
Detalhe da Produo Real
amostra da sada 494
Detalhes da Produo Planejada 486
Detalhes da Produo Real 486
Histograma do Job 483
amostra da sada 493
lista de comandos 480
Listagem de Calendrios 481
amostra da sada 491
Listagem de Detalhes do Job 481
amostra da sada 488
Listagem de Histricos do Job 482
amostra da sada 492
Listagem de Parmetros 481
amostra da sada 492
Listagem de Prompts 481
amostra da sada 491
Listagem de Recursos 481
amostra da sada 492
programas de extrao 498
caxtract 501
jbxtract 499
paxtract 502
prxtract 500
r11xtr 503
rextract 502
xrxtract 504
Referncia Cruzada 487
amostra da sada 496
Resumo da Produo Planejada 486
Resumo da Produo Real 486
comandos utilitrios 441
alterando o formato de data 448
s 442
arquivo at.allow 445
arquivo at.deny 445
varivel ATSCRIPT 443
batch 442
criando calendrios 462
definindo eventos customizados 453
definindo o tamanho do arquivo da
caixa postal 455
enviando eventos customizados 471
excluindo arquivos 452
comandos utilitrios (continuao)

exibindo a verso do produto 475
exibindo arquivos da lista
padro 470
exibindo jobs em execuo 472
exibindo o contedo de arquivos da
lista padro 464
gerenciando parmetros
localmente 466
getting TWS_home path 462
inicializando o netman 474
liberando as unidades de
recursos 468
listando arquivos da lista padro 459
obtendo informaes da estao de
trabalho 446
obtendo informaes do job 457
obtendo relatrios HTML 464, 475
removendo arquivos da lista
padro 470
shutdown 473
ShutDownLwa 473
composer
linha de comando 20
computador
resource 640
comunicao de rede 34
incio do dia 34
processamento de tarefa 34
Comunicao SSL
ativando 147
conexo
definio 567
configurao
relatrio de linha de comandos 517
configuraes de log no AS/400 178
configuraes de log no i5/OS 178
configuraes de log no IBM i 178
configurando
propriedades locais 39
conjunto 5, 7
definindo 135
estao de trabalho 145
conjunto dinmico 5, 8
definindo 135
conman
linha de comando 20
JnextPlan 78
connFactory
elemento 638
convenes, tipo de caractere xiii
convenes de fonte xiii
convenes utilizadas em
publicaes xii
Courier.msg 33
cpu
elemento 613
cpuclass
definio de classe de estao de
trabalho 152
cpuname
CreatePostReports
JnextPlan 79
credencial
elemento 629, 634, 638
criao de tarefa 155
criao de tarefa dinmica 155
criando previso
criando trial
critrios de correspondncia
dentro de um intervalo absoluto 58,
216
dentro de um intervalo relativo 58,
216
follows 209
follows absolute to 58
follows previous 57
follows relative to 58
follows sameday 57
mesmo dia 57, 216
precedente mais prximo 57, 216
predecessor 59
predecessor pendente 60
sucessor 59
curingas
composer 251
customizao da carga de trabalho
utilizando tabela de varivel 109
customizando a carga de trabalho
utilizando tabela de varivel 109
D
d-pool
dano do Symphony
comando resetFTA 369
data
ciclo de execuo 218
definio
parmetros de conexo 50
tabela de varivel 189
definio da tabela de variveis
vartable 141
trabalho 152
cpuclass 152
ignorar 153
members 153
definio de domnio 153
ismaster 154
manager 154
parent 154
definio de estao de trabalho 135,
147
access 143
agent 145
agente dinmico 145
agente estendido 144
agente padro 144
autolink 146
behinfirewall 146
broker 144
cpuname 141
domnio 142
fta 144
ndice Remissivo
671

(continuao)
fullstatus 147
fuso horrio 142
host 143
manager 144
members 149
os type 141
protocol 149
requisitos 149
secureaddr 142
ServerID 148
tcpaddr 142
tipo 143
definio de regra de evento 234
eventRules.xsd 235
palavras-chave
actionProvider 241
actionType 241
activeTime 237
correlationAttributes 241
description 237, 242
eventCondition 238
eventProvider 238
eventRule 236
eventType 238
filteringPredicate 240
Horrio de Vero 237
isDraft 237
name 236
onDetection 242
onTimeOut 242
operator 240
responseType 242
ruleType 236
scope 240, 243
timeInterval 238
timeZone 237
validity 237
definio de tarefa 155
docommand 157
interativo 159
opo de recuperao 160
scriptname 156
streamlogon 158
success condition 159
tarefa 157
tarefas de banco de dados 172
tarefas de Java 174
Tarefas de Servios da Web 166
tarefas de transferncia de
arquivos 168
tarefas do IBM i 177
tarefas do J2EE 170
Tarefas do MSSQL 173
tarefas executveis 174
tarefas JCL 176
tarefas sombra 164
tarefas XA 175
tasktype 158
utilizando variveis e
parmetros 177
definio de usurio do Windows 182
definio do calendrio 184
definio do fluxo de tarefa 194
definio do parmetro 185
definio do prompt 4, 191
672
definio do recurso 193

definio do usurio 182
domnio confivel 184
definindo
dependncias
follows 209
needs 216
opens 223
prompts 226
objetos de banco de dados
calendrios 184
classes de estaes de
trabalho 152
domnios 153
estaes de trabalho 135
fluxo de job 194
prompts 4, 191
recursos 193
regras de eventos 234
servios da Web 166
tarefas 155
tarefas AS/400 176, 177
tarefas de Java 174
tarefas do J2EE 170
tarefas i5/OS 176, 177
tarefas JCL 176
tarefas sombra 164
tarefas XA 175
transferncia de arquivos 168
usurios do Windows 182
variables 185
Definindo Objetos
no banco de dados 133
dentro de um intervalo absoluto
critrios de correspondncia 58
follows 209
follows absolute to 58
dentro de um intervalo relativo
follows 209
follows relative to 58
dependncia
cruzado 576
entre redes 557, 562
dependncia cruzada
como dependncia em uma tarefa
sombra 572
como incluir no plano 573
definio 572
estao de trabalho de mecanismo
remoto 567
etapas para definir 572
fluxo de informaes 569, 576
introduo 567
lgica 567
monitorando resoluo no plano 573
plano de produo 574
tarefa remota 567
tarefa sombra 567
dependncia de interligao de redes
criar 561
gerenciando utilizando o
conman 562
dependncias
rfs 61
dependncias cruzadas
definindo 567
gerenciando 567
DESCONHECIDO 158
destino
elemento 638
destinos da tarefa
definindo 640
dia
ciclo de execuo 218
diskSpace
elemento 617
docommand
domnio 9
done
estado do job 320
doubleVariable
elemento 608
142
E
e
elemento 619
educao xii
ejb
elemento 637
elementos
action 627
allocation 620
annotation 606
aplicativo 609
argumentos 632
candidateCPUs 612
candidateHosts 611
candidateOperatingSystems 614
candidateResources 622
category 606
connFactory 638
cpu 613
credencial 629, 634, 638
destino 638
diskSpace 617
doubleVariable 608
e 619
ejb 637
endpointReference 622
environment 633
estimatedDuration 626
ewlm 625
executvel 630
fileSystem 616
groupName 635
grupo 618
hostName 612
invoker 636
j2ee 636
JAASAuthenticationAlias 640
jms 636
jndiHome 637
jobDefinition 605
logicalResource 617
maximumResourceWaitingTime 626
message 638
elementos (continuao)
objective 623
operatingSystem 615
optimization 622
orderedCandidatedWorkstations 611
ou 619
parmetros 628
password 629, 635, 639
physicalMemory 614
prioridade 626
programando 625
propriedades 618
recoveryActions 627
recursos 609
relacionamento 621
relatedResources 610
requirement 620
script 632
speed 613
stringVariable 607
tpmaction 628
tpmaddress 630
uintVariable 608
userName 629, 634, 639
valor 633
variables 607
varivel 634
virtualMemory 614
workflow 630
em
ciclo de execuo 217
enCarryForward
varivel 68, 73
enCFInterNetworkDeps
varivel 73
enCFResourceQuantity
varivel 73
endpointReference
elemento 622
enLegacyId
varivel 74
enLegacyStartOfDayEvaluation
varivel 76, 524
enPreventStart
varivel 74
enTimeZone
varivel 76, 523
environment
elemento 633
erro
estado do job 320
estao de trabalho
agente tolerante a falhas 5
arquivos da caixa postal
NetReq.msg 33
classe 8
conjunto 5
conjunto dinmico 5
criar 135
definindo 135
remoto 5
gerenciador de domnio 5
gerenciador de domnio mestre 5
gerenciador de domnio principal de
backup 5
processos 25
estao de trabalho (continuao)

tipo de conjunto 145
tipo de conjunto dinmico 146
tipo de d-pool 146
tipo de mecanismo remoto 136, 145
remoto 5, 8, 13
definindo 567, 572
estaes de trabalho dinmicas 5, 135
estados do fluxo de trabalho
abend 327
add 327
exec 327
pronto 327
stuck 327
succ 327
suspender 327
estados do job
abend 320
abenp 320
add 320
done 320
erro 320
exec 320
extrn 320
fail 320
intro 321
limite 321
pend 321
pronto 321
sched 321
succ 321
succp 321
suspender 321
wait 321
estatsticas da tarefa de criao de
log 92
estimatedDuration
elemento 626
eventos customizados
definindo 132, 453
enviando 132, 471
eWAS
parando 416
ewlm
elemento 625
exec
estado do job 320
executando comandos do sistema
a partir do composer 301
a partir do conman 310, 435
executvel
elemento 630
extenso de trial
EXTERNAL
fluxo de job 562
tarefas 563
extrn
estado do job 320
F
fail
estado do job
fdignore
em 221
except 208
fdnext
em 221
except 208
fdprev
em 221
except 208
fileSystem
elemento 616
filtros
composer 251
fluxo de job 2
calculando tempo de execuo 94
EXTERNAL 562
fluxo de tarefa final
automatizando o processamento do
plano 95
FNCJSI
plano de pr-produo 55
follows
follows absolute to
dentro de um intervalo absoluto 58
follows previous
precedente mais prximo 57
follows relative to
dentro de um intervalo relativo 58
follows sameday
mesmo dia 57
fta
fullstatus
fuso horrio
ativando 523
nos fluxos de job 230
G
garantia de servio de carga de trabalho
calculando horrios de incio da
tarefa 71
plano de previso 71
gerenciador de domnio 5
gerenciador de domnio mestre 5
gerenciador de domnio principal de
backup 5
gerenciamento de plano
conceitos bsicos 53
logman 92
Personalizando 68, 72
stageman 89
gerenciando
ciclo de produo 53
dependncias follows externas 57
objetos no banco de dados 133
tarefa sombra no plano 582
320
ndice Remissivo
673
gerenciando eventos
comutando o servidor de
processamento de eventos 433
iniciando o mecanismo de
monitoramento 412
iniciando o servidor de processamento
de eventos 411
parando o mecanismo de
monitoramento 419
parando o servidor de processamento
de eventos 418
gerenciando fusos horrios 523
nome do fuso horrio
com o comprimento da
varivel 523, 529
tabela de fusos horrios
retrocompatibilidade 527
todos suportados 529
gerenciando objetos
no banco de dados 247
no plano 307
glossrio xii
groupName
elemento 635
grupo
elemento 618
H
host
agentes estendidos 143
hostName
elemento 612
143
I
icalendar
ciclo de execuo 219
identificando instncias do fluxo de
trabalho
no plano 56
s 56
scheddateandtime 56
ignorar
trabalho 153
iniciando
processos da estao de trabalho 31
WebSphere Application Server 31
iniciando o processamento
plano de produo 94
incio do dia
estabelecendo comunicao 35
Instrues JSDL 599
Integrao com o IBM Tivoli Monitoring
6.1
bulk_discovery 337
integrao EWLM
ativando em tarefas 622
capacidade de otimizao 622
integridade de dados
interativo
674
Intercom.msg 33
interface de linha de comandos
definio 50
interfaces do usurio
API Java 21
composer 20
conman 21
Dynamic Workload Console 20
Interface de Servios da Web 21
optman 21
planman 21
plug-ins 21
intro
estado do job 321
invoker
elemento 636
ismaster
linha de comandos planman (continuao)

recuperando informaes do
plano 83
Regras de Implementao 87
logicalResource
elemento 617
logmanMinMaxPolicy
varivel 75
logmanSmoothPolicy
varivel 75
j2ee
elemento 636
JAASAuthenticationAlias
elemento 640
jms
elemento 636
jndiHome
elemento 637
JnextPlan
conman startappserver 78
CreatePostReports 79
MakePlan 78
SwitchPlan 79
UpdateStats 79
job statement
nos fluxos de job 213
Job Submission Description Language
(JSDL) 599
jobDefinition
elemento 605
jobman
variveis de ambiente 40
JSDL (Job Submission Description
Language) 599
Mailbox.msg 33
MakePlan
JnextPlan 78
manager
maximumResourceWaitingTime
elemento 626
maxLen
varivel 72
mecanismo de bloqueio
mecanismo remoto
como conectada 575
dependncia cruzada 576
estao de trabalho 136, 145
mdia do tempo de execuo 94
members
trabalho 153
mesmo dia
follows 209
follows sameday 57
message
elemento 638
mtodo de acesso netmth 559
minLen
varivel 72
modelos
para definies de objeto de
planejamento 135
limit cpu
processo jobman 27
limite
estado do job 321
linguagem de planejamento 194
linha de comando
composer 20
conman 20
optman 20
linha de comandos planman
criando previso 86
criando trial 84
extenso de trial 85
plano de desbloqueio 88
plano de reconfigurao 88
plano intermedirio 81, 82
NetReq.msg 33
nvel de log no AS/400 178
nvel de log no i5/OS 178
nvel de log no IBM i 178
nomes de caminho, notao xiii
nomes de diretrio, notao xiii
notao
nomes de caminho xiii
tipografia xiii
variveis de ambiente xiii
novos executores 157
programando 7
tarefa de transferncia de
arquivos 168
tarefas AS/400 176, 177
tarefas de Java 174
novos executores (continuao)

tarefas do J2EE 170
tarefas JCL 176
tarefas XA 175
novos plug-ins
arquivos 168
tarefas AS/400 176, 177
tarefas de Java 174
tarefas do J2EE 170
tarefas JCL 176
tarefas XA 175
novos plugins
O
objective
elemento 623
objetos de banco de dados
calendrios 184
classes de estaes de trabalho 152
comando add 262
comando authenticate 264
comando continue 265
comando create 275
comando delete 265
comando display 269
comando edit 274
comando exit 275
comando extract 275
comando help 279
comando list 280
comando lock 286
comando modify 290
comando new 294
comando print 280
comando redo 296
comando rename 297
comando replace 300
comando unlock 301
comando validate 305
domnios 153
estaes de trabalho 135
exibindo o banner do composer 306
fluxo de job 194
prompts 4, 191
recursos 193
regras de eventos 234
servios da Web 166
tarefas 155
tarefas de Java 174
tarefas do J2EE 170
objetos de banco de dados (continuao)

tarefas JCL 176
tarefas sombra 164
tarefas XA 175
transferncia de arquivos 168
usurios do Windows 182
variables 185
opo local
varivel mm retry link 95
opes globais
carryStates 68
varivel carryforward 90
varivel carryStates 73
varivel enCarryForward 68, 73
varivel enCFInterNetworkDeps 73
varivel enCFResourceQuantity 73
varivel enLegacyId 74
varivel
enLegacyStartOfDayEvaluation 76,
524
varivel enPreventStart 74
varivel enTimeZone 76, 523
varivel logmanMinMaxPolicy 75
varivel logmanSmoothPolicy 75
varivel maxLen 72
varivel minLen 72
varivel startOfDay 73, 524
operatingSystem
elemento 615
optimization
elemento 622
optman
linha de comando 20
orderedCandidatedWorkstations
elemento 611
rfs
dependncias 61
os type
otimizao de recurso
integrao EWLM 622
otimizao de tarefas
integrao EWLM 622
otimizao EWLM
ou
elemento 619
P
palavra-chave
palavra-chave
palavra-chave
palavra-chave
palavra-chave
palavra-chave
palavra-chave
palavra-chave
palavra-chave
palavra-chave
palavra-chave
palavra-chave
palavra-chave
palavra-chave
palavra-chave
palavra-chave
$MANAGER 143
$MASTER 143
at 195, 199
carryforward 200
comment 201
confirmed 201
critical 202
deadline 202
description 203
draft 204
end 204
every 204
except 208
follows 209
freedays 211
keyjob 214
palavra-chave keysched 215

palavra-chave limit 215
palavra-chave matching 216
palavra-chave needs 216
palavra-chave on 217
ciclo de execuo 217
palavra-chave onuntil 230, 231
palavra-chave opens 223
palavra-chave priority 225
palavra-chave prompt 226
palavra-chave schedtime 227
palavra-chave schedule 229
palavra-chave timezone 230
palavra-chave until 230
palavra-chave validfrom 233
palavra-chave vartable 234
palavras-chave
a cada 204
s 195, 199
carryforward 200
comentrio 201
confirmed 201
critical 202
description 203
dias livres 211
draft 204
em 217
except 208
fim 204
follows 209
fuso horrio 230
keyjob 214
keysched 215
limite 215
matching 216
needs 216
opens 223
planejamento 229
prazo final 202
prioridade 225
prompt 226
schedtime 227
until 230
validfrom 233
vartable 234
palavras-chave do fluxo de tarefas
a cada 204
s 199
carryforward 68, 200
comentrio 201
confirmed 201
critical 202
description 203
dias livres 211
draft 204
em 217
except 208
fim 204
follows 209
fuso horrio 230
job statement 213
keyjob 214
keysched 215
limite 215
matching 216
needs 216
opens 223
ndice Remissivo
675
palavras-chave do fluxo de tarefas

(continuao)
planejamento 229
prazo final 202
prioridade 225
prompt 226
schedtime 227
until 230
validfrom 233
vartable 234
palavras-chave dos fluxos de tarefas
s 195
onuntil 230, 231
palavras-chave reservadas
para definies de usurio 135
para estaes de trabalho 135
para fluxos de tarefas 134
palavras reservadas
para definies de usurio 135
para estaes de trabalho 135
para fluxos de tarefas 134
parmetro 12
parmetro global
definio 185
parmetro local
banco de dados 466
definio 185
exportando 466
gerenciando 466
importando 466
parmetros
elemento 628
em definies de job 177
parmetros de conexo
definio 50
parando
WebSphere Application Server 31
parent
password
elemento 629, 635, 639
pend
estado do job 321
physicalMemory
elemento 614
PlanBox.msg 33
planejamento dinmico 5, 7, 8
definio da tarefa 157
planejando recurso 12
plano
incio rpido 21
plano de desbloqueio
plano de experincia
criar 84
description 70
extenso 85
plano de gerenciamento
alterando a prioridade 336
alterando a senha do usurio 335
alternando o gerenciamento de
domnio 434
676
plano de gerenciamento (continuao)

atualizando o arquivo de configurao
de monitoramento 346
cancelando fluxos de job 339
cancelando jobs 337
confirmando a concluso do job 341
definindo o nvel da mensagem 342
designando o console 342
desvinculando estaes de
trabalho 437
encerrando os processos da estao de
trabalho 407
enviando mensagens para o
operador 436
excluindo dependncia dos fluxos de
job 345
excluindo dependncia nos jobs 344
exibindo informaes da ajuda 351
exibindo informaes da estao de
trabalho 371
exibindo jobs ou fluxos de job 347
exibindo o banner do conman 439
exibindo o status do plano de
produo 413
ignorando o comando 343
incluindo dependncia nos fluxos de
job 333
incluindo dependncia nos jobs 332
iniciando o servidor de
aplicativos 410
iniciando processos da estao de
trabalho 408
liberando fluxos de job da
dependncia 363
liberando jobs da dependncia 362
limitando os jobs em execuo em
fluxos de job 355
listando avisos no resolvidos 360
listando planos processados 358
modificando a cerca de job 350
modificando jobs em execuo na
modificando unidades de
recursos 370
mostrando dependncias de
arquivos 379
mostrando informaes de fluxos de
job 402
mostrando informaes de
prompts 397
mostrando informaes do
domnio 378
mostrando informaes do job 382
mostrando informaes do
recurso 400
obter monitores ativos 371
parando jobs 352
parando o servidor de
aplicativos 416
parando processos da estao de
trabalho 413
parando processos da estao de
trabalho com proteo do
firewall 415
reexecutando jobs 366
reexecutando os comandos 361
respondendo aos avisos 365
plano de gerenciamento (continuao)

saindo do conman 350
selecionando o plano processado 371
solicitando um bulk_discovery 337
submetendo arquivos como jobs 423
submetendo comandos como
jobs 419
submetendo fluxos de job 429
submetendo jobs 426
vinculando estaes de trabalho 355
plano de longo prazo
plano de pr-produo
description 54
FNCJSI 55
plano de longo prazo 54
plano de previso
clculo do primeiro horrio de
incio 71
criar 86
description 71
plano de produo
arquivo Symphony 53, 76
automatizando o processamento 95
description 68
gerando 76
iniciando o processamento 94
JnextPlan 53, 76
plano de desbloqueio 88
plano de reconfigurao 88
recuperando informaes 83
plano de reconfigurao
plano intermedirio
estendendo com 82
gerando 81
plug-ins 21
plug-ins de tarefas de aplicativos 157
programando 7
precedente mais prximo
follows 209
follows previous 57
predecessor
sucessor 55, 59
predecessor pendente
dependncias rfs 61
sucessor 60
prioridade
elemento 626
processamento de tarefa
configurando 49
processo batchman 26
processo de conexo
para tarefa sombra distribuda 575
processo jobman 27
limit cpu 27
processo mailman 26
ServerID 26
processo monman 26
processo netman 26
processo writer 26
processos
batchman 26
jobman 27
processos (continuao)
mailman 26
monman 26
netman 26
ssmagent 26
writer 26
rvore de processos no UNIX 28
rvore de processos no Windows 29
batchman 26
comunicao entre os processos 33
gerenciando os estados de alterao
de job 36
iniciando 31
incio do dia
estabelecendo comunicao 35
jobman 27
mailman 26
ServerID 26
monman 26
netman 26
parando 31
writer 26
programa composer 247
caracteres de controle 251
caracteres especiais 255
configurao 247
variables 479
variveis no UNIX 248
variveis no Windows 247
curingas 251
delimitadores 255
editor 248
editor XML 248
executando comandos 249
filtros 251
prompt 249
sada do terminal 247
sada off-line 247
programa conman 307
aviso do usurio 310
caracteres de controle 310
caracteres especiais 311
configurao 307
definir variveis 307
curingas 311
delimitadores 311
executando comandos 309, 311
processando 312
prompt 308
sada do terminal 307
sada off-line 308
selecionando fluxos de job 322
argumentos 322
jobstream_id 322
jobstreamname 322
schedid 322
utilizando at 323
utilizando carriedforward 323
utilizando carryforward 323
utilizando finished 324
utilizando follows 324
utilizando limit 325
utilizando needs 325
programa conman (continuao)

selecionando fluxos de job
(continuao)
utilizando opens 326
utilizando priority 326
utilizando prompt 326
utilizando started 326
utilizando state 327
utilizando until 327
selecionando tarefa 313
argumentos 313
jobstream_ID 314
jobstreamname 313
schedid 314
utilizando at 315
utilizando confirm 315
utilizando critical 316
utilizando critnet 316
utilizando deadline 316
utilizando every 316
utilizando finished 317
utilizando follows 317
utilizando logon 318
utilizando needs 318
utilizando opens 318
utilizando priority 319
utilizando prompt 319
utilizando recovery 319
utilizando scriptname 319
utilizando started 319
utilizando state 320
utilizando until 321
programando
elemento 625
promoo de tarefa 98
promovendo uma tarefa 98
prompt
abend 4
ad hoc 4
globais 4
local 4
nomeado 4
recovery 4
prompt abend 4
prompt ad hoc 4
prompt de recuperao 4
prompt global 4
prompt local 4
prompt nomeado 4
pronto
estado do job 321
propriedades
elemento 618
propriedades da estao de trabalho 377
propriedades locais 39
protocol
publicaes xii
R
recovery
definio de tarefa
recoveryActions
elemento 627
recurso fsico 12
160
recurso lgico 12
recurso relacionado 640
recurso relacionado
recurso lgico 640
sistema de arquivos 640
sistema de rede 640
sistema operacional 640
recursos
elemento 609
otimizveis 641
referncia do composer 133
referncia do conman 307
regra 12
regra de evento 12
regras de eventos
cenrios de amostra 116, 125
ocorrncias 131
opo de tempo limite 124
substituio de varivel 124
Regras de Implementao
relacionamento
elemento 621
relatedResources
elemento 610
relatrio de linha de comandos
configurando 517
relatrios em lote
amostra de cenrio 516
logs 520
rastreios 520
rem-eng
requirement
elemento 620
requisitos
resoluo
varivel 112
resource
computador 640
fsico 12
lgico 12
programando 12
rrcondsucc
S
S.O. Windows
caracteres especiais, manipulando 93
sched
estado do job 321
script
elemento 632
script de configurao .jobmanrc 46
script de configurao djobmanrc 49
script de configurao jobmanrc 43, 47
scriptname
scripts de configurao
.jobmanrc 46
djobmanrc.cmd 49
jobmanrc 43
jobmanrc.cmd 47
secureaddr
ndice Remissivo
677
securitylevel 147
segurana
tabelas de variveis 111
Server.msg 33
ServerID
processo mailman 26
servidor de aplicativos
parando 416
shutdown
comando utilitrio 473
ShutDownLwa
comando utilitrio 473
sistema de arquivos
sistema de rede
sistema operacional
speed
elemento 613
stageman
carryforward 68
SwitchPlan 89
startOfDay
varivel 73, 524
status
atrasado 202
status atrasado 202
status da estao de trabalho 374, 377
status de links da estao de
trabalho 374
status de processos da estao de
trabalho 374
streamlogon
definio de usurio do
Windows 182
stringVariable
elemento 607
stuck
succ
estado do job 321
succp
estado do job 321
sucessor
predecessor 55, 59
predecessor pendente 60
suspender
estado do job 321
SwitchPlan
JnextPlan 79
T
tabela de variveis padro
utilizando 110
definio 189
integridade de dados 111
mecanismo de bloqueio 111
padro 110
678
tabela de varivel (continuao)

utilizando 109
tabelas de variveis
migrao do arquivo de
segurana 110
segurana 111
tarefa
tarefa remota
com falha 581
definindo 567
transio de status durante
recuperao 581
transportar 581
tarefa sombra 2
com falha 581
definio 164
definindo 567, 572
durante recuperao da tarefa
remota 581
gerenciando no plano atual 582
status fail 581
transio de status aps conexo 579
transportar 581
tarefas 2
allocation 640
calculando tempo de execuo 94
criar 640
definindo 640
optimization 640
tarefas
propriedades consumveis 640
propriedades otimizveis 640
tarefas crticas
arquivo de segurana 101
opes globais 98
opes locais 100
tarefas de banco de dados
dinmicas 155
tarefas de servio da Web dinmicas 155
tarefas de transferncia de arquivos
dinmicas 155
tarefas dinmicas 135, 155, 157
arquivos 168
tarefa MSSQL 173
tarefas AS/400 176, 177
tarefas de Java 174
tarefas do J2EE 170
tarefas JCL 176
tarefas XA 175
tarefas do banco de dados DB2 172
tarefas do banco de dados MSSQL 172
tarefas do banco de dados Oracle 172
tarefas java dinmicas 155
tasktype
tcpaddr
tempo de execuo estimado 94
tipo
tipos de recursos
consumvel 641
tipos de tarefas com opes avanadas
definio 2
planejamento dinmico 2
planejamento esttico 2
programando 7, 157
tipos de tarefas existentes
definio 2
Tivoli Dynamic Workload Console
acessibilidade xii
ambiente do tempo de execuo 14
arquitetura 25
conceitos bsicos 1
controlando o processamento de
tarefas 15
definindo atividades 15
executando o gerenciamento de
eventos 19
gerenciando a produo 19
incio rpido 21
interfaces do usurio 20
objeto 1
processos 25
rede 13
viso geral 1
tpmaction
elemento 628
tpmaddress
elemento 630
transportar
tarefa remota 581
tarefa sombra 581
treinamento
tcnico xii
treinamento tcnico xii
Treinamento Tcnico Tivoli xii
trialsked
plano de experincia 70
plano de previso 71
TWS_PROMOTED_JOB 552
U
uintVariable
elemento 608
UNIXTASK 158
UpdateStats
JnextPlan 79
userName
elemento 629, 634, 639
usurio do Windows
definio 183
definindo 183
executando tarefas em um agente
dinmico 183
executando tarefas em um
conjunto 183
executando tarefas em um conjunto
dinmico 183
planejando em um agente
dinmico 183
planejando em um conjunto 183
planejando em um conjunto
dinmico 183
utilizando
tabela de variveis padro
110
V
valor
elemento 633
variables
ATSCRIPT 443
carryforward 90
carryStates 68, 73
COMPUTERNAME 40
elemento 607
enCarryForward 68, 73
enCFInterNetworkDeps 73
enCFResourceQuantity 73
enLegacyId 74
enLegacyStartOfDayEvaluation 76,
524
enPreventStart 74
enTimeZone 76, 523
exportadas localmente por
.jobmanrc 43, 46, 47, 49
exportadas no UNIX 41
HOME 40, 41, 48
HOMEDRIVE 40
HOMEPATH 40
LANG 40, 41
LD_LIBRARY_PATH 41
LD_RUN_PATH 41
LOCAL_RC_OK 44, 48
logmanMinMaxPolicy 75
logmanSmoothPolicy 75
LOGNAME 40, 41
MAESTRO_OUTPUT_STYLE 40, 41
MAIL_ON_ABEND 44, 45, 48
maxLen 72
minLen 72
PATH 41
POSIXHOME 48
SHELL_TYPE 45
startOfDay 73, 524
SystemDrive 40
SystemRoot 40
TEMP 40
TIVOLI_JOB_DATE 40, 42
TMPDIR 40
TMPTEMP 40
TWS_PROMOTED_JOB 40, 42
TWS_TISDIR 42
TZ 40, 42
UNISON_CPU 40, 42
UNISON_DATE 41
UNISON_DATE_FORMAT 42
UNISON_DIR 40, 42
UNISON_EXEC_PATH 40, 42
UNISON_EXIT 44
UNISON_HOST 41, 42
UNISON_JCL 43
UNISON_JOB 41, 42
UNISON_JOBNUM 41, 42
UNISON_MASTER 41, 42
UNISON_RUN 41, 42
UNISON_SCHED 41, 42
UNISON_SCHED_DATE 42
UNISON_SCHED_EPOCH 41, 42
variables (continuao)
UNISON_SCHED_IA 41, 42
UNISON_SCHED_ID 41, 42
UNISON_SHELL 41, 42
UNISON_STDLIST 41, 42, 43
UNISON_SYM 41, 42
UNISONHOME 41, 42
USE_EXEC 45
USERDOMAIN 41
USERNAME 41
USERPROFILE 41
variveis locais 47, 49, 247
variveis, ambiente, notao xiii
variveis de ambiente, notao xiii
varivel 13
definio 185
elemento 634
em definies de job 177
resoluo 112
varivel COMPUTERNAME 40
varivel HOME 40, 41, 48
varivel HOMEDRIVE 40
varivel HOMEPATH 40
varivel LANG 40, 41
varivel LD_LIBRARY_PATH 41
varivel LD_RUN_PATH 41
varivel LOCAL_RC_OK 44, 48
varivel LOGNAME 40, 41
varivel
MAESTRO_OUTPUT_STYLE 40, 41
varivel MAIL_ON_ABEND 44, 45, 48
em uma estao de trabalho com o
Windows 48
varivel PATH 41
varivel POSIXHOME 48
varivel SHELL_TYPE 45
varivel SystemDrive 40
varivel SystemRoot 40
varivel TEMP 40
varivel TIVOLI_JOB_DATE 40, 42
varivel TMPDIR 40
varivel TMPTEMP 40
varivel TWS_PROMOTED_JOB 40, 42
varivel TWS_TISDIR 42
varivel TZ 40, 42
varivel UNISON_CPU 40, 42
varivel UNISON_DATE 41
varivel UNISON_DATE_FORMAT 42
varivel UNISON_DIR 40, 42
varivel UNISON_EXEC_PATH 40, 42
varivel UNISON_EXIT 44
varivel UNISON_HOST 41, 42
varivel UNISON_JCL 43
varivel UNISON_JOB 41, 42
varivel UNISON_JOBNUM 41, 42
varivel UNISON_MASTER 41, 42
varivel UNISON_RUN 41, 42
varivel UNISON_SCHED 41, 42
varivel UNISON_SCHED_DATE 42
varivel UNISON_SCHED_EPOCH 41,
42
varivel UNISON_SCHED_IA 41, 42
varivel UNISON_SCHED_ID 41, 42
varivel UNISON_SHELL 41, 42
varivel UNISON_STDLIST 41, 42, 43
varivel UNISON_SYM 41, 42
varivel UNISONHOME 41, 42
varivel USE_EXEC 45
varivel USERDOMAIN 41
varivel USERNAME 41
varivel USERPROFILE 41
vartable
definio da tabela de variveis 141
verificao de integridade
referencial 257
verificando o funcionamento da caixa de
correio 341
virtualMemory
elemento 614
W
wait
estado do job 321
infra-estrutura 25
iniciando 31
parando 31, 416
WINDOWSTASK 158
workflow
elemento 630
X
XATASK
158
ndice Remissivo
679
680

Nmero do Programa: 5698-WSH
Impresso no Brasil
S517-7781-11
IBM Tivoli Workload Scheduler
Spine information:
Verso 8.6

Awsrgmst

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Awsrgmst

Transféré par

Droits d'auteur :

Formats disponibles

Workload Scheduler

Guia do Usurio e Referncia

Guia do Usurio e Referncia

Captulo 1. Viso Geral do Tivoli

Captulo 2. Entendendo Processos

Processos da Estao de Trabalho do Tivoli

Captulo 3. Configurando o Ambiente

Customizando o Processamento da Tarefa em uma

Captulo 4. Gerenciando o Ciclo de

Captulo 5. Utilizando Garantia do

Captulo 6. Customizando a Carga de

Captulo 7. Automao de Carga de

O Processo de Gerenciamento de Regras de

Captulo 8. Definindo Objetos no

Captulo 9. Gerenciando Objetos no

IBM Tivoli Workload Scheduler: Guia do Usurio e Referncia

Executando o Programa composer . . .

Captulo 10. Gerenciando Objetos no

Captulo 12. Obtendo Relatrios e

Captulo 11. Utilizando Comandos

Configurao para Utilizar Comandos de Relatrio

Captulo 13. Gerenciando fusos

Mudando para o Horrio de Vero Desativado

Captulo 14. Gerenciando Agentes

| Definindo uma Dependncia Cruzada . . . . .

Captulo 15. Gerenciando

Apndice A. Evento de Automao e

Apndice B. Referncia do Esquema

Apndice C. Referncia rpida para

Apndice D. Acessibilidade . . . . . 663

Captulo 16. Definindo e Gerenciando

Uma Introduo a Dependncias Cruzadas

IBM Tivoli Workload Scheduler: Guia do Usurio e Referncia

ndice Remissivo . . . . . . . . . . 669

Rede de Domnio nico . . . . . . . .

Copyright IBM Corp. 1999, 2011

Critrios de Correspondncia de Intervalo

IBM Tivoli Workload Scheduler: Guia do Usurio e Referncia

1. Sintaxe do Comando . . . . . . . . . xiv

31. Atributos Obrigatrios e Opcionais para a

Campos de Sada de Prxtract . . . . .

IBM Tivoli Workload Scheduler: Guia do Usurio e Referncia

88. Mensagens da Tarefa GS (Get Status)

Sobre esta publicao

O que H de Novo Nesse Release?

O Que H de Novo nesta Publicao

Copyright IBM Corp. 1999, 2011

v Definindo Dependncias na pgina 16 para obter uma descrio

Treinamento Tcnico Tivoli

Informaes sobre suporte

IBM Tivoli Workload Scheduler: Guia do Usurio e Referncia

v Obtendo correes: possvel localizar as correes mais recentes que j esto

Convenes Utilizadas Nesta Publicao

variveis e caminhos dependentes do sistema operacional

A primeira palavra ou conjunto de

As informaes entre colchetes ([ ])

Sublinhado Um sinal de sublinhado ( _ ) conecta

{-prompts | -prompt prompt_name }

O texto em Negrito designa

composer add file_name

O texto em Itlico uma varivel e

IBM Tivoli Workload Scheduler: Guia do Usurio e Referncia

Tabela 1. Sintaxe do Comando (continuao)