The UNLOAD flag setting requests that the drive be unloaded whenever a volume is dismounted. If the UNLOAD PARAMETER is set to 2 or 3 the server resident information is also reset during the dismount.

After the initial setup use the

MEDIAS> SET/DEVICE MTA0:/LOCK MEDIAS> SET/DEVICE MTA0:/UNLOCK

to change the lock flag.

The UNLOAD parameter, if set to 1, will force all DISMOUNT operations to unload the medium and put the device off-line. The default action for labeled media is to leave them on-line.

Format

UNLOAD = O(D), 1, 2, or 3

Examples

 UNLOAD = 0 
 
      

more

The various settings have the following meanings:

• 0: Do not unload the medium on dismount. With this setting media are left on-line and the next job in the queue will check to see if it requires the use of an already on-line medium. If so the medium will be used without creating a OPCOM request to the operator. If a medium different from the one already on-line is needed it is first unloaded and the operator requested to mount the right one.
• 1: Unload the medium on dismount. With this setting the dismount operation at the end of each job will cause the medium to be unloaded. A subsequent job that requires this same medium will thus create an OPCOM request to the operator.
• 2: Do not unload the medium on dismount, but on an unload, reset the server information. This setting performs all the features of number 0 above, and if the drive is unload either implicitly or explicitly the server information is reset. The server maintains information about what is and was on a drive to allow future jobs to locate where and whether a requested medium is already on a drive. This information is cleared out by this setting.
• 3:This setting performs all the features of number 1 above and resets the server information.

The USER_ADD parameter controls whether users (not an operator or a manager) can use the ADD command and catalog their own medium into the library.

Format

USER_ADD = O (no) or 1 (yes)(D)

Examples

 USER_ADD = 1 
 
      

more

Each medium in the library is identified either as user added or operator added. Each type of medium can only be removed or renamed by user of equal or higher access rights.

The VDISK parameter specifies where to store VAULT information regarding files backed up from a particular disk. Frequently it is convenient to store VAULT information on the same disk as the files that were backed up. The VAULT system creates on ADR file for each on-line directory file.

This parameter will override the logical name VAULT_ddddd.

Format

VDISK_dddd = location

Examples

 VDISK_DISK$128 = DISK$128:[VAULT] 
 VDISK_DISK$SYS = DISK$128:[VAULT.SYS] 
 
      

more

The VAULT sub-system can potentially create a large number of files in the central MEDIA_LIBRARY location. This parameter can be used to partition this into sections and spread the I/O load across several disk drives.

The VLT_CENTRAL parameter is an alternate way of locating the VAULT database files (nnnnnnnn.ADR). If used, it will override the logical name VAULT_LIBRARY.

Format

VLT_CENTRAL = location

Examples

 VLT_CENTRAL = ALPHA"SYSTEM MANAGER"::DBA0:[SYSMGR] 
 
      

more

This can be especially useful in a DECnet environment where the VAULT database is to be shared. This is an easy way to disguise the actual location from the users.

The VLT_KEEP_ERASED parameter controls the processing of erased file headers in the VAULT database. The normal mode (with this parameter equal to "0") is to reclaim and reuse space occupied by erased file headers. Setting this parameter to a "1" will enable system manager to view and modify these erased records. All reclaim and reuse operations are disabled when this parameter is set to a "1".

Format

VLT_KEEP_ERASED = O(D) or 1

Examples

 VLT_KEEP_ERASED = 1 
 
      

more

This parameter is used in the MEDIA_LIBRARY:VAULT_REBUILD.COM procedure to allow a VAULT database verify/comparison to made against the MEDIA database.

The procedure to do this comparison and implemented in the above mentioned command procedure is as follows:

1. Enable processing of erased records by setting the VLT_KEEP_ERASED parameter to "1".
2. Mark all files in the VAULT database as erase via the command VAULT/DELETE/ERASE.
3. Reverse out the erased mark for all files found in the MEDIA database via the command VAULT/ADD/UNERASE. All entries in the database that were not found in the MEDIA database will remain as erased.
4. Disable processing of erased records and let the system reclaim the space.

For more information please printout the above command file.

The purpose of this procedure is to identify what media are OFFSITE, when media should be sent OFFSITE and when media should be returned ONSITE. The location of individual media is determined by examining the status flag OFFSITE and the date fields SEND_DATE, DURATION and RETURN_DATE.

A.1.1 At the end of each MEDIA BACKUP job

At the end of each BACKUP job, all the media used are marked indicating what date they are to be shipped OFFSITE, and how long they are to stay there. This is done using the FIND and SEND option.

• Define the OS command

  $ OS := @MEDIA_LIBRARY:OFFSITE_STORAGE

• Locate the current volume set

  $ OS FIND 'MEDIA_EXT' 'JOB_NAME' MEDIA_SET

• Mark that volume set to be shipped offsite in 7 days and to stay there 14 days.

  $ OS SEND 'MEDIA_SET' TODAY+7-00 14-00

At the end of each MEDIA job for which the media are to be sent offsite, use the SEND option to indicate when they are to be shipped and how long they are to stay there.

• Mark the current volume to be shipped offsite in 7 days and to stay there 14 days.

  $ OS SEND 'MEDIA_EXT' TODAY+7-00 14-00

To determine what media to send offsite on a particular day use the REPORT SEND option. Once the media have been sent, all the media can be marked as offsite at a particular location by using the MARK OFFSITE option.

• To print out all the media that are to be sent offsite in a 132 column format on the system printer.

  $ OS REPORT SEND 132 PRINTER

  
  

• To mark all these media as having been sent offsite and stored in "WAREHOUSE".

  $ OS MARK OFFSITE TODAY WAREHOUSE

  
  

A sample of the type of report generated for the SEND option follows:

ISE, Inc. ISE, Inc. MEDIA V4.0 July 12, 1996, 22:14 Media to send offsite Page 1 sorted by location (MEDIA_OPER_OST_SEND_80) Location External Type Alias Return Store for Label category on days Tape library 9000 TAPE INCREMENTAL;87 1/Aug/96 30 9001 TAPE INCREMENTAL;88 2/Aug/96 30 9002 TAPE MISC_SOFTWARE;1 Not set Not set 9901 TK50 ARCHIVE_ZZ0010;1 Not set Not set

A.1.4 Returning media onsite

• To print out all the media that are to be returned onsite in a 132 column format on the system printer.

  $ OS REPORT RETURN 132 PRINTER

• To mark all these media as having been sent offsite and stored in "LIBRARY".

  $ OS MARK ONSITE TODAY LIBRARY

A sample of the type of report generated for the RETURN option follows:

ISE, Inc. ISE, Inc. MEDIA V4.0 July 12, 1996, 22:14 Media to return onsite Page 1 sorted by location (MEDIA_OPER_OST_RETURN_80) Location External Type Alias Sent Label category on Warehouse 3B 9604 TAPE INCREMENTAL;12 10/Jun/96 9605 TAPE INCREMENTAL;13 11/Jun/96 9606 TAPE INCREMENTAL;14 12/Jun/96 9101 TAPE ARCHIVE_XX0101;1 20/Apr/96 9609 TAPE 9609;0 11/Jul/96 9610 TAPE 9610;0 11/Jul/96

A.1.5 Listing media offsite

To determine what media are offsite and at what location, use the REPORT OFFSITE option.

• To print out all the media that are offsite in a 132 column format on the system printer, use the command:

  $ OS REPORT OFFSITE 132 PRINTER

• To print out all the media that are onsite in a 132 column format on the system printer, use the command:

  $ OS REPORT ONSITE 132 PRINTER

A sample report generated for the OFFSITE option follows:

ISE, Inc. ISE, Inc. MEDIA V4.0 July 12, 1996, 22:13 Summary of Page 1 all OFFSITE MEDIA sorted by location (MEDIA_OPER_OST_OFFSITE_80) Location External Type Alias Sent Return Label category on on Warehouse 3B 1821 TAPE IMSL;1 3/Jul/96 Not set 1851 TAPE ARCHIVE_YA0010;1 1/Jun/96 Not set 9604 TAPE INCREMENTAL;96 1/Jul/96 1/Aug/96 9605 TAPE INCREMENTAL;91 5/Jul/96 5/Aug/96 9606 TAPE 9606;0 11/Jul/96 12/Sep/96 9609 TAPE 9609;0 11/Jul/96 12/Sep/96 9610 TAPE 9610;0 11/Jul/96 12/Sep/96

A sample report generated for the ONSITE option follows:

ISE, Inc. ISE, Inc. MEDIA V4.0 July 12, 1996, 22:14 Summary of Page 1 all ONSITE MEDIA sorted by location (MEDIA_OPER_OST_ONSITE_80) Location External Type Alias Send Returned Label category on on File Cabinet 114087 TK50 WORD11_V43;1 1/Jan/91 1/Jun/96 34981653 TAPE ALISA_EASYLINK;1 10/Sep/96 Not set 846974 TK50 WORD11_V43_FONTS;1 1/Jan/91 Not set AQJP22DB TK50 VMS052_DIST;1 20/Jul/96 1/Jul/96 AQNH24AB TK50 VMS052_SABCKUP;1 20/Jul/96 1/Jul/96 AQNJ58AB TK50 VMS052_MUP;1 20/Jul/96 1/Jul/96 Tape library 1800 TAPE INCREMENTAL;336 30/Jul/96 Not set 1801 TAPE 1801;0 Not set Not set 1802 TAPE 1802;0 Not set Not set 1803 TAPE INCREMENTAL;332 11/Aug/96 Not set 1804 TAPE 1804;0 5/Dec/96 3/Mar/96 1805 TAPE PERMANENT_YB0000;1 11/Jul/96 Not set 1806 TAPE VMS044_45_BIG;1 20/Jul/96 1/Jul/96 1807 TAPE PERMANENT_YA0000;1 11/Jul/96 Not set 9600 TAPE 9600;0 Not set Not set 9601 TAPE 9601;0 Not set Not set

A.1.6 Activating this procedure

The following format is used to activate this procedure

$ @OFFSITE_STORAGE FUNCTION PARAMETERS

Where the functions are:

Function	Parameters			Description
MENU	none			Display a menu of functions
HELP	none			Display summary of all functions
SEND	m	o	d	Mark media to be sent offsite
Key to SEND function parameters
	m - list of media to modify
	o - date to move media offsite
	d - duration of stay offsite
RETURN	m	r		Mark media to be returned onsite
Key to RETURN function parameters
	m - list of media to modify
	r - date to move media onsite
FIND	x	j	v	Locate backup volume set
Key to FIND function parameters
	x - external id. of master medium
	j - job name in BCKMGR
	v - return DCL variable name
REPORT	n	w	o	Generate report
Key to REPORT function parameters
	n - name of report OFFSITE, ONSITE, SEND or RETURN
	w - width of report 80 OR 132
	o - output(TT = to terminal), PRINTER = to print queue, FILE_NAME = put into a file,BATCH = generate in batch and print
MARK	c	m	l	Mark media as on/offsite
Key to MARK function parameters
	c - current location ONSITE or OFFSITE
	m - list of media to modify (TODAY = use from report)
	l - new location (blank = causes a query)