E-Police home | Easy400 | System i home
Freeware
 
Introduction
Program Error Monitor
Receive Message Queue
Mandatory Activities
Command EDBG
 
Display the Change Log
 
Download
 
 

 
 
  E-Police   In a crowdy iSeries, it takes just a few e-police patrols to make life easier.
E-police patrols don't look for fines, they care for solving accidents, for answering to bothering questions, for making sure that some important shops are working, and ... they do all that at no charge.

by Giovanni B. Perotti (Italy)
Introduction
E-Police is a collection of iSeries utilities dealing with out-of-line situations:
  1. Program Error Monitor
    gets control over ILE-RPG program errors, sends an e-mail message to the appropriate application developer(s) providing complete documentation (error profile, joblog, program source).
  2. Receive Message Queue
    There are installations that are regularly bothered by system messages requiring actions (especially from message queue QSYSOPR).
    In most cases, the causes of the messages are very well known, and the actions are always the same.
    Then, why not an automat taking care of these cases and documenting what was done?
    Optionally this automat can send an e-mail message about the action taken to some e-mail addresses.
  3. Mandatory activities
    Some installations need some subsystems and/or some jobs be always active.
    Command epolice/chksbsjob provides a way to implement such a requirement.
  4. Command EDBG
    Boost up your debug.
Note on SMS support - Besides sending e-mail messages, the Program Error Monitor and the Receive Message Queue facilities may also send SMS to notify people about e-mail messages been sent.
This support has the following prerequisites:
  1. Library MMAIL, not older than August 2019 and a Clickatell Integration API-key. See this page.
  2. Scott Klement's library LIBHTTP with service programs HTTPAPIR4 and EXPAT.
Prerequisites
  • Operating system release V5R2 or subsequent
  • ILE-RPG compiler (just for the initial installation)
Note- SendMail functions are included, therefore MMail utility is not required, unless you want to take advantage of MMAIL SMS support.
Updates
  • Updates to this utility are documented in this page.
  • If you want to know the release date of the EPOLICE package installed on your IBM i, you must run command EPOLICE/RELEASED .
Installation procedure
  1. Signon to the iSeries with a SecurityOfficer-like user profile
  2. CRTSAVF FILE(QGPL/EPOLICE) AUT(*ALL)
  3. From the Easy400 download page download file epolice.zip to your PC and unzip it
  4. Use FTP to copy PC file epolice.sav to save file QGPL/EPOLICE
  5. MD DIR('/mmail') DTAAUT(*RWX) OBJAUT(*ALL)
  6. MD DIR('/mmail/temp') DTAAUT(*RWX) OBJAUT(*ALL)
  7. RSTLIB SAVLIB(EPOLICE) DEV(*SAVF) SAVF(QGPL/EPOLICE)
  8. STRREXPRC SRCMBR(INSTALL) SRCFILE(EPOLICE/QREXSRC)
    It will perform the following:
    1. creates a compile program in library EPOLICE
    2. runs command EPOLICE/COMPILE that creates the necessary modules and programs
    3. runs command EPOLICE/INSTALL to complete the installation by
      • restoring directory /epolice
      • creating directory /epolicedta
      • creating and populating library EPOLICEDTA with local files
      • creating and populating library MMAILDATA with a few objects, if necessary
      During this phase, the installation process will stop two times:
      • The first time it displays the HTTP directives that you must install later on in an Apache HTTP instance of your choice (See the Note below). These directives are in the IFS stream file /epolice/apache/httpdirectives.txt. If you like, you may press this to display them.
      • Then it asks you the DNS name (or the IP address) of such an HTTP instance, inclusive of any non-standard port number (e.g. 192.168.0.2:8020 ).
        You may update later on this piece of information by using command EPOLICE/DNSNAME.
      Note- The e-mail messages sent by E-Police allow to display error data via HTTP. This is why you need an HTTP instance containing directives for E-Police.
More on the HTTP instance

If you are not familiar with the Apache HTTP server, you may not be able to add the HTTP directives /epolice/apache/httpdirectives.txt to an existing HTTP instance of yours.
In such a case, you may want to install a pre-configured E-Police HTTP instance already available.
Do the following:
  1. CPYF FROMFILE(EPOLICE/QATMHINSTC) TOFILE(QUSRSYS/QATMHINSTC) FROMMBR(EPOLICE) TOMBR(EPOLICE) MBROPT(*REPLACE) CRTFILE(*YES)
  2. STRTCPSVR SERVER(*HTTP) HTTPSVR(EPOLICE)
  3. WRKACTJOB SBS(QHTTPSVR) JOB(EPOLICE)
    and make sure that more than one POLICE job is active
  4. EPOLICE/DNSNAME
    and enter the IP address (or the DNS name) of your AS400, followed by a colon and the port number.
    For instance, this is how you display the EPOLICE documentation on your IBM i:
      192.168.0.2:8020/epolice/html/start.html
    www.gigabit.com:8020/epolice/html/start.html



    Contact