OA44202: NEW FUNCTION FOR SA PROCOPS ZENTERPRISE ZBX ENSEMBLE MANAGEMENT:INITIATE PRIMARY/ALTERNATE ROLE SWITCH FOR THE ZENTERPRISE HMC.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• A zEnterprise ensemble is managed by a pair of HMCs that operate
  in a primary/alternate configuration rather than by a single
  HMC. At any point in time, one HMC of the pair is designated as
  the primary HMC and has active management responsibility for the
  resources of the ensemble. The other HMC is designated as the
  alternate HMC, and when in this role acts only as a standby for
  the primary HMC and mirrors configuration updates from the
  primary in case the primary fails, but does not otherwise
  perform active management.  The Web Services API should be
  enabled on both the primary and alternate HMCs of the pair in
  order to use the function. The HMC UserIDs and Passwords used
  for the SA ProcOps should be in sync on both HMCs in the pair.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All System Automation for z/OS customers of  *
  *                 Release 3.4 using the Processor              *
  *                 Operations function of the product to manage *
  *                 the zEnterprise Ensemble zBX(Blade Center    *
  *                 Extensions) resources. All GDPS customers    *
  *                 using the GDPS DCM suport for the            *
  *                 zEnterprise and zBX.                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. New function to support Ensemble HMC *
  *                      switch.                                 *
  *                      2.Coexistence with the RxSocket REXX    *
  *                      Socket API if ProcOps ISQECMD is        *
  *                      called from an automation script        *
  *                      using the REXX sockets.                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  1. New function ISQECMD HMCSWITCH allowing primary/alternate
  role switch.
  2. ISQECMD uses sockets to communicate with the HMC. Cleanup
  process occasionaly closed the socket 0 required for the
  RxSocket API. The cleanup process corrected to use correct
  socket id.
  

Problem conclusion

Temporary fix

Comments

• Modules INGCBX*, INGCBC00, INGRX850,ISQGSNCE,ISQECMD,ISQRCVM
  were changed to    support new function HMCSWITCH. Module
  INGCBXAP was changed to skip closing of  socket 0. Modules
  AOFB000, AOFHELPP, INGHPROC, ISQH$GEN were changed to provide
  HELP panels for the HMCSWITCH.
  

APAR Information

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

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

  UA72789 UA72790

Modules/Macros

• AOFB000  AOFHELPP HSAPRRAC INGBX0VN INGCBC00
  INGCBX00 INGHPROC INGRX850 ISQECMD  ISQGSNCE ISQH$GEN ISQRCVM
  

Fix information

• Fixed component name

  SYSTEM AUTO Z/O

• Fixed component ID

  5698SA300

Applicable component levels

• R340 PSY UA72789

     UP14/03/22 P F403

• R341 PSY UA72790

     UP14/03/22 P F403

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.