4
Frequently Asked Questions

This chapter provides answers to frequently asked questions about the MQ Series adapter. This chapter discusses the following topics:

• Installation and General Questions

• Design Time Questions

Installation and General Questions

The following questions address installation and other concepts of the MQ Series adapter.

How do I know the MQ Series adapter has started properly?

View the oai.txt file located in the appropriate timestamped subdirectory of the MQ Series adapter log directory:

Platform	Directory
UNIX	ORACLE_HOME/oai/9.0.4/adapters/Application/log/timestamp_in_milliseconds
Windows	ORACLE_HOME\oai\9.0.4\adapters\Application\log\timestamp_in_milliseconds

The MQ Series adapter did not start properly - what went wrong?

Inspect the exceptions in the oailog.txt file. The exceptions provide information about what went wrong. One reason is that the MQ Series adapter cannot connect to the repository. Make sure the repository is started properly and the MQ Series adapter connects to the repository once it is started properly. You do not need to restart the MQ Series adapter.

See Also: Oracle Application Server InterConnect User's Guide for instructions on starting the repository on UNIX and Windows

Design Time Questions

The following are design time questions for the MQ Series adapter.

When I change an element in iStudio, such as mappings, it seems like the MQ Series adapter is using old information - what is happening?

The MQ Series adapter caches the information from iStudio that is stored in the repository locally for better performance. If you change something in iStudio and want to see the change in the runtime, you need to stop the MQ Series adapter, delete the MQ Series adapter cache files, and restart the MQ Series adapter.

The MQ Series adapter has a persistence directory located in the MQ Series adapter directory. Deleting this directory when the MQ Series adapter has been stopped should make it obtain the new metadata from the repository when started.

How do I secure any of the inifile parameters?

In order to encrypt any values specified in an .ini file, complete the following steps:

1. Locate the value to be encrypted.

2. Run the encrypt utility in OAI_HOME/bin directory to encrypt the above value.

3. Prefix the name of the parameter in the .ini file with encrypted_.

4. Replace the value with the new encrypted value from step 2.

Example:

To encrypt the password for the mq.default.password parameter, replace mq.default.password=mqm with the following:

encrypted_mq.default.password=112411071071106510801094108410731070107110811069

I am getting a JMS-nnnn error when the MQ Series adapter is starting up - what is wrong?

Look up the error code in the IBM MQ Series for Java guide Messages Appendix and correct any spelling mistakes for the MQ Series connection information in adapter.ini. The following lists some common error codes:

• 2009 MQRC_CONNECTION_BROKEN--The connection to the queue manager has been lost. This can occur because the queue manager has ended. All previous handles are now invalid, so the MQ Series adapter should be restarted.

• 2030 MQRC_MSG_TOO_BIG_FOR_Q--The message length is greater than the maximum for the queue. Increase MaxMsgLength for the queue (MQ Series Administrator).

• 2031 MQRC_MSG_TOO_BIG_FOR_Q_MGR--The message length is greater than the maximum allowed by the remote queue manager. This reason also occurs if a channel, through which the message is to pass, has restricted the maximum message length to a value that is actually less than that supported by the queue manager and the message length is greater than this value.

• 2035 MQRC_NOT_AUTHORIZED--The user is not authorized to perform the operation attempted. Make sure the mq.default.user and mq.default.password parameters in adapter.ini are correct.

More error codes can be found at the following url: http://www-4.ibm.com/software/ts/mqseries/library/manuals/csqfao/CSQFAO1P.HTM.

I am sending files with names such as MQ.FailedMsg.<message-id> in the directory where the adapter.ini file is located. What does this mean?

The means that some outbound messages received from MQ Series did not parse successfully with any of the registered D3L files. Either one or more D3L files should be corrected or the MQ Series sending agent, which enqueued the message on the outbound queue, should correct the messages so they conform to one of the D3L files. If you configure the mq.default.receiver.exception.uri parameter in the adapter.ini file, the 'failed' messages will be enqueued on the configured exception queue.

Why am I getting the following error in the log file?

"MQMessageSender_run: The following exception occurred while invoking oracle.oai.agent.adapter.sdk.Agent.createMessageObject(xml). If the Published Message Type in iStudio was XML, try instead to use the Message Type Generic, setting the Object name to be the root element of the XML document."

The error message essentially also provides the solution to this problem.

Why do I get the "Unable to load message catalog -- mqji" error message when starting the MQ Series adapter?

This is a benign warning message from the MQ Series Java layer which can be avoided by adding the /opt/mqm/java/lib directory to the Java CLASSPATH before starting the MQ Series adapter (modifying the start script).