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:

Microsoft Office 365 Servers and Random Errors Issue Microsoft Office 365 Servers and Random Errors Issue
Posted by November 14, 2022
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
Sending/Resending Emails Using a MIME File with MAILTOOL Sending/Resending Emails Using a MIME File with MAILTOOL
Posted by November 8, 2022
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
Sending an HTML Email on Your IBM i Using MAILTOOL Sending an HTML Email on Your IBM i Using MAILTOOL
Posted by November 1, 2022
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
Transferring License Keys from One System to Another Transferring License Keys from One System to Another
Posted by October 31, 2022
BVSTools >> BVSTools Software Discussion
Calculating the Size of a File Before Base64 Encoding Calculating the Size of a File Before Base64 Encoding
Posted by August 13, 2022
Programming >> RPG Programming
GreenTools for Microsoft Apps (G4MS) v9.12 Now Includes Function to Send Emails using MIME File GreenTools for Microsoft Apps (G4MS) v9.12 Now Includes Function to Send Emails using MIME File
Posted by August 11, 2022
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
GreenTools for Google Apps (G4G) v15.20 Now Supports Shortcuts GreenTools for Google Apps (G4G) v15.20 Now Supports Shortcuts
Posted by August 6, 2022
BVSTools >> BVSTools Announcements >> GreenTools for G Suite (Google Apps) (G4G) Specific Announcements
GreenTools for Microsoft Apps (G4MS) Groups Admin Authority Instructions GreenTools for Microsoft Apps (G4MS) Groups Admin Authority Instructions
Posted by July 26, 2022
BVSTools >> BVSTools Software Discussion >> GreenTools for Microsoft Apps (G4MS) Specific Discussion
GreenTools for Microsoft Apps (G4MS) v9.10 Now Includes OneDrive Functions that Work With Groups/Shared Drives GreenTools for Microsoft Apps (G4MS) v9.10 Now Includes OneDrive Functions that Work With Groups/Shared Drives
Posted by July 19, 2022
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
GreenTools for Google Apps (G4G) v15.10 Now Includes Drive Functions that Work With Shared Drives GreenTools for Google Apps (G4G) v15.10 Now Includes Drive Functions that Work With Shared Drives
Posted by July 15, 2022
BVSTools >> BVSTools Announcements >> GreenTools for G Suite (Google Apps) (G4G) Specific Announcements
GreenTools for Microsoft Apps (G4MS) v9.00 Now Offers Functions to Bypass Registration Command and BVSTools Landing Page GreenTools for Microsoft Apps (G4MS) v9.00 Now Offers Functions to Bypass Registration Command and BVSTools Landing Page
Posted by July 4, 2022
BVSTools >> BVSTools Announcements >> GreenTools for Microsoft Apps (G4MS) Specific Announcements
What Objects Should I Omit from Replication to Ensure My License Keys Work on my HA/DR System? What Objects Should I Omit from Replication to Ensure My License Keys Work on my HA/DR System?
Posted by June 27, 2022
BVSTools >> BVSTools Software Discussion
GreenTools for Google Apps (G4G) v15.00 Now Offers Functions to Bypass Registration Command and BVSTools Landing Page GreenTools for Google Apps (G4G) v15.00 Now Offers Functions to Bypass Registration Command and BVSTools Landing Page
Posted by May 3, 2022
BVSTools >> BVSTools Announcements >> GreenTools for G Suite (Google Apps) (G4G) Specific Announcements
How Do I Switch From MAILTOOL Plus to GreenTools for Google (OAuth 2.0) or Microsoft Office 365? How Do I Switch From MAILTOOL Plus to GreenTools for Google (OAuth 2.0) or Microsoft Office 365?
Posted by April 18, 2022
BVSTools >> BVSTools Software Discussion >> Email Tools (MAILTOOL) Specific Discussion
PTFs Issued for SSL/TLS Issues PTFs Issued for SSL/TLS Issues
Posted by March 12, 2022
IBM Power Systems >> PTF Watch

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).