In order to display the unedited list of media established in the previous option, select Display (unedited) list as report from the Offsite/Onsite functions menu.

A report similar to the one shown below will appear.

4.2.3 Print (unedited) list as report

Next, the Control settings menu shown below will appear.

4.2.4 Review/edit Ext ID list

4.2.5 Mark list as sent offsite

The form shown below will appear.

The definitions of the fields in this form are in the following table.

Data	Description
Onsite location	This designates the onsite location of the media. This can be used to determine where to locate the media when it returns.
Offsite location	This designates the offsite location of the media. This can be used to determine where the media is located when it is sent offsite.
Send date	This designates the date the media is sent offsite.
Return date	This designates the date the media is return onsite.

4.2.6 Mark list as returned onsite

Once a list of media that is to return onsite is established, it may be marked as returned using this option. In order to mark the list of media as returned onsite, select Mark list as returned onsite from the Offsite/Onsite functions menu.

4.3 Generate media list for backups

The Generate media list for backups option is for MANAGERS who are interested in obtaining a list of the media that are required by one or more backup jobs. This is useful if the MANAGER wants a quick way to determine the necessary media to be prepared for daily use.

In order to display or print the media list for backups, select Generate media list for backups from the Manager's express functions menu. The form shown below will appear.

The fields in the form are described in the following table.

Data	Description
Backup job names	The name of the backup job(s) to be selected for display. Wild cards are accepted.
Output file names	The file name to write to if Output to file is chosen.
Display to screen	The list of media will be output to the screen.
Output to file	The list of media will be output to a file.

When the user presses DO, a form will either be displayed on screen or written to a file. A window similar to the following figure will be displayed, if the `Display to screen' option is chosen.

The proper configuration of MEDIA is crucial to the successful and optimal operation of the software. Certain fundamental concepts should be understood before attempting any configuration operations. Knowledge of the handling of queues, types and devices in relation to MEDIA will simplify the configuration process.

Types can be subdivided in any number of ways, but usually are related to the physical characteristics (TK50, RX23 etc.) or the function (USERTAPE for user's tapes, SYSTAPE for system tapes) of the media. Queues are crucial elements of MEDIA that allow media jobs to access devices. Devices in MEDIA are the same as the devices that are you already presently using in your system.

The relationship between queues, types and devices is explained in detail. This section also details many of the more important concepts involved in MEDIA configuration. The most important point to remember is that each type must be referenced by at least one queue and that each device must be referenced by at least one type.

Semi automatic configuration (part of the MCL configuration module) provides a quick way to initially establish queues, types and devices. Through several steps the manager is able to easily set up the relationship between types and devices. The relationship between queues and types is established automatically. All other parameters are left unspecified, which means the intrinsic values are used. The steps are:

1. The DCL command, "SHOW DEVICES" is automatically executed. This builds a list of up to 10 devices which are mounted and accessible from the host to which the manager is logged in.
2. The user enters up to 10 media types and add devices to each type. A queue is automatically generated for each type.
3. The user customizes the settings using MCL forms, if necessary.

Though this chapter deals with the MCL interface, MEDIA configuration can be accomplished using three different methods. While each method performs the same operation (modifying the parameter files), they differ in technique. The methods are:

1. Using MCL menus and forms to configure the system. This method offers several distinct advantages over the other two methods. These advantages are:

   MANAGER is able to choose from a menu or form those parameters that apply to the system.
   The ability to see the current status of the configuration by simply choosing a menu item.
   No need to ever directly interact with the actual file. All changes are made automatically by the program.

2. Using the MEDIAS SET command. This method requires entering manual commands from the DCL command line. This method is described in Section 3.3 of this manual.
3. Manually editing the files using a standard text editor. This method should be attempted only by a MANAGER with complete knowledge of the parameter files and is not recommended otherwise. See Chapter 8 for a detailed description of the parameter file.

The parameter file itself can be split into two pieces. These are:

File	Contents
SYS$MANAGER:MEDIA.VAR	Node specific parameter file.
SYS$COMMON:[SYSMGR]MEDIA2.VAR	Optional cluster common parameter f ile.

The first parameter file is required, the second is optional. If the same parameter is defined in both files the one in MEDIA.VAR will be used. On a cluster system, it is advantageous to put the CPU specific device characteristics in MEDIA.VAR in the CPU specific manager directory, and place all the cluster wide queue definitions in MEDIA2.VAR in the cluster common manager directory.

Once modifications have been made to this file, the server process needs to be restarted to take these changes into account. In order to configure MEDIA,select Configure software from the Media Management menu. You may then choose among Media library, Backup manager and Restoration (VAULT) parameters.

In order to configure MEDIA, choose MEDIA library parameters from the Configuration menu. A menu will appear offering the choice of six aspects of MEDIA that can be configured using the menus and forms.

Figure 5-1 MEDIA settings menu

These are described in the table below.

Category	Description
Controls	This form enables the MANAGER to configure user, allocation and operator controls.
Devices	Selecting devices allows the MANAGER to add, display, modify or delete data pertaining to a device.
Types	This selection enables the MANAGER to create, display, add, remove or delete devices from a certain type.
Queues	Selecting queues allows the MANAGER to create, display, modify or delete a MEDIA queue.
Defaults	The default forms allow the MANAGER to set defaults on type of media, in use media, temporary media and selection controls.
File locations	The file locations form allows the specification of default file locations.

5.2.1 Controls

In order to configure MEDIA controls, choose Controls from the MEDIA settings menu.

A form will appear, giving the user the ability to modify a number of parameters for user, allocation and operator controls.

Fields may be filled with either an "X" or blank (for those fields requiring a positive or negative response), or a number (for those fields requiring a numerical figure). The possible value for each field as well as an explanation of the field is listed below.

5.2.1.1 User controls

Allow device commands to be executed in batch: (X or blank) Determines whether any device commands can be executed in batch mode. Disabling this mode will also disable all batch job commands for general users. Users with OPERATOR privilege can always use the device commands regardless of this setting.Default is "X".
Allow device commands to be executed interactively: (X or blank) Determines whether any device commands can be executed interactively. Users with OPERATOR privilege can always use the device commands regardless of this setting. Default is "X".
Allow INCORE temporary media definition: (X or blank) Determines whether the INCORE temporary medium definition can be used. Default is "X".
Allow general users to add new medium: (X or blank) Controls whether users (not an OPERATOR or a MANAGER can use the ADD command and catalog their own medium into the library. Default is "X".

Unload devices on dismount: (X or blank) If the field is b lank, 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 the field has an "X" it will force all DISMOUNT operations to unload the medium and put the device off-line. A subsequent job that requires this same medium will thus create an OPCOM request to the operator. Default is blank.
Reset server information on an unload: (X or blank) If the field is blank, server information is not updated in case of an unload. If the field has an "X" server information is updated in case of an unload. Default is blank.
Lock all devices for MEDIA use: (X or blank) Controls whether the server process should allocate all the known devices (known devices) and only release them to proper requests from the MEDIA program. This will prevent any user from allocating these devices. Default is blank.
Allocation request timeout in minutes: (Integer) Controls the maximum wait allowed for an allocation request to complete. The default is usually adequate in most cases. In cases where the number of active medium jobs is always equal to the number of available drives, a smaller time out can be used. For situations where queue definitions allow an excess number of active jobs, this number may need to be increased. The same is true on systems where interactive allocations of a drive is allowed. On such systems this number may need to be increased to prevent lengthy interactive allocations from aborting the media batch job. Default is 30 minutes.

Send operator message when a MEDIA job is submitted: (X or blank) Controls whether a message is sent to the operator on submission of tape. Default is blank.
Send operator message when a MEDIA job completes: (X or blank) Controls whether a message is sent to the operator on completion of tape. Default is "X".
Include tape density in message: (X or blank) Controls whether the density of the tape is included in operator messages. Default is "X".
Include tape location in messages: (X or blank) Controls whether the location of the tape is included in operator messages. Default is "X".
Maximum message length: (Integer) Controls the maximum character length an operator message can be. Default is 70 characters.

In order to add, display, modify or delete devices, select Devices from the MEDIA settings menu.

Below is a description of the fields in the form that is displayed when adding, displaying or modifying device data.

Field Name	Description
Device VMS name	Name of device previously entered in dialog box or automatically configured. Read only.
Type of Access	This field is determined by the system and is either DISK(direct access) or TAPE(sequential). Read only.
Device alias	The alias is a descriptive name assigned to a device and used to refer to it.
Device shared by multiple nodes	This flag indicates a device accessible by multiple nodes on a cluster.
Lock this device for MEDIA use	This flag causes the server process to allocate the drive and only release it to a MEDIA ALLOCATE command.
Unload this device on dismount	This flag requests that the device be unloaded whenever the volume is dismounted.
Maximum tape length	Maximum length the specified tape drive can handle. Not set is usual acceptable setting.
Densities supported	Available densities the specified drive can handle. Not set is usual acceptable setting.
Device name synonym list	List of synonyms for specified drive.