MEDIA
General User's Guide

The contents information file describes the files contained on a particular medium. The type of directory structure on the medium will affect how the information is displayed.

When the medium does not have a directory structure, a display similar to the following appears:

$ MEDIA 1200>*.* DIRECTORY Directory of 1200;0>[ ] APR_SALES.DAT;1 JUN_SALES.DAT;1 MAY_SALES.DAT;1 Q4_SALES.DAT TAX.DAT;2 Total of 5 files

When a file name is specified on a medium that has a directory structure, the following contents information is displayed:

$ MEDIA 1220>*.* DIRECTORY Directory of 1220;0(CUSTOMER.BCK/0)>[JOHNSON] 1703Q1.DAT;1 1703Q2.DAT;1 1703Q3.DAT;1 1703Q4.DAT;1 ACCOUNT.COM;18 ADVERT.DAT;4 ANGLE.EXE BACKUP.COM;29 DEMO.EXE;4 GENLEDG.COM;1 TRNSUPD.COM;1 Total of 11 files

When the medium is a disk with a FILES11 structure, the display will look like this:

$ MEDIA VAXVMSRL1>SYS$UPDATE:*.* DIRECTORY Directory of VAXVMSRL1>[SYS0.SYSUPD] ACL.HLP;1 ACL.OLB;2 AUTOGEN.COM;94 BASIC.DIR;1 BTCH2851.LOG;1 BLSSREQ.TLR BOOTBLDR.COM;9 BOOTUPD.COM CDD.OLB;2 CDD.OPT;2 CDDBUILD.COM;2 CDDEXC.MSG;2 LIBRARY.TLR;2 LINEPAGE.COM;2 LINEPAGE.DAT;2 MANAGER.TLR;2 VMSTAILOR.COM;3 VMSUPDATE.COM;4 VMSV22KIT.DAT;2 Total of 19 files

11.2.5.1 Full display

For example:

MEDIA VAXVMSRL>SYS$UPDATE:*.* DIRECTORY/FULL Directory of VAXVMSRL1>[SYS0.SYSUPD] ACL.HLP;1 Size: 120 (512) Created: 29-MAR-1996 11:57:58.11 Owner: [001,004] Revised: 29-MAR-1996 11:58:03.95 Protection: Expires: (not set) (S:RE,O,G,W) Backup: 21-JUL-1996 09:17:16.07 Record size: 111 ACL.OLB;2 Size: 267 (512) Created: 29-MAR-1996 11:58:48.59 Owner: [001,004] Revised: 29-MAR-1996 11:58:53.02 Protection: Expires: (not set) (S:RE,O,G,W) Backup: 21-JUL-1996 09:17:16.07 Record size: 512 AUTOGEN.COM;94 Size: 68 (512) Created: 7-AUG-1996 13:23:43.45 Owner: [001,004] Revised: 7-AUG-1996 13:43:06.14 Protection: Expires: (not set) (S:RE,O,G,W) Backup: 8-AUG-1996 09:32:15.72 Record size: 86 BASIC.DIR;1 Size: 2 (512) Created: 23-MAR-1996 17:28:43.20 Owner: [001,004] Revised: 23-MAR-1996 17:28:43.36 Protection: Expires: 1-FEB-1996 15:28:30.80 (S:RED,O:RE,G:R,W:R) Backup: 20-FEB-1996 14:34:13.87 Record size: 512 BATCH2851.LOG;1 Size: 27 (512) Created: 28-MAR-1996 15:32:31.29 Owner: [007,001] Revised: 28-MAR-1996 15:32:37.84 Protection: Expires: (not set) (S:RWED,O:RE,G,W) Backup: 29-MAR-1996 09:16:45.40 Record size: 0 Total of 5 files

11.2.5.2 Line displays

The default way of displaying information is in the line format. There are numerous variations on this format. Please refer to the detailed command description for a complete listing of the various columns that can be selected.

For example:

MEDIA 1200>*.* DIRECTORY Directory of 1200>[] ACTANAL.EXE;28 ACTANAL.FOR;41 ACTANAL.OBJ;4 ACTBALFWD.COM;16 ACTBALFWD.EXE;13 ACTBALFWD.FOR;8 ACTBALFWD.OBJ;3 ACTCOMPLE.COM;13 BREAK.EXE;4 BREAK.FOR;3 BREAK.OBJ;2 CHECKSPEC.COM;1 COMPILE.COM;4 COMPRESS.COM;14 COMPRESS.EXE;56 COMPRESS.FOR;73 COMPRESS.HLP;5 COMPRESS.OBJ;44 CONNECT.MAR;6 COPYDIR.COM;13 CRFSHR.EXE;1 DEBUG.EXE;8 DEBUG.JNL;1 DEBUG.OBJ;1 DELTA.OBJ;1 DEVSTAT.COM;12 DISP.COM;4 DISP.EXE;8 DP.ALS;23 DP.BAL;53 DP.CBL;53 DP.CHK;20 GL.FOR;162 GL.OBJ;35 GLUTIL.OBJ;2 GODCL.MAR;67 HD.TXT;3 IMSL.FOR;1 IMSL.OLB;2 IPO.FOR;11 Total of 40 files

MEDIA VAXVMSRL1>SYS$UPDATE:*.* DIRECTORY Directory of VAXVMSRL1>[SYS0.SYSUPD] ACL.HLP;2 ACL.OLB;2 AUTOGEN.COM;94 BASIC.DIR;1 BATCH2851.LOG;1 BLISSREQ.TLR;3 BOOTBLDR.COM;9 BOOTUPD.COM;3 CDD.OLB;2 CDD.OPT;2 CDDBUILD.COM;2 CDDEXC.MSG;2 CDDIVP.COM;5 CDDL.HLP;2 CDDL.OLB;2 CDDLEXC.MSG;2 CDDRLSE.MEM;5 CDDV.HLP;2 CDDV.OLB;2 CDDVEXC.MSG;2 CONSCOPY.COM;3 DECNET.TLR;3 DEVELOP.TLR;3 DIRCLENUP.COM;4 DMU.HLP;2 DMU.OLB;2 DMUEXC.MSG;2 DTR32.DIR;1 DTRBUILD.COM;3 EXAMPLES.TLR;2 FILETOOLS.TLR;2 HELP.TLR;2 LIBRARY.TLR;2 LINEPAGE.COM;2 LINEPAGE.DAT;2 MANAGER.TLR;2 MEDIA030.ANL;2 MEDIA030.CBT;9 MEDIACVT.COM;9 MISCTOOLS.TLR;2 OBSOLETE.TLR;2 OLDVMSINS.COM;3 QUEUES.TLR;2 REQUIRED.TLR;2 RSX.TLR;2 SETDEFBOO.COM;2 STABACKIT.COM;6 SWAPFILES.COM;3 TEXTTOOLS.TLR;2 TKIP.CMD;2 UETP.TLR;2 UPGRAD.COM;7 UTIO.OBJ;2 VAXFORUPD.MEM;1 VMS032.TXT;2 VMS033.TXT;2 VMS034.TXT;1 VMS035.TXT;1 VMS036.TXT;1 VMSINSTAL.COM;5 VMSKITBLD.COM;3 VMSKITBLD.DAT;8 VMSKITCPY.COM;9 VMSRTL.MAP;2 VMSTAILOR.COM;2 VMSUPDATE.COM;4 VMSV22KIT.DAT;2 Total of 67 files

MEDIA 1200>*.* DIRECTORY/DATE/SIZE Directory of 1200>[] ACTANAL.OBJ;4 1 (8400) 27-DEC-1996 00:00 ACTBALFWD.COM;16 1 (8400) 21-DEC-1996 00:00 ACTBALFWD.EXE;13 3 (8400) 27-DEC-1996 00:00 ACTCOMPLE.COM;13 1 (8400) 27-DEC-1996 00:00 BREAK.EXE;4 1 (6144) 26-APR-1996 00:00 BREAK.FOR;3 1 (8400) 27-DEC-1996 00:00 BREAK.OBJ;2 1 (8400) 27-DEC-1996 00:00 CHECKSPEC.COM;1 1 (8400) 27-NOV-1996 00:00 COMPILE.COM;4 1 (8400) 11-OCT-1996 00:00 COMPRESS.COM;14 1 (8400) 26-APR-1996 00:00 COMPRESS.EXE;56 1 (8400) 9-JAN-1996 00:00 COMPRESS.FOR;73 1 (8400) 9-JAN-1996 00:00 COMPRESS.HLP;5 1 (8400) 28-SEP-1996 00:00 COMPRESS.OBJ;44 1 (8400) 9-JAN-1996 00:00 CONNECT.MAR;6 1 (8400) 2-FEB-1996 00:00 Total of 15 files

11.2.5.3 Total displays

The total displays will list the number of files found and in what directories (if a directory structured media).

For example:

MEDIA 1200,1800>* DIRECTORY/TOTAL Media Directory Files 1200 [] 257 1800 (GLV3.BCK/1/1800)>[MOSSBERG.GL] 254 (PGPLOT.BCK/1/1800)>[MOSSBERG.PGPLOT] 88 (DECSSP.BCK/1/1800)>[MOSSBERG.DECSSP] 249 (VIKING.BCK/1/1800)>[MOSSBERG.VIKING] 209 (SOURCE.BCK/1/1800)>[MOSSBERG.SOURCE1] 102 (SOURCE.BCK/1/1800)>[MOSSBERG.SOURCE2] 17 Total 1176

The format of the directory name indicates the type of structure being used to store the information. Media 1200 is a tape that has been written using a VMS COPY command. This creates an ANSI Labeled tape. Such tapes have no directory structure. Media 1800 is also a tape but VMS BACKUP has been used to put several savesets on it. The general format of the directory specification is then:

(saveset_name/volume_number/volume_name) [directory_name]

For a FILES-11 disk, the directory format is the same as the on-line format. The example below shows such an off-line disk.

MEDIA VAXVSMRL1>* DIRECTORY/TOTAL Media Directory Files VAXVMSRL1 [376010] 115 [CONSOLE] 88 [CTOS] 14 [MEDIA] 35 [MEDIA.BTR] 7 [MEDIA.COM] 11 [MEDIA.DEF] 87 . . . [SYSLOST] 8 [SYSMAINT] 304 [SYSTPDIR] 302 [SYSUTIL] 72 [VS11] 53 [VS11.VSLIB] 25 Total 5306

11.2.6 Using qualifiers with the MEDIA DIRECTORY command

The DIRECTORY command can be used in conjunction with other qualifiers. The qualifiers can affect the volume header information displayed, using the format:

$ MEDIA MEDIUM_NAME DIRECTORY/QUALIFIERS

or the file content information displayed, using the format:

$ MEDIA MEDIUM_NAME>FILE_NAME DIRECTORY/QUALIFIERS

The qualifiers can be used either to restrict a search of the database or to affect the display of the information output. Search qualifiers restrict the search of possible media to those that satisfy specified criteria; column qualifiers select the information to be displayed. This section discusses the most commonly used qualifiers. For a complete listing of all possible qualifiers, see the Reference Manual.

11.2.6.1 Search qualifiers

Search qualifiers can be used to exclude certain file or media names from the search or to select media by date or some other criterion. The search qualifiers are:

Qualifier	Description
/SINCE=date	selects all media with a date field after this date
/BEFORE=date	selects all media with a date field before this date
/EXCLUDE=file_name or (file_name,file_name,...)	selects all files but the named one (content information)
/SELECT=criterion or (criterion,criterion...)	For example, to select all media with a certain comment, use /SELECT=COMMENT:"text". This applies to volumes that have the selection criteria, not to files.

/SINCE=11-DEC-1996

is equivalent to

/SINCE=11-DEC-1996/CREATED

Some of the most commonly used date-field qualifiers are: ²

Qualifier	Description
/CREATED	the date a file or medium was first created or added
/MODIFIED	the date a file or medium was last modified
/EXPIRED	the date a file or medium expires
/DIRUPD	the last time the directory of the medium was updated

The search qualifiers /EXCLUDE and /SELECT restrict the search by criteria other than a date field. The VMS wildcards * and % can be used in the specifications.

/EXCLUDE affects searches of the MEDIA database for file information by specifying a file name in the command. For example, if a user wanted to display the files on his or her disk that were not .EXE files, he or she would type:

$ MEDIA VAXVMSRL1;0>SYS$UPDATE:*.* DIRECTORY/EXCLUDE=*.EXE Directory of VAXVMSRL1>[SYS0.SYSUPD0] ACL.HLP;1 ACL.OLB;2 BASIC.DIR;1 BTCH2851.LOG;1 BLSSREQ.TLR;3 CDD.OLB;2 CDD.OPT;2 CDDEXC.MSG;2 LIBRARY.TLR;2 LINEPAGE.DAT;2 MANAGER.TLR;2 VMSV22KIT.DAT;2 Total of 12 files

The /SELECT qualifier controls the selection of media using several types of criteria:

Criteria	Description
LOCATION=string or (string,string...)	selection string
TYPE=string or (string,string...)	selection string
COMMENT=string or (string,string...)	selection string
MFG=string or (string,string...)	selection string
DENSITY=density or (density,density...)	density selection
MATCH=mode	match mode

A colon ":" can be used in place of the "=" in the above selection specifications. The acceptable values for these selection strings depend on your site. Contact your MANAGER for the appropriate values. Any of the selection strings can contain the VMS wildcards * and %. If you include any blanks or other non-alphanumeric characters in the selection string, you must enclose the string in double quotes ("). The selection criteria are controlled by one of the following MATCH keywords:

Keyword	Synonym	Action
AND	ALL	if all strings match
OR	ANY	if any strings match (DEFAULT)
XOR	ANY1	if one and only one string matches
NOT		if string does not match
NAND	NOTANY	if no strings match
NOR	NOTALL	if at least one string does not match

For example, you are looking for a medium which is a TK50 AND deals with a backup. The following command will work:

$ MEDIA * DIRECTORY/SELECT=(TYPE:TK50,COMMENT:"*BACKUP*",MATCH:AND)

11.2.6.2 Column selectors

The other extreme would be a full display of the entry. For example, if the qualifier /FULL is used:

$ MEDIA VMS_PROGRAM_RELEASES1 DIRECTORY/FULL

complete information on the media will be displayed.

When used with the DIRECTORY command, column selectors cause the specified data field to be displayed. Several of the common (type 1 header information) column selectors are listed in Table 11-2.

Table 11-2 Common type 1 MEDIA DIRECTORY qualifiers

Qualifier	Description
/COMMENT	displays the comment field
/DATE=field or =(field,field...)	displays the selected date field or fields. Some of the possible date fields include: ADDED, ALL, CERTIFIED, CHECKED, CREATED, DIRECTORY, EXPIRED, MODIFIED
/EXTERNAL	displays the external label of the medium
/FULL	displays a complete listing of all information about the medium
/OWNER	displays the UIC code of the owner of the file
/PROTECTION	displays the protection specification of the file
/SIZE	displays used/allocated space on the file
/TYPE	displays type of medium (TAPE, TK50, RP06)

Each of these column selectors corresponds to a field in the header information file for the medium and can be used as a qualifier for the DIRECTORY command.

For a full list of column selectors, see the Reference Manual.

Column selectors can also be used to expand the contents information file display. If a medium does not have a directory structure, the directory portion of the search string will be ignored. To display expanded contents information, use the format

$ MEDIA MEDIUM_NAME>FILE_NAME DIRECTORY/QUALIFIER

Each of the (type 2 contents information) column selectors listed in Table 11-3 corresponds to a field in the contents information file display. As you can see, some column selectors apply to both kinds of database entries.

Table 11-3 Common type 2 MEDIA DIRECTORY qualifiers

Column selector	Description
/BLOCKS	displays blocks in use by file
/DATES=field or =(field,field...)	displays the date field or fields specified. The date-fields possible are: BACKUP, CREATED, EXPIRED, ALL, REVISED
/FULL	displays a complete listing of all the information about the file
/OWNER	displays UIC code of the owner of the medium
/PROTECTION	displays the protection specification of the medium
/SIZE	displays used and unused space on the medium
/TOTAL	displays the number of files found in each directory. If the file specification is an asterisk, this selector generates a total line for each medium/directory combination

For a full list of column selectors, see the Reference Manual.