TAPEMGR$HELP.HLB  —  TAPEMGR
 	The vtAlpha emulator allows several parameters to be specified for
 	logical tape devices. The TAPEMGR utility can be used to create,
 	delete or change container files, and to select the format used
 	to read or write these files.

 	The utility needs OPER and CMKRNL privileges (except for the HELP
 	and VERSION commands).

 	This utility can also be activated with the command 'AVTAPEMGR'.

1  –  Author 

 	(C) 2013,2023, Advanced Virtualization Technologies
 	www.avtware.com

 	For any issues please email support@avtware.com

2  –  CREATE 

   TAPEMGR CREATE filespec

 	This command will create a virtual tape container file. The filespec
 	must include a full path in unix style (for example
 	"/files/tape.vtape"). The string must be enclosed in quotes. The path
 	must be on a mounted device that is not the system device. If
 	subdirectories are specified then they will automatically be created.

3  –  DELETE 

   TAPEMGR DELETE filespec

 	This command will delete a virtual tape container file. The filespec
 	must include a full path in unix style (for example
 	"/files/tape.vtape"). The string must be enclosed in quotes. The path
 	must be on a mounted device that is not the system device.

 	Wildcards may be specified allowing file and directory deletion
 	in one command. Note that if a wildcard is specified and the result
 	would be deletion of multiple files or non-empty directories then
 	you must speficy /FORCE for the command to proceed. This is a safety
 	feature to prevent unwanted deletion of files.

 	Wildcards are normal posix regular expressions like *, ?, [1-4], etc.

3.1    /FORCE 

  /FORCE
  /NOFORCE

 	If this qualifier is present then wildcard file deletion will be
 	allowed.

4  –  COPY 

   TAPEMGR COPY source_filespec destination_filespec

 	This command will copy a virtual tape container file. The filespecs
 	must include a full path in unix style (for example
 	"/files/tape.vtape"). The string must be enclosed in quotes. The path
 	must be on a mounted device that is not the system device.

 	If the destination ends with a / or if the destination is an existing
 	directory then then the source filename will be	appended to the
 	destination filespec.

 	The destination directory will be created if it is not present.

 	If the destination file is already present it will not be overwritten
 	unless /FORCE is specified.

4.1    /FORCE 

  /FORCE
  /NOFORCE

 	If this qualifier is present then it allows an existing destination
 	file to be overwritten.

5  –  MOVE 

   TAPEMGR MOVE source_filespec destination_filespec

 	This command will move a virtual tape container file. The filespecs
 	must include a full path in unix style (for example
 	"/files/tape.vtape"). The string must be enclosed in quotes. The path
 	must be on a mounted device that is not the system device.

 	If the destination ends with a / or if the destination is an existing
 	directory then then the source filename will be	appended to the
 	destination filespec.

 	The destination directory will be created if it is not present.

 	If the destination file is already present it will not be overwritten
 	unless /FORCE is specified.

5.1    /FORCE 

  /FORCE
  /NOFORCE

 	If this qualifier is present then it allows an existing destination
 	file to be overwritten.

6  –  LOAD 

   TAPEMGR LOAD device [filespec]

 	This command will load a virtual tape container file. The filespec
 	must include a full path in unix style (for example
 	"/files/tape.vtape"). The string must be enclosed in quotes. The path
 	must be on a mounted device that is not the system device.

 	If no filespec is given then the file as specified in the emulator's
 	configuration file will be used.

 	The tapeunit may not be mounted for this operation to succeed.

7  –  UNLOAD 

   TAPEMGR UNLOAD device

 	This command will unload the specified container file in the specified
 	tape device.

 	The tapeunit may not be mounted for this operation to succeed.

8  –  SET 

   TAPEMGR SET device

 	This command allows selection of the used tape format for the specified
 	device. It also allows setting autoload compress and the maximum file size.

8.1    /AUTOLOAD 

  /AUTOLOAD
  /NOAUTOLOAD

 	If this qualifier is present then the tape will automatically be loaded
 	and be ready for use. If /NOAUTOLOAD is specified then the tape will
 	not be automatically loaded and needs to be loaded with the TAPEMGR LOAD
 	command.

 	Do not use autoloading with multi-volume backups or small container files
 	since they will be overwritten when a volume switch is needed.

8.2    /COMPRESS 

  /COMPRESS
  /NOCOMPRESS

 	If this qualifier is present then records will be compressed while written
 	to the tape. If /NOCOMPRESS is specified compression will be disabled.

 	Compression status must be set before the tape is initialized.

8.3    /FORMAT 

  /FORMAT=(DEFAULT,MTD,SMA,LM)

 	The following virtual container file formats are supported:

 	DEFAULT
 	MTD
 	LM
 	SMA

8.4    /MAXIMUMSIZE 

  /MAXIMUMSIZE=xxx

 	This qualifier allow specification of the maximum container file size
 	in megabytes. Once this size is reached the virtual drive will return
 	a 'tape full' status which allow a volume switch.

9  –  SHOW 

   TAPEMGR SHOW device

 	This command will show information for the specified device. Example:

 	$ TAPEMGR SHOW MKA0:
 	%TAPEMGR-I-INFO, _MKA0: file=/files/tape.vtape format=default maximumsize=unlimited autoload=yes status=unloaded

10  –  VERSION 

   TAPEMGR VERSION

 	This command will show the current version of the tapemanager utility.

11  –  HELP 

   TAPEMGR HELP [topic]

 	This command will allows access to the help file.
Close Help