After creating a list of media, the next step is to create a template record for the media in the list. The template is, in effect a `dummy record' that the media in the list will be based on. The characteristics of the template record can later be copied, either completely or partially to the list of media.

In order to add a new template record, select Add new template record from the Modify MULTIPLE media menu. A dialog box will appear requesting the External ID of the template record.

Following the dialog box, a menu of available media types will appear. This will be the type of the template record. Some choices are listed in the figure below.

If the desired type is not listed, ask your MANAGER to add it to the list.

At this point, the user will be presented with a form requesting further information on the template record. The system defaults are displayed, but may be edited for the template.

7.11.2 Enter template record name

In order to review and/or edit the record fields that are associated with the template record, select Review/edit template record fields from the Modify MULTIPLE media menu. The menu shown below appears on the screen.

The choices in the Select record area menu provide a variety of forms. See section Section 7.2 for a description of fields used to modify the Media database. See sections Section 7.3.5.1 through Section 7.3.5.5 for information on modifying the record fields.

7.11.4 Select Physical data fields

This option allows the user to choose the physical data fields that will be copied from the template record to the list of media. This allows the user to modify only select fields and leave the remaining fields intact. In order to select the physical data fields, choose Select Physical data fields from the Modify MULTIPLE media menu. The form shown below will appear. See Section 7.2 at beginning of chapter for a description of fields.

This option allows the user to choose the Dates, Flags & Counts that will be copied from the template record to the list of media. In order to select the physical data fields, choose Select Dates, Flags & Counts from the Modify MULTIPLE media menu. The form shown below will appear.

7.11.6 MODIFY selected header fields

In order to modify all the header fields, select MODIFY all header fields from the Modify MULTIPLE media menu. Most of the fields in the master template will be copied from the template into each of the media records on the list. Exceptions or fields which cannot be changed by this function are: Username, Owner, External ID, Alias name, Version number, Pool assignment, Shadow tape name, ACL and Volume set values, and the internal states function map.

7.12 Obtain medium from pool(Simplified menus)

In order to allocate a single medium, choose Obtain medium from pool from the Media Library functions menu. The Obtain new medium form will appear (see figure below).

Figure 7-16 Obtain new medium form

The user may accept the default values, fill in the fields with the media data, or press the [Find] key with the cursor in the particular field.

7.13 ADD NEW medium to pool(Simplified menus)

The MANAGER can also add media to the allocated pool by designating a specific user name. If the USER_ADD parameter has been disabled by the configuration, then the general user level will be unable to add new media to the data base.

In order to add media, choose ADD NEW medium to pool from the Media Library functions menu.

A dialog box will appear requesting the External ID of the new medium. See the figure below.

Following the dialog box, a menu of available media types will appear. Some typical choices are listed in the following figure.

If the type desired is not listed, see the MANAGER to add it to the list.

At this point, the user will be presented with a form requesting further information on the medium. The system defaults are displayed, but may be edited for the particular medium.

7.14 Catalog medium into pool(Simplified menus)

In order to catalog incoming media in MCL, choose CATALOG medium into pool from the Media POOL Commands menu. A dialog box will appear, requesting the user enter the identifier of the medium being cataloged.

Following the dialog box, the Catalog new medium form will appear.

For a description of all fields to be input in the form, see Table 7-5.

7.15 Media Header REPORTS

It should be noted that HELP can be accessed at any time during an MCL session by pressing the HELP key. To produce reports about the database, select Media Header REPORTS from the Media Library functions menu.

The form shown below, Create a MEDIA Report Menu appears on the screen.

Selecting any menu item from the first menu item to the Control settings menu item will produce a report. Reports can be added or removed from this menu by user selections within the Control settings menu item.

For information on the creation of reports in DCL, see <REFERENCE>(date_rep), "Database reporting".

7.15.1 Sample report

To produce a report about the database, select the desired report from the Create a MEDIA Report menu. If the Execute mode is set to "output to the screen", then a sample report display appears on the screen. Three sample reports are described and listed below.

Figure 7-17 displays a report of all media by location, system wide. Figure 7-18 displays a report of all media by type, system wide. Figure 7-19 displays a report of all media by comment, system wide. Otherwise, for any other Execute mode, an output equivalent to this display is sent either to a file or directly to a printer. The Execute mode is set by user input within the Control settings menu item.

Figure 7-17 Sample Report Display: All by location, system wide

Figure 7-18 Sample Report Display: All by type, system wide

Figure 7-19 Sample Report Display: Select by comment, system wide

7.15.2 Control settings

To control the selection of data to be reported, select Set selections from the Control Settings menu. The form shown below appears on the screen.

The data entered into each field in this form can be used as a selection filter to control which media are displayed in the reports. Each report can be set up to use any, all or none of these selection filters.

7.15.2.2 Set execution mode

To control the output of the report, select Set execution mode from the Control Settings menu. The form shown below appears on the screen.

To choose between 80 column and 132 column reports, either set or clear the 80 (vs 132) columns flag. The 132 column reports contain more columns of data and, in some cases, more characters for specific data fields than the 80 column reports.

To modify the execute mode, move the cursor to the Execute mode field and press FIND. The following figure appears on the screen.

You may choose to submit to batch or to execute immediately. The report can be output to a specific file, spooled to the printer or displayed directly on the screen. Upon selecting one of the five execute modes, the menu is automatically exited and the description of the execute mode is put into this field.

To set the default name for the output file, enter the file name into the File for output field.

7.15.2.3 Set submit parameters

To set the submit parameters for the reports, select Set submit parameters from the Control Settings menu.

All of the data set in this form only relates to generating a batch job to produce a report. This data does not affect the MEDIA database. These fields perform the following functions:

Data	Description
Log file name	This specifies where to place the report log file that is created during report generation. Any file name that is provided is parsed and a default of "SYS$SYSLOGIN:report_name.LOG" is used to complete any missing elements.
Batch queue name	This defines what batch queue the report generation job is to be placed in for execution. This can be either a generic or node specific execution queue. The default, if none has been defined either implicitly or explicitly, is SYS$BATCH.
Job name in queue	This defines the job name that is to be assigned this report generation job when it is in the batch execution queue. This name will only appear when you use the VMS command SHOW ENTRY or SHOW QUEUE. By default, this name is the same as the job entry in the MEDIA database.
Submit after	This is the time when the job, pending in the submit queue, will be executed.
Queue characteristic	This is a single known characteristic name that is to be associated with the job when it is submitted. Characteristics are arbitrary attributes that can be assigned to job queues. A job will only execute in a queue with matching characteristics.
Queue priority	This specifies what queue priority to assign this job when it is inserted into the batch queue for execution. A non-privileged user is limited to a maximum value that is controlled by the AUTHORIZE program and/or the SYSGEN parameter MAXQUEPRI. The priority is NOT the execution priority but strictly the priority used to order jobs in the batch execution queue while they are waiting to start.
Action flags	The following flags are set to perform the specified actions: Hold job in queue - Place the job in the PENDING state on entering into the batch queue. Notify user when done - Notify you, by beep and message, when the submit job is completed. Delete com file - Delete the job temporary COM file on completion. Create log file - Create a log file using the specified name or a default name. Keep log file - Keep the log file on line after the job finishes. Print log file - Print the log file after the job finishes.
Working set parameters	The three working set entries shown on the form in provide for limitations on the batch job use of system resources.

• Working set default defines the number of physical pages that the job can use.
• Working set quota defines the amount of physical memory that the job is guaranteed.
• Working set extent defines the maximum amount of physical memory that the job can use.

To set the print parameters for the reports, select Set print parameters from the Control Settings menu.

All of the data set in this form only relates to generating a batch job to print out a report. This data does not affect the MEDIA database.

These fields perform the following functions:

Data	Description
Form name	This is the name of the form to be used in printing the report.
Printer queue name	This defines what print queue the report generation job is to be placed in for execution. This can be either a generic or node specific execution queue. The default, if none has been defined either implicitly or explicitly, is SYS$PRINT.
Job name in queue	This defines the job name that is to be assigned this report generation job when it is in the print execution queue. This name will only appear when you use the VMS command SHOW ENTRY or SHOW QUEUE. By default, this name is the same as the report name.
Print after	This is the time when the job, pending in the print queue, will be executed.
Queue characteristic	This is a single known characteristic name that is to be associated with the job when it is printed. Characteristics are arbitrary attributes that can be assigned to job queues. A job will only execute in a queue with matching characteristics.
First page note	This is the note that will be printed on the banner page.
Queue priority	This specifies what queue priority to assign this job when it is inserted into the print queue for execution. A non-privileged user is limited to a maximum value that is controlled by the AUTHORIZE program and/or the SYSGEN parameter MAXQUEPRI. The priority is NOT the execution priority but strictly the priority used to order jobs in the batch execution queue while they are waiting to start.
Number of copies	This is the number of reports to be printed.
Action flags	The following flags are set to perform the specified actions: Hold job in queue - Place the job in the PENDING state on entering into the print queue. Notify user when done - Notify you, by beep and message, when the printing of report is completed. Delete file after printing - Delete the report file after printing. Print burst page - Print burst page at beginning of report. Insert form feeds - Insert form feeds into report. Print flag page - Print flag page at beginning of report. Data contains lowercase - Note that some characters in the report are lowercase. Print trailer page - Print trailer page at end of report.