TBOPT parameters

The TBOPT DDNAME is used to set execution-time parameters that override the defaults defined in the VTS install process. For detailed descriptions of these parameters, see tableBASE run-time options.

The parameters that you may wish to change are:

  1. VTSNAME=xxxxxxxx where xxxxxxxx is the one to eight character name used to identify the VTS-TSR created by this VTS Agent. VTS users use this name to make a logical connection to the VTS Agent. It must be unique for each VTS-TSR created within a single MVS image. The default value is DKL1.
  2. TSRSIZE=nnnnnnn (this replaces the Version 5 VTSSIZE parameter). nnnnnnn specifies the amount of virtual storage (Data Space size) to be allocated for this VTS-TSR. It needs to be large enough to contain all open tables and control information for this VTS-TSR. The delivered default is 10M. For format details, see TSRSIZE—tableSPACE Region Size.
  3. MAXNMTAB=nnnnn (VTSNMTAB is supported for compatibility with Release 5.2.). This number allows you to limit the number of tables opened in this VTS-TSR in order to reduce the overhead of the open table index constructed in the TSR. Attempts to open more tables will receive an error. The default is calculated to be the maximum number of tables that could possibly be opened in the TSR.
  4. STROBE=nnnnnnnnnn which specifies the interval after which to collect VTS-TSR usage data. This information will be collected and reported if STROBE is set to a non-zero value. If the value is set too low this may result in a large amount of strobe output which may exceed the installation maximum for job output. The default is 0, which results in no usage data being collected. Starting with Version 7, this option is used in conjunction with STROBEMETHOD (see STROBEMETHOD).
  5. STROBEMETHOD=n which is new with Version 7. This option is used in conjunction with STROBE (see STROBE). If n is 0, 1 or 2, STROBE specifies the call count after which to collect VTS-TSR usage data. If n is 3, STROBE specifies the number of minutes after which to collect VTS-TSR usage data. The default is 0.
  6. SWITCHES=xxxxxxxx which are one-byte codes that are employed to alter the operation of the tableBASE interface used by your programs. Applications using the TBCALLV or TBASEV interfaces may wish to override existing Status Switches at run-time. For more detail, see the tableBASE Programming Guide section on “VTS User access” under “Environmental interfaces”.