OA38829: NEW FUNCTION - TRANSACTIONAL EXECUTION FACILITY SUPPORT FOR ZENTERPRISE EC12 (ZEC12) AND ZAAP ON ZIIP SUPPORT

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as new function.

Error description

  • New function
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: This apar has 2 audiences:                   *
    *                 1.  All users running z/OS 1.13 installing   *
    *                     zEnterprise EC12.                        *
    *                 2.  All users running z/OS 1.12 or 1.13      *
    *                     with zAAPs and zIIPs.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: Support for zEnterprise EC12            *
    *                      (z/OS 1.13 only)                        *
    *                      - support use of transactional          *
    *                        execution facility by Java or in a    *
    *                        test environment by applications      *
    *                      - allow the transactional execution     *
    *                        facility not to be exploited          *
    *                                                              *
    *                      For zIIPs and zAAPs                     *
    *                      (z/OS 1.12 or z/OS 1.13)                *
    *                      - zAAP on zIIP is excluded when any     *
    *                        zAAPs are on the machine              *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    New function support for the transactional execution facility
    and zAAP on zIIP.  search keywords: D/T2827 ZAAP/K ZIIP/K
    

Problem conclusion

Temporary fix

Comments

  • (For z/OS 1.13 only)
    zEnterprise EC12 provides the transaction execution facility.
    This facility may be used by Java and also may be used in a
    test environment by customer or ISV applications.  The
    customer may specify that the facility not to be exploited in
    order to minimize, temporarily, the software paths that change
    when migrating to the zEnterprise EC12.
    (For z/OS 1.12 or z/OS 1.13)
    To facilitate migration, zAAP on zIIP is now allowed when there
    is at least one zIIP and the number of zAAPs plus the number
    of zIIPs does not exceed the number of standard CPs.
    
    DOCUMENTATION HOLD FOR APAR OA38829
      +-------------------------------------------------------+
    
      MVS Data Areas, Volume 1
    
      | CVT Programming Interface information                 |
      CVTTVT
    | CVTTXTE
      CVTTZ
    
      |   CVT Map                                             |
      Offsets
      Dec  Hex   Type/Value Len Name(Dim) Description
      398  (18E) BITSTRING  1   CVTCTLFG  - System Control Flags
    |            1... ....      CVTTXTE   X'80' - A Transactional
    |                      Execution test environment is available.
    |                      When only such a test environment exists,
    |                      you should not use Transactional
    |                      Execution in product code.  In this test
    |                      environment, the limited diagnostic
    |                      data available upon such failures as
    |                      program interrupts may well be
    |                      inadequate to debug programs
                 ...1 ....      CVTDSTAT  X'10' - ...
      |   CVT Cross Reference                                 |
                    Hex     Hex
      Name          Offset  Value
      CVTTVT        9C
    | CVTTXTE       18E     80
      CVTTZ         130     0
    
      MVS Data Areas, Volume 2
    
      |   EPIE Map                                            |
      Offsets
      Dec  Hex   Type/Value Len Name(Dim) Description
    | 154  (9A)  CHARACTER  1   EPIEICX   Interrupt code extended
    |                                     info
    | 154  (9A)  .... ..1.      EPIEPITX
    | 155  (9B)  CHARACTER  1             RESERVED
      156  (9C)  CHARACTER  4   EPIERTOK  ...
      |   EPIE Cross Reference                                |
                    Hex     Hex
      Name          Offset  Value
      EPIEICD1      53
    | EPIEICX       9A
      EPIEILC1      51
      ...
      EPIEPERC      99      10
    | EPIEPITX      9A      02
      EPIEPSW       48
    
      MVS Data Areas, Volume 3
    
      |   IHAIPA Map                                          |
        Offsets
        Dec  Hex   Type/Value Len Name(Dim) Description
      | 2128 (850) ADDRESS    4   IPAMACHMIGADDR -
      |                          Address of MACHMIG statements.
      |                          This is an array of 64-character
      |                          card images.  The number of
      |                          array entries is indicated by
      |                          IPANumMachmigs
      | 2132 (854) SIGNED     2   IPANUMMACHMIGS -
      |                          Number of MACHMIG statements
          IHAIPA Cross Reference                              |
                    Hex     Hex
      Name          Offset  Value
      IPALPNAM      20
    | IPAMACHMIGADDR
    |               850
      IPAMAXCA      978
      ...
      IPANUCXID     867
    | IPANUMMACHMIGS
    |               854
      IPANUMPDES    85C
    
      | IHATDB Programming Interface information (new)        |
    | ---------- Programming Interface information ----------
    | |                       IHATDB                        |
    | ------ End of Programming Interface information -------
      |   IHATDB Heading Information (new)                    |
    | Common Name:          Transaction Diagnostic Block
    | Macro ID:             IHATDB
    | DSECT Name:           TDB
    | Owning Component:     Supervisor Control (SC1C5)
    | Eye-Catcher ID:       NONE
    | Storage Attributes:   Subpool:   Caller-supplied
    |                       Key:       Caller-supplied
    |                       Residency: Caller-supplied
    | Size:                 TDB   -- X'0100' bytes
    | Created by: - The machine, and placed into low storage field
    |               PsaxPITDB for a program interruption that
    |               occurs while the CPU is in the transactional
    |               execution mode. This is the PITDB.
    |             - The user of TBEGIN/TBEGINC, and set by the
    |               set by the machine on a transaction abort.
    |               This is the user TDB.
    | Pointed to by:        None
    | Serialization:        None required
    | Function:     Maps the Transaction Diagnostic Block.  This
    |               is an architected area.  For complete info,
    |               refer to the Principles of Operation.
      |   IHATDB Map (new)                                    |
    | Offsets
    | Dec  Hex   Type/Value Len  Name(Dim)     Description
    |   0    0   CHARACTER    1  TDB_Format    See macro IHATDB
    |   1    1   BITSTRING    1  TDB_Flags
    |   1    1   1... ....       TDB_Flags_CTV
    |   1    1   .1.. ....       TDB_Flags_CTI
    |   2    2   CHARACTER    4  TDB_R002
    |   6    6   CHARACTER    2  TDB_TND
    |   8    8   CHARACTER    8  TDB_TAC
    |  16   10   CHARACTER    8  TDB_ConflictToken
    |  24   18   CHARACTER    8  TDB_AbortedTranIA
    |  32   20   CHARACTER    1  TDB_EAD
    |  33   21   CHARACTER    1  TDB_DXC
    |  34   22   CHARACTER    2  TDB_R022
    |  36   24   CHARACTER    4  TDB_PIID
    |  40   28   CHARACTER    8  TDB_TEID
    |  48   30   CHARACTER    8  TDB_BEA
    |  56   38   CHARACTER   56  TDB_R038
    | 112   70   CHARACTER   16  TDB_MDDI
    | 128   80   CHARACTER  128  TDB_GRS
      |   IHATDB Cross Reference (new)                        |
    |               Hex     Hex
    | Name          Offset  Value
    | TDB_AbortedTranIA
    |                18
    | TDB_BEA        30
    | TDB_ConflictToken
    |                10
    | TDB_DXC        21
    | TDB_EAD        20
    | TDB_Flags       1
    | TDB_Flags_CTI   1     40
    | TDB_Flags_CTV   1     80
    | TDB_Format      0
    | TDB_GRS        80
    | TDB_MDDI       70
    | TDB_PIID       24
    | TDB_R002        2
    | TDB_R022       22
    | TDB_R038       38
    | TDB_TAC         8
    | TDB_TEID       28
    | TDB_TND         6
    
      MVS Initialization and Tuning Reference
    
      | LOADxx (system configuration data sets)               |
      The LOADxx member specifies:
      - Information about the parmlib concatenation.
    | - Facilities that are not to be exploited because migration
    |   to a newer machine and/or operating system release is
    |   underway.
      |   Syntax format of LOADxx                             |
      IODF xx hiqualif configid id y s
    | MACHMIG x1,x2,...,xn
      NUCLEUS n
      |   Statement/parameters for LOADxx                     |
    | MACHMIG
    |   Identifies one or more facilities that you do not want z/OS
    |   to use at this time because migration to another processor,
    |   z/OS release, or both is underway.
    |
    |   Code the MACHMIG statement as follows:
    |
    |   Column Contents
    |   1-7    MACHMIG
    |   10-72  A list of facilities not to use. When more than one
    |          facility is listed, separate each from the previous
    |          by one or more blanks or commas.  The following
    |          facilities may be specified in upper, lower, or
    |          mixed case:
    |          - EDAT2 - the hardware-based enhanced-DAT facility 2
    |          - TX - the hardware-based transactional-execution
    |                 facility
    |
    | Example: The following example shows a MACHMIG statement
    | that tells the system not to use the transactional execution
    | facility and the enhanced DAT facility 2.
    |
    | *
    | *---+----1----+----2----+----3----+----4----+----5----+----6..
    | MACHMIG TX,EDAT2
    | *
    |
    | Default: None. If you do not specify a MACHMIG statement,
    | the system does not limit its use of machine facilities.
    
      MVS Initialization and Tuning Reference
    
      | IEASYSxx (system parameter list)                      |
      |   Statements/parameters for IEASYSxx                  |
      |     ZAAPZIIP                                          |
      - Replace the following bullet:
    
      No zAAPs in the configured state are installed on the ...
      - With:
    | There are no zAAPs installed on the machine or, when there
    | is at least one zAAP installed, the number of installed
    | zAAPs plus the number of installed zIIPs does not exceed
    | the number of installed standard CPs. The installed
    | processors mentioned in the preceding sentence are those
    | in the configured state only; processors in the standby
    | or reserved state do not apply.
    
      MVS System Messages, Vol 6 (GOS-IEA)
    
      |   IEA661I (new)                                       |
    | IEA661I MAXIMUM NUMBER OF MACHMIG STATEMENTS EXCEEDED
    |
    | Explanation: More than 3 MACHMIG statements were specified
    |              in LOADxx.
    | System Action: IPL Continues
    | Source: Initial Program Load (IPL)
    | Detecting Module: IPXI50PS
      |   IEA662I (new)                                       |
    | IEA662I MACHMIG STATEMENT IGNORED: stmt
    |
    | Explanation: A MACHMIG statement is ignored because more
    | than 3 (the maximum allowed) MACHMIG statements have been
    | specified.
    |
    | In the message text:
    | stmt
    |   Columns 10-72 of the MACHMIG statement that will not be
    |   used.
    | System Action: IPL Continues
    | Source: Initial Program Load (IPL)
    | Detecting Module: IPXI50PS
      |   IEA663I (new)                                       |
    | IEA663I LOADXX MACHMIG STATEMENT PARAMETER parm
    |         WAS NOT RECOGNIZED. INITIALIZATION CONTINUES
    |
    | Explanation: An error was detected within a MACHMIG statement
    |              from the LOADxx parmlib member.
    | In the message text:
    | parm
    |   The parameter that was not recognized. If the parameter was
    |   longer than 16 characters, only the first 16 characters are
    |   shown.
    | System Action: IPL Continues
    | Source: Initial Program Load (IPL)
    | Detecting Module: IEAIPL99
    
      MVS System Messages, Vol 7 (IEB-IEE)
    
      |   IEE580I (new)                                       |
    | IEE580I hh.mm.ss LOADXX MACHMIG
    | machmig_stmt
    | machmig_stmt
    | NO MACHMIG STATEMENTS WERE PROVIDED
    |
    | Explanation: In response to a DISPLAY IPLINFO,LOADXX,
    | MACHMIG command, this message displays all the relevant
    | MACHMIG statements from the LOADxx parmlib member, or
    | indicates that there were none.
    |
    | In the message text:
    | hh.mm.ss
    |   The current time. The time format is in hours (00-23),
    |   minutes (00-59) and seconds (00-59).
    | machmig_stmt
    |   Columns 10-72 of a MACHMIG statement from the LOADxx
    |   parmlib member.
    |
    | System Action: The system continues processing.
    | Source: Master scheduler
    | Detecting Module: IEECB985
    | Routing Code: *
    | Descriptor Code: 5
      |   IEE256I                                             |
    | INACTIVE - TOO MANY ZAAPS+ZIIPS INSTALLED ON THE MACHINE:
    | The zAAP on zIIP function is not active because the machine
    | has:
    |
    | - one or more zAAPs; and
    | - the number of zAAPs plus the number of zIIPs exceeds the
    |   number of standard CPs
    |
    | The standard CPs, zAAPs, and zIIPs used in the calculation
    | are those installed on the machine that are in the
    | configured state (and need not have been defined to this
    | LPAR).  The presence of installed processors (whether
    | standard CPs, zAAPs, or zIIPs) in the standby or reserved
    | state does not affect the state of the zAAP on zIIP
    | function.
    
      MVS System Commands
    
      | MVS System Commands Reference                         |
      |   DISPLAY Command                                     |
      |     Displaying IPL information                        |
      - Before the syntax diagram, add:
    
    | Use the DISPLAY IPLINFO,LOADXX,MACHMIG command to display
    | the MACHMIG statement(s) from the LOADxx parmlib member.
    | The output is message IEE580I.
      - Change the syntax diagram to:
    | D IPLINFO   ,sysparm ,STATE   |  ,LOADXX,MACHMIG
    |            L={a|name|name-a}
    

APAR Information

  • APAR number

    OA38829

  • Reported component name

    SUPERVISOR CONT

  • Reported component ID

    5752SC1C5

  • Reported release

    780

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function

  • Submitted date

    2012-02-16

  • Closed date

    2012-08-28

  • Last modified date

    2013-07-30

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

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

    UA66428 UA66429 UA66430 UA66431

Modules/Macros

  •    IEAECVTP IEAIPL50 IEAIPL99 IEAVEDS0 IEAVEIO
    IEAVEPC  IEAVEPCO IEAVERES IEAVESPI IEAVESRT IEAVNIPH IEAVNIPX
    IEAVNIP0 IEAVTPER IEAVTRT1 IEECB985 IEECNAEN IEECNAJP IGFPMCIH
    IHAECVT  IHAEPIE  IHAIPA   IHAPSAX  IHATDB   IPXBRIDG IPXI50PS
    IPXLOADX IRASR204 SPPPACK
    

Publications Referenced
GA320853XX GA320854XX GA320855XX SA227592XX SA227637XX
SA227636XX SA227637XX SA227627XX    

Fix information

  • Fixed component name

    SUPERVISOR CONT

  • Fixed component ID

    5752SC1C5

Applicable component levels

  • R77J PSY UA66430

       UP12/09/12 P F209

  • R770 PSY UA66428

       UP12/09/12 P F209

  • R78J PSY UA66431

       UP12/09/12 P F209

  • R780 PSY UA66429

       UP12/09/12 P F209

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.



Rate this page:

(0 users)Average rating

Document information


More support for:

z/OS family

Software version:

780

Operating system(s):

MVS, z/OS

Reference #:

OA38829

Modified date:

2013-07-30

Translate my page

Machine Translation

Content navigation