RHDCFSTB: source, assembly and link-edit instructions

Products

• IDMS
• IDMS - Database

Issue/Introduction

There are a number of errors and omissions in the System Operations manual section on how to create a UCF front-end system table, and there is no example in the install libraries. This document gives a sample of how to do this.

Environment

Release: All supported releases.

Resolution

The following is a sample job to create a UCF front-end system table.

//ASMCL     EXEC HLASMCL
//C.SYSLIB  DD DISP=SHR,DSN=<your.zOS.maclib>
//          DD DISP=SHR,DSN=<your.IDMS.maclib>
//C.SYSIN   DD *
         #MOPT CSECT=RHDCFSTB,ENV=USER
         COPY #UCFDS
RHDCFSTB CSECT
FESTABLE #FESTDEF CNT=17
         #FESTENT FESID=CICS
         #FESTENT FESID=CICSBULK,BLKSIZ=4096    CICS DTS access
         #FESTENT FESID=BATCH
         #FESTENT FESID=BATCBULK,BLKSIZ=16384   BATCH DTS access
         #FESTENT FESID=IDMS-DC
         #FESTENT FESID=DCXXBULK,BLKSIZ=4096    DC to DC DTS access
         #FESTENT FESID=TSO
         #FESTENT FESID=TIAM
         #FESTENT FESID=UTM
         #FESTENT FESID=UTMBULK,BLKSIZ=4096     UTM DTS access
         #FESTENT FESID=CMS,BLKSIZ=8016
         #FESTENT FESID=CMSBULK,BLKSIZ=3920     CMS DTS ACCESS
         #FESTENT FESID=IMS
         #FESTENT FESID=INTERCOM
         #FESTENT FESID=SHADOW
         #FESTENT FESID=TASKMSTR
         #FESTENT FESID=WESTI
         END FESTABLE
//L.SYSLMOD  DD DISP=SHR,DSN=<your.IDMS.custom.loadlib>
//L.SYSIN   DD *
 ENTRY FESTABLE
 NAME RHDCFSTB(R)
/*

Note the following differences from the section UCF Back-End.

• There should be a line #MOPT CSECT=RHDCFSTB,ENV=USER at the beginning.
• The value of CNT= should match exactly the number of #FESTENT entries.
• There should be an ENTRY equal to the label on the #FESTDEF clause (in this example, FESTABLE).
• The NAME in the link-edit should match the label on the CSECT and ideally should be RHDCFSTB.

Furthermore, the source above is what is used to create the default RHDCFSTB that is delivered at install/configuration time. If there are any #UCFUFT entries in the #UCFFET which have a SYSTEM= value that is not in the above table, it will be necessary to add a #FESTENT entry with FESID= set to that value, and adjust CNT= in #FESTDEF accordingly.