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
Datacom VSAM Transparency
Use the following command to determine the status of
Datacom VSAM Transparency
:
►►─ DVMT INQ= ─┬─ STATUS ─┬────────────────────────────────────────►◄ └─ STATS ──┘
- DVMT
- Invokes theDatacom VSAM TransparencyMaintenance Transaction.
- INQ=STATUS or INQ=STATS
- Displays the status of OnlineDatacom VSAM Transparencyand, 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 OnlineDatacom VSAM Transparency. The displayed message indicates thatDatacom VSAM Transparencyhas been activated, either manually or automatically.
Other messages that could appear instead include:
- DVX0034I ONLINE VSAM TRANSPARENCY IS UNAVAILABLE
- This message indicates thatDatacom VSAM Transparencywas not activated automatically at CICS startup and has not been manually activated.
- DVX0004I ONLINE VSAM TRANSPARENCY IS DEACTIVATED
- This message indicates thatDatacom VSAM Transparencyhas been explicitly deactivated using the following command:DVMT DEACT=$CAVT
- DVX0021I
- This message indicates thatMDB=YESis specified in the Online VIT. If the Online MultipleDatacom/DBTable (DVMDTPR) does not exist, this message does not appear.
- DVX0024I
- This message indicates thatCSP=YESis 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 theDatacom VSAM TransparencyMaintenance 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 theDatacom VSAM TransparencyMaintenance 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.