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:
  1. Define the file to
    Datacom Datadictionary
    as one or more
    Datacom/DB
    tables. For details about creating definitions, see Defining
    Datacom/DB
    Tables for Data to be Converted
    .
  2. Complete the preparation tasks involving online VIT, online MDT, and URTs as listed in Preparing Transparency Tables for Online Processing.
  3. Convert the data to a
    Datacom/DB
    table. For details about converting data, see Converting VSAM Files to
    Datacom/DB
    Tables
    .

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 corresponding
    Datacom/DB
    table must be open.

Switch Processing from VSAM to
Datacom VSAM Transparency

Use the following procedure to stop processing a newly converted file through VSAM and begin processing it through
Datacom VSAM Transparency
:
  1. 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
  2. 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
  3. 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
  4. Open the required User Requirements Table (if it is closed) by issuing the following command, where nnnn is the URT number:
    DBOC OPEN=nnnn
  5. Place the file to be tested under
    Datacom VSAM Transparency
    control by issuing the following command:
    DVMT ACT=ddname

Switch Processing from
Datacom VSAM Transparency
to VSAM

Use the following procedure to switch from processing the converted table to processing the native VSAM file:
  1. Issue the following command to deactivate the specified file and mark it closed:
    DVMT DEACT=ddname,FORCE
  2. Issue the following CICS command to reinvoke native VSAM processing:
    CEMT SET FILE(ddname) OPEN