PM96134: THIS APAR PROVIDES SUPPORT FOR IBM WEBSPHERE MQ FOR Z/OS VALUE UNIT EDITION, V7.1

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides support for IBM WebSphere MQ for z/OS
  Value Unit Edition, V7.1
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
  *                 Release 1                                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR is the installation           *
  *                      pre-requisite for unannounced new       *
  *                      function.                               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The PTF for this APAR is required to provide functions ew
  available in WebSphere MQ for z/OS Value Unit Edition, V7.1.
  

Problem conclusion

Temporary fix

Comments

• A new section is added to the WebSphere MQ for z/OS information
  center section 'Installing WebSphere MQ for z/OS product':
  (q116230_)
  IBM WebSphere MQ for z/OS Value Unit Edition
  
  IBM WebSphere® MQ for z/OS® Value Unit Edition (VUE) provides
  all the function and capability of the base WebSphere MQ for
  z/OS, in a format that offers a one-time-charge (OTC) price
  metric for eligible workloads that are deployed in qualified
  System z New Application License Charge (zNALC) logical
  partitions (LPARs).
  
  The term, Eligible Workload, is defined as new workload that
  executes using the WebSphere MQ for z/OS VUE server environment,
  on condition that the workload is qualified and approved
  through the zNALC qualification process.
  
  For further information on zNALC, see
  http://www.ibm.com/systems/z/resources/swprice/mlc/znalc.html
  
  The OTC price metric provides an alternative pricing model for
  new WebSphere MQ for z/OS-connected applications and new
  WebSphere MQ for z/OS VUE service enablement workloads.
  
  Support for the zNALC metric offers a reduced price for the
  z/OS operating system on LPARs that run a qualified application.
  
  WebSphere MQ for z/OS VUE can connect to other supported
  versions of WebSphere MQ for z/OS (whether in zNALC or
  non-zNALC environments) for the purpose of workload federation
  and systems management.
  
  WebSphere MQ for z/OS VUE includes the code and entitlement to
  use WebSphere MQ for z/OS Client Attachment Feature, by
  allowing connections to WebSphere MQ Clients, that run on other
  platforms.
  
  Installing VUE
  
  An order for WebSphere MQ for z/OS VUE is fulfilled by delivery
  of two products:
  - WebSphere MQ for z/OS,
  - The WebSphere MQ for z/OS VUE enabling product itself.
  The products are separately installed using SMP/E following the
  process documented in their respective program directories.
  
  Enabling VUE
  
  To enable a queue manager to run an eligible workload in a
  zNALC LPAR, the SCUEAUTH library created by installation of the
  WebSphere MQ for z/OS VUE enabling product must be added to the
  STEPLIB concatenation of the xxxxMSTR procedure for that queue
  manager:
  
  - The SCUEAUTH library should be APF authorized
  - The SCUEAUTH libary must be concatenated ahead of the
    SCSQAUTH library, for example, the CSQ4MSTR sample would be
    modified as follows:
  
    //PROCSTEP EXEC PGM=CSQYASCP,REGION=0M,MEMLIMIT=2G
    //*ter.
    //STEPLIB   DD DSN=hlq.SCSQANLE,DISP=SHR
    //          DD DSN=hlq.SCUEAUTH,DISP=SHR
    //          DD DSN=hlq.SCSQAUTH,DISP=SHR
   -
  When SCUEAUTH is added to the STEPLIB concatenation, the
  characters VUE appear in the release level shown by message
  CSQY000I during queue manager startup. The queue manager starts
  only in an LPAR configured for zNALC workload by name or IPL
  parameter.
  
  Characteristics of a VUE-enabled queue manager
  
  A VUE-enabled queue manager has all the function and capability
  of the base queue manager. Additionally, regardless of whether
  the client attachment feature was installed in the base queue
  manager libraries, clients will be enabled during channel
  initiator startup, and indicated active in message CSQX931I.
  
  Note that a VUE-enabled queue manager does not perform measured
  usage recording.
  
  A VUE-enabled queue manager can:
  - Connect to other queue managers and clients in a network,
    according to the connectivity capabilities of the base queue
    manager installation.
  - Participate in a queue sharing group with other queue managers
    provided the base queue manager versions are able to inter-
    operate, regardless of whether other members are standard or r
    VUE function queue managers.
  
  A new message, CSQY026E, is added:
  (q116240_)
  
  CSQY026E: csect-name QUEUE MANAGER STARTUP TERMINATED, VUE IN
  NON-ZNALC LPAR
  
  Explanation
  
  An attempt was made to start a queue manager. The queue manager
  is configured to use 'IBM WebSphere MQ for z/OS Value Unit
  Edition', however, VUE is not running in a z/OS LPAR defined for
  System z New Application License Charges (zNALC).
  
  System action
  
  Queue manager startup terminates abnormally.
  
  Operator response
  
  Notify the system programmer of the problem.
  
  System programmer response
  
  Verify the LPAR is correctly enabled for zNALC, or remove the
  SCUEAUTH library from the queue manager STEPLIB concatenation.
  

APAR Information

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

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

  UK97988

Modules/Macros

• CSQMCPRH CSQMSCHI CSQYASCP CSQYSCMD CSQ3ID30
  CSQ3ID80
  

Fix information

• Fixed component name

  WMQ Z/OS V7

• Fixed component ID

  5655R3600

Applicable component levels

• R100 PSY UK97988

     UP13/10/16 P F310

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.