Adding a new data set to the CICS VT data set table

Edit online

The CICS® VT DST module name is VIDCDTAB. A version containing a definition for the sample data set VIDKSDS is available in VID.SVIDLODE. The macro source for this module is included as member VIDCDTAB in VID.SVIDCNFG. The JCL to assemble the macro source DST is member VIDGDTAB in my.SVIDCNFG.custom.

If you use the data migration generation utility, the member VID9DST in the generated appl.dimname.migrate library has the appropriate macro statements to add the base cluster DIM to the DST. You must code the macro statements manually for alternate index DIMs. If you don't use the data migration generation facility, you must code the DIM and alternate index macro statements manually.

The VIDCTAB source contains multiple occurrences of the CICS VT macro VIDTAB. Each occurrence is qualified with a TYPE parameter specifying one of three potential values:

The first occurrence of the VIDTAB macro must be TYPE=INITIAL.
There are multiple VIDTAB occurrences of TYPE=ENTRY, one for each migrated VSAM file.
The last occurrence of the VIDTAB macro must be TYPE=FINAL.

Sample DST source can be found in my.SVIDSAMP.custom member VIDCDTAB.

Add a TYPE=ENTRY statement for each migrated data set to enable access from CICS programs. The parameters for the TYPE=ENTRY statement are as follows:

FILE= filename

The name used to define the file to CICS in the CSD.

DIM= dimname

The name of the CICS VT DIM module. This can be the same name as the FILE parameter value.

STATUS= ENA|DIS|UNE

The initial status of the file. Possible values are as follows:

ENA: The file is ENABLED. The file can be opened using a SET FILE OPEN command, or implicitly by CICS when it is next referenced.
DIS: The file is DISABLED. The file cannot be opened unless it is first enabled.
UNE: The file is UNENABLED. The file cannot be opened implicitly by CICS when it is next referenced. It can be opened by issuing the SET FILE OPEN command.

See the CICS Resource Definition Guide for an explanation of these parameter values.

MSTATUS= ACT|INACT

The file migration status. Possible values are as follows:

ACT: The file is migrated and data access is DB2®.
INACT: The file is not migrated and data access is VSAM.

OPEN= S|F

The time when the file is opened. Possible values are as follows:

S: The file is opened at CICS startup.
F: The file is opened at first access.

ADD= NO|YES

Whether new records can be added or not.

BRO= NO|YES

Whether the file can be browsed.

DEL= NO|YES

Whether records can be deleted.

REA= NO|YES

Whether the file can be read.

UPD= NO|YES

Whether the file can be updated.

RESET= NO|YES

If the VSAM file is defined with the REUSE attribute, specify YES. Otherwise specify NO.

RECORDF= FIX|VAR

The format of the record. Possible values are as follows:

FIX: Fixed length EXEC CICS file control calls.
VAR: Variable length EXEC CICS file control calls. Specify RECORDF=VAR if you mapped the file as varying length otherwise a LENGERR error is returned when the file is accessed by your application.

ERRORACT= ABEND |REPORT

The action to take if DMF detects a difference. Possible values are as follows:

ABEND: The transaction abends. If the data area is different, the abend code is 3139. If the return code or reason code is different, the abend is 3141.
REPORT: Error details are written to the VIDCOMP DD statement and the transaction continues.

DUMP= NO |YES

When the ERRORACT parameter value is ABEND , use this parameter to indicate if a dump is required.

Model the parameter values for the CICS VT DST entry on the parameters of the file as it is defined in CICS .

After you have added a new entry, assemble the CICS VT DST with the VIDGDTAB member into a library that is part of the CICS DFHRPL concatenation. Ideally, this should be the same library that you use for your CICS VT driver modules. You must add entries for the base cluster and alternate index data sets.