tivoli workload scheduler -...

Tivoli WorkloadSchedulerGuia de ReferênciaVersão 7.0

Tivoli Workload Scheduler - Manual de Referência (Maio de 2000)

Observações sobre Copyright

Copyright ©2000 pela Tivoli Systems Inc., uma Empresa IBM, incluindo esta documentação e todo o software. Todos osdireitos reservados. Somente pode ser utilizado de acordo com um Contrato de Licença de Software do Tivoli Systems ouAdendo para Produtos Tivoli para o Cliente ou Contrato de Licença da IBM. Nenhuma parte dessa publicação poderá serreproduzida, transmitida, transcrita, armazenada em um sistema de recuperação ou convertida em qualquer linguagem decomputador, de qualquer forma ou em hipótese alguma, eletrônica, mecânica, magnética, óptica, química, manual ou docontrário, sem permissão expressa por escrito do Tivoli Systems. A Tivoli Systems concede ao Cliente permissão limitadapara efetuar cópia impressa ou outras reproduções de qualquer documentação lida por máquina para seu próprio uso,contanto que cada uma contenha o aviso de copyright da Tivoli Systems. Não será concedido nenhum outro direito sobcopyright sem permissão prévia por escrito da Tivoli Systems. O documento não é planejado para produção e é fornecido“como está” sem garantia de nenhum tipo.Todas as garantias neste documento são, por meio deste, rejeitadas incluindoas garantias de mercado e adequação a um determinado objetivo.

Marcas

Os nomes de produtos a seguir são marcas da Tivoli Systems ou da IBM Corporation: AIX, IBM, OS/2, RS/6000, TivoliManagement Environment e TME 10.

Microsoft, Windows, Windows NT e o logotipo Windows são marcas ou marcas registradas da Microsoft Corporation.

UNIX é uma marca registrada nos Estados Unidos e em outros países licenciados exclusivamente através da X/OpenCompany Limited.

Java e todas as marcas ou logotipos baseados em Java são marcas da Sun Microsystems, Inc.

Observações

Referências nesta publicação a produtos, programas ou serviços da Tivoli Systems ou IBM não significam que a TivoliSystems ou a IBM pretendam torná-los disponíveis em todos os países onde operam. Qualquer referência a estes produtos,programas ou serviços da Tivoli Systems ou da IBM não significa que apenas os produtos, programas ou serviços da TivoliSystems ou da IBM possam ser utilizados. Qualquer produto, programa ou serviço funcionalmente equivalente, que nãoinfrinja nenhum direito de propriedade intelectual da IBM ou da Tivoli Systems ou outros direitos legalmente protegidos,poderá ser utilizado em substituição a este produto, programa ou serviço. A avaliação e verificação da operação em conjuntocom outros produtos, exceto aqueles expressamente designados pela Tivoli Systems ou pela IBM, são de inteiraresponsabilidade do Cliente.

O Tivoli Systems ou a IBM podem ter patentes ou solicitações de patentes relativas a assuntos tratados nesta publicação. Ofornecimento desta publicação não garante ao Cliente nenhum direito sobre tais patentes. Pedidos de licença devem serenviados, por escrito, à Gerência de Relações Comerciais e Industriais da IBM Brasil, Av. Pasteur, 138-146, Botafogo, CEP22290-240, Rio de Janeiro, RJ.

Índice

Prefácio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiQuem Deve Utilizar Este Guia. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Documentos Relacionados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

O Que Contém Este Guia. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Convenções Utilizadas neste Guia. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii

Informações Específicas da Plataforma. . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii

Como Entrar em Contato com o Suporte ao Cliente. . . . . . . . . . . . . . . . . .xiii

Capítulo 1. Referência do Composer . . . . . . . . . . . . . . . . . . . . . 1Como Gerenciar Objetos de Planejamento. . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Definições da Estação de Trabalho. . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Definições de Classes de Estações de Trabalho. . . . . . . . . . . . . . . . . . . 9

Definições de Domínio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Definições do Job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Definições do Usuário. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Definições do Calendário. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Definições dos parâmetros. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Definições do Prompt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Definições do Recurso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

O Programa Composer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Como Executar o Composer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Sintaxe de Comandos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Descrições dos Comandos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

build . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

continue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

create. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

iiiTivoli Workload Scheduler Guia de Referência

delete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

display, list, print. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

new. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

redo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

replace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

validate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Comando do Sistema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Capítulo 2. Linguagem de Planejamento . . . . . . . . . . . . . . . . 61Sintaxe dos Fluxos de Job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Palavras-chave. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Dependências. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Descrições das Palavras-chave. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

at . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

carryforward. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Comments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

confirmed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

end . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

every. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

except. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

follows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

in order. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Job Statement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

needs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

iv Versão 7.0

opens. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

until . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Capítulo 3. Referência do Conman . . . . . . . . . . . . . . . . . . . . . . 99Como executar o Conman. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Exemplos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Caracteres de Controle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Como Executar Comandos do Sistema. . . . . . . . . . . . . . . . . . . . . . . . 100

Prompt do Usuário. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Saída do Terminal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Saída Offline. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Prompt de Comandos do Conman. . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Sintaxe de Comandos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Caracteres Curinga. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Delimitadores e Caracteres Especiais. . . . . . . . . . . . . . . . . . . . . . . . . 104

Lista de Comandos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Como Selecionar Jobs em Comandos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Sinopse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Argumentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Como Selecionar Fluxos de Job em Comandos. . . . . . . . . . . . . . . . . . . . . . 118

Sinopse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

Argumentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

Descrições dos Comandos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

adddep job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

adddep sched. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

altpass. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

vTivoli Workload Scheduler Guia de Referência

altpri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

cancel job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

cancel sched. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

confirm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

continue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

deldep job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

deldep sched. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

fence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

kill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

limit cpu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

limit sched . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

listsym . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

recall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

redo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

release job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

release sched. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

reply . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

rerun. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

resource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

setsym. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178

showcpus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

showdomain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

showfiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

showjobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

showprompts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

vi Versão 7.0

showresources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

showschedules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

shutdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

start. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

stop. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

submit docommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

submit file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

submit job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

submit sched. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226

switchmgr. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

System Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

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

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

version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236

Capítulo 4. Comandos Utilitários . . . . . . . . . . . . . . . . . . . . . . . 237Descrições dos Comandos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237

Comandos at | batch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

Comando caxtract. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

Comando cpuinfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

Comando datecalc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

Comando dbexpand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Comando delete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

Comando evtsize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

Comando jbxtract. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Comando jobinfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

Comando jobstdl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262

Comando maestro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

Comando makecal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

viiTivoli Workload Scheduler Guia de Referência

Comando morestdl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267

Comando parms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

Comando paxtract. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

Comando prxtract. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

Comando r11xtr. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

Comando release. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275

Comando rextract. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

Comando rmstdlist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

Comando showexec. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Comando StartUp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281

Comando version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

Comando wmaeutil. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284

Comando xrxtrct. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

Comandos Não-suportados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

Capítulo 5. Referência do Agente Estendido . . . . . . . . . . 297O que são Agentes Estendidos?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297

Definição de Estação de Trabalho. . . . . . . . . . . . . . . . . . . . . . . . . . . 298

Interface do Método de Acesso. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298

Sintaxe da Linha de Comandos do Método. . . . . . . . . . . . . . . . . . . . 298

Mensagens de Resposta do Método. . . . . . . . . . . . . . . . . . . . . . . . . . 301

Arquivo de Opções do Método. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303

Execução do Método. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Tarefa Lançar Job (LJ). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Tarefa Gerenciar Job (MJ). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

Tarefa Verificar Arquivo (CF). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306

Tarefa Obter Status (GS). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

O Comando cpuinfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

Detecção de Problemas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

Mensagens de Erro da Lista Padrão de Jobs. . . . . . . . . . . . . . . . . . . . 308

viii Versão 7.0

Método Não Executável. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

Mensagens do Gerenciador de Console. . . . . . . . . . . . . . . . . . . . . . . 309

Mensagens do Composer e do Compiler. . . . . . . . . . . . . . . . . . . . . . 309

Mensagens do Jobman. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309

Capítulo 6. Referência do Agente de Rede . . . . . . . . . . . . 311Visão geral. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

Como Configurar uma Estação de Trabalho do Agente de Rede. . . . . . . . . 312

Exemplo de Linha de Comandos do Agente de Rede. . . . . . . . . . . . . 313

Arquivo de Opções. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314

Dependências entre redes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315

Como Criar uma Dependência entre redes. . . . . . . . . . . . . . . . . . . . . 315

Dependências entre redes e Conman. . . . . . . . . . . . . . . . . . . . . . . . . 316

Apêndice. Nomes dos Fusos Horários . . . . . . . . . . . . . . . . 319Nomes e Descrições dos Fusos Horários. . . . . . . . . . . . . . . . . . . . . . . . . . 319

Glossário . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321

Índice Remissivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331

ixTivoli Workload Scheduler Guia de Referência

x Versão 7.0

Prefácio

O Tivoli Workload Scheduler - Guia de Referência forneceinformações detalhadas sobre a interface de linha de comandos,linguagem de planejamento e comandos utilitários do TWS.

Quem Deve Utilizar Este GuiaEste guia destina-se aos administradores e usuários avançados doTWS.

Documentos Relacionados¶ Tivoli Workload Scheduler - Guia de Planejamento e Instalação

Fornece informações sobre o planejamento e instalação do TivoliWorkload Scheduler.

¶ Tivoli Workload Scheduler - Guia do Usuário

Fornece informações sobre a utilização do Tivoli WorkloadScheduler para gerenciar seu ambiente de produção.

O Que Contém Este GuiaO Tivoli Workload Scheduler - Guia de Referência contém asseguintes seções:

¶ Capítulo 1, “Referência do Composer”

Fornece uma visão geral da CLI docomposer. A CLI docomposeré utilizada para criar objetos de planejamento nobanco de dados do TWS.

¶ Capítulo 2, “Linguagem de Planejamento”

Fornece uma visão geral da linguagem de planejamento utilizadapara definir jobs e fluxos de job no banco de dados do TWS.

¶ Capítulo 3, “Referência do Conman”

Fornece uma visão geral da CLI doconman. A CLI do conmané utilizada para monitorar e gerenciar a execução do job duranteo dia de produção.

xiTivoli Workload Scheduler Guia de Referência

¶ Capítulo 4, “Comandos Utilitários”

Fornece uma visão geral dos comandos utilitários do TWS.Esses comandos são utilizados para gerenciar o ambiente doTWS.

¶ Capítulo 5, “Referência do Agente Estendido”

Fornece uma referência aos programadores para a criação deAgentes Estendidos.

¶ Capítulo 6, “Referência do Agente de Rede”

Fornece informações sobre a criação e utilização de uma estaçãode trabalho do Agente de Rede.

Convenções Utilizadas neste GuiaEste guia utiliza várias convenções de tipo de caractere para termose ações especiais. Estas convenções possuem os seguintessignificados:

Negrito Comandos, palavras-chave, nomes de arquivos,funções de autorização, URLs ou outras informaçõesque você deve utilizar, literalmente, aparecem emnegrito. Nomes de janelas, diálogos e outroscontroles também aparecem emnegrito.

Itálico Variáveis e valores que você deverá providenciaraparecem emitálico.Palavras e frases que sãoenfatizadas também aparecem emitálico.

Negrito em ItálicoTermos novos aparecem emnegrito em itálicoquando forem definidos no texto.

Espaçamento fixoExemplos de códigos, saída e mensagens de sistemaque aparecem em uma fontede Espaçamento Fixo.

xii Versão 7.0

Informações Específicas da PlataformaA tabela a seguir identifica as versões de plataforma suportadas,conhecidas ao tempo da publicação. Para mais detalhes einformações atualizadas, consulte as notas sobre o release.

Plataforma MecanismoTWS

Conector TWS Console JS

AIX 4.2 X X X

AIX 4.3 X X X

HP-UX 10.2 X X X

HP-UX 11.0 X X X

Solaris 2.6 X X X

Solaris 2.7 X X X

Windows NT 4.0 w/SP 4 ou superior

X X X

Windows 2000 X

Digital UNIX 4.0 X

Intel ABI compliant X

MIPS ABI compliant X

Como Entrar em Contato com o Suporte ao ClientePara suporte nos Estados Unidos, para este ou qualquer produtoTivoli, entre em contato com o Suporte ao Cliente Tivoli de uma dasseguintes maneiras:

¶ Envie e-mail [email protected]

¶ Ligue 1-800-848-6548

¶ Navegue em nosso site da Web emhttp://www.support.tivoli.com

Para suporte fora dos Estados Unidos, consulte o Manual de Suporteao Cliente para obter os números de telefone em seu país. O Manualde Suporte ao Cliente está disponível online emhttp://www.support.tivoli.com .

xiiiTivoli Workload Scheduler Guia de Referência

Quando entrar em contato com o Suporte ao Cliente Tivoli, tenha emmãos as informações de identificação de sua empresa para que opessoal de suporte possa ajudar prontamente.

Nós estamos muito interessados em ouvir você a respeito de suaexperiência com produtos e documentações Tivoli. Suas sugestõespara melhorias são bem-vindas. Se você tiver comentários esugestões sobre esta documentação, envie um e-mail [email protected].

xiv Versão 7.0

Referência do Composer

O programa Composer é utilizado para gerenciar objetos deplanejamento no banco de dados do Workload Scheduler. Os objetosde planejamento são estações de trabalho, classes de estações detrabalho, domínios, jobs, fluxos de job, recursos, prompts,calendários e parâmetros. Este capítulo descreve a sintaxe docomando Composer e a sintaxe utilizada para definir os objetos deplanejamento.

Como Gerenciar Objetos de PlanejamentoOs objetos de planejamento são gerenciados com o programaComposer e são armazenados no banco de dados do WorkloadScheduler. Para adicionar um novo objeto você digita sua definiçãoem um arquivo de edição que será verificado antes de ser adicionadoao banco de dados para saber se a sintaxe está correta.

É possível acessar as entradas do banco de dados para fluxos de job,jobs, usuários, estações de trabalho, domínios e classes de estaçõesde trabalho e gerenciá-las individualmente. Por exemplo, paramodificar uma definição de job existente, a definição é copiada dobanco de dados para um arquivo de edição para que você omodifique; o arquivo de edição é verificado quanto à sintaxe corretae a definição modificada é copiada de volta para o banco de dados,substituindo a definição existente.

As entradas do banco de dados para calendários, parâmetros,prompts e recursos são gerenciadas como listas completas. Por

1

1Tivoli Workload Scheduler Guia de Referência

1.R

eferênciado

Com

poser

exemplo, para modificar um recurso existente, a lista de recursoscompleta é copiada do banco de dados para um arquivo de ediçãopara que você o modifique; o arquivo de edição é verificado quantoà sintaxe correta e a nova lista é copiada de volta para o banco dedados, substituindo a lista de recursos existente.

Como Gerenciar Objetos de Planejamento

2 Versão 7.0

Definições da Estação de TrabalhoUma estação de trabalho é um objeto de planejamento que executajobs. Você pode incluir várias definições de estação de trabalho nomesmo arquivo de texto, junto com definições de classes de estaçãode trabalho e definições de domínio.

Sinopse

#[ comment]cpuname wkstation [description ″text″]os os-typenode hostname [tcpaddr port][timezone|tz tzname][domain domainname][for maestro [host host-wkstation[accessmethod]]

[type fta | s-agent | x-agent][ignore][autolink on | off][fullstatus on | off][resolvedep on | off][server serverid]]

end

[cpuname ...]

[cpuclass ...]

[domain ...]

Argumentos# comment

Especifica que tudo deve ser tratado como comentário, dosinal de libra até o fim da linha.

cpunamewkstationEspecifica o nome da estação de trabalho. O nome deveiniciar com uma letra e pode conter caracteres alfanuméricos,traços e sublinhados. Para bancos de dados não-expandidos,



1.R

eferênciado

Com

poser

ele pode conter até oito caracteres. Para bancos de dadosexpandidos, ele pode conter até 16 caracteres.

Nota: Os nomes de estação de trabalho devem serexclusivos e não podem ser iguais aos nomes dedomínio e classe de estação de trabalho.

description “ text”Fornece uma descrição da estação de trabalho. Seu textodeve ser colocado entre aspas duplas.

os os-typeEspecifica o sistema operacional da estação de trabalho. Ossistemas válidos sãoMPEV , MPIX , UNIX , WNT eOTHER .

node hostnameEspecifica o nome do host ou o endereço IP da estação detrabalho. Os nomes de domínio completamente qualificadossão aceitos.

tcpaddr portEspecifica o número da porta TCP que o WorkloadScheduler utiliza para comunicações na estação de trabalho.O padrão é31111.

timezone|tztznameEspecifica o fuso horário da estação de trabalho. Consulte“Nomes dos Fusos Horários” na página 319 para obter osnomes dos fusos horários válidos. Para assegurar a exatidãodo planejamento de horas, este fuso horário deve ser igual aofuso horário do sistema operacional do computador.

domain domainnameEspecifica o nome do domínio da estação de trabalho doWorkload Scheduler. O padrão para os agentes de tolerânciaa falhas e padrão é o domínio mestre, geralmente nomeadoMASTERDM . O padrão para um gerenciador de domínio éo domínio no qual ele é definido como gerenciador. Opadrão para um agente estendido é o domínio de sua estaçãode trabalho host.


4 Versão 7.0

host host-wkstationEspecifica o nome da estação de trabalho host do agente.Isto é requerido para agentes estendidos. O host é a estaçãode trabalho com a qual o agente estendido se comunica eonde seu método de acesso reside. Observe que o host nãopode ser outro agente estendido.

accessmethodEspecifica um método de acesso para agentes estendidos eagentes de rede. Deve ser o nome de um arquivo que residano diretórioTWShome/methodsna estação de trabalho hostdo agente.

type Especifica o tipo de estação de trabalho. Digite um dosseguintes agentes:

fta Agente de tolerância a falhas, incluindogerenciadores de domínio e gerenciadores dedomínio de backup.

s-agentAgente padrão.

x-agentAgente estendido.

ignore Especifica que o Workload Scheduler irá ignorar essadefinição de estação de trabalho.

autolinkEspecifica se o link deve ser aberto entre as estações detrabalho na inicialização. Para agentes de tolerância a falhase padrão, digiteon para que o gerenciador de domínio abrao link para o agente quando o gerenciador de domínio foriniciado. Para o gerenciador de domínio, digiteon para queseus agentes abram links para o gerenciador de domínioquando forem iniciados.

O autolink é útil principalmente durante a seqüência deinicialização no início de cada dia. Nesse momento, um novoplano de produção é criado e compilado no gerenciador dedomínios mestre e todas as estações de trabalho sãoencerradas e reiniciadas. Para cada agente que tenha o



1.R

eferênciado

Com

poser

autolink ativado, o gerenciador de domínio enviaráautomaticamente uma cópia do novo plano de produção einiciará o agente. Seo autolink também for ativado para ogerenciador de domínio, o agente, por sua vez, abrirá umlink de volta com o gerenciador de domínio. Se o valor doautolink for off para um agente, ele será inicializado quandovocê executar um comandolink do Conman no gerenciadorde domínio do agente ou no gerenciador de domínio mestre.

fullstatusEspecifica se o agente deve ser atualizado com statuscompleto ou parcial. Isto é apenas para agentes de tolerânciaa falhas. Digiteon para que o agente opere no modoStatusCompleto. Neste modo, o agente é atualizado sobre o statusdos jobs e fluxos de job em execução em todas as outrasestações de trabalho de seu domínio e domíniossubordinados.

Se o valor dofullstatus for off, o agente será informadoapenas sobre o status dos jobs e fluxos de job em outrasestações de trabalho que afetam seus próprios jobs e fluxosde job. Isto pode melhorar o desempenho reduzindo aatividade da rede.

Para manter o plano de produção de um agente no mesmonível de detalhe de seu gerenciador de domínio, definafullstatus e resolvedepcomoon. Esses valores devem serdefinidos sempre comoon para gerenciadores de domínio debackup.

resolvedepEspecifica se um agente rastreará todas as dependências ouapenas a sua própria. Isto é apenas para agentes de tolerânciaa falhas. Digiteon para que o agente opere no modoResolver Todas as Dependências. Neste modo, o agenterastreia as dependências de todos os jobs e fluxos de job,incluindo aqueles em execução em outras estações detrabalho. Observe quefullstatus também deve ser definidocomoon para que o agente seja informado sobre a atividadeem outras estações de trabalho. Se o valor deresolvedepfor


6 Versão 7.0

off, o agente rastreará dependências apenas para seuspróprios jobs e fluxos de job. Isto reduz a sobrecarga deprocessamento.

Para manter o plano de produção de um agente no mesmonível de detalhe de seu gerenciador de domínio, definafullstatus e resolvedepcomoon. Esses valores devem serdefinidos sempre comoon para gerenciadores de domínio debackup.

server serveridEspecifica um servidor Mailman no gerenciador de domíniopara tratar das comunicações com o agente. Isto é apenaspara agentes de tolerância a falhas e padrão. Não utilize estaopção para gerenciadores de domínio. Utilizar servidorespode reduzir o tempo requerido para inicializar agentes emelhorar a linha de tempo de mensagens.

O ID é uma única letra ou um número (A-Z e 0-9). Os IDssão exclusivos para cada gerenciador de domínios, portanto,você pode utilizar os mesmos IDs em outros domínios semconflito. Se mais de 36 IDs de servidor forem requeridos emum domínio, considere dividi-lo em dois ou mais domínios.

Se um ID de servidor não for especificado, as comunicaçõescom o agente serão tratadas pelo processo Mailman principalno gerenciador de domínios.

Ao ser inicializado, o gerenciador de domínio cria umservidor separado para cada ID de servidor exclusivo. Se omesmo ID for utilizado para vários agentes, um únicoservidor será criado para manipular suas comunicações.Como um guia, os servidores extras devem ser definidospara evitar que um único servidor manipule mais de oitoagentes.

ExemplosO exemplo a seguir cria um gerenciador de domínio mestre chamadohdq-1 e um agente de tolerância a falhas chamadohdq-2 nodomínio mestre. Observe que um argumentodomain é opcionalneste exemplo, porque o domínio mestre é padronizado comomasterdm.



1.R

eferênciado

Com

poser

cpuname hdq-1 description “Headquarters master DM”os unixtz pstnode sultan.unison.comdomain masterdmfor maestro type fta

autolink onfullstatus onresolvedep on

end

cpuname hdq-2os wnttz pstnode opera.unison.comdomain masterdmfor maestro type fta

autolink onend

O exemplo a seguir cria um domínio chamadodistr-a com umgerenciador de domínio chamadodistr-a1 e um agente padrãochamadodistr-a2:domain distr-a

manager distr-a1parent masterdm

end

cpuname distr-a1 description “District A domain mgr”os wnttz estnode pewter.unison.comdomain distr-afor maestro type fta

autolink onfullstatus onresolvedep on

end

cpuname distr-a2os wntnode quatro.unison.comtz estdomain distr-afor maestro type s-agent

host distr-a1end


8 Versão 7.0

Definições de Classes de Estações de TrabalhoUma classe de estação de trabalho é um grupo de estações detrabalho nas quais se podem gravar fluxos de job comuns. Você podeincluir várias definições de classes de estação de trabalho no mesmoarquivo de texto, junto com definições de estação de trabalho edefinições de domínio.

Sinopse

# commentcpuclass wkstationclassmembers { wkstation | @} [...]

end

[cpuname ...]

[cpuclass ...]

[domain ...]

Argumentos# comment


cpuclasswkstationclassEspecifica o nome da classe de estação de trabalho. O nomedeve iniciar com uma letra e pode conter caracteresalfanuméricos, traços e sublinhados. Para bancos de dadosnão-expandidos, ele pode conter até oito caracteres. Parabancos de dados expandidos, ele pode conter até 16caracteres.

Nota: Não é possível utilizar nomes iguais para estações detrabalho, classes de estação de trabalho e domínios.

memberswkstationEspecifica uma lista de nomes de estações de trabalho,separadas por espaços, que são membros da classe. Ocaractere curinga a de arroba (@) inclui todas as estações detrabalho.



1.R

eferênciado

Com

poser

ExemplosO exemplo a seguir define uma classe de estação de trabalhochamadabackup:cpuclass backup

membersmainsite1site2

end

O exemplo a seguir define uma classe de estação de trabalhochamadaallcpus que contém todas as estações de trabalho:cpuclass allcpus

members@

end


10 Versão 7.0

Definições de DomínioUm domínio é um grupo de estações de trabalho que consiste em umou mais agentes e em um gerenciador de domínio. O gerenciador dedomínio age como um hub de gerenciamento para os agentes nodomínio. Você pode incluir várias definições de domínio no mesmoarquivo de texto, junto com definições de estação de trabalho edefinições de classes de estação de trabalho.

Sinopse

# commentdomain domainname[description “ text”]manager wkstation[parent domainname]

end

[cpuname ...]

[cpuclass...]

[domain ...]

Argumentos# comment


domain domainnameEspecifica o nome do domínio. O nome deve iniciar comuma letra e pode conter caracteres alfanuméricos, traços esublinhados. Para bancos de dados não-expandidos, ele podeconter até oito caracteres. Para bancos de dados expandidos,ele pode conter até 16 caracteres.

Nota: Não é possível utilizar nomes iguais para estações detrabalho, classes de estação de trabalho e domínios.

description “ text”Fornece uma descrição do domínio. Seu texto deve sercolocado entre aspas duplas.



1.R

eferênciado

Com

poser

manager wkstationEspecifica o nome da estação de trabalho que é ogerenciador de domínio. O gerenciador de domínio deve serum agente de tolerância a falhas comfullstatus e resolvedepdefinidos comoon.

parent domainnameEspecifica o nome do domínio pai ao qual o gerenciador dedomínio está ligado. O padrão é o domínio mestre.

Nota: O domínio mestre não requer uma definição de domínio. Odomínio mestre é definido pelas opções globaismaster emaster domain.

ExemplosO exemplo a seguir define um domínio chamadoeast, com odomínio mestre como seu pai, e dois domínios subordinadoschamadosnortheast e southeast:domain east description “O domínio Eastern”

manager cyclopsenddomain northeast description “O domínio Northeastern”

manager boxcar parent eastenddomain southeast description “O domínio Southeastern”

manager sedan parent eastend


12 Versão 7.0

Definições do JobUm job é um arquivo, programa ou comando executável que éplanejado e lançado pelo Workload Scheduler. Você pode gravardefinições de job em arquivos de edição e, em seguida, adicioná-losao banco de dados do Workload Scheduler com o programaComposer. É possível incluir várias definições de job em um únicoarquivo de edição. Observe que as dependências do job sãoespecificadas quando os fluxos de job são gravados. A linguagem deplanejamento utilizada para gravar fluxos de job também permite aadição e modificação de definições do job.

Sinopse

$jobs[wkstation#]jobname

[description “ text”]{ scriptname | jobfilename} filename | docommand \

“command”streamlogon username

[interactive][recovery

{ stop | continue | rerun}[{ recoveryjob | after} [ wkstation#]jobname][{ recoveryprompt | abendprompt} “ text”] ]

[ [wkstation#]jobname... ]

Argumentoswkstation#

Especifica o nome da estação de trabalho ou classe detrabalho na qual o job é executado. O padrão é a estação detrabalho na qual o Composer está sendo executado.O sinalde libra (#) é um delimitador necessário. Se você especificaruma classe de estação de trabalho, ela deverá corresponder àclasse de estação de trabalho de qualquer fluxo de job noqual o job foi incluído.

jobnameEspecifica o nome do job. O nome deve iniciar com uma



1.R

eferênciado

Com

poser

letra e pode conter caracteres alfanuméricos, traços esublinhados. Para bancos de dados não-expandidos, ele podeconter até oito caracteres. Para bancos de dados expandidos,ele pode conter até 40 caracteres.

description “ text”Fornece uma descrição do job. Seu texto deve ser colocadoentre aspas duplas.

{scriptname | jobfilename} filename

Especifica o nome do arquivo executado pelo job. Utilizescriptname para jobs do UNIX e Windows NT, ejobfilename para jobs do MPE. Para um arquivo executável,digite o nome do arquivo e todas as opções e argumentos.Para bancos de dados não-expandidos, pode conter até 255caracteres. Para bancos de dados expandidos, pode conter até4095 caracteres. Os parâmetros do Workload Schedulertambém podem ser utilizados. Consulte “Como UtilizarParâmetros nas Definições de Job” na página 17 para obtermais informações.

Para jobs do Windows NT, inclua as extensões de arquivo.Os nomes da Universal Naming Convention (UNC) sãopermitidos. Não especifique arquivos em unidades mapeadas.

Se espaços ou caracteres especiais forem incluídos,diferentes de barras (/) e barras invertidas (\), toda a cadeiadeverá ser colocada entre aspas (″).

Se o nome do arquivo contiver espaços, digite o nome emoutro arquivo que não possua espaços em seu nome e utilizeo nome do segundo arquivo para este argumento.

docommandcommandEspecifica um comando executado pelo job. Digite umcomando válido e todas as opções e argumentos (até 4095caracteres) entre aspas (″). Um comando é executadodiretamente e, ao contrário descriptname ou jobfilename, oscript de configuração,jobmanrc, não é executado. Casocontrário, o comando será tratado como um job, e todas asregras de jobs serão aplicadas. Os parâmetros do Workload


14 Versão 7.0

Scheduler também podem ser inseridos. Consulte “ComoUtilizar Parâmetros nas Definições de Job” na página 17 paraobter mais informações.

streamlogonusername

O nome do usuário sob o qual o job é executado. O nomepode conter até 47 caracteres. Se o nome contiver caracteresespeciais, ele deverá ser colocado entre aspas (″).Especifique um usuário que pode iniciar sessão na estação detrabalho na qual o job é executado. Os parâmetros doWorkload Scheduler também podem ser inseridos. Consulte“Como Utilizar Parâmetros nas Definições de Job” napágina 17 para obter mais informações.

Para jobs do Windows NT, o usuário também deverá ter umadefinição de usuário. Consulte “Definições do Usuário” napágina 18 para obter requisitos do usuário.

interactive

Para jobs do Windows NT, inclua esta palavra-chave paraindicar que o job é executado de forma interativa no desktopdo Windows NT.

recovery

Recupera opções para o job. O padrão éstop sem job derecuperação e sem prompt de recuperação. Digite uma dasopções de recuperação,stop, continue ou rerun . Elaspodem vir seguidas de um job de recuperação, um prompt derecuperação ou de ambos.

stop Se ocorrer abend do job, não continuar com opróximo job.

continueSe ocorrer abend do job, continuar com o próximojob.

rerun Se ocorrer abend do job, reexecutar o job.

{recoveryjob | after} [wkstation#]jobname



1.R

eferênciado

Com

poser

Especifica o nome de um job de recuperação a serexecutado, se o job pai terminar de forma anormal.Os jobs de recuperação são executados somente umavez para cada ocorrência terminada de formaanormal do job pai.

Você pode especificar a estação de trabalho do jobde recuperação se for diferente da estação detrabalho do job pai. O padrão é a estação de trabalhodo job pai. Nem todos os jobs são elegíveis paraexecutarem os jobs de recuperação em uma estaçãode trabalho diferente. Siga estas instruções:

¶ A estação de trabalho do job pai e do job derecuperação devem estar executando o WorkloadScheduler Versão 4.5.5 ou posterior.

¶ Se uma das estações de trabalho for um agenteestendido, ela deverá ser alojada por umgerenciador de domínio ou por um agente detolerância a falhas com um valor deon parafullstatus.

¶ A estação de trabalho do job de recuperaçãodeve estar no mesmo domínio que a estação detrabalho do job pai.

¶ Se a estação de trabalho do job de recuperaçãofor um agente de tolerância a falhas, ela deveráter um valor deon parafullstatus.

{recoveryprompt | abendprompt} “ text”Especifica o texto de um prompt de recuperação,colocado entre aspas, a ser exibido se ocorrer abenddo job. O texto pode conter até 64 caracteres. Se otexto começar com dois-pontos (:), o prompt seráexibido, mas nenhuma resposta será necessária paracontinuar o processamento. Se o texto começar comum ponto de exclamação (!), o prompt não seráexibido, mas será necessária uma resposta paracontinuar.


16 Versão 7.0

Como Utilizar Parâmetros nas Definições de JobOs parâmetros possuem os seguintes usos e limitações nas definiçõesdo job:¶ São permitidos parâmetros nos valoresstreamlogon, scriptname

e docommand.¶ Um parâmetro pode ser utilizado como uma cadeia completa ou

uma parte dela.¶ São permitidos vários parâmetros em uma única variável.¶ Os nomes de parâmetros devem ser incluídos entre sinais de

intercalação (^), e a cadeia completa entre aspas.

Consulte o exemplo abaixo onde um parâmetro chamadomis éutilizado no valorstreamlogon. Para obter outros exemplos, consulte“Definições dos parâmetros” na página 22.

ExemplosA seguir, está o exemplo de um arquivo contendo duas definições dejob:$jobscpu1#gl1

scriptname "/usr/acct/scripts/gl1"streamlogon acctdescription "general ledger job1"

bkupscriptname "/usr/mis/scripts/bkup"streamlogon "^mis^"recovery continue after recjob1



1.R

eferênciado

Com

poser

Definições do UsuárioOs nomes de usuário utilizados como o valorstreamlogon

para as definições de job do Windows NT devem ter definições deusuário. Isto não é necessário para usuários que executam jobs emoutras plataformas.

Sinopse

# commentusername[wkstation#]usernamepassword “senha”

end

[username...]

Argumentos# comment


username [wkstation#]usernameEspecifica o nome de um usuário do Windows NT.

wkstationEspecifica a estação de trabalho na qual o usuáriotem permissão para lançar jobs. O sinal de libra énecessário. O padrão é em branco, significando todasas estações de trabalho.

username

Especifica o nome do usuário no seguinte formato:

[domain\]user

ondedomainé o domínio do Windows NT dousuário euseré o nome do usuário.

Para bancos de dados não-expandidos, o nome podeconter até oito caracteres. Para bancos de dadosexpandidos, o nome do usuário pode conter até 16


18 Versão 7.0

caracteres (incluindo a barra invertida), e o nome dousuário pode conter até 31 caracteres.

Observe que os nomes de usuários do Windows NTfazem distinção entre maiúsculas e minúsculas. Alémdisso, o usuário deve estar apto a iniciar sessão naestação de trabalho na qual o Workload Scheduler irálançar jobs e deve ter o direito deIniciar sessãocomo batch.

Se o nome não for exclusivo no Windows NT, eleserá considerado como um usuário local, usuário dedomínio ou usuário de domínio confiável, nessaordem.

passwordEspecifica a senha do usuário. A senha pode conter até 29caracteres e deve ser colocada entre aspas. Para indicarausência de senha, utilize duas aspas consecutivas semespaços (″″). Depois de uma definição de usuário sercompilada, você não poderá ler a senha. Usuários comprivilégios de segurança apropriados podem modificar ouexcluir um usuário, mas as informações de senha nunca sãoexibidas.

Usuário de Domínio ConfiávelSe o Workload Scheduler tiver que lançar jobs para um usuário dedomínio confiável, a definição das contas de usuário deverá receberatenção especial. Pressupondo-se que o Workload Scheduler estejainstalado noDomain1 para a conta de usuáriomaestro, e a conta deusuáriosueno Domain2 precisa lançar um job, o seguinte deveráser verdadeiro:

¶ Deve haver confiança mútua entreDomain1 e Domain2.

¶ No Domain1 nos computadores onde os jobs são lançados,suedeve ter o direito paraIniciar sessão como batch.

¶ No Domain1, maestro deve ser um usuário de domínio.

¶ Nos controladores de domínio noDomain2, maestro deve ter odireito paraAcessar este computador a partir da rede.



1.R

eferênciado

Com

poser

ExemplosO exemplo a seguir define quatro usuários:username joe

password "okidoki"end#username server#jane

password "okitay"end#username dom1\jane

password "righto"end#username jack

password ""end


20 Versão 7.0

Definições do CalendárioOs calendários são listas de datas que podem ser utilizadas paraplanejar fluxos de job.

Sinopse

$calendarcalendarname[“ description”]

date [...]

[calendarname...]

Argumentoscalendarname

Especifica o nome do calendário. O nome pode conter atéoito caracteres alfanuméricos, incluindo traços (-) esublinhados (_) e deve iniciar com uma letra.

“ description”Fornece uma descrição do calendário. Ela deve ser colocadaentre aspas duplas.

date [...]Especifica uma ou mais datas, separadas por espaços. Oformato émm/dd/aa.

ExemplosO exemplo a seguir define três calendários chamadosmonthend,paydayse holidays:$calendarmonthend "Month end dates 1st half '99"

01/31/99 02/28/99 03/31/99 04/30/99 05/31/99 06/30/99paydays

01/15/99 02/15/9903/15/99 04/15/9905/14/99 06/15/99

holidays01/01/99 02/15/99 05/31/99



1.R

eferênciado

Com

poser

Definições dos parâmetrosOs parâmetros são valores que podem ser variáveis substituídas nasdefinições de job e de fluxo de job.

Sinopse

$parmparametername“value”

[parametername...]

Argumentosparametername

O nome do parâmetro. O nome pode conter até oitocaracteres alfanuméricos, incluindo traços (-) e sublinhados(_) e deve iniciar com uma letra.

value Especifica o valor atribuído ao parâmetro. Não inclua osnomes de outros parâmetros.

Notas de UtilizaçãoOs parâmetros são acessíveis a todos os jobs, fluxos de job eprompts. Quando utilizados no planejamento, os nomes dosparâmetros são substituídos por seus valores quando o plano deprodução é compilado para um novo dia de processamento. ConsulteExemplosabaixo.

ExemplosDois parâmetros,glpath e gllogon, são definidos como a seguir:$parmglpath "/glfiles/daily"gllogon "gluser"

Em um fluxo de job chamadoglsched, os parâmetrosglpath egllogon são utilizados em um job chamadogljob2:schedule glsched on weekdays:gljob2

scriptname "/usr/gl^glpath^"


22 Versão 7.0

streamlogon "^gllogon^"opens "^glpath^/datafile"prompt ":^glpath^ started by ^gllogon^"

end



1.R

eferênciado

Com

poser

Definições do PromptOs prompts podem ser utilizados como dependências em jobs efluxos de job.Um prompt deve ser respondido positivamente para ojob ou fluxo de job dependente a ser lançado.

Existem dois tipos de prompts:

¶ ad hoc ou local

¶ pré-definido ou global

Um prompt local é definido dentro das propriedades de um job oufluxo de job e é exclusivo para esse job ou fluxo de job.

Um prompt global é definido no banco de dados do TWS e pode serutilizado por qualquer job ou fluxo de job.

Sinopse

$promptpromptname“[ : | !]text”

[promptname...]

Argumentospromptname

Especifica o nome do prompt. O nome pode conter até oitocaracteres alfanuméricos, incluindo traços (-) e sublinhados(_) e deve iniciar com uma letra.

text

Fornece o texto do prompt. Se o texto começar comdois-pontos (:), o prompt será exibido, mas nenhumaresposta será necessária para continuar o processamento. Seo texto começar com um ponto de exclamação (!), o promptnão será exibido, mas será necessária uma resposta paracontinuar.

Você pode utilizar um ou mais parâmetros como toda acadeia de texto ou parte dela para um prompt. No caso de


24 Versão 7.0

utilizar um parâmetro, a cadeia de parâmetros deverá sercolocada entre sinais de intercalação (^). Consulte“Definições dos parâmetros” na página 22 para obter umexemplo.

Nota: Dentro de um prompt local, quando não estiverdesignando um parâmetro, um acento circunflexo (^)deve ser precedido por uma barra invertida (\) ouocorrerão erros no prompt. Dentro de promptsglobais, os acentos circunflexos não precisam serprecedidos por uma barra invertida.

Você pode incluir uma barra invertida n (\n) no texto paracriar uma nova linha.

ExemplosO exemplo a seguir define três prompts:$prompt

prmt1 "ready for job4? (y/n)"prmt2 ":job4 launched"prmt3 "!continue?"



1.R

eferênciado

Com

poser

Definições do RecursoRepresentam recursos de planejamento físicos ou lógicos que podemser utilizados como dependências para jobs e fluxos de job.

Sinopse

$resourcewkstation#resourcename units[“ description” ]

[wkstation#resourcename...]

Argumentoswkstation

Especifica o nome da estação de trabalho ou classe daestação de trabalho na qual o recurso é utilizado.

resourcenameEspecifica o nome do recurso. O nome pode conter até oitocaracteres alfanuméricos, incluindo traços (-) e sublinhados(_) e deve iniciar com uma letra.

units Especifica o número de unidades de recurso disponíveis.Osvalores podem ser de0 a 1024.

“ description”

Fornece uma descrição do recurso. Ela deve ser colocadaentre aspas duplas.

ExemplosO exemplo a seguir define quatro recursos:$resourceux1#tapes 3 "tape units"ux1#jobslots 24 "job slots"ux2#tapes 2 "tape units"ux2#jobslots 16 "job slots"


26 Versão 7.0

O Programa ComposerO programa Composer gerencia objetos de planejamento no bancode dados do Workload Scheduler.

Como Executar o ComposerPara executar o programa, utilize o seguinte comando:

composer[″command[& [command]][...] ″]

A seguir, exemplos do comando:

¶ Executa o Composer e solicita um comando:composer

¶ Executa os comandosprint e version e sai:composer "p parms&v"

¶ Executa os comandosprint e version e solicita um comando:composer "p parms&v&"

¶ Lê comandos docmdfile:composer < cmdfile

¶ Canaliza comandos docmdfile para o Composer:cat cmdfile | composer

Caracteres de ControleVocê pode digitar os seguintes caracteres de controle no modoconversacional para interromper o Composer se as definições desttyestiverem configuradas para isso.

Ctrl+cO Composer pára a execução do comando atual na próximaetapa que puder ser interrompida e retorna um prompt decomandos.

Ctrl+dO Composer sai após a execução do comando atual.

Saída do TerminalA saída para seu computador é controlada por variáveis shellchamadasMAESTROLINES e MAESTROCOLUMNS . Se ainda

O Programa Composer


1.R

eferênciado

Com

poser

não estiverem definidas, as variáveis shell padrão,LINES eCOLUMNS , serão utilizadas. No final de cada paginação de tela, oComposer solicita para continuar. SeMAESTROLINES (ouLINES ) estiver definido como zero ou um número negativo, oComposer não pausará no final da página.

Saída Offline no Windows NTA opção;offline nos comandos do Composer é utilizada paraimprimir a saída de um comando. Ao incluí-la, as seguintes variáveiscontrolam a saída:

$MAESTROLPEspecifica o arquivo no qual a saída de um comando égravada. O padrão éstdout.

$MAESTROLPLINESEspecifica o número de linhas por página. O padrão é 60.

$MAESTROLPCOLUMNSEspecifica o número de caracteres por linha. O padrão é 132.

Saída Offline no UNIXA opção;offline nos comandos do Composer é utilizada paraimprimir a saída de um comando. Ao incluí-la, as seguintes variáveisshell controlam a saída:

$MAESTROLPEspecifica o destino da saída de um comando. Defina-ocomo um dos seguintes:

> file Redireciona a saída para um arquivo e sobrepõe oconteúdo do arquivo. Se o arquivo não existir, eleserá criado.

>> fileRedireciona a saída para um arquivo e anexa a saídano final do arquivo. Se o arquivo não existir, ele serácriado.

| commandCanaliza a saída para um comando do sistema ouprocesso. O comando do sistema é executadoindependente da saída ser ou não gerada.

O Programa Composer

28 Versão 7.0

|| commandCanaliza a saída para um comando do sistema ouprocesso. O comando do sistema não será executado,se não existir nenhuma saída.

O padrão é| lp -tCONLIST que canaliza a saída docomando para a impressora e coloca o título “CONLIST” napágina do banner da impressão.

$MAESTROLPLINESEspecifica o número de linhas por página. O padrão é60.

$MAESTROLPCOLUMNSEspecifica o número de caracteres por linha. O padrão é132.

Você deve exportar as variáveis antes de executar o Composer.

Como Selecionar o Editor do Composer no Windows NTVários dos comandos do Composer abrem automaticamente umeditor de texto. O padrão é o editor MS-DOS. Para alterá-lo, definaa variávelEDITOR com o nome do novo editor antes de executar oComposer.

Como Selecionar o Editor do Composer no UNIXVários dos comandos do Composer abrem automaticamente umeditor de texto. O tipo de editor é determinado pelo valor de duasvariáveis shell. Se a variávelVISUAL estiver definida, ela definirá oeditor, caso contrário, a variávelEDITOR definirá o editor. Senenhuma das duas estiver definida, um editorvi será aberto.

Como Selecionar o Prompt de Comandos do Composer noUNIX

O prompt de comandos do Composer é definido no arquivo demensagensTWShome/catalog/maestro.msg. O prompt de comandospadrão é um traço (-). Para selecionar um prompt diferente, edite oarquivo de mensagens, localize o conjunto 208, número demensagem 01 e altere o caractere dessa linha. O prompt pode ter atédez caracteres, fora o sinal de libra (#) necessário. Após alterar oprompt, gere um novo arquivo catálogo a partir do arquivo demensagens alterado, como a seguir:

O Programa Composer


1.R

eferênciado

Com

poser

cd TWShome/cataloggencat maestro.cat maestro.msg

Sintaxe de ComandosOs comandos do Composer consistem nos seguintes elementos:

commandname selection arguments

onde:

commandnameEspecifica o nome do comando.

selectionEspecifica o objeto ou conjunto de objetos sobre os quais aação será tomada.

argumentsEspecifica os argumentos do comando.

Caracteres CuringaOs seguintes caracteres curinga são permitidos em alguns comandosdo Composer:

@ Substitui um ou mais caracteres alfanuméricos.

? Substitui um caractere alfabético.

% Substitui um caractere numérico.

Delimitadores e Caracteres EspeciaisOs caracteres a seguir possuem significados especiais nos comandosdo Composer.

Caractere Descrição

& Delimitador de comando. Consulte “Como Executar oComposer” na página 27.

; Delimitador de argumento. Por exemplo:

;info;offline

= Delimitador de valor. Por exemplo:

sched=sked5

O Programa Composer

30 Versão 7.0


: ! Prefixos de comandos que transmitem o comando para osistema. Esses prefixos são opcionais; se o Composer nãoreconhecer o comando, ele será transmitidoautomaticamente ao sistema. Por exemplo:

!ls ou :ls

<< >> Colchetes de comentários. Os comentários podem sercolocados em uma única linha em qualquer lugar do fluxode job. Por exemplo:

schedule foo <<comment>> on everyday

* Prefixo do comentário. Quando este prefixo for o primeirocaractere de uma linha, toda a linha será um comentário.Quando o prefixo vier depois de um comando, o restanteda linha será um comentário. Por exemplo:

*commentouprint& *comment

> Redireciona a saída de comando para um arquivo esobrepõe o conteúdo do arquivo. Se o arquivo não existir,ele será criado. Por exemplo:

display parms > parmlist

>> Redireciona a saída de comando para um arquivo e anexaa saída no final do arquivo. Se o arquivo não existir, eleserá criado. Por exemplo:

display parms >> parmlist

| Canaliza a saída de comando para um comando do sistemaou processo. O comando do sistema é executadoindependente da saída ser ou não gerada. Por exemplo:

display parms | grep alparm

|| Canaliza a saída de comando para um comando do sistemaou processo. O comando do sistema não será executado, senão existir nenhuma saída. Por exemplo:

display parms || grep alparm

Descrições dos ComandosAs páginas a seguir descrevem os comandos do Composer.

O Programa Composer


1.R

eferênciado

Com

poser

Comandos Descrição Página

add Adiciona objetos de planejamento. 33

build Constrói ou reconstrói um arquivo do Workload Scheduler. 35

continue Ignora o próximo erro. 37

create Cria um arquivo para edição. 38

delete Exclui objetos de planejamento. 41

display Exibe objetos de planejamento. 43

edit Edita um arquivo. 48

exit Termina o Composer. 49

list Lista objetos de planejamento. 43

modify Modifica objetos de planejamento. 50

new Edita e adiciona objetos de planejamento. 53

print Imprime objetos de planejamento. 43

redo Edita o comando anterior. 54

replace Substitui objetos de planejamento. 56

validate Valida um arquivo. 57

version Exibe o banner do programa Composer. 59

system commandTransmite um comando do sistema ao sistema. 60

Os nomes de comandos e palavras-chave podem ser digitados emletras maiúsculas ou minúsculas. Também podem ser abreviados como mínimo de caracteres iniciais, o necessário para distingui-los unsdos outros.

Descrições dos Comandos

32 Versão 7.0

addAdiciona jobs, fluxos de job, usuários, estações de trabalho, classesde estação de trabalho e domínios. Você deve ter acessoadd paranovos objetos. Se um objeto já existir, você deverá ter o acessomodify para o objeto.

Sinopseadd filename

Argumentosfilename

Especifica o nome de um arquivo que contém o seguinte:

¶ Definições do job. (A primeira linha do arquivo deve ser$jobs.)

¶ Definições do fluxo de job.

¶ Qualquer combinação de definições de estação detrabalho, de classe da estação de trabalho e de domínio.

¶ Definições do usuário.

Notas de UtilizaçãoA sintaxe do arquivo é sempre verificada antes de ser gravada nobanco de dados. Todos os erros e avisos são relatados. Se houvererros de sintaxe, será perguntado se deseja editar o arquivo parafazer correções. Se um objeto já existir, será perguntado se deseja ounão substituí-lo.

ExemplosO exemplo a seguir adiciona os jobs do arquivomyjobs:add myjobs

O exemplo a seguir adiciona os fluxos de job do arquivomysked:a mysked

O exemplo a seguir adiciona as estações de trabalho, classes deestação de trabalho e domínios do arquivocpus.src:a cpus.src



1.R

eferênciado

Com

poser

O exemplo a seguir adiciona as definições de usuário do arquivousers_nt:a users_nt


34 Versão 7.0

buildConstrói ou reconstrói arquivos de banco de dados do WorkloadScheduler. Você deve ter acessobuild ao arquivo.

Sinopsebuild filename

Argumentosfilename

Especifica um dos seguintes nomes de arquivos:

calendarsO arquivo que contém definições de calendários.

cpudataO arquivo que contém definições de estação detrabalho, de classe da estação de trabalho e dedomínio.

jobs O arquivo que contém definições de jobs.

mastskedO arquivo que contém definições de fluxos de job.

parms O arquivo que contém definições de parâmetros.

promptsO arquivo que contém definições de prompts.

resourcesO arquivo que contém definições de recursos.

userdataO arquivo que contém definições de usuários.

Notas de UtilizaçãoSe um arquivo não existir, um será criado. Se existir, seráreconstruído. Reconstruir um arquivo de banco de dados pode serútil quando o banco de dados se torna fragmentado com inúmerasadições e exclusões. A reconstrução removerá registros não-utilizadose otimizará as teclas.



1.R

eferênciado

Com

poser

ExemplosO exemplo a seguir reconstrói os arquivos que contém definições defluxos de job:build mastsked

O exemplo a seguir reconstrói o arquivo que contém calendários:build calendars

O exemplo a seguir reconstrói o arquivo que contém estações detrabalho:b cpudata


36 Versão 7.0

continueEspecifica para ignorar o próximo erro de comando.

Sinopsecontinue

Notas de UtilizaçãoEsse comando é útil quando vários comandos são digitados na linhade comandos ou redirecionados a partir de um arquivo. Ele orienta oComposer a continuar a execução de comandos, mesmo se opróximo comando, depois decontinue, resultar em erro. Estecomando não é necessário quando você digita comandosinterativamente porque o Composer não sairá em um erro.

ExemplosO exemplo a seguir informa ao Composer para continuar com ocomandoprint se o comandodelete resultar em erro:composer "continue&delete cpu=site4&print cpu=@"



1.R

eferênciado

Com

poser

createCria um arquivo contendo definições de objetos. Você deve teracessodisplay aos objetos sendo copiados.

Sinopse

create filename from calendars | parms | prompts | resources |cpu={ wkstation | wkstationclass| domain} |jobs=[wkstation#]jobname |sched=[wkstation#]jstream |users=[wkstation#]username

Argumentosfilename

Especifica um nome de arquivo.

calendarsCopia todos os calendários para o arquivo.

parms Copia todos os parâmetros para o arquivo.

promptsCopia todos os prompts para o arquivo.

resourcesCopia todos os recursos para o arquivo.

cpu Copia uma estação de trabalho, classe de estação de trabalhoou domínio para o arquivo.

wkstationO nome da estação de trabalho. Caracteres curingasão permitidos.

wkstationclassO nome da classe de estação de trabalho. Caracterescuringa são permitidos.

domainO nome do domínio. Caracteres curinga sãopermitidos.

jobs Copia um job para o arquivo.


38 Versão 7.0

wkstationO nome da estação de trabalho ou classe de estaçãode trabalho na qual o job é executado. Caracterescuringa são permitidos. O padrão é a estação detrabalho na qual o Composer está sendo executado.

jobnameO nome do job. Caracteres curinga são permitidos.

sched Copia um fluxo de job para o arquivo.

wkstationO nome da estação de trabalho ou classe de estaçãode trabalho na qual o fluxo de job é executado.Caracteres curinga são permitidos. O padrão é aestação de trabalho na qual o Composer está sendoexecutado.

jstreamO nome do fluxo de job. Caracteres curinga sãopermitidos.

users Copia um usuário para o arquivo. O campo de senha não écopiado por motivos de segurança.

wkstationO nome da estação de trabalho na qual o usuário foidefinido. Caracteres curinga são permitidos. Opadrão é a estação de trabalho na qual o Composerestá sendo executado.

usernameO nome do usuário. Caracteres curinga sãopermitidos.

Notas de UtilizaçãoDepois de criar um arquivo, você pode utilizar o comandoedit parafazer alterações no arquivo. O comandoadd ou replace pode, emseguida, ser utilizado para adicionar ou atualizar a definição.

ExemplosO exemplo a seguir cria um arquivo contendo todos os calendários:create caltemp from calendars



1.R

eferênciado

Com

poser

O exemplo a seguir cria um arquivo contendo todos os fluxos dejob:cr stemp from sched=@


40 Versão 7.0

deleteExclui definições de objetos do banco de dados. Você deve teracessodeleteaos objetos sendo excluídos.

Sinopse

delete cpu={ wkstation | wkstationclass| domain} |jobs=[wkstation#]jobname |sched=[wkstation#]jstream |users=[wkstation#]username

Argumentoscpu Exclui uma estação de trabalho, classe de estação de trabalho

ou domínio.




jobs Exclui um job.



sched Exclui um fluxo de job.

wkstationO nome da estação de trabalho ou classe de estaçãode trabalho na qual o fluxo de job é executado.



1.R

eferênciado

Com

poser

Caracteres curinga são permitidos. O padrão é aestação de trabalho na qual o Composer está sendoexecutado.


users Exclui um usuário.



Notas de UtilizaçãoSe você utilizar caracteres curinga para especificar um conjunto dedefinições, o Composer irá requerer confirmação antes de excluircada definição correspondente.

ExemplosO exemplo a seguir exclui ojob3 lançado na estação de trabalhosite3:delete jobs=site3#job3

O exemplo a seguir exclui todas as estações de trabalho com nomescomeçando porux:de cpu=ux@

O exemplo a seguir exclui todos os fluxos de job com nomescomeçando portest em todas as estações de trabalho:de sched=@#test@


42 Versão 7.0

display, list, printExibe, lista ou imprime definições de objetos. Paradisplay e print ,você deve ter acessodisplay ao objeto.O display realmente exibe oconteúdo do objeto de banco de dados, enquantolist e print exibemo nome e atributos do objeto de banco de dados.

Sinopse

display | list | print calendars | parms | prompts | resources |cpu={ wkstation | wkstationclass| domain} |jobs=[wkstation#]jobname |sched=[wkstation#]jstream |users=[wkstation#]username

Argumentoscalendars

Exibe todos os calendários.

parms Exibe todos os parâmetros.

promptsExibe todos os prompts.

resourcesExibe todos os recursos.

cpu Exibe uma estação de trabalho, classe de estação de trabalhoou domínio.




jobs Exibe um job.



1.R

eferênciado

Com

poser



sched Exibe um fluxo de job.



users Exibe um usuário. (O campo de senha não é copiado pormotivos de segurança.)



Saída do ComandoO comandolist exibe apenas os nomes de objetos. A saída docomandoprint é controlada pela variável MAESTROLP. Consulte“Saída Offline” na página 101 para obter mais informações.


44 Versão 7.0

Formato dos Calendários

CalendárioO nome do calendário.

DescriçãoUma descrição de forma livre do calendário.

Depois desses campos há uma lista de datas de calendários.

Formato da Cpu

ID da CPUO nome de uma estação de trabalho, classe de estação detrabalho ou domínio.

CriadorO nome do usuário que criou a definição da estação de trabalho.

Última AtualizaçãoA data em que a definição da estação de trabalho foi atualizadapela última vez.

Depois desses campos, está a definição da estação de trabalho ou daclasse de estação de trabalho.

Formato dos Jobs

ID da CPUO nome da estação de trabalho em que o job é executado.

Job O nome do job.

Início de SessãoO nome do usuário de início de sessão do job.

Data da Última ExecuçãoA data em que o job foi executado pela última vez.

Depois desses campos, está a definição do job.



1.R

eferênciado

Com

poser

Formato dos Parâmetros

ParâmetroO nome do parâmetro.

Valor O valor do parâmetro.

Formato dos Prompts

PromptO nome do prompt.

MensagemO texto da mensagem do prompt.

Formato dos Recursos

ID da CPUO nome da estação de trabalho na qual o recurso foi definido.

RecursoO nome do recurso.

Sem DispO número total de unidades de recursos.

DescriçãoA descrição de forma livre do recurso.

Formato da Agenda

ID da CPUO nome da estação de trabalho em que o fluxo de job éexecutado.

AgendaO nome do fluxo de job.

CriadorO nome do usuário que criou a definição do fluxo de job.

Última AtualizaçãoA data em que a definição do fluxo de job foi atualizada pelaúltima vez.


46 Versão 7.0

Depois desses campos, está a definição do fluxo de job.

Formato dos Usuários

ID da CPUO nome da estação de trabalho na qual o usuário tem permissãopara executar jobs.

UsuárioO nome do usuário.

CriadorO nome do usuário que criou a definição do usuário.

Última AtualizaçãoA data em que a definição do usuário foi atualizada pela últimavez.

Depois desses campos, está a definição do usuário.

ExemplosO exemplo a seguir exibe todos os calendários:display calendars

O exemplo a seguir imprime todos os fluxos de job lançados naestação de trabalhosite2:di sched=site2#@;offline



1.R

eferênciado

Com

poser

editEdita um arquivo.

Sinopseedit filename

Notas de UtilizaçãoUm editor é iniciado e o arquivo especificado é aberto para edição.Consulte “O Programa Composer” na página 27 para obter maisinformações.

ExemplosO exemplo a seguir abre o arquivomytemp para edição:edit mytemp

O exemplo a seguir abre o arquivoresfile para edição:ed resfile


48 Versão 7.0

exitSai do programa Composer.

Sinopseexit

Notas de UtilizaçãoQuando o programa Composer está sendo executado no modo deauxílio, este comando retorna o Composer para o modo de entradado comando.

ExemplosOs exemplos a seguir saem do programa Composer:exit

e



1.R

eferênciado

Com

poser

modifyModifica ou adiciona objetos de planejamento. Você deve ter acessomodify ao objeto ou arquivo de banco de dados afetado.

Sinopse

modify calendars | parms | prompts | resources |cpu={ wkstation | wkstationclass| domain} |jobs=[wkstation#]jobname |sched=[wkstation#]jstream |users=[wkstation#]username

Argumentoscalendars

Modifica todos os calendários.

parms Modifica todos os parâmetros.

promptsModifica todos os prompts.

resourcesModifica todos os recursos.

cpu Modifica uma estação de trabalho, classe de estação detrabalho ou domínio.




jobs Modifica um job.

wkstationO nome da estação de trabalho ou classe de estação


50 Versão 7.0

de trabalho na qual o job é executado. Caracterescuringa são permitidos. O padrão é a estação detrabalho na qual o Composer está sendo executado.


sched Modifica um fluxo de job.



users Modifica um usuário.



Notas de UtilizaçãoO comandomodify copia a definição ou lista de objetos para umarquivo temporário, edita o arquivo e, em seguida, adiciona oconteúdo do arquivo ao arquivo de banco de dados apropriado. Issoequivale à seguinte seqüência de comandos:create file from object-specificationedit fileadd file



1.R

eferênciado

Com

poser

Se a operação de adição for bem-sucedida, o arquivo de edição seráremovido. Para obter mais informações, consulte as descrições doscomandos create, edit e add neste capítulo.

Para definições do usuário, se um campo de senha permanecer vazioquando você sair do editor, a senha antiga será retida. Paraespecificar uma senha nula, utilize duas aspas duplas consecutivas(“”).

ExemplosO exemplo a seguir modifica todos os calendários:modify calendars

O exemplo a seguir modifica o fluxo do jobsked9 lançado naestação de trabalhosite1:m sched=site1#sked9


52 Versão 7.0

newAdiciona um novo objeto de planejamento. Você deve ter acessoadd

para novos objetos na estação de trabalho. Para objetos existentes,você deve ter acessomodify

ao objeto ou arquivo de banco de dados afetado.

Sinopsenew

Notas de UtilizaçãoO comandonew cria um arquivo temporário, edita o arquivo e, emseguida, adiciona o conteúdo do arquivo. Para calendários,parâmetros, recursos e prompts, o conteúdo do arquivo sobrepõequalquer objeto existente. Consulte “modify” na página 50 para criarum arquivo temporário de objetos existentes.

ExemplosO exemplo a seguir cria um arquivo temporário, edita o arquivo e,em seguida, adiciona o conteúdo do arquivo ao banco de dados.new

ou:n



1.R

eferênciado

Com

poser

redoEdita e reexecuta o comando anterior.

Sinopseredo

ContextoAo executar o comandoredo, o Composer exibe o comando anteriorpara que possa ser editado e reexecutado. Utilize a barra de espaçospara mover o cursor sob o caractere a ser modificado e digite asdiretrizes a seguir.

Diretrizes

d[dir] Exclui o caractere acima ded. Pode vir seguido poroutras diretrizes.

itext Insere texto antes do caractere acima dei.

r text Substitui um ou mais caracteres por texto,começando com o caractere acima der . Asubstituição estará implícita se nenhuma outradiretriz for digitada.

>text Anexa texto no final da linha.

>d[dir | text]Exclui caracteres no final da linha. Pode vir seguidopor outra diretriz ou texto.

>r text Substitui caracteres no final da linha por texto.

Exemplos de Diretrizes

ddd Exclui os três caracteres acima deds.

iabc Insereabc antes do caractere acima dei.

rabc Substitui os três caracteres, começando pelocaractere acima der , por abc.

abc Substitui os três caracteres acima deabc por abc.


54 Versão 7.0

d diabcExclui o caractere acima do primeirod, pula umcaractere, exclui o caractere acima do segundod einsereabc em seu lugar.

>abc Anexaabc no final da linha.

>ddabcExclui os dois últimos caracteres na linha e insereabc em seu lugar.

>rabc Substitui os três últimos caracteres na linha porabc.

ExemplosO exemplo a seguir insere um caractere:redodislay site1#sa@

ipdisplay site1#sa@

O exemplo a seguir substitui um caractere:redodisplay site1#sa@

2display site2#sa@



1.R

eferênciado

Com

poser

replaceSubstitui objetos de planejamento. Você deve ter acessomodify aosobjetos ou arquivo de banco de dados afetado.

Sinopsereplace filename

Argumentosfilename

Especifica o nome de um arquivo que contém um dosseguintes argumentos:

¶ Definições do job. A primeira linha do arquivo deve ser$jobs.

¶ Definições do fluxo de job.

¶ Qualquer combinação de definições de estação detrabalho, de classe da estação de trabalho e de domínio.

¶ Definições do usuário.

¶ Um conjunto completo de calendários, parâmetros,prompts ou recursos.

Notas de UtilizaçãoO comandoreplace é semelhante ao comandoadd, exceto que nãohá prompt para substituir objetos existentes. Para obter maioresinformações, consulte “add” na página 33.

ExemplosO exemplo a seguir substitui os jobs do arquivomyjobs:replace myjobs

O exemplo a seguir substitui os fluxos de job do arquivomysked:rep mysked

O exemplo a seguir substitui todos os recursos por aqueles contidosno arquivomyres:rep myres


56 Versão 7.0

validateValida um arquivo contendo objetos de planejamento.

Sinopsevalidate filename[;syntax]

Argumentosfilename

Especifica o nome de um arquivo que contém calendários,estações de trabalho, classes de estações de trabalho,domínios, jobs, parâmetros, prompts, recursos ou fluxos dejob. Digite prodsked para validar o arquivo de planejamentode produção criado durante o processamento do dia depré-produção.

syntaxVerifica o arquivo quanto a erros de sintaxe.

Notas de UtilizaçãoO comandovalidate executa as mesmas verificações de sintaxe evalidação que são executadas quando você adiciona ou modificaobjetos. Ele também pode ser utilizado para validar o arquivo deplanejamento de produção,prodsked, criado durante oprocessamento do dia de pré-produção.Prodsked contém os fluxosde job a serem executados em um determinado dia e pode sermodificado com um editor para incluir alterações especiais antes dodia de processamento começar.Validate deve ser utilizado nessescasos para assegurar que o planejamento de produção ainda sejaválido.

Para fluxos de job, se a opção de sintaxe for omitida, a validação erelatório incluirão o seguinte:

¶ Verificação de nomes de jobs em relação ao arquivo de jobmestre.

¶ Análise de dependências para assegurar que o objeto exista. Porexemplo, uma dependêncianeedsem um recurso não-existenteserá relatado. Também será feita a verificação de referências acalendários não-existentes.



1.R

eferênciado

Com

poser

¶ Verificação de dependências circulares. Por exemplo, sejob1vier apósjob2 e job2 vier apósjob1, haverá uma dependênciacircular.

A saída do comandovalidate pode ser redirecionada para umarquivo como o seguinte:composer "validate filename" > outfile

Para incluir mensagens de erro no arquivo de saída, utilize oseguinte:composer "validate filename" > outfile 2>&1

ExemplosO exemplo a seguir verifica a sintaxe de um arquivo contendodefinições de estações de trabalho:validate mycpus;syntax

O exemplo a seguir revalida todos os fluxos de job. Isso pode serfeito para verificar a integridade de referências a outros objetos deplanejamento depois das alterações terem sido feitas.create allskeds from sched=@#@validate allskeds


58 Versão 7.0

versionExibe o banner do programa Composer.

Sinopseversion

ExemplosO exemplo a seguir exibe o banner do programa Composer:version

ou:v



1.R

eferênciado

Com

poser

Comando do SistemaExecuta um comando do sistema.

Sinopse[: | !] sys-command

Argumentossys-command Especifica qualquer comando de sistema válido. O

prefixo de dois-pontos (:) ou ponto de exclamação(!) é necessário apenas quando o comando é grafadoda mesma forma de um comando do Composer.

ExemplosO exemplo a seguir executa um comandops no UNIX:ps -ef

O exemplo a seguir executa um comandodir no Windows NT:dir \bin


60 Versão 7.0

Linguagem de Planejamento

Este capítulo descreve o formato da linguagem de planejamento e aspalavras-chave utilizadas para definir fluxos de job para o WorkloadScheduler. Essas palavras-chave e sintaxe são utilizadas para definirfluxos de job com o uso da interface de linha de comandos. Fluxosde job criados com a interface gráfica do usuário não fazemreferência às palavras-chave listadas neste capítulo, mas todos osfluxos de job do Tivoli Workload Scheduler são salvos com a mesmasintaxe e palavras-chave da linguagem de planejamento.

Sintaxe dos Fluxos de JobA seguir, é apresentada a estrutura de um fluxo de job, compalavras-chave emnegrito. Um fluxo de job começa com umapalavra-chavescheduleseguida de atributos e dependências. Odelimitador de dois-pontos introduz os jobs que compõem o fluxo dejob. Cada job possui seus próprios atributos e dependências.

schedule name on dates [except dates][at time][carryforward ][follows job|jstream][in order ][limit number][needs resource][opens file][priority number][prompt name|text]

2


2.Linguagem

deP

lanejamento

[until time]:job-statement

[at time][confirmed][every rate][follows job|jstream][needs resource][opens file][priority number][prompt name|text][until time]

[job-statement...]end

Palavras-chaveÉ fornecida uma descrição breve das palavras-chave de planejamentona tabela a seguir.

Palavra-chave Descrição Página

at Define o período do dia em que o fluxo de job ouexecução do job é iniciado.

64

carryforward Transportará o fluxo de job se ele não estiverconcluído.

66

confirmed Especifica que a conclusão deste job requerconfirmação.

68

end Marca o final de um fluxo de job. 69

every Lança o job repetidamente a uma taxa especificada. 70

except Especifica datas que são exceções às datas em que ofluxo de job está selecionado para execução.

71

follows Especifica não lançar este job ou fluxo de job atéque outros jobs e fluxos de job tenham sidoconcluídos com êxito.

73

in order Lança jobs neste fluxo de job na ordem em queforam listados.

75

job-statement Define um job e suas dependências. 77

Sintaxe dos Fluxos de Job

62 Versão 7.0

Palavra-chave Descrição Página

limit Define um limite no número de jobs que podem serlançados simultaneamente a partir do fluxo de job.

83

needs Define o número de unidades de um recursorequerido pelo job ou fluxo de job antes de poderser lançado.

84

on Define as datas em que o fluxo de job é selecionadopara execução.

86

opens Define os arquivos que devem estar acessíveis antesdo job ou fluxo de job ser lançado.

89

priority Define a prioridade de um job ou fluxo de job. 91

prompt Define os prompts que devem ser respondidos antesdo job ou fluxo de job ser lançado.

92

schedule Atribui um nome ao fluxo de job. 94

until Define um período do dia após o qual o job ou fluxode job não será lançado.

96

DependênciasUma dependência é uma condição que deve ser satisfeita antes deum job ou fluxo de job ser lançado. Ela aparece para os fluxos dejob com as palavras-chavefollows, needs, opense prompt . Onúmero máximo de dependências permitido para um job ou fluxo dejob é 40.

Descrições das Palavras-chaveAs páginas a seguir descrevem a sintaxe das palavras-chave dalinguagem de planejamento.

Sintaxe dos Fluxos de Job


2.Linguagem

deP

lanejamento

atDefine a primeira hora em que um job ou fluxo de job será lançado.

Sinopseat time [timezone|tztzname][+nday[s]]

Argumentostime Especifica um período do dia. Os valores possíveis variam

de 0000a 2359.

tznameEspecifica o fuso horário a ser utilizado ao calcular a horade início. Consulte “Nomes dos Fusos Horários” napágina 319 para obter os nomes dos fusos horários. O padrãoé o fuso horário da estação de trabalho em que o job oufluxo de job é lançado.

Nota: Se uma horaat e uma horauntil forem especificadas,os fusos horários deverão ser os mesmos.

n Especifica um deslocamento em dias da data e hora de inícioplanejadas.

Notas de UtilizaçãoSe uma horaat não for especificada para um job ou fluxo de job,sua hora de lançamento será determinada por suas dependências eprioridade.

ExemplosOs exemplos a seguir assumem que o dia de processamento doWorkload Scheduler inicia às 6:00h.

¶ O fluxo de job a seguir, selecionado às terças-feiras, não élançado antes das 3:00h da manhã de quarta-feira. Seus dois jobssão lançados o mais breve possível após essa hora.schedule sked7 on tu at 0300:job1job2end

Descrições das Palavras-chave

64 Versão 7.0

¶ O fuso horário da estação de trabalhosfran está definido comoHora Local do Pacífico (pst) e o fuso horário da estação detrabalhonycity está definido como Hora Local Oriental (est). Ofluxo de job a seguir é selecionado para execução àssextas-feiras. É lançado na estação de trabalhosfran às 10:00hpst do sábado. Ojob1 é lançado nasfran o mais breve possívelapós essa hora. Ojob2 é lançado nasfran às 14:00hest (11:00hpst) do sábado. Ojob3 é lançado na estação de trabalhonycityàs 16:00hest (13:00hpst) do sábado.sfran#schedule sked8 on fr at 1000 + 1 day :job1job2 at 1400 tz estnycity#job3 at 1600end



2.Linguagem

deP

lanejamento

carryforwardQualifica um fluxo de job a ser transportado para o plano deprodução do dia seguinte se não for concluído antes do final doplano de produção do dia atual.

Sinopsecarryforward

ExemplosO fluxo de job a seguir será transportado se seus jobs não tiveremsido concluídos antes do processamento pré-produção iniciar para umnovo dia.schedule sked43 on thcarryforward:job12job13job13aend


66 Versão 7.0

CommentsInclui comentários em uma definição de fluxo de job.

Sinopse* text | <<text>>

Argumentos* text Insere uma linha de comentário. O primeiro caractere da

linha deve ser um asterisco.

<<text>>Insere texto de comentário em uma linha. O texto deve sercolocado entre colchetes angulares duplos.

ExemplosO exemplo a seguir inclui os dois tipos de comentários:***************************************** The weekly cleanup jobs*****************************************schedule wkend on fr at 1830in order:job1 <<final totals and reports>>job2 <<update database >>end



2.Linguagem

deP

lanejamento

confirmedEspecifica que a conclusão de um job deve ser confirmada com aexecução de um comandoconfirm do Conman. Consulte “confirm”na página 137 para obter mais informações.

Sinopseconfirmed

ExemplosNo fluxo de job a seguir, a confirmação da conclusão dojob1 deveser recebida antes dojob2 e job3 serem lançados.schedule test1 on fr:job1 confirmedjob2 follows job1job3 follows job1end


68 Versão 7.0

endMarca o final da definição de um fluxo de job.

Sinopseend

Exemplosschedule test1 on monthend:job1job2job3end << end of job stream >>



2.Linguagem

deP

lanejamento

everyDefine a taxa de repetição de um job. O job é lançado repetidamentena taxa especificada.

Sinopseeveryrate

Argumentosrate A taxa de repetição expressa em horas e minutos, no

formato:hhmm. (A taxa pode ser maior que 24 horas.)

ExemplosO exemplo a seguir lança o jobtestjob a cada hora:testjob every 100

O exemplo a seguir lança o jobtestjob1 a cada 15 minutos, entre as18:00h e 20:00h:testjob1 at 1800 every 15 until 2000


70 Versão 7.0

exceptDefine as datas que são exceções para as datason de um fluxo dejob. Consulte “on” na página 86 para obter mais informações.

Sinopseexcept { date | day | calendar} [,...]

Argumentosdate Uma data no formato:mm/dd/aa.

day Um dia da semana. Especifica um ou mais dos seguintesdias:mo Segunda-feiratu Terça-feirawe Quarta-feirath Quinta-feirafr Sexta-feirasa Sábadosu Domingoweekdays

Todos os dias, exceto sábado e domingo.

calendarAs datas especificadas em um calendário por este nome. Onome do calendário pode vir seguido de um deslocamento noseguinte formato:

{ + | -} n { day[s] | weekday[s] | workday[s]}

Onde:

n O número de dias, dias da semana (menos sábado edomingo) ou dias úteis.

days Todos os dias da semana.

weekdaysTodos os dias da semana, exceto sábado e domingo.

workdaysTodos os dias da semana, exceto as datas queaparecem no calendário chamadoholidays.



2.Linguagem

deP

lanejamento

ExemplosO exemplo a seguir seleciona o fluxo de jobtestskd2para serexecutado todos os dias da semana (menos sábado e domingo),exceto naqueles cujas datas aparecem nos calendários chamadosmonthend e holidays:schedule testskd2 on weekdaysexcept monthend,holidays :

O exemplo a seguir seleciona o fluxo de jobtestskd3para serexecutado todos os dias da semana (menos sábado e domingo),exceto em 15 de maio de 1999 e 23 de maio de 1999:schedule testskd3 on weekdaysexcept 05/15/99,05/23/99 :

O exemplo a seguir seleciona o fluxo de jobtestskd4para serexecutado todos os dias, exceto dois dias da semana (menos sábadoe domingo), anteriores a qualquer data que apareça em umcalendário chamadomonthend:schedule testskd4 on everydayexcept monthend-2 weekdays :


72 Versão 7.0

followsDefine os outros jobs e fluxos de job que devem ser concluídos comêxito antes de um job ou fluxo de job ser lançado.

SinopseUtilize a seguinte sintaxe para fluxos de job:

follows [netagent:: ][wkstation#]jstream[.jobname| @] [ ,...]

Utilize a seguinte sintaxe para jobs:

follows [netagent:: ][wkstation#]jstream{. jobname| @} | jobname[,...]

Argumentosnetagent

O nome do agente de rede em que a dependência entre redesé definida.

wkstationA estação de trabalho em que o job ou fluxo de job que deveser concluído é executado. O padrão é a mesma estação detrabalho do job ou fluxo de job dependente.

Se umawkstationnão for especificada comnetagent, opadrão será a estação de trabalho na qual o agente de redeestá conectado.

jstreamO nome do fluxo de job que deve ser concluído. Para umjob, o padrão é o mesmo fluxo de job do job dependente.

jobnameO nome do job que deve ser concluído. Um a de arroba (@)pode ser utilizado para indicar que todos os jobs do fluxo dejob devem ser concluídos com êxito.



2.Linguagem

deP

lanejamento

ExemplosO exemplo a seguir especifica para não lançar o fluxo de jobskedcaté que o fluxo de jobsked4na estação de trabalhosite1 e o jobjoba no fluxo de jobsked5na estação de trabalhosite2 tenham sidoconcluídos com êxito:schedule skedc on frfollows site1#sked4,site2#sked5.joba

Não lançar sked6 até que o jobx do fluxo de job skedx na rederemota cluster4 tenha sido concluído com êxito:sked6 follows cluster4::site4#skedx.jobx

O exemplo a seguir especifica para não lançar ojobd até que ojobano mesmo fluxo de job e ojob3 no fluxo de jobskeda tenham sidoconcluídos com êxito:jobd follows joba,skeda.job3

O exemplo a seguir especifica para não lançar ojobe até que todosos jobs do fluxo de jobskedb na estação de trabalhounix1 tenhamsido concluídos com êxito:jobe follows unix1#skedb.@


74 Versão 7.0

in orderEspecifica que os jobs devem ser lançados na ordem em queaparecem em um fluxo de job. Cada job deve ser concluído comêxito antes do job seguinte ser lançado. Essa palavra-chave deve sera última a aparecer na definição do fluxo de job antes dosdois-pontos. Não são permitidas dependências para os jobs no fluxode job.

Sinopsein order

Notas de UtilizaçãoSe um jobin order não for concluído com êxito e não puder serreexecutado com êxito, os jobs seguintes deverão ser liberados comum comandoreleasedo Conman. Por exemplo, para liberar os jobsdo fluxo de jobsked1, você pode digitar o seguinte comando doConman:rj sked1.@

Se um jobin order for cancelado, o job seguinte deverá ser liberadocom um comandoreleasedo Conman. Os jobs restantes no fluxo dejob continuarão normalmente. Por exemplo, se o jobj1 forcancelado, você poderá liberar o jobj2 digitando o seguintecomando do Conman:rj sked1.j2

O agente de tolerância a falhas no qual um jobin order é executadodeverá ter o modoStatus Completoativado se o job vier depois deum job que será executado em uma estação de trabalho diferente.Isso é ilustrado em “Exemplos.” Para obter mais informações sobreo modoStatus Completo, consulte “Definições da Estação deTrabalho” na página 3.

ExemplosO exemplo a seguir lança ojoba, o jobb e o jobc, um de cada vez,na ordem em que aparecem emsked2:



2.Linguagem

deP

lanejamento

schedule sked2 on everyday in order :jobajobbjobc

end

O exemplo a seguir lança ojob1, o site2#job2e o job3, um de cadavez, na ordem em que aparecem emsked3:schedule sked3 on tu,th in order :job1site2#job2job3

end

Se o fluxo de job for lançado em um agente de tolerância a falhas(site3, por exemplo), o jobsite2#job2não será lançado quando ojob1 for concluído, a não ser que o modoStatus Completosejaativado para osite2. Além disso, ojob3 não será lançado quando osite2#job2 for concluído, a não ser que o modoStatus Completoseja ativado para osite3.


76 Versão 7.0

Job StatementAs instruções de job colocam os jobs em um fluxo de job e definemdependências de jobs. Em uma instrução de job, também é possívelincluir atributos de job e opções de recuperação que adicionem umnovo job ou modifiquem um job existente no banco de dados.Consulte “Notas de Utilização” para obter mais informações.

Sinopse

[wkstation#]jobname[description “ text”][{ scriptname | jobfilename} filename | docommand “commandline” ][streamlogon username][interactive][recovery { stop | continue | rerun}

[{ recoveryjob | after} [ rwkstation#]rjobname][{ recoveryprompt | abendprompt} “ rtext”]]

[job-dependency[,...]]

Argumentoswkstation

Especifica o nome da estação de trabalho ou classe detrabalho na qual o job é executado. O padrão é a estação detrabalho em que o fluxo de job é executado. O sinal de libra(#) é um delimitador necessário. Se você especificar umaclasse de estação de trabalho, ela deverá corresponder àclasse de estação de trabalho de qualquer fluxo de job noqual o job foi incluído.

jobnameEspecifica o nome do job. O nome deve iniciar com umaletra e pode conter caracteres alfanuméricos, traços esublinhados. Para bancos de dados não-expandidos, ele podeconter até oito caracteres. Para bancos de dados expandidos,ele pode conter até 40 caracteres.

descriptionUma descrição de forma livre do job, colocada entre aspasduplas.



2.Linguagem

deP

lanejamento

{scriptname | jobfilename} filename

Especifica o nome do arquivo executado pelo job. Utilizescriptname para jobs do UNIX e Windows NT, ejobfilename para jobs do MPE. Para um arquivo executável,digite o nome do arquivo e todas as opções e argumentos(até 4095 caracteres). Os parâmetros do Workload Schedulertambém podem ser utilizados. Consulte “Como UtilizarParâmetros nas Definições de Job” na página 80 para obtermais informações.

Para jobs do Windows NT, inclua as extensões de arquivo.Os nomes da Universal Naming Convention (UNC) sãopermitidos. Não especifique arquivos em unidades mapeadas.

Se espaços ou caracteres especiais forem incluídos,diferentes de barras (/) e barras invertidas (\), toda a cadeiadeverá ser colocada entre aspas (″).

Se o nome do arquivo contiver espaços, digite o nome emoutro arquivo que não possua espaços em seu nome e utilizeo nome do segundo arquivo para este argumento.

docommandcommandEspecifica um comando executado pelo job. Digite umcomando válido e todas as opções e argumentos (até 4095caracteres) entre aspas (″). Um comando é executadodiretamente e, ao contrário descriptname ou jobfilename, oscript de configuração,jobmanrc, não é executado. Casocontrário, o comando será tratado como um job, e todas asregras de jobs serão aplicadas. Os parâmetros do WorkloadScheduler também podem ser inseridos. Consulte “ComoUtilizar Parâmetros nas Definições de Job” na página 80 paraobter mais informações.

streamlogon

O nome do usuário sob o qual o job é executado. O nomepode conter até 47 caracteres. Se o nome contiver caracteresespeciais, ele deverá ser colocado entre aspas (″).Especifique um usuário que pode iniciar sessão na estação detrabalho na qual o job é executado. Os parâmetros do


78 Versão 7.0

Workload Scheduler também podem ser inseridos. Consulte“Como Utilizar Parâmetros nas Definições de Job” napágina 80.

Para jobs do Windows NT, o usuário também deverá ter umadefinição de usuário. Consulte “Definições do Usuário” napágina 18 para obter requisitos do usuário.

interactive

Para jobs do Windows NT, inclua esta palavra-chave paraindicar que o job é executado de forma interativa no desktopdo Windows NT.

recovery

Recupera opções para o job. O padrão éstop sem job derecuperação e sem prompt de recuperação. Digite uma dasopções de recuperação,stop, continue ou rerun . Elaspodem vir seguidas de um job de recuperação, um prompt derecuperação ou de ambos.

stop Se ocorrer abend do job, não continuar com opróximo job.

continueSe ocorrer abend do job, continuar com o próximojob.

rerun Se ocorrer abend do job, reexecutar o job.

{recoveryjob | after} [wkstation#]jobname

Especifica o nome de um job de recuperação a serexecutado, se o job pai terminar de forma anormal.Os jobs de recuperação são executados somente umavez para cada ocorrência terminada de formaanormal do job pai.

Você pode especificar a estação de trabalho do jobde recuperação se for diferente da estação detrabalho do job pai. O padrão é a estação de trabalhodo job pai. Nem todos os jobs são elegíveis paraexecutarem os jobs de recuperação em uma estaçãode trabalho diferente. Siga estas instruções:



2.Linguagem

deP

lanejamento

¶ A estação de trabalho do job pai e do job derecuperação devem estar executando o WorkloadScheduler Versão 4.5.5 ou posterior.

¶ Se uma das estações de trabalho for um agenteestendido, ela deverá ser alojada por umgerenciador de domínio ou por um agente detolerância a falhas com um valor deon parafullstatus.

¶ A estação de trabalho do job de recuperaçãodeve estar no mesmo domínio que a estação detrabalho do job pai.

¶ Se a estação de trabalho do job de recuperaçãofor um agente de tolerância a falhas, ela deveráter um valor deon parafullstatus.

{recoveryprompt | abendprompt} “ text”Especifica o texto de um prompt de recuperação,colocado entre aspas, a ser exibido se ocorrer abenddo job. O texto pode conter até 64 caracteres. Se otexto começar com dois-pontos (:), o prompt seráexibido, mas nenhuma resposta será necessária paracontinuar o processamento. Se o texto começar comum ponto de exclamação (!), o prompt não seráexibido, mas será necessária uma resposta paracontinuar.

job-dependencyEspecifica as palavras-chave e argumentos do planejamento.As palavras-chave válidas dos jobs são:at, confirmed,every, follows, needs, opens, priority , prompt e until .

Como Utilizar Parâmetros nas Definições de JobOs parâmetros possuem os seguintes usos e limitações nas definiçõesdo job:¶ São permitidos parâmetros nos valoresstreamlogon, scriptname

e docommand.¶ Um parâmetro pode ser utilizado como uma cadeia completa ou

uma parte dela.


80 Versão 7.0

¶ São permitidos vários parâmetros em uma única variável.¶ Os nomes de parâmetros devem ser incluídos entre sinais de

intercalação (^), e a cadeia completa, entre aspas.

Consulte o exemplo abaixo onde um parâmetro chamadomis éutilizado no valorstreamlogon. Para obter outros exemplos, consulte“Definições dos parâmetros” na página 22.

Notas de UtilizaçãoUm job precisa ser definido apenas uma vez no banco de dados epode ser utilizado em vários fluxos de job. Quando um fluxo de jobé adicionado ou modificado, os atributos ou opções de recuperaçãode seus jobs também são adicionados ou modificados.

Ao definir jobs, lembre-se do seguinte:

¶ Os jobs podem ser definidos independentemente (conformedescrito em “Definições do Job” na página 13), ou como parte defluxos de job. Em qualquer um dos casos, as alterações sãofeitas no banco de dados e não afetam o plano de produção até oinício de um novo dia de processamento.

¶ Quando você adiciona ou substitui um fluxo de job, qualquermodificação ao job afetará todos os outros fluxos de job queutilizam os jobs. Observe que o Relatório de Referência Cruzadapode ser utilizado para determinar os nomes de fluxos de jobnos quais um determinado job está incluído.

ExemplosO exemplo a seguir define um fluxo de job com três jobs definidosanteriormente:schedule bkup on fr at 20:00 :cpu1#jbk1cpu2#jbk2needs 1 tape

cpu3#jbk3follows jbk1

end

A definição de fluxo de job a seguir contém instruções de job queadicionam ou modificam as definições de dois jobs no banco dedados:



2.Linguagem

deP

lanejamento

schedule sked4 on mo :job1 scriptname “d:\apps\maestro\scripts\jcljob1”

streamlogon jackrecovery stop abendprompt “continue production”

site1#job2 scriptname “d:\apps\maestro\scripts\jcljob2”streamlogon jackfollows job1

end


82 Versão 7.0

limitLimita o número de jobs que podem ser executados simultaneamenteem um fluxo de job.

Sinopselimit joblimit

Argumentosjoblimit Especifica o número de jobs que podem ser

executados ao mesmo tempo no planejamento. Osvalores possíveis são0 a 1024. Se você especificar0, impedirá que todos os jobs sejam lançados.

ExemplosO exemplo a seguir limita em 5 o número de jobs que podem serexecutados simultaneamente em um fluxo de jobsked2:schedule sked2 on frlimit 5 :



2.Linguagem

deP

lanejamento

needsDefine os recursos que devem estar disponíveis antes de um job oufluxo de job ser lançado.

Sinopseneeds[n] [wkstation#]resourcename[,...]

Argumentosn Especifica o número de unidades de recurso

necessárias. Os valores possíveis vão de0 a 32. Opadrão é um.

wkstation Especifica o nome da estação de trabalho na qual orecurso foi definido. O padrão é a mesma estação detrabalho do job ou fluxo de job dependente. Osrecursos podem ser utilizados como dependênciasapenas pelos jobs e fluxos de job executados namesma estação de trabalho do recurso. No entanto,um agente padrão e seu host podem fazer referênciaaos mesmos recursos.

resourcename Especifica o nome do recurso.

Notas de UtilizaçãoAdicionar uma dependência de recurso a um job executado em umagente de tolerância a falhas (fta), ou a um fluxo de job quecontenha um job executado em um fta, poderá impedir a execuçãodo job se o recurso não estiver definido no mesmo fta. Para evitarque isso aconteça, assegure que a definição de estação de trabalhodo fta esteja com o modoStatus Completoativado, ou,alternativamente, assegure que o recurso esteja definido no fta noqual o job é executado.

ExemplosO exemplo a seguir impede que o fluxo de jobsked3seja lançadoaté que três unidades decputime e duas detapesse tornemdisponíveis:schedule sked3 on frneeds 3 cputime,2 tapes :


84 Versão 7.0

O recursojlimit foi definido com duas unidades disponíveis. Oexemplo a seguir permite que não mais de dois jobs sejamexecutados simultaneamente no fluxo de jobsked4:schedule sked4 on mo,we,fr :joba needs 1 jlimitjobb needs 1 jlimitjobc needs 2 jlimit <<runs alone>>jobd needs 1 jlimit

end



2.Linguagem

deP

lanejamento

onEsta é uma palavra-chave de fluxo de job necessária que definequando e com que freqüência um fluxo de job é selecionado paraexecução. A palavra-chaveon deve vir depois da palavra-chaveschedule. Consulte “except” na página 71 para obter maisinformações.

Sinopseon { date | day | calendar| request} [,...]

Argumentosdate Especifica uma data no formatomm/dd/aa.

day Um dia da semana. Você pode especificar um ou mais dosseguintes dias:mo Segunda-feiratu Terça-feirawe Quarta-feirath Quinta-feirafr Sexta-feirasa Sábadosu Domingoweekdays

Todos os dias, exceto sábado e domingo.

calendarAs datas especificadas por este nome em um calendário. Onome do calendário pode vir seguido de um deslocamento noseguinte formato:

{ + | -} n { day[s] | weekday[s] | workday[s]}

Onde:

n O número de dias, dias da semana (menos sábado edomingo) ou dias úteis.

days Inclui todos os dias da semana.

weekdaysInclui todos os dias da semana, exceto sábado edomingo.


86 Versão 7.0

workdaysInclui todos os dias da semana, exceto as datas queaparecem no calendário chamadoholidays.

requestSeleciona o fluxo de job quando solicitado. Isto é utilizadopara fluxos de job que são selecionados por nome em vez dedata. Consulte oTivoli Workload Scheduler - Guia doAdministradorpara obter informações sobre o comandoschedulr.

ExemplosO exemplo a seguir seleciona o fluxo de jobsked1às segundas equartas-feiras:schedule sked1 on mo,we

O exemplo a seguir seleciona o fluxo de jobsked3em 15 de junhode 1999 e nas datas listadas no calendárioapdates:schedule sked3 on 6/15/99,apdates

O exemplo a seguir seleciona o fluxo de jobsked4em dois dias dasemana (menos sábado e domingo) antes de cada data que apareceno calendáriomonthend:schedule sked4 on monthend -2 weekdays

O exemplo a seguir seleciona o fluxo de jobtestskd1 todos os diasda semana (menos sábado e domingo), exceto às quartas-feiras:schedule testskd1 on weekdaysexcept we

O exemplo a seguir seleciona o fluxo de jobtestskd3 todos os diasda semana (menos sábado e domingo), exceto em 15 de maio de1999 e em 24 de maio de 1999:schedule testskd3 on weekdaysexcept 05/16/99,05/24/99

O exemplo a seguir seleciona o fluxo de jobtestskd4 todos os dias,exceto em dois dias da semana (menos sábado e domingo) antes dequalquer data que apareça em um calendário chamadomonthend:



2.Linguagem

deP

lanejamento

schedule testskd4 on everydayexcept monthend -2 weekdays


88 Versão 7.0

opensEspecifica os arquivos que devem estar disponíveis antes de um jobou fluxo de job ser lançado.

Sinopseopens[wkstation#]″filename″ [(qualifier)] [ ,...]

Argumentoswkstation

Especifica o nome da estação de trabalho ou classe daestação de trabalho na qual o arquivo existe. O padrão é aestação de trabalho ou classe de estação de trabalho do jobou fluxo de job dependente. Se você utilizar uma classe deestação de trabalho, ela deverá ser a mesma daquela do fluxode job que inclui esta instrução.

filenameEspecifica o nome do arquivo, entre aspas. Você podeutilizar os parâmetros do Workload Scheduler como toda acadeia de nome de arquivo ou parte dela. Se utilizar umparâmetro, ele deverá ser colocado entre sinais deintercalação (^).

qualifierEspecifica uma condição de teste válida. No UNIX, oqualificador é transmitido a um comandotest, que éexecutado comoroot em bin/sh.

No Windows NT, a função de teste é executada como ousuário do maestro. Os qualificadores válidos são:

-d %p Verdadeiro se o arquivo existir e for umdiretório.

-e %p Verdadeiro se o arquivo existir.

-f %p Verdadeiro se o arquivo existir e for umarquivo regular.

-r %p Verdadeiro se o arquivo existir e for legível.



2.Linguagem

deP

lanejamento

-s %p Verdadeiro se o arquivo existir e seutamanho for maior que zero.

-w %p Verdadeiro se o arquivo existir e forgravável.

No UNIX e no Windows NT, a expressão%p insere o nomedo arquivo.

Digitar (notempty) é o mesmo que digitar(-s %p). Senenhum qualificador for especificado, o padrão será-f %p .

Notas de UtilizaçãoA combinação defilenamee de qualifiernão pode exceder 148caracteres, dentro dos quais o nome base do nome de arquivo nãopode exceder 28 caracteres.

ExemplosO exemplo a seguir verifica se o arquivoc:\users\fred\datafiles\file88na estação de trabalhont5 estádisponível para acesso à leitura antes de lançarux2#sked6:schedule ux2#sked6 on tu opens nt5#"c:\users\fred\datafiles\file88"

O exemplo a seguir verifica se três diretórios,/john, /mary e /roger,existem antes de lançar o jobjobr2 :jobr2 opens "/users"(-d %p/john -a -d %p/mary -a -d %p/roger)

O exemplo a seguir verifica secron criou seu arquivo FIFO antes delançar o jobjob6:job6 opens "/usr/lib/cron/FIFO"(-p %p)

O exemplo a seguir verifica se o arquivod:\work\john\execit1 naestação de trabalhodev3 existe e não está vazio, antes de executar ojob jobt2:jobt2 opens dev3#"d:\work\john\execit1"(notempty)

O exemplo a seguir verifica se o arquivoc:\tech\checker\startf naestação de trabalhonyc existe com um tamanho maior que zero e seé gravável, antes de executar o jobjob77:job77 opens nyc#"C:\tech\checker\startf"(-s %p -a -w %p)


90 Versão 7.0

priorityDefine a prioridade de um job ou fluxo de job.

Sinopsepriority number| hi | go

Argumentosnumber Especifica a prioridade. Os valores possíveis são de

0 a 99. Uma prioridade zero evita que o job ou fluxode job seja lançado.

hi O equivalente da prioridade100.

go O equivalente da prioridade101, a mais alta.

ExemplosO exemplo a seguir ilustra a relação entre as prioridades do fluxo dejob e job. Os jobs são lançados na seguinte ordem:job1, job2, joba,jobb.

schedule sked1 on tupriority 50:job1 priority 15job2 priority 10end

schedule sked2 on tupriority 10:joba priority 60jobb priority 50end

Se as prioridades do fluxo de job fossem as mesmas, os jobs seriamlançados na seguinte ordem:joba, jobb, job1, job2.



2.Linguagem

deP

lanejamento

promptEspecifica os prompts que devem ser respondidos afirmativamenteantes de um job ou fluxo de job ser lançado.

Sinopseprompt promptname[,...]

prompt ″[: | !]text″ [...]

Argumentospromptname Especifica o nome de um prompt no banco de dados.

text Especifica um prompt literal como uma cadeia detexto entre aspas (″). Múltiplas cadeias separadas porbarra invertidan (\n) podem ser utilizadas paramensagens longas. Se a cadeia começar comdois-pontos (:), a mensagem será exibida e nenhumaresposta será necessária. Se a cadeia começar comum ponto de exclamação (!), a mensagem não seráexibida e irá requerer uma resposta. Você podeincluir barra invertidan (\n) dentro do texto paraobter novas linhas.

Você pode utilizar um ou mais parâmetros como todaa cadeia de texto ou parte dela. Para utilizar umparâmetro, coloque seu nome entre sinal deinterpolação (^).

Nota: Dentro de um prompt local, quando nãoestiver designando um parâmetro, um acentocircunflexo (^) deve ser precedido por umabarra invertida (\) ou ocorrerão erros noprompt. Dentro de prompts globais, osacentos circunflexos não precisam serprecedidos por uma barra invertida.

ExemplosO exemplo a seguir ilustra os prompts literal e nomeados. Oprimeiro é um prompt literal que utiliza um parâmetro chamado


92 Versão 7.0

sys1. Quando uma única resposta afirmativa é recebida para oprompt nomeadoapmsg, as dependências para ambos,job1 e job2são satisfeitas.schedule sked3 on tu,thprompt "All ap users logged out of ^sys1^? (y/n)"

:job1 prompt apmsgjob2 prompt apmsg

end

O exemplo a seguir define um prompt literal que aparecerá em maisde uma linha. Ele é definido com barra invertidan (\n) no final decada linha:schedule sked5 on frprompt "The jobs in this job stream consume \n

an enormous amount of cpu time.\nDo you want to launch it now? (y/n)":j1j2 follows j1

end



2.Linguagem

deP

lanejamento

scheduleEspecifica o nome do fluxo de job. Com exceção dos comentários,essa deve ser a primeira palavra-chave em um fluxo de job e devevir seguida da palavra-chaveon.

Sinopseschedule[wkstation#]jstreamnameon ...

Argumentoswkstation Especifica o nome da estação de trabalho na qual o

fluxo de job é lançado. O padrão é a estação detrabalho na qual o Composer é executado paraadicionar o fluxo de job.

jstreamname

Especifica o nome do fluxo de job. O nome deveiniciar com uma letra e pode conter caracteresalfanuméricos e traços. Para bancos de dadosnão-expandidos, ele pode conter até oito caracteres.Para bancos de dados expandidos, ele pode conteraté 16 caracteres.

on

Especifica quando e com que freqüência o fluxo dejob é selecionado para execução. Consulte “on” napágina 86 para obter mais informações.

ExemplosO exemplo a seguir nomeia um fluxo de jobsked1que é executadona estação de trabalho na qual o Composer está sendo executado:schedule sked1 on tu

O exemplo a seguir nomeia um fluxo de jobsked-2que é executadona estação de trabalho na qual o Composer está sendo executado:schedule sked-2 on everyday except fr

O exemplo a seguir nomeia um fluxo de jobskedux7que éexecutado na estação de trabalhohpux3:


94 Versão 7.0

schedule hpux3#skedux7 on monthend



2.Linguagem

deP

lanejamento

untilEspecifica a última hora em que um job ou fluxo de job serálançado.

Sinopseuntil time [timezone|tztzname][+nday[s]]

Argumentostime Especifica o período do dia. Os valores possíveis vão de

0000a 2359.

tznameEspecifica o fuso horário a ser utilizado ao calcular a hora.Consulte “Nomes dos Fusos Horários” na página 319 paraobter os nomes dos fusos horários. O padrão é o fuso horárioda estação de trabalho em que o job ou fluxo de job élançado.

Nota: Se uma horauntil e uma horaat forem especificadas,os fusos horários deverão ser os mesmos.

n Especifica um deslocamento, em dias, da data e horaplanejadas.

ExemplosO exemplo a seguir evita quesked1seja lançado após as 17:00h àsterças-feiras:schedule sked1 on tu until 1700 :

O exemplo a seguir lança ojob1 entre as 13:00h e 17:00h nos diasde semana (menos sábado e domingo):schedule sked2 on weekdays :job1 at 1300 until 1700

end

O exemplo a seguir lança ojoba a cada 15 minutos entre as 22:30he 23:30h às segundas-feiras:schedule sked3 on mo :joba at 2230 every 0015 until 2330

end


96 Versão 7.0

O exemplo a seguir lança o fluxo de jobsked4aos sábados entre as8:00h e 13:00h. Os jobs também serão lançados dentro desseintervalo:schedule sked4 on fr at 0800 + 2 daysuntil 1300 + 2 days

:job1job2 at 0900 <<launched on sunday>>job3 follows job2 at 1200 <<launched on sunday>>

end



2.Linguagem

deP

lanejamento


98 Versão 7.0

Referência do Conman

O ambiente de plano de produção do Workload Scheduler égerenciado com o programa Conman. O Conman é utilizado parainiciar e parar o processamento, alterar e exibir o plano de produção(Symphony) e controlar a ligação da estação de trabalho em umarede. Este capítulo contém informações sobre:

¶ Como executar o Conman

¶ Como selecionar e qualificar jobs e fluxos de job

¶ A sintaxe e utilização dos comandos do Conman

Como executar o ConmanPara executar o Conman, digite o seguinte comando:conman [“command[&...][&]"]

ExemplosNo exemplo a seguir, o Conman inicia e solicita um comando:conman

No exemplo a seguir, o Conman executa os comandossj e sp e saiem seguida:conman"sj&sp"

No exemplo a seguir, o Conman executa os comandossj e sp esolicita um comando:conman"sj&sp&"

3


3.R

eferênciado

Conm

an

No exemplo a seguir, o Conman lê comandos decfile:conman < cfile

No exemplo a seguir, comandos decfile são canalizados ao Conman:cat cfile | conman

Caracteres de ControleVocê pode digitar os seguintes caracteres de controle parainterromper o Conman.

Control+cO Conman pára a execução do comando atual na próximaetapa que puder ser interrompida e retorna um prompt decomandos.

Control+dO Conman sai após a execução do comando atual.

Como Executar Comandos do SistemaQuando um comando do sistema é digitado com o uso de um canalou de um prefixo do comando do sistema, (: ou !), ele é executadopor um processo filho. O ID de usuário em vigor do processo filho édefinido como o ID do usuário que executa o Conman para evitarfalhas na segurança.

Prompt do UsuárioQuando você utiliza caracteres curinga para selecionar os objetossobre os quais a ação será executada por um comando, o Conmansolicita confirmação depois de encontrar cada objeto correspondente.Respondersim permite que a ação seja tomada enão pula o objetosem qualquer ação.

Quando o Conman é executado interativamente, os prompts deconfirmação são emitidos em seu computador. Pressionar a teclaReturn em resposta a um prompt é interpretado comonão. Assolicitações através de prompt podem ser desativadas, incluindo-se aopção;noask em um comando.

Apesar de nenhum prompt de confirmação ser emitido quando oConman não está sendo executado no modo interativo, ele age como

Como executar o Conman

100 Versão 7.0

se a resposta tivesse sidonão em cada caso, e nenhum objeto recebeação. É importante, portanto, incluir a opção;noask em comandosquando o Conman não é executado no modo interativo.

Saída do TerminalA saída para seu computador é especificada por variáveis shellchamadas MAESTROLINES e MAESTROCOLUMNS. Se ainda nãoestiverem definidas, as variáveis shell padrão, LINES e COLUMNS,serão utilizadas. As variáveis podem ser definidas como a seguir:

$MAESTROLINESEspecifica o número de linhas por tela. O padrão é24. Nofinal de cada paginação de tela, o Conman solicita paracontinuar. Se MAESTROLINES (ou LINES) estiver definidocomo zero ou um número negativo, o Conman não pausaráno final da página.

$MAESTROCOLUMNSEspecifica o número de caracteres por linha. O padrão é80.

$MAESTRO_OUTPUT_STYLEEspecifica o método de exibição de nomes de objetos. Sedefinidos comoLONG , serão exibidos nomes completos. Senão definidos, ou definidos com qualquer valor diferente deLONG e a opção globalversão expandidafor definidacomosim, os nomes longos serão truncados com oitocaracteres e um sinal de mais (+). Se aversão expandidafor definida comonão, os nomes longos serão truncadoscom oito caracteres.

Saída OfflineA opção;offline nos comandos do Conman é utilizada, geralmente,para imprimir a saída de um comando. Ao incluí-la, as seguintesvariáveis shell controlam a saída:

$MAESTROLPEspecifica o destino da saída de um comando. Defina-ocomo um dos seguintes:

> file Redireciona a saída para um arquivo e sobrepõe oconteúdo do arquivo. Se o arquivo não existir, eleserá criado.



3.R

eferênciado

Conm

an

>> fileRedireciona a saída para um arquivo e anexa a saídano final do arquivo. Se o arquivo não existir, ele serácriado.

| commandCanaliza a saída para um comando do sistema ouprocesso. O comando do sistema é executadoindependente da saída ser ou não gerada.

|| commandCanaliza a saída para um comando do sistema ouprocesso. O comando do sistema não será executado,se não existir nenhuma saída.

O padrão é| lp -tCONLIST que canaliza a saída docomando para a impressora e coloca o título “CONLIST” napágina do banner da impressão.

$MAESTROLPLINESEspecifica o número de linhas por página. O padrão é60.

$MAESTROLPCOLUMNSEspecifica o número de caracteres por linha. O padrão é132.

As variáveis devem ser exportadas antes de se executar o Conman.

Prompt de Comandos do ConmanO prompt de comandos do Conman é, por padrão, um sinal deporcentagem (%). Isso é definido no arquivo catálogo de mensagensWShome/catalog/maestro.msg. Para selecionar um prompt diferente,

1. Edite o arquivo.

2. Localize o conjunto 202 e os números de mensagens 110 e 111.

3. Altere os caracteres nessas linhas.

O número de mensagem 110 é o prompt padrão e o número demensagem 111 é o prompt utilizado depois que você selecionaum arquivo Symphony diferente com o comandosetsym. Osprompts podem ter até oito caracteres.


102 Versão 7.0

4. Após alterar o prompts, gere um novo arquivo catálogo, como aseguir:cd WShome/cataloggencat maestro.cat maestro.msg

Sintaxe de ComandosOs comandos do Conman consistem nos seguintes elementos:

commandname selection arguments

onde:

commandnameEspecifica o nome do comando.

selectionEspecifica o objeto ou conjunto de objetos sobre os quais aação será tomada.

argumentsEspecifica os argumentos do comando.

A seguir, o exemplo de um comando do Conman:sj sked1.@+state=holdxpriority=0;info;offline

onde:

sj A forma abreviada do comandoshowjobs.

sked1.@+state=holdxpriority=0Seleciona todos os jobs no fluxo de jobsked1que estão noestadohold com uma prioridade diferente de zero.

;info;offlineArgumentos do comandoshowjobs.

Caracteres CuringaOs seguintes caracteres curinga são permitidos:

@ Substitui um ou mais caracteres alfanuméricos.

? Substitui um caractere alfabético.



3.R

eferênciado

Conm

an

% Substitui um caractere numérico.

Delimitadores e Caracteres EspeciaisOs caracteres a seguir possuem significados especiais nos comandosdo Conman:


& Delimitador de comando. Consulte “Como executar o Conman”na página 99.

+ Um delimitador utilizado para selecionar objetos paracomandos. Ele adiciona um atributo que o objeto deve ter. Porexemplo:

sked1.@+priority=0

x Um delimitador utilizado para selecionar objetos paracomandos. Ele adiciona um atributo que o objeto não deve ter.Por exemplo:

sked1.@xpriority=0

; Delimitador de argumento. Por exemplo:

;info;offline

, Delimitador de repetição e de faixa. Por exemplo:

state=hold,sked,pend

= Delimitador de valor. Por exemplo:

state=hold

: ! Prefixos de comandos que transmitem o comando para osistema. Esses prefixos são opcionais; se o Conman nãoreconhecer o comando, ele será transmitido automaticamente aosistema. Por exemplo:

!ls ou :ls

<<>> Colchetes de comentários. Por exemplo:

sj @#@.@ <<comment>>

* Prefixo do comentário. O prefixo deve ser o primeiro caractereem uma linha de comandos ou após um delimitador decomandos. Por exemplo:

*comment

ou

sj& *comment

Sintaxe de Comandos

104 Versão 7.0


> Redireciona a saída de comando para um arquivo e sobrepõe oconteúdo do arquivo. Se o arquivo não existir, ele será criado.Por exemplo:

sj> joblist

>> Redireciona a saída de comando para um arquivo e anexa asaída no final do arquivo. Se o arquivo não existir, ele serácriado. Por exemplo:

sj >> joblist

| Canaliza a saída de comando para um comando do sistema ouprocesso. O comando do sistema é executado independente dasaída ser ou não gerada. Por exemplo:

sj| grep ABEND

|| Canaliza a saída de comando para um comando do sistema ouprocesso. O comando do sistema não será executado, se nãoexistir nenhuma saída. Por exemplo:

sj || grep ABEND

Lista de ComandosA tabela a seguir lista o conjunto de comandos do Conman. Osnomes e as palavras-chave dos comandos podem ser digitados emmaiúsculas ou minúsculas e podem ser abreviados com o mínimo decaracteres iniciais possíveis, contanto que possam ser diferenciadosuns dos outros. Alguns dos nomes de comandos também possuemformas abreviadas.

Comandos FormaAbreviada

Descrição Tipo1 Página

addep adj | ads Adiciona dependências dejob ou fluxo de job.

M,F 126128

altpass Altera uma senha dedefinição de objeto doUsuário.

M,F 130

altpri ap Altera prioridades de jobou fluxo de job.

M,F 131

cancel cj | cs Cancela um job ou fluxode job.

M,F 132,135

Sintaxe de Comandos


3.R

eferênciado

Conm

an



confirm Confirma conclusão dojob.

M,F 137

console Atribui o console doWorkload Scheduler.

M,F,A 139

continue Ignora o próximo erro. M,F,A 141

deldep ddj | dds Elimina dependências dejob ou fluxo de job.

M,F 142144

display df | dj |ds

Exibe arquivos, jobs efluxos de job.

M,F,A2 146

exit Termina o Conman. M,F,A 148

fence Define o limitador de jobdo Workload Scheduler.

M,F,A 149

help5 Exibe informações sobre ocomando.

M,F,A 151

kill Pára um job em execução. M,F 153

limit lc | ls Altera o limite de job deuma estação de trabalho oufluxo de job.

M,F,A3 154156

link lk Abre links da estação detrabalho.

M,F,A 157

listsym Exibe uma lista dearquivos de log doSymphony.

M,F 161

recall rc Exibe mensagens deprompt.

M,F 163

redo Edita o comando anterior. M,F,A 165

release rj | rs Libera dependências de jobou de fluxo de job.

M,F 167169

reply Responde a mensagens deprompts.

M,F 171

rerun rr Reexecuta um job. M,F 173

resource Altera o número deunidades de recurso.

M,F 177

Sintaxe de Comandos

106 Versão 7.0



setsym Seleciona um arquivo delog do Symphony.

M,F 178

showcpus sc Exibe informações de linkse de estação de trabalho.

M,F,A 179

showdomain Exibe informações sobre odomínio.

M,F,A 183

showfiles sf Exibe informações sobrearquivos.

M,F 185

showjobs sj Exibe informações sobrejobs.

M,F 188

showprompts sp Exibe informações sobreprompts.

M,F 197

showresources sr Exibe informações sobrerecursos.

M,F 200

showschedules ss Exibe informações sobrefluxos de job.

M,F 203

shutdown Pára os processos deprodução do WorkloadScheduler.

M,F,A 207

start Inicia os processos deprodução do WorkloadScheduler.

M,F,A 208

status Exibe o status de produçãodo Workload Scheduler.

M,F,A 212

stop Pára os processos deprodução do WorkloadScheduler.

M,F,A 213

submit sbd | sbf |sbj | sbs

Submete um comando,arquivo, job ou fluxo dejob.

M,F,A4 217220223226

switchmgr Alterna o gerenciador dedomínio.

M,F 229

sys-command Envia um comando aosistema.

M,F,A 231

Sintaxe de Comandos


3.R

eferênciado

Conm

an



tellop to Envia uma mensagem aoconsole.

M,F,A 232

unlink Fecha links da estação detrabalho.

M,F,A 233

version v Exibe o banner doprograma Conman.

M,F,A 236

1. Tipos de estação de trabalho: gerenciadores de domínio (M),agentes de tolerância a falhas (F), agentes padrão (S).

2. Você pode exibir apenas arquivos em um agente padrão.

3. Você pode alterar o limite apenas de estações de trabalho em umagente padrão.

4. Você pode utilizarsubmit job (sbj) e submit sched(sbs) em umagente padrão somente se o diretóriomozart no gerenciador dedomínio mestre estiver acessível a esse agente.

5. Não disponível no Windows NT.

Como Selecionar Jobs em ComandosPara comandos que operam em jobs, os jobs de destino selecionadospor intermédio de atributos e qualificadores. A sintaxe de seleção dojob é mostrada abaixo e descrita nas páginas a seguir.

Sinopse[wkstation#] { jobstream.job| jobnumber} [ + | xjobqualifier[...]]

ou:

netagent::[wkstation#] jobstream.job

Argumentoswkstation

Quando utilizado comjobstream.job, especifica o nome daestação de trabalho na qual o fluxo de job é executado.

Sintaxe de Comandos

108 Versão 7.0

Quando utilizado comjobnumber, especifica a estação detrabalho na qual o job é executado. Caracteres curinga sãopermitidos.

jobstreamEspecifica o nome do fluxo de job no qual o job éexecutado. Caracteres curinga são permitidos.

job Especifica o nome do job. Caracteres curinga são permitidos.

jobnumberEspecifica o número do job.

jobqualifierConsulte a seção a seguir, “Qualificadores de Job”.

netagentEspecifica o nome do agente de rede do Workload Schedulerque faz interface com a rede remota do Workload Schedulerque contém o job de destino. Os dois-pontos (::) sãorequeridos como delimitador. Caracteres curinga sãopermitidos. Para obter mais informações, consulte“Referência do Agente de Rede” na página 311.

Qualificadores de Jobat[=time | lowtime | hightime| lowtime,hightime]

Seleciona ou exclui jobs com base na hora de inícioplanejada.

time

Especifica a hora de início planejada, expressa comoa seguir:

hhmm[+n days | +date] [ timezone|tztzname]

hhmm A hora e minuto.

+n daysA próxima ocorrência dehhmmem n númerode dias.

Como Selecionar Jobs em Comandos


3.R

eferênciado

Conm

an

+date A próxima ocorrência dehhmmem date,expressa comomm/dd/yy.

timezone|tztznameO nome do fuso horário do job. Consulte“Nomes dos Fusos Horários” na página 319para obter os nomes válidos.

lowtimeEspecifica o limite inferior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados jobs que têm horas de início planejadasnesta hora ou após ela.

hightimeEspecifica o limite superior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados jobs que têm horas de início planejadasnesta hora ou antes dela.

Seat for utilizado sozinho, a faixa será livre, e os jobs serãoselecionados ou excluídos se tiverem alguma hora de inícioplanejada.

confirmedSeleciona ou exclui jobs que foram planejados utilizando-sea palavra-chaveconfirm .

every[=rate | lowrate, | ,highrate | lowrate,highrate]Seleciona ou exclui jobs se tiverem ou não uma taxa derepetição.

rate Especifica a taxa de execução planejada, expressacomo hora e minuto (hhmm).

lowrateEspecifica o limite inferior de uma faixa de taxas,expressa no mesmo formato derate. Jobs que têmtaxas de repetição iguais ou maiores que essa taxasão selecionados.

highrateEspecifica o limite superior de uma faixa de taxas,


110 Versão 7.0

expressa no mesmo formato derate. Jobs que têmtaxas de repetição menores ou iguais a essa taxa sãoselecionados.

Seevery for utilizado sozinho, a faixa será livre e os jobsserão selecionados ou excluídos se tiverem alguma taxa derepetição.

finished[=time | lowtime, | ,hightime| lowtime,hightime]Seleciona ou exclui jobs se tiverem terminado ou não.

time Especifica a hora exata em que os jobs terminaram,expressa como a seguir:

hhmm[date] [ timezone|tztzname]


date A próxima ocorrência dehhmmna data,expressa comomm/dd/yy.


lowtimeEspecifica o limite inferior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados jobs que terminaram nesta hora ou apósela.

hightimeEspecifica o limite superior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados jobs que terminaram nesta hora ouantes dela.

Se finished for utilizado sozinho, a faixa será livre, e os jobsserão selecionados ou excluídos se tiverem terminado aexecução.



3.R

eferênciado

Conm

an

follows[=[netagent::][[ wkstation#] jobstream.]job]Seleciona ou exclui jobs se tiverem ou não uma dependênciafollows.

wkstationEspecifica o nome da estação de trabalho na qual ojob de pré-requisito é executado. Caracteres curingasão permitidos.

jobstreamEspecifica o nome do fluxo de job no qual o job depré-requisito é executado. Caracteres curinga sãopermitidos. Se você digitarjobstream.@, estaráespecificando que o job de destino segue todos osjobs do fluxo de job.

job Especifica o nome do job de pré-requisito. Quandodigitado sem umjobstream, significa que o job depré-requisito está no mesmo fluxo de job do job dedestino. Caracteres curinga são permitidos.

netagentEspecifica o nome do agente de rede do WorkloadScheduler que faz interface com a rede remota doWorkload Scheduler que contém o job depré-requisito. Caracteres curinga são permitidos. Paraobter mais informações, consulte “Referência doAgente de Rede” na página 311.

Se follows for utilizado sozinho, os jobs serão selecionadosou excluídos se tiverem alguma dependênciafollows.

logon=usernameSeleciona jobs com base nos nomes de usuário sob os quaissão executados. Seusernamecontiver caracteres especiais,ele deverá ser colocado entre aspas (″). Caracteres curingasão permitidos.

needs[=[wkstation#]resourcename]Seleciona ou exclui jobs se tiverem ou não uma dependênciade recurso.


112 Versão 7.0

wkstationEspecifica o nome da estação de trabalho na qual orecurso foi definido. Caracteres curinga sãopermitidos.

resourcenameEspecifica o nome do recurso. Caracteres curinga sãopermitidos.

Seneedsfor utilizado sozinho, os jobs serão selecionados ouexcluídos se tiverem alguma dependência de recurso.

opens[=[wkstation#]filename[(qualifier)]]Seleciona jobs se tiverem ou não uma dependência dearquivo.

wkstationEspecifica o nome da estação de trabalho na qual oarquivo existe. Caracteres curinga são permitidos.

filenameEspecifica o nome do arquivo. O nome deverá sercolocado entre aspas (″) se contiver caracteresdiferentes dos seguintes: alfanuméricos, traços (-),barras (/), barras invertidas (\) e sublinhados (_).Caracteres curinga são permitidos.

qualifierUma condição de teste válida. Se omitido, os jobsserão selecionados ou excluídos independente de umqualificador.

Seopensfor utilizado sozinho, os jobs serão selecionados ouexcluídos se tiverem alguma dependência de arquivo.

priority= pri | lowpri, | ,highpri | lowpri,highpriSeleciona ou exclui jobs com base em suas prioridades.

pri Especifica o valor de prioridade. Você pode digitarde 0 a 99, hi ou go.

lowpri Especifica o limite inferior de uma faixa de



3.R

eferênciado

Conm

an

prioridades. Os jobs são selecionados comprioridades iguais ou maiores que esse valor.

highpriEspecifica o limite superior de uma faixa deprioridades. Os jobs são selecionados comprioridades menores ou iguais a esse valor.

prompt[= promptname| msgnum]Seleciona ou exclui jobs se tiverem ou não uma dependênciade prompt.

promptnameEspecifica o nome de um prompt global. Caracterescuringa são permitidos.

msgnumEspecifica o número de mensagem de um promptlocal.

Seprompt for utilizado sozinho, os jobs serão selecionadosou excluídos se tiverem alguma dependência de prompt.

recovery=recv-optionSeleciona ou exclui jobs com base em suas opções derecuperação.

recv-optionEspecifica a opção de recuperação do job comoparar , continuar ou reexecutar.

scriptname=filenameSeleciona ou exclui jobs com base nos nomes de seusarquivos executáveis.

filenameEspecifica o nome de um arquivo executável. Onome deverá ser colocado entre aspas (″) se contivercaracteres diferentes dos seguintes: alfanuméricos,traços (-), barras (/), barras invertidas (\) esublinhados (_). Caracteres curinga são permitidos.

started[=time | lowtime, | ,hightime| lowtime,hightime]Seleciona ou exclui jobs se tiverem ou não sido iniciados.


114 Versão 7.0

time Especifica a hora exata em que o job foi iniciado,expressa como a seguir:





lowtimeEspecifica o limite inferior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados jobs que iniciaram nesta hora ou apósela.

hightimeEspecifica o limite superior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados jobs que iniciaram nesta hora ou antesdela.

Sestarted for utilizado sozinho, a faixa será livre, e os jobsserão selecionados ou excluídos se tiverem sido iniciados.

state=state[,...]Seleciona ou exclui jobs com base em seus estados.

state Especifica o estado atual do job. Os estados de jobválidos são os seguintes:

abend O job terminou com um código de saídadiferente de zero.

abenp Uma confirmação deabend foi recebida,mas o job não está concluído.

add O job está sendo submetido.



3.R

eferênciado

Conm

an

done O job foi concluído em um estadodesconhecido.

error Para dependências entre redes apenas,ocorreu um erro durante a verificação dostatus remoto.

exec O job está sendo executado.

extrn Para as dependências entre redes apenas, ostatus é desconhecido. Ocorreu um erro, umaação reexecutar acabou de ser realizada nojob do fluxo de jobexternal, ou o jobremoto ou fluxo de job não existe.

fail Impossível lançar o job.

fence A prioridade do job está abaixo da grade.

hold O job está aguardando a resolução dadependência.

intro O job é apresentado para ser lançado pelosistema.

pend O job foi concluído e está aguardandoconfirmação.

ready O job está pronto para ser lançado e todas asdependências foram resolvidas.

sched A hora at do job não chegou.

succ O job foi concluído com um código de saídazero.

succp Uma confirmaçãosucc foi recebida, mas ojob não está concluído.

susp O job foi suspenso por um comandobreakjob. (Apenas MPE)

wait O job está no estado deespera. (Apenasagente estendido e MPE)

waitd O job está no estado deesperae é adiado.(Apenas MPE)


116 Versão 7.0

until[= time | lowtime, | ,hightime| lowtime,hightime]Seleciona ou exclui jobs com base em sua hora de términoplanejada.

time Especifica a hora de término planejada, expressacomo a seguir:

hhmm[+n days | date] [ timezone|tztzname]





lowtimeEspecifica o limite inferior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados jobs que planejaram as horas detérmino nesta hora ou após ela.

hightimeEspecifica o limite superior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados jobs que planejaram as horas detérmino nesta hora ou antes dela.

Seuntil for utilizado sozinho, a faixa será livre, e os jobsserão selecionados ou excluídos se tiverem alguma hora detérmino planejada.



3.R

eferênciado

Conm

an

Como Selecionar Fluxos de Job em ComandosPara comandos que operam em fluxos de job, os fluxos de job dedestino são selecionados por intermédio de atributos e qualificadores.A sintaxe de seleção do fluxo de job é mostrada abaixo e descritanas páginas a seguir.

Sinopse[wkstation#] jobstream[+ | xjobstreamqual[...]]

Argumentoswkstation

Especifica o nome da estação de trabalho na qual o fluxo dejob é executado. Caracteres curinga são permitidos.

jobstreamEspecifica o nome do fluxo de job. Caracteres curinga sãopermitidos.

jobstreamqualConsulte “Qualificadores do Fluxo de Job” abaixo.

Qualificadores do Fluxo de Jobat[=time | lowtime, | ,hightime| lowtime,hightime]

Seleciona ou exclui fluxos de job com base na hora de inícioplanejada.

time Especifica a hora de início planejada, expressa comoa seguir:





timezone|tztznameO nome do fuso horário do fluxo de job.

Como Selecionar Fluxos de Job em Comandos

118 Versão 7.0

Consulte “Nomes dos Fusos Horários” napágina 319 para obter os nomes válidos.

lowtimeEspecifica o limite inferior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados fluxos de job que planejaram horas deinício nesta hora ou após ela.

hightimeEspecifica o limite superior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados fluxos de job que planejaram horas deinício nesta hora ou antes dela.

Seat for utilizado sozinho, a faixa será livre, e os fluxos dejob serão selecionados ou excluídos se tiverem alguma horade início planejada.

carriedforwardSeleciona ou exclui fluxos de job que foram transportados.

carryforwardSeleciona ou exclui fluxos de job que foram planejadosutilizando-se a palavra-chavecarryforward .

finished[=time | lowtime, | ,hightime| lowtime,hightime]Seleciona ou exclui fluxos de job se tiverem terminado ounão.

time Especifica a hora exata em que os fluxos de jobterminaram, expressa como a seguir:




timezone|tztznameO nome do fuso horário do fluxo de job.Consulte “Nomes dos Fusos Horários” napágina 319 para obter os nomes válidos.



3.R

eferênciado

Conm

an

lowtimeEspecifica o limite inferior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados fluxos de job que terminaram nessahora ou após ela.

hightimeEspecifica o limite superior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados fluxos de job que terminaram nessahora ou antes dela.

Se finished for utilizado sozinho, a faixa será livre, e osfluxos de job serão selecionados ou excluídos se tiveremterminado a execução.

follows[=[netagent::][ wkstation#] jobstream[.job]Seleciona ou exclui fluxos de job se tiverem ou não umadependênciafollows.

netagentEspecifica o nome do agente de rede que fazinterface com a rede remota do Workload Schedulerque contém o job ou fluxo de job de pré-requisito.Caracteres curinga são permitidos. Para obter maisinformações sobre agentes de rede, consulte“Referência do Agente de Rede” na página 311.

wkstationEspecifica o nome da estação de trabalho na qual ojob ou fluxo de job de pré-requisito é executado.Caracteres curinga são permitidos.

jobstreamEspecifica o nome do fluxo de job de pré-requisito.Caracteres curinga são permitidos.

job Especifica o nome do job de pré-requisito.Caracteres curinga são permitidos.


120 Versão 7.0

Se follows for utilizado sozinho, os fluxos de job serãoselecionados ou excluídos se tiverem alguma dependênciafollows.

limit[= limit | lowlimit, | ,highlimit | lowlimit,highlimit]Seleciona ou exclui fluxos de job se tiverem ou não umlimite de job.

limit Especifica o valor exato do limite de job.

lowlimitEspecifica o limite inferior de faixa. Sãoselecionados fluxos de job que possuem limites dejob iguais ou maiores que esse limite.

highlimitEspecifica o limite superior de uma faixa. Sãoselecionados fluxos de job que possuem limites dejob menores ou iguais a esse limite.

Se limit for utilizado sozinho, a faixa será livre, e os fluxosde job serão selecionados ou excluídos se tiverem algumlimite de job.

needs[=[wkstation#]resourcename]Seleciona ou exclui fluxos de job se tiverem ou não umadependência de recurso.

wkstationEspecifica o nome da estação de trabalho na qual orecurso foi definido. Caracteres curinga sãopermitidos.

resourcenameEspecifica o nome do recurso. Caracteres curinga sãopermitidos.

Seneedsfor utilizado sozinho, os fluxos de job serãoselecionados ou excluídos se tiverem alguma dependência derecurso.



3.R

eferênciado

Conm

an

opens[=[wkstation#]filename[(qualifier)]]Seleciona ou exclui fluxos de job se tiverem ou não umadependência de arquivo.

wkstationEspecifica o nome da estação de trabalho na qual oarquivo existe. Caracteres curinga são permitidos.

filenameEspecifica o nome do arquivo. O nome deverá sercolocado entre aspas (″) se contiver caracteresdiferentes dos seguintes: alfanuméricos, traços (-),barras (/), barras invertidas (\) e sublinhados (_).Caracteres curinga são permitidos.

qualifierUma condição de teste válida. Se omitido, os fluxosde job serão selecionados ou excluídos independentede um qualificador.

Seopensfor utilizado sozinho, os fluxos de job serãoselecionados ou excluídos se tiverem alguma dependência dearquivo.

priority= pri | lowpri, | ,highpri | lowpri,highpriSeleciona ou exclui fluxos de job com base em suasprioridades.

pri Especifica o valor de prioridade. Você pode digitarde 0 a 99, hi ou go.

lowpri Especifica o limite inferior de uma faixa deprioridades. Os fluxos de job são selecionados comprioridades iguais ou maiores que esse valor.

highpriEspecifica o limite superior de uma faixa deprioridades. Os fluxos de job são selecionados comprioridades menores ou iguais a esse valor.

prompt[= promptname| msgnum]Seleciona ou exclui fluxos de job se tiverem ou não umadependência de prompt.


122 Versão 7.0


msgnumEspecifica o número de mensagem de um promptlocal.

Seprompt for utilizado sozinho, os fluxos de job serãoselecionados ou excluídos se tiverem alguma dependência deprompt.

started[=time | lowtime, | ,hightime| lowtime,hightime]Seleciona ou exclui fluxos de job se tiverem ou não sidoiniciados.

time Especifica a hora exata em que os fluxos de jobforam iniciados, expressa como a seguir:





lowtimeEspecifica o limite inferior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados fluxos de job que iniciaram nessa horaou após ela.

hightimeEspecifica o limite superior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados fluxos de job que iniciaram nessa horaou antes dela.



3.R

eferênciado

Conm

an

Sestarted for utilizado sozinho, a faixa será livre, e osfluxos de job serão selecionados ou excluídos se tivereminiciado a execução.

state=state[,...]Seleciona ou exclui fluxos de job com base em seus estados.

state Especifica o estado atual do fluxo de job. Os estadosválidos dos fluxos de job são os seguintes:

abend O fluxo de job terminou de forma anormal.

exec O fluxo de job está sendo executado.

hold O fluxo de job está aguardando a resoluçãode dependências.

ready O fluxo de job está pronto para ser lançado etodas as dependências foram resolvidas.

stuck A execução foi interrompida. Nenhum job élançado sem a intervenção do operador.

succ O fluxo de job foi concluído com êxito.

until[= time | lowtime, | ,hightime| lowtime,hightime]Seleciona ou exclui fluxos de job com base na hora detérmino planejada.

time Especifica a hora de término planejada, expressacomo a seguir:







124 Versão 7.0

lowtimeEspecifica o limite inferior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados fluxos de job que planejaram horas detérmino nessa hora ou após ela.

hightimeEspecifica o limite superior de um intervalo detempo, expresso no mesmo formato detime. Sãoselecionados fluxos de job que planejaram horas detérmino nessa hora ou antes dela.

Seuntil for utilizado sozinho, a faixa será livre, e os fluxosde job serão selecionados ou excluídos se tiverem algumahora de término planejada.

Descrições dos ComandosAs páginas a seguir contêm descrições detalhadas de comandos doConman.

Nota: Nos comandos, os termos sched e schedule referem-se aosfluxos de job, e o termo cpu refere-se a estações de trabalho.



3.R

eferênciado

Conm

an

adddep jobAdiciona dependências a um job.

Você deve ter acessoadddep ao job. Para incluir dependênciasneedse prompt , você deve ter acessouseaos recursos e promptsglobais.

Sinopseadj jobselect[;dependency[;...]][;noask]

Argumentosjobselect

Consulte “Como Selecionar Jobs em Comandos” napágina 108.

dependencyO tipo de dependência. Especifique uma das seguintes.Caracteres curinga não são permitidos.

at=hhmm[+n days | mm/dd/yy]

confirmed

every=rate

follows=[netagent:: ][wkstation#]jstream{. job | @} | job[,...]

needs=[num] [wkstation#]resource[,...]

opens=[wkstation#]″filename″[(qualifier)][ ,...] priority [=pri |hi | go]

prompt=″[: | !]text″ | promptname[,...]

until= hhmm[+n days | mm/dd/yy]

noask Especifica para não solicitar confirmação antes da tomada deação em cada job qualificado.

Notas de UtilizaçãoSe você não especificar um valor parapriority , o job reverterá parasua prioridade planejada original. Se você não especificar umaestação de trabalho emfollows, needsou opens, o padrão será aestação de trabalho na qual o job é executado. Para adicionar


126 Versão 7.0

dependências de prompt enquanto o Conman é executado em umagente de tolerância a falhas, você deverá ter acesso ao diretórioWShome/mozart no gerenciador de domínio mestre.

ExemplosO exemplo a seguir adiciona uma dependência de recurso nojob3fluxo de jobsked9:adddep sked9.job3;needs=2 tapes

O exemplo a seguir adiciona uma dependência de arquivo e umahorauntil no job6 no fluxo de jobsked2:adj sked2.job6;opens="/usr/lib/prdata/file5"(-s %p);until=2330



3.R

eferênciado

Conm

an

adddep schedAdiciona dependências a um fluxo de job.

Você deve ter acessoadddep ao fluxo de job. Para incluirdependênciasneedse prompt , você deve ter acessouseaos recursose prompts globais.

Sinopseads jstreamselect[;dependency[;...]][;noask]

Argumentosjstreamselect

Consulte “Como Selecionar Fluxos de Job em Comandos” napágina 118.

dependencyO tipo de dependência. Especifique uma das seguintes.Caracteres curinga não são permitidos.

at=hhmm[+n days | mm/dd/yy]

carryforward


limit =limit




until= hhmm[+n days | mm/dd/yy]

noask Especifica para não solicitar confirmação antes da tomada deação em cada fluxo de job qualificado.

Notas de UtilizaçãoSe você não especificar um valor parapriority , o fluxo de jobreverterá para sua prioridade planejada original. Se você nãoespecificar uma estação de trabalho emfollows, needsou opens, opadrão será a estação de trabalho na qual o fluxo de job é executado.


128 Versão 7.0

Para adicionar dependências de prompt enquanto o Conman éexecutado em um agente de tolerância a falhas, você deverá teracesso ao diretórioWShome/mozart no gerenciador de domíniomestre.

ExemplosO exemplo a seguir adiciona uma dependência de prompt no fluxode jobsked3:adddep sched=sked3;prompt=msg103

O exemplo a seguir adiciona uma dependência follows e um limitede job no fluxo de jobsked4:ads sked4;follows=sked3;limit=2



3.R

eferênciado

Conm

an

altpassAltera a senha de um objeto de usuário no plano de produção atual.

Você deve ter acessoaltpassao objeto do usuário.

Sinopsealtpass [wkstation#]username[;″password″]

Argumentoswkstation Especifica a estação de trabalho na qual o usuário

está definido. O padrão é a estação de trabalho naqual o Conman está sendo executado.

username Especifica o nome de um usuário.

password Especifica a nova senha. Ela deve ser colocada entreaspas. Para indicar ausência de senha para o usuário,utilize duas aspas consecutivas (″″).

Notas de UtilizaçãoSe você não especificar uma senha (password), o Conman solicitaráuma, além de uma confirmação. Neste caso, a senha não será exibidana digitação e não deverá ser colocada entre aspas. Observe que aalteração é feita somente no plano de produção atual, sendo, dessemodo, temporária. Para fazer uma alteração permanente, consulte“Definições do Usuário” na página 18.

ExemplosO exemplo a seguir altera a senha do usuáriojim na estação detrabalhomis5 paragiraffe:altpass mis5#jim;”giraffe”

O exemplo a seguir altera a senha do usuáriojim na estação detrabalhomis5 paragiraffe sem exibir a senha:altpass mis5#jimpassword: xxxxxxxxconfirm: xxxxxxxx


130 Versão 7.0

altpriAltera a prioridade de um job ou fluxo de job.

Você deve ter acessoaltpri ao job ou fluxo de job.

Sinopseap jobselect| jstreamselect[;pri][ ;noask]

Argumentosjobselect Consulte “Como Selecionar Jobs em Comandos” na

página 108.

jstreamselect Consulte “Como Selecionar Fluxos de Job emComandos” na página 118.

pri Especifica o nível de prioridade. Você pode digitarum valor de0 a 99, hi ou go.

noask Especifica para não solicitar confirmação antes datomada de ação em cada job ou fluxo de jobqualificado.

ExemplosO exemplo a seguir altera a prioridade do jobbalanceno fluxo dejob glmonth:altpri glmonth.balance;55

O exemplo a seguir altera a prioridade de todos os jobs no fluxo dejob mis5:ap mis5.@;25

O exemplo a seguir altera a prioridade do fluxo de jobglmonth:altpri glmonth;10

O exemplo a seguir altera a prioridade do fluxo de jobmis5:ap mis5;30



3.R

eferênciado

Conm

an

canceljob

Cancela um job.

Você deve ter acessocancelao job.

Sinopsecj jobselect[;pend][ ;noask]

Argumentosjobselect Consulte“Como Selecionar Jobs em Comandos” na

página 108.

pend Cancela o job somente após a resolução de suasdependências.

noask Especifica para não solicitar confirmação antes datomada de ação em cada job qualificado.

Notas de UtilizaçãoSe um job for cancelado antes de ser lançado, ele não será lançado.Se for cancelado depois de ser lançado, ele continuará a serexecutado. Se um job em execução for cancelado e for concluído noestadoabend, não serão tentadas etapas automáticas de recuperaçãodo job.

Se você não utilizar a opção;pend, os jobs e fluxos de jobdependentes do job cancelado serão liberados imediatamente dadependência.

Se você incluir a opção;pend e o job não tiver sido lançado, ocancelamento será deferido até que todas as dependências, incluindouma horaat, sejam resolvidas. Depois de todas as dependênciasterem sido resolvidas, o job será cancelado e todos os jobs ou fluxosde job dependentes do job cancelado serão liberados da dependência.Durante o período em que o cancelamento é deferido, a notação[Cancel Pend]é listada na coluna Dependências do job em uma telashowjobs.


132 Versão 7.0

Se você incluir a opção;pend e o job já tiver sido lançado, a opçãoserá ignorada e todos os jobs ou fluxos de job dependentes do jobcancelado serão liberados imediatamente da dependência.

Você pode utilizar o comandorerun para executar novamente osjobs que foram cancelados ou que estiverem marcados com[CancelPend]. Também pode adicionar e excluir dependências de jobs queestiverem marcados com[Cancel Pend].

Para cancelar imediatamente um job marcado com[Cancel Pend],você pode digitar um comandoreleasepara o job ou digitar outrocomandocancelsem a opção;pend.

Para jobs com horasuntil expiradas, a notação[Until] é listada nacoluna Dependências em uma telashowjobse suas dependênciasnão são mais avaliadas. Se esse job também estiver marcado com[Cancel Pend], ele não será cancelado até que você libere ou excluaa horauntil , ou digite outro comandocancelsem a opção;pend.

Para parar de avaliar as dependências, defina a prioridade de um jobcomo zero com o comandoaltpri . Para continuar a avaliá-las, definaa prioridade com um valor maior que zero.

Nota: No caso de dependências entre redes, cancelar um job nofluxo de jobexternal liberará todos os jobs e fluxos de joblocais da dependência. Os jobs do fluxo de jobexternalrepresentam jobs e fluxos de job que foram especificadoscomo dependências entre redes. O status de uma dependênciaentre redes não é verificado após um comandocancelserexecutado. Para obter mais informações, consulte“Dependências entre redes” na página 315.

ExemplosO exemplo a seguir cancela o jobreport no fluxo de jobapwkly naestação de trabalhosite3:cancel site3#apwkly.report

O exemplo a seguir cancela o jobsetup no fluxo de jobmis5 se nãoestiver no estadoabend:



3.R

eferênciado

Conm

an

cj mis5.setupxstate=abend

O exemplo a seguir cancela o jobjob3 no fluxo de jobsked3somente após a resolução de suas dependências:cj sked3.job3;pend


134 Versão 7.0

cancel schedCancela um fluxo de job.

Você deve ter acessocancelao fluxo de job.

Sinopsecs jstreamselect[;pend][ ;noask]

Argumentosjstreamselect Consulte“Como Selecionar Fluxos de Job em

Comandos” na página 118.

pend Cancela o fluxo de job somente após a resolução desuas dependências.

noask Especifica para não solicitar confirmação antes datomada de ação em cada fluxo de job qualificado.

Notas de UtilizaçãoSe um fluxo de job for cancelado antes de ser lançado, ele não serálançado. Se for cancelado após ser lançado, os jobs que foraminiciados terão permissão para serem concluídos, mas nenhum outrojob será lançado.

Se você não utilizar a opção;pend, os jobs e fluxos de jobdependentes do fluxo de job cancelado serão liberadosimediatamente da dependência.

Se você utilizar a opção;pend e o fluxo de job não tiver sidolançado, o cancelamento será deferido até que todas suasdependências, incluindo uma horaat, sejam resolvidas. Depois detodas as dependências terem sido resolvidas, o fluxo de job serácancelado e todos os jobs ou fluxos de job dependentes serãoliberados da dependência. Durante o período em quecancelédeferido, a notação[Cancel Pend]é listada na coluna Dependênciasde uma telashowschedules.

Se você incluir a opção;pend e o fluxo de job já tiver sido lançado,os jobs restantes do fluxo de job serão cancelados e todos os jobs efluxos de job dependentes serão liberados da dependência.



3.R

eferênciado

Conm

an

Para cancelar imediatamente um fluxo de job marcado com[CancelPend], você pode digitar um comandoreleasepara o fluxo de jobou digitar outro comandocancelsem a opção;pend.

Para fluxos de job com horasuntil expiradas, a notação[Until]aparece na coluna Dependências da telashowschedulese suasdependências não são mais avaliadas. Se esse fluxo de job tambémestiver marcado com[Cancel Pend], ele não será cancelado até quevocê libere ou exclua a horauntil , ou digite outro comandocancelsem a opção;pend.

Para parar de avaliar as dependências, defina a prioridade do fluxode job como zero com o comandoaltpri . Para continuar a avaliá-las,defina a prioridade com um valor maior que zero.

ExemplosO exemplo a seguir cancela o fluxo de jobsked1na estação detrabalhosite2:cancel site2#sked1

O exemplo a seguir cancelará o fluxo de jobmis2 se estiver noestadostuck:cs mis2+state=stuck

O exemplo a seguir cancela o fluxo de jobsked3somente após aresolução de suas dependências:cs sked3;pend


136 Versão 7.0

confirmConfirma a conclusão de um job que foi planejado com apalavra-chaveconfirmed

. Uma exceção é indicada na seção “Notas de Utilização”.

Você deve ter acessoconfirm ao job.

Sinopseconfirm jobselect;{ succ | abend}[ ;noask]


página 108.

succ Confirma que o job terminou com êxito.

abend Confirma que o job terminou sem êxito.


Notas de UtilizaçãoAlterar o estado de um job deabend parasuccnão requer que apalavra-chaveconfirmed seja utilizada para planejar o job. Paraobter mais informações sobre a confirmação de jobs, consulte“confirmed” na página 68. Para obter mais informações sobre jobsexternos, consulte “Dependências entre redes” na página 315.

A tabela a seguir mostra como o comandoconfirm afeta os váriosestados dos jobs:

Estado Inicial do Job Estado após confirm;succ

Estado após confirm;abend

ready não afeta não afeta

hold não afeta não afeta

exec succp abenp

abenp succp não afeta

succp não afeta não afeta



3.R

eferênciado

Conm

an

Estado Inicial do Job Estado após confirm;succ

Estado após confirm;abend

pend succ abend

done succ abend

succ não afeta não afeta

abend succ não afeta

fail não afeta não afeta

susp não afeta não afeta

skel não afeta não afeta

qualquer jobexterno succ abend

ExemplosO exemplo a seguir emite uma confirmaçãosuccpara ojob3 nofluxo de jobmisdly:confirm misdly.job3;succ

O exemplo a seguir emite uma confirmaçãoabend para o número dejob 234:conf 234;abend


138 Versão 7.0

consoleAtribui o console do Workload Scheduler e define o nível demensagem.

Você deve ter acessoconsoleà estação de trabalho.

Sinopseconsole[sess| sys][ ;level=msglevel]

Argumentossess Envia mensagens de console do Workload Scheduler

e solicita saída padrão.

sys Pára de enviar mensagens de console do WorkloadScheduler e solicita saída padrão. Isso ocorreautomaticamente quando você sai do Conman.

msglevel O nível de mensagens do Workload Scheduler quesão enviadas para o console. Especifique um dosseguintes níveis:

0 Sem mensagens. Esse é o padrão em agentesde tolerância a falhas.

1 Mensagens de exceção, tais como promptsdo operador e abends de jobs.

2 Nível 1, mais as mensagens de êxito dofluxo de job.

3 Nível 2, mais as mensagens de êxito do job.Esse é o padrão no gerenciador de domíniomestre.

4 Nível 3, mais as mensagens de jobslançados.

Notas de UtilizaçãoSe você digitar o comandoconsolesem opções, o estado atual doconsole será exibido.



3.R

eferênciado

Conm

an

Por padrão, os processos de controle do Workload Scheduler gravamas mensagens de console e os prompts em arquivos de lista padrão.No UNIX, você também pode enviá-los para o daemonsyslog.

ExemplosO exemplo a seguir começa a gravar as mensagens de console eprompts na saída padrão e altera o nível de mensagem para1:console sess;level=1

O exemplo a seguir pára a gravação das mensagens de console eprompts na saída padrão e altera o nível de mensagem para4:cons sys;l=4

O exemplo a seguir exibe o estado atual do console:consConsole is #J675, level 2, session

675 é o ID de processo da shell do usuário.


140 Versão 7.0

continueIgnora o próximo erro de comando.

Sinopsecontinue

Notas de UtilizaçãoEsse comando é útil quando os comandos são digitados de formanão interativa. Ele orienta o Conman a continuar a execução decomandos, mesmo se o próximo comando, depois decontinue,resultar em erro.

ExemplosNo exemplo a seguir, o Conman continuará com o comandorerun ,mesmo se os comandoscancel falharem:conman "continue&cancel=176&rerun job=sked5.job3"



3.R

eferênciado

Conm

an

deldep jobExclui dependências de um job.

Você deve ter acessodeldep ao job.

Sinopseddj jobselect;dependency[;...][;noask]

Argumentosjobselect

Consulte“Como Selecionar Jobs em Comandos” napágina 108.

dependencyO tipo de dependência. Especifique pelo menos uma dasseguintes. Você pode utilizar caracteres curinga emwkstation, jstream, job, resource, filenamee promptname.

at

confirmed

every

follows[=[netagent:: ][wkstation#]jstream{. job | @} | job[,...]]

needs[=[num] [wkstation#]resource[,...]]

opens[=[wkstation#]″filename″[(qualifier)][ ,...]]

priority

prompt [=″[: | !]text″ | promptname[,...]]

until


Notas de UtilizaçãoSepriority for excluído, o job reverterá para sua prioridadeplanejada original. Ao excluir uma dependênciaopens, você podeincluir apenas o nome de arquivo base e o Conman executará umapesquisa sem distinção de maiúsculas/minúsculas para


142 Versão 7.0

correspondência de arquivos, ignorando os nomes de diretórios. Asdependências de todos os arquivos correspondentes são excluídas.

ExemplosO exemplo a seguir exclui uma dependência de recurso dejob3 nosked5:deldep sked5.job3;needs=2 tapes

O exemplo a seguir exclui todas as de dependênciasfollows de job4em sked3:ddj sked3.job4;follows



3.R

eferênciado

Conm

an

deldep schedExclui dependências de um fluxo de job.

Você deve ter acessodeldep ao fluxo de job.

Sinopsedds jstreamselect;dependency[;...][;noask]


Consulte“Como Selecionar Jobs em Comandos” napágina 108.

dependencyO tipo de dependência. Especifique pelo menos uma dasseguintes. Você pode utilizar caracteres curinga emwkstation, jstream, job, resource, filenamee promptname.

at

carryforward


limit



priority


until


Notas de UtilizaçãoSepriority for excluído, o job reverterá para sua prioridadeplanejada original. Ao excluir uma dependênciaopens, você podeincluir apenas o nome de arquivo base e o Conman executará umapesquisa sem distinção de maiúsculas/minúsculas para


144 Versão 7.0

correspondência de arquivos, ignorando os nomes de diretórios. Asdependências de todos os arquivos correspondentes são excluídas.

ExemplosO exemplo a seguir exclui uma dependência de recurso dejob3 nosked5:deldep sked5.job3;needs=2 tapes

O exemplo a seguir exclui todas as de dependênciasfollows de job4em sked3:ddj sked3.job4;follows



3.R

eferênciado

Conm

an

displayExibe um arquivo de job ou uma definição de fluxo de job.

Se você especificar um arquivo pelo nome, deverá ter acesso read aoarquivo. Para arquivos de job e definições de fluxo de job, vocêdeve ter acessodisplay ao job ou fluxo de job.

Sinopsedffilename[;offline ]

dj jobselect[;offline ]

dsjstreamselect[;offline ]

Argumentosfilename Especifica o nome do arquivo, geralmente, um

arquivo de script de job. O nome deverá sercolocado entre aspas (″) se contiver caracteresdiferentes dos seguintes: alfanuméricos, traços (-),barras (/), barras invertidas (\) e sublinhados (_).Caracteres curinga são permitidos. O arquivo deveser acessível da estação de trabalho de início desessão.

jobselect O job cujo arquivo de job é exibido. Consulte“Como Selecionar Jobs em Comandos” napágina 108. O arquivo de job deve ser acessível daestação de trabalho de início de sessão.

jstreamselect O fluxo de job cuja definição é exibida. Consulte“Como Selecionar Fluxos de Job em Comandos” napágina 118. O diretóriomozart do WorkloadScheduler no gerenciador de domínio mestre deveser acessível da estação de trabalho de início desessão.

offline Envia a saída do comando para o dispositivo desaída do Conman. Para obter informações sobre essedispositivo, consulte “Saída Offline” na página 101.


146 Versão 7.0

ExemplosO exemplo a seguir exibe o arquivoc:\maestro\jclfiles\arjob3:df c:\apps\maestro\jclfiles\arjob3

O exemplo a seguir exibe o arquivo de script dejob6 em sked3offline:dj sked3.job6;off

O exemplo a seguir exibe a definição de fluxo de job desked9:\maestro\jclfiles\arjob3:ds sked9



3.R

eferênciado

Conm

an

exitSai do programa Conman.

Sinopsee

Notas de UtilizaçãoQuando você está no modo de auxílio no UNIX, esse comandoretorna o Conman para o modo de entrada de comandos.

ExemplosOs exemplos a seguir saem do programa Conman:exit

e


148 Versão 7.0

fenceAltera o limitador de job em uma estação de trabalho. Os jobs nãoserão lançados na estação de trabalho se suas prioridades foremmenores ou iguais ao limitador de job.

Você deve ter acessofenceà estação de trabalho.

Sinopsefenceworkstation;pri[;noask]

Argumentosworkstation Especifica o nome da estação de trabalho. O padrão

é sua estação de trabalho de início de sessão.

pri Especifica o nível de prioridade. Você pode digitarde 0 a 99, hi ou go. Digitar systemdefine olimitador de job como zero.

noask Especifica para não solicitar confirmação antes datomada de ação em cada estação de trabalhoqualificada.

Notas de UtilizaçãoO limitador de job evita o lançamento de jobs de baixa prioridade,independente das prioridades de seus fluxos de job. É possível,portanto, manter jobs de baixa prioridade em alta prioridade,enquanto se permite que jobs de alta prioridade em fluxos de job debaixa prioridade sejam lançados.

Quando você inicia o Workload Scheduler pela primeira vez após ainstalação, o limitador de job é definido como zero. Quando vocêaltera o limitador de job, ele é transportado durante o processamentode pré-produção para o plano de produção do dia seguinte.

Para exibir a definição atual do limitador de job, utilize o comandostatus.

ExemplosO exemplo a seguir altera o limitador de job na estação de trabalhosite4:



3.R

eferênciado

Conm

an

fence site4;20

O exemplo a seguir altera o limitador de job na estação de trabalhona qual o Conman está sendo executado:f ;40

O exemplo a seguir evita que todos os jobs sejam lançados peloWorkload Scheduler na estação de trabalhotx3:f tx3;go

O exemplo a seguir altera o limitador de job para zero na estação detrabalho na qual o Conman está sendo executado:f ;system


150 Versão 7.0

helpExibe informações de auxílio sobre comandos. Não disponível noWindows NT.

Sinopsehelp command

Argumentoscommand

Especifica o nome de um comando do Conman ou dosistema. Para comandos do Conman, não é suportado digitaro nome completo do comando, abreviações e formassimplificadas. No caso dos comandos consistirem em duaspalavras, digite a primeira palavra e será exibido auxílio paratodas as versões do comando. Por exemplo, digitarhelpdisplay exibirá informações sobre os comandosdisplay file,display job e display sched. Você também pode digitar asseguintes palavras-chave:

commandsLista todos os comandos do Conman.

jobselectLista informações sobre a seleção de jobs paracomandos.

jobstatesLista informações sobre os estados do job.

schedselectLista informações sobre a seleção de fluxos de jobpara comandos.

schedstatesLista informações sobre os estados do fluxo de job.

ExemplosO exemplo a seguir exibe uma lista de todos os comandos doConman:help commands



3.R

eferênciado

Conm

an

O exemplo a seguir exibe informações sobre o comandofence:help fence

O exemplo a seguir exibe informações sobre os comandosaltpri jobe altpri sched:h altpri


152 Versão 7.0

killPára um job em execução. No UNIX, isso é realizado com umcomandokill

do UNIX.

Sinopsekill jobselect[;noask]


página 108.


Notas de UtilizaçãoA operaçãokill não é executada pelo Conman e sim por umprocesso de produção do Workload Scheduler, portanto, pode haverum pequeno atraso.

Jobs eliminados terminam no estadoabend. Todos os jobs ou fluxosde job dependentes de um job eliminado não são liberados. Jobseliminados podem ser executados novamente.

ExemplosO exemplo a seguir elimina o jobreport no fluxo de jobapwkly naestação de trabalhosite3:kill site3#apwkly.report

O exemplo a seguir elimina o número de job456:k 456



3.R

eferênciado

Conm

an

limit cpuAltera o limite do job de uma estação de trabalho.

Você deve ter acessolimit à estação de trabalho.

Sinopselc wkstation;limit[;noask]

Argumentoswkstation Especifica o nome da estação de trabalho. Caracteres

curinga são permitidos. O padrão é sua estação detrabalho de início de sessão.

limit Especifica o limite do job. Você pode digitar de0 a1024. Digitar systemdefine o limite do job comozero. Se for definido um limite de zero, nenhum job,a não ser os de prioridadehi e go serão lançados naestação de trabalho.


Notas de UtilizaçãoPara exibir o limite atual do job na estação de trabalho de início desessão, utilize o comandostatus.

Quando você inicia o Workload Scheduler pela primeira vez após ainstalação, o limite de job da estação de trabalho é definido comozero e deve ser elevado antes de qualquer job ser lançado. Quandovocê altera o limite, ele é transportado durante o processamento depré-produção para o plano de produção do dia seguinte.

O Workload Scheduler tenta lançar o máximo de jobs possíveldentro do limite de job. Há um limite prático para o número deprocessos que podem ser iniciados em uma estação de trabalho. Se olimite for alcançado, o sistema responderá com uma mensagemindicando que os recursos do sistema não estão disponíveis. Quandoum job não pode ser lançado por este motivo, ele entra no estadofail . Abaixar o limite do job pode evitar que isso ocorra.


154 Versão 7.0

ExemplosO exemplo a seguir altera o limite do job na estação de trabalhosite3:limit cpu=site3;25

O exemplo a seguir altera o limite do job na estação de trabalho naqual o Conman está sendo executado:lc ;12

O exemplo a seguir altera o limite do job na estação de trabalhorx12:lc rx12;6



3.R

eferênciado

Conm

an

limit schedAltera o limite do job para um fluxo de job.

Você deve ter acessolimit ao fluxo de job.

Sinopsels jstreamselect;limit[;noask]

Argumentosjstreamselect Consulte“Como Selecionar Fluxos de Job em


limit Especifica o limite do job. Você pode digitar de0 a1024. Se você especificar um limite de zero, nenhumoutro job será lançado do fluxo de job.

noask Especifica para não solicitar confirmação antes datomada de ação em cada fluxo de job qualificado.

ExemplosO exemplo a seguir altera o limite do job em todos os fluxos de jobque incluemsalesno nome:limit sched=sales@;4

O exemplo a seguir altera o limite do job no fluxo de jobapwkly:ls apwkly;6


156 Versão 7.0

linkAbre links de comunicações entre as estações de trabalho. Em umarede do Workload Scheduler, agentes de tolerância a falhas e padrãosão ligados a seus gerenciadores de domínio e os gerenciadores dedomínio são ligados a seus gerenciadores de domínio pai. Agentesestendidos não são ligados; sua comunicação é feita através de umhost.

Você deve ter acessolink à estação de trabalho de destino.

Sinopselk [domain!]wkstation[;noask]

Argumentosdomain Especifica o nome do domínio no qual os links são

abertos. Caracteres curinga são permitidos.

Este argumento é útil quando se está ligando mais deuma estação de trabalho em um domínio. Porexemplo, para ligar todos os agentes no domíniostlouis, utilize o seguinte comando:link stlouis!@

O domínio não será necessário se você não incluircaracteres curinga emwkstation.

Se você não incluirdomaine incluir caracterescuringa emwkstation, o domínio padrão será aqueleonde o Conman está sendo executado.

wkstation Especifica o nome da estação de trabalho a serligada. Caracteres curinga são permitidos.


Notas de UtilizaçãoSe a opçãoautolink for definida comoon em uma definição deestação de trabalho, seu link será aberto automaticamente toda vez



3.R

eferênciado

Conm

an

que o Workload Scheduler for iniciado. Seautolink for definidocomooff, você deverá utilizar os comandoslink e unlink paracontrolar a ligação. Para obter informações sobreautolink , consulte“Definições da Estação de Trabalho” na página 3.

Supondo-se que um usuário tenha o acessolink a estações detrabalho sendo ligadas, as seguintes regras serão aplicadas:

¶ Um usuário executando o Conman no gerenciador de domíniomestre pode ligar qualquer estação de trabalho na rede.

¶ Um usuário executando o Conman em um gerenciador dedomínio diferente do mestre pode ligar qualquer estação detrabalho em seu próprio domínio e em domínios subordinados. Ousuário não pode ligar estações de trabalho em domínios ponto aponto.

¶ Um usuário executando o Conman em um agente pode ligarqualquer estação de trabalho em seu domínio local.

¶ Para ligar um domínio subordinado enquanto o Conman estásendo executado em um domínio superior, não é necessário queos links intermediários sejam abertos.

ExemplosA ilustração e tabela abaixo mostram os links abertos por comandoslink executados por usuários em várias localizações na rede.


158 Versão 7.0

DMn são gerenciadores de domínio eAnn são agentes.

Comandos Links Abertos peloUsuário1

Links Abertos peloUsuário2


link @!@ Todos os links sãoabertos.

DM1-DM2DM2-A21DM2-A22DM2-DM4DM4-A41DM4-A42

DM2-A21DM2-A22

link @ DM1-A11DM1-A12DM1-DM2DM1-DM3

DM1-DM2DM2-A21DM2-A22DM2-DM4

DM2-A21DM2-A22

link DOMAIN3!@ DM3-A31DM3-A32

Não permitido. Não permitido.

link DOMAIN4!@ DM4-A41DM4-A42

DM4-A41DM4-A42

Não permitido.

link DM2 DM1-DM2 Não aplicável. DM2-A21

link A42 DM4-A42 DM4-A42 Não permitido.



3.R

eferênciado

Conm

an

Comandos Links Abertos peloUsuário1



link A31 DM3-A31 Não permitido. Não permitido.


160 Versão 7.0

listsymLista os arquivos de log do plano de produção (Symphony).

Você deve ter acessodisplay ao arquivo Symphony.

Sinopselistsym [;offline ]

Argumentosoffline Envia a saída do comando para o dispositivo de

saída do Conman. Para obter informações sobre essedispositivo, consulte “Saída Offline” na página 101.

Saída de ComandoData de Planejamento

A data utilizada pelo comandoschedulr para selecionarfluxos de job para execução.

Data RealA data em quebatchman começou a executar o arquivoSymphony.

Hora de InícioA hora em quebatchman começou a executar o arquivoSymphony.

Data de RegistroA data em que o plano (Symphony) foi registrado pelocomandostageman.

Núm. de ExecuçãoO número de execução atribuído ao plano (Symphony). Elessão utilizados internamente para sincronização de rede doWorkload Scheduler.

TamanhoO tamanho do arquivo de log em registros.

Núm. de LogO número de log que indica a ordem cronológica dos



3.R

eferênciado

Conm

an

arquivos de log. Esse número pode ser utilizado em umcomandosetsympara mudar para um arquivo de logespecífico.

Nome do ArquivoO nome do arquivo de log atribuído pelo comandostageman.

ExemplosO exemplo a seguir lista os arquivos de log do plano de produção:listsym

O exemplo a seguir lista os arquivos de log do plano de produçãopara o dispositivo de saída do Conman:lis ;off


162 Versão 7.0

recallExibe prompts que estão aguardando uma resposta.

Você deve ter acessodisplay aos prompts.

Sinopserc [wkstation][ ;offline ]


prompt foi emitido. Se você não especificar umaestação de trabalho, somente os prompts da estaçãode trabalho de início de sessão e os prompts globaisserão exibidos.


Saída de ComandoEstado

O estado do prompt.O estado de prompts pendentes é sempreASKED.

Mensagem ou PromptPara prompts nomeados, o número da mensagem, o nome doprompt e o texto da mensagem. Para prompts não-nomeados,o número da mensagem, o nome do job ou fluxo de job e otexto da mensagem.

ExemplosO exemplo a seguir exibe prompts pendentes emitidos na estação detrabalho na qual o Conman está sendo executado:recall

ou:rc



3.R

eferênciado

Conm

an

O exemplo a seguir exibe prompts pendentes na estação de trabalhosite3:rc site3

O exemplo a seguir exibe prompts pendentes em todas as estaçõesde trabalho e a saída é enviada ao dispositivo offline do Conman:rc @;offline


164 Versão 7.0

redoEdita e reexecuta o comando anterior.

Sinopseredo

ContextoQuando você executa o comandoredo, o Conman exibe o comandoanterior para que possa ser editado e reexecutado. Utilize a barra deespaços para mover o cursor sob o caractere a ser modificado edigite as diretrizes a seguir.

Diretrizes

d[dir] Exclui o caractere acima ded. Pode vir seguido poroutras diretrizes.

itext Insere texto antes do caractere acima dei.

r text Substitui um ou mais caracteres por texto,começando com o caractere acima der . Asubstituição estará implícita se nenhuma outradiretriz for digitada.

>text Anexa texto no final da linha.

>d[dir | text]Exclui caracteres no final da linha. Pode vir seguidopor outra diretriz ou texto.

>r text Substitui caracteres no final da linha por texto.

Exemplos de Diretrizes

ddd Exclui os três caracteres acima deds.

iabc Insereabc antes do caractere acima dei.

rabc Substitui os três caracteres, começando pelocaractere acima der , por abc.

abc Substitui os três caracteres acima deabc por abc.



3.R

eferênciado

Conm

an

d diabcExclui o caractere acima do primeirod, pula umcaractere, exclui o caractere acima do segundod einsereabc em seu lugar.

>abc Anexaabc no final da linha.

>ddabcExclui os dois últimos caracteres na linha e insereabc em seu lugar.

>rabc Substitui os três últimos caracteres na linha porabc.

ExemplosO exemplo a seguir insere um caractere:redosetsm 4

iysetsym 4

O exemplo a seguir substitui um caractere:redosetsym 4

5setsym 5


166 Versão 7.0

release jobLibera jobs das dependências.

Você deve ter acessoreleaseao job.

Sinopserj jobselect[;dependency[;...]][;noask]

Argumentosjobselect

Especifica o job ou jobs a serem liberados. Consulte“ComoSelecionar Jobs em Comandos” na página 108.

dependencyO tipo de dependência. Você pode especificar uma dasseguintes. Você pode utilizar caracteres curinga emwkstation, jstream, job, resource, filenamee promptname.

at

confirmed

every




priority


until


Notas de UtilizaçãoQuando você libera uma dependênciaopens, pode incluir apenas onome de arquivo base e o Conman executará uma pesquisa semdistinção de maiúsculas/minúsculas para correspondência de



3.R

eferênciado

Conm

an

arquivos, ignorando os nomes de diretórios. As dependências detodos os arquivos correspondentes são liberadas.

Para dependênciasneeds, o job liberado recebe o número requeridode unidades do recurso, apesar de poderem não estar disponíveis.Isto pode fazer com que as unidadesDisponíveisem umshowresourcesexibam um número negativo.

ExemplosO exemplo a seguir libera ojob3 no fluxo de jobap de todas suasdependências:release job=ap.job3

O exemplo a seguir libera ojob2 no fluxo de jobskedr de todassuas dependênciasopens:rj skedr.job2;opens

O exemplo a seguir libera todos os jobs na estação de trabalhosite4de suas dependências em um prompt chamadoglprmt :rj site4#@.@;prompt=glprmt


168 Versão 7.0

release schedLibera fluxos de job das dependências.

Você deve ter acessoreleaseao fluxo de job.

Sinopsers jstreamselect[;dependency[;...]][;noask]


Consulte“Como Selecionar Fluxos de Job em Comandos”na página 118.

dependencyO tipo de dependência. Especifique uma das seguintes. Vocêpode utilizar caracteres curinga emwkstation, jstream, job,resource, filenamee promptname.

at

carryforward


limit



priority


until


Notas de UtilizaçãoAo excluir uma dependênciaopens, você pode incluir apenas onome de arquivo (nome base) e o Conman executará uma pesquisasem distinção de maiúsculas/minúsculas para correspondência de



3.R

eferênciado

Conm

an

arquivos, ignorando os nomes de diretórios. As dependências detodos os arquivos correspondentes são liberadas.

Para dependênciasneeds, o fluxo de job liberado recebe o númerorequerido de unidades do recurso, apesar de poderem não estardisponíveis. Isso pode fazer com que as unidades Disponíveis em umshowresourcesexibam um número negativo.

ExemplosO exemplo a seguir libera o fluxo de jobap de todas suasdependências:release sched=ap

O exemplo a seguir libera o fluxo de jobsked5de todas suasdependênciasopens:rs sked5;opens

O exemplo a seguir libera todos os fluxos de job na estação detrabalhosite3 de suas dependências em um fluxo de jobmain#sked23:rs site3#@;follows=main#sked23


170 Versão 7.0

replyResponde a um prompt de job ou fluxo de job.

Você deve ter acessoreply ao prompt nomeado ou global. Pararesponder a um prompt não-nomeado, você deve ter acessoreplyaos prompts e acessoreply ao job ou fluxo de job associado.

Sinopsereply{ promptname| [wkstation#]msgnum} ;reply[;noask]

Argumentospromptname Especifica o nome de um prompt global. Caracteres

curinga são permitidos.

wkstation Especifica o nome da estação de trabalho na qual umprompt não-nomeado foi emitido.

msgnum Especifica o número de mensagem de um promptnão-nomeado. Você pode exibir números demensagens com os comandosrecall e showprompts.

reply Especifica a resposta,Y para sim ouN para não.

noask Especifica para não solicitar confirmação antes datomada de ação em cada prompt qualificado.

Notas de UtilizaçãoSe a resposta forY, as dependências no prompt serão satisfeitas. Sea resposta forN, as dependências não serão satisfeitas e o promptnão será emitido novamente.

Os prompts podem ser respondidos antes de serem emitidos. Vocêpode utilizar o comandoshowprompts para exibir todos os prompts,se tiverem ou não sido emitidos.

ExemplosO exemplo a seguir respondeY ao prompt globalarprmt :reply arprmt;y

O exemplo a seguir respondeN ao número de mensagem24 naestação de trabalhosite4:



3.R

eferênciado

Conm

an

rep site4#24;n


172 Versão 7.0

rerunReexecuta um job.

Você deve ter acessorerun ao job.

Sinopserr jobselect[;from= [wkstat#]job[;at=time][ ;pri= pri]][ ;noask]

rr jobselect[;step=step][ ;noask]

Argumentosjobselect

Especifica o nome do prompt global. Caracteres curinga sãopermitidos.

from=[ wkstat#]jobEspecifica o nome de um job definido no banco de dados doWorkload Scheduler cujo arquivo de job ou comando seráexecutado no lugar do job especificado porjobselect.

wkstat#Especifica o nome da estação de trabalho na qual ojob from é executado. O padrão é a estação detrabalho na qual o Conman está sendo executado.

job Especifica o nome da definição de jobfrom . Osseguintes tipos de nomes de job não são permitidos:¶ Os nomes de jobs submetidos com o uso dos

comandossubmit file e submit docommand.¶ Os nomes alias de jobs submetidos com o uso do

comandosubmit job.

Para utilizar o argumentofrom , você deve ter acesso aobanco de dados do Workload Scheduler a partir docomputador no qual o Conman está sendo executado

at=timeEspecifica a hora de início do job de reexecução, expressacomo a seguir:

hhmm [timezone|tztzname][+n days | date]



3.R

eferênciado

Conm

an

onde:


+n daysA próxima ocorrência dehhmmem n número dedias.

+date A próxima ocorrência dehhmmem date, expressacomomm/dd/yy.

timezone|tztznameO nome do fuso horário do job. Consulte “Nomesdos Fusos Horários” na página 319 para obter osnomes válidos.

pri= priEspecifica a prioridade a ser atribuída ao job de reexecução.Se você não especificar uma prioridade, o job receberá amesma prioridade do job original.

step=stepEspecifica que o job é reexecutado utilizando esse nome nolugar do nome de job original. Consulte “Notas deUtilização” para obter mais informações.


Notas de UtilizaçãoVocê pode reexecutar jobs que estão no estadosucc, fail ou abend.Um job de reexecução é colocado no mesmo fluxo de job do joboriginal e herda as dependências do job original. Se você reexecutarum job repetitivo (every), o job de reexecução será planejado paraser executado com a mesma taxa do job original.

Nota: Você pode emitir o comandorerun para jobs no fluxo de jobexternal que estejam no estadoerror . Os jobs do fluxo dejob external representam jobs e fluxos de job que foramespecificados como dependências entre redes. O estado do jobé definido inicialmente comoextrn imediatamente após umcomandorerun ser executado, e o Conman começa averificar o estado.


174 Versão 7.0

Quando;from é utilizado, o nome do job de reexecução depende dovalor da Opção Globalreter nomes de jobs de reexecução. Se aopção for definida comoY, os jobs de reexecução reterão os nomesde job originais. Se a opção for definida comoN, os jobs dereexecução receberão os nomes de jobfrom . Consulte “OpçõesGlobais” no capítulo 2 doTivoli Workload Scheduler - Guia doUsuário para obter mais informações.

Em telas do Conman, os jobs de reexecução são exibidos com anotação>>rerun as. Para referir-se a um job de reexecução emoutro comando, tal comoaltpri , você deve utilizar o nome de joboriginal.

Quando um job é reexecutado com a opção;step, stepé utilizado nolugar de seu nome original. Em um script de job, você pode utilizaro comandojobinfo para retornar o nome do job e executar o scriptde forma diferente para cada iteração. Por exemplo, no script UNIXa seguir, o comandojobinfo é utilizado para definir uma variávelchamadaSTEP com o nome utilizado para executar o job. AvariávelSTEP é utilizada em seguida para determinar como o scriptserá executado....MPATH=vmaestrovSTEP=v$MPATH/bin/jobinfo job_namevif [$STEP = JOB3]then...STEP=JSTEP1fi

if [$STEP = JSTEP1]then...STEP=JSTEP2fi

if [$STEP = JSTEP2]then...fi

...

Em telas do Conman, os jobs reexecutados com a opção;step sãoexibidos com a notação>>rerun step.



3.R

eferênciado

Conm

an

Para obter informações sobrejobinfo , consulte “Comando jobinfo”na página 260.

ExemplosO exemplo a seguir reexecuta ojob4 em sked1na estação detrabalhomain:rerun main#sked1.job4

O exemplo a seguir reexecuta ojob5 em sked2utilizando adefinição de job parajobx. A horaat do job é definida como 18:30he sua prioridade é definida como25:rr sked2.job5;from=jobx;at=1830;pri=25

O exemplo a seguir reexecuta ojob3 em sked4utilizando o nomede job jstep2:rr sked4.job3;step=jstep2


176 Versão 7.0

resourceAltera o número de unidades totais de um recurso.

Você deve ter acessoresourceao recurso.

Sinopseresource [wkstation#]resource;num[;noask]


recurso foi definido. O padrão é a estação detrabalho na qual o Conman está sendo executado.

resource Especifica o nome do recurso.

num Especifica o número total de unidades de recurso. Osvalores válidos são0 a 1024.

noask Especifica para não solicitar confirmação antes datomada de ação em cada recurso qualificado.

ExemplosO exemplo a seguir altera o número de unidades do recursotapespara5:resource tapes;5

O exemplo a seguir altera o número de unidades do recursojobslotsna estação de trabalhosite2 para23:res site2#jobslots;23



3.R

eferênciado

Conm

an

setsymSeleciona um arquivo archive do plano de produção. Comandos deexibição subseqüentes exibem o conteúdo do plano de produçãoarquivado. Você não pode modificar as informações de um arquivoarchive do plano de produção.

Sinopsesetsym[filenum]

Argumentosfilenum Especifica o número do arquivo archive do plano de

produção. Se você não especificar um número dearquivo de log, o ponteiro retornará para zero, oplano de produção atual (Symphony). Utilize ocomandolistsym para listar números do arquivoarchive.

ExemplosO exemplo a seguir seleciona o arquivo archive do plano deprodução5:setsym 5

O exemplo a seguir seleciona o plano de produção atual(Symphony):set


178 Versão 7.0

showcpusExibe informações sobre estações de trabalho e links.

Sinopsesc [[domain!]wkstation][ ;info ][ ;link ][ ;offline ]

Argumentosdomain Especifica o nome de um domínio. O padrão é o

domínio dewkstation. Sewkstationincluir caracterescuringa, o padrão será o domínio em que o Conmanestá sendo executado. Caracteres curinga sãopermitidos.

wkstation Especifica o nome de uma estação de trabalho. Opadrão é a estação de trabalho na qual o Conmanestá sendo executado. Caracteres curinga sãopermitidos.

info Exibe informações no formatoinfo.

link Exibe informações no formatolink .


Saída de ComandoA saída do comando é produzida em três formatos: padrão,info elink .

Formato Padrão:

CPUIDO nome da estação de trabalho na qual essa informação seaplica.

RUN O número de execução do arquivo de Controle de Produção(Symphony).

NODEO tipo de nó e o tipo de estação de trabalho. Os tipos de nós sãoos seguintes:



3.R

eferênciado

Conm

an

¶ UNIX¶ WINT¶ MPEV¶ MPIX¶ OTHER

Os tipos de estação de trabalho são os seguintes:¶ MASTER¶ MANAGER¶ FTA¶ S-AGENT¶ X-AGENT

LIMITO limite de job do Workload Scheduler.

FENCEO limitador de job do Workload Scheduler.

DATE TIMEA data e hora em que o Workload Scheduler começou a executaro plano de produção atual (Symphony).

STATEO estado dos links da estação de trabalho. São exibidos até cincocaracteres, como a seguir:[L] [D|T|H|X] [I] [J] [W|M|H|X]L O link está aberto (ligado).D O link é DS. Apenas para MPEV e MPIX.T O link é TCP/IP.I O programajobman concluiu a inicialização.J O programajobman está sendo executado.W A estação de trabalho está ligada por TCP/IP.M A estação de trabalho está ligada por DS. Apenas para

MPEV e MPIX.X A estação de trabalho está ligada como um agente

estendido (x-agent).H A estação de trabalho está ligada através de seu host.

Nota: Se a estação de trabalho que está executando o Conmanfor o host do agente estendido, o estado do x-agent será


180 Versão 7.0

LXI JX

Se a estação de trabalho que está executando o Conmannão for o host do agente estendido, o estado do x-agentseráLHI JH

METHODO nome do método de acesso especificado na definição deestação de trabalho. Apenas para agentes estendidos.

DOMAINO nome do domínio do qual a estação de trabalho é um membro.

Formato info:


VERSIONA versão do programajobman do Workload Scheduler.

TIMEZONEO fuso horário da estação de trabalho. É o mesmo valor davariável de ambiente TZ. Para um agente estendido, esse é ofuso horário de seu host.

INFO A versão e modelo de hardware do Sistema Operacional. Paraagentes estendidos, nenhuma informação é listada.

Formato link


HOSTO nome da estação de trabalho atuando como o host para umagente padrão ou agente estendido. Para os gerenciadores dedomínio e agentes de tolerância a falhas, é o mesmo de CPUID.



3.R

eferênciado

Conm

an

Para as estações de trabalho do agente padrão, é o nome dogerenciador de domínio. Para agentes estendidos, é o nome doestação de trabalho host.

FLAGSO estado dos links da estação de trabalho. São exibidos até cincocaracteres, como a seguir:[A] [F] [s] [D|T|B]A O link automático está ativado na definição de estação

de trabalho.F O modo Status Completo está ativado na definição de

estação de trabalho.s O ID do servidormailman da estação de trabalho.D O link está definido como DS. Apenas para MPEV e

MPIX.T O link está definido como TCP/IP.B O link está definido como DS e como TCP/IP. Apenas

para MPEV e MPIX.

ADDRO número da porta TCP da estação de trabalho.

NODEO nome do nó da estação de trabalho.

ExemplosO exemplo a seguir exibe informações sobre a estação de trabalho naqual o Conman está sendo executado no formatoinfo:showcpus ;info

O exemplo a seguir exibe informações de ligação offline para todasas estações de trabalho:sc @!@;link;off


182 Versão 7.0

showdomainExibe informações sobre o domínio.

Sinopseshowdomain [domain][ ;info ][ ;offline ]

Argumentosdomain Especifica o nome do domínio. O padrão é o

domínio onde o Conman está sendo executado.Caracteres curinga são permitidos.



Saída de ComandoA saída do comando é produzida em dois formatos: padrão einfo.

Formato Padrão:

DOMAINO nome do domínio no qual essa informação se aplica.

MANAGERO nome do gerenciador de domínio.

PARENTO nome do domínio pai.

Formato info:

DOMAINO nome do domínio no qual essa informação se aplica.

MEMBER-CPUSOs nomes das estações de trabalho do domínio.

CPU-TYPEO tipo de cada estação de trabalho: MASTER, MANAGER,FTA, S-AGENT ou X-AGENT.



3.R

eferênciado

Conm

an

ExemplosO exemplo a seguir exibe informações sobre o domíniomasterdm:showdomain masterdm

O exemplo a seguir exibe as estações de trabalho membros em todosos domínios no formatoinfo:showdomain @;info


184 Versão 7.0

showfilesExibe informações sobre dependências de arquivos.

Sinopsesf [[wkstation#]file][ ;state[;...]][;keys][ ;offline ]

sf [[wkstation#]file][ ;state[;...]][;deps[;keys | info | logon]][ ;offline ]


arquivo existe. O padrão é a estação de trabalho naqual o Conman está sendo executado. Caracterescuringa são permitidos.

file Especifica o nome do arquivo. O nome deverá sercolocado entre aspas (″) se contiver caracteresdiferentes dos seguintes: alfanuméricos, traços (-),barras (/), barras invertidas (\) e sublinhados (_). Opadrão é exibir todas as dependências de arquivos.Caracteres curinga são permitidos.

state Especifica o estado das dependências de arquivos aserem exibidas. O padrão é exibir dependências dearquivos em todos os estados. Os estados são osseguintes:

yes O arquivo existe e está disponível.

no O arquivo não está disponível ou não existe.

? A disponibilidade está sendo verificada.

<blank>O arquivo ainda não foi verificado ou estavadisponível e sendo utilizado para satisfazeruma dependência de job ou de fluxo de job.

keys Exibe uma única coluna de lista dos objetosselecionados pelo comando.

deps Exibe informações no formatodeps. Utilize keys,info ou logon para modificar a exibição.



3.R

eferênciado

Conm

an


Saída de ComandoA saída do comando é produzida em três formatos: padrão,keys edeps. Os argumentoskeys, info e logon modificam a exibição dedeps.

Formato Padrão:

Existe O estado da dependência de arquivo.

Nome do ArquivoO nome do arquivo.

Formato keysOs arquivos são listados um em cada linha. Os nomes dos diretóriosnão são incluídos. Cada arquivo é listado no seguinte formato:

wkstation#file

Formato depsOs arquivos são listados seguidos dos jobs e fluxos de jobdependentes. Os jobs são listados no formatoshowjobs.Os fluxosde job são listados no formatoshowschedulespadrão.

Formato deps;keysOs jobs e fluxos de job que possuem dependências de arquivos sãolistados, um em cada linha, no seguinte formato:

wkstation#jstream[.job]

Formato deps;infoOs arquivos são listados seguidos dos jobs e fluxos de jobdependentes. Os jobs são listados no formatoshowjobs;info. Osfluxos de job são listados no formatoshowschedulespadrão.


186 Versão 7.0

Formato deps;logonOs arquivos são listados seguidos dos jobs e fluxos de jobdependentes. Os jobs são listados no formatoshowjobs;logon. Osfluxos de job são listados no formatoshowschedulespadrão.

ExemplosO exemplo a seguir exibe o status de uma dependência de arquivode d:\apps\mis\lib\data4:showfiles d:\apps\mis\lib\data4

O exemplo a seguir exibeoffline o status de todas as dependênciasde arquivos em todas as estações de trabalho no formatodeps:sf @#@;deps;offline



3.R

eferênciado

Conm

an

showjobsExibe informações sobre jobs.

Sinopsesj[jobselect] [ ;keys | info | step | logon][ ;short | single][ ;offline ]

sj[jobselect] [ ;deps[;keys | info | logon]][ ;short | single][ ;offline ]

sj[jobselect] [ ;stdlist[;keys]][ ;short | single][ ;offline ]


página 108.



step Exibe informações no formatostep.

logon Exibe informações no formatologon.

stdlist Exibe informações no formatostdlist. Utilize oargumentokeys para modificar a exibição.


short Reduz a exibição dos jobsevery e dererun paraincluir apenas o seguinte:¶ A primeira iteração¶ Jobs em estados diferentes¶ Jobs exatamente correspondidos

single Seleciona apenas o job pai em uma cadeia que podeincluir jobs de reexecução, de repetição e derecuperação. O job deve ser identificado pelonúmero de job emjobselect. Isso é especialmenteútil com a opçãostdlist.

offline Envia a saída do comando para o dispositivo de


188 Versão 7.0

saída do Conman. Para obter informações sobre essedispositivo, consulte “Saída Offline” na página 101.

Saída de ComandoA saída do comandoshowjobsé produzida em sete formatos:padrão,keys, info, step, logon, depse stdlist. Os argumentoskeys,info e logon modificam as exibições.

Formato Padrão:

CPU A estação de trabalho em que o job é executado.


Job O nome do job. A seguinte notação pode preceder um nome dejob:

>> rerun asUm job que foi reexecutado com o comandorerun , oucomo resultado de recuperação automática.

>> rerun stepUm job que foi reexecutado com o comandorerun;step.

>> every runA segunda e subseqüentes execuções de um job every.

>> recoveryA execução de um job de recuperação.

EstadoO estado do job ou fluxo de job. Os estados do job são osseguintes:

abend O job terminou com um código de saída diferente dezero.

abenp Uma confirmação deabend foi recebida, mas o job nãoestá concluído.

add O job está sendo submetido.

done O job foi concluído em um estado desconhecido.



3.R

eferênciado

Conm

an

error Para dependências entre redes apenas, ocorreu um errodurante a verificação do status remoto.

exec O job está sendo executado.

extrn Para as dependências entre redes apenas, o status édesconhecido. Ocorreu um erro, uma ação reexecutaracabou de ser realizada no job do fluxo de jobexternal,ou o job remoto ou fluxo de job não existe.

fail Impossível lançar o job.

fence A prioridade do job está abaixo da grade.

hold O job está aguardando a resolução da dependência.

intro O job é apresentado para ser lançado pelo sistema.

pend O job foi concluído e está aguardando confirmação.

ready O job está pronto para ser lançado e todas asdependências foram resolvidas.

sched A hora at do job não chegou.

succ O job foi concluído com um código de saída zero.

succp Uma confirmaçãosucc foi recebida, mas o job não estáconcluído.

susp O job foi suspenso por um comandobreakjob. (ApenasMPE)

wait O job está no estado deespera. (Apenas agenteestendido e MPE)

waitd O job está no estado deesperae é adiado. (ApenasMPE)

Os estados dos fluxos de job são os seguintes:

abend O fluxo de job terminou com um código de saídadiferente de zero.

add O fluxo de job foi adicionado com intervenção dooperador.

cancel O fluxo de job foi cancelado.


190 Versão 7.0

cancel pendO cancelamento do fluxo de job está pendente. Ocancelamento será adiado até que todas as dependências,incluindo uma hora at, sejam resolvidas.



extrn Apenas para dependências entre redes, o fluxo de jobencontra-se em uma rede TWS remota e seu status édesconhecido. Ocorreu um erro, uma ação Reexecutaracaba de ser realizada no fluxo de job EXTERNAL ou ojob INET ou o fluxo de job não existe.

hold O fluxo de job está aguardando a resolução dedependências.

ready O fluxo de job está pronto para ser lançado e todas asdependências foram resolvidas.

stuck A execução do fluxo de job foi interrompida. Nenhumjob é lançado sem a intervenção do operador.


Pr A prioridade do fluxo de job ou job. Um sinal de mais (+) antesda prioridade significa que o job foi lançado.

(Est)StartA hora de início do fluxo de job ou job. Parênteses indicam umaestimativa da hora de início. Se a hora de início ultrapassar 24horas anteriores ou posteriores, a data será listada no lugar dahora.

(Est)ElapseO tempo de execução do fluxo de job ou job. Parênteses indicamuma estimativa com base em estatísticas registradas.

dependênciasUma lista de dependências de job e comentários. Qualquercombinação das seguintes pode ser listada:



3.R

eferênciado

Conm

an

¶ Para uma dependênciafollows, é exibido um nome de fluxode job ou de job.

¶ Para uma dependênciaopens, é exibido o nome do arquivo.Se o arquivo residir em um agente estendido e seu nometiver mais que 25 caracteres, apenas os últimos 25 serãoexibidos.

¶ Para uma dependêncianeeds, é exibido um nome de recursocolocado entre hífens (-). Se o número de unidadessolicitadas for maior que um, o número será exibido antesdo primeiro hífen.

¶ Para uma taxaevery, é exibida a taxa de repetiçãoantecedida de um e comercial (&).

¶ Para uma horauntil , é exibida a hora antecedida por umsinal de menor (<).

¶ Para uma dependênciaprompt , o número do prompt éexibido no formato #num. Para prompts globais, o nome doprompt segue entre parênteses.

¶ Para a execução de jobs, o número de identificação doprocesso (PID) é exibido no formato#Jnnnnn.

¶ Jobs submetidos ao UNIX através dos comandosat e batchdo Workload Scheduler são rotulados como[Userjcl] .

¶ Jobs cancelados são rotulados como[Cancelled].

¶ Jobs cancelados com a opção;pend são rotulados como[Cancel Pend].

¶ Jobs com horasuntil expiradas, incluindo jobs canceladoscom a opção;pend são rotulados como[Until] .

¶ [Recovery] significa que a operação requer intervenção.

¶ [Confirm] significa que é necessária confirmação porque ojob foi planejado com o uso da palavra-chaveconfirm .


192 Versão 7.0

Formato keys:Os nomes de job são listados um em cada linha no seguinte formato:

wkstation#jstream.job

Formato info:





>> rerun stepUm job que foi reexecutado com o comandorerun;step.

>> every runA segunda e subseqüentes execuções de um job every.

>> recoveryA execução de um job de recuperação.

Arquivo do JobO nome do script ou arquivo executável do job. Nomes longosde arquivos podem causar reinício cíclico, causando paginaçãoincorreta. Para evitar isso, direcione a saída paramore. Porexemplo:conman “sj;info | more

Opt A opção de recuperação do job, se houver. As opções derecuperação sãoRE para reexecução,CO para continuar eSTpara parar.

Job O nome do job de recuperação, se houver.

PromptO número do prompt de recuperação, se houver.



3.R

eferênciado

Conm

an

Formato stepEsse formato não é suportado no Windows NT.



Job O nome do job. A seguinte notação pode preceder um nomede job:

>> rerun asUm job que foi reexecutado com o comandorerun ,ou como resultado de recuperação automática.

>> repeated asA segunda e subseqüentes execuções de um jobevery.

EstadoO estado do job ou fluxo de job. Consulte “Formato Padrão”para obter informações sobre estado.

Job# O número de identificação do processo exibido como#Jnnnnn.

Etapa Uma lista de processos descendentes associados ao job. Parajobs do agente estendido, são listados apenas os processos dohost.

Formato logon





>> repeated asA segunda e subseqüentes execuções de um jobevery.


194 Versão 7.0

EstadoO estado do job ou fluxo de job. Consulte “Formato Padrão”para obter informações sobre estado.

Job# O número de identificação do processo exibido como#Jnnnnn.

Início de SessãoO nome de usuário sob o qual o job é executado.

Formato stdlistSão exibidos os arquivos de lista padrão dos jobs selecionados.

Formato stdlist;keysOs nomes dos arquivos de lista padrão dos jobs selecionados sãolistados, um em cada linha.

Formato depsJobs utilizados em dependênciasfollows são listados, seguidos pelosjobs e fluxos de job dependentes. Os jobs são listados no formatoshowjobs.Os fluxos de job são listados no formatoshowschedulespadrão.

Formato deps;keysOs jobs e fluxos de job que possuem dependênciasfollows sãolistados, um em cada linha.

Formato deps;infoOs jobs utilizados em dependênciasfollows são listados, seguidospelos jobs e fluxos de job dependentes. Os jobs são listados noformatoshowjobs;info. Os fluxos de job são listados no formatoshowschedulespadrão.

Formato deps;logonOs jobs utilizados em dependênciasfollows são listados, seguidospelos jobs e fluxos de job dependentes. Os jobs são listados noformatoshowjobs;logon. Os fluxos de job são listados no formatoshowschedulespadrão.



3.R

eferênciado

Conm

an

ExemplosO exemplo a seguir exibe o status de todos os jobs em todos osfluxos de jobacctg na estação de trabalhosite3:showjobs site3#acctg@.@

O exemplo a seguir exibe o status de todos os jobs na estação detrabalho na qual o Conman está sendo executado no formatologon:sj ;logon

O exemplo a seguir exibe o status de todos os jobs no estadoholdem todas as estações de trabalho no formatodeps:sj @#@.@+state=hold;deps

O exemplo a seguir exibe todos os arquivos de lista padrão do jobglno fluxo de jobarec na estação de trabalhosite2:sj site2#arec.gl;stdlist


196 Versão 7.0

showpromptsExibe informações sobre prompts.

Sinopsesp[promptselect][ ;keys][ ;offline ]

sp[promptselect] [ ;deps[;keys | info | logon]][ ;offline ]

Argumentospromptselect

[promptname| [wkstation#]msgnum][ ;state[;...]]


wkstationEspecifica o nome da estação de trabalho na qual umprompt não-nomeado foi emitido. O padrão é aestação de trabalho na qual o Conman está sendoexecutado.

msgnumEspecifica o número de mensagem de um promptnão-nomeado.

state Especifica o estado dos prompts a serem exibidas.Os estados são os seguintes:

YES O prompt recebeu a respostay.

NO O prompt recebeu a respostan.

ASKEDO prompt foi emitido, mas não recebeuresposta.

INACTO prompt não foi emitido.

keys Exibe uma única coluna de lista dos objetos selecionadospelo comando.



3.R

eferênciado

Conm

an

deps Exibe informações no formatodeps. Utilize keys, info oulogon para modificar a exibição.



offline Envia a saída do comando para o dispositivo de saída doConman. Para obter informações sobre esse dispositivo,consulte “Saída Offline” na página 101.


Formato Padrão

EstadoO estado do prompt.

Mensagem ou PromptPara prompts nomeados, o número da mensagem, o nome e otexto do prompt. Para prompts não-nomeados, o número damensagem, o nome do job ou fluxo de job e o texto do prompt.

Formato keysOs prompts são listados um em cada linha. Prompts nomeados sãolistados com seus nomes e números de mensagens. Promptsnão-nomeados são listados com seus números de mensagens e osnomes dos jobs ou fluxos de job nos quais aparecem comodependências.

Formato depsOs prompts utilizados como dependências são listados, seguidospelos jobs e fluxos de job dependentes. Os jobs são listados noformatoshowjobs.Os fluxos de job são listados no formatoshowschedulespadrão.

Formato deps;keysOs jobs e fluxos de job que possuem dependências de prompt sãolistados, um em cada linha.


198 Versão 7.0

Formato deps;infoOs prompts utilizados como dependências são listados, seguidospelos jobs e fluxos de job dependentes. Os jobs são listados noformatoshowjobs;info. Os fluxos de job são listados no formatoshowschedulespadrão.

Formato deps;logonOs prompts utilizados como dependências são listados, seguidospelos jobs e fluxos de job dependentes. Os jobs são listados noformatoshowjobs;logon. Os fluxos de job são listados no formatoshowschedulespadrão.

ExemplosO exemplo a seguir exibe o status de todos os prompts emitidos naestação de trabalho na qual o Conman está sendo executado:showprompts

O exemplo a seguir exibe, no formatodeps, o status de todos ospromptsmis que foram emitidos:sp mis@;asked;deps

O exemplo a seguir exibe o status do prompt número 34 na estaçãode trabalhomain:sp main#34



3.R

eferênciado

Conm

an

showresourcesExibe informações sobre recursos.

Sinopsesr[[wkstation#]resourcename][ ;keys][ ;offline ]

sr[[wkstation#]resourcename][ ;deps[;keys | info | logon]][ ;offline ]


recurso foi definido. O padrão é a estação detrabalho na qual o Conman está sendo executado.

resourcename Especifica o nome do recurso. Caracteres curinga sãopermitidos.







Formato Padrão:

CPU A estação de trabalho na qual o recurso foi definido.

Recurso O nome do recurso.

Total O número total de unidades de recurso definidas.


200 Versão 7.0

Disponível O número de unidades de recurso que não foramalocadas.

Qty O número de unidades de recurso alocadas a um job oufluxo de job.

Used By O nome do job ou fluxo de job.

Formato keysOs recursos são listados um em cada linha.

Formato depsOs recursos utilizados como dependências são listados, seguidospelos jobs e fluxos de job dependentes. Os jobs são listados noformatoshowjobs.Os fluxos de job são listados no formatoshowschedulespadrão.

Formato deps;keysOs jobs e fluxos de job que possuem dependências de recurso sãolistados, um em cada linha.

Formato deps;infoOs recursos utilizados como dependências são listados, seguidospelos jobs e fluxos de job dependentes. Os jobs são listados noformatoshowjobs;info. Os fluxos de job são listados no formatoshowschedulespadrão.

Formato deps;logonOs recursos utilizados como dependências são listados, seguidospelos jobs e fluxos de job dependentes. Os jobs são listados noformatoshowjobs;logon. Os fluxos de job são listados no formatoshowschedulespadrão.

ExemplosO exemplo a seguir exibe informações sobre todos os recursos naestação de trabalho na qual o Conman está sendo executado:showresources

O exemplo a seguir exibe informações sobre o recursodbasenaestação de trabalhomain no formatodeps:



3.R

eferênciado

Conm

an

sr main#dbase;deps


202 Versão 7.0

showschedulesExibe informações sobre fluxos de job.

Sinopsess[jstreamselect][ ;keys][ ;offline ]

ss[jstreamselect][ ;deps[;keys | info | logon]][ ;offline ]

Argumentosjstreamselect Consulte “Como Selecionar Fluxos de Job em








Formato Padrão:

CPU A estação de trabalho na qual o fluxo de job é executado.


EstadoO estado do fluxo de job. Os estados são os seguintes:

add O fluxo de job foi adicionado com intervenção dooperador.



3.R

eferênciado

Conm

an

abend O fluxo de job terminou com um código de saídadiferente de zero.

cancel O fluxo de job foi cancelado.

cancel pendO cancelamento do fluxo de job está pendente. Ocancelamento será adiado até que todas as dependências,incluindo uma hora at, sejam resolvidas.



extrn Apenas para dependências entre redes, o fluxo de jobencontra-se em uma rede TWS remota e seu status édesconhecido. Ocorreu um erro, uma ação Reexecutaracaba de ser realizada no fluxo de job EXTERNAL ou ojob INET ou o fluxo de job não existe.

hold O fluxo de job está aguardando a resolução dadependência.

ready O fluxo de job está pronto para ser lançado e todas asdependências foram resolvidas.

stuck A execução do fluxo de job foi interrompida. Nenhumjob é lançado sem a intervenção do operador.


Pr A prioridade do fluxo de job.

(Est)StartA hora de início do fluxo de job. Parênteses indicam umaestimativa da hora de início. Se a hora de início ultrapassar 24horas anteriores ou posteriores, a data será listada no lugar dahora.

(Est)ElapseO tempo de execução do fluxo de job. Parênteses indicam umaestimativa com base em estatísticas registradas.

Jobs #O número de jobs do fluxo de job.


204 Versão 7.0

Jobs OKO número de jobs que foram concluídos com êxito.

Sch LimO limite de job do fluxo de job. Se não houver um listado, olimite não estará em vigor.

dependênciasUma lista de dependências de fluxo de job e comentários.Qualquer combinação das seguintes pode ser listada:

¶ Para uma dependênciafollows, é exibido um nome de fluxode job ou de job.

¶ Para uma dependênciaopens, é exibido o nome do arquivo.Se o arquivo residir em um agente estendido e seu nometiver mais que 25 caracteres, apenas os últimos 25 serãoexibidos.

¶ Para uma dependêncianeeds, é exibido um nome de recursocolocado entre hífens (-). Se o número de unidadessolicitadas for maior que um, o número será exibido antesdo primeiro hífen.

¶ Para uma horauntil , a hora antecedida por um sinal demenor (<).

¶ Para uma dependênciaprompt , o número do prompt exibidocomo #num. Para prompts globais, o nome do prompt segueentre parênteses.

¶ Fluxos de job cancelados são rotulados como[Cancelled].

¶ Fluxos de job cancelados com a opção;pend são rotuladoscomo [Cancel Pend].

¶ Fluxos de job com horasuntil expiradas, incluindo fluxos dejob cancelados com a opção;pend, são rotulados como:[Until] .

¶ Fluxos de job que contêm a palavra-chavecarryforward sãorotulados como[Carry] .

¶ Para fluxos de job que foram transportados do dia anterior, onome e data originais são exibidos entre colchetes.



3.R

eferênciado

Conm

an

Formato keysOs fluxos de job são listados um em cada linha.

Formato depsOs fluxos de job utilizados como dependências são listados, seguidospelos jobs e fluxos de job dependentes. Os jobs são listados noformatoshowjobs.Os fluxos de job são listados no formatoshowschedulespadrão.

Formato deps;keysOs fluxos de job que possuem dependênciasfollows são listados, umem cada linha.

Formato deps;infoOs fluxos de job utilizados como dependências são listados, seguidospelos jobs e fluxos de job dependentes. Os jobs são listados noformatoshowjobs;info. Os fluxos de job são listados no formatoshowschedulespadrão.

Formato deps;logonOs fluxos de job utilizados como dependências são listados, seguidospelos jobs e fluxos de job dependentes. Os jobs são listados noformatoshowjobs;logon. Os fluxos de job são listados no formatoshowschedulespadrão.

ExemplosO exemplo a seguir exibe o status de todos os fluxos de job noestadohold na estação de trabalho na qual o Conman está sendoexecutado:showschedules @+state=hold

O exemplo a seguir exibe o status de todos os fluxos de jobcorp naestação de trabalhosite2 no formatodeps;info:ss site2#corp@;deps;info

O exemplo a seguir exibeoffline o status de todos os fluxos de jobno estadoabend em todas as estações de trabalho:ss @#@+state=abend;off


206 Versão 7.0

shutdownPára, incondicionalmente, todos os processos de produção doWorkload Scheduler, incluindo Batchman, Jobman, Netman,Mailman, todos os servidores Mailman e todos os transcritores.

Você deve ter acessoshutdown à estação de trabalho.

Sinopseshutdown [;wait ]

Argumentoswait Aguarda até que todos os processos tenham parado

antes de solicitar outro comando.

Notas de UtilizaçãoO comandoshutdown pára os processos somente na estação detrabalho em que o Conman está sendo executado. Para reiniciarapenas o Netman, execute o comandoStartUp. Para obterinformações sobre o comandoStartUp, consulte “Comando StartUp”na página 281. Para reiniciar a árvore de processo completa, executeum comandostart do Conman.

Você deve executar um comandounlink @ do Conman antes deexecutar um comandoshutdown.

ExemplosO exemplo a seguir encerra a produção na estação de trabalho naqual o Conman está sendo executado:unlink @shutdown

O exemplo a seguir encerra a produção na estação de trabalho naqual o Conman está sendo executado e aguarda que todos osprocessos parem:unlink@;noaskshut ;wait



3.R

eferênciado

Conm

an

startInicia os processos de produção do Workload Scheduler.

Você deve ter acessostart para a estação de trabalho.

Sinopsestart[domain!]wkstation[;mgr ][ ;noask]

Argumentosdomain Especifica o nome do domínio no qual as estações

de trabalho foram iniciadas. Como as estações detrabalho possuem nomes exclusivos, o domínio não énecessário quando uma determinada estação detrabalho está sendo iniciada. Caracteres curinga sãopermitidos.

Este argumento é útil quando se está iniciando maisde uma estação de trabalho em um domínio. Porexemplo, para iniciar todos os agentes no domíniostlouis, utilize o seguinte comando:start stlouis!@

Sedomainfor omitido ewkstationcontivercaracteres curinga, o domínio padrão será aquele noqual o Conman está sendo executado.

wkstation Especifica o nome da estação de trabalho a seriniciada. Caracteres curinga são permitidos.

mgr Pode ser digitado apenas na estação de trabalho naqual o Conman está sendo executado. Ele inicia aestação de trabalho local como o gerenciador dedomínio. A estação de trabalho se torna o novogerenciador de domínio e o gerenciador de domínioatual se torna um agente de tolerância a falhas. Essaforma do comando segue, geralmente, um comandostop. Observe que o método preferido de se alternarum gerenciador de domínio é utilizar um comandoswitchmgr. Consulte “switchmgr” na página 229para obter mais informações.


208 Versão 7.0


Notas de UtilizaçãoO comandostart é utilizado no início de cada dia para reiniciar oWorkload Scheduler depois do processamento de pré-produção.Nesta hora, faz com que os agentes de tolerância a falhas e padrãoligados automaticamente sejam inicializados e iniciadosautomaticamente. Os agentes que não são ligados automaticamentesão inicializados e iniciados quando você executa um comandolink .

Supondo-se que um usuário tenha acessostart a estações de trabalhosendo iniciadas, as seguintes regras serão aplicadas:

¶ Um usuário executando o Conman no gerenciador de domíniomestre pode iniciar qualquer estação de trabalho na rede.

¶ Um usuário executando o Conman em um gerenciador dedomínio diferente do mestre pode iniciar qualquer estação detrabalho nesse domínio e em domínios subordinados. O usuárionão pode iniciar estações de trabalho em domínios ponto aponto.

¶ Um usuário executando o Conman em um agente pode iniciarqualquer estação de trabalho no domínio local.

ExemplosA ilustração e tabela abaixo mostram as estações de trabalhoiniciadas por comandosstart executados por usuários em váriaslocalizações na rede.



3.R

eferênciado

Conm

an


Comandos Iniciado peloUsuário1

Iniciado peloUsuário2


start @!@ Todas as estaçõesde trabalho sãoiniciadas.

DM2A21A22DM4A41A42

DM2A21A22

start @ DM1A11A12

DM2A21A22

DM2A21A22

start DOMAIN3!@ DM3A31A32


start DOMAIN4!@ DM4A41A42

DM4A41A42

Não permitido.

start DM2 DM2 DM2 DM2

start A42 A42 A42 Não permitido.


210 Versão 7.0

Comandos Iniciado peloUsuário1



start A31 A31 Não permitido. Não permitido.



3.R

eferênciado

Conm

an

statusExibe o banner do Conman e o status de produção do WorkloadScheduler.

Sinopsestatus

Saída de ComandoDepois da palavraSchedulena segunda linha de saída, o modo deplano de produção (Symphony) é mostrado entre parênteses.Defsignifica que o plano de produção está no modo não-expandido, eExp significa que está no modo expandido. O modo do plano deprodução é determinado pela definição da opção Globalversãoexpandida. Consulte Opções Globais no capítulo 2 doTivoliWorkload Scheduler - Guia do Administradorpara obter maisinformações.

ExemplosO exemplo a seguir exibe o status do plano de produção atual. Emseguida, ele define o indicador do plano de produção como 2 e exibeo status desse plano de produção.%statusMAESTRO for UNIX (HPUX)/CONMAN 6.0 (3.34) (C) Tivoli Systems 1998Schedule (Exp) 11/30/98 (#7) on DEMOCPU. Batchman down.Limit: 6, Fence: 0%setsym 2Schedule 11/29/98 (#5) on DEMOCPU. Symphony switched.(2)%statusMAESTRO for UNIX (HPUX)/CONMAN 6.0 (3.34) (C) Tivoli Systems 1998Schedule (Exp) 11/29/98 (#5) on DEMOCPU. Symphony switched.


212 Versão 7.0

stopPára os processos de produção do Workload Scheduler. Para parar oprocesso Netman, utilize o comandoshutdown

.

Você deve ter acessostop à estação de trabalho.

Sinopsestop[domain!]wkstation[;wait ][ ;noask]

Argumentosdomain Especifica o nome do domínio no qual as estações

de trabalho pararam. Como as estações de trabalhopossuem nomes exclusivos, o domínio não énecessário quando uma determinada estação detrabalho está sendo parada. Caracteres curinga sãopermitidos.

Este argumento é útil quando se está parando maisde uma estação de trabalho em um domínio. Porexemplo, para parar todos os agentes no domíniostlouis, utilize o seguinte comando:stop stlouis!@

Sedomainfor omitido ewkstationcontivercaracteres curinga, o domínio padrão será aquele noqual o Conman está sendo executado.

wkstation Especifica o nome da estação de trabalho a serparada. Caracteres curinga são permitidos.

wait Especifica para não aceitar outro comando até quetodos os processos tenham parado.




3.R

eferênciado

Conm

an

Notas de UtilizaçãoSe o comandostop não puder ser aplicado a uma estação de trabalhodistante (se o caminho TCP/IP não estiver disponível, por exemplo),o comando será armazenado localmente em uma estação de trabalhopobox, e será enviado para a estação de trabalho quando ela forligada.

Supondo-se que um usuário tenha acessostop a estações de trabalhosendo paradas, as seguintes regras serão aplicadas:

¶ Um usuário executando o Conman no gerenciador de domíniomestre pode parar qualquer estação de trabalho na rede.

¶ Um usuário executando o Conman em um gerenciador dedomínio diferente do mestre pode parar qualquer estação detrabalho nesse domínio e em domínios subordinados. O usuárionão pode parar estações de trabalho em domínios ponto a ponto.

¶ Um usuário executando o Conman em um agente pode pararqualquer estação de trabalho no domínio local.

ExemplosA ilustração e tabela abaixo mostram as estações de trabalho paradaspor comandosstop diferentes executados por usuários em váriaslocalizações na rede.


214 Versão 7.0


Comandos Parado pelo:Usuário1

Parado peloUsuário2


stop @!@ Todas as estaçõesde trabalho sãoparadas.

DM2A21A22DM4A41A42

DM2A21A22

stop @ DM1A11A12

DM2A21A22

DM2A21A22

stop DOMAIN3!@ DM3A31A32


stop DOMAIN4!@ DM4A41A42

DM4A41A42

Não permitido.

stop DM2 DM2 DM2 DM2

stop A42 A42 A42 Não permitido.



3.R

eferênciado

Conm

an

Comandos Parado pelo:Usuário1



stop A31 A31 Não permitido. Não permitido.


216 Versão 7.0

submit docommandSubmete um comando para ser lançado como um job do WorkloadScheduler.

Você deve ter acessosubmit ao job. Para incluir dependênciasneedse prompt , você deve ter acessouseaos recursos e prompts globais.

Sinopse

sbd [wkstation#]″cmd″[;alias[=name]][ ;into= jobstream][;joboption[;...]]

Argumentoswkstation

Especifica o nome da estação de trabalho na qual o job serálançado. Caracteres curinga são permitidos e, nesse caso, ojob é lançado em todas as estações de trabalho qualificadas.O padrão é a estação de trabalho na qual o Conman estásendo executado. Você não pode especificar um domínio ouclasse de estação de trabalho.

cmd Especifica um comando de sistema válido de até 255caracteres. Todo o comando deve ser colocado entre aspas(″). O comando será tratado como um job e todas as regrasde job serão aplicadas.

alias=nameEspecifica um nome exclusivo a ser atribuído ao job. Sevocê digitar a palavra-chavealias sem especificar um nome,um nome será construído utilizando os dois primeiroscaracteres alfanuméricos do comando seguido de um númeroaleatório de seis dígitos. O nome é sempre organizado emordem crescente. Por exemplo, se o comando forrm apfile ,o nome gerado será semelhante aRM123456.

Se você não incluir umalias, um nome de job seráconstruído utilizando os primeiros oito caracteresalfanuméricos do comando, em ordem crescente.



3.R

eferênciado

Conm

an

into=jobstreamEspecifica o nome do fluxo de job no qual o job serácolocado para lançamento. Digite o nome como a seguir:

[wkstation#]jstream.Se você não especificar umawkstation,o padrão será a estação de trabalho na qual o Conman estásendo executado. Seinto não for utilizado, o job seráadicionado a um fluxo de job chamadoJOBS.

joboptionEspecifique um dos seguintes:

at=hhmm[timezone|tztzname] [+n days | mm/dd/yy]

confirmed

every=rate


interactive

logon=user




recovery=stop | continue | rerun

recoveryjob | after=[wkstation#]job

recoveryprompt | abendprompt=″text″

until= hhmm[timezone|tztzname] [+n days | mm/dd/yy]

Notas de UtilizaçãoSe você não especificar umaestação de trabalhocom follows, needsou opens, o padrão será a estação de trabalho do job. Se o job forexecutado em um agente de tolerância a falhas e você quiser incluiruma dependênciaprompt ou um recoveryprompt, o diretório domozart (WShome/mozart) no gerenciador de domínio mestre deveráficar acessível, montado ou compartilhado.


218 Versão 7.0

ExemplosO exemplo a seguir submete um comandorm no fluxo de jobJOBScom uma dependênciafollows:submit docommand="rm apfile";follows sked3

O exemplo a seguir submete um comandosort com o aliassortit ecoloca o job no fluxo de jobreports com uma horaat de 17:30h:sbd "sort < file1 > file2";alias=sortit;into=reports;at=1730

O exemplo a seguir submete o comandochmod a todas as estaçõesde trabalho com nomes começando comsite:sbd site@#"chmod 444 file2";alias



3.R

eferênciado

Conm

an

submit fileSubmete um arquivo para ser lançado como um job do WorkloadScheduler.


Sinopsesbffilename[;alias[=name]][ ;into= jobstream][ ;joboption[;...]][;noask]

Argumentosfilename

Especifica o nome do arquivo, até 255 caracteres. Caracterescuringa são permitidos. O nome deverá ser colocado entreaspas (″) se contiver caracteres diferentes de caracteresalfanuméricos, traços (-), barras (/), barras invertidas (\) esublinhados (_).

alias=nameEspecifica um nome exclusivo a ser atribuído ao job. Sevocê digitar a palavra-chavealias sem especificar um nome,um nome será construído utilizando os dois primeiroscaracteres alfanuméricos do nome base do arquivo, seguidode um número aleatório de seis dígitos. O nome é sempreorganizado em ordem crescente. Por exemplo, se o nome doarquivo for jclttx5 , o nome gerado será semelhante aJC123456.

Se você não incluir umalias, um nome de job seráconstruído utilizando os primeiros oito caracteresalfanuméricos do nome base do arquivo, em ordemcrescente.

Em qualquer um dos casos acima, se o nome do arquivo nãoiniciar com uma letra, você será solicitado a utilizaralias=name.


220 Versão 7.0

into=jobstreamO nome do fluxo de job no qual o job será colocado paralançamento. Digite o nome como:

[wkstation#]jstream.Se você não especificar umawkstation,o padrão será a estação de trabalho na qual o Conman estásendo executado. Seinto não for utilizado, o job seráadicionado a um fluxo de job chamadoJOBS.



confirmed

every=rate


interactive

logon=user








noask Especifica para não solicitar confirmação antes da tomada deação em cada arquivo qualificado.

Notas de UtilizaçãoSe você não especificar uma estação de trabalho comfollows, needsou opens, o padrão será a estação de trabalho na qual o Conmanestá sendo executado. Se o job for executado em um agente detolerância a falhas e você quiser incluir uma dependênciaprompt ou



3.R

eferênciado

Conm

an

um recoveryprompt, o diretório do mozart (WShome/mozart) nogerenciador de domínio mestre deverá ficar acessível, montado oucompartilhado.

ExemplosO exemplo a seguir submete um arquivo ao fluxo de jobjobs. Onome do job émyjcl .submit file=d:\jobs\lib\daily\myjcl

O exemplo a seguir submete um arquivo, com um nome de job demisjob4, em um fluxo de job chamadomissked. O job precisa deduas unidades do recursoslots.sbf /usr/lib/mis/jcl4;alias=misjob4;into=missked ;needs=2 slots

O exemplo a seguir submete todos os arquivos com nomescomeçando comback a um fluxo de job chamadobkup.sbf "/usr/lib/backup/back@";into=bkup


222 Versão 7.0

submit jobSubmete um job para ser lançado pelo Workload Scheduler.


Para submeter um job, você deverá estar executando o Conman nogerenciador de domínio mestre, ou ter acesso aos bancos de dadosdo Workload Scheduler no gerenciador de domínio mestre.

Sinopse

sbj [wkstation#]jobname[;alias[=name]][ ;into= jobstream][;joboption[;...]][;noask]

Argumentoswkstation

Especifica o nome da estação de trabalho na qual o job serálançado. Caracteres curinga são permitidos e, nesse caso, ojob é lançado em todas as estações de trabalho qualificadas.O padrão é a estação de trabalho na qual o Conman estásendo executado. Você não pode especificar um domínio ouclasse de estação de trabalho.

jobnameEspecifica o nome do job. Caracteres curinga são permitidose, nesse caso, todos os jobs qualificados são submetidos. Seo job já estiver no plano de produção e estiver sendosubmetido ao mesmo fluxo de job, você deverá utilizar oargumentoalias para atribuir um nome exclusivo.

alias=nameEspecifica um nome exclusivo a ser atribuído ao job nolugar dejobname. Se você digitar a palavra-chavealias semespecificar um nome, um nome será construído utilizando osdois primeiros caracteres alfanuméricos dejobname, seguidode um número aleatório de seis dígitos. O nome é sempreorganizado em ordem crescente. Por exemplo, sejobnamefor jcrttx5 , o nome gerado será semelhante aJC123456.



3.R

eferênciado

Conm

an

into=jobstreamEspecifica o nome do fluxo de job no qual o job serácolocado para lançamento. Digite o nome como:

[wkstation#]jstream.Se você não especificar umawkstation,o padrão será a estação de trabalho na qual o Conman estásendo executado. Seinto não for utilizado, o job seráadicionado a um fluxo de job chamadojobs.



confirmed

every=rate










Notas de UtilizaçãoSe você não especificar uma estação de trabalho comfollows, needsou opens, o padrão será a estação de trabalho do job. Se o job forexecutado em um agente de tolerância a falhas e você quiser incluiruma dependênciaprompt ou um recoveryprompt, o diretório domozart (WShome/mozart) no gerenciador de domínio mestre deveráficar acessível, montado ou compartilhado.


224 Versão 7.0

ExemplosO exemplo a seguir submete os jobstest ao fluxo de jobJOBS:submit job=test@

O exemplo a seguir submete um job com um alias derptx4 e colocao job no fluxo de jobreports com uma horaat de 17:30h:sbj rjob4;alias=rptx4;into=reports;at=1730

O exemplo a seguir submete o jobtxjob3 a todas as estações detrabalho cujos nomes começam comsite:sbj site@#txjob3;alias



3.R

eferênciado

Conm

an

submit schedSubmete um fluxo de job para ser lançado pelo Workload Scheduler.

Você deve ter acessosubmit ao fluxo de job. Para incluirdependênciasneedse prompt , você deve ter acessouseaos recursose prompts globais.

Para submeter um fluxo de job, você deverá estar executando oConman no gerenciador de domínio mestre, ou ter acesso aos bancosde dados do Workload Scheduler no gerenciador de domínio mestre.

Sinopse

sbs [wkstation#]jstreamname[;alias[=name]][;jstreamoption[;...]][;noask]

Argumentoswkstation

Especifica o nome da estação de trabalho na qual fluxo dejob será lançado. Caracteres curinga são permitidos e, nessecaso, o fluxo de job é lançado em todas as estações detrabalho qualificadas. O padrão é a estação de trabalho naqual o Conman está sendo executado. Você não podeespecificar um domínio ou classe de estação de trabalho.

jstreamnameEspecifica o nome do fluxo de job. Caracteres curinga sãopermitidos e, nesse caso, todos os fluxos de job qualificadossão submetidos. Se o fluxo de job já estiver no plano deprodução, você deverá utilizar o argumentoalias paraatribuir um nome exclusivo.

alias=nameEspecifica um nome exclusivo a ser atribuído ao fluxo dejob no lugar dejstreamname. Se você digitar a palavra-chavealias sem especificar um nome, um nome será construídoutilizando os dois primeiros caracteres alfanuméricos dejstreamname, seguido de um número aleatório de seis


226 Versão 7.0

dígitos. O nome é sempre organizado em ordem crescente.Por exemplo, sejstreamnamefor sttrom, o nome geradoserá semelhante aST123456.

jstreamoptionDigite um dos seguintes:


carryforward


limit= joblimit






Notas de UtilizaçãoSe você não especificar uma estação de trabalho comfollows, needsou opens, o padrão será a estação de trabalho do fluxo de job. Se ofluxo de job for executado em um agente de tolerância a falhas evocê quiser incluir uma dependênciaprompt ou umrecoveryprompt, o diretório do mozart (WShome/mozart) nogerenciador de domínio mestre deverá ficar acessível, montado oucompartilhado.

ExemplosO exemplo a seguir submete o fluxo de jobadhoc à estação detrabalhosite1 e a sinaliza como um fluxo de jobcarryforward :submit sched=site1#adhoc;carryforward

O exemplo a seguir submete o fluxo de jobfox4 com um limite dejob 2, uma priority23 e uma horauntil de meia-noite:sbs fox4;limit=2;pri=23;until=0000



3.R

eferênciado

Conm

an

O exemplo a seguir submete o fluxo de jobsched3a todas asestações de trabalho com nomes começando comsite:sbs site@#sched3


228 Versão 7.0

switchmgrAlterna o gerenciamento de domínio do gerenciador de domínioatual para um gerenciador de domínio de backup.

Você deve ter acessostart e stop ao gerenciador de domínio debackup.

Sinopseswitchmgr domain,newmgr

Argumentosdomain Especifica o domínio no qual você deseja alternar

gerenciadores.

newmgr Especifica o nome do novo gerenciador de domínio.Deve ser uma estação de trabalho no mesmodomínio, e deve ser definido antecipadamente comoum agente de tolerância a falhas com ResolverDependências e Status Completo ativado.

Notas de UtilizaçãoO comando pára uma determinada estação de trabalho e a reiniciacomo o gerenciador de domínio. Todas as estações de trabalhomembros do domínio são informadas da mudança, e o gerenciadorde domínio anterior é convertido em um agente de tolerância afalhas no domínio.

A identificação de gerenciadores de domínio é transportada para cadaarquivo Symphony do novo dia, para que as mudanças permaneçamem vigor até que um comandoswitchmgr subseqüente sejaexecutado. No entanto, se o processamento do novo dia (o jobJnextday) for executado no gerenciador de domínio anterior, odomínio agirá apesar de outro comandoswitchmgr ter sidoexecutado e o gerenciador de domínio anterior continuaráautomaticamente as responsabilidades do gerenciamento de domínio.

ExemplosO exemplo a seguir alterna o gerenciador de domínio para a estaçãode trabalhoorca no domíniomasterdm:



3.R

eferênciado

Conm

an

switchmgr masterdm,orca

O exemplo a seguir alterna o gerenciador de domínio para a estaçãode trabalhoruby no domíniobldg2:switchmgr bldg2,ruby


230 Versão 7.0

System CommandExecuta um comando do sistema.

Sinopse[: | !] sys-command

Argumentossys-command Especifica qualquer comando de sistema válido. O

prefixo (: ou !) será necessário apenas quando umnome de comando for grafado da mesma forma queum comando Conman.

ExemplosO exemplo a seguir executa um comandops no UNIX:ps -ef

O exemplo a seguir executa um comandodir no Windows NT:dir \bin



3.R

eferênciado

Conm

an

tellopEnvia uma mensagem ao console do Workload Scheduler.

Sinopseto [text]

Argumentostext Especifica o texto da mensagem. A mensagem pode

conter até 900 caracteres.

Notas de UtilizaçãoSe tellop for emitido no gerenciador de domínio mestre, amensagem será enviada a todas as estações de trabalho ligadas. Seemitido em um gerenciador de domínio, a mensagem será enviada atodos os agentes ligados em seu domínio e domínios subordinados.Se emitido em uma estação de trabalho diferente de um gerenciadorde domínio, a mensagem será enviada somente a seu gerenciador dedomínio, se este estiver ligado. A mensagem será exibida somente seo nível da mensagem de console for maior que zero. Consulte“console” na página 139.

Se tellop for digitado sozinho, ele solicitará o texto da mensagem.No prompt, digite cada linha e pressione a tecla Return. No final damensagem, digite duas barras (//) ou um ponto (.) e pressione a teclaReturn. Você pode utilizar a seqüência de mudança de linha (\n) paraformatar as mensagens. DigitarControl+c a qualquer momento,sairá do comandotellop sem enviar a mensagem.

ExemplosO exemplo a seguir envia uma mensagem:tellop TWS will be stopped at\n4:30 for 15 minutes.

O exemplo a seguir solicita texto antes de enviar uma mensagem:toTELLOP>*********************************TELLOP>* TWS will be stopped at *TELLOP>* 4:30 for 15 minutes. *TELLOP>*********************************TELLOP>//


232 Versão 7.0

unlinkFecha links de comunicações entre as estações de trabalho.

Você deve ter acessounlink à estação de trabalho de destino.

Sinopseunlink [domain!]wkstation[;noask]

Argumentosdomain Especifica o nome do domínio no qual os links

devem ser fechados. Como as estações de trabalhopossuem nomes exclusivos, um domínio não énecessário quando uma determinada estação detrabalho está sendo desligada. Caracteres curinga sãopermitidos.

Este argumento é útil quando se está desligando maisde uma estação de trabalho em um domínio. Porexemplo, para desligar todos os agentes no domíniostlouis, utilize o seguinte comando:link stlouis!@

Se você não especificardomain, e wkstationincluircaracteres curinga, o domínio padrão será aquele noqual o Conman está sendo executado.

wkstation Especifica o nome da estação de trabalho a serdesligada. Caracteres curinga são permitidos.


Notas de UtilizaçãoSupondo-se que um usuário tenha acessounlink a estações detrabalho sendo desligadas, as seguintes regras serão aplicadas:

¶ Um usuário executando o Conman no gerenciador de domíniomestre pode desligar qualquer estação de trabalho na rede.



3.R

eferênciado

Conm

an

¶ Um usuário executando o Conman em um gerenciador dedomínio diferente do mestre pode desligar qualquer estação detrabalho em seu próprio domínio e em domínios subordinados. Ousuário não pode desligar estações de trabalho em domíniosponto a ponto.

¶ Um usuário executando o Conman em um agente pode desligarqualquer estação de trabalho em seu domínio local.

Para obter informações adicionais, consulte “link” na página 157.

ExemplosA ilustração e tabela abaixo mostram os links fechados porcomandosunlink executados por usuários em várias localizações narede.



234 Versão 7.0

Comandos Fechado peloUsuário1

Fechado peloUsuário2

Fechado peloUsuário3

unlink @!@ Todos os links sãofechados.

DM1-DM2DM2-A21DM2-A22DM2-DM4DM4-A41DM4-A42

DM2-A21DM2-A22

unlink @ DM1-A11DM1-A12DM1-DM2DM1-DM3

DM1-DM2DM2-A21DM2-A22DM2-DM4

DM2-A21DM2-A22

unlink domain3!@ DM3-A31DM3-A32


unlink domain4!@ DM4-A41DM4-A42

DM4-A41DM4-A42

Não permitido.

unlink DM2 DM1-DM2 Não aplicável. DM2-A21

unlink A42 DM4-A42 DM4-A42 Não permitido.

unlink A31 DM3-A31 Não permitido. Não permitido.



3.R

eferênciado

Conm

an

versionExibe o banner do programa Conman.

Sinopseversion

ExemplosO exemplo a seguir exibe o banner do programa Conman:%versionMAESTRO for UNIX (HPUX)/CONMAN 6.0 (3.34) (C) Tivoli Systems 1998Schedule 5/16/98 (#7) on SFO. Batchman down. Limit: 6, Fence: 0


236 Versão 7.0

Comandos Utilitários

Este capítulo descreve os comandos utilitários do Tivoli WorkloadScheduler. Esses comandos são ferramentas para ajudá-lo a gerenciaro Tivoli Workload scheduler. Os comandos, com exceção deStartUp e version, são instalados no diretórioTWShome/bin.StartUp é instalado no diretórioTWShomee version no diretórioTWShome/version.


Comandos Descrição

at | mat Apenas no UNIX. Submete um job para ser executadoem um período específico.

batch | mbatch Apenas no UNIX. Submete um job para ser executado omais breve possível.

caxtract Extrai informações sobre calendários.

cpuinfo Retorna informações de uma definição de estação detrabalho.

datecalc Converte data e hora em um formato desejado

dbexpand Expande os bancos de dados do Tivoli WorkloadScheduler.

delete Remove os arquivos de script e arquivos de lista padrãopor nome.

evtsize Define o tamanho máximo dos arquivos de mensagensde eventos.

jbxtract Extrai informações sobre jobs.

4


4.C

omandos

Utilitários

Comandos Descrição

jobinfo Retorna informações sobre um job.

jobstdl Retorna os nomes de caminhos de arquivos de listapadrão.

listproc Apenas no Windows NT. Lista processos. Esse comandonão é suportado.

killproc Apenas no Windows NT. Elimina processos. Essecomando não é suportado.

maestro Retorna o diretório pessoal do Tivoli WorkloadScheduler.

makecal Cria calendários personalizados.

morestdl Exibe o conteúdo de arquivos de lista padrão.

parms Exibe, altera e adiciona parâmetros.

paxtract Extrai informações sobre parâmetros.

prxtract Extrai informações sobre prompts.

r11xtr Extrai informações sobre fluxos de job.

release Libera unidades de um recurso.

rextract Extrai informações sobre recursos.

rmstdlist Remove arquivos de lista padrão com base no tempo.

showexec Apenas no UNIX. Exibe informações sobre os jobs emexecução.

StartUp Inicia o processo Netman.

version Apenas no UNIX. Exibe informações sobre a versão.

xrxtrct Extrai informações sobre referências cruzadas.

wmaeutil Extrai informações sobre referências cruzadas.


238 Versão 7.0

Comandos at | batchApenas no UNIX. Submete comandos e jobs especiais para seremlançados pelo TWS. Quando você instala o TWS, os seguintes linkssão criados por padrão:

/usr/bin/mat —>TWShome/bin/at/usr/bin/mbatch —>TWShome/bin/batch

Consulteat.allow e at.deny a seguir para obter informações sobre adisponibilidade aos usuários.

Sinopseat | mat -v | -u

at | mat -sjstream| -qqueuetime-spec

batch | mbatch -v | -u

batch | mbatch [-s jstream]

Argumentos-v Exibe a versão do comando e sai.

-u Exibe informações de utilização do comando e sai.

-s jstream

Especifica o nome de um fluxo de job ao qual o job ésubmetido. Se o fluxo de job não existir, ele será criado. Onome deve iniciar com uma letra e pode conter caracteresalfanuméricos e traços. Para bancos de dadosnão-expandidos, ele pode conter até oito caracteres. Parabancos de dados expandidos, ele pode conter até 16caracteres.

Se os argumentos-s e -q forem omitidos, um nome de fluxode job será selecionado com base no valor da variável deambiente ATSCRIPT. Se ATSCRIPT contiver a palavramaestro, o nome do fluxo de job será os primeiros oitocaracteres do nome de grupo do usuário. Se ATSCRIPT nãofor definido, ou for definido com um valor diferente de



4.C

omandos

Utilitários

maestro, o nome do fluxo de job seráat (para jobssubmetidos comat) ou batch (para jobs submetidos combatch).

Consulte “Outras Considerações:” na página 242 para obtermais informações sobre fluxos de job.

-qqueueEspecifica para submeter o job a um fluxo de job com onomequeue, que pode ser uma única letra (a-z). Consulte“Outras Considerações:” na página 242 para obter maisinformações sobre fluxos de job.

time-specEspecifica a hora em que o job será lançado. Apenas parajobs at. A sintaxe é a mesma daquela utilizada com ocomandoat do UNIX.

Notas de UtilizaçãoApós digitarat ou batch, digite os comandos que constituem o job.Termine cada linha de entrada pressionando a tecla Return. Aseqüência inteira termina com fim-de-linha (geralmente,Control+d),ou digitando uma linha com um ponto (.). Alternativamente, utilizeum sinal de menor (<) para ler os comandos de um arquivo.Consulte o exemplo a seguir “Outras Considerações:” na página 242.

São enviadas informações sobre os jobsat e batch ao gerenciadorde domínio mestre, onde os jobs são adicionados aos fluxos de jobno plano de produção, Symphony. Os jobs são lançados com basenas dependências incluídas nos fluxos de job.

A shell UNIX a ser utilizada para jobs submetidos com os comandosat e batch do Tivoli Workload Scheduler é determinada pelavariável SHELL_TYPE no script de configuraçãojobmanrc. Nãoutilize a shell C. Para obter mais informações, consulte oTivoliWorkload Scheduler - Guia do Usuário.

Depois de submetidos, os jobs são lançados da mesma maneira queos outros jobs planejados. Cada job é executado no ambiente desubmissão do usuário. Para assegurar que o ambiente esteja


240 Versão 7.0

completo, são inseridos comandosset no script para corresponder àsdefinições de variáveis no ambiente do usuário.

Como Substituir Comandos do UNIX:Os comandos padrãoat e batch do UNIX podem ser substituídospelos comandos do TWS. Os comandos a seguir ilustram comosubstituir os comandosat e batch do UNIX:$ mv /usr/bin/at /usr/bin/uat$ mv /usr/bin/batch /usr/bin/ubatch$ ln -s TWShome/bin/at /usr/bin/at$ ln -s TWShome/bin/batch /usr/bin/batch

Observe que o scriptcustomizeinstala links em seus comandosat ebatch por padrão. Isso permite que os comandos sejam executadoscomo a seguir:/usr/bin/mat

/usr/bin/mbatch

Os Arquivos at.allow e at.deny:Os comandosat e batch utilizam os arquivos/usr/lib/cron/at.allowe /usr/lib/cron/at.deny para restringir o uso. Se o arquivoat.allowexistir, apenas os usuários listados no arquivo terão permissão parautilizar at e batch. Se o arquivo não existir,at.deny será verificadopara saber se o usuário teve a permissão negada explicitamente. Senenhum dos arquivos existir, apenas o usuárioroot terá permissãopara utilizar os comandos. Se os comandos forem executados comomat e mbatch, at.allow e at.deny serão ignorados e nenhumarestrição será aplicada.

Arquivos de Script:Os comandos digitados comat ou batch são armazenados emarquivos de script. Os arquivos são criados pelo TWS com aseguinte convenção de nomenclatura:

TWShome/atjobs/epoch.sss

onde:

epoch O número de segundos desde 00:00, 1/1/70.



4.C

omandos

Utilitários

sss Os três primeiros caracteres do nome do fluxo de job.

Nota: O TWS remove arquivos de script de jobs que não sãotransportados. No entanto, o Tivoli recomenda que vocêmonitore o espaço em disco no diretórioatjobs e removaarquivos antigos, se necessário.

Nomes de Jobs:Todos os jobsat e batch recebem nomes exclusivos do TWSquando são submetidos. Os nomes consistem no PID (ID deprocesso) do usuário, antecedido pelo nome do usuário e truncadopara que não exceda oito caracteres. O nome resultante é organizadoem ordem crescente.

Outras Considerações:O Tivoli recomenda que os fluxos de job nos quais os jobsat ebatch são submetidos sejam criados antecipadamente com oComposer. Os fluxos de job podem conter dependências quedeterminam quando os jobs serão lançados. No mínimo, os fluxos dejob devem conter a palavra-chavecarryforward . Isso irá assegurarque os jobs que não forem concluídos, ou que não forem lançados,durante o dia atual sejam transportados para o plano de produção dodia seguinte. Algumas outras sugestões relativas aos fluxos de jobate batch:

¶ Inclua a expressãoon everydaypara que os fluxos de job sejamselecionados todos os dias.

¶ Utilize a palavra-chavelimit para limitar o número de jobssubmetidos que podem ser executados simultaneamente.

¶ Utilize a palavra-chavepriority para definir a prioridade de jobssubmetidos em relação a outros jobs.

ExemplosO exemplo a seguir submete um job ao fluxo de jobsched8para serlançado o mais breve possível:mbatch -s sched8command <Return>...<Control d>


242 Versão 7.0

O exemplo a seguir submete um job ao fluxo de jobk para serlançado às 21h45:mat -qk 21h45command <Return>...<Control d>

O exemplo a seguir submete um job para ser lançado duas horasdepois da hora em que o comando foi digitado:TWShome/bin/at now + 2 hourscommand <Return>...<Control d>

Se a variável ATSCRIPT for nula, o job será submetido a um fluxode job com o mesmo nome do grupo do usuário. Caso contrário, eleserá submetido a um fluxo de job chamadoat.

O exemplo a seguir submete um job ao fluxo de jobsked-misparaser lançado às 17:30h:mat -s sked-mis 17h30command <Return>...<Control d>

O exemplo a seguir é o mesmo do exemplo anterior, exceto que oscomandos do job são lidos de um arquivo:mat -s sked-mis 17h30 < ./myjob

O fato dos comandos serem lidos de um arquivo não altera seumodo de processamento. Isto é, os comandos são copiados doarquivo ./myjob para um arquivo de script.



4.C

omandos

Utilitários

Comando caxtractExtrai informações sobre calendários do banco de dados do TWS.

Sinopsecaxtract[-v | -u] [ -o file]



-o file Especifica o arquivo de saída. O padrão éstdout.

Saída de ComandoCada registro de calendário contém campos de comprimentovariável, delimitados por tabulação. Os campos são descritos natabela a seguir.

Campo Descrição ComprimentoMáximo (bytes)

1 nome do calendário 8

2 descrição do calendário 64

ExemplosExtrai informações sobre todas as definições do calendário e canalizaa saída para o arquivocainfo:caxtract -o cainfo


244 Versão 7.0

Comando cpuinfoRetorna informações de uma definição de estação de trabalho.

Sinopsecpuinfo -v | -u

cpuinfo wkstation[infotype] [...]



wkstation

O nome da estação de trabalho.

infotypeO tipo de informação a ser exibida. Especifica um ou maisdos seguintes:

os_typeRetorna o valor do campoos: MPEV, MPIX, UNIX,WNT ou OTHER.

node Retorna o valor do camponode.

port Retorna o valor do campoport .

autolinkRetorna o valor do campoautolink : ON ou OFF.

fullstatusRetorna o valor do campofullstatus: ON ou OFF.

resolvedepRetorna o valor do camporesolvedep: ON ou OFF.

host Retorna o valor do campohost.

methodRetorna o valor do campoaccess.

server Retorna o valor do camposerver.



4.C

omandos

Utilitários

type Retorna o tipo de estação de trabalho: MASTER,MANAGER, FTA, S-AGENT e X-AGENT.

time_zoneRetorna o fuso horário da estação de trabalho. Paraum agente estendido, o campo fica em branco.

versionRetorna a versão do TWS que está sendo executadana estação de trabalho. Para um agente estendido, ocampo fica em branco.

info Retorna a versão do sistema operacional e o modelode estação de trabalho. Para um agente estendido, ocampo fica em branco.

Notas de UtilizaçãoOs valores são retornados, separados por novas linhas, na mesmaordem em que os argumentos foram digitados na linha de comandos.Se nenhum argumento for especificado, todas as informaçõesaplicáveis serão retornadas com etiquetas, separadas por novaslinhas.

ExemplosOs exemplos a seguir baseiam-se na seguinte definição de estação detrabalho:cpuname oakos UNIXnode oak.tivoli.comtcpaddr 31111

for maestroautolink onfullstatus onresolvedep on

end

O exemplo a seguir imprime o tipoos para a estação de trabalhooak:>cpuinfo oak os_typeUNIX

O exemplo a seguir imprime os tiposnode e port para a estação detrabalhooak:


246 Versão 7.0

>cpuinfo oak node portoak.tivoli.com31111

O exemplo a seguir imprime todas as informações para a estação detrabalhooak:>cpuinfo oakOS TYPE:UNIXNODE:oak.tivoli.comPORT:31111AUTOLINK:ONFULLSTATUS:ONRESOLVEDEP:ONHOST:METHOD:SERVER:TYPE: FTATIME ZONE:US/PacifVERSION:6.1INFO:SunOS 5.3 Generic 1016 sun4m



4.C

omandos

Utilitários

Comando datecalcResolve expressões de datas e retorna datas nos formatos desejados.

Sinopsedatecalc -v | -u

datecalcbase-date[offset] [pic format]

datecalc -t time [base-date] [offset] [pic format]

datecalcyyyymmddhhtt[offset] [pic format]



base-date

Especifique um dos seguintes:

day | date | today | tomorrow | scheddate

onde:

day Especifica um dia da semana. Os valores válidossão:su, mo, tu, we, th, fr ou sa.

date Especifica uma data, no formatoelement/element[/element], ondeelementé: d[d],m[m] e yy[yy].

Se forem utilizados dois dígitos para o ano (yy), umnúmero superior a 70 será uma data do século 20 eum número inferior a 70 será uma data do século 21.

Os valores válidos para o mês (m[m]) são jan, feb,mar, apr, may, jun , jul , aug, sep, oct, nov ou dec.

As barras (/) podem ser substituídas por traços (-),pontos (.), vírgulas (,) ou espaços. Por exemplo,qualquer um dos seguintes formatos pode serdigitado para 28 de março de 1999:


248 Versão 7.0

03/28/993-28-199928.mar.9999,28,3mar 28 199928 3 99

Quando se utiliza números, há a possibilidade de sedigitar uma data ambígua, por exemplo, 2,7,98.Neste caso,datecalcutiliza o formato de datadefinido no catálogo de mensagens do TWS parainterpretá-la. Se a data não corresponder ao formato,uma mensagem de erro será gerada pordatecalc.

today Especifica a data atual do sistema.

tomorrowEspecifica a data atual do sistema mais um dia, ou,no caso de cálculos de horas, mais 24 horas.

scheddateEspecifica a data do plano de produção.

-t time [base-date]Especifiquetime 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 12:00h (ou 1200h).

midnightEspecifica 24:00h (ou 00:00h).

h[h][[:] mm]Especifica a hora e os minutos em 12 horas (seamou pm for utilizado), ou 24 horas. O delimitadoropcional de dois-pontos (:) pode ser substituído porum ponto (.), uma vírgula (,), um apóstrofo (’), pela



4.C

omandos

Utilitários

letra h, ou por um espaço. Por exemplo, qualquerum dos seguintes formatos pode ser digitado para20:00h:

8:00pm20:000800pm20008pm208,00pm20.008\’00pm20 00

zulu Especifica que a hora digitada é a hora deGreenwich (Hora Coordenada Universal).datecalcirá converte-la na hora local.

yyyymmddhhttEspecifica o ano, mês, dia, hora e minuto expresso emexatamente doze dígitos. Por exemplo, para 1999, 7 de maio,9:15h, digite o seguinte:199905070915

offset Especifica um deslocamento debase-dateno seguinteformato:

{[ + | > | - | < number | nearest] | next} day[s] |weekday[s] | workday[s] | week[s] | month[s] |year[s] | hour[s] | minute[s] |day | calendar

onde:

+ | > (Mais) Especifica um deslocamento para uma dataou hora posterior. Certifique-se de escape o sinal demenor (″\>″).

- | < (Menos) Especifica um deslocamento para uma dataou hora anterior. Certifique-se de escape o sinal demenor (″\<″).


250 Versão 7.0

numberO número de unidades do tipo especificado.

nearestEspecifica um deslocamento para a ocorrência maispróxima do tipo de unidade (anterior ou posterior).

next Especifica a próxima ocorrência do tipo de unidade.

day[s] Especifica todos os dias.

weekday[s]Especifica todos os dias, exceto sábado e domingo.

workday[s]O mesmo deweekday[s], mas também exclui asdatas do calendárioholidays.

week[s]Especifica sete dias.

month[s]Especifica os meses do calendário.

year[s]Especifica os anos do calendário.

hour[s]Especifica as horas do relógio.

minute[s]Especifica os minutos do relógio.

day Especifica um dia da semana. Os valores válidossão:su, mo, tu, we, th, fr ou sa.

calendarEspecifica as entradas em um calendário por estenome.

pic formatEspecifica o formato em que a data e hora são retornados.Os caracteres deformat são os seguintes:

m Número do mês.

d Número do dia.



4.C

omandos

Utilitários

y Número do ano.

j Número do dia Juliano.

h Número da hora.

t Número do minuto.

^ Um espaço. (Esse caractere deve ser escaped (\) nashell Bourne.)

Caracteres de pontuação também podem ser incluídos. Elesfuncionam da mesma forma que os delimitadores utilizadosem datee time.

Se um formato não for definido,datecalc retornará a data ehora no formato definido pelas variáveis de ambiente NLS(Native Language Support). Se as variáveis NLS não foremdefinidas, o idioma nativo será padronizado como C.

ExemplosO exemplo a seguir retorna a próxima data, a partir de hoje, nocalendário monthend:>datecalc today next monthend

Nos exemplos a seguir, a data atual do sistema é sexta-feira, 9 deabril de 1999.>datecalc today +2 days pic mm/dd/yy04/11/99

>datecalc today next tu pic yy\^mm\^dd99 04 13

>LANG=american;export LANG>datecalc -t 14:30 tomorrowSat, Apr 10, 1999 02:30:00 PM

>LANG=french;datecalc -t 14:30 tomorrowSamedi 10 avril 1999 14:30:00

No exemplo a seguir, a hora atual do sistema é 10:24h.>datecalc -t now \> 4 hours pic hh:tt14:24


252 Versão 7.0

Comando dbexpandConverte os bancos de dados do gerenciador de domínio mestre domodo não-expandido no modo expandido. O comando define aopção globalversão expandidacomosim e faz cópias de backup deseus arquivos de banco de dados antigos que poderão ser utilizadaspara retornar ao modo não-expandido, se necessário.

Se você atualizar a rede em etapas e ela contiver estações detrabalho que estejam executando o Tivoli Maestro Versão 5.x ouanterior, você deverá utilizar bancos de dados não-expandidos atéque todos os computadores tenham sido atualizados com o TivoliMaestro 6.x ou Tivoli Workload Scheduler. Quando a atualizaçãoestiver concluída, executedbexpand no gerenciador de domíniomestre para converter os bancos de dados no modo expandido.

Sinopsedbexpand -v | -u

dbexpand -n[-bbackup-dir]



-n

Especifica para não solicitar o nome de um diretório debackup. Se-b for incluído, o diretório nomeado seráutilizado para backup. Se-b não for incluído, será utilizadoo diretório padrão. Em qualquer um dos casos, se o diretórioexistir, ele será sobreposto.

-b backup-dirEspecifica um diretório para fazer backup dos arquivos dobancos de dados. O diretório padrão é:

TWShome/mozart/mozart.old

Se -n for omitido e o diretório de backup já existir, vocêserá solicitado a fornecer o nome de um diretório de backup.



4.C

omandos

Utilitários

Notas de UtilizaçãoVocê pode executar o comandodbexpand sem parar o TWS. Noentanto, não poderá submeter jobs ou fluxos de job ao plano deprodução atual até que ocorra a mudança do novo dia. Por essemotivo, o Tivoli recomenda quedbexpand seja executado por poucotempo antes do jobJnextday ser executado.

ExemplosO exemplo a seguir expande os bancos de dados e faz backup dosarquivos atuais no diretório/usr/lib/maestro/temp. Se o diretório jáexistir, ele sobreporá seu conteúdo.dbexpand -n -b /usr/lib/maestro/temp

O exemplo a seguir expande os bancos de dados e faz backup dosarquivos atuais no diretórioc:\programs\wsched\temp. Será exibidoum prompt se o diretório já existir.dbexpand -b c:\programs\wsched\temp


254 Versão 7.0

Comando deleteRemove arquivos. Esse comando destina-se à remoção de arquivosde lista padrão. Os usuáriosmaestro e root podem remover qualquerarquivo. Outros usuários podem remover somente os arquivosassociados a seus próprios jobs.

Sinopsedelete -v | -u

delete filename



filename

Especifica o nome do arquivo ou grupo de arquivos a seremremovidos. O nome deverá ser colocado entre aspas (″) secontiver caracteres diferentes do seguinte: alfanuméricos,traços (-), barras (/), barras invertidas (\) e sublinhados (_).Caracteres curinga são permitidos.

CUIDADO:Utilize esse comando com cuidado. O uso inadequado decaracteres curinga poderá resultar na remoção acidental dearquivos.

ExemplosO exemplo a seguir remove todos os arquivos de lista padrão em4/11/99:delete d:\win32app\maestro\stdlist\1999.4.11\@

O script a seguir, incluído em um job planejado no UNIX, removeráo arquivo de lista padrão do job se não houver erros:...#Remover a stdlist deste job:if grep -i error $UNISON_STDLISTthenexit 1



4.C

omandos

Utilitários

elsevmaestrov/bin/delete $UNISON_STDLISTfi...

Observe que o script de configuração padrão,jobmanrc, define avariável UNISON_STDLIST com o nome do arquivo de lista padrãodo job. Para obter mais informações sobrejobmanrc consulte oTivoli Workload Scheduler - Guia do Usuário.


256 Versão 7.0

Comando evtsizeDefine o tamanho dos arquivos de evento do TWS. Esse comando éutilizado para aumentar o tamanho de um arquivo de evento após orecebimento da mensagem “Fim do arquivo de eventos.” Você deveser o usuáriomaestro ou root para executarevtsize.

Sinopseevtsize -v | -u

evtsizefilename size



filenameO nome do arquivo de evento. Especifique um dos seguintes:

Courier.msgIntercom.msgMailbox.msgmaestro.msgnetman.msgunison.msgpobox/wkstation.msg

size O tamanho máximo do arquivo de evento em bytes. Quandocriado pela primeira vez pelo TWS, o tamanho máximo édefinido para 1 MB.

ExemplosO exemplo a seguir define o tamanho máximo do arquivoIntercompara 2 MB:evtsize Intercom.msg 2000000

O exemplo a seguir define o tamanho máximo do arquivopobox daestação de trabalhochicagopara 1,5 MB:evtsize pobox\chicago.msg 1500000



4.C

omandos

Utilitários

Comando jbxtractExtrai informações sobre jobs do banco de dados do TWS.

Sinopsejbxtract [-v | -u] [ -j job] [ -c wkstat] [ -o file]



-j job Especifica o job para o qual a extração é executada. Opadrão são todos os jobs.

-c wkstatEspecifica a estação de trabalho de jobs para a qual aextração é executada. O padrão é todas as estações detrabalho.


Saída de ComandoA variável MAESTRO_OUTPUT_STYLE especifica o estilo desaída para nomes longos de objetos. Definir a variável comoLONGpara utilizar os campos de comprimento completos (longos) paranomes de objetos. Se a variável não for definida ou for definida comalgo diferente deLONG e a opção globalversão expandidafordefinida comosim, os nomes longos serão truncados com oitocaracteres e um sinal de mais. Por exemplo:A1234567+. Se a opçãoversão expandidafor definida comonão, os nomes longos serãotruncados com oito caracteres.

Cada registro de job contém campos de comprimento variável,delimitados por tabulação. Os campos são descritos na tabela aseguir.

Campo Descrição ComprimentoMáximo (bytes) *

1 nome da estação de trabalho 8/16

2 nome do job 8/16


258 Versão 7.0


3 nome do arquivo de script do job 256/4096

4 descrição do job 65

5 nome do job de recuperação 16

6 opção de recuperação (0=stop, 1=rerun, 2=continue) 5

7 texto do prompt de recuperação 64

8 sinalizador de documentação automática (0=desativado,1=ativado)

5

9 nome do usuário de início de sessão do job 36

10 nome de usuário do criador do job 36

11 número de execuções bem-sucedidas 5

12 número de execuções terminadas de forma anormal 5

13 tempo total decorrido de todas as execuções do job 8

14 tempo total de cpu de todas as execuções do job 8

15 tempo decorrido médio 8

16 última data de execução (ddmmyy) 8

17 última hora de execução (hhmm) 8

18 últimos segundos da cpu 8

19 último tempo decorrido 8

20 segundos máximos de cpu 8

21 tempo máximo decorrido 8

22 data máxima de execução (ddmmyy) 8

23 segundos mínimos de cpu 8

24 tempo mínimo decorrido 8

25 data mínima de execução (ddmmyy) 8

* bancos de dados não-expandidos/bancos de dados expandidos

ExemplosExtrai informações sobre o jobmyjob na estação de trabalhomain ecanaliza a saída para o arquivojinfo :jbxtract -j myjob -c main -o jinfo



4.C

omandos

Utilitários

Comando jobinfoUtilizado em um script de job para retornar informações sobre o job.

Sinopsejobinfo -v | -u

jobinfo job-option [...]



job-option

A opção de job. Especifica um ou mais dos seguintes:

confirm_jobRetornaráYES se o job requerer confirmação.

is_commandRetornaráYES se o job tiver sido planejado ousubmetido com a construçãodocommand.

job_nameRetorna o nome do job sem os nomes da estação detrabalho e do fluxo de job.

job_priRetorna o nível de prioridade do job.

programmatic_jobRetornaráYES se o job tiver sido submetido com ocomandoat or ubatch do TWS.

re_jobRetornaráYES se o job estiver sendo reexecutadocomo resultado de um comandorerun do Conman,ou da opção de recuperação de reexecução.

re_typeRetornará a opção de recuperação do job (stop,continue ou rerun ).


260 Versão 7.0

rstrt_flagRetornaráYES se o job estiver sendo executadocomo o job de recuperação.

time_startedRetorna a hora em que o job iniciou a execução.

Notas de UtilizaçãoOs valores de opção do job são retornados, separados por novaslinhas, na mesma ordem em que foram solicitados.

ExemplosO arquivo de script/jcl/backup é documentado duas vezes,dando-lhe os nomes de jobpartback e fullback . Se o job forexecutado comopartback, ele executará um backup parcial. Se forexecutado comofullback , executará um backup completo. Dentro doscript, os comandos como os seguintes são utilizados para fazer adeterminação:#Determinar parcial (1) ou completo (2):if [ "v\vmaestro\v/bin/jobinfo job_namev" = "PARTBACK" ]thenbkup=1elsebkup=2fi...



4.C

omandos

Utilitários

Comando jobstdlRetorna os nomes de arquivos de lista padrão.

Sinopsejobstdl -v | -u

jobstdl [-day num] [ -first | -last | -num n | -all][-name jstream.job | jobnum]



-day numRetorna os nomes de arquivos de lista padrão que são osnúmeros especificados de dias anteriores (1 para ontem, 2para anteontem, e assim por diante). O padrão é zero (hoje).

-first Retorna o nome do primeiro arquivo de lista padrãoqualificado.

-last Retorna o nome do último arquivo de lista padrãoqualificado.

-num nRetorna o nome do arquivo de lista padrão da execuçãoespecificada de um job.

-all Retorna o nome de todos os arquivos de lista padrãoqualificados.

-name jstream.jobEspecifica o nome do fluxo de job e job para os quais osnomes do arquivo de lista padrão são retornados.

jobnumEspecifica o número do job para o qual os nomes do arquivode lista padrão são retornados.


262 Versão 7.0

Notas de UtilizaçãoOs nomes de arquivos são retornados em um formato adequado paraentrada de outros comandos. São retornados vários nomes separadospor um espaço.

ExemplosO exemplo a seguir retorna os nomes de caminhos de todos osarquivos de lista padrão do dia atual:jobstdl

O exemplo a seguir retorna o nome do caminho da lista padrão daprimeira execução do jobmailxhg1.getmail no dia atual:jobstdl -first -name mailxhg1.getmail

O exemplo a seguir retorna o nome do caminho da lista padrão dasegunda execução do jobmailxhg1.getmail no dia atual:jobstdl -num 2 -name mailxhg1.getmail

O exemplo a seguir retorna os nomes de caminhos dos arquivos delista padrão de todas as execuções do jobmailxhg1.getmail há trêsdias:jobstdl -day 3 -name mailxhg1.getmail

O exemplo a seguir retorna o nome do caminho da lista padrão daúltima execução do jobmailxhg1.getmail há quatro dias:jobstdl -day 4 -last -name mailxhg1.getmail

O exemplo a seguir retorna o nome do caminho da lista padrão dojob número455:jobstdl 455

O exemplo a seguir imprime o conteúdo do arquivo de lista padrãodo job número455:cd vmaestrov/binlp -p 6 vjobstdl 455v



4.C

omandos

Utilitários

Comando maestroRetorna o nome do caminho do diretório pessoal do Tivoli WorkloadScheduler, referido comoTWShome

.

Sinopsemaestro[-v | -u]



ExemplosO exemplo a seguir exibe o diretório pessoal do TWS:$ maestro /usr/lib/maestro

O exemplo a seguir altera o diretório para o diretório pessoal doTWS:$ cd vmaestrov


264 Versão 7.0

Comando makecalCria um calendário personalizado. No UNIX, a shell Korn énecessária para executar esse comando.

Sinopsemakecal [-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]



-c nameEspecifica um nome para o calendário. O nome pode conteraté oito caracteres alfanuméricos e deve iniciar com umaletra. O nome padrão é:Chhmm, ondehhmmé a hora eminutos atuais.

-d n Especifica o enésimo dia de cada mês.

-e Especifica o último dia de cada mês.

-f 1 | 2 | 3Cria um calendário fiscal de final de mês contendo o últimodia do mês fiscal. Especifique um dos seguintes formatos:

1 formato de semana 4-4-5



Esse argumento requer o argumento-s.

-i n Especifica para colocarn datas no calendário.

-l Especifica o último dia útil de cada mês. Para esseargumento funcionar adequadamente, o plano de produção(arquivo Symphony) e o calendárioholidays já devemexistir.



4.C

omandos

Utilitários

-m Especifica o primeiro e o décimo quinto dias de cada mês.

-p n Especifica o dia útil antes do enésimo dia de cada mês. Paraesse argumento funcionar adequadamente, o plano deprodução (arquivo Symphony) e o calendárioholidays jádevem existir

-r n Especifica todo enésimo dia. Esse argumento requer oargumento-s.

-s dateEspecifica a data de início para os argumentos-f e -r . A datadeve ser colocada entre aspas e deve ser válida enão-ambígua, por exemplo, utilizeJAN 10 1999e não1/10/99. Consultebase-datepara obter odatecalca seguir“Comando datecalc” na página 248 para obter maisinformações sobre os formatos de datas.

-w n Especifica o dia útil após o enésimo dia do mês. Para esseargumento funcionar adequadamente, o plano de produção(arquivo Symphony) e o calendárioholidays já devemexistir.

-x Envia a saída do calendário parastdout em vez deadicioná-lo ao banco de dados de calendários.

-z Adiciona o calendário ao banco de dados de calendários ecompila o plano de produção (arquivo Symphony). AVISO:Esse argumento submete novamente jobs e fluxos de job doplano de produção do dia atual. Poderá ser necessáriocancelar fluxos de job e jobs.

ExemplosO exemplo a seguir cria um calendário de dois anos com o últimodia de cada mês selecionado:makecal -e -i24

O exemplo a seguir cria um calendário com 30 dias, iniciando em 30de maio de 1999 e com cada terceiro dia selecionado:makecal -r 3 -s "30 MAY 1999" -i30


266 Versão 7.0

Comando morestdlExibe o conteúdo de arquivos de lista padrão.

Sinopsemorestdl -v | -u

morestdl [-day num] [ -first | -last | -num n | -all][-name jstream.job | jobnum]



-day numExibe arquivos de lista padrão que são os númerosespecificados de dias anteriores (1 para ontem, 2 paraanteontem, e assim por diante). O padrão é zero (hoje).

-first Exibe o primeiro arquivo de lista padrão qualificado.

-last Exibe o último arquivo de lista padrão qualificado.

-num nExibe o arquivo de lista padrão da execução especificada deum job.

-all Exibe todos os arquivos de lista padrão qualificados.

-name jstream.jobEspecifica o nome do fluxo de job e job para os quais oarquivo de lista padrão é exibido.

jobnumEspecifica o número do job para o qual o arquivo de listapadrão é exibido.

ExemplosO exemplo a seguir exibe o arquivo de lista padrão da primeiraexecução do jobmailxhg1.getmail no dia atual:morestdl -first -name mailxhg1.getmail



4.C

omandos

Utilitários

O exemplo a seguir exibe o arquivo de lista padrão da segundaexecução do jobmailxhg1.getmail no dia atual:morestdl -num 2 -name mailxhg1.getmail

O exemplo a seguir exibe os arquivos de lista padrão de todas asexecuções do jobmailxhg1.getmail há três dias:morestdl -day 3 -name mailxhg1.getmail

O exemplo a seguir exibe o arquivo de lista padrão da últimaexecução do jobmailxhg1.getmail há quatro dias:morestdl -day 4 -last -name mailxhg1.getmail

O exemplo a seguir imprime o arquivo de lista padrão do jobnúmero 455:morestdl 455 | lp -p 6


268 Versão 7.0

Comando parmsRetorna o valor atual de um parâmetro, altera o valor de umparâmetro ou adiciona um novo parâmetro.

Sinopseparms [-v | -u]

parms name

parms -c name value



name Especifica o nome do parâmetro cujo valor é exibido.

-c name valueEspecifica o nome e o valor de um parâmetro. O valor podeconter até 72 caracteres. Serão necessárias aspas se o valorcontiver caracteres especiais. Se o parâmetro não existir, eleserá adicionado ao banco de dados. Se o parâmetro já existir,seu valor será alterado.

Notas de UtilizaçãoQuandoparms for executado na linha de comandos semargumentos, ele solicitará nomes e valores de parâmetros.

ExemplosO exemplo a seguir retorna o valor demyparm:parms myparm

O exemplo a seguir altera o valor demyparm:parms -c myparm "item 123"

O exemplo a seguir cria um novo parâmetro chamadohisparm:parms -c hisparm "item 789"

O exemplo a seguir altera o valor demyparm e adicionaherparm:



4.C

omandos

Utilitários

parmsNome do parâmetro ? myparm < Return>Valor do parâmetro? "item 456" < Return>Nome do parâmetro ? herparm < Return>Valor do parâmetro? "item 123" < Return>Nome do parâmetro ? < Return>


270 Versão 7.0

Comando paxtractExtrai informações sobre parâmetros do banco de dados do TWS.

Sinopsepaxtract[-v | -u] [ -o file]




Saída de ComandoCada registro de parâmetro contém campos de comprimento variável,delimitados por tabulação. Os campos são descritos na tabela aseguir.


1 nome do parâmetro 8

2 valor do parâmetro 64

ExemplosExtrai informações sobre todas as definições de parâmetros ecanaliza a saída para o arquivopainfo:paxtract -o painfo



4.C

omandos

Utilitários

Comando prxtractExtrai informações sobre prompts do banco de dados do TWS.

Sinopseprxtract [-v | -u] [ -o file]




Saída de ComandoCada registro de prompt contém campos de comprimento variável,delimitados por tabulação. Os campos são descritos na tabela aseguir.


1 nome do prompt 8

2 valor do prompt 200

ExemplosExtrai informações sobre todas as definições de prompt e canaliza asaída para o arquivoprinfo :prxtract -o prinfo


272 Versão 7.0

Comando r11xtrExtrai informações sobre fluxos de job do banco de dados do TWS.

Sinopseprxtract [-v | -u] [ -m mm[yy]] [ -c wkstat] [ -o file]



-m mm[yy]Especifica o mês (mm) e, opcionalmente, o ano (yy) dosfluxos de job. O padrão é o mês e ano atuais.

-c wkstatEspecifica a estação de trabalho dos fluxos de job. O padrãoé todas as estações de trabalho.



Cada registro de fluxo de job contém campos de comprimentovariável, delimitados por tabulação. Os campos são descritos natabela a seguir.



2 nome do fluxo de job 8/16



4.C

omandos

Utilitários


3 data do fluxo de job (ddmmyy) 6

4 segundos estimados de cpu 6

5 sinalizador múltiplo de estação de trabalho (* significaque alguns jobs são executados em outras estações detrabalho)

1

6 número de jobs 4

7 dia da semana (Su, Mo, Tu, We, Th, Fr, Sa) 2


ExemplosExtrai informações sobre fluxos de job em junho de 1999 paraestações de trabalhomain:r11xtr -m 0699 -c main

Extrai informações sobre fluxos de job em junho deste ano paratodas as estações de trabalho, e canaliza a saída para o arquivor11out:r11xtr -m 06 -o r11out


274 Versão 7.0

Comando releaseLibera unidades de um recurso no nível do fluxo de job ou job.

Sinopserelease -v | -u

release[-s] [wkstation#]resourcename



-s Libera unidades de um recurso apenas no nível do fluxo dejob.

Se -s não for utilizado, as unidades de recurso serãoliberadas no nível do job, ou no nível do fluxo de job, se orecurso não for encontrado no nível do job.

wkstation#Especifica o nome da estação de trabalho ou classe daestação de trabalho na qual o recurso está definido. O padrãoé a estação de trabalho local.

resourcenameEspecifica o nome do recurso.

Notas de UtilizaçãoUnidades de um recurso são adquiridas por um job ou fluxo de jobna hora em que é lançado e são liberadas automaticamente quando ojob ou fluxo de job é concluído. O comandoreleasepode serutilizado em um script de job para liberar recursos antes daconclusão do job ou fluxo de job. As unidades de um recurso sãoliberadas na mesma ordem em que foram adquiridas.

ExemplosNo fluxo de job a seguir, duas unidades do recursodbasesãorequeridas pelo fluxosked5:



4.C

omandos

Utilitários

schedule ux1#sked5 on tuneeds 2 dbase :job1jobrel follows job1job2 follows jobrelend

Para liberar o recursodbaseantes dejob2 ser iniciado, o arquivo descript parajobrel contém o seguinte comando:vmaestrov/bin/release -s dbase

Observe que o argumento-s pode ser omitido, uma vez que nenhumrecurso foi reservado no nível do job.

No fluxo de job a seguir, oito unidades do recursodiscio sãorequeridas pelo fluxojob2: Isso é definido em dois blocos de 5 e 3para que possam ser liberadas incrementalmente na mesma ordemem que foram adquiridas.schedule ux1#sked7 on weekdays:job1job2 follows job1 needs 5 discio,3 disciojob3 follows job2end

Para liberar o recursodiscio incrementalmente enquantojob2 estásendo executado, o script parajob2 contém as seguintes linhas decomandos:...# Liberar 5 unidades de discio:vmaestrov/bin/release discio...# Liberar 3 unidades de discio:vmaestrov/bin/release discio...


276 Versão 7.0

Comando rextractExtrai informações sobre recursos do banco de dados do TWS.

Sinopserextract [-v | -u] [ -o file]




Saída de ComandoCada registro de recurso contém campos de comprimento variável,delimitados por tabulação. Os campos são descritos na tabela aseguir.



2 nome do recurso 8

3 unidades de recurso totais 4

4 descrição do recurso 72


ExemplosExtrai informações sobre todas as definições de recurso e canaliza asaída para o arquivoreinfo:rextract -o reinfo



4.C

omandos

Utilitários

Comando rmstdlistRemove ou exibe arquivos de lista padrão com base no tempo doarquivo.

Sinopsermstdlist -v | -u

rmstdlist [-p] [age]



-p Exibe os nomes dos diretórios de arquivos de lista padrãoqualificados. Nenhum diretório ou arquivo é removido. Sevocê não especificar-p, os arquivos de lista padrãoqualificados serão removidos.

age O tempo mínimo, em dias, para os diretórios de arquivos delista padrão serem exibidos ou removidos. O padrão é 10dias.

ExemplosO exemplo a seguir exibe os nomes dos diretórios de arquivos delista padrão com mais de 14 dias:rmstdlist -p 14

O exemplo a seguir remove todos os arquivos de lista padrão (e seusdiretórios) com mais de 7 dias:rmstdlist 7


278 Versão 7.0

Comando showexecExibe o status de execução dos jobs. Apenas no UNIX. Essecomando serve para os agentes padrão. Nos gerenciadores dedomínio e agentes de tolerância a falhas, utilize o comandoconmanshowjobs

no lugar.

Sinopseshowexec[-v | -u | -info]



-info Exibe o nome do arquivo de job em vez do usuário, data ehora.

Saída de ComandoA saída do comando está disponível em dois formatos: padrão einfo.

Formato Padrão

CPU A estação de trabalho na qual o job é executado.

Agenda O nome do fluxo de job no qual o job é executado.

Job O nome do job.

Job# O número do job.

Usuário O nome de usuário do job.

Data de InícioA data em que o job iniciou a execução.

Hora de InícioA hora em que o job iniciou a execução.

Tempo Decorrido (Estimado)O tempo estimado, em minutos, no qual o job seráexecutado.



4.C

omandos

Utilitários

Formato info

CPU A estação de trabalho na qual o job é executado.

Agenda O nome do fluxo de job no qual o job é executado.

Job O nome do job.

Job# O número do job.

JCL O nome do arquivo do job.

ExemplosO exemplo a seguir exibe a execução dos jobs no formato padrão:showexec

O exemplo a seguir exibe a execução dos jobs no formatoinfo:showexec -info


280 Versão 7.0

Comando StartUpInicia o processo de gerenciamento de rede do TWS, Netman. Vocêdeve ter acessostart

para a estação de trabalho.

SinopseStartUp [-v | -u]



Notas de UtilizaçãoNo Windows NT, o serviço Netman é iniciado automaticamentequando um computador é reiniciado.StartUp pode ser utilizado parareiniciar o serviço se ele for parado por algum motivo.

No UNIX, o comandoStartUp é, geralmente, instalado no arquivo/etc/rc, para que o Netman seja iniciado toda vez que umcomputador for reinicializado.StartUp pode ser utilizado parareiniciar o Netman se ele for parado por algum motivo.

O restante da árvore de processo pode ser reiniciado com umcomandoconman start. Consulte “start” na página 208 para obtermais informações.

ExemplosO exemplo a seguir exibe o nome e a versão do comando:StartUp -v

O exemplo a seguir inicia o processo Netman:StartUp



4.C

omandos

Utilitários

Comando versionExibe informações sobre a versão do Tivoli Workload Scheduler.Apenas no UNIX. As informações são extraídas de um arquivo deversão.

Sinopseversion/version -V | -u | -h

version/version [-a] [ -f vfile] [ -p product] [ file [...]]

Argumentos-V Exibe a versão do comando e sai.


-h Exibe informações de auxílio do comando e sai.

-a Exibe informações sobre todos os arquivos de produtos. Opadrão é exibir informações apenas sobre os arquivosespecificados.

-f vfile Especifica o nome do arquivo de versão. O padrão é umarquivo chamadoversion.info no diretório de trabalho atual,ou no diretório do produto especificado com-p.

-p productEspecifica o nome do produto Tivoli cujo diretório estádiretamente abaixo do diretório de trabalho atual, e contémum arquivoversion.info. Se omitido,-f, ou seu padrão, seráutilizado.

file Especifica os nomes de arquivos de produtos, separados porespaços, para os quais as informações sobre a versão sãoexibidas. O padrão é não exibir informações sobre osarquivos, ou, se-a for utilizado, exibirá todas as informaçõessobre os arquivos.

Saída de ComandoO cabeçalho de saída contém o nome do produto, a versão, aplataforma, o nível de correção e a data de instalação. O restante datela lista informações sobre o arquivo ou arquivos especificados. Osarquivos são listados no seguinte formato:


282 Versão 7.0

Arquivo O nome do arquivo.

Revisão O número de revisão do arquivo.

Correção O nível de correção do arquivo, se houver.

Tamanho (bytes)O tamanho do arquivo em bytes.

Checksum O checksum do arquivo. Checksums são calculadoscom o comandosum do UNIX. No AIX, sum éutilizado com o argumento-o.

Notas de UtilizaçãoAs informações de arquivo do TWS estão contidas no arquivoversion.info. Este arquivo é colocado no diretórioTWShome/versiondurante a instalação. O arquivoversion.info está em um formatoespecífico e não deve ser alterado.

Você pode mover o arquivoversion.info para outro diretório. Noentanto, deverá incluir, em seguida, o argumento-f para localizar oarquivo.

Você poderá utilizar o argumento-p se seu diretório atual contiveros diretórios de vários produtos do Tivoli. Isso permite que vocêacesse informações sobre a versão especificando o nome do produto.

ExemplosO exemplo a seguir exibe informações sobre todos os arquivos:version/version -a -f version/version.info

O exemplo a seguir exibe informações sobre o arquivocustomize:cd version./version customize

O exemplo a seguir exibe informações sobre o arquivocustomizequandoversion.info está localizado em/apps/maestro:cd version./version -f /apps/maestro/version.info customize



4.C

omandos

Utilitários

Comando wmaeutilUtilizado para encerrar o servidor de conector para o plano, bancode dados e mecanismo. O comando makesec não será executado comêxito no Windows NT até que os conectores sejam encerrados.

Sinopsewmaeutilinstance_name[-stop DB | PL | EG | “*”] [-version DB |PL | EG | “*”] [-dbinfo DB | PL | “*”] [-sethome] [-gethome][ALL -stop]

Argumentosinstance_name

O nome da ocorrência do TWS. Isso refere-se ao nome daocorrência que você digitou durante a instalação domecanismo do TWS e à instalação do conector.

-stop DB | PL | EG | “*”Esta opção pode ser utilizada para encerrar o servidor deconector especificado. O asterisco (*) pode ser utilizado paraencerrar todos os três servidores de conector. Se forutilizado, ele deve ser colocado entre aspas.

-version DB | PL | EG | “*”Esta opção é utilizada para obter o número de versão doservidor de conector, para o plano, banco de dados emecanismo, que está instalado no sistema. O asterisco (*)pode ser utilizado para obter versões de todos os trêsservidores de conector de uma vez. Se for utilizado, ele deveser colocado entre aspas.

-dbinfo DB | PL | “*”Esta opção é utilizada para descobrir se o banco de dados eo plano do TWS ao qual este conector está ligado éexpandido ou não-expandido. O asterisco (*) pode serutilizado para obter versões para o banco de dados e oplano.If used, it must be enclosed by double quotes.

-sethomeEsta opção é utilizada para definir o atributoMaestroHomeDir dos objetos TWS (Engine, Database e


284 Versão 7.0

Plan) no banco de dados de objetos do Tivoli. O valor deatributo liga os conectores da ocorrência do objetoespecificada ao produto de núcleo do TWS. Ele obtém onome completamente qualificado do diretório pessoal doTWS como um argumento. Além disso, a cadeia de nome decaminho deve ser delimitada entre aspas para evitar qualquerinterpretação de shell.

-gethomeEsta opção não requer argumentos e imprime o valor doatributo TWShome para as ocorrências de objeto Engine,Database e Plan, conforme definido no banco de dados deobjetos.

ALL -stopEsta opção encerra os servidores de conector de todas asocorrências de conector do TWS conectadas à instalaçãoatual do TWS, ou seja, ela encerra os servidores de conectorde todas as ocorrências cujo atributo TWShome correspondaao diretório pessoal da instalação atual do TWS.

Notas de Utilização

Definir Variáveis de Ambiente:Para que o wmaeutil possa ser executado com êxito, você deve antesexecutar o seguinte arquivo para poder definir o ambiente deestrutura.

No Windows NT:c: \> %SystemRoot%\system32\drivers\etc\Tivoli\setup_env.cmd

Para UNIX:$ . /etc/Tivoli/setup_env.sh

Você pode atualizar o perfil UNIX para executar este arquivo, paranão ter que executar o comando manualmente.

Considerações sobre Makesec:O comando wmaeutil deve ser executado antes da execução docomando makesec. O comando makesec não será executado com



4.C

omandos

Utilitários

êxito no Windows NT até que os conectores sejam encerrados. Vocêtambém deve encerrar os conectores ao usar o comando makesec noUNIX.

Nome da Ocorrência do TWSSe você não lembrar do nome da ocorrência que foi digitado nainstalação, execute as seguintes etapas:

1. Procure a fonte das variáveis de ambiente do Tivoli:. /etc/Tivoli/setup_env.sh (para UNIX)

C:\winnt\system32\drivers\etc\Tivoli\setup_env.cmd (for NT)

2. Execute o comandowlookup para obter o nome da ocorrência doTWS:wlookup -ar MaestroEngine

maestro2 1697429415.1.596#Maestro::Engine#

ondemaestro2é o nome da ocorrência do TWS.

ExemplosEncerre os conectores para o banco de dados, plano e mecanismo deuma ocorrência chamada maestro:wmaeutil maestro -stop *

Encerre os conectores para o banco de dados de uma ocorrênciachamada tws:wmaeutil tws -stop DB

Encerre as versões de conector para o banco de dados, plano emecanismo de uma ocorrência chamada maestro2:wmaeutil maestro2 -version *


286 Versão 7.0

Comando xrxtrctExtrai informações sobre referências cruzadas do banco de dados doTWS.

Sinopsexrxtrct [-v | -u]




A saída do comando é gravada em oito arquivos,xdep_job,xdep_sched, xfile, xjob, xprompt , xresources,xschede xwhen.

Arquivo xdep_job:O arquivoxdep_job contém dois tipos de registros. O primeirocontém informações sobre jobs e fluxos de job que são dependentesde um job. Cada registro de job e fluxo de job dependente contémcampos de comprimento fixo, sem delimitadores. Os campos sãodescritos na tabela a seguir.

Campo Descrição Comprimento(bytes) *

1 03 2


3 nome do job 8/40



4.C

omandos

Utilitários



5 não utilizado 240

6 nome da estação de trabalho do fluxo de job dependente 8/16

7 nome do fluxo de job dependente 8/16

8 nome da estação de trabalho do job dependente 8/16

9 nome do job dependente 8/40

10 não utilizado 6

11 não utilizado 6

12 não utilizado 8

13 fim do registro (nulo) 1


O segundo tipo de registro contém informações sobre jobs e fluxosde job que são dependentes de uma dependência entre redes. Cadaregistro de job e fluxo de job dependente contém campos decomprimento fixo, sem delimitadores. Os campos são descritos natabela a seguir.


1 08 2


3 nome do job 120






9 não utilizado 6

10 não utilizado 6

11 não utilizado 8


288 Versão 7.0




Arquivo xdep_sched:O arquivoxdep_schedcontém informações sobre fluxos de job quesão dependentes de um fluxo de job. Cada registro de fluxo de jobdependente contém campos de comprimento fixo, sem delimitadores.Os campos são descritos na tabela a seguir.


1 02 2




5 nome da estação de trabalho do fluxo de jobdependente

8/16


7 não utilizado 8

8 não utilizado 8

9 não utilizado 6

10 não utilizado 6

11 não utilizado 8



Arquivo xfile:O arquivoxfile contém informações sobre jobs e fluxos de job quesão dependentes de um arquivo. Cada registro contém campos decomprimento fixo, sem delimitadores. Os campos são descritos natabela a seguir.



4.C

omandos

Utilitários


1 07 2


3 nome do arquivo 256

4 nome da estação de trabalho do fluxo de jobdependente

8/16


6 nome da estação de trabalho do jobdependente

8/16


8 não utilizado 6

9 não utilizado 6

10 não utilizado 8



Arquivo xjob:O arquivoxjob contém informações sobre os fluxos de job nos quaiscada job aparece. Cada registro de job contém campos decomprimento fixo, sem delimitadores. Os campos são descritos natabela a seguir.


1 04 2


3 nome do job 8/40


5 nome da estação de trabalho do fluxo de Job 8/16


7 não utilizado 8

8 não utilizado 8


290 Versão 7.0


9 não utilizado 6

10 não utilizado 6

11 não utilizado 8



Arquivo xprompt:O arquivoxprompt contém informações sobre jobs e fluxos de jobque são dependentes de um prompt. Cada registro de prompt contémcampos de comprimento fixo, sem delimitadores. Os campos sãodescritos na tabela a seguir.


1 05 2


3 nome ou texto do prompt 20






9 não utilizado 6

10 não utilizado 6

11 não utilizado 8





4.C

omandos

Utilitários

Arquivo xresource:O arquivoxresourcecontém informações sobre jobs e fluxos de jobque são dependentes de um recurso. Cada registro de recurso contémcampos de comprimento fixo, sem delimitadores. Os campos sãodescritos na tabela a seguir.


1 06 2


3 nome do recurso 8






9 unidades alocadas 6

10 não utilizado 6

11 não utilizado 8



Arquivo xsched:O arquivoxschedcontém informações sobre fluxos de job. Cadaregistro de fluxo de job contém campos de comprimento fixo, semdelimitadores. Os campos são descritos na tabela a seguir.


1 00 2




5 nome da estação de trabalho (o mesmo de 2 acima) 8/16


292 Versão 7.0


6 nome do fluxo de job (o mesmo de 3 acima) 8/16

7 não utilizado 8

8 não utilizado 8

9 não utilizado 6

10 não utilizado 6

11 não utilizado 8



Arquivo xwhen:O arquivoxwhen contém informações sobre quando os fluxos de jobserão executados. Cada registro de fluxo de job contém os camposde comprimento fixo, sem delimitadores, a seguir. Os campos sãodescritos na tabela a seguir.


1 01 2


3 nome ou data ON/EXCEPT 8

4 sinalizador de exceção (*=EXCEPT) 1




8 não utilizado 8

9 não utilizado 8

10 não utilizado 6

11 núm. de deslocamento 6

12 unidade de deslocamento 8





4.C

omandos

Utilitários

ExemplosExtrai informações sobre todas as referências cruzadas:xrxtrct


294 Versão 7.0

ComandosNão-suportados

Os seguintes comandos utilitários não-suportados fornecem funçõesno Windows NT semelhantes aos comandosps

e kill

do UNIX. Eles poderão ser utilizados se utilitários semelhantes doWindows NT não estiverem disponíveis.

Sinopselistproc

killproc pid

Notas de Utilizaçãolistproc

Exibe uma listagem tabular de processos no sistema.

killprocElimina o processo com o ID de processopid.

CUIDADO:Quando executado pelo Administrador, killproc é capaz deeliminar processos de sistema.



4.C

omandos

Utilitários


296 Versão 7.0

Referência do Agente Estendido

Este capítulo descreve a interface do agente estendido e forneceinformações para programadores que precisam criar métodos deacesso personalizados.

O Tivoli Systems possui vários agentes estendidos que podem serintegrados ao Tivoli Workload Scheduler. Para obter informaçõesespecíficas sobre um determinado agente estendido, consulte adocumentação referente a ele.

O que são Agentes Estendidos?São agentes utilizados para estender as funções de planejamento dejob do Workload Scheduler a outros sistemas e aplicativos.

Um agente estendido é definido como uma estação de trabalho quetem um host e um método de acesso. O host é qualquer outraestação de trabalho, exceto outro agente estendido. O método deacesso é um script ou programa fornecido pelo Tivoli ou pelo

5


5.R

eferênciado

Agente

Estendido

usuário e executado pelo host sempre que o agente estendido éreferido no plano de produção. Por exemplo, para lançar um job emum agente estendido, o host executa o método de acesso,transmitindo a ele detalhes do job como opções da linha decomandos. O método de acesso comunica-se com o sistema externoou aplicativo para lançar o job e retornar o status do job.

Definição de Estação de TrabalhoCada agente estendido deve ter uma definição de estação de trabalhológica. Essa estação de trabalho lógica deve ser hospedada por umaestação de trabalho física do TWS, seja Mestre, gerenciador dedomínio ou FTA. A definição de estação de trabalho do agenteestendido faz referência ao nome do método de acesso e da estaçãode trabalho do host. Quando jobs são lançados na estação detrabalho do agente estendido, o método de acesso é chamado etransmite as informações do job ao sistema externo. Para obter umexemplo de definição de uma estação de trabalho do agenteestendido, consulte oTivoli Workload Scheduler - Guia do Usuário.

Interface do Método de AcessoA interface entre o Workload Scheduler e um método de acessoconsiste em informações transmitidas ao método na linha decomandos e em mensagens retornadas ao Workload Scheduler emstdout.

Sintaxe da Linha de Comandos do MétodoO host do Workload Scheduler executa um método de acessoutilizando a seguinte sintaxe da linha de comandos:

methodname-t task options-- taskstring

onde:

methodnameEspecifica o nome do arquivo do método de acesso. Todosos métodos de acesso devem ser armazenados no diretório:WShome/methods

O que são Agentes Estendidos?

298 Versão 7.0

-t task Especifica a tarefa a ser executada, ondetaské uma dasseguintes:

LJ Lança um job.

MJ Gerencia um job lançado anteriormente. Utilize essaopção para sincronizar novamente se uma tarefaLJanterior tiver terminado inesperadamente.

CF Verifica a disponibilidade de um arquivo. Utilizeessa opção para verificar as dependênciasopens.

GS Obtém o status de um job. Utilize essa opção paraverificar as dependênciasfollows do job.

optionsEspecifica as opções associadas à tarefa. Consulte “Opçõesde Tarefas” para obter mais informações.

taskstringUma cadeia de até 255 caracteres associada à tarefa.Consulte “Opções de Tarefas.”

Opções de TarefasAs opções de tarefas são listadas na tabela a seguir. Um X significaque a opção é válida para a tarefa.

Tarefa Opções Cadeia daTarefa

-t -c -n -p -r -s -d -l -o -j -q -w

LJ X X X X X X X X X ljstring

MJ X X X X X X X X X mjstring

CF X X X X cfstring

GS X X X X X X gsstring

-c xagent,host,masterEspecifica os nomes do agente estendido, do host e dogerenciador de domínio mestre do Workload Scheduler,separados por vírgulas.

-n nodenameEspecifica o nome de nó do computador associado ao agente

Interface do Método de Acesso


5.R

eferênciado

Agente

Estendido

estendido, se houver. Isso é definido no campoNó dadefinição de estação de trabalho do agente estendido.

-p portnumberEspecifica o número da porta TCP associada ao agenteestendido, se houver. Isso é definido no campoEndereço doTCP da definição de estação de trabalho do agenteestendido.

-r currentrun,specificrunEspecifica o número de execução atual do WorkloadScheduler e o número de execução específico associado aojob, separados por uma vírgula. Os números de execuçãoatual e específico poderão ser diferentes se o job tiver sidotransportado de uma execução anterior.

-s jstreamEspecifica o nome do fluxo do job.

-d scheddate,epochEspecifica a data de planejamento (aammdd) e o períodoequivalente, separados por uma vírgula.

-l user Especifica o nome de usuário do job. Isso é definido nocampoInício de Sessãoda definição de job.

-o stdlistEspecifica o nome completo do caminho do arquivo delistagem padrão do job. Qualquer saída do job deverá sergravada nesse arquivo.

-j jobname,idEspecifica o nome do job e o identificador exclusivoatribuído pelo Workload Scheduler, separados por umavírgula. O nome é definido no campoNome do Jobdadefinição de job.

-q qualifierEspecifica o qualificador a ser utilizado em um comando deteste emitido pelo método junto ao arquivo.

-w timeoutEspecifica o período de tempo, em segundos, que oWorkload Scheduler aguarda para obter uma resposta em um


300 Versão 7.0

job externo antes de enviar um sinal SIGTERM para ométodo de acesso. O padrão é 300.

-- ljstringUtilizado com a tarefaLJ . A cadeia do campoArquivo deScript ou Comando da definição de job.

-- mjstringUtilizado com a tarefaMJ . As informações fornecidas aoWorkload Scheduler pelo método em uma resposta%CJ auma tarefaLJ . Em geral, isso identifica o job que foilançado. Por exemplo, um método UNIX pode fornecer oPID (identificação do processo) do job lançado, que éenviado, em seguida, pelo Workload Scheduler como partede uma tarefaMJ .

-- cfstringUtilizado com a tarefaCF. Para a dependênciaopensde umarquivo, a cadeia do campoArquivos Opens da definiçãodo fluxo de job.

-- gsstringUtilizado com a tarefaGS. Especifica o job cujo status foiverificado. O formato é o seguinte:

followsjob[,jobid]

onde:

followsjobA cadeia da listaFollows Sched/Jobda definição dofluxo de job.

jobid Um identificador de job opcional recebido peloWorkload Scheduler em uma resposta%CJ a umatarefaGS anterior.

Mensagens de Resposta do MétodoOs métodos retornam informações ao Workload Scheduler emmensagens gravadas nostdout. Toda linha começando com um sinal



5.R

eferênciado

Agente

Estendido

de porcentagem (%) e terminando com uma nova linha, éinterpretada como uma mensagem. As mensagens possuem oseguinte formato:

%CJ state [mjstring | jobid]

%JS [cputime]

%UT [errormessage]

onde:

CJ Altera o estado do job.

state O estado para o qual o job é alterado. Todos osestados de job do Workload Scheduler são válidos,excetohold e ready. Para a tarefaGS, os seguintesestados também são válidos:

ERROROcorreu um erro.

EXTRNStatus desconhecido.

mjstringUma cadeia de até 255 caracteres que o WorkloadScheduler incluirá em qualquer tarefaMJ associadaao job. Consulte “mjstring” a seguir “Opções deTarefas” na página 299.

jobid Uma cadeia de até 64 caracteres que o WorkloadScheduler incluirá em qualquer tarefaGS associadaao job. Consulte “gsstring” a seguir “Opções deTarefas” na página 299.

JS [cputime]Indica a conclusão bem-sucedida de um job e fornece seutempo de execução decorrido em segundos.

UT [errormessage]Indica que a tarefa solicitada não é suportada pelo método.


302 Versão 7.0

Exibe uma cadeia de até 255 caracteres que o WorkloadScheduler incluirá em sua mensagem de erro.

Arquivo de Opções do MétodoÉ possível utilizar um arquivo de opções do método para especificarinformações especiais de início de sessão e outras opções. OWorkload Scheduler lerá o arquivo, se existir, antes de executar ummétodo. Se o arquivo for modificado após o Workload Scheduler tersido iniciado, as alterações serão efetivadas quando ele for encerradoe reiniciado.

O arquivo pode conter opções do Workload Scheduler e qualqueroutra informação sobre o método. As opções reconhecidas peloWorkload Scheduler são as seguintes:

LJuser=username

CFuser=username

GSuser=username

GStimeout=seconds

onde:

LJuser=usernameEspecifica o início de sessão a ser utilizado para as tarefasLJ e MJ . O padrão é o início de sessão da definição de job.

CFuser=usernameEspecifica o início de sessão a ser utilizado para a tarefaCF.O padrão éroot no UNIX, e no Windows NT é o nome dousuário da conta em que o Workload Scheduler foi instalado.

GSuser=usernameEspecifica o início de sessão a ser utilizado para as tarefasGS. O padrão éroot no UNIX, e no Windows NT é o nomedo usuário da conta em que o Workload Scheduler foiinstalado.



5.R

eferênciado

Agente

Estendido

GStimeout=secondsEspecifica o período de tempo, em segundos, que oWorkload Scheduler aguarda uma resposta antes de eliminaro método de acesso. O padrão é 300 segundos.

Nota: Se o host do agente estendido for um computador doWindows NT, esses usuários deverão ser definidos comoobjetos do usuário do Workload Scheduler.

O arquivo de opções deve ter o mesmo nome de caminho de seumétodo de acesso, com uma extensão de arquivo.opts. Por exemplo,o nome do caminho do Windows NT de um arquivo de opções paraum método chamadonetmth é WShome\methods\netmth.opts.

Execução do MétodoOs tópicos a seguir descrevem o intercâmbio entre o WorkloadScheduler e um método de acesso.

Tarefa Lançar Job (LJ)A tarefaLJ orienta o método do agente estendido para lançar um jobem um sistema ou aplicativo externo. Antes de executar o método, oWorkload Scheduler estabelece um ambiente de execução. OparâmetroLJuser é lido a partir do arquivo de opções do métodopara determinar a conta do usuário com a qual executar o método.Se o parâmetro não estiver presente ou o arquivo de opções nãoexistir, a conta do usuário especificada no campoInício de Sessãoda definição do job será utilizada. Além disso, as seguintes variáveisde ambiente são definidas:

HOMEO diretório pessoal do usuário de início de sessão.

LOGNAMEO nome do usuário de início de sessão.

PATH No UNIX, ele é definido como/bin:/usr/bin . No WindowsNT, como%SYSTEM%\SYSTEM32 .

TZ O fuso horário.


304 Versão 7.0

Se o método não puder ser executado, o job será colocado no estadofail .

Depois de um método ser executado, ele grava mensagens em seustdout que indica o estado do job no sistema externo. As mensagenssão resumidas na tabela a seguir.

Tarefa Resposta do Método Ação do Workload Scheduler

LJ e MJ %CJ state[mjstring] Define o estado do job comostate.Inclui mjstring em qualquer tarefaMJ subseqüente.

%JS [cputime] Define o estado do job comosucc.

Código desaída=diferente de zero

Define o estado do job comoabend.

%UT [errormessage] eCódigo de saída=2

Define o estado do job comoabend e exibeerrormessage.

Uma seqüência comum consiste em uma ou mais mensagens%CJindicando alterações no estado do job e, em seguida, uma mensagem%JS antes do método sair para indicar que o job terminou comêxito. Se o job não for bem-sucedido, o método deverá sair semgravar a mensagem%JS. Um método que não suporta a tarefaLJgrava uma mensagem%UT no stdout e sai com um código de saída2.

Tarefa Gerenciar Job (MJ)A tarefaMJ será utilizada para sincronizar com um job lançadoanteriormente se o Workload Scheduler determinar que a tarefaLJterminou inesperadamente. O Workload Scheduler configura oambiente da mesma maneira que para a tarefaLJ e transmite amjstring. Consulte “Tarefa Lançar Job (LJ)” na página 304 para obtermais informações.

Se o método localizar o job especificado, ele responderá com asmesmas mensagens de uma tarefaLJ . Se o método não conseguirlocalizar o job, ele sairá com um código de saída diferente de zero,fazendo com que o Workload Scheduler coloque o job no estadoabend.

Execução do Método


5.R

eferênciado

Agente

Estendido

Como Eliminar um JobEnquanto uma tarefaLJ ou MJ está sendo executada, o métododeve detectar um sinal SIGTERM (sinal15). O sinal é enviadoquando um operador emite um comandoKill através do gerenciadorde console do Workload Scheduler. No recebimento do sinal, ométodo deve tentar parar (kill ) o job e sair sem gravar umamensagem%JS.

Tarefa Verificar Arquivo (CF)A tarefaCF solicita o método do agente estendido para verificar adisponibilidade de um arquivo no sistema externo. Antes de executaro método, o Workload Scheduler estabelece um ambiente deexecução. O parâmetroCFuser é lido a partir do arquivo de opçõesdo método para determinar a conta do usuário com a qual executar ométodo. Se o parâmetro não estiver presente ou o arquivo de opçõesnão existir, o usuárioroot será utilizado no Unix e no Windows NT,será utilizado o nome do usuário da conta em que o WorkloadScheduler foi instalado. Se o método não puder ser executado, adependênciaopensdo arquivo será marcada como falha, isto é, ostatus do arquivo será definido comoNO e qualquer job ou fluxo dejob dependente não terá permissão para executar.

Durante a execução, o método executa um comando de teste, ouequivalente, no arquivo que está utilizando o qualificador transmitidoa ele na opção-q da linha de comandos. Se o teste do arquivo forverdadeiro, o método sairá com um código de saída zero. Se o testedo arquivo for falso, o método sairá com um código de saídadiferente de zero. Isso é resumido na tabela a seguir.


CF Código de saída=0 Define o estado do arquivo comoYES.

Código desaída=diferente de zero

Define o estado do arquivo comoNO.


Define o estado do arquivo comoNO.


306 Versão 7.0

Um método que não suporta a tarefaCF grava uma mensagem%UT no stdout e sai com um código de saída2.

Tarefa Obter Status (GS)A tarefaGS informa ao método do agente estendido para verificar ostatus de um job. Isso é necessário quando outro job depende daconclusão bem-sucedida de um job externo. Antes de executar ométodo, o parâmetroGSuseré lido a partir do arquivo de opções dométodo para determinar a conta de usuário com a qual executar ométodo. Se o parâmetro não estiver presente ou o arquivo de opçõesnão existir, o usuárioroot será utilizado no Unix e no Windows NT,será utilizado o nome do usuário da conta em que o WorkloadScheduler foi instalado. Se o método não puder ser executado, o jobou fluxo de job dependente não terá permissão para executar. Se umjobid estiver disponível a partir de uma tarefaGS anterior, ele serátransmitido para o método.

O método verifica o estado do job especificado e o retorna em umamensagem%CJ gravada nostdout. Em seguida, sai com um códigode saída zero. Em uma taxa definida pela opção localstatus deverificação de bm, o método é executado novamente com umatarefaGS até que um dos seguintes estados de job sejam retornados:

abend O job terminou de forma anormal.

succ O job foi concluído com êxito.

cancl O job foi cancelado.

done O job terminou, mas seu êxito ou falha não foi indicado.

fail O job não pôde ser executado.

error Ocorreu um erro no método durante a verificação do statusdo job.

extrn A verificação do job falhou ou o status do job não pôde serdeterminado.

Observe queGStimeout no arquivo de opções do método especificaquanto tempo o Workload Scheduler irá aguardar uma resposta antesde eliminar o método. Consulte “Arquivo de Opções do Método” napágina 303 para obter mais informações.



5.R

eferênciado

Agente

Estendido

As respostas dos métodos são resumidas na tabela a seguir:


GS %CJ state[jobid] Define o estado do job comostateeinclui jobid em qualquer tarefaGSsubseqüente.


O estado do job fica inalterado.

Um método que não suporta a tarefaGS grava uma mensagem%UT no stdout e sai com um código de saída2.

O Comando cpuinfoO comandocpuinfo pode ser utilizado em um método de acessopara retornar informações de uma definição de estação de trabalho.Consulte “Comando cpuinfo” na página 245 para obter informaçõescompletas sobre o comando.

Detecção de ProblemasOs tópicos a seguir são fornecidos para ajudá-lo a detectar e depurarproblemas do agente estendido e do método de acesso.

Mensagens de Erro da Lista Padrão de JobsTodas as mensagens de saída de um método de acesso, exceto asiniciadas com um sinal de porcentagem (%), são gravadas noarquivo de lista padrão de jobs (stdlist). Para as tarefasGS e CFnão associadas a jobs do Workload Scheduler, as mensagens sãogravadas no arquivo de lista padrão do Workload Scheduler. Paraobter informações relativas a qualquer tipo de problema, verifiqueesses arquivos.

Método Não ExecutávelSe um método de acesso não puder ser executado, ocorrerá oseguinte:

¶ Para as tarefasLJ e MJ , o job será colocado no estadofail .

¶ Para a tarefaCF, a dependência de arquivo ficará sem solução eo job dependente permanecerá no estadohold.


308 Versão 7.0

¶ Para a tarefaGS, a dependência de job ficará sem solução e ojob dependente permanecerá no estadohold.

Para obter mais informações, consulte novamente os arquivos delista padrão (stdlist) do job e do Workload Scheduler.

Mensagens do Gerenciador de ConsoleEsta mensagem de erro será exibida se você emitir um comandostart, stop, link ou unlink para um agente estendido:Erro na execução do comando: Não implementado para agentesestendidos. [2202.58]

Esse erro não será exibido se um agente estendido for selecionadocomo resultado da utilização de caracteres curinga.

Mensagens do Composer e do CompilerAs mensagens de erro a seguir são geradas quando o Composerencontra sintaxe inválida em uma definição de estação de trabalho:MÉTODO DE ACESSO sintaticamente inválido [1116.45]

Palavra-chave de ACESSO duplicada [1116.46]

MÉTODO DE ACESSO ausente ou inválido [1116.47]

Se um agente estendido for definido com um método de acesso, massem um host, a seguinte mensagem será exibida:"O método precisa de uma CPU do Host"

Mensagens do JobmanPara agentes estendidos, as mensagens de erro, de aviso einformativas são gravadas no arquivostdlist do Jobman.

O lançamento bem-sucedido de um job gera a seguinte mensagem:Job jobname lançado para wkstation, #Jjobid para usuário username.

O lançamento mal sucedido de um job gera a seguinte mensagem:Erro ao lançar jobname para wkstation: errortext

Falha em uma tarefa de verificação de arquivo gera a seguintemensagem:Erro ao chamar methodname para wkstation: errortext

Detecção de Problemas


5.R

eferênciado

Agente

Estendido

Falha em uma tarefa de gerenciamento de job gera a seguintemensagem:Erro ao gerenciar jobname para wkstation utilizando methodname: errortext

Quando um método envia uma mensagem para o Jobman, mas não éreconhecida, é gerada a seguinte mensagem:Erro: mensagem inválida para jobname, #jjobnumber parawkstation usando methodname.

"primeiros 64 caracteres da mensagem afetada"

Detecção de Problemas

310 Versão 7.0

Referência do Agente de Rede

As dependências entre redes do TWS permitem aos jobs e fluxos dejob em uma rede local do TWS utilizarem jobs e fluxos de job emuma rede remota como dependências follows. Este capítulo descrevecomo utilizar as dependências entre redes.

Visão geralUm agente de rede é uma definição de estação de trabalho lógicaque permite dependências follows entre uma rede local e uma rederemota do TWS. Dependências follows remotas são atribuídas a jobse fluxos de job da mesma maneira que as dependências followslocais, exceto que o nome do agente de rede é incluído paraidentificar que o job ou fluxo de está em uma rede externa do TWS.Esses tipos de dependência são chamados dependências entre redes.

Se algum fluxo de job com dependências entre redes for incluído noplano, um fluxo de job especial chamadoEXTERNAL será criadopara exibir o status dessas dependências. Este fluxo de jobEXTERNAL contém jobs marcadores para representar cadadependência follows remota.

A definição de estação de trabalho de um agente de rede contém onome do método de acesso da rede,netmth. Um arquivo de opçõesé utilizado para especificar o usuário sob o qual o método éexecutado, e a taxa com que a dependência remota do job ou fluxodo job é verificada. Esse arquivo de opções deve ter o mesmo nomede caminho do método de acesso e deve chamarnetmth.opts.

6


6.R

eferênciado

Agente

deR

ede

O método de acesso é chamado pelo TWS toda vez que ele precisaverificar o status de um job ou fluxo de job remoto. O método deacesso consulta a rede remota para saber o status do job ou fluxo dejob predecessor. O TWS continua a verificação até que o job oufluxo de job remoto alcance o estado SUCC, CANCL ou ERROR.

Você pode monitorar o status de dependências entre redes com o JobScheduling Console através da exibição do fluxo de jobEXTERNAL .

Como Configurar uma Estação de Trabalho doAgente de Rede

Antes de poder especificar uma dependência entre redes, você devecriar uma definição de estação de trabalho do TWS para a rederemota. A definição de estação de trabalho de uma rede remotachama-se Agente de Rede. As definições de estação de trabalho doagente de rede são feitas de maneira padrão como AgentesEstendidos e requerem uma estação de trabalho host e um método deacesso,netmeth.

Para definir uma estação de trabalho do Agente de Rede no banco dedados do TWS:

1. Destaque o Mecanismo do TWS.

2. No Menu Selecionado, clique em Nova Estação de Trabalho. Ajanela Propriedades - Estação de Trabalho é exibida.

3. No campo Nome, especifique um nome para esta estação detrabalho. O nome da estação de trabalho pode ter até 8caracteres alfanuméricos para o banco de dados não-expandidoou 16 caracteres alfanuméricos para o banco de dadosexpandido. O nome pode incluir um traço e um sublinhado, masdeve começar com uma letra.

4. No campo Nó, especifique o nome do nó ou o endereço IPdesta estação de trabalho. Nomes de domínio completamentequalificados são aceitos. Este é um campo obrigatório.

5. No campo Porta TCP, digite 0.

Visão geral

312 Versão 7.0

6. No campo Sistema Operacional, digite OTHER.

7. No campo Domínio, especifique o domínio da estação detrabalho host.

8. No campo Fuso Horário, especifique o fuso horário destaestação de trabalho (opcional).

9. No campo Descrição, especifique uma descrição da estação detrabalho. Ela pode conter até 40 caracteres e deve começar comuma letra.

10. No campo Estação de Trabalho, selecione Agente Estendido nalista pendente.

11. Deixe a caixa de opções Link Automático vazia.

12. Deixe a caixa de opções Status Completo vazia.

13. Deixe a caixa de opções Ignorar vazia.

14. Deixe a caixa de opções Resolver Dependências vazia.

15. Deixe o campo Servidor vazio.

16. No campo Método de Acesso, digitenetmeth.

17. No campo Host, especifique o nome do nó da estação detrabalho host ou selecione um na lista fornecida, clicando nobotão Estações de Trabalho.

18. Clique emOK . A estação de trabalho Agente da Rede é salvano banco de dados do TWS.

Exemplo de Linha de Comandos do Agente de RedeO exemplo a seguir mostra uma definição de linha de comandos daestação de trabalho para o agente de rede:CPUNAME NETAGT

DESCRIPTION "NETWORK AGENT"

OS OTHER

NODE MAIN

TCPADDR 31111

FOR maestro

HOST MASTER

ACCESS NETMTH

Como Configurar uma Estação de Trabalho do Agente de Rede


6.R

eferênciado

Agente

deR

ede

END

Arquivo de OpçõesUm arquivo de opções deve ser criado para especificar o usuário sobqual método é executado, e a freqüência com que uma dependênciaremota do job ou fluxo do job é verificada. A mudança para estearquivo não é efetivada até que o TWS seja parado e reiniciado.

Esse arquivo de opções deve ter o mesmo nome de caminho dométodo de acesso e deve chamarnetmth.opts.TWShome/methods/netmth.opts

SintaxeGSuser=login_name

GStimeout=seconds

onde:

login_nameO início de sessão utilizado para executar o método. Se ohost do agente de rede for um computador do Windows NT,este usuário deverá ser definido no TWS.

secondsO período de tempo, em segundos, que o TWS espera poruma resposta antes de eliminar o método de acesso. Opadrão é 300 segundos. Se o método de acesso for chamadonovamente, ele será inicializado automaticamente.

Exemplo de Arquivo de OpçõesUm exemplo de arquivo de opções para o métodonetmth é oseguinte:GSuser=bunyon

GStimeout=400

Como Configurar uma Estação de Trabalho do Agente de Rede

314 Versão 7.0

Dependências entre redesUtilizando o Job Scheduling Console, as dependências entre redessão especificadas no Editor de Fluxo de Job. Utilize o botãoAdicionar Dependência ao botão entre redespara adicionar umícone do job entre redes ao fluxo de job (representando opredecessor) e crie, em seguida, a dependência follows a partir desseícone para qualquer outro job que utilize o botãoAdicionar Link .

Nota: Os jobs e fluxos de job remotos são definidos e executadosem sua rede local de maneira padrão. Seu uso como dependênciasentre redes não causa efeito em seu procedimento local.

Quando os jobs e fluxos de job remotos são especificados comodependências Follows em fluxos de job locais, eles são trilhadospelo Conman em um fluxo de job EXTERNAL especialmentecriado. Os nomes são gerados para as dependências e são tratadoscomo jobs no fluxo de job EXTERNAL.

Como Criar uma Dependência entre redesPara adicionar uma dependência entre redes a um job:

1. Abra o fluxo de job no Editor de Fluxo de Job.

2. Na Exibição Gráfico do Editor de Fluxo de Job, clique no botãoAdicionar Dependência entre redesna barra de ferramentas eclique no cursor na janela onde deseja que o ícone do fluxo dejob sela colocado. A janela Dependência entre redes é exibida.

3. No campo Agente de Rede, digite o nome do Agente de Rede.

4. No campo Estação de Trabalho, digite o nome da estação detrabalho que possui o job predecessor. Essa estação de trabalhodeve residir na rede ao qual o Agente de Rede está conectado.

5. No campo Fluxo de Job, digite o nome do fluxo de jobpredecessor.

6. No campo Job, digite o nome do job predecessor.

7. Clique em OK. Um ícone representando o job predecessor éexibido na janela. Você pode arrastar e soltar o ícone do fluxo dejob para posicioná-lo na janela.

Dependências entre redes


6.R

eferênciado

Agente

deR

ede

8. Clique no botão Adicionar Link para criar uma dependênciafollows a partir do ícone do job INET para o job sucessor. Umjob entre redes pode ser um predecessor, mas não um sucessor,para qualquer job do fluxo de job.

9. Salve o fluxo de job.

Como Utilizar a Linha de ComandosAs dependências entre redes podem ser incluídas nos fluxos de jobcompostos com o programaComposerda linha de comandos. Porexemplo, utilize a palavra-chavefollows como nos exemplos aseguir:jstream6 follows netagent1::remotewrkstn#skedx.@

apjob follows netagent2::ahab#qa5.jobc1

Dependências entre redes e ConmanAs dependências entre redes são exibidas e manipuladas no plano devárias maneiras.

¶ Planejamento especial

¶ o fluxo de job EXTERNAL

Planejamento Especial e Dependências entre redesAs dependências entre redes podem ser utilizadas comodependências follows para jobs e fluxos de job submetidos ao plano.As dependências são especificadas como são para outrasdependências follows. Consulte “Como Criar uma Dependência entreredes” na página 315 para obter mais informações.

Fluxo de Job EXTERNALTodas as dependências entre redes são exibidas em um fluxo de jobchamado EXTERNAL. As dependências são listadas como jobsindependentemente de estarem ou não definidas para jobs ou fluxosde job. Há um fluxo de job EXTERNAL para cada agente de redeno plano.

Nomes exclusivos de jobs são gerados como a seguir:Ennnmmss

onde:


316 Versão 7.0

nnn é um número aleatório.

mm são os minutos atuais.

ss são os segundos atuais.

O nome real do job ou fluxo de job é armazenado na parte JCL doregistro de job.

Estados do Job ExternoO status de release dos jobs é determinado pelo método de acesso elistado no campo Status do Release do fluxo de job EXTERNAL. Ostatus é apenas tão atual quanto a última vez em que a rede remotafoi controlada. Parece que os jobs saltam estados que ocorrem entreos controles.

Todos os estados para jobs e fluxos de job são listados, excetoFENCE. Além disso, há dois estados exclusivos para jobsEXTERNAL:

ERROROcorreu um erro durante a verificação do status remoto.

EXTRNStatus desconhecido. Ocorreu um erro, uma ação Reexecutarfoi realizada no fluxo de job EXTERNAL, ou o job ou fluxode job INET não existe.



6.R

eferênciado

Agente

deR

ede

318 Versão 7.0

Nomes dos Fusos Horários

Este apêndice fornece uma lista de nomes de fusos horáriossuportados pelo TWS.

Nomes e Descrições dos Fusos HoráriosA tabela a seguir mostra os nomes dos fusos horários suportadospelo TWS:

Nome Descrição Relativo ao GMT

GMT Hora de Greenwich GMT

UTC Hora Coordenada Universal GMT

ECT Hora Central Européia GMT+1:00

EET Hora Oriental Européia GMT+2:00

ART (Árabe) Hora Local Egípcia GMT+2:00

EAT Hora Oriental Africana GMT+3:00

MET Hora do Oriente Médio GMT+3:30

NET Hora do Oriente Próximo GMT+4:00

PLT Hora Lahore Paquistanesa GMT+5:00

IST Hora Local da Índia GMT+5:30

BST Hora Local de Bangladesh GMT+6:00

VST Hora Local do Vietnã GMT+7:00

CTT Hora de Taiwan da China GMT+8:00

JST Hora Local do Japão GMT+9:00

ACT Hora Central da Austrália GMT+9:30

A


A.

Nom

esdos

Fusos

Horários

Nome Descrição Relativo ao GMT

AET Hora Oriental da Austrália GMT+10:00

SST Hora Local de Salomão GMT+11:00

NST Hora Local de Nova Zelândia GMT+12:00

MIT Hora de Midway Islands GMT-11:00

HST Hora Local do Havaí GMT-10:00

AST Hora Local do Alasca GMT-9:00

PST Hora Local do Pacífico GMT-8:00

PNT Hora Local de Fênix GMT-7:00

MST Hora Local das Montanhas GMT-7:00

CST Hora Local Central GMT-6:00

EST Hora Local Oriental GMT-5:00

IET Hora Local Oriental de Indiana GMT-5:00

PRT Hora de Porto Rico e Ilhas Virgens dosEUA

GMT-4:00

CNT Hora de Newfoundland do Canadá GMT-3:30

AGT Hora Local da Argentina GMT-3:00

BET Hora Oriental do Brasil GMT-3:00

CAT Hora da África Central GMT-1:00

Nomes e Descrições dos Fusos Horários

320 Versão 7.0

Glossário

A

Agente de redeUm tipo de agente estendido utilizado para criar dependências entre jobs e fluxos dejob em redes separadas do Tivoli Workload Scheduler. Consulte também“Dependência de Internetwork (INET)”.

Agente estendidoUm agente utilizado para integrar os recursos de controle do job do Tivoli WorkloadScheduler com outros sistemas operacionais (por exemplo, MVS) e aplicativos (porexemplo, Oracle Applications, Peoplesoft e Baan). Os agentes estendidos utilizamscripts chamados métodos de acesso, para se comunicarem com sistemas externos.

Agente tolerante a falhasUma estação de trabalho do agente na rede do Tivoli Workload Scheduler capaz deresolver as dependências locais e lançar seus jobs na ausência de um gerenciador dedomínio.

agente XConsulte “Agente estendido”.

arquivo stdlistUm arquivo da lista padrão criado para cada job lançado pelo Tivoli WorkloadScheduler. Os arquivos da lista padrão contém cabeçalho e banners do trailer,comandos repetidos, erros e avisos. Estes arquivos podem ser utilizados paradetectar problemas na execução do job.

Arquivo symphonyUm arquivo que contém as informações sobre planejamento necessárias peloprocesso de Controle de Produção (batchman) para executar o plano. O arquivo écriado e carregado durante a fase de pré-produção. Durante a fase de produção, eleé, continuamente, atualizado para indicar o status atual de processamento deprodução: trabalho concluído, trabalho em andamento, trabalho a ser executado.Para gerenciar o processamento de produção, o conteúdo do arquivo symphony(plano) pode ser exibido e alterado com o Job Scheduling console.

B

Banco de DadosUm banco de dados que contém todas as definições criadas para objetos deplanejamento (por exemplo, jobs, fluxos de job, recursos, estações de trabalho, etc).Além disso, o banco de dados mantém outras informações importantes tais comoestatísticas do job e execução do fluxo de job, informações sobre o ID do usuário


Glossário

que criou um objeto e a última data modificada de um objeto. Em comparação, oplano contém somente estes jobs e fluxos de job (incluindo objetos dependentes)que são planejados para execução na produção diária.

Banco de dados expandidoUm banco de dados que permite nomes mais longos para objetos do banco dedados, tais como jobs, fluxos de job, estações de trabalho, domínios e usuários. Osbancos de dados expandidos são configurados utilizando o comando dbexpand oucomo uma opção durante a instalação. Não expanda seu banco de dados antes deentender as implicações e impacto deste comando.

BatchmanUm processo iniciado no começo de cada dia de processamento do TWS para lançarjobs de acordo com as informações no arquivo symphony.

C

CalendárioUm objeto definido no banco de dados do Tivoli Workload Scheduler que contémuma lista de datas de planejamento. Como ele é um objeto exclusivo definido nobanco de dados, ele pode ser atribuído a vários fluxos de job. Atribuir umcalendário a um fluxo de job faz com que o fluxo de job seja executado nos diasespecificados no calendário. Observe que um calendário pode ser utilizado como umciclo de execução inclusivos e exclusivos.

Caracteres CuringaOs caracteres curinga para Tivoli Workload Scheduler são: ? Substitui uma caracterealfa. % Substitui um caractere numérico. * Substitui zero ou mais caracteresalfanuméricos. Geralmente, os caracteres curinga são utilizados para redefiniremuma pesquisa para um ou mais objetos no banco de dados. Por exemplo, se desejarexibir todas as estações de trabalho, é possível digitar o caractere curinga asterisco(*). Para obter uma listagem de estações de trabalho site1 até site8, você podedigitar site%.

Ciclo de execuçãoUm ciclo que especifica os dias que um fluxo de job é planejado para serexecutado. No TWS, existem três tipos de ciclos de execução que você podeespecificar para um fluxo de job: um ciclo de execução Simples, um ciclo deexecução Semanal ou um ciclo de execução calendário (comumentemente chamadode um calendário). Observe que cada tipo de ciclo de execução pode ser inclusivoou exclusivo. Isto é, cada ciclo de execução pode definir os dias que um fluxo dejob é incluído no ciclo de produção ou os dias que um fluxo de job é excluído dociclo de produção. Quando você definir vários ciclos de execução para um fluxo dejob e os ciclos de execução inclusivos e exclusivos especificarem os mesmos dias,os ciclos de execução exclusivos são antecedidos.

322 Versão 7.0

Ciclo de execução exclusivoUm ciclo de execução que especifica os dias que um fluxo de job não pode serexecutado. Os ciclos de execução exclusivos antecedem os ciclos de execuçãoinclusivos.

Ciclo de Execução InclusivoUm ciclo de execução que especifica os dias que um fluxo de job é planejado paraser executado. Os ciclos de execução exclusivos antecedem os ciclos de execuçãoinclusivos.

Ciclo de Execução SemanalUm ciclo de execução que especifica os dias da semana que um fluxo de job éexecutado. Por exemplo, um fluxo de job pode ser especificado para executar todasegunda-feira, quarta-feira e sexta-feira utilizando um ciclo de execução semanal.Um ciclo de execução semanal é definido para um fluxo de job específico e nãopode ser utilizado por vários fluxos de job. Para obter mais informações, consulteCiclo de Execução.

Ciclo de Execução SimplesUm conjunto específico de dias definidos que um fluxo de job é executado. Umciclo de execução simples é definido por um fluxo de job específico e não pode serutilizado por vários fluxos de job. Para obter mais informações, consulte Ciclo deExecução.

Classe da estação de trabalhoUm grupo de estações de trabalho. Qualquer número de estações de trabalho podeser colocado em uma classe. Os fluxos de job e jobs podem ser atribuídos paraserem executados em uma classe da estação de trabalho. Este cria a replicação deum job ou fluxo de job através de muitas estações de trabalho acessíveis.

Comandos do utilitárioUm conjunto de executáveis da linha de comandos para gerenciar o Tivoli WorkloadScheduler.

ComposerUm aplicativo da linha de comandos existentes para gerenciamento de definições deseus objetos de planejamento no banco de dados.

ConmanUm aplicativo da linha de comandos existentes para gerenciamento do ambiente deprodução. O Conman (console manager) executa as seguintes tarefas: inicia eencerra os processos de produção, altera e exibe horários e jobs no plano e controlaa ligação da estação de trabalho em uma rede.


Glossário

D

DependênciaUm pré-requisito que deve ser solucionado antes da execução de um job ou fluxo dejob que pode continuar. O número máximo de dependências permitido para um jobou fluxo de job é 40. Os quatro tipos de dependências utilizados pelo TivoliWorkload Scheduler são as dependências a seguir, dependências de recursos,dependências de arquivos e dependências de prompts.

Dependências de Internetwork (INET)Uma dependência entre jobs ou fluxos de jobs em redes separadas do TivoliWorkload Scheduler. Consulte também “Agente de rede”.

Dependência seguinteUma dependência onde um job ou fluxo de job não pode começar a execução, atéque outros jobs ou fluxos de job foram concluídos com êxito.

DomínioUm grupo nomeado de estações de trabalho do TWS que consiste em mais de umagente e um gerenciador de domínio que age como um hub de gerenciamento.Todos os domínios possuem um domínio pai, exceto para o domínio mestre.

DuraçãoO tempo previsto para a conclusão do job. Na exibição da Linha de Tempo dos jobsno banco de dados, a duração é representada por uma barra azul claro no centro dabarra de atividade, ou por um losango azul claro.

E

Estação de trabalhoGeralmente, um computador individual no qual jobs e fluxos de job são executados.Eles são definidos no banco de dados do Tivoli Workload Scheduler como umobjeto exclusivo. É requerida uma definição da estação de trabalho para todocomputador que executa jobs ou fluxos de job na rede do Workload Scheduler.

Exibição em árvoreA exibição no lado esquerdo do Job Scheduling Console que exibe o servidor TWS,grupos de listas padrão e grupos de listas criadas pelo usuário.

F

Fluxo de JobUma lista de jobs que é executada como uma unidade (tal como um aplicativo debackup semanal), junto com horas, prioridades e outras dependências quedeterminam a ordem exata de execução do job.

324 Versão 7.0

Fluxo de Job FinalO último fluxo de job que é executado em um dia de produção. Ele contém um jobque executa o arquivo script Jnextday.

G

Gerenciador de DomínioO hub de gerenciamento em um domínio do Tivoli Workload Scheduler. Todas ascomunicações para e dos agentes no domínio são roteadas através do gerenciador dedomínio.

Gerenciador de Domínio MestreA estação de trabalho que mantém os arquivos utilizados para documentar osobjetos de planejamento em uma rede do Tivoli Workload Scheduler. Ele cria oplano no início de cada dia e executa todo registro e relatório da rede.

H

Hora de Início EstimadaA hora antes da qual o job ou fluxo do job não pode ser iniciado. A hora de inícioestimada é aquela estimada baseada em experiências anteriores de execução do jobou fluxo de job. Entretanto, o job ou fluxo de job pode iniciar após a horaespecificada, desde que todas as outras dependências estejam solucionadas. Na linhade tempo, a hora de início é representada pelo início (canto esquerdo) da barra deatividade azul marinho. Em ocorrências do job, a hora de início calculada pelo OPCé representada por uma barra azul claro. Consulte também“Tempo de início atual” e“Hora inicial planejada”.

Hora Inicial PlanejadaA hora que o TWS estima uma ocorrência de job será iniciada. Esta estimativa ébaseada nas horas de início de execuções anteriores.

HostUma estação de trabalho do Workload Scheduler requerida por agentes estendidos.Ele pode ser qualquer estação de trabalho do TWS, exceto outro agente estendido.

J

JobUma unidade de trabalho que é processada em uma estação de trabalho. A definiçãodo job consiste em um nome de job exclusivo no banco de dados do TWS juntocom outras informações necessárias para executar o job. Quando você inclui um jobem um fluxo de job, é possível definir suas dependências e suas restrições de tempotal como a hora de início e o tempo final estimados.


Glossário

Job externoUm job de um fluxo que é o predecessor de um job de outro fluxo. Um job externoé representado por um ícone marcador de lugar na exibição de Gráfico do fluxo dojob.

Job / Fluxo de job de Internetwork (INET)Um job ou fluxo de job de uma rede remota do Tivoli Workload Scheduler que éum predecessor de um job ou fluxo de job na rede local. Um job de Internetwork érepresentado por um ícone marcador de lugar na exibição de Gráfico do fluxo dejob. Consulte também “Agente de rede”.

Job JnextdayUm job planejado para ser executado no final de cada dia, para automatizar oprocessamento completo da produção anterior e posterior. Um exemplo do jobjnextday é fornecido comoTWShome\Jnextday.Jnextday faz o seguinte: configura oprocessamento do dia a seguir (contido no arquivo symphony), imprime relatórios,transporta fluxos de job não concluídos e encerra e reinicializa o TWS.

Jobs interativosUm job que é, interativamente, executado em um desktop do Windows NT.

L

LimitadorO limitador de job é um controle mestre na execução do job em uma estação detrabalho. O limitador de job é um nível de prioridade que uma prioridade do job oudo fluxo de job deve exceder antes de poder ser executado. Por exemplo, definir olimitador para 40 previne que jobs com prioridades 40 ou menos sejam lançados.

LimiteUm limite de job que fornece uma maneira de alocar um número de slots de jobsespecífico, no qual é permitido que o Tivoli Workload Scheduler lance jobs. Umlimite de job pode ser definido para cada fluxo de job e para cada estação detrabalho. Por exemplo, definir o limite da estação de trabalho como 25, permite queo TWS tenha mais de 25 jobs sendo executados, concorrentemente, na estação detrabalho.

ListaUma lista que exibe os objetos de planejamento do job. É necessário criar listasseparadas para cada objeto de planejamento do job. Para cada objeto deplanejamento do job, há dois tipos de listas: uma de definições no banco de dados eoutra de ocorrências no plano.

326 Versão 7.0

M

Método de acessoUm executável utilizado por agentes estendidos para conectar e controlar a execuçãodo job em outros sistemas operacionais (por exemplo, MVS) e aplicativos (porexemplo, Oracle Applications, Peoplesoft e Baan). O método de acesso deve serespecificado na definição da estação de trabalho para o agente estendido.

O

Ocorrência do fluxo de jobUm fluxo do job planejado para uma data de execução específica no plano.Consulte também “Fluxo de job”.

Ocorrência do JobUm job planejado para uma data de execução específica no plano. Consulte também“Job”.

Opções globaisAs opções que se aplicam a todas as estações de trabalho de uma rede do TWS.Elas são definidas no arquivoglobaloptsno gerenciador de domínio mestre.Consulte também “Opções locais”.

Opções locaisAs opções que se aplicam somente à estação de trabalho na qual elas são definidas.Elas são definidas no arquivolocaloptsem cada estação de trabalho de uma rede doTivoli Workload Scheduler. Consulte também “Opções globais”.

P

ParâmetroUm parâmetro utilizado para substituir valores em seus jobs e fluxos de job. Aoutilizar um parâmetro em um script de job, o valor é substituído no tempo deexecução. Neste caso, o parâmetro deve ser definido na estação de trabalho ondeserá utilizado. Os parâmetros não podem ser utilizados quando fazer um script dejobs de agentes estendidos.

PlanoUm procedimento que contém toda atividade de planejamento do job por umperíodo de um dia. No TWS, o plano é criado a cada 24 horas e consiste em todosos jobs, fluxos de jobs e objetos de dependência que são planejados para seremexecutados neste dia. Todos os fluxos de job para os quais foram criados ciclos deexecução, são planejados automaticamente e incluídos no plano. Como osprogressos do ciclo de produção, os jobs e fluxos de job no plano são executados deacordo com suas restrições de tempo e outras dependências. Todos os jobs ou fluxosde jobs que não são executados com êxito, são deixados no plano do dia seguinte.


Glossário

PredecessorUm job que deve ser concluído com êxito antes que os jobs do sucessor possamcomeçar a execução.

PrioridadeUma preferência de hora no sistema de enfileiramento do TWS para execução dejobs e fluxos de jobs no plano. Você pode atribuir um nível de prioridade para cadajob e fluxo de job de0 a 101. Uma prioridade0 não será executada.

PromptUm objeto que pode ser utilizado como uma dependência para jobs e fluxos de jobs.Um Prompt deve ser respondido positivamente para o job ou fluxo de jobdependente a ser lançado. Existem dois tipos de prompts: predefinido e especial.Um prompt especial é definido dentro das propriedades de um job ou fluxo de job,e é exclusivo para este job ou fluxo de job. Um prompt predefinido é definido nobanco de dados do TWS e pode ser utilizado por qualquer job ou fluxo de job.

R

RecursoUm objeto que representa recursos físicos ou lógicos em seu sistema. Quandodefinido no banco de dados do Tivoli Workload Scheduler, os recursos podem serutilizados como dependências para jobs e fluxos de job. Por exemplo, você podedefinir um recurso nomeado″fitas″ com um valor de unidade dois. Em seguida,definir jobs que requerem duas unidades de fitas disponíveis como umadependência. Os jobs com esta dependência não podem ser executadosconcorrentemente, porque toda vez que um job é executado, o recurso de “fitas”está em uso.

Restrições de tempoPodem ser especificadas para jobs e fluxos de job. Uma hora pode ser especificadapara a execução começar ou uma hora pode ser especificada, após a qual a execuçãonão será tentada. Especificando ambas, você pode definir uma janela dentro da qualum job ou fluxo de job será executado. Para os jobs, você também pode especificaruma taxa de repetição. Por exemplo, você pode lançar no Tivoli Workload Schedulero mesmo job a cada 30 minutos entre às 8:30 a.m. e 1:30 p.m.

S

StatusReflete o job ou status do fluxo de job atual dentro do Job Scheduling Console. Ostatus do Job Scheduling Console é comum para TWS e OPC. Consulte tambémStatus interno.

Status do jobConsulte “Status”.

328 Versão 7.0

Status internoReflete o status atual de jobs e fluxos de job no mecanismo do TWS. O statusinterno é exclusivo para o TWS. Consulte também Status.

SucessorUm job que não pode ser iniciado, até que todos os jobs do predecessor dos quaisele depende sejam concluídos com êxito.

T

Tempo finalO último momento em que um job ou fluxo de job pode começar a execução. Estecorresponde à Hora final no Maestro existente.

Tivoli Management Framework (TMF)O software de base que é requerido para executar os aplicativos no conjunto deprodutos Tivoli. Esta infra-estrutura de software permite a integração de aplicativosde gerenciamento de sistemas da Tivoli Systems Inc. e de associados Tivoli. OTivoli Management Framework inclui o seguinte:vObject request broker (oserv)vBanco de dados do objeto distribuídovFunções de administração básicasvServiçosde aplicativos básicosvServiços básicos de desktop, tais como a interface gráficacom o usuário (GUI) Em um ambiente Tivoli, o Tivoli Management Framework éinstalado em cada cliente e servidor. Entretanto, o servidor TMR é o único servidorque mantém o banco de dados do objeto completo.

Tivoli Management Region (TMR)Em um ambiente Tivoli, um servidor Tivoli e o conjunto de clientes servidos porele. Uma organização pode ter mais de um TMR. Um TMR trata da conectividadefísica dos recursos, enquanto uma região de critérios trata da organização lógica dosrecursos.

U

UsuárioSomente para o Windows NT, o nome do usuário especificado em um campo“Início de Sessão” de definição do job deve ter uma definição do usuáriocorrespondente. As definições fornecem as senhas do usuário requeridas pelo TivoliWorkload Scheduler para lançar jobs.


Glossário

330 Versão 7.0

Índice Remissivo

Aagente de rede

arquivo de opções 314dependência entre redes 315estação de trabalho 312exemplo de linha de comandos da estação de

trabalho 313netmth 311visão geral 311

agente estendidodefinição de estação de trabalho 298referência 297visão geral 297

Ccaracteres curinga 30, 103caracteres de controle 27caracteres de controle, conman 100caracteres de controle do composer 27caracteres especiais, composer 30caracteres especiais, conman 104comando adddep job 125comando adddep sched 128comando altpass 130comando altpri 131comando at 238comando batch 238comando cancel job 135comando cancel sched 135comando caxtract 244comando confirm 137comando console 139comando continue 141comando cpuinfo 248comando datecalc 248comando dbexpand 253

comando deldep 142comando deldep sched 144comando delete 255comando display 146comando evtsize 258comando exit 148comando fence 149comando help 151comando jbxtract 258comando jobinfo 260comando jobstdl 262comando kill 153comando killproc 295comando limit cpu 154comando limit sched 156comando link 157comando listproc 295comando listsym 161comando maestro 264comando makecal 265comando morestdl 267comando parms 269comando paxtract 271comando prxtract 272comando r11xtract 273comando recall 165comando redo 165comando release 275comando release job 167comando release sched 169comando reply 171comando rerun 173comando resource 177comando rextract 277comando rmstdlist 278comando setsym 178comando showcpus 179comando showdomains 183comando showexec 279


ÍndiceR

emissivo

comando showfiles 185comando showjobs 188comando showprompts 200comando showresources 200comando showschedules 203comando shutdown 207comando start 208comando startup 281comando status 212comando stop 213comando submit file 220comando submit job 223comando submit sched 226comando switchmgr 229comando tellop 232comando unlink 233comando version 236, 282comando wmaeutil 284comando xrxtrct 287comandos do sistema, conman 100comandos não-suportados 295comandos utilitários 237como criar uma dependência entre redes 315como executar o composer 27como executar o conman 99como selecionar fluxos de job em

comandos 118como selecionar jobs em comandos 108conman, como executar 99

Ddefinição da estação de trabalho 2definição de classe da estação de trabalho 9definição de domínio 11definição do calendário 21definição do job 13definição do parâmetro 22definição do prompt 24definição do recurso 26definição do usuário 18delimitadores 30delimitadores, conman 104

dependênciaentre redes 315

dependência entre redes 315descrições dos comandos do composer 31

Eeditor, objeto do banco de dados 29editor do composer 29editor do objeto de banco de dados 29entradas do banco de dados 1estados, jobs 115estados do job 115

Llinguagem de planejamento 61lista de comandos do conman 105

Mmétodo de acesso netmth 311

Oobjetos de planejamento 1

Ppalavra-chave at 63palavra-chave carryforward 66palavra-chave comments 67palavra-chave confirmed 68palavra-chave end 69palavra-chave every 70

332 Versão 7.0

palavra-chave except 71palavra-chave follows 73palavra-chave in order 75palavra-chave job statement 77palavra-chave limit 83palavra-chave needs 84palavra-chave on 86palavra-chave opens 89palavra-chave priority 91palavra-chave prompt 92palavra-chave schedule 94palavra-chave until 96palavras-chave, linguagem de planejamento 62palavras-chave da linguagem de

planejamento 62programa composer 27prompt de comandos 29prompt de comandos, conman 102prompt de comandos do conman 102prompts do usuário 100

Rreferência do composer 1referência do conman 99

Ssaída do terminal 27, 101saída offline 101saída offline no UNIX 28sintaxe, linguagem de planejamento 61sintaxe de comandos, conman 103sintaxe de comandos do composer 30sintaxe de comandos do conman 103submit docommand 217system command, conman 231


ÍndiceR

emissivo

334 Versão 7.0

Impresso em Brazil

G517-6960-00

tivoli workload scheduler -...

Documents