Referência de Mensagens
Abaixo apresentamos uma lista dos códigos de retorno da
função CPI-C, os quais o usuário pode encontrar mais freqüentemente.
Esta NÃO é uma lista completa dos códigos de retorno. O número entre
parêntesis indica o número definido correspondente ao código de
retorno.
- CM_ALLOCATE_FAILURE_NO_RETRY (1): A alocação falhou devido a uma
condição não-temporária. Por exemplo, a sessão não pode ser ativada por
causa de um erro na definição do sistema ou um erro no protocolo de ativação
da sessão. Esse código de retorno também é apresentado quando a sessão
é desativada por causa de um erro no protocolo da sessão ocorrido antes que a
conversação pudesse ser alocada.
- CM_ALLOCATE_FAILURE_RETRY (2): A alocação falhou devido a uma
condição temporária. Por exemplo, a sessão não pode ser ativada por
causa de uma falta de recursos temporária no sistema local ou no sistema
remoto.
- CM_CONVERSATION_TYPE_MISMATCH (3): A alocação falhou porque o
programa remoto não suporta o tipo de conversação do pedido de
alocação. Esse é provavelmente um problema com o TP do servidor.
Confira se o TP do servidor foi configurado para suportar o tipo de
conversação básico.
- CM_TPN_NOT_RECOGNIZED (9): Esse erro ocorre quando o pedido de
alocação é enviado ao sistema remoto. Ele indica que o sistema remoto
não reconhece o nome do programa de transação especificado no pedido.
Se você não estiver usando os serviços do diretório global, verifique se o
nome TP especificado no perfil CPI-C Side Information do cliente corresponde
ao nome TP especificado no servidor. Se estiver usando os serviços do
diretório global, solicite que a ajuda do administrador do banco de dados
verifique se o nome TP especificado na entrada do diretório global corresponde
ao nome TP especificado no servidor.
- CM_TP_NOT_AVAILABLE_NO_RETRY (10): Esse erro ocorre quando o pedido
de alocação é enviado ao sistema remoto. Ele indica que a LU remota
reconhece o nome TP enviado, mas não pode iniciar o programa. Verifique
também se a id do usuário especificada no perfil TPN do servidor é
válida.
- CM_TP_NOT_AVAILABLE_RETRY (11): Esse erro ocorre quando o pedido de
alocação é enviado ao sistema remoto. Ele indica que a LU remota
reconhece o nome TP enviado, mas, por alguma razão que talvez seja temporária,
não pode iniciar o programa. Confirme se o gerenciador do banco de
dados e o suporte ao protocolo APPC do servidor foram iniciados
corretamente.
- CM_DEALLOCATED_ABEND (17): Esse erro ocorre quando o programa remoto
desaloca a conversação. Ele pode acontecer se o programa remoto tiver
sofrido um término anormal ou tiver encontrado uma condição de erro
fatal. Se você estiver tentando se conectar ao DB2 para AIX, verifique
se o gerenciador do banco de dados e o suporte ao protocolo APPC do servidor
foram iniciados corretamente. Em um servidor AIX, esse erro também
poderia ser causado pelo seguinte:
- O agente de banco de dados do servidor foi forçado a se desativar pelo
administrador do sistema.
- O agente de um banco de dados não pôde ser iniciado porque o parâmetro de
configuração do gerenciador de banco de dados maxagents excedeu-se. Consulte o First Failure Service Log (DB2DIAG.LOG)
do servidor para ver se uma mensagem de erro foi registrada.
- O agente de banco de dados do servidor foi cancelado devido ao término
anormal de um processo-chave do gerenciador de banco de dados.
- CM_PRODUCT_SPECIFIC_ERROR (20): Foi detectado um erro específico do
produto, e uma descrição do erro foi armazenada no registro de erro do sistema
do produto. Verifique se o subsistema APPC local foi iniciado
corretamente. No Communication Server for AIX, para obter mais
informações sobre um erro específico do produto, é necessário verificar o
valor do errno da variável global. Consulte a seção abaixo
para obter mais informações sobre os errnos que podem ser
apresentados. O Communication Server for OS/2 registra os erros no
registro de erros do sistema OS/2.
- CM_RESOURCE_FAILURE_NO_RETRY (26): Esse erro ocorre quando a
conversação termina prematuramente (na extremidade remota ou local) a partir
de um erro relacionado aos recursos (tais como sessões ou links). Em um
servidor OS/2, esse erro também poderia ser causado pelo seguinte:
- O agente de banco de dados do servidor foi forçado a se desativar pelo
administrador do sistema.
- O agente de um banco de dados não pôde ser iniciado porque o parâmetro de
configuração do gerenciador de banco de dados maxagents excedeu-se. Consulte o First Failure Service Log (DB2DIAG.LOG)
do servidor para ver se uma mensagem de erro foi registrada.
- O agente de banco de dados do servidor foi cancelado devido ao término
anormal de um processo-chave do gerenciador de banco de dados.
- CM_RESOURCE_FAILURE_RETRY (27): Esse erro ocorre quando a
conversação termina prematuramente (na extremidade remota ou local)
provavelmente pela mesma razão da condição NO_RETRY descrita acima. A
única diferença é a de que o erro pode não ser permanente.
Na maior parte dos casos, os códigos de retorno CPI Communications são
suficientes para a dedução da causa do erro. Quando o
CM_PRODUCT_SPECIFIC_ERROR for apresentado, serão fornecidas informações
adicionais.
No Communication Server for AIX, o errno fornece informações
adicionais. Abaixo apresentamos uma lista de alguns dos
errnos mais comuns. Esta NÃO é uma lista completa. Os
Errnos com o número 101 e superiores podem ser encontrados no
arquivo /usr/include/luxsna.h, o qual contém os
errnos específicos do Communication Server for AIX. A
maioria desses errnos são convertidos em códigos de retorno
CPI-C. Os errnos com números inferiores correspondem aos
problemas AIX e podem ser encontrados no arquivo
/usr/include/sys/errno.h. O número do
errno em si está entre parêntesis.
- EBADF (9): Esse é um erro de "descritor de arquivos ruim". Se
esse erro ocorrer quando você estiver tentando se conectar ao banco de dados,
geralmente significará que o subsistema SNA do servidor não foi iniciado, ou
que há algum problema com os perfis de configuração do SNA. Verifique
se o subsistema SNA do servidor foi iniciado. Confira se a estação do
link com o nó do servidor pode ser ativada.
- EACCESS (13): Esse é um erro de "permissão negada". Se esse
erro ocorrer quando você estiver tentando se conectar ao banco de dados,
geralmente significará que há algum problema com os perfis de configuração do
SNA.
No HP-UX, para SNAPlus2, consulte o arquivo /usr/include/sys/errno.h
para obter uma descrição do erro.
No OS/2, quando o CPI Communications apresenta
CM_PRODUCT_SPECIFIC_ERROR, será criada uma entrada no erro de log. As
informações da entrada do log de erros identificam o CPIC como o autor.
Se Communications Server/2 (CS/2) estiver instalado, CS/2
registra o erro no log de erro do sistema OS/2. Consulte o manual
de determinação do problema do produto específico para obter uma descrição
completa do erro e a ação recomendada.
Para obter mais informações sobre os erros do CPI Communications, consulte
o Systems
Application Architecture Common Programming Interface Communications
Reference.
[ Início da Página | Página Anterior | Próxima Página | Índice | Índice Remissivo ]