Tivoli Service Desk 6.0 Developer's Toolkit - Guia do Criador de Interface

Capítulo 9: Códigos de Retorno e Constantes do Sistema CPIC

Retornar ao Índice


Introdução

Visão Geral

Os possíveis códigos de retorno para comandos CPIC estão listados aqui em ordem numérica. Os mnemônicos fornecidos com a descrição não são constantes definidas pelo sistema TSD Script. Eles são fornecidos aqui como modelos para quaisquer constantes que você desejar definir.

Códigos de retorno CPIC

Código de Retorno Descrição
1 CPIC_SUCCESS. Este valor é retornado por todos os comandos CPIC que foram concluídos com êxito.
-1 CM_ALLOCATE_FAILURE_NO_RETRY. As tentativas de alocações para conversação falharam. A condição provavelmente requer a intervenção do usuário para corrigir a configuração de serviços do nó. O número máximo de sessões atuais (LU, modo) para o par especificado (nome da LU, nome do modo) pode ser 0 ou pode haver um erro de definição do sistema. Tente mudar para um nome de modo diferente para a conversação.
-2 CM_ALLOCATE_FAILURE_RETRY. A tentativa de alocação para conversação falhou devido a uma condição que pode ser temporária. Geralmente, ela é causada por uma falta de recursos temporária em uma das LUs envolvidas na conversação. O aplicativo repete o comando automaticamente.
-3 CM_CONVERSATION_TYPE_MISMATCH. A LU parceira rejeitou o pedido porque o parceiro não suporta o tipo de conversação da conversação. Este código é retornado em uma chamada subseqüente para CPICAllocate.
-5 CM_PIP_NOT_SPECIFIED_CORRECTLY. A LU parceira rejeitou o pedido de alocação porque o aplicativo remoto possui uma ou mais variáveis de parâmetros de inicialização de aplicativos (PIP) definidas. Este tipo de chamada teria que ser feito para uma API não-CPIC .
-6 CM_SECURITY_NOT_VALID. A LU remota rejeitou o pedido porque as informações de segurança de acesso não eram válidas. Estas informações são fornecidas pelo sistema de serviços de nó local. Geralmente, isto ocorre quando você definiu a segurança necessária nas informações secundárias de CPIC, mas ainda não iniciou sessão nos serviços de nó local. De forma alternativa, sua senha de início de sessão não é válida na máquina remota.
-7 CM_SYNC_LVL_NOT_SUPPORTED_LU. O nível de sincronização solicitado por seu aplicativo não é suportado pela LU remota. A CPIC suporta somente níveis de sincronização de $CPICNone e $CPICConfirm. Ela não suporta um nível de sincronização de SYNC_POINT.
-8 CM_SYNC_LVL_NOT_SUPPORTED_PGM. O nível de sincronização solicitado por seu aplicativo não é suportado pelo aplicativo parceiro. A CPIC suporta somente níveis de sincronização de $CPICNone e $CPICConfirm; ela não suporta um nível de sincronização de SYNC_POINT.
-9 CM_TPN_NOT_RECOGNIZED. A LU remota rejeitou o pedido porque o aplicativo local especificou um nome de TP não reconhecido pela LU remota.
-10 CM_TP_NOT_AVAILABLE_NO_RETRY A LU remota rejeitou o pedido de alocação porque o aplicativo local especificou um TP que a LU remota reconhece, mas não pode iniciar. É necessária a intervenção do usuário.
-11 CM_TP_NOT_AVAILABLE_RETRY. A LU remota rejeitou o pedido porque o aplicativo local especificou um TP que a LU remota reconhece mas, no momento, não pode iniciar. Esta condição pode ser temporária.
-17 CM_DEALLOCATED_ABEND. O aplicativo remoto foi desalocado com o tipo de desalocação definido como abend, ou a LU remota foi desalocada porque e aplicativo remoto terminou de forma anormal.
-18 CM_DEALLOCATED_NORMAL. O aplicativo remoto desalocou a conversação em um estado normal.
-19 CM_PARAMETER_ERROR. O aplicativo local emitiu um comando CPIC especificando um parâmetro inválido. Observe que o termo "parâmetro" inclui características associadas ao ID da conversação. Portanto, o problema pode estar em alguns valores nas informações secundárias de CPIC.
-20 CM_PRODUCT_SPECIFIC_ERROR. Indica que o aplicativo de chamada (neste caso, o Tivoli Service Desk (TSD) Developer's Toolkit) detectou um erro e não pode continuar a conversação. Muitas vezes, isto ocorre no OS/2 quando você não definiu a variável de ambiente APPCTPN antes de iniciar um aplicativo CPIC.
-21 CM_PROGRAM_ERROR_NO_TRUNC. O aplicativo remoto emitiu uma chamada SendError em uma conversação mapeada ou básica. Os dados não estavam truncados na operação.
-22 CM_PROGRAM_ERROR_PURGING. O aplicativo remoto emitiu SendError. Se o aplicativo remoto estivesse no estado Receber ou Confirmar, as informações poderiam ser expurgadas.
-23 CM_PROGRAM_ERROR_TRUNC. O aplicativo remoto emitiu SendError em uma conversação básica e a chamada truncou um registro lógico.
-24 CM_PROGRAM_PARAMETER_CHECK. Seu aplicativo CPIC emitiu um comando CPIC com informações de parâmetro inválidas. As ocorrências mais comuns destes códigos de retorno são causadas por SDNs inválidos (como tipo de letra incorreto) ou por um ID de conversação que ainda não foi inicializado. Isto pode incluir características associadas ao ID da conversação. Neste caso, a origem do problema está sob o controle do aplicativo local.
-25 CM_PROGRAM_STATE_CHECK. Seu aplicativo emitiu um comando CPIC que é inválido no estado atual. Por exemplo, seu aplicativo tentou enviar dados quando o aplicativo estava no estado Receber.
-26 CM_RESOURCE_FAILURE_NO_RETRY. Uma falha fez com que a conversação fosse terminada prematuramente. A condição não é temporária, por exemplo, o aplicativo não deve repetir o comando sem intervenção externa.
-27 CM_RESOURCE_FAILURE_RETRY. Uma falha fez com que a conversação fosse terminada prematuramente. A condição pode ser temporária, significando que o aplicativo pode repetir o comando sem intervenção externa.
-28 CM_UNSUCCESSFUL. O comando CPIC não foi executado com êxito.
-30 CM_DEALLOCATED_ABEND_SVC. O aplicativo remoto pode ter desalocado a conversação básica com um tipo ABEND_SVC. De forma alternativa, o aplicativo remoto terminou de maneira anormal e o sistema de serviços de nó para a LU parceira desalocou a conversação em nome do aplicativo remoto. Este tipo de chamada teria que ser feito para uma API não-CPIC .
-31 CM_DEALLOCATED_ABEND_TIMER. O aplicativo remoto desalocou a conversação básica com um tipo ABEND_TIMER. Este tipo de chamada teria que ser feito para uma API não-CPIC .
-32 CM_SVC_ERROR_NO_TRUNC. O aplicativo remoto emitiu SendError com um tipo de SVC e o verbo não truncou o registro de dados. Observe que este tipo de chamada teria que ter sido feito para uma API não-CPIC.
-33 CM_SVC_ERROR_PURGING. O aplicativo remoto emitiu SendError com um tipo de SVC e o registro de dados pode ter sido truncado. Observe que este tipo de chamada teria que ter sido feito para uma API não-CPIC.
-34 CM_SVC_ERROR_TRUNC. O aplicativo remoto emitiu SendError com um tipo de SVC e o registro de dados foi truncado. Observe que este tipo de chamada teria que ter sido feito para uma API não-CPIC.
-37 CM_OPERATION_NOT_ACCEPTED. Uma operação anterior na conversação especificada não foi concluída. Isto pode ocorrer em um aplicativo multitarefa.
-100 CM_TAKE_BACKOUT. O aplicativo remoto emitiu uma chamada Backout de recuperação do recurso SAA. O aplicativo local deve emitir uma chamada Backout para o último ponto de sincronização. Este código é retornado somente para uma conversação do tipo SYNC_POINT.
-130 CM_DEALLOCATED_ABEND_BO. O aplicativo remoto foi desalocado com um tipo de DEALLOCATE_ABEND e o aplicativo local deve emitir uma chamada Backout para o último ponto de sincronização. Este código é retornado somente para uma conversação do tipo SYNC_POINT.
-131 CM_DEALLOCATED_ABEND_SVC_BO. O aplicativo remoto pode ter desalocado a conversação básica com um tipo ABEND_SVC. De forma alternativa, o aplicativo remoto terminou de maneira anormal e o sistema de serviços de nó para a LU parceira desalocou a conversação em nome do aplicativo remoto. Este tipo de chamada teria que ter sido feito para uma API não-CPIC. O aplicativo local deve emitir uma chamada Backout para o último ponto de sincronização. Este código é retornado somente para uma conversação do tipo SYNC_POINT.
-132 CM_DEALLOCATED_ABEND_TIMER_BO. O aplicativo remoto desalocou a conversação básica com um tipo ABEND_TIMER. Este código é retornado somente para uma conversação do tipo SYNC_POINT. Este tipo de chamada teria que ser feito para uma API não-CPIC .
-133 CM_RESOURCE_FAIL_NO_RETRY_BO. Uma falha provocou o termino prematuro da conversação. Esta condição não é temporária; portanto, o aplicativo não deve repetir o comando sem intervenção externa. O aplicativo local deve emitir uma chamada Backout para o último ponto de sincronização. Este código é retornado somente para uma conversação do tipo SYNC_POINT.
-134 CM_RESOURCE_FAILURE_RETRY_BO. Uma falha provocou o término prematuro da conversação. Esta condição pode ser temporária. Este código é retornado somente para uma conversação do tipo SYNC_POINT.
-135 CM_DEALLOCATED_NORMAL_BO. O aplicativo remoto desalocou a conversação. O aplicativo local agora deve emitir uma chamada Backout para o último ponto de sincronização. Este código é retornado somente para uma conversação do tipo SYNC_POINT.

Constantes do Sistema CPIC

Códigos de retorno de operação CPIC

Código de Retorno Descrição
-501 CPIC_GET_CONVTYPE_FAILED. Durante o processamento de CPICAccept, o TSD Developer's Toolkit pergunta o tipo de conversação de entrada (mapeada ou básica). Se esta operação falhar, o TSD Developer's Toolkit não suportará a conversação de entrada.
-502 CPIC_OUT_OF_MEMORY. Durante o processamento de um comando CPIC, houve falha de alocação de memória.
-503 CPIC_SET_FILL_FAILED. Durante o processamento de CPICAccept para uma conversação básica de entrada, o TSD Developer's Toolkit tenta definir o tipo de preenchimento para FILL_LL. Se esta operação falhar, o TSD Developer's Toolkit não suportará a conversação de entrada.
-504 CPIC_TPNAME_CONV_FAILED. O processo de conversão de nomes do TP do serviço SNA em formato do TP de serviço falhou.
-505 CPIC_TPNAME_TOO_SHORT. O TPName fornecido para o comando CPICSetSideInfo é muito curto para ser um nome de TP do serviço SNA.
-506 CPIC_DEFAULT_CONVTYPE_FAILED. Durante o processamento de um CPICInitialize, o TSD Developer's Toolkit tenta definir o tipo de conversação como mapeado. Este código de retorno é obtido se a operação não funcionar.
-507 CPIC_VARLEN_FOR_BASIC. O TSD Developer's Toolkit detectou um campo VAR em um DDF em uma conversação básica. O TSD Developer's Toolkit não suporta campos de comprimentos variáveis para conversações básicas.
-508 CPIC_INVALID_CONVERSATION. O ID de conversação transmitido para a CPIC não é válido. Deve ser inicializada uma conversação antes que ele possa ser alocado.
-509 CPIC_INVALID_SDN. O SDN especificado no comando CPIC é inválido.
-510 CPIC_INVALID_DDF_NAME. O parâmetro transmitido como o nome de DDF é inválido.
-511 CPIC_INVALID_TP_NAME. O parâmetro transmitido como o nome do TP é inválido. Ele pode ser $Unknown.
-512 CPIC_INVALID_PLU_NAME. O parâmetro transmitido como o nome do TP é inválido. Ele pode ser $Unknown.
-513 CPIC_INVALID_PARAMETER. Um dos parâmetros de referência transmitidos para o comando CPIC é inválido. Ele pode ser $Unknown.
-514 CPIC_INVALID_VALUE. Um dos valores de parâmetro transmitidos para o comando CPIC é inválido. Ele pode ser $Unknown.

Códigos de retorno de conversão de cadeia de caracteres

Código de Retorno Descrição
-1501 CONV_BUFFER_LENGTH_ERROR. A tentativa do TSD Developer's Toolkit's de converter uma cadeia de caracteres em ou de ASCII falhou devido ao comprimento inválido transmitido para o CM/2.
-1502 CONV_COMM_SUBSYSTEM_NOT_LOADED. A tentativa de conversão da cadeia de caracteres não foi concluída porque o subsistema de serviços de nó não está carregado (O CM/2 não foi iniciado).
-1503 CONV_CONVERSION_ERROR. Os serviços de nó não conseguiram concluir a conversão de caracteres porque a cadeia de origem continha caracteres que não estavam na tabela de conversão. Provavelmente, isto significa que você utilizou um DDF que não especificou CUSTOM_CONVERT=TRUE e você tentou enviar ou receber uma cadeia não suportada pela tabela padrão dos serviços de nó.
-1504 CONV_CUSTOM_TABLE_ERROR. A tabela personalizada que você especificou na configuração dos serviços de nó não pôde ser carregada. Você poderá utilizar a tabela personalizada ACSGTAB.DAT, fornecida com o CM/2.
-1505 CONV_GENERAL_ERROR. A conversão de caracteres não pôde ser executada devido a um erro não identificado.
-1506 CONV_INVALID_CHARACTER_SET. Os serviços de nó não puderam executar a conversão devido a um erro interno no TSD Developer's Toolkit.

Códigos de retorno DDF

Código de Retorno Descrição
-2501 CPIC_DDF_INVALID_TYPE. O nome do tipo especificado para um campo no DDF é inválido.
-2502 CPIC_DDF_INVALID_FIELD_DECIMALS. Uma especificação de largura decimal de campo está incorreta no DDF.
-2503 CPIC_DDF_INVALID_FIELD_WIDTH. Uma largura de campo especificada no DDF está incorreta.
-2504 CPIC_DDF_NO_FIELD_TYPE. Nenhum tipo foi especificado para um campo no DDF.
-2505 CPIC_DDF_UNKNOWN_PARTNER_ATTRIB. Um atributo na seção Parceiro do DDF não é reconhecido.
-2506 CPIC_DDF_UNRECOGNIZED_SECTION. Existe uma seção não reconhecida no DDF.
-2507 CPIC_DDF_FILE_OPEN_ERROR. O DDF não pôde ser aberto. Certifique-se de que o nome esteja correto e que você tenha especificado o PATH completa ou ainda que PATH esteja na variável de ambiente DPATH.
-2508 CPIC_DDF_FILE_READ_ERROR. O DDF foi aberto, mas o TSD Developer's Toolkit não pôde ler o arquivo. Certifique-se de que tenha direitos de leitura para o arquivo.
-2509 CPIC_DDF_FILE_CLOSE_ERROR. Após a leitura a partir de DDF, o TSD Developer's Toolkit não pôde fechar o arquivo.
-2510 CPIC_DDF_NOT_SPECIFIED. Nenhum DDF foi especificado no comando. Isto ocorre quando você utilizou o comando $SIZEOF ou $INCLUDE em seu DDF mas não transmitiu o nome do DDF para esses comandos.
-2511 CPIC_DDF_DUPLICATE_FIELD. Um dos campos no DDF está definido duas vezes.
-2512 CPIC_DDF_INVALID_VAR_LEN. Um dos campos no DDF foi declarado como tipo VAR, embora não seja o último campo no DDF.
-2513 CPIC_BAD_VAR_LEN_PARAM. O campo de registro do TSD Script, que no DDF era do tipo VAR, não é um campo de cadeia.

Códigos de retorno gerais CPIC

Código de Retorno Descrição
-2514 CPIC_TYPE_CONVERSION_ERROR. O TSD Developer's Toolkit não pôde executar o conversão entre o tipo especificado para um campo de registro do TSD Script e o tipo especificado no DDF para esse campo.
-2516 CPIC_CANT_SEND_UNKNOWN. O DDF especifica FALSE para a coluna sendunknowns para um campo que era $Unknown na chamada para CPICSend.
-2517 CPIC_BUF_TOO_SMALL. O buffer recebido é muito pequeno para o DDF especificado para utilizá-lo. Verifique as larguras do campo no DDF.
-2518 CPIC_CANNOT_CREATE_SEM. Um erro de processamento interno impediu que o TSD Developer's Toolkit criasse semáforos necessários.
-2519 CPIC_CANNOT_GET_SEM. Um erro de processamento interno impediu que o TSD Developer's Toolkit acessasse os semáforos.
-2520 CPIC_GENERAL_ERROR. Um erro de processamento interno impediu que o TSD Developer's Toolkit processasse comandos CPIC.

Constantes do Sistema TSD Script

Visão Geral

Vários dos comandos CPIC utilizam parâmetros de inteiros como indicadores de comportamento. Para ajudar a tornar esses comandos mais legíveis, as constantes do sistema TSD Script estão listadas para fornecer nomes de mnemônicos para esses valores.

Valores do estado de conversão

Mnemônico Valor
$CPICInitState 2
$CPICSendState 3
$CPICReceiveState 4
$CPICSendPendingState 5
$CPICConfirmState 6
$CPICConfirmSendState 7
$CPICConfirmDeallocateState 8
$CPICDeferReceiveState 9
$CPICDeferDeallocateState 10

Valores de dados recebidos

Mnemônico Valor
$CPICNoDataReceived 0
$CPICDataReceived 1
$CPICCompleteDataReceived 2
$CPICIncompleteDataReceived 3

Valores do tipo de desalocação

Mnemônico Valor
$CPICDeallocateSyncLevel 0
$CPICDeallocateFlush 1
$CPICDeallocateConfirm 2
$CPICDeallocateAbend 3

Valores de detecção de erros

Mnemônico Valor
$CPICReceiveError 0
$CPICSendError 1

Valores do tipo de preparação para recepção

Mnemônico Valor
$CPICPrepToReceiveSyncLevel 0
$CPICPrepToReceiveFlush 1
$CPICPrepToReceiveConfirm 2

Valores do tipo de recepção

Mnemônico Valor
$CPICReceiveAndWait 0
$CPICReceiveImmediate 1

Valores recebidos de pedido de envio

Mnemônico Valor
$CPICReqToSendNotReceived 0
$CPICReqToSendReceived 1

Valores de níveis de sincronização

Mnemônico Valor
$CPICNone 0
$CPICConfirm 1
$CPICSyncPoint 2

Valores de controle de retorno

Mnemônico Valor
$CPICWhenSessionAllocated 0
$CPICImmediate 1

Valores de tipo de envio

Mnemônico Valor
$CPICBufferData 0
$CPICSendAndFlush 1
$CPICSendAndConfirm 2
$CPICSendAndPrepToReceive 3
$CPICSendAndAllocate 4

Valores de status recebidos

Mnemônico Valor
$CPICNoStatusReceived 0
$CPICSendReceived 1
$CPICConfirmReceived 2
$CPICConfirmSendReceived 3
$CPICConfirmSendReceived 4
$CPICTakeCommit 5
$CPICTakeCommitSend 6
$CPICTakeCommitDeallocate 7

Valores do tipo de segurança da conversação

Mnemônico Valor
$CPICSecurityNone 0
$CPICSecuritySame 1
$CPICSecurityProgram 2

Valores do tipo de nome do TP

Mnemônico Valor
$CPICApplicationTP 0
$CPICSNAServiceTP 1

Tipos de conversação

Mnemônico Valor
$CPICBasicConversation 0
$CPICMappedConversation 1

Tivoli Service Desk 6.0 Developer's Toolkit - Guia de APIs Existentes

Retornar ao Índice

Copyright