Finalizando Um RKLVLOG e Iniciando Outro

Ao recriar um problema para enviá-lo ao IBM® Software Support, é possível usar um comando MODIFY do z/OS para fechar o conjunto de dados em spool atual do RKLVLOG e abrir um novo. Esse comando é emitido a partir de um console do z/OS. O comando TLVLOG gerencia a gravação de informações no RKLVLOG. A sintaxe e o uso desse comando são da seguinte forma:

>>---MODIFY------stcname------,------TLVLOG------SWITCH--------->

>--+--------------+--+----------------+--+------------+--------->
   '-,CLASS=class-'  '-,COPIES=copies-'  '-,DEST=dest-'   

>--+----------+--+------------+--+-------------------+--+--------------------+--+----------+--+------------+--+------------------+-><
   '-,FCB=fcb-'  '-,FORM=form-'  |       .-NO------. |  '-,MAXLINES=maxlines-'  '-,UCS=ucs-'  '-,USER=user-'  '-,WTRNAME=wtrname-'   
                                 '-HOLD=-+-+-----+-+-'                                                                               
                                           '-YES-'                                                                                   

Em que:

Observações de Uso:

• O comando TLVLOG executa até três funções, dependendo das palavras-chave que são especificadas. Supondo que você selecionou todas as três funções, elas são executadas na seguinte ordem:
  1. Atualiza os valores de alocação dinâmica. Com a exceção de MAXLINES, esses valores são utilizados quando a próxima alocação dinâmica é executada. Valores são atualizados sempre que estiverem codificados no comando.
  2. Lista os valores de alocação dinâmica atual. Isso é feito sempre.
  3. Alterna RKLVLOGs. Isso é feito somente quando SWITCH for especificado no comando.
     Nota: Você pode atualizar valores e solicitar um comutador com o mesmo comando; os valores são atualizados primeiro e, em seguida, o comutador é executado.
• RKLVLOGs podem ser encerrados automaticamente após um certo número de registros ter sido gravado neles, assim como o processamento de SYSLOG do MVS. Consulte a palavra-chave MAXLINES para obter informações adicionais.
• Para configurar um comutador RKLVLOG automático sempre que o espaço de endereço do TMS:Engine for iniciado, inclua o seguinte comando para o CLIST de inicialização do RKANCMD:

  TLVLOG MAXLINES=nnn

  Esse comando faz o comando RKLVLOG ser fechado a qualquer hora e liberado para o JES sempre que nnn milhares de linhas foram gravadas. Se necessário, é possível incluir outros valores dependentes de instalação (por exemplo, CLASS) nesse comando.

• Diversas mensagens de diagnóstico são gravadas no RKLVLOG. Se configurar o RKLVLOG para encaminhar automaticamente, ou se você alternar explicitamente o RKLVLOG, assegure-se de que os arquivos SYSOUT sejam mantidos durante pelo menos a execução do TMS:Engine, caso eles sejam necessários para resolução de problema.
• Talvez você queira emitir um comando TLVLOG SWITCH após um problema ocorrer. Isso encaminha os dados do RKLVLOG relativos ao problema em um conjunto de dados em spool separado, que pode ser incluído como parte da documentação de problema padrão do TMS:Engine. Certifique-se de incluir todos os arquivos do RKLVLOG encaminhados anteriormente.
• Como o RKLVLOG é gerenciado com rotinas de gerenciamento de dados padrão da IBM, os registros são armazenados em buffer antes de serem gravados. Se você estiver visualizando o RKLVLOG ativo no momento com um produto como SDSF, não vê as mensagens mais recentes. Emita o comando FLUSH TLVLOG para forçar a gravação do buffer de gerenciamento de dados atual. Não utilize o TLVLOG SWITCH para originar o RKLVLOG atual para essa finalidade, já que ele desnecessariamente fragmenta as mensagens gravadas no RKLVLOG.
• A menos que você configure explicitamente um valor de MAXLINES diferente de zero, o RKLVLOG nunca alterna automaticamente.
• Se algum erro ocorrer ao gravar no RKLVLOG, o TMS:Engine emitirá uma mensagem e desativará a gravação do RKLVLOG. No entanto, as mensagens continuam sendo gravadas no VIEWLOG e em todas as interfaces de operador ativas. Dependendo do erro, é possível que você posa reiniciar o RKLVLOG emitindo um pedido de comutador.

Aqui estão alguns exemplos de maneiras para utilizar esse comando:

• Para listar o destino e valores do RKLVLOG atual: tlvlog
• Para estabelecer a classe X e o SYSPROG de destino como atributos SYSOUT padrão e o número máximo de linhas como 20.000: tlvlog class=x dest=sysprog maxlines=20
• Para alternar para um novo RKLVLOG: tlvlog switch