User's Guide
To use MQ applications through the MQSeries Internet Gateway you need to:
- Configure and start your Web server
- Set up some MQSeries resources
- Start your Web-aware applications
- 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.
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.
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.
- 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.
- If you do not have a default MQSeries queue manager, create one called DMQSAMP
by entering the command:
CRTMQM -Q DMQSAMP
- Start the default queue manager by entering the command:
STRMQM
- 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.
- 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:
- Enter the userid of your Web server in the MCAUSER field.
- If you are using the default queue manager, set the QMNAME field to ' ' (Note the
space between the quotes).
- For AIX, HP_UX, and Solaris, run the following command:
chmod 666 AMQCLCHL.TAB
to make sure that the Web server userid has sufficient authority to read the AMQCLHCL.TAB file.
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.
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.
- 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.
- Enter the data that you want to send to the MQ application
- 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.)
- 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.
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.
![[Help]](images/help.gif)
[ Home |
Order |
Search |
Contact IBM |
Legal ]
(C) IBM Corporation 1997. All Rights Reserved