Connecting a VTS User to a VTS-TSR

There are two methods to identify the VTS-TSRs that you wish to access:

  • Specify the VTS-TSR name in the TB-SUBSYSTEM field of the TB-PARM parameter. This allows you to access that VTS-TSR directly without going through the local TSR. If this field is blank or low-values, the access defaults to the local TSR. This method allows read-write access to the VTS-TSR if the VTS has been started up in read-write mode and read-only access if it has been started up in read-only mode (available only with VTS Gate). This is referred to as direct access.
  • Specify the VTS-TSR names in the library list (LIB-LIST) by issuing the ML command. Instead of supplying a DDNAME in the ML command, use vtsprefix:xxxxxxx where xxxxxxx is the VTS name and vtsprefix is the TBOPT VTSPREFIX parameter in effect. In CICS, the use of the library list applies only for the duration of the transaction for which the ML command is issued.
  • When a table is first opened, the LIB-LIST is searched. If a VTS-TSR name is encountered, the VTS-TSR is searched and if the table is found, a link is established and the table is flagged as being opened-for-read in the local TSR.
  • This method allows read-only access to the VTS-TSR and is referred to as linked access.

There are several parameters (VTSFIRST, VTSLAST, VTSNAME) that can alter the way a VTS-TSR is accessed. These parameters have default values set at the time tableBASE is installed but run-time settings for them may be provided by a TBOPT DD card.

VTSFIRST and VTSLAST provide additional VTS-TSR searches before and after the tableBASE library search sequence. For more information on VTSFIRST and VTSLAST, see Parameters that apply to VTS only.

VTSNAME can be used to specify the default VTS-TSR accessed by the TBCALLV and TBASEV interface stubs. For more information, see VTSNAME—Specifying the Name of a VTS-TSR.