Scope: All North American SMCs
Effective Date: 10/08/2013
Group Name: Software Services Mainframe IMS
Affected Locations: All North American SMCs
Summary:
Currently, most HP locations are running IMS V12.1 SOS AA00. This user communication provides planning information for sites in preparation for the IMS V12.1 SOS AD00 Maintenance.
Actual upgrade dates will be determined with each account using normal change management processes. Maintenance will be performed in an account’s test IMS subsystem prior to production to allow for application testing.
Justification:
IMS V12.1 SOS AD00 will allow HP to maintain the current level of technology.
The maintenance will include the following enhancements:
-IMS Support for 255 VSAM buffer pools.
-Non-discardable messages user exit (DFSNDMX0) reassemble due to the addition of four new transaction status flag options for field NDMTRNST in the DFSNDM interface block.
-Reset reorganization number in a HALDB partition after a timestamp recovery.
-Syntax checker support for parameter GBL_SERIAL_PGM.
-Online support for new function (/CK,start_value,length_value) in the SRCH= and SUBSEQ= parameters on a XDFLD statement for a DEDB DBD definition with Fast Path secondary index.
-Repository Resource Validation to validate attribute resource definitions being written to the repository with the attributes of any associated definition that is being written to the repository, or is already in the repository.
-ADDs CANCEL_PGM= support in MPP regions for persistent JVM.
-When the OTMA transaction expiration function is activated and the transaction is expired at GU time, SYMPTOM DUMP and DFS554A won't be generated in order to save CPU cycles. DFS3688I instead of DFS555I / DFS2224 will be sent to the OTMA client.
-DBRC Coexistence for IMS V12 with an IMS V13 RECON.
-/DIS TRACE ALL will now include SECT trace information.
-/TRA SET TABLE ALL will act on the SECT trace.
-Fast Path Secondary Index Boolean Operator Support.
-OTMA client IMS proclib dataset member DFSYDTX, addition of parameter ‘MAXTP=’. This indicates the maximum number of TPIPES for this member that can be created.
-Add REFRESH USEREXIT to the list of commands that are supported on the XRF alternate and on an RSR tracking subsystem.
-CMPRSNR parameter (Log Archive Utility).
-Pass a map name to ICAL call using AIB.
-Provide OTMA early termination notification by leaving the XCF group when an IMS abend is detected.
-GSAM Extended Address Volume (EAV) support.
-Persistent JVM in MPP/IFP/BMP enhancement. CANCEL_PGM=Y and Connection re-use CONN_REUSE= support.
-FPSI command codes and multiple SSA support where target segment is not the root segment.
-New user message exit for DATAPOWER HWSDPWR1.
-PARDLI=1 support for all IMS dependent region types (MPP/JMP/IFP)
-Update to parallel RECON access processing.
-Changes to default settings for the IMS V12+ FP 64 bit buffer manager. Default compression and pre-expansion settings default is now OFF.
-IMS Support for CA Reclaim JRNAD exits.
-IMS TIMING SERVICES AND ESAF - Long running calls to ESAF from application programs running in IMS dependent regions receive ABENDU240 when using IMS Timing Services.
Benefits to Users:
This information is being communicated to ensure planning occurs and all prerequisites are addressed for a smooth and timely transition.
IMS Capabilities will test this upgrade on a 'sandbox' system first to verify the installation and to make sure the IMS system starts and is operational. The maintenance will then be applied to the development regions where accounts should verify their applications are still functioning properly. After the application teams complete their testing, the software will be installed in production. The accounts should then verify their applications are still functioning properly in the production environment.
Details:
In order for the functions provided by some of this maintenance to fully correct a reported problem, it must be migrated to all the IMS systems in an IMSPLEX or XRF environment.
-Size of the following log record has changed (in hex): 67D0, subtype 1B, 5607, 5612. 56FA, 4006
-IMS control block HWSDSIB size change.
-Re-link required for the following exits: HWSJAVA0, HWSSMPL0, HWSSMPL1, DBFPSE00, DFSCCMD0, DFSFTFX0, HWSXIBDS.
-An ACBGEN is only required when:
1. The IBM IMS Fastpath DEDB Secondary index function has already been genned into this IMS subsystem. If the ACBGEN is skipped but the code is put on the system, the source and target DEDBs are marked un-usable.
2. If a DBD is updated to use the new SRCH or SUBSEQ format in the XDFLD statement.
-For Full Function HALDB PHIDAM users using PRT=NT (NOTWIN). To be effective, HALDB must be defined as OLRNOCAP – not OLR capable. When the CHANGE.DB DBRC command is used to switch the HALDB between OLRCAP and OLRNOCAP, the master database must be /DBR'ed first, then /STA'ed after the DBRC command to switch from OLRCAP to OLRNOCAP or OLRNOCAP to OLRCAP.
-FP DBCTL changes the value of the DBPCBMKL field in the DBPCB for DBCTL thread. When the PSB is scheduled, the DBPCBMKL field in the DBPCB contains the maximum feedback key length under DBCTL environment. DBPCBMKL field contains zeros under other environments.
-If you have stored JCL created by the IMS Manage Resources, Manage RDDS or Create RDDS from a Log Records Extract list of log data set names from RECON option (IMS ISPF application option 2.7.1.2), you must regenerate that JCL.
-CPI-C transactions utilizing the IMS Subsystem Attach Facility (ESAF) in an online IMS subsystem that is tracked by the corresponding Fast Database Recovery (FDBR) system, must shut down both active and FDBR systems, install the needed fix and then start the active IMS system.
- Changes to the DFSSQQRY FUNC=QNAME,TYPE=TRANRDY behavior from always querying all three queue names (tran ready queue global, tran ready queue affinity, serial queue affinity), to querying tran ready queue global/affinity if SERIAL=NO, and tran serial queue if SERIAL=YES. Any user modifications or non-IBM vendor software which references the DFSSQQRY call must be changed to recognize the DFSSQQRY MACRO changes.
-IF your applications use the AIB INQY ENVIRON call, the application area for the INQY ENVIRON data is a minimum of 108 bytes and the corresponding I/O area is a minimum of 160 bytes. Application programs that issue the INQY ENVIRON call that have an area less than the minimum size will receive a status code "AG". The I/O area will be filled with partial data, as much as will fit in the I/O area provided. AIBOALEN will contain the length of the data returned in the I/O area and AIBOAUSE will contain the output area length that is required to receive all the data for the INQY ENVIRON call.
-If OTMA C/I (Callable Interface) is being used, then after applying this maintenance, standalone program DFSYSVI0 must be run to reinitialize OTMA C/I. APPLICATION CHANGES MAY BE REQUIRED: RC=0 RSN1=48 for OTMA_SEND_RECEIVE and OTMA_SEND_RECEIVEX API calls have been deleted. If the output buffer is too small\OTMA C/I will always return RC=8 RSN1=48.
-Increase in the size of SLDSs if the OLDS being archived contain updates for full function non-recoverable DBs and the archive control statements are not modified.
-IMS will no longer initialize with empty ACBLIBs unless MODBLKS is also empty except for DOPT PSBs and GPSBs. If DOPT/GPSB PDIRs are defined IMS will initialize with no PSBs in the ACBLIBs. If DDIRs are defined there must be at least one DMB read from ACBLIBs
-A bad Change Accum data set (one with CDDBTYP byte at offset x13 not set) can still be used as an input to the next CA job if it is run at the same IMS release. The DFSCUMN data set produced will have the CDDBTYP byte set correctly. If user is in coexistence mode, then a bad CA ds needs to be invalidated by an Image Copy.
-The OTMA Destination descriptor, specified DFSYDTx member of IMS PROCLIB, for the XML
converter parameter CONVRTR. The old CONVERTR parameter will be supported to reduce impact to existing users, but support may be removed in future releases.
-The offset to the field CCBSRPST in the CCB has changed.
-A new symbolic link in the file system used by IMS JAVA users. Run job DFSJSMKD from IMS.SDFSBASE.
-The output of DFSISTS0 message text has changed when the 'NON PRINT=HEX' option is not supplied. There has been no change to the output of DFSISTS0 when 'NON PRINT=HEX' is supplied. Prior to this maintenance some BMP regions were getting ABENDU1033 when several FLD calls are issued. Now a STATUS FW may be returned to your application earlier for FLD calls. Take appropriate Programmer response for STATUS FW.
-IMS V12 will not allow /DBRECOVERY commands against Full Function databases that have INDOUBT EEQEs.
-Any user exits or non-IBM vendor software which is sensitive to these short labels may need to be changed.
*/DIS TRACE ALL will now include SECT trace information.
*Changes output short labels for QUERY commands.
*Command: QUERY DB|DBDESC|PGM|PGMDESC|RTC|RTCDESC|TRAN|TRANDESC
*/DISPLAY ACTIVE REGION command output is modified for TYPE=BMP REGIONS created by IMS to process the online reorg to DISPLAY a status of OLR-RUNNING.
*/DIS POOL QBUF command output in a Shared Queues environments
*MSG CHG DFS3178E, DFS3187W, DFS3490I, DFS2744E, DFS3215W, DFS4427E, DFS4383E, DFS4382W,
DFS4384I, DFS4385W, DFS4386I, DFS3490I, DFS4429E
Primary Contact:
Sue Banville
Software Services Mainframe IMS
845-783-4808
Secondary Contact:
Sonny Smith
Software Services Mainframe IMS
856-451-1367
Rick Manning
Software Services Mainframe IMS
972-604-5359
|
IMS V12 AD00 Maintenance Information