Caixa de Diálogo Criar Tarefa do Lote

Você utiliza esta caixa de diálogo para enviar o código JCL definido pelo usuário. Este pedido de ação é um equivalente mais flexível aos comandos do kit de ferramentas que o produto fornece.

A Guia Opções desta caixa de diálogo fornece os campos descritos abaixo. Limitações e Sugestões do Toolkit de Armazenamento fornece informações úteis sobre a utilização desta caixa de diálogo.

Para aprender sobre os recursos padrão de uma caixa de diálogo, consulte Guias Padrão nas Caixas de Diálogo do Toolkit de Armazenamento. O tópico inclui um link para os Guias de Referência para Comandos que são utilizados no Toolkit de Armazenamento.

Consulte Convenções para Arquivos JCL Utilizados com o Toolkit de Armazenamento. Além disso, consulte Autenticação e Autorização para Execução de Comandos do Toolkit de Armazenamento a respeito da autorização necessária para os pedidos de ações do Toolkit de Armazenamento.

Conjunto de dados de mainframe totalmente qualificado contendo a JCL em lote: Especifica o conjunto de dados que contém a tarefa em lote. O conjunto de dados deve ser um conjunto de dados sequencial ou um membro de um PDS (Partitioned Data Set). O comprimento do registro lógico do conjunto de dados deve ser de 80 caracteres e o conjunto de dados deve ser um formato de comprimento fixo. Para editar ou criar o conjunto de dados, clique no botão Editar JCL, o que faz com que Editar Caixa de Diálogo Conjunto de Dados seja exibido.
Nota: O ID do usuário usado para o Tivoli Enterprise Portal deve estar autorizado no sistema de mainframe para acessar o conjunto de dados. Quando o ID do usuário não é autorizado, você vê uma mensagem de erro ao clicar em Editar JCL. Para obter informações adicionais, consulte Autenticação e Autorização para Execução de Comandos do Toolkit de Armazenamento.
Variáveis de substituição e seus valores de substituição de tempo de execução: Especifica os valores de substituição a serem utilizados no tempo de execução. Os valores de substituição permitem que a tarefa de lote faça referência a objetos específicos, como conjunto de dados e volumes. Por exemplo, esses objetos poderão corresponder a valores nas linhas de tabela que você seleciona antes de chamar essa caixa de diálogo.
Na coluna Variável, você pode digitar um nome exclusivo para cada variável de substituição que existe no conjunto de dados. Nas células da coluna Atributo ou cadeia, você pode selecionar nos nomes disponíveis. Esses nomes refletem atributos das linhas de tabela que você selecionou em um espaço de trabalho antes de chamar a caixa de diálogo Criar Tarefa de Lote. Alternativamente, você pode digitar manualmente os valores nas células. Por exemplo, você poderá desejar digitar valores como nome da tarefa, classe sysout e outros valores que poderão não estar presentes na tabela de espaço de trabalho na qual você está selecionando linhas.
Dica: Utilize a convenção de sinal de porcentagem para as variáveis de substituição (%name%) presentes em seu conjunto de dados JCL. Dessa forma, essa caixa de diálogo localizará e listará automaticamente as variáveis de substituição do JCL.

Consulte Variáveis de Substituição Padrão no Kit de Ferramenta para obter as diretrizes a serem aplicadas na utilização das variáveis de substituição.

Arquivos cujo conteúdo deve ser copiado para visualização posterior: Especifica os nomes DD e os conjuntos de dados a serem preservados como um registro dos resultados da tarefa em lote. Os arquivos estão disponíveis para visualização no espaço de trabalho Detalhes de Resultados do Kit de Ferramentas de Storage.

Na coluna Nome da Etapa, você especifica o nome da etapa cujos dados deseja salvar. Na coluna Conjunto de Dados ou Nome de DD Completo, você especifica os conjuntos de dados sequenciais, membros de conjuntos de dados particionados ou nomes de DD que deseja copiar. A tabela a seguir mostra algumas configurações de amostra para essa área da caixa de diálogo:

Tabela 1. Configurações de amostra para "Arquivos cujo conteúdo deve ser copiado para visualização posterior"
Nome da etapa	Conjunto de Dados ou Nome de DD
STEPX	USER02.LOG.LISTING
STEPY	SYSPRINT

A especificação na linha 1 preserva dados do conjunto de dados USER02.LOG.LISTING.

A especificação na linha 2 preserva o arquivo SYSPRINT em STEPY. Este resultado é salvo no arquivo de ponto de verificação. As seguintes restrições são aplicadas:

Apenas conjuntos de dados sequenciais ou membros de um PDS são suportados.
Conjuntos de dados VSAM não são suportados.
Conjuntos de dados ou arquivos que contêm caracteres que não podem ser impressos (por exemplo, código hexadecimal) podem ser exibidos de forma imprópria no espaço de trabalho Detalhes do Resultado do Kit de Ferramentas de Storage.
Linhas de saída com mais de 256 caracteres são truncadas.

Conjuntos de Dados Completos necessários para a tarefa que também contém variáveis de substituição: Especifica conjuntos de dados localizados fora do fluxo de tarefas JCL. Tais conjuntos de dados poderão ser necessários para fornecer dinamicamente variáveis de substituição que correspondam a objetos (como conjuntos de dados e volumes) que são necessários quando a tarefa de lote é executada. Esses conjuntos de dados adicionais podem ser sequenciais ou membros de conjuntos de dados particionados. O comprimento do registro lógico desses conjuntos de dados deve ser de 80 caracteres e esses conjuntos de dados devem ser de um formato de comprimento fixo.

Por exemplo, uma tarefa IEHLIST pode utilizar uma declaração SYSIN DD que aponte para um conjunto de dados do DASD e não para placas de controle dentro do fluxo. Esse conjunto de dados pode conter variáveis de substituição que precisam ser substituídas no tempo de execução.

Se nenhum conjunto de dados que contém variáveis de substituição for referido na JCL, essa área da caixa de diálogo pode permanecer vazia.

Você pode encontrar os seguintes códigos de retorno quando a tentativa de acessar conjuntos de dados falhar:

RC	Descrição
119 (DataSetError)	O servidor User Data Set (UDS) falhou.
121 (AuthorizationFailure)	Você está tentando acessar um conjunto de dados para o qual não possui autoridade RACF.
123 (DataSetError)	O conjunto de dados não existe ou o conjunto de dados não é de um formato ou comprimento de registro suportado.

Você também pode receber um código de retorno (status) de 117 (InvalidJCL). Geralmente, este status indica que o código JCL excede 72 caracteres quando as variáveis de substituição são aplicadas. Ele também pode indicar outros erros relacionados ao JCL, como um cartão de JOB ausente, ou que um outro conjunto de dados que exige substituição da variável excede 80 caracteres, quando as variáveis de substituição são aplicadas.

Certifique-se de consultar o RKLVLOG para obter mensagens adicionais sobre esses resultados.

Quando a configuração da tarefa em lote é concluída, você clica em OK na caixa de diálogo Criar Tabela em Lote. Nesse ponto, o arquivo JCL que você fornece e quaisquer arquivos fora da JCL que contêm variáveis de substituição são copiados em arquivos temporários. Estes arquivos temporários são usados quando a JCL da tarefa em lote é submetida.

Convenções para Arquivos JCL Utilizados com o Toolkit de Armazenamento

O conjunto de dados para o JCL que você cria ou edita deve ser um conjunto de dados sequencial ou um membro de um PDS (Partitioned Data Set). Qualquer conjunto de dados JCL utilizado com o Toolkit de Armazenamento deve seguir convenções para permitir que o Tivoli Enterprise Portal substitua os valores de dados no tempo de execução. Os elementos a seguir (marcados com texto em negrito em Figura 1) são variáveis de substituição que serão alteradas pelo Kit de Ferramentas de Storage no tempo de execução da tarefa:

%job-name% (consulte a linha 000100)
%sysout% (consulte a linha 000100)
%my-volser% (consulte a linha 000800)
%dsname% (consulte a linha 000800)

Figura 1. Elementos Variáveis para Arquivos JCL Utilizados com o Toolkit de Armazenamento

****** ***************************** Parte Superior dos Dados ******************************
000100 //%job-name% JOB (),'DHODS',REGION=4M,MSGCLASS=%sysout%,NOTIFY=&SYSUID, 
000200 //         CLASS=A
000300 //* ------------------------------------------------------------------- 
000400 //LISTVTOC EXEC PGM=IEHLIST                                             
000500 //SYSPRINT DD SYSOUT=*                                                  
000600 //SYSIN    DD *                                                         
000700 )DOT                                                                    
000800   LISTVTOC DUMP,VOL=3390=%my-volser%,DSNAME=(%dsname%)                  
000900 )ENDDOT
001000 /*                                                                      
001100 //                                                                      
****** **************************** Parte Inferior dos Dados ****************************

Dica: Utilize a convenção de sinal de porcentagem para as variáveis de substituição (%name%) presentes em seu conjunto de dados JCL. Dessa forma, essa caixa de diálogo localizará e listará automaticamente as variáveis de substituição do JCL.

As linhas )DOT e )ENDDOT em Figura 1 indicam o início e o fim do processamento da tabela. As linhas da JCL entre as linhas )DOT e )ENDDOT são repetidas para cada linha da tabela que é transmitida para o agente mainframe no tempo de execução da JCL. Normalmente, essas linhas contêm variáveis de substituição que são substituídas por novos valores no tempo de execução. Por exemplo, a saída para essas linhas SYSIN JCL pode ser semelhante a este trecho:

000600 //SYSIN    DD *                                                         
000700   LISTVTOC DUMP,VOL=3390=TSO201,DSNAME=(SYS2.USER.CLIST)                    
000800   LISTVTOC DUMP,VOL=3390=TSO202,DSNAME=(SYS2.USER.PROCLIB)                    
000900   LISTVTOC DUMP,VOL=3390=MVSA12,DSNAME=(SYS2.PROD.LOADLIB)                    
001000 /*