IBM Books [Return to Library] [Contents] [Previous Topic] [Bottom of Topic] [Next Topic] [Help]

User's Guide


Configuring the MQSeries Internet Gateway

This page describes how to configure your MQSeries Internet Gateway to use your own MQSeries resources and applications.

The following topics are covered:


MQSeries Internet Gateway keywords

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:
  1. 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.)

  2. Keyword values can be stored in your own named 'INI' files

  3. Default values for the following keywords are supplied in the file 'dmq.ini' which is provided with MQSeries Internet Gateway
    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:

  1. The HTML form
  2. The 'INI' file named in the MQIGwIniFile keyword
  3. 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:

Setting keywords

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.

  1. 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.

  2. When the panel appears,

  3. A panel is displayed showing the keywords in the file you have chosen, and their current values.

  4. 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.

  5. 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.

[Return to Library] [Contents] [Previous Topic] [Top of Topic] [Next Topic] [Help]


[ Home | Order | Search | Contact IBM | Legal ]
(C) IBM Corporation 1997. All Rights Reserved