A fix is available
APAR status
Closed as new function.
Error description
Provide additional coupling facility structure accounting and measurement usage statistics for list and cache structure read and write requests.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: Installations exploiting parallel sysplex * * at z/OS V2R2 (HBB77A0) * **************************************************************** * PROBLEM DESCRIPTION: Full function small programming * * enhancement (SPE) for z/OS V2R2 * * (HBB77A0) installations that use * * coupling facility structures in a * * parallel sysplex environment. * * * * Provide additional coupling facility * * structure accounting and measurement * * usage statistics for list and cache * * structure read and write requests. * * * * SYSPLEXDS * **************************************************************** * RECOMMENDATION: Install the PTF on each system in * * the sysplex via rolling IPL. * **************************************************************** Enhancements to the XES accounting and measurement service and output are needed to provide additional information related to the amount of coupling facility structure data written to and read from list and cache structures. Applications want to perform cost and predictive analysis using the amount of data transferred to and from coupling facility structures.
Problem conclusion
Temporary fix
Comments
This APAR enhances the XES IXLMG accounting and measurement service and output (mapped by the IXLYAMDA macro) to provide additional information related to coupling facility structure data written to and read from list and cache structures. Documentation updates for this APAR are located in a pdf file, OA51879.pdf, available at: http://publibz.boulder.ibm.com/zoslib/pdf/OA51879.pdf Summary of Publication Updates: +--- PUBLICATION AFFECTED -------------------------------------+ | | | z/OS MVS Programming: Sysplex Services Reference - SA38-0658 | | | +--------------------------------------------------------------+ Chapter IXLMG - Coupling facility measurement Description . . . - IXLYAMDCF and IXLYAMDCF1 map coupling facility information | - IXLYAMDSTRL, IXLYAMDSTRL1, IXLYAMDSTRL2, and IXLAMDSTRL3 map | coupling facility list structure information | IXLYAMDSTRC, IXLYAMDSTRC1, IXLAMDSTRC2, and IXLAMDSTRC3 map | coupling facility cache structure information . . . Parameter description . . . ,AMDALEVEL=0 ,AMDALEVEL=amdalevel . . . Use IXCQUERY REQINFO=FEATURES to get the QuReqFeatures string. | The QuReqRfWriteReadMetrics bit in the QuReqFeatures | string can be used to test for support of AMDALEVEL=3 on the | system. Use IXCQUERY REQINFO=FEATURES to get the QuReqFeatures string +--- PUBLICATION AFFECTED -------------------------------------+ | | | z/OS MVS Data Areas Volume 3 (ITK - SCE) - GA32-0937 | | | +--------------------------------------------------------------+ IXLYAMDA Data Area Updates: --------------------------- Common Name: Accounting and Measurement Data Area Macro ID: IXLYAMDA New DSECT Names: IXLYAMDSTRL3 IXLYAMDSTRC2 IXLYAMDSTRC3 Size: Variable . . . IXLYAMDSTRL3 -- X'0220' bytes IXLYAMDSTRC2 -- X'0174' bytes IXLYAMDSTRC3 -- X'01D0' bytes . . . IXLYAMDSTRL3 DSECT (new) - IXLYAMDSTRL3_WRITEDATAREQUESTS - IXLYAMDSTRL3_WRITEADJUNCTCOUNT - IXLYAMDSTRL3_READDATAREQUESTS - IXLYAMDSTRL3_READADJUNCTCOUNT - IXLYAMDSTRL3_WRITEENTRYCOUNT - IXLYAMDSTRL3_READENTRYCOUNT - IXLYAMDSTRL3_WRITEENTRYDATA - IXLYAMDSTRL3_WRITEENTRYDATASQR - IXLYAMDSTRL3_READENTRYDATA - IXLYAMDSTRL3_READENTRYDATASQR IXLYAMDSTRC2 DSECT (new) same as IXLYAMDSTRC1 IXLYAMDSTRC3 DSECT (new) - IXLYAMDSTRC3_WRITEDATAREQUESTS - IXLYAMDSTRC3_WRITEADJUNCTCOUNT - IXLYAMDSTRC3_READDATAREQUESTS - IXLYAMDSTRC3_READADJUNCTCOUNT - IXLYAMDSTRC3_WRITEENTRYCOUNT - IXLYAMDSTRC3_READENTRYCOUNT - IXLYAMDSTRC3_WRITEENTRYDATA - IXLYAMDSTRC3_WRITEENTRYDATASQR - IXLYAMDSTRC3_READENTRYDATA - IXLYAMDSTRC3_READENTRYDATASQR For more information, see the IXLYAMDA mapping macro. IXCYQUAA Heading Information ---------------------------- Common Name: Query Answer Area Macro ID: IXCYQUAA . . . Structure QUREQFEATURES . . . - QUREQFEATURES1D . . . ..1. .... QUREQRFASYNCDUPLEX "X 20" Support for system-managed asynchronous duplexing. Includes IXLADUPX, IXLLOCK ADUPREQSEQNUM, IXLLOCK REQVERSION, and IXLMG AMDALEVEL=2. | .... 1... QUREQRFWRITEREADMETRICS "X 08" | List and cache structure write/read | measurement metrics and IXLMG | AMDALEVEL=3 supported on this system +--- PUBLICATION AFFECTED -------------------------------------+ | | | z/OS MVS Programming: Sysplex Services Guide - SA23-1400 | | | +--------------------------------------------------------------+ Under topic "Using the IXCQUERY Macro": Information returned inline to IXCQUERY . . . The information that IXCQUERY returns when you specify REQINFO=FEATURES is placed in a storage area that you specify with the FEATAREA parameter. The information is mapped by QUREQFEATURES in IXCYQUAA and includes the following: . . . | QuReqRfWriteReadMetrics | List and cache structure write/read measurement metrics and | IXLMG AMDALEVEL=3 supported on this system. Under topic "Using IXLMG": Types of information available . . . IXLYAMDCFRF Coupling facility remote facility entry | IXLYAMDSTRL, IXLYAMDSTRL1, IXLYAMDSTRL2, and IXLAMDSTRL3 . . . | IXLYAMDSTRC, IXLYAMDSTRC1, IXLYAMDSTRC2, and IXLAMDSTRC3 Coupling Facility Information o If HWSTATISTICS=YES . . . - AMDSLL and AMDSLL1 (list structure limits) and AMDSLC and AMDSLC1 (cache structure limits) are returned. | - AMDSTRL and AMDSTRL1 - n (list structure entry) and AMDSTRC | and AMDSTRC1 - n (cache structure entry) are returned for | all structures in the coupling facility regardless of | whether there's an active XES connection to that structure | on this system. AMDSTRL, AMDSTRL1 - n, AMDSTRC, and | AMDSTRC1 - n include configuration data, measurement data, | and control information for all structures. | - Structure usage information in AMDSTRL, AMDSTRL1 - n, | AMDSTRC, and AMDSTRC1 - n is available only for structures | that have an active XES connection to that structure on | this system. . . . o If HWSTATISTICS=NO . . . - AMDSLL and AMDSLL1 (list structure limits) and AMDSLC and AMDSLC1 (cache structure limits) are returned. | - AMDSTRL and AMDSTRL1 - n (list structure entry) and AMDSTRC | and AMDSTRC1 - n (cache structure entry) are returned only | for structures that have an active XES connection to that | structure on this system. AMDSTRL, AMDSTRL1 - n, AMDSTRC, | and AMDSTRC1 - n include configuration data and measurement | data. | - AMDSTRL, AMDSTRL1 - n, AMDSTRC, and AMDSTRC1 - n do not | contain structure control information. . . . o If HWSTATISTICS=CF . . . - AMDSLL and AMDSLL1 (list structure limits) and AMDSLC and AMDSLC1 (cache structure limits) are returned. | - AMDSTRL and AMDSTRL1 - n (list structure entry) and AMDSTRC | and AMDSTRC1 - n (cache structure entry) are returned only | for structures that have an active XES connection to that | structure on this system. AMDSTRL, AMDSTRL1 - n, AMDSTRC, | and AMDSTRC1 - n include configuration data and measurement | data. | - AMDSTRL, AMDSTRL1 - n, AMDSTRC, and AMDSTRC1 - n do not | contain structure control information. . . . Coupling Facility Structure Information You can request information about a single named structure (STRNAME) that is allocated in a coupling facility attached to the system on which the IXLMG macro is issued. The data returned includes: . . . - AMDSLL (AMDSLL1) and AMDSLC (AMDSLC1) | - AMDSTRL (AMDSTRL1 - n) or AMDSTRC (AMDSTRC1 - n), | depending on whether the structure is a list or cache | structure. AMDSTRL (AMDSTRL1 - n) or AMDSTRC (AMDSTRC1 - n) | includes structure control information. | - AMDSTRL (AMDSTRL1 - n) or AMDSTRC (AMDSTRC1 - n) contain | structure usage information only for structures that have an | active XES connection to that structure on this system. . . .
APAR Information
APAR number
OA51879
Reported component name
CROSS SYS.EXT.S
Reported component ID
5752SCIXL
Reported release
7A0
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / SYSPLXDS /
Xsystem
Submitted date
2017-01-09
Closed date
2017-06-06
Last modified date
2017-07-05
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA92085
Modules/Macros
IXCI2PH1 IXCYQUAA IXLA1MG IXLA1SLM IXLMG IXLM1TBL IXLR1CAC IXLR1LST IXLYAMDA
GA320937XX | SA231400XX | SA380658XX |
Fix information
Fixed component name
CROSS SYS.EXT.S
Fixed component ID
5752SCIXL
Applicable component levels
R7A0 PSY UA92085
UP17/06/21 P F706
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:
05 July 2017