bvstone

Sending a Slack Alert Using JOBWATCH and G4SLK When a Job Enters MSGW Status

Posted:

Sending a Slack Alert Using JOBWATCH and G4SLK When a Job Enters MSGW Status

Previously we discussed how to send an email when a job enters MSGW using JOBWATCH and MAILTOOL.

This article will expand on that and also send a message to a private Slack channel as a "bot" so that we will receive a notification on any device (like an android or iPhone) that has the Slack app installed.  The software we will need will be Job Watch (JOBWATCH) and GreenTools for Slack (G4SLK).

First we use the Job Watch Configuration (JOBWATCHCF) command to set up a call to a program when a job enters MSGW.  The command in this case looks like this:

CALL PGM(SLACKMSGW) PARM('&J' '&S' '&U' '&N' '&F' '&E')

This will cause JOBWATCH to call the program SLACKMSGW passing in the parameters Job, Job Status, User, Job Number, Function, and Error Text from the job log.

A list of replacement variables and their data sizes can be seen here in the documentation.

In my case I wanted to make sure the messages only came to me.  So I created a private channel in my Slack team named "alerts" that I will use to send alerts from my IBM i to.

Our RPG program that will send the Slack message is as follows:

     H DFTACTGRP(*NO) BNDDIR('BVSTOOLS')
      ****************************************************************
      * Prototypes                                                   *
      ****************************************************************
      /COPY QCOPYSRC,P.G4SLKCH
      ****************************************************************
     D MsgTS           S            256    INZ
     D ErrMsg          S            256    INZ
     D rc              S             10i 0
     D CRLF            S              2    INZ(X'0D25')
     D Message         S          32000
      ****************************************************************
     C     *ENTRY        PLIST
     C                   PARM                    WPJob            10
     C                   PARM                    WPJobStatus       4
     C                   PARM                    WPUser           10
     C                   PARM                    WPJobNbr          6
     C                   PARM                    WPFunction       10
     C                   PARM                    WPErrorText    4096
      /free
       EXSR $Slack;

       *INLR = *ON;
       //***************************************************************
       //* Send a Message to Slack
       //***************************************************************
       begsr $Slack;

         Message = 'JOB: ' + %trim(WPJob) + CRLF +
                   'JOB NUMBER: ' + %trim(WPJobNbr) + CRLF +
                   'STATUS: ' + %trim(WPJobStatus) + CRLF +
                   'FUNCTION: ' + %trim(WPFunction) + CRLF +
                   'MESSAGE: ' + CRLF + %trim(WPErrorText);

         rc = #g4slkch_setValue('id':'bvstools');
         rc = #g4slkch_setValue('team':'bvstools');
         rc = #g4slkch_setValue('channel':'alerts');
         rc = #g4slkch_setValue('as_who':'*BOT');
         rc = #g4slkch_setValue('user_name':'JobWatch');
         rc = #g4slkch_setValue('message':Message);
         msgTS = #g4slkch_sendMessage(errMsg);

       endsr;
      /end-free

All we need to do is build the message we want to send, set the values of our id, team and channel.  Also, in this case I'm sending the message as a "bot" with the name of "JobWatch" so that when my phone dings with the alert I will know what the issue most likely is before even having to look at the message.

Now, not only will the online Slack application show the message in the "alerts" channel:

But also my phone will also show the message:

Pretty neat!

 


Last edited 05/30/2017 at 15:20:06



Latest Posts:

G4MSMAIL Now Allows Wildcard Attachments G4MSMAIL Now Allows Wildcard Attachments
Posted by June 10, 2021
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
G4G Update for Uploading Large Files G4G Update for Uploading Large Files
Posted by May 28, 2021
BVSTools >> BVSTools Announcements >> GreenTools for G Suite (Google Apps) (G4G) Specific Announcements
Can We Purchase License Keys for More Than One Year at a Time? Can We Purchase License Keys for More Than One Year at a Time?
Posted by May 21, 2021
BVSTools >> BVSTools Announcements
JOBWATCH 5.10 Released with New Feature to Monitor CPU Percentages JOBWATCH 5.10 Released with New Feature to Monitor CPU Percentages
Posted by May 10, 2021
BVSTools >> BVSTools Announcements >> Job Watch (JOBWATCH) Specific Announcements
Iseries Access data transfer Iseries Access data transfer
Posted by April 29, 2021
IBM Power Systems >> (QGPL) IBM i
YAJL - Parsing YAJL - Parsing
Posted by April 4, 2021
Programming >> RPG Programming
Create LPAR partition and install OS Create LPAR partition and install OS
Posted by March 24, 2021
IBM Power Systems >> (QGPL) IBM i
G4MS Now Allows User/Password Authentication Option G4MS Now Allows User/Password Authentication Option
Posted by March 16, 2021
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
IPDS printer file using CHRSIZ IPDS printer file using CHRSIZ
Posted by February 25, 2021
Programming >> RPG Programming
How to Correctly Send the Display Machine Information (DSPMCHINF) Data to BVSTools for Key Generation How to Correctly Send the Display Machine Information (DSPMCHINF) Data to BVSTools for Key Generation
Posted by February 9, 2021
BVSTools >> BVSTools Software Discussion
G4MS Updated to v7.10 - Required Update for All G4MS Users G4MS Updated to v7.10 - Required Update for All G4MS Users
Posted by November 12, 2020
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
MAILTOOL Errors with Microsoft Office 365 (2020) MAILTOOL Errors with Microsoft Office 365 (2020)
Posted by September 3, 2020
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
Using MAILTOOL With Office 365 and Two Factor Authentication (2FA or MFA) Using MAILTOOL With Office 365 and Two Factor Authentication (2FA or MFA)
Posted by August 17, 2020
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
Updating DNS With Dynamic IP Addresses After a Router Reboot/Power Outage Updating DNS With Dynamic IP Addresses After a Router Reboot/Power Outage
Posted by August 16, 2020
Programming >> Proof of Concept (POC)
GETURI v10.10 Released with New ILE Functions GETURI v10.10 Released with New ILE Functions
Posted by August 12, 2020
BVSTools >> BVSTools Announcements >> Get URI (GETURI) Specific Announcements

Reply




Copyright 1983-2020 BVSTools
GreenBoard(v3) Powered by the eRPG SDK, MAILTOOL Plus!, GreenTools for Google Apps, jQuery, jQuery UI, BlockUI, CKEditor and running on the IBM i (AKA AS/400, iSeries, System i).