Download Latest Version imsgmgr source (10.2 kB) Get Updates
Name Modified Size InfoDownloads / Week
iSeries_Message_Manager_readme.txt 2009-08-15 6.3 kB 2009-08-15 5.2 kB 2009-08-15 10.2 kB
Totals: 3 Items   21.7 kB 0
iSeries Message Manager(imsgmgr) 1.Introduction 2.System Requirements 3.Installation 4.Configuration 5.Getting Started 6.Uninstalltion 7.Bugs/Issues 8.Troubleshooting/FAQ's 1.Introduction ============== 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. Licence ======= 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. Version History =============== V1r1m0 - Initial Release 2.System Requirements ===================== 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. 3.Installation ============== 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; CRTPF FILE(IMSGMGR/MSGIDXP) SRCFILE(IMSGMGR/QMSGMGR) CRTPF FILE(IMSGMGR/MSGACTP) SRCFILE(IMSGMGR/QMSGMGR) CRTPF FILE(IMSGMGR/MSGFLTP) SRCFILE(IMSGMGR/QMSGMGR) Next you need to creare the CL programs with the following commands; CRTCLPGM PGM(IMSGMGR/MSGMGRC) SRCFILE(IMSGMGR/QMSGMGR) CRTCLPGM PGM(IMSGMGR/MSGMONC) SRCFILE(IMSGMGR/QMSGMGR) CRTCLPGM PGM(IMSGMGR/MSGDLTC) SRCFILE(IMSGMGR/QMSGMGR) Next you need to create the RPGLE programs with the following commands; CRTBNDRPG PGM(IMSGMGR/MSGMGRR) SRCFILE(IMSGMGR/QMSGMGR) SRCMBR(MGRMGRR) CRTBNDRPG PGM(IMSGMGR/MSGIDXR) SRCFILE(IMSGMGR/QMSGMGR) SRCMBR(MGRIDXR) CRTBNDRPG PGM(IMSGMGR/MSGDLTR) SRCFILE(IMSGMGR/QMSGMGR) SRCMBR(MSGDLTR) Finally you need to create the commands using the following commands; CRTCMD CMD(IMSGMGR/MSGMGR) PGM(IMSGMGR/MSGMGRC) CRTCMD CMD(IMSGMGR/MSGMON) PGM(IMSGMGR/MSGMONC) CRTCMD CMD(IMSGMGR/MSGDLT) PGM(IMSGMGR/MSGDLTC) 4.System Configuration ====================== 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. 5.Getting Started ================== 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. 6.Uninstallation ================= To uninstall message manager, end any jobs using the message manager software and delete the imsgmgr library. 7.Bugs/Issues ============= 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. 8.Troubleshooting/FAQ's =======================
Source: iSeries_Message_Manager_readme.txt, updated 2009-08-15