OA61334: VARIOUS ERRORS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Various errors found in testing HJE77D0. TRSQ
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of HJE77D0.                                        *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Various problems discovered during                           *
  * the testing of JES2 HJE77D0.                                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The following defect is addressed by this APAR:
  
  385983 - When UNSPUN output is processed, a JCT buffer
           may be lost.
  
  The following APARs, discovered in a previous release, are
  addressed by this APAR:
  
  OA57667 - In SMF type 55 records, JES2 erroneously sets
            flag bits in flag byte SMF55FLG instead of setting
            SMF55RSO, SMF55CON, and SMF55SEC flag bits in
            flag byte SMF55FG1.
  
            In SMF type 56 records, JES2 erroneously sets
            flag bits in flag byte SMF56FLG instead of setting
            SMF56RSO, SMF56CON, and SMF56SEC flag bits in
            flag byte SMF56FG1.
  
  OA59979 - Aging code is missing for job groups having a state
            of SUSPENDED or PENDING.  As a result, when age
            filtering criteria are specified for JES2 commands
            such as $C Group, $D Group, and $P Group, the
            commands do not detect and have no effect on
            suspended and pending job groups.
  
  OA60677 - When purging jobs with BEFORE= or AFTER=
            statements, faulty logic in the HASPJQS module may
            result in a JES2 ABEND $Q21 when removing such jobs
            from the release list of the parent job.
  

Problem conclusion

• 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 following changes were made in this APAR:
  
  385983 - The HASPSPIN module was changed to correctly free
           the JCT buffer when UNSPUN output is processed.
  
  OA57667 - Code in the HASPNPM module was changed to correctly
            set SMF55RSO, SMF55CON, and SMF55SEC flag bits in
            flag byte SMF55FG1 of SMF type 55 records and to
            correctly set SMF56RSO, SMF56CON, and SMF56SEC
            flag bits in flag byte SMF56FG1 of SMF type 56
            records.  (JES2 will no longer incorrectly
            set the first three flag bits in flag byte
            SMF55FLG of SMF type 55 records nor incorrectly
            set the first three flag bits in flag byte
            SMF56FLG of SMF type 56 records.)
  
  OA59979 - The PREQCHNG ($SCAN PRESCAN for AGE related
            commands) routine in the HASPSXJB module was
            changed to support aging for job groups in
            a PENDING or a SUSPENDED state, allowing JES2
            commands to detect and affect such job groups
            when age filtering criteria are specified.
  
  OA60677 - The HASPJQS module was changed to allow jobs with
            BEFORE= or AFTER= statements to be successfully
            purged from the system.
  
  Additional issues resolved by this APAR:
  
  - Miscellaneous IPCS models were updated, $BUFFER IPCS
    formatting was changed, and the $HDB formatter was
    modified.
  
  - New policy attributes were added for policy types
    PreConversion and SYSOUTGroup.
  
  The information in the following JES2 manuals/publications
  is missing/incorrect:
  
  1. SA32-0995-50 z/OS V2R5 JES2 Installation Exits (for HJE77D0)
  
  In "Chapter 74. JES2 policies", in "Table 15. Attributes
  supported in JES2 policy definitions", the following five rows
  should be added to the table and intermixed alphabetically
  by "Attribute Name":
  
  Attribute Name : GroupID
  Data Type      : Character
  Description    : Specifies the name of an output group. The
                   output-group is 1 through 8 alphanumeric
                   characters and not installation-defined.
  
  Attribute Name : DfltSchenv
  Data Type      : Character
  Description    : Specifies the default WLM scheduling
                   environment name to be assigned to this job.
                   The schenv-name is 1 through 16 alphanumeric,
                   national ($,#,@) characters, or the
                   underscore (_). The schenv-name will be
                   rejected if it is not defined to WLM.
  
  Attribute Name : JesLog
  Data Type      : Character List
  Description    : Indicates if the default JESLOG data is to be
                   spun at a certain interval, suppressed from
                   being recorded, or not spun at all.
  
                   ('Spin') - Spun at any time during job
                   execution when a JES-specific operator command
                   is issued.
  
                   ('Spin','+hh:mm') - Spun every 'hh:mm' time
                   interval where hh and mm values indicate hours
                   and minutes respectively.
  
                   ('Spin','hh:mm') - Spun at time 'hh:mm' each
                   24 hour period.
  
                   ('Spin','nnnX') - Spun when either data set
                   has n lines. X is an optional character that
                   is either K or M. K multiplies n by one
                   thousand and M multiplies n by one million.
  
                   ('Suppress') - Suppressed from being recorded
  
                   ('NoSpin') - Not spun at all
  
  Attribute Name : JobRC
  Data Type      : Character
  Description    : Specifies the default method JES2 uses to
                   determine the return code for this job.
  
                   'MaxRC' - Highest return code
  
                   'LastRC' - Last executed step's return code
  
  Attribute Name : OutDisp
  Data Type      : Character List
  Description    : Indicates the normal and abnormal disposition
                   of a data set.
  
                   (normal,abnormal)
  
                   Each disposition is one of the following
                   values:
  
                        'Hold'
                        'Keep'
                        'Leave'
                        'Purge'
                        'Write'
  
                   Modifying by action:
  
                        Abnormal disposition can be omitted and
                        will result in no change to the previous
                        value.
  
                        Either normal or abnormal disposition can
                        be a string of length zero which will
                        result in no change to the specified
                        previous value.
  
  In "Chapter 74. JES2 policies", in the table "JES2 attributes
  supported for policy type PreConversion", the following three
  rows should be added to the table and intermixed alphabetically
  by "Attribute Name":
  
  Attribute Name : DfltSchenv
  Modifiable     : Yes
  
  Attribute Name : JesLog
  Modifiable     : Yes
  
  Attribute Name : JobRC
  Modifiable     : Yes
  
  In "Chapter 74. JES2 policies", in the table "JES2 attributes
  supported for policy type SYSOUTGroup", the following two rows
  should be added to the table and intermixed alphabetically
  by "Attribute Name":
  
  Attribute Name : GroupID
  Modifiable     : Yes
  
  Attribute Name : OutDisp
  Modifiable     : Yes
  
  APAR OA61334 prereq's (and sup's) for FMID HJE77D0:
  Pre's: * NONE *
  

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:

  UJ05767

Modules/Macros

• HASLIPCS $JESLOG  HASPSPIN HASMFTEX HASMIOT  HASMBUFR HASMSJB
  $ZJC     HASMSTW  HASMTABL $POLICY  HASIBLD  HASMSRW  HASPPCY
  HASMDSIX HASPDYN  HASMDSET HASMSAPD HASCSRAX HASPJQS  HASCXJCT
  HASPMISC HASCCNVS HASCJZDN HASLUSER $PCYINTR HASPSXJB HASMJQE
  HASMSDB  $DOGJQE  HASPCSV  HASCSRIC HASCPCYC HASMBFD  HASPCOMM
  HASMBAT  HASMMODL HASMZJC  HASPNPM  HASCNJEX HASMDSCA HASCEDS
  HASCDSAL HASMPCE3 HASCSRCI HASPCNVT HASPWARM HASMEDSM HASMIPSV
  HASJMON  HASCSRJM HASMSCID HASMJSMT HASMJCT
  

Fix information

• Fixed component name

  JES2

• Fixed component ID

  5752SC1BH

Applicable component levels

• R7D0 PSY UJ05767

     UP21/06/16 P F106

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.