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.

[IBM i][IBM i]O cliente de script wsadmin é executado do Qshell. [IBM i]Para obter informações adicionais, consulte Configurando o Qshell para Executar Scripts do WebSphere Usando o Script wsadmin.

A ajuda da linha de comandos é fornecida para comandos do barramento de integração de serviços:
  • 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')

Após utilizar o comando, salve suas alterações na configuração principal, utilizando o seguinte comando:

AdminConfig.save()

Finalidade

Um servidor IBM MQ representa um gerenciador de filas ou um grupo de filas compartilhadas do IBM MQ (para IBM MQ for z/OS). Este comando cria um novo servidor IBM MQ no escopo da célula, e usa os valores fornecidos para preencher seus parâmetros.
Nota: Ao criar um servidor IBM MQ, é importante entender o significado dos parâmetros -name e -serverName. Por exemplo, se a administração do WebSphere Application Server criasse um objeto do servidor IBM MQ com o nome "My European area server" que representasse um gerenciador de filas do IBM MQ com a QM1 de serverName. A administração do WebSphere Application Server poderia em seguida, criar um segundo objeto do servidor IBM MQ com o nome "My UK country server", que também representasse o mesmo gerenciador de filas do IBM MQ com a QM1 de serverName.

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.
O padrão é TRUE.
-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.
O padrão é TRUE.
-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}

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjfp_cli_mqserver_create
Nome do arquivo: rjfp_cli_mqserver_create.html