A fix is available
APAR status
Closed as new function.
Error description
DCR KA00045 ----------- This IMS service provides support for the Dynamic Resource Definition (DRD) functionality in the IMS IVP process.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All IMS V10 IVP users. * **************************************************************** * PROBLEM DESCRIPTION: In IMS version 10, the current IVP is * * enhanced to demonstrate and test the * * Dynamic Resource Definition (DRD) * * function. * **************************************************************** * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF * **************************************************************** The IVP built sample IMS system is enhanced to demonstrate how to setup and operate Dynamic Resource Definition (DRD). The following steps are provided to create an online IMS execution scenario that exercises DRD functions. 1. Resource preparation 1.1 Create DBD and PSBs for the new resources. 1.2 Assemble and bind application programs. 1.3 Create MFS formats for the new transactions. 1.4 Allocate database dataset for new DBD. 2. Environment setup for DRD 2.1 Create DFSDF000 proclib member using MODBLKS=DYN, AUTOEXPORT, AUTOIMPORT, RDDSDSN=(IMS.RDDS1,IMS.RDDS2). 2.2 Allocate two Resource Definition Data Sets (IMS.RDDS1 and IMS.RDDS2) which are used to save IMS resource definitions. 3. Online IMS execution 3.1 Bring up IMS system with a Cold start. 3.2 Create new resources: databases, programs, transactions using DRD. 3.3 Run BMP jobs and transactions to verify the new resources in effect. 3.4 Shut down IMS system normally. 4. IMS system restart 4.1 Bring up IMS system with a Cold start. 4.2 Run BMP jobs and transactions again to verify the new resources are still in effect. 4.3 Shut down IMS system normally. End of scenario.
Problem conclusion
Temporary fix
The fix for this APAR is BAD. If you need to apply the fix for this APAR to resolve a problem, you must also apply the fix for APAR PK46172. AE07/05/30
Comments
The above scenario is implemented and translated into IVP jobs and tasks sequence as follows: 1- The "E" IVP Steps - Prepare IVP Applications and System The E IVP Steps are modified as follows: IV_E201J JOB - DBDGENs Add steps to generate the new DB IVPDRD1 into the DBDLIB data set. IV_E202J JOB - PSBGENs Add steps to generate the new PSBs DFSIVPDL,DFIVPD2, DFSIVPD3 and DFSIVPH into the PSBLIB data set. IV_E204J JOB - MFS Language Utility Add a step to create the message format service (MFS) DFSIVF6 for new transaction IVTND into the FORMAT data set - DB/DC Add a step to create the message format service (MFS) DFSIVFH for new transaction IVTC5 into the FORMAT data set - DCCTL IV_E206J JOB - Assembly/Bind Applications Add a step to assemble and link edit the new programs DFSIVPD2 and DFSIVPD3 to the PGMLIB data set. The application DFSIVA7 associated with the new Batch program DFSIVPD3. The application DFSIVA1 associated with the new MPP program DFSIVPD2. IV_E301J JOB - Create Dynamic Allocation Members Add statements to allocate database sataset for the new DBD IV_E303J JOB- Add SCI/OM/RM Members to IMS.PROCLIB Add a step to create the DFSDF000 member contains parameters related to dynamic resource definition and common service layer. 2- The "O" IVP Steps - CSL, DRD, CQS samples The O IVP Steps are modified as follows: IV_O101J JOB - Allocate Data Sets Add steps to allocate two resource definition data sets IMS.RDDS1 and IMS.RDDS2. They are external data sets to save the changes made to resource definitions. IV_O214J JOB - Start DCCTL Region IVP9 Add the parameter DFSDF=000 to the PARM1 list to specify the three character suffix of the proclib member DFSDFxxx with DFSDF=000 to have DRD and AutoExport and AutoImport enabled. IV_O215J JOB - Start DB/DC Region IVP1 Add the parameter DFSDF=000 to the PARM1 list to specify the three character suffix of the proclib member DFSDFxxx with DFSDF=000 to have DRD and AutoExport and AutoImport enabled. IV_O216J JOB - Start DBCTL Region IVP2 Add the parameter DFSDF=000 to the PARM1 list to specify the three character suffix of the proclib member DFSDFxxx with DFSDF=000 to have DRD and AutoExport and AutoImport enabled. IV_O220T TASK - SPOC - SPOC Sample II Add steps to create and query new resources IV_O221J JOB - Start the WFI BMP - New step - DCCTL (based on IV_J205J) Run BMP application to verify the new program operational. This WFI (wait for input messages) BMP processes transaction messages received from a terminal. IV_O222J JOB - FF BMP - HDAM Update - New step - DBCTL (based on IV_G210J) Run BMP application to verify the new program operational. This JOB performs updates of a HDAM data base. The program DFSIVPD3 accesses the existing phone book database to update a last name record and delete it. IV_O223J JOB - FF BMP - HDAM Update - New step - DB/DC (based on IV_H211J) Run BMP application to verify the new program operational. This JOB performs updates of a HDAM data base. The program DFSIVPD3 accesses the existing phone book database to update a last name record and delete it. IV_O224T USER - FF MPP Transaction - New step - DB/DC (based on IV_H214T) Run the new transaction IVTND to schedule the new program DFSIVPD2 to verify it operational. The program DFSIVPD2 is processed when the transaction IVTND is requested from a user terminal. The program also access the phone book database and response to user terminal based on user action request displaying, adding, updating, or deleting a last name record. IV_O225T USER - BMP Transaction - New Step - DCCTL (based on IV_J206T) Run the new transaction IVTC5 to schedule the new program DFSIVPH to verify it operational. The program DFSIVPH is processed when the transaction IVTC5 is requested from a user terminal. The program also access the simulated phone book database and response to user terminal based on user action request of displaying, adding, updating, or deleting a last name record. IV_O226T IVP1 - Stop IMS with a /CHE FREEZE - New Step This JOB stops the IMS DB/DC Control Region for system IVP1. IV_O227T IVP3 - Stop DBCTL with a /CHE FREEZE - New Step This JOB stops the IMS DBCTL Control Region for system IVP3. IV_O228T IVP4 - Stop DCCTL with a /CHE FREEZE - New step This JOB stops the IMS DCCTL Control Region for system IVP9. IV_O229J JOB - Start DB/DC Region IVP1 - New Step This JOB starts the IMS DB/DC Control Region for system IVP1. IV_O230J JOB - Start DBCTL Region IVP3 - New Step This JOB starts the DBCTL Control Region for system IVP3. IV_O231J JOB - Start DCCTL Region IVP9 - New Step This JOB starts the DBCTL Control Region for system IVP9. IV_O232T IVP1 - Cold Start IMS - New Step This step issues the IMS cold start command to IVP1. IV_O233T IVP3 - Cold Start DBCTL - New Step This step issues the IMS cold start command to IVP3. IV_O234T IVP9 - Cold Start DCCTL - New Step This step issues the IMS cold start command to IVP9. IV_O235J JOB - Start the WFI BMP - New step - DCCTL Run BMP application to verify the new program operational. This WFI (wait for input messages) BMP processes transaction messages received from a terminal. IV_O236J JOB - FF BMP - HDAM Update - New step - DBCTL Run BMP application to verify the new program operational across IMS restart. This JOB performs updates of a HDAM/OSAM data base. IV_O237J JOB - FF BMP - HDAM Update - New step - DB/DC Run BMP application to verify the new program operational across IMS restart. This JOB performs updates of a HDAM/OSAM data base. IV_O238T USER - FF MPP Transaction - New Step - DB/DC Using the same USER terminal you used previously, re-run the IVTND transaction to verify its operational across IMS restart. IV_O239T USER - BMP Transaction - New Step - DCCTL Using the same USER terminal you used previously, re-run the IVTC5 transaction to verify its operational across IMS restart. IV_O401J JOB - Scratch Data Sets Add a step to scratch the resource definition data sets (RDDS) ------------------- Modified parts: 18 ------------------- DFSIXB02 TABLE - IVP jobs/tasks entries Add new entries for new jobs and tasks for DRD implementation. DFSIXS17 SKELETON - IMBED - DB/DC startup for IVP1 Specified parm DFSDF=000 in the parm1 list for IMS proc. DFSIXS75 SKELETON - IMBED - ALLOCATION JCL Add step that allocates the new database dataset DFSDRD1. DFSIXS83 SKELETON - IMBED - SCRATCH JCL Add step that scratches the new database dataset DFSDRD1. DFSIXS69 SKELETON - IMBED - INIT.DB CONTROL STMT Add step that registers the new database IVPDRD1. DFSIXS61 SKELETON - IMBED - JOB STEP TO LOAD DB Add step that loads the new database IVPDRD1. DFSIXSE1 SKELETON - PERFORM IVP DBDGEN Add step that perfoms a DBDGEN on the new DB IVPDRD1. DFSIXSE2 SKELETON - PSBGENs Add steps to generate PSBs for the new program preparation. DFSIXSE4 SKELETON - MFS Language Utility Add step to define a MFS for the new transaction IVTND. DFSIXSE5 SKELETON - Assembly/Bind Applications Add step to assemble and bind the new BMP and MPP programs. DFSIXSE6 SKELETON - CREATE DYNAMIC ALLOCATION MEMBERS Add step to allocate database and dataset dynamically. DFSIXSOZ SKELETON - Add CSL control statement to PROCLIB Add step to create the proclib member DFSDF000. DFSIXSO0 SKELETON - Allocate Data Sets Add step to allocate two RDDSs for resource repository. DFSIXSOC SKELETON - Scratch Data Sets Add step to scratch two RDDSs for resource repository. DFSIXSOB SKELETON - START DBCTL REGION - IVP3 Add DFSDF=000 to PARM1 list of the DBCTL startup job DFSIXSOD SKELETON - START DCCTL REGION - IVP4 Add DFSDF=000 to PARM1 list of the DCCTL startup job DFSIXROA SCRIPT - Help text for O steps introduction Updated the step title to include DRD. DFSIXROP SCRIPT - Help text for task IV_O220T Add steps that demonstrates how to create new resources. -------------- New parts: 14 -------------- DFSIXS9A SKELETON - IMBED Scratch RDDS This is a callable imbed skeleton job to scratch RDDSs. DFSIXS9B SKELETON - IMBED Allocate RDDS This is a callable imbed skeleton job to allocate RDDSs. DFSIXSO6 SKELETON - BMP HDAM Update job - DBCTL BMP job to execute phone book program running in a BMP region. DFSIXSOK SKELETON - BMP HDAM Update job - DB/DC BMP job to execute phone book program running in a BMP region. DFSIXSOJ SKELETON - WFI BMP - DCCTL This JOB starts the WFI BMP and waits for a request to be processed. DFSIXRO3 SCRIPT - Help text for task IV_O224T DFSIXRO4 SCRIPT - Help text for task IV_O225T DFSDRD1 COPY - DBD source DBCTL DFSIVPDL COPY - PSB source to load new DB DFSIVPD3 COPY - PSB source for BMP program DFSIVPD2 COPY - PSB source for MPP program DFSIVPH COPY - PSB source for WFI BMP program DFSIVF6 COPY - MFS definition for tran IVTND DFSIVFH COPY - MFS definition for tran IVTC5 --------------------------------------------- THE FOLLOWING TEXT DESCRIBES THE DOC CHANGE: - IMS V10 Installation Guide Chapter: Other sample applications Section: CSL, DRD, CQS sample applications Support for the Dynamic Resource Definition (DRD) function is available in the IVP. The IVP built sample IMS system is enhanced to demonstrate how to setup and operate DRD. The following steps are provided to create an online IMS execution scenario that exercises DRD functions. 1. Resource preparation 1.1 Create DBD and PSBs for the new resources. Table 18. IVP Sample Application Parts Part Lang PSB MFS TRANCD DBD Description ============================================================= DFSIVA7 assem DFSIVPD3 n/a n/a IVPDRD1 DB batch, BMP DFSIVA1 assem DFSIVPD2 DFSIVF6 IVTND DFSIVD1 Non-conv. MPP DFSIVAD assem DFSIVPH DFSIVFH IVTC5 Simulated Msg WFI BMP 1.3 Create MFS formats for the new transactions. 1.4 Allocate database dataset for new DBD. 2. Environment setup for DRD 2.1 Create the proclib member DFSDF000 using the following parameters: MODBLKS=DYN enables DRD for MODBLKS resources. AUTOEXPORT=AUTO exports resources automatically to an external data set at a checkpoint time. AUTOIMPORT=AUTO imports resources automatically from an external data set during an IMS cold start. RDDSDSN=(IMS.RDDS1,IMS.RDDS2) defines a set of two BSAM data sets which are used to save IMS resource definitions. 2.2 Allocate two Resource Definition Data Sets (IMS.RDDS1 and IMS.RDDS2) which are used to save IMS resource definitions. 3. Online IMS execution 3.1 Bring up IMS system with a Cold start. 3.2 Create new resources: database, programs, transactions using 3.3 Execute the new programs and transactions to verify the new resources are in effect. The program DFSIVPD1 accesses the existing phone book database to update a record and delete it. The program DFSIVPD2 is processed when the transaction IVTND is requested from a user terminal. The program also accesses the phone book database and response to user terminal based on user action request of displaying, adding, updating, or deleting a record. 3.4 Shut down IMS system normally. 4. IMS system restart 4.1 Bring up IMS system with a Cold start. 4.2 Execute the new programs and transactions again to verify the new resources are still in effect. 4.3 Shut down IMS system normally. End of scenario.
APAR Information
APAR number
PK41596
Reported component name
IMS V10
Reported component ID
5635A0100
Reported release
010
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2007-03-19
Closed date
2007-05-25
Last modified date
2007-09-10
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK25528
Modules/Macros
DFSDRD1 DFSIVFH DFSIVF6 DFSIVPDL DFSIVPD2 DFSIVPD3 DFSIVPH DFSIXB02 DFSIXROA DFSIXROP DFSIXRO3 DFSIXRO4 DFSIXSE1 DFSIXSE2 DFSIXSE4 DFSIXSE5 DFSIXSE6 DFSIXSOB DFSIXSOC DFSIXSOD DFSIXSOJ DFSIXSOK DFSIXSOZ DFSIXSO0 DFSIXSO6 DFSIXS17 DFSIXS61 DFSIXS69 DFSIXS75 DFSIXS83 DFSIXS9A DFSIXS9B
Fix information
Fixed component name
IMS V10
Fixed component ID
5635A0100
Applicable component levels
R010 PSY UK25528
UP07/06/22 P F706
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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.1","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCVRBJ","label":"System Services"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
10 September 2007