Display Status and Options

Learn how to inquire about the status of the system with Datacom VSAM Transparency.
Online
Datacom VSAM Transparency
provides three DVMT commands with which you can make inquiries into the status of the system. The following sections describe these commands.

Display Status of
Datacom VSAM Transparency

Use the following command to determine the status of
Datacom VSAM Transparency
:
►►─ DVMT INQ= ─┬─ STATUS ─┬────────────────────────────────────────►◄ └─ STATS ──┘
DVMT
Invokes the
Datacom VSAM Transparency
Maintenance Transaction.
INQ=STATUS or INQ=STATS
Displays the status of Online
Datacom VSAM Transparency
and, if applicable, up to three of its options.

Command Results

Online
Datacom VSAM Transparency
responds with messages concerning the status. An example follows:
DVMT INQ=STATUS DVX0003I ONLINE VSAM TRANSPARENCY IS ACTIVATED DVX0021I MDB=YES IS IN-USE DVX0024I CSP=YES IS IN-USE DVX0018I TRANSACTION COMPLETED
DVX0003I
The first message indicates the status of Online
Datacom VSAM Transparency
. The displayed message indicates that
Datacom VSAM Transparency
has been activated, either manually or automatically.
Other messages that could appear instead include:
DVX0034I ONLINE VSAM TRANSPARENCY IS UNAVAILABLE
This message indicates that
Datacom VSAM Transparency
was not activated automatically at CICS startup and has not been manually activated.
DVX0004I ONLINE VSAM TRANSPARENCY IS DEACTIVATED
This message indicates that
Datacom VSAM Transparency
has been explicitly deactivated using the following command:
DVMT DEACT=$CAVT
DVX0021I
This message indicates that
MDB=
YES
is specified in the Online VIT. If the Online Multiple
Datacom/DB
Table (DVMDTPR) does not exist, this message does not appear.
DVX0024I
This message indicates that
CSP=
YES
is defined in the Online VIT and Cross-System Product support is available. If CSP support is not available, this message does not appear.

Display Online VSAM Interface Table or Selected Entries

Datacom VSAM Transparency
uses the VSAM Interface Table (DVVXTPR) you built to determine how to route intercepted VSAM requests and how to translate the requests to converted tables to
Datacom/DB
requests.

Display Online VIT Definitions of All Converted Files

Invoke the following
Datacom VSAM Transparency
transaction to display parameter values for all files that are defined to the Online VSAM Interface Table:
►►─ DVMT INQ=VIT ──────────────────────────────────────────────►◄
DVMT
Invokes the
Datacom VSAM Transparency
Maintenance Transaction.
INQ=VIT
Requests display of current values for Online VIT options.

Command Results

Sample Screen Display of Online VIT
DVMT INQ=VIT ONLINE CA-DATACOM/VSAM TRANSPARENCY INTERFACE TABLE (DVVXTPR) ITEM VSAMNM/ DBFILE DBID ELIST RKNAME RKLEN RKP VRECDLN AIXDUP CSP MDB RECFM BDDNAME 1 CUSTMR CUS 10 FULL IDNO 5 0 153 N/A NO NO FIX 2 CUSTMR1 CUS 10 FULL NAME 30 5 153 YES NO NO FIX CUSTMR ***3 BILLING BLC 400 BLCEL BLAKY 6 0 563 N/A NO YES VAR ***4 PARTMST PMR 112 PMREL PMKEY 10 0 428 N/A NO YES VAR DVX0018I TRANSACTION COMPLETED.
Asterisks preceding a sequence number (under the ITEM heading) indicate that the file is not currently under
Datacom VSAM Transparency
control, that is, it is marked for native VSAM processing. An R preceding sequence numbers indicates utilization of CICS function shipping and that this file is a remote resource to this CICS system. Issue
DVMT INQ=VIT
from the resource owning region to determine the transparency status of this file. Files that are marked for
Datacom VSAM Transparency
processing must be defined in CICS as follows:
FILESTAT=(ENABLED,CLOSED)

Field Descriptions

Each numbered item corresponds to a base cluster or path that is defined to the Online VSAM Interface Table (VIT) using a
DBVXFIL
macro. Except for RECFM, which is derived from the CICS file definition, the displayed data is derived from parameters that are specified in
Datacom VSAM Transparency
's
DBVXFIL
macro that is described in Code the DBVXFIL Macro.
Field
Description
ITEM
Sequence number
VSAMNMBDDNAME
DDname for the VSAM fileor (if path) the DDname of associated base cluster
DBFILE
Datacom/DB
table to which the named VSAM file was converted
DBID
Datacom/DB
database ID containing the named table
ELIST
First or only element name that is specified for program access
RKNAME
Datacom/DB
key name
RKLEN
Length of the VSAM key
RKP
Location of the VSAM key relative to zero
VRECDLN
Length of the largest VSAM record
AIXDUP
If path, whether its key allows duplicates (YES) or its key is UNIQUE (NO)
CSP
Whether support is requested for IBM's Cross System Product
MDB
Whether a file was converted to multiple
Datacom/DB
tables based on criteria defined in DVMDTPR, the Online Multiple
Datacom/DB
Table
RECFM
Record format as specified in the CICS file definition, where FIX represents fixed-length and VAR represents variable-length

Display Online VIT Definitions of Selected Converted Files

Invoke the following
Datacom VSAM Transparency
transaction to display parameter values for selected files that are defined to the Online VSAM Interface Table:
┌──────────┐ ►►─ DVMT INQ= ─▼─
ddname
─┴───────────────────────────────────►◄
DVMT
Invokes the
Datacom VSAM Transparency
Maintenance Transaction.
INQ=ddname
Requests display of current values for Online VIT options for the specified base clusters and/or paths.

Command Results

DVMT INQ=CUSTMR,CUSTMR1 ONLINE CA-DATACOM/VSAM TRANSPARENCY INTERFACE TABLE (DVVXTPR) ITEM VSAMNM/ DBFILE DBID ELIST RKNAME RKLEN RKP VRECDLN AIXDUP CSP MDB RECFM BDDNAME 1 CUSTMR CUS 10 FULL IDNO 5 0 153 N/A NO NO FIX 2 CUSTMR1 CUS 10 FULL NAME 30 5 153 YES NO NO FIX CUSTMR DVX0018I TRANSACTION COMPLETED.