Upgrading the CSD

There are two main steps to upgrading the CSD:

  1. Changing the CSD average and maximum record size Changing the CSD record size.
  2. Upgrading the IBM® supplied definitions using the CSD utility UPGRADE command Running the DFHCSDUP UPGRADE job.

When you have successfully upgraded your CSD, you can review the topics Sharing the CSD between different releases of CICS and Incompatibility of REQUESTMODEL resource definitions and plan what you need to do to share your CSD.

Changing the CSD record size

Before you run the DFHCSDUP utility to upgrade your CSD, first redefine the CSD to VSAM with a new average and maximum record size. The maximum record size has increased, and your CSD must now be defined with RECORDSIZE(200 2000). Here are some suggestions of how you can do this:

Here's a sample job that implements the second of these methods:

Figure 1. Sample job to rename and redefine the CSD
//BAKUPCSD JOB (1,BELL),CLASS=A                       
//ALTERDEF EXEC PGM=IDCAMS,REGION=0M                  
//SYSPRINT DD SYSOUT=A                                
//AMSDUMP  DD SYSOUT=A                                
//SYSIN    DD *                                       
  ALTER CICSTS31.CICSH.DFHCSD.* -                     
      NEWNAME(CICSTS31.CICSH.DFHCSD.*.BACKUP)         
  ALTER CICSTS31.CICSH.DFHCSD -                       
      NEWNAME(CICSTS31.CICSH.DFHCSD.BACKUP)           
  IF LASTCC = 0 THEN -                                
      DEFINE CLUSTER (                        -       
                NAME( CICSTS31.CICSH.DFHCSD ) -       
                REC(10000)                    -       
                VOLUME(SYSDA)                 -       
                KEYS( 22 0 )                  -       
                INDEXED                       -       
                RECORDSIZE( 200 2000 )        -       
                FREESPACE( 5 5 )              -       
                SHAREOPTIONS( 2 )             -       
                )                             -       
      INDEX     (                             -       
                NAME( CICSTS31.CICSH.DFHCSD.INDEX ) - 
                )                          -          
      DATA      (                          -          
                NAME( CICSTS31.CICSH.DFHCSD.DATA )    - 
                )                                       
/*                                                       
//REPROCSD EXEC PGM=IDCAMS,REGION=0M,COND=(5,LT,ALTERDEF)
//SYSPRINT DD SYSOUT=A                                   
//AMSDUMP  DD SYSOUT=A                                   
//SYSIN    DD *                                          
      REPRO INDATASET(CICSTS31.CICSH.DFHCSD.BACKUP) -    
            OUTDATASET(CICSTS31.CICSH.DFHCSD)            
/*                                                       
//                                                         

If you fail to redefine the CSD with the correct record size, failures can occur in a number of situations, indicated by the following error messages:

DFH5117
This message is issued by DFHCSDUP if you attempt to process a CSD that has the old record size.
DFHCA5117
This message is issued by CICS® if you attempt to use CEDA against a CSD that is defined with an invalid record length.
DFHAM4822
This message is issued during CICS initialization if CICS tries to open the CSD and finds that it is defined with an incorrect maximum record size.

Running the DFHCSDUP UPGRADE job

When you have redefined your CSD with the correct record size, run the DFHCSDUP utility program, specifying the UPGRADE command, to upgrade the IBM-supplied definitions in your CSD to the latest CICS TS level. You can create a new CSD using the DFHCSDUP INITIALIZE command. For information about running DFHCSDUP with the UPGRADE command, see the the CICS Operations and Utilities Guide.

Upgrading other IBM-supplied resource definitions

If you have resource definitions in your CSD that support other IBM products, you may need to upgrade these also. For example, if your Language Environment® resource definitions are not at the z/OS® Version 1 Release 4 level, you are recommended to delete and replace the CSD group containing these.

You can find the Language Environment resource definitions in the SCEESAMP library in member CEECCSD. The following job is an example of how to upgrade the Language Environment resource definitions in your CSD:

Figure 2. Upgrading Language Environment resource definitions
//CSDUPGRD JOB 1,WALSH,MSGCLASS=A,MSGLEVEL=(1,1),            
//         CLASS=A,NOTIFY=BELL                              
/*JOBPARM SYSAFF=MV26                                       
//*  Remove Old Language Environment group                  
//CSDUP1   EXEC PGM=DFHCSDUP,REGION=2M,PARM='CSD(READWRITE)'
//STEPLIB  DD DSN=CICSTS31.CICS.SDFHLOAD,DISP=SHR           
//DFHCSD   DD DSN=CICSTS31.CICSHURS.DFHCSD,DISP=SHR         
//SYSPRINT DD SYSOUT=*                                      
//SYSABOUT DD SYSOUT=*                                      
//SYSABEND DD SYSOUT=*                                      
//SYSUDUMP DD SYSOUT=*                                      
//SYSIN    DD *                                             
 DELETE GROUP(CEE)                                          
/*                                                          
//*                                                         
//CSDUP2   EXEC PGM=DFHCSDUP,REGION=2M,PARM='CSD(READWRITE)'
//STEPLIB  DD DSN=CICSTS31.CICS.SDFHLOAD,DISP=SHR           
//DFHCSD   DD DSN=CICSTS31.CICSHURS.DFHCSD,DISP=SHR         
//SYSPRINT DD SYSOUT=*                                      
//SYSABOUT DD SYSOUT=*                                      
//SYSABEND DD SYSOUT=*                                      
//SYSUDUMP DD SYSOUT=*                                      
//SYSIN    DD DSN=SYS1.ZOS140.SCEESAMP(CEECCSD),DISP=SHR  
/*                                                          
//                                                                                                                        

The Language Environment group CEE contains mostly the program resource definitions needed for all high-level language support, but also contains the mapset and transaction definition for the Language Environment CLER transaction

[[ Contents Previous Page | Next Page Index ]]