cciRegisterUserExit

Essa é uma função de utilitário que pode ser chamada pelo código do usuário durante a chamada de bipInitializeUserExits. É chamada pelo código do usuário se o usuário desejar registrar as funções a serem chamadas sempre que determinados eventos ocorrem.

Sintaxe

typedef struct cci_UEVft {
    int reserved;
    char StrucId[4];
    int Version;
    cciInputMessageCallback iFpInputMessageCallback;
    cciTransactionEventCallback iFpTransactionEventCallback;
    cciPropagatedMessageCallback iFpPropagatedMessageCallback;
    cciNodeCompletionCallback iFpNodeCompletionCallback;

} CCI_UE_VFT;

void cciRegisterUserExit (
  int*         returnCode,
    CciChar*    name,
  CciDataContext* userContext,
  CCI_UE_VFT* functionTable);

Parâmetros

returnCode (saída)
Requer o código de retorno da função. Os valores possíveis são:
  • CCI_DUP_USER_EXIT_NAME

    O nome especificado corresponde ao nome de uma saída de usuário anteriormente registrada no grupo de execução atual.

  • CCI_INV_USER_EXIT_NAME

    O nome especificado era inválido. Isso pode ser causado se foi especificado um ponteiro NULL, uma cadeia vazia ou uma cadeia que não contém caracteres alfanuméricos.

Nome (entrada)
Ele deve conter um ponteiro para a cadeia terminada em NULL de CciChars especificando um nome para a saída de usuário. O nome deve ser exclusivo em todas as saídas dos usuários que podem ser instaladas no mesmo intermediário. Esse nome é utilizado para identificar a saída do usuário, por exemplo, em:
  • Mensagens de Rastreio de Usuário
  • Exceções ou mensagens syslog
  • Comandos de administração (por exemplo, mqsichangeflowuserexits)
O nome tem as seguintes restrições:
  • Ele deve consistir apenas em caracteres alfanuméricos.
  • Ele deve ter no máximo 255 caracteres.
  • O nome deve ser exclusivo em todas as saídas dos usuários que podem ser instaladas no mesmo intermediário.
userContext (entrada)
Permite ao responsável pela chamada fornecer um ponteiro de contexto transmitido para a função de retorno de chamada, durante a chamada. Este parâmetro pode ser NULL.
functionTable (entrada)
Este é um ponteiro para uma estrutura cujos campos devem conter ponteiros para funções que correspondam a assinaturas corretas ou contenham NULL. Um valor NULL para qualquer um desses campos indica que a saída do usuário não deve ser chamada para aquele evento.

Valores de Retorno

Nenhum Se ocorrer um erro, o parâmetro returnCode indica o motivo do erro.

Exemplo

extern "C"{

void bipInitializeUserExits(){

  int              rc = CCI_SUCCESS;
  CCI_UE_VFT myVft = {CCI_UE_VFT_DEFAULT};
  myVft.iFpInputMessageCallback = myInputMessageCallback;
  myVft.iFpTransactionEventCallback = myTransactionEventCallback;
  myVft.iFpPropagatedMessageCallback = myPropagatedMessageCallback;
  myVft.iFpNodeCompletionCallback = myNodeCompletionCallback;
  
  cciRegisterUserExit(&rc,
                      MyConstants::myUserExitName,
                      0,
                      &myVft);

  /* agora verifique o rc a procura de valores inesperados*/
  
  return;
}

}/* fim do "C" externo*/
Conceitos relacionados
Desenvolvendo Saídas do Usuário
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as35920_