IMS 10 Dynamic Resource Definition
Midwest IMS User’s Group Meeting
September 16, 2009
Angelique Greenhaw
IT Specialist, I...
Overview

        Dynamic Resource Definition (DRD) Introduction
          – Modifying resource definitions without DRD
  ...
Overview (continued)

         DRD Utilities
          – Create RDDS from existing data
          – Extract RDDS contents
...
Dynamic Resource Definition in IMS 10
        Supports MODBLKS resources which are represented by control
        blocks t...
Modifying Resource Definitions without DRD
            To add, change, or delete MODBLKS resources in a running IMS
      ...
Modifying MODBLKS Resources without DRD

                                                 During IMS restart processing,
 ...
Dynamic Resource Definition (DRD)
           OBJECTIVE: To improve the availability of the IMS online
           environme...
DRD Components
         Type-2 commands: CREATE, DELETE, UPDATE,
         IMPORT, EXPORT
         Set of resource definiti...
DRD Components

          Enhanced DFSINSX0 (Destination Creation) user exit to
          dynamically create program and t...
Modifying MODBLKS Resources with DRD
                                               During IMS cold start processing,
    ...
DRD Highlights
        DRD for MODBLKS resources is optional
        Either DRD or online change can be enabled for MODBLK...
DRD Environment
         DRD requires IMS 10 with:
          – Common Service Layer with Structured Call Interface and Ope...
Resource Definition Data Sets
          BSAM data set used to save MODBLKS resource and
          descriptor definitions f...
Automatic Import

          Allows all resource and descriptor definitions to be read in
          automatically during IM...
Automatic Export

          Allows changed resource and descriptor definitions for an IMS
          to be exported to a sy...
Descriptors
          A descriptor is a model for defining (creating) a resource or
          another descriptor
         ...
Recoverability

          Resource and descriptor definitions
             – Exist for the life of IMS or until deleted

 ...
DRD Utilities



                © 2009 IBM Corporation
DRD Utilities – perform DRD-related functions

          Run offline, invoked via JCL streams
          Output written to ...
DRD Utilities – perform DRD-related functions

          Extract RDDS contents
             – Queries the RDDS and display...
DRD Utilities – perform DRD-related functions
          Benefits
             – Facilitate implementation of DRD by reduci...
DRD Commands



               © 2009 IBM Corporation
Commands Used in DRD
          Type-2 commands entered through OM interface

            Command Short Purpose
           ...
Commands Used in DRD - Keywords

     Resource                    SYSGEN        IMS Control Resource   Descriptor
     Typ...
CREATE Command - Syntax
           CREATE rsc-type | desc-type
           NAME(name1,name2,...)
           LIKE(RSC(rsc-na...
DELETE Command - Syntax
          DELETE rsc-type | desc-type
              NAME(* | name1,name2,NAME*,...) OPTION(ALLRSP)...
DELETE Command
          To delete a resource
            – Resource cannot be “in use”
            – Recommendation: stop...
UPDATE Command
         Enhanced in IMS 10 to support updating:
           – Resource/descriptor status and attributes
   ...
IMPORT Command (available with
   PK66682/UK41047)
          Used to import resource and descriptor definitions from an RD...
EXPORT Command (available with
     PK66704/UK41049)

            Used to export resource and descriptor definitions to an...
EXPORT Command (available with
     PK66704/UK41049)
          EXPORT Command Syntax

         EXPORT DEFN TARGET(RDDS) TY...
EXPORT/IMPORT Command Use

          Application migration
             – Use EXPORT/IMPORT to migrate an application defi...
QUERY Command for Runtime
     MODBLKS Resource Definitions
          Enhanced in IMS 10 to support:
            – QUERY P...
Summary
          IMS 10 Dynamic Resource Definition
            – Improves IMS availability by allowing dynamic creation,...
Upcoming SlideShare
Loading in...5
×

Dynamic Resource Definition for IMS

1,516

Published on

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
1,516
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
34
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Dynamic Resource Definition for IMS

  1. 1. IMS 10 Dynamic Resource Definition Midwest IMS User’s Group Meeting September 16, 2009 Angelique Greenhaw IT Specialist, IMS Advanced Technical Support greenhaw@us.ibm.com © 2009 IBM Corporation
  2. 2. Overview Dynamic Resource Definition (DRD) Introduction – Modifying resource definitions without DRD – DRD objective/components – Modifying resource definitions with DRD – DRD highlights and environment – Resource Definition Data Set (RDDS) – Automatic Import/Export – Descriptors – Recoverability of resources/descriptors Midwest IMS User’s Group Meeting - 9/16/2009 2
  3. 3. Overview (continued) DRD Utilities – Create RDDS from existing data – Extract RDDS contents DRD Commands/How to use – CREATE, DELETE, UPDATE, IMPORT, EXPORT, QUERY Midwest IMS User’s Group Meeting - 9/16/2009 3
  4. 4. Dynamic Resource Definition in IMS 10 Supports MODBLKS resources which are represented by control blocks that define resources and their attributes in a running IMS system Control block is generated for a MODBLKS resource when its respective SYSGEN macro is run RESOURCE TYPE SYSGEN MACRO CONTROL BLOCK Database DATABASE DDIR (DB/TM, DBCTL) (Database Directory) Application Program APPLCTN PDIR (DB/TM, DBCTL, DCCTL) (Program Directory) Transaction TRANSACT SMB (DB/TM, DCCTL) (Scheduler Msg Block) Routing Code RTCODE RTCE (DB/TM, DCCTL) (Routing Code Table Entry) Midwest IMS User’s Group Meeting - 9/16/2009 4
  5. 5. Modifying Resource Definitions without DRD To add, change, or delete MODBLKS resources in a running IMS system requires – MODBLKS SYSGEN – ACBGEN - if database (DDIR) or program (PDIR) change – Way to bring the new MODBLKS resources online • Online change • IMS restart During online change processing, all activity is quiesced at some point OLC One resource can prevent SYSGEN entire process from ACBGEN /NRE completing May not have available window to recycle IMS Process is more complex with multiple IMSs running in an IMSplex – Coordinated online change || multiple coordinated system restarts Midwest IMS User’s Group Meeting - 9/16/2009 5
  6. 6. Modifying MODBLKS Resources without DRD During IMS restart processing, //MODBLKSx resource definitions are loaded from the active MODBLKS library (cold start) or from the IMS log (warm/emergency OLDS restart). (stored resource definitions) WARM START COLD START EMERGENCY RESTART OLC IMS Control Region IMS Control Region RESTART Control Blocks After restart, these can only DDIRs be added, changed, or deleted through the ONLINE PDIRs CHANGE process or SMBs SYSGEN Process another RESTART (some RTCEs definitions can be updated (runtime resource definitions) by command). Midwest IMS User’s Group Meeting - 9/16/2009 6
  7. 7. Dynamic Resource Definition (DRD) OBJECTIVE: To improve the availability of the IMS online environment Allow user to dynamically define and enable MODBLKS resource definitions – Databases – Programs – Transactions – Routing Codes Benefits – No requirement for IMS SYSGEN + IMS restart/online change – Increased resource availability – MODBLKS online change process not required, limitations eliminated Midwest IMS User’s Group Meeting - 9/16/2009 7
  8. 8. DRD Components Type-2 commands: CREATE, DELETE, UPDATE, IMPORT, EXPORT Set of resource definition data sets (RDDS) – Contains statically (SYSGEN) and dynamically created definitions • Resource definitions • Model descriptors Import and export functions provided to save/restore resource definitions across a cold start Enhanced Type-2 command to QUERY the attributes of defined IMS resources and descriptors Midwest IMS User’s Group Meeting - 9/16/2009 8
  9. 9. DRD Components Enhanced DFSINSX0 (Destination Creation) user exit to dynamically create program and transaction resources UPDATE and QUERY support for MSC resources – Supports resource modification without requiring system definition changes or an IMS restart Midwest IMS User’s Group Meeting - 9/16/2009 9
  10. 10. Modifying MODBLKS Resources with DRD During IMS cold start processing, resource definitions may be IMPORTed from a Resource Definition Data Set. RDDS Definitions can be EXPORTed OLDS to a Resource Definition Data Set. (stored resource Definitions can be dynamically created, definitions) updated, or deleted using new or WARM START enhanced Type-2 commands. EMERGENCY RESTART IMPORT IMS CONTROL REGION IMS CONTROL REGION EXPORT Control Blocks DDIRs CREATE PDIRs UPDATE SMBs DELETE IMPORT RTCEs EXPORT (runtime resource definitions) QUERY Midwest IMS User’s Group Meeting - 9/16/2009 10
  11. 11. DRD Highlights DRD for MODBLKS resources is optional Either DRD or online change can be enabled for MODBLKS resource management, but not both (cold start required to switch) If DRD is enabled – Online Change for MODBLKS is disabled – MODBLKS data sets are optional – ACBLIB and FMTLIB Online Change is allowed – MODBLKS SYSGEN no longer required Midwest IMS User’s Group Meeting - 9/16/2009 11
  12. 12. DRD Environment DRD requires IMS 10 with: – Common Service Layer with Structured Call Interface and Operations Manager (CSL with SCI/OM) • Resource Manager is not required – IMS PROCLIB members with DRD enablement parameters • DFSDFxxx (new in IMS 10) • DFSCGxxx (CSL parameters - can be replaced by section of DFSDFxxx) – Data sets to hold resource definitions (RDDSs) – Entry point for DRD commands • TSO Single Point Of Control (SPOC), IMS Control Center, or other OM interface All IMS online environments supported, including data sharing and shared queues Midwest IMS User’s Group Meeting - 9/16/2009 12
  13. 13. Resource Definition Data Sets BSAM data set used to save MODBLKS resource and descriptor definitions for use with DRD Contains static and dynamic definitions System RDDS – Provides a single system view of an IMS's resources and descriptors – Contains all resource and descriptor definitions for an IMS – Each IMS must define its own set of system RDDS data sets – A set of system RDDS data sets must be defined for Automatic Import and Automatic Export Non-system RDDS – Can be shared between IMSs – May contain a subset of an IMS’s resource and descriptor definitions Midwest IMS User’s Group Meeting - 9/16/2009 13
  14. 14. Automatic Import Allows all resource and descriptor definitions to be read in automatically during IMS cold start Definitions are used to create the internal control blocks needed to manage resources During cold start, definitions can be imported from – System RDDS – MODBLKS data set Midwest IMS User’s Group Meeting - 9/16/2009 14
  15. 15. Automatic Export Allows changed resource and descriptor definitions for an IMS to be exported to a system RDDS data set automatically at checkpoint time (simple or shutdown) Enabling Automatic Export is optional If enabled: – Automatic Export is always done following the restart checkpoint – Subsequent exports are only done if one or more definitions have been added, changed or deleted since the last checkpoint A set of system RDDSs must be defined Midwest IMS User’s Group Meeting - 9/16/2009 15
  16. 16. Descriptors A descriptor is a model for defining (creating) a resource or another descriptor – Establishes defaults for attributes not set in the CREATE command IMS-defined descriptors provided with the IMS product: – DFSDSDB1 (database) – DFSDSPG1 (program) – DFSDSTR1 (transaction) – DBFDSRT1 (routing code) User-defined descriptors – Created or updated by the user Current system default descriptor – Each resource type will have one default descriptor (IMS-defined or user- defined with DEFAULT(Y)) • Used to set resource attribute values for those not set by user when a resource is created Midwest IMS User’s Group Meeting - 9/16/2009 16
  17. 17. Recoverability Resource and descriptor definitions – Exist for the life of IMS or until deleted – Are recovered from logs across warm and emergency restart • Definitions are logged when created, updated, or deleted, and at system checkpoint time – Are recovered across cold start if both: • Previously exported to system RDDS • Imported during next cold start Midwest IMS User’s Group Meeting - 9/16/2009 17
  18. 18. DRD Utilities © 2009 IBM Corporation
  19. 19. DRD Utilities – perform DRD-related functions Run offline, invoked via JCL streams Output written to SYSPRINT data set Generate RDDS from – Checkpoint and X’22’ (Type-2 command) log records – MODBLKS data set – SYSGEN macros Generate CREATE commands from – MODBLKS data set – SYSGEN macros Midwest IMS User’s Group Meeting - 9/16/2009 19
  20. 20. DRD Utilities – perform DRD-related functions Extract RDDS contents – Queries the RDDS and displays the resources/descriptors with all attribute values, also reports duplicates – Converts stored resource definitions in an RDDS to • IMS Stage-1 macro statements (APPLCTN, TRANSACT, DATABASE, RTCODE) • IMS Type-2 CREATE commands for DRD (could be submitted to IMS via batch SPOC) – CREATE DB – CREATE DBDESC – CREATE TRAN – CREATE TRANDESC – CREATE PGM – CREATE PGMDESC – CREATE RTC – CREATE RTCDESC Midwest IMS User’s Group Meeting - 9/16/2009 20
  21. 21. DRD Utilities – perform DRD-related functions Benefits – Facilitate implementation of DRD by reducing manual effort required to create an RDDS – Make DRD more usable by providing capability to re-create an “up- to-date” RDDS in the event of accidental loss – Allow contents of an RDDS to be queried/displayed Midwest IMS User’s Group Meeting - 9/16/2009 21
  22. 22. DRD Commands © 2009 IBM Corporation
  23. 23. Commands Used in DRD Type-2 commands entered through OM interface Command Short Purpose Form CREATE CRE Create resource or descriptor DELETE DEL Delete resource or descriptor UPDATE UPD Update attributes of resource or descriptor Update status of resource IMPORT IMP Import resource or descriptor definitions EXPORT EXP Export resource or descriptor definitions QUERY QRY Query attributes of resource or descriptor Query status of resource Midwest IMS User’s Group Meeting - 9/16/2009 23
  24. 24. Commands Used in DRD - Keywords Resource SYSGEN IMS Control Resource Descriptor Type Macro Block Keyword Keyword Database DATABASE DDIR DB DBDESC Program/PSB APPLCTN PDIR PGM PGMDESC Transaction TRANSACT SMB TRAN TRANDESC Routing Code RTCODE RTCE RTC RTCDESC Examples – CREATE PGM… – DELETE TRANDESC… – UPDATE TRAN… Midwest IMS User’s Group Meeting - 9/16/2009 24
  25. 25. CREATE Command - Syntax CREATE rsc-type | desc-type NAME(name1,name2,...) LIKE(RSC(rsc-name)) | LIKE(DESC(desc-name)) SET(attr1(val1),attr2(val2),... DEFAULT(Y)) <<< valid for descriptors only rsc-type | desc-type = resource or descriptor type NAME() = resource or descriptor names; they will all have the same attributes; wild cards not supported LIKE() = resource or descriptor name to use as model SET() = attribute names and values – DEFAULT(Y) – valid for descriptors only • Y causes this descriptor to become current system default descriptor Midwest IMS User’s Group Meeting - 9/16/2009 25
  26. 26. DELETE Command - Syntax DELETE rsc-type | desc-type NAME(* | name1,name2,NAME*,...) OPTION(ALLRSP) rsc-type | desc-type = resource or descriptor type NAME() = names of resources or descriptors – Can specify multiple names – Can use wildcard character • NAME(*) – all resources or descriptors (be careful) • NAME(PART*) – resource or descriptors starting with PART • NAME(ADDPART,BILL*) OPTION(ALLRSP) – Ignored except when NAME(*) – Indicates responses to be returned for all resources • Default is to return response only for error conditions Midwest IMS User’s Group Meeting - 9/16/2009 26
  27. 27. DELETE Command To delete a resource – Resource cannot be “in use” – Recommendation: stop resource before attempting to delete QUERY command enhanced to display resource work status – Show work that might cause delete command (or an online change) to fail Midwest IMS User’s Group Meeting - 9/16/2009 27
  28. 28. UPDATE Command Enhanced in IMS 10 to support updating: – Resource/descriptor status and attributes • MODBLKS: DB, PGM, TRAN, RTC • MSC: MSPLINK, MSLINK, MSNAME – MSC definitions have no CREATE | DELETE support Cannot update resource attribute if resource “in use” Recommendation: QUERY and stop resource before attempting to update – Stop resource with either /STOP or UPDATE with STOP() specified Cannot update resource attributes and status in same command Updating (or creating) descriptor with DEFAULT(Y) sets this descriptor to current system default descriptor for that resource type Midwest IMS User’s Group Meeting - 9/16/2009 28
  29. 29. IMPORT Command (available with PK66682/UK41047) Used to import resource and descriptor definitions from an RDDS IMPORT Command Syntax IMPORT DEFN SOURCE(RDDS) TYPE() NAME() RDDSDSN() OPTION() TYPE() defines the resource type – ALL, ALLDESC, ALLRSC, DB, DBDESC, PGM, PGMDESC, RTC, RTCDESC, TRAN, TRANDESC NAME() defines the names of the resources to import – NAME(*) is the default RDDSDSN() defines a system or non-system RDDS – If omitted, imports from a system RDDS OPTION – ALLRSP returns a response for each imported resource, valid with NAME(*) only – ABORT imports no resources or descriptors at all in the event of an error Midwest IMS User’s Group Meeting - 9/16/2009 29
  30. 30. EXPORT Command (available with PK66704/UK41049) Used to export resource and descriptor definitions to an RDDS EXPORT Command Syntax EXPORT DEFN TARGET(RDDS) TYPE() NAME() RDDSDSN() OPTION() TYPE() defines the resource type – ALL, ALLDESC, ALLRSC ,DB, DBDESC, PGM, PGMDESC, RTC, RTCDESC, TRAN, TRANDESC NAME() defines the names of the resources to export – NAME(*) is the default RDDSDSN() defines a non-system RDDS – Cannot be a system RDDS defined in DFSDFxxx member – If omitted, exports to a system RDDS Midwest IMS User’s Group Meeting - 9/16/2009 30
  31. 31. EXPORT Command (available with PK66704/UK41049) EXPORT Command Syntax EXPORT DEFN TARGET(RDDS) TYPE() NAME() RDDSDSN() OPTION() OPTION() – OVERWRITE indicates that resource/descriptor definitions are to overwrite all existing definitions in the RDDS – APPEND indicates that resource/descriptor definitions are to be appended to the end of the specified RDDS data set – ALLRSP returns a response for each exported resource, valid with NAME(*) only – NOCHECK valid with the APPEND option and allows the IMS performing the export to be a different IMS than the one that performed the previous export Midwest IMS User’s Group Meeting - 9/16/2009 31
  32. 32. EXPORT/IMPORT Command Use Application migration – Use EXPORT/IMPORT to migrate an application defined on one IMS system to another IMS system • Issue EXPORT command on IMSA to export an application’s database, program, routing code and transaction definitions to a non- system RDDS • Issue IMPORT command on IMSB to import the definitions IMS cloning – Use EXPORT/IMPORT in these example steps • EXPORT definitions from IMSA to non-system RDDS • Coldstart new IMSB with no resources defined • IMPORT definitions to IMSB from non-system RDDS Midwest IMS User’s Group Meeting - 9/16/2009 32
  33. 33. QUERY Command for Runtime MODBLKS Resource Definitions Enhanced in IMS 10 to support: – QUERY PGM (queries information about program resources) – QUERY RTC (queries information about Fast Path routing codes) – New parameter SHOW(WORK) displays work status of runtime resource Generally indicates reasons that would prevent some DRD commands or online change from completing successfully – DELETE resource – UPDATE resource – Online Change MODBLKS / ACBLIB Midwest IMS User’s Group Meeting - 9/16/2009 33
  34. 34. Summary IMS 10 Dynamic Resource Definition – Improves IMS availability by allowing dynamic creation, deletion, and updating of MODBLKS runtime resource definitions • Reduces the requirements for planned outages • Eliminates unavailability associated with MODBLKS OLC and IMS restart DRD Utilities – Allow user to generate DRD-related components using existing resources • RDDS • Sysgen macro statements • Type-2 CREATE commands – Queries/displays RDDS contents DRD Commands: CREATE, DELETE, UPDATE, IMPORT, EXPORT, QUERY Midwest IMS User’s Group Meeting - 9/16/2009 34
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×