OA62796: NEW FUNCTION - ADDITIONAL JOB NOTIFICATIONS FOR JOB PHASES

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New function.
  
  The asynchronous job completion notification function of
  the z/OS jobs REST interface has been enhanced to issue
  notifications when a job is ready for execution and when
  a job is selected for execution.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of HJE77D0.                                        *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Customers would like to see HTTP Job                         *
  * Notifications for more job                                   *
  * transitions.                                                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The current JES2 HTTP Job Notification support will issue a
  job notification when the job is no longer eligible for
  execution (e.g., the job has completed execution).
  
  Customers would like to receive notifications for other job
  life cycle events so they can be more aware of a job's
  progress and can possibly enhance job scheduling applications
  to use the new notifications to better track job progress.
  

Problem conclusion

Temporary fix

Comments

• TYPE/RESTART (WARM) IPL/REQUIRED (YES) CLPA (YES)
  
  CLPA is needed only if HASCxxxx modules currently reside in
  the pageable link pack area (PLPA).
  
  The JES2 HTTP Job Notification support has been enhanced to
  issue notifications when a job is ready for execution and
  when a job is selected for execution.  It also provides
  customers the ability to indicate what job notifications
  they wish to receive for the job.  This information is
  supplied using a new symbol, SYS_JOB_NOTIFYX, which is
  documented in the z/OS JES Application Programming manual.
  
  Customers can also request job notifications
  using the z/OS jobs REST interface with the enhanced support
  provided in z/OSMF APAR PH44152.  Refer to that APAR for
  information and documentation updates for implementing that
  new capability.
  
  **********************************************************
  *                                                        *
  *  Job notifications may not be received as expected     *
  *  until all members of the MAS have both JES2 HTTP Job  *
  *  Notification APARs OA62804 and OA62796 installed.     *
  *                                                        *
  **********************************************************
  
  **********************************************************
  *                                                        *
  *  Users that have implemented a single TCP/IP stack     *
  *  environment (INET) will not be able to receive JES2   *
  *  job notifications until z/OS Communications Server    *
  *  APAR PH47680 is installed.                            *
  *                                                        *
  **********************************************************
  
  The information in the following JES2 manuals/publications
  is missing/incorrect:
  
  1.SA32-0987-50 z/OS 2.5 JES Application Programming
                                                   (for HJE77D0)
  2.SA32-0989-50 z/OS 2.5 JES2 Messages            (for HJE77D0)
  3.SA32-0990-50 z/OS 2.5 JES2 Commands            (for HJE77D0)
  4.SA32-0991-50 z/OS 2.5 JES2 Initialization and Tuning Guide
                                                   (for HJE77D0)
  
  
  Numerous updates were made to the JES2 publications listed
  above to describe the new support delivered via this APAR.
  Refer to the latest version of the manuals on IBM DOCS to
  obtain the most current information on this function.
  
  The JES2 HTTP Job Notification support has been enhanced to
  issue notifications when a job is ready for execution and
  when a job is selected for execution. It also provides
  customers the ability to indicate what job notifications
  they wish to receive for the job.  This information is
  supplied using a new symbol, SYS_JOB_NOTIFYX, which is
  documented in the z/OS JES Application Programming manual.
  Refer to Chapter 4, JES Symbol Service (IAZSYMBL), in z/OS
  2.5 JES Application Programming (SA32-0987-50), for
  information on specifying the new SYS_JOB_NOTIFYX symbol
  for requesting the new job notifications, and for
  information on how the new symbol interacts with the
  existing SYS_JOB_NOTIFY symbol:
  https://www.ibm.com/docs/en/SSLTBW_2.5.0/
  com.ibm.zos.v2r5.hasc300/iazsymbl.htm
  
  Refer to Chapter 8, JES2 Email Delivery Services, of the z/OS
  2.5 JES2 Initialization and Tuning Guide (SA32-0991-50), in
  the section entitled "Using JES2 EDS for job notifications
  over HTTP" for information on configuring JES2 Email Delivery
  Services (EDS) to deliver job notifications and how it
  interacts with the new SYS_JOB_NOTIFYX symbol:
  https://www.ibm.com/docs/en/SSLTBW_2.5.0/
  com.ibm.zos.v2r5.hasa300/hasa3_eds.htm
  
  Refer to Chapter 5, Command reference section, of z/OS
  2.5 JES2 Commands (SA32-0990-50) for information on the
  $T DEBUG command and how it is used to request diagnostic
  messages for job notification processing:
  https://www.ibm.com/docs/en/SSLTBW_2.5.0/
  com.ibm.zos.v2r5.hasa200/has2cmdr.htm
  
  Refer to z/OS 2.5 JES2 Messages (SA32-0989-50) for
  information on the following updated or new messages:
  https://www.ibm.com/docs/en/SSLTBW_2.5.0/
  
  com.ibm.zos.v2r5.hasa100/has2xones.htm
  
   $HASP1528
   $HASP1548 - new message
   $HASP1549 - new message
   $HASP1550 - new message
   $HASP1551 - new message
  
  
  Searchable keywords:
    msgHASP1528
    msgHASP1548
    msgHASP1549
    msgHASP1550
    msgHASP1551
  
  
  APAR OA62796 prereq's (and sup's) for FMID HJE77D0:
  Pre's: DA60777 DA61231
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UJ09395

Modules/Macros

• $JRW     $MODULE  HASMJQE  $JSON    HASCSRIC HASPSPOL $JQE
  HASMMODL HASMTABL HASPNUC  HASMCADR HASCSRIP HASPTRAK $NOTENF
  $HASPEQU HASPXEQ  $PARMLST HASPHOPE HASPIRSI $PADDR   $NFYURL
  $CADDR   HASCSRJB HASPTABS HASMPADR HASPJQS  HASCBLDM $JSONTAB
  HASPCSV  HASPTERM HASCINJR HASMJRW  $RMSGQUE HASCEDS  $EDS
  HASMEDSM HASCENF
  

Fix information

• Fixed component name

  JES2

• Fixed component ID

  5752SC1BH

Applicable component levels

• R7D0 PSY UJ09395

     UP22/10/19 P F210  

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.