Adding Virtual Tape Links via TCL

Perform this procedure to define a virtual tape link independent of the Server tab (Administration Utility). Actions are required at both ends of the link. In the case that remote systems comprise both ends of the link, one user at each system may be required. Note that the file name for the VTL is created with this procedure, not selected.

NOTE	If you define a VTL at TCL rather than with the Server tab of the Administration Utility, the Server will not retain the configuration of the VTL upon shutdown unless you include that VTL in the USER-COLD-START Proc. mvBase must be installed on all systems associated with the VTL.

Determine the status of virtual tape devices on each mvBase Server system associated with the link. Issue the T-STATUS command at TCL. This command lists all LTUs and identifies those previously configured as virtual (V) tape devices.
Determine the role for each of the two associated LTUs. One LTU must function as the write (send) device, and the other LTU must function as the read (receive) device.
On each end of the link, issue T-SELECT for an available LTU of type V (virtual).
For the LTU write device selected in Step 3, define this side of the link using this command syntax:

Format

SET-TAPEFILE \\.\pipe\pipename

Parameter(s)

. (dot)	The period denotes the local system as being the system on which this write device is to be established.
pipe	Required element which applies this command line to the VTL defined as pipename.
pipename	Name of the virtual tape link. Use alphanumeric characters with no spaces.

For the LTU read device selected in Step 3, define this side of the link using this command syntax:

Format

SET-TAPEFILE \\system\pipe\pipename

Parameter(s)

system	Computer name of the destination system on the reading (receiving) end of the VTL. This must be a valid Windows computer name.
pipe	Required element which applies this command line to the VTL defined as pipename.
pipename	Pipename that identifies this virtual tape link. This must be the same pipename as that which is defined on the writing (sending) side of this VTL.

Use the T-STATUS command to verify that the link name (pipename), which is a file associated with the LTU, is correct.

The VTL is now configured on both sides of the link and is ready for attaching. The VTL must be attached prior to data transfer.

NOTE	Once you define an mvBase tape unit of any type, mvBase considers that unit to be a tape device, hence you must use T-SELECT, T-ONLINE, T-REW and other tape-related commands in the customary sequence in order to perform normal tape device functions.