jmscreate

Description

Creates a JMS entity.

Syntax

Local-mode support: No.

Command line:

jmscreate connect-args entity [file]

Ant build file:

<jag_jmscreate entity=”entity” [ file=”file” ] />

Option

Description

Required

connect-args

Arguments to specify a connection to the server. See “Using connected mode”.

Yes

entity

The entity to create, in the form EntityType:EntityName. Valid entity types are:

  • MessageQueue

  • MessageTopic

  • QueueConnectionFactory

  • ThreadPool

  • TopicConnectionFactory

Yes

file

An optional file containing properties for the entity. The file must specify properties in the form of an EAServer repository properties file. You can set properties after the entity exists with the jmsset_props command.

No

Returns

Return value

Indicates

0

The command ran successfully; the result is true/success.

2

The command did not run successfully; an exception was thrown.

Examples

Example 1

This example uses the command line to create a message queue named MyQueue and specifies a properties file:

jagtool jmscreate MessageQueue:MyQueue D:\Jag41005\sample\jagtool\queueprops.txt

Example 2

This example does the same thing in an Ant build file:

<jag_jmscreate entity="MessageQueue:AntQueue" file="D:\Jag41005\sample\jagtool\queueprops.txt" />

See also

jmsdelete, jmslist, jmsprops, jmsset_props

Chapter 2, “Setting up the Message Service” the EAServer JMS User’s Guide.