PH44152: Jobs API: New job notification

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Jobs API: New job notification
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM z/OSMF V2R5 z/OS REST Jobs  *
  *                 services.                                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides new function to z/OS *
  *                      REST Jobs services.                     *
  ****************************************************************
  This APAR delivers new function to z/OS REST Jobs services.
  The following new features have been added to z/OS REST
  Jobs services:
  
  - Support new job notification when submit a job
  - jobname can contain a question mark(?)
  
  Support new job notification when submit a job.
  
  Previously, job notification is only supported when job is
  completed. With the new support, the "Submit a job" service
  provides a new header "X-IBM-Notification-Options." This
  header consists of a JSON string with a single property called
  events. The value of the events property is a list of strings
  that indicates the job events which trigger HTTP POSTs.
  If any of the job events happen, the destination URL specified
  in the header of "X-IBM-Notification-URL" receives an HTTP POST.
  Valid event types are "ready", "active", and "complete" and are
  case-insensitive.
  
  - ready - Job is ready for execution.
  - active - Job started execution.
  - complete - Job completed execution.
  
  jobname can contain a question mark(?)
  
  With the new support, jobname can contain a question mark(?)
  that represents a single character when the URL contains
  "jobname" parameter
  

Problem conclusion

Temporary fix

Comments

APAR Information

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

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

  UI82766

Modules/Macros

• IZUGNABB IZUGNAET IZUGNAEW
  

Fix information

• Fixed component name

  Z/OSMF RESTJOBS

• Fixed component ID

  5655S28RJ

Applicable component levels

• R250 PSY UI82766

     UP22/11/02 P F211

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.