How do I rename (and optionally enlarge) an RTCS Registry dataset?

Version 1
    Share This:

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    PRODUCT:

    MainView Infrastructure


    COMPONENT:

    Runtime Component System for OS/390 and z/OS



    QUESTION:

    How do I rename (and optionally enlarge) an RTCS Registry dataset?


    ANSWER:

     

    If a rename of an RTCS Registry dataset is required, follow the steps outlined below. If it is recommended to enlarge the dataset by BMC Software then this can be performed using the same process.

    1) Shutdown all MainView address spaces (PASs and CASs), but do not shut down the RTCS Subsystem address space (leave it running).

      

    2) Take the backing VSAM Linear Dataset (VLDS) for the RTCS Subsystem SYSTEM Registry offline. To do this, use the command: "F RTCS,REGISTRY UNALLOCATE".

      

    3) Run the OSZRGTBR utility (as shown below) in batch to allocate the current (and soon to be replaced) backing VLDS with DISP=OLD. This is why it needs to be UNALLOCATEd, to allow a backup of the SYSTEM Registry to be taken.

    4) Create the new RTCS backing VLDS dataset using JCL as shown below.  If it is required to enlarge the dataset then the new SPACE allocation should be larger than the current SYSTEM Registry's backing VLDS.
    The currently recommended size for a Production Registry dataset is 729 CYLS.

    //ALLOC EXEC PGM=IEFBR14 <-- ALLOCATE VSAM LINEAR DATA SET 
    //REGISTRY DD DISP=(NEW,CATLG), 
    //      DSN=your_new_VLDS_name, 
    //      RECORG=LS,AMP=AMORG, 
    //      UNIT=3390,SPACE=(CYL,729)

      

    5) Run the OSZRGTBR utility in batch to restore the backup that was taken in step 2 into the new, freshly-allocated or freshly-DEFINEd LINEAR Data Set created in step 4).
    The restore process performed by OSZRGTBR reloads all the backed up data into the new backing VLDS in a manner that will enable RTCS to (potentially) use the additional DASD SPACE made available by allocating a new, empty, larger VLDS.

      

    6) Shut down the RTCS Subsystem address space.

      

    7) Change OSZINIxx to set SREGVLDS to the newly-allocated Backing VLDS's DSNAME. 

      

    8) Re-Start the RTCS Subsystem address space. 

      

    9) Re-Start all the MainView address spaces (CAS, PASs, etc.).

      


    The JCL for OSZRGTBR is included below. There are two STEPs: one for backup and one for restore. They can be run in the same JOB if desired, but they must be run in two separate JOB STEPs.

      

    //* BACK UP OFFLINE SYSTEM Registry using OSZRGTBR
    //BACKSYS EXEC PGM=OSZEXEC8,PARM=('P=OSZRGTBR‘) 
    //SYSPRINT  DD SYSOUT=*,LRECL=126
    //REGISTRY  DD DISP=OLD,DSN=BMC.MAINVIEW.SYS1.RTCSRGRY
    //BACKUP     DD DISP=(NEW,CATLG),UNIT=3390,RECFM=FB,
    //             LRECL=80,SPACE=(CYL,(nnn,nn),RLSE),   *amend space allocation as required
    //             DSN=prefix.OLD.SYS1.REGISTRY.BACKUP
    //* RESTORE BACKUP INTO A LARGER, EMPTY VSAM LINEAR DATA SET
    //RESTSYS EXEC PGM=OSZEXEC8,PARM=('P=OSZRGTBR‘) 
    //SYSPRINT  DD SYSOUT=*,LRECL=126
    //REGISTRY  DD DISP=(NEW,CATLG),UNIT=3390,
    //             STORCLAS=whatever,MGMTCLAS=NOMIGRAT,
    //             DSN=prefix.new.prod.SYSTEM.REGISTRY, [new DSNAME]
    //             RECORG=LS,SPACE=(CYL,nnn)  *nnn is the recommended new space allocation - in Cylinders (365 or 729 CYL)
    //RESTORE   DD DISP=SHR,DSN=prefix.OLD.SYS1.REGISTRY.BACKUP

     


    Article Number:

    000165551


    Article Type:

    FAQ/Procedural



      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles