createWMQActivationSpec command


 

+

Search Tips   |   Advanced Search

 

Use the createWMQActivationSpec command to create an activation spec 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') eAfter using the command, save the changes to the master configuration. For example, use the following command:

AdminConfig.save()

 

Purpose

Use the createWMQActivationSpec command to create a WebSphere MQ messaging provider activation specification at a specific scope. We cannot create a WebSphere MQ messaging provider activation specification under either of the following conditions:

You create a CCDT based activation spec by specifying any of the following parameters:

If we do not specify any of the following parameters, you create a generic activation specification :

 

Target object

The scope of the WebSphere MQ messaging provider at which the WebSphere MQ messaging provider activation specification is to be created.

 

Required parameters

-name

The admin name assigned to this WebSphere MQ messaging provider activation specification.

-jndiName

The name and location used to bind this object into WAS JNDI.

-destinationJndiName

The JNDI name of a WebSphere MQ messaging provider queue or topic type destination. When an MDB is deployed with this activation specification, messages for the MDB are consumed from this destination.

-destinationType

The type of the destination specified using the -destinationJndiName parameter.Enter one of the following values:

  • javax.jms.Queue
  • javax.jms.Topic

There is no default value.

 

Optional parameters

-description

An admin description assigned to the activation specification.

-ccdtUrl

A URL to a client channel definition table to use, for this activation specification, when contacting WebSphere MQ.

Use this parameter to create ccdtURL activation specifications

Do not specify this parameter in conjunction with the following parameters: -qmgrName, -qmgrType, -qmgrHostname, -qmgrPortNumber, -qmgrSvrconnChannel, or -localAddress.

-ccdtQmgrName

A queue manager name, used to select one or more entries from a client channel definition table.

Specify if the -transportType has been specified as client or bindingsThenClient.

Do not specify this parameter in conjunction with the following parameters:

  • -qmgrName
  • -qmgrType
  • -qmgrHostname
  • -qmgrPortNumber
  • -qmgrSvrconnChannel
  • -localAddress

-qmgrName

The name of the queue manager to use, for this activation specification, when contacting WebSphere MQ.

Use this parameter to create generic activation specifications.

Do not specify this parameter in conjunction with the following parameters: -ccdtUrl or -ccdtQmgrName.

-wmqTransportType

Determines the way in which a connection is established to WebSphere MQ for this activation specification.

Use this parameter to create generic activation specifications. Enter one of the following case-sensitive values:

  • BINDINGS
  • BINDINGS_THEN_CLIENT
  • CLIENT

BINDINGS_THEN_CLIENT is the default value.

Do not specify this parameter in conjunction with the following parameters: -ccdtUrl or -ccdtQmgrName.

For more information about configuring a transport type of bindings then client or bindings, refer to...

-qmgrHostname

The host name to use, for this activation specification, when attempting a client mode connection to WebSphere MQ. It must be a valid TCP/IP host name or IPv4 or IPv6 address.

The default value is the local host.

Do not specify this parameter in conjunction with the following parameters: -ccdtUrl or -ccdtQmgrName.

-qmgrPortNumber

The port number to use, for this activation specification, when attempting a client mode connection to WebSphere MQ.

Enter an integer value in the range 1 - 65536 (inclusive).

The default value is 1414.

Do not specify this parameter in conjunction with the following parameters: -ccdtUrl or -ccdtQmgrName.

-authAlias

The authentication alias used to obtain the credentials specified when this activation spec needs to establish a connection to WebSphere MQ.

-clientId

The client identifier used for connections started using this activation specification.

-providerVersion

Determines the minimum version, and capabilities of the queue manager.Enter values in one of the following formats:

  • n
  • n.n
  • n.n.n
  • n.n.n.n

where n is an integer greater than or equal to zero.

For example 6.0.0.0

-sslCrl

Specifies a list of LDAP servers that are used to provide certificate revocation information if this activation specification establishes an SSL based connection to WebSphere MQ.

-sslResetCount

Used when the activation spec establishes an SSL connection to the queue manager. This parameter determines how many bytes to transfer before resetting the symmetric encryption key used for the SSL session.

Enter a value in the range 0 through 999,999,999.

The default value is 0.

-sslPeerName

Used when the activation spec establishes an SSL connection to the queue manager. The value is compared with the distinguished name present in the peer's certificate.

-rcvExit

A comma-separated list of receive exit class names.

-rcvExitInitData

Initialization data to pass to the receive exit.

Do not specify this parameter unless specify the -rcvExit parameter.

-sendExit

A comma-separated list of send exit class names.

-sendExitInitData

Initialization data to pass to the send exit.

Do not specify this parameter unless specify the -sendExit parameter.

-secExit

A security exit class name.

-secExitInitData

Initialization data to pass to the security exit.

Do not specify this parameter unless specify the -secExit parameter.

-compressHeaders

Determines if message headers are compressed.Enter one of the following values:

  • NONE
  • SYSTEM

The default value is NONE.

-compressPayload

Determines if message payloads are compressed.Enter one of the following values:

  • NONE
  • RLE
  • ZLIBFAST
  • ZLIBHIGH

The default value is NONE.

-msgRetention

Determines if the connection consumer keeps unwanted messages on the input queue. Enter one of the following values:

  • YES
  • NO

where YES specifies that the connection consumer keeps unwanted messages on the input queue, and NO specifies that the messages are disposed of according to their disposition options.

The default value is YES.

-rescanInterval

When a message consumer in the point-to-point domain uses a message selector to select which messages it wants to receive, the JMS client searches the WebSphere MQ queue for suitable messages in the sequence determined by the MsgDeliverySequence attribute of the queue. When the client finds a suitable message and delivers it to the consumer, the client resumes the search for the next suitable message from its current position in the queue. The client continues to search the queue in this way until it reaches the end of the queue, or until the interval of time in milliseconds, as determined by the value of this -rescanInterval parameter has expired. In each case, the client returns to the beginning of the queue to continue its search, and a new time interval commences.

This parameter must be a positive integer value.

The default value is 5000.

-ccsid

The coded character set identifier to be used on connections.

The value of this parameter must be a positive integer.

The default value is 819.

-failIfQuiescing

Determines the behavior of certain calls to the queue manager when the queue manager is put into quiescing state.

The value of this parameter must be true or false.

true specifies that calls to certain methods fail if the queue manager is in a quiescing state. If an application detects that the queue manager is quiescing, the application can complete its immediate task and close the connection, allowing the queue manager to stop.

false specifies that no methods fail if the queue manager is in a quiescing state. If we specify this value, an application cannot detect that the queue manager is quiescing. The application might continue to perform operations against the queue manager, and therefore prevent the queue manager from stopping.

The default value is true.

-brokerCtrlQueue

The name of the broker control queue to use if this activation specification is to subscribe to a topic.

The default value is SYSTEM.BROKER.CONTROL.QUEUE.

-brokerSubQueue

The name of the queue to use for obtaining subscription messages if this activation spec is to subscribe to a topic.

The default value is SYSTEM.JMS.ND.SUBSCRIBER.QUEUE.

-brokerCCSubQueue

The name of the queue from which non-durable subscription messages are retrieved for a ConnectionConsumer.

The default value is SYSTEM.JMS.ND.CC.SUBSCRIBER.QUEUE.

-brokerVersion

The value of this parameter determines the level of functionality required for publish/subscribe operations.

Valid values are 1 and 2.

The default value is 1.

-msgSelection

Determines where message selection occurs.

Valid values are CLIENT and BROKER.

The default value is CLIENT.

-subStore

Determines where WebSphere MQ messaging provider stores persistent data relating to active subscriptions.

Valid values are MIGRATE, QUEUE and BROKER.

The default value is MIGRATE.

-stateRefreshInt

The interval, in milliseconds, between refreshes of the long running transaction that detects when a subscriber loses its connection to the queue manager. This parameter is relevant only if -subStore parameter has the value QUEUE.

The value of this parameter must be a positive integer.

The default value is 60,000.

-cleanupLevel

The cleanup level for BROKER or MIGRATE subscription stores.

Valid values are SAFE, NONE, NONDUR, STRONG and FORCE.

The default value is SAFE.

-cleanupInterval

The interval between background executions of the publish/subscribe cleanup utility.

The value of this parameter must be a positive integer.

The default value is 3,600,000.

-wildcardFormat

Determines which sets of characters are interpreted as topic wildcards.

Valid values are Topic or Char.

The default value is Char.

-sparseSubs

Controls the message retrieval policy of a TopicSubscriber object.

The value of this parameter must be true or false

The default value is false.

-brokerQmgr

The name of the queue manager on which the broker is running.

-clonedSubs

Determines whether two or more instances of the same durable topic subscriber can run simultaneously.

The value of this parameter must be ENABLED or DISABLED

The default value is DISABLED.

-qmgrSvrconChannel

The SVRCONN channel to use when connecting to WebSphere MQ.

Use this parameter to create explicitly defined activation specifications.

The default value is SYSTEM.DEF.SVRCONN.

Do not specify this parameter in conjunction with the following parameters: -ccdtUrl or -ccdtQmgrName.

-brokerCCDurSubQueue

The name of the queue from which a connection consumer receives durable subscription messages.

The default value is SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE.

-maxPoolSize

The maximum number of server sessions in the server session pool used by the connection consumer.

The value of this parameter must be a positive integer.

The default value is 10.

-messageSelector

A message selector expression specifying which messages are to be delivered.

The value of this parameter must be either the empty string or a valid SQL 92 statement.

-poolTimeout

The period of time, in milliseconds, that an unused server session is held open in the server session pool before being closed due to inactivity.

The value of this parameter must be a positive integer.

The default value is 300,000.

-startTimeout

The period of time, in milliseconds, within which delivery of a message to an MDB must start after the work to deliver the message has been scheduled. If this period of time elapses, the message is rolled back onto the queue.

The value of this parameter must be a positive integer.

The default value is 10,000.

-subscriptionDurability

Determines whether a durable or nondurable subscription is used to deliver messages to an MDB that is subscribing to the topic.

The value of this parameter must be Durable or Nondurable

The default value is Nondurable.

-subscriptionName

The name of the durable subscription.

-customProperties

Specifies custom properties to be passed to the WebSphere MQ messaging provider activation specification implementation. Typically, custom properties are used to set attributes of the activation spec which are not directly supported through the WebSphere administration interfaces.

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

-localAddress

Specifies either or both of the following:

  • the local network interface
  • the local port, or range of local ports

Do not specify this parameter in conjunction with the following parameters: -ccdtUrl or -ccdtQmgrName.

-sslType

Determines the configuration, if any, to use when applying SSL encryption to the network connection to the queue manager.

The value of this parameter must be CENTRAL, SPECIFIC or NONE

The -sslConfiguration parameter is not valid unless this parameter is set to SPECIFIC.

The default value is NONE.

-sslConfiguration

The name of the SSL configuration to use when using SSL to secure network connections to the queue manager.

Do not specify this parameter unless the parameter -sslType is assigned the value SPECIFIC.

The value of this parameter must correspond to an SSL configuration.

There is no default value.

-stopEndpointIfDeliveryFails

Indicates whether the endpoint should be stopped if message delivery fails the number of times specified by the failureDeliveryCount property.

The value of this parameter must be true or false.

The default value is true.

-failureDeliveryCount

Specifies the number of sequential delivery failures that are allowed before the endpoint is suspended. This value is only used if stopEndpointIfDeliveryFails is true.

The value of this parameter must be a non-negative integer.

The default value is 0, which means that the endpoint is stopped the first time it fails.

 

Example

The following example creates an activation specification, specifying the minimum number of parameters. Due to the default values assumed for the unspecified parameters, MDBs deployed using this activation specification are co-located with a generic queue manager installed on the same node.

 

Example

The following example creates an activation spec for which the user must specify and maintain all the parameters used for establishing a connection to WebSphere MQ.

 

Example

The following example creates an activation spec that uses a CCDT to locate the queue manager to connect to.




 

Related tasks

Use AdminTask for scripted administration
Start wsadmin
Set the WebSphere MQ messaging provider with native libraries information
Sizing the thread pools used by the WebSphere MQ messaging provider

 

Related

deleteWMQActivationSpec
listWMQActivationSpecs
modifyWMQActivationSpec
showWMQActivationSpec
Mapping of admin console panel names to command names and WebSphere MQ names
WMQAdminCommands