cjmsicmd create dst (creating physical destination)
- Organization of this page
Format
cjmsicmd create dst -t destination-type -n destination-name [[-o property = value]...] [-b host-name : port-number]
Function
Creates a physical destination.
Arguments
- -t destination-type
-
Specifies destination type. You can specify the following destination types:
-
q: Queue
-
t: Topic
-
- -n destination-name
-
Specifies the destination name.
The following are the naming rules for a destination:
-
Specify alphanumeric characters.
-
Specify the initial character with roman characters, underscore (_), and dollar sign ($).
-
You cannot specify the character mq. and numeric characters as a first character.
-
You cannot specify __JMQAdmin, because __JMQAdmin is the physical destination name that is generated automatically by Cosminexus JMS Provider.
-
You cannot specify a space.
-
Specify a name within the length of the OS's maximum-directory-name-length minus 1. If you specify a name exceeding the length of the OS's maximum-directory-name-length minus 1, the command is successfully executed, but an exception occurs when a message is sent.
-
- -o property=value
-
Specifies the property name.
The following properties can be used with the -o option:
-
consumerFlowLimit
-
maxNumMsgs
-
maxTotalMsgBytes
-
maxNumProducers
When an invalid value is specified, an error message will be displayed.
For details about the property, see 5.7 Property settings of physical destination.
-
- -b host-name : port-number
-
Specifies the host name and the port number by delimiting them using a colon (:).
Return values
- 0:
-
The command is terminated normally.
- 1:
-
The command is terminated abnormally.
Notes
-
If the destination type differs for each CJMSP Broker instance, you can create a physical destination with the same name. However, when the destination type is same, you cannot create the physical destination with the same name.
-
If there are different CJMSP Broker instances, you can create the physical destination with the same name.
-
Set imq.autocreate.queue(topic).consumerFlowLimit in the separate CJMSP Broker property file. When you execute this command without specifying consumerFlowLimit with the -o option, the specified number of messages can be delivered in imq.autocreate.queue(topic).consumerFlowLimit at the created physical destination. When you do not set imq.autocreate.queue(topic).consumerFlowLimit, the queue is 100 and the topic is 1000 (default value of consumerFlowLimit) for the number of messages that can be delivered.