IBM Support

OA54814: NEW FUNCTION - system logger support for IBM zHyperWrite data replication

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • NEW FUNCTION -
    z/OS system logger has been enhanced to allow the use of IBM
    zHyperWrite data replication when it is configured at your
    installation.
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    *  Users of HBB77A0 and above releases                         *
    *                 using System Logger Services and using       *
    *                 IBM zHyperWrite data replication             *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    *  New function.                                               *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    New function.
    

Problem conclusion

Temporary fix

Comments

  • z/OS system logger has been enhanced to allow the use of IBM
    zHyperWrite data replication when it is configured at your
    installation.
    
    Refer to the HYPERWRITE specification in publication
    z/OS MVS Initialization and Tuning Reference topic
    "IECIOSxx (I/O related parameters)" for details, requirements,
    and enablement related to the IBM zHyperWrite data replication.
    
    Log stream data sets that system logger will allow IBM
    zHyperWrite data replication are:
     -  staging data sets for DASDONLY type log streams,
     -  offload data sets for both the DASDONLY type and
        Coupling Facility structure-based type log streams.
    
    Log stream data sets that system logger does NOT support using
    IBM zHyperWrite data replication are:
     -  staging data sets for Coupling Facility structure-based
        type log streams.
    
    See the documentation information for more details concerning
    this system logger enhancement.
    
    
    Multi System Application info -
     Before installing the PTFs for APAR OA54814 on any system in
     the SYSPLEX, the PTFs for APAR OA55079 MUST be installed and
     active on every system that makes use of log streams in the
     SYSPLEX.
    
     The PTFs for the APAR OA54814 enhancement may be applied and
     activated on one system at a time in the sysplex.
    
     An IPL is required to activate the PTFs for APAR OA54814
     on each system of the SYSPLEX, however, a rolling
     IPL is sufficient to accomplish the activation.
    
    
      Additional Searchable keywords:
       SYSPLEXDS
       D/T2107
       MSGIXG601I MSGIXG607I
    
    
    DOCUMENTATION Info for APAR OA54814 -
     Summary publication updates-
      SA232300XX   z/OS Summary of Message and Interface Changes
      SA231380XX   z/OS MVS Initialization and Tuning Reference
      SA380666XX   z/OS MVS System Commands
      SA380677XX   z/OS MVS System Messages, Vol 10 (IXC-IZP)
    
     z/OS Summary of Message and Interface Changes
        +-- list of changes --+
      SYS1.PARMLIB member IXGCNFxx
       - MANAGE statement has new HYPERWRITE ALLOWUSE specification
      SYS1.SAMPLIB IXGCNFxx member contains new default
       - MANAGE HYPERWRITE ALLOWUSE(YES)
      System Commands
       - SETLOGR MANAGE,HYPERWRITE,ALLOWUSE(YES|NO)
      System Messages
       - IXG601I message formatted portion (IXG607I) issued in
         response to DISPLAY LOGGER,IXGCNF ,MANAGE  command will now
         include MANAGE HYPERWRITE ALLOWUSE specification
    
    
     z/OS MVS Initialization and Tuning Reference
      +--- LOCATION IN PUBLICATION -------------------------------+
      +-- IXGCNFxx parmlib member, new MANAGE statement keywords--+
      +--  new information in sections -                        --+
      +--    Syntax format of IXGCNFxx                          --+
      +--    Statements and parameters for IXGCNFxx             --+
      +--  A "+" in the left-hand column designates added text  --+
    
    IXGCNFxx member-
     Specifying the IXGCNFxx members
    
     Syntax format of IXGCNFxx
          . . .
          MANAGE
           . . .
     +      HYPERWRITE
     +        ALLOWUSE(YES | NO)
     +                 ---
           . . .
    
     Statements and parameters for IXGCNFxx
    
      MANAGE
       Provides the resource management policy for system logger.
       . . .
    
     + HYPERWRITE
     +  Specifies the system logger policy on the system for IBM
     +  zHyperWrite data replication use for log stream data sets.
     +
     +  ALLOWUSE(YES|NO)
     +           ---
     +   YES
     +    Indicates that use of IBM zHyperWrite data replication is
     +    allowed as system logger writes to certain log stream data
     +    sets on the particular system as follows:
     +     -  staging data sets for DASDONLY type log streams,
     +     -  offload data sets for both the DASDONLY type and
     +        Coupling Facility structure-based type log streams.
     +
     +    Note:  system logger does NOT support IBM zHyperWrite
     +    data replication for:
     +     -  staging data sets for Coupling Facility
     +        structure-based type log streams.
     +
     +    Refer to the HYPERWRITE specification in topic
     +    "IECIOSxx (I/O related parameters)" for details,
     +    requirements, and enablement related to the
     +    IBM zHyperWrite data replication.
     +    requirements, and enablement related to the
     +    IBM zHyperWrite data replication.
     +
     +   NO
     +    Indicates that use of IBM zHyperWrite data replication is
     +    not allowed for any system logger log stream data sets on
     +    the particular system with this specification.
     +
     +   Default:  YES
    
    
     z/OS MVS System Commands
        +--- LOCATION IN PUBLICATION ----------------------------+
        +-- SETLOGR MANAGE command new parameters              --+
    
     The parameters for SETLOGR MANAGE are -
    
     Syntax-
      Table. SETLOGR MANAGE Command   < new options >
      SETLOGR MANAGE,
                . . .
     +          { HYPERWRITE           }
     +          {  ,ALLOWUSE(YES|NO)   }
                . . .
    
     Parameters-
       . . .
     +
     + HYPERWRITE
     +  Specifies the system logger policy on the system for IBM
     +  zHyperWrite data replication use for log stream data sets.
     +  Changes will take effect on any subsequent writes to the
     +  supported log stream data sets.
     +
     +  ALLOWUSE(YES|NO)
     +
     +   YES
     +    Indicates that use of IBM zHyperWrite data replication is
     +    allowed as system logger writes to certain log stream data
     +    sets on the particular system as follows:
     +     -  staging data sets for DASDONLY type log streams,
     +     -  offload data sets for both the DASDONLY type and
     +        Coupling Facility structure-based type log streams.
     +
     +    Note:  system logger does NOT support IBM zHyperWrite
     +    data replication for:
     +     -  staging data sets for Coupling Facility
     +        structure-based type log streams.
     +
     +    Refer to the HYPERWRITE specification in topic
     +    "IECIOSxx (I/O related parameters)" for details,
     +    requirements, and enablement related to the
     +    IBM zHyperWrite data replication.
     +
     +   NO
     +    Indicates that use of IBM zHyperWrite data replication is
     +    not allowed for any system logger log stream data sets on
     +    the particular system with this specification.
    
    
     z/OS MVS System Messages
        +--- LOCATION IN PUBLICATION ----------------------------+
        +--  changed Logger messages                           --+
        +--        IXG601I, IXG607I                            --+
    
      The (IXG607I) formatted portion of IXG601I message issued in
      response to DISPLAY LOGGER,IXGCNF ,MANAGE  command now
      includes MANAGE HYPERWRITE ALLOWUSE specification.
    
        LOGGER            PARAMETER OPTIONS
        KEYWORD           SOURCE    VALUE
        ----------------- --------  ------------------------------
        MANAGE
         OFFLOAD
          ALLOCAHEAD      DEFAULT   YES
          USEOFFLOADMIN   DEFAULT   YES
         STAGING
          USESTAGINGMIN   DEFAULT   YES
     +   HYPERWRITE
     +    ALLOWUSE        DEFAULT   YES
         LOGRCDS
          ALLOWACCESS     DEFAULT   YES
    
    &#215;**** PE19/03/27 FIX IN ERROR. SEE APAR OA57187  FOR DESCRIPTION
    &#215;**** PE19/03/27 FIX IN ERROR. SEE APAR OA57187  FOR DESCRIPTION
    &#215;**** PE19/03/27 FIX IN ERROR. SEE APAR OA57187  FOR DESCRIPTION
    &#215;**** PE19/04/30 FIX IN ERROR. SEE APAR OA57408  FOR DESCRIPTION
    &#215;**** PE19/04/30 FIX IN ERROR. SEE APAR OA57408  FOR DESCRIPTION
    

APAR Information

  • APAR number

    OA54814

  • Reported component name

    SYSTEM LOGGER

  • Reported component ID

    5752SCLOG

  • Reported release

    7A0

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / SYSPLXDS /

  •  

    Xsystem

  • Submitted date

    2018-01-29

  • Closed date

    2018-09-19

  • Last modified date

    2019-07-22

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

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

    UA97466 UA97467

Modules/Macros

  • IXGMLSAB IXGA1AUS IXGE1TPR IXGCNFXX IXGD2IN1 IXGD2WRT IXGYLSAB
    IXGP1DSP IXGL1SUX IXGA1SWT IXGE1TLX IXGILSAB IXGE3CNF IXGA1MM
    IXGD2RED IXGE1CNF IXGA1MTX IXGYSTBL
    

Publications Referenced
SA23230000SA23138000SA38066600SA38067700 

Fix information

  • Fixed component name

    SYSTEM LOGGER

  • Fixed component ID

    5752SCLOG

Applicable component levels

  • R7A0 PSY UA97467

       UP18/09/27 P F809  

  • R7B0 PSY UA97466

       UP18/09/27 P F809  

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.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7A0","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":null,"label":null},"Product":{"code":"SG19O","label":"APARs - MVS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7A0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
22 July 2019