createWMQQueue command

Use the createWMQQueue command to create a queue type destination for the WebSphere® MQ messaging provider at a specific scope.

Para executar o comando, use o objeto AdminTask do cliente de script wsadmin.

[IBM i]O cliente de script wsadmin é executado no Qshell. Para obter informações adicionais, consulte o tópico "Configurar o Qshell para Executar Scripts do WebSphere Application Server".

Esse comando é válido apenas quando for usado com o WebSphere Application Server Versão 7 e servidores de aplicativos posteriores. Não o utilize com versões anteriores.

Para obter uma lista de comandos administrativos do provedor de sistemas de mensagens existentes do IBM MQ, além de uma breve descrição de cada comando, insira o seguinte comando no prompt wsadmin:

print AdminTask.help('WMQAdminCommands')

Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:

print AdminTask.help('command_name')

Depois de utilizar o comando, salve suas alterações na configuração principal. Por exemplo, utilize o seguinte comando:

AdminConfig.save()

Purpose

Use the createWMQQueue command to create a WebSphere MQ messaging provider queue type destination at a specific scope.

You cannot create a WebSphere MQ messaging provider queue type destination under either of the following conditions:
  • A WebSphere MQ messaging provider queue type destination already exists with the same name, at the same scope.
  • The JNDI name clashes with another entry in WebSphere Application Server JNDI.

Target object

The scope of the WebSphere MQ messaging provider at which the WebSphere MQ messaging provider queue type destination is to be created.

Required parameters

-name
The administrative name assigned to this WebSphere MQ messaging provider queue type destination.
-jndiName
The name used to bind this object into WebSphere Application Server JNDI.
-queueName
The name of the WebSphere MQ queue to use to store messages for the WebSphere MQ messaging provider queue type destination definition.

Optional parameters

-description
An administrative description assigned to the queue type destination.
-qmgr
The queue manager that hosts the WebSphere MQ queue.
-persistence
This parameter determines the level of persistence used to store messages sent to this destination.
Enter one of the following case-sensitive values:
  • APP
  • QDEF
  • PERS
  • NON
  • HIGH

The default value is APP.

-priority
The priority level to assign to messages sent to this destination.
Enter one of the following values:
  • APP
    Note: (APP is case-sensitive.)
  • QDEF
    Note: (QDEF is case-sensitive.)
  • <A positive integer in the range 0 to 9 (inclusive)>

The default value is APP.

-expiry
The length of time after which messages sent to this destination expire and are dealt with according to their disposition options.
Enter one of the following values:
  • APP
    Note: (APP is case-sensitive.)
  • UNLIM
    Note: (UNLIM is case-sensitive.)
  • <Any positive integer>

The default value is APP.

-ccsid
The coded character set identifier (CCSID).

The value of this parameter must be a positive integer or blank. See the Configurações de propriedades avançadas de fila e tópico do provedor de sistemas de mensagens IBM MQ for more details.

The default value is 1208.

Leaving this field empty indicates that the default value must be used.

-useNativeEncoding
This parameter specifies whether to use native encoding or not. It can take a value true or false.

If it is set to true, the values of the -integerEncoding, -decimalEncoding and -floatingPointEncoding attributes are ignored.

If it is set to false, the encoding is specified by the -integerEncoding, -decimalEncoding and -floatingPointEncoding attributes.

-integerEncoding
The integer encoding setting for this queue.

Enter one of the following case-sensitive values: Normal or Reversed.

The default value is Normal.

-decimalEncoding
The decimal encoding setting for this queue.

Enter one of the following case-sensitive values: Normal or Reversed.

The default value is Normal.

-floatingPointEncoding
The floating point encoding setting for this queue.

Enter one of the following case-sensitive values: IEEENormal, IEEEReversed, z/OS

The default value is IEEENormal.

-useRFH2
This parameter determines whether an RFH version 2 header is appended to messages sent to this destination, also know as targetClient..

Enter one of the following case-sensitive values: true or false (equivalent to JMS or MQ targetClient, respectively)..

The default value is true (JMS targetClient).

-sendAsync
This parameter determines whether messages can be sent to this destination without queue manager acknowledging that they have arrived.

Enter one of the following case-sensitive values: YES, NO or QDEF.

The default value is QDEF.

-readAhead
This parameter determines whether messages for non-persistent consumers can be read ahead and cached.

Enter one of the following case-sensitive values: YES, NO or QDEF.

The default value is QDEF.

-readAheadClose
This parameter specifies the read ahead close method for the message consumer.

Enter one of the following case-sensitive values: DELIVERALL, or DELIVERCURRENT.

The default value is DELIVERALL.

-customProperties
This parameter specifies custom properties to be passed to the WebSphere MQ messaging provider queue type destination implementation. Typically, custom properties are used to set attributes of the queue type destination that are not directly supported through the WebSphere administration interfaces.
Cada propriedade customizada é especificada usando os parâmetros de etapa de tabela nome e valor. Como são etapas de tabela, a ordem dos dois parâmetros é fixa, de modo que você deve especificar sempre primeiro o nome e depois o valor:
  • No Jython: [name value]
  • No Jacl: {name value}
Note: Nos exemplos a seguir, os blocos de códigos que iniciam com wsadmin> mostram o código que é inserido pelo usuário. As linhas que não iniciam com wsadmin> mostram o código que foi retornado pelo console.

The following example creates a WebSphere MQ messaging provider queue type destination.

  • Using Jython:
    wsadmin>AdminTask.createWMQQueue("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name queue1 -jndiName jms/queues/Q1
     -queueName APP1.QUEUE1"]) 
    queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQQueue_1098737234986) 
  • Using Jacl:
    wsadmin>$AdminTask createWMQQueue 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    {-name queue1 -jndiName jms/queues/Q1 -queueName APP1.QUEUE1} 
    queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQQueue_1098737234986) 

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



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