A fix is available
APAR status
Closed as new function.
Error description
Adds the IMSCMDOPT control statement to change options of IMS commands that are issued by TOSI. Using the new control statement, Smart Reorg Driver can issue /DBD, /DBR, and /STA commands with GLOBAL option via TOSI.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IMS Database Reorganization * * Expert for z/OS Version 4 Release 1 * * (FMID=H25N410) * **************************************************************** * PROBLEM DESCRIPTION: Add the IMSCMDOPT control statement to * * change options of IMS commands that are * * issued by IMS Tools Online System * * Interface (IMS TOSI). This is a forward * * fit APAR of IPR V3R2 PM06846. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** Forward fit APAR of IPR V3R2 PM06846. A new control statement for reorganization manager, IMSCMDOPT is added. Using the new control statement, Smart Reorg Driver can issue /DBD, /DBR, and /STA commands with GLOBAL option via IMS TOSI. If IMSCMDOPT=ALL,GLOBAL is specified, Smart Reorg Driver issues /DBD, /DBR, and commands with GLOBAL option. If IMSCMDOPT=DBD,GLOBAL is specified, Smart Reorg Driver issues /DBD command with GLOBAL option. If IMSCMDOPT=STA,GLOBAL is specified, Smart Reorg Driver issues /STA command with GLOBAL option. One or more IMSCMDOPT control statements can be specified. However, when the first parameter is ALL, only one IMSCMDOPT control statement can be specified. GLOBAL option is valid when IRLM is active. If IMS commands are issued by IMS TOSI, all IMS subsystems that shares the database must be defined in the TOSI XCF group that is specified by TOSIXCFGRP control statement. If GLOBAL is specified, Smart Reorg Driver selects an IMS subsystem in the TOSI XCF group and issues the IMS command with GLOBAL option to it using TOSI. The IMS Command Processing report shows the command result on the IMS subsystem only. The results on the other IMS subsystems are not shown. If /DBD or /DBR commands have not been completed within 20 seconds on all the IMS subsystems, the HPSG0334I message indicating that any IMS subsystem is still using the database can be issued. This enhancement is being implemented for the FITS requirement MR0903095549.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== Changes made to the IBM IMS Database Reorganization Expert for z/OS User's Guide Version 4 Release 1 (SC19-1137-00). 1.0 Introduction to IMS Database Reorganization Expert 1.1 IMS Database Reorganization Expert overview 1.1.7 Functional changes 1.1.7.1 Changes in IMS Database Reorganization Expert Version 4 Release 1 The following description is added: The Smart Reorg utility Enabling GLOBAL option for IMS commands that are issued by TOSI The IPR Driver was enhanced by APAR PM14690 to support the IMSCMDOPT control statement. This control statement allows you to change the options of the IMS commands that are issued by IMS Tools Online System Interface (IMS TOSI). By using the new control statement, IPR Driver can issue /DBD, /DBR, and /STA commands with the GLOBAL option through IMS TOSI. 3.5 Smart Reorg JCL statements 3.5.2 Control statements for Smart Reorg 3.5.2.2 Control statements for the Smart Reorg Driver *A new control statement IMSCMDOPT is added in Table 11 as follows: ---------------------------------------------------------------- Keyword Acceptable values Default Description ---------------------------------------------------------------- IMSCMDOPT a,b None Specifies the option a=ALL, DBD, DBR, parameters for the IMS or STA commands that are issued b=LOCAL or GLOBAL by the IMS Tools Online System Interface. See "IMSCMDOPT control statement" in topic 3.5.2.2.nn. ---------------------------------------------------------------- 3.5 Smart Reorg JCL statements 3.5.2 Control statements for Smart Reorg 3.5.2.2 Control statements for the Smart Reorg Driver 3.5.2.2.17 IMSCMD control statement *The following notes are added to the description of IMSCMD=YES,TOSI. 3. You can change the option parameters for the IMS commands by using IMSCMDOPT control statements. For details, see "IMSCMDOPT control statement" in topic 3.5.2.2.nn. 4. If IMS commands are issued by IMS TOSI, all IMS subsystems that share the database must be defined in the TOSI XCF group that is specified by the TOSIXCFGRP control statement. 5. If the /DBD or the /DBR commands have not ended within 20 seconds on all the IMS subsystems, an HPSG0334I message that indicates that one or more IMS subsystems are still using the database is issued. 3.5 Smart Reorg JCL statements 3.5.2 Control statements for Smart Reorg 3.5.2.2 Control statements for the Smart Reorg Driver 3.5.2.2.33 STARTDB control statement *The following description is added. You can change the option parameters for /STA commands by using IMSCMDOPT control statements. For details, see "IMSCMDOPT control statement" in topic 3.5.2.2.nn. 3.5 Smart Reorg JCL statements 3.5.2 Control statements for Smart Reorg 3.5.2.2 Control statements for the Smart Reorg Driver *A new topic that describes IMSCMDOPT control statement is added. 3.5.2.nn IMSCMDOPT control statement The IMSCMDOPT control statement specifies the option parameters for the IMS commands that are issued by the IMS Tools Online System Interface. By using IMSCMDOPT control statements, you can specify the GLOBAL option for /DBD, /DBR, and /STA commands. This control statement is optional. If you do not specify this control statement, option parameters that are described in "IMSCMD control statement" in topic 3.5.2.2.17 and "STARTDB control statement" in topic 3.5.2.2.33 are used. _______________________________________________ | | | | | >>__IMSCMDOPT=__ __ALL__ __ __,LOCAL___ __>< | | |__DBD__| | | | | |__DBR__| |__,GLOBAL__| | | |__STA__| | | | |_______________________________________________| An IMSCMDOPT control statement must be specified with IMSCMD=YES,TOSI. The first parameter specifies the IMS commands to apply the option parameter change among the IMS commands that are issued during an Smart Reorg Driver job. ALL Applies to all IMS commands. DBD Applies to /DBD commands. DBR Applies to /DBR commands. STA Applies to /STA commands. The second parameter specifies the option parameter for the IMS commands that are specified by the first parameter. LOCAL LOCAL option is used. GLOBAL For /DBD, /DBR, and /STA commands, GLOBAL option is used. Notes: 1. One or more IMSCMDOPT control statements can be specified. However, when the first parameter is ALL, only one IMSCMDOPT control statement can be specified. 2. The GLOBAL option is effective when IRLM is active. 3. When the GLOBAL option is specified, Smart Reorg Driver selects an IMS subsystem in the TOSI XCF group and, by using TOSI, issues the IMS command with the GLOBAL option to the IMS subsystem. The IMS Command Processing report shows the result of the command only for that IMS subsystem. The results on the other IMS subsystems are not shown. 3.9 Smart Reorg reports 3.9.4 HPSOUT2 data set 3.9.4.14 IMS Command Processing report *The description of STATUS is changed as follows: (Revision bar shows the part of change) STATUS The status of each command. If the command is processed by the IMS system, the return code in the IMS DFS0488I message is shown. If an error is returned from IMS TOSI, the meaning or the error is shown. | REQUEST IS NOT ISSUED (GLOBAL OPTION) | This message indicates that this IMS online subsystem did | not receive the IMS command directly from IMS TOSI. The | IMS command was sent to this subsytem through another | subsystem which directly received the IMS command (with | the GLOBAL option) from IMS TOSI. For subsystems that did | not receive IMS commands directly from IMS TOSI, the | status messages and return codes are not shown in this | field. 8.2 Messages and codes 8.2.3 Messages 8.2.3.3 HPSG messages 8.2.3.3.49 HPSG0212E *The following text is added in the Explanation section. - ONE OF ALL, DBD, DBR, OR STA - EITHER LOCAL OR GLOBAL 8.2 Messages and codes 8.2.3 Messages 8.2.3.3 HPSG messages *The following new message is added in the HPSG messages. HPSG0246E IMSCMDOPT STATEMENT CAN ONLY BE SPECIFIED ONCE WHEN FIRST PARM IS ALL Explanation: Two or more IMSCMDOPT control statements are specified. However, when the first parameter of an IMSCMDOPT control statement specifies ALL, only one IMSCMDOPT control statement can be specified in the JCL stream. System Action: The Smart Reorg Driver ends with a return code of 8. Programmer Response: Remove the IMSCMDOPT control statement that specifies ALL for its first parameter, or remove other IMSCMDOPT control statements, and rerun the job.
APAR Information
APAR number
PM14690
Reported component name
IMS DB REORG EX
Reported component ID
5655F7400
Reported release
410
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2010-05-17
Closed date
2010-06-04
Last modified date
2010-07-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK57645
Modules/Macros
HPSGCM00 HPSGCM20 HPSGCSC1 HPSGGDIB HPSGGIOB HPSGGIO0 HPSGGRGB HPSGGRG0 HPSGGRMB HPSGGRM0 HPSGGSTT HPSGMSGT HPSGRD10 HPSGRP10 HPSGRP40 HPSGRS00 HPSGRT00 HPSGSTMT
| SC19113700 |
Fix information
Fixed component name
IMS DB REORG EX
Fixed component ID
5655F7400
Applicable component levels
R410 PSY UK57645
UP10/06/08 P F006
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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSVL5Q","label":"IMS Database Reorganization Expert for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023