List VTS Settings (LV)

Command title

List VTS Settings

Description

The command provides VTS-TSR information from tableBASE.

COBOL syntax

MOVE 'LV'                   TO xxxx-COMMAND
CALL 'TBLBASE' USING        TB-PARM
                            xxxx-COMMAND-AREA
                            VTS-DATA

C syntax

memcpy( tbCommArea.tbCommand, "LV", 2 );
TBLBASE( &tbParm, &tbCommArea, &tbVtsData);

Parameters

VTS-DATA

Explanation

The VTS settings for the VTS name provided in the TB-PARM are stored in the VTS-DATA parameter and are mostly obtained from the TBOPT settings except for VTS-GENERATION. They include:

  • VTSFIRST—the name of the VTS-TSR that is to be searched for tables before searching any libraries listed in the tableBASE library-list
  • VTSLAST—the name of the VTS-TSR that is to be searched for tables after searching any libraries listed in the tableBASE library-list
  • VTSNAME—the name of the VTS-TSR region to be accessed by TBCALLV and TBASEV interfaces
  • VTS-TSRACCESS—the type of access that is available for this VTS-TSR. This value is returned if LV is executed with the name of a running VTS-TSR in the TB-SUBSYSTEM field of the TB-PARM.
  • VTS-RACF-VTS—whether this VTS-TSR is SAF protected. This value is returned if LV is executed with the name of a running VTS-TSR in the TB-SUBSYSTEM field of the TB-PARM.
  • VTS-TSR-KEY-PROTECT—whether this VTS-TSR is hardware key-protected. This value is returned if LV is executed with the name of a running VTS-TSR in the TB-SUBSYSTEM field of the TB-PARM.
  • VTS-GENERATION—the generation number of the VTS-TSR. This value is returned if LV is executed with the name of a running VTS-TSR in the TB-SUBSYSTEM field of the TB-PARM.
  • VTS-PREFIX—the prefix characters used to designate a VTS, when a VTS is to be included in the ML search order list.

Return value

None

Notes

This command is available from user-written applications as well as from DK1TDRV (TBDRIVER) or DK1TDRVC (TBDRIVC).

Exceptions

None

See also

For more information on VTS TBOPT fields, see tableBASE run-time options.