Parâmetro Descrição
LOC A localização na qual a tarefa está sendo executada. Essas localizações são especificadas no repositório do PowerExchange e no arquivo dbmover.cfg. A localização especificada aqui deve ser remota; uma mensagem de erro será gerada para LOC=LOCAL.
UID O ID do usuário exigido para acessar a localização, se necessário.
PWD A senha, simples ou criptografada, exigida para acessar a localização, se necessário. Os caracteres não alfanuméricos devem ser colocados entre aspas (“”).
Não pode haver um caractere de aspa como parte da senha, mesmo que seja colocado entre aspas.
Exemplo de Saída:
2003-06-27 14:20:25 TASK LIST
Name Taskid Partner Port Status Acc_Method ============================================================================== 0740 Active RPX 1688 Active TASK_CNTL
Ajuda do Utilitário DTLUTSK no Linux, UNIX e Windows
Se você não especificar nenhum argumento (como DTLUTSK) ou se usar um ponto de interrogação (como DTLUTSK ?), o utilitário exibirá a seguinte assistência.
DTLUTSK Help: DTLUTSK CMD=LISTTASK/STOPTASK/LISTLOCATIONS/LISTALLOC LOC=location UID=uid PWD=pwd/ EPWD=encryptpwd
O exemplo a seguir mostra a ajuda do DTLUTSK: DTLUTSK Help: Examples:
DTLUTSK Help: DTLUTSK CMD=LISTTASK LOC=NODE1 UID=uid PWD=pwd
DTLUTSK Help: DTLUTSK CMD=STOPTASK TASKID=taskid LOC=NODE1 UID=uid PWD=pwd DTLUTSK Help: DTLUTSK CMD=STOPTASK APPL=taskname LOC=NODE1 UID=uid PWD=pwd DTLUTSK Help: DTLUTSK CMD=LISTLOCATIONS
DTLUTSK Help: DTLUTSK CMD=LISTLOCATIONS LOC=NODE1
DTLUTSK Help: DTLUTSK CMD=LISTALLOC LOC=NODE1 UID=uid PWD=pwd
Trabalho DTLUTSK no MVS
Esta seção oferece informações sobre como submeter o trabalho DTLUTSK.
Trabalho DTLUTSK no MVS - Exemplo de JCL
O exemplo a seguir mostra a JCL do trabalho DTLUTSK. Para especificar o cartão JOB para executar essa JCL, copie o membro JOBCARD para o membro DTLUTSK.
//*
//* MEMBER DTLUTSK //*
//INCS1 INCLUDE MEMBER=GENBULK //*
//RUN EXEC PGM=DTLUTSK,
// PARM=('CMD=LISTTASK LOC=location UID=userid PWD=password') /*
//* SAMPLE PARMS FOLLOW:
//* REMOVE COMMENT BEFORE CMD TO RUN //* DTLUTSK Help: Examples:
//* PARM=('CMD=LISTTASK LOC=NODE1 UID=uid PWD=pwd')
//* PARM=('CMD=STOPTASK TASKID=taskid LOC=NODE1 UID=uid PWD=pwd') //* PARM=('CMD=STOPTASK APPL=taskname LOC=NODE1 UID=uid PWD=pwd') //* PARM=('CMD=LISTTASK TASKID=taskid LOC=location',
//* 'UID=uid EPWD=encryptpwd')
//STEPLIB DD DISP=SHR,DSN=&HLQ..LOADLIB // DD DISP=SHR,DSN=&SCERUN
//*
//SYSIN DD DUMMY /*
//*
//DTLMSG DD DSN=&HLQ..DTLMSG,DISP=SHR
//* IF USING MESSAGE OVERRIDE THEN CUSTOMIZE BELOW //*DTLMSGO DD DISP=SHR,DSN=&RUNLIB(DTLMSGO) //DTLCFG DD DSN=&RUNLIB(DBMOVER),DISP=SHR //DTLKEY DD DSN=&RUNLIB(LICENSE),DISP=SHR //DTLSGN DD DSN=&RUNLIB(SIGNON),DISP=SHR //DTLLOG DD SYSOUT=* //DTLLOG01 DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //SYSOUT DD SYSOUT=* //SYSPRINT DD SYSOUT=* //CEEDUMP DD SYSOUT=*
Trabalho DTLUTSK no MVS - Exemplo de Saída
********************************* TOP OF DATA ********************************** 2007-10-25 13:28:45 TASK LIST
0Name Taskid Partner Port Status Acc_Method Sessid ================================================================================================= x 0001 10.3.4.57 6900 Active CAPXRT
0002 127.0.0.1 6900 Active TASK_CNTL ******************************** BOTTOM OF DATA ********************************
Utilitário da Linha de Comando DTLUTSK no MVS
Os comandos da linha de comando a seguir estão disponíveis:¨ LISTTASK. Lista todas as tarefas atuais.
¨ STOPTASK. Interrompe a tarefa especificada pelo parâmetro TASKID. ¨ LISTLOCATIONS. Lista todas as localizações atuais.
¨ LISTALLOC. Lista todos os conjuntos de dados alocados.
¨ FREEALLOC. Libera os conjuntos de dados alocados especificados pelo DDNAME e o nome do conjunto de dados.
Comando LISTTASK no MVS
Lista todas as tarefas atuais.
Sintaxe:
MODIFY < listener name >,LISTTASK
Exemplo de saída do utilitário:
DTL-00711 Active tasks:
DTL-00712 taskid=0, partner=10.7.16.71, port=16634, name=, am=DB2, status= DTL-00713 1 active tasks
Comando STOPTASK no MVS
Interrompe a tarefa especificada pelo parâmetro TASKID ou pelo nome do aplicativo.
Sintaxe de interrupção por TASKID:
MODIFY <listener name>,STOPTASK TASKID=<taskid>
Sintaxe de interrupção pelo nome do aplicativo:
MODIFY <listener name>,STOPTASK <application name>
A sintaxe para que o comando de modificação do MVS interrompa uma tarefa pelo nome do aplicativo não usa a mesma sintaxe que DTLUTSK.
Nota: Ao interromper as sessões do CDC, o STOPTASK aguarda um limite de confirmação antes de finalizar a
tarefa. Para obter mais informações sobre limites de confirmação e processamento, consulte o Guia do CDC do
PowerExchange para z/OS.
Comando LISTLOCATIONS no MVS
Lista todas as localizações atuais.
Sintaxe:
MODIFY <listener name>,LISTLOCATIONS
Comando LISTALLOC no MVS
Lista todos os conjuntos de dados alocados.
Sintaxe:
MODIFY <listener name>,LISTALLOC
Exemplo de saída:
Alloc: DDN=<STEPLIB > DSN=<CEE.SCEERUN > Alloc: DDN=< > DSN=<DTLUSR.DEVBLD.LOADLIB > Alloc: DDN=< > DSN=<DTLUSR.DEVBLD.LOAD > Alloc: DDN=< > DSN=<DTLUSR.DEVBLD.NIML.USERLIB > Alloc: DDN=<DTLAMCPR> DSN=<DTLUSR.DEVBLD.V1.CCT > Alloc: DDN=<DTLCACDE> DSN=<DTLUSR.DEVBLD.V1.CDEP > Alloc: DDN=<DTLCACDC> DSN=<DTLUSR.DEVBLD.V1.CDCT > Alloc: DDN=<DTLCAMAP> DSN=<DTLUSR.DEVBLD.V1.DTLCAMAP > Alloc: DDN=<DTLMSG > DSN=<DTLUSR.DEVBLD.DTLMSG > Alloc: DDN=<DTLCFG > DSN=<DTLUSR.V811.RUNLIB > Alloc: DDN=<DTLKEY > DSN=<DTLUSR.V811.RUNLIB > Alloc: DDN=<DTLSGN > DSN=<DTLUSR.V811.RUNLIB > Alloc: DDN=<DTLLOG > DSN=<DTLUSR.DTLLOG.LOG > Alloc: DDN=<DATAMAP > DSN=<DTLUSR.V811.V1.DATAMAPS > Alloc: DDN=<SYSUDUMP> DSN=<DTLUSR.DTLUSR2.JOB05761.D0000101.? > Alloc: DDN=<SYSOUT > DSN=<DTLUSR.DTLUSR2.JOB05761.D0000102.? > Alloc: DDN=<URLEOUT > DSN=<DTLUSR.DTLUSR2.JOB05761.D0000103.? > Alloc: DDN=<SYSPRINT> DSN=<DTLUSR.DTLUSR2.JOB05761.D0000104.? > Alloc: DDN=<CEEDUMP > DSN=<DTLUSR.DTLUSR2.JOB05761.D0000105.? > Alloc: DDN=<CXX > DSN=<DCOM.V10.CXX > Alloc: DDN=<DTLOUT > DSN=<DTLUSR.DTLUSR2.JOB05761.D0000106.? > Alloc: DDN=<DTLERR > DSN=<DTLUSR.DTLUSR2.JOB05761.D0000107.? > Command < LISTALLOC> succeeded
Comando FREEALLOC no MVS
Use FREEALLOC para fechar e desalocar um conjunto de dados que já tenha sido alocado dinamicamente por um ouvinte.
Use-o apenas em situações nas quais uma tarefa seja encerrada anormalmente e os gerenciadores de recursos não consigam fechar todos os conjuntos de dados alocados dinamicamente.
Syntax:
MODIFY <listener name>,FREEALLOC DDN=<ddname> FN=<data set name> Os parâmetros DDN e FN são obrigatórios.
Nota: O conjunto de dados não será desalocado se qualquer um dos itens a seguir se aplicar:
¨ A solicitação não é do ouvinte.
¨ A solicitação destina-se a um arquivo que não foi alocado dinamicamente pelo ouvinte e não tem um nome DD que começa com SYS0.
¨ A solicitação é emitida sem o nome do arquivo sendo especificado.
Executando o Utilitário DTLUTSK no Navegador do
PowerExchange
O método de acesso de dados TASK_CNTL está disponível para que você possa executar um teste de linha do banco de dados para recuperar os resultados do comando LISTTASK ou STOPTASK no Navegador do PowerExchange.
Nota: STOPTASK funciona apenas com o método de acesso CAPXRT.
Para executar o utilitário DTLUTSK no Navegador do PowerExchange:
1. No Navegador do PowerExchange, selecione TASK_CNTL na lista suspensa DB_Type. 2. Selecione a localização apropriada na lista suspensa Location.
3. Na caixa SQL Statement, digite um dos seguintes comandos: ¨ listtask
¨ listlocations
¨ stoptask taskid=taskid ¨ stoptask taskname
Não execute o comando STOPTASK na tarefa TASK_CNTL. O ID de tarefa especificado não será encontrado porque um novo é gerado.
Nota: A lista Fetch permite escolher o comando. Isso adiciona o comando à caixa SQL Statement.
4. Clique em Go.
A janela Database Row Test Output exibe os resultados.
Requisitos de Segurança do Utilitário DTLUTSK
Os seguintes requisitos de segurança se aplicam ao utilitário DTLUTSK.Requisitos de Segurança do Utilitário DTLUTSK no MVS
Se o parâmetro de configuração SECURITY estiver definido como (2,x), onde x é N(Não) ou Y(Sim), os seguintes recursos RACF (ou pacote de segurança semelhante) deverão ser definidos como MVS, usando o parâmetro de configuração RACF_CLASS e o acesso concedido aos usuários exigidos:
DTL.TASKCTRL.DISPLAY DTL.TASKCTRL.STOPTASK
Isso permite que os usuários exibam as tarefas ativas e depois as interrompam, respectivamente.
Requisitos de Segurança do Utilitário DTLUTSK no i5/OS
No i5/OS, se o parâmetro SECURITY estiver definido como (2,x), onde x é N(Não) ou Y(Sim), será necessário definir instruções de segurança da seguinte forma, substituindo DATALIB pela biblioteca de dados exigida:
GRTOBJAUT OBJ(DATALIB/AUTHTSKLST) OBJTYPE(*FILE) USER(USERID) AUT(*USE) GRTOBJAUT OBJ(DATALIB/AUTHTSKSTP) OBJTYPE(*FILE) USER(USERID) AUT(*USE)
Usando o Signon.txt para Autorizar Usuários a Exibir ou Interromper
Tarefas
Na execução com uma definição de configuração SECURITY=(n,Y) onde n vai de 0 a 2, um parâmetro adicional está disponível para permitir o uso de listagem e interrupção de tarefas:
/* 4. TASKCNTRL= is an optional function allowed /* Format is D or S
/* If it is supplied, then the user can use Task Control to /* Display or Stop tasks.
/* This signon list will only be used if Security=(n,Y) is used /* in the config.
CA P Í T U L O
1 4
EDMLUCTR - Utilitário de
Digitalização e Impressão de Log
Este capítulo inclui os seguintes tópicos: ¨ Visão Geral do Utilitário EDMLUCTR, 104
¨ Sistemas Operacionais Suportados para o Utilitário EDMLUCTR, 104 ¨ Sintaxe das Instruções de Controle do Utilitário EDMLUCTR, 105 ¨ Parâmetros das Instruções de Controle do Utilitário EDMLUCTR, 105 ¨ Executando o Utilitário EDMLUCTR, 106
¨ Notas de Uso do Utilitário EDMLUCTR, 107 ¨ Exemplos do Utilitário EDMLUCTR, 107
Visão Geral do Utilitário EDMLUCTR
Use o utilitário EDMLUCTR para executar as seguintes tarefas: ¨ Produzir informações resumidas sobre cada registro de log.¨ Produzir informações detalhadas sobre registros de alterações e de unidades de trabalho (UOWs). ¨ Produzir informações resumidas, por nome de marca de registro, sobre todas as fontes cujas alterações são
capturadas.
¨ Listar UOWs que não foram finalizadas ainda.
Para obter mais informações sobre a Mesclagem Pós-Log e o Agente de Log do PowerExchange, consulte o
Guia do CDC do PowerExchange para z/OS.
Sistemas Operacionais Suportados para o Utilitário
EDMLUCTR
O utilitário EDMLUCTR pode ser executado somente no z/OS.
Sintaxe das Instruções de Controle do Utilitário
EDMLUCTR
Use a seguinte sintaxe para as instruções de controle do utilitário EDMLUCTR: [-SEL [CHANGE-DETAIL] [LOGRBA=logrba] [PACKET-DETAIL] [RECORDS={nnnnnnnn|EOF}] [SUMM] ] [-MASK mask]
Aplicam-se as seguintes regras e diretrizes:
¨ Use a instrução SYSIN DD JCL para especificar as instruções de controle do utilitário. ¨ Todas as instruções de controle são opcionais e começam na coluna 1.
¨ As instruções de controle devem terminar com um espaço em branco e não ultrapassar 80 caracteres. ¨ Use um ou mais espaços como delimitador entre os parâmetros de uma instrução de controle. ¨ Não existe sintaxe de continuação.
¨ Se mais de uma linha for exigida para uma instrução de controle -SEL, codifique -SEL no início de cada linha subsequente que inclua os parâmetros adicionais.
¨ O valor de um parâmetro não pode continuar de uma linha para outra. ¨ Se você codificar várias instruções -MASK, somente a última será usada.
Parâmetros das Instruções de Controle do Utilitário
EDMLUCTR
Revise as descrições dos parâmetros para determinar quais deles usar nas instruções de controle EDMLUCTR.
Instrução -SEL
A instrução -SEL tem os seguintes parâmetros:
CHANGE-DETAIL
Opcional. Imprime informações resumidas e detalhadas, em formato hexadecimal, sobre registros de alterações. Se não for especificado, somente informações resumidas de registros de alterações serão impressas.
LOGRBA
Opcional. Especifica um valor RBA nos conjuntos de dados de log usados como ponto de início para o utilitário EDMLUCTR. Ao usar a Mesclagem Pós-Log, o LOGRBA especifica um valor de carimbo de data/ hora nos conjuntos de dados de log. O carimbo de data/hora é um valor de relógio TOD não estruturado. Como ponto de início, o EDMLUCTR usa o primeiro registro de log com um RBA ou um carimbo de data/hora que seja igual ou superior ao valor especificado.
Especifique até 12 dígitos hexadecimais para o valor LOGRBA. Os zeros à esquerda podem ser omitidos.
Nota: Com as configurações de Mesclagem Pós-Log, LOGRBA deve ser especificado e o valor LOGRBA
deve ter 16 dígitos hexadecimais. Os valores LOGRBA representam o carimbo de data/hora dos dados solicitados ao usar a Mesclagem Pós-Log.
Se nenhum parâmetro for especificado, LOGRBA será o padrão. Seu valor padrão é o RBA gravado no conjunto de dados de reinicialização de emergência (ERDS) do ponto de verificação mais recente.
PACKET-DETAIL
Opcional. Imprime informações resumidas e detalhadas, em formato hexadecimal, sobre registros UOW. Se não for especificado, somente informações resumidas de registros UOW serão impressas.
RECORDS
Opcional. Imprime ou digitaliza o número especificado de registros de log.
Quando você especifica RECORDS=EOF, o EDMLUCTR imprime todos os registros do local de início especificado ou padrão no final atual dos dados de log.
Se você especificar a instrução -SEL RECORDS e -MASK, o EDMLUCTR usará o valor RECORDS como número de registros a serem digitalizados para obter o valor de máscara, em vez do número de registros a serem impressos.
O mínimo é 1. O máximo é 99.999.999. O padrão é 5.000.
SUMM
Opcional. Imprime apenas informações resumidas de alterações.
As informações resumidas de alterações incluem o número total de inserções, atualizações e exclusões encontradas nos dados de log digitalizados, ordenadas pelo nome da marca de registro de origem.
Instrução -MASK
A instrução -MASK tem o seguinte parâmetro:
mask
Obrigatório. Especifique um filtro em um dos seguintes formatos:
¨ Um valor de caractere, como um nome de tabela do DB2, sem espaços em branco. Use o formato hexadecimal para cadeias de caracteres com espaços em branco.
¨ Um valor hexadecimal, como um número UOW. Coloque as cadeias de caracteres hexadecimais entre aspas simples e anteceda a cadeia com a letra X.
Se você especificar -SEL RECORDS e -MASK, EDMLUCTR usará o valor RECORDS como número de registros a serem digitalizados para obter o valor de máscara, em vez do número de registros a serem impressos.
70 caracteres é o tamanho máximo.
Executando o Utilitário EDMLUCTR
O PowerExchange oferece uma amostra da JCL do utilitário EDMLUCTR no membro LOGPRINT da biblioteca SAMPLIB.
As seguintes instruções da JCL são necessárias para executar o utilitário: // JOB
//READER EXEC PGM=EDMLUCTR
//STEPLIB DD DISP=SHR,DSN=hlq.LOAD //ERDS01 DD DISP=SHR,DSN=your.ERDS01 //EDMPARMS DD DISP=SHR,DSN=your.USERLIB //SYSIN DD * JOB Inicia o trabalho.