CICS VSAM Transparency for z/OS, Version 1.2


DIM names for alternate indexes

The automated mapping facility generates DIMs and DDMs for each alternate index path. The module names use the first four characters of the base cluster DIM name, followed by X01 for the first alternate index DIM, X02 for the second and so on.

Start of change CICS VT allocates DIM names for alternate index paths in the same sequence that the paths were defined to VSAM. For example, consider the following extract from the list catalog command for the base cluster VID.VIDKSDS:
ASSOCIATIONS               
   DATA-----VID.VIDKSDS.DATA     
   INDEX----VID.VIDKSDS.DATA.INDEX    
   AIX------VID.VIDKSDS.DATA.ZIP     
   AIX------VID.VIDKSDS.DATA.NAME     
   AIX------VID.VIDKSDS.DATA.ADDRESS
There are three paths defined for this data set. The list catalog command shows these in the order that they were defined. If the DIM name for the base cluster is VIDKSDS, the DIM names generated for the alternate index paths are as follows:
Name Function
VIDKX01 The DIM for the ZIP path.
VIDKX02 The DIM for the NAME path.
VIDKX03 The DIM for the ADDRESS path.
End of change

If two base cluster DIMs have the same first four characters and have alternate indexes, SQL code -803 occurs in the PATHMAP step. In this case, choose an alternative DIM name.

Start of changeThere are two methods for choosing an alternate index DIM name: End of change

  1. The first method uses the VIDMAIX REXX exit. You develop this exit to override the default DIM name generated by automated mapping for alternate indexes.
  2. The second method requires the following actions:
    1. Use the SAVE command, which preserves a copy of the mapping JCL in a data set that you can modify.
    2. Modify the PATHNAME parameter in the generated data set prefix.VID.ISPAIX and specify the new AIX DIM name.
    3. Modify the generated data set prefix.VID.dim-name , where dim-name is the base cluster DIM name, and change all occurrences of the default AIX DIM name to the new DIM name.

Read Automated mapping commands for information on the SAVE command.





Last updated: May 25, 2012 20:44:21