Unrecognized, Unknown or Unexpected dataset within CICS DFHRPL concatenation

Question & Answer

Question

Why do I see an unrecognized Library within the DFHRPL concatenation of my CICS Transaction Server for z/OS (CICS TS) region? A CEMT INQUIRE LIBRARY(DFHRPL) command results in the following:

 NQ LIBRARY                            
 RESULT - OVERTYPE TO MODIFY            
   Library(DFHRPL)                      
   Searchpos(0001)                      
   Ranking( 10 )                        
   Numdsnames(009)                      
   Enablestatus( Enabled )              
   Criticalst( Critical )               
   Dsname01(CTS530.CPSM530.SEYULOAD)   
   Dsname02(ATFP.CICS.NULLFILE)        
   Dsname03(USASSC1.CICSR700.TABLIB)   
   Dsname04(USASSC1.CICSR700.P1LIB)    
   Dsname05(CTS530.CICS700.SDFHLOAD)   
   Dsname06(USASSC1.GENAPP.LOAD)

Dataset USASSC1.CICSR700.P1LIB is returned as a member of DFHRPL but my CICS startup JCL does not contain that dataset. Here is my DFHRPL concatenation from my JCL:

 //DFHRPL   DD DISP=SHR,DSN=CTS530.CPSM530.SEYULOAD       
 //         DD DISP=SHR,DSN=ATFP.CICS.NULLFILE            
 //         DD DISP=SHR,DSN=USASSC1.CICSR700.TABLIB       
 //         DD DISP=SHR,DSN=SYS2.CICSR700.TESTLIB
 //         DD DISP=SHR,DSN=CTS530.CICS700.SDFHLOAD       
 //         DD DISP=SHR,DSN=USASSC1.GENAPP.LOAD

I am unable to determine where CICS might be picking up dataset USASSC1.CICSR700.P1LIB.

Answer

Make note of the dataset number (Dsnamexx where "xx" is the number), associated with the dataset in question, within the output from the CEMT INQUIRE LIBRARY(DFHRPL) command. In this instance, the dataset number is "04" in "Dsname04(USASSC1.CICSR700.P1LIB)".

Once you have the position of the dataset, use that information to again review your JCL and determine the dataset that is in the same position. In this instance, the JCL shows SYS2.CICSR700.TESTLIB in the fourth position.

Now go to TSO (3.4) and view the dataset that you saw in the JCL. Likely, you will see the dataset is defined as an "ALIAS" as seen below:

 .    Menu  Options  View  Utilities  Compilers  Help                               .
 .  ssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss  .
 .  DSLIST - Data Sets Matching SYS2.CICSR700.TESTLIB                   Row 1 of 2  .
 .  Command ===>                                                  Scroll ===> CSR   .
 .                                                                                  .
 .  Command - Enter "/" to select action                  Message           Volume  .
 .  ------------------------------------------------------------------------------- .
 .           SYS2.CICSR700.TESTLIB                                          *ALIAS  .
 .  ***************************** End of Data Set list **************************** .

If you browse the dataset, you will notice the Data Set name at the top of the output actually changes to the dataset the ALIAS is related to. In this instance, for example, a browse against dataset SYS2.CICSR700.TESTLIB returns the USASSC1.CICSR700.P1LIB library:

 .    Menu  Functions  Confirm  Utilities  Help                                     .
 .  ssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss  .
 .  BROWSE            USASSC2.CICSR700.P1LIB                Row 0000001 of 0000004  .
 .  Command ===&gt;                                            Scroll ===&gt; CSR   .
 .             Name     Prompt        Alias-of     Size      TTR     AC   AM   RM   .
 .  _________ COBTEST                            00002FE0   000023   00    31  ANY  .
 .  _________ DFHTRAP                            00000250   000107   00    64  ANY  .
 .  _________ DFH0GNT                            00000268   00010F   00    31  ANY  .
 .  _________ READUPDT                           00000240   00001B   00    24   24  .
 .            **End**                                                               .

See Delete an Alias Entry in a Catalog: Example 9 in the z/OS DFSMS documentation if you want to remove the alias from your system.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"Liberty","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICS/TS CICSTS CICS TS CICS Transaction Server

Was this topic helpful?

Document Information

Modified date:
13 November 2017

UID

dwa1412755

Tips