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

User's Guide


Verifying and Using MQSeries Internet Gateway

To use MQ applications through the MQSeries Internet Gateway you need to:
  1. Configure and start your Web server
  2. Set up some MQSeries resources
  3. Start your Web-aware applications
  4. Enter your message in a special HTML form and submit it to an MQSeries Web-aware application.
Web-aware applications are applications that have been written to interact with the Gateway.

Sample forms, and a sample Web-aware application are provided with the MQSeries Internet Gateway. You can use the sample dmqsamp1, with the default resources that are supplied during the installation, to run an initial verification test of your installation.

When you have verified your system with the sample, you can configure the Gateway to use your own resources, and use the sample forms and applications as templates from which to write your own.


Configuring and starting your Web server

When you have installed the MQSeries Internet Gateway files, you need to configure your Web server to find and recognize the Gateway. The configuration for all the servers maps an extension of '.mqf' to the MQSeries Internet Gateway program files. The HTML input forms are the same for all Web server interfaces and if you configure more than one interface for your server, the Gateway will use the first configured interface it finds.

Click on the name of a Web server to see the configuration procedures for that server.

When you have completed the configuration, restart your Web server.

Setting up your MQSeries resources

Some default MQSeries resources are provided with MQSeries Internet Gateway and you are recommended to use these defaults to verify your initial installation. The following procedures describe how to set up and use the defaults.

All the following actions must be performed on your Web server machine. At each stage,you may need to move to the directory where the files you are calling are stored, or you can include the complete path to the files in the command.

  1. To enable the Web server to access MQ resources, the user name under which it runs must be included in the mqm group. If this name is not already included in the group, add it using any method with which you are familiar.
    You need to stop and restart your QMGR to use the new name.
  2. If you do not have a default MQSeries queue manager, create one called DMQSAMP by entering the command: CRTMQM -Q DMQSAMP

  3. Start the default queue manager by entering the command: STRMQM

  4. Create the MQSeries Internet Gateway sample queues using the following command: RUNMQSC < DMQSAMP.TST The sample application queues are called DMQSAMP1 and DMQSAMP2, and the queue from which the Gateway expects to retrieve messages is called DMQGATEWAY.

  5. Define the server and client connections as described in MQSeries Clients (GC33-1632), Part2, Using Channels, 'Creating both definitions on the server'.
    This creates a file called AMQCLCHL.TAB which should be copied in binary mode to /var/mqm on the UNIX platfoms and your mqm directory on OS/2 and WindowsNT.
    When creating the definitions, take note of the following:

Start your Web-aware applications

Start the sample MQSeries applications on your server machine by entering the commands:

For AIX, HP-UX, & Solaris
dmqsamp1 DMQSAMP1 DMQSAMP &
For OS/2 and Windows/NT
start dmqsamp1 DMQSAMP1 DMQSAMP
If you are not using the MQSeries Internet Gateway default queue manager, replace 'DMQSAMP' with the name of the queue manager you want to use.
If you are using your system default queue manager, you do not need to include the queue manager name in the commands.

Enter your message in a special HTML form

Sample forms are provided in the 'mqm\dmqgate\doc' subdirectory of your MQSeries Internet Gateway installation. A form is provided to run the sample program dmqsamp1 which sends and receives a simple message. If you are verifying your installation, use the following procedures to send a message to your MQSeries system. If you want to use your own resources and applications, use the sample as a template to create your own forms.
  1. Open the sample form dmqsamp1.htm in your Web browser.

    Note:If you are viewing this information from your Web server installation, you can Submit the form that is displayed by the link. Otherwise you can only view the form from the link.

  2. Enter the data that you want to send to the MQ application

  3. If you are using an Apache, or Lotus Domino Web Server, edit the ACTION line in the file sample source file as indicated within the file. (The sample source file displayed by the 'dmqsamp1.htm' above is 'dmqsam1d.htm' in the Documentation directory of your MQSeries Internet Gateway Installation. Other sample html files are stored in the 'install_dir\tools\dmqgate\samples\' directory.)

  4. Submit the form
If you are connected to a Web server and have performed all the tasks described above, your message is sent through the MQSeries Internet Gateway and a reply is sent to your browser when the application has completed the task.

Click here to see examples of the replies that you receive using the sample forms.

If the application is not able to reply within the timeout set for the gateway for any reason, including the server application not running, you receive a message in your Web browser. The message page also contains a Retry button. You can continue to use your Web browser for other tasks, and when you want to check whether your message reply is available, return to the timeout message page and click the button.

If the program does not complete successfully, an error message should be returned to your browser. If you cannot correct the problem with the information supplied in the error message, go to 'Solving MQSeries Internet Gateway problems' for further assistance.


Using your own resources and applications

Once you have verified your installation using the defaults provided, you can configure the Gateway to use your own MQ resources, and you can write your own Web-aware applications and HTML forms.

Click on one of the items in the following list to see the necessary procedures.


[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