Propriedades de Aperfeiçoamento Dinâmico SQL do Localizador Customizado

Utilize essa página para modificar definições de propriedades de aperfeiçoamento dinâmico SQL do localizador customizado.

Para assegurar-se de que os aprimoramentos dinâmicos de SQL (Linguagem de Consulta Estruturada) ocorram corretamente nos localizadores customizados definidos em uma interface EJB 1.1 Home que utiliza um armazenamento de dados backend o qual exige as cláusulas especiais de bloqueio SQL, são fornecidas as seguintes propriedades de bean (módulo) e da JVM (Java Virtual Machine). Essas propriedades permitem indicar quais localizadores customizados serão aperfeiçoados, desde que o armazém de dados de backend ofereça suporte a cláusulas SQL.

Para visualizar essa página do console administrativo, clique em Servidores > Servidores de Aplicativos > servidor > Definição de Processo > Controle (para definir a propriedade no Controle) ou Servant (para definir a propriedade no Servant) > Java Virtual Machine > Propriedades Customizadas.

Guia Configuração

com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent

Utilizado para indicar quais enterprise beans devem ter aperfeiçoamento dinâmico de SQL do localizador customizado ativado no tempo de execução.

Essa propriedade atua no nível do servidor. Qualquer localizador customizado definido pela interface home de EJB 1.1 (prefixo denominado find) que tem Atualizar como uma intenção de acesso é candidato ao aperfeiçoamento dinâmico de SQL do localizador customizado com base em seu nível de isolamento especificado. Se o data store de backend exibir uma semântica SQL especial, ela será aplicada. O SQL específico utilizado varia de acordo com o nível de isolamento escolhido para beans no aplicativo e também com o banco de dados de backend utilizado. Se estiver definido como todos, o aperfeiçoamento dinâmico SQL do localizador customizado será ativado para todos os localizadores customizados definidos nos beans instalados no contêiner. Se estiver definido como J2EENAME[:J2EENAME], em que J2EENAME é um pacote ou um nome de bean completo, o aperfeiçoamento dinâmico SQL do localizador customizado será ativado somente para os localizadores customizados definidos nos beans instalados no contêiner e representados pelos nomes de bean indicados.

Tipo de Dados Cadeia
Intervalo Os valores válidos são todos ou J2EENAME[:J2EENAME]
Padrão Comportamento de aperfeiçoamento inativo
Nota: Alguns dos aplicativos podem utilizar localizadores customizados codificados manualmente e já contêm cláusulas SQL de bloqueio ou palavras-chave ORDER BY e DISTINCT na operação SELECT. Nestas instâncias, se o tempo de execução tentar o aperfeiçoamento dinâmico de SQL, será possível introduzir instruções SQL incorretas no data store de backend subjacente. Se um aplicativo tiver esses localizadores customizados, tome cuidado ao especificar o valor da propriedade JVM com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent. Um valor all faz com que ocorra um aperfeiçoamento dinâmico de SQL do localizador customizado para cada método de localizador customizado definido com uma intenção de acesso de Atualizar localizada em todos os beans instalados no servidor de aplicativos, introduzindo, assim, SQL incorreto para esse subconjunto de localizadores customizados.

Para impedir que isto ocorra, não faça a definição no lado do servidor como todos. Em vez disso, utilize a propriedade de nível do método do bean, com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel para indicar em uma base por bean somente os métodos de localizador customizado que devem ter o aperfeiçoamento dinâmico de SQL do localizador customizado executado no tempo de execução.

com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel

Utilizado para indicar que o aperfeiçoamento dinâmico SQL do localizador customizado será ativado no nível do método em um determinado bean.

Quando um bean é definido com essa propriedade definida para uma lista de um ou mais métodos de localizador customizado, todos os localizadores customizados (prefixo denominado find) definidos na interface home que têm um nome de método correspondente e assinatura de parâmetro terão as semânticas de bloqueio SQL aplicadas no tempo de execução. Isto ocorre somente se o método de localizador customizado tiver uma intenção de acesso Atualizar especificada e o data store de backend tiver suporte a cláusulas SQL. O SQL específico utilizado varia de acordo com o nível de isolamento escolhido para o aplicativo e também com o data store de backend utilizado.

Tipo de Dados Cadeia
Intervalo O valor válido é uma cadeia desta forma: method1(parm1,parm2,..parmn):method2(parm1,parm2,..parmn):methodn(...)
com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent [z/OS]

Utilizado pelos usuários do WebSphere Application Server para z/OS Versão 4.x para indicar que o recurso de aprimoramento SQL não deverá ser aplicado aos aplicativos instalados no produto WebSphere Application Server para z/OS.

O comportamento padrão do produto WebSphere Application Server para z/OS Versão 4.x é executar os aprimoramentos de SQL dinâmica. Para aqueles usuários do z/OS que optarem por não participar do aprimoramento de SQL dinâmica de localizadores customizados no produto da Versão 4.x, esse atributo será utilizado para fazer essa indicação no nível do bean e do servidor.

No nível do bean, um par nome/valor que consiste nesse nome de atributo e um valor true desativa o aperfeiçoamento SQL de todos os localizadores customizados definidos na interface inicial do bean indicado.

No nível do servidor, uma entrada no arquivo de propriedades do servidor WebSphere Application Server para z/OS com um valor igual a true desativa o aprimoramento de SQL de todos os beans instalados no determinado servidor.

Esse atributo de aperfeiçoamento do localizador customizado ainda é suportado pelo tempo de execução no nível do bean na Versão 5.x do produto. Seu uso como indicador no âmbito do servidor foi descontinuado, pelo fato do comportamento padrão da Versão 5.x não aperfeiçoar dinamicamente o SQL do localizador customizado.

Nota: Se a instalação do WebSphere Application Server para z/OS contar com o aprimoramento dinâmico automático de todos os localizadores customizados em todos os aplicativos instalados, você deverá definir o indicador com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent como all. Se um aplicativo tiver um bean cujo indicador com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent esteja configurado em suas definições env-var, esse indicador continuará sendo utilizado, desde que os recursos de aperfeiçoamento SQL dinâmico da Versão 5.x do produto estejam ativados conforme descrito anteriormente.
Tipo de Dados Cadeia
Intervalo Os valores válidos são true e false

Algumas observações sobre precedência:

  • O atributo com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent.methodLevel substitui todas as definições de atributo no âmbito do servidor ou no nível do bean
  • Os beans relacionados com um Nome J2EE no indicador com.ibm.websphere.ejbcontainer.customfinder.honorAccessIntent fazem com que o aperfeiçoamento dinâmico ocorra para localizadores customizados definidos para esse bean, mesmo que o comportamento padrão esteja em efeito para o servidor em questão.
  • O atributo com.ibm.websphere.persistence.bean.managed.custom.finder.access.intent desativa o uso deste recurso por um bean específico se a definição no âmbito do servidor ou a definição do bean estiver ativada e nenhuma definição no nível do método estiver especificada.



Links marcados (on-line) requerem acesso à Internet.

Tarefas relacionadas
[AIX Solaris HP-UX Linux Windows] [iSeries]


Nome do arquivo: udat_sqllock.html