A fix is available
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 / Xsystem
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
| 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.
[{"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":"780","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":"780","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
30 July 2013