Aqui está uma breve explicação das
diretivas de configuração.
-
ibm_db2.binmode
int
-
Esta opção controla o modo usado para converter de e para dados binários
no aplicativo PHP.
-
1 (DB2_BINARY)
-
2 (DB2_CONVERT)
-
3 (DB2_PASSTHRU)
-
ibm_db2.i5_all_pconnect
int
-
Esta opção força todas as conexões a serem persistentes no IBM i.
Basicamente, todas as chamadas db2_connect() se tornam transparentemente
chamadas db2_pconnect().
Por padrão, esta opção é 0
.
Esta opção é fornecida como uma conveniência para casos em que as conexões
persistentes são mais rápidas.
Ela não deve ser usada em novas aplicações.
-
ibm_db2.i5_allow_commit
int
-
Esta opção controla o modo de isolamento de transação usado.
Por padrão, esta opção é 0
, então o controle de comprometimento não é usado.
Esta opção pode ser substituída ao conectar se a chave de array
i5_commit
estiver definida no array de opções de conexão
passada para db2_connect() ou
db2_pconnect().
-
0 - o controle de confirmação não é usado
-
1 - leitura não cofirmada, leituras sujas são possíveis.
-
2 - leitura confirmada, leituras sujas não são possíveis.
-
3 - leituras repetíveis, leituras sujas e leituras não repetíveis não são possíveis
-
4 - leituras serializáveis, sujas, não repetíveis e fantasmas não são possíveis
-
ibm_db2.i5_blank_userid
int
-
Esta opção controla se um ID de usuário em branco deve ser permitido no IBM i.
Por padrão, esta opção é 0
.
Ao contrário de ibm_db2.i5_ignore_userid
, esta opção
não força todos os IDs de usuário a ficarem vazios ou altera o comportamento do trabalho, mas
simplesmente permite que um ID de usuário vazio seja passado, para conectar-se ao Db2 como o
usuário atual.
-
ibm_db2.i5_char_trim
int
-
Esta opção controla se o fim das strings são aparadas no IBM i.
Como muitas tabelas usam tamanhos de coluna fixos preenchidos com espaços, isso é
fornecido como uma conveniência.
Por padrão, esta opção é 0
.
-
ibm_db2.i5_dbcs_alloc
int
-
Esta opção afeta a estratégia de alocação de buffer interno no IBM i.
Por padrão, esta opção é 0
.
Quando esta opção é definida, os buffers são alocados com um tamanho muito maior,
caso o banco de dados subestime o tamanho de uma string ao converter
entre codificações.
Esta opção usa seis vezes mais memória para buffers (para contabilizar
as maiores sequências UTF-8 possíveis), mas pode ser necessária se dados truncados
forem retornados.
-
ibm_db2.i5_guard_profile
int
-
Esta opção verifica se o perfil do usuário do banco de dados foi alternado ao
conectar-se a uma conexão de banco de dados persistente no IBM i e, se sim,
desconecta-se do banco de dados.
Por padrão, esta opção é definida como 0
.
-
ibm_db2.i5_log_verbose
int
-
Esta opção define se mensagens de diagnóstico SQL como avisos e erros são
sempre enviadas para o log de erros do PHP no IBM i.
Normalmente, apenas uma breve mensagem sobre falha é enviada (como "statement
execute failed") para o log de erros do PHP, pois esta opção é definida como
0
por padrão.
Observe que pode-se e deve-se chamar, por exemplo,
db2_stmt_errormsg() manualmente como parte da verificação se
as funções falharem.
-
0 - Registra somente mensagens breves.
-
1 - Registra mensagens de diagnóstico SQL, além das mensagens breves.
-
ibm_db2.i5_ignore_userid
int
-
Esta opção ignora o ID do usuário ao conectar-se ao banco de dados quando
em execução no IBM i, e executa a funcionalidade SQL/CLI dentro do trabalho PHP,
em vez de um trabalho separado.
Por padrão, esta opção é 0
.
Quando habilitada, ela não usa mais um trabalho de servidor de banco de dados separado, e
sempre usa o perfil de usuário atual para o banco de dados, ignorando o
nome de usuário e a senha passados para db2_connect() e
db2_pconnect().
-
ibm_db2.i5_job_sort
int
-
Controla a opção de classificação de trabalho no IBM i.
Por padrão, esta opção é 0
.
Isso corresponde ao atributo IBM i SQL/CLI
SQL_ATTR_CONN_SORT_SEQUENCE
.
-
0 - Usa a opção de classificação *HEX
, classificando por bytes.
-
1 - Usa a sequência de classificação de tarefas definida para a tarefa PHP.
-
2 - Usa a sequência de classificação de trabalho definida para a tarefa do banco de dados.
-
ibm_db2.i5_max_pconnect
int
-
Isso afetará quantas vezes uma conexão persistente pode ser reutilizada
ao executar no IBM i.
Por padrão, isso é definido como 0
, o que significa que uma conexão persistente
sempre pode ser reutilizada.
Esta opção pode ajudar a contornar problemas em um tarefa de banco de dados de longa execução
(por exemplo, se um procedimento estiver vazando memória), mas obviamente não é uma correção de longo
prazo.
-
ibm_db2.i5_override_ccsid
int
-
O CCSID PASE a ser usado para conversões de caracteres de EBCDIC no IBM i.
Por padrão, este é 0
, que selecionará o CCSID do trabalho PASE padrão,
que vem das configurações de localidade PASE.
Por exemplo, definir isso como 1208
usará UTF-8.
Isso só deve ser modificado se o CCSID da tarefa PASE não for o CCSID
esperado e a localidade não puder ser modificada.
Para saber mais sobre CCSIDs no IBM i, consulte a
» documentação IBM.
Para saber como as localidades no IBM i PASE são mapeadas para CCSIDs, consulte a
» documentação IBM.
-
ibm_db2.i5_sys_naming
int
-
Esta opção controla o modo de nomenclatura ao conectar-se a um sistema IBM i.
Por padrão, esta opção é 0
.
O modo de nomenclatura afeta como os nomes são resolvidos e a sintaxe permitida para
nomes.
Quando definido como 0
, isso usa pontos para qualificar nomes e
usa a biblioteca padrão ou ID do usuário para resolver nomes.
Quando definido como 1
, isso usa barras para qualificar nomes e
usa a lista de bibliotecas de tarefas para resolver nomes.
Para saber mais sobre modos de nomenclatura no IBM i, consulte a
» documentação da IBM.
-
ibm_db2.i5_servermode-subsystem
string
-
Esta opção altera em qual subsistema as tarefas do servidor de banco de dados são executadas no
IBM i.
Por padrão, esta opção é null
, portanto as tarefas serão executadas no subsistema
padrão para tarefas QSQSRVR.
-
ibm_db2.instance_name
string
-
Em sistemas operacionais Linux e UNIX, esta opção define o nome da
instância a ser usada para conexões de banco de dados catalogadas.
Por padrão, esta opção é null
.
Se esta opção for definida, seu valor substitui a
configuração da variável de ambiente DB2INSTANCE.
Esta opção é ignorada em sistemas operacionais Windows.