OA68094: NEW FUNCTION - JES2 Policy Improvements

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• NEW FUNCTION - Extend JES2 Policies with more Actions,
  Attributes, and Functions.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of HJE77E0.                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: Updates were identified for JES2        *
  *                      Policy types to provide additional      *
  *                      Actions, Attributes, and Functions.     *
  ****************************************************************
  Updates to JES2 Policy types in z/OS 3.1 JES2, delivered by
  APAR OA68094, will address the following requirements:
  
  - Several Actions, Attributes, and Functions have been added,
    fixed, or improved in JES2 Policy types in z/OS 3.1 JES2.
  - A new Policy feature that provides access to the Policy
    import path and time of import (via SSI82) was introduced
    to JES2 Policies in z/OS 3.2 JES2. JES2 Policies imported on
    z/OS 3.1 JES2 should also save this information for access by
    z/OS 3.2 JES2 members.
  

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).
  
  JES2 Policy code has been changed to provide enhancements in
  this APAR.
  
  Enhancements for ALL Policy types:
  - New Action: SetArea
  - New Attributes: JCTUser, JCTUserC, SubmittedLocally,
                    CreatedLocally, OriginMember, OriginNode,
                    ConversionMember
  - New Functions: Uppercase, Lowercase, and ValidJobName
  
  Enhancements for the JobCreate Policy type:
  - New Action: HoldJob
  - New Attributes: HasPassword, HasPassphrase, StmtName
  
  Enhancements for the JobInput Policy type:
  - New Attributes: HasPassword and HasPassphrase
  
  Enhancements for the PreConversion Policy type:
  - New Attribute: DfltStepTime
  
  The Policy import path and time of import are saved for
  access by z/OS 3.2 JES2 members.
  
  **********************************************************
  *                                                        *
  *  The new capabilities may not be fully available until *
  *  all members of the MAS have this fix applied.         *
  *                                                        *
  **********************************************************
  
  The information in the following JES2 manuals/publications
  is missing/incorrect:
  
  1. SA32-0995-60 z/OS 3.1 JES2 Installation Exits (for HJE77E0)
     SA32-0995-70 z/OS 3.2 JES2 Installation Exits (for HJE77F0)
  
  Updates were made to the MVS 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.
  
  
  2. SA32-0989-60 z/OS 3.1 Messages (for HJE77E0)
     SA32-0989-70 z/OS 3.2 Messages (for HJE77F0)
  
  In "Chapter 14. One-thousands", do the following. Update the
  $HASP1660 and $HASP1661 messages. These messages were
  erroneously overwritten and are being restored. Add the new
  $HASP1669 and $HASP1670 messages in numeric order.
  
  ----------------------------------------------------------------
  $HASP1660
  
  Explanation
  >>-- AuthorityCheck: RACROUTE resulted in nnn/mmm/rrr. --><
  
  This informational message is issued by AuthorityCheck()
  function used in the JES2 policy definition, when JES2 policy
  function operates in debug mode (See $T DEBUG - Set the JES2
  DEBUG option in z/OS JES2 Commands). The message reports the
  results of the call to z/OS Security Server RACROUTE macro.
  
  In the message text:
  
  nnn
    SAF return code.
  mmm
    RACF return code.
  rrr
    RACF reason code.
  
  System action
  Processing continues.
  
  Operator response
  None.
  
  Programmer response
  Consult z/OS Security Server RACF documentation about the
  meaning of reported return and reason code.
  
  Module
  HASCPCYC
  
  Routing Code: 2, 10
  
  Descriptor Code: 4
  
  -------------------------------------------------
  $HASP1661
  
  Explanation
  >>-- message text --><
  
  This message is issued by SendMessage action specified in a
  JES2 policy. Content of this message is defined by a JES2
  administrator when defining a JES2 policy.
  
  In the message text:
  
  message text
      text specified on "message" specification of a SendMessage
      action.
  
  System action
  Processing continues.
  
  Operator response
  None.
  
  Programmer response
  None.
  
  Module
  HASCPCYC
  
  Routing Code: 2, 10
  
  Descriptor Code: 4
  
  -------------------------------------------------
  $HASP1669
  
  Explanation
  >>-- Entry --- entryname --- is required for variable
      declaration. --><
  
  This error message is issued during $POLICY IMPORT command
  processing to indicate that a required part of the variable
  declaration in the policy definition was not found.
  
  In the message text:
  entryname
      JSON name that represents the missing part of the variable
      declaration.
  
  System action
  Policy definition is rejected.
  
  Operator response
  None.
  
  Programmer response
  Correct the error in the policy definition, repeat the command.
  
  Module
  HASCPCYC
  
  Routing Code: 1, 2, 10
  
  Descriptor Code: 5
  
  ----------------------------------------------------------------
  $HASP1670
  
  Explanation
  >>-- Too many variables declared. --><
  
  This error message is issued during $POLICY IMPORT command
  processing when policy definition contains too many variables.
  
  System action
  Policy definition is rejected
  
  Operator response
  None.
  
  Programmer response
  Reduce number of variables used in a policy definition and
  retry $POLICY IMPORT command.
  
  Module
  HASPPCY
  
  Routing Code: 1, 2, 10
  
  Descriptor Code: 5
  
  ----------------------------------------------------------------
  Searchable keywords:
   - $HASP1660
   - msgHASP1660
   - $HASP1661
   - msgHASP1661
   - $HASP1669
   - msgHASP1669
   - $HASP1670
   - msgHASP1670
  
  
  APAR OA68094 prereq's (and sup's) for FMID HJE77E0:
  Pre's: EA64584 EA64769 EA65052 EA65663
  

APAR Information

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

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

  UJ98061

Modules/Macros

• $PCYINTR $POLICY  HASCBLDM HASCPCYC HASMFTEX HASMPLCY HASMTABL
  HASPMSG  HASPPCY  HASPSSRV
  

Fix information

• Fixed component name

  JES2

• Fixed component ID

  5752SC1BH

Applicable component levels

• R7E0 PSY UJ98061

     UP25/10/01 P F509  

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.