CICS VSAM Transparency for z/OS, Version 1.2


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

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:

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.
Start of change RECORDF= FIX|VAR End of change
Start of change The format of the record. Possible values are as follows:
FIX
Fixed length EXEC CICS file control calls.
VAR
Start of change 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. End of change
End of change
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.





Last updated: December 6, 2013 20:43:2

Information Information

Feedback


Timestamp icon Last updated: Friday, 6 December 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///topics/cvtug_add_datasettable.html