Propriedades Personalizadas da Java Virtual Machine

É possível utilizar o console administrativo para alterar os valores das propriedades customizadas da Java™ Virtual Machine (JVM).

Nota: Esse tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma recomendação alternativa, é possível configurar o servidor para usar a infraestrutura de log e rastreio do High Performance Extensible Logging (HPEL) em vez de usar os arquivos SystemOut.log , SystemErr.log, trace.log e activity.log em sistemas distribuídos e IBM® i. Também é possível usar HPEL em conjunção com os recursos de criação de log z/OS nativos. Se você estiver usando HPEL, será possível acessar todas as informações de log e rastreio usando a ferramenta de linha de comandos LogViewer a partir do diretório bin do perfil do servidor. Consulte as informações sobre a utilização do HPEL para resolução de problemas dos aplicativos para obter mais informações sobre o uso do HPEL.

Para configurar propriedades customizadas, conecte-se ao console administrativo e navegue para a página apropriada de propriedades customizadas da Java virtual machine.

Servidor de aplicativos Gerenciador de implementação Agente do nó

[z/OS]Clique em Servidores > Tipos de Servidores. e em Servidores de Aplicativos WebSphere > server_name ou em Servidores Proxy WebSphere > server_name. Em seguida, na seção Infraestrutura do Servidor, clique em Gerenciamento Java e Processos > Definição de Processo e selecione Controle, Servidor ou Adjunto. Em seguida, clique em Java Virtual Machine > Propriedades Customizadas.

[AIX Solaris HP-UX Linux Windows][IBM i]Clique em Servidores > Tipos de Servidor e em Servidores de Aplicativos WebSphere > server_name ou em Servidores Proxy do WebSphere > server_name. Em seguida, em Infraestrutura do Servidor, clique em Gerenciamento Java e Processos > Definição de Processo > Java Virtual Machine > Propriedades Customizadas.

[z/OS]Clique em Administração do Sistema > Gerenciador de Implementação > Gerenciamento de Java e Processo > Definição de Processo > Controle > Java Virtual Machine > Propriedades Customizadas

[AIX Solaris HP-UX Linux Windows][IBM i]Administração do Sistema > Gerenciador de Implementação > Gerenciamento de Java e Processos > Definição de Processo > Java Virtual Machine > Propriedades Customizadas

[z/OS] Administração do sistema > Agente do nó > nodeagent_ name > Gerenciamento de Java e processos > Definição de processo > Controle > Java virtual machine > Propriedades customizadas

[AIX Solaris HP-UX Linux Windows][IBM i] Administração do sistema >Agente do nó > nodeagent_name > Gerenciamento de Java e processos > Definição de processo > Java virtual machine > Propriedades customizadas

Se a propriedade customizada não estiver presente na lista de propriedades customizadas já definidas, crie uma nova propriedade e digite o nome da propriedade no campo Nome e um valor válido no campo Valor. Reinicie o servidor para concluir suas mudanças.

É possível utilizar a página de Propriedades customizadas para definir as seguintes propriedades para utilização pela Java virtual machine.

allowDeployerRoleGenPluginCfg

Configure esta propriedade customizada como true para ativar usuários com a função de implementador para gerar e configurar o arquivo plugin-cfg.xml. Após configurar e salvar esta propriedade customizada, reinicie o servidor de aplicativos.

Se a propriedade customizada estiver ausente ou seu valor estiver configurado como false, as situações a seguir ocorrerão quando o usuário tiver as permissões de função de implementador:
  • Falha nos processos de geração e configuração.
  • Uma mensagem de erro é emitida.

Para desativar esta função, exclua a propriedade customizada ou configure seu valor como false.

Além disso, é possível configurar essa propriedade customizada a partir da linha de comandos que usa a ferramenta wsadmin e o seguinte script Jacl:
#-------------------------------------------------------------------------
# setAllowDeployer.jacl - Script Jacl para configurar a propriedade allowDeployerRoleGenPluginCfg
property 
# do plug-in de servidor da web para o WebSphere Application Server
#-------------------------------------------------------------------------
#    Este arquivo Jacl modifica o arquivo server.xml para um aplicativo
em execução. Este script é projetado 
#    para ser invocado enquanto o AppServer está em execução.
#
#    Eis um exemplo de como invocar o script:
#	   wsadmin -f setAllowDeployer.jacl &ltnodeName> &ltserverName> &ltenableValue>

#------------------------------------------------------------------------
proc printUsageAndExit {} {
     puts " "
     puts "Uso: wsadmin -f setAllowDeployer.jacl &ltnodeName> <serverName> <boolEnable>"
     puts "Nota: o argumento enableValue é do tipo booleano; os valores válidos
são true e false."	
     exit
 }
 if { [llength $argv] >= 3 } {
     set nodename [lindex $argv 0]
     set servername [lindex $argv 1]
     set enablevalue [lindex $argv 2]
 } else {
     printUsageAndExit
 }  

set cellname [$AdminControl getCell]
set propname "allowDeployerRoleGenPluginCfg" 
set propdesc "Permitir função de implementador condicional para geração e propagação
de plug-in" 
set required "false"  

set jvm [$AdminConfig getid 
/Cell:${cellname}/Node:${nodename}/Server:${servername}/JavaProcessDef:/JavaVirtualMachine:/]

$AdminConfig modify $jvm [subst {{systemProperties {{{name {$propname}}
{value {$enablevalue}} 
{description {$propdesc}} {required {$required}}}}}}]  
$AdminConfig save   

exit 0
Uso:
wsadmin -f setAllowDeployer.jacl node_name server_name true

com.ibm.cacheLocalHost

Configure esta propriedade para true, para instruir o IBM SDK for Java a armazenar em cache o endereço IP retornado do java/net/InetAddress.getLocalHost por toda a vida do JVM. Esse é um aprimoramento de desempenho que é informado em todos os processos, se o endereço de host local de um processo não mudar enquanto ele estiver em execução.

Nota: O endereço para servidores configurado usando a mudança do DHCP ao longo do tempo. Não configure esta propriedade, a menos que esteja usando endereços IP estaticamente designados para o seu servidor.

com.ibm.apc.nodeMMTimeout

Ao configurar um nó no modo de manutenção e o APC estiver configurado como automático, por padrão, o gerenciador de implementação atingirá o tempo limite da operação de modo de manutenção após 20 minutos. Isso pode ser mudado configurando o argumento genérico de JVM -DnodeMMTimeout no gerenciador de implementação e reiniciando o gerenciador de implementação. Por exemplo, é possível configurar -DnodeMMTimeout como 60 para alocar 60 minutos antes de a operação do modo de manutenção atingir o tempo limite. Relativamente, apcConcurrentStartSize pode ajudar a reduzir o tempo gasto para o APC manipular a operação de modo de manutenção e outras considerações, como min != max no cluster dinâmico pode reduzir as chances de o APC precisar fazer mudanças.

com.ibm.config.allow.set.session.timeout

Configure essa propriedade customizada para reverter o comportamento de PI20040, pois ele se aplica ao elemento session-timeout de web.xml.

Deixe esta propriedade customizada sem configuração para obter o comportamento atualizado fornecido por PI20040.

O comportamento padrão é obter o comportamento atualizado de PI20040. O comportamento atualizado é corrigido de acordo com a especificação do Servlet e é o novo comportamento padrão ao gravar os valores session-timeout . A propriedade customizada é fornecida para reativar o comportamento anterior.

com.ibm.config.eclipse.wtp.enablejemtrim

Use essa propriedade customizada para ativar a limpeza de nós do DOM intermediários após ocorrer a análise de XML dos metadados para um aplicativo.

Evitar Problemas Evitar Problemas: A configuração para essa propriedade deve corresponder à configuração para a propriedade customizada com.ibm.config.eclipse.wtp.enablexmltrim. Ambas as propriedades devem ser deixadas sem configurar, configuradas como false ou configuradas como truegotcha

O valor padrão é false.

com.ibm.config.eclipse.wtp.enablexmltrim

Use essa propriedade customizada para ativar o compartilhamento de instâncias JavaClass e a conversão de objetos JavaClass e JavaMethod expandidos para proxies leves após serem usados.

Evitar Problemas Evitar Problemas: A configuração para essa propriedade deve corresponder à configuração para a propriedade customizada com.ibm.config.eclipse.wtp.enablejemtrim. Ambas as propriedades devem ser deixadas sem configurar, configuradas como false ou configuradas como true.gotcha

O valor padrão é false.

com.ibm.config.eclipse.wtp.jem=finer

Use essa propriedade customizada para gerar um rastreio a partir de áreas de código que são ativadas quando a propriedade customizada com.ibm.config.eclipse.wtp.enablejemtrim é configurada como true.

Evitar Problemas Evitar Problemas: Essa propriedade pode impactar o desempenho. Portanto, essa propriedade deve ser especificada somente se ocorrer um problema durante a limpeza de nós do DOM após ocorrer a análise de XML dos metadados para um aplicativo e se for preciso obter informações adicionais para diagnosticar a causa desse problema.gotcha

com.ibm.config.eclipse.wtp.xmltrim=finer

Use essa propriedade customizada para gerar um rastreio a partir de áreas de código que são ativadas quando a propriedade customizada com.ibm.config.eclipse.wtp.enablexmltrim é configurada como true.

Evitar Problemas Evitar Problemas: Essa propriedade pode impactar o desempenho. Portanto, essa propriedade deve ser especificada somente se ocorrer um problema com o compartilhamento de instâncias JavaClass ou a conversão de objetos JavaClass e JavaMethod expandidos para proxies leves após serem usados e se for preciso obter informações adicionais para diagnosticar a causa desse problema.gotcha

com.ibm.disableCommonsElCache

Configure a propriedade customizada do contêiner de web com.ibm.wsspi.jsp.disableElCache como true para desativar o cache de expressões commons-el, se estiverem ocorrendo condições de falta de memória, porque os hashmaps são retidos pelo avaliador de expressões.

O valor padrão é false

[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]

com.ibm.eclipse.wtp.allowRootedEntries

Em releases de serviço anteriores, arquivos de propriedades no diretório-raiz de um arquivo enterprise archive (EAR) não são lidos corretamente. Assim, nesse release de serviço e posterior, o comportamento é alterado de modo que o caminho da classe em arquivos META-INF e MANIFEST.MF é tratado como uma URI relativa. Para reverter para o comportamento original, configure com.ibm.eclipse.wtp.allowRootedEntries como true.

com.ibm.ejs.ras.disablerasnotifications

Use essa propriedade para desativar e ativar o serviço RAS. Quando essa propriedade estiver definida como true, os serviços RAS serão desativados. O valor-padrão para esta propriedade é false.

com.ibm.ejs.ras.writeSystemStreamsDirectlyToFile

Use esta propriedade customizada para suportar a criação de log customizada JSR-47 para gravação no fluxo SystemOut sem o formato do WebSphere Application Server. O formato do WebSphere Application Server inclui informações, por exemplo, registro de data e hora, ID de encadeamento e algumas outras. Um aplicativo poderá não desejar que estas informações sejam exibidas no fluxo do SystemOut (ou talvez prefira que as informações sejam exibidas em um formato diferente). Para desativar o formato do WebSphere Application Server, configure essa propriedade customizada como true.

com.ibm.ejs.sm.server.quiesceInactiveRequestTime

Utilize esta propriedade customizada para especificar, em milissegundos, com que velocidade os pedidos IIOP feitos por meio do Object Request Broker (ORB) podem ser recebidos e processados. Por exemplo, se você especificar um valor de 5.000 para essa propriedade, o servidor não tentará encerrar até que as solicitações que chegam individualmente em intervalos de no mínimo 5 segundos. Se o valor especificado para essa propriedade for muito grande, quando o servidor de aplicativos for parado no console administrativo, a seguinte mensagem de erro poderá ser emitida:
Ocorreu um erro ao parar Server1. Verifique os logs de erros para obter informações adicionais.

O valor padrão é 5000 (5 segundos).

Se decidir usar esta propriedade customizada, será possível especificá-la como uma propriedade customizada JVM para um servidor de aplicativos, um agente do nó ou um gerenciador de implementação. Ela é geralmente configurada como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ejs.sm.server.quiesceTimeout

Utilize esta propriedade customizada para especificar, em segundos, a duração geral do tempo limite de quiesce. Se um pedido ainda estiver pendente após esse tempo em segundos, o servidor poderá iniciar o encerramento. Por exemplo, um valor de 180 seria 3 minutos. Se o tempo de quiesce for excedido, o regulador de carga de trabalho rejeitará todas as solicitações recebidas e ocorrerá o encerramento do servidor.
Nota: A mensagem WTRN0036W é emitida quando existem transações pendentes enquanto o servidor está no estado de quiesce.
O valor padrão é 180.
Nota: Se o valor de tempo limite for configurado como zero, a função quiesce será desativada.

Se decidir usar esta propriedade customizada, será possível especificá-la como uma propriedade customizada JVM para um servidor de aplicativos, um agente do nó ou um gerenciador de implementação. Geralmente, ela é configurada como uma propriedade customizada da JVM do servidor de aplicativos.

com.ibm.ffdc.log

Use esta propriedade customizada para especificar onde armazenar os dados de primeira captura de dados com falha (FFDC) quando ocorrer uma falha durante o processamento de tempo de execução do produto. O recurso FFDC coleta instantaneamente informações sobre os eventos e erros que levaram à falha. Os dados capturados podem, então, ser usados para analisar o problema. Após as informações serem coletadas e salvas em um arquivo de log, FFDC retorna controle aos mecanismos afetados.

Exemplo de uso, especificando um local de pasta para o arquivo de log:
Nome: com.ibm.ffdc.log
Valor: C:\my_FFDC_CP\
Exemplo de uso, especificando um nome de arquivo real para o arquivo de log:
Name: com.ibm.ffdc.log
Valor: C:\my_FFDC_CP_log

com.ibm.websphere.application.updateapponcluster.waitforappsave

Use essa propriedade customizada para especificar, em segundos, o período de tempo que você deseja que o gerenciador de implementação espere a conclusão das tarefas de extensão da operação de salvamento, antes de ela iniciar o aplicativo atualizado.

Evitar Problemas Evitar Problemas: Essa propriedade será válida apenas se for especificada para um gerenciador de implementação.gotcha

Geralmente, durante a operação de salvamento para uma atualização do aplicativo que está sendo executada usando o processo de atualização de lançamento, as tarefas de extensão da operação de salvamento são executadas como uma operação em segundo plano em um encadeamento separado. Se o encadeamento principal da operação de salvamento for concluído antes da parte de sincronização do processo de atualização de implementação, o aplicativo atualizado falhará ao ser iniciado adequadamente.

Ao incluir essa propriedade customizada nas configurações do gerenciador de implementação, se as tarefas de extensão da operação de salvamento não forem concluídas dentro do período de tempo especificado, o processo de atualização de lançamento irá parar o processo de atualização do aplicativo, evitando que o aplicativo fique corrompido durante a parte de sincronização do processo de atualização de lançamento.

O valor padrão é 180.

[z/OS]

com.ibm.websphere.bean.delete.sleep.time

Utilize essa propriedade para especificar o tempo entre varreduras para verificar os beans com tempo limite esgotado. O valor é inserido em segundos. Por exemplo, um valor de 120 corresponde a 2 minutos. Essa propriedade também controla o intervalo no processo Servant que verifica os beans com tempo limite expirado ainda visíveis para o contêiner de enterprise bean.

O valor padrão é 4200 (70 minutos). O valor mínimo é 60 (1 minuto). O valor pode ser alterado através do console administrativo. Para aplicar essa propriedade, especifique o valor nas Propriedades de JVM Personalizadas do Controle e do Servant.

com.ibm.websphere.deletejspclasses

Use essa propriedade para indicar que você deseja excluir as classes JavaServer Pages para todos os aplicativos, depois que eles forem excluídos ou atualizados. O valor padrão é false.

Evitar Problemas Evitar Problemas: Em um ambiente de Implementação de Rede, essa propriedade se aplica ao Websphere Application Server.gotcha

Configure esta propriedade em um agente do nó quando o servidor de aplicativos for executado em uma célula federada.

com.ibm.websphere.deletejspclasses.delete

Use essa propriedade para indicar que você deseja excluir as classes JavaServer Pages para todos os aplicativos, depois que eles forem excluídos, mas não depois de serem atualizados. O valor padrão é false.

Evitar Problemas Evitar Problemas: Em um ambiente do Network Deployment, essa propriedade se aplica ao Websphere Application Server.gotcha

Configure esta propriedade em um agente do nó quando o servidor de aplicativos for executado em uma célula federada.

com.ibm.websphere.deletejspclasses.update

Use essa propriedade para indicar que você deseja excluir as classes JavaServer Pages para todos os aplicativos, depois de serem atualizados, mas não depois de serem excluídos. O valor padrão é false.

Evitar Problemas Evitar Problemas: Em um ambiente do Network Deployment, essa propriedade se aplica ao Websphere Application Server.gotcha

Configure esta propriedade em um agente do nó quando o servidor de aplicativos for executado em uma célula federada.

com.ibm.websphere.ejb.UseEJB61FEPScanPolicy

Use essa propriedade para controlar se o produto varre os módulos pré-Java EE 5 para mais metadados durante o processo de instalação do aplicativo ou durante a inicialização do servidor. Por padrão esses módulos EJB legado não são varridos.

O valor padrão é false.

Você deve configurar essa propriedade como true para cada servidor e servidor administrativo que exigir uma alteração no valor padrão.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.ejbcontainer.expandCMPCFJNDIName

O contêiner EJB deve permitir a expansão do Nome JNDI do Connection factory CMP quando o nome JNDI de um usuário contiver uma variável do Application Server definida pelo usuário. A propriedade customizada, com.ibm.websphere.ejbcontainer.expandCMPCFJNDIName, permite expandir o Nome JNDI do Connection Factory CMP.

Se o valor for true, que é o padrão, o Contêiner EJB expandirá uma variável quando localizada no Nome de JNDI do Connection Factory CMP. Se o valor for configurado como false, o Contêiner EJB não expandirá uma variável.

Se decidir usar esta propriedade customizada, você deverá especificá-la como uma propriedade customizada da JVM do servidor de aplicativos.

com.ibm.websphere.ejbcontainer.includeRootExceptionOnRollback

Use essa propriedade customizada Enterprise JavaBeans (EJB) para ativar as seguintes funções:
  • Permitir que a causa raiz de um retrocesso de transação seja incluída em uma TransactionRolledbackLocalException, se a transação for emitida por um responsável pela chamada local.
  • Permitir que a causa raiz de um retrocesso de transação do método de confirmação seja incluída em uma TransactionRolledbackLocalException, mesmo que a transação seja emitida por um responsável pela chamada remoto.
  • Permita que as Exceções Heurísticas sejam retornadas ao invés de uma TransactionRolledbackLocalException, para um cliente local ou uma TransactionRolledbackLocalException, para um cliente remoto.
  • Permita que uma RemoteException seja retornada de um método EJB remoto, mesmo se esse método estiver em execução no contexto da transação da chamada. Por exemplo, considere que EJB1, método m1, inicia uma transação e chama EJB2, método m2, em que m2 causa uma exceção não manipulada. Nesse caso, a Especificação EJB manda que m1 receba uma TransactionRolledbackException. Configurar essa propriedade como true permite que uma RemoteException, que inclui exceções aninhadas, seja retornada em vez da TransactionRolledbackException, mesmo que essa função seja contrária ao requisito de Especificação EJB.

Para ativar essa função, configure essa propriedade como true. Para desativar essa função, configure essa propriedade como false.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deverá especificá-la como uma propriedade customizada da JVM do servidor de aplicativos.

com.ibm.websphere.jaxrpc.stub.typemapping.per.thread

Use essa propriedade para indicar se o tempo de execução do JAX-RPC deve usar objetos de mapeamento de tipo específicos do encadeamento.

O tempo de execução do JAX-RPC usa um único objeto TypeMappingRegistry para todos os clientes do JAX-RPC. Esse design é intencional e permite criar um stub do JAX-RPC e usá-lo em diversos encadeamentos. No entanto, o singleton TypeMappingRegistry ficará contaminado se vários serviços da web JAX-RPC com diferentes mapeamentos forem chamados simultaneamente. Embora essa situação seja incomum, se ela existir em seu sistema, será possível configurar a propriedade customizada com.ibm.websphere.jaxrpc.stub.typemapping.per.thread como true para indicar ao tempo de execução JAX-RPC que ele pode usar objetos de mapeamento do tipo específico de encadeamento. Esses objetos de mapeamento separados evitam o problema da contaminação, permitindo êxito nas diversas chamadas de serviço da Web.

O valor padrão é false.

Evitar Problemas Evitar Problemas: Essa propriedade customizada não deve ser usada, a menos que seja encontrada uma situação na qual o singleton TypeMappingRegistry fique contaminado. A ativação dessa propriedade pode retornar aplicativos que dependem de acesso ao mesmo stub JAX-RPC em vários encadeamentos.gotcha

com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine

Use essa propriedade para desativar o processamento automático dos aplicativos do JAX-RS por parte do tempo de execução de integração do JAX-RS. O valor padrão é false.
Evitar Problemas Evitar Problemas: Configurar esta propriedade para um valor de true também desativa a integração do tempo de execução do IBM JAX-RS com o EJB e JCDI.gotcha

com.ibm.websphere.logging.useJULThreadID

Use esta propriedade para controlar o tipo de ID de encadeamento usado nos arquivos de log do WebSphere Application Server.

Ao configurar esta propriedade para true, as instâncias LogRecord são usadas para recuperar o ID de encadeamento. Ao configurar esta propriedade para false, as instâncias Thread são usadas para recuperar o ID de encadeamento.

O valor padrão é false.

Para Usuários de Transição Para Usuários de Transição: Ao iniciar com a Versão 8.5, o valor padrão para a propriedade será false. Em versões anteriores, o valor padrão para a propriedade com.ibm.websphere.logging.useJULThreadID é true.trns

com.ibm.websphere.management.application.client.EnvEntry_processBindings

Use esta propriedade para especificar como um valor de entrada de ambiente é manipulado durante uma implementação do aplicativo.

Se esta propriedade tiver um valor igual a false, um valor de entrada de ambiente será lido a partir do descritor de implementação e gravado nele. Qualquer valor de entrada de ambiente especificado nas ligações XML é ignorado.

Se esta propriedade não for especificada ou tiver um valor de true, um valor de entrada de ambiente especificado nas ligações XML terá preferência sobre o valor especificado no descritor de implementação. As entradas de ambiente a partir das anotações são processadas. O valor padrão é true.

Se um aplicativo for implementado com com.ibm.websphere.management.application.client.EnvEntry_processBindings ativado e, em seguida, exportado para ser implementado em um ambiente de pré-Versão 8.0, o valor de entrada de ambiente nas ligações XML não será reconhecido pelos ambientes de implementação e de tempo de execução.

Se um aplicativo for implementado com com.ibm.websphere.management.application.client.EnvEntry_processBindings ativado e, em seguida, exportado para ser implementado em um ambiente da Versão 8.0 ou mais recente, o valor de entrada de ambiente nas ligações XML não será reconhecido pelo ambiente de implementação, mas será reconhecido pelo ambiente de tempo de execução.

Evitar Problemas Evitar Problemas: Não inclua a propriedade customizada com.ibm.websphere.management.application.client.EnvEntry_processAnnotations nas definições de configuração da JVM se a propriedade customizada com.ibm.websphere.management.application.client.EnvEntry_processBindings estiver configurada como true.gotcha
Evitar Problemas Evitar Problemas: Se seu ambiente contiver nós da pré-Versão 8.0 e um aplicativo for direcionado a um nó da pré-Versão 8.0, configure essa propriedade com um valor de false, se tiver uma entrada de ambiente definida no aplicativo e o valor de entrada de ambiente for fornecido ou mudado durante a implementação, incluindo instalação, edição ou atualização. Caso contrário, a implementação do aplicativo falhará.gotcha

com.ibm.websphere.management.application.fullupdate

Utilize essa propriedade para especificar que quando qualquer um de seus aplicativos for atualizado, você deseja que o diretório de binários seja apagado e o conteúdo do arquivo EAR atualizado seja extraído completamente.

Se essa propriedade não for especificada, cada arquivo alterado dentro de um arquivo EAR atualizado será individualmente atualizado e sincronizado no nó. Esse processo pode ser demorado para aplicativos grandes, se muitos arquivos mudarem.

Configurar a propriedade com.ibm.websphere.management.application.fullupdate como:
  • true especifica que quando qualquer um de seus aplicativos for atualizado, você deseja que o diretório de binários seja apagado e o conteúdo do arquivo EAR atualizado seja extraído completamente.
  • false especifica que quando qualquer um de seus aplicativos for atualizado, você deseja que os arquivos alterados dentro do arquivo EAR sejam atualizados no nó e, então, sincronizados.
Evitar Problemas Evitar Problemas:
  • Use a propriedade com.ibm.websphere.management.application.fullupdateapplication_name se deseja apenas fazer uma substituição completa para um aplicativo específico, em vez de todos os seus aplicativos.
  • É preciso definir esta propriedade no gerenciador de implementação JVM.
gotcha

com.ibm.websphere.management.application.fullupdate.application_name

Utilize essa propriedade para especificar que quando o aplicativo especificado for atualizado, você deseja que o diretório de binários desse aplicativo seja apagado e o conteúdo do arquivo EAR atualizado seja extraído completamente.

Se essa propriedade não for especificada, cada arquivo alterado dentro do arquivo EAR atualizado será individualmente atualizado e sincronizado no nó. Esse processo pode ser demorado para aplicativos grandes, se muitos arquivos mudarem.

Configurar a propriedade com.ibm.websphere.management.application.fullupdate.application_name como:
  • true especifica que quando qualquer o aplicativo especificado for atualizado, você deseja que o diretório de binários seja apagado e o conteúdo do arquivo EAR atualizado seja extraído completamente.
  • false que quando o aplicativo especificado for atualizado, você deseja apenas que os arquivos alterados sejam atualizados no nó e, então, sincronizados.
Evitar Problemas Evitar Problemas:
  • Use a propriedade com.ibm.websphere.management.application.fullupdate se você deseja que o diretório de binários seja apagado e o conteúdo do arquivo EAR atualizado extraído completamente sempre que qualquer um de seus aplicativos for atualizado.
  • É preciso definir esta propriedade no gerenciador de implementação JVM.
gotcha

com.ibm.websphere.management.application.keepExistingSharedLibraries

Use esta propriedade para especificar como os mapeamentos de bibliotecas compartilhadas são tratados durante as atualizações do aplicativo.

Quando essa propriedade estiver configurada como false, as bibliotecas compartilhadas especificadas durante a operação de atualização do aplicativo deverão substituir as configurações originais das bibliotecas compartilhadas. False é a configuração padrão.

Quando essa propriedade é configurada como true, após um aplicativo ser atualizado, as configurações de aplicativo e módulo incluem as configurações de biblioteca compartilhada original além daquelas especificadas durante a operação de atualização.

com.ibm.websphere.management.application.persistWebContext

Use esta propriedade para especificar se as informações da raiz de contexto e do host virtual para módulos da Web persistem no arquivo deployment.xml. Se essa propriedade não for especificada, a implementação do aplicativo terá que contar com o processamento de anotação para ler a raiz de contexto e informações do host virtual, o que afeta o desempenho da implementação do aplicativo.

Quando esta propriedade estiver configurada como true, as informações de raiz de contexto e do host virtual para módulos da web serão persistidas no arquivo deployment.xml, os dados persistidos serão usados para a validação de implementação do aplicativo, o que melhorará o desempenho da implementação do aplicativo.

O valor padrão é false, o que significa que a raiz do contexto e as informações do host virtual para módulos da web não persistem no arquivo deployment.xml.

com.ibm.websphere.management.application.sync.recycleappasv5

Use esta propriedade para especificar que você quer que o comportamento de reciclagem do seu aplicativo trabalhe da mesma maneira que trabalhou em versões anteriores à Versão 6.x do produto.

Na Versão 6.x e superior, depois que uma atualização de aplicativo ou operação de edição ocorrer, dependendo de quais arquivos forem modificados, o aplicativo ou seus módulos serão automaticamente reciclados. Esse processo de reciclagem ocorrerá para todas as alterações no arquivo de configuração do aplicativo e em todas as alterações do arquivo não estático.

No entanto, em versões anteriores à Versão 6.x do produto, um aplicativo só é reciclado se o arquivo Enterprise Archive (EAR) em si é atualizado ou se o atributo URL dos binários muda. Um aplicativo não será reciclado se houver uma alteração no arquivo de configuração do aplicativo.

Configurar a propriedade com.ibm.websphere.management.application.sync.recycleappasv5 para:
  • true especifica que você quer que o comportamento de reciclagem do seu aplicativo trabalhe da mesma maneira que trabalhou em versões anteriores à Versão 6.x do produto.
  • false especifica que você deseja que o comportamento de reciclagem do aplicativo funcione de acordo com o esquema de comportamento da Versão 6.x e superior.

O valor padrão é false.

Evitar Problemas Evitar Problemas: Você deve definir esta propriedade na JVM do agente do nó. No entanto, quando definir essa propriedade, é possível especificar um escopo de célula, se você desejar que a configuração se aplique a todos os nós em uma célula específica. Se esta propriedade for configurada no nível do agente da célula e do nó, a configuração do agente do nó terá precedência para esse agente do nó específico.gotcha

com.ibm.websphere.management.application.updateClusterTask.serverStopWaitTimeout

Use esta propriedade para especificar, em segundos, quanto tempo o gerenciador de implementação aguarda para que um servidor seja parado completamente na tarefa $AdminTask updateAppOnCluster. Por padrão, o gerenciador de implementação aguarda 60 segundos. A quantidade de tempo especificada para esta propriedade deve ser maior do que a quantidade máxima de tempo que leva para parar um servidor no cluster.

Essa propriedade só pode ser especificada se você estiver utilizando a Versão 7.0.0.1 ou posterior.

Evitar Problemas Evitar Problemas: Essa propriedade será válida apenas se for especificada para um gerenciador de implementação.gotcha

com.ibm.websphere.management.application.updatesync.appExpansionTimeout

Use a propriedade para especificar quanto tempo o gerenciador de implementação aguarda para iniciar um servidor de aplicativos seguindo uma atualização do aplicativo. Esse tempo de espera permite que os binários para o aplicativo sejam expandidos para seus diretórios depois que o processo de atualização é concluído. A quantidade de tempo especificada para esta propriedade deve ser a quantidade máxima de tempo que qualquer um dos aplicativos que residem em um nó levam para expandir totalmente seus binários.

Por padrão, a função de atualização da implementação aguarda por 60 segundos, para que cada expansão do aplicativo ocorra seguindo uma atualização para um ou mais aplicativos. Como a função de implementação pode ser usada para atualizar vários aplicativos ao mesmo tempo, o valor padrão para esta propriedade é n x 60 segundos, em que n é o número de aplicativos que estão sendo atualizados.

O tempo de espera padrão pode não ser suficiente para aplicativos maiores. Se após a atualização de seus aplicativos, um ou mais desses aplicativos não puderem iniciar quando o servidor for iniciado, pode ser necessário especificar um período de tempo maior de espera para a função de atualização de lançamento antes de iniciar o servidor.

Evitar Problemas Evitar Problemas: Essa propriedade será válida apenas se for especificada para um gerenciador de implementação.gotcha

com.ibm.websphere.management.configservice.getServerLogRootFromTemplate

Use essa propriedade para especificar se o valor especificado para a variável SERVER_ROOT definida em um modelo de servidor, ou o valor de {LOG_ROOT}/serverName deve ser usado ao criar um servidor de aplicativos ou membro de cluster.

Ao criar um servidor de aplicativos ou membro de cluster, o valor de {LOG_ROOT}/serverName é sempre usado no lugar do valor da variável SERVER_ROOT definida em um modelo de servidor existente. Se, ao criar um servidor de aplicativos ou membro de cluster, você desejar usar o valor da variável SERVER_ROOT definida em um modelo de servidor, configure essa propriedade como true.

Se usar esta propriedade customizada, ela deverá ser configurada para o gerenciador de implementação.

Ao usar wsadmin no modo conectado, use o comando AdminTask.setJVMSystemProperties para configurar esta propriedade no nível do gerenciador de implementação.

Ao usar wsadmin no modo LOCAL (conntype=none), esta propriedade pode ser transmitida como uma javaoption:
wsadmin -conntype none -javaoption
"-Dcom.ibm.websphere.management.configservice.getServerLogRootFromTemplate=true"

com.ibm.websphere.management.configservice.sessionIdUniqueness

Use esta propriedade para evitar geração de ID da sessão de configuração ou da área de trabalho duplicada. Se diferentes processos criarem IDs de sessão de configuração ou de área de trabalho gerados aleatoriamente dentro do mesmo milissegundo, será possível que os IDs sejam idênticos.

Para evitar sessão de configuração ou geração de ID da área de trabalho duplicada, inclua esta propriedade em suas configurações do servidor de aplicativos e configure-a como true.

É possível usar o comando wsadmin AdminTask.setJVMSystemProperties ou o console administrativo para especificar esta propriedade customizada.

Se o servidor de aplicativos fizer parte de uma célula federada, depois que salvar suas mudanças, você deverá sincronizar o nó e reiniciar cada servidor para que essa mudança na configuração entre em vigor.

Se você decidir usar essa propriedade customizada, será possível especificá-la como uma propriedade customizada JVM de um gerenciador de implementação ou de um servidor de aplicativos.

com.ibm.websphere.management.configservice.validatePropNames

Use esta propriedade para especificar se você deve forçar restrições de caracteres para nomes de propriedades customizadas e para o valor nome dos objetos de configuração Property e J2EEResourceProperty em comandos wsadmin.

É possível usar um dos seguintes métodos para desativar a validação de caractere para nomes de propriedades customizadas e para o valor nome dos objetos de configuração Property e J2EEResourceProperty em comandos wsadmin.
  • Configure a propriedade do sistema Java com.ibm.websphere.management.configservice.validatePropNames como false na Java Virtual Machine (JVM) para o servidor do gerenciador de implementação.
  • Configure a propriedade com.ibm.websphere.management.configservice.validatePropNames utilizando o parâmetro -javaoption quando usar o conjunto de ferramentas wsadmin no modo local.
    wsadmin -conntype none -javaoption 
    "-Dcom.ibm.websphere.management.configservice.validatePropNames=false"
[z/OS]

com.ibm.websphere.management.jmx.random

Use essa propriedade para ativar o controlador para selecionar aleatoriamente um servidor inicial do conjunto de servidores para processar pedidos de um conector Java Management Extensions (JMX) ao invés de designar automaticamente o pedido para o servidor ativo.

Por padrão, quando vários servidores forem ativados, e o servidor de aplicativos receber um pedido de conexão JMX, o servidor de aplicativos atribuirá o pedido para o primeiro servidor, que também é referido como o servidor automático. Esta estratégia minimiza o risco de que o pedido seja atribuído a um servidor que é paginado. Entretanto, se o primeiro servidor tiver uma carga de trabalho pesada, os pedidos para esse servidor, eventualmente, falharão. Portanto, a vantagem de usar um algoritmo aleatório é que o servidor designado provavelmente ainda não está manipulando muitas outras solicitações. A desvantagem de utilizar o algoritmo aleatório é que o servidor selecionado pode ser paginado e ter que ser paginado novamente antes de poder tratar o pedido.

Configurar a propriedade para com.ibm.websphere.management.jmx.random:
  • true especifica que o controlador selecionará aleatoriamente um servidor inicial do conjunto de servidores para processar pedidos de um conector JMX.
  • false especifica que o controlador atribuirá todos os pedidos de conector JMX para o servidor automático.

Se você decidir usar essa propriedade customizada, deverá especificá-la como uma propriedade customizada JVM para o controlador.

com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool

Use essa propriedade para controlar o número de encadeamentos que podem ser incluídos em um conjunto de encadeamentos recém-criado. Um encadeamento dedicado é criado para iniciar cada servidor de aplicativos do Java Virtual Machine (JVM). As JVMs com encadeamentos dedicados nesse conjunto de encadeamentos são as JVMs iniciadas em paralelo sempre que o agente do nó é iniciado.

É possível especificar um número inteiro de 0 a 5 como o valor para essa propriedade. Se o valor especificado for maior que 0, um conjunto de encadeamentos será criado com esse valor como o número máximo de encadeamentos que podem ser incluídos neste conjunto de encadeamentos recém-criado. A tabela a seguir lista os valores suportados para esta propriedade customizada e seus efeitos.

Tabela 1. Valores suportados para com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool. A tabela inclui o valor da propriedade customizada e o efeito da propriedade customizada.
com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool Efeito
A propriedade com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool está configurada como 0 ou não especificada. O nó do agente inicia até cinco JVMs em paralelo.
A propriedade com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool está configurada como 1. O nó do agente inicia os JVMs em série.
A propriedade com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool está configurada como um valor de número inteiro entre 2 e 5. O nó do agente inicia um número de JVMs igual ao valor especificado em paralelo.

Por exemplo, suponha que o agente do nó possui dez JVMs que estão configuradas como o estado em execução, o que significa que elas são iniciadas sempre que o agente do nó inicia. Se você especificar 3 para esta propriedade, sempre que parar e iniciar o agente do nó, somente três das dez JVMs serão iniciadas em paralelo quando o agente do nó iniciar.

Evitar Problemas Evitar Problemas:
  • Se estiver usando o console administrativo e especificar com.ibm.websphere.management.nodeagent.bootstrap.maxthreadpool como o nome de uma nova propriedade customizada de JVM para o agente do nó, deve-se especificar um valor no campo Valor para essa nova propriedade customizada. Uma mensagem de erro será recebida se você não especificar um valor.
  • Se transmitir um valor em branco para a propriedade a partir da linha de comandos, o valor em branco será considerado um valor ilegal e o comportamento padrão do agente do nó será restaurado.
gotcha

Esta propriedade não é especificada por padrão. Se decidir usar esta propriedade customizada, você deverá especificá-la como uma propriedade customizada da JVM do agente do nó.

com.ibm.websphere.management.nodesync.skipWebServerTarget

Use essa propriedade para controlar se os binários de aplicativos são distribuídos para nós de destino em que o aplicativo destina apenas servidores da Web.

Por padrão, o valor da propriedade customizada é configurado como false, o que faz o servidor de aplicativos distribuir binários do aplicativo para nós de destino. Se você configurar essa propriedade customizada como true, o servidor de aplicativos não distribuirá binários do aplicativo para nós de destino que contêm apenas destinos de servidor da Web.

Importante: O comportamento do sistema não é afetado por esse valor da propriedade customizada. Além disso, ele não é afetado pela mudança de sincronização de nós que levou a uma mudança nesse valor da propriedade customizada para nós de destinos que contêm destinos do servidor de aplicativos. Essas instruções são verdadeiras, independentemente se os destinos dos servidores da Web estão incluídos nesse mesmo nó.
O exemplo de saída a seguir mostra a saída isAppReady, que é gerada para nós de destino apenas do servidor da Web quando você configura essa propriedade customizada como true:
wsadmin>$AdminApp isAppReady SuperApp 
ADMA5071I: Verificação do status de distribuição iniciada para o aplicativo SuperApp. 
WebSphere:cell=IBMCell10,node=IBMNode30,distribution=true,expansion=skipped 
ADMA5011I: A limpeza do diretório temporário para o aplicativo SuperApp está concluída. 
ADMA5072I: Verificação do status de distribuição concluída para o aplicativo SuperApp. 
true
É possível configurar essa propriedade customizada para o gerenciador de implementação, mas não para o servidor de aplicativos ou o agente do nó. É possível usar o console administrativo ou concluir as seguintes etapas usando uma linha de comandos:
  1. Inicie as ferramentas de script wsadmin a partir do diretório profile_root/bin. É necessário iniciar o comando .wsadmin.bat ou wsadmin.sh dentro desse diretório.
  2. Execute um dos seguintes comandos:
    Usando Jacl
    $AdminTask setJVMSystemProperties {-serverName server_name -nodeName node_name -propertyName com.ibm.websphere.management.nodesync.skipWebServerTarget -propertyValue true}
    Usando a cadeia Jython
    AdminTask.setJVMSystemProperties('[-serverName server_name -nodeName node_name -propertyName com.ibm.websphere.management.nodesync.skipWebServerTarget -propertyValue true]')
    Usando a lista Jython
    AdminTask.setJVMSystemProperties (['-serverName', 'server_name', '-nodeName', 'node_name' '-propertyName', 'com.ibm.websphere.management.nodesync.skipWebServerTarget', '-propertyValue', 'true'])

    em que as variáveis server_name e node_name são específicas para o seu ambiente.

  3. Reinicie o gerenciador de implementação.

com.ibm.websphere.management.processEmbeddedConfigGlobal

Use esta propriedade para ativar ou desativar globalmente o processamento da configuração integrada dos arquivos Enterprise Archive (EAR) do aplicativo aprimorado durante a implementação. Um arquivo EAR aprimorado é resultado quando você exporta um aplicativo instalado.

Esta propriedade customizada substitui globalmente a configuração padrão para a opção Processar Configuração Integrada (-processEmbededConfig). Por padrão, a Processar Configuração Integrada é configurada como true (selecionada) para arquivos EAR aprimorados e como false (seleção cancelada) para todos os outros arquivos EAR. A configuração Processar Configuração Integrada determina o diretório no qual o produto expande um arquivo EAR aprimorado durante a implementação desse arquivo. Se você exportou um aplicativo a partir de uma célula diferente da atual e não especificou a variável $(CELL) para Diretório para Instalar o Aplicativo quando instalou o aplicativo pela primeira vez, a configuração de Processar Configuração Integrada como false durante a implementação de um arquivo EAR aprimorado extrai o arquivo EAR aprimorado no diretório app_server_root/profiles/installedApps/current_cell_name. Caso contrário, se Processar Configuração Integrada estiver configurada como true, o arquivo EAR aprimorado será expandido no diretório app_server_root/profiles/installedApps/original_cell_name, em que original_cell_name é a célula na qual o aplicativo foi instalado pela primeira vez. Se você especificou a variável $(CELL) para Diretório de Instalação do Aplicativo quando o aplicativo for instalado pela primeira vez, a instalação expandirá o arquivo EAR aprimorado no diretório app_server_root/profiles/installedApps/current_cell_name.

Quando esta propriedade customizada processEmbeddedConfigGlobal estiver configurada como false, o produto não processará a configuração integrada de nenhum aplicativo, inclusive os arquivos EAR aprimorados, durante a implementação. Após configurar processEmbeddedConfigGlobal como false, o produto não processará a configuração integrada dos arquivos EAR aprimorados. No entanto, ao implementar um arquivo EAR aprimorado individual, será possível substituir essa configuração false configurando explicitamente Processar Configuração Integrada como true.

Quando esta propriedade customizada processEmbeddedConfigGlobal estiver configurada como true, o produto processará a configuração integrada dos arquivos EAR aprimorados.

Independentemente de se esta propriedade customizada processEmbeddedConfigGlobal estiver configurada como true ou false, o produto implementará os aplicativos que não têm configurações integradas como usuais. A configuração não tem nenhum efeito sobre a implementação.

Evitar Problemas Evitar Problemas: Se decidir usar esta propriedade customizada, você deverá especificar esta propriedade e seu valor como uma propriedade customizada da JVM para o Controle e Servidor ou incluir esta propriedade no arquivo wsadmin.properties.gotcha
Evitar Problemas Evitar Problemas: Se decidir usar esta propriedade customizada, você deverá especificar esta propriedade como uma propriedade customizada da JVM para o gerenciador de implementação ou incluir esta propriedade no arquivo wsadmin.properties.gotcha
[z/OS]

com.ibm.websphere.management.registerServerIORWithLSD

Utilize essa propriedade para controlar se um servidor federado se registrará com o LSD (Daemon do Serviço de Localização). Normalmente, um servidor federado requer que o agente do nó esteja em execução. Para direcionar o servidor para não se registrar com o LSD e remover sua dependência em um agente do nó ativo, a propriedade customizada da JVM, com.ibm.websphere.management.registerServerIORWithLSD, deve ser configurada como false e o ORB_LISTENER_ADDRESS deve ser configurado como um valor maior que 0, para que o ORB seja recebido em uma porta fixa. A configuração dessa propriedade é ignorada se a propriedade ORB_LISTENER_ADDRESS for configurada para 0 (zero) ou não for especificada e o servidor federado registrar o LSD.

Configure essa propriedade para false se quiser que o servidor seja executado quando o agente do nó não estiver em execução. Quando essa propriedade for configurada para true, o servidor federado registra-se com o LSD. O valor padrão é true.

Evitar Problemas Evitar Problemas: Essa propriedade já existe na lista de propriedades customizadas do Serviço ORB. Para alterar a configuração dessa propriedade customizada, no console administrativo, clique em Servidores> Servidores de Aplicativos > server_name > gerenciamento de sessões > Serviços do Contêiner > Serviço do ORB > Propriedades Customizadas > com.ibm.websphere.management.registerServerIORWithLSDgotcha

Depois de alterar o valor dessa propriedade customizada, você deve executar uma sincronização completa antes que essa mudança seja refletida no arquivo server.xml do nó. Se não foi possível iniciar o agente do nó para o servidor, você deverá editar manualmente o arquivo server.xml para alterar o valor dessa propriedade customizada de true para false.

Quando você configura a propriedade com.ibm.websphere.management.registerServerIORWithLSD como false, o servidor não notifica o agente do nó quando ele atribui de modo dinâmico a porta ORB_LISTENER_ADDRESS. Também não haverá nenhuma IOR (Interoperable Object Reference) que o agente do nó poderá determinar para um servidor. Todas as IORs se tornam diretas, o que significa que o agente do nó só pode contactar esse servidor se um ORB_LISTENER_ADDRESS estático tiver sido atribuído a esse servidor.

Evitar Problemas Evitar Problemas: Se você configurar a propriedade com.ibm.websphere.management.registerServerIORWithLSD como false e não pretender usar o serviço do gerenciador de alta disponibilidade (HAManager) e o processo do agente do nó, então deverá criar uma tabela de roteamento estático para ativar o roteamento estático. A ativação do roteamento estático assegura que o WLM (Gerenciamento de Carga de Trabalho) continue a funcionar corretamente. Você usa com.ibm.websphere.management.registerServerIORWithLSD para impedir que IORs indiretos sejam retornados para os serviços que estão sendo fornecidos pelos servidores de aplicativos (e fazer com que o agente do nó mapeie esses IORs indiretos para IORs diretos).
O uso do agente do nó estabelece uma porta conhecida no lado do servidor, para a qual o cliente pode enviar solicitações quando as portas dos servidores de aplicativos não forem conhecidas. A criação de uma tabela de roteamento estático e a ativação do roteamento estático fornece portas estáticas aos servidores de aplicativos e torna essas portas disponíveis para uso. Com as portas estáticas, o processamento do agente do nó não é necessário.
Nota: Com as portas do servidor de aplicativos dinâmicas, não é possível usar a tabela de roteamento estático. O processamento do agente do nó é necessário com as portas do servidor de aplicativos dinâmicas, porque o cliente precisa obter informações da nova porta quando os servidores são reiniciados.

A configuração da propriedade com.ibm.websphere.management.registerServerIORWithLSD não afeta o uso de portas dinâmicas ou estáticas ou o roteamento de pedidos pelo WLM. No entanto, você perde um nível potencial de failover fornecido pelos agentes dos nós do HAManager.

O processamento do WLM é retido com a distribuição ponderada de pedidos.

gotcha

com.ibm.websphere.management.soapSocketConnectionTimeout

Use essa propriedade para especificar, em segundos, quanto tempo um soquete de conector JMX SOAP deve permanecer aberto. Se você não especificar um valor para essa propriedade, a conexão do soquete do conector JMX SOAP fica aberta indefinidamente.

com.ibm.websphere.management.useUpdatedPropertyFiles

Use esta propriedade para criar novas sessões de email usando o modelo de arquivo de propriedades atualizadas.

Configure essa propriedade para true para usar o modelo atualizado da configuração do arquivo de propriedades para criar novas sessões de correio. O modelo atualizado da configuração do arquivo de propriedades será usado, ao invés do modelo de configuração do arquivo de propriedades original.

Boas Práticas Boas Práticas: Você deve ativar o com.ibm.websphere.management.useUpdatedPropertyFiles a menos que tenha usado o modelo do arquivo de propriedades original para extrair os objetos de configuração WebSphere Application Server para os arquivos de propriedade.bprac

Depois de configurar a propriedade do sistema, salve as mudanças. Se o servidor de aplicativos fizer parte de uma célula federada, sincronize o nó para propagar as mudanças. Reinicie cada servidor para as mudanças entrarem em vigor.

Esta propriedade não é ativada por padrão.

com.ibm.websphere.metadata.ignoreDuplicateRefBindingsInWebModules

Use essa propriedade para controlar se a JVM ignora instâncias de ligações de referência duplicadas no arquivo DTD para um módulo da Web em um aplicativo Java 2 Platform, Enterprise Edition (J2EE) versão 1.3. Geralmente, ocorrerá uma MetaDataException se um arquivo DTD para um módulo da Web em um aplicativo Java 2 Platform, Enterprise Edition (J2EE) versão 1.3 contiver referências duplicadas.

Os padrões para o arquivo DTD de um módulo da web especificamente indicam que as ligações de referência devem ter campos de nome exclusivo. Portanto, um aplicativo que contém um módulo da Web que inclui ligações de referência duplicadas é, tecnicamente, um aplicativo não compatível.

Embora os padrões para o arquivo DTD de um módulo da Web proíbam um usuário de definir ligações de referência duplicadas, as JVMs em versões do produto anteriores à 7.0 toleram ligações de referência duplicadas. Se você tiver arquivos DTD para módulos da Web em aplicativos Java 2 Platform, Enterprise Edition (J2EE) versão 1.3 que contenham ligações de referência duplicadas, será possível remover a referência duplicada ou incluir essa propriedade em suas definições de configuração JVM, e definir a propriedade como true.

com.ibm.websphere.network.useMultiHome

[AIX Solaris HP-UX Linux Windows][IBM i]Utilize essa propriedade em um ambiente multihome para indicar em qual endereço IP o servidor de aplicativos atende. Em um ambiente multihome, normalmente há um endereço IP específico em que o servidor de aplicativos deve atender as mensagens do Discovery e do SOAP. Configurar a propriedade com.ibm.websphere.network.useMultiHome para:
  • true especifica que o produto atende em todos os endereços IP no host para mensagens do Discovery e do SOAP.
  • false especifica que o produto atende apenas no nome do host configurado para mensagens do Discovery e do SOAP. Se você configurar essa propriedade como false, deverá ter um nome do host configurado no produto que seja resolvido para um endereço IP específico.
  • null especifica que o produto atende apenas no endereço IP padrão.
[z/OS]Em um ambiente multihome no qual o produto deve atender apenas em um endereço IP específico para mensagens do Discovery e do SOAP, configure essa propriedade para false para o gerenciador de implementação, todos os servidores de aplicativos e todos os agentes do nó. Por padrão, o valor da propriedade é verdadeiro e o servidor de aplicativos atende em todos os endereços IP do host para mensagens Discovery e SOAP. Se a propriedade for configurada para false, o produto atenderá apenas para mensagens do Discovery e do SOAP no nome do host configurado. Se você definir a propriedade como false, também deverá:
  • Ter um nome do host configurado no produto que resolva para um endereço IP específico.
  • Assegurar-se de que a propriedade end point para o gerenciador de implementação, todos os servidores de aplicativos e todos os agentes do nó seja configurada para esse nome do host. Para o gerenciador de implementação, os nós de extremidade que devem ser definidos são CELL_DISCOVERY_ADDRESS e SOAP_CONNECTOR_ADDRESS. Para o agente do nó e os servidores de aplicativos, apenas o nó de extremidade SOAP_CONNECTOR_ADDRESS deve ser definido.
É possível alterar o valor através do console administrativo. Modifique os padrões definindo o valor para o servidor, gerenciador de implementação e agente de nós. Para que essas alterações entrem em vigor, você deve iniciar novamente o servidor.

Se não conseguir entrar em contato com o servidor, verifique a configuração de com.ibm.websphere.network.useMultihome para assegurar que esteja correta. É possível alterar o valor através do console administrativo. Modifique os padrões definindo o valor para o servidor, gerenciador de implementação e agente de nós. Você deve reiniciar o servidor para que essas alterações tenham efeito.

com.ibm.websphere.perf.tuning.disableRPARepositoryCache

Use esta propriedade para evitar o armazenamento em cache de detalhes da configuração do servidor quando o RPA está desativado.

RPA usa um cache de repositório para armazenar os detalhes de configuração do servidor. Este cache é inicializado e os detalhes de configuração são armazenados mesmo se o RPA e o PMI estão desativados. O cache de repositório pode se tornar muito grande para instalações extremamente grandes, tal como uma instalação que possui mais de 3000 origens de dados. Se você encontrar problemas de desempenho devido ao tamanho deste cache de repositório, e o RPA estiver desativado, inclua esta propriedade em suas definições de configuração da JVM e configure-a como true. Você não deverá usar esta propriedade customizada se o RPA estiver ativado ou se você não estiver encontrando problemas de desempenho devido ao tamanho deste cache de repositório.

Evitar Problemas Evitar Problemas: Você não deverá usar esta propriedade customizada se o RPA estiver ativado ou se você não estiver encontrando problemas de desempenho devido ao tamanho deste cache de repositório.gotcha

O valor-padrão para esta propriedade é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.resource.xmlConfigMaxLineLength

Use esta propriedade para especificar a duração da máxima da linha preferencial para documentos de configuração XML.

Linhas no início de um arquivo server.xml sempre excedem o comprimento de 2048 caracteres. Linhas que ultrapassam o comprimento de 2048 caracteres não podem ser processados por ferramentas de edição de texto em alguns sistemas operacionais, como z/OS. Portanto, ao editar e salvar um arquivo que incluem linhas ultrapassando os 2048 caracteres, as linhas longas serão truncada. Este truncamento torna inutilizável o arquivo de configuração, causando falha na inicialização do servidor.

Se você especificar um valor para esta propriedade, ao editar e salvar um documento de configuração XML, as quebras de linhas irão ocorrer assim que possível, depois que o número de caracteres na linha atingir o número máximo especificado de caracteres permitidos. As quebras de linhas ainda ocorrerão em pontos de quebras lógicas, que é o motivo pelo qual os comprimentos das linhas ainda poderão ultrapassar o máximo especificado. Portanto, o valor especificado para essa propriedade deve considerar o número de caracteres que podem exceder o máximo especificado para assegurar que nenhuma das linhas no documento exceda 2048 caracteres.

Se você não especificar um valor para esta propriedade, as linhas poderão aumentar para qualquer comprimento.

Um valor aceitável para esta propriedade é um número inteiro no intervalo de 80 a 2046, inclusivo.

Não existe valor padrão para esta propriedade.

Se você decidir usar essa propriedade customizada, deverá especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.sib.webservices.useTypeSoapArray

É possível transmitir mensagens diretamente para um destino do barramento substituindo o namespace de ligação do cliente JAX-RPC e o endereço do terminal. Entretanto:
  • A mensagem padrão da matriz de sequência dos serviços da web codificados para RPC que é gerada não pode interoperar com êxito com alguns provedores do serviço de destino.
  • A mensagem da matriz de cadeias produzida não é exatamente a mesma do JAX-RPC padrão equivalente, que pode interoperar com êxito.
Aqui encontram-se os exemplos de duas mensagens diferentes:
  • Mensagem de barramento de integração de serviços:
    <partname env:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/ xsi:type='ns1:ArrayOf_xsd_string'>
      <item xsi:type='xsd:anySimpleType'>namevalue</item>
    </partname>
  • Mensagem do cliente JAX-RPC:
    <partname xsi:type="soapenc:Array" soapenc:arrayType="xsd:string[1]">
      <item>namevalue</item>
    </partname>

Configure esta propriedade como true para modificar o comportamento padrão e enviar uma mensagem da matriz de cadeias que seja totalmente compatível com o JAX-RPC padrão. A configuração dessa propriedade modifica o comportamento padrão para todas as chamadas de serviços da web JMS de saída enviadas a partir do barramento de integração de serviços.

com.ibm.websphere.webservices.attachment.tempfile.expiration

Use essa propriedade para indicar, em segundos, um prazo de expiração para um anexo em um cliente ou serviço JAX-WS ou Service Component Architecture (SCA). Se um anexo não for acessado para um período de tempo maior que o prazo de expiração, o tempo de execução do serviço da Web será permitido para excluir o anexo.

O modelo de programação JAX-RPC permite acesso a anexos de mensagens de serviço da web recebidas. O anexo pode ser acessado imediatamente, ou pode ser armazenado para processamento posterior. Portanto, a memória que está associada ao anexo pode persistir por muito mais tempo que o tempo de vida da interação do serviço da web, porque não há nenhum período de tempo preciso após o qual o tempo de execução de serviço da web possa liberar o anexo com segurança.

Para anexos pequenos, a memória é eventualmente liberada pelo coletor de lixo Java.

Para anexos grandes, o tempo de execução do JAX-RPC armazena os dados do anexo em um arquivo temporário, permitindo assim que o tempo de execução processe anexos extremamente grandes sem consumir memória. Se o aplicativo não acessar o anexo ou se o aplicativo não fechar de forma adequada o manipulador de dados associado ao anexo, o arquivo de memória grande não será liberado. Com o passar do tempo, esses arquivos de anexos temporários poderão acumular no sistema de arquivos se nenhum prazo de expiração for especificado para esses arquivos.

Boas Práticas Boas Práticas: Uma configuração igual a 600 será recomendada se você precisar de um prazo de expiração para esses anexos. A configuração padrão para essa propriedade customizada é 0 segundos, o que indica que não há prazo de expiração para esses anexos.bprac

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.webservices.attachements.maxMemCacheSize

Use essa propriedade para especificar, em kilobytes, o tamanho máximo do anexo no serviço ou cliente JAX-RPC que pode ser gravado na memória. Por exemplo, se o seu serviço da Web precisar enviar anexos de 20 MB, configure a propriedade como 20480.

Ao determinar um valor para essa propriedade, lembre-se de que quanto maior o tamanho máximo do cache, mais impacto existe no desempenho e, potencialmente, para o heap Java.

Se você não especificar um valor para essa propriedade, a memória máxima usada para anexos de cache será de 32 KB, que é o valor padrão para essa propriedade.

Configurações suportadas Configurações suportadas: Para especificar o tamanho máximo de um anexo no serviço ou cliente JAX-WS, consulte a propriedade customizada com.ibm.ws.websvcs.attachments.sizethreshold.sptcfg

Se decidir usar esta propriedade customizada, você deverá especificá-la como uma propriedade customizada de JVM de servidor de aplicativos.

com.ibm.websphere.webservices.DisableIBMJAXWSEngine

Use essa propriedade para desativar a varredura de anotações de serviços da web no nível do servidor. Por padrão, a varredura de anotações de serviços da web está ativada no nível do servidor.

Para desligar a varredura de anotação no nível do aplicativo, configure a propriedade DisableIBMJAXWSEngine no META-INF/MANIFEST.MF de um arquivo WAR ou módulo EJB module como verdade.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.webservices.http.OneWayConnectionRecycleTime

Use essa propriedade para especificar, em segundos, quanto tempo o mecanismo de serviços da web deve aguardar antes de reutilizar uma conexão unidirecional. Quando uma conexão unidirecional é reutilizada muito rapidamente, uma operação do serviço da Web pode falhar no cliente devido a um problema de tempo limite, como SocketTimeoutException.

Quando um valor é especificado para essa propriedade, as conexões unidirecionais não são reconfiguradas até que o número de segundos especificado se expire, a partir do momento do envio da solicitação.

Por padrão, essa propriedade não é configurada e as conexões unidirecionais são reconfiguradas imediatamente após o envio da solicitação.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.webservices.http.waitingThreadsThreshold

Use esta propriedade para especificar quantos pedidos de conexão em espera são tolerados antes da liberação de conexões temporárias. Uma conexão flexível ocorre quando um mecanismo cliente mantém objetos de conexão para alguns hosts após a conexão estar fechada. Por padrão, depois que cinco encadeamentos estiverem aguardando as conexões, o mecanismo do cliente liberará as conexões temporárias.

Nota: Se todas as conexões estiverem sendo usadas, a propriedade customizada não sofrerá um impacto. Nesta situação, é possível aumentar o limite máximo de conexão, o número máximo de encadeamentos ou ambos.

O valor padrão para essa propriedade customizada é 5.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.webservices.jaxrpc.client.publishwsdl

Especificar se um arquivo WSDL é publicado para um módulo da Web do cliente. Quando essa propriedade estiver configurada como true, se um aplicativo contiver um módulo da Web do cliente, um arquivo WSDL poderá ser publicado para esse cliente. Se você não desejar arquivos WSDL publicados para seus aplicativos cliente, configure essa propriedade como false.

O valor padrão é true.

Evitar Problemas Evitar Problemas:
  • A publicação do arquivo WSDL não está disponível para aplicativos JAX-RPC que contêm apenas um cliente.
  • Essa propriedade não pode ser utilizada para aplicativos JAX-WS.
gotcha

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.management.connector.http.header.includeProductVersion

Configure isso para um valor true para incluir as informações da versão do servidor no cabeçalho de resposta HTTP da porta SOAP. O padrão é false.

com.ibm.websphere.webservices.jaxws.setLinkValuePrecedence

Use esta propriedade para especificar a precedência de valores vinculados no ambiente de tempo de execução JAX-WS.

Quando esta propriedade for configurada para true, os valores de vinculados do descritor de implementação têm precedência sobre os valores vinculados da anotação.

O valor padrão é false.

com.ibm.websphere.webservices.soap.enable.legacy.get.behavior

Iniciando em WebSphere Application Server Versão 8, os métodos SOAPMessage.getSOAPHeader e getSOAPBody emite um SOAPException, se não houver elemento correspondente na mensagem. Uma propriedade de sistema, com.ibm.websphere.webservices.soap.IBMSOAPMessage.ENABLE_LEGACY_GETSOAP_BEHAVIOR, é fornecida para reverter o comportamento para retornar nulo em vez de emitir uma exceção. Esta propriedade de sistema é configurada usando uma propriedade customizada JVM, com.ibm.websphere.webservices.soap.enable.legacy.get.behavior. O valor padrão para essa propriedade customizada da JVM é false. Configurar essa propriedade JVM como true reverte para o comportamento anterior, que é retornar um nulo para os métodos SOAPMessage.getSOAPHeader e getSOAPBody quando não há nenhuma mensagem correspondente.
Nota: O comportamento anterior de retornar um nulo não é compatível com a especificação.

com.ibm.websphere.webservices.tempAttachDir

Use essa propriedade para especificar o local em um dispositivo de armazenamento em que você deseja que o tempo de execução de serviços da web armazene em cache uma cópia de qualquer anexos, que tenha mais de 32 KB de tamanho, que esteja sendo enviada ou recebida como parte de uma mensagem SOAP.

Por motivos de desempenho, o tempo de execução de serviços da web armazena em cache uma cópia temporária de qualquer anexo de mensagem SOAP com mais de 32 KB de tamanho. Se você não especificar um valor para essa propriedade, a cópia em cache do anexo é normalmente enviada para o diretório temporário padrão para seu sistema operacional.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.webservices.transport.jms.messageType

Use essa propriedade para controlar o tipo de mensagem JMS usada pelo mecanismo de serviços da web para componentes SOAP sobre JMS ao enviar mensagens de solicitação e resposta. Para especificar um objeto JMS BytesMessage (javax.jms.BytesMessage), configure a propriedade como BYTES para indicar que o corpo da mensagem são dados binários. Para especificar um objeto JMS TextMessage (javax.jms.TextMessage), configure a propriedade como TEXT para indicar que o corpo da mensagem são dados da sequência.

O valor padrão para essa propriedade é BYTES.

Para saber mais sobre os tipos de mensagem SOAP sobre JMS, consulte as informações de Configurando Tipos de Mensagem SOAP sobre JMS.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.webservices.transport.OPTIMIZE_HTTP_HEADERS

Nas versões anteriores à Versão 8, um aplicativo cliente do JAX-WS para WebSphere Application Server pode enviar um cabeçalho HTTP SAVE_CONNECTION em uma mensagem SOAP. Esse cabeçalho adicional garante que ocorra processamento adequado pelo servidor de aplicativos que está hospedando o serviço da Web JAX-WS. No entanto, este cabeçalho SAVE_CONNECTION e o processamento adicional não serão necessários se o servidor de aplicativos para o cliente e o host do servidor de aplicativos para o serviço da Web estiverem, ambos, usando o WebSphere Application Server Versão 7.0 Fix Pack 3 ou posterior.

É possível configurar a propriedade customizada com.ibm.websphere.webservices.transport.OPTIMIZE_HTTP_HEADERS como false para ativar o cabeçalho SAVE_CONNECTION para assegurar o processamento adequado por níveis mais antigos do servidor de aplicativos. Por padrão, esta propriedade customizada é configurada como true, o que não permite que o cliente JAX-WS envie o cabeçalho SAVE_CONNECTION. Se for necessário alterar este comportamento padrão, configure a propriedade customizada como false no servidor de aplicativos que está hospedando o aplicativo cliente JAX-WS.
Importante: Você deve verificar se o servidor de aplicativos para o cliente e o host do servidor de aplicativos para o serviço da Web estão, ambos, usando a Versão 7.0 Fix Pack 3 ou posterior.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.webservices.transport.ssl.loadFromPolicyBinding

Use essa propriedade para controlar se aplicativos JAX-WS usam ligações de transporte de SSL ou as configurações de SSL padrão do sistema quando o cliente for um cliente gerenciado e o cliente e o servidor estiverem em diferentes servidores de aplicativos.

Ao criar uma ligação de SSL, essa propriedade é automaticamente incluída no arquivo de ligações e configurada como verdade. Essa configuração ativa ligações de transporte de SSL para ser usadas para aplicativos JAX-WS quando o cliente for um cliente gerenciado e o cliente e o servidor estiverem em diferentes servidores de aplicativos. Se nenhuma ligação estiver conectada ao seu aplicativo JAX-WS, configure essa propriedade como false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.webservices.UseWSFEP61ScanPolicy

Utilize essa propriedade para controlar se o produto faz a varredura de módulos WAR 2.4 e anteriores para componentes JAXWS e clientes de serviço semigerenciados. Por padrão, esses módulos WAR legado só são varridos para clientes de serviço semigerenciados.

O valor padrão é false.

Você deve configurar essa propriedade como true para cada servidor e servidor administrativo que exigir uma alteração no valor padrão.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.webservices.WSDL_Generation_Extra_ClassPath

Use essa propriedade para configurar o local dos arquivos de classe compartilhados. A ferramenta da linha de comandos wsgen gera os artefatos necessários que são necessários para a API Java para aplicativos XML Web Services (JAX-WS) quando forem iniciados a partir do código Java. No entanto, a ferramenta de linha de comandos pode não localizar os arquivos de classe necessários e anexar as seguintes mensagens de erro ao arquivo de log:
Causado por: java.lang.NoClassDefFoundError
...
at com.ibm.ws.websvcs.wsdl.WASWSDLGenerator.wsgen(WASWSDLGenerator.java:521)
at com.ibm.ws.websvcs.wsdl.WASWSDLGenerator.generateWsdl(WASWSDLGenerator.java:183)
Use essa propriedade para fornecer o local completo dos arquivos de classe ausentes. Com essa propriedade customizada, você deve fornecer os caminhos completos aos vários Java archives (JAR) e diretórios e separá-los usando ponto e vírgula (;). [z/OS]Para evitar problema, configure essa propriedade para todos os processos da JVM, incluindo gerenciador de implementação, agente do nó e servidor de aplicativos.
Importante: Se seu sistema operacional de base para WebSphere Application Server for AIX, Linux ou UNIX, use um caractere de dois pontos (:) para separar os diversos archives Java archives (JAR) e diretórios.

Exemplo: D:\sharedlibs;D:\libs\WSBean.jar

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

[z/OS]Lembre-se: Configure esta propriedade para o controlador e o servant. É possível configurar essa propriedade para o servant da seguinte maneira:
[z/OS]Evitar Problemas: Se desejar configurar essa propriedade no z/OS, é necessário configurar a propriedade para as propriedades customizadas JVM de Controle e Servidor:
  • Servidores de aplicativos>[SERVER_NAME]>Definição de processo>Servidor>Java Virtial Machine>Propriedades customizadas
  • Servidores de aplicativos>[SERVER_NAME]>Definição de processo>Controle>Java Virtial Machine>Propriedades customizadas

com.ibm.websphere.websvcs.EJBPostInvokeCallOnException

Use esta propriedade para limpar o estado e a transação após uma exceção em um Enterprise JavaBeans (EJB) chamado por serviços da web.

Em instalações do WebSphere Application Server que usam serviços da web JAX-WS, quando ocorre uma exceção em um EJB chamado como parte de um serviço da web, as transações podem permanecer ativas em um encadeamento e evitar que uma transação associada a um fluxo de transação XA atual continue. Configure esta propriedade para true para garantir uma limpeza completa do estado e da transação.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.websphere.workspace.decodeclustervariable

Use esta propriedade para garantir que as variáveis definidas em um escopo de cluster sejam expandidas quando ocorrerem em caminhos de arquivos de log definidos no console administrativo.

Se esta propriedade não for configurada e as variáveis com escopo definido em cluster forem usadas para definir os caminhos dos arquivos de log, então o gerenciamento de implementação pode falhar ao recuperar o arquivo de log requisitado. Portanto, você deve incluir esta propriedade às configurações JVM do gerenciador de implementação se você incluir variáveis com escopo definido em cluster em seus caminhos de arquivos de log.

O valor padrão é false.

Se você decidir usar esta propriedade customizada, será necessário especificá-la como uma propriedade customizada JVM do gerenciador de implementação. Depois de configurar esta propriedade para true, é preciso reiniciar o gerenciador de implementação antes de essa mudança entrar em vigor.

com.ibm.websphere.wsrm.MaxSequenceBacklog

Utilize essa propriedade para configurar o número máximo de mensagens em uma sequência de saída WS-RM.

Quando o limite definido é atingido, o WS-RM rejeitará quaisquer novas mensagens, emitindo uma exceção javax.xml.ws.WebServiceException até que o backlog diminua abaixo do limite. Os clientes que receberem uma exceção deverão tentar novamente a solicitação.

Não há nenhum valor padrão definido. Se nenhum valor configurado for definido, o limite de lista não processada será infinito.

com.ibm.websphere.wsrm.MessageContextCacheSize

Utilize essa propriedade para configurar o tamanho máximo do cache na memória para um valor inteiro positivo.

Não há nenhum valor padrão definido. O tamanho do cache é infinito.

com.ibm.websphere.wsrm.pollingInterval

Utilize essa propriedade para especificar a frequência com qual as solicitações MakeConnection são feitas para uma Sequência.

O valor especifica o intervalo em milissegundos. O comportamento padrão quando a propriedade não é configurada é 3000 milissegundos.

com.ibm.websphere.wsrm.retransmissionInterval

Use esta propriedade para especificar a frequência com a qual o WS-RM retransmite mensagens do aplicativo quanto tentativas anteriores de transmitir a mensagem tiverem falhado.

O valor especifica o intervalo em milissegundos. O comportamento padrão quando a propriedade não for configurada é 15000 milissegundos.

[z/OS]

com.ibm.websphere.zos.userdir.useRacfSettings

Quando essa propriedade é configurada para false, o user.dir é configurado pelo código do WebSphere Application Server para ${USER_INSTALL_ROOT}, a parte do caminho do sistema de arquivos de configuração antes do diretório /profiles/.

Quando essa propriedade é configurada para true, o user.dir não é configurado pelo código do WebSphere Application Server. Em vez disso, user.dir é configurado permitindo que as configurações do USS entrem em vigor (user.dir == diretório inicial do segmento OMVS).

Como o WebSphere Application Server não está configurando a propriedade, é possível definir user.dir nas propriedades customizadas da JVM do servidor para um valor de sua escolha. Uma vez definido o user.dir, o código Java o configurará por meio do arquivo de opções servant.jvm.options.

Note: A mudança do user.dir muda somente o valor da propriedade. Ela não muda o diretório atualmente em funcionamento da JVM, que é configurado no tempo de inicialização.

com.ibm.ws.amm.require.produces.annotation.for.cdi

O WebSphere Application Server ignora incorretamente as anotações a seguir (@EJB, @WebServiceRef, @PersistenceContext, @PersistenceUnit e @Resource) a menos que uma anotação @Produces esteja presente no bean CDI. Esse comportamento é incorreto porque não há requisito Java EE para que a anotação @Produces esteja presente. Como aplicativos existentes possuem dependências neste comportamento incorreto, o comportamento incorreto da especificação permanece o padrão. Esta propriedade customizada é fornecida para permitir que você obtenha o comportamento correto de especificação configurando a propriedade como false.

Configure a propriedade como false para obter o comportamento correto da especificação quando todos os itens a seguir forem true:
  • Seu aplicativo contém um bean CDI
  • O bean CDI contém qualquer uma das anotações a seguir: @EJB, @WebServiceRef, @PersistenceContext, @PersistenceUnit, @Resource
  • O bean CDI não contém uma anotação @Produces

com.ibm.ws.amm.scan.context.filter.archives

Use essa propriedade para fornecer uma lista de arquivos ou arquivos JAR utilitários que não contêm anotações. Archives ou arquivos JAR utilitários especificados para essa propriedade não devem ser varridos em busca de anotações.

Quando um aplicativo Java Platform, Enterprise Edition (Java EE) 5 ou 6 é implementado ou atualizado, o recurso Annotations Metadata Manager (AMM) varre todos os metadados de anotação. Esse processo de varredura pode afetar negativamente o período de tempo necessário para implementar um aplicativo. Se o aplicativo inclui arquivos ou utilitários que não contêm anotações, é possível listar esses arquivos e utilitários como o valor para essa propriedade. Se o aplicativo incluir Pacotes Java que não contenham anotações, você poderá listá-los como o valor para a propriedade Ignore-Scanning-Packages.

Os valores especificados para essas propriedades fazem distinção entre maiúsculas e minúsculas e devem ser expressos como uma única sequência com uma vírgula seguida por um espaço que é usado para separar os nomes dos archives ou arquivos JAR utilitários. Curingas e expressões REGEX não são permitidos.

Como uma alternativa para usar essa propriedade customizada, é possível incluir a propriedade Ignore-Scanning-Archives em um dos seguintes arquivos ou módulos e especificar os arquivos e utilitários que você não deseja que sejam varridos como o valor dessa propriedade:
  • O arquivo amm.filter.properties que está localizado no diretório was_home/properties.
  • O arquivo amm.filter.properties que está localizado no diretório profile_home/properties
  • O arquivo de manifesto de um aplicativo, META-INF/MANIFEST.MF
  • O manifesto de um módulo da Web ou Enterprise JavaBeans (EJB) dentro de um aplicativo

Valores especificados nos arquivos amm.filter.properties são mesclados com esses localizados nessa propriedade customizada para formar um conjunto de filtros com escopo definido pelo servidor. Esse conjunto de filtros mesclado aplica-se a todos os aplicativos que estão implementados nesse servidor.

Valores especificados no arquivo de manifesto de um aplicativo são mesclados com o conjunto de filtros com escopo definido pelo servidor para formar um superconjunto com escopo definido pelo módulo que se aplica a todos os módulos dentro desse aplicativo.

Valores especificados no arquivo de manifesto de um módulo da Web ou Enterprise JavaBeans (EJB) são mesclados com o conjunto de filtros com escopo definido pelo módulo. Esse conjunto de filtros mesclados aplica-se apenas a esse módulo.

Evitar Problemas Evitar Problemas: Aja com cuidado ao atualizar um arquivo de manifesto. Arquivos de manifesto possuem limitações de comprimento da linha e outras restrições que devem ser acatadas.gotcha
Por exemplo:
Ignore-Scanning-Archives : ant.jar,  avalon-framework-4.2.0.jar, axis.jar, CICS.jar, xerces.jar

com.ibm.ws.amm.scan.context.filter.disable.unifyTrue

Use esta propriedade somente se precisar filtrar determinados arquivos JAR a partir da varredura de anotação pelo Annotations Metadata Manager (AMM), mas você deseja que os arquivos sejam varridos pela camada do Extensible Class Scanner (ECS). Para ativar essa propriedade, configure o valor para true.

O valor padrão é false.

com.ibm.ws.amm.scan.context.filter.packages.

Use essa propriedade para fornecer uma lista de Java Packages que não contêm anotações. As classes Java especificadas para essa propriedade não são varridas para anotações.

Quando um aplicativo Java Platform, Enterprise Edition (Java EE) 5 ou 6 é implementado ou atualizado, o recurso Annotations Metadata Manager (AMM) varre todos os metadados de anotação. Esse processo de varredura pode afetar negativamente a quantidade de tempo necessária para implementar um aplicativo. Se o aplicativo inclui Java Packages que não contêm anotações, é possível listá-los como o valor para essa propriedade. Se o aplicativo inclui arquivos ou utilitários que não contêm anotações, é possível listá-los como o valor para a propriedade Ignore-Scanning-Archives.

Os valores especificados para essa propriedade fazem distinção entre maiúsculas e minúsculas e devem ser expressos como uma única sequência seguida por um espaço que é usado para separar os nomes de Pacotes Java. Curingas e expressões REGEX não são permitidos.

Como uma alternativa para usar essa propriedade customizada, é possível incluir a propriedade Ignore-Scanning-Packages em um dos seguintes arquivos ou módulos e especificar os arquivos e utilitários que você não deseja que sejam varridos como o valor dessa propriedade:
  • O arquivo amm.filter.properties que está localizado no diretório was_home/properties
  • O arquivo amm.filter.properties que está localizado no diretório profile_home/properties
  • O arquivo de manifesto de um aplicativo, META-INF/MANIFEST.MF
  • O manifesto de um módulo da Web ou Enterprise JavaBeans (EJB) dentro de um aplicativo

Os valores especificados nos arquivos amm.filter.properties são mesclados com os valores localizados nessa propriedade customizada para formar um conjunto de filtros com escopo definido pelo servidor. Esse conjunto de filtros mesclado aplica-se a todos os aplicativos que estão implementados nesse servidor.

Os valores especificados no arquivo manifest de um aplicativo são mesclados com o conjunto de filtros com escopo definido pelo servidor para formar um superconjunto com escopo definido pelo módulo que se aplica a todos os módulos nesse aplicativo.

Os valores especificados no arquivo manifest de um módulo da web ou Enterprise JavaBeans (EJB) são mesclados com o conjunto de filtros com escopo definido pelo módulo. Esse conjunto de filtros mesclados aplica-se apenas a esse módulo.

Evitar Problemas Evitar Problemas: O exemplo a seguir é centrado em um arquivo de propriedades e não pode ser usado no estado em que se encontra para um arquivo de manifesto. Os arquivos manifest possuem um limite de comprimento de linha de 72 bytes, bem como outras restrições que devem ser consideradas.gotcha
Por exemplo:
Ignore-Scanning-Packages : org.apache.avalon, org.apache.batik, org.apache.commons

com.ibm.ws.application.enhancedScanning

Utilize esta propriedade para desativar várias otimizações que diminuem o tempo de implementação e inicialização de aplicativos corporativos. As otimizações envolvem principalmente os aplicativos ativados para Java Platform, Enterprise Edition (Java EE 5). Quando você configura essa propriedade como false, as atualizações a seguir são desativadas:
  • Um novo cache para arquivos de módulo
  • Um novo cache para o carregamento de classe do módulo
  • Caminhos de código alternativos para processamento de anotação.
Se você configurar essa propriedade como false, talvez ocorra uma queda no desempenho. O valor padrão é true.

com.ibm.ws.cache.CacheConfig.alwaysSetSurrogateControlHdr

Use esta propriedade para forçar o cabeçalho de controle de substituto para que o serviço de cache dinâmico seja sempre configurado na resposta. O cabeçalho de controle de substituto contém os metadados que o processamento do Edge Side Include (ESI) precisa para gerar e invalidar o conteúdo armazenado em cache no cache ESI corretamente.

O valor padrão é false, o que significa que o cabeçalho de controle de substituto poderá não ser configurado na resposta.

Se decidir usar esta propriedade customizada, especifique-a como uma propriedade customizada da JVM do servidor de aplicativos, a menos que seja indicado de outra forma dentro do contexto de uma tarefa específica.

com.ibm.ws.cache.CacheConfig.cascadeCachespecProperties

Use esta propriedade para ativar páginas filhos ou fragmentos para herdar a cascata de propriedades de atributos salvos e de cookies armazenados a partir de suas páginas pais ou fragmentos. O valor padrão é false.

O comportamento padrão do serviço de cache dinâmico é armazenar os atributos de pedido para uma página ou fragmento filho, se não explicitamente substituídos na especificação de cache. Um servidor de aplicativos pode ser executado em uma condição Sem Memória em cenários onde esses atributos de pedido ficam muito grandes. Se os atributos salvos por padrão não forem serializáveis, a transferência de disco dessas entradas de cache resulta em java.io.NotSerializableExceptions.

Se decidir usar esta propriedade customizada, especifique-a como uma propriedade customizada da JVM do servidor de aplicativos, a menos que seja indicado de outra forma dentro do contexto de uma tarefa específica.

com.ibm.ws.cache.CacheConfig.filteredStatusCodes

Use essa propriedade para indicar situações de erro nas quais você não deseja que o serviço de cache dinâmico armazene em cache a saída do servlet.

O valor especificado para essa propriedade é uma lista delimitada por espaços de códigos de erro de resposta HTTP. Se o código de status retornado de uma perda de acerto no cache corresponder a um dos códigos de erro de resposta listados, o serviço de cache dinâmico não armazenará em cache os dados que foram obtidos em resposta a uma solicitação de HTTP.

Se decidir usar esta propriedade customizada, especifique-a como uma propriedade customizada da JVM do servidor de aplicativos, a menos que seja indicado de outra forma dentro do contexto de uma tarefa específica.

com.ibm.ws.cache.CacheConfig.use61EntrySetBehavior

Use esta propriedade para retornar uma visualização de conjunto dos mapeamentos contidos no mapa.

Quando com.ibm.ws.cache.CacheConfig.use61EntrySetBehavior for definido e configurado como true, o métodoDistributedMap.entrySet() retornará uma visualização configurada dos mapeamentos contidos no mapa.

Essa propriedade customizada pode ser configurada como uma propriedade customizada JVM em Servidores > Servidores de aplicativos > <nome do servidor> > Definições do processo > Java Virtual Machine > Propriedades customizadas.

Definir esta propriedade customizada da JVM afeta todas as instâncias de cache. Esta propriedade é especificada no nível de servidor de aplicativos.

com.ibm.ws.cache.CacheConfig.useServerClassLoader

Use essa propriedade para especificar qual carregador de classe a JVM deve usar quando desserializar um InvalidationEvent. Quando você configura essa propriedade para true, o carregador de classe do servidor será usado para desserializar o InvalidationEvent. Se você configurar essa propriedade como false, o carregador de classe do aplicativo será utilizado para desserializar InvalidationEvent. O valor padrão é false.

Usar o carregador de classe apropriado quando desserializar um InvalidationEvent ajuda a melhorar o desempenho.

Se decidir usar esta propriedade customizada, especifique-a como uma propriedade customizada da JVM do servidor de aplicativos, a menos que seja indicado de outra forma dentro do contexto de uma tarefa específica.

com.ibm.ws.CacheConfig.alwaysTriggerCommandInvalidations

Use essa propriedade para assegurar que as invalidações desse comando sejam acionadas independentemente do atributo skipCache.

Quando um objeto da solicitação contém o atributo <previewRequest>, o cache dinâmico configura o atributo skipCache como true. Quando o atributo skipCache for verdadeiro, os comandos não são sempre invalidados. Configure a propriedade customizada com.ibm.ws.CacheConfig.alwaysTriggerCommandInvalidations como verdade para assegurar que as invalidações desse comando sejam acionadas independentemente do atributo skipCache. Quando você configura essa propriedade customizada, ela afeta todas as instâncias de cache. O valor padrão é false.

Essa propriedade customizada é configurada apenas no nível do servidor de aplicativos.

Se decidir usar esta propriedade customizada, especifique-a como uma propriedade customizada da JVM do servidor de aplicativos, a menos que seja indicado de outra forma dentro do contexto de uma tarefa específica.

com.ibm.ws.cdi.immediate.ejb.start

Use essa propriedade para assegurar que o contêiner contexts and dependency injection (CDI) e seus ciclos de vida sejam iniciados para todos os módulos EJB quando o aplicativo for iniciado.

Quando essa propriedade estiver configurada como um valor true, o contêiner CDI e seus ciclos de vida serão iniciados para todos os módulos EJB quando o aplicativo for iniciado. O valor padrão dessa propriedade é false.

com.ibm.ws.classloader.allowDisposedClassLoad

Use essa propriedade para especificar se a JVM deve descartar completamente um carregador de classes de aplicativo quando o aplicativo é interrompido. Se a JVM não descartar completamente um carregador de classes de aplicativo, as classes ainda poderão ser carregadas desse carregador de classes.

Quando essa propriedade estiver configurada para um valor true, a JVM não descartará completamente um carregador de classes de aplicativo quando o aplicativo for interrompido.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.classloader.encodeResourceURLs

Use esta propriedade para especificar se os carregadores de classes de aplicativo, tais como carregadores de EAR, módulo da web e biblioteca compartilhada codificam espaços em URLs do recurso. Se esta propriedade for configurada como true, os espaços serão codificados como "%20" nas URLs que uma chamada getResource ou getResources retorna.

O valor padrão é true. Se essa propriedade for configurada como false, uma mensagem de aviso WSVR0333W será exibida nos logs. Esta mensagem indica que o uso da configuração false para essa propriedade foi descontinuado.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.classloader.strict

Use esta propriedade para ativar o carregador de classes de aplicativo do WebSphere Application Server para fornecer acesso ao diretório META-INF através de uma chamada getResources, mesmo que o caminho de diretório META-INF não inclua uma barra final

Por padrão, o carregador de classes de aplicativo do WebSphere Application Server não fornece acesso ao diretório META-INF por meio de uma chamada getResources, a menos que uma barra à esquerda seja especificada no fim do caminho do diretório META-INF. Se você quiser que o carregador de classes de aplicativo do WebSphere Application Server forneça acesso ao diretório META-INF através de uma chamada getResources, mesmo que uma barra final não seja especificada no final do caminho de diretório META-INF, configure essa propriedade como true.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.classloader.zipFileCacheSize

Use essa propriedade para especificar o número máximo de arquivos JAR do aplicativo que possam ser retidos abertos para carregamento de classe e de recurso. A redução do número de vezes que os arquivos JAR devem ser abertos melhora o desempenho de aplicativos com carregamento intensivo de recurso ou classe.

Quando o limite especificado de arquivos JAR abertos é atingido, o carregador de classes começa a fechar e remover os arquivos JAR baseados na última vez em que foram acessados. Os arquivos JAR acessados recentemente são mantidos abertos. O valor que é especificado para essa propriedade deve ser baseado no número total de arquivos JAR do aplicativo que são frequentemente acessados.

O valor padrão para esta propriedade é 8. A especificação do valor 0 desativa o cache e evita que arquivos JAR do aplicativo sejam mantidos abertos.

Evitar Problemas Evitar Problemas: Evite Problemas: Não use a função Microsoft Windows Hot Deployment se especificar um valor diferente de 0 para esta propriedade. gotcha

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.cscope.HighlyAvailableIORsEnabled

Esta propriedade permite que o administrador configure o serviço de compensação para gerar IORs altamente disponíveis para objetos CORBA de atividade de negócios distribuída, que permitem atividades de negócios subordinadas distribuídas que falharam sejam concluídas durante a recuperação peer-to-peer. Esta propriedade também permite novas atividades de negócios quando o agente do nó não está em execução.

O valor padrão dessa propriedade é false. A especificação de um valor igual a true ativa esta propriedade. Esta propriedade deve ser configurada em cada servidor de aplicativos no cluster.

com.ibm.ws.el.reuseEvaluationContext

Utilize esta propriedade para indicar que o mesmo objeto EvaluationContext pode ser reutilizado por encadeamento.

Normalmente, durante a avaliação de expressões, o código Unified EL cria um novo objeto org.apache.el.lang.EvaluationContext object para cada chamada que é feita. Como esses objetos são disponibilizados subsequentemente para coleta de lixo, conforme aumenta o número de objetos criados, o consumo de memória e a coleta de lixo também aumentam. A configuração da propriedade com.ibm.ws.el.reuseEvaluationContext como true permite que o mesmo objeto EvaluationContext seja reutilizado em uma base por encadeamento, diminuindo, assim, o consumo de memória e a quantidade de coleta de lixo que precisa ocorrer.

O valor padrão é false.

com.ibm.ws.http.ConnectionIOTimeout

Use esta propriedade para estender o tempo limite da porta SOAP entre o tempo em que uma conexão é estabelecida e o tempo em que a transmissão de dados do cliente é iniciada. O valor padrão é de 5 segundos (15 segundos no Liberty). Ele talvez precise ser aumentado se um servidor SOAP ou JVM cliente estiver ocupada, ou um handshake SSL estiver demorando um longo período de tempo. Uma mensagem HTTP 408 pode ser recebida a partir do servidor SOAP, se ocorrer esse tempo limite.

[z/OS]

com.ibm.ws.iiop.channel.disableOnewayLocateRequiredMessage

Use essa propriedade para controlar se a mensagem CWZGB0005I é exibida sempre que uma solicitação GIOP unidirecional com relação a um objeto requer endereçamento de avanço de localização adicional. Se a propriedade for configurada como false, a mensagem CWZGB0005I será exibida. Se a propriedade for configurada para true, a mensagem CWZGB0005I não será exibida.

O valor padrão é false.

com.ibm.ws.jsf.allow.interpolator.per.app

O contêiner JSF foi atualizado para permitir que um MessageInterpolator fosse definido e usado para cada aplicativo e não é compartilhado entre os aplicativos. Essa propriedade deve ser configurada como true para que um novo comportamento seja ativado:

com.ibm.ws.jsf.call.publishevent.with.sourceclass

Use esta propriedade para assegurar que a classe de origem adequada seja usada ao chamar javax.faces.Application.publishEvent. Por padrão, ao chamar javax.faces.Application.publishEvent, UIComponent.class é sempre usada no lugar da classe de origem real. No entanto, o parâmetro sourceBaseType deve indicar o evento de origem que deve ser usado para consultar o listener no qual este evento deve ser publicado. Se este argumento for nulo o retorno de source.getClass() deverá ser usado como o sourceBaseType.

O valor padrão é false.

com.ibm.ws.jsp.enhance_el_support

Use essa propriedade para controlar como uma expressão é manipulada. Durante a avaliação de uma expressão, o valor é imposto para o tipo esperado na Seção 1.8.2 do Expression Language Specification Versão 2.1. Essa imposição pode resultar em resultados inesperados, pois o valor da expressão pode não ser do tipo esperado. Configure essa propriedade para true para evitar essa imposição.

O valor padrão é false.

com.ibm.ws.management.application.task.AppTypeDeploymentTask.isLongRunningApp

Essa propriedade é listada somente para propósitos informativos. Essa propriedade é criada automaticamente e é usada para configuração automática e não deve ser mudada.

O valor padrão é true.

com.ibm.ws.management.connector.soap.logClientInfo

Use essa propriedade para indicar se você deseja registrar o host, a porta e o nome de usuário de solicitações do cliente SOAP. Quando essa propriedade está configurada como true, os detalhes do cliente SOAP são registrado em SystemOut.log. Esses detalhes também são incluídos em trace.log se o nível de rastreio para o conector SOAP está configurado para all.

O valor padrão é false.

[Windows]

com.ibm.ws.management.connector.soap.waitBeforeCloseTime

Use essa propriedade para alterar o tempo de duração especificado para o tempo limite de conexão SOAP do servidor. Ao usar o adaptador do host local no sistema operacional Microsoft Windows, o tempo limite da conexão do servidor SOAP, que é padronizado para 10 milissegundos, permitirá grandes quantidades de dados a serem transmitidos sem interrupção.

Se for especificar um tempo de duração muito curto para essa propriedade, uma SOAPException para fim precoce do fluxo poderá ocorrer no lado do servidor da conexão quando uma grande quantidade de dados for enviada.

Especificar um valor 0 desativa a função de tempo limite.

com.ibm.ws.management.event.max_polling_interval

Use esta propriedade para especificar o período de tempo máximo que o servidor deve esperar antes de solicitar ou obter notificações do cliente. O intervalo de pesquisa padrão é 1000 milissegundos (1 segundo). Se um valor da propriedade não for especificado, o valor padrão será usado.

Se estiver usando um conector SOAP ou IPC, será possível usar esta propriedade para sintonizar esse conector de forma que a quantidade de tempo que o servidor espera por uma notificação de pesquisa do cliente corresponda ao intervalo de tempo que o servidor esperaria se você estivesse usando um conector RMI.

Este valor da propriedade é configurado como -1, o cliente pesquisa notificações com base em um algoritmo adaptável integrado que altera o intervalo de pesquisa com base no número de notificações que o cliente recebe. Um intervalo de tempo de 3 a 20 segundos pode expirar entre pesquisas antes que a primeira notificação seja recebida.

Para Usuários de Transição Para Usuários de Transição: Anterior à Versão 8.0, se um valor não foi especificado para a propriedade com.ibm.ws.management.event.max_polling_interval, as pesquisas dos cliente para notificação foram baseadas no algoritmo de adaptação integrado que altera o intervalo de pesquisa com base no número de notificações que o cliente recebe.trns

Esta propriedade deve ser especificada para a JVM do lado do cliente.

com.ibm.ws.management.event.pull_notification_timeout

Use esta propriedade para especificar a quantidade de tempo que o cliente espera antes da notificação de pesquisa do servidor. O tempo limite padrão é 60000 milissegundos (60 segundos ou 1 minuto). Se um valor da propriedade não for especificado, o valor padrão será usado.

Se o valor da propriedade for configurado como 0 (zero) ou com um número negativo tal como -1, o servidor retornará ao cliente imediatamente, mesmo se nenhuma notificação estiver disponível.

Para Usuários de Transição Para Usuários de Transição: Anterior à versão 8.0, se um valor não foi especificado para a propriedade com.ibm.ws.management.event.pull_notification_timeout, o servidor será retornado para o cliente imediatamente, mesmo que nenhuma notificação estivesse disponível.trns

Esta propriedade deve ser especificada para a JVM do lado do servidor.

com.ibm.ws.management.repository.tempFileKeepTimeMinutes

Use esta propriedade para especificar, em minutos, quanto tempo um arquivo é mantido no diretório temporário do repositório de configuração antes que a tarefa de limpeza do diretório temporário do repositório possa excluir esse arquivo do diretório. O valor padrão para essa propriedade é de 1440 minutos, que é igual a 24 horas. Nas versões anteriores do produto, um arquivo era mantido por 60 minutos.

O valor padrão é tipicamente suficiente para executar a limpeza necessária sem excluir os arquivos que estão em uso. No entanto, poderá haver situações em que é necessário especificar um valor maior ou menor. É possível especificar um valor mínimo de 60 minutos para essa propriedade. No entanto, é recomendável que você especifique um valor que seja equivalente a várias horas para a conta, para situações em que arquivos muito grandes estejam sendo transferidos ou sincronizados, ou em que uma rede esteja lenta e as operações de transferência de arquivos estejam demorando um longo tempo. Nestas situações, se um período de tempo muito curto estiver especificado, é possível que um arquivo seja excluído enquanto ainda estiver sendo transferido.

Se a propriedade com.ibm.ws.management.repository.tempFileSweepIntervalMinutes estiver configurada como 0, a função de limpeza será desativada e os arquivos deixados atrás depois de uma falha do processo do servidor, permanecerão no diretório temporário do repositório de configuração até que sejam removidos manualmente ou que a função de limpeza seja ativada.

Evitar Problemas Evitar Problemas: Se um valor inválido estiver especificado para essa propriedade, o valor padrão será usado.gotcha

com.ibm.ws.management.repository.tempFileSweepIntervalMinutes

Use esta propriedade para especificar, em minutos, com que frequência a tarefa de limpeza do diretório temporário do repositório de configuração é executada. Essa tarefa remove os arquivos do diretório temporário do repositório de configuração que não foram removidos adequadamente por causa de uma falha do processo do servidor.

A tarefa de limpeza é sempre executada quando o servidor é iniciado e, em seguida, novamente após o período de tempo especificado que a expiração dessa propriedade. O valor padrão para essa propriedade é de 720 minutos, que é equivalente a 12 horas. Essa duração de tempo é tipicamente suficiente para que a tarefa de limpeza do diretório temporário do repositório de configuração conclua com êxito o processo de limpeza. É possível desativar essa função de limpeza configurando essa propriedade como 0.

Na versões anteriores do produto, a tarefa de limpeza era executada quando o servidor era iniciado e, em seguida, executada novamente a cada 30 minutos.

Evitar Problemas Evitar Problemas: Se um valor inválido estiver especificado para essa propriedade, o valor padrão será usado.gotcha

com.ibm.ws.management.suppressPortScan

Configure esta propriedade como um valor de true para suprimir a verificação de atividade da porta pelo gerenciador de implementação quando novos servidores forem criados. Ao configurar como true, o gerenciador de implementação não tentará vincular ou conectar a uma nova porta antes de usar a porta em uma configuração do servidor. A supressão da verificação de atividade da porta pode conduzir a conflitos de porta, se outros aplicativos tiverem portas ativas. O valor padrão é false.

com.ibm.ws.management.taskcommandtimeoutsec

Configure esta propriedade para um valor em segundos, se ocorrer um SessionTimeoutException de TaskCommandSessionMgr ao executar uma atualização de aplicativo de longa execução. O valor padrão é de 1200 segundos (20 minutos).

com.ibm.ws.odr.plugincfg.config.ASDisableNagle

Use essa propriedade para especificar se você deseja desativar o algoritmo de Nagle para a conexão entre o plug-in e o servidor proxy.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Config no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é false, o que significa que o algoritmo de Nagle está ativado para a conexão entre o plug-in e o servidor proxy.

com.ibm.ws.odr.plugincfg.config.AcceptAllContent

Use essa propriedade para especificar se é possível incluir conteúdo nas solicitações POST, PUT, GET e HEAD quando um cabeçalho Content-Length ou Transfer-encoding está contido no cabeçalho da solicitação. É possível especificar um dos valores a seguir para esse atributo:
  • True se o contexto for esperado e lido por todas as solicitações.
  • False se conteúdo for esperado e lido somente por solicitações POST e PUT.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Config no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.config.AppServerPortPreference

Use essa propriedade para especificar qual número de porta é usado para construir URIs para um sendRedirect.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Config no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é HostHeader.

com.ibm.ws.odr.plugincfg.config.ChunkedResponse

Use essa propriedade para especificar se o plug-in agrupa a resposta para o cliente quando um cabeçalho da resposta Transfer-Encoding: Em Chunk está presente na resposta.

É possível especificar um dos valores a seguir para esse atributo:
  • True se o plug-in deve dividir em chunk a resposta para o cliente quando um cabeçalho da resposta Transfer-Encoding: Em Chunk está presente na resposta.
  • False se a resposta não deve sofrer chunk.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Config no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.config.IISDisableNagle

Use essa propriedade para especificar se você deseja desativar o algoritmo de Nagle.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Config no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.config.IISPluginPriority

Use essa propriedade para especificar a prioridade na qual o servidor da web carrega o plug-in. É possível especificar um dos valores a seguir para esse atributo:
  • Alto
  • Médio
  • Baixo

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Config no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é Alto.

com.ibm.ws.odr.plugincfg.config.IgnoreDNSFailures

Use essa propriedade para especificar se o plug-in deve ignorar falhas de DNS em uma configuração quando iniciado.

Quando essa propriedade é configurada como true, o plug-in ignora as falhas de DNS em uma configuração e inicia com êxito se pelo menos um servidor em cada ServerCluster resolver o nome do host. Qualquer servidor para o qual o nome do host não é resolvido é marcado como indisponível para a duração da configuração. O nome do host não é resolvido posteriormente durante o roteamento de solicitações. Se ocorrer uma falha de DNS, uma mensagem de log será gravada no arquivo de log do plug-in e a inicialização do plug-in continuará em vez do servidor da web não iniciar.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Config no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.config.RefreshInterval

Use essa propriedade para especificar, em segundos, com que frequência o plug-in deve verificar atualizações ou mudanças no arquivo de configuração. O plug-in verifica quaisquer modificações no arquivo que ocorreram desde que a configuração de plug-in foi carregada.

Em um ambiente de desenvolvimento no qual ocorrem mudanças frequentes, configure o intervalo de tempo para menos que 60 segundos.

Em um ambiente de produção, você deve configurar um valor mais alto que o valor padrão, pois as atualizações na configuração não ocorrem tão frequentemente.

Se o recarregamento do plug-in não for bem-sucedido, o arquivo de log do plug-in conterá uma mensagem de erro e a configuração anterior será usada até que o arquivo de configuração de plug-in seja recarregado com êxito. Consulte o arquivo de log do plug-in para obter informações adicionais se ocorrer um erro.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Config no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é 60.

com.ibm.ws.odr.plugincfg.config.ResponseChunkSize

Use essa propriedade para especificar, em kilobytes, o tamanho máximo do chunk que o plug-in deve usar ao ler o corpo de resposta. Por exemplo, Config ResponseChunkSize="N", em que N é igual ao tamanho do chunk.

Por padrão, o plug-in lê o corpo de resposta em chunks de 64 k até que todos os dados de resposta sejam lidos. Esse processo pode causar um problema de desempenho para solicitações em que o corpo de resposta contém grandes quantidades de dados. Se o tamanho do conteúdo do corpo de resposta for desconhecido, um tamanho do buffer de N kilobytes será alocado e o corpo será lido em chunks com o tamanho de N kilobytes até que o corpo inteiro seja lido. Se o tamanho do conteúdo for conhecido, um tamanho do buffer do tamanho do conteúdo ou com tamanho de N será usado para ler o corpo de resposta.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Config no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é 64.

com.ibm.ws.odr.plugincfg.config.VHostMatchingCompat

Use essa propriedade para especificar se o plug-in deve usar o número da porta para a correspondência do host virtual. Os valores a seguir podem ser especificados:
  • True para corresponder fisicamente usando o número da porta no qual a solicitação é recebida.
  • False para corresponder logicamente usando o número da porta contido no cabeçalho do host.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Config no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.config.TrustedProxyEnable

Use essa propriedade para especificar se o plug-in deve permitir a inclusão de proxies confiáveis. Os valores a seguir podem ser especificados:
  • True se desejar permitir a inclusão de proxies confiáveis.
  • False se não desejar permitir a inclusão de proxies confiáveis.

Os proxies confiáveis são coletados a partir dos proxies de segurança confiáveis definidos.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Config no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.log.Name

Use essa propriedade para especificar o caminho completo para o arquivo de log no qual o plug-in grava mensagens de erro.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Log no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é profileRoot/logs/http_plug-in.log.

com.ibm.ws.odr.plugincfg.log.LogLevel

Use essa propriedade para especificar o nível de detalhes das mensagens de log que o plug-in grava no log. É possível especificar um dos valores a seguir para esse atributo:
  • Trace. Todas as etapas no processo de solicitação são regradas em detalhe.
  • Stats. O servidor selecionado para cada solicitação e outras informações de balanceamento de carga relacionadas à manipulação de solicitações são registrados.
  • Warn. Todas as mensagens de aviso e erro resultantes do processamento de solicitação anormal são registradas.
  • Error. Somente as mensagens de erro resultantes do processamento de solicitação anormal são registradas.
  • Debug. Todas as etapas críticas que são executadas no processamento de solicitações são registradas.
  • Detalhe. Todas as informações sobre pedidos e respostas são registradas.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Log no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é Error.

Evitar Problemas Evitar Problemas: Muitas mensagens são registradas no nível de rastreio, o que pode fazer com que o sistema de arquivo fique cheio muito rapidamente. Nunca use uma configuração de rastreio em um ambiente funcionando normalmente porque isso afeta adversamente o desempenho.gotcha

com.ibm.ws.odr.plugincfg.cluster.CloneSeparatorChange

Use essa propriedade para indicar ao plug-in que o caractere de mais (+) pode ser usado como o separador de clone.

Alguns dispositivos disseminados não podem manipular o caractere dois pontos (:) que é usado para separar IDs de clone com afinidade de sessão.

Evitar Problemas Evitar Problemas: Se você usar essa propriedade customizada, deverá alterar as configurações do servidor proxy de modo que o servidor proxy separe os IDs de clone com o caractere de mais em vez do caractere dois-pontos.gotcha

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento ServerCluster no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.cluster.LoadBalance

Use esta propriedade para especificar a opção de balanceamento de carga apropriada: Round Robin ou Aleatório.

A implementação de Round Robin possui um ponto inicial aleatório. O primeiro servidor proxy é selecionado aleatoriamente. Round-robin é, então, usado para selecionar servidores proxy desse ponto em diante. Essa implementação assegura que, em vários servidores da web baseados em processo, todos os processos não são iniciados enviando a primeira solicitação para o mesmo servidor proxy.

A implementação Aleatória também possui um ponto de início aleatório. No entanto, com essa implementação, todos os servidores proxy subsequentes também são selecionados aleatoriamente. Portanto, o mesmo servidor proxy pode ser selecionado repetidamente enquanto outros servidores proxy permanecem inativos.

O valor padrão é Round Robin.

com.ibm.ws.odr.plugincfg.cluster.PostSizeLimit

Use essa propriedade para especificar, em bytes, o número máximo de bytes do conteúdo da solicitação que o plug-in tem permissão para tentar enviar a um servidor. Se for recebida uma solicitação maior que o valor especificado, o plug-in terminará a solicitação

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento ServerCluster no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é -1, o que indica que não há nenhum limite para o tamanho de uma solicitação.

com.ibm.ws.odr.plugincfg.cluster.RemoveSpecialHeaders

Use essa propriedade para especificar se o plug-in deve incluir cabeçalhos especiais em uma solicitação antes que ela seja encaminhada ao servidor. Esses cabeçalhos armazenam informações sobre a solicitação que o aplicativo usa. Por padrão, o plug-in remove esses cabeçalhos das solicitações recebidas antes de incluir os cabeçalhos necessários.

Se você configurar essa propriedade como false, apresentará um cabeçalho com possível risco à segurança de solicitações recebidas que não são removidas.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento ServerCluster no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é true.

com.ibm.ws.odr.plugincfg.cluster.RetryInterval

Use essa propriedade para especificar, em segundos, a quantidade de tempo que decorre entre quando um servidor proxy é marcado como inativo e quando o plug-in tenta novamente fazer uma conexão.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento ServerCluster no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é 60.

com.ibm.ws.odr.plugincfg.odrIncludeStopped

Use essa propriedade para especificar se o plug-in deve permitir a inclusão de servidores proxy interrompidos. Os valores a seguir podem ser especificados:
  • True se desejar permitir a inclusão de servidores proxy interrompidos.
  • False se você não desejar permitir a inclusão de servidores proxy interrompidos.

Esta propriedade é válida somente para um servidor proxy.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.server.ConnectTimeout

Use essa propriedade para especificar, em segundos, o período de tempo que o plug-in deverá esperar por uma conexão bem-sucedida

A especificação de um valor para a propriedade permite que o plug-in execute conexões não bloqueadas com o servidor proxy. Tais conexões são vantajosas quando o plug-in não pode entrar em contato com o destino para determinar se a porta está disponível ou indisponível.

Quando um valor maior que 0 é especificado, e uma conexão não ocorre após a decorrência desse intervalo de tempo, o plug-in marca o servidor proxy como indisponível e continua com um dos outros servidores proxy definidos no cluster.

Se nenhum valor for especificado para essa propriedade, o plug-in executará uma conexão de bloqueio na qual o plug-in aguarda até que um sistema operacional atinja o tempo limite e permita que o plug-in marque o servidor proxy como indisponível.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Server no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é 0.

com.ibm.ws.odr.plugincfg.server.ExtendedHandShake

Use esta propriedade para indicar ao plug-in que ele deve assegurar a disponibilidade de um servidor proxy antes de enviar uma solicitação para esse servidor proxy.

Geralmente, o plug-in marca um servidor proxy como interrompido quando um connect() é encerrado. No entanto, quando um firewall do proxy estiver entre o plug-in e o servidor proxy, connect() será bem-sucedido, mesmo que o servidor proxy backend seja interrompido. Esta situação faz com que o plug-in não execute failover corretamente para outros servidores proxy.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Server no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.server.MaxConnections

Use essa propriedade para especificar o número máximo de conexões pendentes para um servidor proxy que podem fluir em um processo do servidor da web a qualquer momento.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Server no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é -1, o que indica que não há nenhum número máximo para o número de conexões pendentes para um servidor proxy que podem fluir por um processo do servidor da web a qualquer momento.

com.ibm.ws.odr.plugincfg.cluster.WaitForContinue

Use essa propriedade para especificar se deve usar o suporte para HTTP 1.1 100 Continuar antes de enviar o conteúdo da solicitação para o servidor proxy.

Normalmente, o plug-in não aguarda a resposta 100 Continuar do servidor proxy antes de enviar o conteúdo da solicitação. Você deve usar o suporte para HTTP 1.1 100 Continuar ao configurar o plug-in para trabalhar com determinados tipos de firewalls de proxy.

Essa propriedade é ignorada para solicitações POST para evitar que uma falha ocorra se o servidor proxy fechar uma conexão devido a um tempo limite.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Server no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.property.ESIEnable

Use essa propriedade para ativar ou desativar o processador Edge Side Include (ESI). Se o processador ESI for desativado, os outros elementos ESI no arquivo serão ignorados.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Property no arquivo plug-in-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é true.

com.ibm.ws.odr.plugincfg.property.ESIMaxCacheSize

Use esta propriedade para especificar, em unidades de 1 KB, o tamanho máximo do cache. O tamanho máximo padrão do cache é 1024 KB (1 megabyte). Se o cache estiver cheio, a primeira entrada a ser despejada do cache será a mais próxima da hora de expiração.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Property no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é 1024.

com.ibm.ws.odr.plugincfg.property.ESIInvalidationMonitor

Use essa propriedade para especificar se o processador ESI recebe invalidações do servidor proxy.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Property no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.property.https.keyring

Use essa propriedade para especificar o local do diretório do conjunto de chaves SAF quando o protocolo do transporte é configurado como HTTPS.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Property no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é profileRoot/etc/plugin-key.kdb.

com.ibm.ws.odr.plugincfg.property.https.stashfile

Use esta propriedade para especificar o local do arquivo stash.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Property no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é profileRoot/node/etc/plugin-key.sth .

com.ibm.ws.odr.plugincfg.property.PluginInstallRoot

Use esta propriedade para especificar o caminho da instalação para o plug-in.

Você deve configurar essa propriedade para o caminho completo da raiz da instalação do plug-in. Se você usar o valor padrão, a propriedade não será exibida no arquivo plug-in-cfg.xml.

Essa propriedade é válida somente para um servidor proxy e se aplica ao elemento Property no arquivo plugin-cfg.xml gerado automaticamente pelo servidor proxy.

O valor padrão é "".

com.ibm.ws.pm.checkingDBconnection

Use esta propriedade para especificar se o gerenciador de persistência deve continuar a verificar a disponibilidade de um banco de dados, que foi marcado anteriormente como indisponível, até que uma conexão com esse banco de dados seja estabelecida com êxito.

Se um serviço do banco de dados estiver desativado quando o gerenciador de persistência tentar estabelecer uma conexão com esse banco de dados, o banco de dados será marcado como indisponível. Tipicamente, o gerenciador de persistência não tenta estabelecer novamente uma conexão depois que um banco de dados é marcado como indisponível. Se você enviou essa propriedade como true, o gerenciador de persistência continuará a verificar a disponibilidade do banco de dados até que ele possa estabelecer com êxito uma conexão com esse banco de dados.

O valor padrão é false.

com.ibm.ws.policyset.exportEncodedPasswords

Configure a propriedade como true para ativar as ligações do conjunto de políticas WS-Security que incluem senhas criptografadas a serem exportadas usando as senhas codificadas XOR em substituição.

Os valores válidos são true e false.

O valor padrão é false.

com.ibm.ws.recoverylog.disableNonHARegistration

Quando o servidor de aplicativos não for membro de um cluster que tem o failover de recuperação do log de transações que está ativado, não é necessário que o serviço de log de recuperação seja registrado no HA Manager.

No entanto, se o failover for ativado posteriormente, e ocorrer apenas uma reinicialização parcial do cluster, configure essa propriedade customizada como true para que o serviço do log de recuperação não se registre no HA Manager.

Os valores válidos são true e false.

O valor padrão é false.

com.ibm.ws.recoverylog.spi.NoMemoryMappedFiles

Use esta propriedade para fornecer uma melhoria de desempenho para o mapeamento de memória dos arquivos de log de transações, se os logs forem locais para o servidor de aplicativos.

Entretanto, se os logs de transações forem definidos em um sistema de arquivos remoto, o que é a situação típica ao ativar o suporte de Alta Disponibilidade (HA), quaisquer ganhos de desempenho são insignificantes. Além disso, o processamento do log é mais complexo. Devido a esta complexidade, em uma memória de ambiente de HA, desative o mapeamento dos logs de transações.

Para desativar os arquivos mapeados de memória, configure a propriedade customizada da JVM de com.ibm.ws.recoverylog.spi.NoMemoryMappedFiles como true em qualquer servidor que acesse os arquivos de log de recuperação. O valor padrão é false.
Remember: Por padrão, o mapeamento de memória dos logs de transações está desativado no sistema operacional z/OS e no sistema operacional Windows em um ambiente de HA.

com.ibm.ws.runtime.component.ResourceMgr.postBindNotify

Use essa propriedade para tornar Connection Factory MBeans disponível quando um adaptador de recursos for iniciado. Geralmente, quando um adaptador de recursos é iniciado, os Connection Factory MBeans não estão disponíveis para o adaptador de recursos a ser consultado. No entanto, alguns adaptadores de recursos, como o IMS DB Resource Adapter, requerem essa função para inicialização.

Se você não estiver usando um adaptador de recursos que requeira a disponibilidade dos Connection Factory MBeans na inicialização, inclua essa propriedade nas configurações da JVM e configure o valor como false.

O valor padrão é true.

com.ibm.ws.runtime.dumpShutdown

Há diferentes situações em que um dump de encadeamento é útil durante o encerramento do servidor. A seguir estão exemplos
  • Encerramento do servidor porque o agente do nó parou o servidor de interrupção.
  • Encerramento do servidor quando System.exit() é chamado a partir do código do aplicativo em execução no servidor.
  • Encerramento do servidor esporádico.
A propriedade customizada de diagnóstico com.ibm.ws.runtime.dumpShutdown permite acionar um dump de encadeamento principal Java durante o encerramento do servidor. Configure esta propriedade como true se desejar acionar um dump de encadeamento principal Java durante o encerramento do servidor. O valor padrão é false.

[AIX][Windows][Linux][z/OS]Para plataformas em que um IBM Software Development Kit é usado (AIX, Windows, Linux, z/OS), o dump de encadeamento principal Java é gerado no diretório ativo do servidor de aplicativos.

[Solaris][HP-UX]Para outras plataformas (Solaris, HP-UX), o dump de encadeamento de núcleo Java é gravado no arquivo native_stdout.log para o servidor de aplicativos.

Além do dump de encadeamento de núcleo Java, o rastreio de pilha do encadeamento atual que está processando o encerramento é impresso no SystemErr.log para o servidor de aplicativos.

[AIX Solaris HP-UX Linux Windows][IBM i]

com.ibm.ws.runtime.logThreadPoolGrowth

Os conjuntos de encadeamentos cujo crescimento é permitido são configurados com um tamanho máximo, mas podem aumentar em tamanho, além do máximo. Entretanto, não é emitida nenhuma mensagem indicando que o tamanho máximo foi excedido.

Configure essa propriedade como true se desejar que o servidor envie uma mensagem para o arquivo de log quando um conjunto de encadeamentos com crescimento permitido aumentar além do tamanho máximo configurado.

com.ibm.ws.scripting.apptimeout

Use esta propriedade para especificar, em segundos, a duração de tempo que pode decorrer antes que a instalação ou a atualização de um aplicativo tenha o tempo limite esgotado. O valor padrão é 86400, que é equivalente a 24 horas.

A especificação de um valor razoável para essa propriedade evita que o processo de instalação ou de atualização continue indefinidamente quando ocorrer um situação que impeça que o script de instalação ou de atualização seja concluído. Por exemplo, é possível ter um script JACL que atualiza um arquivo EAR que não pode ser concluído porque o gerenciador de implementação com o qual o script está conectado é parado.

com.ibm.ws.sib.webservices.useSOAPJMSTextMessages

Por padrão, no WebSphere Application Server Versão 6 ou mais recente, uma mensagem de serviço da web SOAP sobre JMS que é enviada pelo Web Services Gateway é enviada como JmsBytesMessage.

Configure esta propriedade como true para modificar o comportamento padrão e enviar uma JmsTextMessage compatível. A configuração dessa propriedade modifica o comportamento padrão para todas as chamadas de serviços da web JMS de saída enviadas a partir do barramento de integração de serviços.

Se você decidir usar essa propriedade customizada, deverá especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.soap.handleRST

Use esta propriedade se desejar que o servidor da web reconheça quando uma mensagem SOAP é lida e trate o elemento RequestSecurityToken (RST) como um tipo de mensagem FIN.

Em algumas instâncias, quando ocorre uma reconfiguração da conexão, um servidor da web é iniciado com a segurança desativada. No entanto, como um RST foi recebido no lugar do FIN/término do arquivo normal, uma mensagem de erro aparece no console administrativo indicando que o servidor da web falhou ao iniciar, embora o servidor da web tenha iniciado e esteja operacional. Uma atualização da página de console do servidor da web exibe o status operacional correto.

Se você configurar a propriedade customizada com.ibm.ws.soap.handleRST como true, seu servidor da web reconhecerá quando a mensagem SOAP completa tiver sido lida e tratará o RST como um FIN, e você não receberá uma mensagem de erro quando um RST for recebido.

com.ibm.ws.use602RequiredAttrCompatibility

Use a propriedade customizada com.ibm.ws.use602RequiredAttrCompatibility para especificar se o atributo <required> será avaliado antes de outros atributos no arquivo cachespec.xml.

Na Versão 6.0.2, se você configurar o atributo <required> como false, todos os outros atributos no arquivo cachespec.xml será ignorados e um ID de cache será gerado.

Para Usuários de Transição Para Usuários de Transição: Em versões mais recentes que a 6.0.2, por padrão, o atributo <required> é avaliado juntamente com todos os outros atributos para determinar se um ID do cache é gerado.trns
Nota: Se você configurar a propriedade customizada com.ibm.ws.use602RequiredAttrCompatibility como verdade, o comportamento do arquivo cachespec.xml é revertido para o comportamento na Versão 6.0.2. O atributo <required> é avaliado antes de outros atributos no arquivo cachespec.xml. O valor padrão é false.. Quando você configura essa propriedade customizada da JVM, que só se aplica no nível do servidor de aplicativos, ela afeta todos os usuários de cache dinâmico.

Se decidir usar esta propriedade customizada, especifique-a como uma propriedade customizada da JVM do servidor de aplicativos, a menos que seja indicado de outra forma dentro do contexto de uma tarefa específica.

com.ibm.ws.webcontainer.allowDefaultErrorPage

Use esta propriedade se seu arquivo web.xml contiver uma definição de página de erro que está de acordo com a Especificação de Servlet 3.0. A especificação Servlet 3.0 indica que somente o parâmetro <location> é obrigatório. Os parâmetros <error-code> e <exception-type> são opcionais. No entanto, se você não incluir essa propriedade nas configurações da JVM e configurá-la como true, uma página de erro definida somente com o parâmetro <location> será ignorada.

O valor padrão é false.

Se você usar esta propriedade, ela deverá ser configurada no nível do servidor de aplicativos.

com.ibm.ws.webservices.allowNoSOAPActionHeader

Use essa propriedade para ativar o mecanismo de serviços da web para tolerar uma solicitação de serviço da Web de entrada que não contenha um cabeçalho SOAPAction. Essa propriedade deve ser configurada no nível do servidor de aplicativos.

A especificação SOAP declara que uma mensagem de pedido de HTTP deve conter um campo de cabeçalho de SOAPAction HTTP com um valor de cadeia vazia citado, se na descrição de WSDL correspondente, a soapAction soapbind:operation não estiver presente ou estiver presente com uma cadeia vazia como seu valor. No entanto, se você desejar que o mecanismo de serviços da Web trate solicitações que não contenham um cabeçalho SOAPACTION, inclua essa propriedade nas configurações do servidor de aplicativos para defini-la como true.

Quando essa propriedade não for especificada ou não estiver configurada como verdade, se uma mensagem de pedido SOAP recebida não contiver um cabeçalho SOAPAction, uma Falha de SOAP será retornada ao cliente

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.webservices.allowStatusCode202OneWay

Use essa propriedade para permitir que um serviço unidirecional JAX-RPC envie um código de status 202 em vez de um código de status 200.

Um serviço unidirecional JAX-RPC implementado no WebSphere Application Server geralmente retorna um código de status HTTP 200. Algumas implementações JAX-RPC não podem tolerar um código de status 200, preferindo um 202 no lugar. De acordo com o Basic Profile Versão 1.1, os códigos de status 200 e 202 são válidos para serviços unidirecionais.

Se a propriedade for configurada como true, o serviço unidirecional JAX-RPC retornará um código de status 202.

O valor padrão é false.

Esta propriedade se aplica apenas à JVM do servidor de aplicativos.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.webservices.appendRootCauseToWSF

Se você for um usuário do JAX-RPC, use essa propriedade para especificar se deseja que os detalhes da Falha para uma exceção, que são retornados em uma resposta, contenham informações sobre a exceção original

Normalmente, os detalhes da Falha para uma exceção, que são retornados em uma resposta, contêm apenas informações sobre a exceção mais recente. Eles não contêm informações sobre a exceção original, que geralmente não é a exceção mais atual. Frequentemente, uma exceção aciona outras exceções antes de os detalhes da Falha serem retornados em uma resposta. Essa discrepância pode tornar a determinação de problema mais difícil para o usuário final se essa pessoa não tiver acesso aos logs do provedor de serviços.

Se o usuário final precisar estar apto a ver os detalhes da exceção para todas as exceções associadas a um problema, essa propriedade customizada deverá ser configurada como true para a JVM no servidor de aplicativos do provedor de serviços. Quando essa propriedade customizada é configurada como true no servidor de aplicativos do provedor de serviços, o servidor de aplicativos efetua loop em todas causas de exceção e concatena os detalhes de cada exceção nos detalhes da Falha que são retornados na resposta.

O valor padrão é false.

Se você decidir usar essa propriedade customizada, deverá especificá-la como uma propriedade customizada JVM para um servidor de aplicativos.

[z/OS]

com.ibm.ws.webservices.cacheEngineList

Em configurações do WebSphere Application Server para z/OS que usam serviços da web JAX-RPC, use essa propriedade para desativar o armazenamento em cache do mecanismo de serviços da web do cliente.

Se um aplicativo for reiniciado diversas vezes, o cache do mecanismo do cliente poderá preencher o armazenamento de sistema local, causando um erro de falta de memória. Quando esta propriedade for configurada para true, o cache do mecanismo será ativado. Configure esta propriedade para false para desativar o armazenamento em cache do mecanismo quando ocorrer este erro de falta de memória.

O valor padrão é true.

com.ibm.ws.webservices.contentTransferEncoding

Utilize essa propriedade para especificar um intervalo de bits para o qual a codificação por XML está desativada. Normalmente, qualquer inteiro maior que 127 é codificado por XML. Quando especificar essa propriedade:
  • Os serviços da web desativam a codificação para números inteiros que estão dentro do intervalo especificado.
  • A mensagem de transporte HTTP contém um cabeçalho ContentTransferEncoding que está configurado para o valor especificado para essa propriedade customizada.

Especifique 7bit, se desejar apenas inteiros maiores que 127 codificados. Especifique 8bit, se desejar apenas inteiros maiores que 255 codificados. Especifique binary, se desejar que a codificação seja desativada para todos os inteiros.

O valor padrão é 7bit.

Se você decidir usar essa propriedade customizada, deverá especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.webservices.disableSOAPElementLazyParse

Utilize esta propriedade para desativar a análise tardia de SOAPElements. A análise lenta é projetada para situações em que o cliente não esteja analisando o SOAPElement. Se um cliente estiver analisando SOAPElement com SAAJ, será melhor não atrasar a análise pelo componente de serviços da web.

É possível configurar essa propriedade como uma propriedade customizada JVM no nível do servidor ou do cliente. Quando essa propriedade está configurada no nível do servidor ou do cliente, a configuração se aplica a todos os aplicativos na JVM. O valor padrão é false.

Também é possível usar uma ferramenta do conjunto de aplicativos para especificar essa propriedade como uma nova entrada de ligação da descrição de serviço da Web para a ligação do componente da porta, se desejar desativar a análise lenta de SOAPElements em uma base aplicativo por aplicativo para um servidor específico, em vez de para todos os servidores gerenciados pelo gerenciador de implementação.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.webservices.engine.transport.jms.propagateOneWaySystemExceptions

Use essa propriedade para ativar exceções que ocorrem durante o processamento de um serviço da Web JMS unidirecional a ser propagado novamente no contêiner EJB. Essa propagação torna a recuperação de erro normal possível.

Se essa propriedade for definida como false, uma exceção será agrupada em uma mensagem WebServicesFault e enviada de volta ao cliente. Como o serviço da web não está ciente da exceção, não há tentativa de recuperação.

O valor padrão é false.

Evitar Problemas Evitar Problemas: Essa propriedade não se aplica a um serviço da Web HTTP unidirecional ou a solicitações JMS bidirecionais.gotcha

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.webservices.forceLegacyDispatchFromSOAPConnection

Use esta propriedade para especificar que o mecanismo JAX-RPC vai ser usado para processar solicitações realizadas para clientes SAAJ (SOAP with Attachments API for Java). ao invés do mecanismo JAX-WS.

Esta propriedade não se aplica a clientes de serviço da web que usam APIs JAX-RPC ou JAX-WS APIs para chamar serviços da web. Quando o mecanismo JAX-WS é usado para processar solicitações do cliente, o resultado pode ser diferente de quando o mecanismo JAX-RPC é usado. Por exemplo, alguns clientes SAAJ configuram o cabeçalho SOAPAction como um cabeçalho MIME, usando as APIs SAAJ. Quando o mecanismo JAX-RPC é usado para processar uma solicitação como essa, o cabeçalho SOAPAction, juntamente com se valor configurado pelo usuário, é enviado na solicitação. No entanto, se o mecanismo JAX-WS for usado para processar a mesma solicitação, será enviado um cabeçalho SOAPAction vazio na solicitação. Se você estiver acostumado a ter as solicitações do cliente do SAAJ de processo de mecanismo do JAX-RPC e desejar preservar este comportamento, inclua esta propriedade nas configurações da JVM e configure-a como true.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.webservices.HttpRedirectWithProxy

Configure essa propriedade como true para permitir que solicitações de redirecionamento HTTP sejam enviadas por meio do servidor proxy. Ao configurar essa propriedade como true, você altera o comportamento padrão de todas as solicitações de redirecionamento HTTP de saída enviadas a partir do tempo de execução JAX-RPC. Quando essa propriedade é configurada como false, uma solicitação de redirecionamento é enviada para um servidor remoto diretamente mesmo que um servidor proxy esteja configurado.

O valor padrão é false.

Se você decidir usar essa propriedade customizada, deverá especificá-la como uma propriedade customizada JVM do servidor proxy.

com.ibm.ws.webservices.ignoreUnknownElements

Utilize essa propriedade para controlar se os clientes podem ignorar elementos XML extras que às vezes são localizados dentro de repostas de operação SOAP literais.

Configurar essa propriedade como true oferece a flexibilidade de poder atualizar o código do servidor para incluir mais informações de resposta, sem precisar atualizar imediatamente o código do cliente para processar essas informações adicionais. No entanto, quando essa função é ativada, a verificação da mensagem SOAP na estrutura da mensagem esperada é mais tranquila do que quando essa propriedade é configurada como false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.webservices.jaxrpc.parse.tolerate.invalid.namespace

Use essa propriedade para ativar o mecanismo JAX-RPC para usar um algoritmo mais tolerante ao determinar se deve-se aceitar uma mensagem de JAX-RPC recebida.

Normalmente, se uma mensagem de JAX-RPC recebida usa um namespace inválido para um elemento de corpo, o mecanismo JAX-RPC rejeita a mensagem. Se você configurar essa propriedade como true, o mecanismo JAX-RPC usa um algoritmo mais tolerante que ignora a incompatibilidade do namespace.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.webservices.resolveXMLSchemaDTD

Use essa propriedade customizada para ativar um aplicativo JAX-RPC para iniciar adequadamente mesmo se o esquema ou o arquivo WSDL que está representado na classe _AbsoluteImportResolver também fizer referência à DTD http://www.w3.org/2001/XMLSchema.dtd.

Quando você executar em um host que não esteja conectado à Internet, um aplicativo JAX-RPC que está empacotado com a classe _AbsoluteImportResolver poderá não ser iniciado adequadamente. O erro a seguir poderá existir nos arquivos de log:
WSDDPort      W com.ibm.ws.webservices.engine.deployment.wsdd.WSDDPort expand 
WSWS3114E: Erro: Erro interno.
java.net.UnknownHostException: www.w3.org

Configurar essa propriedade customizada como true ativa um aplicativo JAX-RPC para iniciar adequadamente mesmo se o esquema ou o arquivo WSDL que está representado na classe _AbsoluteImportResolver também fizer referência à DTD http://www.w3.org/2001/XMLSchema.dtd.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.webservices.searchForAppServer

Use essa propriedade para controlar se as mensagens DualMetaDataLoaderImpl E loadWebContainerPorts não puderam localizar nenhuma porta de http ou https são enviadas para o log do sistema.

Dependendo da configuração do sistema, se um aplicativo de serviços da web estiver instalado em um servidor da Web ou em um servidor de aplicativos, seu sistema poderá emitir essa mensagem, indiciando que ocorreu um erro embora esta seja uma configuração válida. Portanto, se você instalar algum de seus aplicativos de serviços da web em um servidor da web e em um servidor de aplicativos, talvez não queira que essas mensagens sejam enviadas para o log do sistema.

Se a propriedade com.ibm.ws.webservices.searchForAppServer estiver configurada como true, qualquer mensagem DualMetaDataLoaderImpl E loadWebContainerPorts não puderam localizar nenhuma porta de http ou https que for emitida não será enviada para o log do sistema. Se essa propriedade não estiver especificada ou estiver configurada como false, essas mensagens são enviadas para o log do sistema.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.webservices.serialize.2DimArray.asArrays

Use essa propriedade para fazer com que o tempo de execução JAX-RPC serialize matrizes XML bidimensionais como uma série de matrizes.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

O valor padrão é false.

O fragmento de mensagem a seguir ilustra uma série de elementos, que é um formato válido para representar matrizes XML bidimensionais quando essa propriedade é configurada como false.

<p565:sayHelloResponse xmlns:p565="http://ibm.com">
    <sayHelloReturn xsi:type="soapenc:Array" 
soapenc:arrayType="xsd:string[2,3]">
      <item xsi:type="xsd:string">array1 element1</item>
      <item xsi:type="xsd:string">array1 element2</item>
      <item xsi:type="xsd:string">array1 element3</item>
      <item xsi:type="xsd:string">array2 element1</item>
      <item xsi:type="xsd:string">array2 element2</item>
      <item xsi:type="xsd:string">array2 element3</item>
    </sayHelloReturn>
  </p565:sayHelloResponse>

O fragmento de mensagem a seguir ilustra uma matriz de duas matrizes, com cada matriz contendo três elementos, que é um formato válido para representar matrizes XML bidimensionais quando essa propriedade é configurada como true.

<p565:sayHelloResponse xmlns:p565="http://ibm.com">
    <sayHelloReturn xsi:type="soapenc:Array" 
soapenc:arrayType="xsd:string[][2]">
      <item soapenc:arrayType="xsd:string[3]">
         <item>array1 element1</item>
         <item>array1 element2</item>
         <item>array1 element3</item>
      </item>
      <item soapenc:arrayType="xsd:string[3]">
         <item>array2 element1</item>
         <item>array2 element2</item>
         <item>array2 element3</item>
      </item>
    </sayHelloReturn>
  </p565:sayHelloResponse>

com.ibm.ws.webservices.serializeDetailElementUsingDefaultNamespace

Use essa propriedade para especificar se o servidor de aplicativos usa um nome de prefixo real para localizar o namespace que define o detalhe da Falha ou usa um namespace padrão para definir o detalhe da Falha.

Quando um serviço da Web do JAX-RPC responde com uma falha de SOAP, geralmente é usado um nome de prefixo real para localizar o namespace que define o conteúdo do detalhe da Falha. A seguir, é mostrado um exemplo da mensagem que o servidor de aplicativos geralmente emite nessa situação:

<soapenv:Fault                                      
      xmlns:soapenv=
      "http://schemas.xmlsoap.org/soap/envelope/">      
  <faultcode xmlns="http://sample">       
     sampleFault                          
  </faultcode>                                              
  <faultstring>sample text</faultstring>                      
  <detail encodingStyle="">                                
    <sampleFault                        
      xmlns="http://sample"> 
      ...
    </sampleFault>
  </detail>
<soapenv:Fault>   

Se o servidor de aplicativos precisar se comunicar com os clientes .Net e esses clientes .Net exigirem o uso de um namespace padrão para definir o conteúdo do detalhe da Falha, configure essa propriedade como true. Quando esta propriedade é configurada como true, a mensagem que o servidor de aplicativos emite é semelhante à mensagem que foi enviada de uma versão anterior a um servidor de aplicativos da Versão 6.x.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.webservices.suppressHTTPRequestPortSuffix

Utilize essa propriedade para controlar se um número de porta pode ser mantido em um pedido HTTP POST que envia uma mensagem SOAP.

Algumas implementações de serviço da Web não toleram adequadamente a presença de um número de porta na solicitação POST de HTTP que envie a mensagem SOAP. Se você tiver um cliente de serviço da web que precise interoperar com um serviço da web que não possa tolerar um número de porta em uma solicitação de POST de HTTP que envie uma mensagem SOAP, configure essa propriedade customizada como true.

Ao definir essa propriedade como true, o número da porta será removido do pedido HTTP POST antes de enviá-lo.

Evitar Problemas Evitar Problemas: Deve-se reiniciar o servidor antes que essa definição de configuração entre em vigor.gotcha

O valor padrão é false.

Se você decidir usar esta propriedade customizada, deverá especificá-la como uma propriedade customizada da JVM do servidor de aplicativos.

com.ibm.ws.websvcs.attachments.sizethreshold

Use essa propriedade para especificar, em bytes, o tamanho máximo do anexo no serviço ou cliente JAX-WS que pode ser gravado na memória. Por padrão, o tamanho máximo do anexo é configurado para 11 MB. Com esse valor, se um anexo exceder 11 MB, ele será armazenado em cache no sistema de arquivos em vez de gravado na memória. Ao usar essa propriedade customizada, à medida que aumenta o tamanho máximo do cache, há um impacto maior no desempenho e, possivelmente, no heap Java.

Nota: Para especificar o tamanho máximo de um anexo no serviço ou cliente JAX-RPC, consulte a propriedade customizada com.ibm.websphere.webservices.attachements.maxMemCacheSize.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.websvcs.getJAXBContext.cacheClassList

Use esta propriedade para armazenar em cache uma lista de classes Java Architecture for XML Binding (JAXB) contidas em um pacote.

Geralmente, ao construir um JAXBContext, se um pacote não contém um arquivo de classe ObjectFactory ou package-info, o pacote é procurado por todas as classes JAXB em potencial. Este processo de procura pode ser demorado e pode ser atrasado pelo bloqueio do arquivo JAR. Configure esta propriedade para true para armazenar em cache a lista de classe para cada pacote, eliminando a necessidade de procuras subsequentes do mesmo pacote. Solicitações de criação de JAXBContext posteriores recuperam a versão em cache da lista de classes em vez de iniciar uma nova procura.

Como o cache da lista de classes é criado usando uma SoftReference, o cache pode ser liberado se a memória disponível se torna baixa.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.websvcs.getJAXBContext.cacheClassList.persist

Use essa propriedade para criar um cache em disco das classes do Java Architecture for XML Binding (JAXB) contidas em um pacote.

Geralmente, ao construir um JAXBContext, se um pacote não contiver um ObjectFactory ou um arquivo de classe package-info, no pacote serão procuradas todas as possíveis classes JAXB. Este processo de procura pode ser demorado e pode ser atrasado pelo bloqueio de arquivo JAR. Configure esta propriedade para true para criar um cache de disco da lista de classes para cada pacote, eliminando a necessidade de procuras subsequentes do mesmo pacote. Solicitações de criação de JAXBContext posteriores recuperam a versão em cache da lista de classes em vez de iniciar uma nova procura.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.websvcs.logOperationExceptionAsDebug

As exceções de falha de SOAP são sempre gravadas usando o log.error, que é gravado no SystemOut.log e também no Trace.log. Use essa propriedade para assegurar que as exceções de falha de SOAP sejam registradas SOMENTE no Trace.log quando o rastreio estiver ativado e NÃO no SystemOut.log. A propriedade não distingue o tipo de exceções de falha de SOAP registradas no SystemOut.log.

Note: As exceções de falha de SOAP somente são vistas no Trace.log quando os rastreios de serviços da web estão ativados e quando com.ibm.ws.websvcs.logOperationExceptionAsDebug=true.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.websvcs.suppressHTTPRequestPortSuffix

Utilize esta propriedade para evitar que o tempo de execução do JAX-WS anexe o número da porta ao valor do cabeçalho Host HTTP para um pedido.

Um cliente JAX-WS pode receber java.io.IOException em resposta a uma solicitação, especialmente se houver um serviço da Web não IBM localizado entre o cliente e o serviço da Web que o cliente está tentando chamar. Esse servidor intermediário pode não entender para onde rotear o pedido, pois o tempo de execução do JAX-WS anexou o número da porta ao valor do cabeçalho Host HTTP. Por exemplo, o tempo de execução do JAX-WS pode ter alterado o valor do cabeçalho da URL de terminal lilygirl.austin.mycompany.com para a URL lilygirl.austin.mycompany.com:80, que inclui o número da porta.

Para evitar que o tempo de execução do JAX-WS anexe o número da porta ao valor do cabeçalho Host HTTP, inclua essa propriedade customizada nas configurações de JVM e configure-a como true. Quando essa propriedade for configurada como true, o cabeçalho do Host conterá apenas o nome do host da URL do terminal como, por exemplo, Host: lilygirl.austin.mycompany.com

O valor padrão para essa propriedade é false, o que significa que o número da porta é anexado ao valor do cabeçalho Host.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.websvcs.transport.enableProxyTunnel

Configure essa propriedade como true para permitir que o cliente de serviços da web acesse recursos por meio de um servidor proxy da web. A configuração padrão para essa propriedade é false, o que indica que o tunelamento não deve ser usado na camada de transporte de serviços da web para proxies.
Exemplo: Deixando a configuração padrão como false, um cliente de serviço da web JAX-WS que tentar chamar um serviço da web remoto sobre HTTPS receberá uma exceção quando a chamada for direcionada por meio de um servidor HTTP configurado como um proxy de encaminhamento.

O valor padrão é false.

Se você decidir usar essa propriedade customizada, deverá especificá-la como uma propriedade customizada da JVM do servidor proxy.

com.ibm.ws.websvcs.relaxClientPolsetMatching

Use essa propriedade para permitir que conjuntos de políticas do lado do cliente JAX-WS sejam aplicados no nível de serviço ou inferior por meio do console administrativo quando o código do cliente abranger mais de um archive.

O valor padrão é false.

com.ibm.ws.websvcs.transport.jms.enableBasicAuthOnResponse

Use essa propriedade para especificar se o ID do usuário e a senha de autorização básica do conjunto de políticas JMS serão aplicados a mensagens de resposta JMS. Por padrão, o ID do usuário e a senha de autorização básica do conjunto de políticas JMS não são aplicados a mensagens de resposta JMS.

Se você incluir essa propriedade em suas configurações de JVM e especificar true como o valor dessa propriedade, o ID do usuário e a senha de usuário básica do conjunto de políticas JMS serão aplicados a mensagens de resposta JMS. Se essa propriedade for configurada como false, nem o ID do usuário nem a senha serão aplicados.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.websvcs.unifyServiceMessage

Configure essa propriedade como true para que os aplicativos JAX-WS exibam a mensagem do JAX-RPC, "Hi there, this is a Web service!", em uma janela do navegador em vez da mensagem específica do JAX-WS, "Hello! This is an Axis2 Web Service!" quando uma URL de serviço for inserida em um navegador.

O valor padrão é false.

com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri

Talvez você queira que um pedido de um serviço do cliente JAX-WS não gerenciado seja enviado à URL de terminal que está especificada no campo URL de Terminal Substituído no console administrativo. O valor desse campo gerenciado, que é configurado como parte da configuração da porta dos serviços da Web, substitui o terminal que foi especificado no arquivo WSDL especificado. Para obter mais informações sobre esse campo, leia sobre a porta do cliente de serviços da web.

Evitar Problemas Evitar Problemas: Se você tiver todos os clientes gerenciados ou uma mistura de clientes gerenciados e não gerenciados, pode editar o campo URL de Terminal Substituído no console administrativo. No entanto, se você não tiver nenhum cliente gerenciado, não poderá editar o campo.gotcha

Normalmente, você não deseja que um serviço do cliente JAX-WS não gerenciado acesse essa função do serviço do cliente gerenciado. No entanto, é possível depender de serviços do cliente JAX-WS não gerenciado que acessam essa URL. Por padrão, a propriedade customizada com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri é configurada como falsa para permitir aos serviços do cliente JAX-WS gerenciado acessarem a URL de terminal que sobrescreve o terminal no arquivo WSDL.

Essa propriedade customizada é configurada no nível do servidor de aplicativos em que um cliente JAX-WS está instalado ou um cliente Java EE existe se você executar o launchClient.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

com.ibm.ws.ws.wsba.protocolmessages.twoway

Utilize essa propriedade para melhorar o desempenho de um servidor de aplicativos que esteja manipulando pedidos para o WS-BA (Web Services Business Activities). A especificação de true para essa propriedade customizada melhora o desempenho do servidor de aplicativos quando as mensagens de protocolo WS-BA são enviadas entre dois servidores de aplicativos. O valor padrão é true.

Evitar Problemas Evitar Problemas: Se você decidir utilizar essa propriedade customizada, a propriedade deverá ser definida no servidor de aplicativos que inicia os pedidos. Ela não precisa ser definida no servidor de aplicativos que recebe os pedidos.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

gotcha
[z/OS]

com.ibm.ws390.SystemOutErrCodepage

Use essa propriedade customizada para especificar um esquema de codificação para mensagens emitidas usando System.out e System.err com os métodos println, print e write diferente de EBCDIC. Se nenhum esquema de codificação for especificado, EBCDIC, que é o esquema de codificação padrão, será usado para essas mensagens.

O valor especificado para essa propriedade deve estar no formato de sequência.

Se você decidir usar essa propriedade customizada, deverá especificá-la como uma propriedade customizada JVM para o servidor.

com.ibm.wsspi.amm.merge.ignoreValidationExceptions

Use essa propriedade customizada para indicar à JVM que ela deve ignorar exceções de validação que podem ocorrer durante o processamento de EJB. Quando um aplicativo é configurado com as classes necessárias definidas em bibliotecas compartilhadas durante o processamento de EJB, informações incompletas podem ser geradas. Como resultado, uma exceção de validação pode ocorrer e a mensagem de exceção a seguir pode aparecer:
AnnotativeMetadataManagerImpl merge Capturada exceção ao mesclar com.ibm.wsspi.amm.validate.ValidationException: 
a interface com.xyz.app.myappRemote não define uma
interface de negócios remota válida; o método mygetMethod não
está em conformidade com as regras de RMI.

Configure essa propriedade como true se desejar que a JVM ignore essas exceções de validação.

O valor padrão é false.

Se você decidir usar essa propriedade customizada, deverá especificá-la como uma propriedade customizada JVM para o servidor de aplicativos.

com.ibm.wsspi.wssecurity.dsig.enableEnvelopedSignatureProperty

Use esta propriedade customizada para indicar ao JVM que você deseja que o tempo de execução WS-Security verifique uma Assinatura Digital XML da mesma maneira que ele fazia nas Versões 7.0.0.21 e anteriores, e 8.0.0.3 anteriores.

Evitar Problemas Evitar Problemas: Esta propriedade deve ser configurada somente para true se o ambiente incluir uma célula que possuir servidores de aplicativos em níveis diferentes de fix pack e se estiver encontrando problemas de compatibilidade.gotcha
Em Versões 7.0.0.21 e anteriores, e 8.0.0.3 e anteriores, quando o WS-Security verifica uma Assinatura XML Digital que usa o algoritmo de conversão http://www.w3.org/2000/09/xmldsig#enveloped-signature e o elemento assinado possui atributos com um prefixo de namespace, uma mensagem de erro, Incompatibilidade de valor de Compilação, semelhante à mensagem de erro a seguir, poderá ocorrer:
SAML Assertion signature is verified.Core validity=false
Signed info validity=true Signed info
message='null'(validity=false message='Digest value mismatch:
calculated: KCuNwlUAk5+G2PYb8fZ+Y1hTMtw='
uri='#Assertion-1234' type='null')

Se um elemento a ser assinado contiver um atributo com um prefixo de namespace, o tempo de execução de WS-Security canonicalizará o elemento antes de calcular o valor de compilação.

Nesta versão do produto e nas Versões 7.0.0.23 e superior e 8.0.0.4 e superior, o tempo de execução do WS-Security manipula adequadamente os atributos de elemento com prefixos de namespace.

Evitar Problemas Evitar Problemas:
  • Se você configurar esta propriedade para true, será preciso também especificar a seguinte propriedade customizada de WS-Security como uma propriedade customizada de Entrada, Saída, ou Entrada e Saída para as ligações de configuração da política de WS-Security:
    com.ibm.wsspi.wssecurity.dsig.oldEnvelopedSignature=true
  • Se você configurar esta propriedade para true, e estiver usando o SAMLTokenFactory para criar o token de SAML, inclua a seguinte propriedade para o arquivo SAMLIssuerConfig.properties:
    com.ibm.wsspi.wssecurity.dsig.oldEnvelopedSignature=true
gotcha

Se você decidir usar essa propriedade customizada, deverá especificá-la como uma propriedade customizada JVM para o servidor de aplicativos.

com.ibm.xml.xlxp.jaxb.opti.level

Use a propriedade customizada com.ibm.xml.xlxp.jaxb.opti.level para controlar se os métodos de otimização são ativados para desserialização e serialização da Java Architecture para XML Binding (JAXB). A tabela a seguir lista os valores suportados para essa propriedade customizada e seus efeitos em aplicativos e serviços da web.
Tabela 2. Valores Suportados para a Propriedade Customizada. A tabela inclui o valor da propriedade customizada e o efeito da propriedade customizada nos aplicativos e nos serviços da web.
Valor da propriedade customizada Efeito
com.ibm.xml.xlxp.jaxb.opti.level=0 Métodos de otimização não são ativados.
com.ibm.xml.xlxp.jaxb.opti.level=1 Apenas métodos de otimização de desserialização são ativados.
com.ibm.xml.xlxp.jaxb.opti.level=2 Apenas métodos de otimização de serialização são ativados.
com.ibm.xml.xlxp.jaxb.opti.level=3 Métodos de otimização de desserialização e serialização são ativados, que é o valor padrão.

Para excelente desempenho, configure a propriedade customizada como 3. Esse valor aumenta o rendimento para serviços da web e aplicativos que usam o JAXB diretamente. Se você estiver tendo problemas com a otimização após configurar esse valor, altere o valor para 0 como uma solução alternativa temporária.

É possível configurar essa propriedade customizada apenas no nível do servidor de aplicativos.

com.ibm.xml.xlxp2.api.util.encoding.DataSourceFactory.bufferLength

A configuração desta propriedade customizada da JVM com um valor menor, tal como 2048, pode reduzir o uso de memória se os buffers de 64 KB (o padrão) estão preenchidos apenas parcialmente pelo InputStream quando estão em uso. Os buffers são armazenados em cache no analisador de XML com/ibm/xml/xlxp2/api/wssec/WSSXMLStreamReader. Uma redução no uso da memória reduz a memória geral vinculada a cada objeto analisador.

com.ibm.xml.xlxp2.api.util.Pool.STRONG_REFERENCE_POOL_MAXIMUM_SIZE

O valor desta propriedade de sistema é um número inteiro e, quando configurado, ele limita o número de XMLStreamReaders e XMLStreamWriters que são armazenados em cache usando referências fortes.

Para evitar um OutOfMemoryError, configure a propriedade do sistema para 0. Isso força todos os XMLStreamReaders a serem armazenados em cache usando SoftReferences e permite que o coletor de lixo recupere a memória que ocupam no cache a qualquer momento.

Quando esta propriedade de sistema não está configurada, seu valor padrão é 10.

config_consistency_check

Use essa propriedade para desativar opcionalmente o processo de consistência da área de trabalho padrão. O gerenciador de implementação mantém um repositório de configuração principal para a célula inteira. Por padrão, quando a configuração é alterada, o produto compara a configuração na área de trabalho com o repositório principal para manter a consistência da área de trabalho. No entanto, o processo de verificação da consistência pode causar um aumento no tempo para salvar uma mudança na configuração ou para implementar uma grande quantidade de aplicativos. Os seguintes fatores influenciam quanto tempo é necessário:
  • Quanto mais servidores de aplicativos ou clusters são definidos em uma célula, mais tempo se leva para salvar uma alteração na configuração.
  • Quanto mais aplicativos são implementados em uma célula, mais tempo se leva para salvar uma mudança na configuração.

Se a quantidade de tempo necessária para fazer uma alteração de configuração não for satisfatória, é possível incluir a propriedade customizada config_consistency_check nas configurações da JVM e definir o valor dessa propriedade como false.

Configurações suportadas Configurações suportadas: A propriedade customizada config_consistency_check afeta apenas o processo do gerenciador de implementação. Ela não afeta outros processos incluindo o agente do nó e processos do servidor de aplicativos. A verificação de consistência não é executada nesses processos. Entretanto, dentro dos arquivos SystemOut.log para esses processos, você poderá ver uma nota de que a verificação de consistência está desativada. Para esses processos do gerenciador de não implementação, você poderá ignorar essa mensagem.sptcfg

deactivateWildCardURIMapping

Use essa propriedade para ativar o gerador do arquivo plug-in-cfg.xml para reconhecer os padrões de URI especificados no atributo file.serving.patterns.allow no arquivo ibm-web-ext.xmi de um aplicativo da Web.

O gerador de arquivo plugin-cfg.xml somente reconhece os padrões de URI especificados no atributo file.serving.patterns.allow se o atributo FileServingEnabled nesse arquivo ibm-web-ext.xmi estiver configurado como true. No entanto, quando o atributo FileServingEnabled estiver configurado como verdade, o gerador de arquivo plug-in-cfg.xml automaticamente inclui o mapeamento de URI curinga, /* , para o arquivo plug-in-cfg.xml, que nega a utilidade de definir padrões de serviço de arquivo exclusivos.

Configurar a propriedade deactivateWildCardURIMapping como true impede que o gerador de arquivo plugin-cfg.xml inclua o arquivo /* no arquivo plugin-cfg.xml e ativa o gerador de arquivo plugin-cfg.xml para reconhecer os padrões de URI especificados no atributo file.serving.patterns.allow. Se essa propriedade não estiver incluída nas configurações da JVM ou estiver configurada como false, o /* é automaticamente incluído no arquivo plugin-cfg.xml.

Essa propriedade é configurada no nível do gerenciador de implementação.

DISABLE_LOCAL_COMM_WHEN_SSL_REQUIRED

Especifica se localComm ou SSL deve ser usado quando o nível de transporte SSL é suportado no lado do cliente ou servidor e é requerido no outro lado.

localComm não deve ser usado quando o nível de transporte SSL é suportado no lado do cliente ou servidor e é requerido no outro lado. Nesta situação, você deve configurar esta propriedade customizada como true para assegurar que SSL seja usado no lugar de localComm.

O valor padrão para essa propriedade é falso, o que significa que localComm será usado.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

Quando você especifica essa propriedade para um servidor de aplicativos:
  • A configuração de transporte Entrada CSIv2 deve ser configurada como Suportado pelo SSL ou Requerido pelo SSL. Consulte o tópico Configurando Transportes de Entrada para obter mais informações sobre estas configurações.
  • No lado do cliente, a propriedade com.ibm.CORBA.loginSource no arquivo sas.client.props deve ser configurada como none.
  • Uma das configurações a seguir deve estar no local no lado do cliente:
    • com.ibm.CSI.performTransportAssocSSLTLSRequired=true
    • com.ibm.CSI.performTransportAssocSSLTLSSupported=true

    Ou, se um servidor do WebSphere estiver atuando como o cliente, a configuração de transporte de Entrada do CSIv2 deve ser configurado para Suportado por SSl ou Solicitado por SSL nesse servidor.

disableWSAddressCaching

Use essa propriedade para desativar o cache de endereços para serviços da web. Se o seu sistema geralmente executar com muitos encadeamentos de cliente e você encontrar contenção de bloqueio no cache wsAddrCache, será possível configurar essa propriedade customizada como true para evitar o armazenamento em cache dos dados dos serviços da web.

Se você especificar networkaddress.cache.ttl com um valor igual a zero ou qualquer outro número inteiro positivo, esta propriedade deverá ser configurada como true, para evitar o armazenamento em cache de um endereço IP no mecanismo de serviço da web. Networkaddress.cache.ttl é usado para indicar o número de segundos para armazenar em cache uma consulta bem-sucedida.

O valor padrão é false.

DRS_BATCH_INTERVAL_SIZE

Especifica o número máximo de objetos que podem ser incluídos em um lote de dados da sessão HTTP replicados pelo Data Replication Service (DRS). Se houver menos que o número especificado de objetos nos dados da sessão HTTP sendo replicados, todos os dados da sessão serão replicados em um único lote.

Por padrão, o DRS replica 50 objetos de dados da sessão HTTP em um lote. Como a serialização de uma mensagem grande pode causar condição de falta de memória, você talvez queira incluir um número menor de objetos em cada lote, especialmente se tiver servidores de aplicativos que se unem a domínios de replicação estabelecidos totalmente preenchidos.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

DRS_THREADPOOL_MINSIZE

Especifica o número mínimo de encadeamentos permitidos no conjunto de encadeamentos do serviço de replicação de dados (DRS).

Quando um servidor de aplicativos é iniciado, os encadeamentos não são inicialmente designados ao conjunto de encadeamentos. Os encadeamentos são incluídos no conjunto de encadeamentos à medida que a carga de trabalho designada ao servidor de aplicativos precisar deles, até que o número de encadeamentos no conjunto seja igual ao número especificado por essa propriedade customizada. Após esse momento, encadeamentos adicionais serão incluídos e removidos à medida que a carga de trabalho for alterada. No entanto, o número de encadeamentos no conjunto nunca diminui abaixo do número especificado por essa propriedade customizada, mesmo se alguns dos encadeamentos estiverem inativos.

O valor padrão para essa propriedade customizada é 40 encadeamentos.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

DRS_THREADPOOL_MAXSIZE

Especifica o número máximo de encadeamentos a serem mantidos no conjunto de encadeamentos do DRS.

O valor padrão para essa propriedade customizada é 100 encadeamentos.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

DRS_THREADPOOL_ISGROWABLE

Especifica se o número de encadeamentos pode aumentar acima do tamanho máximo configurado para o conjunto de encadeamentos do DRS.

O número máximo de encadeamentos que podem ser criados está restrito somente dentro dos limites da Java Virtual Machine e do sistema operacional. Quando um conjunto de encadeamentos passível de crescimento ultrapassa o tamanho máximo, os encadeamentos adicionais não são reutilizados e são descartados do conjunto depois que o processamento dos itens de trabalho para os quais eles foram criados é concluído.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

dynacache.jms.cacheInstance

Quando a invalidação do grupo de multicélulas e de multinúcleos de serviço de cache dinâmico estiver ativada, use essa propriedade para especificar a instância de cache para usar para processar invalidações. Configurar essa propriedade como "*" faz IDs de invalidação ser processados em todas as instâncias de cache. Essa propriedade deve ser configurada nos servidores de barramento de integração de serviços.

Por padrão, a instância de cache baseCache é usada. É possível usar o console administrativo para determinar os nomes das instâncias de cache que são definidas para o seu sistema.

Se decidir usar esta propriedade customizada, especifique-a como uma propriedade customizada da JVM do servidor de aplicativos, a menos que seja indicado de outra forma dentro do contexto de uma tarefa específica.

dynacache.jms.connRetryInterval

Quando a invalidação do grupo de multicélulas e de multinúcleos de serviço de cache dinâmico estiver ativada, use essa propriedade para especificar o número de segundos que um membro de cluster aguarda antes de tentar reconectar-se a um servidor de barramento de integração de serviços.

O valor-padrão para essa propriedade é 30.

Se decidir usar esta propriedade customizada, especifique-a como uma propriedade customizada da JVM do servidor de aplicativos, a menos que seja indicado de outra forma dentro do contexto de uma tarefa específica.

dynacache.jms.invProcessingDelay

Quando a invalidação do grupo de multicélulas e de multinúcleos de serviço de cache dinâmico estiver ativada, use essa propriedade para especificar o número de segundos que o servidor de barramento de integração de serviços enfileira IDs de invalidação antes de processá-los.

O valor-padrão para essa propriedade é 20.

Se decidir usar esta propriedade customizada, especifique-a como uma propriedade customizada da JVM do servidor de aplicativos, a menos que seja indicado de outra forma dentro do contexto de uma tarefa específica.

dynacache.jms.numStoredInvalidations

Quando a invalidação do grupo de multicélulas e de multinúcleos de serviço de cache dinâmico estiver ativada, use essa propriedade para especificar o número máximo de IDs de invalidação que um membro de cluster pode armazenar enquanto aguarda um servidor de barramento de integração de serviços se tornar disponível. Após o limite ser atingido, os IDs de invalidação mais antigos são removidos conforme novos IDs são incluídos.

O valor-padrão para essa propriedade é 10000.

Se decidir usar esta propriedade customizada, especifique-a como uma propriedade customizada da JVM do servidor de aplicativos, a menos que seja indicado de outra forma dentro do contexto de uma tarefa específica.

[z/OS]

invocationCacheSize

Utilize essa propriedade para controlar o tamanho do cache de chamada. O cache de chamada contém informações para mapear URLs de pedido para recursos de servlet. Um cache de tamanho solicitado é criado para cada worker thread disponível para processar um pedido. O tamanho padrão do cache de chamada é 50. Se mais de 50 URLs exclusivas estiverem sendo utilizadas ativamente (cada JavaServer Page é uma URL exclusiva), você deve aumentar o tamanho do cache de chamada.

Um cache maior utiliza mais do heap Java, portanto, talvez você precise aumentar também o tamanho máximo do heap Java. Por exemplo, se cada entrada de cache exigir 2KB, o tamanho máximo de encadeamento será definido como 25, e o tamanho de cache de chamada de URL será 100; então, 5MB de heap Java serão necessários.

É possível especificar qualquer número maior do que 0 para o tamanho do cache. Configurar o valor para zero desativa o cache de chamada.

[AIX Solaris HP-UX Linux Windows][IBM i]

java.net.preferIPv4Stack

Utilize essa propriedade para desativar o suporte ao IPv6. Em sistemas operacionais em que o suporte ao IPv6 está disponível, o soquete nativo subjacente que o produto utiliza é um soquete IPv6. Em pilhas de rede IPv6 que suportam endereços mapeados IPv4, é possível utilizar soquetes IPv6 para conectar e aceitar conexões de hosts IPv4 e IPv6.

Configurar essa propriedade para true desativa o modo de suporte duplo na JVM que poderá, por sua vez, corromper as funções normais do produto. Assim, é importante entender todas as implicações antes de utilizar essa propriedade. Em geral, a configuração dessa propriedade não é recomendada.

O valor padrão para esta propriedade customizada é false, exceto nos sistemas operacional Microsoft Windows onde o padrão é true.

[AIX Solaris HP-UX Linux Windows][IBM i]

java.net.preferIPv6Addresses

Utilize essa propriedade para desativar o suporte ao IPv4. Configurar essa propriedade para true desativa o modo de suporte duplo na JVM que poderá, por sua vez, corromper as funções normais do produto. Assim, é importante entender todas as implicações antes de utilizar essa propriedade. Em geral, a configuração dessa propriedade não é recomendada.

O valor padrão para essa propriedade customizada é false, exceto no sistema operacional Windows, em que o padrão é true.

java.util.logging.configureByLoggingPropertiesFile

Use essa propriedade customizada para especificar se a JVM usa o arquivo logging.properties para configurar a criação de log JSR-47.

Se essa propriedade não for incluída nas definições de configuração da JVM ou se estiver configurada como false, as definições de configuração contidas no arquivo logging.properties não são coletadas porque o produto substitui a configuração base de criação de log JSR47 com a configuração de propriedade de sistema java.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager. Nesta situação, somente as configurações de criação de log que podem ser alteradas programaticamente, como a inclusão de manipuladores e formatadores, podem ser modificadas.

Quando essa propriedade está configurada como true, a JVM ainda configura o WsLogManager como o LogManager, mas durante a inicialização do servidor, a configuração de criação de log para aplicativos que usam a criação de log JSR-47 é inicializada com base em configurações no arquivo logging.properties. Consulte a documentação da API do Java Utility Logging para obter propriedades válidas de criação de log e o formato que pode ser especificado no arquivo de configuração logging.properties.
Evitar Problemas Evitar Problemas: Não designe java.util.logging.ConsoleHandler a nenhum dos criadores de logs, porque essa designação pode causar um loop infinito.gotcha

[AIX Solaris HP-UX Linux Windows][IBM i]O arquivo logging.properties encontra-se no diretório <<WAS_install>>/java/jre/lib/logging.properties, e pode ser customizado conforme necessário.

[z/OS]O arquivo logging.properties está localizado no diretório <<WAS_install>>/java/J*/lib/logging.properties e pode ser customizado conforme necessário.

O valor padrão é false.

jaxws.asyncClient.maxThreadPoolSize

Use esta propriedade para limitar o número de encadeamentos em execução simultânea para solicitações do cliente assíncronas para JAX-WS.

Por padrão, o número de encadeamentos não é limitado.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

jaxws.handler.reducecaching

Use esta propriedade para garantir que os manipuladores de JAX-WS atualizem corretamente mensagens SOAP.

Mensagens SOAP atualizadas por um manipulador de JAX-WS parecerão corretas quando efetuado dump no manipulador. mas quando uma mensagem for enviada, as mudanças estarão ausentes. Configure esta propriedade para true se o seu manipulador chamar getMessage() diversas vezes e as mensagens forem perdidas.

Evitar Problemas Evitar Problemas: Esta propriedade não é compatível com a modificação dos cabeçalhos SOAP diretamente por meio de propriedades do contexto da mensagem de JAX-WS. Usar os dois tipos de modificação de mensagens poderá causar perda de informações.gotcha

O valor padrão é false.

jaxws.ignore.extraWSDLOps

Use essa propriedade se houver mais operações no WSDL do que construídas no cliente.

O comportamento padrão do cliente é validar as operações construídas no cliente com relação às operações no WSDL e falhar se elas não corresponderem. Configure essa propriedade como true se houver mais operações no WSDL do que construídas no cliente e a validação de WSDL obtiver êxito e o cliente puder ser chamado.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

jaxws.ignoreMetadataComplete

Configure esta propriedade JVM como true para executar uma varredura da anotação de serviço da web, mesmo se os metadados completos estiverem configurados em um módulo. O padrão é false.

No caso padrão, os serviços da web do JAX-WS não serão detectados quando os metadados completos estiverem configurados como true.

Evitar Problemas Evitar Problemas: Esta propriedade JVM deve ser configurada em cada JVM na célula WebSphere Application Server.gotcha

jaxws.JAXBContext.permStoreCostThresholdMsec

Use esta propriedade para ativar o armazenamento em cache de objetos JAXBContext que exigem mais do que a quantidade de tempo especificada para serem construídos.

Os serviços da web JAX-WS ou clientes podem se deparar com atrasos durante a execução ao construir objetos JAXBContext que manipulam centenas de classes . Armazenar em cache objetos JAXBContext de tempo intensivo acelera o serviço da web e a execução do cliente, eliminando a necessidade de reconstruir o objeto JAXBContext sobre cada uso.

Configure esta propriedade para um valor, em milissegundos, que seja superior a 0, para ativar o armazenamento em cache de objetos JAXBContext que exigem mais do que uma quantidade especificada de tempo para serem construídos. O cache persiste até que o JVM seja reiniciado. O valor recomendado é de 5000 milissegundos ou superior.

O valor padrão é 0, o que não ativa o armazenamento em cache.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

jaxws.JAXBContext.permStoreMaxSize

Configure esta propriedade para um valor de número inteiro para especificar o número máximo de entradas no cache do JAXBContext. Se o cache estiver cheio, entradas inativas são substituídas primeiro, seguindo-se a entrada com o tempo mais curto de construção.

O valor padrão é de 32.

Nota: Esta propriedade modifica o cache criado pela propriedade jaxws.JAXBContext.permStoreCostThresholdMsec

jaxws.JAXBContext.permStoreStaleThresholdHours

Configure esta propriedade para um valor, em horas, depois que uma entrada no cache JAXBContext que não foi acessado, for considerada inativa. Se o cache estiver cheio, entradas inativas serão substituídas primeiro.

O valor padrão é de 24 horas.

Nota: Esta propriedade modifica o cache criado pela propriedade jaxws.JAXBContext.permStoreCostThresholdMsec

jaxws.payload.highFidelity

Use essa propriedade para ativar transformações sem perda. Quando essa propriedade é definida como true, o tempo de execução do serviço da Web garante que a mensagem recebida e a mensagem no limite SOAPHandler sejam as mesmas.

Geralmente, a mensagem SOAP recebida por um JAX-WS SOAPHandler não é exatamente a mesma que a mensagem SOAP de entrada. Por exemplo, a mensagem recebida pelo JAX-WS SOAPHandler pode usar diferentes prefixos xml do que a mensagem de entrada original. Essas mudanças sutis não afetam a interpretação lógica da mensagem. No entanto, você deve incluir essa propriedade nas configurações da JVM e definir a propriedade como true se as mensagens no limite SOAPHandler devem ser exatamente as mesmas que as mensagens recebidas. Por exemplo, a Especificação de Canonicalização (C14N) requer que os nomes de prefixo sejam preservados.

Boas Práticas Boas Práticas: Você deve usar essa propriedade apenas se suas solicitações SOAP acessam o conteúdo de um elemento soapenv:Body dentro de seu SOAPHandlers. A configuração da propriedade como true pode degradar o desempenho de tempo de execução do Serviço da Web.bprac

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

jaxws.provider.interpretNullAsOneway

Se você tiver um serviço da Web JAX-WS que define o terminal baseado em Provedor usando a anotação javax.xml.ws.Provider, e um arquivo WSDL não for especificado, é possível usar essa propriedade customizada para controlar como o ambiente de tempo de execução JAX-WS se comporta quando o Provedor retorna um valor nulo do método invoke(). Por padrão, o ambiente de tempo de execução enviará de volta uma resposta consistindo em um SOAPEnvelope que contém um elemento SOAPBody vazio.

Se essa propriedade for configurada como true, sempre que a implementação de Provedor retornar um valor nulo e um arquivo WSDL não for definido, o ambiente de tempo de execução interpretará o valor nulo retornado da implementação do Provedor como uma operação somente-solicitação para que nenhuma resposta seja retornada. Como acontece com todas as operações somente-solicitação, algumas qualidades de serviço, como WS-Transactions, não estão disponíveis.

Se a anotação javax.xml.ws.WebServiceProvider especificar um valor de WSDL, e o WSDL definir uma operação de solicitação e resposta, o ambiente de tempo de execução JAX-WS sempre retornará uma resposta consistindo em um SOAPEnvelope que contém um SOAPBody vazio, independentemente da configuração dessa propriedade.

O valor padrão é false.

Você deve configurar essa propriedade como true para cada servidor que requer uma mudança no valor padrão.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

jaxws.runtime.inheritedImplMethodsAccessible

Use esta propriedade para revisar o tempo de execução de serviço da web para permitir que os métodos herdados sejam chamados. Este comportamento é ativado configurando a propriedade para true.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

jaxws.runtime.restrictStaticWebmethod

Use esta propriedade para evitar a exposição de operações estáticas. Quando essa propriedade é configurada como true, o tempo de execução JAX-WS evita a exposição de operações estáticas.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

jaxws.share.dynamic.ports.enable

Use esta propriedade para especificar a visibilidade de portas dinâmicas entre serviços da web do JAX-WS.

Por padrão, as portas dinâmicas são visíveis somente para a instância do serviço criado pela porta. Configure esta propriedade para true para compartilhar portas dinâmicas entre serviços da web.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

jaxws.soapfault.local.exceptions.disable

Use a propriedade jaxws.soapfault.local.exceptions.disable para evitar que exceções que ocorrem localmente em um cliente JAX-WS sejam tratadas como um SOAPFault. Por padrão, se um cliente JAX-WS encontrar uma exceção local, um SOAPFault será criado para a exceção. Um exemplo de uma exceção local é um ConnectException causado por um host ou porta inválido. Os métodos handleFault de manipuladores de aplicativos JAX-WS relevantes são chamados com o SOAPFault, então, um SOAPFaultException é enviado de volta pelo método chamado do cliente JAX-WS.

Ao configurar esta propriedade como true, as exceções locais criam uma mensagem vazia. Os métodos handleMessage dos manipuladores de aplicativo JAX-WS relevantes são chamados com a mensagem vazia e, em seguida, uma WebServiceException é emitida de volta por meio do método de chamada do cliente JAX-WS. Esse era o comportamento em liberações anteriores.

O valor padrão é false.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

jaxws.useSafeIPC

Configure essa propriedade como true em servidores de aplicativos se ocorrerem erros em serviços da web JAX-WS quando a propriedade enableInProcessConnections for configurada como true no Contêiner da Web. Isso pode acontecer quando aplicativos de serviços da web que chamam um ao outro não podem compartilhar com segurança um único encadeamento. A configuração dessa propriedade como true faz com que os aplicativos executem em encadeamentos separados.

O valor padrão é false.

jdk.corba.allowOutputStreamSubclass

Configure esta propriedade como true para assegurar que o org.omg.CORBA_2_3.portable.OutputStream possa ser subclassificado.

Os aplicativos em execução com um gerenciador de segurança podem experimentar uma queda no desempenho devido a verificações de segurança adicionais que agora são executadas para proteger o construtor padrão org.omg.CORBA_2_3.portable.OutputStream quando um gerenciador de segurança é instalado. Estas verificações de segurança adicionais podem causar incompatibilidades com implementações do aplicativo existentes. A inclusão desta propriedade em suas configurações de JVM e a configuração dela como true evita que estas incompatibilidades ocorram.

Esta propriedade pode ser configurada no nível do servidor de aplicativos, do agente do nó ou do gerenciador de implementação, mas geralmente é especificada no nível do servidor de aplicativos.

ODCClearMessageAge

Utilize essa propriedade para estabelecer um período de tempo, especificado em milissegundos, após o qual uma mensagem ODC será removida do quadro de avisos, mesmo se o receptor não tiver confirmado a mensagem. Especificar um valor para essa propriedade ajuda a evitar a criação de mensagens que, por alguma razão, não são confirmadas.

É possível especificar qualquer inteiro positivo como um valor para essa propriedade, mas um valor de 300000 (5 minutos) ou superior é recomendado para evitar a remoção prematura de mensagens.

O valor padrão é 300000 milissegundos.

ODCInit.disabled

Configure esta propriedade como true se quiser desativar a comunicação entre processos para o componente On Demand Configuration (ODC) e para todo processamento de ODC local.

O componente de configuração on demand é usado ao implementar aplicativos baseados em serviços da web e ao usar um WebSphere Application Server Proxy Server para tratar solicitações. O componente de configuração on demand é ativado ou desativado em toda a célula. Portanto, se sua topologia contiver quaisquer servidores proxy, ou quaisquer aplicativos baseados em serviços da web, você não deverá desativar o serviço de configuração on demand.

Se estiver executando em um ambiente de topologia grande no qual os aplicativos baseados em serviços da Web não são implementados ou os WebSphere Application Server Proxy Servers não são usados para tratar solicitações, o componente de configuração on demand não será utilizado e será possível configurar esta propriedade como true. A configuração dessa propriedade como true desativa o componente de configuração on demand, o que reduzirá a largura da banda da rede e a utilização de CPU.

O valor padrão é false.

org.apache.aries.blueprint.header.mandatory

Quando configurados para true, os pacotes configuráveis com blueprint devem ter um cabeçalho de blueprint. Isso permite que o apache aries evite varreduras caras quando não houver nenhum cabeçalho de blueprint.

org.apache.axiom.attachments.tempfile.expiration

Se ocorrer um excesso de acumulação de arquivos temporários do formulário AxisXXXXXX.att, configure esta propriedade para um valor, em segundos, após o que o tempo de execução do JAX-WS deverá excluir esses arquivos temporários usados para armazenar os anexos MTOM.

O valor padrão é de 0. Arquivos serão excluídos quando existir o JVM.

org.apache.el.parser.SKIP_IDENTIFIER_CHECK

Use esta propriedade para relaxar a verificação que ocorre para identificadores de variável EL. O comportamento de verificação relaxado é equivalente ao comportamento observado em versões do WebSphere Application Server anteriores à Versão 8.0.

A partir da Versão 8.0, a verificação de identificadores de variável EL é mais restrita. O processo de verificação agora verifica as palavras-chaves Java reservadas bem como palavras-chaves EL reservadas. Antes da Versão 8.0, o processo de verificação verificava apenas palavras-chave EL reservadas.

Se qualquer identificador de variável usado em um script JSTL/EL incluir qualquer uma das palavras-chave de JSP reservadas, o identificador de variável falhará ao converter, resultando em uma exceção. O método preferencial para manipular uma exceção desse tipo é modificar o código JSTL/EL para eliminar o uso das palavras-chave reservadas como nomes de variável. No entanto, se isto não for possível ou prático, configure esta propriedade como true para relaxar o nível de verificação que ocorre no nível pré-Versão 8.0.

Uma lista de palavras-chave JSP reservadas pode ser localizada em http://docs.oracle.com/javaee/5/tutorial/doc/bnahq.html#bnail

org.eclipse.jst.j2ee.commonarchivecore.disableZip

Use essa propriedade customizada para permitir que archives ZIP sejam processados como arquivos simples.

Configure essa propriedade como true para permitir que archives ZIP sejam processados como arquivos simples ao varrer os arquivos de um aplicativo implementado.

O valor padrão é false.

Esta propriedade deve ser configurada como uma propriedade customizada para o processo do IBM WebSphere Application Server que executa aplicativos para os quais os arquivos ZIP devem ser ignorados.

org.eclipse.jst.j2ee.commonarchivecore.ignore.ejb.in.war

Use esta propriedade se todos os itens a seguir forem verdadeiros:
  • Você possui um aplicativo Java EE 5.
  • Esse aplicativo contém um EJB em um arquivo WAR.
  • Seu aplicativo foi implementado com sucesso em um servidor independente que está executando o WebSphere Application Server Versão 7.x
  • A implementação do aplicativo falha quando você tenta implementar de um gerenciador de implementação que está executando o WebSphere Application Server Versão 8.0 ou mais recente para um nó que está executando a Versão 7.x.

Se todas as condições anteriores forem verdadeiras, a implementação poderá falhar, porque o aplicativo é promovido para o nível Java EE 6 durante a implementação. O WebSphere Application Server Versão 7.x implementa EJBs Java EE 5. que não foram introduzidos em arquivos WAR até o Java EE 6. Quando o WebSphere Application Server Versão 8.0 ou mais recente localiza um EJB em um arquivo WAR, ele promove o WAR para a versão 3.0 e o aplicativo para Java EE 6. Quando isso acontece, o aplicativo não pode ser implementado em um nó que está executando o WebSphere Application Server Versão 7.x.

Para ignorar EJBs em arquivos WAR, e para evitar que a versão do aplicativo seja atualizada, configure a propriedade como true no gerenciador de implementação. O valor padrão é false.

A configuração dessa propriedade customizada aplica a configuração a todos os aplicativos. Para aplicar a configuração a um aplicativo específico, edite o arquivo META-INF/MANIFEST.MF e inclua a seguinte linha:
Ignore-Ejb-In-War-Annotation: true
Evitar Problemas Evitar Problemas: Ao atualizar o manifesto do aplicativo, siga as limitações de comprimento de linha e outras restrições para o manifesto.gotcha

org.eclipse.jst.j2ee.commonarchivecore.FILTERBINARIES

Use esta propriedade customizada para evitar que determinados arquivos de aplicativos sejam listados durante o processamento de tempo de execução.

Devido a novos requisitos de processamento de anotações JavaEE5, mais arquivos de aplicativos são geralmente listados durante o processamento de tempo de execução do que são listados em versões anteriores do produto. A listagem adicional pode fazer com que os aplicativos que são migrados de versões anteriores do produto iniciem mais lentamente, uma vez que tempo adicional é gasto listando arquivos de aplicativos.

O valor padrão não está configurado.

Se decidir usar esta propriedade customizada, você deve especificá-la como uma propriedade customizada JVM do servidor de aplicativos.

org.eclipse.jst.j2ee.commonarchivecore.ignore.jee6.annotation

Use esta propriedade se todos os itens a seguir forem verdadeiros:
  • Você possui um aplicativo Java EE 5.
  • O aplicativo contém anotações do Java EE 6.
  • Seu aplicativo foi implementado com sucesso em um servidor independente que está executando o WebSphere Application Server Versão 7.x.
  • A implementação do aplicativo falha quando você tenta implementar de um gerenciador de implementação que está executando o WebSphere Application Server Versão 8.0 ou mais recente para um nó que está executando o WebSphere Application Server Versão 7.x

Se todas as condições anteriores forem verdadeiras, a implementação poderá falhar, porque o aplicativo é promovido para o nível Java EE 6 durante a implementação. O WebSphere Application Server Versão 7.x implementa Java EE 5 e ignora anotações Java EE 6. O WebSphere Application Server Versão 8.0 ou mais recente implementa Java EE 6 e, portanto, as anotações Java EE 6 são processadas. Isso faz com que um aplicativo Java EE 5 que contém anotações Java EE 6 seja promovido para o nível Java EE 6. Após a promoção do aplicativo, o WebSphere Application Server Versão 8.0 ou mais recente não implementa o aplicativo em um nó que está executando o WebSphere Application Server Versão 7.x.

Para ignorar as anotações Java EE 6 e para evitar que a versão do aplicativo seja atualizada, configure a propriedade para true no gerenciador de implementação. O valor padrão é false.

Configurar a propriedade customizada aplica a configuração a todos os aplicativos. Para aplicar a configuração a um aplicativo específico, edite o arquivo META-INF/MANIFEST.MF e inclua a seguinte linha:
Ignore-JEE6-Annotation: true
Evitar Problemas Evitar Problemas: Ao atualizar o manifesto do aplicativo, siga as limitações de comprimento de linha e outras restrições para o manifesto.gotcha

org.eclipse.jst.j2ee.commonarchivecore.ignore.jee7.annotation

Use esta propriedade se todos os itens a seguir forem verdadeiros:
  • Você tem um aplicativo Java EE 5 ou Java EE 6.
  • O aplicativo contém anotações Java EE 7.
  • Seu aplicativo foi implementado com sucesso em um servidor independente que está executando o WebSphere Application Server Versão 7.x ou 8.x.
  • A implementação do aplicativo falha quando você tenta implementar de um gerenciador de implementação que está executando o WebSphere Application Server Versão 9.x para um nó que está executando o WebSphere Application Server Versão 7.x ou 8.x.

Se todas as condições anteriores forem verdadeiras, a implementação provavelmente falhará porque o aplicativo é promovido para o nível Java EE 7 durante a implementação. O WebSphere Application Server Versões 7.x e 8.x implementa Java EE 5 e Java EE 6, respectivamente. O WebSphere Application Server Versão 9.x implementa Java EE 7 e, portanto, as anotações Java EE 7 são processadas. Isso faz um aplicativo Java EE 5 ou Java EE 6 que contém anotações Java EE 7 ser promovido para o nível Java EE 7. Após a promoção do aplicativo, o WebSphere Application Server Versão 9.x não implementa o aplicativo em um nó que está executando a Versão 7.x ou 8.x.

Para ignorar as anotações Java EE 7 e para evitar que a versão do aplicativo seja atualizada, configure a propriedade como true no gerenciador de implementação. O valor padrão é false.

Configurar a propriedade customizada aplica a configuração a todos os aplicativos. Para aplicar a configuração a um aplicativo específico, edite o arquivo META-INF/MANIFEST.MF e inclua a seguinte linha:
Ignore-JEE7-Annotation: true
Evitar Problemas Evitar Problemas: Ao atualizar o manifest do aplicativo, siga as limitações de comprimento de linha e outras restrições para o manifest.gotcha

org.eclipse.jst.j2ee.commonarchivecore.ignore.web.fragment

Use esta propriedade se todos os itens a seguir forem verdadeiros:
  • Você possui um aplicativo Java EE 5.
  • Este aplicativo contém um arquivo WAR com um fragmento da web.
  • Seu aplicativo foi implementado com sucesso em um servidor independente que está executando o WebSphere Application Server Versão 7.x
  • A implementação do aplicativo falha quando você tenta implementar de um gerenciador de implementação que está executando o WebSphere Application Server Versão 8.0 ou mais recente para um nó que está executando a Versão 7.x.

Se todas as condições anteriores forem verdadeiras, a implementação poderá falhar, porque o aplicativo é promovido para o nível Java EE 6 durante a implementação. O WebSphere Application Server Versão 7.x implementa Java EE 5. Os fragmentos da web não foram introduzidos em arquivos WAR até o Java EE 6. Quando o WebSphere Application Server Versão 8.0 ou mais recente localiza um fragmento da web, ele promove o WAR para a versão 3.0 e o aplicativo para Java EE 6. Quando isso acontece, o aplicativo não pode ser implementado em um nó que está executando o WebSphere Application Server Versão 7.x.

Para ignorar fragmentos da web e evitar que a versão do aplicativo seja atualizada, configure a propriedade como true no gerenciador de implementação. O valor padrão é false.

A configuração dessa propriedade customizada aplica a configuração a todos os aplicativos. Para aplicar a configuração a um aplicativo específico, edite o arquivo META-INF/MANIFEST.MF e inclua a seguinte linha:
Ignore-Web-Fragment: true
Evitar Problemas Evitar Problemas: Ao atualizar o manifesto do aplicativo, siga as limitações de comprimento de linha e outras restrições para o manifesto.gotcha

org.eclipse.jst.j2ee.commonarchivecore.openAllArchivesTrue

Use esta propriedade customizada para configurar o servidor para expandir todos os archives.

Para ativar a expansão de archives não padrão durante a implementação, configure a propriedade no processo do Servidor de Aplicativos envolvido com a implementação. Se estiver usando um Deployment Manager, configure a propriedade no processo do Deployment Manager.

Para ativar a expansão pelo script earExpander, configure a propriedade como uma propriedade customizada Java, editando o script earExpander.

O valor padrão é false.

Note: Esta propriedade não é aplicada em JARs dentro de JARs. JARs dentro de JARS não serão expandidos, mesmo com a propriedade configurada como true. Todos os JARs nos arquivos EAR e todos os JARs nos arquivos RAR estão ativos. O processamento de JARs em arquivos EAR e JARs em arquivos RAR não é afetado pela propriedade customizada.

org.eclipse.jst.j2ee.commonarchivecore.PM62467.Disabled

Use esta propriedade customizada para especificar o comportamento que ocorre quando um caminho de entrada de archive contém um valor não permitido.

Quando um aplicativo é implementado no WebSphere Application Server, o conteúdo do archive do aplicativo e dos arquivos do módulo são extraídos para o diretório installedApps do perfil do servidor de aplicativos usando os caminhos de entrada de archive dos arquivos. Os arquivos de aplicativos devem ser extraídos para o diretório installedApps, mas se um caminho de entrada do archive do arquivo contiver o valor ../, os archives poderão ser extraídos para outro diretório. Se esta propriedade customizada for false e o caminho de entrada do archive contiver o valor ../, uma ArchiveRuntimeException ocorrerá e o processo de archive será interrompido. Configure esta propriedade para true para efetuar log de uma mensagem de aviso e continuar implementando o aplicativo.

O valor padrão é false.

Se você decidir usar esta propriedade customizada, será necessário especificá-la como propriedade customizada JVM no nó do gerenciador de implementação e o servidor de aplicativos.

overrideAutoProp

Use essa propriedade customizada para propagar o plugin-cfg.xml para o repositório do nó remoto e o local do servidor da web remoto.

Quando essa propriedade é configurada para true com propagação manual, o plugin-cfg.xml é propagado para o repositório do nó remoto e o local do servidor da web remoto. Quando essa propriedade é configurada para false com propagação manual, o plugin-cfg.xml é propagado SOMENTE para o repositório do nó remoto e NÃO para o local do servidor da web.

O valor padrão é false.

Se decidir usar esta propriedade customizada, será preciso especificá-la como uma propriedade customizada JVM do nó.

Depois que essa propriedade estiver configurada para o nó, deve-se sincronizar a mudança para o nó. Configurar essa propriedade requer que você pare e inicie o nó para que a configuração entre em vigor.

plugin.syncdisabled

Use esta propriedade customizada para desativar a sincronização do nó chamado pela propagação da configuração de plug-in do servidor da Web.

Quando esta propriedade é configurada para true, as mudanças na configuração do plug-in do servidor da Web não são automaticamente sincronizadas entre o nó. Isso significa que quaisquer mudanças na configuração do plug-in do servidor da web que forem feitas não serão propagadas para o servidor da web até que seja feita sincronização manual.

O valor padrão é false.

Se decidir usar esta propriedade customizada, será preciso especificá-la como uma propriedade customizada JVM do nó.

threadpool.maxsize

Use essa propriedade para controlar o número de encadeamentos que podem ser incluídos em um conjunto de encadeamentos recém-criado. Um encadeamento dedicado é criado para iniciar cada servidor de aplicativos do Java Virtual Machine (JVM). As JVMs com encadeamentos dedicados nesse conjunto de encadeamentos são as JVMs iniciadas em paralelo sempre que o agente do nó é iniciado.

É possível especificar um número inteiro de 0 a 5 como o valor para essa propriedade. Se o valor especificado for maior que 0, um conjunto de encadeamentos será criado com esse valor como o número máximo de encadeamentos que podem ser incluídos neste conjunto de encadeamentos recém-criado. A tabela a seguir lista os valores suportados para esta propriedade customizada e seus efeitos.

Tabela 3. Valores Suportados para threadpool.maxsize. A tabela inclui o valor da propriedade customizada e o efeito da propriedade customizada.
threadpool.maxsize value Efeito
A propriedade threadpool.maxsize está configurado para 0 ou não especificada. O nó do agente inicia até cinco JVMs em paralelo.
A propriedade threadpool.maxsize está configurada para 1. O nó do agente inicia os JVMs em série.
A propriedade threadpool.maxsize está configurada para um valor de número inteiro 2 e 5. O nó do agente inicia um número de JVMs igual ao valor especificado em paralelo.

Por exemplo, suponha que o agente do nó possui dez JVMs que são configuradas no estado em execução, o que significa que elas são iniciadas sempre que o agente do nó inicia. Se especificar 3 para essa propriedade, sempre que você parar e iniciar o agente do nó, somente três das dez JVMs serão iniciadas em paralelo quando o agente do nó for iniciado.

Evitar Problemas Evitar Problemas:
  • Se estiver usando o console administrativo e especificar threadpool.maxsize como o nome de uma nova propriedade customizada da JVM para o agente do nó, você deverá especificar um valor no campo Valor para esta nova propriedade customizada. Uma mensagem de erro será recebida se você não especificar um valor.
  • Se você passar um valor em branco para a propriedade a partir da linha de comandos, o valor em branco será considerado um valor ilegal e o comportamento padrão do agente do nó será restaurado.
gotcha

Esta propriedade não é especificada por padrão. Se você decidir usar essa propriedade customizada, deverá especificá-la como uma propriedade customizada JVM do agente do nó.

[z/OS]

was.xcfmonitor.enabled

Use esta propriedade para ativar o uso do z/OS Cross-system Coupling Facility (XCF) para monitorar o status do servidor de aplicativos. Quando essa propriedade é configurada como true, os agentes do nó podem usar o XCF para monitorar os servidores de aplicativos, os servidores de aplicativos podem usar o XCF para monitorar os agentes do nó, e um servidor de agente administrativo pode usar o XCF para monitorar os servidores de aplicativos registrados. Quando essa propriedade é definida como false, o método de ping de TCP/IP é utilizado para monitorar o servidor de aplicativos e o status do agente de nó.

O valor padrão é false.

webservices.unify.faults

Use a propriedade webservices.unify.faults para ativar a unificação de Falha de SOAP para JAX-WS e JAX-RPC. Por padrão, os ambientes do tempo de execução do serviço da Web (JAX-WS e JAX-RPC) unificam todas as falhas geradas pelo ambiente do tempo de execução em um único tipo de falha contendo um faultcode de Server e um faultstring de Internal Error. As falhas não contêm nenhuma informação adicional que identifique a causa real da falha. A unificação de falhas resulta em um sistema mais seguro, evitando informações detalhadas sobre porque o processamento de mensagens de entrada falhou ao ser retornado para os emissores da mensagem.

O valor padrão para esta propriedade é true, o que faz com que as falhas sejam unificadas. Se seus aplicativos exigirem detalhes da falha, será possível configurar esta propriedade como false para desativar a unificação da falha, permitindo que informações detalhadas sejam retornadas nas falhas. Observe que, independentemente da configuração da propriedade, as exceções verificadas definidas no WSDL e lançadas por uma implementação do método do provedor de serviços não são unificadas. Além disso, informações detalhadas relativas à causa da falha serão registradas se o rastreio for ativado, independentemente da configuração desta propriedade.

wink.client.readTimeout

Use essa propriedade para especificar por quanto tempo o objeto RestClient aguarda (em milissegundos) por uma resposta para pedidos antes de atingir o tempo limite. Um valor zero (0) significa que o cliente aguarda por uma quantidade ilimitada de tempo e não atingirá o tempo limite.

O valor-padrão é de 60.000 milissegundos.

wink.client.connectTimeout

Use essa propriedade para especificar por quanto tempo o objeto RestClient aguarda (em milissegundos) antes de atingir o tempo limite ao tentar se conectar ao recurso de destino. Um valor zero (0) significa que o cliente aguarda por uma quantidade ilimitada de tempo e não atingirá o tempo limite.

O valor-padrão é de 60.000 milissegundos.


Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=xrun_jvm
Nome do arquivo: xrun_jvm.html