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.