OA65571: NEW FUNCTION - NEW JES2 SYMBOL AND JCL SIGNATURE SUPPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• NEW FUNCTION
  
  **ADITIONAL INFORMATION**
  Note:  If this fix is applied without corresponding SMF new
  function APAR OA66003, then certain fields in SMF30 record such
  as SMF30COR may not be filled. Please apply SMF APAR OA66003
  along with this fix to ensure that SMF30 data is fully captured.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of HJE77D0 and HJE77E0.            *
  ****************************************************************
  * PROBLEM DESCRIPTION: Roll down the following items from z/OS *
  *                      3.1                                     *
  *                      - Support JES symbols SYS_DEADLINE,     *
  *                        SYS_HOLDUNTIL, and SYS_JOBTOKEN       *
  *                      - Support for JCL signatures            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  - Support the JES symbols SYS_DEADLINE, SYS_HOLDUNTIL, and
    SYS_JOBTOKEN including:
    - Extracting the symbols during internal reader processing.
    - Store the SYS_DEADLINE and SYS_JOBTOKEN in SMF 26 and the
      JMR extension (for use by SMF for the SMF 30 record
      (APAR OA66003)).
    - Support the SYS_HOLDUNTIL symbol as an override for the
       JCL SCHEDULE HOLDUNTL= keyword.
    - Support passing the SYS_JOBTOKEN to exits 7 (X007JBTK)
      and 51 (X051JBTK) when available.
  - Support for two JCL signature values to identify jobs:
    - Calculate signature 1 during INPUT phase and signature 2
      during conversion processing.
    - Store the signatures in the JMR extension (for used by
       SMF for the SMF 30 record (APAR OA66003)).
  - Update SSI 54 (who-am-I) to indicate this support is
    installed.
    - Update the variable section with the string
      AI_SELECTION='PH1'
  

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).
  
  Code was changed to implement the changes from the problem
  summary.
  
  OA65597 is the JES common code in support of this APAR. It
  will add the following:
  - Support for setting the new JES symbols SYS_DEADLINE,
    SYS_HOLDUNTIL, and SYS_JOBTOKEN from unauthorized code
  - Define the new fields added to the SMF 26 definition
  
  
  **********************************************************
  *                                                        *
  *  The new symbol data provided in this APAR may not be  *
  *  available until all members of the MAS have this fix  *
  *  applied.                                              *
  *                                                        *
  *  Jobs submitted prior to the APARs being applied on all*
  *  members will not have the new symbol data in their SMF*
  *  records.                                              *
  *                                                        *
  **********************************************************
  
  
  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-0995-50 z/OS 2.5 JES2 Installation Exits    (for HJE77D0)
  3.SA32-0989-50 z/OS 2.5 JES2 Messages              (for HJE77D0)
  4.SA38-0679-50 z/OS 2.5 MVS Using the Subsystem Interface
                                                     (for HBB77D0)
  
  In JES Application Programming, "Chapter 4. JES Symbol Service
  (IAZSYMBL)", the section "JES system symbols", should be updated
  to the following text:
  
   JES symbols with the prefix SYS are system symbols, which
   communicate information between applications and the system.
   JES SYS symbols are read-only, and applications are not
   allowed to manage them, with five exceptions. The
   SYS_CORR_USRDATA, SYS_JOB_NOTIFY, SYS_HOLDUNTIL,
   SYS_DEADLINE, and SYS_JOBTOKEN symbols communicate
   information from applications to JES, are user-defined, and
   subject to the following rules:
  
  
  The section "JES system symbols" should also be updated to add
  the following new symbol descriptions:
  
   SYS_HOLDUNTIL
  
   The SYS_HOLDUNTIL symbol specifies the date and time until
   which to hold a job. The syntax of the symbol value
   adheres to the syntax of the HOLDUNTL parameter on JCL
   SCHEDULE statement. Similarly, the symbol's relationship
   with other JCL parameters is the same as JCL HOLDUNTL
   keyword. These JCL parameters include the SCHEDULE
   statement's STARTBY keyword and the JOB statement's
   TYPRUN=HOLD keyword. For details see the MVS JCL
   Reference (SA23-1385-60).
  
   The symbol value is available in SMF records 26 and 30 as a
   UTC timestamp represented by the first 6 bytes (bits 0-47)
   of an ETOD value.
  
   SYS_DEADLINE
  
   The SYS_DEADLINE symbol specifies the target deadline for a
   job's completion. Specifying this symbol will not guarantee
   the job will end by the specified date and time. The syntax
   of the symbol's value adheres to the syntax of the HOLDUNTL
   keyword on SCHEDULE JCL statement. For details see the MVS
   JCL Reference.
  
   The symbol value is available in SMF records 26 and 30 as a
   UTC timestamp represented by the first 6 bytes (bits 0-47)
   of an ETOD value.
  
   SYS_JOBTOKEN
  
   The SYS_JOBTOKEN symbol specifies a unique signature for a
   job. This enables a job submitter to identify repetitive job
   instances (i.e., daily jobs, weekly jobs, etc.). The
   symbol value can be 1 to 16 hex digits, or 8 bytes, in
   length. If less than 8 bytes are specified, the most
   significant bytes will be zero padded.
  
   The symbol value is available in SMF records 26 and 30 as an
   8 byte binary value, and when available, it is included in
   the exit parameter lists of Exit 7 and 51.
  
  
   In JES2 Installation Exits, "Chapter 20. Exit 7: Control block
   I/O (JES2)", in section "Register contents on entry to Exit 7",
   add the following field definition after the X007CBID field:
  
   X007JBTK
      The 8 byte value of the SYS_JOBTOKEN JES system symbol,
      when available
  
  
   In JES2 Installation Exits, "Chapter 63. Exit 51: Job phase
   change exit ($QMOD)", in section "Register contents when Exit
   51 gets control", add the following field definition after
   the X051FLG1 field:
  
   X051JBTK
      The 8 byte value of the SYS_JOBTOKEN JES system symbol,
      when available
  
   In JES2 Messages, "Chapter 5. One-hundreds", add the following
   information for new message HASP176:
  
   $HASP176
  
   Explanation
  
   >>-+- Syntax of -+- SYS_HOLDUNTIL --+- symbol is not valid +-
      |             +- SYS_DEADLINE ---+                      |
      |             +- SYS_JOBTOKEN ---+                      |
      |                                                       |
      +- Failed to obtain the AI-Infused Selection JCTX ------+
  
  
   --><
  
   The specification of a JES system symbol was not correct. Or,
   alternatively, the AIS JCT Extension could not be obtained.
  
   System action
   JES2 deletes the job.
  
   Operator response
   Report this message to the system programmer.
  
   System programmer response
   If the message indicates a system symbol's syntax is not
   valid, then verify the value specified for the symbol
   indicated in the message.
  
   Module
   HASCSRIP
  
   Routing Code: 7
   Descriptor Code: 4
  
  
   In MVS Using the Subsystem Interface", "Chapter 3. SSI
   function codes your program can request", in section "Request
   subsystem information call - SSI function code 54", in
   "Table 3. IBM-Defined Keywords", add the following keyword in
   alphabetic order to the table:
  
   Keyword
    ,AI_SELECTION='PH1'
  
   Explanation
    Indicates the phase 1 function of AI-Infused Job Selection
    is supported.
  
  
   Updates have been made to the manuals in 3.1.
  
  
  APAR OA65571 prereq's (and sup's) for FMID HJE77D0:
  Pre's: DA60777 DA61231 DA61750 DA62796 DA63581 DA61751 DA66214
  
  APAR OA65571 prereq's (and sup's) for FMID HJE77E0:
  Pre's: EA64769 EA65602
  ×**** PE24/10/10 FIX IN ERROR. SEE APAR OA67088  FOR DESCRIPTION
  

APAR Information

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

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

  UJ95829 UJ95831

Modules/Macros

• $CADDR   $CIPARM  $CIWORK  $JCTX    $JRW     $MODULE  $PERFCB
  $TODWORK $XPL     HASCBLDM HASCCNVS HASCDSOC HASCINJR HASCJBST
  HASCSRIP HASIBLD  HASMCADR HASMCIP  HASMCIW  HASMJCTX HASMJRW
  HASMPERF HASPCNVT HASPHOPE HASPIRMA HASPIRSI HASPJOS  HASPJQS
  HASPNSR  HASPNUC  HASPPRPU HASPPSO  HASPRDR  HASPSPIN HASPTRAK
  HASPXEQ
  

Fix information

• Fixed component name

  JES2

• Fixed component ID

  5752SC1BH

Applicable component levels

• R7D0 PSY UJ95831

     UP24/09/11 P F409  

• R7E0 PSY UJ95829

     UP24/09/11 P F409  

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.