Configurando um cliente transacional estendido para CICS

Inclua a definição de recurso XAD usando o comando CICS definição de recurso online (RDO), cicsadd. A definição de recurso XAD especifica as seguintes informações:

• Uma sequência xa_open
• O nome do caminho completo de um arquivo de carregamento do comutador

Um arquivo de carregamento de comutação é fornecido para uso por CICS em cada uma das seguintes plataformas:

• AIX®
• Windows

Cada arquivo de carregamento do comutador contém uma função que retorna um ponteiro para a estrutura do comutador XA que é usada para registro dinâmico, MQRMIXASwitchDynamic. Consulte a Tabela 1 para obter o nome do caminho totalmente qualificado de cada arquivo de carga do switch.O MQ_INSTALLATION_PATH representa o diretório de alto nível no qual o IBM® MQ está instalado.

Aqui está um exemplo de uma definição de recurso XAD para sistemas Windows :

cicsadd -c xad -r REGION1 WMQXA \
    ResourceDescription="IBM MQ queue manager MARS" \
    XAOpen="channel=MARS.SVR,trptype=tcp,conname=MARS(1415),qmname=MARS,tpm=cics" \
    SwitchLoadFile="C:\Program Files\IBM\MQ\bin\mqcc4swi.dll"

Para obter mais informações sobre a inclusão de uma definição de recurso XAD em uma região CICS , consulte o CICS Referência de Administração e o CICS Guia de Administração para sua plataforma.

Observe as informações a seguir sobre o uso de CICS com um cliente transacional estendido:

• É possível adicionar apenas uma definição de recurso XAD para IBM MQ a uma região CICS . Isso significa que apenas um gerenciador de filas pode ser associado a uma região, e todos os aplicativos CICS que são executados na região podem se conectar apenas a esse gerenciador de filas. Se você deseja executar aplicativos CICS que se conectam a um gerenciador de filas diferente, você deve executar os aplicativos em uma região diferente.
• Cada servidor de aplicativos em uma região chama xa_open enquanto ele está inicializando e inicia um canal MQI no gerenciador de filas associado à região. Isto significa que o gerenciador de filas deve ser iniciado antes de um servidor de aplicativos iniciar, caso contrário a chamada xa_open falhará. Todos os aplicativos IBM MQ MQI client posteriormente processados pelo servidor de aplicativos utilizam o mesmo canal de MQI.
• Quando um canal MQI é iniciado e não há saída de segurança na extremidade do cliente do canal, o ID do usuário que segue a partir do sistema do cliente para a conexão do servidor MCA está cics. Sob determinadas circunstâncias, o gerenciador de filas usa este ID do usuário para verificações de autoridade quando o MCA de conexão do servidor tenta subsequentemente acessar os recursos do gerenciador de filas em nome de um aplicativo cliente. Se este ID do usuário for usado para verificações de autoridade, é necessário assegurar que ele tenha a autoridade para acessar todos os recursos que ele precisa acessar.

  Para obter informações sobre quando o gerenciador de filas utiliza este ID de usuário para verificações de autoridade, consulte Securing.

• As saídas de finalização de tarefas CICS que são fornecidas para uso em sistemas clientes IBM MQ são listadas na Tabela 2 . Você configura essas saídas da mesma forma que você configura as saídas correspondentes para os sistemas do servidor IBM MQ . Portanto, para obter essas informações, consulte Ativando as saídas de usuário do CICS.

  Tabela 2. CICS saídas de finalização de tarefas

  Plataforma	Origem	Biblioteca
  AIX Linux	amqzscgx.c	amqczscg
  Windows sistemas	amqzscgn.c	mqcc1415.dll