iSeries Message Manager(imsgmgr)
The iSeries Message Manager is a message handling utility for the IBM iSeries and i5 systems. It has been developed in RPGLE and CL.
Terms and conditions
These files are provided on an as is basis.
No warranty is supplied or implied.
The supplier of these files is in no way responsible for any loss of data or other problems resulting from their use.
These programs and files are protected under the GPL licence.
A licence is granted to use these files in their unmodified form.
They may be freely distributed as long as all files remain together and unmodified, unless otherwise specified, together with an unmodified copy of this text file.
These files may not be re-engineered or used as the basis for the development of new files or programs.
V1r1m0 - Initial Release
These programs have been tested on all versions of OS/400 and i5/os from v4r5 to v5r4.
MSGMON - Message manager client
MSGMONC - Message manager client
MSGIDXR - Message repository server
MSGMGR Message manager server
MSGMGRC Message manager server
MSGMGRR Message manager server
MSGIDXP Message repository
MSGIDXN DDM remote view of MSGIDXP
MSGFLTP Message filters
MSGACTP Message actions
To use the email functionality you will need to configure your iseries server to send emails.
To install these programs you will need to understand how to compile source code
to create program and file objects.
Create a library on your server called imsgmgr.
In this library create a source file called qmsgmgr.
Upload the source files to the source file created above on iSeries server.
Logon to the server and make your
source library your current library.
To begin you should use the following commands to create the data files;
Next you need to creare the CL programs with the following commands;
Next you need to create the RPGLE programs with the following commands;
Finally you need to create the commands using the following commands;
The sample data files contain exmaples of filters and message actions to be used
with the message manager software. The cover the most common reference messages on the
iseries server to get you started.
Message filters are used to select which messages are processed. A message filter specifies a filter list, message id, an action list to use and a filter description. The filter description can be used by the email function. The filter list is used by the message manager server to select which messages to use. This enables the message manager to be run against different message queues or applications.
Message actions determine what actions are applied to each message. The message manager allows multiple actions to be applied to each message. The message actions speficies the action list, the message id, the action sequence, The action to be applied, the data for the action and a description of the action.
The message manager client can be run against different message queues using different message filter lists. To enable this you must submit the job using different job names. If you start multiple instances of message manager with the same job name, only one will run. The message manage locks a member in a temporary file called msgmgr in the program library with the name of job to ensure that only one instance is running.
Submit a job using the MSGRMON command to monitor the desired message queue. The message monitor can use either a local or remote repository. For a remote repository you need to specify the ip address of the remote server where the repository is located. The message manager client will only load messages from the selected message queue into the message repository.
To process the messages in the message repository, submit a job with the MSGMGR command. The message manager server can use either a local or remote repository. For a remote repository you need to specify the ip address of the remote server where the repository is located. The Message manager server will process the messages in the message repository. Any messages which do not have a filter will be ignored.
To uninstall message manager, end any jobs using the message manager software and delete the imsgmgr library.
When using remote repositories, the remote server must be available when the message manager is started otherwise the program will not function properly.
If the message queue being monitored is in break mode, the message manager client will not
be able to process it. The program will send an error message to qsysopr until the message queue is available.
If the message repository file is locked when the program tries to access it such as during a backup, the program will hang and needs to be restarted.