cciRegisterUserExit

cciRegisterUserExit é uma função de utilitário que pode ser chamada pelo código do usuário quando bipInitializeUserExits é chamado.

Esta função é chamada pelo código do usuário se o usuário desejar registrar funções a serem chamadas toda vez que determinados eventos ocorrerem.

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. Isto pode ser causado se um ponteiro NULO, cadeia vazia ou uma cadeia contendo caracteres não-alfanuméricos foi especificada.

Nome (entrada)
Este parâmetro deve conter um ponteiro para uma cadeia finalizada com NULO 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 não deve ser maior que 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)
Este parâmetro permite que o responsável pela chamada forneça um ponteiro de contexto que é transmitido para a função de retorno de chamada quando ela é chamada. Este parâmetro pode ser NULL.
functionTable (entrada)
Este parâmetro é um ponteiro para uma estrutura cujos campos devem conter ponteiros para funções que correspondem a assinaturas corretas ou conter NULO. Um valor NULO para qualquer um destes campos indica que a saída de usuário não deve ser chamada para esse 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
Saídas de usuário
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:13:13

as35920_