** Please read all of the HOLDDATA before acting on any of it. ** ************************************************************************

Transcription

1 HOLDDATA FOR IMS 8.1 PUT Level 0308 ** Please read all of the HOLDDATA before acting on any of it. ** **************************** Please pay close attention to the holddata for the following PTFs with action items. UQ79258 UQ79259 (UQ65933,UQ79259) UQ79604 (UQ70134) UQ79839 (UQ70134) UQ79961 ********** HOLDDATA ******** ++ HOLD(UQ79258) SYS FMID(HMK8800) REASON(ACTION) DATE(03219) APAR PQ76636 CHANGES THE *SIZE* OF AN IMS CONTROL BLOCK. Control Block name: CFB Macro changed: DFSCFB Old size: x'114' New size: x'128' ANY USER MODIFICATIONS OR NONIBM VENDOR SOFTWARE WHICH REFERENCES THIS BLOCK MUST BE CHANGED AND/OR REASSEMBLED TO INCLUDE THE NEW SIZE. ++ HOLD(UQ65933) SYS FMID(JMK8801) REASON(ACTION) DATE(03219) APAR PQ59157 CHANGES THE *CONTENTS* OF AN IMS CONTROL BLOCK. CONTROL BLOCK NAME: XPCB AT +X'06' (RELEASE INDICATOR) OLD CONTENTS: R1 NEW CONTENTS: R2 ANY USER MODIFICATIONS OR NONIBM VENDOR SOFTWARE WHICH REFERENCES THIS BLOCK MUST BE CHANGED AND/OR REASSEMBLED TO INCLUDE THE NEW CONTENTS. ++ HOLD(UQ79259) SYS FMID(JMK8801) REASON(ACTION) DATE(03219) APAR PQ76636 CHANGES THE *SIZE* OF AN IMS CONTROL BLOCK. Control Block name: CFB Macro changed: DFSCFB Old size: x'114' New size: x'128' ANY USER MODIFICATIONS OR NONIBM VENDOR SOFTWARE WHICH REFERENCES THIS BLOCK MUST BE CHANGED AND/OR REASSEMBLED TO INCLUDE THE NEW SIZE. ++ HOLD(UQ65933) SYS FMID(JMK8801) REASON(AO) DATE(03219)

2 + HOLD FOR APAR PQ THIS APAR CHANGES OR AFFECTS AN IMS MESSAGE. IMS Message number: DFS686W ANY USER EXITS OR NONIBM VENDOR SOFTWARE WHICH ARE SENSITIVE TO THIS MESSAGE MAY NEED TO BE CHANGED. SEE THE APAR CLOSING TEXT OR PTF COVER LETTER FOR COMPLETE DETAILS ++ HOLD(UQ65933) SYS FMID(JMK8801) REASON(DOC) DATE(03219) ( The following are the Documentation changes. 1. The IMS/ESA V8 Messages and Code manual (ZES12256), will be updated with the following message: DFS0548A RRS NOT ACTIVE BUT RRS=Y SPECIFIED REPLY: RETRY OR CONTINUE Explanation: IMS attempted to set exits with RRS since RRS=Y was specified. However, RRS is not active. System Action: The system waits for a response to the message. Operator Response: Reply RETRY after starting the RRS system. To proceed without RRS reply CONTINUE. Problem Determination: None 2. The IMS/ESA V8 Messages and Code manual will also be updated with the following: Message DFS686W is updated with following values for yyzz for DFSVCI00 failures: 52A IMODULE LOAD for DFSDCFC0 failed. 52B IMODULE LOAD for DFSRRSB0 failed. 3. The IMS/ESA V8 Installation Volume 2: System Definition and Tailoring manual (ZES12253) will be updated with the following: The batch procedures, DBBBATCH and DLIBATCH, are altered to accept the following execution parameter: RRS= Specifies whether IMS is to connect with RRS. Y Indicates that RRS is active and that IMS is to connect and establish exits for syncpoint processing. N Indicates that IMS is not to connect with RRS. This is the default. 4. The IMS/ESA V8 FAST manual (ZES12250) will be updated with the following: The module, DFSRRSB0, is added to the list of the issuers of ABENU0711. DFSRRSB0 Reason Code Description X'20' IMS was unable to load all the RRS callable stubs. X'23' IMS failed to register as a resource manager with RRS/MVS. Register 2 contains the return code from the CRGGRM service. X'24' IMS was unable to switch the private context to another batch TCB. Register 2 contains the return code from the CTXSWCH service. X'26'

3 IMS was unable to create a private context. Register 2 contains the return code from the CTXBEGC service. ). ++ HOLD(UQ65933) SYS FMID(JMK8801) REASON(ENH) DATE(03219) APAR PQ59157 ADDS NEW IMS FUNCTION. Function name: IMS Batch (DLIBATCH and / or DBBBATCH) support of RRS. See APAR closing text or PTF cover letter for complete details. ++ HOLD(UQ65933) SYS FMID(JMK8801) REASON(IOGEN) DATE(03219) (AFTER THIS MAINTENANCE IS ACCEPTED AN IMS "CTLBLKS" SYSGEN IS REQUIRED. THIS SERVICE WILL ALLOW THE USE OF IMS DLIBATCH OR DBBBATCH PROCLIB MEMBERS TO UTILIZE SYSTEM LEVEL RESOURCE RECOVERY SERVICES PROVIDED BY THE OS/390 PLATFORM. * THE PROCLIB MEMBERS WILL NOT BE REBUILT * UNLESS *PROCLIB=YES* IS SET IN SYSGEN * STAGE 1. =>The IMSPLEX parm has been *MOVED* to the =>25th positional parameter of the DLIBATCH =>and DBBBATCH procedures. =>If you intend to use *AUTOMATIC RECON =>LOSS NOTIFICATION* you *MUST* rebuild =>these using sysgen. ****IF you are *NOT* going to use the RRS or Automatic RECON Loss Notification capability, a sysgen is *NOT* required. This service will be picked up the next time a CTLBLKS or higher sysgen is completed.). ++ HOLD(UQ79301) SYS FMID(HMK8800) REASON(EXRF) DATE(03220) (********* + Hold for APAR PQ If you have IMS Connect in an XRF environment this maintenance must be applied to all systems in this environment at the same time. You have two options: 1. Shutdown both Active and Alternate systems, install the maintenance on both systems, and restart both systems. 2. Install the maintenance in a phased approach as follows: 1. Shutdown the Alternate system 2. Install the maintenance to the Alternate system 3. On the Active system: a. Be sure IMS Connect is active by doing a /DIS OTMA command. If it's not active, bring up IMS Connect. b. If IMS Connect is active, issue a /CHE SNAPQ command 4. Restart the Alternate system 5. Once the Alternate is in tracking phase, perform a takeover. 6. After the old Active system is down,

4 install the maintenance to the old Active system 7. Restart the new Alternate system *********). ++ HOLD(UQ79484) SYS FMID(HMK8800) REASON(DOC) DATE(03230) (DOCUMENTATION CHANGE FOR APAR PQ62186 IMS version 8 Messages and Codes, SC , DFS section, DFS4261I has been updated with the following information: "DLI/SAS Region not detected" has been replaced by "DLI/SAS Region undetected" because of texts' truncation.). ++ HOLD(UQ70134) SYS FMID(JMK8801) REASON(ACTION) DATE(03245) (++ + Hold for APAR PQ A more effective Shared Queues scheduling algorithm has been + + designed to reduce false schedules. Basically, PARLIM means + + something now in Shared Queues similar to what it means in + + nonshared Queues. A new field has been added to the SMB, + + SMBGUCNT, which represents the successful consecutive message+ + GU count. Instead of comparing the number of queued messages + + with the PARLIM threshold value (PARLIM multiplied by + + SMBRGNS), we now compare SMBGUCNT with the PARLIM threshold + + value to determine load balancing in a shared queues + + environment. So you can now tune your Shared Queues systems + + with PARLIM. Prior to this, PARLIM was only used to determine+ + if MAXRGN should be checked. In a Shared Queues environment,+ + we could only check MAXRGN (max region count) for load + + balancing because we did not know the actual message queue + + count due to messages being queued out on the coupling + + facility (the Shared Queue) instead of locally. So, you may + + need to tune your PARLIM values now for any transactions + + pertaining to shared queues. + ++). ++ HOLD(UQ70134) SYS FMID(JMK8801) REASON(DOC) DATE(03245) (DOCUMENTATION CHANGE FOR APAR PQ65904 ZES ZES Installation Volume 2: System Definition and Tailoring Chapter 3: Macros, in the section on the TRANSACT macro ZES First change: The syntax diagram for the PARLIM= parameter on the TRANSACT macro should have as the default. Second change: The PARLIM= description needs to be updated as indicated by the change bars as follows: PARLIM= Specifies the threshold value to be used when SCHDTYP=PARALLEL is specified in the preceding APPLCTN macro instruction. An additional region is scheduled whenever the current transaction enqueue count (for shared queues environments, the successful consecutive GU count is used instead of the enqueue count) exceeds the PARLIM value multiplied by the number of regions...

5 Also, the last paragraph under the PARLIM description that talks about Shared Queues needs to be DELETED Command Reference ZES The PARLIM description needs to be updated as indicated by the change bars as follows: First Change: Chapter 2: IMS Commands, under "/ASSIGN" PARLIM Specifies a new value for the parallel processing limit count of a transaction. parlim# is the maximum number of messages that can currently be queued, but not yet processed, by each active message region currently scheduled for this transaction. An additional region will be scheduled whenever the transaction queue count (for shared queues environments, the successful consecutive GU count is used instead of the queue count) exceeds the PARLIM value multiplied by the number of regions currently... Second Change: Chapter 1: Introduction, under "Keyword Table and Definitions" PARLIM Is used with the /ASSIGN command when message regions are parallel processing a transaction. PARLIM is the maximum number of messages that can be enqueued, but not yet processed, by each active message region currently scheduled for this transaction. An additional message region is scheduled whenever the transaction queue count (for shared queues environments, the successful consecutive GU count is used instead of the queue count) exceeds the PARLIM value multiplied by the number of regions currently scheduled for this transaction. Valid parameters are numeric values from 0...). ++ HOLD(UQ75761) SYS FMID(JMK8801) REASON(DOC) DATE(03245) (DOCUMENTATION CHANGE FOR APAR PQ69397 LY * FAILURE ANALYSIS STRUCTURE TABLES (FAST) * * SRL : LY * * CHAPTER 2 * * ABENDU0780 * ADD MODULE DFSDBDR0 TO THE LIST OF THE MODULES WHICH CAN ISSUE AN ABENDU0780. UNDER ANALYSIS CHANGE SENTENCE #1 TO INDICATE THE MODULE DFSDBDR0 CAN ISSUE THE ABEND. UNDER ANALYSIS, PARAGRAPH #1 ADD THE FOLLOWING SENTENCE. IF THE ABEND IS ISSUED FROM DFSDBDR0 REGISTER 15 CONTAINS THE RETURN CODE FROM MODULE DFSCLM00.). ++ HOLD(UQ78153) SYS FMID(JMK8801) REASON(DOC) DATE(03245) (DOCUMENTATION CHANGE FOR APAR PQ74080 GC

6 SC Documentation will be changed as follows: IMS Messages and Codes Manual volume 2, DFS0565I, Explanation add the following paragraph: The region identified in the DFS0565I can also be an MPP region. This can occur to break a potential deadlock condition between Online Change, a DBR or STA command against a database being used by the MPP, and an application running in the MPP issuing an ICMD or CMD call. IMS Command Reference Manual, /DBRECOVERY, DATABASE keyword description, paragraph 3, which describes conditions in which the DBR command is ignored or rejected. Add the following paragraph after paragraph 3: The region identified in the DFS0565I can also be an MPP region. This can occur to break a potential deadlock condition between Online Change, a DBR or STA command against a database being used by the MPP, and an application running in the MPP issuing an ICMD or CMD call.). ++ HOLD(UQ79805) SYS FMID(HMK8800) REASON(DOC) DATE(03241) (DOCUMENTATION CHANGE FOR APAR PQ77588 GC In the IMS Version 8 Messages & Codes Vol. 2 ( GC ), Add the following to the MSGDFS4130I:. under Reason Code Explanation add 08 Invalid LSN 12 Gap Detected). ++ HOLD(UQ70134) SYS FMID(JMK8801) REASON(ACTION) DATE(03245) (++ + Hold for APAR PQ A more effective Shared Queues scheduling algorithm has been + + designed to reduce false schedules. Basically, PARLIM means + + something now in Shared Queues similar to what it means in + + nonshared Queues. A new field has been added to the SMB, + + SMBGUCNT, which represents the successful consecutive message+ + GU count. Instead of comparing the number of queued messages + + with the PARLIM threshold value (PARLIM multiplied by + + SMBRGNS), we now compare SMBGUCNT with the PARLIM threshold + + value to determine load balancing in a shared queues + + environment. So you can now tune your Shared Queues systems + + with PARLIM. Prior to this, PARLIM was only used to determine+ + if MAXRGN should be checked. In a Shared Queues environment,+ + we could only check MAXRGN (max region count) for load + + balancing because we did not know the actual message queue + + count due to messages being queued out on the coupling + + facility (the Shared Queue) instead of locally. So, you may + + need to tune your PARLIM values now for any transactions + + pertaining to shared queues. + ++). ++ HOLD(UQ70134) SYS FMID(JMK8801) REASON(DOC) DATE(03245)

7 (DOCUMENTATION CHANGE FOR APAR PQ65904 ZES ZES Installation Volume 2: System Definition and Tailoring Chapter 3: Macros, in the section on the TRANSACT macro ZES First change: The syntax diagram for the PARLIM= parameter on the TRANSACT macro should have as the default. Second change: The PARLIM= description needs to be updated as indicated by the change bars as follows: PARLIM= Specifies the threshold value to be used when SCHDTYP=PARALLEL is specified in the preceding APPLCTN macro instruction. An additional region is scheduled whenever the current transaction enqueue count (for shared queues environments, the successful consecutive GU count is used instead of the enqueue count) exceeds the PARLIM value multiplied by the number of regions... Also, the last paragraph under the PARLIM description that talks about Shared Queues needs to be DELETED Command Reference ZES The PARLIM description needs to be updated as indicated by the change bars as follows: First Change: Chapter 2: IMS Commands, under "/ASSIGN" PARLIM Specifies a new value for the parallel processing limit count of a transaction. parlim# is the maximum number of messages that can currently be queued, but not yet processed, by each active message region currently scheduled for this transaction. An additional region will be scheduled whenever the transaction queue count (for shared queues environments, the successful consecutive GU count is used instead of the queue count) exceeds the PARLIM value multiplied by the number of regions currently... Second Change: Chapter 1: Introduction, under "Keyword Table and Definitions" PARLIM Is used with the /ASSIGN command when message regions are parallel processing a transaction. PARLIM is the maximum number of messages that can be enqueued, but not yet processed, by each active message region currently scheduled for this transaction. An additional message region is scheduled whenever the transaction queue count (for shared queues environments, the successful consecutive GU count is used instead of the queue count) exceeds the PARLIM value multiplied by the number of regions currently scheduled for this transaction. Valid parameters are numeric values from 0...). ++ HOLD(UQ75761) SYS FMID(JMK8801) REASON(DOC) DATE(03245) (DOCUMENTATION CHANGE FOR APAR PQ69397

8 LY * FAILURE ANALYSIS STRUCTURE TABLES (FAST) * * SRL : LY * * CHAPTER 2 * * ABENDU0780 * ADD MODULE DFSDBDR0 TO THE LIST OF THE MODULES WHICH CAN ISSUE AN ABENDU0780. UNDER ANALYSIS CHANGE SENTENCE #1 TO INDICATE THE MODULE DFSDBDR0 CAN ISSUE THE ABEND. UNDER ANALYSIS, PARAGRAPH #1 ADD THE FOLLOWING SENTENCE. IF THE ABEND IS ISSUED FROM DFSDBDR0 REGISTER 15 CONTAINS THE RETURN CODE FROM MODULE DFSCLM00.). ++ HOLD(UQ78153) SYS FMID(JMK8801) REASON(DOC) DATE(03245) (DOCUMENTATION CHANGE FOR APAR PQ74080 GC SC Documentation will be changed as follows: IMS Messages and Codes Manual volume 2, DFS0565I, Explanation add the following paragraph: The region identified in the DFS0565I can also be an MPP region. This can occur to break a potential deadlock condition between Online Change, a DBR or STA command against a database being used by the MPP, and an application running in the MPP issuing an ICMD or CMD call. IMS Command Reference Manual, /DBRECOVERY, DATABASE keyword description, paragraph 3, which describes conditions in which the DBR command is ignored or rejected. Add the following paragraph after paragraph 3: The region identified in the DFS0565I can also be an MPP region. This can occur to break a potential deadlock condition between Online Change, a DBR or STA command against a database being used by the MPP, and an application running in the MPP issuing an ICMD or CMD call.). ++ HOLD(UQ79956) SYS FMID(HMK8800) REASON(DOC) DATE(03248) (DOCUMENTATION CHANGE FOR APAR PQ71178 GC Documentation change: CQS message CQS0205E in IMS Version 8: Messages and Codes Volume 1 (GC ) is modified as: 1. Add the following paragraph into the explanation section: For a resource structure, this message is issued if a CQSUPD

9 request of a resource list entry failed because the resource structure is full. Only the first such failure within the resource update list causes this message to be displayed. There will be at most one CQS0205E message for a resource update list. 2. Add CQSUPD00 into the Module section.). ++ HOLD(UQ79957) SYS FMID(HMK8800) REASON(DOC) DATE(03248) (DOCUMENTATION CHANGE FOR APAR PQ76706 GC Documentation changes: ====================== Add a new CQS overflow error message, CQS0269E, to:. Messages and Codes Volume 1 (GC ) CQS0269E CQS cqsname FAILED OVERFLOW SCAN phase PROCESSING FOR STRUCTURE structurename RC=xxxxxxxx Explanation: the overflow scan processing failed for the structure. In the message text: cqsname Name of the CQS that was the master of the overflow scan processing. phase The phase of the overflow scan processing that failed, either START or END. structurename The name of the structure for which CQS attemped overflow scan processing. xxxxxxxx The reason code. Reason Code X' ' X' ' Explanation The CQS overflow scan process in this CQS could not obtain the structure quiesce latch. The overflow scan process for this CQS ends. The CQS overflow scan process in another CQS could not obtain the structure quiesce latch. This is a propagated error. The CQS overflow scan process for this CQS ends.). ++ HOLD(UQ79961) SYS FMID(HMK8800) REASON(AO) DATE(03248) + HOLD FOR APAR PQ THIS APAR CHANGES OR AFFECTS AN IMS MESSAGE. IMS MESSAGE NUMBER: DFS3483 ANY USER EXITS OR NONIBM VENDOR SOFTWARE WHICH ARE SENSITIVE TO THIS MESSAGE MAY NEED TO BE CHANGED. SEE THE APAR CLOSING TEXT OR PTF COVER LETTER FOR COMPLETE DETAILS ++ HOLD(UQ79961) SYS FMID(HMK8800) REASON(DOC) DATE(03248) (DOCUMENTATION CHANGE FOR APAR PQ73173 GC

10 GC MESSAGES AND CODES VOLUME 2 Remove the "I" from message DFS3483I and replace the message text with the following: DFS3483 ERROR DURING ENQUEUE DDNAME=dddddddd Explanation: An error was detected while attempting to enqueue DD name dddddddd before copying. System Action: The copy is not done, and the utility is terminated. System Programmer Response: Correct the DD statement).