+

Search Tips   |   Advanced Search

createWMQQueue command


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

To run the command, use AdminTask of the wsadmin scripting client.

This command is valid only when it is used with WAS V7 and later appservers. Do not use it with earlier versions.

For a list of the available WebSphere MQ messaging provider admin commands, plus a brief description of each command, enter the following command at the wsadmin prompt:

print AdminTask.help('WMQAdminCommands')

For overview help on a given command, enter the following command at the wsadmin prompt:

print AdminTask.help('command_name')

After using the command, save the changes to the master configuration. For example, use the following command:

AdminConfig.save()

 

Purpose

Use the createWMQQueue command to create a WebSphere MQ messaging provider queue type destination at a specific scope. We cannot create a WebSphere MQ messaging provider queue type destination under either of the following conditions:

 

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 admin name assigned to this WebSphere MQ messaging provider queue type destination.

-jndiName

The name used to bind this object into WAS JNDI.

 

Optional parameters

-description

An admin description assigned to the queue type destination.

-queueName

The name of the WebSphere MQ queue to use to store messages for the WebSphere MQ messaging provider queue type destination definition.

-qmgr

The queue manager on which the WebSphere MQ queue resides

-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 case-sensitive values:

  • APP

  • QDEF

or enter 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 case-sensitive values:

  • APP

  • UNLIM

or enter any positive integer.

The default value is APP.

-ccsid

The coded character set identifier.

The value of this parameter must be a positive integer.

The default value is 1208.

-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.

Enter one of the following case-sensitive values: true or false.

The default value is true.

-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 YES.

-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 YES.

-readAheadClose

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

The default value is YES.

-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.

-customProperties are multi-step command parameters, consisting of tuples of -name and -value parameters.

 

Example

Example

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




 

Related tasks


Use AdminTask for scripted administration
Start wsadmin

 

Related


WMQAdminCommands
manageWMQ
migrateWMQMLP
deleteWMQQueue
listWMQQueues
modifyWMQQueue
showWMQQueue
Mapping of admin console panel names to command names and WebSphere MQ names
WMQAdminCommands