RC/Migrator: Toleration messages and RCMTOLR Datasets.
search cancel

RC/Migrator: Toleration messages and RCMTOLR Datasets.

book

Article ID: 11338

calendar_today

Updated On:

Products

RC Compare for DB2 for z/OS RC/Migrator for DB2 for z/OS

Issue/Introduction

During every strategy analysis, CA RC/Migrator™ for DB2 for z/OS checks for DB2 features that are not currently supported. If the product detects an attempt to operate on objects that exploit unsupported features of DB2, warning messages are directed to an output data set named RCMTOLR. If the use of RCMTOLR is not required it can be disabled by customizing the MIGRATOR parmlib member in hlq.CDBAPARM. However, we strongly recommend using RCMTOLR and checking for warning messages generated by the analysis before executing the strategy.

Messages like this will be seen in the Analysis Output:

RMA599I CA RC/MIGRATOR HAS IDENTIFIED ONE OR MORE OBJECTS IN THE 
       SUBSYSTEM WHICH CONTAIN FEATURES NOT CURRENTLY SUPPORTED. 
       MESSAGES FOR EACH OF THE OBJECTS THE PRODUCT CANNOT PROCESS 
       HAVE BEEN DIRECTED TO OUTPUT DD RCMTOLR.       

Contained in the DD RCMTOLR Output dataset a message like this one might be seen about an index for example:
- hlq.RCMTOLR   
RMA608W OBJECT TYPE INDEX WITH CREATOR: authid1                     
        NAME: NEWIX1                                            
        CANNOT BE PROCESSED, NEW FEATURE " Extended indexes "     
        NOT YET SUPPORTED BY CA RC/MIGRATOR.  

In this way , the message can be investigated.                

Is there a flag to turn the RCMTOLR messages off so they are not displayed or written to a dataset?

 

Environment

DB2 for Z/OS

Resolution

There is a hlq.CDBAPARM(MIGRATOR) parameter called TOLRMSGS. This parameter has a YES or NO flag which will either allow or disallow the generation of the messages.

 

TOLRMSGS indicates whether to create the RCMTOLR data set and populate it during analysis. If Y, the RCMTOLR data set is created and populated during analysis. Messages are written about each object that is not yet supported by CA RC/Migrator in the subsystem. This is the default.

If N, the RCMTOLR data set is not created.

The parameter can be found in the header of the MIGRATOR parmlib member and appears like this:

TOLRMSGS (YES)       /* TURN TOLERATION MESSAGES ON
/* OR OFF. SPECIFY NO TO NOT
/* GENERATE THE MESSAGES/DATASET.

This parm can also be added to the MIGRATOR member via the EP(Edit Parmlib Members) function on the main menu.
When editing the MIGRATOR member using EP you will see "Generate toleration msgs?....> Y (Y/N)" as an option to set.

Additional Information

MIGRATOR Parmlib Options

See also technical document :

Allocation options for the RCMTOLR dataset to prevent security violations.

RMA599I