A fix is available
APAR status
Closed as new function.
Error description
New function: z/OS Contents Supervisor support for z17 workload instrumentation
Local fix
Please apply DFSMS OA68125 PTFs when available. See OA68192 for details. Also, see OA68303 for another issue with OA66032.
Problem summary
**************************************************************** * USERS AFFECTED: * * Users of HBB77D0 and above * **************************************************************** * PROBLEM DESCRIPTION: * * z/OS Contents Supervisor support for * * z17 workload instrumentation * **************************************************************** * RECOMMENDATION: * **************************************************************** z/OS Contents Supervisor support for z17 workload instrumentation PRICINGINFR/K E9175/K SMFREC/K SMFTYPE1156
Problem conclusion
Temporary fix
Comments
z/OS Contents Supervisor support for z17 workload instrumentation Documentation Info: z/OS MVS System Management Facilities (SMF) (SA38-0667) SMF records # editor note: new record type 1156 Record type 1156 (X'484') - Module Fetch The type 1156 record provides information about module fetch processing. SMF type 1156 subtype 1 is produced whenever a module is loaded with an associated workload class. The type 1156 subtype specific records are mapped using the following mapping macros: - IFASMFH, which maps the SMF standard and extended header area of the record. - CSVS1156, which maps the data provided for SMF record type 1156. Both IFASMFH and CSVS1156 reside in SYS1.MACLIB Subtype-specific triplet information: The subtype specific area can be located in each SMF 1156 subtype record by using the following triplet fields. These fields are defined in the CSVS1156 mapping macro. Offset - SMF1156T1_DOffset Length - SMF1156T1_DLength Number - SMF1156T1_DNum Subtype 1 Information pertaining to a module load with an associated workload class. Record environment - The following conditions exist for the generation of this record: Macro - SMFEWTM, BRANCH=YES (record exit: IEFU86) Storage Residency - 31-bit. Record mapping Header/self-defining section This section contains the common SMF Extended SMF record header version 1 fields and the triplet fields (offset/length/number), if applicable, that locate the other sections on the record. Offset (Dec) | (Hex) | Name | Size | Format | Description 0 | 0 | SMF1156T1 | 72 | Binary | SMF record (type 1156 subtype 1) data 0 | 0 | * | 56 | Binary | Mapped by SMFHDR1 DSECT in IFASMFH. We set fields SMFHDR1_Len, SMFHDR1_STV=1 SMFHDR1_Ext=1, SMFHDR1_Rty=126, SMFHDR1_STP = 1, SMFHDR1_Ext_Rty = 1156, SMFHDR1_Version = 1, SMFHDR1_Ext_Len = 32 54 | 36 | SMF1156T1_NumTriplets | 2 | Binary | Number of triplets that follow, initially 1. 58 | 3A | * | 6 | Binary | Reserved 64 | 40 | SMF1156T1_Triplet0 | 8 | Binary | Data triplet 64 | 40 | SMF1156T1_DOffset | 4 | Binary | Offset from start of SMF1156T1 to SMF1156T1D section, mapped by SMF1156T1D. 68 | 44 | SMF1156T1_DLength | 2 | Binary | Length of data section 70 | 46 | SMF1156T1_DNum | 2 | Binary | Number of data sections. Will always be 1. 72 | 48 | * | 0 | | Data Section for subtype 1 Information pertaining to a module load with an associated workload class. Located by adding to the address of the SMF record the value in SMF1156T1_DOffset. Offset (Dec) | (Hex) | Name | Size | Format | Description 0 | 0 | SMF1156T1D | 48 | Binary | Data section 0 | 0 | SMF1156T1D_Version | 1 | Binary | Version of data section 1 | 1 | SMF1156T1D_Flags | 1 | Binary | Flag byte. Bit Meaning when set 0-1 | result - exactly one of these two bits will be on 0 Success - module fetch was successful 1 NotSuccess - module fetch was not successful, there was a mismatch related to workload classification. For example the UUID is not valid 2-3 | by - exactly one of these two bits will be on 2 ByVolDSN - This was a fetch from a data set, so the SMF1156T1DMVD section is present 3 ByPath - This was a fetch by path from the file system, so the SMF1156T1DP section is 4 Pathname_Truncated - Applies only when ByPath, this indicates that the path name was longer than the maximum indicated by equate SMF1156T1DP_PathName_MaxLen. The last MaxLen characters are placed in the SMF record. 2 | 2 | * | 1 | | Reserved 3 | 3 | SMF1156T1D_WC | 1 | Binary | Workload class 4 | 4 | SMF1156T1D_MVD_or_P_Offset | 2 | Binary | Offset from start of record to the SMF1156T1DMVD or SMF1156T1DP section, whichever applies 6 | 6 | SMF1156T1D_NotSuccess_Reason | 2 | Binary | IBM-only - reason, when NotSuccess is on. 8 | 8 | SMF1156T1D_JobnameS | 8 | EBCDIC | Jobname for the START/MOUNT/LOGON that is associated with this address space. If the first byte is x'00', then none is associated. Source: ASSBJBNS 16 | 10 | SMF1156T1D_JobnameI | 8 | EBCDIC | Jobname for the initiated program that is associated with this address space. If the first byte is x'00', then none is associated. Source: ASSBJBNI 24 | 18 | SMF1156T1D_JobID | 8 | EBCDIC | The Job ID if available, otherwise hex zeros 32 | 20 | SMF1156T1D_UUID | 16 | Binary | When not all 0's, the UUID associated with the module. When all 0's, the UUID is not available 48 | 30 | SMF1156T1D_Base_End | 0 | | End of base The Mod/Vol/DSN section is present when SMF1156T1D_ByVolDSN is on and is located by adding SMF1156T1D_MVD_or_P_Offset to the address of the start of the SMF record: Offset (Dec) | (Hex) | Name | Size | Format | Description 0 | 0 | SMF1156T1DMVD | 58 | Binary | Mod/Vol/DSN section 0 | 0 | SMF1156T1DMVD_Modname | 8 | EBCDIC | The module name 8 | 8 | SMF1156T1DMVD_VolDsn | 50 | EBCDIC | Volume and DS name 8 | 8 | SMF1156T1DMVD_Vol | 6 | EBCDIC | When the first character is not x'00', the volume from which the module was fetched, padded on the right with with EBCDIC blanks if the volume name is shorter than 6 characters 14 | A | SMF1156T1DMVD_Dsname | 44 | EBCDIC | When the first character is not x'00', the data set from which the module was fetched, padded on the right with EBCDIC blanks if the data set name is shorter than 44 characters 58 | 3A | * | 0 | - | End of SMF1156T1DMVD The Path section is present when SMF1156T1D_ByPath is on and is located by adding SMF1156T1D_MVD_or_P_Offset to the address of the start of the SMF record: Offset (Dec) | (Hex) | Name | Size | Format | Description 0 | 0 | SMF1156T1DP | * | Binary | Path section 0 | 0 | SMF1156T1DP_Header | 16 | Binary | Path header 0 | 0 | SMF1156T1DP_PathToken | 12 | Binary | A path uniqueness token provided by USS 12 | C | SMF1156T1DP_LenPath | 2 | Binary | The length of of the path name in the next field (PathName). Only the number of characters indicated by this length field are set in the PathName field. 14 | E | SMF1156T1DP_TotalLenPath | 2 | Binary | When the "truncated" bit is off, this matches LenPath. Otherwise, it is the length known to the system (but it still remains the case that no more than 64 characters are provided within the SMF record) 16 | 10 | SMF1156T1DP_PathName | * | EBCDIC | The path name (which could be a relative path name) provided as input to identify the file. If that path name's length <= 64, the whole path name is in the SMF record. If that path name's length > 64, the last 64 characters are used and bit SMF1156T1D_Pathname_Truncated is set 58 | 3A | * | 0 | - | End of SMF1156T1DP Constants: SMF1156T1DP_PathName_MaxLen - 64 z/OS MVS Data Areas Volume 1 (ABE - IAR) (GA32-0935) CVT info: CVT_CsvVolDSN is a new bit x'02' in byte CVTOSLV8 indicating the availability of these: "Support for OutVolDSN and OutWC in CSVQUERY is available." CSVFETCH exit information: the FTCHX (CSVFTCHX) is expanded Offset Dec Offset Hex Type Len Name(Dim) Description 317 (13D) CHARACTER 1 FTCHX_WC When not 0, the workload classification. Applies only to Fetch and Fork events. 318 (13E) CHARACTER 2 Reserved, value is unpredictable 320 (140) CHARACTER 8 FTCHX_FETCHDURATION Wall-clock time, in STCK format, of the duration of the fetch. Approximately, this can be thought of as from the time that it was determined that the fetch was needed to the time that the fetch processing completed. Valid only for the ServiceIDs for Fetch_GetStore, Fetch_DirLoad, Unix_GetStore, Unix_DirLoad. Not defined for other ServiceIDs. Do not look at this field unless z/OS 3.1 functions are known to be present (bit CVTZOS_V3R1 would be 1). 328 (148) Character 50 FTCHX_VolDSN Volume and data set name when module was fetched. Applies to non-Unix Fetch events, non-Unix Unfetch events, the Fork event 328 (148) Character 6 FTCHX_Vol Volume name. If first char is x'00', volume name is not available. 334 (14E) Character 44 FTCHX_DSN Data set name. If first char is x'00', data set name is not available. CSVMODI information Added fields and bits to the MODI_HEADER structure: Offset Dec Offset Hex Type Len Name(Dim) Description 0 (0) STRUCTURE 0 MODI_HEADER 64 (40) BITSTRING 4 MODI_FLAGS Flags 64 (40) BITSTRING 1 MODI_FLAGS_BYTE0 .... ...1 MODI_Header_Len_Exists The MODI_Header_Len field is provided and can be used to determine whether fields after it in the MODI_Header DSECT are present 65 (41) BITSTRING 1 MODI_FLAGS_BYTE1 1... .... MODI_NO_MODI_6 "X'80'" The MODI_6 data could not be accessed from the dump 66 (42) BITSTRING 2 Reserved 68 (44) ADDRESS 4 MODI64_1_PTR Address of the 1st 64-bit section 72 (48) SIGNED 4 MODI64_1_LEN Length of the 1st 64-bit section 76 (4C) SIGNED 1 MODI_Header_Len Length of MODI_Header. Valid if and only if MODI_Header_Len_Exists 77 (4D) BITSTRING 3 Reserved 80 (50) ADDRESS 4 MODI_6_PTR When not zero, address of the 6th section. Valid if and only if MODI_Header_Len_Exists 84 (54) Signed 4 MODI_6_LEN When not zero, length of the 6th section. Valid if and only if MODI_Header_Len_Exists Added field MODI_WC to the MODI_1 structure: Offset Dec Offset Hex Type Len Name(Dim) Description 26 (1A) CHARACTER 1 MODI_ATTR4 Fourth attribute field 27 (1B) UNSIGNED 1 MODI_WC Workload class 28 (1C) CHARACTER 8 MODI_XATTR1 Extended attributes Added MODI_6 structure: Offset Dec Offset Hex Type Len Name(Dim) Description 0 (0) STRUCTURE 0 MODI_6 0 (0) Character 50 MODI_VolDSN The volume and dataset name from which the module was fetched, when known. One case where the volume and dataset name are not known is use of the CSVDYLPA macro with the BYADDR=YES keyword. 0 (0) Character 6 MODI_Vol The volume when known. When the first character is x'00', the volume is not known 6 (6) Character 44 MODI_DSN The dataset name when known. When the first character is x'00', the dataset name is not known z/OS MVS Programming: Assembler Services Reference ABE-HSP (SA23-1369) Chapter 85. CSVQUERY Contents supervisor query service CSVQUERY information: new parameters OUTVOLDSN and OUTWC Syntax Description ,OUTVOLDSN=outvoldsn outvoldsn: RS-type address or register (2) - (12). ,OUTWC=outwc outwc: RS-type address or register (2) - (12). ,OUTVOLDSN=outvoldsn Specifies an optional 50 character area that CSVQUERY is to return is to contain the volume and dataset name from which he module was fetched, when known. The 50 character area has the volume in the first 6 characters and the dataset name in the last 44. The "validity bit" will be on whenever the parameter is successfully processed. One case where the volume and dataset name are not known is use of the CSVDYLPA macro with the BYADDR=YES keyword. When the first character of the volume is x'00', the volume is not known. When the first character of the dataset name is x'00', the dataset name is not known. ,OUTWC=outwc Specifies an optional 1-byte variable where CSVQUERY returns the workload classification of the module. A value of 0 indicates that there is no assigned workload classification. The "validity bit" will be on whenever the parameter is successfully processed. ×**** PE25/07/11 FIX IN ERROR. SEE APAR OA68192 FOR DESCRIPTION ×**** PE25/08/04 FIX IN ERROR. SEE APAR OA68303 FOR DESCRIPTION
APAR Information
APAR number
OA66032
Reported component name
CONTENTS SUPERV
Reported component ID
5752SC1CJ
Reported release
7E0
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2024-01-18
Closed date
2025-05-30
Last modified date
2025-08-08
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UJ97286
Modules/Macros
IEAVTSDG IEWLFSHR CSVFXT64 CSVFTCHX IEAVTSDL IEAVNPD5 IEWLSTGX IEWLUNFX CSVARMGR BPXPRFVE CSVCSVTM CSVS1156 CSVXCEFM IEAVNP05 CSVHFLDM CSVLLIN2 IEAVID00 IEAVNIP0 BLSSLLPA IEWLSRV0 IEAVECVT BLSRFMOD IHAASXB IEAVELCR IEWLRLCX CSVLPPR CSVLLTCH IEWLFINX IEWLFORK IHALPDE IEWLFTCX CVT CSVLLCPY CSVCHKPT IEWLIPCS IEWLRFMT CSVEXIT CSVINFOM BPX0FH IFACSMFR BPXPRFP BLSRWHRS CSVMODI IFASMFRD CSVLPAMP CSVMLPRM BPXPRFC IEAVEOR AIRMDLD CSVRFREE IEWLUNF0 IHACDE CSVLLREF IEAVNPC5 CSVFRR IEWLSFT0 CSVQSER CSVRSTRT IEAVCKRS CSVFORKM IEAVCVT CSVSBRTN CSVQUERY IEAVWSAT IHACDX IHAWSAVT CSVS2RTN CSVGETMD IEWLSTKM CSVLLSTA IEWPMAR CSVLPRET IEWLDFTX
| SA38066700 | SA23136900 | GA32093500 |
Fix information
Fixed component name
CONTENTS SUPERV
Fixed component ID
5752SC1CJ
Applicable component levels
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":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19O"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"7E0"}]
Document Information
Modified date:
08 August 2025