CICS VSAM Transparency for z/OS, Version 1.2


VTMI - subsystem control transaction

When you migrate a VSAM file, you must add it to the CICS® VT DST so that CICS transactions can access the data in DB2®. To activate a change to the table, the CICS VT CICS subsystem must stop and restart. Use the VTMI transaction for this purpose.

Specify one of the following parameters for the VTMI transaction:

STAT
This shows the status of the CICS VT interface.
START
This starts the CICS VT interface.
STOP
This stops the CICS VT interface.
RESTART WARM
This stops and restarts the interface and loads the DST. The migration status of each file changed by the VTMM transaction persists.
RESTART COLD
This stops and restarts the interface and loads the DST. The migration status of all files is reset to the value of MSTATUS in the DST.
To add a new file to the DST, follow these steps:
  1. Add the new file entry to VIDCDTAB.
  2. Assemble the table into the DFHRPL library.
  3. Run the transaction VTMI RESTART to stop and restart the interface. This also issues a NEWCOPY for the new VIDCDTAB module.

If the MSTATUS of the new file is ACT, all calls to this file from CICS programs now access the data in DB2. If the MSTATUS is INACT, calls continue to be processed in VSAM. If you run the VTMI transaction with the STOP keyword, all VSAM calls for all files are processed by CICS.

The DST is explained in full in Adding a new data set to the CICS VT data set table.





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

Information Information

Feedback


Timestamp icon Last updated: Friday, 6 December 2013


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