A fix is available
APAR status
Closed as new function.
Error description
New function - provide enhanced information about coupling channel configuration for display, IPCS, and accounting and measurement. PE Information : -User Affected : Customers with PTF UA66418 applied without UA59908 in HBB7770, and UA66419 applied without UA59909 in HBB7780. -User Impact : APAR OA37550 provided the intended new function but introduced a new problem. OA37550 provided performance and RAS enhancements for coupling facility cache structure exploiters. ABEND026-0C0E1026 occurs with CACHE structure related access. If ECS structure was utilized in the plex, Catalog address space could suffer failure with its access of str and LPAR could NOT operate normally.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: Installations exploiting parallel sysplex at * * z/OS V1R12 (HBB7770) and above. * **************************************************************** * PROBLEM DESCRIPTION: Provide enhanced information about * * coupling channel configuration for * * display, IPCS, and accounting and * * measurement. * * * * SYSPLEXDS E2827/K * **************************************************************** * RECOMMENDATION: Install the applicable PTF on each system in * * the sysplex. A rolling IPL is sufficient to * * activate the fix. * **************************************************************** This APAR enhances display, IPCS, and accounting and measurement output to provide additional information about coupling facility message channels, including protocol in use, operational status, and physical configuration.
Problem conclusion
Temporary fix
Comments
Updated the following to report additional channel path characteristics for directly-connected and remotely-connected (i.e., peer-to-peer linked) coupling facilities (CFs). o DISPLAY CF (directly- and remotely-connected CFs) o DISPLAY M=CHP (directly-connected CFs) o The IXLMG accounting and measurement API (directly- and remotely-connected CFs) o The IPCS XESDATA FACILITY report (directly- and remotely- connected CFs). The enhanced subchannel reporting function is provided by the zEnterprise EC12 (zEC12) processor (D/T 2827). o To report or display the additional channel path information for directly-connected CFs, z/OS must be running on a zEC12 processor. o To report or display the additional channel path information for remotely-connected CFs, the directly-connected CF must be running on a zEC12 processor (CFLEVEL 18 or higher). +--- PUBLICATIONS AFFECTED -------------------------------+ | | | o z/OS MVS System Messages, Vol 10 (IXC-IZP) - SA22-7640| +---------------------------------------------------------+ Update message IXL150I: ----------------------- IXL150I hh.mm.ss DISPLAY CF COUPLING FACILITY type.mfg.plant.sequence PARTITION: partition side CPCID: cpcid | LP NAME: lparname CPC NAME: cpcname CONTROL UNIT ID: cuid NAMED cfname . . . DYNAMIC CF DISPATCHING: ON|OFF | COUPLING FACILITY IS standalonestate COUPLING FACILITY HAS ONLY ONE ONLINE SENDER PATH | mtofstatus | REASON: mtofreason COUPLING FACILITY SPACE CONFIGURATION IN USE FREE TOTAL CONTROL SPACE: inusespace u cfreespace u ctotspace u NON-CONTROL SPACE: ncinusespace u ncfreespace u nctotspace u NO COUPLING FACILITY SPACE DATA AVAILABLE | PATH PHYSICAL LOGICAL CHANNEL TYPE AID PORT | chpid /pchid phystatus logstatus chtype pathmode aid port . . . REMOTELY CONNECTED COUPLING FACILITIES CFNAME COUPLING FACILITY -------- -------------------------- rfcfname rftype.rfmfg.rfplant.rfsequence PARTITION: partition rfside CPCID: rfcpcid CHPIDS ON LF01 CONNECTED TO REMOTE FACILITY RECEIVER: CHPID TYPE | rfchpid rfchtype rfpmode SENDER: CHPID TYPE | rfchpid rfschtype rfspmode | * = PATH OPERATING AT REDUCED CAPACITY Explanation: The message provides the output for a DISPLAY CF command. . . . cpcid Node Central Processor Complex (CPC) ID (See ndecpcid in IXLYNDE). | lparname | Name assigned to the logical partition in which the CF is | running. "N/A" indicates that the name is not available. | cpcname | Name assigned to the CPC on which the CF is running. "N/A" | indicates that the name is not available. . . . | standalonestate | | One of the following: | | STANDALONE | The CF resides on a CEC with no general-purpose | processors, so that no z/OS image can run on the CEC. | | NOT STANDALONE | The CF resides on a CEC with at least one general-purpose | processor, so it is possible to configure a z/OS image on | the same CEC. . . . phystatus One of the following: ONLINE The path chpid to the coupling facility cfname is physically available for use. The chpid is configured online and is operating. | ONLINE - DEGRADED | The path chpid to the coupling facility cfname is | physically available for use. The chpid is configured | online and is operating, but at a reduced capacity. OFFLINE The path chpid to the coupling facility cfname is configured offline. . . . | pathmode | H | The channel path supports a 1.0625 Gb/sec data rate (half | rate). | | F | The channel path supports a 2.125 Gb/sec data rate (full | rate). It may operate at either 1.0625 or 2.125 Gb/sec. | | 1X-IFB | The channel path is operating at 1X bandwidth using the | IFB protocol. | | 12X-IFB | The channel path is operating at 12X bandwidth using the | IFB protocol. | | 12X-IFB3 | The channel path is operating at 12X bandwidth using the | IFB3 protocol. | | aid | The adapter identifier associated with path chpid, if | applicable and available. | | port | The port associated with path chpid, if applicable and | available. . . . rfchpid CHPID installed on cfname that is being used for a peer connection between coupling facility cfname and coupling | facility rfcfname. An asterisk following the CHPID | indicates that the path is operating at reduced capacity. . . . | rfpmode - same as pathmode . . . | rfspmode - same as pathmode . . . Delete message IXL141I ---------------------- Actually issued as IEE174I. +--- PUBLICATIONS AFFECTED -------------------------------+ | | | o z/OS MVS System Messages, Vol 7 (IEB-IEE) - | | SA22-7637 | +---------------------------------------------------------+ Update message IEE174I format 17: --------------------------------- COUPLING FACILITY type.mfg.plant.sequence PARTITION: partition side CPCID: cpcid CONTROL UNIT ID: cuid NAMED cfname | PATH PHYSICAL LOGICAL CHANNEL TYPE AID PORT | chpid /pchid phystatus logstatus chtype pathmode aid port | COUPLING FACILITY SUBCHANNEL STATUS | TOTAL: totdev IN USE: usedev NOT USING: nusedev NOT USABLE: unusedev | NOT OPERATIONAL DEVICES / SUBCHANNELS: | dev / subch dev / subch dev / subch dev / subch Explanation: A reconfiguration display request (a DISPLAY M=CHP(chp) command) asked the system to display the status of a channel path and the devices connected to it. In the message text: . . . phystatus One of the following: ONLINE The path chpid . . . | ONLINE - DEGRADED | The path chpid to the coupling facility cfname is | physically available for use. The chpid is configured | online and is operating, but at a reduced capacity. . . . NOT OPERATIONAL The path chpid . . . | NOT IN CONFIGURATION The path, chpid . . . FACILITY PAUSED The path, chpid . . . | PATH NOT AVAILABLE The path, chpid . . . . . . | chtype One of the following: . . . | pathmode | H | The channel path supports a 1.0625 Gb/sec data rate (half | rate). | | F | The channel path supports a 2.125 Gb/sec data rate (full | rate). It may operate at either 1.0625 or 2.125 Gb/sec. | | 1X-IFB | The channel path is operating at 1X bandwidth using the | IFB protocol. | | 12X-IFB | The channel path is operating at 12X bandwidth using the | IFB protocol. | | 12X-IFB3 | The channel path is operating at 12X bandwidth using the | IFB3 protocol. | | aid | The adapter identifier associated with path chpid, if | applicable and available. | | port | The port associated with path chpid, if applicable and | available. | | totdev | Number of coupling facility subchannels that have been | defined for this system. | | usedev | Number of coupling facility subchannels that are currently | being used by this system to execute requests to the | coupling facility. This is equal to the number of concurrent | operations that can be initiated to this coupling facility | minus any subchannels that are not being used because of | subchannel tuning actions. | | nusedev | Number of coupling facility subchannels that are eligible to | be used but are not currently being used by this system to | execute requests to the coupling facility. This is equal to | the number of subchannels that have been taken out of the | pool of usable subchannels by subchannel tuning actions. | This count may temporarily include some number of | subchannels when a readjusting of the IN USE subchannel | count is in progress as a result of configuration actions | against CF Links for this facility. | | unusedev | Number of coupling facility subchannels that have been | defined for this system but which cannot be used to execute | requests to the coupling facility. Equal to the number of | sub-channels defined that are in excess of the number of | concurrent operations that can be initiated to this coupling | facility. This count also includes the number of | not-operational subchannels, if any. | | dev | Coupling facility device. | | subch | Coupling facility subchannel. +--- PUBLICATIONS AFFECTED -------------------------------+ | | | o z/OS MVS Sysplex Services Reference SA22-7618 | +---------------------------------------------------------+ Chapter "IXLMG - Coupling Facility Measurement" ----------------------------------------------- Added IXLYAMDCFCP and IXLYAMDCFCPINFO DSECTs to the description. +--- PUBLICATIONS AFFECTED -------------------------------+ | | | o z/OS MVS Data Areas Volume 4 GA32-0856 | +---------------------------------------------------------+ Updated IXLYAMDA heading and mapping information. KEYWORDS: PSIFB/K
APAR Information
APAR number
OA38312
Reported component name
CROSS SYS.EXT.S
Reported component ID
5752SCIXL
Reported release
770
Status
CLOSED UR1
PE
YesPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / SYSPLXDS /
Xsystem
Submitted date
2011-12-12
Closed date
2012-08-28
Last modified date
2013-12-19
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA66468 UA66469 402PC0Ÿ UA66470 402PC0Ÿ 402PC0Ÿ UA66471 402PC0Ÿ
402PC0Ÿ 402PC0Ÿ
Modules/Macros
IXLA1MG IXLC3ASC IXLC3CRF IXLC3CSC IXLC3DSC IXLC3INC IXLC3VSC IXLE1MEV IXLE1SCH IXLF1FAT IXLF1STC IXLF1TF6 IXLF1VSL IXLIXLEN IXLIXLJP IXLI1SIN IXLM1MST IXLM1MS2 IXLM1TBL IXLM2XRQ IXLR3DCH IXLR3DFS IXLR3DSF IXLYAMDA IXLYCON IXLYCSCS IXLYDSCC
| SA227637XX | SA227640XX | SA227618XX | GA320856XX |
Fix information
Fixed component name
CROSS SYS.EXT.S
Fixed component ID
5752SCIXL
Applicable component levels
R77J PSY UA66470
UP12/09/12 P F209
R770 PSY UA66468
UP12/09/12 P F209
R78J PSY UA66471
UP12/09/12 P F209
R780 PSY UA66469
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":"770","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":"770","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
19 December 2013