User's Guide
This page describes how to configure your MQSeries Internet Gateway to use your own
MQSeries resources and applications.
The following topics are covered:
Information about which MQSeries resources should be used by messages passing through the MQSeries
Internet Gateway, is conveyed through the following keywords:
- MQIGwQueue
- MQSeries application queue name - the queue on which the message will be put
- MQIGwReplyQueue
- MQSeries Gateway queue name - the queue from which the MQSeries Internet Gateway retrieves
messages
- MQIGwQueueManager
- Name of the MQSeries queue manager that is to be used
- MQIGwWaitInterval
- The time in milliseconds that the gateway should wait for a reply.
- MQIGwWaitHTML
- The name of the HTML file that should be displayed if a timeout occurs.
This HTML should contain a message indicating that the wait time has expired, and it should also contain a button to
enable the message reply to be retrieved at a later date. See
Writing HTML forms for MQSeries Internet Gateway
for a simple example of a timeout page, timedout.htm, which is stored in the
Gateway files directory of your installation.
- MQIGwContext
- Which context information should be sent to the application.
This keyword can be set to the following values:
- None
- None of the contextual information is passed to the serving application.
- All.
- All the following contextual information is passed to the serving application:
- AUTH_TYPE | - REQUEST_METHOD | - QUERY_STRING |
- HTTP_ACCEPT | - REMOTE_HOST | - REMOTE_USER |
- HTTP_REFERER | - REMOTE_ADDR | - REMOTE_IDENT |
- HTTP_USER_AGENT | - SCRIPT_NAME | - SERVER_SOFTWARE |
- HTTP_RESPONSE | - CONTENT_TYPE | - SERVER_NAME |
- HTTP_REASON | - CONTENT_LENGTH | - GATEWAY_INTERFACE |
- SERVER_PROTOCOL | - PATH_INFO |
- SERVER_PORT | - PATH_TRANSLATED |
Click here to see examples of the information that is returned when this keyword is set.
- MQIGwIniFile
- The name of an INI file that can be used to hold default values for any of the other keywords.
The value for these keywords can be provided in the following ways:
- All the keywords can have values specified in the HTML form that is used to send messages
through the Gateway.
Note: This is the only place that you can set MQIGwIniFile if you wish to use
values that are stored in your own named 'INI' file. (See (2) below.)
- Keyword values can be stored in your own named 'INI' files
- Default values for the following keywords are supplied in the file
'dmq.ini' which is provided with MQSeries Internet Gateway and is found in /var/mqm on
the UNIX platforms and mqm\bin on OS/2 and WindowsNT.
- MQIGwReplyQueue
- DMQGATEWAY
- MQIGwWaitInterval
- 10000 ms
- MQIGwContext
- All
Note: Although any one keyword can be set in any or all of the places described above, take care not to define a
particular keyword more than once in any one place as this can lead to unpredictable results.
MQSeries Internet Gateway searches the various keyword definition sources in the
following order:
- The HTML form
- The 'INI' file named in the MQIGwIniFile keyword
- The dmq.ini file
If no valid values are found for the following keywords, basic default values are used:
- MQIGwQueueManager
- Basic default is the MQSeries default queue manager
Note: On MVS there is no default queue manager and you must set
the value of MQIGwQueueManager by one of the methods described above.
- MQIGwWaitInterval
- Basic default is unlimited wait interval
- MQIGwWaitHTML
- Basic default is 'timedout.htm' which is stored in the Gateway files directory of your installation.
- MQIGwContext
- Basic default is all
If no valid values are found for any of the following keywords, the transaction cannot be completed
and an error message is displayed:
- MQIGwQueue
- MQIGwReplyQueue
- MQIGwQueueManager
You can change the value of the keyword defaults in 'dmq.ini', and you can also create
your own 'INI' files to store keyword values.
A configurator program is supplied with MQSeries Internet Gateway to assist you in changing
and creating the default, and your own 'INI' files.
Note: You are strongly advised to use this program, and not to use an editor to modify or edit your 'INI'
files. Editors are likely to corrupt the format of 'INI' files.
The configurator is supplied as an HTML file that can be run in a
Web browser.
Use the following procedure to perform your configuration.
- Open the MQSeries Internet Gateway file 'dmqcnf.htm' in your Web
browser. (Note: The program will only run from this link if you are viewing the
documentation that is installed on your Web server machine.)
This file is stored in the documentation directory of your MQSeries Internet Gateway installation.
- When the panel appears,
- If you want to to modify the default INI file (dmq.ini) that is supplied with the gateway, click
the Submit button
- If you want to modify or create, another INI file, enter the name of the file and then click on Submit
- A panel is displayed showing the keywords in the file you have chosen, and their current values.
- If you want to alter the value of one of the displayed keywords, overtype the current value
- If you want to modify the default value of another keyword, type the keyword value into the Name input field and the new
value in the Value field.
- If you want to delete a keyword from the default values list, click on the delete box
beside the keyword.
Note:You are advised not to delete the MQSeries Internet Gateway keywords from the
'dmq.ini' file. If you delete MQIGwQueueManager, MQIGwReplyQueue, or
MQIGwQueue from this file, and do not supply values in another specified INI file, or your
HTML form, your transaction may not be able to complete.
-
- If you want to save your changes to the file that is displayed in the Save as field, click on Apply
- If you want to save the modified file with a new name, enter the new name in the Save as field and then click on Apply
The keyword list is updated with your changes.
If you have chosen to save to a file that already exists and contains some keywords, the complete list of keywords in the file is
displayed.
- If you want to add further keywords, or make further modifications to the values in the list, repeat the procedures described
above.
Note: Imbedded blanks are not allowed in keyword names.
If you have modified the 'dmq.ini' file, the new values will be used as your defaults next
time you use the MQSeries Internet Gateway to send an MQ message. If you have modified or created
your own 'INI' file, the new values will be used the next time you use a form which sets the
MQIGwIniFile keyword to your 'INI' file name.
![[Help]](images/help.gif)
[ Home |
Order |
Search |
Contact IBM |
Legal ]
(C) IBM Corporation 1997. All Rights Reserved