Comando modify
É possível emitir o comando modify no console do MVS para modificar dinamicamente as operações do produto.
- Controladores ativos
- Definições de rastreio
- Servants
- Sessões
- Heap da JVM (Java™ virtual machine)
- Rastreio Java
Utilize o seguinte formato ao inserir o comando modify.
f <server>, parâmetros
server é o nome abreviado do servidor para o qual o comando modify é direcionado. Esse argumento é obrigatório.
Parameters
Os parâmetros a seguir são válidos para o comando modify:
- DISABLEFAILOVER,'<JNDI Name>'
- Usado para desativar manualmente o suporte de failover de recurso para o recurso identificado pelo nome JNDI fornecido. O nome JNDI fornecido identifica o recurso principal e deve estar entre aspas para preservar seu caso.
- ENABLEFAILOVER,'<JNDI Name>'
- Usado para ativar manualmente o suporte de failover de recurso para o recurso identificado pelo nome JNDI fornecido. O nome JNDI fornecido identifica o recurso principal e deve ser incluído entre aspas simples para preservar a distinção entre letras maiúsculas e minúsculas.
- FAILOVER,'<JNDI Name>'
- Usado para rotear manualmente as solicitações destinadas ao recurso principal para seu recurso alternativo configurado. O nome JNDI fornecido identifica o recurso principal e deve ser incluído entre aspas simples para preservar a distinção entre letras maiúsculas e minúsculas. Para efetuar failback das solicitações para o recurso principal, emita o comando modify com o parâmetro FAILBACK,'<JNDI name>'.
- FAILBACK,'<JNDI Name>'
- Usado para rotear manualmente as solicitações para o recurso principal configurado que é identificado pelo nome JNDI fornecido. O nome JNDI fornecido identifica o
recurso principal e deve ser incluído entre aspas simples para preservar a distinção entre
letras maiúsculas e minúsculas. Este comando ativa automaticamente o failover
automático. Se o failover automático não for desejado após o failback, emita o comando
modify com o parâmetro DISABLEFAILOVER,'<JNDI Name>'. Atenção: A entrada do nome JNDI faz distinção entre maiúsculas de minúsculas.
- CANCEL
- Utilizado para cancelar o servidor especificado.
É possível especificar as seguintes opções para o parâmetro CANCEL:
- ARMRESTART
- Especifica se você está utilizando o agente ARM (Application Response Management) e se deseja que o ARM reinicie o servidor após ser encerrado. Se você não especificar a opção ARMRESTART no parâmetro CANCEL, o ARM não reiniciará o servidor.
- HELP
- Especifica que você deseja visualizar as informações da ajuda que descrevem a sintaxe de CANCEL.
Evitar Problemas: Não é possível usar o parâmetro CANCEL para cancelar um cluster do console MVS. Você deve cancelar individualmente cada um dos servidores que formam o cluster.gotcha
- DPM,[IIOP=nnn | HTTP=nnn | HTTPS=nnn | MDB=nnn | SIP=nnn | CRA=nnn | SIPS=nnn | OLA=nnn | INTERVAL=nnn | dump_action={SVCDUMP|JAVACORE|HEAPDUMP|TRACEBACK|JAVATDUMP|NONE|RESET} | clear_all | reset_all]
O marcador nnn especifica, em segundos, a duração do intervalo de tempo para um tipo de protocolo específico. O valor para o marcador nnn deve ser um número inteiro 0 - 255 ou reset. Um valor 0 ilustra que o protocolo não possui nenhum intervalo e que o DPM está desativado para as solicitações que usam esse protocolo. Um valor reset ilustra que o controle do intervalo DPM é retornado para o atributo de classificação dpm_interval no arquivo de classificação de carga de trabalho.
O comando DPM INTERVAL modify substitui o atributo de classificação dpm_interval. O comando DPM dump_action modify substitui o atributo de classificação dpm_dump_action e a propriedade de todo o servidor server_region_dpm_dump_action.
Ao especificar RESET a ação de dump desativa a ação de dump para o comando modify. As configurações do atributo de classificação dpm_dump_action e a propriedade do servidor server_region_dpm_dump_action estão novamente em vigor.
Um valor especificado no parâmetro INTERVAL configura o intervalo DPM de todos os seis protocolos para o mesmo valor.
O valor clear_all configura os intervalos de tempo de todos os protocolos de solicitação relacionados ao 0 e a ação de dump para None.
O valor reset_all reconfigura todos os intervalos DPM e o parâmetro dump_action. O controle dos intervalos de DPM e da ação de dump é retornado para o arquivo de classificação WLM.
- HEAPDUMP
- Usado para gerar um dump de heap da JVM do controlador e de todos os servidores associados a esse controlador.
- JAVACORE
- Usado para gerar um core dump da JVM do controlador e de todos os servidores associados a esse controlador.
- JAVATDUMP
- Usado para gerar um TDUMP iniciado pela JVM de todos os espaços de endereço do servidor. Também é possível usar a variável de ambiente nativa JAVA_DUMP_TDUMP_PATTERN para especificar o nome do conjunto de dados de TDUMP.
- JAVAOOM,[INTERVAL=nnn | ACTION=xxx | RESET]
- Usado para alterar dinamicamente a ação de diagnóstico que é tomada se
uma condição de falta de memória Java Virtual Machine (JVM) ocorre neste
servidor. Também é usado para alterar dinamicamente o intervalo de tempo no qual
a ação de diagnóstico é repetida.
Especificar INTERVAL configura a quantia de tempo, em segundos, durante a qual uma ação de diagnóstico não é repetida. Este atributo substitui o valor especificado para a variável de ambiente ras_java_oom_interval.
Especificar ACTION configura a ação de diagnóstico que é tomada quando uma condição de falta de memória JVM ocorre neste servidor. Este atributo substitui o valor especificado para a variável de ambiente ras_java_oom_action. Um dos valores a seguir pode ser especificado como o valor para xxx:
- NONE
- Nenhuma ação de diagnóstico é executada.
- WTO
- Uma mensagem de erro BBOO0404E é gravada na cópia impressa.
- SVCDUMP
- Um SVCDUMP do espaço de endereço afetado é obtido, com código secundário C9C2704B.
Especificar RESET reconfigura a ação de diagnóstico e o intervalo para os valores especificados para as variáveis de ambiente ras_java_oom_action e ras_java_oom_interval.
- MSGROUTE,{ERRORLOG|HARDCOPY|CONSOLE|COPYERRORLOG|COPYHARDCOPY|COPYCONSOLE|NONE}{[=xxx][,RESET][,CLEAR]}
- Usado para alterar dinamicamente o local de saída de IDs de mensagens.
O marcador xxx é uma lista delimitada por vírgula de IDs de mensagens do produto a serem roteados pelo servidor de aplicativos. As mensagens podem ser roteadas para mais de um local.
A primeira vez que você emite o comando para um local e um conjunto de mensagens, a lista de mensagens do local é a lista de mensagens do primeiro comando. Se a variável de ambiente do local tiver mensagens definidas, essas mensagens serão anexadas à lista de mensagens do local. Quando o comando for emitido posteriormente para o mesmo local e um outro conjunto de mensagens, o servidor de aplicativos anexará as mensagens do comando subsequente na lista existente de mensagens.
Especificar ERRORLOG roteia as mensagens para o log de erros, em vez de para o local padrão.
Especificar HARDCOPY roteia as mensagens para o log do sistema SYSLOG, também conhecido como hardcopy, em vez do local padrão.
Especificar CONSOLE roteia as mensagens para o console do operador do MVS, em vez de para o local padrão.
Especificar COPYERRORLOG copia as mensagens no log de erro, bem como no local padrão.
Especificar COPYHARDCOPY copia as mensagens no log do sistema SYSLOG, também conhecido como cópia impressa, bem como no local padrão
Especificar COPYCONSOLE copia as mensagens no console do operador MVS, bem como no local padrão.
Especificar NONE suprime o roteamento das mensagens. Um valor NONE tem precedência sobre o roteamento de mensagens para o log de erros, o log do sistema ou o console do operador do MVS.
Especificar RESET com ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG,COPYHARDCOPY,COPYCONSOLE ou NONE significa que as mensagens que são roteadas ou suprimidas vêm do arquivo was.env em vez do comando de modificação MSGROUTE.- Especificar RESET com ERRORLOG roteia as mensagens especificadas na variável de ambiente ras_message_routing_errorlog para o log de erros, em vez de para o local padrão.
- Especificar RESET com HARDCOPY roteia as mensagens especificadas na variável de ambiente ras_message_routing_hardcopy para o log de sistema SYSLOG, em vez de para o local padrão.
- Especificar RESET com CONSOLE roteia as mensagens especificadas na variável de ambiente ras_message_routing_console para o console do operador do MVS, em vez de para o local padrão.
- Especificar RESET com COPYERRORLOG copia mensagens especificadas na variável de ambiente ras_message_routing_copy_errorlog no log de erro, bem como no local padrão.
- Especificar RESET com COPYHARDCOPY copia as mensagens especificadas na variável de ambiente ras_message_routing_copy_hardcopy no log do sistema SYSLOG, bem como no local padrão.
- Especificar RESET com COPYCONSOLE copia as mensagens especificadas na variável de ambiente ras_message_routing_copy_console no console do operador MVS, bem como no local padrão.
- Especificar RESET com NONE suprime o roteamento de mensagens especificadas na variável de ambiente ras_message_routing_hardcopy.
Especificar CLEAR com ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG,COPYHARDCOPY,COPYCONSOLE ou NONE significa que as mensagens são roteadas para um local padrão ou não estão mais suprimidas.- Especificar CLEAR com ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG, COPYHARDCOPY, COPYCONSOLE ou NONE significa que as mensagens são roteadas para um local padrão ou não estão mais suprimidas.
- Especificar CLEAR com ERRORLOG ou COPYERRORLOG roteia mensagens para o local padrão, em vez do log de erro.
- Especificar CLEAR com HARDCOPY ou COPYERRORLOG roteia as mensagens para o local padrão, em vez de para o log do sistema SYSLOG.
- Especificar CLEAR com CONSOLE ou COPYCONSOLE roteia as mensagens para o local padrão, em vez de para o console do operador MVS.
- Especificar CLEAR com NONE cancela a supressão das mensagens.
- RECLASSIFY[,FILE=['/path/to/file.xml']]
- Usado para recarregar dinamicamente o documento de classificação de carga de trabalho
sem precisar reiniciar o servidor. As configurações de classificação de carga de trabalho recarregadas têm efeito imediatamente.
Especificar RECLASSIFY executa a reclassificação usando o arquivo de classificação de carga de trabalho especificado na variável wlm_classification_file.
Especificar um nome de arquivo com o parâmetro de reclassificação, como RECLASSIFY,FILE='/path/to/newfile.xml', executa a reclassificação usando o arquivo de classificação especificado. O valor da variável wlm_classification_file é alterado para o arquivo especificado na opção FILE. Os comandos modify de reclassificação subsequentes que usam a variável wlm_classification_file recarregam o novo arquivo especificado na variável, não o arquivo original.
Especificar RECLASSIFY,FILE= desativa a classificação. A variável wlm_classification_file é configurada como null. Os comandos modify de reclassificação subsequentes que usam a variável wlm_classification_file não afetam o servidor, uma vez que a variável wlm_classification_file não tem valor.
Atenção: Se o novo arquivo de classificação de carga de trabalho não puder ser carregado, o servidor de aplicativos descartará as configurações de classificação recarregadas. O servidor de aplicativos continua a ser executado com as configurações de classificação em vigor antes da emissão do comando modify de reclassificação.Dica: Sempre que o arquivo de classificação de carga de trabalho é carregado com êxito, o servidor de aplicativos emite no log de sistema, SYSLOG, uma mensagem como a mostrada a seguir. A mensagem também é exibida no console do operador em resposta ao comando de exibição DISPLAY,WORK,CLINFO.BBOJ0129I: O arquivo de classificação de carga de trabalho /tmp/wlm4.class.xml foi carregado em 2009/07/14 19:33:35.297 (GMT)
- ROLL_LOGS
- Usado para emitir novamente um redirecionamento de logs de saída do servidor para o sistema de arquivos USS. Um novo conjunto de arquivos de log de saída será criado sob o mesmo diretório de saída e os arquivos de log mais antigos serão preservados. Mensagens serão gravadas no fim dos logs anteriores e no início dos novos logs, criando assim, um link lógico entre os arquivos.
- STACKTRACE
- Utilizado para registrar em log a análise retrospectiva de pilha Java para todos os encadeamentos Java no servidor para o log de erros.
- SMF,REQUEST,{ON|OFF|RESET}
- Usado para controlar a criação de registros SMF 120-9.
O comando modify SMF,REQUEST substitui o atributo de classificação SMF_request_activity_enabled e a propriedade do servidor server_SMF_request_activity_enabled.
Especificar ON ativa a criação de registros SMF 120-9.
Especificar OFF desativa a criação de registros SMF 120-9.
Especificar RESET desativa a configuração do comando modify para a criação de registros SMF 120-9. As configurações do atributo de classificação SMF_request_activity_enabled e a propriedade do servidor server_SMF_request_activity_enabled no momento da reconfiguração estão em vigor.
- SMF,REQUEST,ASYNC,{ON|OFF|RESET}
- Usado na coleção de dados para a Seção ASYNC Formatada
do registro SMF 120-9 sempre que esse registro é criado.
O comando modify SMF,REQUEST,ASYNC substitui a propriedade server_SMF_request_activity_async server-wide.
Especificar ON ativa a coleta dos dados.
Especificar OFF desativa a coleta dos dados. Quando esse valor é especificado, os registros criados possuem zeros para essa seção nos trios do local na parte superior do registro.
Especificar RESET desativa a configuração do comando modify para a coleta dos dados. As configurações para a propriedade server_SMF_request_activity_async server-wide no momento da reconfiguração estão em efeito.
- SMF,REQUEST,CPU,{ON|OFF|RESET}
- Usado na coleta de dados da Seção de Interrupção de Uso da CPU
do registro SMF 120-9, sempre que o registro é criado.
O comando modify SMF,REQUEST,CPU substitui o atributo de classificação SMF_request_activity_CPU_detail e a propriedade do servidor server_SMF_request_activity_CPU_detail.
Especificar ON ativa a coleta dos dados.
Especificar OFF desativa a coleta dos dados. Quando esse valor é especificado, os registros criados possuem zeros para essa seção nos trios do local na parte superior do registro.
Especificar RESET desativa a configuração do comando modify para a coleta dos dados. As configurações do atributo de classificação SMF_request_activity_CPU_detail e a propriedade do servidor server_SMF_request_activity_CPU_detail no momento da reconfiguração estão em vigor.
- SMF,REQUEST,SECURITY,{ON|OFF|RESET}
- Usado na coleta de dados da Seção de Dado de Segurança do
registro SMF 120-9, sempre que esse registro é criado.
O comando modify SMF,REQUEST,SECURITY substitui o atributo de classificação SMF_request_activity_security e a propriedade do servidor server_SMF_request_activity_security.
Especificar ON ativa a coleta dos dados.
Especificar OFF desativa a coleta dos dados. Quando esse valor é especificado, os registros criados possuem zeros para essa seção nos trios do local na parte superior do registro.
Especificar RESET desativa a configuração do comando modify para a coleta dos dados. As configurações do atributo de classificação SMF_request_activity_security e a propriedade do servidor server_SMF_request_activity_security no momento da reconfiguração estão em vigor.
- SMF,REQUEST,TIMESTAMPS,{ON|OFF|RESET}
- Usado na coleta de dados da Seção de Registros de Data e Hora Formatados
do registro SMF 120-9, sempre que esse registro é criado.
O comando modify SMF,REQUEST,TIMESTAMPS substitui o atributo de classificação SMF_request_activity_timestamps e a propriedade do servidor server_SMF_request_activity_timestamps.
Especificar ON ativa a coleta dos dados.
Especificar OFF desativa a coleta dos dados. Quando esse valor é especificado, os registros criados possuem zeros para essa seção nos trios do local na parte superior do registro.
Especificar RESET desativa a configuração do comando modify para a coleta dos dados. As configurações do atributo de classificação SMF_request_activity_timestamps e a propriedade do servidor server_SMF_request_activity_timestamps no momento da reconfiguração estão em vigor.
- SMF,OUTBOUND,ON
- Usado para ativar a criação de registros SMF 120-10.
- SMF,OUTBOUND,OFF
- Usado para desativar a criação de registros SMF 120-10.
- SMF,OUTBOUND,RESET
- Usado para ter a criação de registros SMF 120-10 controlada pelo valor especificado na variável de ambiente server_SMF_outbound_enabled.
- TIMEOUT_DELAY=n
- Utilizado para alterar dinamicamente a variável de opção de atraso do tempo
limite, control_region_timeout_delay, para n segundos. Esse comando modify é usado com
o comando TIMEOUTDUMPACTION modify para configurar um atraso no tempo
limite que permita que a ação de dump especificada, como JAVACORE,
seja concluída quando ocorrer um tempo limite. As ações de dump especificadas no comando TIMEOUTDUMPACTION
modify requerem um atraso de tempo limite que permita que o servant conclua
a ação de dump antes de o servant ser finalizado.
Depois que o dump especificado for usado, é possível emitir novamente este comando para alterar o valor da variável control_region_timeout_delay de volta à sua configuração anterior sem reciclar o servidor.
- TIMEOUTDUMPACTION=n
- Utilizado para indicar qual das seguintes ações é executada sempre que ocorre um tempo limite para o trabalho que foi efetuado dispatch para um servidor quando a propriedade control_region_timeout_delay é configurada para um valor diferente de zero:
- Se NONE ou none for especificado, nenhum dump será efetuado.
- Se JAVACORE ou javacore for especificado, um dump de núcleo Java será executado.
- Se SVCDUMP ou svcdump for especificado, um dump SVC será efetuado.
- Se JAVATDUMP ou javatdump for
especificado, um TDUMP iniciado por JVM será utilizado. Nota: A propriedade control_region_timeout_delay deve ser configurada para um período de tempo longo o suficiente para o servant coletar o JAVATDUMP antes do controlador finalizar o servant. O comando TIMEOUT_DELAY modify pode ser utilizado para alterar dinamicamente o valor da propriedade control_region_timeout_delay.
- TIMEOUTDUMPACTIONSESSION=n
- Utilizado para indicar qual das seguintes ações é executada sempre que ocorre um tempo limite para um pedido HTTP, HTTPS, SIP ou SIPS que foi efetuado dispatch para um servidor, e a propriedade correspondente é configurada para SESSION:
- Se NONE ou none for especificado, nenhum dump será efetuado.
- Se JAVACORE ou javacore for especificado, um dump de núcleo Java será executado.
- Se SVCDUMP ou svcdump for especificado, um dump SVC será efetuado.
- Se JAVATDUMP ou javatdump for especificado, um TDUMP iniciado por JVM será utilizado.
A seguir, está uma lista das propriedades de recuperação correspondentes:- protocol_http_timeout_output_recovery
- protocol_https_timeout_output_recovery
- protocol_sip_timeout_output_recovery
- protocol_sips_timeout_output_recovery
- TRACEALL=n
- Utilizado para estabelecer um nível de rastreio geral para o servidor. Os valores a seguir são níveis de rastreio válidos. Geralmente, você especifica um valor de 1.
- 0: nenhum rastreio é executado
- 1: o rastreio é executado quando ocorre uma exceção
- 2: o rastreio básico é executado
- 3: o rastreio detalhado para todos os componentes é executado.
Evitar Problemas: Tome cuidado ao utilizar o nível 3, pois esse nível de rastreio poderá resultar em mais dados do que o normal para sua revisão.gotcha
- TRACEBASIC=n
- Utilizado para especificar os componentes do produto para os quais você deseja ativar um
nível de rastreio básico. Esse comando pode substituir um nível de rastreio diferente estabelecido por TRACEALL para esses componentes.
Evitar Problemas: Não altere essa variável, a menos que seja indicado pelo Suporte da IBM®. gotcha
A tabela a seguir inclui os valores que podem ser especificados para este parâmetro. É possível especificar um ou mais destes valores para TRACEBASIC ou TRACEDETAIL:
Valor Componente do produto 0 RAS 1 Utilitários Comuns 3 COMM 4 ORB 6 OTS 7 Shasta 9 z/OS Wrappers A Daemon E Security F Externalização J (Deve ser usado apenas sob orientação do Suporte IBM) JRas L Java EE - TRACEDETAIL=n
- Utilizada para especificar os componentes do produto para os quais você deseja ativar um nível detalhado de rastreio. Esse comando ativa o rastreio mais detalhado para os componentes do produto especificados e substitui diferentes configurações em TRACEALL. Os componentes selecionados são identificados pelos seus IDs de componentes, que são os mesmos IDs que os listados para o parâmetro TRACEBASIC. Os subcomponentes, especificados por números, recebem rastreios detalhados. Outras partes do produto recebem o rastreio, conforme especificado no parâmetro TRACEALL.
Evitar Problemas: Não altere essa variável, a menos que seja indicado pelo Suporte da IBM.gotcha
- TRACESPECIFIC=xxyyyzzz
- Utilizado para especificar substituições de rastreio para pontos específicos de rastreio do produto. Os pontos de rastreio são especificados por números hexadecimais de oito dígitos. Para especificar mais de um ponto de rastreio, utilize parênteses e separe os números por vírgulas. Também é possível especificar um nome de variável de ambiente ao colocar o nome entre aspas simples. O valor da variável de ambiente é processado como se esse valor fosse especificado no parâmetro TRACESPECIFIC.
Evitar Problemas: Não utilize TRACESPECIFIC a menos que seja orientado pelo Suporte IBM.gotcha
- TRACE_EXCLUDE_SPECIFIC=xxyyyzzz
- Utilizado para especificar pontos de rastreio do produto a serem excluídos. Os pontos de rastreio são especificados por números hexadecimais de oito dígitos. Para especificar mais de um ponto de rastreio, utilize parênteses e separe os números por vírgulas. Também é possível especificar um nome de variável de ambiente ao colocar o nome entre aspas simples. O valor da variável de ambiente é processado como se esse valor fosse especificado no parâmetro TRACE_EXCLUDE_SPECIFIC. O parâmetro TRACE_EXCLUDE_SPECIFIC pode ser utilizado como uma máscara para desativar rastreios atualmente ativados. Por exemplo, utilize o parâmetro TRACESPECIFIC para ativar o rastreio em uma parte inteira do produto e, em seguida, utilize o parâmetro TRACE_EXCLUDE_SPECIFIC para desativar um rastreio nessa parte do produto.
Evitar Problemas: Não utilize o parâmetro TRACE_EXCLUDE_SPECIFIC a menos que seja orientado a fazer isso pelo Suporte IBM.gotcha
- TRACEINIT
- Utilizado para redefinir para as configurações de rastreio iniciais.
- TRACENONE
- Utilizado para desativar todas as configurações de rastreio.
- TRACETOSYSPRINT={YES|NO}
- Utilizado para selecionar se deve enviar o rastreio para SYSPRINT.
Especificar YES envia o rastreio para SYSPRINT, e especificar NO para o envio do rastreio para SYSPRINT.
- TRACETOTRCFILE={YES|NO}
- Usado para especificar se o rastreio deve ser direcionado para a placa
TRCFILE DD.
Especificar YES envia o rastreio para a placa TRCFILE DD, e especificar NO para o envio do rastreio para a placa TRCFILE DD.
- TRACEJAVA
- Modifique a cadeia de rastreio Java.
A especificação de rastreio Java é utilizada para controlar o rastreio Java, para que esteja em conformidade com as regras de especificação de rastreio Java. *=all=enabled significa ativar todos os tipos de rastreio para todos os componentes de rastreio registrados.
- TRACERECORD,{ON|OFF|RESET}
- Usado para controlar a gravação de registros de rastreio. O parâmetro é
usado com o atributo classification_only_trace definido no arquivo de classificação de
carga de trabalho.
Especificar ON faz com que os registros de rastreio sejam gravados com base na especificação de rastreio atual. Os atributos classification_only_trace são ignorados.
Especificar OFF evita que os registros de rastreio sejam gravados.CUIDADO:Os registros de rastreio baseados na especificação de rastreio atual ou produzidos como parte do processamento normal de tempo de execução não são gravados.Especificar RESET faz com que os registros de rastreio sejam gravados para a especificação de rastreio atual, da seguinte forma:- Se não houver nenhum atributo classification_only_trace definido, os registros de rastreio serão gravados para todos os encadeamentos de processamentos. Esta situação é funcionalmente equivalente à configuração de TRACERECORD como ON.
- Se houver um ou mais atributos classification_only_trace definidos, os registros de rastreio serão gravados apenas para encadeamentos de processamentos cuja classificação contiver um atributo classification_only_trace 1.
O valor-padrão é RESET.
- HELP
- Utilizado para exibir uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify.
Também é possível utilizar o parâmetro HELP após os parâmetros CANCEL e DISPLAY para exibir listas de todas as palavras-chave que podem ser utilizadas com um desses parâmetros.
- PAUSELISTENERS
- Utilizado para impedir que o trabalho seja aceito no servidor. Utilize esse parâmetro para encerrar os listeners de comunicação e limpar qualquer trabalho pendente no registro de trabalhos.
Evitar Problemas: O comando MODIFY server,PAUSELISTENERS para o recebimento do controlador em todas as portas, excetuo IIOP (ORB_TCP_SECURE e ORB_TCP_LISTENER). Para IIOP, quando este comando modify é emitido, o daemon para de enviar solicitações aos canais de transporte IIOP. No entanto, se você estiver executando aplicativos clientes que executam armazenamento em cache, tal como armazenamento em cache de bean, será possível para solicitações destes aplicativos serem enviadas diretamente à porta IIOP aberta. Esta situação pode ocorrer porque os listeners IIOP iniciam antecipadamente no processo de inicialização do servidor, por meio disso, abrindo possivelmente a porta IIOP antes deste comando modify ser emitido.gotcha
- WLM_MIN_MAX=min,max
- Utilizado para modificar dinamicamente os números mínimo e máximo de configurações de servants (wlm_minimumSRCount e wlm_maximumSRCount). O WLM ajusta
dinamicamente o número atual de servidores ativos para que se ajuste às novas
restrições. As novas configurações não são efetivadas de imediato, necessariamente;
o WLM trabalha em direção aos novos destinos mínimo e máximo o mais rápido
possível, considerando fatores como a disponibilidade e a carga de trabalho do recurso.
Evitar Problemas: O comando WLM_MIN_MAX é ignorado para um servidor que está configurado com um ambiente de aplicativo dinâmico de servidor único, no qual a propriedade wlm_dynapplenv_single_server está definida como 1.gotcha
- WORKERTHREADMAX=n
- Usado para aumentar o máximo do conjunto de encadeamentos do trabalhador da região controladora. O valor especificado no comando modify substitui o valor especificado para a variável de ambiente control_region_thread_pool_maximum_size. O máximo só pode ser aumentado. Solicitações para diminuir o máximo serão rejeitadas. Ao especificar um máximo, assegure-se de que haverá recursos suficientes disponíveis para suportar o máximo especificado. Um exemplo de um recurso a considerar é o tamanho de heap JVM.
- RESUMELISTENERS
- Utilizado para reiniciar os listeners de comunicação após emitir um comando modify que inclui o parâmetro PAUSELISTENERS. Esse parâmetro permite que novo trabalho seja aceito no servidor.
- DISPLAY
- Utilizado para exibir o nome do servidor, o nome do sistema em que o servidor está sendo executado e o nível de código atual.
É possível especificar as seguintes opções para esse parâmetro:
- SERVERS exibe o nome do servidor em que o comando é direcionado, o nome do sistema e o nível de código para cada servidor ativo no sysplex que está na mesma célula.
- SERVANTS: exibe uma lista de ASIDs (address space identifiers) dos servants conectados ao servidor no qual o comando display foi emitido.
- TRACE exibe informações de rastreio para um controlador do servidor. É possível modificar ainda mais esse comando com as seguintes opções:
- SRS exibe informações de rastreio para todos os servidores, um de cada vez.
- ALL exibe informações de rastreio para o controlador e todos os servidores, um de cada vez.
- JAVA exibe as configurações da cadeia de rastreio Java para um controlador de servidor. É possível modificar ainda mais esse comando com as seguintes opções:
- SRS exibe informações de rastreio Java para todos os servants, um por vez.
- ALL exibe informações de rastreio Java para o controlador e todos os servants, um por vez.
- HELP exibe uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify display trace Java.
- HELP exibe uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify display trace.
- JVMHEAP exibe as informações de heap da JVM para um controlador do servidor. É possível modificar ainda mais esse comando com as seguintes opções:
- SRS exibe as informações de heap da JVM para todos os servidores, um de cada vez.
- ALL exibe as informações de heap da JVM para o controlador e todos os servidores, um de cada vez.
- HELP exibe uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify display Javaheap.
- LISTENERS exibe o nome da instância de conexão, o endereço IP associado e o número da porta de atendimento. O endereço IP associado pode exibir um asterisco (*) como um curinga.
- CONNECTIONS exibe cada nome da instância de conexão e uma contagem do número de conexões. Cada instância da conexão é uma linha separada. É possível modificar ainda mais esse comando com as seguintes opções:
- NAME='name' exibe o número de conexões associadas para a instância de conexão especificada 'name'. Se o nome da conexão for localizado, mas não tiver conexões, o comando retornará uma contagem de zero. Se o nome da conexão não for localizado, o comando retornará uma mensagem de erro.
- LIST exibe as informações de host remoto de todas as conexões de cada uma das instâncias de conexão. Se um nome da instância de conexão não tiver nenhuma conexão, o comando retornará apenas o nome da instância da conexão.
- LIST, NAME='name' exibe as informações de host remoto para todas as conexões de uma instância de conexão especificada 'name'.
- HELP exibe uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify.
- ERRLOG exibe as 10 últimas entradas no log de
erros. Também é possível modificar essa opção com uma das seguintes opções:
- SRS exibe as 10 últimas entradas no log de erros de todos os servidores, uma de cada vez.
- HELP exibe uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify display error log.
- MODE exibe o modo de bit de execução.
- MSGROUTE exibe a lista de mensagens de todos os
locais de roteamento e das mensagens a serem suprimidas. Os locais de roteamento
podem ser o log de erros, o log do sistema ou o console do operador do MVS.
- ERRORLOG exibe uma lista de mensagens a serem roteadas para o log de erros.
- HARDCOPY exibe uma lista de mensagens a serem roteadas para o log do sistema SYSLOG, também conhecido como hardcopy.
- CONSOLE exibe uma lista de mensagens a serem roteadas para o console do operador do MVS.
- NONE exibe uma lista de mensagens a serem suprimidas.
- SMF exibe o status da criação do registro SMF 120-9
de um servidor.
- ASYNC exibe o status da criação de registro SMF 120-9 para trabalho assíncrono em todos os servidores, um servidor por vez.
- HELP exibe uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify display SMF.
- WORK exibe a contagem dos elementos de trabalho para o servidor. Também é possível modificar essa opção com uma das seguintes opções:
- CRA exibe informações de contagem de solicitações
do bean acionado por mensagens (MDB) CRA. É possível modificar ainda mais esse comando com as seguintes opções:
- SRS exibe informações de contagem de solicitações de CRA para todos os servidores, um por vez.
- HELP exibe uma lista de todas as palavras-chave que podem ser usadas com o comando modify display work CRA.
- ASYNCSERVLET exibe o
número total de solicitações do servlet assíncrono e o número atual
de solicitações do servlet assíncrono que estão sendo processadas. O número total
de solicitações do servlet assíncrono consiste apenas em solicitações feitas desde
o início ou a reinicialização mais recente do servidor inteiro. No entanto, o total
pode diminuir se um ou mais dos servidores tiver sido interrompido ou reiniciado.
- SRS exibe para cada servidor o número total de solicitações do servlet assíncronas e o número atual de solicitações do servlet assíncronas que estão sendo processadas. O número total é o número de solicitações do servlet assíncrono desde o último início ou última reinicialização do servidor.
- HELP exibe uma lista de todas as palavras-chave que podem ser usadas com o comando modify display work asyncservlets.
- EJB exibe informações de contagem de pedidos EJB (Enterprise JavaBeans).
É possível modificar essa opção com uma das seguintes opções:
- SRS exibe informações de contagem de pedidos EJB para todos os servants, um de cada vez.
- HELP exibe uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify display work EJB.
- SERVLET exibe informações de contagem de pedidos do servlet.
É possível modificar essa opção com uma das seguintes opções:
- SRS exibe informações de contagem de pedidos do servlet para todos os servants, um de cada vez.
- HELP exibe uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify display work servlet.
- MDB exibe informações de contagem de pedido MDB (bean acionado por mensagens). É possível modificar ainda mais esse comando com as seguintes opções:
- SRS exibe informações de contagem de pedidos MDB para todos os servants, um de cada vez.
- HELP exibe uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify display work MDB.
- SIP exibe informações de contagem de pedido SIP (Session Initiation Protocol). É possível modificar essa opção com uma das seguintes opções:
- SRS exibe informações de contagem de pedidos SIP para todos os servants, um de cada vez.
- HELP exibe uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify display work SIP.
- SUMMARY exibe informações de contagem de pedidos de resumo.
- SRS exibe informações de contagem de pedidos de resumo para todos os servants, um de cada vez.
- HELP exibe uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify display work summary.
- ALL exibe todas as informações de contagem de pedidos.
- SRS exibe todas as informações de contagem de pedidos para todos os servants, um de cada vez.
- STATS exibe todas as estatísticas detalhadas.
- HELP exibe uma lista de todas as palavras-chave que é possível utilizar com o comando modify display work all.
- CLINFO exibe informações de classificação de trabalho.
- HELP exibe uma lista de todas as palavras-chave que podem ser utilizadas com o comando modify display work.
- OLA exibe solicitações de entrada do OLA (Optimized Local Adapter)
orientadas pelos serviços BBOA1INV e BBOA1SRQ. É possível modificar ainda mais esse comando com as seguintes opções:
- SRS exibe informações de contagem de solicitações OLA para todos os servidores, um de cada vez.
- HELP exibe uma lista de todas as palavras-chave que é possível utilizar com o comando modify display work all.
- CRA exibe informações de contagem de solicitações
do bean acionado por mensagens (MDB) CRA. É possível modificar ainda mais esse comando com as seguintes opções:
- FRCA (Fast Response Cache Accelerator). Exiba as estatísticas de cache do FRCA da
seguinte forma:
- f <servername>,display,frca
- f <servername>,display,frca,content
- f <servername>,display,frca,stats
- ADAPTER
- STATUS exibe o status do componente de adaptadores locais otimizados.
- REGISTRATIONS exibe uma lista de clientes de adaptadores locais otimizados conectados a este servidor.
- DAEMONRGES exibe uma lista de clientes de adaptadores locais otimizados conectados a qualquer servidor neste grupo de daemons.
- SEARCHRGES exibe uma lista de clientes de adaptadores locais otimizados conectados a qualquer servidor neste grupo de daemons, correspondendo os critérios de procura.
- ASIDX=
- Inclua ASIDX= após o comando modify com o
ASID apropriado (em hexa) de uma região servidora na qual deseja executar dump.Exemplo
Neste exemplo, o comando utiliza um JAVACORE da região servidora cujo ASID (hexa) é 'F4'.MODIFY server,JAVACORE,ASIDX=F4
Exemplo: Desativando o Failover
f bbos001,DISABLEFAILOVER,'jdbc/MySampleDataSource'
Exemplo: Cancelando Clusters de Aplicativo e Servidores com o Comando modify
Não é possível cancelar um cluster do console MVS. Em vez disso, você deve cancelar cada um dos servidores que formam o cluster.
f bbo6acr,cancel
f bbo6acr,cancel,armrestart
Exemplo: Estabelecendo um nível geral de rastreio usando script
f server,traceall=n
Os níveis de rastreio válidos são: 0 (nenhum), 1 (exceção), 2 (básico) e 3 (rastreio detalhado). Sob condições normais e em produção, utilize 1 (exceção).
f bbo6acr,traceall=1
f bbo6acr,traceall=1
BBOO0211I COMANDO DE MODIFICAÇÃO TRACEALL=1 CONCLUÍDO COM SUCESSO
Exemplo: Configurando Níveis de Rastreio Básico e Ddetalhado para os Componentes do WebSphere z/OS
f server,tracebasic=(n,...)
f bbo6acr,tracebasic=a
f bbo6acr,TRACEBASIC=A
BBOO0211I MODIFY COMMAND TRACEBASIC=A COMPLETED SUCCESSFULLY
f server,tracedetail=(n,...)
f bbo6acr,tracedetail=e
f bbo6acr,TRACEDETAIL=E
BBOO0211I MODIFY COMMAND TRACEDETAIL=E COMPLETED SUCCESSFULLY
Exemplo: Configurando Pontos de Rastreio Específicos Usando Script
f server,tracespecific=n | (n,...)
f bbo6acr,tracespecific=04006001
f bbo6acr,tracespecific=(04006001,04006027)
f bbo6acr,tracespecific='tracepoints'
Exemplo: Excluindo Pontos de Rastreio Específicos Usando Script
f server,trace_exclude_specific=n | (n,...)
f bbo6acr,tracespecific=04006000
f bbo6acr,trace_exclude_specific=04006031
Exemplo: Redefinindo para as Configurações de Rastreio Iniciais Usando Script
f server,traceinit
Exemplo: Comando para Desativar o Rastreio Usando uma Linha de Comandos
f server,tracenone
Exemplo: Enviando o Rastreio para SYSPRINT Usando Script
f server,tracetosysprint=yes
f server,tracetosysprint=no
Exemplo: Cancelando Clusters de Aplicativo e Servidores com o Comando modify
Este exemplo demonstra como cancelar clusters de aplicativo e servidores com o comando modify.
Antes de começar: Você não pode cancelar um cluster do console MVS. Em vez disso, você deve cancelar cada um dos servidores que formam o cluster.
f bbo6acr,cancel
f bbo6acr,cancel,armrestart
Exemplo: Obtendo Ajuda para o Comando modify
É possível obter ajuda de sintaxe para vários níveis do comando modify.
f bbo6acr,help
F bbo6acr,HELP
BBOO0178I A MODIFICAÇÃO DO COMANDO PODE SER SEGUIDA POR UMA DAS SEGUINTES PALAVRAS-CHAVE:
BBOO0179I CANCEL - CANCELAR ESTA REGIÃO DE CONTROLE
BBOO0179I TRACEALL - CONFIGURAR O NÍVEL DE RASTREIO GERAL
BBOO0179I TRACEBASIC - CONFIGURAR COMPONENTES DE RASTREIO BÁSICOS
BBOO0179I TRACEDETAIL - CONFIGURAR COMPONENTES DE RASTREIO DETALHADOS
BBOO0179I TRACESPECIFIC - CONFIGURAR PONTOS DE RASTREIO ESPECÍFICOS
BBOO0179I TRACEINIT - RECONFIGURAR PARA CONFIGURAÇÕES DE RASTREIO INICIAIS
BBOO0179I TRACENONE - DESATIVAR TODO O RASTREIO
BBOO0179I TRACETOSYSPRINT - ENVIAR SAÍDA DE RASTREIO PARA SYSPRINT (SIM/NÃO)
BBOO0179I TRACETOTRCFILE - ENVIAR SAÍDA DE RASTREIO PARA TRCFILE DD CARD (SIM/NÃO)
BBOO0179I DISPLAY - EXIBIR STATUS
BBOO0179I TRACE_EXCLUDE_SPECIFIC - EXCLUIR PONTOS DE RASTREIO ESPECÍFICOS
BBOO0179I TRACEJAVA - CONFIGURAR OPÇÕES DE RASTREIO JAVA
BBOO0179I TRACETOTRCFILE - ENVIAR SAÍDA DE RASTREIO PARA TRCFILE (SIM/NÃO)
BBOO0179I MDBSTATS - MDB DETAILED STATISTICS
BBOO0179I PAUSELISTENERS - PAUSAR OS LISTENERS DE COMUNICAÇÃO
BBOO0179I RESUMELISTENERS - RESUME THE COMMUNICATION LISTENERS
BBOO0179I STACKTRACE - REGISTRAR RASTREIOS DE PILHA DE ENCADEAMENTO JAVA
BBOO0179I TIMEOUTDUMPACTION - CONFIGURAR AÇÃO DO DUMP DE TEMPO LIMITE
BBOO0179I TIMEOUTDUMPACTIONSESSION - SET TIMEOUT DUMP ACTION SESSION
BBOO0179I WLM_MIN_MAX - REDEFINIR CONFIGURAÇÕES DO SERVANT MÍN./MÁX. DO WLM
f bbo6acr,display,help
F BBOS001,DISPLAY,HELP
BBOO0178I A EXIBIÇÃO DO COMANDO PODE SER SEGUIDA POR UMA DAS SEGUINTES
124
PALAVRAS-CHAVE:
BBOO0179I SERVERS - EXIBIR PROCESSOS DE CONTROLE ATIVOS
BBOO0179I SERVANTS - DISPLAY SERVANT PROCESSES OWNED BY THIS CONTROL 126
PROCESS
BBOO0179I LISTENERS - EXIBIR LISTENERS
BBOO0179I CONNECTIONS - EXIBIR INFORMAÇÕES DE CONEXÃO
BBOO0179I TRACE - EXIBIR INFORMAÇÕES SOBRE CONFIGURAÇÕES DE RASTREIO
BBOO0179I JVMHEAP - EXIBIR ESTATÍSTICAS DE HEAP DA JVM
BBOO0179I WORK - EXIBIR ELEMENTOS DE TRABALHO
BBOO0179I ERRLOG - EXIBIR AS ÚLTIMAS 10 ENTRADAS NO LOG DE ERROS
BBOO0179I MODE - EXIBIR O MODO DE BIT DE EXECUÇÃO
BBOO0188I FIM DA SAÍDA PARA EXIBIÇÃO DE COMANDOS,AJUDA
f bbos001,timeoutdumpactionsession=help
BBOO0178I THE COMMAND MODIFY TIMEOUTDUMPACTIONSESSION= MAY BE FOLLOWED BY
UMA DAS SEGUINTES PALAVRAS-CHAVE:
BBOO0179I SVCDUMP - DUMP SVC
BBOO0179I JAVACORE - DUMP DE NÚCLEO JAVA
BBOO0179I NONE - NENHUM DUMP
f bbos001,dpm,help
BBOO0178I THE COMMAND MODIFY DPM, MAY BE FOLLOWED BY ONE OF THE
SEGUINTES PALAVRAS-CHAVE:
BBOO0179I IIOP - IIOP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I HTTP - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH HTTP
BBOO0179I HTTPS - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH HTTPS
BBOO0179I MDB - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH MDB
BBOO0179I SIP - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH SIP
BBOO0179I SIPS - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH SIPS
BBOO0179I INTERVAL - TODOS OS INTERVALOS DE MONITOR DE PROGRESSO DE DISPATCH
BBOO0179I OLA - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH OLA
BBOO0179I DUMP_ACTION - AÇÃO DE DUMP DO MONITOR DE PROGRESSO DE DISPATCH
BBOO0179I CLEAR_ALL - LIMPAR TODAS AS CONFIGURAÇÕES DO MONITOR DE PROGRESSO DE DISPATCH
BBOO0179I RESET_ALL - RECONFIGURAR TODAS AS CONFIGURAÇÕES DO MONITOR DE PROGRESSO DE DISPATCH
BBOO0211I COMANDO MODIFY DPM CONCLUÍDO COM ÊXITO
Se
tiver o Fix Pack 8.5.5.1 ou superior instalado, a saída resultante será
como o exemplo a seguir:BBOO0178I THE COMMAND MODIFY DPM, MAY BE FOLLOWED BY ONE OF THE
SEGUINTES PALAVRAS-CHAVE:
BBOO0179I IIOP - IIOP DISPATCH PROGRESS MONITOR INTERVAL
BBOO0179I HTTP - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH HTTP
BBOO0179I HTTPS - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH HTTPS
BBOO0179I MDB - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH MDB
BBOO0179I SIP - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH SIP
BBOO0179I SIPS - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH SIPS
BBOO0179I OLA - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH OLA
BBOO0179I INTERVAL - TODOS OS INTERVALOS DE MONITOR DE PROGRESSO DE DISPATCH
BBOO0179I DUMP_ACTION - AÇÃO DE DUMP DO MONITOR DE PROGRESSO DE DISPATCH
BBOO0179I CLEAR_ALL - LIMPAR TODAS AS CONFIGURAÇÕES DO MONITOR DE PROGRESSO DE DISPATCH
BBOO0179I RESET_ALL - RECONFIGURAR TODAS AS CONFIGURAÇÕES DO MONITOR DE PROGRESSO DE DISPATCH
BBOO0179I CRA - INTERVALO DO MONITOR DE PROGRESSO DE DISPATCH MDB CRA
BBOO0211I COMANDO MODIFY DPM CONCLUÍDO COM ÊXITO
Exemplo: Modificando a Sequência de Rastreio Java
Este exemplo mostra como usar um comando de console para modificar uma sequência de rastreio Java.
f server, tracejava='trace specification'
f bbo6acr,tracejava='*=all'
Exemplo: Modificando a Ação de Diagnóstico que É Tomada se Ocorre uma Condição de Falta de Memória na JVM
Este exemplo mostra como usar um comando do console para modificar a ação de diagnósticos que é tomada se ocorre uma condição de falta de memória na Java Virtual Machine (JVM), use o comando a seguir:
f server,javaoom,[interval=xxx | action=xxx]
f bbo6acr,,javaoom,[interval=1200 | action=svcdump]