A fix is available
APAR status
Closed as new function.
Error description
New Function **ADITIONAL INFORMATION** Note: This fix should be applied alongside corresponding JES2 new function APAR OA65571. If not, certain fields in SMF30 record such as SMF30COR may not be filled. Please apply this fix alongside JES2 APAR OA65571 to ensure that SMF30 data is fully captured.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: * * All HBB77D0 environments. * **************************************************************** * PROBLEM DESCRIPTION: * * New function in support of JES2 APAR OA65571. * **************************************************************** * RECOMMENDATION: * **************************************************************** This APAR provides the following changes in support of OA65571: - Enhancements to the IEFJMR macro which describes the Job Management Record (JMR). - Enhancements to the SMF 30 identification section. These changes are described in the documentation provided with this APAR. The function provided in this APAR may not be fully functional until APAR OA65571 is applied and fully active. See that APAR for additional information. Additional Search Keywords: SMFREC/K SMFTYPE30
Problem conclusion
Temporary fix
Comments
This APAR provides the following changes in support of OA65571: - Enhancements to the IEFJMR macro which describes the Job Management Record (JMR). - Enhancements to the SMF 30 identification section. These changes are described in the documentation provided with this APAR. The function provided in this APAR may not be fully functional until APAR OA65571 is applied and fully active. See that APAR for additional information. DOCUMENTATION HOLD FOR APAR OA66003 ORDER NO- SA38-0667 Book Title- z/OS MVS System Management Facilities (SMF) +--- LOCATION IN PUBLICATION ---------------------------+ | | | SMF records | | Record type 30 (X'1E') - Common address space work | | Record mapping | | Identification section | | | +-------------------------------------------------------+ The following new fields and version information are added to the SMF 30 identification section. Changes are indicated by |: Offsets Name Length Format Description 186 BA SMF30COR 64 EBCDIC JES job correlator. | 250 FA SMF30ID_End_V1 0 * End of version 1. | 250 FA SMF30JCLID1 4 binary JES-computed binary | identifier for the job that was | submitted (using method 1), if provided | by the primary subsystem. | 254 FE SMF30JCLID2 4 binary JES-computed binary | identifier for the job that was | submitted (using method 2) , if provided | by the primary subsystem. | 258 102 SMF30JCLTOKEN 8 binary Identifier for the | job, if provided by the primary | subsystem. | 266 10A SMF30HOLDUNTIL 6 binary A UTC timestamp | represented by the first 6 bytes (bits | 0-47) of an ETOD value. This is the | resolved HOLDUNTL value for the job | (from JCL or JES2 symbol on the internal | reader interface), if provided by the | primary subsystem. | 272 110 SMF30DEADLINE 6 binary A UTC timestamp | represented by the first 6 bytes (bits | 0-47) of an ETOD value. This is the | resolved DEADLINE value for the job | (from JES2 symbol on the internal reader | interface), if provided by the primary | subsystem | 278 116 SMF30ID_End_V2 0 * End of version 2 | | Version information: | When processing a type 30 record identification section, | the value in SMF30ILN can be used to determine the | version of the section. Equates are provided for the | lengths of each version: | | Version 1 | This version contains the fields through SMF30COR. | SMF30ILN contains the value SMF30ID_Len_V1 (X'FA'). | Version 2 | This version contains the fields through | SMF30DEADLINE. SMF30ILN contains the value | SMF30ID_Len_V2 (X'116'). ORDER NO- GA32-0937 Book Title- z/OS MVS Data Areas Volume 3 (ITK-RQE) +--- LOCATION IN PUBLICATION ---------------------------+ | | | JMR information | | JMR heading information | | | +-------------------------------------------------------+ The following updates are made to the JMR. Changes are indicated by |: Common name: Job Management Record Macro ID: IEFJMR DSECT name: JMR Owning component: Interpreter - CI (SC1B9) Eye-catcher ID: None Storage attributes: Virtual Storage: Obtained via GETMAIN Subpool: 255, 236 or 237 Key: 1 Residency: Below | Size: 176 bytes (decimal) for V2 JMR Frequency: 1 per job Created by: IEFSMFIE or IEFTB721 Pointed to by: TCTJMR field of the TCT (IEFTCT) data area Serialization: None Function: Contains job information accummulated by IBM-supplied data collection routines. It is also an information source for JES and the user exit routines. +--- LOCATION IN PUBLICATION ---------------------------+ | | | JMR information | | JMR mapping | | | +-------------------------------------------------------+ The following updates are made to the JMRE structure. Changes are indicated by |: Structure JMRE Offset Offset Type Len Name(Dim) Description Dec Hex ... 72 (48) SIGNED 4 JMRENDV1(0) End of Version 1 JMRE - See JMRVERSN | 72 (48) X'48' 0 JMRELEN1 "*-JMRE" Length of | V1 JMR extension | 72 (48) BITSTRING 4 JMRJCLID1 JES-computed | binary identifier for the | job that was submitted | (using method 1), if | provided by the primary | job subsystem | 76 (4C) BITSTRING 4 JMRJCLID2 JES-computed | binary identifier for the | job that was submitted | (using method 2), if | provided by the primary | job subsystem | 80 (50) BITSTRING 8 JMRJOBTOKEN 8-byte binary | identifier for the job, if | provided by the primary | job subsystem | 88 (58) BITSTRING 6 JMRHOLDUNTIL A UTC timestamp | represented by the first 6 | bytes (bits 0-47) of an | ETOD value. This is the | resolved HOLDUNTL value for | the job (from JCL or JES2 | symbol on the internal | reader interface), if | provided by the primary | job subsystem | 94 (5E) BITSTRING 6 JMRDEADLINE A UTC timestamp | represented by the first 6 | bytes (bits 0-47) of an | ETOD value. This is the | resolved DEADLINE value for | the job (from JES2 symbol on | the internal reader | interface), if provided by | the primary job subsystem. | 100 (64) SIGNED 4 JMRENDV2(0) End of Version 2 | JMRE - See JMRVERSN | 100 (64) X'64' 0 JMRELEN2 "*-JMRE" Length of | V2 JMR extension | 100 (64) SIGNED 4 JMREENDG(0) End of JMR | Extension | 100 (64) X'64' 0 JMRELENG "*-JMRE" Length of | JMR extension ORDER NO- SA23-1381 Book Title- z/OS MVS Installation Exits +--- LOCATION IN PUBLICATION ---------------------------+ | | | The Exits | | IEFACTRT - SMF Job and Job Step Termination Exits | | Entry Specifications | | Common Exit Parameter Area | | | +-------------------------------------------------------+ The following updates are made to the documentation of the IEFACTRT exit. Changes are indicated by |: The common exit parameter area is a 56-byte area that contains information an SMF installation exit routine might need. It is a copy of the first 56 bytes of the job management record (JMR), of which the first 36 bytes are usable by the exit. In addition, byte 55 is a version indicator, which indicates whether additional information | is available. When the version indicator is non-zero, an | additional area is provided at offset 76, mapped by the | JMRE DSECT within the JMR. The following versions are | currently supported: | | Version 0 | This version contains the fields through the JMR | version (56 bytes). The version indicator byte | contains the value JMRVER0 (X'00'). | Version 1 | This version contains the fields through the job | correlator (148 bytes). The version indicator byte | contains the value JMRVER1 (X'01'). | Version 2 | This version contains the fields through the resolved | DEADLINE value timestamp (176 bytes). The version | indicator byte contains the value JMRVER2 (X'02'). The address of the common exit parameter area is passed to all SMF installation exits except IEFU29, IEFU83, IEFU84, and IEFU85. The common exit parameter area is mapped by macro IEFJMR, as part of the JMR, except for the indicator of the SMF option selected by the user field. This field is mapped by the SMCAOPT field in the SMCA data area. See Table 1 for a description of the area, and Accounting Information for a description of the accounting information. See z/OS MVS Data Areas in the z/OS Internet library for the complete mapping of the JMR and the complete mapping of the SMCA. Table 1. Common Exit Parameter Area +-------------------------------------------------------+ Displacement Field Data Description from pointer size format ... 84 64 EBCDIC Job correlator, if provided by primary job subsystem | 148 4 binary JES-computed binary | identifier for the job that was | submitted (using method 1), if | provided by the primary job subsystem. | 152 4 binary JES-computed binary | identifier for the job that was | submitted (using method 2), if | provided by the primary job subsystem. | 156 8 binary 8-byte binary identifier for | the job, if provided by the primary | job subsystem. | 164 6 binary A UTC timestamp represented | by the first 6 bytes (bits 0-47) of an | ETOD value. This is the resolved | HOLDUNTL value for the job (from JCL | or JES2 symbol on the internal reader | interface), if provided by the primary | job subsystem. | 170 6 binary A UTC timestamp represented | by the first 6 bytes (bits 0-47) of an | ETOD value. This is the resolved | DEADLINE value for the job (from | JES2 symbol on the internal reader | interface), if provided by the primary | job subsystem.
APAR Information
APAR number
OA66003
Reported component name
INITIATOR/TERM
Reported component ID
5752SC1B6
Reported release
7D0
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2024-01-11
Closed date
2024-08-26
Last modified date
2025-05-16
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UJ95860
Modules/Macros
IFASMFR3 IEEMB836 IEFIB600 IEFJCNTL IEFTB721 IEFCIPS IEFTB728 IEFCNINT IEFSMFIE IEESB801 IEFSMF30 IEFTB726 IFAEASI IEFJMR IEFCIPSI IEFNB903
| SA380667xx | GA320937xx | SA231381xx |
Fix information
Fixed component name
INITIATOR/TERM
Fixed component ID
5752SC1B6
Applicable component levels
R7D0 PSY UJ95860
UP24/09/11 P F409
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":"7D0"}]
Document Information
Modified date:
16 May 2025