Virtual Subsystem (VS)

Command title

Virtual Subsystem

Description

This command specifies the VTS-TSR as the target for all subsequent TBASEV and TBCALLV calls to tableBASE in the region.

COBOL syntax

MOVE 'VS'                   TO xxxx-COMMAND.
CALL 'TBLBASE' USING        TB-PARM
                            xxxx-COMMAND-AREA

C syntax

memcpy( tbCommArea.tbCommand, "VS", 2 );
memcpy( tbParm.tbSubSystem, pSubSystemName, 4 );
TBLBASE( &tbParm, &tbCommArea );

Parameters

VTS-NAME—the name of the VTS-TSR to use (must be a running VTS-TSR)

Explanation

None

Return value

None

Notes

If using the Version 5 TB-PARM and your application is calling tableBASE dynamically, i.e. the tableBASE API is not statically linked into your application, you can override the VS by placing the target VTS name in the TB-PARM.

The VS command will only work for a valid VTS name which is running. If the VTS name supplied is an invalid name or the VTS is not running, a 1072 will be returned and the value in the VTS-NAME parameter remains unchanged.

This command overrides the VTSNAME parameter in TBOPT. The value to which VTS-NAME was set can be retrieved with the LV command.

Exceptions

None

See also

None