Test Online Processing of a Newly Converted File
Learn how to test online processing of converted files in Datacom VSAM Transparency.
For information about how the
Datacom VSAM Transparency
works, see How Datacom VSAM Transparency Works with Online Processing.Prerequisites to Online Operation
Before attempting to process a given VSAM file through Online
Datacom VSAM Transparency
, ensure that the following prerequisites have been met:
- Define the file toDatacom Datadictionaryas one or moreDatacom/DBtables. For details about creating definitions, see DefiningDatacom/DBTables for Data to be Converted.
- Complete the preparation tasks involving online VIT, online MDT, and URTs as listed in Preparing Transparency Tables for Online Processing.
- Convert the data to aDatacom/DBtable. For details about converting data, see Converting VSAM Files toDatacom/DBTables.
Post-Conversion Tasks
After conversion of a VSAM file, we recommend you perform parallel testing to verify that your programs produce the same results when processing converted tables through the
Datacom VSAM Transparency
as they do when processing the corresponding files in native mode.Prerequisites to Switching between Processing
Review the following prerequisites to switching dynamically between native VSAM processing of a VSAM file and
Datacom VSAM Transparency
processing of the Datacom/DB
tables that are converted from the file:
- The native VSAM file must exist and must be synchronized with the converted tables, that is, the converted table must have had no updates that are not reflected in the source file.
- The JCL statement identifying the VSAM file must be present in the CICS job stream, for example://vsamnm DD DSN=dsname,...
- The CICS File Definition entry for the native VSAM file (or files) must be specified as follows:FILESTAT=(ENABLED,CLOSED)
- The converted file must be defined in the copy of the Online VIT that is loaded.
- At least one User Requirements Table which references the correspondingDatacom/DBtable must be open.
Switch Processing from VSAM to Datacom VSAM Transparency
Datacom VSAM Transparency
Use the following procedure to stop processing a newly converted file through VSAM and begin processing it through
Datacom VSAM Transparency
:
- Verify that the file is defined to the loaded copy of the Online VIT and determine its status by issuing the following command and examining the entry or entries:DVMT INQ=VIT
- Close the VSAM file being switched from by issuing the following CICS command if the sequence number of the entry is preceded by asterisks as shown in the resulting display:CEMT SET FILE(ddname) CLOSE
- Verify that a User Requirements Table referencing the table is in OPEN status by issuing the following command, where aaa is the table name:DBOC INQ=????.aaa
- Open the required User Requirements Table (if it is closed) by issuing the following command, where nnnn is the URT number:DBOC OPEN=nnnn
- Place the file to be tested underDatacom VSAM Transparencycontrol by issuing the following command:DVMT ACT=ddname
Switch Processing from Datacom VSAM Transparency to VSAM
Datacom VSAM Transparency
to VSAMUse the following procedure to switch from processing the converted table to processing the native VSAM file:
- Issue the following command to deactivate the specified file and mark it closed:DVMT DEACT=ddname,FORCE
- Issue the following CICS command to reinvoke native VSAM processing:CEMT SET FILE(ddname) OPEN