Comando createSIBWMQServer
Use o comando createSIBWMQServer para criar um novo servidor IBM MQ no escopo da célula.
É possível criar um novo servidor IBM MQ usando a ferramenta wsadmin, como descrito neste tópico, ou usando o console administrativo, conforme descrito em Criando uma definição do servidor IBM MQ.
Para executar o comando, utilize o objeto AdminTask do cliente de script wsadmin.
O cliente de script wsadmin é executado do Qshell.
Para obter informações adicionais, consulte Configurando o Qshell para Executar Scripts do WebSphere Usando o Script wsadmin.
- Para obter uma lista dos comandos de barramento de integração de
serviços disponíveis no Jython e uma breve descrição de cada comando, digite o seguinte
comando no prompt wsadmin:
print AdminTask.help('SIBAdminCommands')
- Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:
print AdminTask.help('command_name')
AdminConfig.save()
Finalidade
Objeto de Destino
Uma célula do WebSphere Application Server.
Parâmetros Requeridos
- -name
- O nome do servidor IBM MQ. Este valor serve apenas para propósitos administrativos e pode ser decidido pelo administrador. O nome é significativo apenas dentro da administração do WebSphere Application Server e deve ser exclusivo no nível da célula. Não há valor padrão. Este parâmetro não pode ser modificado.
- -serverName
- O nome do gerenciador de filas ou do grupo de filas compartilhadas. Este valor é o nome pelo qual o gerenciador de filas ou o grupo de filas compartilhadas é identificado e é alocado pela administração do IBM MQ para o objeto do IBM MQ. O administrador do WebSphere Application Server sempre deve usar o nome alocado pela administração do IBM MQ.
- -host
- O host com o qual uma conexão é estabelecida para comunicação com um gerenciador de
filas ou com um grupo de filas compartilhadas. Esse valor é o nome do host ou o endereço IP do gerenciador de filas ou do grupo de filas compartilhadas, que esse servidor IBM MQ representa. O valor é uma cadeia e deve ser um dos seguintes:
- nome do host simbólico
- Endereço IPv4
- Endereço IPv6
- -transportChain
- A cadeia de transporte de saída da estrutura do canal a ser utilizada ao estabelecer uma conexão com o IBM MQ. Se você não especificar esta opção, será assumido o valor padrão de OutboundBasicWMQClient.
Parâmetros Condicionais
Nenhum(a)
Parâmetros Opcionais
Os atributos opcionais de host, porta, canal e alias de autenticação juntos especificam o caminho de acesso de conexão para esse servidor IBM MQ, para aplicativos de sistemas de mensagens em execução na integração de serviço. Para obter informações adicionais, consulte Servidor IBM MQ: conexão e autenticação.
- -port
- O número da porta TCP/IP na qual o gerenciador de filas ou o grupo de filas compartilhadas que esse servidor IBM MQ representa atende. O valor padrão é 1414.
- -channel
- O nome do canal do cliente do IBM MQ a ser usado ao conectar-se com o gerenciador de filas ou com grupo de filas compartilhadas que este servidor IBM MQ representa. Este valor é o nome alocado pela administração do IBM MQ para o objeto do IBM MQ e deve ser sempre usado pela administração do WebSphere Application Server. O valor padrão é SYSTEM.DEF.SVRCONN.
- -description
- Uma descrição simples do servidor IBM MQ. Este valor é utilizado apenas para propósitos administrativos.
- -securityAuthAlias
- O alias de autenticação a ser usado ao conectar-se a um gerenciador de filas ou a um grupo de filas compartilhadas. Este parâmetro não deve ser confundido com o alias de autenticação de descoberta.
- -trustUserIds
- Determina se os IDs do usuário recebidos em mensagens do IBM MQ serão transmitidos com as mensagens pelo barramento de integração de serviços. O ID do usuário do aplicativo é sempre configurado a partir do valor RFH2 jsAppUserId. Se ele não estiver presente (porque o par de chave/valor não está presente no cabeçalho
RFH2 ou porque a mensagem não possui um cabeçalho RFH2), este campo não será
configurado. Se você configurar esse valor como FALSE, o ID do usuário será sobrescrito pelo nome do servidor IBM MQ. Este parâmetro possui dois valores possíveis:
- TRUE
- Os IDs são propagados para mensagens.
- FALSE
- Os IDs não são propagados para mensagens.
- -allowDiscovery
- Determina se a descoberta automatizada de recursos do IBM MQ
será desempenhada.
Este parâmetro possui dois valores possíveis:
- TRUE
- A descoberta automatizada será utilizada.
- FALSE
- A descoberta automatizada não será utilizada.
- -discoveryAuthAlias
- O alias de autenticação a ser usado ao estabelecer uma conexão da descoberta de recursos com o gerenciador de filas ou com o grupo de filas compartilhadas. Este valor não deve ser confundido com o alias de autenticação de segurança.
- -replyToQueue
- A fila de resposta a ser utilizada para descoberta de recursos. Este valor é o nome alocado pela administração do IBM MQ para o objeto do IBM MQ e deve ser o nome de uma fila modelo para uma fila dinâmica temporária. O administrador do WebSphere Application Server sempre deve usar o nome alocado pela administração do IBM MQ. O padrão é SYSTEM.DEFAULT.MODEL.QUEUE.
- -type
- Determina se o objeto do servidor IBM MQ é um gerenciador de filas ou um grupo de filas compartilhadas, conforme determinado pela administração do WebSphere Application Server.
Este parâmetro tem dois valores possíveis:
- MQ_QUEUE_MANAGER
- O servidor IBM MQ representa um gerenciador de filas. Se você selecionar este valor, o processo de descoberta de recursos recuperará os nomes de filas que pertencem a gerenciadores de filas.
- MQ_QUEUE_SHARING_GROUP
- O servidor IBM MQ representa um grupo de filas compartilhadas. Se você selecionar este valor, o processo de descoberta de recursos recuperará os nomes de filas que pertencerem aos grupos de filas compartilhadas.
- -bindingsMode
- Determina se as conexões de modo de transporte de ligações serão usadas
ao conectar-se a um gerenciador de filas ou a um grupo de filas compartilhadas.
A conexão de modo de ligações
estará disponível se o servidor de aplicativos e o gerenciador de filas estiverem
no mesmo nó. É possível conectar-se a um único gerenciador de filas apenas no modo de ligações,
mesmo que existam vários gerenciadores de filas no mesmo nó. Este parâmetro possui dois valores possíveis:
- TRUE
- O modo de ligações será utilizado, se disponível. Se você selecionar esta opção e o modo de ligações não estiver disponível, o mecanismo de conexões será padronizado como o modo de transporte do cliente.
- FALSE
- O modo do cliente é sempre utilizado.
Por exemplo:
- Utilizando Jython:
wsadmin>AdminTask.createSIBWMQServer(["-name", "Finance dept QM", "-serverName", "FDQM", "-type", "MQ_QUEUE_MANAGER", "-bindingsMode", "true", "-host", "findep01.ibm.com", "-port", 1414, "-transportChain", "OutboundSecureWMQClient"])
- Utilizando Jacl:
wsadmin>$AdminTask createSIBWMQServer {-name "Finance dept QM" -serverName FDQM -type MQ_QUEUE_MANAGER -bindingsMode true -host findep01.ibm.com -port 1414 -transportChain OutboundSecureWMQClient}