1 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'.
2 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.

2 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 /FORCE

 /FORCE
 /NOFORCE

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

2 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.

3 /FORCE

 /FORCE
 /NOFORCE

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

2 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.

3 /FORCE

 /FORCE
 /NOFORCE

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

2 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.

2 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.

2 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.

3 /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.

3 /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.

3 /FORMAT

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

	The following virtual container file formats are supported:

	DEFAULT
	MTD
	LM
	SMA

3 /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.

2 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

2 VERSION

  TAPEMGR VERSION

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

2 HELP

  TAPEMGR HELP [topic]

	This command will allows access to the help file.