DBUTLTY DATASCAN vs RETIX KEYNAME=*DATA for CA Datacom

Products

• Datacom
• Datacom/AD
• Datacom/DB

Issue/Introduction

Datacom version 15.1 provides several enhancements, including a new DBUTLTY function called DATASCAN.

One of the DATASCAN options is 

     DATASCAN OPTION=REBUILD_SPACE_INDEX

This option is an alternative to RETIX KEYNAME=*DATA. However, note that options currently documented continue to be supported. 

Environment

z/OS

Release: 15.1

Component : CA Datacom/DB

Component : CA Datacom/AD

Resolution

If you previously used the DBUTLTY function

RETIX KEYNAME=*DATA,DBID=dbid,...,

you can now use the new feature available in Version 15.1:

DATASCAN OPTION=REBUILD_SPACE_INDEX,DBID=dbid,...

This function is described in the documentation:

CA Datacom®/DB uses the DATASCAN OPTION=REBUILD_SPACE_INDEX option to track the space available in a data area which is defined with space reclamation (data area space management options other than 0).

When running this function, the output is very simple. Here is an example using DBID 252:

Date:  5/19/2021    ********************************************************************************         Page:     8
                    *                                CA Datacom/DB                                 *                    
Time: 11.25.26      *                                General Utility                               *      Version: 15.1 
                    *               COPYRIGHT (C) 1990-2015 CA.   ALL RIGHTS RESERVED.             *                    
                    ******************************************************************************** Directory: MY15MUF 
                                                                                                                        
                    CONTROL CARD(S)                                                                                     
                    .........1.........2.........3.........4.........5.........6.........7.........8                    
                      DATASCAN DBID=252,OPTION=REBUILD_SPACE_INDEX                                                      
                                                                                                                        
                    FUNCTION=DATASCAN                                                                                   
                       DBID=00252                                                                                       
                       OPTION=REBUILD_SPACE_INDEX                                                                       
                                                                                                                        
Date:  5/19/2021    ********************************************************************************         Page:     9
                    *                                CA Datacom/DB                                 *                    
Time: 11.25.27      *                                General Utility                               *      Version: 15.1 
                    *               COPYRIGHT (C) 1990-2015 CA.   ALL RIGHTS RESERVED.             *                    
                    ******************************************************************************** Directory: MY15MUF 
                                                                                                                        
                    * DBID    252 AREA FCA                   REQUEST COMPLETE                                           
 BLOCKS READ 2,691                                                                                                      

 

Additional Information

For further information about this function, please refer to CA Datacom Core - 15.1 documentation for "DATASCAN OPTION=REBUILD_SPACE_INDEX."

As always, please contact Broadcom support for CA Datacom if you have further questions.